Validator CLI Commands

This contains a summarized list of all relevant CLI commands for validators

Validator Set

• To query the current list of active validators with the following command: sifnoded query tendermint-validator-set

  • This query will show information about all validators in the validator set. Once your validator’s total delegated tokens is higher than the lowest staked validator in this set, your validator will enter the set.

• You can view your validator’s current staked tokens with: sifnoded query staking validator <validator-address>

Delegation

• Validators can view all unclaimed commission charged to their delegators with the following command: sifnoded query distribution commission <validator-address>

Block Rewards

• Validators can view all of their unclaimed rewards with the following command:sifnoded query distribution validator-outstanding-rewards <validator-address>

Claiming & Restaking Block Rewards

• To withdraw rewards, execute one of the below commands:

  • sifnoded tx distribution withdraw-rewards <validator-address> --from <address>

  • sifnoded tx distribution withdraw-rewards <validator-address> --from <address> --commission

    • Adding the --commission flag will also withdraw all of your commissions as well.

• By default, reward withdrawals will be sent to the source address. This default can be modified with the following command:

  • sifnoded tx distribution set-withdraw-addr <address> --from <address>

Unbonding

• In order to execute an unbonding transaction, you will need to run the below command:

  • sifnoded tx staking unbond <validator-address> <amount> --from <address>

    • Specify the validator you want to unbond from (in this case, your valiadator address), the amount to unbond, and your address.

    • If the validator is currently in the active validator set and not jailed, successful submission of this transaction will put the specified amount into the above mentioned unbonding period.

    • You can check the status of an unbonding delegation with the following command:

      • sifnoded query staking unbonding-delegation <delegator-address> <validator-address>

Slashing

• To see the jailing status in the standard staking validator query: sifnoded query staking validator <validator-address>

• In order to rejoin the validator set, you must run this transaction: sifnoded tx slashing unjail --from <moniker>

  • After submitting this transaction, simply query your validator information again to see that you have been unjailed.

Editing your Validator

• There are a few commands that can be run to edit the various details about your validator. These include:

  • sifnoded tx staking edit-validator --commission-rate <rate>

    • Submits a transaction to change a validator’s commission rate. Rate change cannot exceed 'Rate Change Maximum' established at time of validator creation.

  • sifnoded tx distribution set-withdraw-address <address> --from <address>

    • Submits a transaction to change the default recipient address for reward withdrawals

Other Helpful Queries

• Query Account Balance:

  • sifnoded query account <address>

  • Queries balance for specified account.

• Query Outstanding Validator Rewards:

  • sifnoded query distribution validator-outstanding-rewards <validator-address>

  • Queries all unclaimed rewards for a validator.

• Query Validator Commission:

  • sifnoded query distribution commission <validator-address>

  • Queries all unclaimed commissions charged by a validator.

• Query Delegation Information:

  • sifnoded query staking delegation <delegator-address> <validator-address>

  • Queries info about a delegation between specified delegator and validator.

• Query All Validators:

  • sifnoded query staking validators

  • Queries info for all validators on the chain.

• Querying Delegations to a Validator:

  • sifnoded query staking delegations-to <validator-address>

  • Queries info about all delegations made to a specific validator.

Note:

If your transaction throw any error, make sure to add the necessary flags. Some of the flags you may need are:

Some useful flags:

--chain-id string The network chain ID

--fees string Fees to pay along with transaction

--from string Name or address of private key with which to sign

--keyring-backend string Select keyring's backend (os|file|kwallet|pass|test|memory)

--node string <host>:<port> to tendermint rpc interface for this chain

Logs flag:

--log_format string The logging format (json|plain) (default "plain")

--log_level string The logging level (trace|debug|info|warn|error|fatal|panic)

--trace print out full stack trace on errors