Struct StaticTestnet 

pub struct StaticTestnet {
    pub testnet: Testnet,
    /* private fields */
}

A testnet for interactive / CLI use — all ports are fixed and well-known.

Use this when you need a long-running testnet that external processes can connect to (e.g. browser tests, mobile apps, or manual debugging). The fixed ports make it easy to hard-code endpoints in client configuration.

Supports two storage modes:

• In-memory (default) — all state is lost on shutdown.
• Persistent — state is stored on disk and survives restarts. Enable with .persistent(data_dir) on the builder.

For automated tests with random ports, see EphemeralTestnet.

Fixed ports

• DHT bootstrap node: 6881
• pkarr relay: 15411
• HTTP relay: 15412
• Homeserver ICANN HTTP: 6286
• Homeserver Pubky HTTPS: 6287
• Homeserver admin: 6288

The homeserver address is hardcoded to 8pinxxgqs41n4aididenw5apqp1urfmzdztr8jt4abrkdn435ewo.

Fields

testnet: Testnet

Inner flexible testnet.

Implementations

impl StaticTestnet

pub fn builder() -> StaticTestnetBuilder

Create a builder for configuring the testnet.

pub async fn start() -> Result<Self>

Run an in-memory testnet with the default homeserver config.

pub async fn start_with_homeserver_config(config_path: PathBuf) -> Result<Self>

👎Deprecated since 0.9.0:

Use StaticTestnet::builder().homeserver_config(path).build() instead

Run an in-memory testnet with a custom homeserver config.

pub fn is_persistent(&self) -> bool

Whether this testnet is running in persistent mode.

pub async fn create_random_homeserver(&mut self) -> Result<&HomeserverApp>

Create an additional homeserver with a random keypair.

pub fn client_builder(&self) -> PubkyHttpClientBuilder

Create a new pubky client builder.

pub fn client(&self) -> Result<PubkyHttpClient, BuildError>

Creates a pubky::PubkyHttpClient pre-configured to use this test network.

pub fn sdk(&self) -> Result<Pubky, BuildError>

Creates a pubky::Pubky SDK facade pre-configured to use this test network.

This is a convenience method that builds a client from Self::client_builder.

pub fn pkarr_client_builder(&self) -> ClientBuilder

Create a new pkarr client builder.

pub fn homeserver_app(&self) -> &HomeserverApp

Get the homeserver in the testnet.

pub fn http_relay(&self) -> &HttpRelay

Get the http relay in the testnet.

pub fn pkarr_relay(&self) -> &Relay

Get the pkarr relay in the testnet.

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

Get the bootstrap nodes for the testnet.