BitBadges Mainnet Validator

Chaind ID	Last Version Tag
bitbadges-1	v16

Service	URL
RPC	https://bitbadges-rpc.linknode.org
API	https://bitbadges-api.linknode.org
gRPC	https://bitbadges-grpc.linknode.org
Resource	https://vault.astrostake.xyz/mainnet/bitbadges
Dashboard	https://www.astrostake.xyz/networks/bitbadges

Installation

1. Install Dependencies

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

2. Install Go

cd $HOME
VER="1.22.3"
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 ~/.bash_profile ] && touch ~/.bash_profile
echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
source $HOME/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin

3. Set Vars

Configuration:

Wallet

Moniker

Port

Generated Code:

Loading...

4. Download Binary

cd $HOME
rm -rf bitbadgeschain
git clone https://github.com/BitBadges/bitbadgeschain.git
cd bitbadgeschain
git checkout v16
make build-linux/amd64
mv build/bitbadgeschain-linux-amd64 /root/go/bin/bitbadgeschaind
bitbadgeschaind version

5. Initialized

bitbadgeschaind init $MONIKER --chain-id $BITBADGES_CHAIN_ID
sed -i \
  -e 's|^chain-id *=.*|chain-id = "bitbadges-1"|' \
  -e 's|^keyring-backend *=.*|keyring-backend = "os"|' \
  -e "s|^node *=.*|node = \"tcp://localhost:${BITBADGES_PORT}657\"|" \
  $HOME/.bitbadgeschain/config/client.toml

6. Download addrbook & genesis

wget -O $HOME/.bitbadgeschain/config/genesis.json https://vault.astrostake.xyz/mainnet/lumera/genesis.json
wget -O $HOME/.bitbadgeschain/config/addrbook.json https://vault.astrostake.xyz/mainnet/lumera/addrbook.json
wget -O $HOME/.bitbadgeschain/config/claims.csv https://raw.githubusercontent.com/LumeraProtocol/lumera-networks/refs/heads/master/mainnet/claims.csv

7. Configure Node

Update app.toml ports

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

Update config.toml ports

sed -i.bak -e "s%:26658%:${BITBADGES_PORT}658%g;
s%:26657%:${BITBADGES_PORT}657%g;
s%:6060%:${BITBADGES_PORT}060%g;
s%:26656%:${BITBADGES_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${BITBADGES_PORT}656\"%;
s%:26660%:${BITBADGES_PORT}660%g" $HOME/.bitbadgeschain/config/config.toml

Configure pruning

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

Set Minimum Gas Fee & Other Parameters

sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0.025ulume"|g' $HOME/.bitbadgeschain/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.bitbadgeschain/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.bitbadgeschain/config/config.toml

8. Create Services

sudo tee /etc/systemd/system/bitbadgeschaind.service > /dev/null <<EOF
[Unit]
Description=bitbadgeschaind Daemon
After=network-online.target
[Service]
User=$USER
ExecStart=$(which bitbadgeschaind) start
Restart=always
RestartSec=3
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF

9. Start Services

sudo systemctl daemon-reload
sudo systemctl enable bitbadgeschaind
sudo systemctl restart bitbadgeschaind && sudo journalctl -u bitbadgeschaind -fo cat

Useful Commands

INFO

For a complete guide to creating a validator, visit our Cheat Sheet & Key Management page. It covers all the necessary commands and crucial steps for securing your keys.

Check logs

sudo journalctl -u bitbadgeschaind -fo cat

Check Sync

curl -sL https://raw.githubusercontent.com/astrostake/scripts/refs/heads/main/cosmos_sync_monitor.sh | bash -s -- --directory $HOME/.bitbadgeschain --public-rpc https://bitbadges-rpc.linknode.org --interval 5

🛡️ Security

To apply a quick security baseline, you can configure your firewall like this:

sudo ufw allow ${BITBADGES_PORT}656/tcp comment 'BITBADGES Node p2p Port'

🔐 For a more secure and maintainable setup, check out our Essentials Guide, including SSH key setup, Fail2Ban protection, and a full VPS hardening checklist.