Struct WalletClient 

pub struct WalletClient {
    pub wallet_address: WalletAddress,
    pub private_key: String,
    pub signing_chain_id: u64,
    ws_messages: Arc<Mutex<Vec<WsMessage>>>,
    ws_tx: Arc<Mutex<Option<UnboundedSender<Message>>>>,
    nonce_counter: Arc<AtomicU64>,
    http_client: Client,
}

Fields

wallet_address: WalletAddress

private_key: String

signing_chain_id: u64

ws_messages: Arc<Mutex<Vec<WsMessage>>>

ws_tx: Arc<Mutex<Option<UnboundedSender<Message>>>>

nonce_counter: Arc<AtomicU64>

http_client: Client

Implementations

impl WalletClient

pub async fn sign_directive( &self, action_key: ActionKey, account: WalletAddress, nonce: u64, action: &Value, chain_id: u64, ) -> Result<String, Box<dyn Error + Send + Sync>>

pub async fn submit_directive( &self, base_url: &str, action_key: ActionKey, account: WalletAddress, nonce: u64, action: Value, chain_id: u64, ) -> Result<Value, Box<dyn Error + Send + Sync>>

impl WalletClient

pub async fn set_margin_mode( &self, base_url: &str, margin_mode: &str, ) -> Result<Value, Box<dyn Error + Send + Sync>>

Set margin mode for the wallet

impl WalletClient

pub async fn create_account_on_chain( &self, exchange_address: &str, rpc_url: &str, ) -> Result<String, Box<dyn Error + Send + Sync>>

Create account contract on the Exchange using alloy (must be called first)

pub async fn add_api_wallet_on_chain( &self, account_address: &str, api_wallet_address: &str, exchange_address: &str, rpc_url: &str, ) -> Result<String, Box<dyn Error + Send + Sync>>

Add API wallet to account on-chain (must be called after createAccount)

impl WalletClient

pub async fn place_order( &self, base_url: &str, symbol: &str, side: Side, price: f64, size: f64, ) -> Result<Value, Box<dyn Error + Send + Sync>>

pub async fn cancel_order( &self, base_url: &str, order_id: u64, ) -> Result<Value, Box<dyn Error + Send + Sync>>

pub async fn bulk_place_orders( &self, base_url: &str, orders: Vec<(String, Side, f64, f64)>, ) -> Result<Value, Box<dyn Error + Send + Sync>>

Place multiple orders in a single bulk request

pub async fn bulk_place_orders_with_builder( &self, base_url: &str, orders: Vec<(String, Side, f64, f64)>, builder_code_address: Option<&str>, ) -> Result<Value, Box<dyn Error + Send + Sync>>

Place multiple orders in a single bulk request with builder code for fee sharing

pub async fn bulk_cancel_orders( &self, base_url: &str, order_ids: Vec<u64>, ) -> Result<Value, Box<dyn Error + Send + Sync>>

Cancel multiple orders by order_id in a single bulk request

pub async fn place_order_raw( &self, base_url: &str, symbol: &str, side: Side, price: f64, size: f64, ) -> Result<Response, Box<dyn Error + Send + Sync>>

Place an order and return the raw HTTP response (including headers). Useful for testing rate limit headers and error responses.

pub async fn cancel_order_raw( &self, base_url: &str, order_id: u64, ) -> Result<Response, Box<dyn Error + Send + Sync>>

Cancel an order and return the raw HTTP response (including headers). Useful for testing rate limit headers and error responses.

impl WalletClient

pub async fn get_orders( &self, base_url: &str, ) -> Result<Value, Box<dyn Error + Send + Sync>>

pub async fn get_portfolio( &self, base_url: &str, ) -> Result<Value, Box<dyn Error + Send + Sync>>

impl WalletClient

pub(super) async fn sign_place_order( &self, symbol: &str, side: &str, size: &str, price: &str, tif: &str, client_id: &str, nonce: u64, ) -> Result<String, Box<dyn Error + Send + Sync>>

Sign a PlaceOrder action with EIP-712

pub(super) async fn sign_cancel_order( &self, order_id: &str, nonce: u64, ) -> Result<String, Box<dyn Error + Send + Sync>>

Sign a CancelOrder action with EIP-712

pub async fn sign_withdraw_option( &self, account: WalletAddress, symbol: &str, amount: &str, nonce: u64, ) -> Result<String, Box<dyn Error + Send + Sync>>

Sign an option withdrawal action with EIP-712.

pub async fn sign_withdraw_usdc( &self, account: WalletAddress, destination: WalletAddress, amount: &str, nonce: u64, ) -> Result<String, Box<dyn Error + Send + Sync>>

pub async fn sign_set_margin_mode( &self, margin_mode: &str, nonce: u64, ) -> Result<String, Box<dyn Error + Send + Sync>>

Sign a SetMarginMode action with EIP-712

impl WalletClient

pub async fn connect_websocket( &self, base_url: &str, with_auth: bool, ) -> Result<(), Box<dyn Error + Send + Sync>>

pub async fn subscribe_to_streams( &self, channels: Vec<&str>, ) -> Result<(), Box<dyn Error + Send + Sync>>

pub async fn get_messages(&self) -> Vec<WsMessage>

pub async fn clear_messages(&self)

pub async fn wait_for_message_type<F>( &self, check: F, timeout_ms: u64, ) -> Option<WsMessage>

where F: Fn(&WsMessage) -> bool,

pub async fn count_message_type<F>(&self, check: F) -> usize

where F: Fn(&WsMessage) -> bool,

impl WalletClient

pub async fn withdraw_option_with_nonce( &self, base_url: &str, account: WalletAddress, symbol: &str, amount: &str, nonce: u64, ) -> Result<Value, Box<dyn Error + Send + Sync>>

pub async fn withdraw_option( &self, base_url: &str, account: WalletAddress, symbol: &str, amount: &str, ) -> Result<Value, Box<dyn Error + Send + Sync>>

pub async fn withdraw_usdc_with_nonce( &self, base_url: &str, account: WalletAddress, destination: WalletAddress, amount: &str, nonce: u64, ) -> Result<Value, Box<dyn Error + Send + Sync>>

pub async fn withdraw_usdc( &self, base_url: &str, account: WalletAddress, destination: WalletAddress, amount: &str, ) -> Result<Value, Box<dyn Error + Send + Sync>>

impl WalletClient

pub async fn new(wallet_address: WalletAddress, private_key: String) -> Self

pub(super) fn next_nonce(&self) -> u64

Get next nonce for EIP-712 signatures

pub(super) fn hypercall_domain(&self) -> Eip712Domain

Get Hypercall EIP-712 domain

pub(super) fn input_error( message: impl Into<String>, ) -> Box<dyn Error + Send + Sync>

Trait Implementations

impl Clone for WalletClient

fn clone(&self) -> WalletClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WalletClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.