Struct Header

pub struct Header {

    pub hash: BlockHash,
    pub parent_hash: B256,
    pub uncles_hash: B256,
    pub miner: Address,
    pub state_root: B256,
    pub transactions_root: B256,
    pub receipts_root: B256,
    pub logs_bloom: Bloom,
    pub difficulty: U256,
    pub number: u64,
    pub gas_limit: u64,
    pub gas_used: u64,
    pub timestamp: u64,
    pub total_difficulty: Option<U256>,
    pub extra_data: Bytes,
    pub mix_hash: Option<B256>,
    pub nonce: Option<B64>,
    pub base_fee_per_gas: Option<u64>,
    pub withdrawals_root: Option<B256>,
    pub blob_gas_used: Option<u64>,
    pub excess_blob_gas: Option<u64>,
    pub parent_beacon_block_root: Option<B256>,
    pub requests_hash: Option<B256>,
}

Block header representation.

Fields

hash: BlockHash

Hash of the block

parent_hash: B256

Hash of the parent

uncles_hash: B256

Hash of the uncles

miner: Address

Alias of author

state_root: B256

State root hash

transactions_root: B256

Transactions root hash

receipts_root: B256

Transactions receipts root hash

logs_bloom: Bloom

Logs bloom

difficulty: U256

Difficulty

number: u64

Block number

gas_limit: u64

Gas Limit

gas_used: u64

Gas Used

timestamp: u64

Timestamp

total_difficulty: Option<U256>

Total difficulty

extra_data: Bytes

Extra data

mix_hash: Option<B256>

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

Nonce

base_fee_per_gas: Option<u64>

Base fee per unit of gas (if past London)

withdrawals_root: Option<B256>

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

EIP-4788 parent beacon block root

requests_hash: Option<B256>

EIP-7685 requests hash.

Implementations

impl Header

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

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

Returns None if excess_blob_gas is None

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

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

Returns None if excess_blob_gas is None.

See also Self::next_block_excess_blob_gas

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

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

Returns a None if no excess blob gas is set, no EIP-4844 support

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for Header

fn arbitrary(u: &mut Unstructured<'arbitrary>) -> Result<Self>

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

fn arbitrary_take_rest(u: Unstructured<'arbitrary>) -> Result<Self>

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.

impl Clone for Header

fn clone(&self) -> Header

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Header

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

Formats the value using the given formatter.

impl Default for Header

fn default() -> Header

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Header

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Header> for WithOtherFields<Header>

Available on crate feature serde only.

fn from(inner: Header) -> Self

Converts to this type from the input type.

impl Hash for Header

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

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 HeaderResponse for Header

fn hash(&self) -> BlockHash

Block hash

fn number(&self) -> u64

Block number

fn timestamp(&self) -> u64

Block timestamp

fn extra_data(&self) -> &Bytes

Extra data

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

Base fee per unit of gas (If EIP-1559 is supported)

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

Blob fee for the next block (if EIP-4844 is supported)

fn coinbase(&self) -> Address

Coinbase/Miner of the block

fn gas_limit(&self) -> u64

Gas limit of the block

fn mix_hash(&self) -> Option<B256>

Mix hash of the block

fn difficulty(&self) -> U256

Difficulty of the block

impl PartialEq for Header

fn eq(&self, other: &Header) -> 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 Header

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Header> for Header

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Header) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Header

impl StructuralPartialEq for Header