Installation

Chain ID	Version	Custom Port
nillion-chain-testnet-1	0.2.2	55

Official Documentation Recommended Hardware: 16 Cores, 64GB RAM, 1000GB of storage (NVME)

Manual Installation

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

# install go, if needed
cd $HOME
VER="1.20.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

# set vars
echo "export WALLET="wallet"" >> $HOME/.bash_profile
echo "export MONIKER="test"" >> $HOME/.bash_profile
echo "export NILLION_CHAIN_ID="nillion-chain-testnet-1"" >> $HOME/.bash_profile
echo "export NILLION_PORT="55"" >> $HOME/.bash_profile
source $HOME/.bash_profile

# download binary
cd $HOME
rm -rf nilchain
git clone https://github.com/NillionNetwork/nilchain.git
cd nilchain
git checkout v0.2.1
make install
mv $HOME/nilchain $HOME/go/bin/

# config and init app
nilchaind config node tcp://localhost:${NILLION_PORT}657
nilchaind config keyring-backend os
nilchaind config chain-id nillion-chain-testnet-1
nilchaind init "test" --chain-id nillion-chain-testnet-1

# download genesis and addrbook
wget -O $HOME/.nilchain/config/genesis.json https://testnet-files.bonynode.online/nillion/genesis.json
wget -O $HOME/.nilchain/config/addrbook.json https://testnet-files.bonynode.online/nillion/addrbook.json

# set seeds and peers
SEEDS=
PEERS="0fb5ce425197a462a66de015ee5fbbf103835b8a@54.238.14.220:26656,7581c3fc378f1d6013e4f2eaa1e50fc3c25b9524@52.197.82.153:26656,d1a99acbf7139c9cf148357332986bbe7358793b@54.150.188.132:26656"
sed -i -e "s/^seeds *=.*/seeds = \"$SEEDS\"/; s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.nilchain/config/config.toml

# set custom ports in app.toml
sed -i.bak -e "s%:1317%:${NILLION_PORT}317%g;
s%:8080%:${NILLION_PORT}080%g;
s%:9090%:${NILLION_PORT}090%g;
s%:9091%:${NILLION_PORT}091%g;
s%:8545%:${NILLION_PORT}545%g;
s%:8546%:${NILLION_PORT}546%g;
s%:6065%:${NILLION_PORT}065%g" $HOME/.nilchain/config/app.toml

# set custom ports in config.toml file
sed -i.bak -e "s%:26658%:${NILLION_PORT}658%g;
s%:26657%:${NILLION_PORT}657%g;
s%:6060%:${NILLION_PORT}060%g;
s%:26656%:${NILLION_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${NILLION_PORT}656\"%;
s%:26660%:${NILLION_PORT}660%g" $HOME/.nilchain/config/config.toml

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

# set minimum gas price, enable prometheus and disable indexing
sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0.01unil"|g' $HOME/.nilchain/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.nilchain/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.nilchain/config/config.toml

# create service file
sudo tee /etc/systemd/system/nilchaind.service > /dev/null <<EOF
[Unit]
Description=Nillion node
After=network-online.target
[Service]
User=$USER
WorkingDirectory=$HOME/.nilchain
ExecStart=$(which nilchaind) start --home $HOME/.nilchain
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF

# reset and download snapshot
nilchaind tendermint unsafe-reset-all --home $HOME/.nilchain
if curl -s --head curl https://testnet-files.bonynode.online/nillion/snap_nillion.tar.lz4 | head -n 1 | grep "200" > /dev/null; then
  curl https://testnet-files.bonynode.online/nillion/snap_nillion.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.nilchain
    else
  echo no have snap
fi

# enable and start service
sudo systemctl daemon-reload
sudo systemctl enable nilchaind
sudo systemctl restart nilchaind && sudo journalctl -u nilchaind -f

Create Wallet

# to create a new wallet, use the following command. don’t forget to save the mnemonic
nilchaind keys add $WALLET

# to restore exexuting wallet, use the following command
nilchaind keys add $WALLET --recover

# save wallet and validator address
WALLET_ADDRESS_nillion=$(nilchaind keys show $WALLET -a)
VALOPER_ADDRESS_nillion=$(nilchaind keys show $WALLET --bech val -a)
echo "export WALLET_ADDRESS_nillion="$WALLET_ADDRESS_nillion >> $HOME/.bash_profile
echo "export VALOPER_ADDRESS_nillion="$VALOPER_ADDRESS_nillion >> $HOME/.bash_profile
source $HOME/.bash_profile

# check sync status, once your node is fully synced, the output from above will print "false"
nilchaind status 2>&1 | jq 

# before creating a validator, you need to fund your wallet and check balance
nilchaind query bank balances $WALLET_ADDRESS_nillion 

Create Validator

nilchaind tx staking create-validator \
--amount 1000000unil \
--from $WALLET \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--pubkey $(nilchaind tendermint show-validator) \
--moniker "test" \
--identity "" \
--website "" \
--details "I love blockchain 💚" \
--chain-id nillion-chain-testnet-1 \
--gas auto --gas-adjustment 1.4 --gas-prices 0.01unil \
-y

Firewall security

Set the default to allow outgoing connections, deny all incoming, allow ssh and node p2p port

sudo systemctl stop nilchaind
sudo systemctl disable nilchaind
sudo rm -rf /etc/systemd/system/nilchaind.service
sudo rm $(which nilchaind)
sudo rm -rf $HOME/.nilchain
sed -i "/NILLION_/d" $HOME/.bash_profile

Delete Node

sudo systemctl stop nilchaind
sudo systemctl disable nilchaind
sudo rm -rf /etc/systemd/system/nilchaind.service
sudo rm $(which nilchaind)
sudo rm -rf $HOME/.nilchain
sed -i "/NILLION_/d" $HOME/.bash_profile