lightcone 0.6.1

Rust SDK for the Lightcone Protocol — unified native + WASM client
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

//! Environment configuration for the Lightcone SDK.
//!
//! The [`LightconeEnv`] enum determines which Lightcone deployment the SDK
//! connects to. Each variant maps to a specific API URL, WebSocket URL,
//! Solana RPC URL, and on-chain program ID.

use solana_pubkey::Pubkey;
use std::fmt;
use std::str::FromStr;

/// Lightcone deployment environment.
///
/// Pass to [`LightconeClientBuilder::env`](crate::client::LightconeClientBuilder::env)
/// to configure the client for a specific deployment. Defaults to [`Prod`](LightconeEnv::Prod)
/// when not specified.
///
/// # Example
///
/// ```rust
/// use lightcone::prelude::*;
///
/// let client = LightconeClient::builder()
///     .env(LightconeEnv::Staging)
///     .build()?;
/// ```
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum LightconeEnv {
    /// Local development environment.
    Local,
    /// Staging / test environment.
    Staging,
    /// Production environment (default).
    Prod,
}

impl LightconeEnv {
    /// REST API base URL for this environment.
    pub fn api_url(&self) -> &'static str {
        match self {
            Self::Local => "https://local-api.lightcone.xyz",
            Self::Staging => "https://tapi2.lightcone.xyz",
            Self::Prod => "https://tapi.lightcone.xyz",
        }
    }

    /// WebSocket URL for this environment.
    pub fn ws_url(&self) -> &'static str {
        match self {
            Self::Local => "wss://local-ws.lightcone.xyz/ws",
            Self::Staging => "wss://tws2.lightcone.xyz/ws",
            Self::Prod => "wss://tws.lightcone.xyz/ws",
        }
    }

    /// Solana RPC URL for this environment.
    pub fn rpc_url(&self) -> &'static str {
        match self {
            Self::Local => "https://api.devnet.solana.com",
            Self::Staging => "https://api.devnet.solana.com",
            Self::Prod => "https://api.devnet.solana.com",
        }
    }

    /// On-chain Lightcone program ID for this environment.
    pub fn program_id(&self) -> Pubkey {
        match self {
            Self::Local | Self::Staging => {
                Pubkey::from_str("H3qkHTWUDUUw4ZvGNPdwdU4CYqks69bijo1CzVR12mq")
                    .expect("valid program id")
            }
            Self::Prod => Pubkey::from_str("8nzsoyHZFYig3uN3M717Q47MtLqzx2V2UAKaPTqDy5rV")
                .expect("valid program id"),
        }
    }
}

impl Default for LightconeEnv {
    fn default() -> Self {
        Self::Prod
    }
}

impl fmt::Display for LightconeEnv {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::Local => write!(formatter, "local"),
            Self::Staging => write!(formatter, "staging"),
            Self::Prod => write!(formatter, "prod"),
        }
    }
}