Struct Events

pub struct Events<Hash> { /* private fields */ }

A collection of events obtained from a block, bundled with the necessary information needed to decode and iterate over them.

Implementations

impl<Hash: Copy + Encode + Decode> Events<Hash>

pub fn new(metadata: Metadata, block_hash: Hash, event_bytes: Vec<u8>) -> Self

pub fn len(&self) -> u32

The number of events.

pub fn is_empty(&self) -> bool

Are there no events in this block?

pub fn block_hash(&self) -> Hash

Return the block hash that these events are from.

pub fn event_bytes(&self) -> Arc<[u8]>

Return the encoded bytes of the Events.

pub fn iter( &self, ) -> impl Iterator<Item = Result<EventDetails<Hash>, Error>> + Send + Sync + 'static

Iterate over all of the events, using metadata to dynamically decode them as we go, and returning the raw bytes and other associated details. If an error occurs, all subsequent iterations return None.

pub fn find<Ev: StaticEvent>( &self, ) -> impl Iterator<Item = Result<Ev, Error>> + '_

Iterate through the events using metadata to dynamically decode and skip them, and return only those which should decode to the provided Ev type. If an error occurs, all subsequent iterations return None.

pub fn find_first<Ev: StaticEvent>(&self) -> Result<Option<Ev>, Error>

Iterate through the events using metadata to dynamically decode and skip them, and return the first event found which decodes to the provided Ev type.

pub fn find_last<Ev: StaticEvent>(&self) -> Result<Option<Ev>, Error>

Iterate through the events using metadata to dynamically decode and skip them, and return the last event found which decodes to the provided Ev type.

pub fn has<Ev: StaticEvent>(&self) -> Result<bool, Error>

Find an event that decodes to the type provided. Returns true if it was found.

Trait Implementations

impl<Hash: Clone> Clone for Events<Hash>

fn clone(&self) -> Events<Hash>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<Hash: Debug> Debug for Events<Hash>

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

Formats the value using the given formatter.