Struct risc0_steel::account::Account

pub struct Account<E> { /* private fields */ }

Represents an EVM account query.

Usage

• Preflight calls on the Host: To prepare the account query on the host environment and build the necessary proof, use Account::preflight.
• Calls in the Guest: To initialize the account query in the guest, use Account::new.

Examples

let account_address = address!("F977814e90dA44bFA03b6295A0616a897441aceC");

// Host:
let url = "https://ethereum-rpc.publicnode.com".parse()?;
let mut env = EthEvmEnv::builder().rpc(url).build().await?;
let account = Account::preflight(account_address, &mut env);
let info = account.bytecode(true).info().await?;

let evm_input = env.into_input().await?;

// Guest:
let env = evm_input.into_env();
let account = Account::new(account_address, &env);
let info = account.bytecode(true).info();

Implementations

impl<'a, N, P, H, C> Account<&'a mut EvmEnv<ProofDb<ProviderDb<N, P>>, H, HostCommit<C>>>

where N: Network, P: Provider<N>, ProviderDb<N, P>: Send + 'static, H: EvmBlockHeader,

pub fn preflight( address: Address, env: &'a mut EvmEnv<ProofDb<ProviderDb<N, P>>, H, HostCommit<C>>, ) -> Self

Available on crate feature host only.

Constructor for preflighting queries to an Ethereum account on the host.

Initializes the environment for querying account information, fetching necessary data via the [Provider], and generating a storage proof for any accessed elements using EvmEnv::into_input.

pub async fn info(self) -> Result<AccountInfo>

Available on crate feature host only.

Gets the AccountInfo for the corresponding account using an EvmEnv constructed with Account::preflight.

impl<E> Account<E>

pub fn bytecode(self, code: bool) -> Self

Sets whether to fetch the bytecode for this account.

If set to true, the bytecode will be fetched when calling Account::info.

impl<'a, H: EvmBlockHeader> Account<&'a EvmEnv<StateDb, H, Commitment>>

pub fn new(address: Address, env: &'a EvmEnv<StateDb, H, Commitment>) -> Self

Constructor for querying an Ethereum account in the guest.

pub fn try_info(self) -> Result<AccountInfo>

Attempts to get the AccountInfo for the corresponding account and returns an error if the query fails.

In general, it’s recommended to use Account::info unless explicit error handling is required.

pub fn info(self) -> AccountInfo

Gets the AccountInfo for the corresponding account and panics on failure.

A convenience wrapper for Account::try_info, panicking if the query fails. Useful when success is expected.