Struct DmEnvelope 

pub struct DmEnvelope {
    pub protocol_version: u16,
    pub request_id: [u8; 16],
    pub sender_agent_id: [u8; 32],
    pub sender_machine_id: [u8; 32],
    pub recipient_agent_id: [u8; 32],
    pub created_at_unix_ms: u64,
    pub expires_at_unix_ms: u64,
    pub body: DmBody,
    pub signature: Vec<u8>,
}

A direct-message envelope, signed by the sender’s ML-DSA-65 agent key and (for Payload variants) encrypted to the recipient’s ML-KEM-768 public key.

See docs/design/dm-over-gossip.md for the full spec.

Fields

protocol_version: u16

Wire-format protocol version. Receivers reject envelopes whose protocol_version > self.max_protocol_version.

request_id: [u8; 16]

128-bit per-message id. Random on first send; reused on retries of the same logical message to enable recipient dedupe.

sender_agent_id: [u8; 32]

Sender’s AgentId (32 bytes, SHA-256 of ML-DSA-65 pubkey).

sender_machine_id: [u8; 32]

Sender’s MachineId. Populates trust-policy evaluation.

recipient_agent_id: [u8; 32]

Recipient’s AgentId. Receivers drop envelopes addressed to a different agent_id (defence-in-depth; topic filtering normally prevents this).

created_at_unix_ms: u64

Sender-local unix-ms timestamp at envelope creation.

expires_at_unix_ms: u64

Envelope expiry. Receivers drop envelopes past this time.

body: DmBody

Kind — Payload or Ack.

signature: Vec<u8>

ML-DSA-65 signature over the domain-separated envelope bytes computed via build_signed_bytes().

Implementations

impl DmEnvelope

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

Domain-separated bytes to sign. Only depends on the fields covered by the signature — signature itself is excluded.

pub fn aead_aad(&self) -> Vec<u8>

AAD used for the inner-payload AEAD. Only meaningful for DmBody::Payload; callers may still build it ahead of time for general use.

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

Serialize envelope with postcard for over-the-wire transport.

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

Deserialize envelope from the wire. Enforces the envelope-size cap.

pub fn dedupe_key(&self) -> DedupeKey

Dedupe key for this envelope.

Trait Implementations

impl Clone for DmEnvelope

fn clone(&self) -> DmEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DmEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DmEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DmEnvelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.