Abstract
The distribution precompiled contract acts as a bridge that enables EVM environments to use the Stable SDK’s x/distribution module functionality.
Contents
- Concepts
- Configuration
- Methods
- Events
Concepts
The distribution precompiled contract performs additional checks to ensure that the delegator or depositor is the caller.
Configuration
The contract address and gas cost are predefined.
Contract address
0x0000000000000000000000000000000000000801
Methods
setWithdrawAddress
Sets the address to receive the reward for the token delegated by the delegator to the validator.
Sometimes, when the delegator is self-delegated, the validator address is used as the delegator.
SetWithdrawAddress is emitted when the withdrawer address is successfully set.
| Name | Type | Description |
|---|
| delegatorAddress | address | the address of the delegator |
| withdrawerAddress | address | the address to receive the reward of delegation |
Outputs
| Name | Type | Description |
|---|
| success | bool | true if the withdrawer address is successfully set |
withdrawDelegatorRewards
Withdraws the reward to be received by the delegator from the validator.
All types of tokens that the validator rewards to the delegator are withdrawn in a single transaction.
WithdrawDelegatorRewards is emitted when the reward is successfully withdrawn.
| Name | Type | Description |
|---|
| delegatorAddress | address | the address of the delegator |
| validatorAddress | address | the address of the validator |
Outputs
| Name | Type | Description |
|---|
| amount | Coin[] | rewards of various tokens to be received by the delegator |
Coin is a struct with the following fields:
| Name | Type | Description |
|---|
| denom | string | the denom of the reward |
| amount | uint256 | the amount of the reward |
withdrawValidatorCommission
Withdraws the commission of the validator.
All types of tokens that the validator receives as commission are withdrawn in a single transaction.
WithdrawValidatorCommission is emitted when the commission is successfully withdrawn.
| Name | Type | Description |
|---|
| validatorAddress | address | the address of the validator |
Outputs
| Name | Type | Description |
|---|
| amount | Coin[] | commissions of various tokens to be received by the validator |
validatorDistributionInfo
Returns the distribution information representing the reward the validator will receive. A validator can delegate tokens to itself at its own address to act as a delegator, called self-bonded.
| Name | Type | Description |
|---|
| validatorAddress | address | the address of the validator |
Outputs
| Name | Type | Description |
|---|
| distributionInfo | ValidatorDistributionInfo | distribution information of the validator |
ValidatorDistributionInfo is a struct with the following fields:
| Name | Type | Description |
|---|
| operatorAddress | address | the address of the operator of the validator |
| selfBondRewards | DecCoin[] | the self-bonded amount of the validator |
| commission | DecCoin[] | the commission of the validator |
DecCoin is a struct with the following fields:
| Name | Type | Description |
|---|
| denom | string | the denom of the reward |
| amount | uint256 | the amount of the reward |
| precision | uint8 | the precision of the reward |
validatorOutstandingRewards
Returns the outstanding rewards of the validator. Outstanding rewards represent the total reward pool: the validator’s commission and self-bonded rewards, plus the total rewards owed to delegators. For example, if validator A has delegators B, C, and D, the outstanding rewards equal A’s commission and self-bonded rewards, plus the rewards of B, C, and D.
| Name | Type | Description |
|---|
| validatorAddress | address | the address of the validator |
Outputs
| Name | Type | Description |
|---|
| rewards | DecCoin[] | outstanding rewards of the validator |
validatorCommission
Returns the commission of the validator. This method is used to retrieve the commission of the validator before calling withdrawValidatorCommission method.
| Name | Type | Description |
|---|
| validatorAddress | address | the address of the validator |
Outputs
| Name | Type | Description |
|---|
| commission | DecCoin[] | commission of the validator |
validatorSlashes
Returns the history of slashes of the validator between the starting height and ending height. Slashing is the fines imposed when a validator behaves maliciously or violates network rules such as double signing, misbehavior, or not following the chain rules.
| Name | Type | Description |
|---|
| validatorAddress | address | the address of the validator |
| startingHeight | uint64 | the starting height |
| endingHeight | uint64 | the ending height |
| pageRequest | PageReq | the pagination request |
PageReq is a struct with the following fields:
| Name | Type | Description |
|---|
| key | bytes | the key of the pagination |
| offset | uint64 | the offset of the pagination |
| limit | uint64 | the limit of the pagination |
| countTotal | bool | whether to count the total number of pages |
| reverse | bool | whether to reverse the pagination |
Outputs
| Name | Type | Description |
|---|
| slashes | ValidatorSlashEvent[] | slashes of the validator |
| pagination | PageResp | the pagination response |
ValidatorSlashEvent is a struct with the following fields:
| Name | Type | Description |
|---|
| validatorPeriod | uint64 | the period of the validator |
| fraction | Dec | the fraction of the slash |
Dec is a struct with the following fields:
| Name | Type | Description |
|---|
| value | uint64 | the value of the Dec |
| precision | uint8 | the precision of the Dec |
PageResp is a struct with the following fields:
| Name | Type | Description |
|---|
| nextKey | bytes | the next key of the pagination |
| total | uint64 | the total number of pages |
delegationRewards
Returns the rewards that delegator receives from the validator.
| Name | Type | Description |
|---|
| delegatorAddress | address | the hex address of the delegator |
| validatorAddress | address | the address of the validator |
Outputs
| Name | Type | Description |
|---|
| rewards | DecCoin[] | rewards that delegator receives from the validator |
delegationTotalRewards
Returns the total rewards that delegator receives from all validators.
| Name | Type | Description |
|---|
| delegatorAddress | address | the hex address of the delegator |
Outputs
| Name | Type | Description |
|---|
| rewards | DelegationDelegatorReward[] | total rewards that delegator receives from all validators |
| total | DecCoin[] | the total amount of the rewards |
DelegationDelegatorReward is a struct with the following fields:
| Name | Type | Description |
|---|
| validatorAddress | address | the address of the validator |
| reward | DecCoin[] | rewards that delegator receives from the validator |
delegatorValidators
Returns the validators that delegator is bonded to.
| Name | Type | Description |
|---|
| delegatorAddress | address | the hex address of the delegator |
Outputs
| Name | Type | Description |
|---|
| validators | string[] | validators that delegator is bonded to |
delegatorWithdrawAddress
Returns the address to receive the reward of delegation set by setWithdrawAddress method.
| Name | Type | Description |
|---|
| delegatorAddress | address | the hex address of the delegator |
Outputs
| Name | Type | Description |
|---|
| withdrawAddress | address | the address to receive the reward of delegation |
Events
SetWithdrawAddress
| Name | Type | Indexed | Description |
|---|
| caller | address | Y | the address of the caller (delegator) |
| withdrawAddress | address | N | the address to receive the reward of delegation |
WithdrawDelegatorRewards
| Name | Type | Indexed | Description |
|---|
| delegatorAddress | address | Y | the address of the delegator |
| validatorAddress | address | Y | the address of the validator |
| amount | uint256 | N | the amount of the reward |
WithdrawValidatorCommission
| Name | Type | Indexed | Description |
|---|
| validatorAddress | address | Y | the address of the validator |
| commission | uint256 | N | the total amount of the commission |
Last modified on April 23, 2026
