Struct risc0_steel::EvmEnv

pub struct EvmEnv<D, H, C> { /* private fields */ }

The environment to execute the contract calls in.

Implementations

impl<H> EvmEnv<(), H, ()>

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

Available on crate feature host only.

Creates a builder for building an environment.

Create an Ethereum environment bast on the latest block:

let env = EthEvmEnv::builder().rpc(url).build().await?;

impl<D, H: EvmBlockHeader, C> EvmEnv<ProofDb<D>, H, HostCommit<C>>

pub fn with_chain_spec(self, chain_spec: &ChainSpec) -> 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 extend(&mut self, other: Self) -> Result<()>

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

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

tokio::join!(contract1.call_builder(&call).call(), contract2.call_builder(&call).call());

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

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

where N: Network, P: Provider<N>, H: EvmBlockHeader + TryFrom<<N as Network>::HeaderResponse>, <H as TryFrom<<N as Network>::HeaderResponse>>::Error: Display,

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

Available on crate feature host only.

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

impl<D, H: EvmBlockHeader, C: Clone + BlockHeaderCommit<H>> EvmEnv<ProofDb<D>, H, 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>>, RlpHeader<Header>, HostCommit<GeneralizedBeaconCommit<BLOCK_HASH_LEAF_INDEX>>>

where P: Provider<Ethereum>,

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

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>>, RlpHeader<Header>, HostCommit<HistoryCommit>>

where P: Provider<Ethereum>,

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

Available on crate features host and unstable-history only.

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

Availability

This API is marked as unstable and is only available when the unstable-history crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

impl<P> EvmEnv<ProofDb<ProviderDb<Ethereum, P>>, RlpHeader<Header>, HostCommit<()>>

where P: Provider<Ethereum>,

pub async fn into_beacon_input( self, url: Url, ) -> Result<EvmInput<EthBlockHeader>>

👎Deprecated since 0.14.0: use EvmEnv::builder().beacon_api() instead

Available on crate feature host only.

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

impl<D, H: EvmBlockHeader, C> EvmEnv<D, H, C>

pub fn header(&self) -> &Sealed<H>

Returns the sealed header of the environment.

impl<D, H: EvmBlockHeader> EvmEnv<D, H, Commitment>

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

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