package cosmos.distribution.v1beta1

Get desktop application:
View/edit binary Protocol Buffers messages

Msg defines the distribution Msg service.

• rpc FundCommunityPool (MsgFundCommunityPool, MsgFundCommunityPoolResponse)

  tx.proto:28

  FundCommunityPool defines a method to allow an account to directly fund the community pool.

  message MsgFundCommunityPool

  tx.proto:83

  MsgFundCommunityPool allows an account to directly fund the community pool.

  • repeated base.v1beta1.Coin amount = 1

  • string depositor = 2

  message MsgFundCommunityPoolResponse

  tx.proto:95

  MsgFundCommunityPoolResponse defines the Msg/FundCommunityPool response type.

  (message has no fields)

• rpc SetWithdrawAddress (MsgSetWithdrawAddress, MsgSetWithdrawAddressResponse)

  tx.proto:16

  SetWithdrawAddress defines a method to change the withdraw address for a delegator (or validator self-delegation).

  message MsgSetWithdrawAddress

  tx.proto:33

  MsgSetWithdrawAddress sets the withdraw address for a delegator (or validator self-delegation).

  • string delegator_address = 1

  • string withdraw_address = 2

  message MsgSetWithdrawAddressResponse

  tx.proto:44

  MsgSetWithdrawAddressResponse defines the Msg/SetWithdrawAddress response type.

  (message has no fields)

• rpc WithdrawDelegatorReward (MsgWithdrawDelegatorReward, MsgWithdrawDelegatorRewardResponse)

  tx.proto:20

  WithdrawDelegatorReward defines a method to withdraw rewards of delegator from a single validator.

  message MsgWithdrawDelegatorReward

  tx.proto:48

  MsgWithdrawDelegatorReward represents delegation withdrawal to a delegator from a single validator.

  • string delegator_address = 1

  • string validator_address = 2

  message MsgWithdrawDelegatorRewardResponse

  tx.proto:59

  MsgWithdrawDelegatorRewardResponse defines the Msg/WithdrawDelegatorReward response type.

  • repeated base.v1beta1.Coin amount = 1

• rpc WithdrawValidatorCommission (MsgWithdrawValidatorCommission, MsgWithdrawValidatorCommissionResponse)

  tx.proto:24

  WithdrawValidatorCommission defines a method to withdraw the full commission to the validator address.

  message MsgWithdrawValidatorCommission

  tx.proto:66

  MsgWithdrawValidatorCommission withdraws the full commission to the validator address.

  • string validator_address = 1

  message MsgWithdrawValidatorCommissionResponse

  tx.proto:76

  MsgWithdrawValidatorCommissionResponse defines the Msg/WithdrawValidatorCommission response type.

  • repeated base.v1beta1.Coin amount = 1

Query defines the gRPC querier service for distribution module.

• rpc CommunityPool (QueryCommunityPoolRequest, QueryCommunityPoolResponse)

  query.proto:63

  CommunityPool queries the community pool coins.

  message QueryCommunityPoolRequest

  query.proto:211

  QueryCommunityPoolRequest is the request type for the Query/CommunityPool RPC method.

  (message has no fields)

  message QueryCommunityPoolResponse

  query.proto:215

  QueryCommunityPoolResponse is the response type for the Query/CommunityPool RPC method.

  • repeated base.v1beta1.DecCoin pool = 1

    pool defines community pool's coins.

• rpc DelegationRewards (QueryDelegationRewardsRequest, QueryDelegationRewardsResponse)

  query.proto:39

  DelegationRewards queries the total rewards accrued by a delegation.

  message QueryDelegationRewardsRequest

  query.proto:132

  QueryDelegationRewardsRequest is the request type for the Query/DelegationRewards RPC method.

  • string delegator_address = 1

    delegator_address defines the delegator address to query for.

  • string validator_address = 2

    validator_address defines the validator address to query for.

  message QueryDelegationRewardsResponse

  query.proto:144

  QueryDelegationRewardsResponse is the response type for the Query/DelegationRewards RPC method.

  • repeated base.v1beta1.DecCoin rewards = 1

    rewards defines the rewards accrued by a delegation.

