Manual Installation
Official Documentation Recommended Hardware: 4 Cores, 16GB RAM, 500GB of storage (NVME)
# 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
Node Name
Wallet
Port
Pruning
custom
Pruning Keep Recent
Pruning Interval
# install go, if needed
cd $HOME
VER="1.22.0"
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 QUICKSILVER_CHAIN_ID="rhye-3"" >> $HOME/.bash_profile
echo "export QUICKSILVER_PORT="37"" >> $HOME/.bash_profile
source $HOME/.bash_profile
# download binary
cd $HOME
rm -rf ~/quicksilver
git clone https://github.com/ingenuity-build/quicksilver
cd quicksilver
git checkout v1.7.6-testnet2
make install
# config and init app
quicksilverd config node tcp://localhost:${QUICKSILVER_PORT}657
quicksilverd config keyring-backend os
quicksilverd config chain-id rhye-3
quicksilverd init "test" --chain-id rhye-3
# download genesis and addrbook
wget -O $HOME/.quicksilverd/config/genesis.json https://server-4.itrocket.net/testnet/quicksilver/genesis.json
wget -O $HOME/.quicksilverd/config/addrbook.json https://server-4.itrocket.net/testnet/quicksilver/addrbook.json
# set seeds and peers
SEEDS="78283975c2bee9b95bbf9408cc974cbab7bfe8ef@quicksilver-testnet-seed.itrocket.net:37656"
PEERS="2aed12a25bfa92e40ccb95c88692735a9488a17e@quicksilver-testnet-peer.itrocket.net:37656"
sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" \
-e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" $HOME/.quicksilverd/config/config.toml
# set custom ports in app.toml
sed -i.bak -e "s%:1317%:${QUICKSILVER_PORT}317%g;
s%:8080%:${QUICKSILVER_PORT}080%g;
s%:9090%:${QUICKSILVER_PORT}090%g;
s%:9091%:${QUICKSILVER_PORT}091%g;
s%:8545%:${QUICKSILVER_PORT}545%g;
s%:8546%:${QUICKSILVER_PORT}546%g;
s%:6065%:${QUICKSILVER_PORT}065%g" $HOME/.quicksilverd/config/app.toml
# set custom ports in config.toml file
sed -i.bak -e "s%:26658%:${QUICKSILVER_PORT}658%g;
s%:26657%:${QUICKSILVER_PORT}657%g;
s%:6060%:${QUICKSILVER_PORT}060%g;
s%:26656%:${QUICKSILVER_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${QUICKSILVER_PORT}656\"%;
s%:26660%:${QUICKSILVER_PORT}660%g" $HOME/.quicksilverd/config/config.toml
# config pruning
sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.quicksilverd/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.quicksilverd/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.quicksilverd/config/app.toml
# set minimum gas price, enable prometheus and disable indexing
sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0.0uqck"|g' $HOME/.quicksilverd/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.quicksilverd/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.quicksilverd/config/config.toml
# create service file
sudo tee /etc/systemd/system/quicksilverd.service > /dev/null <<EOF
[Unit]
Description=Quicksilver node
After=network-online.target
[Service]
User=$USER
WorkingDirectory=$HOME/.quicksilverd
ExecStart=$(which quicksilverd) start --home $HOME/.quicksilverd
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF
# reset and download snapshot
quicksilverd tendermint unsafe-reset-all --home $HOME/.quicksilverd
if curl -s --head curl https://server-4.itrocket.net/testnet/quicksilver/null | head -n 1 | grep "200" > /dev/null; then
curl https://server-4.itrocket.net/testnet/quicksilver/null | lz4 -dc - | tar -xf - -C $HOME/.quicksilverd
else
echo "no snapshot found"
fi
# enable and start service
sudo systemctl daemon-reload
sudo systemctl enable quicksilverd
sudo systemctl restart quicksilverd && sudo journalctl -u quicksilverd -fo cat
Automatic Installation
pruning: | indexer:
source <(curl -s https://itrocket.net/api/testnet/quicksilver/autoinstall/)
Create wallet
# to create a new wallet, use the following command. don’t forget to save the mnemonic
quicksilverd keys add $WALLET
# to restore exexuting wallet, use the following command
quicksilverd keys add $WALLET --recover
# save wallet and validator address
WALLET_ADDRESS=$(quicksilverd keys show $WALLET -a)
VALOPER_ADDRESS=$(quicksilverd keys show $WALLET --bech val -a)
echo "export WALLET_ADDRESS="$WALLET_ADDRESS >> $HOME/.bash_profile
echo "export VALOPER_ADDRESS="$VALOPER_ADDRESS >> $HOME/.bash_profile
source $HOME/.bash_profile
# check sync status, once your node is fully synced, the output from above will print "false"
quicksilverd status 2>&1 | jq
# before creating a validator, you need to fund your wallet and check balance
quicksilverd query bank balances $WALLET_ADDRESS
Node Sync Status Checker
#!/bin/bash
rpc_port=$(grep -m 1 -oP '^laddr = "\K[^"]+' "$HOME/.quicksilverd/config/config.toml" | cut -d ':' -f 3)
while true; do
local_height=$(curl -s localhost:$rpc_port/status | jq -r '.result.sync_info.latest_block_height')
network_height=$(curl -s https://quicksilver-testnet-rpc.itrocket.net/status | jq -r '.result.sync_info.latest_block_height')
if ! [[ "$local_height" =~ ^[0-9]+$ ]] || ! [[ "$network_height" =~ ^[0-9]+$ ]]; then
echo -e "\033[1;31mError: Invalid block height data. Retrying...\033[0m"
sleep 5
continue
fi
blocks_left=$((network_height - local_height))
echo -e "\033[1;33mNode Height:\033[1;34m $local_height\033[0m \033[1;33m| Network Height:\033[1;36m $network_height\033[0m \033[1;33m| Blocks Left:\033[1;31m $blocks_left\033[0m"
sleep 5
done
Create validator
Moniker
Identity
Details
Amount, uqck
Commission rate
Commission max rate
Commission max change rate
Website
quicksilverd tx staking create-validator \
--amount 1000000uqck \
--from $WALLET \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--pubkey $(quicksilverd tendermint show-validator) \
--moniker "test" \
--identity "" \
--website "" \
--details "I love blockchain ❤️" \
--chain-id rhye-3 \
\
-y
Monitoring
If you want to have set up a monitoring and alert system use our cosmos nodes monitoring guide with tenderduty
Security
To protect you keys please don`t share your privkey, mnemonic and follow basic security rules
Set up ssh keys for authentication
You can use this guide to configure ssh authentication and disable password authentication on your server
Firewall security
Set the default to allow outgoing connections, deny all incoming, allow ssh and node p2p port
sudo ufw default allow outgoing
sudo ufw default deny incoming
sudo ufw allow ssh/tcp
sudo ufw allow ${QUICKSILVER_PORT}656/tcp
sudo ufw enable
Delete node
sudo systemctl stop quicksilverd
sudo systemctl disable quicksilverd
sudo rm -rf /etc/systemd/system/quicksilverd.service
sudo rm $(which quicksilverd)
sudo rm -rf $HOME/.quicksilverd
sed -i "/QUICKSILVER_/d" $HOME/.bash_profile