Struct Message 

pub struct Message {
    pub id: String,
    pub message_type: String,
    pub from: String,
    pub to: String,
    pub created_at: f64,
    pub ttl: u64,
    pub content_type: String,
    pub reply_to: Option<String>,
    pub content: Vec<u8>,
    pub signature: Vec<u8>,
}

A signed actor-to-actor message.

Messages are signed on creation using the sender’s SigningKey. The signature covers the CBOR-serialized headers (including a BLAKE3 hash of the content), ensuring both integrity and authenticity.

Examples

use ma_core::{generate_identity_from_secret, Message, SigningKey, Did};

let sender = generate_identity_from_secret([1u8; 32]).unwrap();
let recipient = generate_identity_from_secret([2u8; 32]).unwrap();

let sign_url = Did::new_url(&sender.subject_url.ipns, None::<String>).unwrap();
let signing_key = SigningKey::from_private_key_bytes(
    sign_url,
    hex::decode(&sender.signing_private_key_hex).unwrap().try_into().unwrap(),
).unwrap();

// Create a signed message
let msg = Message::new(
    sender.document.id.clone(),
    recipient.document.id.clone(),
    "text/plain",
    b"hello".to_vec(),
    &signing_key,
).unwrap();

// Verify against sender's document
msg.verify_with_document(&sender.document).unwrap();

// Serialize to wire format
let bytes = msg.encode().unwrap();
let restored = Message::decode(&bytes).unwrap();
assert_eq!(msg.id, restored.id);

Fields

id: String

message_type: String

from: String

to: String

created_at: f64

ttl: u64

content_type: String

reply_to: Option<String>

content: Vec<u8>

signature: Vec<u8>

Implementations

impl Message

pub fn new( from: impl Into<String>, to: impl Into<String>, content_type: impl Into<String>, content: Vec<u8>, signing_key: &SigningKey, ) -> Result<Self>

pub fn new_with_ttl( from: impl Into<String>, to: impl Into<String>, content_type: impl Into<String>, content: Vec<u8>, ttl: u64, signing_key: &SigningKey, ) -> Result<Self>

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

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

pub fn unsigned_headers(&self) -> Headers

pub fn headers(&self) -> Headers

pub fn sign(&mut self, signing_key: &SigningKey) -> Result<()>

pub fn verify_with_document(&self, sender_document: &Document) -> Result<()>

pub fn enclose_for(&self, recipient_document: &Document) -> Result<Envelope>

Trait Implementations

impl Clone for Message

fn clone(&self) -> Message

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Message

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Message

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Message

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

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 Message