Struct CatchupSnapshot 

pub struct CatchupSnapshot {
    pub v: u8,
    pub conversation_metas: Vec<CatchupConversationEntry>,
    pub last_app_events_per_conv: Vec<CatchupAppEventEntry>,
}

[CR-13] Catchup snapshot delivered to a newly-linked device.

Populates the catchup_snapshot field of LinkingTicket so the new device boots with a populated conversation list + last-known plaintext per conversation, instead of an empty UI until peers re-Welcome.

group_state_bytes is reserved for the [CR-7] DeviceGroup-snapshot machinery; until CR-7 lands it’s always empty (Vec::new()) on every meta. The encoding is forward- compatible: a snapshot produced today will decode cleanly on a future SDK build that understands CR-7, and a future-produced snapshot decodes on today’s SDK (we just ignore the populated group_state_bytes).

last_app_events_per_conv is host-supplied — the SDK doesn’t store decrypted plaintext on its own, so the host passes through whatever it wants the new device to see on launch (typically: the last N AppEvent bytes per conversation).

Fields

v: u8

Format version. 1 today; bumped on incompatible CBOR-shape changes.

conversation_metas: Vec<CatchupConversationEntry>

Conversation list + per-conversation MLS state. group_state_bytes is empty pre-CR-7; the field is reserved so the wire format doesn’t churn when CR-7 ships.

last_app_events_per_conv: Vec<CatchupAppEventEntry>

Last-known decrypted AppEvent bytes per conversation. Host-supplied; opaque to the SDK. Each entry is keyed by ConversationId.

Implementations

impl CatchupSnapshot

pub fn empty() -> Self

Build an empty snapshot (no metas, no events). Equivalent to “no catchup data.”

pub fn encode(&self) -> Result<Vec<u8>>

CBOR-encode for inclusion in a LinkingTicket::catchup_snapshot.

Returns Err(Error::Invalid) if the encoded size exceeds CATCHUP_SNAPSHOT_HARD_CAP (256 KB). Sizes between the soft cap (64 KB) and the hard cap log a warning but still succeed — they’re suboptimal but not refused.

pub fn decode(bytes: &[u8]) -> Result<Self>

Decode a CBOR-encoded snapshot. Refuses sizes over CATCHUP_SNAPSHOT_HARD_CAP to bound attacker-controlled allocation; refuses unknown v to avoid silently dropping fields a future version added.

Trait Implementations

impl Clone for CatchupSnapshot

fn clone(&self) -> CatchupSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CatchupSnapshot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CatchupSnapshot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CatchupSnapshot

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

where __S: Serializer,

Serialize this value into the given Serde serializer.