Struct EthEvmConfig 

pub struct EthEvmConfig<C = ChainSpec, F = RethEvmFactory>
where
    F: EvmFactory,
{
    pub executor_factory: EthBlockExecutorFactory<RethReceiptBuilder, C, F>,
    pub block_assembler: EthBlockAssembler<C>,
    pub sender_recovery_cache: Option<SenderRecoveryCache>,
}

Available on crate features node-api and node only.

Ethereum-related EVM configuration.

Fields

executor_factory: EthBlockExecutorFactory<RethReceiptBuilder, C, F>

Inner Ethereum block executor factory.

block_assembler: EthBlockAssembler<C>

Ethereum block assembler.

sender_recovery_cache: Option<SenderRecoveryCache>

Cache of recovered transaction senders, if enabled.

Implementations

impl EthEvmConfig

pub fn mainnet() -> EthEvmConfig

Available on crate feature evm only.

Creates a new Ethereum EVM configuration for Ethereum mainnet.

impl<ChainSpec> EthEvmConfig<ChainSpec>

pub fn new(chain_spec: Arc<ChainSpec>) -> EthEvmConfig<ChainSpec>

Available on crate feature evm only.

Creates a new Ethereum EVM configuration with the given chain spec.

pub fn ethereum(chain_spec: Arc<ChainSpec>) -> EthEvmConfig<ChainSpec>

Available on crate feature evm only.

Creates a new Ethereum EVM configuration.

impl<ChainSpec, F> EthEvmConfig<ChainSpec, F>

where F: EvmFactory,

pub fn new_with_evm_factory( chain_spec: Arc<ChainSpec>, evm_factory: F, ) -> EthEvmConfig<ChainSpec, F>

Available on crate feature evm only.

Creates a new Ethereum EVM configuration with the given EVM factory configuration.

pub const fn chain_spec(&self) -> &Arc<ChainSpec>

Available on crate feature evm only.

Returns the chain spec associated with this configuration.

pub fn with_sender_recovery_cache( self, cache: SenderRecoveryCache, ) -> EthEvmConfig<ChainSpec, F>

Available on crate feature evm only.

Uses the provided sender recovery cache.

Trait Implementations

impl<C, F> Clone for EthEvmConfig<C, F>

where C: Clone, F: Clone + EvmFactory,

fn clone(&self) -> EthEvmConfig<C, F>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<ChainSpec, EvmF> ConfigureEngineEvm<ExecutionData> for EthEvmConfig<ChainSpec, EvmF>

where ChainSpec: EthChainSpec<Header = Header> + EthereumHardforks + Hardforks + 'static, EvmF: EvmFactory, <EvmF as EvmFactory>::Types: EvmTypes<Tx = TxEnvelope>,

Available on crate feature std only.

fn evm_env_for_payload( &self, payload: &ExecutionData, ) -> Result<<<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::EvmEnv, <EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::Error>

Returns an crate::EvmEnv for the given payload.

fn context_for_payload<'a>( &self, payload: &'a ExecutionData, ) -> Result<<<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::ExecutionCtx<'a>, <EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::Error>

Returns an ExecutionCtxFor for the given payload.

fn tx_iterator_for_payload( &self, payload: &ExecutionData, ) -> Result<impl ExecutableTxIterator<EthEvmConfig<ChainSpec, EvmF>>, <EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::Error>

Returns an ExecutableTxIterator for the given payload.

impl<ChainSpec, EvmF> ConfigureEvm for EthEvmConfig<ChainSpec, EvmF>

where ChainSpec: EthChainSpec<Header = Header> + EthereumHardforks + Hardforks + 'static, EvmF: EvmFactory, <<EvmF as EvmFactory>::Types as EvmTypesHost>::Tx: Typed2718 + FromTxWithEncoded<EthereumTxEnvelope<TxEip4844>> + TransactionEnvMut,

type Primitives = EthPrimitives

The primitives type used by the EVM.

type Error = !

The error type that is returned by Self::next_evm_env.

type NextBlockEnvCtx = NextBlockEnvAttributes

Context required for configuring next block environment.

type BlockExecutorFactory = EthBlockExecutorFactory<RethReceiptBuilder, ChainSpec, EvmF>

