blockchain-node-setup.md

Blockchain Node Setup

1. Install the toolchain:

   sudo apt -y install make build-essential gcc git jq chrony lz4 wget liblz4-tool aria2
   
   #######################
   ## BEGIN: Install Go ##
   #######################
   
   set URL https://golang.org/dl/go1.18.2.linux-amd64.tar.gz
   wget $URL
   sudo tar xzvf (basename $URL) -C /usr/local
   rm (basename $URL)
   
   #####################
   ## END: Install Go ##
   #####################
   
   read -P 'A moniker is a name of your choosing for your node. Enter the moniker: ' MONIKER
   
   ##############################
   ## BEGIN: Select blockchain ##
   ##############################
   
   set PROMPT '1 is for Commercio.network, 2 is for Cosmos Hub, 3 is for Juno, 4 is for Osmosis, 5 is for Sei, and 6'
   set PROMPT "$PROMPT is for Stride. Enter which node you\re setting up: "
   read -P $PROMPT BLOCKCHAIN
   
   switch $BLOCKCHAIN
       case 1
           set DAEMON_NAME commercionetworkd
           set DAEMON_HOME ~/.commercionetwork
       case 2
           set DAEMON_NAME gaiad
           set DAEMON_HOME ~/.gaia
       case 3
           set DAEMON_NAME junod
           set DAEMON_HOME ~/.juno
       case 4
           set DAEMON_NAME osmosisd
           set DAEMON_HOME ~/.osmosisd
       case 5
           set DAEMON_NAME seid
           set DAEMON_HOME ~/.sei
       case 6
           set DAEMON_NAME strided
           set DAEMON_HOME ~/.stride
   end
   
   ############################
   ## END: Select blockchain ##
   ############################
   
   ######################################
   ## BEGIN: Set environment variables ##
   ######################################
   
   printf "\
   
   set MONIKER $MONIKER
   
   # Go
   set -x GOROOT /usr/local/go
   set -x GOPATH ~/go
   set -x GO111MODULE on
   set PATH /usr/local/go/bin ~/go/bin $PATH
   
   # Cosmovisor
   set -x DAEMON_NAME $DAEMON_NAME
   set -x DAEMON_HOME $DAEMON_HOME
   " >> ~/.config/fish/config.fish
   
   source ~/.config/fish/config.fish
   
   ####################################
   ## END: Set environment variables ##
   ####################################

2. Set up the relevant blockchain node by picking the relevant link from the following list.

   If the blockchain node you're interested in isn't listed below, then pick a similar link anyway such as a validator setup link if you're setting up a validator, and follow similar instructions by referring to the blockchain node's official docs.

   If you're running an RPC node, then we recommend keeping state for one more than the number of days required to unbond tokens. This way, queriers can see relevant transactions regarding unstaking while you keep storage costs down.

   • Commercio.network:
     • testnet11k:
       • Validator
   • Cosmos Hub:
     • cosmoshub-4:
       • Full node
   • Juno:
     • juno-1:
       • Archive node
   • Osmosis:
     • osmo-test-4:
       • Validator
     • osmosis-1:
       • Full node
   • Sei:
     • atlantic-1:
       • Validator
     • atlantic-sub-1:
       • Validator
     • atlantic-sub-2:
       • Validator
   • Stride:
     • STRIDE-TESTNET-4:
       • Validator

3. Enable Prometheus:

   sed 's|prometheus = .*|prometheus = true|' -i $DAEMON_HOME/config/config.toml
   sudo systemctl restart cosmovisor

4. Only follow this step on full nodes that must have the API enabled. Enable the API:

   1. In the [api] section of $DAEMON_HOME/config/app.toml, set the enable key's value to true.

   2. Apply changes:

      sudo systemctl restart cosmovisor

5. Only follow this step on servers for validators or sentries. Configure:

   #########################
   ## BEGIN: Disable APIs ##
   #########################
   
   # The first expression disables the REST, gRPC, and gRPC Web APIs. The second enables the REST API for PANIC.
   sed \
       -e 's|enable = true|enable = false|' \
       -e '0,/enable = false/{s|enable = false|enable = true|}' \
       -i $DAEMON_HOME/config/app.toml
   
   #######################
   ## END: Disable APIs ##
   #######################
   
   ##################
   ## BEGIN: Prune ##
   ##################
   
   sed \
       -e 's|pruning = .*|pruning = "custom"|' \
       -e 's|pruning-keep-recent = .*|pruning-keep-recent = "100"|' \
       -e 's|pruning-keep-every = .*|pruning-keep-every = "0"|' \
       -e 's|pruning-interval = .*|pruning-interval = "10"|' \
       -i $DAEMON_HOME/config/app.toml
   
   sed 's|indexer = .*|indexer = "null"|' -i $DAEMON_HOME/config/config.toml
   
   ################
   ## END: Prune ##
   ################
   
   #############################################
   ## BEGIN: Improve performance and security ##
   #############################################
   
   sed \
       -e 's|max_num_inbound_peers = .*|max_num_inbound_peers = 100|' \
       -e 's|max_num_outbound_peers = .*|max_num_outbound_peers = 10|' \
       -e 's|flush_throttle_timeout = .*|flush_throttle_timeout = "100ms"|' \
       -i $DAEMON_HOME/config/config.toml
   
   ###########################################
   ## END: Improve performance and security ##
   ###########################################
   
   sudo systemctl restart cosmovisor