Struct Envelope 

pub struct Envelope {
    pub car_enc: String,
    pub nonce: String,
    pub ct: String,
    pub kid: Option<u64>,
}

The ciphertext form of a payload — what the relay stores and sees. Cleartext op_id/seq/hlc/scope/surface metadata lives outside this, on the crate::oplog::OpRecord; the envelope hides only the payload body.

Fields

car_enc: String

Algorithm tag (ALG_CHACHA20POLY1305).

nonce: String

The 96-bit AEAD nonce, hex (24 chars). Random per encryption, so the same plaintext encrypts to distinct ciphertext each time.

ct: String

The ciphertext ‖ Poly1305 tag, hex.

kid: Option<u64>

Org key-id (rotation EPOCH). ONLY the multi-epoch org cipher sets it, so a remaining member can select the right per-epoch key after a rotation instead of trial-decrypting. Personal / wrap envelopes omit it.

skip_serializing_if is LOAD-BEARING: personal envelopes stay byte-identical (the field never serializes), AND wrap_org_key signs canonical_json(envelope) — so an always-omitted kid keeps every Ed25519 wrap signature valid. Do NOT drop skip_serializing_if, and do NOT add deny_unknown_fields.

Implementations

impl Envelope

pub fn is_envelope(v: &Value) -> bool

Is this JSON value a ciphertext envelope (vs. a cleartext payload)?

Trait Implementations

impl Clone for Envelope

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Envelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Envelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Envelope

impl PartialEq for Envelope

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Envelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Envelope