Struct IpcMessage 

pub struct IpcMessage {
    pub topic: String,
    pub payload: IpcPayload,
    pub signature: Option<Vec<u8>>,
    pub source_id: Uuid,
    pub timestamp: DateTime<Utc>,
    pub seq: u64,
    pub principal: Option<String>,
}

A cross-boundary message sent over the event bus between WASM guests and the host.

Fields

topic: String

Topic pattern or exact match (e.g., astrid.cli.input).

payload: IpcPayload

Standardized payload structure.

signature: Option<Vec<u8>>

Optional cryptographic signature for stateless verification across a distributed swarm.

source_id: Uuid

Identifier of the sender plugin or agent.

timestamp: DateTime<Utc>

Timestamp when the message was dispatched. Defaults to now on deserialization so capsules forwarding bus messages over the wire (e.g. the CLI proxy) don’t need to fabricate a timestamp the SDK doesn’t expose to them. Only filled in by the clock feature path (kernel-side); when the feature is off (capsule SDK consumption on wasm32-unknown-unknown), missing timestamps fall back to the Unix epoch — capsules read timestamps from kernel-published messages, they never construct fresh ones.

seq: u64

Monotonic sequence number assigned by the event bus at publish time. Used by the dispatcher to guarantee in-order delivery per capsule.

principal: Option<String>

The principal (user identity) this message is acting on behalf of.

String rather than PrincipalId because astrid-types must not depend on astrid-core. Validation to PrincipalId happens at the kernel boundary. None for system events (boot, lifecycle).

Implementations

impl IpcMessage

pub fn new( topic: impl Into<String>, payload: IpcPayload, source_id: Uuid, ) -> IpcMessage

Create a new IPC message stamped with the current wall-clock time. Only available when the clock feature is enabled (kernel-side); capsule code constructs IpcMessage from payloads it receives, never from scratch.

pub fn with_signature(self, signature: Vec<u8>) -> IpcMessage

Attach a signature for swarm verification.

pub fn with_principal(self, principal: impl Into<String>) -> IpcMessage

Set the acting principal for this message.

Trait Implementations

impl Clone for IpcMessage

fn clone(&self) -> IpcMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IpcMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for IpcMessage

fn deserialize<__D>( __deserializer: __D, ) -> Result<IpcMessage, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for IpcMessage

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

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 StructuralPartialEq for IpcMessage