Struct AnyHeader

pub struct AnyHeader {

    pub parent_hash: FixedBytes<32>,
    pub ommers_hash: FixedBytes<32>,
    pub beneficiary: Address,
    pub state_root: FixedBytes<32>,
    pub transactions_root: FixedBytes<32>,
    pub receipts_root: FixedBytes<32>,
    pub logs_bloom: Bloom,
    pub difficulty: Uint<256, 4>,
    pub number: u64,
    pub gas_limit: u64,
    pub gas_used: u64,
    pub timestamp: u64,
    pub extra_data: Bytes,
    pub mix_hash: Option<FixedBytes<32>>,
    pub nonce: Option<FixedBytes<8>>,
    pub base_fee_per_gas: Option<u64>,
    pub withdrawals_root: Option<FixedBytes<32>>,
    pub blob_gas_used: Option<u64>,
    pub excess_blob_gas: Option<u64>,
    pub parent_beacon_block_root: Option<FixedBytes<32>>,
    pub requests_hash: Option<FixedBytes<32>>,
    pub target_blobs_per_block: Option<u64>,
}

Block header representation with certain fields made optional to account for possible differencies in network implementations.

Fields

parent_hash: FixedBytes<32>

Hash of the parent

ommers_hash: FixedBytes<32>

Hash of the uncles

beneficiary: Address

Alias of author

state_root: FixedBytes<32>

State root hash

transactions_root: FixedBytes<32>

Transactions root hash

receipts_root: FixedBytes<32>

Transactions receipts root hash

logs_bloom: Bloom

Logs bloom

difficulty: Uint<256, 4>

Difficulty

number: u64

Block number

gas_limit: u64

Gas Limit

gas_used: u64

Gas Used

timestamp: u64

Timestamp

extra_data: Bytes

Extra data

mix_hash: Option<FixedBytes<32>>

Mix Hash

Before the merge this proves, combined with the nonce, that a sufficient amount of computation has been carried out on this block: the Proof-of-Work (PoF).

After the merge this is prevRandao: Randomness value for the generated payload.

This is an Option because it is not always set by non-ethereum networks.

See also https://eips.ethereum.org/EIPS/eip-4399 And https://github.com/ethereum/execution-apis/issues/328

nonce: Option<FixedBytes<8>>

Nonce

base_fee_per_gas: Option<u64>

Base fee per unit of gas (if past London)

withdrawals_root: Option<FixedBytes<32>>

Withdrawals root hash added by EIP-4895 and is ignored in legacy headers.

blob_gas_used: Option<u64>

Blob gas used

excess_blob_gas: Option<u64>

Excess blob gas

parent_beacon_block_root: Option<FixedBytes<32>>

EIP-4788 parent beacon block root

requests_hash: Option<FixedBytes<32>>

EIP-7685 requests hash.

target_blobs_per_block: Option<u64>

EIP-7744 target blob count.

Trait Implementations

impl BlockHeader for AnyHeader

fn parent_hash(&self) -> FixedBytes<32>

Retrieves the parent hash of the block

fn ommers_hash(&self) -> FixedBytes<32>

Retrieves the ommers hash of the block

fn beneficiary(&self) -> Address

Retrieves the beneficiary (miner) of the block

fn state_root(&self) -> FixedBytes<32>

Retrieves the state root hash of the block

fn transactions_root(&self) -> FixedBytes<32>

Retrieves the transactions root hash of the block

fn receipts_root(&self) -> FixedBytes<32>

Retrieves the receipts root hash of the block

fn withdrawals_root(&self) -> Option<FixedBytes<32>>

Retrieves the withdrawals root hash of the block, if available

fn logs_bloom(&self) -> Bloom

Retrieves the logs bloom filter of the block

fn difficulty(&self) -> Uint<256, 4>

Retrieves the difficulty of the block

fn number(&self) -> u64

Retrieves the block number

fn gas_limit(&self) -> u64

Retrieves the gas limit of the block

fn gas_used(&self) -> u64

Retrieves the gas used by the block

fn timestamp(&self) -> u64

Retrieves the timestamp of the block

fn mix_hash(&self) -> Option<FixedBytes<32>>

Retrieves the mix hash of the block, if available

fn nonce(&self) -> Option<FixedBytes<8>>

Retrieves the nonce of the block, if avaialble

fn base_fee_per_gas(&self) -> Option<u64>

Retrieves the base fee per gas of the block, if available

fn blob_gas_used(&self) -> Option<u64>

Retrieves the blob gas used by the block, if available

fn excess_blob_gas(&self) -> Option<u64>

Retrieves the excess blob gas of the block, if available

fn parent_beacon_block_root(&self) -> Option<FixedBytes<32>>

Retrieves the parent beacon block root of the block, if available

fn requests_hash(&self) -> Option<FixedBytes<32>>

Retrieves the requests hash of the block, if available

fn target_blobs_per_block(&self) -> Option<u64>

Retrieves the target blob count of the block, if available

fn extra_data(&self) -> &Bytes

Retrieves the block’s extra data field

fn blob_fee(&self) -> Option<u128>

Returns the blob fee for this block according to the EIP-4844 spec.

fn next_block_excess_blob_gas(&self) -> Option<u64>

Calculate excess blob gas for the next block according to the EIP-4844 spec.

fn next_block_blob_fee(&self) -> Option<u128>

Returns the blob fee for the next block according to the EIP-4844 spec.

fn next_block_base_fee(&self, base_fee_params: BaseFeeParams) -> Option<u64>

Calculate base fee for next block according to the EIP-1559 spec.

fn parent_num_hash(&self) -> NumHash

Returns the parent block’s number and hash

fn is_empty(&self) -> bool

Checks if the header is considered empty - has no transactions, no ommers or withdrawals

impl Clone for AnyHeader

fn clone(&self) -> AnyHeader

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AnyHeader

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

Formats the value using the given formatter.

impl Default for AnyHeader

fn default() -> AnyHeader

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AnyHeader

fn deserialize<__D>( __deserializer: __D, ) -> Result<AnyHeader, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Header> for AnyHeader

fn from(value: Header) -> AnyHeader

Converts to this type from the input type.

impl Hash for AnyHeader

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AnyHeader

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AnyHeader

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 Eq for AnyHeader

impl StructuralPartialEq for AnyHeader