Enum LocalIdentity 

pub enum LocalIdentity<I: NodeIdentity> {
    LongTerm(I),
    Ephemeral(SoftwareIdentity),
}

A local node identity that the Mac coordinator owns and acts on behalf of.

UMSH nodes are identified by Ed25519 public keys. An identity provides the public key and the ability to derive pairwise keys via ECDH with the corresponding private key. Two variants are supported:

• LongTerm(I) — wraps the platform-supplied I: NodeIdentity, which is typically backed by secure-element storage, an HSM, or a platform keystore. Long-term identities persist across reboots; their frame counters are saved to the umsh_hal::CounterStore so that replay protection remains valid after a power cycle.

• Ephemeral — wraps an in-memory SoftwareIdentity generated fresh at runtime for Perfect Forward Secrecy sessions. Because the key material itself vanishes on power loss, ephemeral identities do not persist their frame counters; replay protection is meaningful only within a single session. Requires the software-crypto crate feature.

Use LocalIdentity::public_key or LocalIdentity::hint to inspect the address presented to the network without matching on the variant.

Variants

LongTerm(I)

Long-term platform identity.

Ephemeral(SoftwareIdentity)

Software ephemeral identity used for PFS sessions.

Implementations

impl<I: NodeIdentity> LocalIdentity<I>

pub fn public_key(&self) -> &PublicKey

Return the public key for this identity.

pub fn hint(&self) -> NodeHint

Return the derived node hint for this identity.

pub fn is_ephemeral(&self) -> bool

Return whether this identity is ephemeral.

Trait Implementations

impl<I: NodeIdentity> From<I> for LocalIdentity<I>

fn from(value: I) -> Self

Converts to this type from the input type.