Trait EngineApiValidator 

pub trait EngineApiValidator<Types: PayloadTypes>:
    Send
    + Sync
    + Unpin
    + 'static {
    // Required methods
    fn validate_version_specific_fields(
        &self,
        version: EngineApiMessageVersion,
        payload_or_attrs: PayloadOrAttributes<'_, Types::ExecutionData, Types::PayloadAttributes>,
    ) -> Result<(), EngineObjectValidationError>;
    fn ensure_well_formed_attributes(
        &self,
        version: EngineApiMessageVersion,
        attributes: &Types::PayloadAttributes,
    ) -> Result<(), EngineObjectValidationError>;
}

Validates engine API requests at the RPC layer, before payloads and attributes are forwarded to the engine for processing.

• validate_version_specific_fields: Enforced in each engine_newPayloadVN RPC handler to verify the payload contains the correct fields for the engine API version (e.g., blob fields in V3+, requests in V4+).

• ensure_well_formed_attributes: Enforced in engine_forkchoiceUpdatedVN RPC handlers to validate payload attributes are well-formed for the given version before forwarding to the engine.

After this validation passes, the engine performs the full consensus validation pipeline (header, pre-execution, execution, post-execution).

Required Methods

fn validate_version_specific_fields( &self, version: EngineApiMessageVersion, payload_or_attrs: PayloadOrAttributes<'_, Types::ExecutionData, Types::PayloadAttributes>, ) -> Result<(), EngineObjectValidationError>

Validates the presence or exclusion of fork-specific fields based on the payload attributes and the message version.

fn ensure_well_formed_attributes( &self, version: EngineApiMessageVersion, attributes: &Types::PayloadAttributes, ) -> Result<(), EngineObjectValidationError>

Ensures that the payload attributes are valid for the given [EngineApiMessageVersion].

Implementors