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

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() -> Self

Creates a new Ethereum EVM configuration for Ethereum mainnet.

impl<ChainSpec> EthEvmConfig<ChainSpec>

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

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

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

Creates a new Ethereum EVM configuration.

impl<ChainSpec, F: EvmFactory> EthEvmConfig<ChainSpec, F>

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

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

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

Returns the chain spec associated with this configuration.

pub fn with_sender_recovery_cache(self, cache: SenderRecoveryCache) -> Self

Uses the provided sender recovery cache.

Trait Implementations

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

where F: EvmFactory + Clone,

fn clone(&self) -> Self

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::Types: EvmTypes<Tx = TxEnvelope>,

Available on crate feature std only.

fn evm_env_for_payload( &self, payload: &ExecutionData, ) -> Result<EvmEnvFor<Self>, Self::Error>

Returns an [crate::EvmEnv] for the given payload.

fn context_for_payload<'a>( &self, payload: &'a ExecutionData, ) -> Result<ExecutionCtxFor<'a, Self>, Self::Error>

Returns an [ExecutionCtxFor] for the given payload.

fn tx_iterator_for_payload( &self, payload: &ExecutionData, ) -> Result<impl ExecutableTxIterator<Self>, Self::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::Types as EvmTypesHost>::Tx: Typed2718 + FromTxWithEncoded<TransactionSigned> + 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) -> &Self::BlockExecutorFactory

Available on crate feature std only.

Returns reference to the configured [BlockExecutorFactory].

fn block_assembler(&self) -> &Self::BlockAssembler

Available on crate feature std only.

Returns reference to the configured [BlockAssembler].

fn with_jit_support_enabled(self, enabled: bool) -> Self

where Self: 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: EvmEnvFor<Self>, cache_map: PrecompileCacheMap<SpecFor<Self>>, metrics_enabled: bool, ) -> EvmFor<'a, Self>

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<EvmEnvFor<Self>, Self::Error>

Creates a new [EvmEnv] for the given header.

fn next_evm_env( &self, parent: &Header, attributes: &NextBlockEnvAttributes, ) -> Result<EvmEnvFor<Self>, Self::Error>

Returns the configured [EvmEnv] for parent + 1 block.

fn context_for_block<'a>( &self, block: &'a SealedBlock<Block>, ) -> Result<EthBlockExecutionCtx<'a>, Self::Error>

where Self: 'a,

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

fn context_for_next_block( &self, parent: &SealedHeader, attributes: Self::NextBlockEnvCtx, ) -> Result<EthBlockExecutionCtx<'_>, Self::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: &TransactionSigned, result: TxResultWithStateFor<Self>, ) -> Option<TxExecutionResultFor<'a, Self>>

where Self: '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<EvmEnvFor<Self>>

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: Debug, F> Debug for EthEvmConfig<C, F>

where F: EvmFactory + Debug,

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

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.