Struct Connections 

pub struct Connections { /* private fields */ }

One live connection per node on one ALPN, shared by every pull of one command (cdn/client/v1, from new) or by every outbound call of one node (with_options).

A pull opens its own bi-stream on the node’s connection and dials only when the node has no live connection. Concurrent callers for one node share one dial. A pull that meets a transport fault (a connection reset, a closed connection, an idle timeout, an open or read that falls under its deadline) unpins its connection (invalidate), so the next get dials again. A protocol refusal or a hash mismatch ends only its own stream, and the connection stays pinned. The connection carries no payment state: payment lanes stay per (signer, provider).

Cloning is cheap: every clone shares one map. Each pull holds its connection, so each connection closes when the map drops it and no pull still holds it.

Where the drivers run (#1675). A connection’s QUIC driver lives on the runtime that dialled it, and the connection makes progress only while that driver runs. A map with a dial runtime dials every connection there, so callers on any runtime share it, including runtimes they throw away (decdn-node’s per-serve pull legs), as long as the dial runtime outlives the endpoint. A map without one dials on the caller’s runtime: share it only between callers on one runtime that outlives the map, such as the decdn CLI’s.

Implementations

impl Connections

pub fn new(endpoint: Endpoint) -> Self

An empty map that dials cdn/client/v1 from endpoint, on the caller’s runtime.

Trait Implementations

impl Clone for Connections

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Connections

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

Formats the value using the given formatter.