@pendle/core-v2 0.6.8 → 0.7.0

package/build/artifacts/contracts/periphery/PendleGovernanceManager.sol/PendleGovernanceManager.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/06153896566a2eed67eb95c7473fae3c.json"
+  "buildInfo": "../../../build-info/bc0acb3641076a281bea6ddc48f72287.json"
 }

package/build/artifacts/contracts/periphery/PendleGovernanceManager.sol/PendleGovernanceManager.json

@@ -80,8 +80,8 @@
       "type": "function"
     }
   ],
-  "bytecode": "0x608060405234801561001057600080fd5b5060405161036238038061036283398101604081905261002f9161009d565b6001600160a01b0381166100785760405162461bcd60e51b815260206004820152600c60248201526b7a65726f206164647265737360a01b604482015260640160405180910390fd5b600080546001600160a01b0319166001600160a01b03929092169190911790556100cd565b6000602082840312156100af57600080fd5b81516001600160a01b03811681146100c657600080fd5b9392505050565b610286806100dc6000396000f3fe608060405234801561001057600080fd5b506004361061004c5760003560e01c80635aa6e675146100515780635d36b19014610080578063d38bfff41461008a578063f39c38a01461009d575b600080fd5b600054610064906001600160a01b031681565b6040516001600160a01b03909116815260200160405180910390f35b6100886100b0565b005b610088610098366004610220565b61016d565b600154610064906001600160a01b031681565b6001546001600160a01b031633146100fb5760405162461bcd60e51b81526020600482015260096024820152682327a92124a22222a760b91b60448201526064015b60405180910390fd5b600154600054604080516001600160a01b0393841681529290911660208301527f5f56bee8cffbe9a78652a74a60705edede02af10b0bbb888ca44b79a0d42ce80910160405180910390a160018054600080546001600160a01b03199081166001600160a01b03841617909155169055565b6000546001600160a01b031633146101b95760405162461bcd60e51b815260206004820152600f60248201526e4f4e4c595f474f5645524e414e434560881b60448201526064016100f2565b6001600160a01b0381166101fe5760405162461bcd60e51b815260206004820152600c60248201526b7a65726f206164647265737360a01b60448201526064016100f2565b600180546001600160a01b0319166001600160a01b0392909216919091179055565b60006020828403121561023257600080fd5b81356001600160a01b038116811461024957600080fd5b939250505056fea26469706673582212206f1f89da0ff41dbbbfde6d0dfa49a4df25a83fe2d6df770c91bf6ad536504fd864736f6c63430008090033",
-  "deployedBytecode": "0x608060405234801561001057600080fd5b506004361061004c5760003560e01c80635aa6e675146100515780635d36b19014610080578063d38bfff41461008a578063f39c38a01461009d575b600080fd5b600054610064906001600160a01b031681565b6040516001600160a01b03909116815260200160405180910390f35b6100886100b0565b005b610088610098366004610220565b61016d565b600154610064906001600160a01b031681565b6001546001600160a01b031633146100fb5760405162461bcd60e51b81526020600482015260096024820152682327a92124a22222a760b91b60448201526064015b60405180910390fd5b600154600054604080516001600160a01b0393841681529290911660208301527f5f56bee8cffbe9a78652a74a60705edede02af10b0bbb888ca44b79a0d42ce80910160405180910390a160018054600080546001600160a01b03199081166001600160a01b03841617909155169055565b6000546001600160a01b031633146101b95760405162461bcd60e51b815260206004820152600f60248201526e4f4e4c595f474f5645524e414e434560881b60448201526064016100f2565b6001600160a01b0381166101fe5760405162461bcd60e51b815260206004820152600c60248201526b7a65726f206164647265737360a01b60448201526064016100f2565b600180546001600160a01b0319166001600160a01b0392909216919091179055565b60006020828403121561023257600080fd5b81356001600160a01b038116811461024957600080fd5b939250505056fea26469706673582212206f1f89da0ff41dbbbfde6d0dfa49a4df25a83fe2d6df770c91bf6ad536504fd864736f6c63430008090033",
+  "bytecode": "0x608060405234801561001057600080fd5b5060405161036238038061036283398101604081905261002f9161009d565b6001600160a01b0381166100785760405162461bcd60e51b815260206004820152600c60248201526b7a65726f206164647265737360a01b604482015260640160405180910390fd5b600080546001600160a01b0319166001600160a01b03929092169190911790556100cd565b6000602082840312156100af57600080fd5b81516001600160a01b03811681146100c657600080fd5b9392505050565b610286806100dc6000396000f3fe608060405234801561001057600080fd5b506004361061004c5760003560e01c80635aa6e675146100515780635d36b19014610080578063d38bfff41461008a578063f39c38a01461009d575b600080fd5b600054610064906001600160a01b031681565b6040516001600160a01b03909116815260200160405180910390f35b6100886100b0565b005b610088610098366004610220565b61016d565b600154610064906001600160a01b031681565b6001546001600160a01b031633146100fb5760405162461bcd60e51b81526020600482015260096024820152682327a92124a22222a760b91b60448201526064015b60405180910390fd5b600154600054604080516001600160a01b0393841681529290911660208301527f5f56bee8cffbe9a78652a74a60705edede02af10b0bbb888ca44b79a0d42ce80910160405180910390a160018054600080546001600160a01b03199081166001600160a01b03841617909155169055565b6000546001600160a01b031633146101b95760405162461bcd60e51b815260206004820152600f60248201526e4f4e4c595f474f5645524e414e434560881b60448201526064016100f2565b6001600160a01b0381166101fe5760405162461bcd60e51b815260206004820152600c60248201526b7a65726f206164647265737360a01b60448201526064016100f2565b600180546001600160a01b0319166001600160a01b0392909216919091179055565b60006020828403121561023257600080fd5b81356001600160a01b038116811461024957600080fd5b939250505056fea264697066735822122067e6304d55f193f4ca1a731f794e79e96922132a50cf62e9de37826d9c4514a764736f6c634300080d0033",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b506004361061004c5760003560e01c80635aa6e675146100515780635d36b19014610080578063d38bfff41461008a578063f39c38a01461009d575b600080fd5b600054610064906001600160a01b031681565b6040516001600160a01b03909116815260200160405180910390f35b6100886100b0565b005b610088610098366004610220565b61016d565b600154610064906001600160a01b031681565b6001546001600160a01b031633146100fb5760405162461bcd60e51b81526020600482015260096024820152682327a92124a22222a760b91b60448201526064015b60405180910390fd5b600154600054604080516001600160a01b0393841681529290911660208301527f5f56bee8cffbe9a78652a74a60705edede02af10b0bbb888ca44b79a0d42ce80910160405180910390a160018054600080546001600160a01b03199081166001600160a01b03841617909155169055565b6000546001600160a01b031633146101b95760405162461bcd60e51b815260206004820152600f60248201526e4f4e4c595f474f5645524e414e434560881b60448201526064016100f2565b6001600160a01b0381166101fe5760405162461bcd60e51b815260206004820152600c60248201526b7a65726f206164647265737360a01b60448201526064016100f2565b600180546001600160a01b0319166001600160a01b0392909216919091179055565b60006020828403121561023257600080fd5b81356001600160a01b038116811461024957600080fd5b939250505056fea264697066735822122067e6304d55f193f4ca1a731f794e79e96922132a50cf62e9de37826d9c4514a764736f6c634300080d0033",
   "linkReferences": {},
   "deployedLinkReferences": {}
 }

