sui_rpc/light_client/events/mod.rs
1//! Authenticated event stream verification.
2//!
3//! [`AuthenticatedEventsClient`] drives the v2alpha
4//! `LedgerService.ListEvents` RPC filtered by `EventStreamHeadFilter`,
5//! replays each received event into a local Merkle Mountain Range, and
6//! periodically reconciles that MMR against the on-chain
7//! [`EventStreamHead`] fetched via an OCS inclusion proof. Events are
8//! only yielded to the consumer after the reconciliation that covers
9//! them succeeds, so every emitted event is cryptographically
10//! authenticated end-to-end.
11//!
12//! [`AuthenticatedEvent`] is the in-memory envelope used both as the
13//! decoded form of an `EventItem` and as the unit of work flowing
14//! through the verifier.
15//!
16//! [`EventStreamHead`]: sui_sdk_types::framework::EventStreamHead
17
18mod client;
19mod config;
20mod envelope;
21mod state;
22
23pub use client::AuthenticatedEventsClient;
24pub use config::AuthenticatedEventsConfig;
25pub use envelope::AuthenticatedEvent;