Struct SealedBlock

Help

pub struct SealedBlock<B>where
    B: Block,
{ /* private fields */ }

Expand description

Sealed full block composed of the block’s header and body.

This type uses lazy sealing to avoid hashing the header until it is needed, see also SealedHeader.

Implementations§

§

impl SealedBlock
where B: Block,

pub fn seal_slow(block: B) -> SealedBlock

Hashes the header and creates a sealed block.

This calculates the header hash. To create a SealedBlock without calculating the hash upfront see SealedBlock::new_unhashed

pub fn new_unchecked(block: B, hash: FixedBytes<32>) -> SealedBlock

Create a new sealed block instance using the block.

Caution: This assumes the given hash is the block’s hash.

pub fn new_unhashed(block: B) -> SealedBlock

Creates a SealedBlock from the block without the available hash

pub fn seal_parts( header: ::Header, body: ::Body, ) -> SealedBlock

Creates the SealedBlock from the block’s parts by hashing the header.

This calculates the header hash. To create a SealedBlock from its parts without calculating the hash upfront see SealedBlock::from_parts_unhashed

pub fn from_parts_unhashed( header: ::Header, body: ::Body, ) -> SealedBlock

Creates the SealedBlock from the block’s parts without calculating the hash upfront.

pub fn from_parts_unchecked( header: ::Header, body: ::Body, hash: FixedBytes<32>, ) -> SealedBlock

Creates the SealedBlock from the block’s parts.

pub fn from_sealed_parts( header: SealedHeader<::Header>, body: ::Body, ) -> SealedBlock

Creates the SealedBlock from the SealedHeader and the body.

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

Returns a reference to the block hash.

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

Returns the block hash.

pub fn split(self) -> (B, FixedBytes<32>)

Consumes the type and returns its components.

pub fn into_block(self) -> B

Consumes the type and returns the block.

pub fn unseal(self) -> B

Consumes the type and returns the block.

pub fn clone_block(&self) -> B

Clones the wrapped block.

pub const fn with_senders(self, senders: Vec<Address>) -> RecoveredBlock

Converts this block into a RecoveredBlock with the given senders

Note: This method assumes the senders are correct and does not validate them.

pub fn try_with_senders( self, senders: Vec<Address>, ) -> Result<RecoveredBlock, BlockRecoveryError<SealedBlock>>

Converts this block into a RecoveredBlock with the given senders if the number of senders is equal to the number of transactions in the block and recovers the senders from the transactions, if not using SignedTransaction::recover_signer to recover the senders.

Returns an error if any of the transactions fail to recover the sender.

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

Converts this block into a RecoveredBlock with the given senders if the number of senders is equal to the number of transactions in the block and recovers the senders from the transactions, if not using SignedTransaction::recover_signer_unchecked to recover the senders.

Returns an error if any of the transactions fail to recover the sender.

pub fn try_recover( self, ) -> Result<RecoveredBlock, BlockRecoveryError<SealedBlock>>

Recovers the senders from the transactions in the block using SignedTransaction::recover_signer.

Returns an error if any of the transactions fail to recover the sender.

pub fn try_recover_unchecked( self, ) -> Result<RecoveredBlock, BlockRecoveryError<SealedBlock>>

Recovers the senders from the transactions in the block using SignedTransaction::recover_signer_unchecked.

Returns an error if any of the transactions fail to recover the sender.

Returns reference to block header.

pub const fn body(&self) -> &::Body

Returns reference to block body.

pub fn rlp_length(&self) -> usize

Returns the length of the block.

pub fn senders(&self) -> Result<Vec<Address>, RecoveryError>

Recovers all senders from the transactions in the block.

Returns None if any of the transactions fail to recover the sender.

pub fn num_hash(&self) -> NumHash

Return the number hash tuple.

pub fn block_with_parent(&self) -> BlockWithParent

Return a [BlockWithParent] for this header.

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

Returns the Sealed header.

pub fn sealed_header_ref(&self) -> SealedHeader<&::Header>

Returns the wrapped SealedHeader<B::Header> as SealedHeader<&B::Header>.

pub fn clone_sealed_header(&self) -> SealedHeader<::Header>

Clones the wrapped header and returns a SealedHeader sealed with the hash.

pub fn into_sealed_header(self) -> SealedHeader<::Header>

Consumes the block and returns the sealed header.

pub fn into_header(self) -> ::Header

Consumes the block and returns the header.

pub fn into_body(self) -> ::Body

Consumes the block and returns the body.

pub fn split_header_body(self) -> (::Header, ::Body)

Splits the block into body and header into separate components

pub fn split_sealed_header_body( self, ) -> (SealedHeader<::Header>, ::Body)

Splits the block into body and header into separate components.

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 transaction_count(&self) -> usize

Returns the number of transactions in the block.

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.

§