emission package

Overview

Package emission manages GNS token emission and distribution for GnoSwap.

The emission system controls creation and distribution of new GNS tokens with a deflationary model featuring periodic halvings over 12 years.

Emission Schedule:

Year 1-2: 100% emission rate (225,000,000 GNS/year)
Year 3-4: 50% emission rate (112,500,000 GNS/year)
Year 5-6: 25% emission rate (56,250,000 GNS/year)
Year 7-8: 12.5% emission rate (28,125,000 GNS/year)
Year 9-12: 6.25% emission rate (14,062,500 GNS/year)

Distribution Targets (configurable via admin or governance):

LIQUIDITY_STAKER: Rewards for LP providers (default 75%)
DEVOPS: Development and operations fund (default 20%)
COMMUNITY_POOL: Community treasury (default 5%)
GOV_STAKER: GNS staking rewards (default 0%)

Key Functions:

MintAndDistributeGns: Mints and distributes GNS per emission schedule; returns false only when emission is halted.
SetDistributionStartTime: Sets or reschedules the start timestamp while it is still in the future; the timestamp is immutable once active.
ChangeDistributionPct: Updates distribution percentages
ClearDistributedToStaker/GovStaker: Resets pending distribution amounts

Function

GetStakerEmissionAmountPerSecondInRange


              func GetStakerEmissionAmountPerSecondInRange(start, end int64) ([]int64, []int64, error)

GetStakerEmissionAmountPerSecondInRange returns liquidity-staker emission-rate change points in a time range.

Parameters:

start: inclusive start Unix timestamp for the range.
end: inclusive end Unix timestamp for the range.

Returns:

timestamps: ordered timestamps in the range where the base emission rate changes.
amountsPerSecond: liquidity-staker GNS rates corresponding to timestamps, in token base units per second.
error: nil when the liquidity-staker distribution share is available; otherwise the target lookup error.

Command

gnokey query vm/qeval -remote "http://127.0.0.1:26657" -data "gno.land/r/gnoswap/emission.GetStakerEmissionAmountPerSecondInRange(,)"

Result