Skip to main content

Testnets

note

testnet11 is the supported testnet. Older testnets may remain active, but are no longer officially supported by Chia Network Inc.

Testnets can be used to test the chia software with coins that have no real world value.
If you want to run the Chia blockchain mainnet, use the mainnet installation instructions.


Join the official testnet

Prerequisites

  • Minimum Chia version is 2.1.0 installed.
  • All chia processes have been stopped with chia stop all-d.

Configure Chia for testnet

# Initialize chia
chia init

# Generate keys (if they have not already been generated)
chia keys generate

# Configure Chia for the currently-active testnet
chia configure --testnet true

(Opt) Download the official testnet db

This step is optional, but it will speed up syncing with the testnet

  • Linux users: wget https://databases.chia.net/file/chia-public-databases/blockchain_v2_testnet11.sqlite.gz while in the directory (a v1 DB is also available, but no longer updated).
  • Windows users: download it from https://downloads.chia.net/testnet11/ and move it to the db folder in the mainnet/ directory in the Chia root folder (i.e. ~/.chia/mainnet/db is the database directory).

Make sure to unzip the database before continuing to the next step.

tip

Prior to starting your node, it is recommended to delete peers.dat, located in ~/.chia/mainnet/db. If you don't delete this file you might see WARNING Invalid handshake with peer in your log file. The reason for this is that peers.dat will contain mainnet peers, which are not running on the testnet. If you do see these warnings, there's no requirement to take further action -- they'll eventually stop appearing as your invalid peers are replaced with valid ones.

Start your node and connect to peers

# Note - make sure to delete the peers.dat file in ~/.chia/mainnet/db prior to starting your node
# Start your node
chia start farmer

# Check sync status
chia show -s`

# Once the node is synced, you can check the wallet status
chia wallet show

(Opt) Fund a testnet wallet

# Get a testnet wallet address differentiated from mainnet wallet addresses by beginning with txch instead of xch
chia wallet get_address

Input your testnet wallet address into one of the faucets. If it says you are in the queue, it has worked.

  • Chia Official testnet faucet.
  • Community developed and managed testnet faucet. Thank you to Steve Stepp for building and managing this faucet!

Funds will not appear in your wallet until you are fully synced to the blockchain.


Dual farming mainnet and testnet

These instructions are tailored for Linux. A similar approach could likely be followed for MacOS.

In some cases, you may want to farm the same plots you farm on mainnet on one of the testnets as well, without removing them from mainnet. This is doable with a bit of extra legwork to set up unique ports for the testnet chia installation.

There are a couple options for setting this up. You can either ensure you have the CHIA_ROOT set to unique values for each instance you want to run, or else run the installations on separate users. These instructions will show setting a specific CHIA_ROOT.

Set Up mainnet installation

For the mainnet installation, we will stick with the default ports and CHIA_ROOT, so these steps are essentially no different than the standard installation instructions

Set Up testnet installation

note

(Optional) Install yq to make editing the yaml files easier https://github.com/mikefarah/yq#install.
Alternatively, you can manually edit the ports in config.yaml.

# Export the Chia root
export CHIA_ROOT=~/.chia/testnet

# Initialize testnet
chia init

# Configure Chia for the currently-active testnet
chia configure --testnet true

# Edit the file `~/.chia/testnet/config/config.yaml` and set the following fields to the new port values.
# Use the ports listed or choose any you desire as long as they are different than the default values for mainnet.

yq -i -y '.daemon_port = 55401' ~/.chia/testnet/config/config.yaml
yq -i -y '.ui.daemon_port = 55401' ~/.chia/testnet/config/config.yaml

yq -i -y '.ui.port = 8802' ~/.chia/testnet/config/config.yaml

yq -i -y '.farmer.port = 8547' ~/.chia/testnet/config/config.yaml
yq -i -y '.full_node.farmer_peer.port = 8547' ~/.chia/testnet/config/config.yaml
yq -i -y '.harvester.farmer_peer.port = 8547' ~/.chia/testnet/config/config.yaml

yq -i -y '.harvester.port = 8548' ~/.chia/testnet/config/config.yaml
yq -i -y '.farmer.harvester_peer.port = 8548' ~/.chia/testnet/config/config.yaml

yq -i -y '.wallet.port = 8649' ~/.chia/testnet/config/config.yaml
yq -i -y '.full_node.wallet_peer.port = 8649' ~/.chia/testnet/config/config.yaml

yq -i -y '.full_node.rpc_port = 8800' ~/.chia/testnet/config/config.yaml
yq -i -y '.ui.rpc_port = 8800' ~/.chia/testnet/config/config.yaml

yq -i -y '.farmer.rpc_port = 8571' ~/.chia/testnet/config/config.yaml

yq -i -y '.harvester.rpc_port = 8572' ~/.chia/testnet/config/config.yaml

yq -i -y '.wallet.rpc_port = 9456' ~/.chia/testnet/config/config.yaml

# Start Chia
chia start farmer

Swap between mainnet and testnet

To swap between running commands for mainnet and running commands for testnet, you need to ensure your CHIA_ROOT is set properly before running any commands

  • Mainnet: export CHIA_ROOT=~/.chia/mainnet
  • Testnet: export CHIA_ROOT=~/.chia/testnet

Create a local testnet for fast, private testing

These instructions are tailored for Linux. A similar approach could likely be followed for MacOS.

  1. Stop all chia processes. Check that they have stopped with ps -ef | grep chia
  2. Create a new chia root using export CHIA_ROOT="~/.chia/my_testnet", then chia init. Don't forget to export CHIA_ROOT, or prefix your chia commands with CHIA_ROOT="~/.chia/my_testnet" if you want to run on my_testnet when starting a new terminal.
  3. Create a new entry in config.yaml with a different GENESIS_CHALLENGE, and reduced DIFFICULTY_CONSTANT_FACTOR. 2^67 constant factor is around 110PiB assuming a fast timelord. So if you have around 110GiB, you can set it to 2 ^ 47. Decrease SUB_SLOT_ITERS_STARTING to something like 2^23 if you are using a slow computer. Decrease PLOT_FILTER if you want to have more proof checks per signage point.
  4. Make sure to add my_testnet to all places that need it, like network_overrides.config, and selected_network
  5. Change the introducer URLs to point to localhost so you don't contact the real ones
  6. Do sh install-timelord.sh
  7. Run the system with chia start all
  8. If you have installed the gui, run (cd chia-blockchain-gui && npm run electron &)

You can generate a new genesis challenge by running python, and entering the following commands:

from secrets import token_bytes
print(token_bytes().hex())

Testnet support

Join Our Discord and jump into the #testnet channel for support