Struct MessageEnvelope 

pub struct MessageEnvelope {
    pub v: u8,
    pub conversation_id: ConversationId,
    pub epoch: u64,
    pub kind: MessageKind,
    pub sender_device: DeviceId,
    pub seq: u64,
    pub hlc: Hlc,
    pub payload: Vec<u8>,
    pub content_hash: [u8; 32],
}

On-the-wire envelope. CBOR-encoded.

Fields

v: u8

conversation_id: ConversationId

epoch: u64

kind: MessageKind

sender_device: DeviceId

seq: u64

hlc: Hlc

payload: Vec<u8>

content_hash: [u8; 32]

Implementations

impl MessageEnvelope

pub fn new( conversation_id: ConversationId, epoch: u64, kind: MessageKind, sender_device: DeviceId, seq: u64, hlc: Hlc, payload: Vec<u8>, ) -> Self

Build an envelope for a handshake message (Commit / Welcome / Proposal / KeyPackage). The content_hash is computed over SHA-256(kind || payload) — unchanged across the v=1 → v=2 transition because handshake payloads have no “plaintext vs ciphertext” distinction.

For MessageKind::Application use new_application instead; passing an application kind here is a bug and tagged by debug_assert.

pub fn new_application( conversation_id: ConversationId, epoch: u64, sender_device: DeviceId, seq: u64, hlc: Hlc, payload: Vec<u8>, plaintext: &[u8], ) -> Self

Build an envelope for an application message ([CR-6]).

content_hash = SHA-256(plaintext) — keyed to the application bytes, not the MLS ciphertext. This is what makes rebase-on-409 clean: a message that gets resent against a new epoch keeps the same content_hash so app-layer dedup tables remain consistent. It also gives every binding identical hashes for the same AppEvent because CBOR encoding is canonical.

payload is the MLS ciphertext (what goes on the wire); plaintext is the application-defined bytes that were encrypted. The constructor uses plaintext only for hashing and payload for the envelope body.

Trait Implementations

impl Clone for MessageEnvelope

fn clone(&self) -> MessageEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessageEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MessageEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MessageEnvelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.