Struct TestNetwork 

pub struct TestNetwork { /* private fields */ }

A test network consisting of gateways and peer nodes

Implementations

impl TestNetwork

pub fn log_files(&self) -> Vec<(String, PathBuf)>

Get all log files from the network

pub fn read_logs(&self) -> Result<Vec<LogEntry>>

Read all logs in chronological order

pub fn tail_logs(&self) -> Result<impl Iterator<Item = LogEntry> + '_>

Tail logs from all peers (blocking)

impl TestNetwork

pub fn builder() -> NetworkBuilder

Create a new network builder

pub fn gateway(&self, index: usize) -> &TestPeer

Get a gateway peer by index

pub fn peer(&self, index: usize) -> &TestPeer

Get a non-gateway peer by index

pub fn gateway_ws_urls(&self) -> Vec<String>

Get all gateway WebSocket URLs

pub fn peer_ws_urls(&self) -> Vec<String>

Get all peer WebSocket URLs

pub async fn wait_until_ready(&self) -> Result<()>

Wait until the network is ready for use

This checks that peers have formed connections and the network is sufficiently connected for testing.

pub async fn wait_until_ready_with_timeout( &self, timeout: Duration, ) -> Result<()>

Wait until the network is ready with a custom timeout

pub async fn topology(&self) -> Result<NetworkTopology>

Get the current network topology

pub fn export_for_viz(&self) -> String

Export network information in JSON format for visualization tools

pub async fn collect_diagnostics(&self) -> Result<NetworkDiagnosticsSnapshot>

Collect diagnostics from every peer, returning a snapshot that can be serialized to JSON for offline analysis.

pub async fn ring_snapshot(&self) -> Result<Vec<RingPeerSnapshot>>

Collect per-peer ring data (locations + adjacency) for visualization/debugging.

pub async fn write_ring_visualization<P: AsRef<Path>>( &self, output_path: P, ) -> Result<()>

Generate an interactive HTML ring visualization for the current network.

pub async fn write_ring_visualization_for_contract<P: AsRef<Path>>( &self, output_path: P, contract_id: &str, ) -> Result<()>

Generate an interactive HTML ring visualization for a specific contract.

impl TestNetwork

pub fn run_root(&self) -> &Path

Directory containing all peer state/logs for this test network run.