> ## Documentation Index > Fetch the complete documentation index at: https://docs.stable.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Distribution precompile reference > Distribution precompile reference: reward withdrawal, withdraw-address management, and query methods. **Concept:** For what the distribution module does and when to use it, see [Distribution module](/en/explanation/distribution-module). ## Abstract The `distribution` precompiled contract acts as a bridge that enables EVM environments to use the Stable SDK's `x/distribution` module functionality. ## Contents 1. **[Concepts](#concepts)** 2. **[Configuration](#configuration)** 3. **[Methods](#methods)** 4. **[Events](#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. #### Inputs | 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. #### Inputs | 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. #### Inputs | 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. #### Inputs | 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. #### Inputs | 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. #### Inputs | 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. #### Inputs | 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. #### Inputs | 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. #### Inputs | 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. #### Inputs | 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. #### Inputs | 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 |