x/issuancepolicy — Issuance Policy module
The x/issuancepolicy module encodes the rules under which new tokens may
be minted: schedules, safeguards and policy parameters that staking and
identity allocations must respect. The proposed issuance model uses VEID-led
15-token issuance batches: 14 tokens to eligible active verified humans and
1 token to the Foundation-controlled genesis account. All policy lives in
chain state and can be changed through consensus.
Because policy is a module, changing issuance rules is a governance act with a public proposal trail, not a quiet parameter edit.
What it does
Section titled “What it does”The module holds issuance policy as first-class on-chain state. Policies are created and updated, activated as the active policy, and lifecycle-managed through pause, resume, and deprecation — all as messages rather than off-chain configuration.
Policy is enforced through bounded mechanics: BME mint schedules and staking
rewards execute within the policy’s schedules and safeguards. The module also
exposes its own accounting — Counters tracks issuance against policy, and
ProofMintRecord/ProofMintRecords exposes proof-of-mint records so the
issuance trail can be audited. Under the proposed model, VEID-led batches
issue 15 tokens: 14 to eligible active verified humans and 1 to the
Foundation-controlled genesis account.
Why it exists
Section titled “Why it exists”Monetary credibility requires that issuance be rule-bound and visible. Separating the policy (what may be minted) from the mechanics (how minting executes) means the rules can be audited and governed independently of the machinery.
Primary objects
Section titled “Primary objects”| Concept | Definition |
|---|---|
| Issuance schedule | The governed timetable and limits under which new supply may be minted. |
| Max supply | No fixed maximum or hard cap. Initial supply is zero; new tokens are issued only through verified human identities, with continued issuance as new identities are verified and the human population grows. |
Core flow
Section titled “Core flow”- Encode — Policy becomes state. Issuance rules live in chain state, auditable by anyone, changeable only through consensus.
- Constrain — Mechanics obey bounds. BME mint schedules and staking rewards execute within the policy’s schedules and safeguards.
- Propose — Changes go public. New schedules arrive as governance proposals with open debate and stakeholder vote.
- Enact — Consensus adopts. Approved policy activates through the normal upgrade path, with the trail preserved on-chain.
Messages
Section titled “Messages”| Message | Purpose |
|---|---|
MsgUpsertPolicy | Creates or updates an issuance policy. |
MsgSetActivePolicy | Makes a policy the active issuance policy. |
MsgPausePolicy | Pauses a policy. |
MsgResumePolicy | Resumes a paused policy. |
MsgDeprecatePolicy | Deprecates a policy. |
MsgPauseIssuancePolicy | Pauses issuance under policy control. |
MsgResumeIssuancePolicy | Resumes previously paused issuance. |
MsgUpdateIssuanceParams | Updates issuance-specific parameters. |
MsgUpdateParams | Governance-only update of module parameters. |
Queries
Section titled “Queries”| Query | Purpose |
|---|---|
Policy / Policies | One issuance policy, or all policies. |
ActivePolicy | The currently active issuance policy. |
Counters | Running counters tracking issuance against policy. |
ProofMintRecord / ProofMintRecords | Proof-of-mint records, individually and as a list. |
Params | Current module parameters. |
Module interactions
Section titled “Module interactions”| Module | How they interact |
|---|---|
| x/bme | Mint schedules execute within policy bounds. |
| x/staking | Reward issuance is constrained by governed policy. |
| x/config | Policy parameters are part of governed chain configuration. |
Related documentation
Section titled “Related documentation”- Tokenomics — supply, issuance, and the economics policy protects.
- BME — the minting mechanics policy constrains.
- Staking — reward issuance governed by this policy.
- Governance & Staking — how policy changes become proposals.
- On-Chain Module Map — all 27 modules at a glance.
What is an issuance schedule?
Section titled “What is an issuance schedule?”The governed timetable and limits under which new supply may be minted — the temporal bounds every minting path must respect.
Is there a maximum supply?
Section titled “Is there a maximum supply?”No fixed maximum or hard cap. Initial supply is zero, and new tokens issue only through verified human identities as the verified population grows. See Tokenomics explained.
Why separate policy from mechanics?
Section titled “Why separate policy from mechanics?”So the rules can be audited and governed independently of the minting machinery — monetary credibility requires issuance to be rule-bound and visible. See the x/bme module.