Struct CompiledHandler 

pub struct CompiledHandler<'a> {
    pub compiled: &'a CompiledContracts,
    pub cache: &'a CompileCache,
    pub spec_id: SpecId,
}

Custom handler that dispatches to compiled functions. All bytecodes — including runtime-created ones (CREATE/CREATE2) — are JIT-compiled before execution. Never falls back to the interpreter.

Fields

compiled: &'a CompiledContracts

cache: &'a CompileCache

spec_id: SpecId

Trait Implementations

impl Handler for CompiledHandler<'_>

type Evm = Evm<Context<BlockEnv, TxEnv, CfgEnv, &'static mut State<EmptyDBTyped<Infallible>>>, (), EthInstructions<EthInterpreter, Context<BlockEnv, TxEnv, CfgEnv, &'static mut State<EmptyDBTyped<Infallible>>>>, EthPrecompiles, EthFrame>

The EVM type containing Context, Instruction, and Precompiles implementations.

type Error = EVMError<EvmDatabaseError<Infallible>>

The error type returned by this handler.

type HaltReason = HaltReason

The halt reason type included in the output

fn run_exec_loop( &mut self, evm: &mut Self::Evm, first_frame_input: FrameInit, ) -> Result<FrameResult, Self::Error>

Executes the main frame processing loop.

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

The main entry point for transaction execution.

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

Runs the system call.

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

Called by [Handler::run] to execute the core handler logic.

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

Validates the execution environment and transaction parameters.

fn pre_execution(&self, evm: &mut Self::Evm) -> Result<u64, Self::Error>

Prepares the EVM state for execution.

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

Creates and executes the initial frame, then processes the execution loop.

fn post_execution( &self, evm: &mut Self::Evm, exec_result: &mut FrameResult, init_and_floor_gas: InitialAndFloorGas, eip7702_gas_refund: i64, ) -> Result<ResultGas, Self::Error>

Handles the final steps of transaction execution.

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

Validates block, transaction and configuration fields.

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

Calculates initial gas costs based on transaction type and input data.

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

Loads access list and beneficiary account, marking them as warm in the [context::Journal].

fn apply_eip7702_auth_list( &self, evm: &mut Self::Evm, ) -> Result<u64, Self::Error>

Processes the authorization list, validating authority signatures, nonces and chain IDs. Applies valid authorizations to accounts.

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

Deducts the maximum possible fee from caller’s balance.

fn first_frame_input( &mut self, evm: &mut Self::Evm, gas_limit: u64, ) -> Result<FrameInit, Self::Error>

Creates initial frame input using transaction parameters, gas limit and configuration.

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

Processes the result of the initial call and handles returned gas.

fn eip7623_check_gas_floor( &self, _evm: &mut Self::Evm, exec_result: &mut <<Self::Evm as EvmTr>::Frame as FrameTr>::FrameResult, init_and_floor_gas: InitialAndFloorGas, )

Validates that the minimum gas floor requirements are satisfied.

fn refund( &self, evm: &mut Self::Evm, exec_result: &mut <<Self::Evm as EvmTr>::Frame as FrameTr>::FrameResult, eip7702_refund: i64, )

Calculates the final gas refund amount, including any EIP-7702 refunds.

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

Returns unused gas costs to the transaction sender’s account.

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

Transfers transaction fees to the block beneficiary’s account.

fn execution_result( &mut self, evm: &mut Self::Evm, result: <<Self::Evm as EvmTr>::Frame as FrameTr>::FrameResult, result_gas: ResultGas, ) -> Result<ExecutionResult<Self::HaltReason>, Self::Error>

Processes the final execution output.

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

Handles cleanup when an error occurs during execution.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 24 bytes