Struct SealedSenderV2SentMessage

pub struct SealedSenderV2SentMessage<'a> {
    pub version: u8,
    pub recipients: IndexMap<ServiceId, SealedSenderV2SentMessageRecipient<'a>>,
    /* private fields */
}

A parsed representation of a Sealed Sender v2 SentMessage.

This only parses enough to fan out the message as a series of ReceivedMessages.

Fields

version: u8

The version byte at the head of the message.

recipients: IndexMap<ServiceId, SealedSenderV2SentMessageRecipient<'a>>

The parsed list of recipients, grouped by ServiceId.

The map is ordered by when a recipient first appears in the full message, even if they appear again later with more devices. This makes iteration over the full set of recipients deterministic.

Implementations

impl<'a> SealedSenderV2SentMessage<'a>

pub fn parse(data: &'a [u8]) -> Result<Self>

Parses the message, or produces an error if the message is invalid.

pub fn received_message_parts_for_recipient( &self, recipient: &SealedSenderV2SentMessageRecipient<'a>, ) -> impl AsRef<[&[u8]]>

Returns a slice of slices that, when concatenated, form the ReceivedMessage appropriate for recipient.

If recipient is not one of the recipients in self, the resulting message will not be decryptable.

pub fn range_for_recipient_key_material( &self, recipient: &SealedSenderV2SentMessageRecipient<'a>, ) -> Range<usize>

Returns the range within the full message of recipient’s user-specific key material.

This can be concatenated as [version, recipient_key_material, shared_bytes] to produce a valid SSv2 ReceivedMessage, the payload delivered to recipients.

Panics if recipient is not one of the recipients in self.

pub fn offset_of_shared_bytes(&self) -> usize

Returns the offset of the shared bytes within the full message.

This can be concatenated as [version, recipient_key_material, shared_bytes] to produce a valid SSv2 ReceivedMessage, the payload delivered to recipients.