gns state

SECONDS_IN_YEAR

HALVING_START_YEAR

HALVING_END_YEAR

halvingAmountsPerYear

MUST BE IMMUTABLE, DO NOT MODIFY. Annual halving amount - maximum issuance per year

InitEmissionState

InitEmissionState initializes emission schedule with start timestamp. Only callable by emission contract. Sets up 12-year emission schedule with halving every 2 years. Panics if caller is not emission contract.

emissionState

init.6

EmissionState

EmissionState manages emission state and halving data. Tracks emission timing, status, and halving year information for 12-year schedule.

NewEmissionState

NewEmissionState creates a new EmissionState with specified start height and timestamp. Calculates emission end time based on 12-year schedule and initializes halving data.

getEmissionState

getEmissionState returns the singleton emission state instance.

errInvalidYear

errTooManyEmission

errInvalidEmissionAmount

makeErrorWithDetails

GetMaxEmissionAmount

GetMaxEmissionAmount returns the maximum amount of emission allowed.

GetMaximumSupply

GetMaximumSupply returns the maximum supply of gns tokens.

GetInitialMintAmount

GetInitialMintAmount returns the initial amount of gns tokens to be minted.

IsEmissionInitialized

IsEmissionInitialized returns true if emission schedule has been initialized.

IsEmissionActive

IsEmissionActive returns true if emission is currently active based on current time.

IsEmissionEnded

IsEmissionEnded returns true if emission schedule has completed.

GetHalvingYear

GetHalvingYear returns the halving year (1-12) for a given timestamp.

GetCurrentYear

GetCurrentYear returns the current halving year (1-12) or 0 if emission is not active.

GetEmissionAmountPerSecondInRange

GetEmissionAmountPerSecondInRange returns halving timestamps and emission rates for the given time range. Returns two slices: timestamps when halving periods start and corresponding emission rates per second.

GetEmissionAmountPerSecondByTimestamp

GetEmissionAmountPerSecondByTimestamp returns the emission rate per second for a given timestamp. Returns 0 if timestamp is outside emission period.

GetEmissionLeftAmountByTimestamp

GetEmissionLeftAmountByTimestamp returns the remaining emission amount for the halving year at given timestamp. Returns 0 if timestamp is outside emission period.

GetEmissionAccumulatedAmountByTimestamp

GetEmissionAccumulatedAmountByTimestamp returns the accumulated emission amount for the halving year at given timestamp. Returns 0 if timestamp is outside emission period.

GetHalvingYearStartTimestamp

GetHalvingYearStartTimestamp returns the start timestamp for the specified halving year.

GetHalvingYearEndTimestamp

GetHalvingYearEndTimestamp returns the end timestamp for the specified halving year.

GetHalvingYearMaxAmount

GetHalvingYearMaxAmount returns the maximum token issuance for the specified halving year.

GetHalvingYearMintAmount

GetHalvingYearMintAmount returns the amount of tokens minted for the specified halving year.

GetHalvingYearLeftAmount

GetHalvingYearLeftAmount returns the remaining token issuance for the specified halving year.

GetHalvingYearAccuAmount

GetHalvingYearAccuAmount returns the accumulated token issuance for the specified halving year.

GetAmountPerSecondPerHalvingYear

GetAmountPerSecondPerHalvingYear returns the emission rate per second for the specified halving year.

GetHalvingAmountsPerYear

GetHalvingAmountsPerYear returns the total emission amount allocated for the specified year. Returns 0 if year is outside the valid range (1-12).

GetEmissionCreatedHeight

GetEmissionCreatedHeight returns the block height when emission schedule was created.

GetEmissionStartTimestamp

GetEmissionStartTimestamp returns the timestamp when emission schedule begins.

GetEmissionEndTimestamp

GetEmissionEndTimestamp returns the timestamp when emission schedule ends.

GetHalvingYearInfo

GetHalvingYearInfo returns the halving year, start timestamp, and end timestamp for a given timestamp. Returns (year, startTimestamp, endTimestamp). Year is 0 if outside emission period.

GetHalvingInfo

GetHalvingInfo returns a clone of the halving data.

CalculateMintGnsAmount

CalculateMintGnsAmount returns the amount of GNS that would be minted for the given timestamp range.

tokenID

MAXIMUM_SUPPLY

INITIAL_MINT_AMOUNT

MAX_EMISSION_AMOUNT

// MAXIMUM\_SUPPLY - INITIAL\_MINT\_AMOUNT

token

privateLedger

userTeller

leftEmissionAmount

// amount of GNS can be minted for emission

mintedEmissionAmount

// amount of GNS that has been minted for emission

lastMintedTimestamp

// last block time that gns was minted for emission

init.50

Name

Name returns the name of the GNS token.

Symbol

Symbol returns the symbol of the GNS token.

Decimals

Decimals returns the number of decimal places for GNS token.

TotalSupply

TotalSupply returns the total supply of GNS tokens in circulation.

KnownAccounts

KnownAccounts returns the number of addresses that have held GNS.

BalanceOf

BalanceOf returns the GNS balance of a specific address.

Allowance

Allowance returns the amount of GNS that a spender is allowed to transfer from an owner.

MintGns

MintGns mints new GNS tokens according to the emission schedule. Parameters: - address: recipient address for minted tokens Returns amount minted. Only callable by emission contract. Note: Halt check is performed by the caller (emission.MintAndDistributeGns) to allow graceful handling. This function assumes caller has already verified halt status before invoking.

Transfer

Transfer transfers GNS tokens from caller to recipient. Parameters: - to: recipient address - amount: amount to transfer

Approve

Approve allows spender to transfer GNS tokens from caller's account. Parameters: - spender: address authorized to spend - amount: maximum amount spender can transfer

TransferFrom

TransferFrom transfers GNS tokens on behalf of owner. Parameters: - from: token owner address - to: recipient address - amount: amount to transfer

Render

Render returns token information for web interface.

checkErr

checkErr panics if error is not nil.

calculateAmountToMint

calculateAmountToMint calculates and allocates GNS tokens to mint for given timestamp range. This function has side effects: it updates the accumulated and remaining amounts for each halving year in the emission state.

LastMintedTimestamp

LastMintedTimestamp returns the timestamp of the last GNS emission mint.

LeftEmissionAmount

LeftEmissionAmount returns the remaining GNS tokens available for emission.

MintedEmissionAmount

MintedEmissionAmount returns the total GNS tokens minted through emission, excluding the initial mint amount.

setLastMintedTimestamp

setLastMintedTimestamp sets the timestamp of the last emission mint.

setLeftEmissionAmount

setLeftEmissionAmount sets the remaining emission amount.

setMintedEmissionAmount

setMintedEmissionAmount sets the total minted emission amount.

HalvingData

HalvingData stores emission data for each halving period. Contains timestamps, amounts, and rates for the 12-year emission schedule.

NewHalvingData

NewHalvingData creates a new HalvingData instance with emission schedule. Initializes 12 years of halving periods with timestamps, amounts, and rates based on startTimestamp.

validYear

validYear validates that year is within halving period range (1-12). Returns error if year is outside the valid range.

validEmissionAmount

validEmissionAmount validates that the emission amount does not exceed maximum. Returns error if minting the amount would exceed MAX\_EMISSION\_AMOUNT.

i64Min

i64Min returns the smaller of two int64 values.