Trait NestedEvm 

pub trait NestedEvm {
    type Spec;
    type Block;
    type Tx;

    // Required methods
    fn journal_inner_mut(&mut self) -> &mut JournaledState;
    fn run_execution(
        &mut self,
        frame: FrameInput,
    ) -> Result<FrameResult, EVMError<DatabaseError>>;
    fn transact_raw(
        &mut self,
        tx: Self::Tx,
    ) -> Result<ResultAndState<HaltReason>, EVMError<DatabaseError>>;
    fn to_evm_env(&self) -> EvmEnv<Self::Spec, Self::Block>;
}

Object-safe trait exposing the operations that cheatcode nested EVM closures need.

This abstracts over the concrete EVM type (FoundryEvm, future TempoEvm, etc.) so that cheatcode impls can build and run nested EVMs without knowing the concrete type.

Required Associated Types

type Spec

The spec type.

type Block

The block environment type.

type Tx

The transaction environment type.

Required Methods

fn journal_inner_mut(&mut self) -> &mut JournaledState

Returns a mutable reference to the journal inner state (JournaledState).

fn run_execution( &mut self, frame: FrameInput, ) -> Result<FrameResult, EVMError<DatabaseError>>

Runs a single execution frame (create or call) through the EVM handler loop.

fn transact_raw( &mut self, tx: Self::Tx, ) -> Result<ResultAndState<HaltReason>, EVMError<DatabaseError>>

Executes a full transaction with the given tx env.

fn to_evm_env(&self) -> EvmEnv<Self::Spec, Self::Block>

Implementations on Foreign Types

impl<'db, I: FoundryInspectorExt<EthEvmContext<&'db mut dyn DatabaseExt<EthEvmFactory>>>> NestedEvm for Evm<EthEvmContext<&'db mut dyn DatabaseExt<EthEvmFactory>>, I, EthInstructions<EthInterpreter, EthEvmContext<&'db mut dyn DatabaseExt<EthEvmFactory>>>, PrecompilesMap, EthFrame<EthInterpreter>>

type Spec = SpecId

type Block = BlockEnv

type Tx = TxEnv

fn journal_inner_mut(&mut self) -> &mut JournaledState

fn run_execution( &mut self, frame: FrameInput, ) -> Result<FrameResult, EVMError<DatabaseError>>

fn transact_raw( &mut self, tx: Self::Tx, ) -> Result<ResultAndState<HaltReason>, EVMError<DatabaseError>>

fn to_evm_env(&self) -> EvmEnv<Self::Spec, Self::Block>

impl<'db, I: FoundryInspectorExt<OpContext<&'db mut dyn DatabaseExt<OpEvmFactory>>>> NestedEvm for OpEvm<OpContext<&'db mut dyn DatabaseExt<OpEvmFactory>>, I, EthInstructions<EthInterpreter, OpContext<&'db mut dyn DatabaseExt<OpEvmFactory>>>, PrecompilesMap>

type Spec = OpSpecId

type Block = BlockEnv

type Tx = OpTransaction<TxEnv>

fn journal_inner_mut(&mut self) -> &mut JournaledState

fn run_execution( &mut self, frame: FrameInput, ) -> Result<FrameResult, EVMError<DatabaseError>>

fn transact_raw( &mut self, tx: Self::Tx, ) -> Result<ResultAndState<HaltReason>, EVMError<DatabaseError>>

fn to_evm_env(&self) -> EvmEnv<Self::Spec, Self::Block>

impl<'db, I: FoundryInspectorExt<TempoContext<&'db mut dyn DatabaseExt<TempoEvmFactory>>>> NestedEvm for TempoEvm<&'db mut dyn DatabaseExt<TempoEvmFactory>, I>

type Spec = TempoHardfork

type Block = TempoBlockEnv

type Tx = TempoTxEnv

fn journal_inner_mut(&mut self) -> &mut JournaledState

fn run_execution( &mut self, frame: FrameInput, ) -> Result<FrameResult, EVMError<DatabaseError>>

fn transact_raw( &mut self, tx: Self::Tx, ) -> Result<ResultAndState<HaltReason>, EVMError<DatabaseError>>

fn to_evm_env(&self) -> EvmEnv<Self::Spec, Self::Block>

Implementors