Struct ChainClient 

pub struct ChainClient { /* private fields */ }

Implementations

impl ChainClient

pub async fn fetch_accounts( &self, keys: &[Pubkey], ) -> Result<Vec<Option<Account>>, ChainError>

Chunked reads preserve input order, including missing accounts.

pub async fn maker_open_positions( &self, owner: &Pubkey, ) -> Result<Vec<(Pubkey, PositionInfo)>, ChainError>

Startup/manual recovery only. Includes Open and Funded positions; absence is not proof of closure.

pub async fn maker_snapshot( &self, owner: &Pubkey, positions: &[Pubkey], premiums: &[PremiumToken], ) -> Result<MakerSnapshot, ChainError>

Two dependency rounds: positions + known premium ATAs, then unique markets. Chunks may observe different slots; this is not an atomic chain snapshot.

impl ChainClient

pub async fn signature_statuses( &self, signatures: &[Signature], ) -> Result<Vec<ConfirmationStatus>, ChainError>

One status read per chunk of at most 256 signatures, including history.

pub async fn confirm_signatures( &self, ws_url: &str, signatures: &[Signature], timeout: Duration, ) -> Result<Vec<ConfirmationStatus>, ChainError>

Wait on one Solana WS connection, then reconcile unresolved signatures in one chunked status pass on disconnect, subscription error, or deadline. No polling.

impl ChainClient

pub fn rpc(&self) -> &RpcClient

pub fn from_rpc(rpc: RpcClient, program_id: Pubkey) -> Self

pub fn with_confirmation_ws_url(self, url: impl Into<String>) -> Self

Use Solana signature subscriptions for confirming conveniences instead of the legacy RPC confirmation fallback. Batch submission remains submit-only.

pub fn program_id(&self) -> Pubkey

pub fn new( rpc_url: &str, program_id: Pubkey, commitment: CommitmentConfig, ) -> Self

pub async fn maker_deposit( &self, args: MakerDepositArgs, maker_owner: &(dyn Signer + Sync), fee_payer: Option<&(dyn Signer + Sync)>, ) -> Result<Signature, ChainError>

Submit and wait for confirmation at the client commitment; execution failure is an error.

pub async fn maker_withdraw( &self, args: MakerWithdrawArgs, maker_owner: &(dyn Signer + Sync), fee_payer: Option<&(dyn Signer + Sync)>, ) -> Result<Signature, ChainError>

Submit and wait for confirmation at the client commitment; execution failure is an error.

pub async fn fund_position( &self, args: FundPositionArgs, maker_owner: &(dyn Signer + Sync), fee_payer: Option<&(dyn Signer + Sync)>, ) -> Result<Signature, ChainError>

Submit and wait for confirmation at the client commitment; execution failure is an error.

pub async fn build_maker_deposit_ixs( &self, args: &MakerDepositArgs, fee_payer: Pubkey, ) -> Result<Vec<Instruction>, ChainError>

pub async fn build_maker_withdraw_ixs( &self, args: &MakerWithdrawArgs, fee_payer: Pubkey, ) -> Result<Vec<Instruction>, ChainError>

pub async fn build_fund_position_ixs( &self, args: &FundPositionArgs, fee_payer: Pubkey, ) -> Result<Vec<Instruction>, ChainError>

pub async fn fetch_position_info( &self, position_pda: &Pubkey, ) -> Result<PositionInfo, ChainError>

pub async fn fetch_market_info( &self, market_pda: &Pubkey, ) -> Result<MarketInfo, ChainError>

pub async fn fetch_market_quote_mint( &self, market_pda: &Pubkey, ) -> Result<Pubkey, ChainError>

pub async fn hot_authority(&self) -> Result<Pubkey, ChainError>

Reads the canonical GlobalConfig PDA and returns its checked hot authority.

Vault opens use this key as both transaction fee payer and account 0, so accepting a venue-provided value would let the venue choose the signer.

pub async fn fetch_token_balance( &self, token_account: &Pubkey, ) -> Result<u64, ChainError>

Fetch the raw token balance (u64 atoms) of a token account.

pub async fn address_lookup_tables( &self, keys: &[Pubkey], ) -> Result<Vec<AddressLookupTableAccount>, ChainError>

Active lookup tables by key, for verifying served v0 transactions.

pub async fn send_instructions_with_options( &self, instructions: Vec<Instruction>, fee_payer: &(dyn Signer + Sync), extra_signers: &[&(dyn Signer + Sync)], options: SendOptions, ) -> Result<Signature, ChainError>

Submit and wait for confirmation at the client commitment; execution failure is an error.

pub async fn send_instructions_with_blockhash( &self, instructions: Vec<Instruction>, fee_payer: &(dyn Signer + Sync), extra_signers: &[&(dyn Signer + Sync)], options: SendOptions, blockhash: Hash, ) -> Result<Signature, ChainError>

Submit without confirmation using a blockhash shared across the caller’s batch.

impl ChainClient

pub async fn vault_manager( &self, vault: Pubkey, actor: Pubkey, ) -> Result<VaultManager, ChainError>

impl ChainClient

pub async fn unfunded_positions( &self, vault: &Pubkey, ) -> Result<Vec<(Pubkey, PositionInfo)>, ChainError>

Positions the vault bought as a maker that still await FundPositionForVaultHolder, read from the program’s accounts.

pub async fn pending_capital_requests( &self, vault: &Pubkey, ) -> Result<PendingCapitalRequests, ChainError>

The vault’s nonzero queued deposits and withdrawals, read from the program’s accounts.

impl ChainClient

pub async fn build_settle_position( &self, maker_owner: Pubkey, position_pda: Pubkey, ) -> Result<Instruction, ChainError>

pub async fn settle_position_sequence( &self, maker_owner: Pubkey, position_pda: Pubkey, ) -> Result<Vec<Instruction>, ChainError>