V3LPVault4626

The V3LPVault4626 is the core component of Peridot's PancakeSwap Boosted Markets. It wraps a Concentrated Liquidity (CL) position (NFT) from PancakeSwap V3 into a fungible ERC-20 token (Vault Share) that can be used as collateral.

🛠️ Key User Functions

✅ depositDual(DepositParams calldata params)

The primary way to mint vault shares. Since V3 positions consist of two tokens (e.g., USDC and AUSD), users must supply both in the correct ratio.

  • Parameters (DepositParams struct):

    • amount0Desired, amount1Desired: Amounts of tokens to supply.

    • amount0Min, amount1Min: Slippage protection.

    • receiver: Address receiving the shares.

    • deadline: Timestamp expiration.

  • Returns: uint256 shares (Amount of vault shares minted).

✅ withdrawDual(WithdrawParams calldata params)

The primary way to burn shares and retrieve underlying assets.

  • Parameters (WithdrawParams struct):

    • shares: Amount of shares to burn.

    • amount0Min, amount1Min: Slippage protection for withdrawals.

    • receiver: Address receiving the withdrawn tokens.

  • Returns: amount0, amount1 (Amounts of tokens returned).

⚙️ Mechanics

Auto-Compounding

The vault has a harvestAndCompound() function (callable by a keeper or owner) that:

  1. Collects accrued trading fees from the V3 pool.

  2. Optionally swaps rewards if needed.

  3. Re-adds the fees as new liquidity into the existing position.

Pricing & Security

  • TWAP: The vault relies on a V3LPVaultOracle that checks Time-Weighted Average Prices to ensure the LP position value isn't manipulated via flash loans.

  • Deviation Checks: Prevents deposits/withdrawals if the spot price deviates too far from the TWAP.

Inflation Protection

To prevent "donation attacks," the vault enforces a minimum "Dead Seed" balance. A small amount of shares must be permanently locked at the dead address (0x...dEaD) before users can deposit.

PreviousPancakeBoostedDelegateNextDual Investment

Last updated