Local Testnet

For testing or developing purpose, you may want to setup a local testnet.

Single Node Testnet



We use the default home directory for all the following examples

iris init

Initialize the genesis.json file that will help you to bootstrap the network

iris init testing --chain-id=testing

create a key

Create a key to hold your validator account

iris keys add MyValidator

iris add-genesis-account

Add that key into the genesis.app_state.accounts array in the genesis file


this command lets you set the number of coins. Make sure this account has some uiris which is the only staking coin on IRIShub

iris add-genesis-account $(iris keys show MyValidator --address) 150000000uiris

iris gentx

Generate the transaction that creates your validator. The gentxs are stored in ~/.iris/config/gentx/

iris gentx MyValidator 100000000uiris --chain-id=testing 

iris collect-gentxs

Add the generated staking transactions to the genesis file

iris collect-gentxs

iris start

Change the default token denom to uiris

sed -i 's/stake/uiris/g' $HOME/.iris/config/genesis.json

Now it‘s ready to start iris

iris start

iris unsafe-reset-all

You can use this command to reset your node, including the local blockchain database, address book file, and resets priv_validator.json to the genesis state.

This is useful when your local blockchain database somehow breaks and you are not able to sync or participate in the consensus.

iris unsafe-reset-all

iris tendermint

Query the unique node id which can be used in p2p connection, e.g. the seeds and persistent_peers in the config.toml are formatted as <node-id>@ip:26656.

The node id is stored in the node_key.json.

iris tendermint show-node-id

Query the Tendermint Pubkey which is used to identify your validator, and the corresponding private key will be used to sign the Pre-vote/Pre-commit in the consensus.

The Tendermint Key is stored in the priv_validator.json which is required to be backed up once you become a validator.

iris tendermint show-validator

Query the bech32 prefixed validator address

iris tendermint show-address

iris export

Please refer to Export Blockchain State

Multiple Nodes Testnet


Build and Init

# Work from the irishub repo
cd [your-irishub-repo]

# Build the linux binary in ./build
make build-linux

# Quick init a 4-node testnet configs
make testnet-init

The make testnet-init generates config files for a 4-node testnet in the ./build/nodecluster directory by calling the iris testnet command:

$ tree -L 3 build/nodecluster/
├── gentxs
│   ├── node0.json
│   ├── node1.json
│   ├── node2.json
│   └── node3.json
├── node0
│   ├── iris
│   │   ├── config
│   │   └── data
│   └── iriscli
│       ├── key_seed.json
│       └── keys
├── node1
│   ├── iris
│   │   ├── config
│   │   └── data
│   └── iriscli
│       └── key_seed.json
├── node2
│   ├── iris
│   │   ├── config
│   │   └── data
│   └── iriscli
│       └── key_seed.json
└── node3
    ├── iris
    │   ├── config
    │   └── data
    └── iriscli
        └── key_seed.json


make testnet-start

This command creates a 4-node network using the ubuntu:16.04 docker image. The ports for each node are found in this table:

NodeP2P PortRPC Port

To update the binary, just rebuild it and restart the nodes:

make build-linux testnet-start


To stop all the running nodes:

make testnet-stop


To stop all the running nodes and delete all the files in the build/ directory:

make testnet-clean