Skip to content

Latest commit

 

History

History
87 lines (55 loc) · 2.5 KB

GENTX.md

File metadata and controls

87 lines (55 loc) · 2.5 KB

GENTX & HARDFORK INSTRUCTIONS

Install & Initialize

  • Install cantod binary

  • Initialize canto node directory

cantod init <node_name> --chain-id <chain_id>
wget https://github.com/Canto-Network/Canto/raw/main/Mainnet/genesis.json -b $HOME/.cantod/config

Add a Genesis Account

A genesis account is required to create a GENTX

cantod add-genesis-account <address-or-key-name> acanto --chain-id <chain-id>

Create & Submit a GENTX file + genesis.json

A GENTX is a genesis transaction that adds a validator node to the genesis file.

cantod gentx <key_name> <token-amount>acanto --chain-id=<chain_id> --moniker=<your_moniker> --commission-max-change-rate=0.01 --commission-max-rate=0.10 --commission-rate=0.05 --details="<details here>" --security-contact="<email>" --website="<website>"

  • Fork Canto

  • Copy the contents of ${HOME}/.cantod/config/gentx/gentx-XXXXXXXX.json to $HOME/Canto/Mainnet/gentx/<yourvalidatorname>.json

  • Copy the genesis.json file ${HOME}/.cantod/config/genesis.json to $HOME/Canto/Mainnet/Genesis-Files/

  • Create a pull request to the main branch of the repository

Restarting Your Node

You do not need to reinitialize your Canto Node. Basically a hard fork on Cosmos is starting from block 1 with a new genesis file. All your configuration files can stay the same. Steps to ensure a safe restart

  1. Backup your data directory.

  • mkdir $HOME/canto-backup

  • cp $HOME/.cantod/data $HOME/canto-backup/

  1. Remove old genesis
  • rm $HOME/.cantod/genesis.json
  1. Download new genesis
  • wget
  1. Remove old data
  • rm -rf $HOME/.cantod/data
  1. Create a new data directory
  • mkdir $HOME/.cantod/data

If you do not reinitialize then your peer id and ip address will remain the same which will prevent you from needing to update your peers list.

  1. Download the new binary
cd $HOME/Canto
git checkout <branch>
make install
mv $HOME/go/bin/cantod /usr/bin/
  1. Restart your node
  • systemctl restart cantod

Emergency Reversion

  1. Move your backup data directory into your .cantod directory
  • mv HOME/canto-backup/data $HOME/.canto/
  1. Download the old genesis file
  • wget https://github.com/Canto-Network/Canto/raw/main/Mainnet/genesis.json -b $HOME/.cantod/config/
  1. Restart your node
  • systemctl restart cantod