Crate payload

This crate defines abstractions to create and update payloads (blocks)

Enums

EngineApiMessageVersion

The version of Engine API message.

EngineObjectValidationError

Thrown when the payload or attributes are known to be invalid before processing.

InvalidPayloadAttributesError

Thrown when validating the correctness of a payloadattributes object.

MessageValidationKind

A type that represents whether or not we are validating a payload or payload attributes.

NewPayloadError

Error validating payload received over newPayload API.

PayloadBuilderError

Possible error variants during payload building.

PayloadKind

Determines how we should choose the payload to return.

PayloadOrAttributes

Either a type that implements the ExecutionPayload or a type that implements the PayloadAttributes trait.

VersionSpecificValidationError

Thrown when validating an execution payload OR payload attributes fails due to:

Traits

BuiltPayload

Represents a built payload type that contains a built SealedBlock and can be converted into engine API execution payloads.

ExecutionPayload

An execution payload.

PayloadAttributes

The execution payload attribute type the CL node emits via the engine API. This trait should be implemented by types that could be used to spawn a payload job.

PayloadAttributesBuilder

A builder that can return the current payload attribute.

PayloadBuilderAttributes

This can be implemented by types that describe a currently running payload job.

PayloadTypes

The types that are used by the engine API.

Functions

validate_execution_requests

Validates that execution requests are valid according to Engine API specification.

validate_parent_beacon_block_root_presence

Validate the presence of the parentBeaconBlockRoot field according to the given timestamp. This method is meant to be used with either a payloadAttributes field or a full payload, with the engine_forkchoiceUpdated and engine_newPayload methods respectively.

validate_payload_timestamp

Validates the timestamp depending on the version called:

validate_version_specific_fields

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

validate_withdrawals_presence

Validates the presence of the withdrawals field according to the payload timestamp. After Shanghai, withdrawals field must be Some. Before Shanghai, withdrawals field must be None;