Struct Message 

pub struct Message {
    pub id: String,
    pub message_type: String,
    pub from: String,
    pub to: String,
    pub created_at: u64,
    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_did::{generate_identity, Message, SigningKey, Did};

let sender = generate_identity("k51qzi5uqu5dj9807pbuod1pplf0vxh8m4lfy3ewl9qbm2s8dsf9ugdf9gedhr").unwrap();
let recipient = generate_identity("k51qzi5uqu5dl96qbq93mwl5drvk2z83fk4s6h4n7xgqnwrxlscs11i1bja7uk").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 CBOR
let bytes = msg.to_cbor().unwrap();
let restored = Message::from_cbor(&bytes).unwrap();
assert_eq!(msg.id, restored.id);

Fields

id: String

message_type: String

from: String

to: String

created_at: u64

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<Message, MaError>

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<Message, MaError>

pub fn to_cbor(&self) -> Result<Vec<u8>, MaError>

pub fn from_cbor(bytes: &[u8]) -> Result<Message, MaError>

pub fn unsigned_headers(&self) -> Headers

pub fn headers(&self) -> Headers

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

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

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

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<(), Error>

Formats the value using the given formatter.

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

fn deserialize<__D>( __deserializer: __D, ) -> Result<Message, <__D as Deserializer<'de>>::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 as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Message

impl StructuralPartialEq for Message