Enum CacheError 

pub enum CacheError {
    Runtime(RuntimeError),
    Rpc(RpcError),
    Persistence(PersistenceError),
    MissingStorageBatchFetcher,
    MissingAccountFieldsFetcher,
    ReconcileFetchFailed {
        requested: usize,
    },
    AccountFetch {
        address: Address,
        details: String,
    },
    CodeSeedConflict {
        address: Address,
        cached: B256,
        seeded: B256,
    },
    CodeSeedEmpty {
        address: Address,
    },
    StorageRead {
        address: Address,
        slot: U256,
        details: String,
    },
    StorageInsert {
        address: Address,
        slot: U256,
        details: String,
    },
    TxEnv {
        details: String,
    },
    Transact {
        details: String,
    },
    CallNotSuccessful {
        result: String,
    },
    TraceParse {
        details: String,
    },
    Decode {
        what: &'static str,
        details: String,
    },
    SolCallFailed {
        signature: &'static str,
        from: Address,
        to: Address,
        result: String,
    },
    SolCallDecode {
        signature: &'static str,
        from: Address,
        to: Address,
        output_len: usize,
        details: String,
    },
    DeploymentMissingAddress,
    DeploymentReverted {
        output_hex: String,
    },
    DeploymentHalted {
        reason: String,
    },
    MissingSourceBytecode {
        source_address: Address,
    },
    MissingRuntimeCode {
        role: &'static str,
        address: Address,
    },
    MissingTargetAccount {
        target: Address,
    },
    TargetAccountFetch {
        target: Address,
        details: String,
    },
}

General cache-operation error for APIs that execute or mutate local fork state but do not classify EVM reverts as SimError.

Variants

Runtime(RuntimeError)

Runtime precondition failure.

Rpc(RpcError)

Direct RPC callback failure.

Persistence(PersistenceError)

On-disk persistence failure.

MissingStorageBatchFetcher

A storage verification/reconciliation path had no batch fetcher.

MissingAccountFieldsFetcher

Code-seed verification had pending seeds but no account-fields fetcher.

ReconcileFetchFailed

Reconciliation could not fetch any requested slot, so it cannot prove the local state fresh.

Fields

requested: usize

Number of requested slots.

AccountFetch

Account fetch failed.

Fields

address: Address

Account address.

details: String

Backend/provider error text.

CodeSeedConflict

A canonical code seed contradicts code already fetched from the chain.

Chain-fetched state is authoritative over templates: the seed is rejected and the cached code is left untouched. If the caller believes the chain has moved (e.g. a redeploy), purge the account first and re-seed.

Fields

address: Address

Account address.

cached: B256

Code hash of the RPC-origin code already in the cache.

seeded: B256

Code hash of the rejected seed.

CodeSeedEmpty

A code seed/etch was given empty bytes; claiming an address is code-less is not a supported seed (that is what verification’s codeless classification reports).

Fields

address: Address

Account address.

StorageRead

Storage read failed.

Fields

address: Address

Contract address.

slot: U256

Storage slot.

details: String

Backend/provider error text.

StorageInsert

Storage insert failed.

Fields

address: Address

Contract address.

slot: U256

Storage slot.

details: String

Backend error text.

TxEnv

Transaction environment construction failed.

Fields

details: String

Builder error text.

Transact

revm returned a host/database transaction error.

Fields

details: String

revm/database error text.

CallNotSuccessful

A helper that requires a successful EVM call observed a revert or halt.

Fields

result: String

Debug rendering of the execution result.

TraceParse

A debug/trace RPC response could not be parsed into the cache’s typed block state-diff representation.

Fields

details: String

Parser error text.

Decode

ABI or helper-specific decode failure.

Fields

what: &'static str

Human-readable decode target.

details: String

Decoder error text.

SolCallFailed

A typed Solidity call executed but did not succeed.

Fields

signature: &'static str

Solidity function signature.

from: Address

Call sender.

to: Address

Call target.

result: String

Debug rendering of the execution result.

SolCallDecode

A typed Solidity call returned malformed data.

Fields

signature: &'static str

Solidity function signature.

from: Address

Call sender.

to: Address

Call target.

output_len: usize

Return-data length in bytes.

details: String

Decoder error text.

DeploymentMissingAddress

Deployment succeeded without a created address.

DeploymentReverted

Deployment reverted.

Fields

output_hex: String

Hex-encoded revert output.

DeploymentHalted

Deployment halted.

Fields

reason: String

Debug rendering of the halt reason.

MissingSourceBytecode

Source account did not contain bytecode for an override.

Fields

source_address: Address

Source address.

MissingRuntimeCode

Runtime bytecode was required but absent or empty.

Fields

role: &'static str

Account role in the operation.

address: Address

Account address.

MissingTargetAccount

Target account was required but absent.

Fields

target: Address

Target address.

TargetAccountFetch

Target account fetch failed while validating an override target.

Fields

target: Address

Target address.

details: String

Backend/provider error text.

Implementations

impl CacheError

pub fn tx_env(source: impl Debug) -> Self

Convert a transaction-builder error into CacheError::TxEnv.

pub fn transact(source: impl Debug) -> Self

Convert a revm host/database transaction error into CacheError::Transact.

Trait Implementations

impl Debug for CacheError

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

Formats the value using the given formatter.

impl Display for CacheError

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

Formats the value using the given formatter.

impl Error for CacheError

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<CacheError> for SimHostError

fn from(source: CacheError) -> Self

Converts to this type from the input type.

impl From<CacheError> for MulticallError

fn from(source: CacheError) -> Self

Converts to this type from the input type.

impl From<CacheError> for DeployError

fn from(source: CacheError) -> Self

Converts to this type from the input type.

impl From<CacheError> for SimError

fn from(e: CacheError) -> Self

Converts to this type from the input type.

impl From<PersistenceError> for CacheError

fn from(source: PersistenceError) -> Self

Converts to this type from the input type.

impl From<RpcError> for CacheError

fn from(source: RpcError) -> Self

Converts to this type from the input type.

impl From<RuntimeError> for CacheError

fn from(source: RuntimeError) -> Self

Converts to this type from the input type.