Testnet User Guide
Last updated
Last updated
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.
Explorer
Older Explorer
Get free Testnet QTUM, once every 24 hours
Qtum Testnet Faucet
Select Settings – Network – Testnet
Select the network (Testnet or Mainnet) before restoring from a key file and entering the password.
Download and install the Qtum Core wallet for Mac, Linux or Windows from or for all versions from . See the user documentation for wallets at
Launch the wallet on Testnet
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 --testnet parameter, using these commands:
Using Linux, launch the wallet with "./qtumd -testnet" from the bin directory. The command from the home directory is ~/qtum/qtum-0.17.6/bin/./qtum-qt -testnet
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:
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:
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 qtumd.exe -testnet:
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:
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:
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.
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:
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.
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:
./Qtum-Qt --testnet
~/qtum/qtum-0.17.6/bin/./qtum-qt -testnet
./qtumd -testnet
./qtum-cli -testnet getblockchaininfo
Launching qtum-qt for Testnet
qtumd.exe -testnet
qtum-cli.exe -testnet getblockchaininfo
(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 (). 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
generate 600
-testnet addnode 47.89.255.216:13888 add
