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<Provider: BlockReader + TrieReader + StageCheckpointReader + PruneCheckpointReader> + BlockReader<Header = N::BlockHeader> + StateProviderFactory + StateReader + HashedPostStateProvider + Clone + 'static, 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>>, ) -> Self

Creates a new TreePayloadValidator.

pub fn convert_to_block<T: PayloadTypes<BuiltPayload: BuiltPayload<Primitives = N>>>( &self, input: BlockOrPayload<T>, ) -> Result<SealedBlock<N::Block>, NewPayloadError>

where V: PayloadValidator<T, Block = N::Block>,

Converts a BlockOrPayload to a recovered block.

pub fn evm_env_for<T: PayloadTypes<BuiltPayload: BuiltPayload<Primitives = N>>>( &self, input: &BlockOrPayload<T>, ) -> Result<EvmEnvFor<Evm>, Evm::Error>

where V: PayloadValidator<T, Block = N::Block>, Evm: ConfigureEngineEvm<T::ExecutionData, Primitives = N>,

Returns EVM environment for the given payload or block.

pub fn tx_iterator_for<'a, T: PayloadTypes<BuiltPayload: BuiltPayload<Primitives = N>>>( &'a self, input: &'a BlockOrPayload<T>, ) -> Result<impl ExecutableTxIterator<Evm>, NewPayloadError>

where V: PayloadValidator<T, Block = N::Block>, Evm: ConfigureEngineEvm<T::ExecutionData, Primitives = N>,

Returns ExecutableTxIterator for the given payload or block.

pub fn execution_ctx_for<'a, T: PayloadTypes<BuiltPayload: BuiltPayload<Primitives = N>>>( &self, input: &'a BlockOrPayload<T>, ) -> Result<ExecutionCtxFor<'a, Evm>, Evm::Error>

where V: PayloadValidator<T, Block = N::Block>, Evm: ConfigureEngineEvm<T::ExecutionData, Primitives = N>,

Returns a ExecutionCtxFor for the given payload or block.

pub fn validate_block_with_state<T: PayloadTypes<BuiltPayload: BuiltPayload<Primitives = N>>>( &mut self, input: BlockOrPayload<T>, ctx: TreeCtx<'_, N>, ) -> ValidationOutcome<N, InsertPayloadError<N::Block>>

where V: PayloadValidator<T, Block = N::Block>, Evm: ConfigureEngineEvm<T::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::Primitives, Error = ConsensusError>>: Debug, PayloadProcessor<Evm>: Debug, PrecompileCacheMap<SpecFor<Evm>>: Debug, V: Debug,

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

Formats the value using the given formatter.

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

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

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

Validates the payload attributes with respect to the header.

fn convert_payload_to_block( &self, payload: Types::ExecutionData, ) -> Result<SealedBlock<N::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::ExecutionData, ctx: TreeCtx<'_, N>, ) -> ValidationOutcome<N>

Validates a payload received from engine API.

fn validate_block( &mut self, block: SealedBlock<N::Block>, ctx: TreeCtx<'_, N>, ) -> ValidationOutcome<N>

Validates a block downloaded from the network.

fn on_inserted_executed_block(&self, block: ExecutedBlock<N>)

Hook called after an executed block is inserted directly into the tree.

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.