Struct PeerTarget 

pub struct PeerTarget {
    pub peer_id: PeerId,
    pub network_id: String,
    /* private fields */
}

A description of the peer to connect to.

The caller supplies the peer’s stable PeerId (for mTLS verification) and any candidate addresses it knows (from discovery / the address manager / the relay peer list). At least one direct candidate OR peer_id+relay reachability is needed; the strategy uses the candidate list for the direct/mapping methods and peer_id for the relay-coordinated + relayed methods.

Address-family policy — IPv6-first, IPv4-fallback (via dig-ip)

The candidate list is stored in DISCOVERY order — the IPv6-first preference + the local∩peer family intersection are applied at DIAL time by the canonical dig-ip crate (crate::dialer), not by this type. So a peer reachable over IPv6 is dialed over IPv6 and IPv4 is used only as a fallback, but a caller supplies candidates in whatever order it discovered them. Use PeerTarget::with_addrs to supply several candidates; PeerTarget::with_addr for a single one.

Fields

peer_id: PeerId

The peer’s network identity — SHA-256 of its TLS SPKI DER. Used to VERIFY the mTLS peer and to address it over the relay. Required.

network_id: String

The network id the peer registered under (relay network_id, e.g. DIG_MAINNET). Used to scope relay peer lookups + hole-punch coordination.

Implementations

impl PeerTarget

pub fn with_addr( peer_id: PeerId, direct_addr: SocketAddr, network_id: impl Into<String>, ) -> Self

A peer known by a single direct address (public / port-forwarded / discovered).

pub fn with_addrs( peer_id: PeerId, direct_addrs: Vec<SocketAddr>, network_id: impl Into<String>, ) -> Self

A peer known by one OR MORE direct candidate addresses, kept in the order supplied. The dialer (dig-ip) applies the IPv6-first preference + local∩peer family intersection at dial time, so the caller need not pre-order the candidates.

pub fn relay_only(peer_id: PeerId, network_id: impl Into<String>) -> Self

A peer known only by identity — reachable via relay-coordinated methods.

pub fn direct_addrs(&self) -> &[SocketAddr]

The peer’s candidate addresses, in discovery order. Empty for a relay-only target. The dial order (IPv6-first, intersected with the local host’s families) is computed by dig-ip at dial time.

pub fn direct_addr(&self) -> Option<SocketAddr>

The first candidate address, or None for a relay-only target.

A convenience accessor for callers that want ONE address; it returns the first candidate in discovery order. Prefer PeerTarget::direct_addrs so the dialer honours the full family-aware happy-eyeballs fallback (dig-ip).

pub fn set_direct_addrs(&mut self, addrs: Vec<SocketAddr>)

Replace the candidate list (kept in the order supplied).

Trait Implementations

impl Clone for PeerTarget

fn clone(&self) -> PeerTarget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerTarget

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

Formats the value using the given formatter.

impl Eq for PeerTarget

impl PartialEq for PeerTarget

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PeerTarget