2 releases

new 0.1.1 Feb 20, 2025
0.1.0 Feb 13, 2025

#897 in Authentication

Download history 126/week @ 2025-02-11

126 downloads per month

MIT license

155KB
3K SLoC

Pubky Testnet

A local test network for developing Pubky Core or applications depending on it.

All resources are ephemeral, databases are in the operating system's temporary directories, and all servers are closed as the testnet dropped.

Usage

Inline testing

use pubky_testnet::Testnet;

#[tokio::main]
async fn main () {
  // Run a new testnet.
  let testnet = Testnet::run().await.unwrap();

  // Optionally create and run a Homeserver.
  let server = testnet.run_homeserver().await.unwrap();

  // Optionally create and run an HTTP Relay.
  let http_relay = testnet.run_http_relay().await.unwrap();

  // Create a Pubky Client from the testnet.
  let client = testnet.client_builder().build().unwrap();
}

Binary (hardcoded testnet, and browser support).

If you need to run the testnet in a separate process, for example to test Pubky Core in browsers, you need to run this binary, which will create these components with hardcoded configurations:

  1. A local DHT with bootstrapping nodes: &["localhost:6881"]
  2. A Pkarr Relay running on port 15411
  3. A Homeserver with address is hardcoded to 8pinxxgqs41n4aididenw5apqp1urfmzdztr8jt4abrkdn435ewo
  4. An HTTP relay running on port 15412

Dependencies

~37–52MB
~1M SLoC