Struct NodeIdentity 

pub struct NodeIdentity {
    pub cluster_id: ClusterId,
    pub node_id: NodeId,
    pub created_at: HlcTimestamp,
    pub format_version: u32,
}

Persisted node identity (spec section 11.1, S2A-001).

Serialized as versioned JSON; format_version is part of the struct per S2A-001 and is verified on every load. Unknown fields and unknown versions fail closed (spec section 4.10).

Fields

cluster_id: ClusterId

Cluster this node is bound to for the lifetime of its data directory.

node_id: NodeId

This node’s identifier within the cluster.

created_at: HlcTimestamp

Wall-clock time the identity was minted (informational).

format_version: u32

Durable format version; see NODE_IDENTITY_FORMAT_VERSION.

Implementations

impl NodeIdentity

pub fn load(node_data: &Path) -> Result<Option<Self>, ClusterError>

Load and verify the persisted identity, if present.

Returns Ok(None) when no identity has been minted yet. A present but undecodable, unknown-version, or reserved-identifier file fails closed with a typed error; it is never silently replaced.

pub fn load_or_create( node_data: &Path, csprng: Csprng<'_>, ) -> Result<Self, ClusterError>

Load the persisted identity, or mint and persist a fresh one on first boot (cluster_id and node_id drawn from csprng).

Concurrent first boots on one directory race on an atomic create-if-absent publish; the loser loads and returns the winner’s identity, so the result is stable.

Trait Implementations

impl Clone for NodeIdentity

fn clone(&self) -> NodeIdentity

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: &NodeIdentity) -> 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