Struct CfgEnv

#[non_exhaustive]
pub struct CfgEnv {
    pub chain_id: u64,
    pub kzg_settings: EnvKzgSettings,
    pub perf_analyse_created_bytecodes: AnalysisKind,
    pub limit_contract_code_size: Option<usize>,
    pub memory_limit: u64,
    pub disable_balance_check: bool,
    pub disable_block_gas_limit: bool,
    pub disable_eip3607: bool,
    pub disable_gas_refund: bool,
    pub disable_base_fee: bool,
    pub disable_beneficiary_reward: 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, it will be compared to the transaction’s Chain ID. Chain ID is introduced EIP-155

kzg_settings: EnvKzgSettings

KZG Settings for point evaluation precompile. By default, this is loaded from the ethereum mainnet trusted setup.

perf_analyse_created_bytecodes: AnalysisKind

Bytecode that is created with CREATE/CREATE2 is by default analysed and jumptable is created. This is very beneficial for testing and speeds up execution of that bytecode if called multiple times.

Default: Analyse

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).

memory_limit: u64

A hard memory limit in bytes beyond which crate::result::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.

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_gas_refund: bool

Disables all gas refunds. This is useful when using chains that have gas refunds disabled e.g. Avalanche. Reasoning behind removing gas refunds can be found in EIP-3298. 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.

disable_beneficiary_reward: bool

Disables the payout of the reward to the beneficiary. By default, it is set to false.

Implementations

impl CfgEnv

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

pub fn is_eip3607_disabled(&self) -> bool

pub fn is_balance_check_disabled(&self) -> bool

pub fn is_gas_refund_disabled(&self) -> bool

pub fn is_base_fee_check_disabled(&self) -> bool

pub fn is_block_gas_limit_disabled(&self) -> bool

pub fn is_beneficiary_reward_disabled(&self) -> bool

Trait Implementations

impl Clone for CfgEnv

fn clone(&self) -> CfgEnv

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CfgEnv

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

Formats the value using the given formatter.

impl Default for CfgEnv

fn default() -> Self

Returns the “default value” for a type.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CfgEnv

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for CfgEnv

impl StructuralPartialEq for CfgEnv