• rpc DelegationTotalRewards (QueryDelegationTotalRewardsRequest, QueryDelegationTotalRewardsResponse)

  query.proto:46

  DelegationTotalRewards queries the total rewards accrued by a each validator.

  message QueryDelegationTotalRewardsRequest

  query.proto:152

  QueryDelegationTotalRewardsRequest is the request type for the Query/DelegationTotalRewards RPC method.

  • string delegator_address = 1

    delegator_address defines the delegator address to query for.

  message QueryDelegationTotalRewardsResponse

  query.proto:161

  QueryDelegationTotalRewardsResponse is the response type for the Query/DelegationTotalRewards RPC method.

  • repeated DelegationDelegatorReward rewards = 1

    rewards defines all the rewards accrued by a delegator.

  • repeated base.v1beta1.DecCoin total = 2

    total defines the sum of all the rewards.

• rpc DelegatorValidators (QueryDelegatorValidatorsRequest, QueryDelegatorValidatorsResponse)

  query.proto:51

  DelegatorValidators queries the validators of a delegator.

  message QueryDelegatorValidatorsRequest

  query.proto:171

  QueryDelegatorValidatorsRequest is the request type for the Query/DelegatorValidators RPC method.

  • string delegator_address = 1

    delegator_address defines the delegator address to query for.

  message QueryDelegatorValidatorsResponse

  query.proto:181

  QueryDelegatorValidatorsResponse is the response type for the Query/DelegatorValidators RPC method.

  • repeated string validators = 1

    validators defines the validators a delegator is delegating for.

• rpc DelegatorWithdrawAddress (QueryDelegatorWithdrawAddressRequest, QueryDelegatorWithdrawAddressResponse)

  query.proto:57

  DelegatorWithdrawAddress queries withdraw address of a delegator.

  message QueryDelegatorWithdrawAddressRequest

  query.proto:191

  QueryDelegatorWithdrawAddressRequest is the request type for the Query/DelegatorWithdrawAddress RPC method.

  • string delegator_address = 1

    delegator_address defines the delegator address to query for.

  message QueryDelegatorWithdrawAddressResponse

  query.proto:201

  QueryDelegatorWithdrawAddressResponse is the response type for the Query/DelegatorWithdrawAddress RPC method.

  • string withdraw_address = 1

    withdraw_address defines the delegator address to query for.

• rpc Params (QueryParamsRequest, QueryParamsResponse)

  query.proto:16

  Params queries params of the distribution module.

  message QueryParamsRequest

  query.proto:69

  QueryParamsRequest is the request type for the Query/Params RPC method.

  (message has no fields)

  message QueryParamsResponse

  query.proto:72

  QueryParamsResponse is the response type for the Query/Params RPC method.

  • optional Params params = 1

    params defines the parameters of the module.

• rpc ValidatorCommission (QueryValidatorCommissionRequest, QueryValidatorCommissionResponse)

  query.proto:28

  ValidatorCommission queries accumulated commission for a validator.

  message QueryValidatorCommissionRequest

  query.proto:92

  QueryValidatorCommissionRequest is the request type for the Query/ValidatorCommission RPC method

  • string validator_address = 1

    validator_address defines the validator address to query for.

  message QueryValidatorCommissionResponse

  query.proto:99

  QueryValidatorCommissionResponse is the response type for the Query/ValidatorCommission RPC method

  • optional ValidatorAccumulatedCommission commission = 1

    commission defines the commision the validator received.

• rpc ValidatorOutstandingRewards (QueryValidatorOutstandingRewardsRequest, QueryValidatorOutstandingRewardsResponse)

  query.proto:21

  ValidatorOutstandingRewards queries rewards of a validator address.

  message QueryValidatorOutstandingRewardsRequest

  query.proto:79

  QueryValidatorOutstandingRewardsRequest is the request type for the Query/ValidatorOutstandingRewards RPC method.

  • string validator_address = 1

    validator_address defines the validator address to query for.

  message QueryValidatorOutstandingRewardsResponse

  query.proto:86

  QueryValidatorOutstandingRewardsResponse is the response type for the Query/ValidatorOutstandingRewards RPC method.

  • optional ValidatorOutstandingRewards rewards = 1

