Skip to Content
ConceptsIncome

Income

Anyone can distribute coins to the holders of a right kind. Every holder accrues its share pro rata at that instant, and claims whenever it wants. Nothing iterates over holders: the chain keeps one index per (asset, kind, denom) and a checkpoint per holder.

  • Ex-date is the distribution block. Units received afterwards accrue nothing from that distribution.
  • Nothing is forfeited. Income accrued before you sold stays yours and remains claimable after your position reaches zero.
  • Dust is carried, not lost. Rounding leaves at most one base unit per holder per distribution in the module account; the chain reports it as the residue.
  • Allowed denoms. The issuer chooses up to eight denoms that may be distributed on the asset (the settlement denom by default).
  • Routing. A delegation with purpose INCOME, or a pledge with income to the beneficiary, sends the income of the locked units to someone else while the holder keeps them.

Delegation

A holder can delegate units for a period: purpose INCOME routes their income to the delegate, purpose VOTE counts them in the delegate’s voting power (informational; there is no on-chain vote module for assets). The units are locked for the period. The holder can revoke if the delegation is revocable; the delegate can always return it; it ends by itself at until.

Messages

MsgDistribute, MsgClaim, MsgClaimAll, MsgSetDistributionDenoms, MsgDelegate, MsgRevokeDelegation, MsgReturnDelegationReference → Messages.

CLI

aevad tx payout distribute <asset-id> 1 1000000000aeusd --from payer aevad query payout claimable <holder> aevad tx payout claim <asset-id> --from holder aevad tx delegation delegate <asset-id> 1 100 <delegate> 2026-12-31T00:00:00Z INCOME --revocable --from holder

On the explorer

/income  lists distributions and claims. /address/<addr>Income shows an account’s income; /assets/<id>Distributions an asset’s; /delegations/<id> shows a delegation.

Last updated