package/build/artifacts/contracts/periphery/PermissionsV2Upg.sol/PermissionsV2Upg.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/88454e13e5755d4eedd68a3511bda74a.json"
+  "buildInfo": "../../../build-info/50c4d5ce389938ed6a22f6a59a2e36eb.json"
 }

package/contracts/SuperComposableYield/SCY-implementations/AaveV3/PendleAaveV3SCY.sol

@@ -0,0 +1,147 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+pragma solidity 0.8.13;
+import "../../base-implementations/SCYBaseWithRewards.sol";
+import "../../../interfaces/IAToken.sol";
+import "../../../interfaces/IAavePool.sol";
+import "../../../interfaces/IAaveRewardsController.sol";
+import "./WadRayMath.sol";
+
+contract PendleAaveV3SCY is SCYBaseWithRewards {
+    using Math for uint256;
+    using WadRayMath for uint256;
+
+    address public immutable underlying;
+    address public immutable pool;
+    address public immutable rewardsController;
+    address public immutable aToken;
+
+    uint256 private constant PRECISION_INDEX = 1e9;
+
+    constructor(
+        string memory _name,
+        string memory _symbol,
+        address _aToken
+    ) SCYBaseWithRewards(_name, _symbol, _aToken) {
+        aToken = _aToken;
+        underlying = IAToken(aToken).UNDERLYING_ASSET_ADDRESS();
+        rewardsController = IAToken(aToken).getIncentivesController();
+        pool = IAToken(aToken).POOL();
+        _safeApprove(underlying, pool, type(uint256).max);
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                    DEPOSIT/REDEEM USING BASE TOKENS
+    //////////////////////////////////////////////////////////////*/
+
+    function _deposit(address tokenIn, uint256 amountDeposited)
+        internal
+        virtual
+        override
+        returns (uint256 amountSharesOut)
+    {
+        // aTokenScaled -> SCY is 1:1
+        if (tokenIn == aToken) {
+            amountSharesOut = _aTokenToScaledBalance(amountDeposited);
+        } else {
+            uint256 preScaledBalance = IAToken(aToken).scaledBalanceOf(address(this));
+            IAavePool(pool).supply(underlying, amountDeposited, address(this), 0);
+            amountSharesOut = IAToken(aToken).scaledBalanceOf(address(this)) - preScaledBalance;
+        }
+    }
+
+    function _redeem(address tokenOut, uint256 amountSharesToRedeem)
+        internal
+        virtual
+        override
+        returns (uint256 amountTokenOut)
+    {
+        if (tokenOut == aToken) {
+            amountTokenOut = _scaledBalanceToAToken(amountSharesToRedeem);
+        } else {
+            uint256 preBalanceUnderlying = _selfBalance(underlying);
+
+            uint256 amountATokenToWithdraw = _scaledBalanceToAToken(amountSharesToRedeem);
+            IAavePool(pool).withdraw(underlying, amountATokenToWithdraw, address(this));
+
+            // underlying is potentially also rewardToken, hence we need to manually track the balance here
+            amountTokenOut = _selfBalance(underlying) - preBalanceUnderlying;
+        }
+    }
+
+    function _updateYieldReserve() internal virtual override {
+        yieldTokenReserve = IAToken(aToken).scaledBalanceOf(address(this));
+    }
+
+    function _getFloatingAmount(address token) internal view virtual override returns (uint256) {
+        if (token != aToken) return _selfBalance(token) - rewardState[token].lastBalance;
+        // the only reserve token is aToken
+        uint256 scaledATokenAmount = IAToken(aToken).scaledBalanceOf(address(this)) -
+            yieldTokenReserve;
+        return _scaledBalanceToAToken(scaledATokenAmount);
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                               EXCHANGE-RATE
+    //////////////////////////////////////////////////////////////*/
+
+    function exchangeRate() public view virtual override returns (uint256) {
+        return _getReserveNormalizedIncome() / PRECISION_INDEX;
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                               REWARDS-RELATED
+    //////////////////////////////////////////////////////////////*/
+
+    function _getRewardTokens() internal view override returns (address[] memory res) {
+        res = IAaveRewardsController(rewardsController).getRewardsByAsset(aToken);
+    }
+
+    function _redeemExternalReward() internal override {
+        address[] memory assets = new address[](1);
+        assets[0] = aToken;
+
+        IAaveRewardsController(rewardsController).claimAllRewards(assets, address(this));
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                               INTERNAL-HELPER-FUNCTIONS
+    //////////////////////////////////////////////////////////////*/
+
+    function _getReserveNormalizedIncome() internal view returns (uint256) {
+        return IAavePool(pool).getReserveNormalizedIncome(underlying);
+    }
+
+    function _aTokenToScaledBalance(uint256 aTokenAmount) internal view returns (uint256) {
+        return aTokenAmount.rayDiv(_getReserveNormalizedIncome());
+    }
+
+    function _scaledBalanceToAToken(uint256 scaledAmount) internal view returns (uint256) {
+        return scaledAmount.rayMul(_getReserveNormalizedIncome());
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                            MISC FUNCTIONS FOR METADATA
+    //////////////////////////////////////////////////////////////*/
+
+    function getBaseTokens() public view virtual override returns (address[] memory res) {
+        res = new address[](2);
+        res[0] = underlying;
+        res[1] = aToken;
+    }
+
+    function isValidBaseToken(address token) public view virtual override returns (bool res) {
+        res = (token == underlying || token == aToken);
+    }
+
+    function assetInfo()
+        external
+        view
+        returns (
+            AssetType assetType,
+            address assetAddress,
+            uint8 assetDecimals
+        )
+    {
+        return (AssetType.TOKEN, underlying, IERC20Metadata(underlying).decimals());
+    }
+}

package/contracts/{core/PendleSCYImpl → SuperComposableYield/SCY-implementations}/AaveV3/WadRayMath.sol

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: BUSL-1.1
-pragma solidity 0.8.9;
+pragma solidity 0.8.13;
 
 /**
  * @title WadRayMath library

package/contracts/SuperComposableYield/SCY-implementations/BenQi/PendleQiTokenHelper.sol

@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+pragma solidity 0.8.13;
+
+import "../../../interfaces/IQiToken.sol";
+
+contract PendleQiTokenHelper {
+    IQiToken private immutable qiToken;
+    uint256 private immutable initialExchangeRateMantissa;
+    uint256 private constant borrowRateMaxMantissa = 0.0005e16;
+
+    constructor(address _qiToken, uint256 _initialExchangeRateMantissa) {
+        qiToken = IQiToken(_qiToken);
+        initialExchangeRateMantissa = _initialExchangeRateMantissa;
+    }
+
+    function _exchangeRateCurrentView() internal view returns (uint256) {
+        uint256 currentBlockTimestamp = block.timestamp;
+
+        uint256 accrualBlockTimestampPrior = qiToken.accrualBlockTimestamp();
+
+        if (accrualBlockTimestampPrior == currentBlockTimestamp)
+            return qiToken.exchangeRateStored();
+
+        /* Read the previous values out of storage */
+        uint256 cashPrior = qiToken.getCash();
+        uint256 borrowsPrior = qiToken.totalBorrows();
+        uint256 reservesPrior = qiToken.totalReserves();
+
+        /* Calculate the current borrow interest rate */
+        uint256 borrowRateMantissa = qiToken.interestRateModel().getBorrowRate(
+            cashPrior,
+            borrowsPrior,
+            reservesPrior
+        );
+
+        require(borrowRateMantissa <= borrowRateMantissa, "borrow rate is absurdly high");
+
+        uint256 timestampDelta = currentBlockTimestamp - accrualBlockTimestampPrior;
+
+        uint256 simpleInterestFactor = borrowRateMantissa * timestampDelta;
+
+        uint256 interestAccumulated = (simpleInterestFactor * borrowsPrior) / 1e18;
+
+        uint256 totalBorrowsNew = interestAccumulated + borrowsPrior;
+
+        uint256 totalReservesNew = qiToken.reserveFactorMantissa() *
+            interestAccumulated +
+            reservesPrior;
+
+        return
+            _calcExchangeRate(qiToken.totalSupply(), cashPrior, totalBorrowsNew, totalReservesNew);
+    }
+
+    function _calcExchangeRate(
+        uint256 totalSupply,
+        uint256 totalCash,
+        uint256 totalBorrows,
+        uint256 totalReserves
+    ) private view returns (uint256) {
+        uint256 _totalSupply = totalSupply;
+        if (_totalSupply == 0) {
+            return initialExchangeRateMantissa;
+        } else {
+            uint256 cashPlusBorrowsMinusReserves;
+            uint256 exchangeRate;
+
+            cashPlusBorrowsMinusReserves = totalCash + totalBorrows - totalReserves;
+
+            exchangeRate = (cashPlusBorrowsMinusReserves * 1e18) / _totalSupply;
+
+            return exchangeRate;
+        }
+    }
+}

package/contracts/SuperComposableYield/SCY-implementations/BenQi/PendleQiTokenSCY.sol

@@ -0,0 +1,187 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+pragma solidity 0.8.13;
+
+import "../../base-implementations/SCYBaseWithRewards.sol";
+import "../../../interfaces/IQiErc20.sol";
+import "../../../interfaces/IQiAvax.sol";
+import "../../../interfaces/IBenQiComptroller.sol";
+import "../../../interfaces/IWETH.sol";
+
+import "./PendleQiTokenHelper.sol";
+
+contract PendleQiTokenSCY is SCYBaseWithRewards, PendleQiTokenHelper {
+    address public immutable underlying;
+    address public immutable QI;
+    address public immutable WAVAX;
+    address public immutable comptroller;
+    address public immutable qiToken;
+
+    constructor(
+        string memory _name,
+        string memory _symbol,
+        address _qiToken,
+        address _WAVAX,
+        uint256 _initialExchangeRateMantissa
+    )
+        SCYBaseWithRewards(_name, _symbol, _qiToken)
+        PendleQiTokenHelper(_qiToken, _initialExchangeRateMantissa)
+    {
+        require(_WAVAX != address(0), "zero address");
+
+        qiToken = _qiToken;
+
+        underlying = _getUnderlyingOfQiToken();
+        comptroller = IQiToken(qiToken).comptroller();
+
+        QI = IBenQiComptroller(comptroller).qiAddress();
+        WAVAX = _WAVAX;
+
+        if (underlying != NATIVE) {
+            _safeApprove(underlying, qiToken, type(uint256).max);
+        }
+    }
+
+    function _getUnderlyingOfQiToken() internal view returns (address) {
+        try IQiErc20(qiToken).underlying() returns (address res) {
+            return res;
+        } catch {
+            return NATIVE;
+        }
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                    DEPOSIT/REDEEM USING BASE TOKENS
+    //////////////////////////////////////////////////////////////*/
+
+    /**
+     * @dev See {SCYBase-_deposit}
+     *
+     * The underlying yield token is qiToken. If the base token deposited is underlying asset, the function
+     * first convert those deposited into qiToken. Then the corresponding amount of shares is returned.
+     *
+     * The exchange rate of qiToken to shares is 1:1
+     */
+    function _deposit(address tokenIn, uint256 amount)
+        internal
+        override
+        returns (uint256 amountSharesOut)
+    {
+        if (tokenIn == qiToken) {
+            amountSharesOut = amount;
+        } else {
+            // tokenIn is underlying -> convert it into qiToken first
+            uint256 preBalanceQiToken = _selfBalance(qiToken);
+
+            if (underlying == NATIVE) {
+                IQiAvax(qiToken).mint{ value: amount }();
+            } else {
+                uint256 errCode = IQiErc20(qiToken).mint(amount);
+                require(errCode == 0, "mint failed");
+            }
+
+            amountSharesOut = _selfBalance(qiToken) - preBalanceQiToken;
+        }
+    }
+
+    /**
+     * @dev See {SCYBase-_redeem}
+     *
+     * The shares are redeemed into the same amount of qiTokens. If `tokenOut` is the underlying asset,
+     * the function also redeems said asset from the corresponding amount of qiToken.
+     */
+    function _redeem(address tokenOut, uint256 amountSharesToRedeem)
+        internal
+        override
+        returns (uint256 amountTokenOut)
+    {
+        if (tokenOut == qiToken) {
+            amountTokenOut = amountSharesToRedeem;
+        } else {
+            uint256 preBalanceUnderlying = _selfBalance(underlying);
+
+            if (underlying == NATIVE) {
+                uint256 errCode = IQiAvax(qiToken).redeem(amountSharesToRedeem);
+                require(errCode == 0, "redeem failed");
+            } else {
+                uint256 errCode = IQiErc20(qiToken).redeem(amountSharesToRedeem);
+                require(errCode == 0, "redeem failed");
+            }
+
+            // underlying is potentially also rewardToken, hence we need to manually track the balance here
+            amountTokenOut = _selfBalance(underlying) - preBalanceUnderlying;
+        }
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                               EXCHANGE-RATE
+    //////////////////////////////////////////////////////////////*/
+
+    /**
+     * @notice Calculates and updates the exchange rate of shares to underlying asset token
+     * @dev It is the exchange rate of qiToken to its underlying asset
+     */
+    function exchangeRate() public view override returns (uint256) {
+        return _exchangeRateCurrentView();
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                               REWARDS-RELATED
+    //////////////////////////////////////////////////////////////*/
+
+    /**
+     * @dev See {ISuperComposableYield-getRewardTokens}
+     */
+    function _getRewardTokens() internal view override returns (address[] memory res) {
+        res = new address[](2);
+        res[0] = QI;
+        res[1] = WAVAX;
+    }
+
+    function _redeemExternalReward() internal override {
+        address[] memory holders = new address[](1);
+        address[] memory qiTokens = new address[](1);
+        holders[0] = address(this);
+        qiTokens[0] = qiToken;
+
+        IBenQiComptroller(comptroller).claimReward(0, holders, qiTokens, false, true);
+        IBenQiComptroller(comptroller).claimReward(1, holders, qiTokens, false, true);
+
+        if (address(this).balance != 0) IWETH(WAVAX).deposit{ value: address(this).balance };
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                    MISC FUNCTIONS FOR METADATA
+    //////////////////////////////////////////////////////////////*/
+
+    /**
+     * @dev See {ISuperComposableYield-getBaseTokens}
+     */
+    function getBaseTokens() public view override returns (address[] memory res) {
+        res = new address[](2);
+        res[0] = qiToken;
+        res[1] = underlying;
+    }
+
+    /**
+     * @dev See {ISuperComposableYield-isValidBaseToken}
+     */
+    function isValidBaseToken(address token) public view override returns (bool res) {
+        res = (token == underlying || token == qiToken);
+    }
+
+    function assetInfo()
+        external
+        view
+        returns (
+            AssetType assetType,
+            address assetAddress,
+            uint8 assetDecimals
+        )
+    {
+        return (
+            AssetType.TOKEN,
+            underlying,
+            underlying == NATIVE ? 18 : IERC20Metadata(underlying).decimals()
+        );
+    }
+}

package/contracts/SuperComposableYield/SCY-implementations/PendleBtrflySCY.sol

@@ -0,0 +1,123 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+pragma solidity 0.8.13;
+
+import "../base-implementations/SCYBase.sol";
+import "../../interfaces/IWXBTRFLY.sol";
+import "../../interfaces/IREDACTEDStaking.sol";
+
+contract PendleBtrflyScy is SCYBase {
+    address public immutable BTRFLY;
+    address public immutable xBTRFLY;
+    address public immutable wxBTRFLY;
+
+    constructor(
+        string memory _name,
+        string memory _symbol,
+        address _wxBTRFLY
+    ) SCYBase(_name, _symbol, _wxBTRFLY) {
+        require(_wxBTRFLY != address(0), "zero address");
+        wxBTRFLY = _wxBTRFLY;
+        BTRFLY = IWXBTRFLY(wxBTRFLY).BTRFLY();
+        xBTRFLY = IWXBTRFLY(wxBTRFLY).xBTRFLY();
+
+        _safeApprove(BTRFLY, wxBTRFLY, type(uint256).max);
+        _safeApprove(xBTRFLY, wxBTRFLY, type(uint256).max);
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                    DEPOSIT/REDEEM USING BASE TOKENS
+    //////////////////////////////////////////////////////////////*/
+
+    /**
+     * @dev See {SCYBase-_deposit}
+     *
+     * The underlying yield token is wxBTRFLY. If the base token is not said token, the contract
+     * first wraps from `tokenIn` to wxBRTRFLY. Then the corresponding amount of shares is returned.
+     *
+     * The exchange rate of wxBTRFLY to shares is 1:1
+     */
+    function _deposit(address tokenIn, uint256 amountDeposited)
+        internal
+        virtual
+        override
+        returns (uint256 amountSharesOut)
+    {
+        if (tokenIn == wxBTRFLY) {
+            amountSharesOut = amountDeposited;
+        } else if (tokenIn == xBTRFLY) {
+            // wrapFromxBTRFLY returns amountWXBTRFLYout
+            amountSharesOut = IWXBTRFLY(wxBTRFLY).wrapFromxBTRFLY(amountDeposited);
+        } else {
+            // must be BTRFLY
+            // wrapFromBTRFLY returns amountWXBTRFLYout
+            amountSharesOut = IWXBTRFLY(wxBTRFLY).wrapFromBTRFLY(amountDeposited);
+        }
+    }
+
+    /**
+     * @dev See {SCYBase-_redeem}
+     *
+     * The shares are redeemed into the same amount of wxBTRFLY. If `tokenOut` is not wxBTRFLY
+     * the function unwraps said amount of wxBTRFLY into `tokenOut` for redemption.
+     */
+    function _redeem(address tokenOut, uint256 amountSharesToRedeem)
+        internal
+        virtual
+        override
+        returns (uint256 amountTokenOut)
+    {
+        if (tokenOut == wxBTRFLY) {
+            amountTokenOut = amountSharesToRedeem;
+        } else if (tokenOut == xBTRFLY) {
+            amountTokenOut = IWXBTRFLY(wxBTRFLY).unwrapToxBTRFLY(amountSharesToRedeem);
+        } else {
+            // must be BTRFLY
+            amountTokenOut = IWXBTRFLY(wxBTRFLY).unwrapToBTRFLY(amountSharesToRedeem);
+        }
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                               EXCHANGE-RATE
+    //////////////////////////////////////////////////////////////*/
+
+    /**
+     * @notice Calculates and updates the exchange rate of shares to underlying asset token
+     * @dev It is the conversion rate of wxBTRFLY to BTRFLY
+     */
+    function exchangeRate() public view virtual override returns (uint256) {
+        return IWXBTRFLY(wxBTRFLY).xBTRFLYValue(Math.ONE);
+    }
+
+    /*///////////////////////////////////////////////////////////////
+                MISC FUNCTIONS FOR METADATA
+    //////////////////////////////////////////////////////////////*/
+
+    /**
+     * @dev See {ISuperComposableYield-getBaseTokens}
+     */
+    function getBaseTokens() public view virtual override returns (address[] memory res) {
+        res = new address[](3);
+        res[0] = BTRFLY;
+        res[1] = xBTRFLY;
+        res[2] = wxBTRFLY;
+    }
+
+    /**
+     * @dev See {ISuperComposableYield-isValidBaseToken}
+     */
+    function isValidBaseToken(address token) public view virtual override returns (bool) {
+        return token == BTRFLY || token == xBTRFLY || token == wxBTRFLY;
+    }
+
+    function assetInfo()
+        external
+        view
+        returns (
+            AssetType assetType,
+            address assetAddress,
+            uint8 assetDecimals
+        )
+    {
+        return (AssetType.TOKEN, BTRFLY, IERC20Metadata(BTRFLY).decimals());
+    }
+}