Struct EvmEnv

pub struct EvmEnv<D, F: EvmFactory, C> { /* private fields */ }

Represents the complete execution environment for EVM contract calls.

This struct encapsulates all necessary components to configure and run an EVM instance compatible with the specified EvmFactory. It serves as the primary context object passed around during EVM execution setup and interaction, both on the host (for preflight) and in the guest.

Implementations

impl<F: EvmFactory> EvmEnv<(), F, ()>

pub fn builder() -> EvmEnvBuilder<(), F, (), ()>

Available on crate feature host only.

Creates a builder for building an environment.

Create an Ethereum environment bast on the latest block:

let url = Url::parse("https://ethereum-rpc.publicnode.com")?;
let env = EthEvmEnv::builder().rpc(url).chain_spec(&ETH_MAINNET_CHAIN_SPEC).build().await?;

impl<D, F: EvmFactory, C> EvmEnv<ProofDb<D>, F, HostCommit<C>>

pub fn with_chain_spec(self, chain_spec: &ChainSpec<F::Spec>) -> Self

Available on crate feature host only.

Sets the chain ID and specification ID from the given chain spec.

This will panic when there is no valid specification ID for the current block.

pub fn merge(self, other: Self) -> Result<Self>

Available on crate feature host only.

Extends the environment with the contents of another compatible environment.

Errors

It returns an error if the environments are inconsistent, specifically if:

• The configurations don’t match
• The headers don’t match

Panics

It panics if the database states conflict.

Use Cases

This method is particularly useful for combining results from parallel preflights, allowing you to execute multiple independent operations and merge their environments.

Example

let call =
    IERC20::balanceOfCall { account: address!("F977814e90dA44bFA03b6295A0616a897441aceC") };

let url = "https://ethereum-rpc.publicnode.com".parse()?;
let builder = EthEvmEnv::builder().rpc(url).chain_spec(&ETH_MAINNET_CHAIN_SPEC);

let mut env1 = builder.clone().build().await?;
let block_hash = env1.header().seal();
let mut contract1 = Contract::preflight(usdt_addr, &mut env1);
// build second env on the same block
let mut env2 = builder.block_hash(block_hash).build().await?;
let mut contract2 = Contract::preflight(usdc_addr, &mut env2);

// Perform parallel operations (these would typically modify the state within env1/env2's dbs)
tokio::join!(contract1.call_builder(&call).call(), contract2.call_builder(&call).call());

let env = env1.merge(env2)?;
let evm_input = env.into_input().await?;

impl<N, P, F> EvmEnv<ProofDb<ProviderDb<N, P>>, F, HostCommit<()>>

where N: Network, P: Provider<N>, F: EvmFactory, F::Header: TryFrom<<N as Network>::HeaderResponse>, <F::Header as TryFrom<<N as Network>::HeaderResponse>>::Error: Display,

pub async fn into_input(self) -> Result<EvmInput<F>>

Available on crate feature host only.

Converts the environment into a EvmInput committing to an execution block hash.

impl<D, F: EvmFactory, C: Clone + BlockHeaderCommit<F::Header>> EvmEnv<ProofDb<D>, F, HostCommit<C>>

pub fn commitment(&self) -> Commitment

Available on crate feature host only.

Returns the Commitment used to validate the environment.

impl<P> EvmEnv<ProofDb<ProviderDb<Ethereum, P>>, EthEvmFactory, HostCommit<GeneralizedBeaconCommit<BLOCK_HASH_LEAF_INDEX>>>

where P: Provider<Ethereum>,

pub async fn into_input(self) -> Result<EthEvmInput>

Available on crate feature host only.

Converts the environment into a EvmInput committing to a Beacon Chain block root.

impl<P> EvmEnv<ProofDb<ProviderDb<Ethereum, P>>, EthEvmFactory, HostCommit<HistoryCommit>>

where P: Provider<Ethereum>,

pub async fn into_input(self) -> Result<EthEvmInput>

Available on crate feature host only.

Converts the environment into a EvmInput recursively committing to multiple Beacon Chain block roots.

impl<D, F: EvmFactory, C> EvmEnv<D, F, C>

pub fn header(&self) -> &Sealed<F::Header>

Returns the sealed header of the environment.

impl<D, F: EvmFactory> EvmEnv<D, F, Commitment>

pub fn commitment(&self) -> &Commitment

Returns the Commitment used to validate the environment.

pub fn into_commitment(self) -> Commitment

Consumes and returns the Commitment used to validate the environment.