Struct BasicEngineValidator 

pub struct BasicEngineValidator<P, Evm, V>
where
    Evm: ConfigureEvm,
{ /* private fields */ }

A helper type that provides reusable payload validation logic for network-specific validators.

This type satisfies EngineValidator and is responsible for executing blocks/payloads.

This type contains common validation, execution, and state root computation logic that can be used by network-specific payload validators (e.g., Ethereum, Optimism). It is not meant to be used as a standalone component, but rather as a building block for concrete implementations.

Implementations

impl<N, P, Evm, V> BasicEngineValidator<P, Evm, V>

where N: NodePrimitives, P: DatabaseProviderFactory + BlockReader<Header = <N as NodePrimitives>::BlockHeader> + StateProviderFactory + StateReader + HashedPostStateProvider + Clone + 'static, <P as DatabaseProviderFactory>::Provider: BlockReader, Evm: ConfigureEvm<Primitives = N> + 'static,

pub fn new( provider: P, consensus: Arc<dyn FullConsensus<N, Error = ConsensusError>>, evm_config: Evm, validator: V, config: TreeConfig, invalid_block_hook: Box<dyn InvalidBlockHook<N>>, ) -> BasicEngineValidator<P, Evm, V>

Creates a new TreePayloadValidator.

pub fn convert_to_block<T>( &self, input: BlockOrPayload<T>, ) -> Result<RecoveredBlock<<N as NodePrimitives>::Block>, NewPayloadError>

where T: PayloadTypes, <T as PayloadTypes>::BuiltPayload: BuiltPayload<Primitives = N>, V: PayloadValidator<T, Block = <N as NodePrimitives>::Block>,

Converts a [BlockOrPayload] to a recovered block.

pub fn evm_env_for<T>( &self, input: &BlockOrPayload<T>, ) -> EvmEnv<<<<Evm as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Spec>

where T: PayloadTypes, <T as PayloadTypes>::BuiltPayload: BuiltPayload<Primitives = N>, V: PayloadValidator<T, Block = <N as NodePrimitives>::Block>, Evm: ConfigureEngineEvm<<T as PayloadTypes>::ExecutionData, Primitives = N>,

Returns EVM environment for the given payload or block.

pub fn tx_iterator_for<'a, T>( &'a self, input: &'a BlockOrPayload<T>, ) -> Result<impl ExecutableTxIterator<Evm> + 'a, NewPayloadError>

where T: PayloadTypes, <T as PayloadTypes>::BuiltPayload: BuiltPayload<Primitives = N>, V: PayloadValidator<T, Block = <N as NodePrimitives>::Block>, Evm: ConfigureEngineEvm<<T as PayloadTypes>::ExecutionData, Primitives = N>,

Returns ExecutableTxIterator for the given payload or block.

pub fn execution_ctx_for<'a, T>( &self, input: &'a BlockOrPayload<T>, ) -> <<Evm as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::ExecutionCtx<'a>

where T: PayloadTypes, <T as PayloadTypes>::BuiltPayload: BuiltPayload<Primitives = N>, V: PayloadValidator<T, Block = <N as NodePrimitives>::Block>, Evm: ConfigureEngineEvm<<T as PayloadTypes>::ExecutionData, Primitives = N>,

Returns a [ExecutionCtxFor] for the given payload or block.

pub fn validate_block_with_state<T>( &mut self, input: BlockOrPayload<T>, ctx: TreeCtx<'_, N>, ) -> Result<ExecutedBlockWithTrieUpdates<N>, InsertPayloadError<<N as NodePrimitives>::Block>>

where T: PayloadTypes, <T as PayloadTypes>::BuiltPayload: BuiltPayload<Primitives = N>, V: PayloadValidator<T, Block = <N as NodePrimitives>::Block>, Evm: ConfigureEngineEvm<<T as PayloadTypes>::ExecutionData, Primitives = N>,

Validates a block that has already been converted from a payload.

This method performs:

• Consensus validation
• Block execution
• State root computation
• Fork detection

Trait Implementations

impl<P, Evm, V> Debug for BasicEngineValidator<P, Evm, V>

where Evm: ConfigureEvm + Debug, P: Debug, Arc<dyn FullConsensus<<Evm as ConfigureEvm>::Primitives, Error = ConsensusError>>: Debug, PayloadProcessor<Evm>: Debug, PrecompileCacheMap<<<<Evm as ConfigureEvm>::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Spec>: Debug, V: Debug,

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

Formats the value using the given formatter.

impl<N, Types, P, Evm, V> EngineValidator<Types> for BasicEngineValidator<P, Evm, V>

where P: DatabaseProviderFactory + BlockReader<Header = <N as NodePrimitives>::BlockHeader> + StateProviderFactory + StateReader + HashedPostStateProvider + Clone + 'static, <P as DatabaseProviderFactory>::Provider: BlockReader, N: NodePrimitives, V: PayloadValidator<Types, Block = <N as NodePrimitives>::Block>, Evm: ConfigureEngineEvm<<Types as PayloadTypes>::ExecutionData, Primitives = N> + 'static, Types: PayloadTypes, <Types as PayloadTypes>::BuiltPayload: BuiltPayload<Primitives = N>,

fn validate_payload_attributes_against_header( &self, attr: &<Types as PayloadTypes>::PayloadAttributes, header: &<N as NodePrimitives>::BlockHeader, ) -> Result<(), InvalidPayloadAttributesError>

Validates the payload attributes with respect to the header.

fn ensure_well_formed_payload( &self, payload: <Types as PayloadTypes>::ExecutionData, ) -> Result<RecoveredBlock<<N as NodePrimitives>::Block>, NewPayloadError>

Ensures that the given payload does not violate any consensus rules that concern the block’s layout.

fn validate_payload( &mut self, payload: <Types as PayloadTypes>::ExecutionData, ctx: TreeCtx<'_, N>, ) -> Result<ExecutedBlockWithTrieUpdates<N>, InsertPayloadError<<N as NodePrimitives>::Block>>

Validates a payload received from engine API.

fn validate_block( &mut self, block: RecoveredBlock<<N as NodePrimitives>::Block>, ctx: TreeCtx<'_, N>, ) -> Result<ExecutedBlockWithTrieUpdates<N>, InsertPayloadError<<N as NodePrimitives>::Block>>

Validates a block downloaded from the network.

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.