lightcone 0.7.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
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
155
156
157
158
159
160
161
162
163
164
165
166
167

//! Constants for the Lightcone Pinocchio program.
//!
//! This module contains all program IDs, seeds, discriminators, and size constants
//! matching the on-chain program exactly.

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

// ============================================================================
// Program IDs
// ============================================================================

lazy_static::lazy_static! {
    /// Address Lookup Table Program ID
    pub static ref ALT_PROGRAM_ID: Pubkey = Pubkey::from_str("AddressLookupTab1e1111111111111111111111111").unwrap();
}

/// SPL Token Program ID
pub const TOKEN_PROGRAM_ID: Pubkey = spl_token::ID;

/// Associated Token Account Program ID
pub const ASSOCIATED_TOKEN_PROGRAM_ID: Pubkey = spl_associated_token_account::ID;

/// System Program ID
pub const SYSTEM_PROGRAM_ID: Pubkey = solana_sdk_ids::system_program::ID;

/// Rent Sysvar ID
pub const RENT_SYSVAR_ID: Pubkey = solana_sdk_ids::sysvar::rent::ID;

lazy_static::lazy_static! {
    /// Metaplex Token Metadata Program ID
    pub static ref MPL_TOKEN_METADATA_PROGRAM_ID: Pubkey =
        Pubkey::from_str("metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s").unwrap();
}

// ============================================================================
// Instruction Discriminators
// ============================================================================

/// Instruction discriminators (single byte indices)
pub mod instruction {
    pub const INITIALIZE: u8 = 0;
    pub const CREATE_MARKET: u8 = 1;
    pub const ADD_DEPOSIT_MINT: u8 = 2;
    pub const MINT_COMPLETE_SET: u8 = 3;
    pub const MERGE_COMPLETE_SET: u8 = 4;
    pub const CANCEL_ORDER: u8 = 5;
    pub const INCREMENT_NONCE: u8 = 6;
    pub const SETTLE_MARKET: u8 = 7;
    pub const REDEEM_WINNINGS: u8 = 8;
    pub const SET_PAUSED: u8 = 9;
    pub const SET_OPERATOR: u8 = 10;
    pub const WITHDRAW_FROM_POSITION: u8 = 11;
    pub const ACTIVATE_MARKET: u8 = 12;
    pub const MATCH_ORDERS_MULTI: u8 = 13;
    pub const SET_AUTHORITY: u8 = 14;
    pub const CREATE_ORDERBOOK: u8 = 15;
    pub const WHITELIST_DEPOSIT_TOKEN: u8 = 16;
    pub const DEPOSIT_TO_GLOBAL: u8 = 17;
    pub const GLOBAL_TO_MARKET_DEPOSIT: u8 = 18;
    pub const INIT_POSITION_TOKENS: u8 = 19;
    pub const DEPOSIT_AND_SWAP: u8 = 20;
    pub const EXTEND_POSITION_TOKENS: u8 = 21;
    pub const WITHDRAW_FROM_GLOBAL: u8 = 22;
    pub const CLOSE_POSITION_ALT: u8 = 23;
    pub const CLOSE_ORDER_STATUS: u8 = 24;
    pub const CLOSE_POSITION_TOKEN_ACCOUNTS: u8 = 25;
    pub const CLOSE_ORDERBOOK_ALT: u8 = 26;
    pub const CLOSE_ORDERBOOK: u8 = 27;
    pub const SET_MANAGER: u8 = 28;
    pub const SET_MARKET_FEES: u8 = 29;
    pub const SET_FEE_RECEIVER: u8 = 30;
    pub const CREATE_CONDITIONAL_METADATA: u8 = 31;
    pub const UPDATE_CONDITIONAL_METADATA: u8 = 32;
}

// ============================================================================
// Account Discriminators (8 bytes each, SHA-256 hash bytes)
// ============================================================================

