Join Anemos Testnet
Preface
The Anemos testnet is a public testing environment that replicates the functionality of the mainnet but uses test coins with no real-world value. Running a node on the testnet allows you to experiment safely, test applications, and support the stability of the network. It also helps the development team test and improve Anemos more effectively.
This document provides a step-by-step guide on how to join the Anemos testnet.
Set up the node
To set up a Testnet node, first download the latest version of Anemos. The Testnet uses the same software as the Mainnet, but it must be configured to connect to the Testnet.
Running Testnet with Anemos Daemon (CLI)
You can also use the Anemos Daemon (CLI) to join the Testnet.
To join the Testnet, you need to explicitly specify the --testnet flag when initializing the node:
./anemos-daemon init --working-dir=~/anemos/testnet --testnetThis command creates your wallet and sets up the working directory at ~/anemos/testnet.
anemos-daemon.exe init --working-dir=%USERPROFILE%\anemos\testnet --testnetThis command creates your wallet and sets up the working directory at C:\Users\<USER_NAME>\anemos\testnet.
Here’s what the flags mean:
--working-dir: Specifies the directory where node data (e.g., blockchain data, configuration files) will be stored.--testnet: Configures the node to connect to the Testnet instead of the Mainnet.
After initializing the node, you can optionally import the latest blockchain data and run the Testnet in pruned mode. This helps you sync faster and reduces storage usage:
./anemos-daemon import --working-dir=~/anemos/testnetanemos-daemon.exe import --working-dir=%USERPROFILE%\anemos\testnetImport is an optional fast-sync step. The default snapshot host (
snapshot.anemos.one)
may not yet be serving a live Testnet snapshot. If import fails, pass
–server-addr <url> to point at a snapshot host you trust, or skip this step entirely
and let the node sync from the network when you start it below.Now, start the node:
./anemos-daemon start --working-dir=~/anemos/testnetanemos-daemon.exe start --working-dir=%USERPROFILE%\anemos\testnetThis command starts your node and connects it to the Anemos Testnet.
Running Testnet with Anemos GUI
You can also run the Testnet using the Anemos GUI. Open a terminal (or command prompt on Windows) and start Anemos GUI with:
./anemos-gui -working-dir=~/anemos/testnet -testnetanemos-gui.exe -working-dir=%USERPROFILE%\anemos\testnet -testnetThe GUI will initialize and connect to the Testnet using the specified working directory.
Obtaining Test Coins
To interact with the Anemos Testnet, you will need test coins (tANM).
These coins have no real-world value but are required for testing transactions,
applications, and validator operations.
Open faucet.anemos.one, paste your testnet address (
tan1…), and click Request tANM. The faucet sends you test coins and shows the
transaction hash with a link to the explorer. There is a short cooldown per address (and per IP)
between requests; the amount per request is a small fixed sum (currently 100,000 tANM), which is
plenty for testing transactions and applications.If you intend to run a validator on the Testnet permanently, you can reach out to the Anemos team to receive stake coins for your validator.