Module executors 

EVM executor abstractions, which can execute calls.

Used for running tests, scripts, and interacting with the inner backend which holds the state.

Re-exports

use crate::inspectors::Cheatcodes; 🔒

use crate::inspectors::CmpOperands; 🔒

use crate::inspectors::EdgeCoverage; 🔒

use crate::inspectors::EdgeIndexMap; 🔒

use crate::inspectors::InspectorData; 🔒

use crate::inspectors::InspectorStack; 🔒

use crate::inspectors::cheatcodes::BroadcastableTransactions; 🔒

use alloy_dyn_abi::DynSolValue; 🔒

use alloy_dyn_abi::FunctionExt; 🔒

use alloy_dyn_abi::JsonAbiExt; 🔒

use alloy_eips::eip4788::BEACON_ROOTS_ADDRESS; 🔒

use alloy_eips::eip4788::SYSTEM_ADDRESS; 🔒

use alloy_evm::Evm; 🔒

use alloy_json_abi::Function; 🔒

use alloy_primitives::Address; 🔒

use alloy_primitives::B256; 🔒

use alloy_primitives::Bytes; 🔒

use alloy_primitives::Log; 🔒

use alloy_primitives::TxKind; 🔒

use alloy_primitives::U256; 🔒

use alloy_primitives::keccak256; 🔒

use alloy_primitives::map::HashMap; 🔒

use alloy_sol_types::SolCall; 🔒

use alloy_sol_types::sol; 🔒

use eyre::WrapErr; 🔒

use foundry_evm_core::EvmEnv; 🔒

use foundry_evm_core::FoundryBlock; 🔒

use foundry_evm_core::FoundryChain; 🔒

use foundry_evm_core::FoundryTransaction; 🔒

use foundry_evm_core::backend::Backend; 🔒

use foundry_evm_core::backend::BackendError; 🔒

use foundry_evm_core::backend::BackendResult; 🔒

use foundry_evm_core::backend::CowBackend; 🔒

use foundry_evm_core::backend::DatabaseError; 🔒

use foundry_evm_core::backend::DatabaseExt; 🔒

use foundry_evm_core::backend::GLOBAL_FAIL_SLOT; 🔒

use foundry_evm_core::constants::CALLER; 🔒

use foundry_evm_core::constants::CHEATCODE_ADDRESS; 🔒

use foundry_evm_core::constants::CHEATCODE_CONTRACT_HASH; 🔒

use foundry_evm_core::constants::DEFAULT_CREATE2_DEPLOYER; 🔒

use foundry_evm_core::constants::DEFAULT_CREATE2_DEPLOYER_CODE; 🔒

use foundry_evm_core::constants::DEFAULT_CREATE2_DEPLOYER_DEPLOYER; 🔒

use foundry_evm_core::decode::RevertDecoder; 🔒

use foundry_evm_core::decode::SkipReason; 🔒

use foundry_evm_core::eip2935::HISTORY_STORAGE_ADDRESS; 🔒

use foundry_evm_core::eip2935::HISTORY_STORAGE_CODE; 🔒

use foundry_evm_core::eip2935::history_storage_slot; 🔒

use foundry_evm_core::eip2935::history_storage_value; 🔒

use foundry_evm_core::eip2935::history_window_start; 🔒

use foundry_evm_core::evm::ChainFor; 🔒

use foundry_evm_core::evm::EthEvmNetwork; 🔒

use foundry_evm_core::evm::EvmEnvFor; 🔒

use foundry_evm_core::evm::FoundryEvmFactory; 🔒

use foundry_evm_core::evm::FoundryEvmNetwork; 🔒

use foundry_evm_core::evm::IntoInstructionResult; 🔒

use foundry_evm_core::evm::SpecFor; 🔒

use foundry_evm_core::evm::TxEnvFor; 🔒

use foundry_evm_core::utils::StateChangeset; 🔒

use foundry_evm_coverage::HitMaps; 🔒

use foundry_evm_fuzz::ObservedCall; 🔒

use foundry_evm_networks::NetworkConfigs; 🔒

use foundry_evm_traces::SparsedTraceArena; 🔒

use foundry_evm_traces::TraceRequirements; 🔒

use revm::bytecode::Bytecode; 🔒

use revm::context::Block; 🔒

use revm::context::Cfg; 🔒

use revm::context::ContextTr; 🔒

use revm::context::Transaction; 🔒

use revm::context_interface::cfg::gas_params::Eip2780TxInfo; 🔒

use revm::context_interface::result::ExecutionResult; 🔒

use revm::context_interface::result::Output; 🔒

use revm::context_interface::result::ResultAndState; 🔒

