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<T, D>(&self, topics: T, data: D)

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

Publish an event.

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 copy 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.