Enum ProviderError 

#[non_exhaustive]
pub enum ProviderError {
    Timeout {
        message: String,
    },
    RateLimited {
        message: String,
    },
    ConnectionFailed {
        message: String,
    },
    InvalidResponse {
        message: String,
    },
    RpcError {
        code: i64,
        message: String,
    },
    ExecutionReverted {
        code: i64,
        message: String,
    },
    InvalidBlockRange {
        from: u64,
        to: u64,
    },
    InvalidAddress {
        address: String,
        reason: String,
    },
    InvalidTopic {
        topic: String,
        reason: String,
    },
    InvalidParams {
        message: String,
    },
    AnvilError {
        message: String,
    },
    InvalidAbi {
        message: String,
    },
    EncodingError {
        message: String,
    },
    DecodingError {
        message: String,
    },
    SerializationError {
        message: String,
    },
    SubscriptionNotSupported {
        message: String,
    },
    ChainMismatch {
        expected: u64,
        actual: u64,
        endpoint: String,
    },
    Other {
        message: String,
    },
}

Errors that can occur during provider operations.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Timeout

Request timeout.

Fields

message: String

RateLimited

Rate limit exceeded.

Fields

message: String

ConnectionFailed

Connection failed.

Fields

message: String

InvalidResponse

Invalid response from RPC.

Fields

message: String

RpcError

RPC error with code and message.

Fields

code: i64

message: String

ExecutionReverted

An EVM execution revert reported by the provider (eth_call/ eth_estimateGas). Replaces the string-scraping the Python adapter seam (degenbot.provider.alloy_errors) used to perform: the JSON-RPC error code (-32000 Geth/Alchemy, -3 Anvil, etc.) is preserved alongside the message so the FFI layer can raise the degenbot-owned ContractLogicError structurally rather than by marker substring.

Fields

code: i64

message: String

InvalidBlockRange

Invalid block range.

Fields

from: u64

to: u64

InvalidAddress

Invalid Ethereum address format.

Fields

address: String

reason: String

InvalidTopic

Invalid topic format.

Fields

topic: String

reason: String

InvalidParams

Invalid parameters.

Fields

message: String

AnvilError

Anvil-specific error.

Fields

message: String

InvalidAbi

Invalid ABI.

Fields

message: String

EncodingError

Encoding error.

Fields

message: String

DecodingError

Decoding error.

Fields

message: String

SerializationError

Serialization error.

Fields

message: String

SubscriptionNotSupported

Subscription not supported (e.g., HTTP transport).

Fields

message: String

ChainMismatch

The endpoint serves a different chain than the one it was bound to.

Binding an endpoint to a chain reads eth_chainId once and refuses a disagreement here, before any pool or token I/O runs against a node that is not the chain the session declared. Not retryable: the same endpoint will keep answering with the same chain.

Fields

expected: u64

The chain the endpoint was bound to.

actual: u64

The chain the endpoint actually serves.

endpoint: String

The endpoint that was bound.

Other

Other error.

Fields

message: String

Implementations

impl ProviderError

pub const fn is_retryable(&self) -> bool

Returns true if this error is retryable (rate-limited, timeout, connection failure).

Used by the retry-with-backoff loop to decide whether to sleep and retry or surface the error immediately.

Trait Implementations

impl Clone for ProviderError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderError

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

Formats the value using the given formatter.

impl Display for ProviderError

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

Formats the value using the given formatter.

impl Error for ProviderError

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<ContractError> for ProviderError

fn from(err: ContractError) -> Self

Converts to this type from the input type.