SDL Pool
The SDLPool allows users to stake and/or lock SDL tokens and receive reSDL (Reward Escrowed SDL) in return. SDL stakers will receive a portion of protocol rewards proportional to the amount of reSDL they hold. They will also receieve priority staking access in the PriorityPool over non reSDL holders. A user's reSDL balance is represented by one or multiple NFTs which are minted when SDL is staked/locked in the pool.
If a user stakes but does not lock their SDL, they will receive an NFT representing reSDL at a 1:1 ratio to the SDL they staked. If a user locks their SDL, they will receive an additional boosted amount of reSDL depending on the duration they have chosen to lock for, resulting in a ratio greater than 1:1. The calculation for the amount of boost received for a specific amount of SDL and locking duration is handled by the LinearBoostController.
If an reSDL position is not locked, the underlying SDL can be withdrawn at any time. If a position is locked, the withdrawal period must be initiated before SDL can be withdrawn. The withdrawal period can only be initiated after at least half of the total locking duration has elapsed and the withdrawal period itself will have a duration of exactly half the total locking duration. For the duration of the withdrawal period, the boost amount for the position will be set to 0 and only after this period has elapsed, the underlying SDL can be withdrawn.
A user can hold any number of reSDL NFTs and NFTs are transferrable in all states but by transferring an NFT, the ownership of the underlying SDL is also transferred.
ERC721 Functions
All standard IERC721 and IERC721Metadata functions are implemented for SDLPool
View Functions
name
Returns the name of the staking derivative token.
function name() public view returns (string)Return Values
name
string
Name of the token
symbol
Returns the symbol of the staking derivative token.
Return Values
symbol
string
Symbol of the token
sdlToken
Returns the SDL token contract address.
Return Values
sdlToken
address
SDL token address
boostController
Returns the boost controller contract address.
Return Values
boostController
address
Boost controller address
lastLockId
Returns the last lock ID created.
Return Values
lastLockId
uint256
Last lock ID
totalEffectiveBalance
Returns the total effective balance (including boosts) staked in the pool.
Return Values
totalEffectiveBalance
uint256
Total effective balance
delegatorPool
Returns the address of the delegator pool contract.
Return Values
delegatorPool
address
Delegator pool address
baseURI
Returns the base URI for all tokens.
Return Values
baseURI
string
Base URI
effectiveBalanceOf
Returns the effective stake balance of an account, including boosts.
_account
address
Account address
Return Values
effectiveBalance
uint256
Effective stake balance
balanceOf
Returns the number of locks owned by an account.
_account
address
Account address
Return Values
balance
uint256
Number of locks
ownerOf
Returns the owner of a lock.
_lockId
uint256
Lock ID
Return Values
owner
address
Lock owner
getLocks
Returns the list of locks for the given lock IDs.
_lockIds
uint256[]
List of lock IDs
Return Values
locks
Lock[]
List of locks
getLockIdsByOwner
Returns a list of lock IDs owned by an account.
_owner
address
Account
Return Values
lockIds
uint256[]
List of lock IDs
staked
Returns an account's staked amount for use by reward pools.
_account
address
Account address
Return Values
staked
uint256
Staked amount
totalStaked
Returns the total staked amount for use by reward pools.
Return Values
totalStaked
uint256
Total staked amount
supportedTokens
Returns a list of supported tokens.
Return Values
tokens
address[]
List of supported tokens
isTokenSupported
Returns true/false for whether a given token is supported.
_token
address
Token address
Return Values
supported
bool
Is token supported
tokenBalances
Returns balances of supported tokens within the controller.
Return Values
tokens
address[]
List of supported tokens
balances
uint256[]
List of token balances
withdrawableRewards
Returns a list of withdrawable rewards for an account.
_account
address
Account address
Return Values
rewards
uint256[]
List of withdrawable rewards
Write Functions
onTokenTransfer
ERC677 implementation to stake/lock SDL tokens or distribute rewards.
_sender
address
Sender address
_value
uint256
Value transferred
_calldata
bytes
Encoded lockId and lockingDuration
extendLockDuration
Extends the locking duration of a lock.
_lockId
uint256
Lock ID
_lockingDuration
uint64
New locking duration
initiateUnlock
Initiates the unlock period for a lock.
_lockId
uint256
Lock ID
withdraw
Withdraws unlocked SDL from a lock.
_lockId
uint256
Lock ID
_amount
uint256
Amount to withdraw
setBaseURI
Sets the base URI for all tokens.
_baseURI
string
Base URI
setBoostController
Sets the boost controller contract.
_boostController
address
Boost controller
migrate
Used by the delegator pool to migrate user stakes to this contract.
_sender
address
Owner of lock
_amount
uint256
Amount to stake
_lockingDuration
uint64
Duration of lock
distributeTokens
Distributes token balances to their respective rewards pools.
_tokens
address[]
List of token addresses
distributeToken
Distributes a token balance to its respective rewards pool.
_token
address
Token address
withdrawRewards
Withdraws an account's earned rewards for a list of tokens.
_tokens
address[]
List of token addresses
addToken
Adds a new token and its rewards pool.
_token
address
Token to add
_rewardsPool
address
Token rewards pool
removeToken
Removes a supported token.
_token
address
Token address
Last updated