switchboard-on-demand 0.10.5

A Rust library to interact with the Switchboard Solana program.
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

//! Solana version compatibility layer
//!
//! This module provides compatibility between different Solana versions,
//! ensuring the correct types and modules are available regardless of which
//! version of the Solana SDK is being used.

// ===== Compile-time feature compatibility checks =====

// Ensure only one Solana version is enabled
#[cfg(all(feature = "solana-v2", feature = "solana-v3"))]
compile_error!("Cannot enable both 'solana-v2' and 'solana-v3' features at the same time. Choose one.");

// Ensure only one client version is enabled
#[cfg(all(feature = "client", feature = "client-v3"))]
compile_error!("Cannot enable both 'client' and 'client-v3' features at the same time. Use 'client' for Solana v2 or 'client-v3' for Solana v3.");

#[cfg(all(feature = "client-v2", feature = "client-v3"))]
compile_error!("Cannot enable both 'client-v2' and 'client-v3' features at the same time. Use 'client-v2' for Solana v2 or 'client-v3' for Solana v3.");

// When anchor is enabled, use anchor's solana_program (v2.x)
#[cfg(feature = "anchor")]
pub use anchor_lang::solana_program;

// When anchor is NOT enabled, use version-specific solana_program
// v3 takes precedence when both v2 and v3 are enabled
#[cfg(all(not(feature = "anchor"), feature = "solana-v2"))]
pub use solana_program_v2 as solana_program;
#[cfg(all(not(feature = "anchor"), feature = "solana-v3"))]
pub use solana_program_v3 as solana_program;

// ===== solana_sdk (only when client is enabled) =====
// Version-specific solana_sdk selection based on features

// When client-v3 is enabled, expose solana_sdk v3
#[cfg(feature = "client-v3")]
pub use solana_sdk_v3 as solana_sdk;

// When client is enabled (default v2), expose solana_sdk v2
#[cfg(all(feature = "client", not(feature = "client-v3")))]
pub use solana_sdk_v2 as solana_sdk;

// ===== Unified module re-exports for both v2 and v3 =====
// These modules exist in different places in v2 vs v3
// Re-export them here to provide a consistent API

// V2: these come from solana_sdk
#[cfg(all(any(feature = "client", feature = "client-v2"), not(feature = "client-v3")))]
pub mod address_lookup_table {
    #[allow(deprecated)]
    pub use solana_sdk_v2::address_lookup_table::*;
}

#[cfg(all(any(feature = "client", feature = "client-v2"), not(feature = "client-v3")))]
pub mod compute_budget {
    #[allow(deprecated)]
    pub use solana_sdk_v2::compute_budget::*;
}

#[cfg(all(any(feature = "client", feature = "client-v2"), not(feature = "client-v3")))]
pub mod commitment_config {
    #[allow(deprecated)]
    pub use solana_sdk_v2::commitment_config::*;
}

// V3: These modules were moved to separate crates in Solana v3
// However, those crates are not yet published to crates.io
// WORKAROUND: Use v2 versions with to_bytes().into() conversions
#[cfg(feature = "client-v3")]
pub mod address_lookup_table {
    // Use v2 SDK modules as compat layer
    // Convert types using to_bytes().into() when interfacing with v3 types
    #[allow(deprecated)]
    pub use solana_sdk_v2::address_lookup_table::*;
}

#[cfg(feature = "client-v3")]
pub mod compute_budget {
    // Use v2 SDK modules as compat layer
    #[allow(deprecated)]
    pub use solana_sdk_v2::compute_budget::*;
}

#[cfg(feature = "client-v3")]
pub mod commitment_config {
    // Use v2 SDK modules as compat layer
    #[allow(deprecated)]
    pub use solana_sdk_v2::commitment_config::*;
}

#[cfg(feature = "client-v3")]
pub mod client {
    // SyncClient from v2 for compatibility
    #[allow(deprecated)]
    pub use solana_sdk_v2::client::*;
}

// ===== solana_client (when client or client-v3 is enabled) =====
// Version-specific solana-client selection based on features

// When client-v3 is enabled, use solana-client v3
#[cfg(feature = "client-v3")]
pub use solana_client_v3 as solana_client;

// When client is enabled (default v2), use solana-client v2
#[cfg(all(feature = "client", not(feature = "client-v3")))]
pub use solana_client_v2 as solana_client;

// Re-export common types for easier access
pub use solana_program::{
    account_info::AccountInfo,
    instruction::{AccountMeta, Instruction},
    msg,
    pubkey::{pubkey, Pubkey},
    sysvar,
};

// These modules are in different locations depending on which solana_program is used
#[cfg(not(feature = "anchor"))]
pub use solana_program::{ed25519_program, hash, syscalls};

// When anchor is enabled, use solana_program_v2 directly for these modules
#[cfg(feature = "anchor")]
pub use solana_program_v2::{ed25519_program, hash, syscalls};

extern "C" {
    pub fn sol_memcpy_(dst: *mut u8, src: *const u8, n: u64);
}

// AddressLookupTableAccount location differs between versions
// For anchor, use solana_program_v2 directly
#[cfg(feature = "anchor")]
pub use solana_program_v2::address_lookup_table::AddressLookupTableAccount;

// For v2, it's in solana_program
#[cfg(all(feature = "solana-v2", not(feature = "solana-v3"), not(feature = "anchor")))]
pub use solana_program::address_lookup_table::AddressLookupTableAccount;

// For v3 when used with client-v3, get it from our v2-compat re-exported address_lookup_table module
#[cfg(all(feature = "solana-v3", feature = "client-v3"))]
pub use address_lookup_table::AddressLookupTableAccount;

/// Cluster type enum for specifying Solana network environments
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ClusterType {
    /// Solana mainnet-beta
    MainnetBeta,
    /// Solana testnet
    Testnet,
    /// Solana devnet
    Devnet,
    /// Local development environment
    Development,
}