Struct LighterRawHttpClient 

pub struct LighterRawHttpClient { /* private fields */ }

Raw HTTP client for Lighter REST API operations.

This client owns the transport, base URL, default headers, and rate limit. Methods map directly to venue endpoints and return venue response models without converting to Nautilus domain types.

Implementations

impl LighterRawHttpClient

pub fn new( environment: LighterEnvironment, base_url: Option<String>, timeout_secs: u64, proxy_url: Option<String>, ) -> LighterHttpResult<Self>

Creates a new LighterRawHttpClient.

Errors

Returns an error if the underlying HTTP client cannot be created.

pub fn new_with_quotas( environment: LighterEnvironment, base_url: Option<String>, timeout_secs: u64, proxy_url: Option<String>, default_quota: Quota, tx_rate_limiter: Option<Arc<LighterTxRateLimiter>>, ) -> LighterHttpResult<Self>

Creates a new LighterRawHttpClient with an explicit read quota and an optional shared transaction limiter.

default_quota governs the REST read bucket (LIGHTER_REST_BUCKET), resolved from the client’s configured rest_quota_per_min (detected tier only logs hints). tx_rate_limiter paces sendTx / sendTxBatch; the execution client shares one limiter across this and the WebSocket sendTx path so their combined rate honours the single venue tx bucket. The data client passes None (it sends no transactions).

Errors

Returns an error if the underlying HTTP client cannot be created.

pub fn base_url(&self) -> &str

Returns the configured REST base URL.

pub const fn environment(&self) -> LighterEnvironment

Returns the configured Lighter environment.

pub fn set_base_url(&mut self, base_url: &str)

Overrides the REST base URL. Intended for mock-server tests.

pub fn set_retry_manager( &mut self, retry_manager: RetryManager<LighterHttpError>, )

Overrides the retry manager. Intended for mock-server tests that need shorter backoff than [create_http_retry_manager] produces.

pub async fn get_order_books( &self, query: &LighterOrderBooksQuery, ) -> LighterHttpResult<LighterOrderBooks>

Calls GET /api/v1/orderBooks.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_order_book_details( &self, query: &LighterOrderBookDetailsQuery, ) -> LighterHttpResult<LighterOrderBookDetails>

Calls GET /api/v1/orderBookDetails.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_order_book_orders( &self, query: &LighterOrderBookOrdersQuery, ) -> LighterHttpResult<LighterOrderBookOrders>

Calls GET /api/v1/orderBookOrders.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_recent_trades( &self, query: &LighterRecentTradesQuery, ) -> LighterHttpResult<LighterTrades>

Calls GET /api/v1/recentTrades.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_trades( &self, query: &LighterTradesQuery, ) -> LighterHttpResult<LighterTrades>

Calls GET /api/v1/trades.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_candles( &self, query: &LighterCandlesQuery, ) -> LighterHttpResult<LighterCandles>

Calls GET /api/v1/candles.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_fundings( &self, query: &LighterFundingsQuery, ) -> LighterHttpResult<LighterFundings>

Calls GET /api/v1/fundings.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_account( &self, query: &LighterAccountQuery, ) -> LighterHttpResult<LighterAccountsResponse>

Calls GET /api/v1/account.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_account_active_orders( &self, query: &LighterAccountActiveOrdersQuery, ) -> LighterHttpResult<LighterOrders>

Calls GET /api/v1/accountActiveOrders.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_account_inactive_orders( &self, query: &LighterAccountInactiveOrdersQuery, ) -> LighterHttpResult<LighterOrders>

Calls GET /api/v1/accountInactiveOrders.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_next_nonce( &self, query: &LighterNextNonceQuery, ) -> LighterHttpResult<LighterNextNonce>

Calls GET /api/v1/nextNonce.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn get_maker_only_api_keys( &self, query: &LighterMakerOnlyApiKeysQuery, ) -> LighterHttpResult<LighterMakerOnlyApiKeys>

Calls GET /api/v1/getMakerOnlyApiKeys.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn send_tx( &self, request: &LighterSendTxRequest, ) -> LighterHttpResult<LighterSendTxResponse>

Calls POST /api/v1/sendTx.

Errors

Returns an error if the request fails or the response is invalid.

pub async fn send_tx_batch( &self, request: &LighterSendTxBatchRequest, ) -> LighterHttpResult<LighterSendTxBatchResponse>

Calls POST /api/v1/sendTxBatch.

Errors

Returns an error if the request fails or the response is invalid.

Trait Implementations

impl Clone for LighterRawHttpClient

fn clone(&self) -> LighterRawHttpClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LighterRawHttpClient

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

Formats the value using the given formatter.

impl Default for LighterRawHttpClient

fn default() -> Self

Returns the “default value” for a type.