Struct Network 

pub struct Network { /* private fields */ }

Network abstraction for the Autonomi client.

Wraps a P2PNode providing high-level operations for peer discovery and message routing.

Implementations

impl Network

pub async fn new( bootstrap_peers: &[SocketAddr], allow_loopback: bool, ipv6: bool, ) -> Result<Self>

Create a new network connection with the given bootstrap peers.

allow_loopback controls the saorsa-transport local flag on the underlying CoreNodeConfig. Set it to true only for devnet / local testing. Public Autonomi network peers reject the QUIC handshake variant produced when local = true, so production callers must pass false (this is what ant-cli does by default — see ant-cli/src/main.rs::create_client_node_raw, which builds a similar CoreNodeConfig directly, with ipv6 toggled by the --ipv4-only flag).

ipv6 controls whether the node binds a dual-stack IPv6 socket (true) or an IPv4-only socket (false). The default for library callers should be true to match the CLI default; set it to false only when running on hosts without a working IPv6 stack, to avoid advertising unreachable v6 addresses to the DHT.

Errors

Returns an error if the P2P node cannot be created or bootstrapping fails.

pub fn from_node(node: Arc<P2PNode>) -> Self

Create a network from an existing P2P node.

pub fn node(&self) -> &Arc<P2PNode>

Get a reference to the underlying P2P node.

pub fn peer_id(&self) -> &PeerId

Get the local peer ID.

pub async fn find_closest_peers( &self, target: &[u8; 32], count: usize, ) -> Result<Vec<(PeerId, Vec<MultiAddr>)>>

Find the closest peers to a target address.

Returns each peer paired with its known network addresses, enabling callers to pass addresses to send_and_await_chunk_response for faster connection establishment.

Errors

Returns an error if the DHT lookup fails.

pub async fn connected_peers(&self) -> Vec<PeerId>

Get all currently connected peers.