Module inspector 

Cheatcode EVM inspector.

Re-exports

use crate::Cheatcode; 🔒

use crate::CheatcodesCore; 🔒

use crate::CheatsConfig; 🔒

use crate::CheatsCtxt; 🔒

use crate::Error; 🔒

use crate::Result; 🔒

use crate::Vm; 🔒

use crate::Vm::AccountAccess; 🔒

use crate::evm::DealRecord; 🔒

use crate::evm::GasRecord; 🔒

use crate::evm::RecordAccess; 🔒

use crate::evm::append_storage_access; 🔒

use crate::evm::journaled_account; 🔒

use crate::evm::mark_account_accesses_reverted; 🔒

use crate::evm::merge_recorded_frame; 🔒

use crate::evm::mock; 🔒

use crate::evm::mock::MockCallDataContext; 🔒

use crate::evm::mock::MockCallReturnData; 🔒

use crate::evm::prank::Prank; 🔒

use crate::expected_emit; 🔒

use crate::expected_emit::ExpectedEmitTracker; 🔒

use crate::inspector::utils::CommonCreateInput; 🔒

use crate::script::Broadcast; 🔒

use crate::test::assume::AssumeNoRevert; 🔒

use crate::test::expect; 🔒

use crate::test::expect::ExpectedCallTracker; 🔒

use crate::test::expect::ExpectedCreate; 🔒

use crate::test::expect::ExpectedRevert; 🔒

use crate::test::expect::ExpectedRevertKind; 🔒

use crate::test::revert_handlers; 🔒

use crate::utils::IgnoredTraces; 🔒

use alloy_consensus::BlobTransactionSidecarVariant; 🔒

use alloy_network::Ethereum; 🔒

use alloy_network::Network; 🔒

use alloy_network::TransactionBuilder; 🔒

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::hex; 🔒

use alloy_primitives::hex; 🔒

use alloy_primitives::map::HashMap; 🔒

use alloy_primitives::map::HashSet; 🔒

use alloy_sol_types::SolCall; 🔒

use alloy_sol_types::SolInterface; 🔒

use foundry_common::FoundryTransactionBuilder; 🔒

use foundry_common::SELECTOR_LEN; 🔒

use foundry_common::TransactionMaybeSigned; 🔒

use foundry_common::mapping_slots::MappingSlots; 🔒

use foundry_common::mapping_slots::PendingMappingHash; 🔒

use foundry_common::mapping_slots::capture_hash as capture_mapping_hash; 🔒

use foundry_common::mapping_slots::record_hash as record_mapping_hash; 🔒

use foundry_common::mapping_slots::step as mapping_step; 🔒

use foundry_evm_core::Breakpoints; 🔒

use foundry_evm_core::EvmEnv; 🔒

use foundry_evm_core::FoundryTransaction; 🔒

use foundry_evm_core::InspectorExt; 🔒

use foundry_evm_core::abi::Vm::stopExpectSafeMemoryCall; 🔒

use foundry_evm_core::backend::ContextUpdateFor; 🔒

use foundry_evm_core::backend::DatabaseError; 🔒

use foundry_evm_core::backend::DatabaseExt; 🔒

use foundry_evm_core::backend::JournaledState; 🔒

use foundry_evm_core::backend::LocalForkId; 🔒

use foundry_evm_core::backend::RevertDiagnostic; 🔒

use foundry_evm_core::constants::CHEATCODE_ADDRESS; 🔒

use foundry_evm_core::constants::HARDHAT_CONSOLE_ADDRESS; 🔒

use foundry_evm_core::constants::MAGIC_ASSUME; 🔒

use foundry_evm_core::env::FoundryContextExt; 🔒

use foundry_evm_core::evm::BlockEnvFor; 🔒

use foundry_evm_core::evm::ChainFor; 🔒

use foundry_evm_core::evm::EthEvmNetwork; 🔒

use foundry_evm_core::evm::EvmFactoryFor; 🔒

use foundry_evm_core::evm::FoundryContextFor; 🔒

use foundry_evm_core::evm::FoundryEvmFactory; 🔒

use foundry_evm_core::evm::FoundryEvmNetwork; 🔒

use foundry_evm_core::evm::NestedEvmClosureFor; 🔒

use foundry_evm_core::evm::SpecFor; 🔒

use foundry_evm_core::evm::TransactionRequestFor; 🔒

use foundry_evm_core::evm::TxEnvFor; 🔒

