Struct BotConfig 

pub struct BotConfig {

    pub environment: String,
    pub private_key: String,
    pub address: String,
    pub vault_address: Option<String>,
    pub base_url_override: Option<String>,
    pub strategy_type: String,
    pub markets: Vec<Market>,
    pub poll_delay_ms: u64,
    pub grid: Option<GridConfigJson>,
    pub mm: Option<MMConfigJson>,
    pub dca: Option<DCAConfigJson>,
    pub arbitrage: Option<ArbitrageConfigJson>,
    pub orchestrator: Option<OrchestratorConfigJson>,
    pub builder_fee: Option<BuilderFeeConfig>,
    pub sync: Option<SyncConfigJson>,
    pub simulation: Option<SimulationConfig>,
    pub extra: HashMap<String, Value>,
}

Bot configuration - V2 format with markets array. This is the unified config format for all strategies.

Fields

environment: String

Environment: “testnet” or “mainnet”

private_key: String

Private key (hex, with or without 0x prefix). Optional — resolved at runtime from ~/.supurr/credentials.json if absent.

address: String

Wallet address. Optional — resolved at runtime from ~/.supurr/credentials.json if absent.

vault_address: Option<String>

Optional vault address

base_url_override: Option<String>

Optional Hyperliquid base URL override. When set, both /info and /exchange requests use this gateway.

strategy_type: String

Strategy type: “grid”, “mm”, “dca”, or “arbitrage”

markets: Vec<Market>

Markets to trade on (V2 format - uses bot_core::Market enum)

poll_delay_ms: u64

Polling delay in milliseconds

grid: Option<GridConfigJson>

Grid strategy configuration

mm: Option<MMConfigJson>

Market Maker strategy configuration

dca: Option<DCAConfigJson>

DCA strategy configuration

arbitrage: Option<ArbitrageConfigJson>

Arbitrage strategy configuration

orchestrator: Option<OrchestratorConfigJson>

Parent strategy configuration for grouped child strategies.

builder_fee: Option<BuilderFeeConfig>

Builder fee configuration

sync: Option<SyncConfigJson>

Trade sync configuration for upstream API PnL tracking

simulation: Option<SimulationConfig>

Simulation configuration (paper/backtest) Optional — uses sensible defaults if absent.

extra: HashMap<String, Value>

Catch-all for custom strategy configuration sections. Any JSON key that doesn’t match a named field above lands here. Custom strategies read their config via config.custom_config("mystrategy").

Implementations

impl BotConfig

pub fn primary_market(&self) -> &Market

Get the primary market from the markets array

pub fn is_spot(&self) -> bool

Check if this is a spot market

pub fn is_spot_like(&self) -> bool

Check if the primary market settles like spot with no margin/leverage.

pub fn primary_market_uses_margin(&self) -> bool

Check if the primary market uses margin/leverage.

pub fn is_outcome(&self) -> bool

Check if this is a prediction market outcome

pub fn instrument_id(&self) -> InstrumentId

Get instrument ID from primary market

pub fn market_index(&self) -> MarketIndex

Get market index from primary market

pub fn hip3_config(&self) -> Option<Hip3MarketConfig>

Get HIP-3 config if this is a HIP-3 market

pub fn custom_config<T: DeserializeOwned>( &self, strategy_name: &str, ) -> Result<T>

Get custom strategy config as typed struct. Looks up the strategy name in the extra catch-all map and deserializes.

Example

let my_config: MyConfig = config.custom_config("mystrategy")?;

pub fn from_env() -> Result<Self>

Load config from environment variables. V2 configs require a JSON file, so this returns an error.

pub fn resolve_credentials(&self) -> Result<(String, String)>

Resolve wallet credentials: use fields from config if present, otherwise fall back to ~/.supurr/credentials.json.

Returns (private_key, address).

pub fn from_file(path: &PathBuf) -> Result<Self>

Load config from a JSON file

pub fn parse_environment(&self) -> Environment

Parse environment from string

pub fn strategy_leverage(&self) -> Option<(Decimal, Decimal)>

Extract strategy leverage and max_leverage from whichever strategy config is active. Returns Some((leverage, max_leverage)) if the active strategy has leverage settings.

pub fn strategy_allocated_capital_usdc(&self) -> Option<Decimal>

Capital allocated to the active strategy, used as the performance metric base.

This is deliberately strategy-scoped. Wallet/account equity is not used here because unrelated idle wallet capital would dilute APR, Sharpe, and drawdown percentages.

pub fn effective_simulation_config(&self) -> SimulationConfig

Get the effective simulation config, falling back to defaults if absent.

Trait Implementations

impl Clone for BotConfig

fn clone(&self) -> BotConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BotConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BotConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for BotConfig

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Serialize for BotConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.