Enum RoomMessageBody 

pub enum RoomMessageBody {
    Public {
        content_type: u32,
        content_version: u32,
        data: Vec<u8>,
    },
    Private {
        content_type: u32,
        content_version: u32,
        ciphertext: Vec<u8>,
        nonce: [u8; 12],
        secret_version: SecretVersion,
    },
}

Message body that can be either public or private (encrypted).

Content is opaque to the contract - interpretation happens client-side. This design enables adding new content types without contract redeployment.

Content Types

• content_type = 1: Text message (TextContentV1)
• content_type = 2: Action on another message (ActionContentV1)
• Future types can be added without contract changes

Extensibility

• New content types: Just use a new content_type number
• New action types: Just use a new action_type number within ActionContentV1
• New fields: Add to content structs (old clients ignore unknown fields)
• Breaking changes: Bump content_version

Variants

Public

Public (unencrypted) message

Fields

content_type: u32

Content type identifier (see content module for constants)

content_version: u32

Version of the content format

data: Vec<u8>

CBOR-encoded content bytes

Private

Private (encrypted) message

Fields

content_type: u32

Content type identifier (see content module for constants)

content_version: u32

Version of the content format

ciphertext: Vec<u8>

Encrypted CBOR-encoded content

nonce: [u8; 12]

Nonce used for encryption

secret_version: SecretVersion

Version of the room secret used for encryption

Implementations

impl RoomMessageBody

pub fn public(text: String) -> Self

Create a new public text message

pub fn public_raw( content_type: u32, content_version: u32, data: Vec<u8>, ) -> Self

Create a new public message with raw content

pub fn private( content_type: u32, content_version: u32, ciphertext: Vec<u8>, nonce: [u8; 12], secret_version: SecretVersion, ) -> Self

Create a new private message

pub fn private_text( ciphertext: Vec<u8>, nonce: [u8; 12], secret_version: SecretVersion, ) -> Self

Create a private text message (convenience method)

pub fn edit(target: MessageId, new_text: String) -> Self

Create an edit action (public)

pub fn delete(target: MessageId) -> Self

Create a delete action (public)

pub fn reaction(target: MessageId, emoji: String) -> Self

Create a reaction action (public)

pub fn remove_reaction(target: MessageId, emoji: String) -> Self

Create a remove reaction action (public)

pub fn private_action( ciphertext: Vec<u8>, nonce: [u8; 12], secret_version: SecretVersion, ) -> Self

Create a private action message (encrypted)

Use this for any action (edit, delete, reaction, remove_reaction) in a private room. The caller should:

1. Create the ActionContentV1 (e.g., ActionContentV1::edit(target, new_text))
2. Encode it: action.encode()
3. Encrypt the bytes with the room secret
4. Pass the ciphertext here

pub fn is_public(&self) -> bool

Check if this is a public message

pub fn is_private(&self) -> bool

Check if this is a private message

pub fn content_type(&self) -> u32

Get the content type

pub fn content_version(&self) -> u32

Get the content version

pub fn is_action(&self) -> bool

Check if this is an action message (content_type = ACTION)

pub fn decode_content(&self) -> Option<DecodedContent>

Decode the content (for public messages only) Returns None for private messages - decrypt first

pub fn target_id(&self) -> Option<MessageId>

Get the target message ID if this is an action

pub fn content_len(&self) -> usize

Get the content length for validation (contract uses this for size limits)

pub fn secret_version(&self) -> Option<SecretVersion>

Get the secret version (if private)

pub fn to_string_lossy(&self) -> String

Get a string representation for display purposes

pub fn as_public_string(&self) -> Option<String>

Try to get the public plaintext, returns None if private or not a text message

Trait Implementations

impl Clone for RoomMessageBody

fn clone(&self) -> RoomMessageBody

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RoomMessageBody

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RoomMessageBody

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RoomMessageBody

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

Formats the value using the given formatter.

impl PartialEq for RoomMessageBody

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RoomMessageBody

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 RoomMessageBody