Struct Block

pub struct Block {
    pub header: Header,
    pub body: BlockBody,
}

Ethereum full block.

Withdrawals can be optionally included at the end of the RLP encoded message.

Fields

header: Header

Block header.

body: BlockBody

Block body.

Implementations

impl Block

pub fn seal_slow(self) -> SealedBlock

Calculate the header hash and seal the block so that it can’t be changed.

pub fn seal(self, hash: B256) -> SealedBlock

Seal the block with a known hash.

WARNING: This method does not perform validation whether the hash is correct.

pub fn senders(&self) -> Option<Vec<Address>>

Expensive operation that recovers transaction signer. See SealedBlockWithSenders.

pub fn with_senders_unchecked(self, senders: Vec<Address>) -> BlockWithSenders

Transform into a BlockWithSenders.

Panics

If the number of senders does not match the number of transactions in the block and the signer recovery for one of the transactions fails.

Note: this is expected to be called with blocks read from disk.

pub fn try_with_senders_unchecked( self, senders: Vec<Address>, ) -> Result<BlockWithSenders, Self>

Transform into a BlockWithSenders using the given senders.

If the number of senders does not match the number of transactions in the block, this falls back to manually recovery, but without ensuring that the signature has a low s value. See also TransactionSigned::recover_signer_unchecked

Returns an error if a signature is invalid.

pub fn with_recovered_senders(self) -> Option<BlockWithSenders>

Expensive. Transform into a BlockWithSenders by recovering senders in the contained transactions.

Returns None if a transaction is invalid.

Methods from Deref<Target = Header>

pub fn hash_slow(&self) -> FixedBytes<32>

Heavy function that will calculate hash of data and will not save the change to metadata.

Use [Header::seal_slow] and unlock if you need the hash to be persistent.

pub fn is_empty(&self) -> bool

Checks if the header is empty - has no transactions and no ommers

pub fn ommers_hash_is_empty(&self) -> bool

Check if the ommers hash equals to empty hash list.

pub fn transaction_root_is_empty(&self) -> bool

Check if the transaction root equals to empty root.

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_base_fee(&self, base_fee_params: BaseFeeParams) -> Option<u64>

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

Returns a None if no base fee is set, no EIP-1559 support

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

pub fn size(&self) -> usize

Calculate a heuristic for the in-memory size of the [Header].

pub fn parent_num_hash(&self) -> NumHash

Returns the parent block’s number and hash

Note: for the genesis block the parent number is 0 and the parent hash is the zero hash.

pub fn num_hash_slow(&self) -> NumHash

Returns the block’s number and hash.

Note: this hashes the header.

pub fn is_zero_difficulty(&self) -> bool

Checks if the block’s difficulty is set to zero, indicating a Proof-of-Stake header.

This function is linked to EIP-3675, proposing the consensus upgrade to Proof-of-Stake: EIP-3675

Verifies whether, as per the EIP, the block’s difficulty is updated to zero, signifying the transition to a Proof-of-Stake mechanism.

Returns true if the block’s difficulty matches the constant zero set by the EIP.

pub fn exceeds_allowed_future_timestamp(&self, present_timestamp: u64) -> bool

Checks if the block’s timestamp is in the future based on the present timestamp.

Clock can drift but this can be consensus issue.

Note: This check is relevant only pre-merge.

Trait Implementations

impl<'a> Arbitrary<'a> for Block

Available on crate feature arbitrary only.

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

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

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, 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 Block for Block

type Header = Header

Header part of the block.

type Body = BlockBody

The block’s body contains the transactions in the block.

fn body(&self) -> &Self::Body

Returns reference to block body.

fn header(&self) -> &Self::Header

Returns reference to block header.

impl Clone for Block

fn clone(&self) -> Block

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Block

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

Formats the value using the given formatter.

impl Decodable for Block

fn decode(b: &mut &[u8]) -> Result<Self>

Decodes the blob into the appropriate type. buf must be advanced past the decoded object.

impl Default for Block

fn default() -> Block

Returns the “default value” for a type.

impl Deref for Block

type Target = Header

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'de> Deserialize<'de> for Block

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodable for Block

fn encode(&self, out: &mut dyn BufMut)

Encodes the type into the out buffer.

fn length(&self) -> usize

Returns the length of the encoding of this type in bytes.

impl From<Block> for BlockBody

fn from(block: Block) -> Self

Converts to this type from the input type.

impl From<SealedBlock> for Block

fn from(block: SealedBlock) -> Self

Converts to this type from the input type.

impl InMemorySize for Block

fn size(&self) -> usize

Calculates a heuristic for the in-memory size of the Block.

impl PartialEq for Block

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<WithOtherFields<Block<WithOtherFields<Transaction<AnyTxEnvelope>>, Header<AnyHeader>>>> for Block

Available on crate feature alloy-compat only.

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(block: AnyRpcBlock) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Block

impl StructuralPartialEq for Block

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: 792 bytes