Struct EvmEnv 

pub struct EvmEnv<Spec = SpecId, BlockEnv = BlockEnv> {
    pub cfg_env: CfgEnv<Spec>,
    pub block_env: BlockEnv,
}

Container type that holds both the configuration and block environment for EVM execution.

Fields

cfg_env: CfgEnv<Spec>

The configuration environment with handler settings

block_env: BlockEnv

The block environment containing block-specific data

Implementations

impl EvmEnv<SpecId>

pub fn for_eth_block( header: impl BlockHeader, chain_spec: impl EthereumHardforks, chain_id: ChainId, blob_params: Option<BlobParams>, ) -> Self

Create a new EvmEnv with SpecId from a block header, chain_id, chain_spec and optional blob_params.

Arguments

• header - The block to make the env out of.
• chain_spec - The chain hardfork description, must implement EthereumHardforks.
• chain_id - The chain identifier.
• blob_params - Optional parameters that sets limits on gas and count for blobs.

pub fn for_eth_next_block( header: impl BlockHeader, attributes: NextEvmEnvAttributes, base_fee_per_gas: u64, chain_spec: impl EthereumHardforks, chain_id: ChainId, blob_params: Option<BlobParams>, ) -> Self

Create a new EvmEnv with SpecId from a parent block header, chain_id, chain_spec and optional blob_params.

Arguments

• header - The parent block to make the env out of.
• base_fee_per_gas - Base fee per gas for the next block.
• chain_spec - The chain hardfork description, must implement EthereumHardforks.
• chain_id - The chain identifier.
• blob_params - Optional parameters that sets limits on gas and count for blobs.

impl<Spec, BlockEnv> EvmEnv<Spec, BlockEnv>

pub const fn new(cfg_env: CfgEnv<Spec>, block_env: BlockEnv) -> Self

Create a new EvmEnv from its components.

Arguments

• cfg_env_with_handler_cfg - The configuration environment with handler settings
• block - The block environment containing block-specific data

impl<Spec, BlockEnv: BlockEnvironment> EvmEnv<Spec, BlockEnv>

pub fn map_block_env<NewBlockEnv>( self, f: impl FnOnce(BlockEnv) -> NewBlockEnv, ) -> EvmEnv<Spec, NewBlockEnv>

Sets an extension on the environment.

pub const fn block_env(&self) -> &BlockEnv

Returns a reference to the block environment.

pub const fn cfg_env(&self) -> &CfgEnv<Spec>

Returns a reference to the configuration environment.

pub const fn chainid(&self) -> u64

Returns the chain ID of the environment.

pub const fn spec_id(&self) -> &Spec

Returns the spec id of the chain

pub fn with_block_number(self, number: U256) -> Self

Overrides the configured block number

pub fn with_block_number_opt(self, number: Option<U256>) -> Self

Convenience function that overrides the configured block number with the given Some(number).

This is intended for block overrides.

pub fn set_block_number_opt(&mut self, number: Option<U256>) -> &mut Self

Sets the block number if provided.

pub fn with_timestamp(self, timestamp: U256) -> Self

Overrides the configured block timestamp.

pub fn with_timestamp_opt(self, timestamp: Option<U256>) -> Self

Convenience function that overrides the configured block timestamp with the given Some(timestamp).

This is intended for block overrides.

pub fn set_timestamp_opt(&mut self, timestamp: Option<U256>) -> &mut Self

Sets the block timestamp if provided.

pub fn with_base_fee(self, base_fee: u64) -> Self

Overrides the configured block base fee.

pub fn with_base_fee_opt(self, base_fee: Option<u64>) -> Self

Convenience function that overrides the configured block base fee with the given Some(base_fee).

This is intended for block overrides.

pub fn set_base_fee_opt(&mut self, base_fee: Option<u64>) -> &mut Self

Sets the block base fee if provided.

Trait Implementations

impl<Spec: Clone, BlockEnv: Clone> Clone for EvmEnv<Spec, BlockEnv>

fn clone(&self) -> EvmEnv<Spec, BlockEnv>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Spec: Debug, BlockEnv: Debug> Debug for EvmEnv<Spec, BlockEnv>

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

Formats the value using the given formatter.

impl<Spec: Default, BlockEnv: Default> Default for EvmEnv<Spec, BlockEnv>

fn default() -> EvmEnv<Spec, BlockEnv>

Returns the “default value” for a type.

impl<Spec, BlockEnv> From<(CfgEnv<Spec>, BlockEnv)> for EvmEnv<Spec, BlockEnv>

fn from((cfg_env, block_env): (CfgEnv<Spec>, BlockEnv)) -> Self

Converts to this type from the input type.

impl<Spec: PartialEq, BlockEnv: PartialEq> PartialEq for EvmEnv<Spec, BlockEnv>

fn eq(&self, other: &EvmEnv<Spec, 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<Spec: Eq, BlockEnv: Eq> Eq for EvmEnv<Spec, BlockEnv>

impl<Spec, BlockEnv> StructuralPartialEq for EvmEnv<Spec, BlockEnv>