Struct reth::primitives::SealedBlock

pub struct SealedBlock {
    pub header: SealedHeader,
    pub body: Vec<TransactionSigned>,
    pub ommers: Vec<Header>,
    pub withdrawals: Option<Withdrawals>,
    pub requests: Option<Requests>,
}

Sealed Ethereum full block.

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

Fields

header: SealedHeader

Locked block header.

body: Vec<TransactionSigned>

Transactions with signatures.

ommers: Vec<Header>

Ommer/uncle headers

withdrawals: Option<Withdrawals>

Block withdrawals.

requests: Option<Requests>

Block requests.

Implementations

impl SealedBlock

pub fn new(header: SealedHeader, body: BlockBody) -> SealedBlock

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(self) -> (SealedHeader, Vec<TransactionSigned>, Vec<Header>)

Splits the sealed block into underlying components

pub fn split_header_body(self) -> (SealedHeader, BlockBody)

Splits the BlockBody and SealedHeader into separate 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 size(&self) -> usize

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

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 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 TransactionSigned::encode_enveloped.

Methods from Deref<Target = SealedHeader>

pub fn header(&self) -> &Header

Returns the sealed Header fields.

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

Returns header/block hash.

pub fn num_hash(&self) -> BlockNumHash

Return the number hash tuple.

pub fn size(&self) -> usize

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

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.

Methods from Deref<Target = 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 ensure_extradata_valid(&self) -> Result<(), HeaderError>

Performs a sanity check on the extradata field of the header.

Errors

Returns an error if the extradata size is larger than 100 KB.

pub fn ensure_difficulty_valid(&self) -> Result<(), HeaderError>

Performs a sanity check on the block difficulty field of the header.

Errors

Returns an error if the block difficulty exceeds 80 bits.

pub fn ensure_well_formed(&self) -> Result<(), HeaderError>

Performs combined sanity checks on multiple header fields.

This method combines checks for block difficulty and extradata sizes.

Errors

Returns an error if either the block difficulty exceeds 80 bits or if the extradata size is larger than 100 KB.

pub fn is_timestamp_in_past(&self, parent_timestamp: u64) -> bool

Checks if the block’s timestamp is in the past compared to the parent block’s timestamp.

Note: This check is relevant only pre-merge.

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.

pub fn parent_num_hash(&self) -> BlockNumHash

Returns the parent block’s number and hash

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, SealedHeader and unlock if you need 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.

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for SealedBlock

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

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

fn arbitrary_take_rest( u: Unstructured<'arbitrary>, ) -> Result<SealedBlock, 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.

impl Clone for SealedBlock

fn clone(&self) -> SealedBlock

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SealedBlock

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 Default for SealedBlock

fn default() -> SealedBlock

Returns the “default value” for a type.

impl Deref for SealedBlock

type Target = SealedHeader

The resulting type after dereferencing.

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

Dereferences the value.

impl DerefMut for SealedBlock

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

Mutably dereferences the value.

impl<'de> Deserialize<'de> for SealedBlock

fn deserialize<__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 length(&self) -> usize

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

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

Encodes the type into the out buffer.

impl From<SealedBlock> for Block

fn from(block: SealedBlock) -> Block

Converts to this type from the input type.

impl PartialEq for SealedBlock

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

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 Eq for SealedBlock

impl StructuralPartialEq for SealedBlock

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