Locked Tokens Contract Reference
Contracts
LockedTokens
The LockedTokens contract defines the resources and interfaces
used to store locked FLOW tokens owned by a token holder.
Source: LockedTokens.cdc
| Network | Contract Address |
|---|---|
| Testnet | 0x95e019a17d0e23d7 |
| Mainnet | 0x8d0e87b65159ae63 |
StakingProxy
The StakingProxy contract defines the interfaces through which token holder
and node operators perform staking operations with locked FLOW.
Source: StakingProxy.cdc
| Network | Contract Address |
|---|---|
| Testnet | 0x7aad92e5a0715d21 |
| Mainnet | 0x62430cf28c26d095 |
Transactions
Token Admin
The token admin is the administrator responsible for distributing and releasing locked FLOW tokens. The token admin has possession of a single account that is used to control the lockups for all locked FLOW.
The token admin creates a shared account for each token holder that is co-owned by the token admin and the token holder. The shared account is used to store all locked FLOW owned by a token holder.
The token admin public key is used by account creators to configure token holder accounts to hold locked FLOW.
Note: these keys have a weight of 100.
| Network | Token Admin Public Key |
|---|---|
| Testnet | f845b840fd8c6a3078ea6b7ecb96d914832ee3b62323d4d42860235b4a175d75544f476aeb800e3a4bad2cc5375e47fc5e13356167a4512b6ad03e660c04b6db26246cba020364 |
| Mainnet | f845b8406e4f43f79d3c1d8cacb3d5f3e7aeedb29feaeb4559fdb71a97e2fd0438565310e87670035d83bc10fe67fe314dba5363c81654595d64884b1ecad1512a64e65e020164 |
| ID | Name | Source |
|---|---|---|
TA.01 | Set Up Admin Account | lockedTokens/admin/create_admin_collection.cdc |
TA.02 | Created Shared Account | lockedTokens/admin/admin_create_shared_accounts.cdc |
TA.04 | Deposit Locked Tokens | lockedTokens/admin/deposit_locked_tokens.cdc |
TA.05 | Unlock Tokens | lockedTokens/admin/unlock_tokens.cdc |
TA.06 | Deposit Account Creator | lockedTokens/admin/admin_deposit_account_creator.cdc |
Custodian
The custodian is an agent who acts on behalf of the token holder for the purpose of securing FLOW tokens.
| ID | Name | Source |
|---|---|---|
C.01 | Set Up Creator Account | lockedTokens/admin/custody_setup_account_creator.cdc |
C.02 | Create Shared Accounts | lockedTokens/admin/custody_create_shared_accounts.cdc |
C.03 | Create Only Shared Acccount | lockedTokens/admin/custody_create_only_shared_account.cdc |
Token Holder
The token holder is a user who holds possession of locked and unlocked FLOW tokens.
The token holder can stake and delegate locked or unlocked FLOW
through the StakingProxy contract.
The token holder can withdraw unlocked FLOW from the shared account created by the token admin.
| ID | Name | Source |
|---|---|---|
TH.01 | Withdraw Unlocked FLOW | lockedTokens/user/withdraw_tokens.cdc |
TH.02 | Deposit Unlocked FLOW | lockedTokens/user/deposit_tokens.cdc |
TH.03 | Get Unlock Limit | lockedTokens/user/get_unlock_limit.cdc |
TH.04 | Get Locked Account Balance | lockedTokens/user/get_locked_account_balance.cdc |
TH.05 | Get Locked Account Address | lockedTokens/user/get_locked_account_address.cdc |
Staking
These transactions operate through the StakingProxy.NodeStakerProxy interface.
| ID | Name | Source |
|---|---|---|
TH.06 | Register Node | lockedTokens/staker/register_node.cdc |
TH.07 | Get Node ID | lockedTokens/staker/get_node_id.cdc |
TH.08 | Stake New Locked FLOW | lockedTokens/staker/stake_new_tokens.cdc |
TH.09 | Re-stake Unstaked FLOW | lockedTokens/staker/stake_unstaked_tokens.cdc |
TH.10 | Re-stake Rewarded FLOW | lockedTokens/staker/stake_rewarded_tokens.cdc |
TH.11 | Request Unstake of FLOW | lockedTokens/staker/request_unstaking.cdc |
TH.12 | Unstake All FLOW | lockedTokens/staker/unstake_all.cdc |
TH.13 | Withdraw Unstaked FLOW | lockedTokens/staker/withdraw_unstaked_tokens.cdc |
TH.14 | Withdraw Rewarded FLOW | lockedTokens/staker/withdraw_rewarded_tokens.cdc |
Register an Operator Node
| ID | Name | Source |
|---|---|---|
TH.15 | Get Operator Node Info | stakingProxy/get_node_info.cdc |
TH.16 | Register Operator Node | stakingProxy/register_node.cdc |
Delegating
These transactions operate through the StakingProxy.NodeDelegatorProxy interface.
| ID | Name | Source |
|---|---|---|
TH.17 | Register Delegator | lockedTokens/delegator/register_delegator.cdc |
TH.18 | Get Delegator ID | lockedTokens/delegator/get_delegator_id.cdc |
TH.19 | Delegate New Locked FLOW | lockedTokens/delegator/delegate_new_tokens.cdc |
TH.20 | Re-delegate Unstaked FLOW | lockedTokens/delegator/delegate_unstaked_tokens.cdc |
TH.21 | Re-delegate Rewarded FLOW | lockedTokens/delegator/delegate_rewarded_tokens.cdc |
TH.22 | Request Unstake of Delegated FLOW | lockedTokens/delegator/request_unstaking.cdc |
TH.23 | Withdraw Unstaked Delegated FLOW | lockedTokens/delegator/withdraw_unstaked_tokens.cdc |
TH.24 | Withdraw Rewarded Delegated FLOW | lockedTokens/delegator/withdraw_rewarded_tokens.cdc |
Node Operator
The node operator is an independent user who operators a Flow node on behalf of a token holder.
| ID | Name | Source |
|---|---|---|
NO.01 | Set Up Operator Account | stakingProxy/setup_node_account.cdc |
Staking
These transactions operate through the StakingProxy.NodeStakerProxy interface.
The node operator can perform the following staking actions using locked or unlocked FLOW owned by the token holder.
Note: The node operator can perform these actions on behalf of the token holder, but only with explicit permission. This permission can be revoked by the token holder.
| ID | Name | Source |
|---|---|---|
NO.02 | Add Node Info | stakingProxy/add_node_info.cdc |
NO.03 | Remove Node Info | stakingProxy/remove_node_info.cdc |
NO.04 | Remove Staking Proxy | stakingProxy/remove_staking_proxy.cdc |
NO.05 | Stake New Locked FLOW | stakingProxy/stake_new_tokens.cdc |
NO.06 | Re-stake Unstaked FLOW | stakingProxy/stake_unstaked_tokens.cdc |
NO.07 | Unstake FLOW | stakingProxy/unstake_all.cdc |
NO.08 | Withdraw Unstaked FLOW | stakingProxy/withdraw_unstaked.cdc |
NO.09 | Withdraw Rewarded FLOW | stakingProxy/withdraw_rewards.cdc |
Events
The LockedTokens contract defines events that can be monitored for important actions.
SharedAccountRegistered
Emitted when a new shared (locked) account is registered.
pub event SharedAccountRegistered(address: Address)
UnlockedAccountRegistered
Emitted when a new user (unlocked) account is registered. This and SharedAccountRegistered
are always emitted at the same time.
pub event UnlockedAccountRegistered(address: Address)
UnlockLimitIncreased
Emitted when the token admin increases the unlock limit for a locked account. This will usually happen when a milestone is reached in the vesting of the locked tokens.
pub event UnlockLimitIncreased(address: Address, increaseAmount: UFix64, newLimit: UFix64)
LockedAccountRegisteredAsNode
Emitted when a user registers their locked account as a node operator.
pub event LockedAccountRegisteredAsNode(address: Address, nodeID: String)
LockedAccountRegisteredAsDelegator
Emitted when a user registers their locked account as a delegator.
pub event LockedAccountRegisteredAsDelegator(address: Address, nodeID: String)
LockedTokensDeposited
Emitted when the token admin deposits locked tokens from the token sale.
pub event LockedTokensDeposited(address: Address, amount: UFix64)