Struct NodeIdentity 

pub struct NodeIdentity {
    pub ed25519_secret: [u8; 32],
    pub wg_secret: [u8; 32],
}

The node’s persisted cryptographic identity.

Two independent 32-byte secrets: an ed25519 signing key (identity / challenge signing) and a Curve25519 WireGuard secret (transport / overlay addressing). Serialized to JSON for on-disk persistence.

Fields

ed25519_secret: [u8; 32]

Raw 32-byte ed25519 signing (secret) key.

wg_secret: [u8; 32]

Raw 32-byte Curve25519 WireGuard secret key.

Implementations

impl NodeIdentity

pub fn signing_key(&self) -> SigningKey

Reconstruct the ed25519 [SigningKey] from the stored secret bytes.

pub fn identity_pubkey_hex(&self) -> String

The node’s stable identity public key, lowercase hex (64 chars).

This is the ed25519 verifying key that peers use to check signatures on connection identifiers and challenge responses.

pub fn wireguard_pubkey_hex(&self) -> String

This node’s WireGuard public key, lowercase hex (64 chars).

pub fn overlay_addr(&self) -> String

The node’s overlay address, derived from its WireGuard public key.

This is an fd… ULA IPv6 string produced by crate::connection_identifier::derive_overlay_addr.

pub fn load_or_create() -> Result<NodeIdentity, String>

Load the persisted node identity, or generate and persist a fresh one.

Reads app_meta_dir()/node_identity.json. If the file exists and parses, it is returned as-is. Otherwise a new identity is generated from the OS CSPRNG, written to that path (creating the parent directory as needed) as pretty-printed JSON, and returned. All errors are mapped to String.

Available on all targets: mesh WG helpers remain native-only, but the Ed25519 apparatus identity is needed for multi-device person/fleet wiring.

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<'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 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.