Republic AI Cheat Sheet and Key Management

This guide provides essential commands for managing wallets, nodes, and validators on the Republic AI 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.
republicd keys add $WALLET

Recover Wallet from Seed Phrase

republicd keys add $WALLET --recover

List Wallets

republicd keys list

Show Wallet Details

republicd keys show $WALLET

Delete Wallet

republicd keys delete $WALLET

2. Wallet Operations

Check Balance

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

Send Tokens

republicd tx bank send $WALLET <recipient_address> <amount>arai --chain-id republic_77701-1 --gas auto --gas-adjustment 1.5 --fees 500arai

3. Validator Management

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

Create Validator

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

Edit Validator

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

Delegate Tokens

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

Withdraw Rewards (Delegator)

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

Withdraw Rewards (Validator Commission)

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

Unbond Tokens

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

Redelegate Tokens

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

4. Node Status & Info

Check Sync Status

republicd 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

republicd tendermint show-node-id

Restart Node

sudo systemctl restart republicd

View Node Logs

sudo journalctl -u republicd -f -o cat

5. Governance

List Proposals

republicd query gov proposals

View Proposal Details

republicd query gov proposal <proposal_id>

Vote on Proposal

republicd tx gov vote <proposal_id> yes --from $WALLET --chain-id republic_77701-1 --gas auto --gas-adjustment 1.5 --fees 500arai

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=\"republic_77701-1\"" >> $HOME/.bash_profile
source $HOME/.bash_profile

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