Struct TestnetBuilder 

pub struct TestnetBuilder { /* private fields */ }

Builder for creating a Testnet with custom configuration.

Defaults

• bind_address: 127.0.0.1 (localhost)
• seeded: true - nodes start with fully populated routing tables

Example

use std::net::Ipv4Addr;
use mainline::Testnet;

// Use localhost (default)
let testnet = Testnet::builder(3).build().unwrap();

// Use all interfaces (0.0.0.0)
let testnet = Testnet::builder(3)
    .bind_address(Ipv4Addr::UNSPECIFIED)
    .build()
    .unwrap();

Implementations

impl TestnetBuilder

pub fn new(count: usize) -> Self

Create a new builder with the specified number of nodes.

Defaults

• bind_address: 127.0.0.1 (localhost)
• seeded: true

pub fn bind_address(&mut self, bind_address: Ipv4Addr) -> &mut Self

Set the address to bind all nodes to.

Defaults to 127.0.0.1 (localhost). Use Ipv4Addr::UNSPECIFIED (0.0.0.0) to bind to all interfaces.

pub fn seeded(&mut self, seeded: bool) -> &mut Self

Whether to pre-seed routing tables with all nodes.

Defaults to true.

When true, all nodes start with fully populated routing tables. When false, nodes bootstrap from each other which is faster at startup but may not have immediate full connectivity.

pub fn build(&self) -> Result<Testnet, Error>

Build the testnet.

Nodes will be bound to the configured bind_address (default: 127.0.0.1).

This will block until all nodes are created (and seeded if seeded is true).

Trait Implementations

impl Clone for TestnetBuilder

fn clone(&self) -> TestnetBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TestnetBuilder

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

Formats the value using the given formatter.