Struct CfgEnv

#[non_exhaustive]
pub struct CfgEnv<SPEC = SpecId> {
    pub chain_id: u64,
    pub spec: SPEC,
    pub limit_contract_code_size: Option<usize>,
    pub disable_nonce_check: bool,
    pub blob_target_and_max_count: Vec<(SpecId, u64, u64)>,
    pub memory_limit: u64,
    pub disable_balance_check: bool,
    pub disable_block_gas_limit: bool,
    pub disable_eip3607: bool,
    pub disable_base_fee: bool,
}

EVM configuration

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

chain_id: u64

Chain ID of the EVM

chain_id will be compared to the transaction’s Chain ID.

Chain ID is introduced EIP-155.

spec: SPEC

Specification for EVM represent the hardfork

limit_contract_code_size: Option<usize>

If some it will effects EIP-170: Contract code size limit.

Useful to increase this because of tests.

By default it is 0x6000 (~25kb).

disable_nonce_check: bool

Skips the nonce validation against the account’s nonce

blob_target_and_max_count: Vec<(SpecId, u64, u64)>

Blob target count. EIP-7840 Add blob schedule to EL config files.

Note : Items must be sorted by SpecId.

memory_limit: u64

A hard memory limit in bytes beyond which OutOfGasError::Memory cannot be resized.

In cases where the gas limit may be extraordinarily high, it is recommended to set this to a sane value to prevent memory allocation panics.

Defaults to 2^32 - 1 bytes per EIP-1985.

disable_balance_check: bool

Skip balance checks if true

Adds transaction cost to balance to ensure execution doesn’t fail.

By default, it is set to false.

disable_block_gas_limit: bool

There are use cases where it’s allowed to provide a gas limit that’s higher than a block’s gas limit.

To that end, you can disable the block gas limit validation.

By default, it is set to false.

disable_eip3607: bool

EIP-3607 rejects transactions from senders with deployed code

In development, it can be desirable to simulate calls from contracts, which this setting allows.

By default, it is set to false.

disable_base_fee: bool

Disables base fee checks for EIP-1559 transactions

This is useful for testing method calls with zero gas price.

By default, it is set to false.

Implementations

impl CfgEnv

pub fn new() -> Self

Creates new CfgEnv with default values.

impl<SPEC> CfgEnv<SPEC>

pub fn new_with_spec(spec: SPEC) -> Self

Create new CfgEnv with default values and specified spec.

pub fn with_chain_id(self, chain_id: u64) -> Self

Consumes self and returns a new CfgEnv with the specified chain ID.

pub fn with_spec<OSPEC: Into<SpecId>>(self, spec: OSPEC) -> CfgEnv<OSPEC>

Consumes self and returns a new CfgEnv with the specified spec.

pub fn with_blob_max_and_target_count( self, blob_params: Vec<(SpecId, u64, u64)>, ) -> Self

Sets the blob target and max count over hardforks.

pub fn set_blob_max_and_target_count( &mut self, blob_params: Vec<(SpecId, u64, u64)>, )

Sets the blob target and max count over hardforks.

Trait Implementations

impl<SPEC: Into<SpecId> + Copy> Cfg for CfgEnv<SPEC>

fn is_block_gas_limit_disabled(&self) -> bool

Returns true if the block gas limit is disabled.

type Spec = SPEC

fn chain_id(&self) -> u64

fn spec(&self) -> Self::Spec

fn blob_max_count(&self, spec_id: SpecId) -> u64

Returns the blob target and max count for the given spec id.

fn max_code_size(&self) -> usize

fn is_eip3607_disabled(&self) -> bool

fn is_balance_check_disabled(&self) -> bool

fn is_nonce_check_disabled(&self) -> bool

fn is_base_fee_check_disabled(&self) -> bool

impl<SPEC: Clone> Clone for CfgEnv<SPEC>

fn clone(&self) -> CfgEnv<SPEC>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<SPEC: Debug> Debug for CfgEnv<SPEC>

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

Formats the value using the given formatter.

impl<SPEC: Default> Default for CfgEnv<SPEC>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, SPEC> Deserialize<'de> for CfgEnv<SPEC>

where SPEC: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<SPEC: PartialEq> PartialEq for CfgEnv<SPEC>

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

where SPEC: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<SPEC: Eq> Eq for CfgEnv<SPEC>

impl<SPEC> StructuralPartialEq for CfgEnv<SPEC>