Skip to content
All services

Testnet

Terra

Chain ID
Version
Go

Run these after the install guide, which sets $WALLET, $MONIKER and the chain variables.

Keys and wallet

  1. Add a new key

    terrad keys add $WALLET
  2. Recover a key

    terrad keys add $WALLET --recover
  3. List keys

    terrad keys list
  4. Wallet balance

    terrad q bank balances $(terrad keys show $WALLET -a)

Validator

  1. Create a validator

    cat > $HOME/validator.json << EOF
    {
      "pubkey": $(terrad comet show-validator),
      "amount": "1000000uluna",
      "moniker": "$MONIKER",
      "identity": "",
      "website": "",
      "security": "",
      "details": "",
      "commission-rate": "0.05",
      "commission-max-rate": "0.20",
      "commission-max-change-rate": "0.05",
      "min-self-delegation": "1"
    }
    EOF
    terrad tx staking create-validator $HOME/validator.json --from $WALLET --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y
  2. Edit the validator

    terrad tx staking edit-validator --new-moniker "$MONIKER" --identity "" --website "" --details "" --from $WALLET --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y
  3. Unjail

    terrad tx slashing unjail --from $WALLET --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y
  4. Validator details

    terrad q staking validator $(terrad keys show $WALLET --bech val -a)

Tokens

  1. Withdraw all rewards

    terrad tx distribution withdraw-all-rewards --from $WALLET --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y
  2. Withdraw commission and rewards

    terrad tx distribution withdraw-rewards $(terrad keys show $WALLET --bech val -a) --commission --from $WALLET --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y
  3. Delegate to yourself

    terrad tx staking delegate $(terrad keys show $WALLET --bech val -a) 1000000uluna --from $WALLET --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y
  4. Redelegate

    terrad tx staking redelegate $(terrad keys show $WALLET --bech val -a) <TO_VALOPER> 1000000uluna --from $WALLET --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y
  5. Unbond

    terrad tx staking unbond $(terrad keys show $WALLET --bech val -a) 1000000uluna --from $WALLET --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y
  6. Send tokens

    terrad tx bank send $WALLET <TO_ADDRESS> 1000000uluna --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y

Governance

  1. List proposals

    terrad q gov proposals
  2. View a proposal

    terrad q gov proposal <ID>
  3. Vote

    terrad tx gov vote <ID> yes --from $WALLET --chain-id $TERRA_CHAIN_ID --gas auto --gas-adjustment 1.5 --gas-prices 0.0125uluna -y
    # yes | no | abstain | no_with_veto

Maintenance

  1. Node status

    terrad status 2>&1 | jq
  2. Node peer address

    echo $(terrad comet show-node-id)@$(wget -qO- eth0.me):$TERRA_PORT656
  3. Live peers

    curl -s localhost:$TERRA_PORT657/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr | split(":") | last)"' | paste -sd,
  4. Check the validator key

    [[ $(terrad q staking validator $(terrad keys show $WALLET --bech val -a) -o json | jq -r .validator.consensus_pubkey.value) = $(terrad comet show-validator | jq -r .key) ]] && echo "match" || echo "MISMATCH"
  5. Reset chain data

    terrad comet unsafe-reset-all --keep-addr-book --home $HOME/.terra
  6. Remove the node

    sudo systemctl stop terrad
    sudo systemctl disable terrad
    sudo rm /etc/systemd/system/terrad.service
    sudo systemctl daemon-reload
    rm -rf $HOME/.terra $(which terrad)

Service

  1. Service status

    sudo systemctl status terrad
  2. Follow logs

    sudo journalctl -fu terrad -o cat
  3. Restart

    sudo systemctl restart terrad
  4. Stop

    sudo systemctl stop terrad