SDL Pool Secondary

The SDLPoolSecondary performs the same functions as the SDLPoolSecondary with a few restrictions. Performing any state changes on reSDL positions including minting, burning, and updating requires the action to be queued at which point the NFT will be non-transferrable until an update is sent to the primary chain (updates are sent periodically). If there are no queued actions for an reSDL NFT, it can be transferred as normal.

This contract is deployed on all supported chains besides the primary chain.

ERC721 Functions

All standard IERC721 and IERC721Metadata functions are implemented for SDLPoolSecondary

View Functions

tokenPools

Returns the rewards pool for a token

function tokenPools(address _token) external view returns (address)

Parameters

Name
Type
Description

_token

address

address of token

Return Values

Name
Type
Description

rewardsPool

address

address of rewards pool

supportedTokens

Returns a list of supported tokens

function supportedTokens() external view returns (address[])

Return Values

Name
Type
Description

tokens

address[]

list of token addresses

isTokenSupported

Returns true/false to whether a given token is supported

function isTokenSupported(address _token) public view returns (bool)

Parameters

Name
Type
Description

_token

address

address of token

Return Values

Name
Type
Description

isSupported

bool

is token supported

tokenBalances

Returns balances of supported tokens within the controller

function tokenBalances() external view returns (address[], uint256[])

Return Values

Name
Type
Description

tokens

address[]

list of supported tokens

balances

uint256[]

list of token balances

staked

Returns an account's staked amount for use by reward pools controlled by this contract

function staked(address _account) external view virtual returns (uint256)

Parameters

Name
Type
Description

_account

address

address of account

Return Values

Name
Type
Description

staked

uint256

account's staked amount

totalStaked

Returns the total staked amount for use by reward pools controlled by this contract

function totalStaked() external view virtual returns (uint256)

Return Values

Name
Type
Description

totalStaked

uint256

total staked amount

withdrawableRewards

Returns a list of withdrawable rewards for an account

function withdrawableRewards(address _account) external view returns (uint256[])

Parameters

Name
Type
Description

_account

address

address of account

Return Values

Name
Type
Description

withdrawableRewards

uint256[]

list of withdrawable reward amounts for each token

sdlToken

Returns the address of the SDL token

function sdlToken() external view returns (address)

Return Values

Name
Type
Description

sdlToken

address

address of SDL token

boostController

Returns the address of the boost controller

function boostController() external view returns (address)

Return Values

Name
Type
Description

boostController

address

address of boost controller

lastLockId

Returns the id of the most recently minted lock

function lastLockId() external view returns (uint256)

Return Values

Name
Type
Description

lastLockId

uint256

latest lock id

ccipController

Returns the address of the CCIP controller for this contract

function ccipController() external view returns (address)

Return Values

Name
Type
Description

ccipController

address

address of CCIP controller

effectiveBalanceOf

Returns the effective stake balance of an account (the effective stake balance includes the actual amount of tokens an account has staked across all locks plus any applicable boost gained by locking)

function effectiveBalanceOf(address _account) external view returns (uint256)

Parameters

Name
Type
Description

_account

address

address of account

Return Values

Name
Type
Description

effectiveBalance

uint256

effective stake balance

totalEffectiveBalance

Returns the sum of effective balances across all accounts

function totalEffectiveBalance() external view returns (uint256)

Return Values

Name
Type
Description

totalEffectiveBalance

uint256

total effective balance

getLocks

Returns the list of locks that corresponds to _lockIds

function getLocks(uint256[] _lockIds) external view returns (struct SDLPool.Lock[])

Parameters

Name
Type
Description

_lockIds

uint256[]

list of lock ids

Return Values

Name
Type
Description

locks

struct SDLPool.Lock[]

list of locks

getLockIdsByOwner

Returns a list of lockIds owned by an account

function getLockIdsByOwner(address _owner) external view returns (uint256[])

Parameters

Name
Type
Description

_owner

address

address of account

Return Values

Name
Type
Description

lockIds

uint256[]

list of lockIds

queuedNewLockLimit

Returns the maximum number of queued new locks an account can have at one time

function queuedNewLockLimit() external view returns (uint256)

Return Values

Name
Type
Description

queuedNewLockLimit

uint256

max num of queued new locks

updateBatchIndex

Returns the index of the current update batch

function updateBatchIndex() external view returns (uint128)

Return Values

Name
Type
Description

updateBatchIndex

uint128

index of current batch

queuedRESDLSupplyChange

Returns the current queued reSDL supply change to be sent in the next update

int256 queuedRESDLSupplyChange

Return Values

Name
Type
Description

queuedRESDLSupplyChange

int256

queued reSDL supply change

getQueuedNewLocksByOwner

Returns a list of queued new locks for an owner

function getQueuedNewLocksByOwner(address _owner) external view returns (struct SDLPool.Lock[], uint256[])

Parameters

Name
Type
Description

_owner

