Struct risc0_steel::event::Event

pub struct Event<S, E> { /* private fields */ }

Available on crate feature unstable-event only.

Represents an EVM event query.

Usage

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

Examples

let contract_address = address!("dAC17F958D2ee523a2206206994597C13D831ec7");
sol! {
    interface IERC20 {
        event Transfer(address indexed from, address indexed to, uint256 value);
    }
}

// Host:
let url = "https://ethereum-rpc.publicnode.com".parse()?;
let mut env = EthEvmEnv::builder().rpc(url).build().await?;
let event = Event::preflight::<IERC20::Transfer>(&mut env).address(contract_address);
event.query().await?;

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

// Guest:
let env = evm_input.into_env();
let event = Event::new::<IERC20::Transfer>(&env).address(contract_address);
let logs = event.query();

Implementations

impl<D, H: EvmBlockHeader, C> Event<(), &mut EvmEnv<ProofDb<D>, H, HostCommit<C>>>

where D: EvmDatabase + Send + 'static, <D as RevmDatabase>::Error: StdError + Send + Sync + 'static,

pub fn preflight<S: SolEvent>( env: &mut EvmEnv<ProofDb<D>, H, HostCommit<C>>, ) -> Event<S, &mut EvmEnv<ProofDb<D>, H, HostCommit<C>>>

Available on crate feature host only.

Constructor for preflighting an event query for a specific EVM event.

Initializes the environment for event queries, fetching necessary data via the Provider, and generating a storage proof for any accessed elements using EvmEnv::into_input.

impl<S: SolEvent, D, H: EvmBlockHeader, C> Event<S, &mut EvmEnv<ProofDb<D>, H, HostCommit<C>>>

where D: EvmDatabase + Send + 'static, <D as RevmDatabase>::Error: StdError + Send + Sync + 'static,

pub async fn query(self) -> Result<Vec<Log<S>>>

Available on crate feature host only.

Executes the event query using an EvmEnv constructed with Event::preflight.

This uses [tokio::task::spawn_blocking] to run the blocking revm execution.

impl<H: EvmBlockHeader> Event<(), &EvmEnv<StateDb, H, Commitment>>

pub fn new<S: SolEvent>( env: &EvmEnv<StateDb, H, Commitment>, ) -> Event<S, &EvmEnv<StateDb, H, Commitment>>

Constructor for executing an event query for a specific Solidity event.

impl<S: SolEvent, H: EvmBlockHeader> Event<S, &EvmEnv<StateDb, H, Commitment>>

pub fn query(self) -> Vec<Log<S>>

Executes the query and returns the matching logs and panics on failure.

A convenience wrapper for Event::try_query, panicking if the call fails. Useful when success is expected.

pub fn try_query(self) -> Result<Vec<Log<S>>>

Attempts to execute the query and returns the matching logs or an error.

impl<S, E> Event<S, E>

pub fn address<A: Into<ValueOrArray<Address>>>(self, address: A) -> Self

Sets the address to query with this filter.

See [Filter::address].

pub fn topic1<TO: Into<Topic>>(self, topic: TO) -> Self

Sets the 1st indexed topic.

pub fn topic2<TO: Into<Topic>>(self, topic: TO) -> Self

Sets the 2nd indexed topic.

pub fn topic3<TO: Into<Topic>>(self, topic: TO) -> Self

Sets the 3rd indexed topic.