EngineValidator

Trait EngineValidator 

Source
pub trait EngineValidator<Types: PayloadTypes, N: NodePrimitives = <<Types as PayloadTypes>::BuiltPayload as BuiltPayload>::Primitives>:
    Send
    + Sync
    + 'static {
    // Required methods
    fn validate_payload_attributes_against_header(
        &self,
        attr: &Types::PayloadAttributes,
        header: &N::BlockHeader,
    ) -> Result<(), InvalidPayloadAttributesError>;
    fn convert_payload_to_block(
        &self,
        payload: Types::ExecutionData,
    ) -> Result<SealedBlock<N::Block>, NewPayloadError>;
    fn validate_payload(
        &mut self,
        payload: Types::ExecutionData,
        ctx: TreeCtx<'_, N>,
    ) -> ValidationOutcome<N>;
    fn validate_block(
        &mut self,
        block: SealedBlock<N::Block>,
        ctx: TreeCtx<'_, N>,
    ) -> ValidationOutcome<N>;
    fn on_inserted_executed_block(&self, block: ExecutedBlock<N>);
}
Expand description

Type that validates the payloads processed by the engine.

This provides the necessary functions for validating/executing payloads/blocks.

Required Methods§

Source

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

Validates the payload attributes with respect to the header.

By default, this enforces that the payload attributes timestamp is greater than the timestamp according to:

  1. Client software MUST ensure that payloadAttributes.timestamp is greater than timestamp of a block referenced by forkchoiceState.headBlockHash.

See also: https://github.com/ethereum/execution-apis/blob/main/src/engine/common.md#specification-1

Source

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.

This function must convert the payload into the executable block and pre-validate its fields.

Implementers should ensure that the checks are done in the order that conforms with the engine-API specification.

Source

fn validate_payload( &mut self, payload: Types::ExecutionData, ctx: TreeCtx<'_, N>, ) -> ValidationOutcome<N>

Validates a payload received from engine API.

Source

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

Validates a block downloaded from the network.

Source

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

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

This is invoked when blocks are inserted via InsertExecutedBlock (e.g., locally built blocks by sequencers) to allow implementations to update internal state such as caches.

Implementors§

Source§

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