Configured BlockExecutorFactory, contains the EVM factory internally.

type BlockAssembler = EthBlockAssembler<ChainSpec>

Available on crate feature std only.

A type that knows how to build a block.

fn block_executor_factory( &self, ) -> &<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory

Available on crate feature std only.

Returns reference to the configured BlockExecutorFactory.

fn block_assembler( &self, ) -> &<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockAssembler

Available on crate feature std only.

Returns reference to the configured BlockAssembler.

fn with_jit_support_enabled( self, enabled: bool, ) -> EthEvmConfig<ChainSpec, EvmF>

where EthEvmConfig<ChainSpec, EvmF>: Sized,

Returns a config with JIT support enabled for subsequently created EVMs, if supported.

fn evm_with_precompile_cache<'a, DB>( &self, db: DB, evm_env: <<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::EvmEnv, cache_map: PrecompileCacheMap<<<<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::EvmTypes as EvmTypesHost>::SpecId>, metrics_enabled: bool, ) -> <<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::Evm<'a>

where DB: Database + 'a,

Available on crate feature std only.

Creates an EVM whose precompile results are cached in cache_map.

fn jit_backend(&self) -> Option<&dyn JitBackend>

Returns the JIT backend, if supported.

fn evm_env( &self, header: &Header, ) -> Result<<<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::EvmEnv, <EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::Error>

Creates a new EvmEnv for the given header.

fn next_evm_env( &self, parent: &Header, attributes: &NextBlockEnvAttributes, ) -> Result<<<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::EvmEnv, <EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::Error>

Returns the configured EvmEnv for parent + 1 block.

fn context_for_block<'a>( &self, block: &'a SealedBlock<Block<EthereumTxEnvelope<TxEip4844>>>, ) -> Result<EthBlockExecutionCtx<'a>, <EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::Error>

where EthEvmConfig<ChainSpec, EvmF>: 'a,

Returns the configured BlockExecutorFactory::ExecutionCtx for a given block.

fn context_for_next_block( &self, parent: &SealedHeader, attributes: <EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::NextBlockEnvCtx, ) -> Result<EthBlockExecutionCtx<'_>, <EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::Error>

Returns the configured BlockExecutorFactory::ExecutionCtx for parent + 1 block.

fn reuses_prewarm_results(&self) -> bool

Returns whether engine validation may commit transaction results from speculative prewarm execution instead of executing the transactions again.

fn prewarm_tx_result<'a>( &self, tx: &EthereumTxEnvelope<TxEip4844>, result: TxResultWithState<<<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::EvmTypes>, ) -> Option<<<<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::Executor<'a> as BlockExecutor>::TransactionResultWithState>

where EthEvmConfig<ChainSpec, EvmF>: 'a,

Available on crate feature std only.

Wraps a speculative prewarm execution result of tx into the result consumed by BlockExecutor::commit_transaction.

fn speculative_next_evm_env( &self, parent: &SealedHeader, beneficiary: Address, ) -> Option<<<EthEvmConfig<ChainSpec, EvmF> as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::EvmEnv>

Returns the predicted environment of the block after parent with beneficiary, in which engine validation speculatively executes pool transactions before the block arrives.

fn tx_env( &self, transaction: impl IntoTxEnv<Recovered<<<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmTypes as EvmTypesHost>::Tx>>, ) -> Recovered<<<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmTypes as EvmTypesHost>::Tx>

Returns a transaction environment from a transaction.

fn evm_factory( &self, ) -> &<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory

Available on crate feature std only.

Provides a reference to the configured EVM factory state.

fn with_jit_support(self) -> Self

where Self: Sized,

Returns a config with local JIT support enabled for subsequently created EVMs, if supported.

fn executor<DB>( &self, db: DB, ) -> impl Executor<DB, Primitives = Self::Primitives, Error = BlockExecutionError>

where DB: Database,

Returns a new Executor for executing blocks.

fn batch_executor<DB>( &self, db: DB, ) -> impl Executor<DB, Primitives = Self::Primitives, Error = BlockExecutionError>

where DB: Database,

Returns a new BasicBlockExecutor.

