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 governance):
14//   - LIQUIDITY_STAKER: Rewards for LP providers (default 75%)
15//   - DEVOPS: Development and operations fund (default 20%)
16//   - COMMUNITY_POOL: Community-governed 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//   - SetDistributionStartTime: One-time setup of emission start timestamp
22//   - ChangeDistributionPct: Updates distribution percentages
23//   - ClearDistributedToStaker/GovStaker: Resets pending distribution amounts
24package emission