Struct Contact 

pub struct Contact {
    pub peer_id: String,
    pub addresses: Vec<CandidateAddr>,
}

A known peer in the routing table / on the wire: its peer_id (64-hex) and candidate addresses.

This is the DHT’s contact record and the find_node / find_providers.closer wire shape. The addresses are the same { host, port, kind } candidates as an L7 dig.getPeers peer, so a contact converts directly to a dig_nat::PeerTarget.

Fields

peer_id: String

The peer’s identity — 64-hex peer_id = SHA-256(SPKI DER).

addresses: Vec<CandidateAddr>

Candidate addresses to reach the peer. Ordered IPv6-first, then most-direct-first by AddressKind::rank when built via Contact::new; a Contact deserialized directly from the wire (bypassing new) is not guaranteed sorted, so a consumer that cannot assume a conforming producer should still sort defensively.

Implementations

impl Contact

pub fn new(peer_id: &PeerId, addresses: Vec<CandidateAddr>) -> Self

Build a contact from a decoded PeerId and its candidate addresses. addresses is sorted IPv6-first-then-rank (see sort_addresses_ipv6_first) — ecosystem-wide IPv6-first, IPv4-fallback for peer communication.

pub fn peer_id(&self) -> Option<PeerId>

The peer’s PeerId decoded from the 64-hex field, or None if malformed.

pub fn key(&self) -> Option<Key>

This contact’s key in the DHT keyspace (its peer_id), or None if the hex is malformed.

pub fn best_address(&self) -> Option<&CandidateAddr>

The IPv6-preferred, most-direct dialable candidate address, if any. addresses is already IPv6-first-then-rank sorted, so this is simply the first dialable entry.

Trait Implementations

impl Clone for Contact

fn clone(&self) -> Contact

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Contact

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Contact

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Contact

impl PartialEq for Contact

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Contact

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 Contact