Gitopia Mainnet - Cheat-sheet

Gitopia Mainnet Cheat Sheet and Key Management

This guide provides essential commands for managing wallets, nodes, and validators on the Gitopia Mainnet 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.

gitopiad keys add $WALLET

Recover Wallet from Seed Phrase

gitopiad keys add $WALLET --recover

List Wallets

gitopiad keys list

Show Wallet Details

gitopiad keys show $WALLET

Delete Wallet

gitopiad keys delete $WALLET

2. Wallet Operations

Check Balance

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

Send Tokens

gitopiad tx bank send $WALLET <recipient_address> <amount>ulore --chain-id gitopia --gas auto --gas-adjustment 1.5 --fees 500ulore

3. Validator Management

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

Create Validator

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

Edit Validator

gitopiad tx staking edit-validator \\
  --new-moniker "$MONIKER" \\
  --identity "" \\
  --website "" \\
  --details "Your validator description" \\
  --chain-id gitopia \\
  --from $WALLET \\
  --gas auto --gas-adjustment 1.5 \\
  --fees 500ulore

Delegate Tokens

gitopiad tx staking delegate $(gitopiad keys show $WALLET --bech val -a) 1000000ulore --from $WALLET --chain-id gitopia --gas auto --gas-adjustment 1.5 --fees 500ulore

Withdraw Rewards (Delegator)

gitopiad tx distribution withdraw-rewards $(gitopiad keys show $WALLET --bech val -a) --from $WALLET --chain-id gitopia --gas auto --gas-adjustment 1.5 --fees 500ulore

Withdraw Rewards (Validator Commission)

gitopiad tx distribution withdraw-rewards $(gitopiad keys show $WALLET --bech val -a) --commission --from $WALLET --chain-id gitopia --gas auto --gas-adjustment 1.5 --fees 500ulore

Unbond Tokens

gitopiad tx staking unbond $(gitopiad keys show $WALLET --bech val -a) 1000000ulore --from $WALLET --chain-id gitopia --gas auto --gas-adjustment 1.5 --fees 500ulore

Redelegate Tokens

gitopiad tx staking redelegate $(gitopiad keys show $WALLET --bech val -a) <destination_validator_address> 1000000ulore --from $WALLET --chain-id gitopia --gas auto --gas-adjustment 1.5 --fees 500ulore

4. Node Status & Info

Check Sync Status

gitopiad 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

gitopiad tendermint show-node-id

Restart Node

sudo systemctl restart gitopiad

View Node Logs

sudo journalctl -u gitopiad -f -o cat

5. Governance

List Proposals

gitopiad query gov proposals

View Proposal Details

gitopiad query gov proposal <proposal_id>

Vote on Proposal

gitopiad tx gov vote <proposal_id> yes --from $WALLET --chain-id gitopia --gas auto --gas-adjustment 1.5 --fees 500ulore

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

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