emission state

assertValidDistributionTarget

assertValidDistributionTarget panics if the given distribution target is invalid.

assertValidDistributionPct

assertValidDistributionPct ensures the sum of all distribution percentages equals 10000 (100%). Panics if the sum does not equal exactly 10000 basis points.

LIQUIDITY_STAKER

DEVOPS

COMMUNITY_POOL

GOV_STAKER

distributionBpsPct

distributedToStaker

// can be cleared by staker contract

distributedToDevOps

distributedToCommunityPool

distributedToGovStaker

// can be cleared by governance staker

accuDistributedToStaker

accuDistributedToDevOps

accuDistributedToCommunityPool

accuDistributedToGovStaker

init.15

ChangeDistributionPct

ChangeDistributionPct changes distribution percentages for emission targets. This function redistributes how newly minted GNS tokens are allocated across protocol components. Before applying new ratios, it distributes any accumulated emissions using the current ratios, ensuring emissions are distributed according to the ratios in effect when they were generated. This prevents retroactive application of new ratios to past emissions. Parameters: - liquidityStakerPct: Percentage for liquidity stakers in basis points (100 = 1%, 10000 = 100%) - devOpsPct: Percentage for devops in basis points - communityPoolPct: Percentage for community pool in basis points - govStakerPct: Percentage for governance stakers in basis points Requirements: - Percentages must sum to exactly 10000 (100%) - Each percentage must be 0-10000 Example: ChangeDistributionPct( 7000, // 70% to liquidity stakers 2000, // 20% to devops 1000, // 10% to community pool 0, // 0% to governance stakers ) Only callable by admin or governance.

changeDistributionPcts

changeDistributionPcts updates the distribution percentages for all targets.

calculateDistributableAmounts

calculateAmount

calculateAmount converts basis points to actual token amount.

applyDistribution

transferToTarget

GetDistributionBpsPct

GetDistributionBpsPct returns the distribution percentage in basis points for a specific target.

GetDistributedToStaker

GetDistributedToStaker returns pending GNS for liquidity stakers.

GetDistributedToDevOps

GetDistributedToDevOps returns accumulated GNS for DevOps.

GetDistributedToCommunityPool

GetDistributedToCommunityPool returns the amount of GNS distributed to Community Pool.

GetDistributedToGovStaker

GetDistributedToGovStaker returns the amount of GNS distributed to governance stakers since last clear.

AccumulateDistributedInfo

GetAccuDistributedToStaker

GetAccuDistributedToStaker returns the total historical GNS distributed to liquidity stakers.

GetAccuDistributedToDevOps

GetAccuDistributedToDevOps returns the total historical GNS distributed to DevOps.

GetAccuDistributedToCommunityPool

GetAccuDistributedToCommunityPool returns the total historical GNS distributed to Community Pool.

GetAccuDistributedToGovStaker

GetAccuDistributedToGovStaker returns the total historical GNS distributed to governance stakers.

GetEmissionAmountPerSecondBy

GetEmissionAmountPerSecondBy returns the emission amount per second for a given timestamp and distribution percentage.

GetStakerEmissionAmountPerSecond

GetStakerEmissionAmountPerSecond returns the current per-second emission amount allocated to liquidity stakers.

GetStakerEmissionAmountPerSecondInRange

GetStakerEmissionAmountPerSecondInRange returns emission amounts allocated to liquidity stakers for a time range.

ClearDistributedToStaker

ClearDistributedToStaker resets the pending distribution amount for liquidity stakers. Only callable by staker contract.

ClearDistributedToGovStaker

ClearDistributedToGovStaker resets the pending distribution amount for governance stakers. Only callable by governance staker contract.

setDistributionBpsPct

setDistributionBpsPct changes percentage of each target for how much GNS it will get by emission. Creates new map if nil.

targetToStr

targetToStr converts target constant to string representation.

totalDistributionDuration

// 12 years

leftGNSAmount

lastExecutedTimestamp

emissionAddr

distributionStartTimestamp

onDistributionPctChangeCallback

init.45

setLeftGNSAmount

setLeftGNSAmount updates the undistributed GNS token amount

setLastExecutedTimestamp

setLastExecutedTimestamp updates the timestamp of the last emission distribution execution.

MintAndDistributeGns

MintAndDistributeGns mints and distributes GNS tokens according to the emission schedule. This function is called automatically by protocol contracts during user interactions to trigger periodic GNS emission. It mints new tokens based on elapsed time since last distribution and distributes them to predefined targets (staker, devops, etc.). Returns: - int64: Total amount of GNS distributed in this call Note: Distribution only occurs if start timestamp is set and reached. Any undistributed tokens from previous calls are carried forward.

SetDistributionStartTime

SetDistributionStartTime sets the timestamp when emission distribution starts. This function controls when GNS emission begins. Once set and reached, the protocol starts minting GNS tokens according to the emission schedule. The timestamp can only be set before distribution starts - it becomes immutable once active. Parameters: - startTimestamp: Unix timestamp when emission should begin Requirements: - Must be called before distribution starts (one-time setup) - Timestamp must be in the future - Cannot be negative Effects: - Sets global distribution start time - Initializes GNS emission state if not already started - Emission begins automatically when timestamp is reached Only callable by admin or governance.

SetOnDistributionPctChangeCallback

SetOnDistributionPctChangeCallback sets a callback function to be called when distribution percentages change. This allows external contracts (like staker) to update their internal caches when governance changes emission rates. Only callable by the staker contract.

errInvalidEmissionTarget

errInvalidEmissionPct

errDuplicateTarget

errDistributionAddressNotFound

makeErrorWithDetails

makeErrorWithDetails creates a new error by combining a base error with additional details.

GetLeftGNSAmount

GetLeftGNSAmount returns the amount of undistributed GNS tokens from previous distributions.

GetDistributionStartTimestamp

GetDistributionStartTimestamp returns the timestamp when emission distribution started. Returns 0 if distribution has not been started yet.

GetLastExecutedTimestamp

GetLastExecutedTimestamp returns the timestamp of the last emission distribution execution.

GetAllDistributionBpsPct

GetAllDistributionBpsPct returns all distribution percentages in basis points.

GetTotalAccuDistributed

GetTotalAccuDistributed returns the total accumulated distributed GNS amount.

GetTotalDistributed

GetTotalDistributed returns the total pending distributed GNS amount.

GetDistributionEndTimestamp

GetDistributionEndTimestamp returns the timestamp when emission distribution ends. Returns 0 if distribution has not been started yet.

GetDistributableAmount

GetDistributableAmount returns distribution amounts by target and the remainder. If timestamp is outside the distribution window, it returns an empty map and the full amount as left.