Type Alias Block

pub type Block<T = TransactionSigned, H = Header> = Block<T, H>;

Ethereum full block.

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

Aliased Type

struct Block<T = TransactionSigned, H = Header> {
    pub header: H,
    pub body: BlockBody<T, H>,
}

Fields

header: H

Block header.

body: BlockBody<T, H>

Block body.

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.

Implementations

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

pub const fn new(header: H, body: BlockBody<T, H>) -> Block<T, H>

Creates a new block with the given header and body.

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

Creates a new empty uncle block.

pub fn into_header(self) -> H

Consumes the block and returns the header.

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

Consumes the block and returns the body.

pub fn map_header<U>(self, f: impl FnMut(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 FnMut(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 successfully.

pub fn rlp_length_for(header: &H, body: &BlockBody<T, H>) -> usize

where H: Encodable, T: Encodable,

Returns the RLP encoded length of the block’s header and body.

Trait Implementations

impl<'a, T, H> Arbitrary<'a> for Block<T, H>

where T: Arbitrary<'a>, H: Arbitrary<'a>,

Available on crate feature arbitrary only.

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Block<T, H>, 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<T, H> Block for Block<T, H>

where T: SignedTransaction, H: BlockHeader,

type Header = H

Header part of the block.

type Body = BlockBody<T, H>

The block’s body contains the transactions in the block and additional data, e.g. withdrawals in ethereum.

fn new( header: <Block<T, H> as Block>::Header, body: <Block<T, H> as Block>::Body, ) -> Block<T, H>

Create new block instance.

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

Returns reference to block header.

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

Returns reference to block body.

fn split(self) -> (<Block<T, H> as Block>::Header, <Block<T, H> as Block>::Body)

Splits the block into its header and body.

fn rlp_length( header: &<Block<T, H> as Block>::Header, body: &<Block<T, H> as Block>::Body, ) -> usize

Returns the rlp length of the block with the given header and body.

fn new_sealed( header: SealedHeader<Self::Header>, body: Self::Body, ) -> SealedBlock<Self>

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

fn seal_unchecked(self, hash: FixedBytes<32>) -> SealedBlock<Self>

Seal the block with a known hash.

fn seal(self) -> SealedBlock<Self>

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

fn seal_slow(self) -> SealedBlock<Self>

Calculate the header hash and seal the block so that it can’t be changed.

fn split_ref(&self) -> (&Self::Header, &Self::Body)

Returns a tuple of references to the block’s header and body.

fn into_header(self) -> Self::Header

Consumes the block and returns the header.

fn into_body(self) -> Self::Body

Consumes the block and returns the body.

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

where <Self::Body as BlockBody>::Transaction: SignedTransaction,

Expensive operation that recovers transaction signer.

fn try_into_recovered_unchecked( self, senders: Vec<Address>, ) -> Result<RecoveredBlock<Self>, BlockRecoveryError<Self>>

where <Self::Body as BlockBody>::Transaction: SignedTransaction,

Transform the block into a RecoveredBlock using the given senders.

fn into_recovered_with_signers( self, signers: Vec<Address>, ) -> RecoveredBlock<Self>

where <Self::Body as BlockBody>::Transaction: SignedTransaction,

Transform the block into a RecoveredBlock using the given signers.

fn try_into_recovered( self, ) -> Result<RecoveredBlock<Self>, BlockRecoveryError<Self>>

where <Self::Body as BlockBody>::Transaction: SignedTransaction,

Expensive. Transform into a RecoveredBlock by recovering senders in the contained transactions.

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

where T: Clone, H: Clone,

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

where T: Decodable, H: Decodable,

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

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

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

where H: Default,

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

Returns the “default value” for a type.

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

type Target = H

The resulting type after dereferencing.

fn deref(&self) -> &<Block<T, H> as Deref>::Target

Dereferences the value.

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

where T: Encodable, H: Encodable,

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

fn withdrawals(&self) -> Option<&Withdrawals>

Returns reference to withdrawals in the block if present

impl<'a, T, H> From<Block<'a, T, H>> for Block<T, H>

where T: SerdeBincodeCompat, H: SerdeBincodeCompat,

fn from(value: Block<'a, T, H>) -> Block<T, H>

Converts to this type from the input type.

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

where T: InMemorySize, H: InMemorySize,

fn size(&self) -> usize

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

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

where T: SerdeBincodeCompat, H: SerdeBincodeCompat,

type BincodeRepr<'a> = Block<'a, T, H>

Serde representation of the type for bincode serialization.

fn as_repr(&self) -> <Block<T, H> as SerdeBincodeCompat>::BincodeRepr<'_>

Convert this type into its bincode representation

fn from_repr( repr: <Block<T, H> as SerdeBincodeCompat>::BincodeRepr<'_>, ) -> Block<T, H>

Convert from the bincode representation

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

where T: SignedTransaction, H: TestHeader,

Available on crate feature test-utils only.

fn body_mut(&mut self) -> &mut <Block<T, H> as Block>::Body

Returns mutable reference to block body.

fn header_mut(&mut self) -> &mut <Block<T, H> as Block>::Header

Returns mutable reference to block header.

fn set_header(&mut self, header: <Block<T, H> as Block>::Header)

Updates the block header.

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

Updates the parent block hash.

fn set_block_number(&mut self, number: u64)

Updates the block number.

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

Updates the block state root.

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

Updates the block difficulty.

impl<T> TryFrom<ExecutionPayload> for Block<T>

where T: Decodable2718,

type Error = PayloadError

The type returned in the event of a conversion error.

fn try_from( value: ExecutionPayload, ) -> Result<Block<T>, <Block<T> as TryFrom<ExecutionPayload>>::Error>

Performs the conversion.

impl<T> TryFrom<ExecutionPayloadV1> for Block<T>

where T: Decodable2718,

type Error = PayloadError

The type returned in the event of a conversion error.

fn try_from( value: ExecutionPayloadV1, ) -> Result<Block<T>, <Block<T> as TryFrom<ExecutionPayloadV1>>::Error>

Performs the conversion.

impl<T> TryFrom<ExecutionPayloadV2> for Block<T>

where T: Decodable2718,

type Error = PayloadError

The type returned in the event of a conversion error.

fn try_from( value: ExecutionPayloadV2, ) -> Result<Block<T>, <Block<T> as TryFrom<ExecutionPayloadV2>>::Error>

Performs the conversion.

impl<T> TryFrom<ExecutionPayloadV3> for Block<T>

where T: Decodable2718,

type Error = PayloadError

The type returned in the event of a conversion error.

fn try_from( value: ExecutionPayloadV3, ) -> Result<Block<T>, <Block<T> as TryFrom<ExecutionPayloadV3>>::Error>

Performs the conversion.

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

where T: Eq, H: Eq,

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