Struct ethers_contract::builders::Event

pub struct Event<'a, M, D> {
    pub filter: Filter,
    // some fields omitted
}

Helper for managing the event filter before querying or streaming its logs

Fields

filter: Filter

The event filter’s state

Implementations

impl<M, D: EthLogDecode> Event<'_, M, D>

pub fn from_block<T: Into<BlockNumber>>(self, block: T) -> Self

Sets the filter’s from block

pub fn to_block<T: Into<BlockNumber>>(self, block: T) -> Self

Sets the filter’s to block

pub fn at_block_hash<T: Into<H256>>(self, hash: T) -> Self

Sets the filter’s blockHash. Setting this will override previously set from_block and to_block fields.

pub fn topic0<T: Into<ValueOrArray<H256>>>(self, topic: T) -> Self

Sets the filter’s 0th topic (typically the event name for non-anonymous events)

pub fn topic1<T: Into<ValueOrArray<H256>>>(self, topic: T) -> Self

Sets the filter’s 1st topic

pub fn topic2<T: Into<ValueOrArray<H256>>>(self, topic: T) -> Self

Sets the filter’s 2nd topic

pub fn topic3<T: Into<ValueOrArray<H256>>>(self, topic: T) -> Self

Sets the filter’s 3rd topic

impl<'a, M, D> Event<'a, M, D> where
    M: Middleware,
    D: EthLogDecode, 

pub async fn stream(
    &'a self
) -> Result<EventStream<'a, FilterWatcher<'a, M::Provider, Log>, D, ContractError<M>>, ContractError<M>>

Returns a stream for the event

impl<'a, M, D> Event<'a, M, D> where
    M: Middleware,
    <M as Middleware>::Provider: PubsubClient,
    D: EthLogDecode, 

pub async fn subscribe(
    &'a self
) -> Result<EventStream<'a, SubscriptionStream<'a, M::Provider, Log>, D, ContractError<M>>, ContractError<M>>

Returns a subscription for the event

impl<M, D> Event<'_, M, D> where
    M: Middleware,
    D: EthLogDecode, 

pub async fn query(&self) -> Result<Vec<D>, ContractError<M>>

Queries the blockchain for the selected filter and returns a vector of matching event logs

pub async fn query_with_meta(
    &self
) -> Result<Vec<(D, LogMeta)>, ContractError<M>>

Queries the blockchain for the selected filter and returns a vector of logs along with their metadata

Trait Implementations

impl<'a, M: Debug, D: Debug> Debug for Event<'a, M, D>

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

Formats the value using the given formatter.