Queries

Cosmos-SDK Distribution module query commands

The query commands allow users to query distribution state.

sged query distribution --help

Commission

The commission command allows users to query validator commission rewards by address.

sged query distribution commission [address] [flags]

Example:

sged query distribution commission sgevaloper1..

Example Output:

commission:
- amount: "1000000.000000000000000000"
  denom: usge

Community Pool

The community-pool command allows users to query all coin balances within the community pool.

sged query distribution community-pool [flags]

Example:

sged query distribution community-pool

Example Output:

commission:
- amount: "1000000.000000000000000000"
  denom: usge

Params

The params command allows users to query the parameters of the distribution module.

sged query distribution params [flags]

Example:

sged query distribution params

Example Output:

base_proposer_reward: "0.010000000000000000"
bonus_proposer_reward: "0.040000000000000000"
community_tax: "0.020000000000000000"
withdraw_addr_enabled: true

Rewards

The rewards command allows users to query delegator rewards. Users can optionally include the validator address to query rewards earned from a specific validator.

sged query distribution rewards [delegator-addr] [validator-addr] [flags]

Example:

sged query distribution rewards sge1..

Example Output:

rewards:
- reward:
  - amount: "1000000.000000000000000000"
    denom: usge
  validator_address: sgevaloper1..
total:
- amount: "1000000.000000000000000000"
  denom: usge

Slashes

The slashes command allows users to query all slashes for a given block range.

sged query distribution slashes [validator] [start-height] [end-height] [flags]

Example:

sged query distribution slashes sgevaloper1.. 1 1000

Example Output:

pagination:
  next_key: null
  total: "0"
slashes:
- validator_period: 20,
  fraction: "0.009999999999999999"

Validator outstanding rewards

The validator-outstanding-rewards command allows users to query all outstanding (un-withdrawn) rewards for a validator and all their delegations.

sged query distribution validator-outstanding-rewards [validator] [flags]

Example:

sged query distribution validator-outstanding-rewards sgevaloper1..

Example Output:

rewards:
- amount: "1000000.000000000000000000"
  denom: usge

For detailed information see the original document.