Struct Block

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

Ethereum full block.

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

Fields

header: Header

Block header.

body: BlockBody<T>

Block body.

Methods from Deref<Target = Header>

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_slow and unlock if you need the hash to be persistent.

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.

If Self::target_blobs_per_block is Some, uses EIP-7742 formula for calculating the excess blob gas, otherwise uses EIP-4844 formula.

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.

pub fn parent_num_hash(&self) -> NumHash

Returns the parent block’s number and hash

Note: for the genesis block the parent number is 0 and the parent hash is the zero hash.

pub fn num_hash_slow(&self) -> NumHash

Returns the block’s number and hash.

Note: this hashes the header.

pub fn num_hash_with_parent_slow(&self) -> BlockWithParent

Returns the block’s number and hash with the parent hash.

Note: this hashes the header.

Trait Implementations

impl<'a> Arbitrary<'a> for Block

Available on crate feature arbitrary only.

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>

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> Block for Block<T>

where T: SignedTransaction,

type Header = Header

Header part of the block.

type Body = BlockBody<T>

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

fn new(header: Self::Header, body: Self::Body) -> Self

Create new block instance.

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

Returns reference to block header.

fn body(&self) -> &Self::Body

Returns reference to block body.

fn split(self) -> (Self::Header, Self::Body)

Splits the block into its header and body.

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

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

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

impl<T: Decodable> Decodable for Block<T>

fn decode(b: &mut &[u8]) -> Result<Self>

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

impl<T> Default for Block<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T> Deref for Block<T>

type Target = Header

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'de, T> Deserialize<'de> for Block<T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: Encodable> Encodable for Block<T>

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 From<Block> for BlockBody

fn from(block: Block) -> Self

Converts to this type from the input type.

impl From<SealedBlock> for Block

fn from(block: SealedBlock) -> Self

Converts to this type from the input type.

impl<T: InMemorySize> InMemorySize for Block<T>

fn size(&self) -> usize

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

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

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

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<WithOtherFields<Block<WithOtherFields<Transaction<AnyTxEnvelope>>, Header<AnyHeader>>>> for Block

Available on crate feature alloy-compat only.

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(block: AnyRpcBlock) -> Result<Self, Self::Error>

Performs the conversion.

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

impl<T> StructuralPartialEq for Block<T>

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