evm-fork-cache 0.2.1

Forked EVM state cache, snapshots, overlays, and simulation utilities for EVM search
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! The typed error surface for cold-start runs.

use crate::errors::CacheError;

/// A hard error that aborts a cold-start round or run.
///
/// Deliberately typed (no blanket dynamic-error arm): composed-primitive
/// errors are converted explicitly at call sites via [`ColdStartError::Fetch`], so
/// a partial round's outcomes are never silently collapsed.
#[derive(Debug, thiserror::Error)]
pub enum ColdStartError {
    /// A round declared verify/probe slots but the cache has no storage batch
    /// fetcher configured.
    #[error("cold-start requires a storage batch fetcher")]
    NoBatchFetcher,
    /// A round declared probe-roots accounts but the cache has no account proof
    /// fetcher configured.
    #[error("cold-start requires an account proof fetcher")]
    NoAccountProofFetcher,
    /// The cache holds pending code seeds but has no account-fields fetcher to
    /// verify them with (fires only for pending-bearing rounds).
    #[error("cold-start code-seed verification requires an account fields fetcher")]
    NoAccountFieldsFetcher,
    /// The planner kept returning `Continue` past `max_rounds` executed rounds.
    #[error("cold-start round budget exceeded ({max_rounds})")]
    RoundBudgetExceeded {
        /// The configured maximum number of executed rounds.
        max_rounds: usize,
    },
    /// A composed fetch/call error, carrying the underlying cause explicitly.
    #[error("cold-start fetch error: {0}")]
    Fetch(#[source] CacheError),
}