address

owner of locks

Return Values

Name
Type
Description

queuedLocks

Lock[]

list of queued locks

batchIndexes

uint256[]

corresponding batch indexes

getQueuedLockUpdates

Returns queued lock updates for a list of lock ids

function getQueuedLockUpdates(uint256[] _lockIds) external view returns (struct SDLPoolSecondary.LockUpdate[][])

Parameters

Name
Type
Description

_lockIds

uint256[]

list of lock ids

Return Values

Name
Type
Description

lockUpdates

LockUpdate[][]

list of queued lock updates corresponding to each lock id

shouldUpdate

Returns whether an update should be sent to the primary chain

function shouldUpdate() external view returns (bool)

Return Values

Name
Type
Description

shouldUpdate

bool

whether update should be sent

updateInProgress

Returns whether a cross chain update is in progress

function isUpdateInProgress() external view returns (bool)

Return Values

Name
Type
Description

updateInProgress

bool

whether update is in progress

Write Functions

distributeTokens

Distributes token balances to their respective rewards pools

function distributeTokens(address[] _tokens) public

Parameters

Name
Type
Description

_tokens

address[]

list of token addresses

distributeToken

Distributes a token to its respective rewards pool

function distributeToken(address _token) public

Parameters

Name
Type
Description

_token

address

address of token

withdrawRewards

Withdraws an account's earned rewards for a list of tokens

function withdrawRewards(address[] _tokens) public

Parameters

Name
Type
Description

_tokens

address[]

list of token addresses to withdraw rewards from

addToken

Adds a new token

function addToken(address _token, address _rewardsPool) public

Parameters

Name
Type
Description

_token

address

address of token to add

_rewardsPool

address

address of token rewards pool to add

removeToken

Removes a supported token

function removeToken(address _token) external

Parameters

Name
Type
Description

_token

address

address of token

setBaseURI

Sets the base URI for all tokens

function setBaseURI(string _baseURI) external

Parameters

Name
Type
Description

_baseURI_

string

base URI

setBoostController

Sets the boost controller

function setBoostController(address _boostController) external

Parameters

Name
Type
Description

_boostController

address

address of boost controller

setCCIPController

Sets the CCIP controller

function setCCIPController(address _ccipController) external

Parameters

Name
Type
Description

_ccipController

address

address of CCIP controller

onTokenTransfer

ERC677 implementation to stake/lock SDL tokens or distribute rewards

function onTokenTransfer(address _sender, uint256 _value, bytes _calldata) external

Parameters

Name
Type
Description

_sender

address

sender of the stake

_value

uint256

value of the token transfer

_calldata

bytes

encoded lockId (uint256) and lockingDuration (uint64)

extendLockDuration

Extends the locking duration of a lock

function extendLockDuration(uint256 _lockId, uint64 _lockingDuration) external

Parameters

Name
Type
Description

_lockId

uint256

id of lock

_lockingDuration

uint64

new locking duration to set

initiateUnlock

Initiates the unlock period for a lock

function initiateUnlock(uint256 _lockId) external

Parameters

Name
Type
Description

_lockId

uint256

id of lock

withdraw

Withdraws unlocked SDL

function withdraw(uint256 _lockId, uint256 _amount) external

Parameters

Name
Type
Description

_lockId

uint256

id of the lock

_amount

uint256

amount to withdraw from the lock

executeQueuedOperations

Executes queued operations for the sender

function executeQueuedOperations(uint256[] _lockIds) external

Parameters

Name
Type
Description

_lockIds

uint256[]

ids of locks to execute updates for

handleOutgoingRESDL

Handles the outgoing transfer of an reSDL lock to another chain

function handleOutgoingRESDL(address _sender, uint256 _lockId, address _sdlReceiver) external returns (struct SDLPool.Lock)

Parameters

Name
Type
Description

_sender

address

sender of the transfer

_lockId

uint256

id of lock

_sdlReceiver

address

address to receive underlying SDL on this chain

Return Values

Name
Type
Description

lock

Lock

the lock being transferred

handleIncomingRESDL

Handles the incoming transfer of an reSDL lock from another chain

function handleIncomingRESDL(address _receiver, uint256 _lockId, struct SDLPool.Lock _lock) external

Parameters

Name
Type
Description

_receiver

address

receiver of the transfer

_lockId

uint256

id of lock

_lock

Lock

lock

handleOutgoingUpdate

Handles an outgoing update to the primary chain

function handleOutgoingUpdate() external returns (uint256, int256)

Return Values

Name
Type
Description

numNewLocks

uint256

the number of new locks to mint

resdlSupplyChange

int256

the reSDL supply change since the last update

handleIncomingUpdate

Handles an incoming update from the primary chain

function handleIncomingUpdate(uint256 _mintStartIndex) external

Parameters

Name
Type
Description

_mintStartIndex

uint256

start index to use for minting new locks in the lastest batch

Last updated