Struct HyperliquidConfig 

pub struct HyperliquidConfig {
    pub wallet: LocalWallet,
    pub network: Network,
    pub dexes: Vec<SmolStr>,
}

Configuration for the Hyperliquid execution client.

Example

use rustrade_execution::client::hyperliquid::config::HyperliquidConfig;
use std::env;

let config = HyperliquidConfig::from_env().expect("failed to load Hyperliquid config from env");

Fields

wallet: LocalWallet

The wallet containing the private key for signing (ethers LocalWallet).

network: Network

The network to trade on. Network::Mainnet trades real funds.

dexes: Vec<SmolStr>

The builder-deployed (HIP-3) perpetual DEXs the perpetuals client trades besides Hyperliquid’s default one, by the name Hyperliquid lists them under (xyz, flx), exactly as spelled there. Empty by default: only the default DEX.

The perpetuals client reads each one’s markets when it connects, and refuses to connect if Hyperliquid does not list one. A name given twice counts once. See HyperliquidClient’s HIP-3 docs. The spot client ignores this.

Each DEX adds a clearinghouseState (weight 2) and an openOrders (weight 20) request to every account snapshot, and an openOrders to every listing of open orders, against Hyperliquid’s REST limit of 1,200 a minute per IP address.

Implementations

impl HyperliquidConfig

pub fn new(wallet: LocalWallet, network: Network) -> Self

Create a new config with the given wallet on network (Network::Mainnet trades real funds), trading only Hyperliquid’s default perpetual DEX.

pub fn with_dexes<Dex: Into<SmolStr>>( self, dexes: impl IntoIterator<Item = Dex>, ) -> Self

Trade the builder-deployed (HIP-3) perpetual DEXs dexes as well, replacing any named before. See dexes.

pub fn from_env() -> Result<Self, HyperliquidConfigError>

Build a config from environment variables.

Reads:

• HYPERLIQUID_PRIVATE_KEY (required) — hex-encoded private key (with or without 0x prefix).
• HYPERLIQUID_TESTNET (optional) — "true"/"false" (case-insensitive). Absent ⇒ the safe testnet environment. Set HYPERLIQUID_TESTNET=false to target mainnet (real funds).
• HYPERLIQUID_DEXES (optional) — the HIP-3 DEXs to trade, comma-separated (xyz,flx). Spaces around a name and empty entries are ignored. Absent ⇒ none.

Errors

Returns HyperliquidConfigError (never panics):

• HYPERLIQUID_PRIVATE_KEY unset (MissingPrivateKey), non-UTF-8 (InvalidPrivateKeyVar), or not a valid key (InvalidPrivateKey);
• HYPERLIQUID_TESTNET is neither true nor false, or holds non-UTF-8 (InvalidTestnet);
• HYPERLIQUID_DEXES holds non-UTF-8 (InvalidDexes).

pub fn from_private_key( private_key: &str, network: Network, ) -> Result<Self, HyperliquidConfigError>

Create a config from a hex-encoded private key string.

The private key can have an optional “0x” prefix. Trades only Hyperliquid’s default perpetual DEX; add HIP-3 ones with with_dexes.

pub fn wallet_address_hex(&self) -> String

Returns the wallet address as a hex string (0x-prefixed).

Trait Implementations

impl Clone for HyperliquidConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HyperliquidConfig

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

Formats the value using the given formatter.