Struct LightconePinocchioClient 

pub struct LightconePinocchioClient {
    pub rpc_client: RpcClient,
    pub program_id: Pubkey,
}

Client for interacting with the Lightcone Pinocchio program.

Fields

rpc_client: RpcClient

RPC client for Solana

program_id: Pubkey

Program ID

Implementations

impl LightconePinocchioClient

pub fn new(rpc_url: &str) -> Self

Create a new client with default program ID.

pub fn with_program_id(rpc_url: &str, program_id: Pubkey) -> Self

Create a new client with custom program ID.

pub fn from_rpc_client(rpc_client: RpcClient) -> Self

Create a new client with existing RpcClient.

pub fn pda(&self) -> &Pda

Get PDA derivation helpers.

pub async fn get_exchange(&self) -> SdkResult<Exchange>

Fetch the Exchange account.

pub async fn get_market(&self, market_id: u64) -> SdkResult<Market>

Fetch a Market account by ID.

pub async fn get_market_by_pubkey(&self, market: &Pubkey) -> SdkResult<Market>

Fetch a Market account by pubkey.

pub async fn get_position( &self, owner: &Pubkey, market: &Pubkey, ) -> SdkResult<Option<Position>>

Fetch a Position account (returns None if not found).

pub async fn get_order_status( &self, order_hash: &[u8; 32], ) -> SdkResult<Option<OrderStatus>>

Fetch an OrderStatus account (returns None if not found).

pub async fn get_user_nonce(&self, user: &Pubkey) -> SdkResult<u64>

Fetch a user’s current nonce (returns 0 if not initialized).

pub async fn get_next_nonce(&self, user: &Pubkey) -> SdkResult<u64>

Get the next available nonce for a user (the current stored nonce value).

Orders should be signed with this nonce value. Call increment_nonce to invalidate orders with the current nonce.

pub async fn get_next_market_id(&self) -> SdkResult<u64>

Get the next available market ID.

pub async fn get_latest_blockhash(&self) -> SdkResult<Hash>

Get the latest blockhash for transaction building.

pub async fn initialize(&self, authority: &Pubkey) -> SdkResult<Transaction>

Build Initialize transaction.

pub async fn create_market( &self, params: CreateMarketParams, ) -> SdkResult<Transaction>

Build CreateMarket transaction.

pub async fn add_deposit_mint( &self, params: AddDepositMintParams, market: &Pubkey, num_outcomes: u8, ) -> SdkResult<Transaction>

Build AddDepositMint transaction.

pub async fn mint_complete_set( &self, params: MintCompleteSetParams, num_outcomes: u8, ) -> SdkResult<Transaction>

Build MintCompleteSet transaction.

pub async fn merge_complete_set( &self, params: MergeCompleteSetParams, num_outcomes: u8, ) -> SdkResult<Transaction>

Build MergeCompleteSet transaction.

pub async fn cancel_order( &self, maker: &Pubkey, order: &FullOrder, ) -> SdkResult<Transaction>

Build CancelOrder transaction.

pub async fn increment_nonce(&self, user: &Pubkey) -> SdkResult<Transaction>

Build IncrementNonce transaction.

pub async fn settle_market( &self, params: SettleMarketParams, ) -> SdkResult<Transaction>

Build SettleMarket transaction.

pub async fn redeem_winnings( &self, params: RedeemWinningsParams, winning_outcome: u8, ) -> SdkResult<Transaction>

Build RedeemWinnings transaction.

pub async fn set_paused( &self, authority: &Pubkey, paused: bool, ) -> SdkResult<Transaction>

Build SetPaused transaction.

pub async fn set_operator( &self, authority: &Pubkey, new_operator: &Pubkey, ) -> SdkResult<Transaction>

Build SetOperator transaction.

pub async fn withdraw_from_position( &self, params: WithdrawFromPositionParams, is_token_2022: bool, ) -> SdkResult<Transaction>

Build WithdrawFromPosition transaction.

pub async fn activate_market( &self, params: ActivateMarketParams, ) -> SdkResult<Transaction>

Build ActivateMarket transaction.

pub async fn match_orders_multi( &self, params: MatchOrdersMultiParams, ) -> SdkResult<Transaction>

Build MatchOrdersMulti transaction without Ed25519 verify instructions.

Note: This requires Ed25519 verification instructions to be added separately before the match instruction.

pub async fn match_orders_multi_with_verify( &self, params: MatchOrdersMultiParams, ) -> SdkResult<Transaction>

Build MatchOrdersMulti transaction with Ed25519 verify instructions.

Uses individual Ed25519 verify instructions (one per signature).

pub async fn match_orders_multi_cross_ref( &self, params: MatchOrdersMultiParams, ) -> SdkResult<Transaction>

Build MatchOrdersMulti transaction with cross-reference Ed25519 verification.

This is the most space-efficient approach - Ed25519 instructions reference data in the match instruction instead of duplicating it.

pub fn create_bid_order(&self, params: BidOrderParams) -> FullOrder

Create an unsigned bid order.

pub fn create_ask_order(&self, params: AskOrderParams) -> FullOrder

Create an unsigned ask order.

pub fn create_signed_bid_order( &self, params: BidOrderParams, keypair: &Keypair, ) -> FullOrder

Create and sign a bid order.

pub fn create_signed_ask_order( &self, params: AskOrderParams, keypair: &Keypair, ) -> FullOrder

Create and sign an ask order.

pub fn hash_order(&self, order: &FullOrder) -> [u8; 32]

Compute the hash of an order.

pub fn sign_order(&self, order: &mut FullOrder, keypair: &Keypair)

Sign an order with the given keypair.

pub fn derive_condition_id( &self, oracle: &Pubkey, question_id: &[u8; 32], num_outcomes: u8, ) -> [u8; 32]

Derive the condition ID for a market.

pub fn get_conditional_mints( &self, market: &Pubkey, deposit_mint: &Pubkey, num_outcomes: u8, ) -> Vec<Pubkey>

Get all conditional mint pubkeys for a market.

pub fn get_exchange_pda(&self) -> Pubkey

Get the Exchange PDA.

pub fn get_market_pda(&self, market_id: u64) -> Pubkey

Get a Market PDA.

pub fn get_position_pda(&self, owner: &Pubkey, market: &Pubkey) -> Pubkey

Get a Position PDA.

pub fn get_order_status_pda(&self, order_hash: &[u8; 32]) -> Pubkey

Get an Order Status PDA.

pub fn get_user_nonce_pda(&self, user: &Pubkey) -> Pubkey

Get a User Nonce PDA.