Enum PeerIdentity 

#[non_exhaustive]
pub enum PeerIdentity {
    Network(SocketAddr),
    Local(LocalPeer),
    Unknown,
}

Who is on the other end of a connection.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Network(SocketAddr)

A TCP/TLS network peer — the pre-2.0 behaviour.

Local(LocalPeer)

A same-machine peer reached over a local transport.

Unknown

Transport could not determine a peer (in-process tests, exotic transports).

Implementations

impl PeerIdentity

pub fn ip_addr(&self) -> IpAddr

Best-effort IP for logging and for the pre-2.0 ip_addr field.

Local and unknown peers report loopback — they have no IP, and loopback is both truthful about locality and safe for code that only formats this value.

pub fn socket_addr(&self) -> SocketAddr

The socket address for network peers; a loopback placeholder otherwise.

Provided for the deprecated WsConnection::address accessor. Prefer matching on the enum.

pub fn attestation(&self) -> Option<&Attestation>

Attestation for local peers; None for network peers (TLS client certs are not modelled here).

pub fn display(&self) -> String

Compact one-line form for logs: 1.2.3.4:5678, local(pid=42,xpc-codesign-requirement).

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

Formats the value using the given formatter.

impl Display for PeerIdentity

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

Formats the value using the given formatter.

impl From<SocketAddr> for PeerIdentity

fn from(addr: SocketAddr) -> Self

Converts to this type from the input type.