Struct CommunityV2 

pub struct CommunityV2 {

    pub identity: CommunityIdentity,
    pub community_root: [u8; 32],
    pub root_epoch: Epoch,
    pub name: String,
    pub description: Option<String>,
    pub icon: Option<ImageRef>,
    pub banner: Option<ImageRef>,
    pub meta_custom: Option<Map<String, Value>>,
    pub meta_extra: Map<String, Value>,
    pub relays: Vec<String>,
    pub channels: Vec<ChannelV2>,
    pub dissolved: bool,
    pub created_at_ms: u64,
}

A v2 community in memory: its self-certifying identity, base access key, and channels. Persisted via crate::db::community’s v2 helpers into the shared community tables (with the migration-65 columns).

Fields

identity: CommunityIdentity

community_root: [u8; 32]

The base @everyone access key at root_epoch — holding it IS membership.

root_epoch: Epoch

name: String

description: Option<String>

icon: Option<ImageRef>

Folded vsk-0 icon/banner. Held so a local edit republishes the FULL metadata document — an edition replaces the entity, so an editor that doesn’t carry these forward wipes them for everyone (CORD-02 §6).

banner: Option<ImageRef>

meta_custom: Option<Map<String, Value>>

Folded vsk-0 client-extensible object + unknown top-level fields — carried through our own editions verbatim (CORD-02 §6).

meta_extra: Map<String, Value>

relays: Vec<String>

channels: Vec<ChannelV2>

dissolved: bool

created_at_ms: u64

Local wall-clock of first acquisition (ms), for display ordering.

Implementations

impl CommunityV2

pub fn from_genesis( g: &Genesis, name: &str, description: Option<String>, relays: Vec<String>, created_at_ms: u64, ) -> CommunityV2

Build the owner’s fresh community from a Genesis (the two genesis editions are the caller’s to publish). The #general channel is Public.

pub fn from_bundle( bundle: &CommunityInvite, created_at_ms: u64, ) -> Result<CommunityV2, String>

Reconstruct a member’s community from an accepted invite bundle. The bundle’s owner commitment MUST already have been verified (CommunityInvite::validate) — this re-checks it fail-closed anyway. A channel is treated as Private iff its bundle key differs from the community_root (a Public channel’s “key” is the root; a Private one carries its own).

pub fn id(&self) -> &CommunityId

The community_id this community is anchored on.

pub fn metadata(&self) -> CommunityMetadata

The full vsk-0 metadata document rebuilt from held state — the base every local edit MUST start from, so changing one field can’t wipe the rest (CORD-02 §6), foreign clients’ custom/extra fields included.

pub fn owner(&self) -> Result<PublicKey, String>

The proven owner (the identity self-certifies at construction).

pub fn channel(&self, id: &ChannelId) -> Option<&ChannelV2>

pub fn primary_channel(&self) -> Option<&ChannelV2>

The ONE channel the chat list surfaces for this community (multi-channel UI is a later cut, mirroring v1’s single-channel groups): a readable #general when present, else the oldest readable channel, else the first. A keyless Private channel is skipped — it can’t render a single message.

pub fn channel_secret(&self, ch: &ChannelV2) -> ([u8; 32], Epoch)

The encryption secret + epoch that address a channel’s Chat Plane: the community_root at root_epoch for a Public channel, the channel’s own key at its own epoch for a Private one (CORD-03 §1).

pub fn channel_read_coords(&self, ch: &ChannelV2) -> Vec<([u8; 32], Epoch)>

Every (secret, epoch) pair to query for a channel’s history — for the first cut this is the single current head; the multi-epoch archive (across rekeys) layers on once rotation lands in the service.

pub fn to_summary_json(&self) -> Value

The untyped summary the facade hands the SDK (protocol-agnostic shape + a version tell). Kept deliberately close to v1’s summary keys so a consumer treats both uniformly.

Trait Implementations

impl Clone for CommunityV2

fn clone(&self) -> CommunityV2

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CommunityV2

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.