launchpad state

Counter

Counter manages unique incrementing IDs.

NewCounter

NewCounter creates a new Counter starting at 0.

Deposit

Deposit represents a deposit made by a user in a launchpad project. This struct contains the necessary data and methods to manage and distribute rewards for a specific deposit. Fields: - depositor (std.Address): The address of the depositor. - id (string): The unique identifier for the deposit. - projectID (string): The ID of the project associated with the deposit. - tier (int64): The tier of the deposit. - depositAmount (int64): The amount of the deposit. - withdrawnHeight (int64): The height at which the deposit was withdrawn. - withdrawnTime (int64): The time when the deposit was withdrawn. - createdTime (int64): The time when the deposit was created. - endTime (int64): The time when the deposit ends.

NewDeposit

NewDeposit returns a pointer to a new Deposit with the given values.

ErrSpoofedRealm

GetProjectCount

GetProjectCount returns the total number of projects.

GetProjectIDs

GetProjectIDs returns a paginated list of project IDs.

GetProject

GetProject retrieves a project by its ID. Returns a cloned project to prevent external modification.

GetProjectName

GetProjectName returns the name of a project by its ID.

GetProjectTokenPath

GetProjectTokenPath returns the token path of a project by its ID.

GetProjectDepositAmount

GetProjectDepositAmount returns the deposit amount of a project by its ID.

GetProjectRecipient

GetProjectCondition

GetProjectCondition retrieves a specific condition of a project. Returns a cloned condition to prevent external modification.

GetProjectTiersRatios

GetProjectTiersRatios returns the tiers ratios map of a project by its ID.

GetProjectCreatedHeight

GetProjectCreatedHeight returns the created height of a project by its ID.

GetProjectCreatedAt

GetProjectCreatedAt returns the created time of a project by its ID.

GetProjectTier

GetProjectTier retrieves a specific tier of a project. Returns a cloned tier to prevent external modification.

GetProjectTierDistributeAmountPerSecondX128

GetProjectTierDistributeAmountPerSecondX128 returns the distribute amount per second (Q128) of a project tier.

GetProjectTierTotalDistributeAmount

GetProjectTierTotalDistributeAmount returns the total distribute amount of a project tier.

GetProjectTierTotalDepositAmount

GetProjectTierTotalDepositAmount returns the total deposit amount of a project tier.

GetProjectTierTotalWithdrawAmount

GetProjectTierTotalWithdrawAmount returns the total withdraw amount of a project tier.

GetProjectTierTotalDepositCount

GetProjectTierTotalDepositCount returns the total deposit count of a project tier.

GetProjectTierTotalWithdrawCount

GetProjectTierTotalWithdrawCount returns the total withdraw count of a project tier.

GetProjectTierTotalCollectedAmount

GetProjectTierTotalCollectedAmount returns the total collected amount of a project tier.

GetProjectTierStartTime

GetProjectTierStartTime returns the start time of a project tier.

GetProjectTierEndTime

GetProjectTierEndTime returns the end time of a project tier.

GetDepositCount

GetDepositCount returns the total number of deposits.

GetCurrentDepositId

GetCurrentDepositId returns the current deposit counter value.

GetProjectTierDepositCount

GetProjectTierDepositCount returns the total number of deposits for a project tier.

GetProjectTierDepositIDs

GetProjectTierDepositIDs returns a paginated list of deposit IDs for a project tier.

GetDeposit

GetDeposit retrieves a deposit by its ID. Returns a cloned deposit to prevent external modification.

GetDepositProjectID

GetDepositProjectID returns the project ID of a deposit by its ID.

GetDepositTier

GetDepositTier returns the tier of a deposit by its ID.

GetDepositProjectTierID

GetDepositProjectTierID returns the project tier ID of a deposit by its ID.

GetDepositAmount

GetDepositAmount returns the deposit amount of a deposit by its ID.

GetDepositWithdrawnHeight

GetDepositWithdrawnHeight returns the withdrawn height of a deposit by its ID.

GetDepositWithdrawnTime

GetDepositWithdrawnTime returns the withdrawn time of a deposit by its ID.

GetDepositCreatedHeight

GetDepositCreatedHeight returns the created height of a deposit by its ID.

GetDepositCreatedAt

GetDepositCreatedAt returns the created time of a deposit by its ID.

GetDepositEndTime

GetDepositEndTime returns the end time of a deposit by its ID.