• rpc ValidatorSlashes (QueryValidatorSlashesRequest, QueryValidatorSlashesResponse)

  query.proto:34

  ValidatorSlashes queries slash events of a validator.

  message QueryValidatorSlashesRequest

  query.proto:106

  QueryValidatorSlashesRequest is the request type for the Query/ValidatorSlashes RPC method

  • string validator_address = 1

    validator_address defines the validator address to query for.

  • uint64 starting_height = 2

    starting_height defines the optional starting height to query the slashes.

  • uint64 ending_height = 3

    starting_height defines the optional ending height to query the slashes.

  • optional base.query.v1beta1.PageRequest pagination = 4

    pagination defines an optional pagination for the request.

  message QueryValidatorSlashesResponse

  query.proto:122

  QueryValidatorSlashesResponse is the response type for the Query/ValidatorSlashes RPC method.

  • repeated ValidatorSlashEvent slashes = 1

    slashes defines the slashes the validator received.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

CommunityPoolSpendProposal details a proposal for use of community funds, together with how many coins are proposed to be spent, and to which recipient account.

• string title = 1

• string description = 2

• string recipient = 3

• repeated base.v1beta1.Coin amount = 4

CommunityPoolSpendProposalWithDeposit defines a CommunityPoolSpendProposal with a deposit

• string title = 1

• string description = 2

• string recipient = 3

• string amount = 4

• string deposit = 5

DelegationDelegatorReward represents the properties of a delegator's delegation reward.

Used in: QueryDelegationTotalRewardsResponse

• string validator_address = 1

• repeated base.v1beta1.DecCoin reward = 2

DelegatorStartingInfo represents the starting info for a delegator reward period. It tracks the previous validator period, the delegation's amount of staking token, and the creation height (to check later on if any slashes have occurred). NOTE: Even though validators are slashed to whole staking tokens, the delegators within the validator may be left with less than a full token, thus sdk.Dec is used.

Used in: DelegatorStartingInfoRecord

• uint64 previous_period = 1

• string stake = 2

• uint64 height = 3

DelegatorStartingInfoRecord used for import / export via genesis json.

Used in: GenesisState

• string delegator_address = 1

  delegator_address is the address of the delegator.

• string validator_address = 2

  validator_address is the address of the validator.

• optional DelegatorStartingInfo starting_info = 3

  starting_info defines the starting info of a delegator.

DelegatorWithdrawInfo is the address for where distributions rewards are withdrawn to by default this struct is only used at genesis to feed in default withdraw addresses.

Used in: GenesisState

• string delegator_address = 1

  delegator_address is the address of the delegator.

• string withdraw_address = 2

  withdraw_address is the address to withdraw the delegation rewards to.

FeePool is the global fee pool for distribution.

Used in: GenesisState

• repeated base.v1beta1.DecCoin community_pool = 1

GenesisState defines the distribution module's genesis state.

• optional Params params = 1

  params defines all the paramaters of the module.

• optional FeePool fee_pool = 2

  fee_pool defines the fee pool at genesis.

• repeated DelegatorWithdrawInfo delegator_withdraw_infos = 3

  fee_pool defines the delegator withdraw infos at genesis.

• string previous_proposer = 4

  fee_pool defines the previous proposer at genesis.

• repeated ValidatorOutstandingRewardsRecord outstanding_rewards = 5

  fee_pool defines the outstanding rewards of all validators at genesis.

• repeated ValidatorAccumulatedCommissionRecord validator_accumulated_commissions = 6

  fee_pool defines the accumulated commisions of all validators at genesis.

• repeated ValidatorHistoricalRewardsRecord validator_historical_rewards = 7

  fee_pool defines the historical rewards of all validators at genesis.

