vector_core/community/v2/
mod.rs

1//! Concord v2 (the upstream CORD specs — `github.com/concord-protocol/concord`).
2//!
3//! Vector's second-generation community protocol, carried ALONGSIDE v1 (the
4//! sibling `community::` modules) for a migration window. v2 keeps v1's control
5//! plane engine verbatim — the edition hash, fold, roster, and authority algebra
6//! are shared by import, not copied — and replaces the envelope (CORD-01 Private
7//! Streams: group-key-signed kind-1059 wraps addressed by `authors`), the owner
8//! anchor (a self-certifying `community_id`), the invite system (CORD-05), and
9//! adds the Guestbook plane (CORD-02 §5).
10//!
11//! Nothing in here touches v1 state: a `Community` is one protocol or the other
12//! (`protocol` discriminator), and the two stacks share only pure logic.
13//!
14//! Frozen wire constants live in two places: the derivation labels in
15//! [`derive`], and the kind registry below (CORD-02 Appendix B). A retired
16//! number is burned forever, never reused.
17
18pub mod chat;
19pub mod community;
20pub mod control;
21pub mod derive;
22pub mod dissolution;
23pub mod guestbook;
24pub mod inbound;
25pub mod invite;
26pub mod list;
27pub mod realtime;
28pub mod volley;
29pub mod rekey;
30pub mod roles;
31pub mod service;
32pub mod stream;
33pub mod streamauth;
34
35/// Inner rumor kinds (CORD-02 Appendix B). The *outer* event is always a wrap
36/// ([`stream::KIND_WRAP`] / [`stream::KIND_WRAP_EPHEMERAL`]); these ride inside.
37pub mod kind {
38    /// Chat message (NIP-C7 shape: content = text; a `q` tag = an INLINE quote).
39    pub const MESSAGE: u16 = 9;
40    /// Threaded reply (NIP-22 comment, CORD-03 §3): uppercase `K`/`E`/`P` pin the
41    /// thread root, lowercase `k`/`e`/`p` the immediate parent — all rumor ids.
42    /// Deliberately distinct from a kind-9 inline quote.
43    pub const COMMENT: u16 = 1111;
44    /// Reaction (NIP-25 shape: `e`/`p`/`k` tags name the target — `k` is the
45    /// target's kind, `9` or `1111`).
46    pub const REACTION: u16 = 7;
47    /// Delete (NIP-09 shape: `e` names the author's own rumor id).
48    pub const DELETE: u16 = 5;
49    /// Message edit (fields unpinned upstream; Vector: `e` = own message rumor id,
50    /// content = replacement text).
51    pub const EDIT: u16 = 3302;
52    /// Rekey blobs (CORD-06).
53    pub const REKEY: u16 = 3303;
54    /// Guestbook join/leave (content = the verb).
55    pub const JOIN_LEAVE: u16 = 3306;
56    /// Control edition, sub-kinded by `vsk` (shared grammar with v1 — `community::edition`).
57    pub const CONTROL: u16 = 3308;
58    /// Guestbook kick (admin-signed, `p` target, `vac` citation).
59    pub const KICK: u16 = 3309;
60    /// WebXDC peer signal (payload opaque to the protocol).
61    pub const WEBXDC: u16 = 3310;
62    /// Guestbook snapshot (refounder-signed, chunked 400/event).
63    pub const SNAPSHOT: u16 = 3312;
64    /// Direct invite rumor — rides a STANDARD NIP-59 giftwrap to a person,
65    /// never a stream wrap (CORD-05 §6).
66    pub const DIRECT_INVITE: u16 = 3313;
67    /// Typing indicator (ephemeral tier — 21059 wrap, never stored).
68    pub const TYPING: u16 = 23311;
69    /// Voice presence heartbeat (ephemeral tier; CORD-07 — deferred in Vector,
70    /// constant reserved so nothing else claims it).
71    pub const VOICE_PRESENCE: u16 = 23313;
72    /// Public invite bundle — bare addressable event signed by the per-link
73    /// keypair at an empty `d` (CORD-05 §2). Outside the wrap.
74    pub const INVITE_BUNDLE: u16 = 33301;
75    /// A member's self-encrypted Community List (replaceable). Outside the wrap.
76    pub const COMMUNITY_LIST: u16 = 13302;
77    /// A creator's self-encrypted Invite List (replaceable). Outside the wrap.
78    pub const INVITE_LIST: u16 = 13303;
79}
80
81/// Control-plane `vsk` sub-kinds (CORD-02 Appendix B). Identical numbering to
82/// v1 (`community::roster`) — that is deliberate, the registry is shared. 7 is
83/// retired upstream (the v1 owner attestation, obsoleted by the self-certifying
84/// community id); 11 is claimed by Vector for the v1-side migration pointer and
85/// never appears on the v2 wire.
86pub mod vsk {
87    pub const COMMUNITY_METADATA: &str = "0";
88    pub const ROLE: &str = "1";
89    pub const CHANNEL_METADATA: &str = "2";
90    pub const GRANT: &str = "3";
91    pub const BANLIST: &str = "4";
92    // "5" reserved (role ordering), "6"/"9" claimed by the 33301 invite marker,
93    // "7" retired, "8" = invite-link registry, "10" = dissolved tombstone.
94    pub const INVITE_LINKS: &str = "8";
95    pub const INVITE_LIVE: &str = "6";
96    pub const INVITE_REVOKED: &str = "9";
97    pub const DISSOLVED: &str = "10";
98}
vector_core/community/v2/mod.rs

vector_core/community/v2/
mod.rs
