Distribution

Overview

The Distribution precompile provides access to the Cosmos SDK x/distribution module. Smart contracts can claim rewards, query reward balances, and interact with the community pool.

On mainnet, x/distribution currently receives no automatic rewards. Inflation is 0, x/feeburn burns all transaction fees every block before x/distribution can allocate them, and community tax and proposer rewards are 0. Unless tokens are deposited with depositValidatorRewardsPool, the reward and commission queries return empty amounts, withdrawDelegatorRewards, claimRewards and withdrawValidatorCommission pay nothing, and delegators earn nothing. Validators are paid through the x/valrewards subsidy instead; see Validator Rewards.

Precompile Address: 0x0000000000000000000000000000000000000801

Gas Costs

Method Type	Gas Cost
Transactions	`2000 + (30 x bytes of input)`
Queries	`1000 + (3 x bytes of input)`

Transaction Methods

Method	Description
`setWithdrawAddress`	Set the address that receives staking rewards
`withdrawDelegatorRewards`	Withdraw rewards from a specific validator
`withdrawValidatorCommission`	Withdraw validator commission earnings
`fundCommunityPool`	Send tokens to the community pool
`claimRewards`	Claim rewards for a delegator with a max retrieval count
`depositValidatorRewardsPool`	Add tokens to one validator’s `x/distribution` rewards (commission first, the rest to its delegators). Takes the validator operator address. Not related to the `x/valrewards` pool

Query Methods

Method	Description
`validatorDistributionInfo`	Get a validator’s distribution state
`validatorOutstandingRewards`	Get unclaimed validator rewards
`validatorCommission`	Get accumulated validator commission
`delegationTotalRewards`	Get total rewards across all delegations
`delegatorValidators`	List validators a delegator has staked with

Example

// Pseudocode: import DistributionI from the canonical interface.
DistributionI constant dist = DistributionI(0x0000000000000000000000000000000000000801);

// Withdraw this contract's rewards from a validator
dist.withdrawDelegatorRewards(address(this), "c8valoper1...");

The delegator address must be the direct caller of the precompile. A contract withdraws its own rewards by passing address(this); an EOA calls the precompile directly with its own address. Any other address reverts with msg.sender address ... does not match the requester address .... For exact signatures, return values, and events, see Precompile ABI Reference.

Learn

Core Concepts

Chain Architecture

Execution and EVM

Interoperability and IBC

Modules & Precompiles

Transaction Lifecycle

Overview

Gas Costs

Transaction Methods

Query Methods

Example

​Overview

​Gas Costs

​Transaction Methods

​Query Methods

​Example

Overview

Gas Costs

Transaction Methods

Query Methods

Example