dig-events-protocol 0.1.3

Canonical DIG Network blockchain→app event contract: the wallet/chain event taxonomy (WalletEvent, EventKind, Cursor, EmittedEvent, SyncStatus) plus the EventEmitter/CatchUp shape traits that the node engine emits and apps subscribe to — a pure leaf crate (serde + enumset + async-trait, no dig-* deps) that freezes the event wire format against drift.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

//! The event-kind discriminant used as the subscription filter (SPEC §5).

use enumset::EnumSetType;
use serde::{Deserialize, Serialize};

/// The kind discriminant of a [`WalletEvent`](crate::WalletEvent), used as the subscription FILTER.
///
/// A subscriber passes an `EnumSet<EventKind>`; the engine delivers only matching events (e.g. funds
/// notifications subscribe `FundsReceived | FundsSent`; chain-watch subscribes
/// `CoinStateChanged | NewTip`). An `EnumSet<EventKind>` serializes as a snake_case LIST on the wire
/// (`["funds_received","funds_sent"]`).
#[derive(Debug, Serialize, Deserialize, EnumSetType)]
#[enumset(serialize_repr = "list")]
#[serde(rename_all = "snake_case")]
pub enum EventKind {
    /// Inbound value landed.
    FundsReceived,
    /// Outbound value confirmed.
    FundsSent,
    /// A tracked coin's spent/created state changed.
    CoinStateChanged,
    /// A submitted transaction confirmed.
    Confirmation,
    /// A submitted transaction failed.
    TransactionFailed,
    /// A new chain tip was observed.
    NewTip,
    /// Sync progress advanced.
    SyncProgress,
    /// CAT metadata became available.
    CatInfo,
    /// DID metadata became available.
    DidInfo,
    /// NFT data became available.
    NftData,
    /// A new HD receive address became active.
    Derivation,
}