GetTotalGNSStakedAmount

GetTotalGNSStakedAmount returns the total amount of GNS currently staked across all launchpad deposits.

GetProjectTierRewardManagerCount

GetProjectTierRewardManagerCount returns the total number of reward managers.

GetProjectTierRewardManager

GetProjectTierRewardManager retrieves a reward manager by project tier ID. Returns a cloned reward manager to prevent external modification.

GetProjectTierRewardDistributeAmountPerSecondX128

GetProjectTierRewardDistributeAmountPerSecondX128 returns the distribute amount per second (Q128) of a reward manager.

GetProjectTierRewardAccumulatedRewardPerDepositX128

GetProjectTierRewardAccumulatedRewardPerDepositX128 returns the accumulated reward per deposit (Q128) of a reward manager.

GetProjectTierRewardTotalDistributeAmount

GetProjectTierRewardTotalDistributeAmount returns the total distribute amount of a reward manager.

GetProjectTierRewardTotalClaimedAmount

GetProjectTierRewardTotalClaimedAmount returns the total claimed amount of a reward manager.

GetProjectTierRewardDistributeStartTime

GetProjectTierRewardDistributeStartTime returns the distribute start time of a reward manager.

GetProjectTierRewardDistributeEndTime

GetProjectTierRewardDistributeEndTime returns the distribute end time of a reward manager.

GetProjectTierRewardAccumulatedDistributeAmount

GetProjectTierRewardAccumulatedDistributeAmount returns the accumulated distribute amount of a reward manager.

GetProjectTierRewardAccumulatedTime

GetProjectTierRewardAccumulatedTime returns the accumulated time of a reward manager.

GetProjectTierRewardClaimableDuration

GetProjectTierRewardClaimableDuration returns the reward claimable duration of a reward manager.

GetRewardState

GetRewardState retrieves a reward state by project tier ID and deposit ID. Returns a cloned reward state to prevent external modification.

GetProjectActiveStatus

GetProjectActiveStatus returns whether a project is currently active.

cloneStringSlice

cloneInt64Map

Project

Project represents a launchpad project. This struct contains the necessary data and methods to manage and distribute rewards for a specific project. Fields: - id (string): The unique identifier for the project, formatted as "{tokenPath}:{createdHeight}". - name (string): The name of the project. - tokenPath (string): The path of the token associated with the project. - depositAmount (int64): The total amount of tokens deposited for the project. - recipient (std.Address): The address to receive the project's rewards. - conditions (map\[string]\*ProjectCondition): A map of token paths to their associated conditions. - tiers (map\[int64]\*ProjectTier): A map of tier durations to their associated tiers. - tiersRatios (map\[int64]int64): A map of tier durations to their associated ratios. - createdBlockTimeInfo (BlockTimeInfo): The block time and height information for the creation of the project.

NewProject

MakeProjectID

