Struct BlockEnv

pub struct BlockEnv {
    pub number: Uint<256, 4>,
    pub coinbase: Address,
    pub timestamp: Uint<256, 4>,
    pub gas_limit: Uint<256, 4>,
    pub basefee: Uint<256, 4>,
    pub difficulty: Uint<256, 4>,
    pub prevrandao: Option<FixedBytes<32>>,
    pub blob_excess_gas_and_price: Option<BlobExcessGasAndPrice>,
}

The block environment.

Fields

number: Uint<256, 4>

The number of ancestor blocks of this block (block height).

coinbase: Address

Coinbase or miner or address that created and signed the block.

This is the receiver address of all the gas spent in the block.

timestamp: Uint<256, 4>

The timestamp of the block in seconds since the UNIX epoch.

gas_limit: Uint<256, 4>

The gas limit of the block.

basefee: Uint<256, 4>

The base fee per gas, added in the London upgrade with EIP-1559.

difficulty: Uint<256, 4>

The difficulty of the block.

Unused after the Paris (AKA the merge) upgrade, and replaced by prevrandao.

prevrandao: Option<FixedBytes<32>>

The output of the randomness beacon provided by the beacon chain.

Replaces difficulty after the Paris (AKA the merge) upgrade with EIP-4399.

NOTE: prevrandao can be found in a block in place of mix_hash.

blob_excess_gas_and_price: Option<BlobExcessGasAndPrice>

Excess blob gas and blob gasprice. See also crate::calc_excess_blob_gas and calc_blob_gasprice.

Incorporated as part of the Cancun upgrade via EIP-4844.

Implementations

impl BlockEnv

pub fn set_blob_excess_gas_and_price(&mut self, excess_blob_gas: u64)

Takes blob_excess_gas saves it inside env and calculates blob_fee with BlobExcessGasAndPrice.

pub fn get_blob_gasprice(&self) -> Option<u128>

See EIP-4844 and crate::calc_blob_gasprice.

Returns None if Cancun is not enabled. This is enforced in Env::validate_block_env.

pub fn get_blob_excess_gas(&self) -> Option<u64>

Return blob_excess_gas header field. See EIP-4844.

Returns None if Cancun is not enabled. This is enforced in Env::validate_block_env.

pub fn clear(&mut self)

Clears environment and resets fields to default values.

Trait Implementations

impl Clone for BlockEnv

fn clone(&self) -> BlockEnv

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BlockEnv

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

Formats the value using the given formatter.

impl Default for BlockEnv

fn default() -> BlockEnv

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BlockEnv

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for BlockEnv

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BlockEnv

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

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 BlockEnv

impl StructuralPartialEq for BlockEnv

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