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)

delegation.gnogno

1package staker23import (4	"errors"56	gnsmath "gno.land/p/gnoswap/gnsmath/v1"78

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/gov/staker"

11const errCollectAmountExceedsCollectable = "amount to collect is greater than collectable amount"

13type DelegationResolver struct {

14 delegation *staker.Delegation

17// NewDelegationResolver wraps a delegation in a resolver for derived amounts and withdrawals.

20// - delegation: delegation state to resolve

23// - *DelegationResolver: resolver backed by delegation

24func NewDelegationResolver(delegation *staker.Delegation) *DelegationResolver {

25 return &DelegationResolver{delegation}

28// Get returns the underlying delegation state.

31// - *staker.Delegation: wrapped delegation instance

32func (r *DelegationResolver) Get() *staker.Delegation {

33 return r.delegation

36// DelegatedAmount returns total delegated amount minus amount already undelegated.

39// - int64: amount still delegated

40func (r *DelegationResolver) DelegatedAmount() int64 {

41 return gnsmath.SafeSubInt64(r.delegation.TotalDelegatedAmount(), r.delegation.UnDelegatedAmount())

44// LockedAmount returns total delegated amount minus amount already collected.

47// - int64: amount still locked in the delegation

48func (r *DelegationResolver) LockedAmount() int64 {

49 return gnsmath.SafeSubInt64(r.delegation.TotalDelegatedAmount(), r.delegation.CollectedAmount())

52// IsEmpty reports whether no locked delegation amount remains.

55// - bool: true when LockedAmount is zero, otherwise false

56func (r *DelegationResolver) IsEmpty() bool {

57 return r.LockedAmount() == 0

60// CollectableAmount calculates the total amount that can be collected at the given time.

63// - currentTime: current Unix timestamp used to evaluate each withdrawal's lockup

66// - total: sum of all withdrawal amounts currently available for collection

67func (r *DelegationResolver) CollectableAmount(currentTime int64) (total int64) {

68 for _, withdraw := range r.delegation.Withdraws() {

69 total = gnsmath.SafeAddInt64(total, NewDelegationWithdrawResolver(&withdraw).CollectableAmount(currentTime))

75// UnDelegate processes an undelegation with a time-based lockup period.

78// - amount: amount to undelegate and place into a withdrawal

79// - currentHeight: block height at which the undelegation is recorded

80// - currentTimestamp: Unix timestamp at which the undelegation is recorded

81// - unDelegationLockupPeriod: lockup duration in seconds before the withdrawal is collectible

82func (r *DelegationResolver) UnDelegate(

83 amount, currentHeight, currentTimestamp, unDelegationLockupPeriod int64,

85 r.delegation.SetUnDelegateAmount(gnsmath.SafeAddInt64(r.delegation.UnDelegatedAmount(), amount))

87 withdraw := NewDelegationWithdraw(

88 r.delegation.ID(),

91 currentTimestamp,

92 unDelegationLockupPeriod,

94 r.delegation.AddWithdraw(withdraw)

97// UnDelegateWithoutLockup processes an immediate undelegation without lockup.

100// - amount: amount to undelegate and mark as collected immediately

101// - currentHeight: current block height context; retained for API symmetry and unused by this immediate path

102// - currentTime: current Unix timestamp context; retained for API symmetry and unused by this immediate path

103func (r *DelegationResolver) UnDelegateWithoutLockup(

104 amount, currentHeight, currentTime int64,

106 r.delegation.SetUnDelegateAmount(gnsmath.SafeAddInt64(r.delegation.UnDelegatedAmount(), amount))

107 r.delegation.SetCollectedAmount(gnsmath.SafeAddInt64(r.delegation.CollectedAmount(), amount))

110// processCollection handles the actual collection logic

111func (r *DelegationResolver) processCollection(currentTime int64) (int64, error) {

112 collectedAmount := int64(0)

113 withdraws := r.delegation.Withdraws()

115 for i := range withdraws {

116 resolver := NewDelegationWithdrawResolver(&withdraws[i])

118 collectableAmount := resolver.CollectableAmount(currentTime)

119 if collectableAmount <= 0 {

123 err := resolver.Collect(collectableAmount, currentTime)

128 updatedAmount, err := addToCollectedAmount(r.delegation.CollectedAmount(), collectableAmount)

133 r.delegation.SetCollectedAmount(updatedAmount)

134 collectedAmount = gnsmath.SafeAddInt64(collectedAmount, collectableAmount)

137 // Skip filtering if nothing was collected

138 if collectedAmount == 0 {

139 return collectedAmount, nil

142 currentIndex := 0

144 for i := range withdraws {

145 if !withdraws[i].IsCollected() {

146 r.delegation.SetWithdraw(currentIndex, withdraws[i])

151 r.delegation.SetWithdraws(withdraws[:currentIndex])

153 return collectedAmount, nil

156func addToCollectedAmount(collectedAmount, amount int64) (int64, error) {

158 return 0, errors.New(errAmountMustBeNonNegative)

160 return gnsmath.SafeAddInt64(collectedAmount, amount), nil

163// NewDelegation creates a new delegation.

164// This is a convenience wrapper around staker.NewDelegation.

167// - id: delegation ID

168// - delegateFrom: delegator's address

169// - delegateTo: delegatee's address

170// - delegateAmount: amount to delegate

171// - createdHeight: creation block height

172// - createdAt: creation timestamp

175// - *staker.Delegation: new delegation instance

176func NewDelegation(

178 delegateFrom, delegateTo address,

179 delegateAmount, createdHeight, createdAt int64,

180) *staker.Delegation {

181 return staker.NewDelegation(

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

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