Skip to main content

Run DO Testnet Node

The test network differs from the official network mainly in config.json. To run a test node, download the testnet package and replace or edit the configuration file.

Download Testnet Program and config.json​

Download the testnet package and the matching config.json before starting.

VersionDownloadNotes
v3.4.0don_v3.4.0_aeef62d_testnet.zipLatest testnet package on the page
v3.2.0don_v3.2.0_9ebacb4_testnet.zip
v3.1.0don_v3.1.0_6fdcaa4_testnet.zip
v3.0.0don_v3.0.0_c1ddae0_testnet.zip
v2.11.0don_v2.11.0_44ac885_testnet.zip
v2.10.0don_v2.10.0_2620f01_testnet.zip
v2.9.0don_v2.9.0_d8e96f2_testnet.zip
v2.8.0don_v2.8.0_f139d8f_testnet.zip
v2.7.0don_v2.7.0_40a440a_testnet.zip
v2.6.0don_v2.6.0_732c24c_testnet.zip
v2.5.0don_v2.5.0_c2bfdda_testnet.zip
v2.4.0don_v2.4.0_767e36a_testnet.zip
v2.3.0don_v2.3.0_cb089c7_testnet.zip
v2.2.1don_v2.2.1_9443001_testnet.zip
v2.2.0don_v2.2.0_8f7e317_testnet.zip
v2.1.0don_v2.1.0_785ad2f_testnet.zip
v2.0.2don_v2.0.2_42323c1_testnet.zip
v2.0.0don_v2.0.0_019d77a_testnet.zipOpen ports 22288 and 22287

Latest ledger data:

Run DO Testnet Node​

If the package has already been extracted to the server, you can skip the first step.

  1. Download the testnet package and put it in a directory with read, write, and execute permissions.
wget https://fastcdn.donetwork.io/testnet/don_v2.5.0_c2bfdda_testnet.zip
  1. Unzip the package.
unzip don_v2.5.x_xxxxx_testnet.zip
tips

If unzip is not installed, install it first.

sudo apt-get update
sudo apt-get install unzip
sudo dnf install unzip
sudo yum install unzip
  1. Grant execution permission.
chmod +x don_v2.5.x_xxxx_testnet
  1. Run the program.
./don_v2.5.x_xxxx_testnet -m

The -m parameter enables the menu. Press 0 to exit the current program.

  1. Check the generated directories and files in the current directory, then edit config.json.

Modify or Replace config.json​

There are two common ways to configure a test node.

Replace config.json​

  1. Download the prepared config.json.
  2. Open security group ports 22288 and 22287.
  3. Restart the node and check whether block height starts increasing.

Modify config.json​

Update the IP address and port values in config.json.

{
  "http_callback": {
    "ip": "192.168.1.123",
    "path": "/donetServer/app/syncMessage",
    "port": 6061
  },
  "http_port": 22288,
  "info": {
    "logo": "",
    "name": ""
  },
  "ip": "",
  "log": {
    "console": false,
    "level": "off",
    "path": "./logs"
  },
  "rpc": true,
  "server": [
    "54.177.31.10",
    "54.176.251.137"
  ],
  "server_port": 22287,
  "version": "1.0.14"
}

Notes:

  • http_callback configures the RPC callback service.
  • http_port is the RPC port and should be 22288.
  • ip must be the server's public IP.
  • log controls log output.
  • rpc enables the RPC service.
  • server defines the peer nodes used for synchronization.
  • server_port is the synchronization port and should be 22287.
  • version is the current program version.

The test network and official network must use different ports. If the ports are the same, the node may sync official data by mistake.

Get TDO Coins​

  1. Open the faucet page and request test TDO.
  2. Enter your node wallet address.
  3. If the transfer is delayed, wait a few minutes and check again.
  4. Confirm the receipt in the wallet or block explorer.
  5. After the funds arrive, continue with staking and investment.

Stake​

Press 2 to enter the stake interface.

Enter the stake amount. The minimum stake amount is 20000.

stake addr: 0x65Aa2da93b3880Ee370DA96c5Ef04b7638cC7825
Please enter the amount to stake:
20000

Invest​

Press 4 to enter the investment interface and enter your address.

AddrList:
0x65Aa2da93b3880Ee370DA96c5Ef04b7638cC7825 [default]
Please enter your addr:
0x65Aa2da93b3880Ee370DA96c5Ef04b7638cC7825

Enter the target address.

Please enter the addr you want to invest to:
0x65Aa2da93b3880Ee370DA96c5Ef04b7638cC7825

Enter the investment amount. The minimum investment amount is 1500.

Please enter the amount to invest:
1500

Enter the investment type. The default is 0, which means network investment.

Please enter invest type: (0: NetLicence)
0

After these steps, the test node can be used for transaction signing, contract deployment, and development testing.

Questions​

What should I do if I sync official data?​

Change the ports in config.json, delete the synced block data, restart the program, and resync.

rm -rf data.db

What should I do if the balance does not change?​

Check whether the node has synchronized to the latest block height, then request the faucet again.

What should I do if the data is not synchronized?​

Check whether the server can reach the external network.

Check whether ports 22288 and 22287 are open.

Check whether the ip field in config.json contains the public IP address.

How can I view node information?​

Open the browser and visit:

http://your-public-ip:22288/info