Trait InspectorHandler 

pub trait InspectorHandler: Handler
where
    Self::Evm: InspectorEvmTr,
    <Self::Evm as InspectorEvmTr>::Inspector: Inspector<<Self::Evm as EvmTr>::Context, Self::IT>,
{
    type IT: InterpreterTypes;

    // Provided methods
    fn inspect_run(
        &mut self,
        evm: &mut Self::Evm,
    ) -> Result<ExecutionResult<Self::HaltReason>, Self::Error> { ... }
    fn inspect_run_without_catch_error(
        &mut self,
        evm: &mut Self::Evm,
    ) -> Result<ExecutionResult<Self::HaltReason>, Self::Error> { ... }
    fn inspect_execution(
        &mut self,
        evm: &mut Self::Evm,
        init_and_floor_gas: &InitialAndFloorGas,
    ) -> Result<FrameResult, Self::Error> { ... }
    fn inspect_run_exec_loop(
        &mut self,
        evm: &mut Self::Evm,
        first_frame_input: <<Self::Evm as EvmTr>::Frame as FrameTr>::FrameInit,
    ) -> Result<FrameResult, Self::Error> { ... }
    fn inspect_run_system_call(
        &mut self,
        evm: &mut Self::Evm,
    ) -> Result<ExecutionResult<Self::HaltReason>, Self::Error> { ... }
}

Trait that extends Handler with inspection functionality.

Similar how Handler::run method serves as the entry point, InspectorHandler::inspect_run method serves as the entry point for inspection. For system calls, InspectorHandler::inspect_run_system_call provides inspection support similar to Handler::run_system_call.

Notice that when inspection is run it skips few functions from handler, this can be a problem if custom EVM is implemented and some of skipped functions have changed logic. For custom EVM, those changed functions would need to be also changed in InspectorHandler.

List of functions that are skipped in InspectorHandler:

• Handler::run replaced with InspectorHandler::inspect_run
• Handler::run_without_catch_error replaced with InspectorHandler::inspect_run_without_catch_error
• Handler::execution replaced with InspectorHandler::inspect_execution
• Handler::run_exec_loop replaced with InspectorHandler::inspect_run_exec_loop
  • run_exec_loop calls inspect_frame_init and inspect_frame_run that call inspector inside.
• Handler::run_system_call replaced with InspectorHandler::inspect_run_system_call

Required Associated Types

type IT: InterpreterTypes

The interpreter types used by this handler.

Provided Methods

fn inspect_run( &mut self, evm: &mut Self::Evm, ) -> Result<ExecutionResult<Self::HaltReason>, Self::Error>

Entry point for inspection.

This method is acts as Handler::run method for inspection.

fn inspect_run_without_catch_error( &mut self, evm: &mut Self::Evm, ) -> Result<ExecutionResult<Self::HaltReason>, Self::Error>

Run inspection without catching error.

This method is acts as Handler::run_without_catch_error method for inspection.

fn inspect_execution( &mut self, evm: &mut Self::Evm, init_and_floor_gas: &InitialAndFloorGas, ) -> Result<FrameResult, Self::Error>

Run execution loop with inspection support

This method acts as Handler::execution method for inspection.

fn inspect_run_exec_loop( &mut self, evm: &mut Self::Evm, first_frame_input: <<Self::Evm as EvmTr>::Frame as FrameTr>::FrameInit, ) -> Result<FrameResult, Self::Error>

Run inspection on execution loop.

This method acts as Handler::run_exec_loop method for inspection.

It will call:

• Inspector::call,Inspector::create to inspect call, create and eofcreate.
• Inspector::call_end,Inspector::create_end to inspect call, create and eofcreate end.
• Inspector::initialize_interp to inspect initialized interpreter.

fn inspect_run_system_call( &mut self, evm: &mut Self::Evm, ) -> Result<ExecutionResult<Self::HaltReason>, Self::Error>

Run system call with inspection support.

This method acts as Handler::run_system_call method for inspection. Similar to InspectorHandler::inspect_run but skips validation and pre-execution phases, going directly to execution with inspection support.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl<EVM, ERROR> InspectorHandler for OpHandler<EVM, ERROR, EthFrame>

where EVM: InspectorEvmTr<Frame = EthFrame>, <EVM as EvmTr>::Context: OpContextTr, <EVM as InspectorEvmTr>::Inspector: Inspector<<<OpHandler<EVM, ERROR, EthFrame> as Handler>::Evm as EvmTr>::Context>, ERROR: EvmTrError<EVM> + From<OpTransactionError> + FromStringError + IsTxError,

type IT = EthInterpreter

Implementors

impl<EVM, ERROR> InspectorHandler for MainnetHandler<EVM, ERROR, EthFrame>

where EVM: InspectorEvmTr<Frame = EthFrame>, <EVM as EvmTr>::Context: ContextTr, <<EVM as EvmTr>::Context as ContextTr>::Journal: JournalTr<State = HashMap<Address, Account, DefaultHashBuilder>>, <EVM as InspectorEvmTr>::Inspector: Inspector<<<MainnetHandler<EVM, ERROR, EthFrame> as Handler>::Evm as EvmTr>::Context>, ERROR: EvmTrError<EVM>,

type IT = EthInterpreter