Struct PeerIdentity 

pub struct PeerIdentity { /* private fields */ }

A known peer’s identity (public key only, no signing capability).

Use this to represent remote peers whose npub you know. For a local identity with signing capability, use [Identity] instead.

Implementations

impl PeerIdentity

pub fn from_pubkey(pubkey: XOnlyPublicKey) -> PeerIdentity

Create a PeerIdentity from an x-only public key.

Note: When only the x-only key is available, the full public key will be derived assuming even parity for ECDH operations.

Precomputes the even-parity full pubkey eagerly so pubkey_full() is a constant-time field load. Without this, every send-side hot-path caller (e.g. send_endpoint_data per packet) re-derived the full key, which spends ~6% of CPU on a secp256k1 EC point parse for what should be a memoized lookup.

pub fn from_pubkey_full(pubkey: PublicKey) -> PeerIdentity

Create a PeerIdentity from a full public key (includes parity).

Use this when you have the complete public key (e.g., from a Noise handshake) to preserve parity information for ECDH operations.

pub fn from_npub(npub: &str) -> Result<PeerIdentity, IdentityError>

Create a PeerIdentity from a bech32-encoded npub string.

pub fn pubkey(&self) -> XOnlyPublicKey

Return the x-only public key.

pub fn pubkey_full(&self) -> PublicKey

Return the full public key for ECDH operations.

If the full key was provided during construction, it is returned. Otherwise, the key is derived from the x-only key assuming even parity.

pub fn npub(&self) -> String

Return the public key as a bech32-encoded npub string (NIP-19).

pub fn short_npub(&self) -> String

Return a shortened npub for log display (e.g., npub1abcd...wxyz).

pub fn node_addr(&self) -> &NodeAddr

Return the node ID.

pub fn address(&self) -> &FipsAddress

Return the FIPS address.

pub fn verify(&self, data: &[u8], signature: &Signature) -> bool

Verify a signature from this peer.

Trait Implementations

impl Clone for PeerIdentity

fn clone(&self) -> PeerIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerIdentity

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

Formats the value using the given formatter.

impl Display for PeerIdentity

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

Formats the value using the given formatter.

impl PartialEq for PeerIdentity

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for PeerIdentity

impl Eq for PeerIdentity

impl StructuralPartialEq for PeerIdentity