doc.gno

 1// Package emission manages GNS token emission and distribution for GnoSwap.
 2//
 3// The emission system controls creation and distribution of new GNS tokens
 4// with a deflationary model featuring periodic halvings over 12 years.
 5//
 6// Emission Schedule:
 7//   - Year 1-2:  100% emission rate (225,000,000 GNS/year)
 8//   - Year 3-4:   50% emission rate (112,500,000 GNS/year)
 9//   - Year 5-6:   25% emission rate  (56,250,000 GNS/year)
10//   - Year 7-8:  12.5% emission rate (28,125,000 GNS/year)
11//   - Year 9-12:  6.25% emission rate (14,062,500 GNS/year)
12//
13// Distribution Targets (configurable via admin or governance):
14//   - LIQUIDITY_STAKER: Rewards for LP providers (default 75%)
15//   - DEVOPS: Development and operations fund (default 20%)
16//   - COMMUNITY_POOL: Community treasury (default 5%)
17//   - GOV_STAKER: GNS staking rewards (default 0%)
18//
19// Key Functions:
20//   - MintAndDistributeGns: Mints and distributes GNS per emission schedule;
21//     returns false only when emission is halted.
22//   - SetDistributionStartTime: Sets or reschedules the start timestamp while
23//     it is still in the future; the timestamp is immutable once active.
24//   - ChangeDistributionPct: Updates distribution percentages
25//   - ClearDistributedToStaker/GovStaker: Resets pending distribution amounts
26package emission