Trait NestedEvm 

pub trait NestedEvm {
    type Spec;
    type Block;
    type Tx: FoundryTransaction;
    type Chain: FoundryChain<Self::Tx>;
    type Journal: FoundryJournal;

    // Required methods
    fn journal_inner_mut(&mut self) -> &mut JournaledState;
    fn tx_mut(&mut self) -> &mut Self::Tx;
    fn chain_mut(&mut self) -> &mut Self::Chain;
    fn journal_mut(&mut self) -> &mut Self::Journal;
    fn run_execution(
        &mut self,
        frame: FrameInput,
    ) -> Result<FrameResult, EVMError<DatabaseError>>;
    fn transact_raw(
        &mut self,
        tx: Self::Tx,
    ) -> Result<ResultAndState<HaltReason>>;
    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: FoundryTransaction

The transaction environment type.

type Chain: FoundryChain<Self::Tx>

Chain context identifying the active transaction position.

type Journal: FoundryJournal

The Journal type, which may own Monad’s reserve-balance-tracker state.

Required Methods

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

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

fn tx_mut(&mut self) -> &mut Self::Tx

Returns a mutable reference to the transaction environment.

fn chain_mut(&mut self) -> &mut Self::Chain

Returns a mutable reference to the chain-position context.

fn journal_mut(&mut self) -> &mut Self::Journal

Returns a mutable reference to the Journal.

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>>

Executes a full transaction with the given tx env.

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

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl<'db, I: FoundryInspectorExt<EthEvmContext<&'db mut dyn DatabaseExt<EthEvmFactory>>>> NestedEvm for EthRevmEvm<'db, I>

type Spec = SpecId

type Block = BlockEnv

type Tx = TxEnv

type Chain = ()

type Journal = Journal<&'db mut dyn DatabaseExt<EthEvmFactory, Error = DatabaseError>>

impl<'db, I: FoundryInspectorExt<MonadContext<&'db mut dyn DatabaseExt<MonadEvmFactory>>>> NestedEvm for MonadRevmEvm<'db, I>

Available on crate feature monad only.

type Spec = MonadHardfork

type Block = BlockEnv

type Tx = TxEnv

type Chain = MonadChainContext

type Journal = MonadJournal<&'db mut dyn DatabaseExt<MonadEvmFactory, Error = DatabaseError>>

impl<'db, I: FoundryInspectorExt<OpEvmContext<&'db mut dyn DatabaseExt<OpEvmFactory>>>> NestedEvm for OpRevmEvm<'db, I>

Available on crate feature optimism only.

type Spec = OpSpecId

type Block = BlockEnv

type Tx = OpTx

type Chain = L1BlockInfo

type Journal = Journal<&'db mut dyn DatabaseExt<OpEvmFactory, Error = DatabaseError>>

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

type Spec = TempoHardfork

type Block = TempoBlockEnv

type Tx = TempoTxEnv

type Chain = ()

type Journal = Journal<&'db mut dyn DatabaseExt<TempoEvmFactory, Error = DatabaseError>>