3Pool Convex Meta Vault

Abstract ERC-4626 vaults with DAI, USDC or USDT asset invested in Curve's 3Pool, and then the 3Pool LP token (3Crv) is invested in an underlying 3Pool-based (3Crv) Meta Vault.

Capabilities

• ERC-4626 compliant tokenized vault.

• ERC-20 compliant token.

• Invests DAI, USDC or USDT in Curve's 3Pool and then invests the 3Crv LP token in an underlying ERC4626 vault.

• Sandwich attack protection on ERC4626 operations deposit, mint, withdraw and redeem.

• Vault operations are pausable by the Governor.

• Emergency asset recovery by the Governor. This will be removed after 2 months.

• Vault configuration is controlled by a protocol Governor. This includes:

  • Setting the slippage limits for mint, deposit, redeem and withdraw.

• Initially the Governor can upgrade the contracts via a proxy without a time delay. After 6 weeks, this will be changed to a one week time delay.

Contract Interface

See the metavaults github repository for contract diagrams and process diagrams.

See General ERC-4626 Vault Interface for the standard ERC-4626 functions.

Variables

BASIS_SCALE

uint256 BASIS_SCALE

Basis points calculation scale. 100% = 10000. 1% = 100

redeemSlippage

uint256 redeemSlippage

Redeem slippage in basis points i.e. 1% = 100

depositSlippage

uint256 depositSlippage

Deposit slippage in basis points i.e. 1% = 100

withdrawSlippage

uint256 withdrawSlippage

Withdraw slippage in basis points i.e. 1% = 100

mintSlippage

uint256 mintSlippage

Mint slippage in basis points i.e. 1% = 100

assetScale

uint256 assetScale

Scale of one asset. eg 1e18 if asset has 18 decimal places.

assetFromUsdScale

uint256 assetFromUsdScale

Converts USD value with 18 decimals back down to asset/vault scale. For example, convert 18 decimal USD value back down to USDC which only has 6 decimal places. Will be 1 for DAI, 1e12 for USDC and USDT.

threeCrvTokenScale

uint256 threeCrvTokenScale

Scale of the Curve.fi 3Crv token. 1e18 = 18 decimal places

metaVault

contract IERC4626Vault metaVault

Address of the underlying Meta Vault that implements ERC-4626.

assetPoolIndex

uint256 assetPoolIndex

The index of underlying asset DAI, USDC or USDT in 3Pool. DAI = 0, USDC = 1 and USDT = 2

Functions

liquidateVault

function liquidateVault(uint256 minAssets) external

Governor liquidates all the vault's assets and send to the governor. Only to be used in an emergency. eg whitehat protection against a hack.

Parameters

Name	Type	Description
minAssets	uint256	Minimum amount of asset tokens to receive from removing liquidity from the Curve 3Pool. This provides sandwich attack protection.

resetAllowances

function resetAllowances() external

Approves Curve's 3Pool contract to transfer assets (DAI, USDC or USDT) from this vault. Also approves the underlying Meta Vault to transfer 3Crv from this vault.

setRedeemSlippage

function setRedeemSlippage(uint256 _slippage) external

Governor function to set redeem slippage.

Parameters

Name	Type	Description
_slippage	uint256	Redeem slippage to apply as basis points i.e. 1% = 100

setDepositSlippage

function setDepositSlippage(uint256 _slippage) external

Governor function to set deposit slippage.

Parameters

Name	Type	Description
_slippage	uint256	Deposit slippage to apply as basis points i.e. 1% = 100

setWithdrawSlippage

function setWithdrawSlippage(uint256 _slippage) external

Governor function to set withdraw slippage.

Parameters

Name	Type	Description
_slippage	uint256	Withdraw slippage to apply as basis points i.e. 1% = 100

setMintSlippage

function setMintSlippage(uint256 _slippage) external

Governor function to set mint slippage.

Parameters

Name	Type	Description
_slippage	uint256	Mint slippage to apply as basis points i.e. 1% = 100