Struct Block 

pub struct Block<T = Transaction, H = Header> {
    pub header: H,
    pub uncles: Vec<FixedBytes<32>>,
    pub transactions: BlockTransactions<T>,
    pub withdrawals: Option<Withdrawals>,
}

Available on crate feature eth only.

Block representation for RPC.

Fields

header: H

Header of the block.

uncles: Vec<FixedBytes<32>>

Uncles’ hashes.

transactions: BlockTransactions<T>

Block Transactions. In the case of an uncle block, this field is not included in RPC responses, and when deserialized, it will be set to BlockTransactions::Uncle.

withdrawals: Option<Withdrawals>

Withdrawals in the block.

Implementations

impl<T, H> Block<T, H>

pub const fn empty(header: H) -> Block<T, H>

Creates a new empty block (without transactions).

pub const fn new(header: H, transactions: BlockTransactions<T>) -> Block<T, H>

Creates a new Block with the given header and transactions.

Note: This does not set the withdrawals for the block.

use alloy_eips::eip4895::Withdrawals;
use alloy_network_primitives::BlockTransactions;
use alloy_rpc_types_eth::{Block, Header, Transaction};
let block = Block::new(
    Header::new(alloy_consensus::Header::default()),
    BlockTransactions::<Transaction>::Full(vec![]),
)
.with_withdrawals(Some(Withdrawals::default()));

pub fn number(&self) -> u64

where H: BlockHeader,

Returns the block’s number.

pub fn apply<F>(self, f: F) -> Block<T, H>

where F: FnOnce(Block<T, H>) -> Block<T, H>,

Apply a function to the block, returning the modified block.

pub fn with_transactions( self, transactions: BlockTransactions<T>, ) -> Block<T, H>

Sets the transactions for the block.

pub fn with_withdrawals(self, withdrawals: Option<Withdrawals>) -> Block<T, H>

Sets the withdrawals for the block.

pub fn with_uncles(self, uncles: Vec<FixedBytes<32>>) -> Block<T, H>

Sets the uncles for the block.

pub fn try_into_transactions( self, ) -> Result<Vec<T>, ValueError<BlockTransactions<T>>>

Tries to convert inner transactions into a vector of full transactions

Returns an error if the block contains only transaction hashes or if it is an uncle block.

pub fn into_transactions_vec(self) -> Vec<T>

Consumes the type and returns the transactions as a vector.

Note: if this is an uncle or hashes, this will return an empty vector.

pub fn into_hashes_vec(self) -> Vec<FixedBytes<32>>

where T: TransactionResponse,

Consumes the type and returns the transaction hashes as a vector.

Note: if this is an uncle, this will return an empty vector.

pub fn try_into_block_body( self, ) -> Result<BlockBody<T, H>, ValueError<Block<T, H>>>

Converts this block into a BlockBody.

Returns an error if the transactions are not full or if the block has uncles.

pub fn into_block_body_unchecked(self) -> BlockBody<T, H>

Converts this block into a BlockBody

Caution: The body will have empty transactions unless the block’s transactions are BlockTransactions::Full. This will disregard ommers/uncles and always return an empty ommers vec.

pub fn into_consensus_block(self) -> Block<T, H>

Consumes the block and returns the alloy_consensus::Block with the current transaction and header type.

Note: Unlike Self::into_consensus, this method returns the Header type H as-is without converting it to alloy_consensus::Header, See Header::into_consensus.

This has two caveats:

• The returned block will always have empty uncles.
• If the block’s transaction is not BlockTransactions::Full, the returned block will have an empty transaction vec.

pub fn map_header<U>(self, f: impl FnOnce(H) -> U) -> Block<T, U>

Converts the block’s header type by applying a function to it.

pub fn into_header(self) -> H

Consumes the block and only returns the rpc header.

To obtain the underlying alloy_consensus::Header use Block::into_consensus_header.

pub fn try_convert_header<U>( self, ) -> Result<Block<T, U>, <U as TryFrom<H>>::Error>

where U: TryFrom<H>,

Converts the block’s header type to the given alternative that is TryFrom<H>

pub fn try_map_header<U, E>( self, f: impl FnOnce(H) -> Result<U, E>, ) -> Result<Block<T, U>, E>

