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 find_witnessed_close_group( &self, target: &[u8; 32], count: usize, ) -> Result<WitnessedCloseGroup>

Find a witnessed close-group transcript for a target address.

The underlying DHT method returns the initial client K, each responder’s self-inclusive closest-K node view, and enough trusted node records for callers to apply their own quorum and fallback policy.

Errors

Returns an error if the DHT lookup itself fails. The returned transcript may still be inconclusive; callers should evaluate it before payment.

pub async fn find_witnessed_close_group_with_view_count( &self, target: &[u8; 32], count: usize, view_count: usize, ) -> Result<WitnessedCloseGroup>

Find a witnessed close-group transcript with wider responder views.

count is the initial responder set size. view_count is the number of closest nodes each responder view may contribute.

Errors

Returns an error if the DHT lookup itself fails. The returned transcript may still be inconclusive; callers should evaluate it before payment.

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

Get all currently connected peers.