fn executor_for_block<'a, DB>( &'a self, db: DB, block: &'a SealedBlock<<Self::Primitives as NodePrimitives>::Block>, ) -> Result<<Self::BlockExecutorFactory as BlockExecutorFactory>::Executor<'a>, Self::Error>

where Self: 'a, DB: Database + 'a,

Available on crate feature std only.

Creates a block executor for the given block.

fn evm_with_env<'a, DB>( &self, db: DB, evm_env: <Self::BlockExecutorFactory as BlockExecutorFactory>::EvmEnv, ) -> <Self::BlockExecutorFactory as BlockExecutorFactory>::Evm<'a>

where DB: Database + 'a,

Available on crate feature std only.

Creates an EVM instance for single-transaction execution with the configured environment.

fn evm_for_block<'a, DB>( &self, db: DB, header: &<Self::Primitives as NodePrimitives>::BlockHeader, ) -> Result<<Self::BlockExecutorFactory as BlockExecutorFactory>::Evm<'a>, Self::Error>

where DB: Database + 'a,

Available on crate feature std only.

Creates an EVM instance for the given block.

fn create_block_builder<'a>( &'a self, evm: <Self::BlockExecutorFactory as BlockExecutorFactory>::Evm<'a>, evm_env: <Self::BlockExecutorFactory as BlockExecutorFactory>::EvmEnv, parent: &'a SealedHeader<<Self::Primitives as NodePrimitives>::BlockHeader>, ctx: <Self::BlockExecutorFactory as BlockExecutorFactory>::ExecutionCtx<'a>, ) -> impl BlockBuilder<Primitives = Self::Primitives, Executor = <Self::BlockExecutorFactory as BlockExecutorFactory>::Executor<'a>>

where Self: 'a,

Available on crate feature std only.

Creates a BlockBuilder. Should be used when building a new block.

fn create_block_builder_with<'a, E>( &'a self, evm: <Self::BlockExecutorFactory as BlockExecutorFactory>::Evm<'a>, evm_env: <Self::BlockExecutorFactory as BlockExecutorFactory>::EvmEnv, parent: &'a SealedHeader<<Self::Primitives as NodePrimitives>::BlockHeader>, ctx: <Self::BlockExecutorFactory as BlockExecutorFactory>::ExecutionCtx<'a>, f: impl FnOnce(<Self::BlockExecutorFactory as BlockExecutorFactory>::Executor<'a>) -> E, ) -> impl BlockBuilder<Primitives = Self::Primitives, Executor = E>

where Self: 'a, E: BlockExecutor<Evm = <Self::BlockExecutorFactory as BlockExecutorFactory>::Evm<'a>, Transaction = <Self::Primitives as NodePrimitives>::SignedTx, Receipt = <Self::Primitives as NodePrimitives>::Receipt>,

Available on crate feature std only.

Creates a BlockBuilder like ConfigureEvm::create_block_builder, with a customized executor.

fn builder_for_next_block<'a, DB>( &'a self, db: DB, parent: &'a SealedHeader<<Self::Primitives as NodePrimitives>::BlockHeader>, attributes: Self::NextBlockEnvCtx, ) -> Result<impl BlockBuilder<Primitives = Self::Primitives, Executor = <Self::BlockExecutorFactory as BlockExecutorFactory>::Executor<'a>>, Self::Error>

where Self: 'a, DB: Database + 'a,

Available on crate feature std only.

Creates a BlockBuilder for building of a new block. This is a helper to invoke ConfigureEvm::create_block_builder.

fn pre_block_state_changes<'a, DB>( &'a self, db: DB, evm_env: <Self::BlockExecutorFactory as BlockExecutorFactory>::EvmEnv, ctx: <Self::BlockExecutorFactory as BlockExecutorFactory>::ExecutionCtx<'a>, ) -> Result<BundleState, Box<dyn Error + Sync + Send>>

where Self: 'a, DB: DynDatabase + 'a,

Available on crate feature std only.

Applies block-level state changes required before transaction execution using the configured block executor.

impl<C, F> Debug for EthEvmConfig<C, F>

where C: Debug, F: Debug + EvmFactory,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.