Struct PeerConnection 

pub struct PeerConnection {
    pub peer_id: PeerId,
    pub method: TraversalKind,
    pub remote_addr: SocketAddr,
    pub session: PeerSession,
}

An established, mutually-authenticated, multiplexed connection to a peer.

The connection is one mTLS byte stream whose remote presented a certificate whose peer_id equals Self::peer_id (verified during the handshake by crate::mtls::PeerIdPinningVerifier), wrapped in a PeerSession so the caller can open many concurrent logical streams (open_stream) or byte-range streams (open_range_stream) — streaming-first, no head-of-line blocking. Self::method reports which traversal technique established it — observability only; the caller opens streams identically regardless of the tier.

Fields

peer_id: PeerId

The verified remote identity (== the PeerTarget::peer_id the caller asked for).

method: TraversalKind

The traversal technique that established this connection (Direct, Upnp, …, Relayed).

remote_addr: SocketAddr

The remote address the mTLS session runs over (the peer’s endpoint, or the relay for a relayed transport).

session: PeerSession

The multiplexed session over the authenticated, encrypted byte stream to the peer.

Implementations

impl PeerConnection

pub async fn open_stream(&mut self) -> Result<PeerStream>

Open a new concurrent logical stream to the peer (cheap; open as many as you need for simultaneous transfers without head-of-line blocking).

pub async fn open_range_stream( &mut self, req: &RangeRequest, ) -> Result<PeerStream>

Open a dig.fetchRange stream for req (writes the range-request preamble, then streams crate::mux::RangeFrames). The primitive for multi-source parallel range downloads.

pub async fn query_availability( &mut self, items: Vec<AvailabilityItem>, ) -> Result<AvailabilityResponse>

Availability pre-check (dig.getAvailability) — ask whether this peer holds items BEFORE opening range streams (see crate::mux::PeerSession::query_availability).

Trait Implementations

impl Debug for PeerConnection

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

Formats the value using the given formatter.