/// Exchange account discriminator
pub const EXCHANGE_DISCRIMINATOR: [u8; 8] = [0x1e, 0xc8, 0xdc, 0x95, 0x03, 0x3d, 0x68, 0x32];
/// Market account discriminator
pub const MARKET_DISCRIMINATOR: [u8; 8] = [0xdb, 0xbe, 0xd5, 0x37, 0x00, 0xe3, 0xc6, 0x9a];
/// Order status account discriminator
pub const ORDER_STATUS_DISCRIMINATOR: [u8; 8] = [0x2e, 0x5a, 0xf1, 0x49, 0xb2, 0x68, 0x41, 0x03];
/// User nonce account discriminator
pub const USER_NONCE_DISCRIMINATOR: [u8; 8] = [0xeb, 0x85, 0x01, 0xf3, 0x12, 0x87, 0x58, 0xe0];
/// Position account discriminator
pub const POSITION_DISCRIMINATOR: [u8; 8] = [0xaa, 0xbc, 0x8f, 0xe4, 0x7a, 0x40, 0xf7, 0xd0];
/// Orderbook account discriminator
pub const ORDERBOOK_DISCRIMINATOR: [u8; 8] = [0x2b, 0x22, 0x19, 0x71, 0xc3, 0x45, 0x48, 0x07];
/// GlobalDepositToken account discriminator
pub const GLOBAL_DEPOSIT_TOKEN_DISCRIMINATOR: [u8; 8] =
    [0x25, 0xbe, 0xa1, 0xe8, 0x7b, 0x92, 0x2a, 0x57];

// ============================================================================
// PDA Seeds
// ============================================================================

/// Exchange PDA seed
pub const EXCHANGE_SEED: &[u8] = b"central_state";
/// Market PDA seed
pub const MARKET_SEED: &[u8] = b"market";
/// Vault PDA seed (for deposit token accounts)
pub const VAULT_SEED: &[u8] = b"market_deposit_token_account";
/// Mint authority PDA seed
pub const MINT_AUTHORITY_SEED: &[u8] = b"market_mint_authority";
/// Conditional mint PDA seed
pub const CONDITIONAL_MINT_SEED: &[u8] = b"conditional_mint";
/// Condition tombstone PDA seed
pub const CONDITION_SEED: &[u8] = b"condition";
/// Order status PDA seed
pub const ORDER_STATUS_SEED: &[u8] = b"order_status";
/// User nonce PDA seed
pub const USER_NONCE_SEED: &[u8] = b"user_nonce";
/// Position PDA seed
pub const POSITION_SEED: &[u8] = b"position";
/// Orderbook PDA seed
pub const ORDERBOOK_SEED: &[u8] = b"orderbook";
/// GlobalDepositToken PDA seed (also used for user global deposit accounts)
pub const GLOBAL_DEPOSIT_TOKEN_SEED: &[u8] = b"global_deposit";
/// Fee receiver seed exported by the on-chain program.
pub const FEE_RECEIVER_SEED: &[u8] = b"fee_receiver";
/// Metaplex metadata PDA seed.
pub const MPL_METADATA_SEED: &[u8] = b"metadata";

// ============================================================================
// Account Sizes
// ============================================================================

/// Exchange account size in bytes
pub const EXCHANGE_SIZE: usize = 212;
/// Market account size in bytes
pub const MARKET_SIZE: usize = 212;
/// Order status account size in bytes
pub const ORDER_STATUS_SIZE: usize = 32;
/// User nonce account size in bytes
pub const USER_NONCE_SIZE: usize = 16;
/// Position account size in bytes
pub const POSITION_SIZE: usize = 80;
/// Orderbook account size in bytes
pub const ORDERBOOK_SIZE: usize = 144;
/// GlobalDepositToken account size in bytes
pub const GLOBAL_DEPOSIT_TOKEN_SIZE: usize = 48;

// ============================================================================
// Order Sizes
// ============================================================================

/// Signed order size in bytes
pub const SIGNED_ORDER_SIZE: usize = 233;
/// Order size in bytes (compact on-chain format)
pub const ORDER_SIZE: usize = 37;
/// Signature size in bytes
pub const SIGNATURE_SIZE: usize = 64;

// ============================================================================
// Limits
// ============================================================================

/// Maximum outcomes per market (limited by compute budget)
pub const MAX_OUTCOMES: u8 = 6;
/// Minimum outcomes per market
pub const MIN_OUTCOMES: u8 = 2;
/// Maximum makers in a single match_orders_multi instruction
pub const MAX_MAKERS: usize = 5;