spy_events

fn spy_events() -> EventSpy

Creates EventSpy instance which spies on events emitted after its creation.

pub struct EventSpy {
    ...
}

An event spy structure.

pub struct Events {
    pub events: Array<(ContractAddress, Event)>,
}

A wrapper structure on an array of events to handle event filtering.

pub struct Event {
    pub keys: Array<felt252>,
    pub data: Array<felt252>,
}

Raw event format (as seen via the RPC-API), can be used for asserting the emitted events.

Implemented traits

EventSpyTrait

pub trait EventSpyTrait {
    fn get_events(ref self: EventSpy) -> Events;
}

Gets all events since the creation of the given EventSpy.

EventSpyAssertionsTrait

pub trait EventSpyAssertionsTrait<T, +starknet::Event<T>, +Drop<T>> {
    fn assert_emitted(ref self: EventSpy, events: @Array<(ContractAddress, T)>);
    fn assert_not_emitted(ref self: EventSpy, events: @Array<(ContractAddress, T)>);
}

Allows to assert the expected events emission (or lack thereof), in the scope of the EventSpy structure.

EventsFilterTrait

pub trait EventsFilterTrait {
    fn emitted_by(self: @Events, contract_address: ContractAddress) -> Events;
}

Filters events emitted by a given ContractAddress.