v1 state

assertIsValidDelegateAmount

assertIsValidDelegateAmount validates that the delegation amount meets system requirements. This function checks minimum amount and multiple requirements. Parameters: - amount: amount to validate Returns: - error: nil if valid, error describing validation failure

assertIsValidSnapshotTime

assertIsAvailableCleanupSnapshotTime

assertIsAvailableCleanupSnapshotTime checks that no active proposals need

assertNoSameDelegatee

assertNotImplementYet

minimumAmount

// 1 GNS

maxAccrualBucketsPerCollect

maxStakeEventsPerCollect

errCollectAmountExceedsCollectable

DelegationResolver

NewDelegationResolver

NewDelegationResolver wraps a delegation in a resolver for derived amounts and withdrawals. Parameters: - delegation: delegation state to resolve Returns: - \*DelegationResolver: resolver backed by delegation

addToCollectedAmount

NewDelegation

NewDelegation creates a new delegation. This is a convenience wrapper around staker.NewDelegation. Parameters: - id: delegation ID - delegateFrom: delegator's address - delegateTo: delegatee's address - delegateAmount: amount to delegate - createdHeight: creation block height - createdAt: creation timestamp Returns: - \*staker.Delegation: new delegation instance

DelegationManagerResolver

NewDelegationManagerResolver

NewDelegationManagerResolver creates a resolver over an existing delegation manager. Parameters: - delegationManager: manager whose domain-owned delegation trees will be queried or updated. Returns: - \*DelegationManagerResolver: resolver exposing address-typed delegation operations.

DelegationWithdrawResolver

NewDelegationWithdrawResolver

NewDelegationWithdrawResolver wraps a delegation withdrawal for collection state and lockup calculations. Parameters: - withdraw: delegation withdrawal state to resolve Returns: - \*DelegationWithdrawResolver: resolver retaining the supplied withdrawal pointer

NewDelegationWithdraw

NewDelegationWithdraw creates a new delegation withdrawal with lockup period. This is a convenience wrapper around staker.NewDelegationWithdraw. Parameters: - delegationID: unique identifier of the associated delegation - unDelegateAmount: amount being withdrawn - createdHeight: height when the withdrawal was created - createdAt: timestamp when the withdrawal was created - unDelegationLockupPeriod: duration of the lockup period in seconds Returns: - staker.DelegationWithdraw: new withdrawal instance with lockup

NewDelegationWithdrawWithoutLockup

NewDelegationWithdrawWithoutLockup creates a new delegation withdrawal that is immediately collectable. This is a convenience wrapper around staker.NewDelegationWithdrawWithoutLockup. Parameters: - delegationID: unique identifier of the associated delegation - unDelegateAmount: amount being withdrawn - createdHeight: height when the withdrawal was created - createdAt: timestamp when the withdrawal was created Returns: - staker.DelegationWithdraw: new withdrawal instance that is immediately collectable

EmissionRewardManagerResolver

NewEmissionRewardManagerResolver

NewEmissionRewardManagerResolver wraps an emission reward manager with reward calculation and stake-accounting helpers. Parameters: - emissionRewardManager: manager state to resolve and mutate. Returns: - \*EmissionRewardManagerResolver: resolver backed by emissionRewardManager.

EmissionRewardStateResolver

NewEmissionRewardStateResolver

NewEmissionRewardStateResolver wraps an on-chain emission reward state for reward calculation and stake/claim updates. Parameters: - emissionRewardState: persisted reward state to expose through the resolver Returns: - \*EmissionRewardStateResolver: resolver backed by emissionRewardState

emitUpdateEmissionRewardAccumulation

emitUpdateEmissionRewardAccumulation emits the persisted global emission reward accumulation state so that off-chain indexers can consume the authoritative accumulator instead of re-deriving it. It must be emitted after every path that calls updateAccumulatedRewardX128PerStake (add/remove/claim), otherwise the off-chain accumulator drifts from the contract. All values are read from the manager's persisted state (post-update): - distributedAmount is GetDistributedAmount() (the stored baseline the contract will use for the next delta), not the live emission distribution snapshot. - totalStakedAmount reflects the current total after the stake change and is the divisor for the next accumulation delta.

emitUpdateProtocolFeeStakeAccrual

emitUpdateProtocolFeeStakeAccrual emits the accrual epoch opened by a stake change together with the total stake in force from it, so that off-chain indexers can attribute fees bucketed under that epoch without re-deriving the stake history.

emitUpdateProtocolFeeRewardAccumulation

emitUpdateProtocolFeeRewardAccumulation emits the persisted accumulation state of every token that was just folded. Like the emission variant it must be emitted after every path that folds accrual buckets, otherwise the off-chain accumulator drifts from the contract.

errDataNotFound

errInvalidAmount

errNoDelegatedAmount

errNotEnoughDelegated

errInvalidAddress

errNotEnoughBalance

errLessThanMinimum

errInvalidSnapshotTime

errSameDelegatee

errWithdrawNotCollectable

