Enum ClientMsg 

pub enum ClientMsg {
    Hello {
        fingerprint: String,
        pubkey_b64: String,
        signature_b64: String,
        rooms: Vec<String>,
        acks: bool,
    },
    Subscribe {
        room: String,
    },
    Unsubscribe {
        room: String,
    },
    Publish {
        room: String,
        id: String,
        payload_b64: String,
    },
    SendDirect {
        to: String,
        room: String,
        id: String,
        payload_b64: String,
    },
    CreateConnectToken,
    RedeemConnectToken {
        token: String,
    },
    Fetch,
    Ack {
        mailbox_id: i64,
    },
    Ping,
}

Client → relay. The client serializes these; the relay deserializes them, tolerating absent optional fields from older clients via serde(default).

Variants

Hello

Announce identity and (re)assert room memberships, then drain the mailbox. Must be the first message. huddle 1.1.4: it authenticates — pubkey_b64 is the client’s Ed25519 pubkey and signature_b64 is a signature over RELAY_AUTH_DOMAIN || nonce for the nonce the relay sent in the opening Challenge. The relay verifies both before registering.

Fields

fingerprint: String

pubkey_b64: String

signature_b64: String

rooms: Vec<String>

acks: bool

huddle 2.0: capability bit — the client implements at-least-once mailbox ACKs (it answers each queued Message with ClientMsg::Ack carrying the row’s mailbox_id). When true the relay tags each mailbox delivery with its row id and keeps the row until the matching Ack arrives; when false (pre-2.0 clients — the serde default) the relay falls back to classical delete-on-deliver.

Subscribe

Fields

room: String

Unsubscribe

Fields

room: String

Publish

Send an opaque payload to every other member of room.

Fields

room: String

id: String

payload_b64: String

SendDirect

huddle 1.2: deliver an opaque payload to a SPECIFIC recipient fingerprint, independent of room membership — how 1:1 DMs and friend requests route reliably. room is an opaque tag the recipient’s client uses to file the message; the relay never interprets it.

Fields

to: String

room: String

id: String

payload_b64: String

CreateConnectToken

huddle 1.2.1: mint a short-lived connect code bound to this authenticated identity. The relay replies with ConnectToken.

RedeemConnectToken

huddle 1.2.1: resolve a connect code to its owner’s fingerprint+pubkey. The relay replies with ConnectTokenResolved (fingerprint = None when unknown/expired).

Fields

token: String

Fetch

Re-drain the mailbox on demand.

Ack

huddle 2.0: acknowledge durable receipt of a relay-delivered mailbox message. The relay deletes the row only after this ACK (at-least-once delivery). Scoped to the authenticated fingerprint.

Fields

mailbox_id: i64

Ping

Trait Implementations

impl Clone for ClientMsg

fn clone(&self) -> ClientMsg

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientMsg

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClientMsg

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ClientMsg

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.