Comment on page
Testnet User Guide
Qtum Testnet offers a public blockchain for testing and development. Free QTUM Testnet coins are available from a faucet and users can test transactions, staking, smart contract creation and operations, QRC20 transactions, etc. Testnet is a separate blockchain from Mainnet. It has different blocks, different transactions, and different coins, but the operation, protocols and specifications are identical to Mainnet (unless new features are being introduced on Testnet).
The Qtum Core wallet application can be set to run on Testnet with the command line parameter "
-testnet" on startup. A Testnet wallet works identically to a Mainnet wallet except it will use the \Qtum\testnet3 data directory and default port 13888. An additional test mode "regtest" is described below.
Qtum Testnet Faucet
Select the network (Testnet or Mainnet) before restoring from a key file and entering the password.
You can launch the wallet on Testnet by using the "
-testnet" command line parameter on startup.
The Qtum Testnet data directories are:
- On macOS/OS X: ~/Library/Application Support/Qtum/testnet3
- On Linux: ~/.qtum/testnet3
- On Windows: %APPDATA%\Qtum\testnet3
Using Apple macOS, to launch the qtum-qt GUI wallet on Testnet use Terminal and change directory to the Qtum app and launch the wallet with the
--testnetparameter, using these commands:
Using Linux, launch the wallet with "
./qtumd -testnet" from the bin directory. The command from the home directory is
The same approach can be used to launch qtumd (the server wallet), using Terminal with change directory to navigate to the bin directory and launch qtumd on Testnet:
For qtumd use the Command Line Interface (CLI) qtum-cli to give commands, and for the Testnet wallet use the "
-testnet" parameter. Here the "
getblockchaininfo" command is used to verify Testnet:
./qtum-cli -testnet getblockchaininfo
The Qtum Windows installation includes Startup shortcuts for Mainnet and Testnet (the Testnet shortcut automatically invokes the "
-testnet" parameter). To launch Testnet on windows for the qtum-qt GUI wallet, click the Testnet app on the Start menu:
Launching qtum-qt for Testnet
To run qtumd for Testnet on Windows, open a command prompt window ("Command Prompt"), change directories to (on 64-bit Windows) C:\Program Files\Qtum\daemon and launch with the command
To use the Command Line Interface, open another Command Prompt window, change directories to Program Files/Qtum/daemon, and enter the commands for qtum-cli with the "
-testnet" prefix. For example, to confirm Testnet with
qtum-cli.exe -testnet getblockchaininfo:
qtum-cli.exe -testnet getblockchaininfo
Another way to launch the Core wallet on Testnet is to include "
testnet=1" in the configuration file "qtum.conf". This file should be located in the Qtum Mainnet data directory, and when the wallet launches it will read the configuration file and startup on Testnet:
(here the configuration file is renamed "qtum.conf.txt" for editing and renamed "qtum.conf" after)
Regression Test (regtest) is another test blockchain that runs as local blockchain. regtest can be run in a Docker container (https://github.com/qtumproject/documents/blob/master/en/Launch-Qtum-with-Docker.md). To run the Core wallet for regtest on a desktop or server, use the "
-regtest" parameter to launch as shown in the examples above.
qtum-qt on regtest, mining two blocks a minute
A typical sequence after regtest is launched is to manually create blocks (using the "
generate" command) and then run tests using transactions created:
regtest wallets use the /Qtum/regtest or \Qtum\regtest data directory, have default port 23888, and will be generating Proof of Work blocks with block rewards of 20,000 QTUM for the first 5,000 blocks.
- 1.If your new or updated wallet is having trouble making peer connections for Testnet, try the "
addnode" command with the peers below. The correct response is "null" for qtum-qt or nothing for qtumd, and then the wallet will try for the next few minutes to make the peer connections. Enter one or more of these commands:
addnode 220.127.116.11:13888 add
addnode 18.104.22.168:13888 add
addnode 22.214.171.124:13888 add
addnode 126.96.36.199:13888 add
addnode 188.8.131.52:13888 add
-testnet addnode 184.108.40.206:13888 add
- 1.On the Web Wallet see "Restore from key file failed. Maybe the password is not correct"
In switching between Mainnet and Testnet with the Web Wallet (Settings – Network), switch networks before loading the key file and entering the password.
- 1.The Testnet Faucet gives "You can only request tokens once every 24 hours" on first use or > 24 hours after the previous use.
Click the address bar checkmark button several times until the green confirmation bar appears: