Struct SealedBlock

pub struct SealedBlock<H = Header, B = BlockBody> {
    pub header: SealedHeader<H>,
    pub body: B,
}

Sealed Ethereum full block.

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

Fields

header: SealedHeader<H>

Locked block header.

body: B

Block body.

Implementations

impl<H, B> SealedBlock<H, B>

pub const fn new(header: SealedHeader<H>, body: B) -> SealedBlock<H, B>

Create a new sealed block instance using the sealed header and block body.

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

Header hash.

pub fn split_header_body(self) -> (SealedHeader<H>, B)

Splits the BlockBody and SealedHeader into separate components

impl SealedBlock

pub fn split(self) -> (SealedHeader, Vec<TransactionSigned>, Vec<Header>)

Splits the sealed block into underlying components

pub fn blob_transactions_iter(&self) -> impl Iterator<Item = &TransactionSigned>

Returns an iterator over all blob transactions of the block

pub fn blob_transactions(&self) -> Vec<&TransactionSigned>

Returns only the blob transactions, if any, from the block body.

pub fn blob_versioned_hashes_iter( &self, ) -> impl Iterator<Item = &FixedBytes<32>>

Returns an iterator over all blob versioned hashes from the block body.

pub fn blob_versioned_hashes(&self) -> Vec<&FixedBytes<32>>

Returns all blob versioned hashes from the block body.

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

Expensive operation that recovers transaction signer. See SealedBlockWithSenders.

pub fn seal_with_senders(self) -> Option<SealedBlockWithSenders>

Seal sealed block with recovered transaction senders.

pub fn try_seal_with_senders( self, ) -> Result<SealedBlockWithSenders, SealedBlock>

Seal sealed block with recovered transaction senders.

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

Transform into a SealedBlockWithSenders.

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.

pub fn try_with_senders_unchecked( self, senders: Vec<Address>, ) -> Result<SealedBlockWithSenders, SealedBlock>

Transform into a SealedBlockWithSenders 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 unseal(self) -> Block

Unseal the block

pub fn blob_gas_used(&self) -> u64

Calculates the total gas used by blob transactions in the sealed block.

pub fn has_blob_transactions(&self) -> bool

Returns whether or not the block contains any blob transactions.

pub fn has_eip7702_transactions(&self) -> bool

Returns whether or not the block contains any eip-7702 transactions.

pub fn ensure_transaction_root_valid( &self, ) -> Result<(), GotExpected<FixedBytes<32>>>

Ensures that the transaction root in the block header is valid.

The transaction root is the Keccak 256-bit hash of the root node of the trie structure populated with each transaction in the transactions list portion of the block.

Returns

Returns Ok(()) if the calculated transaction root matches the one stored in the header, indicating that the transactions in the block are correctly represented in the trie.

Returns Err(error) if the transaction root validation fails, providing a GotExpected error containing the calculated and expected roots.

pub fn raw_transactions(&self) -> Vec<Bytes>

Returns a vector of transactions RLP encoded with [alloy_eips::eip2718::Encodable2718::encoded_2718].

Methods from Deref<Target = SealedHeader<H>>

pub fn header(&self) -> &H

Returns the sealed Header fields.

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

Returns header/block hash.

pub fn num_hash(&self) -> NumHash

Return the number hash tuple.

pub fn set_header(&mut self, header: Header)

Available on crate feature test-utils only.

Updates the block header.

pub fn set_hash(&mut self, hash: FixedBytes<32>)

Available on crate feature test-utils only.

Updates the block hash.

pub fn set_parent_hash(&mut self, hash: FixedBytes<32>)

Available on crate feature test-utils only.

Updates the parent block hash.

pub fn set_block_number(&mut self, number: u64)

Available on crate feature test-utils only.

Updates the block number.

pub fn set_state_root(&mut self, state_root: FixedBytes<32>)

Available on crate feature test-utils only.

Updates the block state root.

pub fn set_difficulty(&mut self, difficulty: Uint<256, 4>)

Available on crate feature test-utils only.

Updates the block difficulty.

Trait Implementations

impl<'a, H, B> Arbitrary<'a> for SealedBlock<H, B>

where SealedHeader<H>: Arbitrary<'a>, B: Arbitrary<'a>,

Available on crate feature arbitrary only.

fn arbitrary(u: &mut Unstructured<'a>) -> Result<SealedBlock<H, B>, Error>

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<H, B> Block for SealedBlock<H, B>

where H: BlockHeader + 'static, B: BlockBody + 'static, SealedBlock<H, B>: Serialize + for<'a> Deserialize<'a>,

type Header = H

Header part of the block.

type Body = B

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

fn header(&self) -> &<SealedBlock<H, B> as Block>::Header

Returns reference to block header.

fn body(&self) -> &<SealedBlock<H, B> as Block>::Body

Returns reference to block body.

impl<H, B> Clone for SealedBlock<H, B>

where H: Clone, B: Clone,

fn clone(&self) -> SealedBlock<H, B>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<H, B> Debug for SealedBlock<H, B>

where H: Debug, B: Debug,

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

Formats the value using the given formatter.

impl Decodable for SealedBlock

fn decode(b: &mut &[u8]) -> Result<SealedBlock, Error>

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

impl<H, B> Default for SealedBlock<H, B>

where SealedHeader<H>: Default, B: Default,

fn default() -> SealedBlock<H, B>

Returns the “default value” for a type.

impl<H, B> Deref for SealedBlock<H, B>

type Target = SealedHeader<H>

The resulting type after dereferencing.

fn deref(&self) -> &<SealedBlock<H, B> as Deref>::Target

Dereferences the value.

impl<H, B> DerefMut for SealedBlock<H, B>

fn deref_mut(&mut self) -> &mut <SealedBlock<H, B> as Deref>::Target

Mutably dereferences the value.

impl<'de, H, B> Deserialize<'de> for SealedBlock<H, B>

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de> DeserializeAs<'de, SealedBlock> for SealedBlock<'de>

fn deserialize_as<D>( deserializer: D, ) -> Result<SealedBlock, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodable for SealedBlock

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<'a> From<&'a SealedBlock> for SealedBlock<'a>

fn from(value: &'a SealedBlock) -> SealedBlock<'a>

Converts to this type from the input type.

impl<'a> From<SealedBlock<'a>> for SealedBlock

fn from(value: SealedBlock<'a>) -> SealedBlock

Converts to this type from the input type.

impl From<SealedBlock> for Block

fn from(block: SealedBlock) -> Block

Converts to this type from the input type.

impl<H, B> InMemorySize for SealedBlock<H, B>

where H: InMemorySize, B: InMemorySize,

fn size(&self) -> usize

Returns a heuristic for the in-memory size of a struct.

impl<H, B> PartialEq for SealedBlock<H, B>

where H: PartialEq, B: PartialEq,

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

where H: Serialize, B: 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 SerializeAs<SealedBlock> for SealedBlock<'_>

fn serialize_as<S>( source: &SealedBlock, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<H, B> Eq for SealedBlock<H, B>

where H: Eq, B: Eq,

impl<H, B> StructuralPartialEq for SealedBlock<H, B>

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.