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 rekey;
29pub mod roles;
30pub mod service;
31pub mod stream;
32pub mod streamauth;
33
34/// Inner rumor kinds (CORD-02 Appendix B). The *outer* event is always a wrap
35/// ([`stream::KIND_WRAP`] / [`stream::KIND_WRAP_EPHEMERAL`]); these ride inside.
36pub mod kind {
37    /// Chat message (NIP-C7 shape: content = text; a `q` tag = an INLINE quote).
38    pub const MESSAGE: u16 = 9;
39    /// Threaded reply (NIP-22 comment, CORD-03 §3): uppercase `K`/`E`/`P` pin the
40    /// thread root, lowercase `k`/`e`/`p` the immediate parent — all rumor ids.
41    /// Deliberately distinct from a kind-9 inline quote.
42    pub const COMMENT: u16 = 1111;
43    /// Reaction (NIP-25 shape: `e`/`p`/`k` tags name the target — `k` is the
44    /// target's kind, `9` or `1111`).
45    pub const REACTION: u16 = 7;
46    /// Delete (NIP-09 shape: `e` names the author's own rumor id).
47    pub const DELETE: u16 = 5;
48    /// Message edit (fields unpinned upstream; Vector: `e` = own message rumor id,
49    /// content = replacement text).
50    pub const EDIT: u16 = 3302;
51    /// Rekey blobs (CORD-06).
52    pub const REKEY: u16 = 3303;
53    /// Guestbook join/leave (content = the verb).
54    pub const JOIN_LEAVE: u16 = 3306;
55    /// Control edition, sub-kinded by `vsk` (shared grammar with v1 — `community::edition`).
56    pub const CONTROL: u16 = 3308;
57    /// Guestbook kick (admin-signed, `p` target, `vac` citation).
58    pub const KICK: u16 = 3309;
59    /// WebXDC peer signal (payload opaque to the protocol).
60    pub const WEBXDC: u16 = 3310;
61    /// Guestbook snapshot (refounder-signed, chunked 400/event).
62    pub const SNAPSHOT: u16 = 3312;
63    /// Direct invite rumor — rides a STANDARD NIP-59 giftwrap to a person,
64    /// never a stream wrap (CORD-05 §6).
65    pub const DIRECT_INVITE: u16 = 3313;
66    /// Typing indicator (ephemeral tier — 21059 wrap, never stored).
67    pub const TYPING: u16 = 23311;
68    /// Voice presence heartbeat (ephemeral tier; CORD-07 — deferred in Vector,
69    /// constant reserved so nothing else claims it).
70    pub const VOICE_PRESENCE: u16 = 23313;
71    /// Public invite bundle — bare addressable event signed by the per-link
72    /// keypair at an empty `d` (CORD-05 §2). Outside the wrap.
73    pub const INVITE_BUNDLE: u16 = 33301;
74    /// A member's self-encrypted Community List (replaceable). Outside the wrap.
75    pub const COMMUNITY_LIST: u16 = 13302;
76    /// A creator's self-encrypted Invite List (replaceable). Outside the wrap.
77    pub const INVITE_LIST: u16 = 13303;
78}
79
80/// Control-plane `vsk` sub-kinds (CORD-02 Appendix B). Identical numbering to
81/// v1 (`community::roster`) — that is deliberate, the registry is shared. 7 is
82/// retired upstream (the v1 owner attestation, obsoleted by the self-certifying
83/// community id); 11 is claimed by Vector for the v1-side migration pointer and
84/// never appears on the v2 wire.
85pub mod vsk {
86    pub const COMMUNITY_METADATA: &str = "0";
87    pub const ROLE: &str = "1";
88    pub const CHANNEL_METADATA: &str = "2";
89    pub const GRANT: &str = "3";
90    pub const BANLIST: &str = "4";
91    // "5" reserved (role ordering), "6"/"9" claimed by the 33301 invite marker,
92    // "7" retired, "8" = invite-link registry, "10" = dissolved tombstone.
93    pub const INVITE_LINKS: &str = "8";
94    pub const INVITE_LIVE: &str = "6";
95    pub const INVITE_REVOKED: &str = "9";
96    pub const DISSOLVED: &str = "10";
97}
vector_core/community/v2/mod.rs

vector_core/community/v2/
mod.rs