Converts the block’s header type by applying a fallible function to it.

pub fn convert_transactions<U>(self) -> Block<U, H>

where U: From<T>,

Converts the block’s transaction type to the given alternative that is From<T>

pub fn try_convert_transactions<U>( self, ) -> Result<Block<U, H>, <U as TryFrom<T>>::Error>

where U: TryFrom<T>,

Converts the block’s transaction to the given alternative that is TryFrom<T>

Returns the block with the new transaction type if all conversions were successful.

pub fn map_transactions<U>(self, f: impl FnMut(T) -> U) -> Block<U, H>

Converts the block’s transaction type by applying a function to each transaction.

Returns the block with the new transaction type.

pub fn try_map_transactions<U, E>( self, f: impl FnMut(T) -> Result<U, E>, ) -> Result<Block<U, H>, E>

Converts the block’s transaction type by applying a fallible function to each transaction.

Returns the block with the new transaction type if all transactions were mapped successfully.

pub fn calculate_transactions_root(&self) -> Option<FixedBytes<32>>

where T: Encodable2718,

Calculate the transaction root for the full transactions in this block type.

Returns None if the transactions is not the BlockTransactions::Full variant.

impl<T, H> Block<T, H>

where T: TransactionResponse,

pub fn into_full_block(self, txs: Vec<T>) -> Block<T, H>

Converts a block with Tx hashes into a full block.

impl<T, H> Block<T, Header<H>>

where H: Sealable + Encodable,

pub fn uncle_from_header(header: H) -> Block<T, Header<H>>

Constructs an “uncle block” from the provided header.

This function creates a new Block structure for uncle blocks (ommer blocks), using the provided alloy_consensus::Header.

impl<T> Block<T>

pub const fn hash(&self) -> FixedBytes<32>

Returns the block’s hash as received from rpc.

pub const fn sealed_header(&self) -> Sealed<&Header>

Returns a sealed reference of the header: Sealed<&Header>

pub fn into_sealed_header(self) -> Sealed<Header>

Consumes the type and returns the sealed alloy_consensus::Header.

pub fn into_consensus_header(self) -> Header

Consumes the type, strips away the rpc context from the rpc Header type and just returns the alloy_consensus::Header.

pub fn from_consensus( block: Block<T>, total_difficulty: Option<Uint<256, 4>>, ) -> Block<T>

where T: Encodable,

Constructs block from a consensus block and total_difficulty.

pub fn into_consensus(self) -> Block<T>

Consumes the block and returns the ethereum alloy_consensus::Block with the ethereum header type.

This has two caveats:

• The returned block will always have empty uncles.
• If the block’s transaction is not BlockTransactions::Full, the returned block will have an empty transaction vec.

pub fn into_consensus_sealed(self) -> Sealed<Block<T>>

Same as Self::into_consensus but returns the block as Sealed with the block’s hash.

Trait Implementations

impl<T, H> BlockResponse for Block<T, H>

where T: TransactionResponse,

type Header = H

Header type

type Transaction = T

Transaction type

fn header(&self) -> &<Block<T, H> as BlockResponse>::Header

Block header

fn transactions(&self) -> &BlockTransactions<T>

Block transactions

fn transactions_mut( &mut self, ) -> &mut BlockTransactions<<Block<T, H> as BlockResponse>::Transaction>

Mutable reference to block transactions

fn other_fields(&self) -> Option<&OtherFields>

Returns the other field from WithOtherFields type.

impl<T, H> Clone for Block<T, H>

where T: Clone, H: Clone,

fn clone(&self) -> Block<T, H>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, H> Debug for Block<T, H>

where T: Debug, H: Debug,

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

Formats the value using the given formatter.

impl<T, H> Default for Block<T, H>

where H: Default,

fn default() -> Block<T, H>

Returns the “default value” for a type.

impl<'de, T, H> Deserialize<'de> for Block<T, H>

where T: Deserialize<'de>, H: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T, H> PartialEq for Block<T, H>

where T: PartialEq, H: PartialEq,

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

where T: Serialize, H: Serialize,

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<T, H> Eq for Block<T, H>

where T: Eq, H: Eq,

impl<T, H> StructuralPartialEq for Block<T, H>

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.