# Run a Full Node & Join a Public Network

Once you have installed the required software, you can run a full node, join one of the public networks (TestNet or MainNet) and try out becoming a validator.


Whenever you use undcli to send Txs or query the chain ensure you pass the correct data to the --chain-id and if necessary --node= flags so that you connect to the correct network!

# Contents

# Prerequisites

Before continuing, ensure you have gone through the following docs:

  1. Installing the software

# Initialising a New Node

Once installed, you will need to initialise your node:

und init [your_node_moniker]

[your_node_moniker] can be any identifier you like, but are limited to ASCII characters. For example:

und init MyAwesomeNode

Once initialised, you can edit your configuration in $HOME/.und_mainchain/config/config.toml. See configuration reference for more details on the config file.


the default directory used by und is $HOME/.und_mainchain. This can be changed by passing the global --home= flag to the und command, for example und start --home=$HOME/.und_mainchain_TestNet.

# Genesis

The latest genesis for each network can always be found in their respective Github repos:

# TestNet: https://github.com/unification-com/testnet/latest

# MainNet: https://github.com/unification-com/mainnet/latest

# Download the latest Genesis


Please ensure you download the correct genesis for the network you would like to join! Remember to change the output directory in the command below if you are using something other than the default $HOME/.und_mainchain directory!

To spin up your new node, download the latest genesis.json for the network you would like to join:

# TestNet

curl https://raw.githubusercontent.com/unification-com/testnet/master/latest/genesis.json > $HOME/.und_mainchain/config/genesis.json

# MainNet

curl https://raw.githubusercontent.com/unification-com/mainnet/master/latest/genesis.json > $HOME/.und_mainchain/config/genesis.json

# Get the current Chain ID


You'll need jq installed to run the command below. Use your package manager to install, for example sudo apt install jq on Debian based systems, and sudo yum install jq on CentOS/RedHat systems.

The Chain ID will need to be passed to all undcli commands via the --chain-id flag. The current Chain ID for the network your node is connecting to can easily be found by running:

jq --raw-output '.chain_id' $HOME/.und_mainchain/config/genesis.json

This will output, for example:




which can then be passed to your undcli commands:

undcli query tx FCDFE69F20431B23CF16CAA68C10325EB2E1126FCDF8AD4010CCE927A0808740 --chain-id FUND-Mainchain-TestNet-v7

# Seed Node Peers


Please ensure you get the correct seed node information for the network you would like to join! Remember to change the directory if you are using something other than the default $HOME/.und_mainchain directory!

Your node will need to know at least one seed node in order to join the network and begin P2P communication with other nodes in the network. The latest seed information will always be available at each network's respective Github repo:

# TestNet: https://github.com/unification-com/testnet/blob/master/latest/seed_nodes.md

# MainNet: https://github.com/unification-com/mainnet/blob/master/latest/seed_nodes.md

Edit $HOME/.und_mainchain/config/config.toml, and set the seeds value with a comma separated list of one or more peers. For example, a TestNet seed node may look like:

seeds = "[email protected]on.io:26656"


always check the latest seed node in the respective network's repository - the above example may not always match the actual current seed node!

# Minimum Gas

In order to protect your full node from spam transactions, it is good practice to set the minimum-gas-prices value in $HOME/.und_mainchain/config/app.toml. This should be set as a decimal value in nund, and the recommended value is currently 0.25nund.

# Pruning


If you intend for your node to become a Validator node, you may want to consider also setting pruning = "nothing" in $HOME/.und_mainchain/config/app.toml, or start your node with the --pruning=nothing flag. Be aware that pruning nothing will increase the disk space required considerably.

# Running your node

Now that you have genesis, and some seed nodes, you can run your full node:

und start

You should see that your node connects to some peers, and after a few seconds begins syncing with the network.


undcli status

in a separate terminal should output show that the node is running and connected to your chosen network.

By default, any transactions you send via the undcli command will be sent via your local node (which was started using the und start command, and whose RPC is on tcp://localhost:26656 and only open to localhost).


You can use the --node flag with the undcli command to have it send to a different node instead. Default values for undcli can also be set in $HOME/.und_cli/config/config.toml, or with the undcli config command

# Block Explorer

Our public block explorers can be found at:

# TestNet: https://explorer-testnet.unification.io

# MainNet: https://explorer.unification.io

# TestNet Faucet

Our public TestNet has a faucet which can be used to obtain Test FUND for use exclusively on the TestNet network. You will need an account and its associated address in order to be able to claim Test FUND.

See https://faucet-testnet.unification.io

# Next

Creating and importing accounts and wallets, sending transactions and becoming a Validator

Last Updated: 5/15/2020, 1:49:20 PM