Struct ExecutionPayloadV4 

pub struct ExecutionPayloadV4 {
    pub payload_inner: ExecutionPayloadV3,
    pub block_access_list: Bytes,
    pub slot_number: u64,
}

Available on crate feature rpc only.

Execution payload V4 as defined in the Amsterdam fork.

This extends ExecutionPayloadV3 with the block_access_list field for EIP-7928 and the slot_number field for EIP-7843.

See also: https://github.com/ethereum/execution-apis/blob/7b4d9f62a3fe62b9b8dcb355f1c5a38b5ff084f6/src/engine/amsterdam.md#executionpayloadv4

Fields

payload_inner: ExecutionPayloadV3

Inner V3 payload

block_access_list: Bytes

RLP-encoded block access list as defined in EIP-7928.

slot_number: u64

The slot number corresponding to this block, calculated in the consensus layer.

Implementations

impl ExecutionPayloadV4

pub fn from_block_slow<T, H>(block: &Block<T, H>) -> ExecutionPayloadV4

where T: Encodable2718, H: BlockHeader + Sealable,

Available on crate feature ssz only.

Converts [alloy_consensus::Block] to ExecutionPayloadV4.

This uses the header’s block_access_list_hash bytes as the block_access_list fallback when the full RLP-encoded block access list is not available on the block value. If the block header does not carry a BAL hash, this falls back to the canonical empty BAL hash bytes. Use Self::from_block_unchecked_with_bal when the full block access list bytes are available and should be preserved.

See also ExecutionPayloadV3::from_block_unchecked.

Note: This re-calculates the block hash.

pub fn from_block_unchecked<T, H>( block_hash: FixedBytes<32>, block: &Block<T, H>, ) -> ExecutionPayloadV4

where T: Encodable2718, H: BlockHeader,

Available on crate feature ssz only.

Converts [alloy_consensus::Block] to ExecutionPayloadV4 using the given block hash.

This uses the header’s block_access_list_hash bytes as the block_access_list fallback because the full RLP-encoded block access list is not available on the block value. If the block header does not carry a BAL hash, this falls back to the canonical empty BAL hash bytes. Use Self::from_block_unchecked_with_bal when the full block access list bytes are available and should be preserved.

See also ExecutionPayloadV3::from_block_unchecked.

pub fn from_block_unchecked_with_bal<T, H>( block_hash: FixedBytes<32>, block: &Block<T, H>, block_access_list: Bytes, ) -> ExecutionPayloadV4

where T: Encodable2718, H: BlockHeader,

Available on crate feature ssz only.

Converts [alloy_consensus::Block] to ExecutionPayloadV4 using the given block hash and block access list.

Unlike Self::from_block_unchecked, this preserves the full RLP-encoded block access list instead of falling back to the header hash bytes.

See also ExecutionPayloadV3::from_block_unchecked.

pub const fn timestamp(&self) -> u64

Available on crate feature ssz only.

Returns the timestamp for the execution payload.

pub fn try_into_block<T>(self) -> Result<Block<T>, PayloadError>

where T: Decodable2718,

Available on crate feature ssz only.

Converts ExecutionPayloadV4 to [Block].

This performs the same conversion as the underlying V3 payload, but calculates the block access list hash and sets the slot number.

See also ExecutionPayloadV3::try_into_block.

pub fn try_into_block_with<T, F, E>( self, f: F, ) -> Result<Block<T>, PayloadError>

where F: FnMut(Bytes) -> Result<T, E>, E: Into<PayloadError>,

Available on crate feature ssz only.

Converts ExecutionPayloadV4 to [Block] with a custom transaction mapper.

See also ExecutionPayloadV3::try_into_block_with.

pub fn into_block_raw(self) -> Result<Block<Bytes>, PayloadError>

Available on crate feature ssz only.

Converts ExecutionPayloadV4 to [Block] with raw [Bytes] transactions.

This is similar to Self::try_into_block_with but returns the transactions as raw bytes without any conversion.

pub fn into_block_raw_with_transactions_root( self, transactions_root: FixedBytes<32>, ) -> Result<Block<Bytes>, PayloadError>

Available on crate feature ssz only.

Converts ExecutionPayloadV4 to [Block] with raw [Bytes] transactions using the given transactions_root.

See also ExecutionPayloadV1::into_block_raw_with_transactions_root.

pub fn into_block_raw_with_transactions_root_opt( self, transactions_root: Option<FixedBytes<32>>, ) -> Result<Block<Bytes>, PayloadError>

Available on crate feature ssz only.

Converts ExecutionPayloadV4 to [Block] with raw [Bytes] transactions, optionally using the given transactions_root.

If transactions_root is None, it will be computed from the transactions.

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for ExecutionPayloadV4

fn arbitrary( u: &mut Unstructured<'arbitrary>, ) -> Result<ExecutionPayloadV4, Error>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest( u: Unstructured<'arbitrary>, ) -> Result<ExecutionPayloadV4, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for ExecutionPayloadV4

fn clone(&self) -> ExecutionPayloadV4

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExecutionPayloadV4

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

Formats the value using the given formatter.

impl Decode for ExecutionPayloadV4

Available on crate feature ssz only.

fn is_ssz_fixed_len() -> bool

Returns true if this object has a fixed-length.

fn from_ssz_bytes(bytes: &[u8]) -> Result<ExecutionPayloadV4, DecodeError>

Attempts to decode Self from bytes, returning a DecodeError on failure.

fn ssz_fixed_len() -> usize

The number of bytes this object occupies in the fixed-length portion of the SSZ bytes.

impl<'de> Deserialize<'de> for ExecutionPayloadV4

Available on crate feature serde only.

fn deserialize<D>( deserializer: D, ) -> Result<ExecutionPayloadV4, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encode for ExecutionPayloadV4

Available on crate feature ssz only.

fn is_ssz_fixed_len() -> bool

Returns true if this object has a fixed-length.

fn ssz_append(&self, buf: &mut Vec<u8>)

Append the encoding self to buf.

fn ssz_bytes_len(&self) -> usize

Returns the size (in bytes) when self is serialized.

fn ssz_fixed_len() -> usize

The number of bytes this object occupies in the fixed-length portion of the SSZ bytes.

fn as_ssz_bytes(&self) -> Vec<u8>

Returns the full-form encoding of this object.

impl Eq for ExecutionPayloadV4

impl<'a> From<BeaconExecutionPayloadV4<'a>> for ExecutionPayloadV4

fn from(payload: BeaconExecutionPayloadV4<'a>) -> ExecutionPayloadV4

Converts to this type from the input type.

impl From<ExecutionPayloadV4> for ExecutionPayload

fn from(payload: ExecutionPayloadV4) -> ExecutionPayload

Converts to this type from the input type.

impl PartialEq for ExecutionPayloadV4

fn eq(&self, other: &ExecutionPayloadV4) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ExecutionPayloadV4

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ExecutionPayloadV4

impl<T> TryFrom<ExecutionPayloadV4> for Block<T>

where T: Decodable2718,

type Error = PayloadError

The type returned in the event of a conversion error.

fn try_from( value: ExecutionPayloadV4, ) -> Result<Block<T>, <Block<T> as TryFrom<ExecutionPayloadV4>>::Error>

Performs the conversion.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 640 bytes