Republic Cheat Sheet and Key Management

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

1. Key Management

Create a New Wallet

republicd keys add $WALLET

Keep the generated seed phrase safe. It is the only way to recover your wallet.

Recover Wallet from Seed Phrase

republicd keys add $WALLET --recover

You will be prompted to enter your seed phrase.

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 $(republicd keys show $WALLET -a) <receiver_wallet_address> <amount><denom> --chain-id $REPUBLIC_CHAIN_ID --gas-prices 2500000000arai --gas-adjustment 1.5 --gas auto -y

Example:

republicd tx bank send $(republicd keys show $WALLET -a) rai1...yyy 1000000arai --chain-id $REPUBLIC_CHAIN_ID --gas-prices 2500000000arai --gas-adjustment 1.5 --gas auto -y

Replace <amount> with the number of tokens and <denom> with the token denomination (e.g., arai).

3. Validator Management

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

Create Validator

Configuration:

Amount

Moniker

Identity

Website

Contact

Details

Commission

Chain

Generated Code:

Loading...

Parameter Explanation:

Parameter	Details
--amount	Tokens self-delegated to the validator. 1000000000000000000arai = 1 RAI
--from	Wallet used for the transaction.
--commission-rate	Initial commission rate.
--commission-max-rate	Maximum allowed commission rate.
--commission-max-change-rate	Max daily commission change.
--min-self-delegation	Minimum tokens for self-delegation.
--pubkey	Validator's public key.
--moniker	Validator nickname.
--identity	Keybase ID for identity verification.
--website	Validator's website URL.
--details	Validator description.
--security-contact	Email for security-related contact.

Edit Validator

republicd tx staking edit-validator \
--moniker "$MONIKER" \
--identity "<new_keybase_id>" \
--website "<new_website>" \
--security-contact "<new_contact_email>" \
--details "<new_description>" \
--commission-rate "0.07" \
--chain-id $REPUBLIC_CHAIN_ID \
--gas-prices 2500000000arai \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Delegate Tokens

republicd tx staking delegate $(republicd keys show $WALLET --bech val -a) <amount>arai \
--chain-id $REPUBLIC_CHAIN_ID \
--gas-prices 2500000000arai \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Withdraw Rewards (Delegator)

republicd tx distribution withdraw-rewards $(republicd keys show $WALLET --bech val -a) \
--chain-id $REPUBLIC_CHAIN_ID \
--gas-prices 2500000000arai \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Withdraw Rewards (Validator Commission)

republicd tx distribution withdraw-rewards $(republicd keys show $WALLET --bech val -a) --commission \
--chain-id $REPUBLIC_CHAIN_ID \
--gas-prices 2500000000arai \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Unbond Tokens

republicd tx staking unbond $(republicd keys show $WALLET --bech val -a) <amount>arai \
--chain-id $REPUBLIC_CHAIN_ID \
--gas-prices 2500000000arai \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Redelegate Tokens

republicd tx staking redelegate $(republicd keys show $WALLET --bech val -a) <destination_validator_address> <amount>arai \
--chain-id $REPUBLIC_CHAIN_ID \
--gas-prices 2500000000arai \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

4. Node Status & Info

Check Sync Status

republicd status 2>&1 | jq .result.sync_info

Check Peer Info

republicd status 2>&1 | jq .result.sync_info.catching_up
republicd status 2>&1 | jq .result.node_info.listen_addr

Show Node ID

republicd tendermint show-node-id

Restart Node

sudo systemctl restart republicd

View Node Logs

sudo journalctl -u republicd -fo 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|no|no_with_veto|abstain> \
--chain-id $REPUBLIC_CHAIN_ID \
--gas-prices 2500000000arai \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

6. Environment Variables

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

export WALLET="wallet"
export MONIKER="YourMoniker"
export REPUBLIC_CHAIN_ID="raitestnet_77701-1"
export REPUBLIC_PORT="14"

Apply the changes with:

source ~/.bash_profile

---

This cheat sheet is provided to streamline Republic validator and wallet management.