Skip to main content

State

Params​

Stored under prefix 0. Governance-updatable via MsgUpdateParams, except where noted.

ParamTypeDefaultMeaning
service_pool_denomstringadtThe pool's single fee/payout denom. Immutable
epoch_identifierstring"week"Which x/epochs timer fires both epoch streams
validator_epoch_rewardInt0Fixed amount paid to each bonded validator per epoch
fee_burn_ratioLegacyDec0.2Fraction of accrued fees burned each epoch
fee_distribute_ratioLegacyDec0.5Fraction of accrued fees sent to the fee collector each epoch

Validation: both ratios ≥ 0 and fee_burn_ratio + fee_distribute_ratio ≤ 1; epoch_identifier non-empty; validator_epoch_reward ≥ 0; service_pool_denom a valid denom.

The defaults above are code defaults; live networks set their own values at genesis. Mainnet dchain-1 currently runs epoch_identifier = "day", fee_burn_ratio = 1 (100% burn), fee_distribute_ratio = 0, and validator_epoch_reward = 15000000000000000000000 (15,000 DT).

Why service_pool_denom is immutable: AccruedFees is a denom-less Int interpreted through this param. A live change would silently re-denominate the counter while the pool's actual coins stay adt, corrupting the epoch split and the balance invariant. Stateless Validate() cannot enforce this (it has no access to the previous value), so the guard lives in the MsgUpdateParams handler.

Derived (not stored)​

fee_retain_ratio = 1 − fee_burn_ratio − fee_distribute_ratio. Computed on read and surfaced by the Params query for transparency; never persisted and not used in any calculation — the retained amount is the split remainder, which also absorbs truncation dust.

Collections​

CollectionPrefixTypeMeaning
Params0Item[Params]Module parameters (above)
AccruedFees1Item[Int]Protocol fees received but not yet processed by the epoch split
LastPaidTime2Item[Timestamp]Block time of the last validator-reward payment

LastPaidTime drives the no-binge-pay guard and is updated only on successful payment.

All servicepool state is persisted — there is no mem store.

Genesis​

GenesisState carries params, accrued_fees (default 0, must be non-negative), and last_paid_time (zero value means "never paid", so the first due epoch pays a reward round). ExportGenesis exports all three.

The pool's token seed is bank genesis state, not servicepool state: a balances entry for the module account address with matching supply.