Struct alloy_rpc_types_eth::Block

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

Block representation for RPC.

Fields

header: H

Header of the block.

uncles: Vec<B256>

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) -> Self

Creates a new empty block (without transactions).

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

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 with_transactions(self, transactions: BlockTransactions<T>) -> Self

Sets the transactions for the block.

pub fn with_withdrawals(self, withdrawals: Option<Withdrawals>) -> Self

Sets the withdrawals for the block.

pub fn with_uncles(self, uncles: Vec<B256>) -> Self

Sets the uncles for the block.

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 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 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 successfully.

impl<T: TransactionResponse, H> Block<T, H>

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

Converts a block with Tx hashes into a full block.

impl<T, H: Sealable + Encodable> Block<T, Header<H>>

pub fn uncle_from_header(header: H) -> Self

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 fn from_consensus(block: Block<T>, total_difficulty: Option<U256>) -> Self

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 alloy_consensus::Block.

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.

Trait Implementations

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

type Header = H

Header type

type Transaction = T

Transaction type

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

Block header

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

Block transactions

fn transactions_mut(&mut self) -> &mut BlockTransactions<Self::Transaction>

Mutable reference to block transactions

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

Returns the other field from WithOtherFields type.

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

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

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

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

fn default() -> Self

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<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Block> for WithOtherFields<Block>

fn from(inner: Block) -> Self

Converts to this type from the input type.

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

fn eq(&self, other: &Block<T, H>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method 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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Eq, H: Eq> Eq for Block<T, H>

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