Installation guide [ENG]

Installation

Update the packages

sudo apt update && sudo apt upgrade -y
sudo apt install curl -y

Install GO

wget -O go1.18.linux-amd64.tar.gz https://go.dev/dl/go1.18.linux-amd64.tar.gz
rm -rf /usr/local/go && tar -C /usr/local -xzf go1.18.linux-amd64.tar.gz && rm go1.18.linux-amd64.tar.gz
cat <<'EOF' >> $HOME/.bash_profile
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin
EOF
. $HOME/.bash_profile
cp /usr/local/go/bin/go /usr/bin
go version

Install jq

sudo apt-get update && apt-get install -y jq

Install Iris

you can see the current version [in the Iris Docs] and in the GitHub [Releases]. Instructions about How to upgrade you can find [here]

apt install git -y
git clone https://github.com/irisnet/irishub
cd irishub
git checkout v1.3.0
git pull origin v1.3.0
sudo apt-get install gcc g++ make
make install
. $HOME/.bash_profile
# cp $HOME/go/bin/iris /usr/local/bin
# cp $HOME/go/bin/iris /usr/local/sbin
iris version --long
iris version

Entering variables

Iris_moniker=<Your_node_name>
echo $Iris_moniker
echo 'export Iris_moniker='\"${Iris_moniker}\" >> $HOME/.bash_profile

Iris_wallet=<Your_wallet_name>
echo $Iris_wallet
echo 'export Iris_wallet='\"${Iris_wallet}\" >> $HOME/.bash_profile

chainName=irishub-1
echo $chainName
echo 'export chainName='\"${chainName}\" >> $HOME/.bash_profile
. $HOME/.bash_profile

Initialize node configurations

iris init --chain-id=$chainName $Iris_moniker

Download mainnet public config.toml and genesis.json

curl -o ~/.iris/config/config.toml https://raw.githubusercontent.com/irisnet/mainnet/master/config/config.toml
curl -o ~/.iris/config/genesis.json https://raw.githubusercontent.com/irisnet/mainnet/master/config/genesis.json

Since we replaced config.toml, you need to enter your moniker!

sed -i.bak -e "s/^moniker *=.*/moniker = \"$Iris_moniker\"/" $HOME/.iris/config/config.toml

Create a service file

sudo tee <<EOF >/dev/null /etc/systemd/system/irisd.service
[Unit]
Description=iris Cosmos daemon
After=network-online.target

[Service]
User=$USER
ExecStart=/root/go/bin/iris start --log_level=info
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Comment out the line log_level = "info"

sed -i.bak 's/^log_level/# log_level/' $HOME/.iris/config/config.toml

Insert peers and seeds. You can get them from [here]:

SEEDS="[e-mail]:26656,[e-mail]:26656"
PEERS="fcc1d9bc43163b20ce5163cf41a302b33f25375f@34.82.96.8:26656,fdc0406afdd3acc63f74f5439e09104f663a7c1f@44.241.177.178:26656,090bcbe5302e6104821a96c4899912870db04cb9@52.11.128.123:26656,83b3f989f3ce089afdf733f8aa06e792d7e00c08@3.34.6.30:26656,87f18756b93d835c59fe5ce2a8da51858837eb5b@54.180.15.28:26656,90e48220190b16cad95145b6213d512d703e5617@138.197.158.189:26656,7fad2da10c41b0c1e3c2ce6e708f7fa817b5e19d@135.181.56.26:46656,[e-mail]:26656,895d5a5009d042108783a6aeb0991c5186a46617@144.76.96.47:26656,40821d0ade83d582b29d748f37ecf7bef0a823d0@66.42.116.195:26656,f4af63df2f5c63428be776e56ffc2899fa47afdf@47.101.160.78:26656,08e2f9453541b104df84efa68ab2f0d242eb829b@176.9.47.69:26656,db3dacf404840e067b2f59e304cb2b6662ec0cea@173.212.212.252:26656,87525da8c830da2c3a861638a77f601278efd353@185.181.103.142:26656,4ac6200974d3fd80a8e49d145a2c254ed37a9b9a@159.69.106.156:26656,4e02a4b4f4350ea2b770cd03dc41fedcadb13176@159.69.55.206:26656,63f5646b5f9ce927241383a091b60f797796588f@143.110.240.198:26656,84cc32adca3986b35953886ad075431d318a98b5@52.214.130.28:46656,5387e8f13cee43b47526d2d6a9d8ee65b14e4b8f@161.97.187.139:26656"
sed -i.bak -e "s/^seeds *=.*/seeds = \"$SEEDS\"/; s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.iris/config/config.toml

Set minimum-gas-prices

sed -i "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.0001uiris\"/;" $HOME/.iris/config/app.toml

Synchronization using State Sync (recommended)

Official guide is [here]

And here is the guide [from ping.pub]

So we should Modify the config.toml with the data from these sources. Open config by nano:

nano $HOME/.iris/config/config.toml

When you paste the data into config.toml it should look like this:

[statesync]
enable = true
rpc_servers = "http://34.82.96.8:26657,http://34.77.68.145:26657"
trust_height = 14718000
trust_hash = "9FB190795F774BD566D768335A39C67BD5C677F8B6C93E9A2C3BCD65CFC3C034"
trust_period = "168h0m0s"
# THAT'S AN EXAMPLE!!!!!!!

Start the node

iris unsafe-reset-all
sudo systemctl enable irisd
sudo systemctl daemon-reload
sudo systemctl restart irisd
echo 'Node status:'$(sudo service irisd status | grep active)

Logs

journalctl -u irisd -f
# Or
journalctl -u irisd -f --output cat

Check your node status

curl localhost:26657/status
curl localhost:26657/status | jq '.result.sync_info'

Create the wallet

iris keys add $Iris_wallet

Send the validator creating transaction:

iris tx staking create-validator \
    --pubkey=$(iris tendermint show-validator) \
    --moniker=$Iris_moniker \
    --amount=<amount-to-be-delegated, e.g. 10000iris> \
    --min-self-delegation=1 \
    --commission-max-change-rate=0.1 \
    --commission-max-rate=0.1 \
    --commission-rate=0.1 \
    --gas=auto \
    --fees=0.6iris \
    --chain-id=$chainName \
    --from=$Iris_wallet

Useful Commands

Start. Restart.

sudo systemctl enable irisd
sudo systemctl daemon-reload
sudo systemctl restart irisd
echo 'Node status:'$(sudo service irisd status | grep active)

Logs

journalctl -u irisd -f

Status of the node

curl localhost:26657/status

Sync options only

curl localhost:26657/status | jq '.result.sync_info'

iris status | jq .sync_info.catching_up

Find out your node_id

curl localhost:26657/status | jq '.result.node_info.id'

See if your validator has tombstoned

iris query slashing signing-info $(iris tendermint show-validator)

How to edit your validator

iris tx staking edit-validator \
    --moniker=$Iris_moniker \
    --gas=auto \
    --fees=0.6iris \
    --chain-id=irishub-1 \
    --from=$Iris_wallet \
    --identity=<your_identity> \
    --details="<your details>"

Balance

iris q bank balances <iris1...your..wallet...>