Struct BitrouterConfig 

pub struct BitrouterConfig {
    pub server: ServerConfig,
    pub database: DatabaseConfig,
    pub guardrails: GuardrailConfig,
    pub solana_rpc_url: Option<String>,
    pub mpp: Option<MppConfig>,
    pub wallet: Option<WalletConfig>,
    pub inherit_defaults: bool,
    pub providers: HashMap<String, ProviderConfig>,
    pub models: HashMap<String, ModelConfig>,
    pub tools: HashMap<String, ToolConfig>,
    pub agents: HashMap<String, AgentConfig>,
    pub routing: HashMap<String, RoutingRuleConfig>,
}

Root configuration file, typically bitrouter.yaml.

Fields

server: ServerConfig

database: DatabaseConfig

Database configuration.

guardrails: GuardrailConfig

Guardrails configuration — content inspection firewall for AI traffic.

solana_rpc_url: Option<String>

Solana RPC endpoint used for Swig wallet operations.

mpp: Option<MppConfig>

MPP (Machine Payment Protocol) configuration.

wallet: Option<WalletConfig>

OWS (Open Wallet Standard) wallet configuration.

When set, the OWS wallet is used for policy-gated signing in place of raw private keys. Requires the wallet-ows feature.

inherit_defaults: bool

When true (the default), built-in provider definitions are merged into the provider set before user overrides are applied. Set to false to use only the providers declared in the config file.

providers: HashMap<String, ProviderConfig>

Provider definitions (merged on top of built-in providers).

models: HashMap<String, ModelConfig>

Model routing definitions.

tools: HashMap<String, ToolConfig>

Tool routing definitions.

agents: HashMap<String, AgentConfig>

Agent definitions (ACP-compatible coding agents).

routing: HashMap<String, RoutingRuleConfig>

Content-based auto-routing rules.

Each key is a virtual model name (e.g. "auto") that triggers content-aware classification when a request targets it. The rule maps detected signals and complexity levels to concrete model names defined in the models section.

Implementations

impl BitrouterConfig

pub fn has_configured_providers(&self) -> bool

Returns true if at least one provider has an API key configured.

pub fn configured_provider_names(&self) -> Vec<String>

Returns the names of providers that have API keys configured.

pub fn load_from_file(path: &Path, env_file: Option<&Path>) -> Result<Self>

Full config loading pipeline:

1. Read and parse YAML
2. Load .env file (provided externally by the runtime)
3. Substitute ${VAR} references in all string values
4. Merge user providers on top of the built-in registry
5. Resolve derives chains
6. Apply env_prefix auto-overrides

pub fn load_from_str(raw: &str, env_file: Option<&Path>) -> Result<Self>

Loads from an in-memory YAML string (useful for testing).

The optional env_file path is resolved by the caller (runtime layer).

Trait Implementations

impl Clone for BitrouterConfig

fn clone(&self) -> BitrouterConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BitrouterConfig

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

Formats the value using the given formatter.

impl Default for BitrouterConfig

fn default() -> BitrouterConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BitrouterConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BitrouterConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.