State
Params
Stored under prefix 0. Governance-updatable via MsgUpdateParams, except where noted.
| Param | Type | Default | Meaning |
|---|---|---|---|
service_pool_denom | string | adt | The pool's single fee/payout denom. Immutable |
epoch_identifier | string | "week" | Which x/epochs timer fires both epoch streams |
validator_epoch_reward | Int | 0 | Fixed amount paid to each bonded validator per epoch |
fee_burn_ratio | LegacyDec | 0.2 | Fraction of accrued fees burned each epoch |
fee_distribute_ratio | LegacyDec | 0.5 | Fraction 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
| Collection | Prefix | Type | Meaning |
|---|---|---|---|
Params | 0 | Item[Params] | Module parameters (above) |
AccruedFees | 1 | Item[Int] | Protocol fees received but not yet processed by the epoch split |
LastPaidTime | 2 | Item[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.