# ConvexUSDCCrvUSDStrategy ## Overview The ConvexUSDCCrvUSDStrategy contract is a strategy that supplies USDC into the crvUSD-USDC pool in Curve on Polygon, then stakes the curve LP tokens in Convex to maximize yield. It handles multiple token conversions and uses TWAP oracles for price calculations. ## Constants ```solidity address public constant crvUsd = CRV_USD_POLYGON; // CRVUSD token address address public constant wpol = WPOL_POLYGON; // Wrapped MATIC address address public constant crv = CRV_POLYGON; // CRV token address address public constant usdc = USDC_POLYGON; // USDC token address uint256 public constant CRVUSD_USDC_CONVEX_POOL_ID = CRVUSD_USDC_CONVEX_POOL_ID_POLYGON; // Convex pool ID address public constant pool = UNISWAP_V3_USDC_USDCE_POOL_POLYGON; // Uniswap V3 pool address public constant triCryptoPool = TRI_CRYPTO_POOL_POLYGON; // CrvTricrypto pool ``` ## State Variables ```solidity IRouter public router; // Router for swaps ICurveLpPool public curveLpPool; // Main Curve pool IConvexBoosterPolygon public constant convexBooster = IConvexBoosterPolygon(CONVEX_BOOSTER_POLYGON); // Convex booster ICurveAtriCryptoZapper public constant zapper = ICurveAtriCryptoZapper(CURVE_CRV_ATRICRYPTO_ZAPPER_POLYGON); // Curve zapper ``` ## Functions ### Initialization Functions #### constructor ```solidity constructor() initializer ``` Empty constructor marked as initializer. #### initialize ```solidity function initialize( IMaxApyVault _vault, address[] calldata _keepers, bytes32 _strategyName, address _strategist, ICurveLpPool _curveLpPool, IRouter _router ) public initializer ``` Initializes the strategy with required components. Parameters: * `_vault`: MaxApy vault address * `_keepers`: Array of keeper addresses * `_strategyName`: Name of the strategy * `_strategist`: Strategist address * `_curveLpPool`: Curve LP pool address * `_router`: Router address for swaps ### Configuration Functions #### setRouter ```solidity function setRouter(address _newRouter) external checkRoles(ADMIN_ROLE) ``` Updates the router used for token swaps. Parameters: * `_newRouter`: New router address ### Core Functions #### \_invest ```solidity function _invest(uint256 amount, uint256 minOutputAfterInvestment) internal override returns (uint256) ``` Invests assets through: 1. Swapping base asset to USDC 2. Adding liquidity to crvUSD-USDC pool 3. Staking LP tokens in Convex Parameters: * `amount`: Amount to invest * `minOutputAfterInvestment`: Minimum expected LP tokens Returns: * Amount of tokens received #### \_divest ```solidity function _divest(uint256 amount) internal override returns (uint256) ``` Withdraws assets through: 1. Withdrawing from Convex 2. Removing liquidity from Curve 3. Swapping USDC to base asset Parameters: * `amount`: LP tokens to divest Returns: * Amount received after withdrawals and swaps #### \_unwindRewards ```solidity function _unwindRewards(IConvexRewardsPolygon rewardPool) internal override ``` Claims and converts rewards: 1. Claims CRV rewards 2. Swaps CRV through TriCrypto pool 3. Swaps crvUSD through multiple hops Parameters: * `rewardPool`: Convex rewards pool ### View Functions #### previewLiquidate ```solidity function previewLiquidate(uint256 requestedAmount) public view virtual override returns (uint256) ``` Simulates withdrawal including potential losses. Parameters: * `requestedAmount`: Amount to withdraw Returns: * Expected output amount ### Internal View Functions #### \_lpValue ```solidity function _lpValue(uint256 lp) internal view override returns (uint256) ``` Calculates underlying value of LP tokens using TWAP. Parameters: * `lp`: LP token amount Returns: * Underlying value #### \_lpForAmount ```solidity function _lpForAmount(uint256 amount) internal view override returns (uint256) ``` Calculates LP tokens needed for amount using TWAP. Parameters: * `amount`: Asset amount Returns: * Required LP tokens #### \_lpPrice ```solidity function _lpPrice() internal view override returns (uint256) ``` Calculates LP token price. Returns: * LP token price #### \_estimateAmountOut ```solidity function _estimateAmountOut(address tokenIn, address tokenOut, uint128 amountIn, uint32 secondsAgo) internal view returns (uint256) ``` Calculates swap output using TWAP oracle. Parameters: * `tokenIn`: Input token * `tokenOut`: Output token * `amountIn`: Input amount * `secondsAgo`: TWAP period Returns: * Estimated output amount #### \_crv ```solidity function _crv() internal pure override returns (address) ``` Returns CRV token address. #### \_crvUsdBalance ```solidity function _crvUsdBalance() internal view returns (uint256) ``` Returns strategy's crvUSD balance. #### \_simulateHarvest ```solidity function _simulateHarvest() public override ``` Simulates harvest operation and reverts with simulation data. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://devs.maxapy.io/maxapy-erc4626/strategies/polygon-usdc.e/convex/convexusdccrvusdstrategy.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.