Enum ScopeError 

pub enum ScopeError {
    Config(ConfigError),
    Chain(String),
    Venue {
        venue: String,
        message: String,
    },
    Request(Error),
    InvalidAddress(String),
    InvalidHash(String),
    IoError(Error),
    Export(String),
    Json(Error),
    Network(String),
    Api(String),
    NotFound(String),
    TokenNotFound {
        input: String,
        searched: String,
    },
    AmbiguousToken {
        input: String,
        candidates: Vec<String>,
    },
    TokenMismatch {
        symbol: String,
        chain: String,
        saved: String,
        venue_contract: String,
        venue: String,
    },
    InvalidInput(String),
    Compliance(String),
    Discovery(String),
    Contract(String),
    Other(String),
}

The primary error type for the Scope application.

This enum encompasses all error conditions that can occur during blockchain analysis operations. Each variant provides context-specific information to aid in debugging and user-friendly error messages.

Variants

Config(ConfigError)

Configuration file could not be loaded or parsed.

This includes missing files, invalid YAML syntax, or schema violations.

Chain(String)

Blockchain client encountered an error.

This covers RPC failures, unsupported chain operations, or protocol errors.

Venue

A market venue (exchange) request or capability failed.

venue is the venue id that made the request, for example bybit.

Fields

venue: String

Venue id from the descriptor.

message: String

What went wrong.

Request(Error)

HTTP request to an external API failed.

Wraps reqwest errors for network failures, timeouts, or HTTP error responses.

InvalidAddress(String)

The provided blockchain address is malformed.

Addresses must be valid for their respective chain (e.g., 0x-prefixed 40-character hex string for Ethereum).

InvalidHash(String)

The provided transaction hash is malformed.

Transaction hashes must be valid for their respective chain.

IoError(Error)

An I/O operation failed. Context goes into the error’s message (io::Error::new(e.kind(), …)); the kind stays, so callers can tell a closed pipe from a full disk.

Export(String)

Data export operation failed.

Json(Error)

JSON serialization/deserialization error.

Network(String)

Network operation failed.

Api(String)

External API returned an error.

NotFound(String)

Resource not found.

TokenNotFound

No token matches a symbol in the place that was searched.

Fields

input: String

What the user typed.

searched: String

Where scope looked, for example “DexScreener on ethereum”.

AmbiguousToken

A symbol names more than one token and scope cannot ask which one.

Fields

input: String

What the user typed.

candidates: Vec<String>

One line for each candidate: chain, contract, name.

TokenMismatch

A saved binding names a different contract than the venue lists.

Fields

symbol: String

The symbol.

chain: String

The binding’s chain.

saved: String

The saved contract.

venue_contract: String

The venue’s contract on that chain.

venue: String

The venue id.

InvalidInput(String)

The request itself is at fault and the caller can fix it: an unknown venue, or a chain that a DEX venue does not read. The message is shown as is.

Compliance(String)

Compliance or risk analysis failed.

Discovery(String)

Token discovery operation failed.

Contract(String)

Contract analysis failed.

Other(String)

Other unspecified error.

Implementations

impl ScopeError

pub fn io_context(e: Error, context: impl Display) -> Self

The one way to wrap an I/O error with what was being done: the message reads <context>: <error> and the error kind stays, so a closed pipe is still a closed pipe.

Trait Implementations

impl Debug for ScopeError

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

Formats the value using the given formatter.

impl Display for ScopeError

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

Formats the value using the given formatter.

impl Error for ScopeError

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<ConfigError> for ScopeError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for ScopeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ScopeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ScopeError

fn from(source: Error) -> Self

Converts to this type from the input type.