Skip to main content

Distribution Module

The ZIGChain Distribution Module is based on the Cosmos SDK - Distribution Module but with the specific parameters that you can find in the Distribution Parameters section.

Distribution Parameters​

The Distribution module in ZIGChain is configured with the following parameters:

note

These values may change via governance proposals. Always confirm using the CLI or API.

ParametersTestnet ValuesMainnet Values
base_proposer_reward0.000000000000000000 (0%)0.000000000000000000 (0%)
bonus_proposer_reward0.000000000000000000 (0%)0.000000000000000000 (0%)
community_tax0.02 (2%)0.02 (2%)
withdraw_addr_enabledTrueTrue

Parameters Overview​

base_proposer_reward

Description: This parameter defines the fixed portion of block rewards allocated to the proposer of a block, regardless of how many precommits (votes) the block includes. It's expressed as a fraction of the total fees collected in that block.

Default: 0.000000000000000000

Note: A value of zero means no fixed proposer reward is distributed for proposing a block.

bonus_proposer_reward

Description: This parameter defines an additional reward given to the block proposer based on the percentage of validators that precommitted (voted) on the proposed block. It incentivizes proposers to include valid and well-formed blocks to maximize participation.

Default: 0.000000000000000000

Note: A value of zero means no additional bonus is given, even if many validators precommit to the block.

community_tax

Description: This parameter defines the portion of block rewards and transaction fees allocated to the blockchain's community pool. This pool is a shared fund managed through governance and used to support ecosystem development and community-driven initiatives.

Example: If block rewards total 1,000 ZIG, 20 ZIG (2%) are allocated to the community pool, while the remaining 980 ZIG are distributed among validators and delegators.

For a detailed breakdown of validator and delegator rewards, see Delegator's FAQ.

Default: 2% or 20,000,000,000,000,000 (expressed in 18 decimal format)

Note: The community pool is managed through governance proposals. For more information, refer to the Governance Documentation.

withdraw_addr_enabled

Description: This parameter allows delegators to receive the rewards in a different address than the one used for staking.

Default: True

Note: This feature is particularly useful for users who wish to separate their staking operations from reward management.

Distribution CLI Quick Sheet​

Check distribution module parameters
zigchaind query distribution params \
--chain-id zigchain-1 --node https://public-zigchain-rpc.numia.xyz
Check community pool balance
zigchaind query distribution community-pool \
--chain-id zigchain-1 --node https://public-zigchain-rpc.numia.xyz
Fund the community pool
zigchaind tx distribution fund-community-pool 100uzig \
--from $ACCOUNT --gas-adjustment 1.5 \
--gas auto --gas-prices="0.0025uzig" \
--chain-id zigchain-1 --node https://public-zigchain-rpc.numia.xyz
Query Validator's Commission Rewards
zigchaind query distribution commission $VALIDATOR_ADDRESS \
--chain-id zigchain-1 --node https://public-zigchain-rpc.numia.xyz
Query Validator's Outstanding Rewards
zigchaind query distribution validator-outstanding-rewards $VALIDATOR_ADDRESS \
--chain-id zigchain-1 --node https://public-zigchain-rpc.numia.xyz
Query Validator Slashes by Block Range
zigchaind query distribution slashes $VALIDATOR_ADDRESS [start-height] [end-height] \
--chain-id zigchain-1 --node https://public-zigchain-rpc.numia.xyz
Query All Rewards Earned by a Delegator
zigchaind query distribution rewards $VALIDATOR_ADDRESS \
--chain-id zigchain-1 --node https://public-zigchain-rpc.numia.xyz
Query Validator Distribution Info
zigchaind query distribution validator-distribution-info $VALIDATOR_ADDRESS \
--chain-id zigchain-1 --node https://public-zigchain-rpc.numia.xyz

References​