Structs

For Ubuntu 22.04 or later. The node listens on ports starting with your port prefix (e.g. 26657 becomes 29657), so several nodes can share a server.

1. 01Install tools

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y curl git wget jq make gcc build-essential lz4 zstd tmux htop unzip

   Copy

2. 02Install Go

   cd $HOME
   VER="<go-version>"
   wget "https://golang.org/dl/go$VER.linux-amd64.tar.gz"
   sudo rm -rf /usr/local/go
   sudo tar -C /usr/local -xzf "go$VER.linux-amd64.tar.gz"
   rm "go$VER.linux-amd64.tar.gz"
   [ ! -f $HOME/.bash_profile ] && touch $HOME/.bash_profile
   echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> $HOME/.bash_profile
   source $HOME/.bash_profile
   mkdir -p $HOME/go/bin
   go version

   Copy

3. 03Build the binary

   cd $HOME
   rm -rf structsd
   git clone https://github.com/playstructs/structsd.git structsd
   cd structsd
   git checkout <version>
   make install
   structsd version --long | grep -E '^(version|commit):'

   Copy

4. 04Install Cosmovisor

   go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@latest
   DAEMON_HOME=$HOME/.structs DAEMON_NAME=structsd cosmovisor init $HOME/go/bin/structsd

   Copy

5. 05Create the service

   sudo tee /etc/systemd/system/structsd.service > /dev/null << EOF
   [Unit]
   Description=Structs node
   After=network-online.target
   
   [Service]
   User=$USER
   ExecStart=$(which cosmovisor) run start
   WorkingDirectory=$HOME/.structs
   Restart=on-failure
   RestartSec=10
   LimitNOFILE=65535
   Environment="DAEMON_HOME=$HOME/.structs"
   Environment="DAEMON_NAME=structsd"
   Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=true"
   Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
   Environment="UNSAFE_SKIP_BACKUP=true"
   Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:$HOME/.structs/cosmovisor/current/bin"
   
   [Install]
   WantedBy=multi-user.target
   EOF
   sudo systemctl daemon-reload
   sudo systemctl enable structsd

   Copy

6. 06Set variables

   echo 'export WALLET="wallet"' >> $HOME/.bash_profile
   echo 'export MONIKER="Your-Moniker"' >> $HOME/.bash_profile
   echo 'export STRUCTS_CHAIN_ID="<chain-id>"' >> $HOME/.bash_profile
   echo 'export STRUCTS_PORT="29"' >> $HOME/.bash_profile
   source $HOME/.bash_profile

   Copy

7. 07Initialize the node

   structsd init "$MONIKER" --chain-id $STRUCTS_CHAIN_ID --home $HOME/.structs
   structsd config set client chain-id $STRUCTS_CHAIN_ID
   structsd config set client keyring-backend os
   structsd config set client node tcp://localhost:$STRUCTS_PORT657

   Copy

8. 08Custom ports

   sed -i.bak -e "s%:1317%:$STRUCTS_PORT317%g;
   s%:8080%:$STRUCTS_PORT080%g;
   s%:9090%:$STRUCTS_PORT090%g;
   s%:9091%:$STRUCTS_PORT091%g;
   s%:8545%:$STRUCTS_PORT545%g;
   s%:8546%:$STRUCTS_PORT546%g" $HOME/.structs/config/app.toml
   sed -i.bak -e "s%:26658%:$STRUCTS_PORT658%g;
   s%:26657%:$STRUCTS_PORT657%g;
   s%:6060%:$STRUCTS_PORT060%g;
   s%:26656%:$STRUCTS_PORT656%g;
   s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):$STRUCTS_PORT656\"%;
   s%:26660%:$STRUCTS_PORT660%g" $HOME/.structs/config/config.toml

   Copy

9. 09Minimum gas price

   sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0ualpha\"|" $HOME/.structs/config/app.toml

   Copy

10. 10Pruning

    sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.structs/config/app.toml
    sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.structs/config/app.toml
    sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.structs/config/app.toml

    Copy

11. 11Disable the indexer

    sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.structs/config/config.toml

    Copy

12. 12Start the node

    sudo systemctl restart structsd && sudo journalctl -fu structsd -o cat

    Copy

13. 13Check sync

    curl -s localhost:$STRUCTS_PORT657/status | jq .result.sync_info

    Copy