Enum CliError 

pub enum CliError {
    BootRefused(String),
    Aborted,
    DatabaseUpgradeRetired,
    DatabaseForeign,
    DatabaseNothingToDo,
    Database(DbError),
    Io(Error),
    Config(ConfigError),
    UnknownChain {
        chain: String,
    },
    UnknownDeployment {
        chain_id: u64,
        name: String,
    },
    InvalidBlockTag(String),
    BlockResolution(String),
    InvalidAddress(String),
    InvalidArgument(String),
    NoActiveAaveMarkets,
    PoolUpdate(Box<PoolUpdateFailure>),
    AaveUpdate(RunError),
    RuntimeNested,
    OperatorRefused(String),
    OperatorProtocol(String),
    OperatorHygiene(String),
}

A typed console failure.

Every variant carries the data the argv facade needs to render the operator-facing line through CliError::message; rendering itself is the facade’s job (ADR-051 Q1).

Variants

BootRefused(String)

The typed fleet boot refusal (FF-T1). Exits EX_CONFIG 78.

Aborted

The operator declined a confirmation prompt — the click Abort arm.

DatabaseUpgradeRetired

The database upgrade subcommand is retired: the database upgrades itself at open (ADR-052), and database heal is the explicit repair.

DatabaseForeign

The file is a foreign SQLite database — the arm refuses to adopt it.

DatabaseNothingToDo

The schema state offers nothing for this arm (e.g. cutover on an empty file with no legacy history).

Database(DbError)

Any other database failure (I/O, integrity, heal verification).

Io(Error)

A filesystem failure outside the database (e.g. database reset bootstrapping a missing state-home directory chain).

Config(ConfigError)

Driver-domain config resolution failed (ADR-051 D8).

UnknownChain

An unknown chain selector (--chain foo): the console names chain slugs (base, ethereum) or numeric chain ids.

Fields

chain: String

The rejected selector, verbatim.

UnknownDeployment

The deployments registry has no record for the resolved (chain_id, name) pair.

Fields

chain_id: u64

The resolved chain id.

name: String

The DEX name slug (the --name value).

InvalidBlockTag(String)

A malformed block identifier — the exact Invalid block tag: {tag} refusal the Python _resolve_to_block raises.

BlockResolution(String)

The RPC read that resolves a tag:offset block identifier failed.

InvalidAddress(String)

The supplied address does not parse (the click Abort arm of aave position show).

InvalidArgument(String)

A required command argument is missing or malformed (--pool-manager on --family v4, an out-of-range chain id).

NoActiveAaveMarkets

aave update found no active Aave markets (the Python DegenbotValueError).

PoolUpdate(Box<PoolUpdateFailure>)

A pool update / pool verify core failure (DB/RPC/cancelled/ verification), wrapped with the run context the arm held when the core returned it (endpoint, chain, requested range, per-exchange resume state) so the rendered diagnostic is complete.

The payload is boxed to keep the variant out of the result_large_err budget every arm’s Result shares.

AaveUpdate(RunError)

An aave core failure (DB/RPC/verification/market-not-found).

RuntimeNested

A command arm that block_ons the process-wide shared runtime was invoked from inside an existing tokio runtime. run_pool_update/run_aave_update ride get_runtime() and must not nest; the arms hold the same constraint.

OperatorRefused(String)

The operator host refused a command: the {"ok": false, "error": ...} frame, rendered as one line (ADR-051 D6).

OperatorProtocol(String)

A protocol-level failure talking to the operator host: an unreachable socket, a timed-out exchange, or a malformed/non-object/missing-ok response frame.

OperatorHygiene(String)

A client-side wire-hygiene refusal (an unknown cordon_* key, an empty posture patch, an unknown hop-family string), raised BEFORE the socket is touched. Domain validation stays server-side.

Implementations

impl CliError

pub fn message(&self) -> String

The operator-facing line for this failure.

Trait Implementations

impl Debug for CliError

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

Formats the value using the given formatter.

impl Display for CliError

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

Formats the value using the given formatter.

impl Error for CliError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<&CliError> for ExitCode

THE one CliError → ExitCode mapping site (ADR-051 D1).

fn from(err: &CliError) -> Self

Converts to this type from the input type.

impl From<CliError> for ExitCode

fn from(err: CliError) -> Self

Converts to this type from the input type.

impl From<ConfigError> for CliError

Map a config-resolution error onto its typed console failure.

fn from(err: ConfigError) -> Self

Converts to this type from the input type.

impl From<DbError> for CliError

Map a database error onto its typed console failure.

A foreign-file failure stays typed here — the facade must be able to point the operator at the right remedy without string matching.

fn from(err: DbError) -> Self

Converts to this type from the input type.