use foundry_evm_core::evm::with_inherited_evm; 🔒

use foundry_evm_traces::TracingInspector; 🔒

use foundry_evm_traces::TracingInspectorConfig; 🔒

use foundry_evm_traces::identifier::SignaturesIdentifier; 🔒

use itertools::Itertools; 🔒

use rand::Rng; 🔒

use revm::Inspector; 🔒

use revm::JournalEntry; 🔒

use revm::bytecode::opcode as op; 🔒

use revm::context::Cfg; 🔒

use revm::context::ContextTr; 🔒

use revm::context::Host; 🔒

use revm::context::JournalTr; 🔒

use revm::context::Transaction; 🔒

use revm::context::TransactionType; 🔒

use revm::context::result::EVMError; 🔒

use revm::context_interface::CreateScheme; 🔒

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

use revm::handler::FrameResult; 🔒

use revm::interpreter::CallInput; 🔒

use revm::interpreter::CallInputs; 🔒

use revm::interpreter::CallOutcome; 🔒

use revm::interpreter::CallScheme; 🔒

use revm::interpreter::CallValue; 🔒

use revm::interpreter::CreateInputs; 🔒

use revm::interpreter::CreateOutcome; 🔒

use revm::interpreter::FrameInput; 🔒

use revm::interpreter::Gas; 🔒

use revm::interpreter::InstructionResult; 🔒

use revm::interpreter::Interpreter; 🔒

use revm::interpreter::InterpreterAction; 🔒

use revm::interpreter::InterpreterResult; 🔒

use revm::interpreter::interpreter_types::Jumps; 🔒

use revm::interpreter::interpreter_types::LoopControl; 🔒

use revm::interpreter::interpreter_types::MemoryTr; 🔒

use revm::interpreter::interpreter_types::ReturnData; 🔒

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

use std::cmp::max; 🔒

use std::collections::BTreeMap; 🔒

use std::collections::VecDeque; 🔒

use std::fmt::Debug; 🔒

use std::fmt::Debug; 🔒

use std::ops::Range; 🔒

use std::sync::Arc; 🔒

use std::sync::OnceLock; 🔒

Modules

analysis

Cheatcode information, extracted from the syntactic and semantic analysis of the sources.

env_overrides 🔒

Cheatcode overrides of the BASEFEE, GASPRICE and BLOBHASH opcode values.

utils 🔒

Macros

try_or_return 🔒

Structs

ActiveStorageHook 🔒

ArbitraryStorage

Holds data about arbitrary storage.

BroadcastableTransaction

Helps collecting transactions from different forks.

CheatcodeAnalysis

Provides cached, on-demand syntactic and semantic analysis of a completed Compiler instance.

Cheatcodes

An EVM inspector that handles calls to various cheatcodes, each with their own behavior.

CreatedAccountChange 🔒

CreatedAccountsFrame 🔒

CreatedAccountsSnapshot 🔒

EnvOverrideState

Per-fork environment overrides and their state-snapshot copies.

GasMetering

Holds gas metering state.

RecordDebugStepInfo

StorageHook

A callback registered for a storage access hook.

StorageHookInspectorState 🔒

TransparentCheatcodesExecutor 🔒

Basic implementation of CheatcodesExecutor that simply returns the Cheatcodes instance as an inspector.

Enums

CreatedAccountsFrameKind 🔒

PendingStorageHook 🔒

Traits

CheatcodesExecutor

Helper trait for running nested EVM operations from inside cheatcode implementations.

Functions

access_is_call 🔒

Returns true if the kind of account access is a call.

apply_authorization_nonces 🔒

Increments the nonce of every authority whose authorization would be applied on-chain.

apply_dispatch 🔒

Dispatches the cheatcode call to the appropriate function.

cheatcode_id 🔒

cheatcode_of 🔒

Returns the spec::Cheatcode definition for a given spec::CheatcodeDef implementor.

cheatcode_signature 🔒

disallowed_mem_write 🔒

Helper that expands memory, stores a revert string pertaining to a disallowed memory write, and sets the return range to the revert string’s location in memory.

exec_create 🔒

Builds a sub-EVM from the current context and executes the given CREATE frame.

frame_gas 🔒

record_logs 🔒

Records a log into the recorded logs vector, if it exists.

will_exit 🔒

Helper function to check if frame execution will exit.

Type Aliases

BroadcastableTransactions

List of transactions that can be broadcasted.