Struct HyperliquidExecClientConfig 

pub struct HyperliquidExecClientConfig {

    pub private_key: Option<String>,
    pub vault_address: Option<String>,
    pub account_address: Option<String>,
    pub base_url_ws: Option<String>,
    pub base_url_http: Option<String>,
    pub base_url_exchange: Option<String>,
    pub proxy_url: Option<String>,
    pub environment: HyperliquidEnvironment,
    pub http_timeout_secs: u64,
    pub max_retries: u32,
    pub retry_delay_initial_ms: u64,
    pub retry_delay_max_ms: u64,
    pub normalize_prices: bool,
    pub market_order_slippage_bps: u32,
    pub include_builder_attribution: bool,
    pub transport_backend: TransportBackend,
    pub ws_post_timeout_secs: u64,
    pub outcome_settlement_poll_secs: u64,
}

Configuration for the Hyperliquid execution client.

Fields

private_key: Option<String>

Private key for signing transactions.

If not provided, falls back to environment variable:

• Mainnet: HYPERLIQUID_PK
• Testnet: HYPERLIQUID_TESTNET_PK

vault_address: Option<String>

Optional vault address for vault operations.

If not provided, falls back to environment variable:

• Mainnet: HYPERLIQUID_VAULT
• Testnet: HYPERLIQUID_TESTNET_VAULT

account_address: Option<String>

Optional main account address when using an agent wallet (API sub-key). When set, used for balance queries, position reports, and WS subscriptions instead of the address derived from the private key.

If not provided and no explicit vault address is set, falls back to the HYPERLIQUID_ACCOUNT_ADDRESS environment variable.

base_url_ws: Option<String>

Override for the WebSocket URL.

base_url_http: Option<String>

Override for the HTTP info URL.

base_url_exchange: Option<String>

Override for the exchange API URL.

proxy_url: Option<String>

Optional proxy URL for HTTP and WebSocket transports.

environment: HyperliquidEnvironment

The target environment (mainnet or testnet).

http_timeout_secs: u64

HTTP timeout in seconds.

max_retries: u32

Maximum number of retry attempts for HTTP requests.

retry_delay_initial_ms: u64

Initial retry delay in milliseconds.

retry_delay_max_ms: u64

Maximum retry delay in milliseconds.

normalize_prices: bool

When true, normalize order prices to 5 significant figures before submission (Hyperliquid requirement).

market_order_slippage_bps: u32

Slippage buffer in basis points applied to MARKET orders and stop-to-limit trigger derivations. Can be overridden per-order via SubmitOrder.params["market_order_slippage_bps"].

include_builder_attribution: bool

If true, attach Nautilus builder attribution to eligible mainnet orders.

transport_backend: TransportBackend

WebSocket transport backend (Sockudo by default; Tungstenite when the transport-sockudo feature is disabled).

ws_post_timeout_secs: u64

Timeout in seconds for WebSocket post trading requests.

outcome_settlement_poll_secs: u64

Poll interval in seconds for outcomeMeta settlement detection. Disabled by default; venue Settlement fills drive HIP-4 settlement through the standard user-fills stream. Set to a non-zero value only when the venue fill stream is unavailable.

Implementations

impl HyperliquidExecClientConfig

pub fn builder() -> HyperliquidExecClientConfigBuilder

Create an instance of HyperliquidExecClientConfig using the builder syntax

impl HyperliquidExecClientConfig

pub fn has_credentials(&self) -> bool

Returns true when private key is populated and non-empty.

pub fn ws_url(&self) -> String

Returns the WebSocket URL, respecting the environment and overrides.

pub fn http_url(&self) -> String

Returns the HTTP info URL, respecting the environment and overrides.

Trait Implementations

impl ClientConfig for HyperliquidExecClientConfig

fn as_any(&self) -> &dyn Any

Return the configuration as a trait object.

impl Clone for HyperliquidExecClientConfig

fn clone(&self) -> HyperliquidExecClientConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HyperliquidExecClientConfig

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

Formats the value using the given formatter.

impl Default for HyperliquidExecClientConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HyperliquidExecClientConfig

where HyperliquidExecClientConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HyperliquidExecClientConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.