errAmountMustBeNonNegative

errTotalStakedAmountOverflow

errRemoveAmountExceedsTotalStaked

errRemoveAmountExceedsStaked

errAmountMustBePositive

errRewardDebtUpdateRequired

errDelegatedAmountNegative

errUndelegationAmountNegative

errDelegationNotFound

errInvalidAccrualEpoch

errInvalidAccrualBuckets

makeErrorWithDetails

cloneDelegationEntry

cloneDelegationEntry is the transformation for the delegation tree. Delegation is mutable and its setters are declared in /r/gnoswap/gov/staker, so an external holder of the stored pointer could write realm state through it.

cloneDelegationIDsEntry

cloneDelegationIDsEntry is the transformation for a delegator's delegation tree. The stored value is a slice, so hand out a copy rather than letting a reader write through the shared backing array.

init.50

registerGovStakerV1

initStoreData

govStakerV1

NewGovStakerV1

NewGovStakerV1 creates the governance staker v1 implementation backed by store. Parameters: - store: governance-staker storage interface used by the implementation. Returns: - staker.IGovStaker: governance staker API backed by store.

LaunchpadProjectDepositsResolver

NewLaunchpadProjectDepositsResolver

NewLaunchpadProjectDepositsResolver wraps launchpad project deposit state. Parameters: - launchpadProjectDeposits: project deposit state to resolve and mutate Returns: - \*LaunchpadProjectDepositsResolver: resolver retaining the supplied deposit state pointer

ProtocolFeeRewardManagerResolver

ProtocolFeeRewardManagerResolver drives the ProtocolFeeRewardManager. Stake changes only move the epoch, the total stake history and the staker's own event list. Fees are folded into a token's accumulator when that token is collected, each accrual bucket against the total stake in force during its epoch.

NewProtocolFeeRewardManagerResolver

NewProtocolFeeRewardManagerResolver wraps the shared protocol-fee reward manager. Parameters: - manager: Protocol-fee reward state to resolve and mutate. Returns: - \*ProtocolFeeRewardManagerResolver: resolver operating on manager's accounting state.

maxInt64

minInt64

ProtocolFeeRewardStateResolver

ProtocolFeeRewardStateResolver settles one staker's protocol fee rewards. A staker's reward for a token is the sum, over the segments between their stake events, of the stake held during the segment times the growth of the token's accumulated fee per stake across it. Segments are folded in event order, so the work of settling a token is proportional to the staker's own stake changes since the token was last settled, never to the number of tokens.

NewProtocolFeeRewardStateResolver

NewProtocolFeeRewardStateResolver wraps one staker's protocol fee reward state with settlement operations. Parameters: - protocolFeeRewardState: staker reward state to resolve and mutate. Returns: - \*ProtocolFeeRewardStateResolver: resolver backed by protocolFeeRewardState.

protocolFeeAccumulatorView

protocolFeeAccumulatorView reads a token accumulator as it stands, optionally extended in memory with buckets that are still pending on the protocol fee realm. The extension lets a query report what a collect would pay without folding anything.

protocolFeeTokenSettlement

protocolFeeTokenSettlement is the in-memory working copy of a token's settlement state. It is written back only on a collect, so queries never touch storage.

closeOpenSegment

closeOpenSegment folds the open segment up to the accumulator's latest value. It may only be called once every stake event is settled, so that the open segment really ends at the present.

takeReward

takeReward removes the whole-unit part of the earned reward from the settlement and returns it. The sub-unit remainder stays earned so that no fee share is lost.

segmentRewardX128

segmentRewardX128 returns stakedAmount times the accumulator growth across a segment.

transferToken

transferToken transfers tokens from the staker contract to a recipient address. transferToken handles token transfers for reward distribution. Non-crossing helper: takes \`\_ int, rlm realm\` so the realm token threaded in by the public reward-collection entry points reaches the underlying GRC-20 transfer without forcing each caller to recompute it.

marshal

marshal data to json string

getUint64FromTree

getUint64FromTree returns the uint64 value from the tree

updateUint64InTree

updateUint64InTree updates the uint64 value in the tree

milliToSec

milliToSec converts milliseconds to seconds

userHistoryKeySeparator

userHistoryKeySeparator is chosen to be lexicographically smaller than any

userHistoryKeySeparatorNextWord

userHistoryKeySeparator is chosen to be lexicographically smaller than any

userHistoryTimestampWidth

userHistoryTimestampWidth is the zero-padded width that fits the maximum

makeUserHistoryKey

makeUserHistoryKey builds the composite key "addr|paddedTimestamp" used in the user delegation history BPTree.

userHistoryKeyRange

userHistoryKeyRange returns the half-open prefix range that covers all composite keys belonging to addrStr.

padTimestamp

padTimestamp left-pads timestamp with zeros to userHistoryTimestampWidth so that lexicographic ordering of the resulting strings matches numeric order.

parseUserHistoryKey

parseUserHistoryKey splits a composite key produced by makeUserHistoryKey back into its address and timestamp components.