gno.land/r/gnoswap/gov/staker/v1

Realm

Overview

Kind: Realm (renderable)
Name: v1
Namespace: gnoswap / gov / staker
Files: 25 (README)(gnomod.toml)
Exported functions: 12
Module: gno.land/r/gnoswap/gov/staker/v1
gno: 0.9

Files (25)

staker_delegation_snapshot.gnogno

1package staker23import (4	"chain"56	"gno.land/p/gnoswap/utils/v1"7	"gno.land/r/gnoswap/access/v1"8

Functions

NewDelegation(id int64, delegateFrom string, delegateTo string, delegateAmount int64, createdHeight int64, createdAt int64) *gno.land/r/gnoswap/gov/staker.Delegation
NewDelegationManagerResolver(delegationManager *gno.land/r/gnoswap/gov/staker.DelegationManager) *gno.land/r/gnoswap/gov/staker/v1.DelegationManagerResolver
NewDelegationResolver(delegation *gno.land/r/gnoswap/gov/staker.Delegation) *gno.land/r/gnoswap/gov/staker/v1.DelegationResolver
NewDelegationWithdraw(delegationID int64, unDelegateAmount int64, createdHeight int64, createdAt int64, unDelegationLockupPeriod int64) struct{delegationID int64; unDelegateAmount int64; unDelegatedHeight int64; unDelegatedAt int64; collectedAmount int64; collectableTime int64; collectedAt int64; collected bool}
NewDelegationWithdrawResolver(withdraw *gno.land/r/gnoswap/gov/staker.DelegationWithdraw) *gno.land/r/gnoswap/gov/staker/v1.DelegationWithdrawResolver
NewDelegationWithdrawWithoutLockup(delegationID int64, unDelegateAmount int64, createdHeight int64, createdAt int64) struct{delegationID int64; unDelegateAmount int64; unDelegatedHeight int64; unDelegatedAt int64; collectedAmount int64; collectableTime int64; collectedAt int64; collected bool}
NewEmissionRewardManagerResolver(emissionRewardManager *gno.land/r/gnoswap/gov/staker.EmissionRewardManager) *gno.land/r/gnoswap/gov/staker/v1.EmissionRewardManagerResolver
NewEmissionRewardStateResolver(emissionRewardState *gno.land/r/gnoswap/gov/staker.EmissionRewardState) *gno.land/r/gnoswap/gov/staker/v1.EmissionRewardStateResolver
NewGovStakerV1(store interface {GetAllDelegations func() *gno.land/p/nt/bptree/v0.BPTree; GetDelegation func(int64) (*gno.land/r/gnoswap/gov/staker.Delegation, bool); GetDelegationCounter func() *gno.land/r/gnoswap/gov/staker.Counter; GetDelegationManager func() *gno.land/r/gnoswap/gov/staker.DelegationManager; GetEmissionRewardManager func() *gno.land/r/gnoswap/gov/staker.EmissionRewardManager; GetLaunchpadProjectDeposits func() *gno.land/r/gnoswap/gov/staker.LaunchpadProjectDeposits; GetProtocolFeeRewardManager func() *gno.land/r/gnoswap/gov/staker.ProtocolFeeRewardManager; GetTotalDelegatedAmount func() int64; GetTotalDelegationHistory func() *gno.land/r/gnoswap/gov/staker.UintTree; GetTotalLockedAmount func() int64; GetUnDelegationLockupPeriod func() int64; GetUserDelegationHistory func() *gno.land/p/nt/bptree/v0.BPTree; HasDelegation func(int64) bool; HasDelegationCounterStoreKey func() bool; HasDelegationManagerStoreKey func() bool; HasDelegationsStoreKey func() bool; HasEmissionRewardManagerStoreKey func() bool; HasLaunchpadProjectDepositsStoreKey func() bool; HasProtocolFeeRewardManagerStoreKey func() bool; HasTotalDelegatedAmountStoreKey func() bool; HasTotalDelegationHistoryStoreKey func() bool; HasTotalLockedAmountStoreKey func() bool; HasUnDelegationLockupPeriodStoreKey func() bool; HasUserDelegationHistoryStoreKey func() bool; RemoveDelegation func(int, .uverse.realm, int64) .uverse.error; SetDelegation func(int, .uverse.realm, int64, *gno.land/r/gnoswap/gov/staker.Delegation) .uverse.error; SetDelegationCounter func(int, .uverse.realm, *gno.land/r/gnoswap/gov/staker.Counter) .uverse.error; SetDelegationManager func(int, .uverse.realm, *gno.land/r/gnoswap/gov/staker.DelegationManager) .uverse.error; SetDelegations func(int, .uverse.realm, *gno.land/p/nt/bptree/v0.BPTree) .uverse.error; SetEmissionRewardManager func(int, .uverse.realm, *gno.land/r/gnoswap/gov/staker.EmissionRewardManager) .uverse.error; SetLaunchpadProjectDeposits func(int, .uverse.realm, *gno.land/r/gnoswap/gov/staker.LaunchpadProjectDeposits) .uverse.error; SetProtocolFeeRewardManager func(int, .uverse.realm, *gno.land/r/gnoswap/gov/staker.ProtocolFeeRewardManager) .uverse.error; SetTotalDelegatedAmount func(int, .uverse.realm, int64) .uverse.error; SetTotalDelegationHistory func(int, .uverse.realm, *gno.land/r/gnoswap/gov/staker.UintTree) .uverse.error; SetTotalLockedAmount func(int, .uverse.realm, int64) .uverse.error; SetUnDelegationLockupPeriod func(int, .uverse.realm, int64) .uverse.error; SetUserDelegationHistory func(int, .uverse.realm, *gno.land/p/nt/bptree/v0.BPTree) .uverse.error}) interface {CleanStakerDelegationSnapshotByAdmin func(int, .uverse.realm, int64, .uverse.address); CollectEmissionReward func(int, .uverse.realm); CollectEmissionRewardFromLaunchPad func(int, .uverse.realm, .uverse.address); CollectProtocolFeeReward func(int, .uverse.realm, string); CollectProtocolFeeRewardFromLaunchPad func(int, .uverse.realm, .uverse.address, string); CollectReward func(int, .uverse.realm); CollectRewardFromLaunchPad func(int, .uverse.realm, .uverse.address); CollectUndelegatedGns func(int, .uverse.realm) int64; Delegate func(int, .uverse.realm, .uverse.address, int64, string) int64; ExistsDelegation func(int64) bool; GetClaimableRewardByAddress func(.uverse.address) (int64, map[string]int64, .uverse.error); GetClaimableRewardByLaunchpad func(.uverse.address) (int64, map[string]int64, .uverse.error); GetClaimableRewardByRewardID func(string) (int64, map[string]int64, .uverse.error); GetCollectableWithdrawAmount func(int64) int64; GetDelegationWithdrawCount func(int64) int; GetDelegationWithdraws func(int64, int, int) ([]gno.land/r/gnoswap/gov/staker.DelegationWithdraw, .uverse.error); GetDelegations func() *gno.land/p/nt/bptree/rotree/v0.ReadOnlyTree; GetDelegatorDelegations func(.uverse.address) *gno.land/p/nt/bptree/rotree/v0.ReadOnlyTree; GetEmissionAccumulatedTimestamp func() int64; GetEmissionAccumulatedX128PerStake func() *gno.land/p/gnoswap/uint256/v1.Uint; GetEmissionDistributedAmount func() int64; GetLaunchpadProjectDeposit func(string) (int64, bool); GetProtocolFeeAccumulatedTimestamp func() int64; GetProtocolFeeAccumulatedX128PerStake func(string) *gno.land/p/gnoswap/uint256/v1.Uint; GetProtocolFeeAmount func(string) int64; GetTotalDelegated func() int64; GetTotalDelegationAmountAtSnapshot func(int64) (int64, bool); GetTotalLockedAmount func() int64; GetTotalxGnsSupply func() int64; GetUnDelegationLockupPeriod func() int64; GetUserDelegationAmountAtSnapshot func(.uverse.address, int64) (int64, bool); GetUserDelegationIDs func(.uverse.address, .uverse.address) []int64; HasDelegationSnapshotsKey func() bool; Redelegate func(int, .uverse.realm, .uverse.address, .uverse.address, int64) int64; Render func(string) string; SetAmountByProjectWallet func(int, .uverse.realm, .uverse.address, int64, bool); SetUnDelegationLockupPeriodByAdmin func(int, .uverse.realm, int64); Undelegate func(int, .uverse.realm, .uverse.address, int64) int64}
NewLaunchpadProjectDepositsResolver(launchpadProjectDeposits *gno.land/r/gnoswap/gov/staker.LaunchpadProjectDeposits) *gno.land/r/gnoswap/gov/staker/v1.LaunchpadProjectDepositsResolver
NewProtocolFeeRewardManagerResolver(manager *gno.land/r/gnoswap/gov/staker.ProtocolFeeRewardManager) *gno.land/r/gnoswap/gov/staker/v1.ProtocolFeeRewardManagerResolver
NewProtocolFeeRewardStateResolver(protocolFeeRewardState *gno.land/r/gnoswap/gov/staker.ProtocolFeeRewardState) *gno.land/r/gnoswap/gov/staker/v1.ProtocolFeeRewardStateResolver

Signatures reconstructed verbatim from vm/qfuncs — interface params keep their inline definitions.

Rendered

Rendered Raw gnoweb ↗

This realm does not provide renderable output (vm/qrender → NoRenderDeclError). View on gnoweb ↗

vm/qrender output, sanitized (docs/render-security.md) and displayed in an empty-sandbox iframe — scripts, forms and popups cannot run. Links stay inert in-preview; right-click to open.

"gno.land/r/gnoswap/halt/v1"

11// SetUnDelegationLockupPeriodByAdmin sets the undelegation lockup period.

12// This administrative function configures the time period that undelegated tokens

13// must wait before they can be collected by users.

15// The lockup period serves as a security mechanism to:

16// - Prevent rapid delegation/undelegation cycles

17// - Provide time for governance decisions to take effect

18// - Maintain system stability during volatile periods

21// - _: leading realm-call discriminator; callers pass 0 for the forwarded implementation call

22// - rlm: propagated current realm context validated before administrative state updates

23// - period: lockup period in seconds (must be non-negative)

26// - if caller is not admin

27// - if period is negative

29// Note: This change affects all future undelegation operations

30func (gs *govStakerV1) SetUnDelegationLockupPeriodByAdmin(_ int, rlm realm, period int64) {

31 access.AssertIsRlmCurrent(0, rlm)

33 halt.AssertIsNotHaltedGovStaker()

35 prev := rlm.Previous()

36 caller := prev.Address()

37 access.AssertIsAdmin(caller)

40 panic("period must be greater than 0")

43 gs.setUnDelegationLockupPeriod(0, rlm, period)

46 "SetUnDelegationLockupPeriod",

47 "prevAddr", prev.Address().String(),

48 "prevRealm", prev.PkgPath(),

49 "period", utils.FormatInt(period),

53// CleanStakerDelegationSnapshotByAdmin cleans old delegation history records.

54// This administrative function removes delegation history records older than the specified threshold

55// to prevent unlimited growth of historical data and optimize storage usage.

57// The cleanup process:

58// 1. Validates the snapshot time is within allowed range

59// 2. Checks that no active proposals need data older than the cleanup threshold

60// 3. Filters delegation history to keep only records after cutoff time

61// 4. Updates the delegation history with filtered records

64// - _: leading realm-call discriminator; callers pass 0 for the forwarded implementation call

65// - rlm: propagated current realm context validated before administrative state updates

66// - snapshotTime: cutoff timestamp (records older than this will be removed)

67// - target: the user address whose delegation history should be cleaned

70// - if caller is not admin

71// - if snapshotTime is invalid (negative or too recent)

72// - if active proposals have snapshotTime older than the cleanup threshold

73func (gs *govStakerV1) CleanStakerDelegationSnapshotByAdmin(_ int, rlm realm, snapshotTime int64, target address) {

74 access.AssertIsRlmCurrent(0, rlm)

76 halt.AssertIsNotHaltedGovStaker()

78 prev := rlm.Previous()

79 caller := prev.Address()

80 access.AssertIsAdmin(caller)

82 assertIsValidSnapshotTime(snapshotTime)

83 assertIsAvailableCleanupSnapshotTime(snapshotTime)

85 // Clean total delegation history

86 gs.cleanTotalDelegationHistory(0, rlm, snapshotTime)

88 // Clean user delegation history

89 gs.cleanUserDelegationHistoryForAddress(0, rlm, target, snapshotTime)

92 "CleanStakerDelegationSnapshot",

93 "prevAddr", prev.Address().String(),

94 "prevRealm", prev.PkgPath(),

95 "snapshotTime", utils.FormatInt(snapshotTime),

96 "target", target.String(),

100// cleanTotalDelegationHistory removes total delegation history entries older than cutoff time.

101// Keeps the most recent entry before cutoff to preserve state continuity.

102func (gs *govStakerV1) cleanTotalDelegationHistory(_ int, rlm realm, cutoffTimestamp int64) {

103 history := gs.store.GetTotalDelegationHistory()

105 // First, find the most recent entry before cutoff to preserve state

106 var lastValue any

108 hasLastValue := false

110 history.ReverseIterate(0, cutoffTimestamp, func(timestamp int64, value any) bool {

111 lastValue = value

112 hasLastValue = true

114 return true // stop after first (most recent)

117 // If there was a value before cutoff, set it at cutoff time to preserve continuity

118 if hasLastValue && !history.Has(cutoffTimestamp) {

119 history.Set(cutoffTimestamp, lastValue)

122 // Collect keys to remove (cannot modify tree during iteration)

123 var keysToRemove []int64

124 history.Iterate(0, cutoffTimestamp, func(timestamp int64, _ any) bool {

125 keysToRemove = append(keysToRemove, timestamp)

126 return false // continue

128 for _, key := range keysToRemove {

129 history.Remove(key)

132 if err := gs.store.SetTotalDelegationHistory(0, rlm, history); err != nil {

137// cleanUserDelegationHistoryForAddress removes user delegation history entries

138// older than cutoff time for a single target address.

139// Keeps the most recent entry strictly before cutoff

140// in place so range-based snapshot lookups continue to resolve correctly.

141func (gs *govStakerV1) cleanUserDelegationHistoryForAddress(_ int, rlm realm, target address, cutoffTimestamp int64) {

142 if cutoffTimestamp <= 0 {

146 history := gs.store.GetUserDelegationHistory()

148 addrStr := target.String()

149 iterationStartKey, _ := userHistoryKeyRange(addrStr)

150 iterationEndKey := makeUserHistoryKey(addrStr, cutoffTimestamp)

152 // First, find the most recent entry before cutoff to preserve state

153 var lastValue any

155 hasLastValue := false

157 history.ReverseIterate(iterationStartKey, iterationEndKey, func(key string, value any) bool {

158 lastValue = value

159 hasLastValue = true

161 return true // stop after first (most recent)

164 if hasLastValue && !history.Has(iterationEndKey) {

165 history.Set(iterationEndKey, lastValue)

168 // Collect all keys strictly before preserveKey within this address prefix.

169 // Iterate's end is exclusive, so [lo, preserveKey) skips the preserved entry.

170 var keysToRemove []string

172 history.Iterate(iterationStartKey, iterationEndKey, func(key string, _ any) bool {

173 keysToRemove = append(keysToRemove, key)

178 for _, key := range keysToRemove {

179 history.Remove(key)

182 if err := gs.store.SetUserDelegationHistory(0, rlm, history); err != nil {

gno.land/r/gnoswap/gov/staker/v1⧉

gno.land/r/gnoswap/gov/staker/v1