Struct MessageV0Header 

pub struct MessageV0Header {
    pub sender: VerifyingKey,
    pub when: u64,
    pub kind: Kind,
    pub tags: Vec<Tag>,
}

Header information for MessageV0 containing metadata and routing information.

MessageV0Header Structure

MessageV0Header contains all the metadata fields from a MessageV0 message except for the content payload. This allows RPC transport layers to access sender information, timing, message types, and routing tags without having to deserialize the potentially encrypted content.

Field Description

• sender: Ed25519 public key of the message author
• when: Unix timestamp in seconds (for ordering and expiration)
• kind: Message type determining storage and forwarding behavior
• tags: Routing and reference tags (channels, users, events)

Usage in RPC Transport

This header allows RPC systems to examine message metadata before deciding how to handle the content, enabling efficient routing and access control.

Fields

sender: VerifyingKey

ML-DSA public key of the message sender (serialized as bytes).

This key is used to verify the digital signature in MessageFull. The sender must possess the corresponding private key to create valid signatures. Stored as encoded bytes for serialization compatibility.

when: u64

Unix timestamp in seconds when the message was created.

Used for:

• Message ordering in conversations
• Expiration of ephemeral messages
• Preventing replay attacks (with reasonable clock skew tolerance)

kind: Kind

Message type determining storage and forwarding behavior.

See Kind for details on different message types:

• Regular: Stored permanently
• Ephemeral: Temporary storage with optional TTL
• Store: Updates a specific key-value store
• ClearStore: Clears a key-value store

tags: Vec<Tag>

Tags for routing, references, and metadata.

Common tag types include:

• Protected: Message should only be forwarded to authenticated recipients
• Event: References another message or event by ID
• User: References a user identity
• Channel: Routes to a specific channel or group

Default value is an empty vector when deserializing legacy messages.

Trait Implementations

impl Clone for MessageV0Header

fn clone(&self) -> MessageV0Header

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessageV0Header

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MessageV0Header

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MessageV0Header

Manual PartialEq implementation for MessageV0Header

fn eq(&self, other: &Self) -> 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 MessageV0Header

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for MessageV0Header

Manual Eq implementation for MessageV0Header