Testnet

There's a long-running testnet chain available, intended for developers to test code and practice integrating their software with the Penumbra stack.

Services available

The following public services are available:

Joining the testnet

You can run a node on the public testnet like so:

# clean up any pre-existing network state
cargo run --release --bin pd -- network unsafe-reset-all
# generate network configs for the testnet chain
cargo run --release --bin pd -- network join http://testnet.plinfra.net:26657

That network join command will initialize node state directories locally. Then fetch the most recent snapshot to backfill blocks from before the most recent testnet chain upgrade:

curl -O https://artifacts.plinfra.net/penumbra-testnet-phobos-2/penumbra-node-archive-latest.tar.gz
tar -xzf penumbra-node-archive-latest.tar.gz -C ~/.penumbra/network_data/node0/

After that, if you've set up the Penumbra developer environment, you can run a fullnode locally via:

just dev

For a more persistent setup, consult the tutorial on running a node.

Running pcli

To interact with the chain, configure a wallet pointing at the testnet node:

cargo run --release --bin pcli -- --home ~/.local/share/pcli-testnet view reset
cargo run --release --bin pcli -- init --grpc-url https://testnet.plinfra.net soft-kms generate
# or, to reuse an existing seed phrase:
cargo run --release --bin pcli -- init --grpc-url https://testnet.plinfra.net soft-kms import-phrase

and then pass the --home flag to any commands you run to point pcli at your local node, e.g.,

cargo run --release --bin pcli -- --home ~/.local/share/pcli-testnet view balance

You'll be able to run queries like pcli query validator list, but by default you won't be able to create transactions, as an empty wallet will lack funds to pay gas fees.

Using the testnet faucet

There's currently no faucet running for the Penumbra testnet chain, but check back soon for details.