Local Testnet

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

Single Node Testnet

Requirements:

• Install iris

TIP

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

TIP

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

Requirements:

• Install iris
• Install jq
• Install docker
• Install docker-compose

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/
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

Start

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:

Node	P2P Port	RPC Port
irisnode0	26656	26657
irisnode1	26659	26660
irisnode2	26661	26662
irisnode3	26663	26664

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

make build-linux testnet-start

Stop

To stop all the running nodes:

make testnet-stop

Clean

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

make testnet-clean