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 with_signature(self, signature: Vec<u8>) -> Self

Attach a signature for swarm verification.

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

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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for IpcMessage