Struct Events 

pub struct Events(/* private fields */);

Events publishes events for the currently executing contract.

use soroban_sdk::Env;

let event = env.events();
let data = map![&env, (1u32, 2u32)];
// topics can be represented with tuple up to a certain length
let topics0 = ();
let topics1 = (0u32,);
let topics2 = (0u32, 1u32);
let topics3 = (0u32, 1u32, 2u32);
let topics4 = (0u32, 1u32, 2u32, 3u32);
// topics can also be represented with a `Vec` with no length limit
let topics5 = vec![&env, 4u32, 5u32, 6u32, 7u32, 8u32];
event.publish(topics0, data.clone());
event.publish(topics1, data.clone());
event.publish(topics2, data.clone());
event.publish(topics3, data.clone());
event.publish(topics4, data.clone());
event.publish(topics5, data.clone());

Implementations

impl Events

pub fn publish_event(&self, e: &(impl Event + ?Sized))

Publish an event defined using the contractevent macro.

pub fn publish<T, D>(&self, topics: T, data: D)

where T: Topics, D: IntoVal<Env, Val>,

👎Deprecated: use the #[contractevent] macro on a contract event type

Publish an event.

Consider using contractevent instead of this function.

Event data is specified in data. Data may be any value or type, including types defined by contracts using contracttype.

Event topics must not contain:

• Vec
• Map
• Bytes/BytesN longer than 32 bytes
• contracttype

Trait Implementations

impl Clone for Events

fn clone(&self) -> Events

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Events

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

Formats the value using the given formatter.

impl Events for Events

Available on crate feature testutils only.

fn all(&self) -> Vec<(Address, Vec<Val>, Val)>

Returns all events that have been published by contracts.