Join our telegram
Join our discord
Visit our website
Deploy your VPS using our referral link to get 20€ bonus
Deploy your VPS using our referral link to get 100$ free bonus for 60 days
Deploy your VPS using our referral link to get 100$ free bonus
Official documentation:
Explorer:
To set up monitoring for your validator node navigate to Set up monitoring and alerting for canine validator
To migrate your validator to another machine read Migrate your validator to another machine
Like any Cosmos-SDK chain, the hardware requirements are pretty modest.
- 4x CPUs; the faster clock speed the better
- 8GB RAM
- 100GB of storage (SSD or NVME)
- Permanent Internet connection (traffic will be minimal during testnet; 10Mbps will be plenty - for production at least 100Mbps is expected)
- 8x CPUs; the faster clock speed the better
- 64GB RAM
- 1TB of storage (SSD or NVME)
- Permanent Internet connection (traffic will be minimal during testnet; 10Mbps will be plenty - for production at least 100Mbps is expected)
You can setup your canine fullnode in few minutes by using automated script below. It will prompt you to input your validator node name!
wget -O jackal.sh https://raw.githubusercontent.com/kj89/testnet_manuals/main/jackal/jackal.sh && chmod +x jackal.sh && ./jackal.sh
You can follow manual guide if you better prefer setting up node manually
When installation is finished please load variables into system
source $HOME/.bash_profile
Next you have to make sure your validator is syncing blocks. You can use command below to check synchronization status
canined status 2>&1 | jq .SyncInfo
You can state sync your node in minutes by running commands below
N/A
To create new wallet you can use command below. Don’t forget to save the mnemonic
canined keys add $WALLET
(OPTIONAL) To recover your wallet using seed phrase
canined keys add $WALLET --recover
To get current list of wallets
canined keys list
Add wallet and valoper address into variables
JACKAL_WALLET_ADDRESS=$(canined keys show $WALLET -a)
JACKAL_VALOPER_ADDRESS=$(canined keys show $WALLET --bech val -a)
echo 'export JACKAL_WALLET_ADDRESS='${JACKAL_WALLET_ADDRESS} >> $HOME/.bash_profile
echo 'export JACKAL_VALOPER_ADDRESS='${JACKAL_VALOPER_ADDRESS} >> $HOME/.bash_profile
source $HOME/.bash_profile
You can buy JKL on https://frontier.osmosis.zone
Before creating validator please make sure that you have at least 1 jkl (1 jkl is equal to 1000000 ujkl) and your node is synchronized
To check your wallet balance:
canined query bank balances $JACKAL_WALLET_ADDRESS
If your wallet does not show any balance than probably your node is still syncing. Please wait until it finish to synchronize and then continue
To create your validator run command below
canined tx staking create-validator \
--amount 1000000ujkl \
--from $WALLET \
--commission-max-change-rate "0.01" \
--commission-max-rate "0.2" \
--commission-rate "0.07" \
--min-self-delegation "1" \
--pubkey $(canined tendermint show-validator) \
--moniker $NODENAME \
--chain-id $JACKAL_CHAIN_ID
To protect you keys please make sure you follow basic security rules
Good tutorial on how to set up ssh keys for authentication to your server can be found here
Start by checking the status of ufw.
sudo ufw status
Sets the default to allow outgoing connections, deny all incoming except ssh and 26656. Limit SSH login attempts
sudo ufw default allow outgoing
sudo ufw default deny incoming
sudo ufw allow ssh/tcp
sudo ufw limit ssh/tcp
sudo ufw allow ${JACKAL_PORT}656,${JACKAL_PORT}660/tcp
sudo ufw enable
To monitor and get alerted about your validator health status you can use my guide on Set up monitoring and alerting for canine validator
This script will help you to estimate how much time it will take to fully synchronize your node
It measures average blocks per minute that are being synchronized for period of 5 minutes and then gives you results
wget -O synctime.py https://raw.githubusercontent.com/kj89/testnet_manuals/main/jackal/tools/synctime.py && python3 ./synctime.py
[[ $(canined q staking validator $JACKAL_VALOPER_ADDRESS -oj | jq -r .consensus_pubkey.key) = $(canined status | jq -r .ValidatorInfo.PubKey.value) ]] && echo -e "\n\e[1m\e[32mTrue\e[0m\n" || echo -e "\n\e[1m\e[31mFalse\e[0m\n"
canined q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
curl -sS http://localhost:${JACKAL_PORT}657/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
Check logs
journalctl -fu canined -o cat
Start service
sudo systemctl start canined
Stop service
sudo systemctl stop canined
Restart service
sudo systemctl restart canined
Synchronization info
canined status 2>&1 | jq .SyncInfo
Validator info
canined status 2>&1 | jq .ValidatorInfo
Node info
canined status 2>&1 | jq .NodeInfo
Show node id
canined tendermint show-node-id
List of wallets
canined keys list
Recover wallet
canined keys add $WALLET --recover
Delete wallet
canined keys delete $WALLET
Get wallet balance
canined query bank balances $JACKAL_WALLET_ADDRESS
Transfer funds
canined tx bank send $JACKAL_WALLET_ADDRESS <TO_JACKAL_WALLET_ADDRESS> 10000000ujkl
canined tx gov vote 1 yes --from $WALLET --chain-id=$JACKAL_CHAIN_ID
Delegate stake
canined tx staking delegate $JACKAL_VALOPER_ADDRESS 10000000ujkl --from=$WALLET --chain-id=$JACKAL_CHAIN_ID --gas=auto
Redelegate stake from validator to another validator
canined tx staking redelegate <srcValidatorAddress> <destValidatorAddress> 10000000ujkl --from=$WALLET --chain-id=$JACKAL_CHAIN_ID --gas=auto
Withdraw all rewards
canined tx distribution withdraw-all-rewards --from=$WALLET --chain-id=$JACKAL_CHAIN_ID --gas=auto
Withdraw rewards with commision
canined tx distribution withdraw-rewards $JACKAL_VALOPER_ADDRESS --from=$WALLET --commission --chain-id=$JACKAL_CHAIN_ID
Edit validator
canined tx staking edit-validator \
--moniker=$NODENAME \
--identity=<your_keybase_id> \
--website="<your_website>" \
--details="<your_validator_description>" \
--chain-id=$JACKAL_CHAIN_ID \
--from=$WALLET
Unjail validator
canined tx slashing unjail \
--broadcast-mode=block \
--from=$WALLET \
--chain-id=$JACKAL_CHAIN_ID \
--gas=auto
This commands will completely remove node from server. Use at your own risk!
sudo systemctl stop canined
sudo systemctl disable canined
sudo rm /etc/systemd/system/canine* -rf
sudo rm $(which canined) -rf
sudo rm $HOME/.canine* -rf
sudo rm $HOME/canine -rf
sed -i '/JACKAL_/d' ~/.bash_profile