MakeProjectID generates a unique project ID based on the given token path and the current block height. The generated ID combines the \`tokenPath\` and the current block height in the following format: "{tokenPath}:{height}" Parameters: - tokenPath (string): The path of the token associated with the project. Returns: - string: A unique project ID in the format "tokenPath:height".

stringSplitterPad

ProjectCondition

ProjectCondition represents a condition for a project. This struct contains the necessary data and methods to manage and distribute rewards for a specific project. Fields: - tokenPath (string): The path of the token associated with the project. - minimumAmount (int64): The minimum amount of the token required for the project.

NewProjectCondition

NewProjectConditionsWithError

ProjectTier

ProjectTier represents a tier within a project. This struct contains the necessary data and methods to manage and distribute rewards for a specific tier of a project. Fields: - distributeAmountPerSecondX128 (u256.Uint): The amount of tokens to be distributed per second, represented as a Q128 fixed-point number. - startTime (int64): The time for the start of the tier. - endTime (int64): The time for the end of the tier. - id (string): The unique identifier for the tier, formatted as "{projectID}:duration". - totalDistributeAmount (int64): The total amount of tokens to be distributed for the tier. - totalDepositAmount (int64): The total amount of tokens deposited for the tier. - totalWithdrawAmount (int64): The total amount of tokens withdrawn from the tier. - totalDepositCount (int64): The total number of deposits made to the tier. - totalWithdrawCount (int64): The total number of withdrawals from the tier. - totalCollectedAmount (int64): The total amount of tokens collected as rewards for the tier.

NewProjectTier

NewProjectTier returns a pointer to a new ProjectTier with the given values.

MakeProjectTierID

MakeProjectTierID generates a unique tier ID based on the given project ID and the tier duration. The generated ID combines the \`projectId\` and the \`duration\` in the following format: "{projectId}:{duration}" Parameters: - projectId (string): The unique ID of the project associated with the tier. - duration (uint64): The duration of the tier (e.g., 30, 90, 180 days). Returns: - string: A unique tier ID in the format "projectId:duration".

CreateProject

CreateProject creates a new launchpad project with tiered allocations.

CollectProtocolFee

CollectProtocolFee collects accumulated protocol fees from launchpad operations.

CollectEmissionReward

CollectEmissionReward collects accumulated launchpad emission rewards.

CollectProtocolFeeReward

CollectProtocolFeeReward collects accumulated launchpad protocol fee rewards for the provided token path.

TransferLeftFromProjectByAdmin

TransferLeftFromProjectByAdmin transfers the remaining rewards of a project to a specified recipient.

DepositGns

DepositGns deposits GNS tokens to a launchpad project tier.

CollectDepositGns

CollectDepositGns collects rewards from a deposit.

CollectRewardByDepositId

CollectRewardByDepositId collects rewards from a deposit.

RewardManager

RewardManager manages the distribution of rewards for a project tier. This struct contains the necessary data and methods to calculate and track rewards for deposits associated with a project tier. Fields: - rewards (bptree.BPTree): A map of deposit IDs to their associated reward states. - distributeAmountPerSecondX128 (u256.Uint): The amount of tokens to be distributed per second, represented as a Q128 fixed-point number. - accumulatedRewardPerDepositX128 (u256.Uint): The accumulated reward per GNS stake, represented as a Q128 fixed-point number. - totalDistributeAmount (int64): The total amount of tokens to be distributed. - totalClaimedAmount (int64): The total amount of tokens claimed. - distributeStartTime (int64): The start time of the reward calculation. - distributeEndTime (int64): The end time of the reward calculation. - accumulatedDistributeAmount (int64): The accumulated amount of tokens distributed. - rewardClaimableDuration (int64): The duration of reward claimable.

NewRewardManager

NewRewardManager returns a pointer to a new RewardManager with the given values.

RewardState

RewardState represents the state of a reward for a deposit. It contains the necessary data to manage and distribute rewards for a specific deposit.

NewRewardState

NewRewardState returns a pointer to a new RewardState with the given values.

kvStore

versionManager

implementation

init.81

initializeDomainStore

getImplementation

updateImplementation

NewBPTreeN

NewBPTreeN allocates a BP-tree under /r/gnoswap/launchpad's realm context (the realm that declares Project/Deposit/RewardManager). The tree's PkgID is therefore /r/gnoswap/launchpad, matching the domain values it stores, so tree.Set leaf-slot writes clear the readonly-taint gate regardless of which realm (launchpad/v1, mock, tests) calls Set. Implementations, mocks, and tests must allocate launchpad trees through here rather than calling bptree.NewBPTreeN directly in their own realm.

StoreKey

StoreKeyProjects

// Projects tree

StoreKeyProjectTierRewardManagers

// Project tier reward managers tree

StoreKeyDepositCounter

// Deposit counter

StoreKeyDeposits

// Deposits tree

StoreKeyTotalGNSStakedAmount

// Total active launchpad GNS stake

launchpadStore

NewLaunchpadStore

NewLaunchpadStore creates a new launchpad store instance with the provided KV store. This function is used by the upgrade system to create storage instances for each implementation.

ILaunchpad

ILaunchpadProject

ILaunchpadDeposit

ILaunchpadGetter

ILaunchpadStore

RegisterInitializer

RegisterInitializer registers a new launchpad implementation version. This function is called by each version (v1, v2, etc.) during initialization to register their implementation with the proxy system. The initializer function creates a new instance of the implementation using the provided launchpadStore interface. Security: Only contracts within the domain path can register initializers. Each package path can only register once to prevent duplicate registrations.

UpgradeImpl

UpgradeImpl switches the active launchpad implementation to a different version. This function allows seamless upgrades from one version to another without data migration or downtime. Security: Only admin or governance can perform upgrades. The new implementation must have been previously registered via RegisterInitializer.

GetImplementationPackagePath

GetImplementationPackagePath returns the package path of the currently active implementation.