Validator Node Setup

Official documentation:

Overview | Documentationdocs.airchains.io

Validator configuration requirements:

CPU: 4 cores

Memory: 32GB RAM

Disk: 2 TB NVMe/SSD with bandwidth greater than 1000 MiBps

Network bandwidth: 100 Mbps

Current junctiond version: v0.1.0

Install the dependent environment

Install go

wget -c https://golang.org/dl/go1.22.3.linux-amd64.tar.gz  -O - | sudo tar -xz -C /usr/local

echo "export PATH=$PATH:/usr/local/go/bin" >> /etc/profile && source /etc/profile

go version

Check go version

go version

Install Dependencies

sudo apt update && sudo apt install curl build-essential make gcc jq git -y

Compile the junctiond binary

git clone https://github.com/airchains-network/junction.git
cd junction
git checkout  v0.1.0
make install  # Or execute make build and move the generated binary to your $PATH path

Check version

junctiond version

If you don't want to compile, you can also choose to download the binary file directly:

wget https://github.com/airchains-network/junction/releases/download/v0.1.0/junctiond

Initialization

junctiond init $moniker --chain-id=junction 
junctiond config set client chain-id junction 

Download Genesis File

curl -s https://snapshot.kubenode.xyz/testnet/airchains/genesis.json >  ~/.junction/config/genesis.json

Setting up peer and seed

PEERS=`curl -sS  https://airchains-rpc.kubenode.xyz/net_info  | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}' | sed -z 's|\n|,|g;s|.$||'`


sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.junction/config/config.toml
sed -i.bak -e "s/^seeds *=.*/seeds = \"$seeds\"/" ~/.junction/config/config.toml

Modify the default port (optional)

To prevent port conflicts, you can modify the port and set a port prefix, such as starting with 61:

PREFIX_PORT="61"

sed -i.bak -e "s%:1317%:${PREFIX_PORT}317%g;
s%:8080%:${PREFIX_PORT}080%g;
s%:9090%:${PREFIX_PORT}090%g;
s%:9091%:${PREFIX_PORT}091%g;
s%:8545%:${PREFIX_PORT}545%g;
s%:8546%:${PREFIX_PORT}546%g;
s%:6065%:${PREFIX_PORT}065%g" ~/.junction/config/app.toml

sed -i.bak -e "s%:26658%:${PREFIX_PORT}658%g;
s%:26657%:${PREFIX_PORT}657%g;
s%:6060%:${PREFIX_PORT}060%g;
s%:26656%:${PREFIX_PORT}656%g;
s%:26660%:${PREFIX_PORT}660%g" ~/.junction/config/config.toml

Set the prune parameter to reduce the data size (optional)

pruning="custom" && \
pruning_keep_recent="100" && \
pruning_keep_every="0" && \
pruning_interval="10" && \
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.junction/config/app.toml && \
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.junction/config/app.toml && \
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.junction/config/app.toml && \
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.junction/config/app.toml

Fast Sync from Snapshot

curl -C - -OL https://snapshot.kubenode.xyz/testnet/airchains/airchains_latest.tar.lz4

(This allows you to resume downloading from a breakpoint. If the download is interrupted, just re-execute this command.)

junctiond tendermint unsafe-reset-all --home ~/.junction--keep-addr-book

# Execute after download is complete
lz4 -c -d airchains_latest.tar.lz4 | tar -x -C ~/.junction

Add the program to the systemd daemon

cat > /etc/systemd/system/junctiond.service << EOF
[Unit]
Description=junction daemon
After=network-online.target
[Service]
User=$USER
ExecStart=$(which junctiond) start
Restart=on-failure
RestartSec=3
LimitNOFILE=10000
[Install]
WantedBy=multi-user.target
EOF

Reload the configuration file and add the startup

sudo systemctl daemon-reload && sudo systemctl enable junctiond

Start the validator node

sudo systemctl start junctiond

View logs

sudo journalctl -u junctiond -f

View Sync Status

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

Note that if you have not changed the default port, the RPC port defaults to 26657. If you have changed the port as described in the Change the default port (optional) section, the RPC port defaults to 61657. You can view the port you defined in the ~/.junction/config/config.toml configuration file.

You can visit the block browser to view the latest height. When the current height queried by this command is consistent with the official height, you can create a validator.

Official block explorer:

Switchyard | Airchainstestnet.airchains.io

If you still can't sync properly and have peer connection problems, you can use my addrbook or peer list here.

Peers | Node.Studydocs.node.study

Addrbook | Node.Studydocs.node.study

View currently active peers:

curl -sS  https://airchains-rpc.kubenode.xyz/net_info  | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}' | sed -z 's|\n|,|g;s|.$||'

Edit the configuration file and add the persistent peer list

PEERS="<Put the peer list output from the previous command here>"

sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" ~/.junction/config/config.toml

Then restart junctiond:

sudo systemctl restart junctiond

Check again whether the log is synchronized normally:

sudo journalctl -u junctiond -f

Create validator

When the local height is consistent with the official height, you can create a validator. We need to create a wallet first.

junctiond keys add $WALLET_NAME

Remember to back up the output mnemonic information.

Then copy the wallet address and go here to get faucet.

FAUCETME | AIRCHAINSairchains.faucetme.pro

Execute the create operation

junctiond tx mstaking create-validator --node tcp://localhost:26657  \
        --amount=1000000amf \
        --pubkey=$(junctiond tendermint show-validator) \
        --moniker=$YOUR_NODE_NAME \
        --chain-id=junction  \
        --commission-rate=0.05 \
        --commission-max-rate=0.10 \
        --commission-max-change-rate=0.01 \
        --from=$WALLET_NAME \
        --gas 500000 \
        --fees 500amf

(1000000amf is 1 token)

Optional parameters:

--identity  # Validator logo, which can be created from https://keybase.io/
--website=  # Your website link
--security-contact  # Contact Email

If created successfully, you can find your validator name in the block browser:

https://testnet.airchains.io/validatorstestnet.airchains.io

Useful commands

Stake more tokens to a validator

junctiond tx staking delegate <Validator Address> 1000000amf --from <WALLET_NAME> -y --fees 500amf --gas 500000

(1000000amf is 1 coin, modify it according to your needs, and run junctiond tendermint show-validator to view the validator address)

Unjail

junctiond  tx slashing unjail  --from <WALLET_NAME> --gas auto

Vote

junctiond tx gov vote <Proposal ID> yes --from <WALLET_NAME> --chain-id junction  --gas=auto  --fees 5000amf  -y