# Distribution

# Delegator Rewards

Terra.distribution.rewards_for(delegator)

Get an account's delegation rewards.

terra.distribution.rewards_for("terra...")

# Parameters

AccAddress
delegator

Delegator's account address.


# Returns

A JiguBox with the following keys:

ValAddress:Coins
rewards

Maps validator with whom delegator has staked tokens, to the rewards corresponding to that delegation.

Coins
total

Total amount delegated with.

# Withdraw Address

Terra.distribution.withdraw_address_for(delegator)

Get an account's Withdraw Address, the address to which funds are sent when rewards are withdrawn.

terra.distribution.withdraw_address_for("terra...")

# Parameters

AccAddress
delegator

Delegator's account address.


# Returns

AccAddress

Withdraw address for the delegator.

# Validator Rewards

Terra.distribution.val_rewards_for(validator)

Get a Validator's self-delegation and commission reward information.

terra.distribution.val_reward_for("terravaloper...")

# Parameters

ValAddress
validator

Validator's operator address.


# Returns

JiguBox with the following keys:

Coins
self_bond

Rewards validator has earned from its self-delegation.


Coins
commission

Rewards validator has earned from its commissions through delegations.


# Community Pool

Terra.distribution.community_pool(denom)

Get the current value of the Community Pool.

# all denominations -> Coins
terra.distribution.community_pool()
# one denomination -> Coin
terra.distribution.community_pool("uluna")

# Parameters

Denom
denom
optional

Denomination of community pool to query.


# Returns

Coins

The current community pool value.

Coin

If denom was provided, the community pool value in that denomination.

# Module Params

Terra.distribution.params(key=None)

Get the current Distribution module parameters.

# Parameters

str
key
optional

One of "community_tax", "base_proposer_reward", "bonus_proposer_reward", "withdraw_addr_enabled".


# Returns

JiguBox with the following keys:

Dec
community_tax

Community tax rate.

Dec
base_proposer_reward

Base reward for proposer of block.

Dec
bonus_proposer_reward

Bonus reward for proposer of block.

bool
withdraw_addr_enabled

Whether withdrawals are currently enabled.