use revm::context_interface::transaction::SignedAuthorization; 🔒

use revm::database::Database; 🔒

use revm::database::DatabaseCommit; 🔒

use revm::database::DatabaseRef; 🔒

use revm::interpreter::InstructionResult; 🔒

use revm::interpreter::gas::InitialAndFloorGas; 🔒

use revm::primitives::hardfork::SpecId; 🔒

use sancov::SancovGuard; 🔒

use std::borrow::Cow; 🔒

use std::sync::Arc; 🔒

use std::sync::atomic::AtomicBool; 🔒

use std::sync::atomic::Ordering; 🔒

use std::time::Duration; 🔒

use std::time::Instant; 🔒

use alloy_monad_evm::MonadEvmFactory; 🔒 monad

use foundry_common::SYSTEM_TRANSACTION_TYPE; 🔒 monad

use foundry_common::is_known_system_sender; 🔒 monad

use foundry_evm_core::evm::MonadEvmNetwork; 🔒 monad

use foundry_evm_core::evm::refresh_chain_journal; 🔒 monad

use foundry_evm_core::evm::try_transact_monad_system_replay; 🔒 monad

use monad_revm::MonadChainContext; 🔒 monad

use monad_revm::MonadHardfork; 🔒 monad

use revm::context::TxEnv; 🔒 monad

pub use fuzz::FuzzedExecutor;

pub use invariant::InvariantExecutor;

Modules

ITest

Module containing a contract’s types and functions.

builder 🔒

campaign 🔒

Worker-local call execution policy shared by stateless and invariant fuzz campaigns.

corpus 🔒

Corpus management for parallel fuzzing with coverage-guided mutation.

corpus_io 🔒

Shared helpers for reading on-disk corpus directories.

fuzz

invariant

sancov 🔒

showmap 🔒

AFL-afl-showmap-style corpus replay.

trace 🔒

Structs

CallResult

The result of a call.

CorpusDirEntry

A single corpus file on disk.

DeployResult

The result of a deployment.

DynamicTargetCtx

Refs used during corpus replay to register contracts deployed mid-sequence as fuzz targets, mirroring the campaign loop so follow-up calls into them aren’t dropped by can_replay_tx.

EarlyExit

Helper struct to enable early exit behavior: when one test fails or run is interrupted, all other tests stop early.

ExecutionErr

Represents the context after an execution error occurred.

Executor

EVM executor.

ExecutorBuilder

The builder that allows to configure an evm Executor which a stack of optional [revm::Inspector]s, such as Cheatcodes.

FuzzTestTimer

Timer for a fuzz test.

InvariantReplayOptions

Invariant replay settings that affect when terminal checks run.

MinimizationReplayInput

RawCallResult

The result of a raw call.

ReplayObservation

Facts observed while replaying one candidate for corpus minimization.

ShowmapOpts

Per-replay options.

ShowmapReplayTarget

Test target metadata needed to replay corpus entries.

ShowmapStats

Stats returned from a single trial replay.

StatelessReplayTarget

TracingExecutor

A default executor with tracing enabled

TracingFork

Fork state and network context used to construct a tracing executor.

Enums

EvmError

EvmExecutionCancellation 🔒

Shared cancellation state for an active EVM execution.

ReplayFailure

A structured identity for a failure observed during corpus replay.

ShowmapDomain

Which coverage bitmap(s) to dump.

Constants

DURATION_BETWEEN_METRICS_REPORT 🔒

Functions

calculate_initial_gas 🔒

Returns the intrinsic gas and EIP-7623 calldata floor of a transaction.

calculate_stipend 🔒

canonical_replay_dirs

Returns every worker*/corpus/ under root, or [root] if none exist.

collect_debug_bytecodes 🔒

convert_executed_result 🔒

Converts the data aggregated in the inspector and call to a RawCallResult.

parse_corpus_filename

Parses a corpus filename of the form <uuid>-<timestamp>.json[.gz].

persist_corpus_seed

Persists one call sequence as a corpus seed in the canonical worker0 corpus directory.

read_corpus_dir

Iterate corpus files in path, ignoring entries with unparsable names.

read_corpus_tree

Reads corpus files from a file, corpus directory, worker corpus directory, or generated corpus root such as <root>/<contract>/<test>/worker0/corpus.

replay_corpus_to_showmap

Replay every corpus entry under corpus_dir and emit showmap files.

replay_sequence_for_minimization

Replays one candidate input and returns coverage/failure facts for minimizers.

should_ignore_revert

Returns whether a nested revert can be ignored when fail-on-revert is disabled.

worker_seed 🔒

Derives the deterministic RNG seed for a fuzz or invariant worker.