Meshswap
Search
K
Comment on page

PlusPool

This contract manages the leveraged assets of Meshswap's plus pool liquidity providers. Liquidity providers can maximize their returns with positive assets (deposited assets + utilized assets) by using positive deposits according to their deposited assets. However, a high asset utilization ratio can result in automatic returns, which can result in losses.

Code

Github Link: (Will be updated after official launch)

Address

  • Contract adress after production is deployed

Events, Read-Only Functions, and State-Changing Functions

Events
Read-Only Functions
State-Changing Functions

Events

ChangeBorrowFactor
event ChangeBorrowFactor(uint newBorrowFactor);
  • Event log of borrow factor change
ChangeLiquidationFactor
event ChangeLiquidationFactor(uint newLiquidationFactor);
  • Event log of liquidation factor change
ChangeBorrowable
event ChangeBorrowable(address token, bool b);
  • Event that occurs when availability is changed
GiveReward
event GiveReward(address user, uint amount, uint lastIndex, uint rewardSum);
  • Event log of when mined MESH is claimed and distributed
  • Parameters
    • user : address of the user who claimed
    • amount : the amount of MESH claimed
    • lastIndex : index result of the pair of the wallet after claiming
    • rewardSum : The amount of MESH that has been accrued so far
GiveAirdropReward
event GiveAirdropReward(address user, address dist, uint amount, uint currentIndex, uint userAirdropSum);
  • Event log of when airdrop token is claimed and distributed
  • Parameters
    • user : address of the user who claimed
    • dist : Airdrop contract address
    • amount : the amount of token claimed
    • lastIndex : index result of the pair of the wallet after claiming
    • rewardSum : The amount of token that has been accrued so far
OpenPosition
event OpenPosition(address user, uint amount0, uint amount1, uint borrow0, uint borrow1, uint amountLP, uint userLP);
  • Events that occur when depositing to PlusPool
  • If the token to deposit is MESH, msg.value is provided.
  • Parameters
    • user : address of the user
    • amount0 : The deposit amount of token0
    • amount1 : The deposit amount of token1
    • borrow0 : The utilization amount of token0
    • borrow1: The utilization amount of token1
    • amountLP: The amount of LP tokens minted due to additional liquidity
    • userLP : the total amount of LP tokens minted due to additional liquidity
ClosePosition
event ClosePosition(address user, uint amountLP, uint amount0, uint amount1, uint userLP);
  • Events that occur when withdraw liquidity
  • Parameters
    • user : address of the user
    • amountLP: The amount of LP tokens burned due to liquidity removal
    • amount0 : The withdraw amount of token0
    • amount1 : The withdraw amount of token1
    • userLP : the total amount of LP tokens minted due to additional liquidity
Liquidate
event Liquidate(address user, uint idx, uint debt0, uint debt1, uint lp, uint debtRatio, uint time);
  • Event that occur when the automatic return system activates
  • Parameters
    • user : address of the user
    • idx : Number of auto-return count
    • dept0 : Number of token0 returned automatically
    • dept1 : Number of token1 returned automatically
    • lp : the total amount of LP tokens
    • debtRatio : Asset utilization ratio in case of automatic return
    • time : Automatic return time

Read-Only Functions

totalLP

  • mint/burn depending on liquidity addition/removal
lpToken
  • target liquidity pool address

token0

  • The first token address composed of the pair

token1

  • The second token address composed of the pair

borrowable0

  • Whether token0 can be borrowable

borrowable1

  • Whether token1 can be borrowable

liquidationFactor

  • automatic return factor
  • It is a value between 1 and 1e18, in units of 1/1e16%
  • Default - 0.85e18

borrowFactor

  • Utilization cost interest rate of utilized assets
  • It is a value between 1 and 1e18, in units of 1/1e16%
  • Default - 0.67e18

userLP

  • Number of PlusPool tokens held by each address

liquidationBonusRate

  • Ratio of resources to be used for MESH buyback & incineration in case of automatic return

liquidationCount

function liquidationCount(address user) public view returns (uint)
  • Returns the user's cumulative automatic return count

State-Changing Functions

claimReward

function claimReward() public
  • Method that a user calls to claim the claimable MESH that has accumulated for the pair
  • When called, MESH is claimed from the Factory and paid to msg.sender
  • Even if the method is not called directly, it is automatically called when the LP token balance of the user’s wallet changes.
    • When liquidity is added
    • When liquidity is removed

openPositionETH

function openPositionETH(uint amount1, uint borrow0, uint borrow1, uint minAmountLP) public payable
  • Method that depositing MATIC to PlusPool
  • After liquidity is provided, the LP token corresponding to the pool share is minted in the msg.sender wallet.
  • If there is claimable MESH when called, the claim proceeds to msg.sender.
  • Parameter
    • amount1 : The deposit amount of token1
    • borrow0 : The utilization amount of WMATIC
    • borrow1: The utilization amount of token1
    • minAmountLP : Minimum Guaranteed LP amount

openPositionToken

function openPositionToken(uint amount0, uint amount1, uint borrow0, uint borrow1, uint minAmountLP) public payable
  • Method that depositing to PlusPool
  • After liquidity is provided, the LP token corresponding to the pool share is minted in the msg.sender wallet.
  • If there is claimable MESH when called, the claim proceeds to msg.sender.
  • Parameter
    • amount0 : The deposit amount of token0
    • amount1 : The deposit amount of token1
    • borrow0 : The utilization amount of token0
    • borrow1: The utilization amount of token1
    • minAmountLP : Minimum Guaranteed LP amount

closePositionETH

function closePositionETH(uint amountLP, uint minAmount0, uint minAmount1) public
  • Returns the amount of LP tokens, and distributes the corresponding MATIC and token1 to the msg.sender wallet
  • The returned LP token amount is burned
  • If there is claimable MESH and Airdrop when called, the claim proceeds to msg.sender.
  • Parameters
    • amountLP: The amount of LP tokens burned due to liquidity removal
    • minAmount0 : The withdraw amount of token0
    • minAmount1 : The withdraw amount of token1

closePositionToken

function closePositionToken(uint amountLP, uint minAmount0, uint minAmount1) public
  • Returns the amount of LP tokens, and distributes the corresponding token0 and token1 to the msg.sender wallet
  • The returned LP token amount is burned
  • If there is claimable MESH and Airdrop when called, the claim proceeds to msg.sender.
  • Parameters
    • amountLP: The amount of LP tokens burned due to liquidity removal
    • minAmount0 : The withdraw amount of token0
    • minAmount1 : The withdraw amount of token1