doc.gno

 1// Package gns implements the GNS governance and utility token for GnoSwap.
 2//
 3// GNS is a GRC20-compliant token with a deflationary emission schedule.
 4// The emission follows a 12-year schedule with halving every 2 years:
 5//   - Years 1-2:  225,000,000 GNS per year (100%)
 6//   - Years 3-4:  112,500,000 GNS per year (50%)
 7//   - Years 5-6:   56,250,000 GNS per year (25%)
 8//   - Years 7-8:   28,125,000 GNS per year (12.5%)
 9//   - Years 9-12:  14,062,500 GNS per year (6.25%)
10//
11// Token Economics:
12//   - Maximum Supply: 1,000,000,000 GNS
13//   - Initial Mint:     100,000,000 GNS
14//   - Total Emission:   900,000,000 GNS
15//
16// Key Functions:
17//   - InitEmissionState: Initializes emission schedule (emission contract only)
18//   - MintGns: Mints tokens per emission schedule (emission contract only)
19//   - Burn: Burns tokens from circulation (admin only)
20//   - Transfer/TransferFrom/Approve: Standard GRC20 operations
21//
22// The emission state tracks accumulated and remaining amounts per halving year,
23// ensuring precise token distribution according to the schedule.
24package gns