• repeated ValidatorCurrentRewardsRecord validator_current_rewards = 8

  fee_pool defines the current rewards of all validators at genesis.

• repeated DelegatorStartingInfoRecord delegator_starting_infos = 9

  fee_pool defines the delegator starting infos at genesis.

• repeated ValidatorSlashEventRecord validator_slash_events = 10

  fee_pool defines the validator slash events at genesis.

Params defines the set of params for the distribution module.

Used in: GenesisState, QueryParamsResponse

• string community_tax = 1

• string base_proposer_reward = 2

• string bonus_proposer_reward = 3

• bool withdraw_addr_enabled = 4

ValidatorAccumulatedCommission represents accumulated commission for a validator kept as a running counter, can be withdrawn at any time.

Used in: QueryValidatorCommissionResponse, ValidatorAccumulatedCommissionRecord

• repeated base.v1beta1.DecCoin commission = 1

ValidatorAccumulatedCommissionRecord is used for import / export via genesis json.

Used in: GenesisState

• string validator_address = 1

  validator_address is the address of the validator.

• optional ValidatorAccumulatedCommission accumulated = 2

  accumulated is the accumulated commission of a validator.

ValidatorCurrentRewards represents current rewards and current period for a validator kept as a running counter and incremented each block as long as the validator's tokens remain constant.

Used in: ValidatorCurrentRewardsRecord

• repeated base.v1beta1.DecCoin rewards = 1

• uint64 period = 2

ValidatorCurrentRewardsRecord is used for import / export via genesis json.

Used in: GenesisState

• string validator_address = 1

  validator_address is the address of the validator.

• optional ValidatorCurrentRewards rewards = 2

  rewards defines the current rewards of a validator.

ValidatorHistoricalRewards represents historical rewards for a validator. Height is implicit within the store key. Cumulative reward ratio is the sum from the zeroeth period until this period of rewards / tokens, per the spec. The reference count indicates the number of objects which might need to reference this historical entry at any point. ReferenceCount = number of outstanding delegations which ended the associated period (and might need to read that record) + number of slashes which ended the associated period (and might need to read that record) + one per validator for the zeroeth period, set on initialization

Used in: ValidatorHistoricalRewardsRecord

• repeated base.v1beta1.DecCoin cumulative_reward_ratio = 1

• uint32 reference_count = 2

ValidatorHistoricalRewardsRecord is used for import / export via genesis json.

Used in: GenesisState

• string validator_address = 1

  validator_address is the address of the validator.

• uint64 period = 2

  period defines the period the historical rewards apply to.

• optional ValidatorHistoricalRewards rewards = 3

  rewards defines the historical rewards of a validator.

ValidatorOutstandingRewards represents outstanding (un-withdrawn) rewards for a validator inexpensive to track, allows simple sanity checks.

Used in: QueryValidatorOutstandingRewardsResponse

• repeated base.v1beta1.DecCoin rewards = 1

ValidatorOutstandingRewardsRecord is used for import/export via genesis json.

Used in: GenesisState

• string validator_address = 1

  validator_address is the address of the validator.

• repeated base.v1beta1.DecCoin outstanding_rewards = 2

  outstanding_rewards represents the oustanding rewards of a validator.

ValidatorSlashEvent represents a validator slash event. Height is implicit within the store key. This is needed to calculate appropriate amount of staking tokens for delegations which are withdrawn after a slash has occurred.

Used in: QueryValidatorSlashesResponse, ValidatorSlashEventRecord, ValidatorSlashEvents

• uint64 validator_period = 1

• string fraction = 2

ValidatorSlashEventRecord is used for import / export via genesis json.

Used in: GenesisState

• string validator_address = 1

  validator_address is the address of the validator.

• uint64 height = 2

  height defines the block height at which the slash event occured.

• uint64 period = 3

  period is the period of the slash event.

• optional ValidatorSlashEvent validator_slash_event = 4

  validator_slash_event describes the slash event.

ValidatorSlashEvents is a collection of ValidatorSlashEvent messages.

• repeated ValidatorSlashEvent validator_slash_events = 1