Struct CliContext 

pub struct CliContext<'a> { /* private fields */ }

The resolved inputs a console command runs against.

Implementations

impl<'a> CliContext<'a>

pub fn new(env: &'a dyn EnvVars) -> Self

A context over env with no CLI overrides (file + env + defaults only).

pub fn with_database(self, database: impl Into<String>) -> Self

Set the --database override (highest-precedence layer).

pub fn with_chain_id(self, chain_id: impl Into<String>) -> Self

Set the --chain-id override.

pub fn with_node(self, uri: impl Into<String>, transport: NodeTransport) -> Self

Set one --node override: an explicit endpoint for the transport its own value classified as (ADR-062 D6). The flag cannot name a transport its value does not carry, so each occurrence fills exactly one slot.

pub fn with_node_overrides(self, nodes: NodeOverrides) -> Self

Set every explicit endpoint at once (a caller that classified a whole argv vector itself, e.g. the repeatable --node).

pub fn with_config(self, path: impl Into<String>) -> Self

Set the --config override (the typed config file the strategy verbs read and write).

pub fn env(&self) -> &'a dyn EnvVars

The env seam (the loaders’ only env reader).

pub fn database_override(&self) -> Option<&str>

The --database override, if any.

pub fn node_overrides(&self) -> &NodeOverrides

The explicit node endpoints the argv facade threaded in.

pub fn config_file(&self) -> Option<PathBuf>

The config file the driver-domain resolvers read: the --config override when given, else the standard path — DEGENBOT_CONFIG (honored even when the file is missing: the operator asked for it) else the XDG/HOME config file when it exists. None means the context has no file layer at all, which is contractually the schema defaults.

pub fn loaded_config(&self) -> Result<&LoadedConfig, CliError>

The four layers loaded once per context: the file layer (Self::config_file) over the env seam, plus the declared defaults. Every driver-domain resolver reads this value, so a command resolves its database path, chain id, and endpoints against ONE load.

Errors

crate::error::CliError::Config carrying the loader’s fail-closed degenbot_config::ConfigError when a file the operator named is unreadable, unparsable, or holds an invalid value.

pub fn database_path(&self) -> Result<Resolved<PathBuf>, CliError>

Resolve the database path: --database > DEGENBOT_DB_PATH > database.path > the state-home default. The env seam supplies HOME / $XDG_STATE_HOME for the ~ expansion of the default.

Errors

crate::error::CliError::Config when the context’s config layers do not load.

pub fn chain_id(&self) -> Result<Resolved<u64>, CliError>

Resolve the session chain id: --chain-id > DEGENBOT_DEFAULT_CHAIN_ID

session.chain_id.

Errors

crate::error::CliError::Config when no layer named a chain, when the explicit value is not an integer, or when the config layers do not load.

pub fn node_request_uri_for( &self, chain_id: u64, ) -> Result<Resolved<String>, CliError>

Resolve the node URI a REQUEST consumer uses for chain_id: ipc, then ws, then http (ADR-062 D3).

The updater arms resolve the chain they actually operate on (which may differ from the session chain id, e.g. a validated Aave deployment).

Errors

crate::error::CliError::Config when no layer supplied an endpoint for the chain, or when the config layers do not load.

pub fn node_request_uri(&self) -> Result<Resolved<String>, CliError>

Resolve the node URI a REQUEST consumer uses for the session chain id.

Errors

crate::error::CliError::Config when the chain id or the endpoint is unresolved, or when the config layers do not load.

pub fn node_subscription_uri(&self) -> Result<Resolved<String>, CliError>

Resolve the node URI a SUBSCRIPTION consumer uses for the session chain id: ipc or ws, never http (ADR-062 D3 — a feed never polls).

Errors

crate::error::CliError::Config when the chain id or the feed endpoint is unresolved, or when the config layers do not load.

pub fn resolve_config_file(&self) -> Result<PathBuf, CliError>

Resolve the config file the strategy verbs write to: the --config override, else the DEGENBOT_CONFIG env var (honored even when the file is absent — the operator asked for it), else the XDG config home (a write there creates the file). No home and no override is a typed refusal, never a silent skip.

Errors

[CliError::Config]-carrying crate::error::CliError when no config location resolves at all.

pub fn load_bot_config(&self) -> Result<LoadedConfig, CliError>

Load the typed config over this context’s env + the resolved file.

Errors

The loader’s fail-closed degenbot_config::ConfigError wrapped in crate::error::CliError::InvalidArgument.

pub fn load_bot_config_at(&self, file: &Path) -> Result<LoadedConfig, CliError>

Load the typed config over this context’s env + an explicit file. An absent file is the empty default config (a first write creates it); an existing-but-unreadable file surfaces the loader’s refusal.

Errors

The loader’s fail-closed degenbot_config::ConfigError wrapped in crate::error::CliError::InvalidArgument.