Consumer chain validator rewards

warning

A validator can only receive rewards from a consumer chain if the validator has been validating the consumer chain for some time. Specifically, the validator has to be a consumer validator of the consumer chain for at least NumberOfEpochsToStartReceivingRewards * BlocksPerEpoch blocks (run interchain-security-pd query provider params for the actual values of the NumberOfEpochsToStartReceivingRewards and BlocksPerEpoch params).

Withdrawing rewards

Here are example steps for withdrawing rewards from consumer chains in the provider chain

info

The examples used are from rs-testnet, the Interchain Security persistent testnet.

Validator operator address: cosmosvaloper1e5yfpc8l6g4808fclmlyd38tjgxuwshnmjkrq6 Self-delegation address: cosmos1e5yfpc8l6g4808fclmlyd38tjgxuwshn7xzkvf

Prior to withdrawing rewards, query balances for self-delegation address:

gaiad q bank balances cosmos1e5yfpc8l6g4808fclmlyd38tjgxuwshn7xzkvf

balances:
- amount: "1000000000000"
  denom: uatom
pagination:
  next_key: null
  total: "0"

Querying validator rewards

Query rewards for the validator address:

gaiad q distribution rewards cosmos1e5yfpc8l6g4808fclmlyd38tjgxuwshn7xzkvf cosmosvaloper1e5yfpc8l6g4808fclmlyd38tjgxuwshnmjkrq6

rewards:
- amount: "158.069895000000000000"
  denom: ibc/2CB0E87E2A742166FEC0A18D6FBF0F6AD4AA1ADE694792C1BD6F5E99088D67FD
- amount: "841842390516.072526500000000000"
  denom: uatom

The ibc/2CB0E87E2A742166FEC0A18D6FBF0F6AD4AA1ADE694792C1BD6F5E99088D67FD denom represents rewards from a consumer chain.

Withdrawing rewards and commission

1. Withdraw rewards

gaiad tx distribution withdraw-rewards cosmosvaloper1e5yfpc8l6g4808fclmlyd38tjgxuwshnmjkrq6 --from cosmos1e5yfpc8l6g4808fclmlyd38tjgxuwshn7xzkvf --commission --chain-id provider --gas auto --fees 500uatom -b block -y

txhash: A7E384FB1958211B43B7C06527FC7D4471FB6B491EE56FDEA9C5634D76FF1B9A

2. Confirm withdrawal

After withdrawing rewards self-delegation address balance to confirm rewards were withdrawn:

gaiad q bank balances cosmos1e5yfpc8l6g4808fclmlyd38tjgxuwshn7xzkvf

balances:
- amount: "216"
  denom: ibc/2CB0E87E2A742166FEC0A18D6FBF0F6AD4AA1ADE694792C1BD6F5E99088D67FD
- amount: "2233766225342"
  denom: uatom
pagination:
  next_key: null
  total: "0"