Struct NodeIdentity 

pub struct NodeIdentity {
    pub v: u8,
    pub id: String,
    pub nm: Option<String>,
    pub pr: Option<String>,
    pub ver: Option<String>,
    pub pv: Option<u16>,
    pub pl: Option<String>,
}

A drone’s identity, sent less often than status because it does not change.

This is the frame that lets a ground station answer “who is my peer” with the node’s real identity. The presence beacon carries a device id, but the beacon is a fixed 68-byte HMAC-signed frame with its identity field already full, so there is no room in it for a name or an agent version.

Fields

v: u8

Schema version (NODE_STATUS_VERSION).

id: String

The node’s persistent device id, the key everything else correlates on.

nm: Option<String>

Human-facing node name, when the node has one configured.

pr: Option<String>

The node’s profile (drone, ground-station, …), when known.

ver: Option<String>

Agent version string.

pv: Option<u16>

The highest plugin contract version any installed plugin declares, a coarse node-wide signal a peer can glance at. The authoritative per-plugin detail is Self::pl. Absent when no plugin is installed.

pl: Option<String>

The installed plugin inventory as a comma-joined list of pluginId@contractVersion, clipped to MAX_PLUGIN_LIST. Lets a peer compare per-plugin contract versions and detect an AD05-class wire disagreement instead of silently misreading a field.

Implementations

impl NodeIdentity

pub fn build( device_id: &str, name: Option<&str>, profile: Option<&str>, version: Option<&str>, plugins: &[(String, u16)], ) -> Self

Build a bounded identity frame. Every field is clipped here, so no caller can put an unbounded string on the lane.

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

Encode to msgpack. None when the frame would exceed one aux payload, which the field caps make unreachable; it is a guard, not a path.

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

Decode a msgpack identity frame, rejecting an unrecognised schema version and an empty device id (an id-less identity correlates to nothing and is worse than no frame at all).

Trait Implementations

impl Clone for NodeIdentity

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 NodeIdentity

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NodeIdentity

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for NodeIdentity

impl PartialEq for NodeIdentity

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for NodeIdentity

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 NodeIdentity