Struct MeshIpcEnvelope 

pub struct MeshIpcEnvelope {
    pub source_node: String,
    pub dest_node: String,
    pub message: KernelMessage,
    pub hop_count: u8,
    pub envelope_id: String,
    pub dest_scope: Option<Scope>,
    pub src_scope: Option<Scope>,
}

A mesh IPC envelope wrapping a KernelMessage with routing metadata.

Fields

source_node: String

Source node ID.

dest_node: String

Destination node ID.

message: KernelMessage

The kernel message being transported.

hop_count: u8

Hop count (incremented at each relay, max 8).

envelope_id: String

Unique envelope ID for deduplication.

dest_scope: Option<Scope>

Destination tenant scope. Absent on the wire when None, so envelopes without scopes stay byte-identical to the old format.

src_scope: Option<Scope>

Source tenant scope (stamped by the mesh service, never trusted from an unregistered peer). Absent on the wire when None.

Implementations

impl MeshIpcEnvelope

pub fn new( source_node: String, dest_node: String, message: KernelMessage, ) -> Self

Create a new envelope for a message being sent to a remote node.

pub fn to_bytes(&self) -> Result<Vec<u8>, MeshIpcError>

Serialize the envelope using DEFAULT_MESH_IPC_ENCODING (JSON).

pub fn to_bytes_with_encoding( &self, encoding: MeshIpcEncoding, ) -> Result<Vec<u8>, MeshIpcError>

Serialize with an explicit encoding.

JSON is always available. RVF requires feature = "mesh-rvf" and currently returns MeshIpcError::UnsupportedEncoding (WEFT-683 Option A — deferred until revisit triggers in ADR-031 fire).

pub fn from_bytes(data: &[u8]) -> Result<Self, MeshIpcError>

Deserialize an envelope from JSON bytes (default encoding).

pub fn from_bytes_with_encoding( data: &[u8], encoding: MeshIpcEncoding, ) -> Result<Self, MeshIpcError>

Deserialize with an explicit encoding.

pub fn increment_hop(&mut self) -> Result<(), MeshIpcError>

Increment hop count and check if max hops exceeded.

pub fn inner_target(&self) -> &MessageTarget

Extract the inner target (unwrap RemoteNode if present).

Trait Implementations

impl Clone for MeshIpcEnvelope

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MeshIpcEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MeshIpcEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MeshIpcEnvelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.