KiiChain - Cheat-sheet

KiiChain Cheat Sheet and Key Management

This guide provides essential commands for managing wallets, nodes, and validators on the KiiChain network. Make sure the environment variables mentioned at the end are correctly configured before using these commands.

1. Key Management

Create a New Wallet

⚠️ Important: Keep the generated seed phrase safe. It is the only way to recover your wallet.

repod keys add $WALLET

Recover Wallet from Seed Phrase

repod keys add $WALLET --recover

List Wallets

repod keys list

Show Wallet Details

repod keys show $WALLET

Delete Wallet

repod keys delete $WALLET

2. Wallet Operations

Check Balance

repod query bank balances $(repod keys show $WALLET -a)

Send Tokens

repod tx bank send $WALLET <recipient_address> <amount>akii --chain-id kiichain_1783-1 --gas auto --gas-adjustment 1.5 --fees 500akii

3. Validator Management

💡 Note: Ensure you have enough tokens for self-delegation and transaction fees before creating a validator.

Create Validator

repod tx staking create-validator \\
  --amount 1000000akii \\
  --from $WALLET \\
  --commission-rate 0.1 \\
  --commission-max-rate 0.2 \\
  --commission-max-change-rate 0.01 \\
  --min-self-delegation 1 \\
  --pubkey $(repod tendermint show-validator) \\
  --moniker "$MONIKER" \\
  --identity "" \\
  --website "" \\
  --details "Your validator description" \\
  --security-contact "your@email.com" \\
  --chain-id kiichain_1783-1 \\
  --gas auto --gas-adjustment 1.5 \\
  --fees 500akii

Edit Validator

repod tx staking edit-validator \\
  --new-moniker "$MONIKER" \\
  --identity "" \\
  --website "" \\
  --details "Your validator description" \\
  --chain-id kiichain_1783-1 \\
  --from $WALLET \\
  --gas auto --gas-adjustment 1.5 \\
  --fees 500akii

Delegate Tokens

repod tx staking delegate $(repod keys show $WALLET --bech val -a) 1000000akii --from $WALLET --chain-id kiichain_1783-1 --gas auto --gas-adjustment 1.5 --fees 500akii

Withdraw Rewards (Delegator)

repod tx distribution withdraw-rewards $(repod keys show $WALLET --bech val -a) --from $WALLET --chain-id kiichain_1783-1 --gas auto --gas-adjustment 1.5 --fees 500akii

Withdraw Rewards (Validator Commission)

repod tx distribution withdraw-rewards $(repod keys show $WALLET --bech val -a) --commission --from $WALLET --chain-id kiichain_1783-1 --gas auto --gas-adjustment 1.5 --fees 500akii

Unbond Tokens

repod tx staking unbond $(repod keys show $WALLET --bech val -a) 1000000akii --from $WALLET --chain-id kiichain_1783-1 --gas auto --gas-adjustment 1.5 --fees 500akii

Redelegate Tokens

repod tx staking redelegate $(repod keys show $WALLET --bech val -a) <destination_validator_address> 1000000akii --from $WALLET --chain-id kiichain_1783-1 --gas auto --gas-adjustment 1.5 --fees 500akii

4. Node Status & Info

Check Sync Status

repod status 2>&1 | jq .SyncInfo

Check Peer Info

curl -s localhost:26657/net_info | jq -r '.result.peers[] | "\\(.node_info.id)@\\(.remote_ip):\\(.node_info.listen_addr | split(":")[2])"'

Show Node ID

repod tendermint show-node-id

Restart Node

sudo systemctl restart repod

View Node Logs

sudo journalctl -u repod -f -o cat

5. Governance

List Proposals

repod query gov proposals

View Proposal Details

repod query gov proposal <proposal_id>

Vote on Proposal

repod tx gov vote <proposal_id> yes --from $WALLET --chain-id kiichain_1783-1 --gas auto --gas-adjustment 1.5 --fees 500akii

6. Environment Variables

💡 Tip: Make sure to set these in your ~/.bash_profile or equivalent shell config.

echo "export WALLET=\"wallet\"" >> $HOME/.bash_profile
echo "export MONIKER=\"your-moniker\"" >> $HOME/.bash_profile
echo "export CHAIN_ID=\"kiichain_1783-1\"" >> $HOME/.bash_profile
source $HOME/.bash_profile

This cheat sheet is provided to streamline KiiChain validator and wallet management. All commands use environment variables for easier management.