Overview
S Balance
S Value
$0.00More Info
Private Name Tags
ContractCreator
Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
---|---|---|---|---|---|---|---|---|---|
Latest 1 internal transaction
Parent Transaction Hash | Block | From | To | |||
---|---|---|---|---|---|---|
11461948 | 2 days ago | Contract Creation | 0 S |
Loading...
Loading
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Source Code Verified (Exact Match)
Contract Name:
SiloAdvancedLib
Compiler Version
v0.8.23+commit.f704f362
Optimization Enabled:
Yes with 200 runs
Other Settings:
shanghai EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import {IERC4626} from "@openzeppelin/contracts/interfaces/IERC4626.sol"; import {Math} from "@openzeppelin/contracts/utils/math/Math.sol"; import {StrategyLib} from "./StrategyLib.sol"; import {ISilo} from "../../integrations/silo/ISilo.sol"; import {ISiloConfig} from "../../integrations/silo/ISiloConfig.sol"; import {ISiloOracle} from "../../integrations/silo/ISiloOracle.sol"; import {ISiloLens} from "../../integrations/silo/ISiloLens.sol"; import {ILeverageLendingStrategy} from "../../interfaces/ILeverageLendingStrategy.sol"; import {IPriceReader} from "../../interfaces/IPriceReader.sol"; import {IPlatform} from "../../interfaces/IPlatform.sol"; import {IControllable} from "../../interfaces/IControllable.sol"; library SiloAdvancedLib { using SafeERC20 for IERC20; /// @dev 100_00 is 1.0 or 100% uint public constant INTERNAL_PRECISION = 100_00; function receiveFlashLoan( address platform, ILeverageLendingStrategy.LeverageLendingBaseStorage storage $, address token, uint amount, uint feeAmount ) external { // token is borrow asset (USDC/WETH/wS) address collateralAsset = $.collateralAsset; address flashLoanVault = $.flashLoanVault; if (msg.sender != flashLoanVault) { revert IControllable.IncorrectMsgSender(); } if ($.tempAction == ILeverageLendingStrategy.CurrentAction.Deposit) { uint tempBorrowAmount = $.tempBorrowAmount; // swap StrategyLib.swap(platform, token, collateralAsset, amount, $.swapPriceImpactTolerance0); // supply ISilo($.lendingVault).deposit( IERC20(collateralAsset).balanceOf(address(this)), address(this), ISilo.CollateralType.Collateral ); // borrow ISilo($.borrowingVault).borrow(tempBorrowAmount, address(this), address(this)); // pay flash loan IERC20(token).safeTransfer(flashLoanVault, amount + feeAmount); // repay remaining balance ISilo($.borrowingVault).repay(StrategyLib.balance(token), address(this)); // reset temp vars $.tempBorrowAmount = 0; } if ($.tempAction == ILeverageLendingStrategy.CurrentAction.Withdraw) { uint tempCollateralAmount = $.tempCollateralAmount; uint swapPriceImpactTolerance0 = $.swapPriceImpactTolerance0; // repay debt ISilo($.borrowingVault).repay(amount, address(this)); // withdraw { address lendingVault = $.lendingVault; uint collateralAmountTotal = totalCollateral(lendingVault); collateralAmountTotal -= collateralAmountTotal / 1000; ISilo(lendingVault).withdraw( Math.min(tempCollateralAmount, collateralAmountTotal), address(this), address(this), ISilo.CollateralType.Collateral ); } // swap StrategyLib.swap( platform, collateralAsset, token, Math.min(tempCollateralAmount, StrategyLib.balance(collateralAsset)), swapPriceImpactTolerance0 ); // pay flash loan IERC20(token).safeTransfer(flashLoanVault, amount + feeAmount); // swap unnecessary borrow asset StrategyLib.swap(platform, token, collateralAsset, StrategyLib.balance(token), swapPriceImpactTolerance0); // reset temp vars $.tempCollateralAmount = 0; } if ($.tempAction == ILeverageLendingStrategy.CurrentAction.DecreaseLtv) { address lendingVault = $.lendingVault; // repay ISilo($.borrowingVault).repay(StrategyLib.balance(token), address(this)); // withdraw amount ISilo(lendingVault).withdraw( $.tempCollateralAmount, address(this), address(this), ISilo.CollateralType.Collateral ); // swap StrategyLib.swap(platform, collateralAsset, token, $.tempCollateralAmount, $.swapPriceImpactTolerance1); // pay flash loan IERC20(token).safeTransfer(flashLoanVault, amount + feeAmount); // repay remaining balance ISilo($.borrowingVault).repay(StrategyLib.balance(token), address(this)); $.tempCollateralAmount = 0; } if ($.tempAction == ILeverageLendingStrategy.CurrentAction.IncreaseLtv) { uint tempBorrowAmount = $.tempBorrowAmount; // swap StrategyLib.swap( platform, token, collateralAsset, IERC20(token).balanceOf(address(this)) * $.increaseLtvParam1 / INTERNAL_PRECISION, $.swapPriceImpactTolerance1 ); // supply ISilo($.lendingVault).deposit( IERC20(collateralAsset).balanceOf(address(this)), address(this), ISilo.CollateralType.Collateral ); // borrow ISilo($.borrowingVault).borrow(tempBorrowAmount, address(this), address(this)); // pay flash loan IERC20(token).safeTransfer(flashLoanVault, amount + feeAmount); // repay remaining balance ISilo($.borrowingVault).repay(StrategyLib.balance(token), address(this)); // reset temp vars $.tempBorrowAmount = 0; } (uint ltv,, uint leverage,,,) = health(platform, $); emit ILeverageLendingStrategy.LeverageLendingHealth(ltv, leverage); $.tempAction = ILeverageLendingStrategy.CurrentAction.None; } function health( address platform, ILeverageLendingStrategy.LeverageLendingBaseStorage storage $ ) public view returns ( uint ltv, uint maxLtv, uint leverage, uint collateralAmount, uint debtAmount, uint targetLeveragePercent ) { address lendingVault = $.lendingVault; address collateralAsset = $.collateralAsset; ltv = ISiloLens($.helper).getLtv(lendingVault, address(this)); ltv = ltv * INTERNAL_PRECISION / 1e18; collateralAmount = StrategyLib.balance(collateralAsset) + totalCollateral(lendingVault); debtAmount = totalDebt($.borrowingVault); IPriceReader priceReader = IPriceReader(IPlatform(platform).priceReader()); (uint _realTvl,) = realTvl(platform, $); (uint collateralPrice,) = priceReader.getPrice(collateralAsset); uint collateralUsd = collateralAmount * collateralPrice / 10 ** IERC20Metadata(collateralAsset).decimals(); leverage = collateralUsd * INTERNAL_PRECISION / _realTvl; targetLeveragePercent = $.targetLeveragePercent; (maxLtv,,) = getLtvData(lendingVault, targetLeveragePercent); } function realTvl( address platform, ILeverageLendingStrategy.LeverageLendingBaseStorage storage $ ) public view returns (uint tvl, bool trusted) { IPriceReader priceReader = IPriceReader(IPlatform(platform).priceReader()); address lendingVault = $.lendingVault; address collateralAsset = $.collateralAsset; address borrowAsset = $.borrowAsset; uint collateralAmount = StrategyLib.balance(collateralAsset) + totalCollateral(lendingVault); (uint collateralPrice, bool CollateralPriceTrusted) = priceReader.getPrice(collateralAsset); uint collateralUsd = collateralAmount * collateralPrice / 10 ** IERC20Metadata(collateralAsset).decimals(); uint borrowedAmount = totalDebt($.borrowingVault); (uint borrowAssetPrice, bool borrowAssetPriceTrusted) = priceReader.getPrice(borrowAsset); uint borrowAssetUsd = borrowedAmount * borrowAssetPrice / 10 ** IERC20Metadata(borrowAsset).decimals(); tvl = collateralUsd - borrowAssetUsd; trusted = CollateralPriceTrusted && borrowAssetPriceTrusted; } function getPrices(address lendVault, address debtVault) public view returns (uint priceCtoB, uint priceBtoC) { ISiloConfig siloConfig = ISiloConfig(ISilo(lendVault).config()); ISiloConfig.ConfigData memory collateralConfig = siloConfig.getConfig(lendVault); address collateralOracle = collateralConfig.solvencyOracle; ISiloConfig.ConfigData memory borrowConfig = siloConfig.getConfig(debtVault); address borrowOracle = borrowConfig.solvencyOracle; if (collateralOracle != address(0) && borrowOracle == address(0)) { priceCtoB = ISiloOracle(collateralOracle).quote( 10 ** IERC20Metadata(collateralConfig.token).decimals(), collateralConfig.token ); priceBtoC = 1e18 * 1e18 / priceCtoB; } else if (collateralOracle == address(0) && borrowOracle != address(0)) { priceBtoC = ISiloOracle(borrowOracle).quote(10 ** IERC20Metadata(borrowConfig.token).decimals(), borrowConfig.token); priceCtoB = 1e18 * 1e18 / priceBtoC; } else { priceCtoB = ISiloOracle(collateralOracle).quote( 10 ** IERC20Metadata(collateralConfig.token).decimals(), collateralConfig.token ); priceBtoC = 1e18 * 1e18 / priceCtoB; } } /// @dev LTV data /// @return maxLtv Max LTV with 18 decimals /// @return maxLeverage Max leverage multiplier with 4 decimals /// @return targetLeverage Target leverage multiplier with 4 decimals function getLtvData( address lendingVault, uint targetLeveragePercent ) public view returns (uint maxLtv, uint maxLeverage, uint targetLeverage) { address configContract = ISilo(lendingVault).config(); ISiloConfig.ConfigData memory config = ISiloConfig(configContract).getConfig(lendingVault); maxLtv = config.maxLtv; maxLeverage = 1e18 * INTERNAL_PRECISION / (1e18 - maxLtv); targetLeverage = maxLeverage * targetLeveragePercent / INTERNAL_PRECISION; } function calcTotal(ILeverageLendingStrategy.LeverageLendingAddresses memory v) external view returns (uint) { (, uint priceBtoC) = getPrices(v.lendingVault, v.borrowingVault); uint borrowedAmountPricedInCollateral = totalDebt(v.borrowingVault) * priceBtoC / 1e18; return totalCollateral(v.lendingVault) - borrowedAmountPricedInCollateral; } function totalCollateral(address lendingVault) public view returns (uint) { return IERC4626(lendingVault).convertToAssets(StrategyLib.balance(lendingVault)); } function totalDebt(address borrowingVault) public view returns (uint) { return ISilo(borrowingVault).maxRepay(address(this)); } /*function _mintCollateralAsset(address token, address */ /*tokenOut*/ /*, uint amount) internal { if (token == TOKEN_USDC) { // mint scUSD IERC20(TOKEN_USDC).forceApprove(TOKEN_scUSD, amount); ITeller(TELLER_scUSD).deposit(TOKEN_USDC, amount, 0); // mint stkscUSD IERC20(TOKEN_scUSD).forceApprove(TOKEN_stkscUSD, amount); ITeller(TELLER_stkscUSD).deposit(TOKEN_scUSD, amount, 0); // mint wstkscUSD IERC20(TOKEN_stkscUSD).forceApprove(TOKEN_wstkscUSD, amount); IERC4626(TOKEN_wstkscUSD).deposit(amount, address(this)); } }*/ }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol) pragma solidity ^0.8.20; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @dev Emitted when `value` tokens are moved from one account (`from`) to * another (`to`). * * Note that `value` may be zero. */ event Transfer(address indexed from, address indexed to, uint256 value); /** * @dev Emitted when the allowance of a `spender` for an `owner` is set by * a call to {approve}. `value` is the new allowance. */ event Approval(address indexed owner, address indexed spender, uint256 value); /** * @dev Returns the value of tokens in existence. */ function totalSupply() external view returns (uint256); /** * @dev Returns the value of tokens owned by `account`. */ function balanceOf(address account) external view returns (uint256); /** * @dev Moves a `value` amount of tokens from the caller's account to `to`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address to, uint256 value) external returns (bool); /** * @dev Returns the remaining number of tokens that `spender` will be * allowed to spend on behalf of `owner` through {transferFrom}. This is * zero by default. * * This value changes when {approve} or {transferFrom} are called. */ function allowance(address owner, address spender) external view returns (uint256); /** * @dev Sets a `value` amount of tokens as the allowance of `spender` over the * caller's tokens. * * Returns a boolean value indicating whether the operation succeeded. * * IMPORTANT: Beware that changing an allowance with this method brings the risk * that someone may use both the old and the new allowance by unfortunate * transaction ordering. One possible solution to mitigate this race * condition is to first reduce the spender's allowance to 0 and set the * desired value afterwards: * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 * * Emits an {Approval} event. */ function approve(address spender, uint256 value) external returns (bool); /** * @dev Moves a `value` amount of tokens from `from` to `to` using the * allowance mechanism. `value` is then deducted from the caller's * allowance. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transferFrom(address from, address to, uint256 value) external returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/utils/SafeERC20.sol) pragma solidity ^0.8.20; import {IERC20} from "../IERC20.sol"; import {IERC20Permit} from "../extensions/IERC20Permit.sol"; import {Address} from "../../../utils/Address.sol"; /** * @title SafeERC20 * @dev Wrappers around ERC20 operations that throw on failure (when the token * contract returns false). Tokens that return no value (and instead revert or * throw on failure) are also supported, non-reverting calls are assumed to be * successful. * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract, * which allows you to call the safe operations as `token.safeTransfer(...)`, etc. */ library SafeERC20 { using Address for address; /** * @dev An operation with an ERC20 token failed. */ error SafeERC20FailedOperation(address token); /** * @dev Indicates a failed `decreaseAllowance` request. */ error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease); /** * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value, * non-reverting calls are assumed to be successful. */ function safeTransfer(IERC20 token, address to, uint256 value) internal { _callOptionalReturn(token, abi.encodeCall(token.transfer, (to, value))); } /** * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful. */ function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal { _callOptionalReturn(token, abi.encodeCall(token.transferFrom, (from, to, value))); } /** * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value, * non-reverting calls are assumed to be successful. */ function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal { uint256 oldAllowance = token.allowance(address(this), spender); forceApprove(token, spender, oldAllowance + value); } /** * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no * value, non-reverting calls are assumed to be successful. */ function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal { unchecked { uint256 currentAllowance = token.allowance(address(this), spender); if (currentAllowance < requestedDecrease) { revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease); } forceApprove(token, spender, currentAllowance - requestedDecrease); } } /** * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value, * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval * to be set to zero before setting it to a non-zero value, such as USDT. */ function forceApprove(IERC20 token, address spender, uint256 value) internal { bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value)); if (!_callOptionalReturnBool(token, approvalCall)) { _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0))); _callOptionalReturn(token, approvalCall); } } /** * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement * on the return value: the return value is optional (but if data is returned, it must not be false). * @param token The token targeted by the call. * @param data The call data (encoded using abi.encode or one of its variants). */ function _callOptionalReturn(IERC20 token, bytes memory data) private { // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that // the target address contains contract code and also asserts for success in the low-level call. bytes memory returndata = address(token).functionCall(data); if (returndata.length != 0 && !abi.decode(returndata, (bool))) { revert SafeERC20FailedOperation(address(token)); } } /** * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement * on the return value: the return value is optional (but if data is returned, it must not be false). * @param token The token targeted by the call. * @param data The call data (encoded using abi.encode or one of its variants). * * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead. */ function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) { // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false // and not revert is the subcall reverts. (bool success, bytes memory returndata) = address(token).call(data); return success && (returndata.length == 0 || abi.decode(returndata, (bool))) && address(token).code.length > 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Metadata.sol) pragma solidity ^0.8.20; import {IERC20} from "../IERC20.sol"; /** * @dev Interface for the optional metadata functions from the ERC20 standard. */ interface IERC20Metadata is IERC20 { /** * @dev Returns the name of the token. */ function name() external view returns (string memory); /** * @dev Returns the symbol of the token. */ function symbol() external view returns (string memory); /** * @dev Returns the decimals places of the token. */ function decimals() external view returns (uint8); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC4626.sol) pragma solidity ^0.8.20; import {IERC20} from "../token/ERC20/IERC20.sol"; import {IERC20Metadata} from "../token/ERC20/extensions/IERC20Metadata.sol"; /** * @dev Interface of the ERC4626 "Tokenized Vault Standard", as defined in * https://eips.ethereum.org/EIPS/eip-4626[ERC-4626]. */ interface IERC4626 is IERC20, IERC20Metadata { event Deposit(address indexed sender, address indexed owner, uint256 assets, uint256 shares); event Withdraw( address indexed sender, address indexed receiver, address indexed owner, uint256 assets, uint256 shares ); /** * @dev Returns the address of the underlying token used for the Vault for accounting, depositing, and withdrawing. * * - MUST be an ERC-20 token contract. * - MUST NOT revert. */ function asset() external view returns (address assetTokenAddress); /** * @dev Returns the total amount of the underlying asset that is “managed” by Vault. * * - SHOULD include any compounding that occurs from yield. * - MUST be inclusive of any fees that are charged against assets in the Vault. * - MUST NOT revert. */ function totalAssets() external view returns (uint256 totalManagedAssets); /** * @dev Returns the amount of shares that the Vault would exchange for the amount of assets provided, in an ideal * scenario where all the conditions are met. * * - MUST NOT be inclusive of any fees that are charged against assets in the Vault. * - MUST NOT show any variations depending on the caller. * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange. * - MUST NOT revert. * * NOTE: This calculation MAY NOT reflect the “per-user” price-per-share, and instead should reflect the * “average-user’s” price-per-share, meaning what the average user should expect to see when exchanging to and * from. */ function convertToShares(uint256 assets) external view returns (uint256 shares); /** * @dev Returns the amount of assets that the Vault would exchange for the amount of shares provided, in an ideal * scenario where all the conditions are met. * * - MUST NOT be inclusive of any fees that are charged against assets in the Vault. * - MUST NOT show any variations depending on the caller. * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange. * - MUST NOT revert. * * NOTE: This calculation MAY NOT reflect the “per-user” price-per-share, and instead should reflect the * “average-user’s” price-per-share, meaning what the average user should expect to see when exchanging to and * from. */ function convertToAssets(uint256 shares) external view returns (uint256 assets); /** * @dev Returns the maximum amount of the underlying asset that can be deposited into the Vault for the receiver, * through a deposit call. * * - MUST return a limited value if receiver is subject to some deposit limit. * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of assets that may be deposited. * - MUST NOT revert. */ function maxDeposit(address receiver) external view returns (uint256 maxAssets); /** * @dev Allows an on-chain or off-chain user to simulate the effects of their deposit at the current block, given * current on-chain conditions. * * - MUST return as close to and no more than the exact amount of Vault shares that would be minted in a deposit * call in the same transaction. I.e. deposit should return the same or more shares as previewDeposit if called * in the same transaction. * - MUST NOT account for deposit limits like those returned from maxDeposit and should always act as though the * deposit would be accepted, regardless if the user has enough tokens approved, etc. * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees. * - MUST NOT revert. * * NOTE: any unfavorable discrepancy between convertToShares and previewDeposit SHOULD be considered slippage in * share price or some other type of condition, meaning the depositor will lose assets by depositing. */ function previewDeposit(uint256 assets) external view returns (uint256 shares); /** * @dev Mints shares Vault shares to receiver by depositing exactly amount of underlying tokens. * * - MUST emit the Deposit event. * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the * deposit execution, and are accounted for during deposit. * - MUST revert if all of assets cannot be deposited (due to deposit limit being reached, slippage, the user not * approving enough underlying tokens to the Vault contract, etc). * * NOTE: most implementations will require pre-approval of the Vault with the Vault’s underlying asset token. */ function deposit(uint256 assets, address receiver) external returns (uint256 shares); /** * @dev Returns the maximum amount of the Vault shares that can be minted for the receiver, through a mint call. * - MUST return a limited value if receiver is subject to some mint limit. * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of shares that may be minted. * - MUST NOT revert. */ function maxMint(address receiver) external view returns (uint256 maxShares); /** * @dev Allows an on-chain or off-chain user to simulate the effects of their mint at the current block, given * current on-chain conditions. * * - MUST return as close to and no fewer than the exact amount of assets that would be deposited in a mint call * in the same transaction. I.e. mint should return the same or fewer assets as previewMint if called in the * same transaction. * - MUST NOT account for mint limits like those returned from maxMint and should always act as though the mint * would be accepted, regardless if the user has enough tokens approved, etc. * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees. * - MUST NOT revert. * * NOTE: any unfavorable discrepancy between convertToAssets and previewMint SHOULD be considered slippage in * share price or some other type of condition, meaning the depositor will lose assets by minting. */ function previewMint(uint256 shares) external view returns (uint256 assets); /** * @dev Mints exactly shares Vault shares to receiver by depositing amount of underlying tokens. * * - MUST emit the Deposit event. * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the mint * execution, and are accounted for during mint. * - MUST revert if all of shares cannot be minted (due to deposit limit being reached, slippage, the user not * approving enough underlying tokens to the Vault contract, etc). * * NOTE: most implementations will require pre-approval of the Vault with the Vault’s underlying asset token. */ function mint(uint256 shares, address receiver) external returns (uint256 assets); /** * @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the * Vault, through a withdraw call. * * - MUST return a limited value if owner is subject to some withdrawal limit or timelock. * - MUST NOT revert. */ function maxWithdraw(address owner) external view returns (uint256 maxAssets); /** * @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block, * given current on-chain conditions. * * - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw * call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if * called * in the same transaction. * - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though * the withdrawal would be accepted, regardless if the user has enough shares, etc. * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees. * - MUST NOT revert. * * NOTE: any unfavorable discrepancy between convertToShares and previewWithdraw SHOULD be considered slippage in * share price or some other type of condition, meaning the depositor will lose assets by depositing. */ function previewWithdraw(uint256 assets) external view returns (uint256 shares); /** * @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver. * * - MUST emit the Withdraw event. * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the * withdraw execution, and are accounted for during withdraw. * - MUST revert if all of assets cannot be withdrawn (due to withdrawal limit being reached, slippage, the owner * not having enough shares, etc). * * Note that some implementations will require pre-requesting to the Vault before a withdrawal may be performed. * Those methods should be performed separately. */ function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares); /** * @dev Returns the maximum amount of Vault shares that can be redeemed from the owner balance in the Vault, * through a redeem call. * * - MUST return a limited value if owner is subject to some withdrawal limit or timelock. * - MUST return balanceOf(owner) if owner is not subject to any withdrawal limit or timelock. * - MUST NOT revert. */ function maxRedeem(address owner) external view returns (uint256 maxShares); /** * @dev Allows an on-chain or off-chain user to simulate the effects of their redeemption at the current block, * given current on-chain conditions. * * - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call * in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the * same transaction. * - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the * redemption would be accepted, regardless if the user has enough shares, etc. * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees. * - MUST NOT revert. * * NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in * share price or some other type of condition, meaning the depositor will lose assets by redeeming. */ function previewRedeem(uint256 shares) external view returns (uint256 assets); /** * @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver. * * - MUST emit the Withdraw event. * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the * redeem execution, and are accounted for during redeem. * - MUST revert if all of shares cannot be redeemed (due to withdrawal limit being reached, slippage, the owner * not having enough shares, etc). * * NOTE: some implementations will require pre-requesting to the Vault before a withdrawal may be performed. * Those methods should be performed separately. */ function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/Math.sol) pragma solidity ^0.8.20; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { /** * @dev Muldiv operation overflow. */ error MathOverflowedMulDiv(); enum Rounding { Floor, // Toward negative infinity Ceil, // Toward positive infinity Trunc, // Toward zero Expand // Away from zero } /** * @dev Returns the addition of two unsigned integers, with an overflow flag. */ function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { uint256 c = a + b; if (c < a) return (false, 0); return (true, c); } } /** * @dev Returns the subtraction of two unsigned integers, with an overflow flag. */ function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b > a) return (false, 0); return (true, a - b); } } /** * @dev Returns the multiplication of two unsigned integers, with an overflow flag. */ function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { // Gas optimization: this is cheaper than requiring 'a' not being zero, but the // benefit is lost if 'b' is also tested. // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522 if (a == 0) return (true, 0); uint256 c = a * b; if (c / a != b) return (false, 0); return (true, c); } } /** * @dev Returns the division of two unsigned integers, with a division by zero flag. */ function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b == 0) return (false, 0); return (true, a / b); } } /** * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag. */ function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b == 0) return (false, 0); return (true, a % b); } } /** * @dev Returns the largest of two numbers. */ function max(uint256 a, uint256 b) internal pure returns (uint256) { return a > b ? a : b; } /** * @dev Returns the smallest of two numbers. */ function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /** * @dev Returns the average of two numbers. The result is rounded towards * zero. */ function average(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b) / 2 can overflow. return (a & b) + (a ^ b) / 2; } /** * @dev Returns the ceiling of the division of two numbers. * * This differs from standard division with `/` in that it rounds towards infinity instead * of rounding towards zero. */ function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) { if (b == 0) { // Guarantee the same behavior as in a regular Solidity division. return a / b; } // (a + b - 1) / b can overflow on addition, so we distribute. return a == 0 ? 0 : (a - 1) / b + 1; } /** * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or * denominator == 0. * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by * Uniswap Labs also under MIT license. */ function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) { unchecked { // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256 // variables such that product = prod1 * 2^256 + prod0. uint256 prod0 = x * y; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { // Solidity will revert if denominator == 0, unlike the div opcode on its own. // The surrounding unchecked block does not change this fact. // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic. return prod0 / denominator; } // Make sure the result is less than 2^256. Also prevents denominator == 0. if (denominator <= prod1) { revert MathOverflowedMulDiv(); } /////////////////////////////////////////////// // 512 by 256 division. /////////////////////////////////////////////// // Make division exact by subtracting the remainder from [prod1 prod0]. uint256 remainder; assembly { // Compute remainder using mulmod. remainder := mulmod(x, y, denominator) // Subtract 256 bit number from 512 bit number. prod1 := sub(prod1, gt(remainder, prod0)) prod0 := sub(prod0, remainder) } // Factor powers of two out of denominator and compute largest power of two divisor of denominator. // Always >= 1. See https://cs.stackexchange.com/q/138556/92363. uint256 twos = denominator & (0 - denominator); assembly { // Divide denominator by twos. denominator := div(denominator, twos) // Divide [prod1 prod0] by twos. prod0 := div(prod0, twos) // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one. twos := add(div(sub(0, twos), twos), 1) } // Shift in bits from prod1 into prod0. prod0 |= prod1 * twos; // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for // four bits. That is, denominator * inv = 1 mod 2^4. uint256 inverse = (3 * denominator) ^ 2; // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also // works in modular arithmetic, doubling the correct bits in each step. inverse *= 2 - denominator * inverse; // inverse mod 2^8 inverse *= 2 - denominator * inverse; // inverse mod 2^16 inverse *= 2 - denominator * inverse; // inverse mod 2^32 inverse *= 2 - denominator * inverse; // inverse mod 2^64 inverse *= 2 - denominator * inverse; // inverse mod 2^128 inverse *= 2 - denominator * inverse; // inverse mod 2^256 // Because the division is now exact we can divide by multiplying with the modular inverse of denominator. // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1 // is no longer required. result = prod0 * inverse; return result; } } /** * @notice Calculates x * y / denominator with full precision, following the selected rounding direction. */ function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) { uint256 result = mulDiv(x, y, denominator); if (unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0) { result += 1; } return result; } /** * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded * towards zero. * * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11). */ function sqrt(uint256 a) internal pure returns (uint256) { if (a == 0) { return 0; } // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target. // // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`. // // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)` // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))` // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)` // // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit. uint256 result = 1 << (log2(a) >> 1); // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128, // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision // into the expected uint128 result. unchecked { result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; return min(result, a / result); } } /** * @notice Calculates sqrt(a), following the selected rounding direction. */ function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = sqrt(a); return result + (unsignedRoundsUp(rounding) && result * result < a ? 1 : 0); } } /** * @dev Return the log in base 2 of a positive value rounded towards zero. * Returns 0 if given 0. */ function log2(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 128; } if (value >> 64 > 0) { value >>= 64; result += 64; } if (value >> 32 > 0) { value >>= 32; result += 32; } if (value >> 16 > 0) { value >>= 16; result += 16; } if (value >> 8 > 0) { value >>= 8; result += 8; } if (value >> 4 > 0) { value >>= 4; result += 4; } if (value >> 2 > 0) { value >>= 2; result += 2; } if (value >> 1 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 2, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log2(value); return result + (unsignedRoundsUp(rounding) && 1 << result < value ? 1 : 0); } } /** * @dev Return the log in base 10 of a positive value rounded towards zero. * Returns 0 if given 0. */ function log10(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >= 10 ** 64) { value /= 10 ** 64; result += 64; } if (value >= 10 ** 32) { value /= 10 ** 32; result += 32; } if (value >= 10 ** 16) { value /= 10 ** 16; result += 16; } if (value >= 10 ** 8) { value /= 10 ** 8; result += 8; } if (value >= 10 ** 4) { value /= 10 ** 4; result += 4; } if (value >= 10 ** 2) { value /= 10 ** 2; result += 2; } if (value >= 10 ** 1) { result += 1; } } return result; } /** * @dev Return the log in base 10, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log10(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log10(value); return result + (unsignedRoundsUp(rounding) && 10 ** result < value ? 1 : 0); } } /** * @dev Return the log in base 256 of a positive value rounded towards zero. * Returns 0 if given 0. * * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string. */ function log256(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 16; } if (value >> 64 > 0) { value >>= 64; result += 8; } if (value >> 32 > 0) { value >>= 32; result += 4; } if (value >> 16 > 0) { value >>= 16; result += 2; } if (value >> 8 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 256, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log256(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log256(value); return result + (unsignedRoundsUp(rounding) && 1 << (result << 3) < value ? 1 : 0); } } /** * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers. */ function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) { return uint8(rounding) % 2 == 1; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol"; import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import "@openzeppelin/contracts/utils/math/Math.sol"; import "../../core/libs/ConstantsLib.sol"; import "../../core/libs/VaultTypeLib.sol"; import "../../core/libs/CommonLib.sol"; import "../../interfaces/IPlatform.sol"; import "../../interfaces/IVault.sol"; import "../../interfaces/IVaultManager.sol"; import "../../interfaces/IStrategyLogic.sol"; import "../../interfaces/IFactory.sol"; import "../../interfaces/IPriceReader.sol"; import "../../interfaces/ISwapper.sol"; import "../../interfaces/ILPStrategy.sol"; import "../../interfaces/IFarmingStrategy.sol"; library StrategyLib { using SafeERC20 for IERC20; /// @dev Reward pools may have low liquidity and 1% fees uint internal constant SWAP_REWARDS_PRICE_IMPACT_TOLERANCE = 7_000; struct ExtractFeesVars { IPlatform platform; uint feePlatform; uint amountPlatform; uint feeShareVaultManager; uint amountVaultManager; uint feeShareStrategyLogic; uint amountStrategyLogic; uint feeShareEcosystem; uint amountEcosystem; } function FarmingStrategyBase_init( IFarmingStrategy.FarmingStrategyBaseStorage storage $, string memory id, address platform, uint farmId ) external { $.farmId = farmId; IFactory.Farm memory farm = IFactory(IPlatform(platform).factory()).farm(farmId); if (keccak256(bytes(farm.strategyLogicId)) != keccak256(bytes(id))) { revert IFarmingStrategy.IncorrectStrategyId(); } updateFarmingAssets($, platform); $._rewardsOnBalance = new uint[](farm.rewardAssets.length); } function updateFarmingAssets(IFarmingStrategy.FarmingStrategyBaseStorage storage $, address platform) public { IFactory.Farm memory farm = IFactory(IPlatform(platform).factory()).farm($.farmId); address swapper = IPlatform(platform).swapper(); $._rewardAssets = farm.rewardAssets; uint len = farm.rewardAssets.length; // nosemgrep for (uint i; i < len; ++i) { IERC20(farm.rewardAssets[i]).forceApprove(swapper, type(uint).max); } } function transferAssets( IStrategy.StrategyBaseStorage storage $, uint amount, uint total_, address receiver ) external returns (uint[] memory amountsOut) { address[] memory assets = $._assets; uint len = assets.length; amountsOut = new uint[](len); // nosemgrep for (uint i; i < len; ++i) { amountsOut[i] = balance(assets[i]) * amount / total_; IERC20(assets[i]).transfer(receiver, amountsOut[i]); } } function extractFees( address platform, address vault, string memory _id, address[] memory assets_, uint[] memory amounts_ ) external returns (uint[] memory amountsRemaining) { ExtractFeesVars memory vars = ExtractFeesVars({ platform: IPlatform(platform), feePlatform: 0, amountPlatform: 0, feeShareVaultManager: 0, amountVaultManager: 0, feeShareStrategyLogic: 0, amountStrategyLogic: 0, feeShareEcosystem: 0, amountEcosystem: 0 }); (vars.feePlatform, vars.feeShareVaultManager, vars.feeShareStrategyLogic, vars.feeShareEcosystem) = vars.platform.getFees(); try vars.platform.getCustomVaultFee(vault) returns (uint vaultCustomFee) { if (vaultCustomFee != 0) { vars.feePlatform = vaultCustomFee; } } catch {} address vaultManagerReceiver = IVaultManager(vars.platform.vaultManager()).getRevenueReceiver(IVault(vault).tokenId()); //slither-disable-next-line unused-return uint strategyLogicTokenId = IFactory(vars.platform.factory()).strategyLogicConfig(keccak256(bytes(_id))).tokenId; address strategyLogicReceiver = IStrategyLogic(vars.platform.strategyLogic()).getRevenueReceiver(strategyLogicTokenId); uint len = assets_.length; amountsRemaining = new uint[](len); // nosemgrep for (uint i; i < len; ++i) { // revenue fee amount of assets_[i] vars.amountPlatform = amounts_[i] * vars.feePlatform / ConstantsLib.DENOMINATOR; vars.amountPlatform = Math.min(vars.amountPlatform, balance(assets_[i])); if (vars.amountPlatform > 0) { // VaultManager amount vars.amountVaultManager = vars.amountPlatform * vars.feeShareVaultManager / ConstantsLib.DENOMINATOR; // StrategyLogic amount vars.amountStrategyLogic = vars.amountPlatform * vars.feeShareStrategyLogic / ConstantsLib.DENOMINATOR; // Ecosystem amount vars.amountEcosystem = vars.amountPlatform * vars.feeShareEcosystem / ConstantsLib.DENOMINATOR; // Multisig share and amount uint multisigShare = ConstantsLib.DENOMINATOR - vars.feeShareVaultManager - vars.feeShareStrategyLogic - vars.feeShareEcosystem; uint multisigAmount = multisigShare > 0 ? vars.amountPlatform - vars.amountVaultManager - vars.amountStrategyLogic - vars.amountEcosystem : 0; // send amounts IERC20(assets_[i]).safeTransfer(vaultManagerReceiver, vars.amountVaultManager); IERC20(assets_[i]).safeTransfer(strategyLogicReceiver, vars.amountStrategyLogic); if (vars.amountEcosystem > 0) { IERC20(assets_[i]).safeTransfer(vars.platform.ecosystemRevenueReceiver(), vars.amountEcosystem); } if (multisigAmount > 0) { IERC20(assets_[i]).safeTransfer(vars.platform.multisig(), multisigAmount); } emit IStrategy.ExtractFees( vars.amountVaultManager, vars.amountStrategyLogic, vars.amountEcosystem, multisigAmount ); amountsRemaining[i] = amounts_[i] - vars.amountPlatform; amountsRemaining[i] = Math.min(amountsRemaining[i], balance(assets_[i])); } } } function liquidateRewards( address platform, address exchangeAsset, address[] memory rewardAssets_, uint[] memory rewardAmounts_, uint customPriceImpactTolerance ) external returns (uint earnedExchangeAsset) { ISwapper swapper = ISwapper(IPlatform(platform).swapper()); uint len = rewardAssets_.length; uint exchangeAssetBalanceBefore = balance(exchangeAsset); // nosemgrep for (uint i; i < len; ++i) { if (rewardAmounts_[i] > swapper.threshold(rewardAssets_[i])) { if (rewardAssets_[i] != exchangeAsset) { swapper.swap( rewardAssets_[i], exchangeAsset, Math.min(rewardAmounts_[i], balance(rewardAssets_[i])), customPriceImpactTolerance != 0 ? customPriceImpactTolerance : SWAP_REWARDS_PRICE_IMPACT_TOLERANCE ); } else { exchangeAssetBalanceBefore = 0; } } } uint exchangeAssetBalanceAfter = balance(exchangeAsset); earnedExchangeAsset = exchangeAssetBalanceAfter - exchangeAssetBalanceBefore; } function emitApr( IStrategy.StrategyBaseStorage storage $, address platform, address[] memory assets, uint[] memory amounts, uint tvl, uint totalBefore ) external { uint duration = block.timestamp - $.lastHardWork; IPriceReader priceReader = IPriceReader(IPlatform(platform).priceReader()); //slither-disable-next-line unused-return (uint earned,, uint[] memory assetPrices,) = priceReader.getAssetsPrice(assets, amounts); uint apr = computeApr(tvl, earned, duration); uint aprCompound = totalBefore != 0 ? computeApr(totalBefore, $.total - totalBefore, duration) : apr; uint sharePrice = tvl * 1e18 / IERC20($.vault).totalSupply(); emit IStrategy.HardWork(apr, aprCompound, earned, tvl, duration, sharePrice, assetPrices); $.lastApr = apr; $.lastAprCompound = aprCompound; $.lastHardWork = block.timestamp; } function balance(address token) public view returns (uint) { return IERC20(token).balanceOf(address(this)); } /// @dev https://www.investopedia.com/terms/a/apr.asp /// TVL and rewards should be in the same currency and with the same decimals function computeApr(uint tvl, uint earned, uint duration) public pure returns (uint) { if (tvl == 0 || duration == 0) { return 0; } return earned * 1e18 * ConstantsLib.DENOMINATOR * uint(365) / tvl / (duration * 1e18 / 1 days); } function computeAprInt(uint tvl, int earned, uint duration) public pure returns (int) { if (tvl == 0 || duration == 0) { return 0; } return earned * int(1e18) * int(ConstantsLib.DENOMINATOR) * int(365) / int(tvl) / int(duration * 1e18 / 1 days); } function assetsAmountsWithBalances( address[] memory assets_, uint[] memory amounts_ ) external view returns (address[] memory assets, uint[] memory amounts) { assets = assets_; amounts = amounts_; uint len = assets_.length; // nosemgrep for (uint i; i < len; ++i) { amounts[i] += balance(assets_[i]); } } function assetsAreOnBalance(address[] memory assets) external view returns (bool isReady) { uint rwLen = assets.length; for (uint i; i < rwLen; ++i) { if (IERC20(assets[i]).balanceOf(address(this)) > 0) { isReady = true; break; } } } function isPositiveAmountInArray(uint[] memory amounts) external pure returns (bool) { uint len = amounts.length; for (uint i; i < len; ++i) { if (amounts[i] != 0) { return true; } } return false; } function swap(address platform, address tokenIn, address tokenOut, uint amount) external returns (uint amountOut) { uint outBalanceBefore = balance(tokenOut); ISwapper swapper = ISwapper(IPlatform(platform).swapper()); swapper.swap(tokenIn, tokenOut, amount, 1000); amountOut = balance(tokenOut) - outBalanceBefore; } function swap( address platform, address tokenIn, address tokenOut, uint amount, uint priceImpactTolerance ) external returns (uint amountOut) { uint outBalanceBefore = balance(tokenOut); ISwapper swapper = ISwapper(IPlatform(platform).swapper()); swapper.swap(tokenIn, tokenOut, amount, priceImpactTolerance); amountOut = balance(tokenOut) - outBalanceBefore; } // function getFarmsForStrategyId(address platform, string memory _id) external view returns (IFactory.Farm[] memory farms) { // uint total; // IFactory.Farm[] memory allFarms = IFactory(IPlatform(platform).factory()).farms(); // uint len = allFarms.length; // for (uint i; i < len; ++i) { // IFactory.Farm memory farm = allFarms[i]; // if (farm.status == 0 && CommonLib.eq(farm.strategyLogicId, _id)) { // total++; // } // } // farms = new IFactory.Farm[](total); // uint k; // for (uint i; i < len; ++i) { // IFactory.Farm memory farm = allFarms[i]; // if (farm.status == 0 && CommonLib.eq(farm.strategyLogicId, _id)) { // farms[k] = farm; // k++; // } // } // } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import {IERC4626} from "@openzeppelin/contracts/interfaces/IERC4626.sol"; interface ISilo is IERC4626 { /// @dev There are 2 types of accounting in the system: for non-borrowable collateral deposit called "protected" and /// for borrowable collateral deposit called "collateral". System does /// identical calculations for each type of accounting but it uses different data. To avoid code duplication /// this enum is used to decide which data should be read. enum CollateralType { Protected, Collateral } /// @notice Implements IERC4626.deposit for protected (non-borrowable) collateral and collateral /// @dev Reverts for debt asset type function deposit(uint _assets, address _receiver, CollateralType collateralType) external returns (uint shares); /// @notice Allows an address to borrow a specified amount of assets /// @param _assets Amount of assets to borrow /// @param _receiver Address receiving the borrowed assets /// @param _borrower Address responsible for the borrowed assets /// @return shares Amount of shares equivalent to the borrowed assets function borrow(uint _assets, address _receiver, address _borrower) external returns (uint shares); /// @notice Repays a given asset amount and returns the equivalent number of shares /// @param _assets Amount of assets to be repaid /// @param _borrower Address of the borrower whose debt is being repaid /// @return shares The equivalent number of shares for the provided asset amount function repay(uint _assets, address _borrower) external returns (uint shares); /// @notice Implements IERC4626.withdraw for protected (non-borrowable) collateral and collateral /// @dev Reverts for debt asset type function withdraw( uint _assets, address _receiver, address _owner, CollateralType collateralType ) external returns (uint shares); /// @notice Accrues interest for the asset and returns the accrued interest amount /// @return accruedInterest The total interest accrued during this operation function accrueInterest() external returns (uint accruedInterest); /// @inheritdoc IERC4626 /// @dev For protected (non-borrowable) collateral and debt, use: /// `convertToAssets(uint256 _shares, AssetType _assetType)` with `AssetType.Protected` or `AssetType.Debt` function convertToAssets(uint _shares) external view returns (uint assets); function asset() external view returns (address assetTokenAddres); /// @notice Fetches the silo configuration contract /// @return siloConfig Address of the configuration contract associated with the silo function config() external view returns (address siloConfig); /// @notice Calculates the maximum amount an address can repay based on their debt shares /// @param _borrower Address of the borrower /// @return assets Maximum amount of assets the borrower can repay function maxRepay(address _borrower) external view returns (uint assets); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import {ISilo} from "./ISilo.sol"; interface ISiloConfig { struct InitData { /// @notice Can be address zero if deployer fees are not to be collected. If deployer address is zero then /// deployer fee must be zero as well. Deployer will be minted an NFT that gives the right to claim deployer /// fees. NFT can be transferred with the right to claim. address deployer; /// @notice Address of the hook receiver called on every before/after action on Silo. Hook contract also /// implements liquidation logic and veSilo gauge connection. address hookReceiver; /// @notice Deployer's fee in 18 decimals points. Deployer will earn this fee based on the interest earned /// by the Silo. Max deployer fee is set by the DAO. At deployment it is 15%. uint deployerFee; /// @notice DAO's fee in 18 decimals points. DAO will earn this fee based on the interest earned /// by the Silo. Acceptable fee range fee is set by the DAO. Default at deployment is 5% - 50%. uint daoFee; /// @notice Address of the first token address token0; /// @notice Address of the solvency oracle. Solvency oracle is used to calculate LTV when deciding if borrower /// is solvent or should be liquidated. Solvency oracle is optional and if not set price of 1 will be assumed. address solvencyOracle0; /// @notice Address of the maxLtv oracle. Max LTV oracle is used to calculate LTV when deciding if borrower /// can borrow given amount of assets. Max LTV oracle is optional and if not set it defaults to solvency /// oracle. If neither is set price of 1 will be assumed. address maxLtvOracle0; /// @notice Address of the interest rate model address interestRateModel0; /// @notice Maximum LTV for first token. maxLTV is in 18 decimals points and is used to determine, if borrower /// can borrow given amount of assets. MaxLtv is in 18 decimals points. MaxLtv must be lower or equal to LT. uint maxLtv0; /// @notice Liquidation threshold for first token. LT is used to calculate solvency. LT is in 18 decimals /// points. LT must not be lower than maxLTV. uint lt0; /// @notice minimal acceptable LTV after liquidation, in 18 decimals points uint liquidationTargetLtv0; /// @notice Liquidation fee for the first token in 18 decimals points. Liquidation fee is what liquidator earns /// for repaying insolvent loan. uint liquidationFee0; /// @notice Flashloan fee sets the cost of taking a flashloan in 18 decimals points uint flashloanFee0; /// @notice Indicates if a beforeQuote on oracle contract should be called before quoting price bool callBeforeQuote0; /// @notice Address of the second token address token1; /// @notice Address of the solvency oracle. Solvency oracle is used to calculate LTV when deciding if borrower /// is solvent or should be liquidated. Solvency oracle is optional and if not set price of 1 will be assumed. address solvencyOracle1; /// @notice Address of the maxLtv oracle. Max LTV oracle is used to calculate LTV when deciding if borrower /// can borrow given amount of assets. Max LTV oracle is optional and if not set it defaults to solvency /// oracle. If neither is set price of 1 will be assumed. address maxLtvOracle1; /// @notice Address of the interest rate model address interestRateModel1; /// @notice Maximum LTV for first token. maxLTV is in 18 decimals points and is used to determine, /// if borrower can borrow given amount of assets. maxLtv is in 18 decimals points uint maxLtv1; /// @notice Liquidation threshold for first token. LT is used to calculate solvency. LT is in 18 decimals points uint lt1; /// @notice minimal acceptable LTV after liquidation, in 18 decimals points uint liquidationTargetLtv1; /// @notice Liquidation fee is what liquidator earns for repaying insolvent loan. uint liquidationFee1; /// @notice Flashloan fee sets the cost of taking a flashloan in 18 decimals points uint flashloanFee1; /// @notice Indicates if a beforeQuote on oracle contract should be called before quoting price bool callBeforeQuote1; } struct ConfigData { uint daoFee; uint deployerFee; address silo; address token; address protectedShareToken; address collateralShareToken; address debtShareToken; address solvencyOracle; address maxLtvOracle; address interestRateModel; uint maxLtv; uint lt; uint liquidationTargetLtv; uint liquidationFee; uint flashloanFee; address hookReceiver; bool callBeforeQuote; } struct DepositConfig { address silo; address token; address collateralShareToken; address protectedShareToken; uint daoFee; uint deployerFee; address interestRateModel; } error OnlySilo(); error OnlySiloOrTokenOrHookReceiver(); error WrongSilo(); error OnlyDebtShareToken(); error DebtExistInOtherSilo(); error FeeTooHigh(); /// @dev It should be called on debt transfer (debt share token transfer). /// In the case if the`_recipient` doesn't have configured a collateral silo, /// it will be set to the collateral silo of the `_sender`. /// @param _sender sender address /// @param _recipient recipient address function onDebtTransfer(address _sender, address _recipient) external; /// @notice Set collateral silo. /// @dev Revert if msg.sender is not a SILO_0 or SILO_1. /// @dev Always set collateral silo the same as msg.sender. /// @param _borrower borrower address function setThisSiloAsCollateralSilo(address _borrower) external; /// @notice Set collateral silo /// @dev Revert if msg.sender is not a SILO_0 or SILO_1. /// @dev Always set collateral silo opposite to the msg.sender. /// @param _borrower borrower address function setOtherSiloAsCollateralSilo(address _borrower) external; /// @notice Accrue interest for the silo /// @param _silo silo for which accrue interest function accrueInterestForSilo(address _silo) external; /// @notice Accrue interest for both silos (SILO_0 and SILO_1 in a config) function accrueInterestForBothSilos() external; /// @notice Retrieves the collateral silo for a specific borrower. /// @dev As a user can deposit into `Silo0` and `Silo1`, this property specifies which Silo /// will be used as collateral for the debt. Later on, it will be used for max LTV and solvency checks. /// After being set, the collateral silo is never set to `address(0)` again but such getters as /// `getConfigsForSolvency`, `getConfigsForBorrow`, `getConfigsForWithdraw` will return empty /// collateral silo config if borrower doesn't have debt. /// /// In the SiloConfig collateral silo is set by the following functions: /// `onDebtTransfer` - only if the recipient doesn't have collateral silo set (inherits it from the sender) /// This function is called on debt share token transfer (debt transfer). /// `setThisSiloAsCollateralSilo` - sets the same silo as the one that calls the function. /// `setOtherSiloAsCollateralSilo` - sets the opposite silo as collateral from the one that calls the function. /// /// In the Silo collateral silo is set by the following functions: /// `borrow` - always sets opposite silo as collateral. /// If Silo0 borrows, then Silo1 will be collateral and vice versa. /// `borrowSameAsset` - always sets the same silo as collateral. /// `switchCollateralToThisSilo` - always sets the same silo as collateral. /// @param _borrower The address of the borrower for which the collateral silo is being retrieved /// @return collateralSilo The address of the collateral silo for the specified borrower function borrowerCollateralSilo(address _borrower) external view returns (address collateralSilo); /// @notice Retrieves the silo ID /// @dev Each silo is assigned a unique ID. ERC-721 token is minted with identical ID to deployer. /// An owner of that token receives the deployer fees. /// @return siloId The ID of the silo function SILO_ID() external view returns (uint siloId); // solhint-disable-line func-name-mixedcase /// @notice Retrieves the addresses of the two silos /// @return silo0 The address of the first silo /// @return silo1 The address of the second silo function getSilos() external view returns (address silo0, address silo1); /// @notice Retrieves the asset associated with a specific silo /// @dev This function reverts for incorrect silo address input /// @param _silo The address of the silo for which the associated asset is being retrieved /// @return asset The address of the asset associated with the specified silo function getAssetForSilo(address _silo) external view returns (address asset); /// @notice Verifies if the borrower has debt in other silo by checking the debt share token balance /// @param _thisSilo The address of the silo in respect of which the debt is checked /// @param _borrower The address of the borrower for which the debt is checked /// @return hasDebt true if the borrower has debt in other silo function hasDebtInOtherSilo(address _thisSilo, address _borrower) external view returns (bool hasDebt); /// @notice Retrieves the debt silo associated with a specific borrower /// @dev This function reverts if debt present in two silo (should not happen) /// @param _borrower The address of the borrower for which the debt silo is being retrieved function getDebtSilo(address _borrower) external view returns (address debtSilo); /// @notice Retrieves configuration data for both silos. First config is for the silo that is asking for configs. /// @param borrower borrower address for which debtConfig will be returned /// @return collateralConfig The configuration data for collateral silo (empty if there is no debt). /// @return debtConfig The configuration data for debt silo (empty if there is no debt). function getConfigsForSolvency(address borrower) external view returns (ConfigData memory collateralConfig, ConfigData memory debtConfig); /// @notice Retrieves configuration data for a specific silo /// @dev This function reverts for incorrect silo address input. /// @param _silo The address of the silo for which configuration data is being retrieved /// @return config The configuration data for the specified silo function getConfig(address _silo) external view returns (ConfigData memory config); /// @notice Retrieves configuration data for a specific silo for withdraw fn. /// @dev This function reverts for incorrect silo address input. /// @param _silo The address of the silo for which configuration data is being retrieved /// @return depositConfig The configuration data for the specified silo (always config for `_silo`) /// @return collateralConfig The configuration data for the collateral silo (empty if there is no debt) /// @return debtConfig The configuration data for the debt silo (empty if there is no debt) function getConfigsForWithdraw( address _silo, address _borrower ) external view returns (DepositConfig memory depositConfig, ConfigData memory collateralConfig, ConfigData memory debtConfig); /// @notice Retrieves configuration data for a specific silo for borrow fn. /// @dev This function reverts for incorrect silo address input. /// @param _debtSilo The address of the silo for which configuration data is being retrieved /// @return collateralConfig The configuration data for the collateral silo (always other than `_debtSilo`) /// @return debtConfig The configuration data for the debt silo (always config for `_debtSilo`) function getConfigsForBorrow(address _debtSilo) external view returns (ConfigData memory collateralConfig, ConfigData memory debtConfig); /// @notice Retrieves fee-related information for a specific silo /// @dev This function reverts for incorrect silo address input /// @param _silo The address of the silo for which fee-related information is being retrieved. /// @return daoFee The DAO fee percentage in 18 decimals points. /// @return deployerFee The deployer fee percentage in 18 decimals points. /// @return flashloanFee The flashloan fee percentage in 18 decimals points. /// @return asset The address of the asset associated with the specified silo. function getFeesWithAsset(address _silo) external view returns (uint daoFee, uint deployerFee, uint flashloanFee, address asset); /// @notice Retrieves share tokens associated with a specific silo /// @dev This function reverts for incorrect silo address input /// @param _silo The address of the silo for which share tokens are being retrieved /// @return protectedShareToken The address of the protected (non-borrowable) share token /// @return collateralShareToken The address of the collateral share token /// @return debtShareToken The address of the debt share token function getShareTokens(address _silo) external view returns (address protectedShareToken, address collateralShareToken, address debtShareToken); /// @notice Retrieves the share token and the silo token associated with a specific silo /// @param _silo The address of the silo for which the share token and silo token are being retrieved /// @param _collateralType The type of collateral /// @return shareToken The address of the share token (collateral or protected collateral) /// @return asset The address of the silo token function getCollateralShareTokenAndAsset( address _silo, ISilo.CollateralType _collateralType ) external view returns (address shareToken, address asset); /// @notice Retrieves the share token and the silo token associated with a specific silo /// @param _silo The address of the silo for which the share token and silo token are being retrieved /// @return shareToken The address of the share token (debt) /// @return asset The address of the silo token function getDebtShareTokenAndAsset(address _silo) external view returns (address shareToken, address asset); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; interface ISiloOracle { /// @notice Hook function to call before `quote` function reads price /// @dev This hook function can be used to change state right before the price is read. For example it can be used /// for curve read only reentrancy protection. In majority of implementations this will be an empty function. /// WARNING: reverts are propagated to Silo so if `beforeQuote` reverts, Silo reverts as well. /// @param _baseToken Address of priced token function beforeQuote(address _baseToken) external; /// @return quoteAmount Returns quote price for _baseAmount of _baseToken /// @param _baseAmount Amount of priced token /// @param _baseToken Address of priced token function quote(uint _baseAmount, address _baseToken) external view returns (uint quoteAmount); /// @return address of token in which quote (price) is denominated function quoteToken() external view returns (address); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; interface ISiloLens { /// @notice Retrieves the loan-to-value (LTV) for a specific borrower /// @param _silo Address of the silo /// @param _borrower Address of the borrower /// @return ltv The LTV for the borrower in 18 decimals points function getLtv(address _silo, address _borrower) external view returns (uint ltv); /// @notice Calculates current borrow interest rate /// @param _silo Address of the silo /// @return borrowAPR The interest rate value in 18 decimals points. 10**18 is equal to 100% per year function getBorrowAPR(address _silo) external view returns (uint borrowAPR); /// @notice Calculates current deposit interest rate. /// @param _silo Address of the silo /// @return depositAPR The interest rate value in 18 decimals points. 10**18 is equal to 100% per year. function getDepositAPR(address _silo) external view returns (uint depositAPR); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; interface ILeverageLendingStrategy { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ event LeverageLendingHardWork( int realApr, int earned, uint realTvl, uint duration, uint realSharePrice, uint supplyApr, uint borrowApr ); event LeverageLendingHealth(uint ltv, uint leverage); event TargetLeveragePercent(uint value); event UniversalParams(uint[] params); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* DATA TYPES */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @custom:storage-location erc7201:stability.LeverageLendingBase struct LeverageLendingBaseStorage { // init immutable params address collateralAsset; address borrowAsset; address lendingVault; address borrowingVault; address flashLoanVault; address helper; // temp vars CurrentAction tempAction; uint tempBorrowAmount; uint tempCollateralAmount; // configurable params /// @dev Percent of max leverage. 90_00 is 90%. uint targetLeveragePercent; /// @dev Universal configurable param 0 for depositAssets uint depositParam0; /// @dev Universal configurable param 1 for depositAssets uint depositParam1; /// @dev Universal configurable param 0 for withdrawAssets uint withdrawParam0; /// @dev Universal configurable param 1 for withdrawAssets uint withdrawParam1; /// @dev Universal configurable param 0 for increase LTV uint increaseLtvParam0; /// @dev Universal configurable param 1 for increase LTV uint increaseLtvParam1; /// @dev Universal configurable param 0 for decrease LTV uint decreaseLtvParam0; /// @dev Universal configurable param 1 for decrease LTV uint decreaseLtvParam1; /// @dev Swap price impact tolerance on enter/exit uint swapPriceImpactTolerance0; /// @dev Swap price impact tolerance on re-balance debt uint swapPriceImpactTolerance1; } struct LeverageLendingStrategyBaseInitParams { string strategyId; address platform; address vault; address collateralAsset; address borrowAsset; address lendingVault; address borrowingVault; address flashLoanVault; address helper; uint targetLeveragePercent; } struct LeverageLendingAddresses { address collateralAsset; address borrowAsset; address lendingVault; address borrowingVault; } enum CurrentAction { None, Deposit, Withdraw, DecreaseLtv, IncreaseLtv } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* WRITE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice Re-balance debt /// @param newLtv Target LTV after re-balancing with 4 decimals. 90_00 is 90%. /// @return resultLtv LTV after re-balance. For static calls. function rebalanceDebt(uint newLtv) external returns (uint resultLtv); /// @notice Change target leverage percent /// @param value Value with 4 decimals, 90_00 is 90%. function setTargetLeveragePercent(uint value) external; /// @notice Change universal configurable params function setUniversalParams(uint[] memory params) external; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice Difference between collateral and debt /// @return tvl USD amount of user deposited assets /// @return trusted True if only oracle prices was used for calculation. function realTvl() external view returns (uint tvl, bool trusted); /// @notice Vault share price of difference between collateral and debt /// @return sharePrice USD amount of share price of user deposited assets /// @return trusted True if only oracle prices was used for calculation. function realSharePrice() external view returns (uint sharePrice, bool trusted); /// @notice Show leverage main data /// @return ltv Current LTV with 4 decimals. 90_00 is 90%. /// @return maxLtv Maximum LTV with 4 decimals. 90_00 is 90%. /// @return leverage Current leverage multiplier with 4 decimals /// @return collateralAmount Current amount of collateral asset (strategy asset) /// @return debtAmount Current debt of borrowed asset /// @return targetLeveragePercent Configurable percent of max leverage. 90_00 is 90%. function health() external view returns ( uint ltv, uint maxLtv, uint leverage, uint collateralAmount, uint debtAmount, uint targetLeveragePercent ); /// @notice Show APRs /// @return supplyApr APR of supplying with 5 decimals. /// @return borrowApr APR of borrowing with 5 decimals. function getSupplyAndBorrowAprs() external view returns (uint supplyApr, uint borrowApr); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; /// @dev Combining oracle and DeX spot prices /// @author Alien Deployer (https://github.com/a17) /// @author Jude (https://github.com/iammrjude) /// @author JodsMigel (https://github.com/JodsMigel) interface IPriceReader { //region ----- Events ----- event AdapterAdded(address adapter); event AdapterRemoved(address adapter); //endregion -- Events ----- /// @notice Price of asset /// @dev Price of 1.0 amount of asset in USD /// @param asset Address of asset /// @return price USD price with 18 decimals /// @return trusted Price from oracle function getPrice(address asset) external view returns (uint price, bool trusted); /// @notice Get USD price of specified assets and amounts /// @param assets_ Addresses of assets /// @param amounts_ Amount of asset. Index of asset same as in previous parameter. /// @return total Total USD value with 18 decimals /// @return assetAmountPrice USD price of asset amount. Index of assetAmountPrice same as in assets_ parameters. /// @return assetPrice USD price of asset. Index of assetAmountPrice same as in assets_ parameters. /// @return trusted True if only oracle prices was used for calculation. function getAssetsPrice( address[] memory assets_, uint[] memory amounts_ ) external view returns (uint total, uint[] memory assetAmountPrice, uint[] memory assetPrice, bool trusted); /// @notice Add oracle adapter to PriceReader /// Only operator (multisig is operator too) can add adapter /// @param adapter_ Address of price oracle proxy function addAdapter(address adapter_) external; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; /// @notice Interface of the main contract and entry point to the platform. /// @author Alien Deployer (https://github.com/a17) /// @author Jude (https://github.com/iammrjude) /// @author JodsMigel (https://github.com/JodsMigel) interface IPlatform { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ error AlreadyAnnounced(); error SameVersion(); error NoNewVersion(); error UpgradeTimerIsNotOver(uint TimerTimestamp); error IncorrectFee(uint minFee, uint maxFee); error NotEnoughAllowedBBToken(); error TokenAlreadyExistsInSet(address token); error AggregatorNotExists(address dexAggRouter); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ event PlatformVersion(string version); event UpgradeAnnounce( string oldVersion, string newVersion, address[] proxies, address[] newImplementations, uint timelock ); event CancelUpgrade(string oldVersion, string newVersion); event ProxyUpgraded( address indexed proxy, address implementation, string oldContractVersion, string newContractVersion ); event Addresses( address multisig_, address factory_, address priceReader_, address swapper_, address buildingPermitToken_, address vaultManager_, address strategyLogic_, address aprOracle_, address hardWorker, address rebalancer, address zap, address bridge ); event OperatorAdded(address operator); event OperatorRemoved(address operator); event FeesChanged(uint fee, uint feeShareVaultManager, uint feeShareStrategyLogic, uint feeShareEcosystem); event MinInitialBoostChanged(uint minInitialBoostPerDay, uint minInitialBoostDuration); event NewAmmAdapter(string id, address proxy); event EcosystemRevenueReceiver(address receiver); event SetAllowedBBTokenVaults(address bbToken, uint vaultsToBuild, bool firstSet); event RemoveAllowedBBToken(address bbToken); event AddAllowedBoostRewardToken(address token); event RemoveAllowedBoostRewardToken(address token); event AddDefaultBoostRewardToken(address token); event RemoveDefaultBoostRewardToken(address token); event AddBoostTokens(address[] allowedBoostRewardToken, address[] defaultBoostRewardToken); event AllowedBBTokenVaultUsed(address bbToken, uint vaultToUse); event AddDexAggregator(address router); event RemoveDexAggregator(address router); event MinTvlForFreeHardWorkChanged(uint oldValue, uint newValue); event CustomVaultFee(address vault, uint platformFee); event Rebalancer(address rebalancer_); event Bridge(address bridge_); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* DATA TYPES */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ struct PlatformUpgrade { string newVersion; address[] proxies; address[] newImplementations; } struct PlatformSettings { string networkName; bytes32 networkExtra; uint fee; uint feeShareVaultManager; uint feeShareStrategyLogic; uint feeShareEcosystem; uint minInitialBoostPerDay; uint minInitialBoostDuration; } struct AmmAdapter { string id; address proxy; } struct SetupAddresses { address factory; address priceReader; address swapper; address buildingPermitToken; address buildingPayPerVaultToken; address vaultManager; address strategyLogic; address aprOracle; address targetExchangeAsset; address hardWorker; address zap; address bridge; address rebalancer; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice Platform version in CalVer scheme: YY.MM.MINOR-tag. Updates on core contract upgrades. function platformVersion() external view returns (string memory); /// @notice Time delay for proxy upgrades of core contracts and changing important platform settings by multisig //slither-disable-next-line naming-convention function TIME_LOCK() external view returns (uint); /// @notice DAO governance function governance() external view returns (address); /// @notice Core team multi signature wallet. Development and operations fund function multisig() external view returns (address); /// @notice This NFT allow user to build limited number of vaults per week function buildingPermitToken() external view returns (address); /// @notice This ERC20 token is used as payment token for vault building function buildingPayPerVaultToken() external view returns (address); /// @notice Receiver of ecosystem revenue function ecosystemRevenueReceiver() external view returns (address); /// @dev The best asset in a network for swaps between strategy assets and farms rewards assets /// The target exchange asset is used for finding the best strategy's exchange asset. /// Rhe fewer routes needed to swap to the target exchange asset, the better. function targetExchangeAsset() external view returns (address); /// @notice Platform factory assembling vaults. Stores settings, strategy logic, farms. /// Provides the opportunity to upgrade vaults and strategies. /// @return Address of Factory proxy function factory() external view returns (address); /// @notice The holders of these NFT receive a share of the vault revenue /// @return Address of VaultManager proxy function vaultManager() external view returns (address); /// @notice The holders of these tokens receive a share of the revenue received in all vaults using this strategy logic. function strategyLogic() external view returns (address); /// @notice Combining oracle and DeX spot prices /// @return Address of PriceReader proxy function priceReader() external view returns (address); /// @notice Providing underlying assets APRs on-chain /// @return Address of AprOracle proxy function aprOracle() external view returns (address); /// @notice On-chain price quoter and swapper /// @return Address of Swapper proxy function swapper() external view returns (address); /// @notice HardWork resolver and caller /// @return Address of HardWorker proxy function hardWorker() external view returns (address); /// @notice Rebalance resolver /// @return Address of Rebalancer proxy function rebalancer() external view returns (address); /// @notice ZAP feature /// @return Address of Zap proxy function zap() external view returns (address); /// @notice Stability Bridge /// @return Address of Bridge proxy function bridge() external view returns (address); /// @notice Name of current EVM network function networkName() external view returns (string memory); /// @notice Minimal initial boost rewards per day USD amount which needs to create rewarding vault function minInitialBoostPerDay() external view returns (uint); /// @notice Minimal boost rewards vesting duration for initial boost function minInitialBoostDuration() external view returns (uint); /// @notice This function provides the timestamp of the platform upgrade timelock. /// @dev This function is an external view function, meaning it doesn't modify the state. /// @return uint representing the timestamp of the platform upgrade timelock. function platformUpgradeTimelock() external view returns (uint); /// @dev Extra network data /// @return 0-2 bytes - color /// 3-5 bytes - background color /// 6-31 bytes - free function networkExtra() external view returns (bytes32); /// @notice Pending platform upgrade data function pendingPlatformUpgrade() external view returns (PlatformUpgrade memory); /// @notice Get platform revenue fee settings /// @return fee Revenue fee % (between MIN_FEE - MAX_FEE) with DENOMINATOR precision. /// @return feeShareVaultManager Revenue fee share % of VaultManager tokenId owner /// @return feeShareStrategyLogic Revenue fee share % of StrategyLogic tokenId owner /// @return feeShareEcosystem Revenue fee share % of ecosystemFeeReceiver function getFees() external view returns (uint fee, uint feeShareVaultManager, uint feeShareStrategyLogic, uint feeShareEcosystem); /// @notice Get custom vault platform fee /// @return fee revenue fee % with DENOMINATOR precision function getCustomVaultFee(address vault) external view returns (uint fee); /// @notice Platform settings function getPlatformSettings() external view returns (PlatformSettings memory); /// @notice AMM adapters of the platform function getAmmAdapters() external view returns (string[] memory id, address[] memory proxy); /// @notice Get AMM adapter data by hash /// @param ammAdapterIdHash Keccak256 hash of adapter ID string /// @return ID string and proxy address of AMM adapter function ammAdapter(bytes32 ammAdapterIdHash) external view returns (AmmAdapter memory); /// @notice Allowed buy-back tokens for rewarding vaults function allowedBBTokens() external view returns (address[] memory); /// @notice Vaults building limit for buy-back token. /// This limit decrements when a vault for BB-token is built. /// @param token Allowed buy-back token /// @return vaultsLimit Number of vaults that can be built for BB-token function allowedBBTokenVaults(address token) external view returns (uint vaultsLimit); /// @notice Vaults building limits for allowed buy-back tokens. /// @return bbToken Allowed buy-back tokens /// @return vaultsLimit Number of vaults that can be built for BB-tokens function allowedBBTokenVaults() external view returns (address[] memory bbToken, uint[] memory vaultsLimit); /// @notice Non-zero vaults building limits for allowed buy-back tokens. /// @return bbToken Allowed buy-back tokens /// @return vaultsLimit Number of vaults that can be built for BB-tokens function allowedBBTokenVaultsFiltered() external view returns (address[] memory bbToken, uint[] memory vaultsLimit); /// @notice Check address for existance in operators list /// @param operator Address /// @return True if this address is Stability Operator function isOperator(address operator) external view returns (bool); /// @notice Tokens that can be used for boost rewards of rewarding vaults /// @return Addresses of tokens function allowedBoostRewardTokens() external view returns (address[] memory); /// @notice Allowed boost reward tokens that used for unmanaged rewarding vaults creation /// @return Addresses of tokens function defaultBoostRewardTokens() external view returns (address[] memory); /// @notice Allowed boost reward tokens that used for unmanaged rewarding vaults creation /// @param addressToRemove This address will be removed from default boost reward tokens /// @return Addresses of tokens function defaultBoostRewardTokensFiltered(address addressToRemove) external view returns (address[] memory); /// @notice Allowed DeX aggregators /// @return Addresses of DeX aggregator rounters function dexAggregators() external view returns (address[] memory); /// @notice DeX aggregator router address is allowed to be used in the platform /// @param dexAggRouter Address of DeX aggreagator router /// @return Can be used function isAllowedDexAggregatorRouter(address dexAggRouter) external view returns (bool); /// @notice Show minimum TVL for compensate if vault has not enough ETH /// @return Minimum TVL for compensate. function minTvlForFreeHardWork() external view returns (uint); /// @notice Front-end platform viewer /// @return platformAddresses Platform core addresses /// platformAddresses[0] factory /// platformAddresses[1] vaultManager /// platformAddresses[2] strategyLogic /// platformAddresses[3] buildingPermitToken /// platformAddresses[4] buildingPayPerVaultToken /// platformAddresses[5] governance /// platformAddresses[6] multisig /// platformAddresses[7] zap /// platformAddresses[8] bridge /// @return bcAssets Blue chip token addresses /// @return dexAggregators_ DeX aggregators allowed to be used entire the platform /// @return vaultType Vault type ID strings /// @return vaultExtra Vault color, background color and other extra data. Index of vault same as in previous array. /// @return vaultBulldingPrice Price of creating new vault in buildingPayPerVaultToken. Index of vault same as in previous array. /// @return strategyId Strategy logic ID strings /// @return isFarmingStrategy True if strategy is farming strategy. Index of strategy same as in previous array. /// @return strategyTokenURI StrategyLogic NFT tokenId metadata and on-chain image. Index of strategy same as in previous array. /// @return strategyExtra Strategy color, background color and other extra data. Index of strategy same as in previous array. function getData() external view returns ( address[] memory platformAddresses, address[] memory bcAssets, address[] memory dexAggregators_, string[] memory vaultType, bytes32[] memory vaultExtra, uint[] memory vaultBulldingPrice, string[] memory strategyId, bool[] memory isFarmingStrategy, string[] memory strategyTokenURI, bytes32[] memory strategyExtra ); /// @notice Front-end balances, prices and vault list viewer /// DEPRECATED: use IFrontend.getBalanceAssets and IFrontend.getBalanceVaults /// @param yourAccount Address of account to query balances /// @return token Tokens supported by the platform /// @return tokenPrice USD price of token. Index of token same as in previous array. /// @return tokenUserBalance User balance of token. Index of token same as in previous array. /// @return vault Deployed vaults /// @return vaultSharePrice Price 1.0 vault share. Index of vault same as in previous array. /// @return vaultUserBalance User balance of vault. Index of vault same as in previous array. /// @return nft Ecosystem NFTs /// nft[0] BuildingPermitToken /// nft[1] VaultManager /// nft[2] StrategyLogic /// @return nftUserBalance User balance of NFT. Index of NFT same as in previous array. /// @return buildingPayPerVaultTokenBalance User balance of vault creation paying token function getBalance(address yourAccount) external view returns ( address[] memory token, uint[] memory tokenPrice, uint[] memory tokenUserBalance, address[] memory vault, uint[] memory vaultSharePrice, uint[] memory vaultUserBalance, address[] memory nft, uint[] memory nftUserBalance, uint buildingPayPerVaultTokenBalance ); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* WRITE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice Add platform operator. /// Only governance and multisig can add operator. /// @param operator Address of new operator function addOperator(address operator) external; /// @notice Remove platform operator. /// Only governance and multisig can remove operator. /// @param operator Address of operator to remove function removeOperator(address operator) external; /// @notice Announce upgrade of platform proxies implementations /// Only governance and multisig can announce platform upgrades. /// @param newVersion New platform version. Version must be changed when upgrading. /// @param proxies Addresses of core contract proxies /// @param newImplementations New implementation for proxy. Index of proxy same as in previous array. function announcePlatformUpgrade( string memory newVersion, address[] memory proxies, address[] memory newImplementations ) external; /// @notice Upgrade platform /// Only operator (multisig is operator too) can ececute pending platform upgrade function upgrade() external; /// @notice Cancel pending platform upgrade /// Only operator (multisig is operator too) can ececute pending platform upgrade function cancelUpgrade() external; /// @notice Register AMM adapter in platform /// @param id AMM adapter ID string from AmmAdapterIdLib /// @param proxy Address of AMM adapter proxy function addAmmAdapter(string memory id, address proxy) external; // todo Only governance and multisig can set allowed bb-token vaults building limit /// @notice Set new vaults building limit for buy-back token /// @param bbToken Address of allowed buy-back token /// @param vaultsToBuild Number of vaults that can be built for BB-token function setAllowedBBTokenVaults(address bbToken, uint vaultsToBuild) external; // todo Only governance and multisig can add allowed boost reward token /// @notice Add new allowed boost reward token /// @param token Address of token function addAllowedBoostRewardToken(address token) external; // todo Only governance and multisig can remove allowed boost reward token /// @notice Remove allowed boost reward token /// @param token Address of allowed boost reward token function removeAllowedBoostRewardToken(address token) external; // todo Only governance and multisig can add default boost reward token /// @notice Add default boost reward token /// @param token Address of default boost reward token function addDefaultBoostRewardToken(address token) external; // todo Only governance and multisig can remove default boost reward token /// @notice Remove default boost reward token /// @param token Address of allowed boost reward token function removeDefaultBoostRewardToken(address token) external; // todo Only governance and multisig can add allowed boost reward token // todo Only governance and multisig can add default boost reward token /// @notice Add new allowed boost reward token /// @notice Add default boost reward token /// @param allowedBoostRewardToken Address of allowed boost reward token /// @param defaultBoostRewardToken Address of default boost reward token function addBoostTokens( address[] memory allowedBoostRewardToken, address[] memory defaultBoostRewardToken ) external; /// @notice Decrease allowed BB-token vault building limit when vault is built /// Only Factory can do it. /// @param bbToken Address of allowed buy-back token function useAllowedBBTokenVault(address bbToken) external; /// @notice Allow DeX aggregator routers to be used in the platform /// @param dexAggRouter Addresses of DeX aggreagator routers function addDexAggregators(address[] memory dexAggRouter) external; /// @notice Remove allowed DeX aggregator router from the platform /// @param dexAggRouter Address of DeX aggreagator router function removeDexAggregator(address dexAggRouter) external; /// @notice Change initial boost rewards settings /// @param minInitialBoostPerDay_ Minimal initial boost rewards per day USD amount which needs to create rewarding vault /// @param minInitialBoostDuration_ Minimal boost rewards vesting duration for initial boost function setInitialBoost(uint minInitialBoostPerDay_, uint minInitialBoostDuration_) external; /// @notice Update new minimum TVL for compensate. /// @param value New minimum TVL for compensate. function setMinTvlForFreeHardWork(uint value) external; /// @notice Set custom platform fee for vault /// @param vault Vault address /// @param platformFee Custom platform fee function setCustomVaultFee(address vault, uint platformFee) external; /// @notice Setup Rebalancer. /// Only Goverannce or Multisig can do this when Rebalancer is not set. /// @param rebalancer_ Proxy address of Bridge function setupRebalancer(address rebalancer_) external; /// @notice Setup Bridge. /// Only Goverannce or Multisig can do this when Bridge is not set. /// @param bridge_ Proxy address of Bridge function setupBridge(address bridge_) external; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; /// @dev Base core interface implemented by most platform contracts. /// Inherited contracts store an immutable Platform proxy address in the storage, /// which provides authorization capabilities and infrastructure contract addresses. /// @author Alien Deployer (https://github.com/a17) /// @author JodsMigel (https://github.com/JodsMigel) interface IControllable { //region ----- Custom Errors ----- error IncorrectZeroArgument(); error IncorrectMsgSender(); error NotGovernance(); error NotMultisig(); error NotGovernanceAndNotMultisig(); error NotOperator(); error NotFactory(); error NotPlatform(); error NotVault(); error IncorrectArrayLength(); error AlreadyExist(); error NotExist(); error NotTheOwner(); error ETHTransferFailed(); error IncorrectInitParams(); //endregion -- Custom Errors ----- event ContractInitialized(address platform, uint ts, uint block); /// @notice Stability Platform main contract address function platform() external view returns (address); /// @notice Version of contract implementation /// @dev SemVer scheme MAJOR.MINOR.PATCH //slither-disable-next-line naming-convention function VERSION() external view returns (string memory); /// @notice Block number when contract was initialized function createdBlock() external view returns (uint); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Permit.sol) pragma solidity ^0.8.20; /** * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612]. * * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't * need to send a transaction, and thus is not required to hold Ether at all. * * ==== Security Considerations * * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be * considered as an intention to spend the allowance in any specific way. The second is that because permits have * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be * generally recommended is: * * ```solidity * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public { * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {} * doThing(..., value); * } * * function doThing(..., uint256 value) public { * token.safeTransferFrom(msg.sender, address(this), value); * ... * } * ``` * * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also * {SafeERC20-safeTransferFrom}). * * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so * contracts should have entry points that don't rely on permit. */ interface IERC20Permit { /** * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens, * given ``owner``'s signed approval. * * IMPORTANT: The same issues {IERC20-approve} has related to transaction * ordering also apply here. * * Emits an {Approval} event. * * Requirements: * * - `spender` cannot be the zero address. * - `deadline` must be a timestamp in the future. * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner` * over the EIP712-formatted function arguments. * - the signature must use ``owner``'s current nonce (see {nonces}). * * For more information on the signature format, see the * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP * section]. * * CAUTION: See Security Considerations above. */ function permit( address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) external; /** * @dev Returns the current nonce for `owner`. This value must be * included whenever a signature is generated for {permit}. * * Every successful call to {permit} increases ``owner``'s nonce by one. This * prevents a signature from being used multiple times. */ function nonces(address owner) external view returns (uint256); /** * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}. */ // solhint-disable-next-line func-name-mixedcase function DOMAIN_SEPARATOR() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol) pragma solidity ^0.8.20; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev The ETH balance of the account is not enough to perform the operation. */ error AddressInsufficientBalance(address account); /** * @dev There's no code at `target` (it is not a contract). */ error AddressEmptyCode(address target); /** * @dev A call to an address target failed. The target may have reverted. */ error FailedInnerCall(); /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { if (address(this).balance < amount) { revert AddressInsufficientBalance(address(this)); } (bool success, ) = recipient.call{value: amount}(""); if (!success) { revert FailedInnerCall(); } } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason or custom error, it is bubbled * up by this function (like regular Solidity function calls). However, if * the call reverted with no returned reason, this function reverts with a * {FailedInnerCall} error. * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { if (address(this).balance < value) { revert AddressInsufficientBalance(address(this)); } (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an * unsuccessful call. */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata ) internal view returns (bytes memory) { if (!success) { _revert(returndata); } else { // only check if target is a contract if the call was successful and the return data is empty // otherwise we already know that it was a contract if (returndata.length == 0 && target.code.length == 0) { revert AddressEmptyCode(target); } return returndata; } } /** * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the * revert reason or with a default {FailedInnerCall} error. */ function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) { if (!success) { _revert(returndata); } else { return returndata; } } /** * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}. */ function _revert(bytes memory returndata) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert FailedInnerCall(); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/ERC20.sol) pragma solidity ^0.8.20; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import {ContextUpgradeable} from "../../utils/ContextUpgradeable.sol"; import {IERC20Errors} from "@openzeppelin/contracts/interfaces/draft-IERC6093.sol"; import {Initializable} from "../../proxy/utils/Initializable.sol"; /** * @dev Implementation of the {IERC20} interface. * * This implementation is agnostic to the way tokens are created. This means * that a supply mechanism has to be added in a derived contract using {_mint}. * * TIP: For a detailed writeup see our guide * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How * to implement supply mechanisms]. * * The default value of {decimals} is 18. To change this, you should override * this function so it returns a different value. * * We have followed general OpenZeppelin Contracts guidelines: functions revert * instead returning `false` on failure. This behavior is nonetheless * conventional and does not conflict with the expectations of ERC20 * applications. * * Additionally, an {Approval} event is emitted on calls to {transferFrom}. * This allows applications to reconstruct the allowance for all accounts just * by listening to said events. Other implementations of the EIP may not emit * these events, as it isn't required by the specification. */ abstract contract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20, IERC20Metadata, IERC20Errors { /// @custom:storage-location erc7201:openzeppelin.storage.ERC20 struct ERC20Storage { mapping(address account => uint256) _balances; mapping(address account => mapping(address spender => uint256)) _allowances; uint256 _totalSupply; string _name; string _symbol; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ERC20")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant ERC20StorageLocation = 0x52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace00; function _getERC20Storage() private pure returns (ERC20Storage storage $) { assembly { $.slot := ERC20StorageLocation } } /** * @dev Sets the values for {name} and {symbol}. * * All two of these values are immutable: they can only be set once during * construction. */ function __ERC20_init(string memory name_, string memory symbol_) internal onlyInitializing { __ERC20_init_unchained(name_, symbol_); } function __ERC20_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing { ERC20Storage storage $ = _getERC20Storage(); $._name = name_; $._symbol = symbol_; } /** * @dev Returns the name of the token. */ function name() public view virtual returns (string memory) { ERC20Storage storage $ = _getERC20Storage(); return $._name; } /** * @dev Returns the symbol of the token, usually a shorter version of the * name. */ function symbol() public view virtual returns (string memory) { ERC20Storage storage $ = _getERC20Storage(); return $._symbol; } /** * @dev Returns the number of decimals used to get its user representation. * For example, if `decimals` equals `2`, a balance of `505` tokens should * be displayed to a user as `5.05` (`505 / 10 ** 2`). * * Tokens usually opt for a value of 18, imitating the relationship between * Ether and Wei. This is the default value returned by this function, unless * it's overridden. * * NOTE: This information is only used for _display_ purposes: it in * no way affects any of the arithmetic of the contract, including * {IERC20-balanceOf} and {IERC20-transfer}. */ function decimals() public view virtual returns (uint8) { return 18; } /** * @dev See {IERC20-totalSupply}. */ function totalSupply() public view virtual returns (uint256) { ERC20Storage storage $ = _getERC20Storage(); return $._totalSupply; } /** * @dev See {IERC20-balanceOf}. */ function balanceOf(address account) public view virtual returns (uint256) { ERC20Storage storage $ = _getERC20Storage(); return $._balances[account]; } /** * @dev See {IERC20-transfer}. * * Requirements: * * - `to` cannot be the zero address. * - the caller must have a balance of at least `value`. */ function transfer(address to, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _transfer(owner, to, value); return true; } /** * @dev See {IERC20-allowance}. */ function allowance(address owner, address spender) public view virtual returns (uint256) { ERC20Storage storage $ = _getERC20Storage(); return $._allowances[owner][spender]; } /** * @dev See {IERC20-approve}. * * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on * `transferFrom`. This is semantically equivalent to an infinite approval. * * Requirements: * * - `spender` cannot be the zero address. */ function approve(address spender, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _approve(owner, spender, value); return true; } /** * @dev See {IERC20-transferFrom}. * * Emits an {Approval} event indicating the updated allowance. This is not * required by the EIP. See the note at the beginning of {ERC20}. * * NOTE: Does not update the allowance if the current allowance * is the maximum `uint256`. * * Requirements: * * - `from` and `to` cannot be the zero address. * - `from` must have a balance of at least `value`. * - the caller must have allowance for ``from``'s tokens of at least * `value`. */ function transferFrom(address from, address to, uint256 value) public virtual returns (bool) { address spender = _msgSender(); _spendAllowance(from, spender, value); _transfer(from, to, value); return true; } /** * @dev Moves a `value` amount of tokens from `from` to `to`. * * This internal function is equivalent to {transfer}, and can be used to * e.g. implement automatic token fees, slashing mechanisms, etc. * * Emits a {Transfer} event. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _transfer(address from, address to, uint256 value) internal { if (from == address(0)) { revert ERC20InvalidSender(address(0)); } if (to == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(from, to, value); } /** * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from` * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding * this function. * * Emits a {Transfer} event. */ function _update(address from, address to, uint256 value) internal virtual { ERC20Storage storage $ = _getERC20Storage(); if (from == address(0)) { // Overflow check required: The rest of the code assumes that totalSupply never overflows $._totalSupply += value; } else { uint256 fromBalance = $._balances[from]; if (fromBalance < value) { revert ERC20InsufficientBalance(from, fromBalance, value); } unchecked { // Overflow not possible: value <= fromBalance <= totalSupply. $._balances[from] = fromBalance - value; } } if (to == address(0)) { unchecked { // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply. $._totalSupply -= value; } } else { unchecked { // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256. $._balances[to] += value; } } emit Transfer(from, to, value); } /** * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0). * Relies on the `_update` mechanism * * Emits a {Transfer} event with `from` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _mint(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(address(0), account, value); } /** * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply. * Relies on the `_update` mechanism. * * Emits a {Transfer} event with `to` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead */ function _burn(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidSender(address(0)); } _update(account, address(0), value); } /** * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens. * * This internal function is equivalent to `approve`, and can be used to * e.g. set automatic allowances for certain subsystems, etc. * * Emits an {Approval} event. * * Requirements: * * - `owner` cannot be the zero address. * - `spender` cannot be the zero address. * * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument. */ function _approve(address owner, address spender, uint256 value) internal { _approve(owner, spender, value, true); } /** * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event. * * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any * `Approval` event during `transferFrom` operations. * * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to * true using the following override: * ``` * function _approve(address owner, address spender, uint256 value, bool) internal virtual override { * super._approve(owner, spender, value, true); * } * ``` * * Requirements are the same as {_approve}. */ function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual { ERC20Storage storage $ = _getERC20Storage(); if (owner == address(0)) { revert ERC20InvalidApprover(address(0)); } if (spender == address(0)) { revert ERC20InvalidSpender(address(0)); } $._allowances[owner][spender] = value; if (emitEvent) { emit Approval(owner, spender, value); } } /** * @dev Updates `owner` s allowance for `spender` based on spent `value`. * * Does not update the allowance value in case of infinite allowance. * Revert if not enough allowance is available. * * Does not emit an {Approval} event. */ function _spendAllowance(address owner, address spender, uint256 value) internal virtual { uint256 currentAllowance = allowance(owner, spender); if (currentAllowance != type(uint256).max) { if (currentAllowance < value) { revert ERC20InsufficientAllowance(spender, currentAllowance, value); } unchecked { _approve(owner, spender, currentAllowance - value, false); } } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; library ConstantsLib { uint internal constant DENOMINATOR = 100_000; address internal constant DEAD_ADDRESS = 0xdEad000000000000000000000000000000000000; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; library VaultTypeLib { string internal constant COMPOUNDING = "Compounding"; string internal constant REWARDING = "Rewarding"; string internal constant REWARDING_MANAGED = "Rewarding Managed"; string internal constant SPLITTER_MANAGED = "Splitter Managed"; string internal constant SPLITTER_AUTO = "Splitter Automatic"; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import "@openzeppelin/contracts/utils/Strings.sol"; import "./ConstantsLib.sol"; library CommonLib { function filterAddresses( address[] memory addresses, address addressToRemove ) external pure returns (address[] memory filteredAddresses) { uint len = addresses.length; uint newLen; // nosemgrep for (uint i; i < len; ++i) { if (addresses[i] != addressToRemove) { ++newLen; } } filteredAddresses = new address[](newLen); uint k; // nosemgrep for (uint i; i < len; ++i) { if (addresses[i] != addressToRemove) { filteredAddresses[k] = addresses[i]; ++k; } } } function formatUsdAmount(uint amount) external pure returns (string memory formattedPrice) { uint dollars = amount / 10 ** 18; string memory priceStr; if (dollars >= 1000) { uint kDollars = dollars / 1000; uint kDollarsFraction = (dollars - kDollars * 1000) / 10; string memory delimiter = "."; if (kDollarsFraction < 10) { delimiter = ".0"; } priceStr = string.concat(Strings.toString(kDollars), delimiter, Strings.toString(kDollarsFraction), "k"); } else if (dollars >= 100) { priceStr = Strings.toString(dollars); } else { uint dollarsFraction = (amount - dollars * 10 ** 18) / 10 ** 14; if (dollarsFraction > 0) { string memory dollarsFractionDelimiter = "."; if (dollarsFraction < 10) { dollarsFractionDelimiter = ".000"; } else if (dollarsFraction < 100) { dollarsFractionDelimiter = ".00"; } else if (dollarsFraction < 1000) { dollarsFractionDelimiter = ".0"; } priceStr = string.concat( Strings.toString(dollars), dollarsFractionDelimiter, Strings.toString(dollarsFraction) ); } else { priceStr = Strings.toString(dollars); } } formattedPrice = string.concat("$", priceStr); } function formatApr(uint apr) external pure returns (string memory formattedApr) { uint aprInt = apr * 100 / ConstantsLib.DENOMINATOR; uint aprFraction = (apr - aprInt * ConstantsLib.DENOMINATOR / 100) / 10; string memory delimiter = "."; if (aprFraction < 10) { delimiter = ".0"; } formattedApr = string.concat(Strings.toString(aprInt), delimiter, Strings.toString(aprFraction), "%"); } function formatAprInt(int apr) external pure returns (string memory formattedApr) { int aprInt = apr * 100 / int(ConstantsLib.DENOMINATOR); int aprFraction = (apr - aprInt * int(ConstantsLib.DENOMINATOR) / 100) / 10; string memory delimiter = "."; if (aprFraction < 10 || aprFraction > -10) { delimiter = ".0"; } formattedApr = string.concat(i2s2(aprInt), delimiter, i2s(aprFraction), "%"); } function implodeSymbols( address[] memory assets, string memory delimiter ) external view returns (string memory outString) { return implode(getSymbols(assets), delimiter); } function implode(string[] memory strings, string memory delimiter) public pure returns (string memory outString) { uint len = strings.length; if (len == 0) { return ""; } outString = strings[0]; // nosemgrep for (uint i = 1; i < len; ++i) { outString = string.concat(outString, delimiter, strings[i]); } return outString; } function getSymbols(address[] memory assets) public view returns (string[] memory symbols) { uint len = assets.length; symbols = new string[](len); // nosemgrep for (uint i; i < len; ++i) { symbols[i] = IERC20Metadata(assets[i]).symbol(); } } function bytesToBytes32(bytes memory b) external pure returns (bytes32 out) { // nosemgrep for (uint i; i < b.length; ++i) { out |= bytes32(b[i] & 0xFF) >> (i * 8); } // return out; } function bToHex(bytes memory buffer) external pure returns (string memory) { // Fixed buffer size for hexadecimal convertion bytes memory converted = new bytes(buffer.length * 2); bytes memory _base = "0123456789abcdef"; uint baseLength = _base.length; // nosemgrep for (uint i; i < buffer.length; ++i) { converted[i * 2] = _base[uint8(buffer[i]) / baseLength]; converted[i * 2 + 1] = _base[uint8(buffer[i]) % baseLength]; } return string(abi.encodePacked(converted)); } function shortId(string memory id) external pure returns (string memory) { uint words = 1; bytes memory idBytes = bytes(id); uint idBytesLength = idBytes.length; // nosemgrep for (uint i; i < idBytesLength; ++i) { if (keccak256(bytes(abi.encodePacked(idBytes[i]))) == keccak256(bytes(" "))) { ++words; } } bytes memory _shortId = new bytes(words); uint k = 1; _shortId[0] = idBytes[0]; // nosemgrep for (uint i = 1; i < idBytesLength; ++i) { if (keccak256(bytes(abi.encodePacked(idBytes[i]))) == keccak256(bytes(" "))) { if (keccak256(bytes(abi.encodePacked(idBytes[i + 1]))) == keccak256(bytes("0"))) { _shortId[k] = idBytes[i + 3]; } else { _shortId[k] = idBytes[i + 1]; } ++k; } } return string(abi.encodePacked(_shortId)); } function eq(string memory a, string memory b) external pure returns (bool) { return keccak256(bytes(a)) == keccak256(bytes(b)); } function u2s(uint num) external pure returns (string memory) { return Strings.toString(num); } function i2s(int num) public pure returns (string memory) { return Strings.toString(num > 0 ? uint(num) : uint(-num)); } function i2s2(int num) public pure returns (string memory) { if (num >= 0) { return Strings.toString(uint(num)); } return string.concat("-", Strings.toString(uint(-num))); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "./IStrategy.sol"; /// @notice Vault core interface. /// Derived implementations can be effective for building tokenized vaults with single or multiple underlying liquidity mining position. /// Fungible, static non-fungible and actively re-balancing liquidity is supported, as well as single token liquidity provided to lending protocols. /// Vaults can be used for active concentrated liquidity management and market making. /// @author Jude (https://github.com/iammrjude) /// @author JodsMigel (https://github.com/JodsMigel) interface IVault is IERC165 { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ error NotEnoughBalanceToPay(); error FuseTrigger(); error ExceedSlippage(uint mintToUser, uint minToMint); error ExceedSlippageExactAsset(address asset, uint mintToUser, uint minToMint); error ExceedMaxSupply(uint maxSupply); error NotEnoughAmountToInitSupply(uint mintAmount, uint initialShares); error WaitAFewBlocks(); error StrategyZeroDeposit(); error NotSupported(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ event DepositAssets(address indexed account, address[] assets, uint[] amounts, uint mintAmount); event WithdrawAssets( address indexed sender, address indexed owner, address[] assets, uint sharesAmount, uint[] amountsOut ); event HardWorkGas(uint gasUsed, uint gasCost, bool compensated); event DoHardWorkOnDepositChanged(bool oldValue, bool newValue); event MaxSupply(uint maxShares); event VaultName(string newName); event VaultSymbol(string newSymbol); event MintFees( uint vaultManagerReceiverFee, uint strategyLogicReceiverFee, uint ecosystemRevenueReceiverFee, uint multisigReceiverFee ); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* DATA TYPES */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @custom:storage-location erc7201:stability.VaultBase struct VaultBaseStorage { /// @dev Prevents manipulations with deposit and withdraw in short time. /// For simplification we are setup new withdraw request on each deposit/transfer. mapping(address msgSender => uint blockNumber) withdrawRequests; /// @inheritdoc IVault IStrategy strategy; /// @inheritdoc IVault uint maxSupply; /// @inheritdoc IVault uint tokenId; /// @inheritdoc IVault bool doHardWorkOnDeposit; /// @dev Immutable vault type ID string _type; /// @dev Changed ERC20 name string changedName; /// @dev Changed ERC20 symbol string changedSymbol; } /// @title Vault Initialization Data /// @notice Data structure containing parameters for initializing a new vault. /// @dev This struct is commonly used as a parameter for the `initialize` function in vault contracts. /// @param platform Platform address providing access control, infrastructure addresses, fee settings, and upgrade capability. /// @param strategy Immutable strategy proxy used by the vault. /// @param name ERC20 name for the vault token. /// @param symbol ERC20 symbol for the vault token. /// @param tokenId NFT ID associated with the VaultManager. /// @param vaultInitAddresses Array of addresses used during vault initialization. /// @param vaultInitNums Array of uint values corresponding to initialization parameters. struct VaultInitializationData { address platform; address strategy; string name; string symbol; uint tokenId; address[] vaultInitAddresses; uint[] vaultInitNums; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice Immutable vault type ID function vaultType() external view returns (string memory); /// @return uniqueInitAddresses Return required unique init addresses /// @return uniqueInitNums Return required unique init nums function getUniqueInitParamLength() external view returns (uint uniqueInitAddresses, uint uniqueInitNums); /// @notice Vault type extra data /// @return Vault type color, background color and other extra data function extra() external view returns (bytes32); /// @notice Immutable strategy proxy used by the vault /// @return Linked strategy function strategy() external view returns (IStrategy); /// @notice Max supply of shares in the vault. /// Since the starting share price is $1, this ceiling can be considered as an approximate TVL limit. /// @return Max total supply of vault function maxSupply() external view returns (uint); /// @dev VaultManager token ID. This tokenId earn feeVaultManager provided by Platform. function tokenId() external view returns (uint); /// @dev Trigger doHardwork on invest action. Enabled by default. function doHardWorkOnDeposit() external view returns (bool); /// @dev USD price of share with 18 decimals. /// ONLY FOR OFF-CHAIN USE. /// Not trusted vault share price can be manipulated. /// @return price_ Price of 1e18 shares with 18 decimals precision /// @return trusted True means oracle price, false means AMM spot price function price() external view returns (uint price_, bool trusted); /// @dev USD price of assets managed by strategy with 18 decimals /// ONLY FOR OFF-CHAIN USE. /// Not trusted TVL can be manipulated. /// @return tvl_ Total USD value of final assets in vault /// @return trusted True means TVL calculated based only on oracle prices, false means AMM spot price was used. function tvl() external view returns (uint tvl_, bool trusted); /// @dev Calculation of consumed amounts, shares amount and liquidity/underlying value for provided available amounts of strategy assets /// @param assets_ Assets suitable for vault strategy. Can be strategy assets, underlying asset or specific set of assets depending on strategy logic. /// @param amountsMax Available amounts of assets_ that user wants to invest in vault /// @return amountsConsumed Amounts of strategy assets that can be deposited by providing amountsMax /// @return sharesOut Amount of vault shares that will be minted /// @return valueOut Liquidity value or underlying token amount that will be received by the strategy function previewDepositAssets( address[] memory assets_, uint[] memory amountsMax ) external view returns (uint[] memory amountsConsumed, uint sharesOut, uint valueOut); /// @notice All available data on the latest declared APR (annual percentage rate) /// @return totalApr Total APR of investing money to vault. 18 decimals: 1e18 - +100% per year. /// @return strategyApr Strategy investmnt APR declared on last HardWork. /// @return assetsWithApr Assets with underlying APR /// @return assetsAprs Underlying APR of asset function getApr() external view returns (uint totalApr, uint strategyApr, address[] memory assetsWithApr, uint[] memory assetsAprs); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* WRITE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice Write version of previewDepositAssets /// @param assets_ Assets suitable for vault strategy. Can be strategy assets, underlying asset or specific set of assets depending on strategy logic. /// @param amountsMax Available amounts of assets_ that user wants to invest in vault /// @return amountsConsumed Amounts of strategy assets that can be deposited by providing amountsMax /// @return sharesOut Amount of vault shares that will be minted /// @return valueOut Liquidity value or underlying token amount that will be received by the strategy function previewDepositAssetsWrite( address[] memory assets_, uint[] memory amountsMax ) external returns (uint[] memory amountsConsumed, uint sharesOut, uint valueOut); /// @dev Mint fee shares callback /// @param revenueAssets Assets returned by _claimRevenue function that was earned during HardWork /// @param revenueAmounts Assets amounts returned from _claimRevenue function that was earned during HardWork /// Only strategy can call this function hardWorkMintFeeCallback(address[] memory revenueAssets, uint[] memory revenueAmounts) external; /// @dev Deposit final assets (pool assets) to the strategy and minting of vault shares. /// If the strategy interacts with a pool or farms through an underlying token, then it will be minted. /// Emits a {DepositAssets} event with consumed amounts. /// @param assets_ Assets suitable for the strategy. Can be strategy assets, underlying asset or specific set of assets depending on strategy logic. /// @param amountsMax Available amounts of assets_ that user wants to invest in vault /// @param minSharesOut Slippage tolerance. Minimal shares amount which must be received by user. /// @param receiver Receiver of deposit. If receiver is zero address, receiver is msg.sender. function depositAssets( address[] memory assets_, uint[] memory amountsMax, uint minSharesOut, address receiver ) external; /// @dev Burning shares of vault and obtaining strategy assets. /// @param assets_ Assets suitable for the strategy. Can be strategy assets, underlying asset or specific set of assets depending on strategy logic. /// @param amountShares Shares amount for burning /// @param minAssetAmountsOut Slippage tolerance. Minimal amounts of strategy assets that user must receive. /// @return Amount of assets for withdraw. It's related to assets_ one-by-one. function withdrawAssets( address[] memory assets_, uint amountShares, uint[] memory minAssetAmountsOut ) external returns (uint[] memory); /// @dev Burning shares of vault and obtaining strategy assets. /// @param assets_ Assets suitable for the strategy. Can be strategy assets, underlying asset or specific set of assets depending on strategy logic. /// @param amountShares Shares amount for burning /// @param minAssetAmountsOut Slippage tolerance. Minimal amounts of strategy assets that user must receive. /// @param receiver Receiver of assets /// @param owner Owner of vault shares /// @return Amount of assets for withdraw. It's related to assets_ one-by-one. function withdrawAssets( address[] memory assets_, uint amountShares, uint[] memory minAssetAmountsOut, address receiver, address owner ) external returns (uint[] memory); /// @dev Setting of vault capacity /// @param maxShares If totalSupply() exceeds this value, deposits will not be possible function setMaxSupply(uint maxShares) external; /// @dev If activated will call doHardWork on strategy on some deposit actions /// @param value HardWork on deposit is enabled function setDoHardWorkOnDeposit(bool value) external; /// @notice Initialization function for the vault. /// @dev This function is usually called by the Factory during the creation of a new vault. /// @param vaultInitializationData Data structure containing parameters for vault initialization. function initialize(VaultInitializationData memory vaultInitializationData) external; /// @dev Calling the strategy HardWork by operator with optional compensation for spent gas from the vault balance function doHardWork() external; /// @dev Changing ERC20 name of vault function setName(string calldata newName) external; /// @dev Changing ERC20 symbol of vault function setSymbol(string calldata newSymbol) external; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "@openzeppelin/contracts/token/ERC721/extensions/IERC721Metadata.sol"; /// @notice The vaults are assembled at the factory by users through UI. /// Deployment rights of a vault are tokenized in VaultManager NFT. /// The holders of these tokens receive a share of the vault revenue and can manage vault if possible. /// @dev Rewards transfers to token owner or revenue receiver address managed by token owner. /// @author Alien Deployer (https://github.com/a17) /// @author Jude (https://github.com/iammrjude) /// @author JodsMigel (https://github.com/JodsMigel) interface IVaultManager is IERC721Metadata { //region ----- Events ----- event ChangeVaultParams(uint tokenId, address[] addresses, uint[] nums); event SetRevenueReceiver(uint tokenId, address receiver); //endregion -- Events ----- struct VaultData { // vault uint tokenId; address vault; string vaultType; string name; string symbol; string[] assetsSymbols; string[] rewardAssetsSymbols; uint sharePrice; uint tvl; uint totalApr; bytes32 vaultExtra; // strategy uint strategyTokenId; string strategyId; string strategySpecific; uint strategyApr; bytes32 strategyExtra; } //region ----- View functions ----- /// @notice Vault address managed by token /// @param tokenId ID of NFT. Starts from 0 and increments on mints. /// @return vault Address of vault proxy function tokenVault(uint tokenId) external view returns (address vault); /// @notice Receiver of token owner's platform revenue share /// @param tokenId ID of NFT /// @return receiver Address of vault manager fees receiver function getRevenueReceiver(uint tokenId) external view returns (address receiver); /// @notice All vaults data. /// DEPRECATED: use IFrontend.vaults /// The output values are matched by index in the arrays. /// @param vaultAddress Vault addresses /// @param name Vault name /// @param symbol Vault symbol /// @param vaultType Vault type ID string /// @param strategyId Strategy logic ID string /// @param sharePrice Current vault share price in USD. 18 decimals /// @param tvl Current vault TVL in USD. 18 decimals /// @param totalApr Last total vault APR. Denominator is 100_00. /// @param strategyApr Last strategy APR. Denominator is 100_00. /// @param strategySpecific Strategy specific name function vaults() external view returns ( address[] memory vaultAddress, string[] memory name, string[] memory symbol, string[] memory vaultType, string[] memory strategyId, uint[] memory sharePrice, uint[] memory tvl, uint[] memory totalApr, uint[] memory strategyApr, string[] memory strategySpecific ); /// @notice All deployed vault addresses /// @return vaultAddress Addresses of vault proxy function vaultAddresses() external view returns (address[] memory vaultAddress); /// @notice Vault extended info getter /// @param vault Address of vault proxy /// @return strategy /// @return strategyAssets /// @return underlying /// @return assetsWithApr Assets with underlying APRs that can be provided by AprOracle /// @return assetsAprs APRs of assets with APR. Matched by index wuth previous param. /// @return lastHardWork Last HardWork time function vaultInfo(address vault) external view returns ( address strategy, address[] memory strategyAssets, address underlying, address[] memory assetsWithApr, uint[] memory assetsAprs, uint lastHardWork ); //endregion -- View functions ----- //region ----- Write functions ----- /// @notice Changing managed vault init parameters by Vault Manager (owner of VaultManager NFT) /// @param tokenId ID of VaultManager NFT /// @param addresses Vault init addresses. Must contain also not changeable init addresses /// @param nums Vault init numbers. Must contant also not changeable init numbers function changeVaultParams(uint tokenId, address[] memory addresses, uint[] memory nums) external; /// @notice Minting of new token on deploying vault by Factory /// Only Factory can call this. /// @param to User which creates vault /// @param vault Address of vault proxy /// @return tokenId Minted token ID function mint(address to, address vault) external returns (uint tokenId); /// @notice Owner of token can change revenue reciever of platform fee share /// @param tokenId Owned token ID /// @param receiver New revenue receiver address function setRevenueReceiver(uint tokenId, address receiver) external; //endregion -- Write functions ----- }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "@openzeppelin/contracts/token/ERC721/extensions/IERC721Metadata.sol"; /// @dev Interface of developed strategy logic NFT /// @author Alien Deployer (https://github.com/a17) /// @author Jude (https://github.com/iammrjude) /// @author JodsMigel (https://github.com/JodsMigel) interface IStrategyLogic is IERC721Metadata { //region ----- Events ----- event SetRevenueReceiver(uint tokenId, address receiver); //endregion -- Events ----- struct StrategyData { uint strategyTokenId; string strategyId; bytes32 strategyExtra; } /// @notice Minting of new developed strategy by the factory /// @dev Parameters from StrategyDeveloperLib, StrategyIdLib. /// Only factory can call it. /// @param to Strategy developer address /// @param strategyLogicId Strategy logic ID string /// @return tokenId Minted token ID function mint(address to, string memory strategyLogicId) external returns (uint tokenId); /// @notice Owner of token can change address for receiving strategy logic revenue share /// Only owner of token can call it. /// @param tokenId Owned token ID /// @param receiver Address for receiving revenue function setRevenueReceiver(uint tokenId, address receiver) external; /// @notice Token ID to strategy logic ID map /// @param tokenId Owned token ID /// @return strategyLogicId Strategy logic ID string function tokenStrategyLogic(uint tokenId) external view returns (string memory strategyLogicId); /// @notice Current revenue reciever for token /// @param tokenId Token ID /// @return receiver Address for receiving revenue function getRevenueReceiver(uint tokenId) external view returns (address receiver); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "@openzeppelin/contracts/utils/structs/EnumerableSet.sol"; /// @notice Creating vaults, upgrading vaults and strategies, vault list, farms and strategy logics management /// @author Alien Deployer (https://github.com/a17) /// @author Jude (https://github.com/iammrjude) /// @author JodsMigel (https://github.com/JodsMigel) /// @author HCrypto7 (https://github.com/hcrypto7) interface IFactory { //region ----- Custom Errors ----- error VaultImplementationIsNotAvailable(); error VaultNotAllowedToDeploy(); error StrategyImplementationIsNotAvailable(); error StrategyLogicNotAllowedToDeploy(); error YouDontHaveEnoughTokens(uint userBalance, uint requireBalance, address payToken); error SuchVaultAlreadyDeployed(bytes32 key); error NotActiveVault(); error UpgradeDenied(bytes32 _hash); error AlreadyLastVersion(bytes32 _hash); error NotStrategy(); error BoostDurationTooLow(); error BoostAmountTooLow(); error BoostAmountIsZero(); //endregion ----- Custom Errors ----- //region ----- Events ----- event VaultAndStrategy( address indexed deployer, string vaultType, string strategyId, address vault, address strategy, string name, string symbol, address[] assets, bytes32 deploymentKey, uint vaultManagerTokenId ); event StrategyProxyUpgraded(address proxy, address oldImplementation, address newImplementation); event VaultProxyUpgraded(address proxy, address oldImplementation, address newImplementation); event VaultConfigChanged( string type_, address implementation, bool deployAllowed, bool upgradeAllowed, bool newVaultType ); event StrategyLogicConfigChanged( string id, address implementation, bool deployAllowed, bool upgradeAllowed, bool newStrategy ); event VaultStatus(address indexed vault, uint newStatus); event NewFarm(Farm[] farms); event UpdateFarm(uint id, Farm farm); event SetStrategyAvailableInitParams(string id, address[] initAddresses, uint[] initNums, int24[] initTicks); event AliasNameChanged(address indexed operator, address indexed tokenAddress, string newAliasName); //endregion -- Events ----- //region ----- Data types ----- /// @custom:storage-location erc7201:stability.Factory struct FactoryStorage { /// @inheritdoc IFactory mapping(bytes32 typeHash => VaultConfig) vaultConfig; /// @inheritdoc IFactory mapping(bytes32 idHash => StrategyLogicConfig) strategyLogicConfig; /// @inheritdoc IFactory mapping(bytes32 deploymentKey => address vaultProxy) deploymentKey; /// @inheritdoc IFactory mapping(address vault => uint status) vaultStatus; /// @inheritdoc IFactory mapping(address address_ => bool isStrategy_) isStrategy; EnumerableSet.Bytes32Set vaultTypeHashes; EnumerableSet.Bytes32Set strategyLogicIdHashes; mapping(uint week => mapping(uint builderPermitTokenId => uint vaultsBuilt)) vaultsBuiltByPermitTokenId; address[] deployedVaults; Farm[] farms; /// @inheritdoc IFactory mapping(bytes32 idHash => StrategyAvailableInitParams) strategyAvailableInitParams; mapping(address tokenAddress => string aliasName) aliasNames; } struct VaultConfig { string vaultType; address implementation; bool deployAllowed; bool upgradeAllowed; uint buildingPrice; } struct StrategyLogicConfig { string id; address implementation; bool deployAllowed; bool upgradeAllowed; bool farming; uint tokenId; } struct Farm { uint status; address pool; string strategyLogicId; address[] rewardAssets; address[] addresses; uint[] nums; int24[] ticks; } struct StrategyAvailableInitParams { address[] initAddresses; uint[] initNums; int24[] initTicks; } //endregion -- Data types ----- //region ----- View functions ----- /// @notice All vaults deployed by the factory /// @return Vault proxy addresses function deployedVaults() external view returns (address[] memory); /// @notice Total vaults deployed function deployedVaultsLength() external view returns (uint); /// @notice Get vault by VaultManager tokenId /// @param id Vault array index. Same as tokenId of VaultManager NFT /// @return Address of VaultProxy function deployedVault(uint id) external view returns (address); /// @notice All farms known by the factory in current network function farms() external view returns (Farm[] memory); /// @notice Total farms known by the factory in current network function farmsLength() external view returns (uint); /// @notice Farm data by farm index /// @param id Index of farm function farm(uint id) external view returns (Farm memory); /// @notice Strategy logic settings /// @param idHash keccak256 hash of strategy logic string ID /// @return config Strategy logic settings function strategyLogicConfig(bytes32 idHash) external view returns (StrategyLogicConfig memory config); /// @notice All known strategies /// @return Array of keccak256 hashes of strategy logic string ID function strategyLogicIdHashes() external view returns (bytes32[] memory); // todo remove, use new function without calculating vault symbol on the fly for not initialized vaults // factory required that special functionally only internally, not for interface function getStrategyData( string memory vaultType, address strategyAddress, address bbAsset ) external view returns ( string memory strategyId, address[] memory assets, string[] memory assetsSymbols, string memory specificName, string memory vaultSymbol ); /// @dev Get best asset of assets to be strategy exchange asset function getExchangeAssetIndex(address[] memory assets) external view returns (uint); /// @notice Deployment key of created vault /// @param deploymentKey_ Hash of concatenated unique vault and strategy initialization parameters /// @return Address of deployed vault function deploymentKey(bytes32 deploymentKey_) external view returns (address); /// @notice Calculating deployment key based on unique vault and strategy initialization parameters /// @param vaultType Vault type string /// @param strategyId Strategy logic Id string /// @param vaultInitAddresses Vault initialization addresses for deployVaultAndStrategy method /// @param vaultInitNums Vault initialization uint numbers for deployVaultAndStrategy method /// @param strategyInitAddresses Strategy initialization addresses for deployVaultAndStrategy method /// @param strategyInitNums Strategy initialization uint numbers for deployVaultAndStrategy method /// @param strategyInitTicks Strategy initialization int24 ticks for deployVaultAndStrategy method function getDeploymentKey( string memory vaultType, string memory strategyId, address[] memory vaultInitAddresses, uint[] memory vaultInitNums, address[] memory strategyInitAddresses, uint[] memory strategyInitNums, int24[] memory strategyInitTicks ) external view returns (bytes32); /// @notice Available variants of new vault for creating. /// DEPRECATED: use IFrontend.whatToBuild /// The structure of the function's output values is complex, /// but after parsing them, the front end has all the data to generate a list of vaults to create. /// @return desc Descriptions of the strategy for making money /// @return vaultType Vault type strings. Output values are matched by index with previous array. /// @return strategyId Strategy logic ID strings. Output values are matched by index with previous array. /// @return initIndexes Map of start and end indexes in next 5 arrays. Output values are matched by index with previous array. /// [0] Start index in vaultInitAddresses /// [1] End index in vaultInitAddresses /// [2] Start index in vaultInitNums /// [3] End index in vaultInitNums /// [4] Start index in strategyInitAddresses /// [5] End index in strategyInitAddresses /// [6] Start index in strategyInitNums /// [7] End index in strategyInitNums /// [8] Start index in strategyInitTicks /// [9] End index in strategyInitTicks /// @return vaultInitAddresses Vault initialization addresses for deployVaultAndStrategy method for all building variants. /// @return vaultInitNums Vault initialization uint numbers for deployVaultAndStrategy method for all building variants. /// @return strategyInitAddresses Strategy initialization addresses for deployVaultAndStrategy method for all building variants. /// @return strategyInitNums Strategy initialization uint numbers for deployVaultAndStrategy method for all building variants. /// @return strategyInitTicks Strategy initialization int24 ticks for deployVaultAndStrategy method for all building variants. function whatToBuild() external view returns ( string[] memory desc, string[] memory vaultType, string[] memory strategyId, uint[10][] memory initIndexes, address[] memory vaultInitAddresses, uint[] memory vaultInitNums, address[] memory strategyInitAddresses, uint[] memory strategyInitNums, int24[] memory strategyInitTicks ); /// @notice Governance and multisig can set a vault status other than Active - the default status. /// HardWorker only works with active vaults. /// @return status Constant from VaultStatusLib function vaultStatus(address vault) external view returns (uint status); /// @notice Check that strategy proxy deployed by the Factory /// @param address_ Address of contract /// @return This address is our strategy proxy function isStrategy(address address_) external view returns (bool); /// @notice How much vaults was built by builderPermitToken NFT tokenId in week /// @param week Week index (timestamp / (86400 * 7)) /// @param builderPermitTokenId Token ID of buildingPermitToken NFT /// @return vaultsBuilt Vaults built function vaultsBuiltByPermitTokenId( uint week, uint builderPermitTokenId ) external view returns (uint vaultsBuilt); /// @notice Data on all factory strategies. /// The output values are matched by index in the arrays. /// @return id Strategy logic ID strings /// @return deployAllowed New vaults can be deployed /// @return upgradeAllowed Strategy can be upgraded /// @return farming It is farming strategy (earns farming/gauge rewards) /// @return tokenId Token ID of StrategyLogic NFT /// @return tokenURI StrategyLogic NFT tokenId metadata and on-chain image /// @return extra Strategy color, background color and other extra data function strategies() external view returns ( string[] memory id, bool[] memory deployAllowed, bool[] memory upgradeAllowed, bool[] memory farming, uint[] memory tokenId, string[] memory tokenURI, bytes32[] memory extra ); /// @notice Get config of vault type /// @param typeHash Keccak256 hash of vault type string /// @return vaultType Vault type string /// @return implementation Vault implementation address /// @return deployAllowed New vaults can be deployed /// @return upgradeAllowed Vaults can be upgraded /// @return buildingPrice Price of building new vault function vaultConfig(bytes32 typeHash) external view returns ( string memory vaultType, address implementation, bool deployAllowed, bool upgradeAllowed, uint buildingPrice ); /// @notice Data on all factory vault types /// The output values are matched by index in the arrays. /// @return vaultType Vault type string /// @return implementation Address of vault implemented logic /// @return deployAllowed New vaults can be deployed /// @return upgradeAllowed Vaults can be upgraded /// @return buildingPrice Price of building new vault /// @return extra Vault type color, background color and other extra data function vaultTypes() external view returns ( string[] memory vaultType, address[] memory implementation, bool[] memory deployAllowed, bool[] memory upgradeAllowed, uint[] memory buildingPrice, bytes32[] memory extra ); /// @notice Initialization strategy params store function strategyAvailableInitParams(bytes32 idHash) external view returns (StrategyAvailableInitParams memory); /// @notice Retrieves the alias name associated with a given address /// @param tokenAddress_ The address to query for its alias name /// @return The alias name associated with the provided address function getAliasName(address tokenAddress_) external view returns (string memory); //endregion -- View functions ----- //region ----- Write functions ----- /// @notice Main method of the Factory - new vault creation by user. /// @param vaultType Vault type ID string /// @param strategyId Strategy logic ID string /// Different types of vaults and strategies have different lengths of input arrays. /// @param vaultInitAddresses Addresses for vault initialization /// @param vaultInitNums Numbers for vault initialization /// @param strategyInitAddresses Addresses for strategy initialization /// @param strategyInitNums Numbers for strategy initialization /// @param strategyInitTicks Ticks for strategy initialization /// @return vault Deployed VaultProxy address /// @return strategy Deployed StrategyProxy address function deployVaultAndStrategy( string memory vaultType, string memory strategyId, address[] memory vaultInitAddresses, uint[] memory vaultInitNums, address[] memory strategyInitAddresses, uint[] memory strategyInitNums, int24[] memory strategyInitTicks ) external returns (address vault, address strategy); /// @notice Upgrade vault proxy. Can be called by any address. /// @param vault Address of vault proxy for upgrade function upgradeVaultProxy(address vault) external; /// @notice Upgrade strategy proxy. Can be called by any address. /// @param strategy Address of strategy proxy for upgrade function upgradeStrategyProxy(address strategy) external; /// @notice Add farm to factory /// @param farms_ Settings and data required to work with the farm. function addFarms(Farm[] memory farms_) external; /// @notice Update farm /// @param id Farm index /// @param farm_ Settings and data required to work with the farm. function updateFarm(uint id, Farm memory farm_) external; /// @notice Initial addition or change of vault type settings. /// Operator can add new vault type. Governance or multisig can change existing vault type config. /// @param vaultConfig_ Vault type settings function setVaultConfig(VaultConfig memory vaultConfig_) external; /// @notice Initial addition or change of strategy logic settings. /// Operator can add new strategy logic. Governance or multisig can change existing logic config. /// @param config Strategy logic settings /// @param developer Strategy developer is receiver of minted StrategyLogic NFT on initial addition function setStrategyLogicConfig(StrategyLogicConfig memory config, address developer) external; /// @notice Governance and multisig can set a vault status other than Active - the default status. /// @param vaults Addresses of vault proxy /// @param statuses New vault statuses. Constant from VaultStatusLib function setVaultStatus(address[] memory vaults, uint[] memory statuses) external; /// @notice Initial addition or change of strategy available init params /// @param id Strategy ID string /// @param initParams Init params variations that will be parsed by strategy function setStrategyAvailableInitParams(string memory id, StrategyAvailableInitParams memory initParams) external; /// @notice Assigns a new alias name to a specific address /// @dev This function may require certain permissions to be called successfully. /// @param tokenAddress_ The address to assign an alias name to /// @param aliasName_ The alias name to assign to the given address function setAliasName(address tokenAddress_, string memory aliasName_) external; //endregion -- Write functions ----- }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; /// @notice On-chain price quoter and swapper by predefined routes /// @author Alien Deployer (https://github.com/a17) /// @author Jude (https://github.com/iammrjude) /// @author JodsMigel (https://github.com/JodsMigel) /// @author 0xhokugava (https://github.com/0xhokugava) interface ISwapper { event Swap(address indexed tokenIn, address indexed tokenOut, uint amount); event PoolAdded(PoolData poolData, bool assetAdded); event PoolRemoved(address token); event BlueChipAdded(PoolData poolData); event ThresholdChanged(address[] tokenIn, uint[] thresholdAmount); event BlueChipPoolRemoved(address tokenIn, address tokenOut); //region ----- Custom Errors ----- error UnknownAMMAdapter(); error LessThenThreshold(uint minimumAmount); error NoRouteFound(); error NoRoutesForAssets(); //endregion -- Custom Errors ----- struct PoolData { address pool; address ammAdapter; address tokenIn; address tokenOut; } struct AddPoolData { address pool; string ammAdapterId; address tokenIn; address tokenOut; } /// @notice All assets in pools added to Swapper /// @return Addresses of assets function assets() external view returns (address[] memory); /// @notice All blue chip assets in blue chip pools added to Swapper /// @return Addresses of blue chip assets function bcAssets() external view returns (address[] memory); /// @notice All assets in Swapper /// @return Addresses of assets and blue chip assets function allAssets() external view returns (address[] memory); /// @notice Add pools with largest TVL /// @param pools Largest pools with AMM adapter addresses /// @param rewrite Rewrite pool for tokenIn function addPools(PoolData[] memory pools, bool rewrite) external; /// @notice Add pools with largest TVL /// @param pools Largest pools with AMM adapter ID string /// @param rewrite Rewrite pool for tokenIn function addPools(AddPoolData[] memory pools, bool rewrite) external; /// @notice Add largest pools with the most popular tokens on the current network /// @param pools_ PoolData array with pool, tokens and AMM adapter address /// @param rewrite Change exist pool records function addBlueChipsPools(PoolData[] memory pools_, bool rewrite) external; /// @notice Add largest pools with the most popular tokens on the current network /// @param pools_ AddPoolData array with pool, tokens and AMM adapter string ID /// @param rewrite Change exist pool records function addBlueChipsPools(AddPoolData[] memory pools_, bool rewrite) external; /// @notice Retrieves pool data for a specified token swap in Blue Chip Pools. /// @dev This function provides information about the pool associated with the specified input and output tokens. /// @param tokenIn The input token address. /// @param tokenOut The output token address. /// @return poolData The data structure containing information about the Blue Chip Pool. /// @custom:opcodes view function blueChipsPools(address tokenIn, address tokenOut) external view returns (PoolData memory poolData); /// @notice Set swap threshold for token /// @dev Prevents dust swap. /// @param tokenIn Swap input token /// @param thresholdAmount Minimum amount of token for executing swap function setThresholds(address[] memory tokenIn, uint[] memory thresholdAmount) external; /// @notice Swap threshold for token /// @param token Swap input token /// @return threshold_ Minimum amount of token for executing swap function threshold(address token) external view returns (uint threshold_); /// @notice Price of given tokenIn against tokenOut /// @param tokenIn Swap input token /// @param tokenOut Swap output token /// @param amount Amount of tokenIn. If provide zero then amount is 1.0. /// @return Amount of tokenOut with decimals of tokenOut function getPrice(address tokenIn, address tokenOut, uint amount) external view returns (uint); /// @notice Return price the first poolData.tokenIn against the last poolData.tokenOut in decimals of tokenOut. /// @param route Array of pool address, swapper address tokenIn, tokenOut /// @param amount Amount of tokenIn. If provide zero then amount is 1.0. function getPriceForRoute(PoolData[] memory route, uint amount) external view returns (uint); /// @notice Check possibility of swap tokenIn for tokenOut /// @param tokenIn Swap input token /// @param tokenOut Swap output token /// @return Swap route exists function isRouteExist(address tokenIn, address tokenOut) external view returns (bool); /// @notice Build route for swap. No reverts inside. /// @param tokenIn Swap input token /// @param tokenOut Swap output token /// @return route Array of pools for swap tokenIn to tokenOut. Zero length indicate an error. /// @return errorMessage Possible reason why the route was not found. Empty for success routes. function buildRoute( address tokenIn, address tokenOut ) external view returns (PoolData[] memory route, string memory errorMessage); /// @notice Sell tokenIn for tokenOut /// @dev Assume approve on this contract exist /// @param tokenIn Swap input token /// @param tokenOut Swap output token /// @param amount Amount of tokenIn for swap. /// @param priceImpactTolerance Price impact tolerance. Must include fees at least. Denominator is 100_000. function swap(address tokenIn, address tokenOut, uint amount, uint priceImpactTolerance) external; /// @notice Swap by predefined route /// @param route Array of pool address, swapper address tokenIn, tokenOut. /// TokenIn from first item will be swaped to tokenOut of last . /// @param amount Amount of first item tokenIn. /// @param priceImpactTolerance Price impact tolerance. Must include fees at least. Denominator is 100_000. function swapWithRoute(PoolData[] memory route, uint amount, uint priceImpactTolerance) external; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "../interfaces/IAmmAdapter.sol"; /// @title Liquidity providing strategy /// @author Alien Deployer (https://github.com/a17) interface ILPStrategy { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ event FeesClaimed(uint[] fees); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ error ZeroAmmAdapter(); error IncorrectAssetsLength(); error IncorrectAssets(); error IncorrectAmountsLength(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* DATA TYPES */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @custom:storage-location erc7201:stability.LPStrategyBase struct LPStrategyBaseStorage { /// @inheritdoc ILPStrategy address pool; /// @inheritdoc ILPStrategy IAmmAdapter ammAdapter; uint[] _feesOnBalance; } struct LPStrategyBaseInitParams { string id; address platform; address vault; address pool; address underlying; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev AMM adapter string ID for interacting with pool function ammAdapterId() external view returns (string memory); /// @dev AMM adapter address for interacting with pool function ammAdapter() external view returns (IAmmAdapter); /// @dev AMM function pool() external view returns (address); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; /// @dev Mostly this interface need for front-end and tests for interacting with farming strategies /// @author JodsMigel (https://github.com/JodsMigel) interface IFarmingStrategy { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ event RewardsClaimed(uint[] amounts); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ error BadFarm(); error IncorrectStrategyId(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* DATA TYPES */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @custom:storage-location erc7201:stability.FarmingStrategyBase struct FarmingStrategyBaseStorage { /// @inheritdoc IFarmingStrategy uint farmId; address[] _rewardAssets; uint[] _rewardsOnBalance; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice Index of the farm used by initialized strategy function farmId() external view returns (uint); /// @notice Strategy can earn money on farm now /// Some strategies can continue work and earn pool fees after ending of farm rewards. function canFarm() external view returns (bool); /// @notice Mechanics of receiving farming rewards function farmMechanics() external view returns (string memory); /// @notice Farming reward assets for claim and liquidate /// @return Addresses of farm reward ERC20 tokens function farmingAssets() external view returns (address[] memory); /// @notice Address of pool for staking asset/underlying function stakingPool() external view returns (address); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* WRITE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice Update strategy farming reward assets from Factory /// Only operator can call this function refreshFarmingAssets() external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Context.sol) pragma solidity ^0.8.20; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract ContextUpgradeable is Initializable { function __Context_init() internal onlyInitializing { } function __Context_init_unchained() internal onlyInitializing { } function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol) pragma solidity ^0.8.20; /** * @dev Standard ERC20 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens. */ interface IERC20Errors { /** * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. * @param balance Current balance for the interacting account. * @param needed Minimum amount required to perform a transfer. */ error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC20InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC20InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers. * @param spender Address that may be allowed to operate on tokens without being their owner. * @param allowance Amount of tokens a `spender` is allowed to operate with. * @param needed Minimum amount required to perform a transfer. */ error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC20InvalidApprover(address approver); /** * @dev Indicates a failure with the `spender` to be approved. Used in approvals. * @param spender Address that may be allowed to operate on tokens without being their owner. */ error ERC20InvalidSpender(address spender); } /** * @dev Standard ERC721 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens. */ interface IERC721Errors { /** * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20. * Used in balance queries. * @param owner Address of the current owner of a token. */ error ERC721InvalidOwner(address owner); /** * @dev Indicates a `tokenId` whose `owner` is the zero address. * @param tokenId Identifier number of a token. */ error ERC721NonexistentToken(uint256 tokenId); /** * @dev Indicates an error related to the ownership over a particular token. Used in transfers. * @param sender Address whose tokens are being transferred. * @param tokenId Identifier number of a token. * @param owner Address of the current owner of a token. */ error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC721InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC721InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `operator`’s approval. Used in transfers. * @param operator Address that may be allowed to operate on tokens without being their owner. * @param tokenId Identifier number of a token. */ error ERC721InsufficientApproval(address operator, uint256 tokenId); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC721InvalidApprover(address approver); /** * @dev Indicates a failure with the `operator` to be approved. Used in approvals. * @param operator Address that may be allowed to operate on tokens without being their owner. */ error ERC721InvalidOperator(address operator); } /** * @dev Standard ERC1155 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens. */ interface IERC1155Errors { /** * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. * @param balance Current balance for the interacting account. * @param needed Minimum amount required to perform a transfer. * @param tokenId Identifier number of a token. */ error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC1155InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC1155InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `operator`’s approval. Used in transfers. * @param operator Address that may be allowed to operate on tokens without being their owner. * @param owner Address of the current owner of a token. */ error ERC1155MissingApprovalForAll(address operator, address owner); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC1155InvalidApprover(address approver); /** * @dev Indicates a failure with the `operator` to be approved. Used in approvals. * @param operator Address that may be allowed to operate on tokens without being their owner. */ error ERC1155InvalidOperator(address operator); /** * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation. * Used in batch transfers. * @param idsLength Length of the array of token identifiers * @param valuesLength Length of the array of token amounts */ error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/Initializable.sol) pragma solidity ^0.8.20; /** * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. * * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in * case an upgrade adds a module that needs to be initialized. * * For example: * * [.hljs-theme-light.nopadding] * ```solidity * contract MyToken is ERC20Upgradeable { * function initialize() initializer public { * __ERC20_init("MyToken", "MTK"); * } * } * * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable { * function initializeV2() reinitializer(2) public { * __ERC20Permit_init("MyToken"); * } * } * ``` * * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. * * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity. * * [CAUTION] * ==== * Avoid leaving a contract uninitialized. * * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() { * _disableInitializers(); * } * ``` * ==== */ abstract contract Initializable { /** * @dev Storage of the initializable contract. * * It's implemented on a custom ERC-7201 namespace to reduce the risk of storage collisions * when using with upgradeable contracts. * * @custom:storage-location erc7201:openzeppelin.storage.Initializable */ struct InitializableStorage { /** * @dev Indicates that the contract has been initialized. */ uint64 _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool _initializing; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Initializable")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant INITIALIZABLE_STORAGE = 0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00; /** * @dev The contract is already initialized. */ error InvalidInitialization(); /** * @dev The contract is not initializing. */ error NotInitializing(); /** * @dev Triggered when the contract has been initialized or reinitialized. */ event Initialized(uint64 version); /** * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope, * `onlyInitializing` functions can be used to initialize parent contracts. * * Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any * number of times. This behavior in the constructor can be useful during testing and is not expected to be used in * production. * * Emits an {Initialized} event. */ modifier initializer() { // solhint-disable-next-line var-name-mixedcase InitializableStorage storage $ = _getInitializableStorage(); // Cache values to avoid duplicated sloads bool isTopLevelCall = !$._initializing; uint64 initialized = $._initialized; // Allowed calls: // - initialSetup: the contract is not in the initializing state and no previous version was // initialized // - construction: the contract is initialized at version 1 (no reininitialization) and the // current contract is just being deployed bool initialSetup = initialized == 0 && isTopLevelCall; bool construction = initialized == 1 && address(this).code.length == 0; if (!initialSetup && !construction) { revert InvalidInitialization(); } $._initialized = 1; if (isTopLevelCall) { $._initializing = true; } _; if (isTopLevelCall) { $._initializing = false; emit Initialized(1); } } /** * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be * used to initialize parent contracts. * * A reinitializer may be used after the original initialization step. This is essential to configure modules that * are added through upgrades and that require initialization. * * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer` * cannot be nested. If one is invoked in the context of another, execution will revert. * * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in * a contract, executing them in the right order is up to the developer or operator. * * WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization. * * Emits an {Initialized} event. */ modifier reinitializer(uint64 version) { // solhint-disable-next-line var-name-mixedcase InitializableStorage storage $ = _getInitializableStorage(); if ($._initializing || $._initialized >= version) { revert InvalidInitialization(); } $._initialized = version; $._initializing = true; _; $._initializing = false; emit Initialized(version); } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} and {reinitializer} modifiers, directly or indirectly. */ modifier onlyInitializing() { _checkInitializing(); _; } /** * @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}. */ function _checkInitializing() internal view virtual { if (!_isInitializing()) { revert NotInitializing(); } } /** * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call. * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized * to any version. It is recommended to use this to lock implementation contracts that are designed to be called * through proxies. * * Emits an {Initialized} event the first time it is successfully executed. */ function _disableInitializers() internal virtual { // solhint-disable-next-line var-name-mixedcase InitializableStorage storage $ = _getInitializableStorage(); if ($._initializing) { revert InvalidInitialization(); } if ($._initialized != type(uint64).max) { $._initialized = type(uint64).max; emit Initialized(type(uint64).max); } } /** * @dev Returns the highest version that has been initialized. See {reinitializer}. */ function _getInitializedVersion() internal view returns (uint64) { return _getInitializableStorage()._initialized; } /** * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}. */ function _isInitializing() internal view returns (bool) { return _getInitializableStorage()._initializing; } /** * @dev Returns a pointer to the storage namespace. */ // solhint-disable-next-line var-name-mixedcase function _getInitializableStorage() private pure returns (InitializableStorage storage $) { assembly { $.slot := INITIALIZABLE_STORAGE } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Strings.sol) pragma solidity ^0.8.20; import {Math} from "./math/Math.sol"; import {SignedMath} from "./math/SignedMath.sol"; /** * @dev String operations. */ library Strings { bytes16 private constant HEX_DIGITS = "0123456789abcdef"; uint8 private constant ADDRESS_LENGTH = 20; /** * @dev The `value` string doesn't fit in the specified `length`. */ error StringsInsufficientHexLength(uint256 value, uint256 length); /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { unchecked { uint256 length = Math.log10(value) + 1; string memory buffer = new string(length); uint256 ptr; /// @solidity memory-safe-assembly assembly { ptr := add(buffer, add(32, length)) } while (true) { ptr--; /// @solidity memory-safe-assembly assembly { mstore8(ptr, byte(mod(value, 10), HEX_DIGITS)) } value /= 10; if (value == 0) break; } return buffer; } } /** * @dev Converts a `int256` to its ASCII `string` decimal representation. */ function toStringSigned(int256 value) internal pure returns (string memory) { return string.concat(value < 0 ? "-" : "", toString(SignedMath.abs(value))); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { unchecked { return toHexString(value, Math.log256(value) + 1); } } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { uint256 localValue = value; bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = HEX_DIGITS[localValue & 0xf]; localValue >>= 4; } if (localValue != 0) { revert StringsInsufficientHexLength(value, length); } return string(buffer); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal * representation. */ function toHexString(address addr) internal pure returns (string memory) { return toHexString(uint256(uint160(addr)), ADDRESS_LENGTH); } /** * @dev Returns true if the two strings are equal. */ function equal(string memory a, string memory b) internal pure returns (bool) { return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b)); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "@openzeppelin/contracts/utils/introspection/IERC165.sol"; /// @dev Core interface of strategy logic interface IStrategy is IERC165 { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ event HardWork( uint apr, uint compoundApr, uint earned, uint tvl, uint duration, uint sharePrice, uint[] assetPrices ); event ExtractFees( uint vaultManagerReceiverFee, uint strategyLogicReceiverFee, uint ecosystemRevenueReceiverFee, uint multisigReceiverFee ); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ error NotReadyForHardWork(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* DATA TYPES */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @custom:storage-location erc7201:stability.StrategyBase struct StrategyBaseStorage { /// @inheritdoc IStrategy address vault; /// @inheritdoc IStrategy uint total; /// @inheritdoc IStrategy uint lastHardWork; /// @inheritdoc IStrategy uint lastApr; /// @inheritdoc IStrategy uint lastAprCompound; /// @inheritdoc IStrategy address[] _assets; /// @inheritdoc IStrategy address _underlying; string _id; uint _exchangeAssetIndex; uint customPriceImpactTolerance; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Strategy logic string ID function strategyLogicId() external view returns (string memory); /// @dev Extra data /// @return 0-2 bytes - strategy color /// 3-5 bytes - strategy background color /// 6-31 bytes - free function extra() external view returns (bytes32); /// @dev Types of vault that supported by strategy implementation /// @return types Vault type ID strings function supportedVaultTypes() external view returns (string[] memory types); /// @dev Linked vault address function vault() external view returns (address); /// @dev Final assets that strategy invests function assets() external view returns (address[] memory); /// @notice Final assets and amounts that strategy manages function assetsAmounts() external view returns (address[] memory assets_, uint[] memory amounts_); /// @notice Priced invested assets proportions /// @return proportions Proportions of assets with 18 decimals. Min is 0, max is 1e18. function getAssetsProportions() external view returns (uint[] memory proportions); /// @notice Underlying token address /// @dev Can be used for liquidity farming strategies where AMM has fungible liquidity token (Solidly forks, etc), /// for concentrated liquidity tokenized vaults (Gamma, G-UNI etc) and for other needs. /// @return Address of underlying token or zero address if no underlying in strategy function underlying() external view returns (address); /// @dev Balance of liquidity token or liquidity value function total() external view returns (uint); /// @dev Last HardWork time /// @return Timestamp function lastHardWork() external view returns (uint); /// @dev Last APR of earned USD amount registered by HardWork /// ONLY FOR OFF-CHAIN USE. /// Not trusted asset price can be manipulated. /// @return APR with 18 decimals. 1e18 - 100%. function lastApr() external view returns (uint); /// @dev Last APR of compounded assets registered by HardWork. /// Can be used on-chain. /// @return APR with 18 decimals. 1e18 - 100%. function lastAprCompound() external view returns (uint); /// @notice Calculation of consumed amounts and liquidity/underlying value for provided strategy assets and amounts. /// @param assets_ Strategy assets or part of them, if necessary /// @param amountsMax Amounts of specified assets available for investing /// @return amountsConsumed Cosumed amounts of assets when investing /// @return value Liquidity value or underlying token amount minted when investing function previewDepositAssets( address[] memory assets_, uint[] memory amountsMax ) external view returns (uint[] memory amountsConsumed, uint value); /// @notice Write version of previewDepositAssets /// @param assets_ Strategy assets or part of them, if necessary /// @param amountsMax Amounts of specified assets available for investing /// @return amountsConsumed Cosumed amounts of assets when investing /// @return value Liquidity value or underlying token amount minted when investing function previewDepositAssetsWrite( address[] memory assets_, uint[] memory amountsMax ) external returns (uint[] memory amountsConsumed, uint value); /// @notice All strategy revenue (pool fees, farm rewards etc) that not claimed by strategy yet /// @return assets_ Revenue assets /// @return amounts Amounts. Index of asset same as in previous array. function getRevenue() external view returns (address[] memory assets_, uint[] memory amounts); /// @notice Optional specific name of investing strategy, underyling type, setup variation etc /// @return name Empty string or specific name /// @return showInVaultSymbol Show specific in linked vault symbol function getSpecificName() external view returns (string memory name, bool showInVaultSymbol); /// @notice Variants pf strategy initializations with description of money making mechanic. /// As example, if strategy need farm, then number of variations is number of available farms. /// If CAMM strategy have set of available widths (tick ranges), then number of variations is number of available farms. /// If both example conditions are met then total number or variations = total farms * total widths. /// @param platform_ Need this param because method called when strategy implementation is not initialized /// @return variants Descriptions of the strategy for making money /// @return addresses Init strategy addresses. Indexes for each variants depends of copmpared arrays lengths. /// @return nums Init strategy numbers. Indexes for each variants depends of copmpared arrays lengths. /// @return ticks Init strategy ticks. Indexes for each variants depends of copmpared arrays lengths. function initVariants(address platform_) external view returns (string[] memory variants, address[] memory addresses, uint[] memory nums, int24[] memory ticks); /// @notice How does the strategy make money? /// @return Description in free form function description() external view returns (string memory); /// @notice Is HardWork on vault deposits can be enabled function isHardWorkOnDepositAllowed() external view returns (bool); /// @notice Is HardWork can be executed function isReadyForHardWork() external view returns (bool); /// @notice Strategy not need to process revenue on HardWorks function autoCompoundingByUnderlyingProtocol() external view returns (bool); /// @notice Custom price impact tolerance instead default need for specific cases where liquidity in pools is low function customPriceImpactTolerance() external view returns (uint); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* WRITE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev A single universal initializer for all strategy implementations. /// @param addresses All addresses that strategy requires for initialization. Min array length is 2. /// addresses[0]: platform (required) /// addresses[1]: vault (required) /// addresses[2]: initStrategyAddresses[0] (optional) /// addresses[3]: initStrategyAddresses[1] (optional) /// addresses[n]: initStrategyAddresses[n - 2] (optional) /// @param nums All uint values that strategy requires for initialization. Min array length is 0. /// @param ticks All int24 values that strategy requires for initialization. Min array length is 0. function initialize(address[] memory addresses, uint[] memory nums, int24[] memory ticks) external; /// @notice Invest strategy assets. Amounts of assets must be already on strategy contract balance. /// Only vault can call this. /// @param amounts Anounts of strategy assets /// @return value Liquidity value or underlying token amount function depositAssets(uint[] memory amounts) external returns (uint value); /// @notice Invest underlying asset. Asset must be already on strategy contract balance. /// Only vault can call this. /// @param amount Amount of underlying asset to invest /// @return amountsConsumed Cosumed amounts of invested assets function depositUnderlying(uint amount) external returns (uint[] memory amountsConsumed); /// @dev For specified amount of shares and assets_, withdraw strategy assets from farm/pool/staking and send to receiver if possible /// Only vault can call this. /// @param assets_ Here we give the user a choice of assets to withdraw if strategy support it /// @param value Part of strategy total value to withdraw /// @param receiver User address /// @return amountsOut Amounts of assets sent to user function withdrawAssets( address[] memory assets_, uint value, address receiver ) external returns (uint[] memory amountsOut); /// @notice Wothdraw underlying invested and send to receiver /// Only vault can call this. /// @param amount Ampunt of underlying asset to withdraw /// @param receiver User of vault which withdraw underlying from the vault function withdrawUnderlying(uint amount, address receiver) external; /// @dev For specified amount of shares, transfer strategy assets from contract balance and send to receiver if possible /// This method is called by vault w/o underlying on triggered fuse mode. /// Only vault can call this. /// @param amount Ampunt of liquidity value that user withdraw /// @param totalAmount Total amount of strategy liquidity /// @param receiver User of vault which withdraw assets /// @return amountsOut Amounts of strategy assets sent to user function transferAssets( uint amount, uint totalAmount, address receiver ) external returns (uint[] memory amountsOut); /// @notice Execute HardWork /// During HardWork strategy claiming revenue and processing it. /// Only vault can call this. function doHardWork() external; /// @notice Emergency stop investing by strategy, withdraw liquidity without rewards. /// This action triggers FUSE mode. /// Only governance or multisig can call this. function emergencyStopInvesting() external; /// @notice Custom price impact tolerance instead default need for specific cases where low liquidity in pools /// @param priceImpactTolerance Tolerance percent with 100_000 DENOMINATOR. 4_000 == 4% function setCustomPriceImpactTolerance(uint priceImpactTolerance) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/extensions/IERC721Metadata.sol) pragma solidity ^0.8.20; import {IERC721} from "../IERC721.sol"; /** * @title ERC-721 Non-Fungible Token Standard, optional metadata extension * @dev See https://eips.ethereum.org/EIPS/eip-721 */ interface IERC721Metadata is IERC721 { /** * @dev Returns the token collection name. */ function name() external view returns (string memory); /** * @dev Returns the token collection symbol. */ function symbol() external view returns (string memory); /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) external view returns (string memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/structs/EnumerableSet.sol) // This file was procedurally generated from scripts/generate/templates/EnumerableSet.js. pragma solidity ^0.8.20; /** * @dev Library for managing * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive * types. * * Sets have the following properties: * * - Elements are added, removed, and checked for existence in constant time * (O(1)). * - Elements are enumerated in O(n). No guarantees are made on the ordering. * * ```solidity * contract Example { * // Add the library methods * using EnumerableSet for EnumerableSet.AddressSet; * * // Declare a set state variable * EnumerableSet.AddressSet private mySet; * } * ``` * * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`) * and `uint256` (`UintSet`) are supported. * * [WARNING] * ==== * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure * unusable. * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info. * * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an * array of EnumerableSet. * ==== */ library EnumerableSet { // To implement this library for multiple types with as little code // repetition as possible, we write it in terms of a generic Set type with // bytes32 values. // The Set implementation uses private functions, and user-facing // implementations (such as AddressSet) are just wrappers around the // underlying Set. // This means that we can only create new EnumerableSets for types that fit // in bytes32. struct Set { // Storage of set values bytes32[] _values; // Position is the index of the value in the `values` array plus 1. // Position 0 is used to mean a value is not in the set. mapping(bytes32 value => uint256) _positions; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function _add(Set storage set, bytes32 value) private returns (bool) { if (!_contains(set, value)) { set._values.push(value); // The value is stored at length-1, but we add 1 to all indexes // and use 0 as a sentinel value set._positions[value] = set._values.length; return true; } else { return false; } } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function _remove(Set storage set, bytes32 value) private returns (bool) { // We cache the value's position to prevent multiple reads from the same storage slot uint256 position = set._positions[value]; if (position != 0) { // Equivalent to contains(set, value) // To delete an element from the _values array in O(1), we swap the element to delete with the last one in // the array, and then remove the last element (sometimes called as 'swap and pop'). // This modifies the order of the array, as noted in {at}. uint256 valueIndex = position - 1; uint256 lastIndex = set._values.length - 1; if (valueIndex != lastIndex) { bytes32 lastValue = set._values[lastIndex]; // Move the lastValue to the index where the value to delete is set._values[valueIndex] = lastValue; // Update the tracked position of the lastValue (that was just moved) set._positions[lastValue] = position; } // Delete the slot where the moved value was stored set._values.pop(); // Delete the tracked position for the deleted slot delete set._positions[value]; return true; } else { return false; } } /** * @dev Returns true if the value is in the set. O(1). */ function _contains(Set storage set, bytes32 value) private view returns (bool) { return set._positions[value] != 0; } /** * @dev Returns the number of values on the set. O(1). */ function _length(Set storage set) private view returns (uint256) { return set._values.length; } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function _at(Set storage set, uint256 index) private view returns (bytes32) { return set._values[index]; } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function _values(Set storage set) private view returns (bytes32[] memory) { return set._values; } // Bytes32Set struct Bytes32Set { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _add(set._inner, value); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _remove(set._inner, value); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) { return _contains(set._inner, value); } /** * @dev Returns the number of values in the set. O(1). */ function length(Bytes32Set storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) { return _at(set._inner, index); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(Bytes32Set storage set) internal view returns (bytes32[] memory) { bytes32[] memory store = _values(set._inner); bytes32[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } // AddressSet struct AddressSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(AddressSet storage set, address value) internal returns (bool) { return _add(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(AddressSet storage set, address value) internal returns (bool) { return _remove(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(AddressSet storage set, address value) internal view returns (bool) { return _contains(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns the number of values in the set. O(1). */ function length(AddressSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(AddressSet storage set, uint256 index) internal view returns (address) { return address(uint160(uint256(_at(set._inner, index)))); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(AddressSet storage set) internal view returns (address[] memory) { bytes32[] memory store = _values(set._inner); address[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } // UintSet struct UintSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(UintSet storage set, uint256 value) internal returns (bool) { return _add(set._inner, bytes32(value)); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(UintSet storage set, uint256 value) internal returns (bool) { return _remove(set._inner, bytes32(value)); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(UintSet storage set, uint256 value) internal view returns (bool) { return _contains(set._inner, bytes32(value)); } /** * @dev Returns the number of values in the set. O(1). */ function length(UintSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(UintSet storage set, uint256 index) internal view returns (uint256) { return uint256(_at(set._inner, index)); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(UintSet storage set) internal view returns (uint256[] memory) { bytes32[] memory store = _values(set._inner); uint256[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "@openzeppelin/contracts/utils/introspection/IERC165.sol"; /// @dev Get price, swap, liquidity calculations. Used by strategies and swapper /// @author Alien Deployer (https://github.com/a17) /// @author JodsMigel (https://github.com/JodsMigel) interface IAmmAdapter is IERC165 { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ error PriceIncreased(); error WrongCallbackAmount(); error NotSupportedByCAMM(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ event SwapInPool( address pool, address tokenIn, address tokenOut, address recipient, uint priceImpactTolerance, uint amountIn, uint amountOut ); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* DATA TYPES */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ struct SwapCallbackData { address tokenIn; uint amount; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice String ID of the adapter function ammAdapterId() external view returns (string memory); /// @notice Tokens of a pool supported by the adapter function poolTokens(address pool) external view returns (address[] memory); /// @notice Computes the maximum amount of liquidity received for given amounts of pool assets and the current /// pool price. /// This function signature can be used only for non-concentrated AMMs. /// @param pool Address of a pool supported by the adapter /// @param amounts Amounts of pool assets /// @return liquidity Liquidity out value /// @return amountsConsumed Amounts of consumed assets when providing liquidity function getLiquidityForAmounts( address pool, uint[] memory amounts ) external view returns (uint liquidity, uint[] memory amountsConsumed); /// @notice Priced proportions of pool assets /// @param pool Address of a pool supported by the adapter /// @return Proportions with 18 decimals precision. Max is 1e18, min is 0. function getProportions(address pool) external view returns (uint[] memory); /// @notice Current price in pool without amount impact /// @param pool Address of a pool supported by the adapter /// @param tokenIn Token for sell /// @param tokenOut Token for buy /// @param amount Amount of tokenIn. For zero value provided amount 1.0 (10 ** decimals of tokenIn) will be used. /// @return Amount of tokenOut with tokenOut decimals precision function getPrice(address pool, address tokenIn, address tokenOut, uint amount) external view returns (uint); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* WRITE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @notice Swap given tokenIn for tokenOut. Assume that tokenIn already sent to this contract. /// @param pool Address of a pool supported by the adapter /// @param tokenIn Token for sell /// @param tokenOut Token for buy /// @param recipient Recipient for tokenOut /// @param priceImpactTolerance Price impact tolerance. Must include fees at least. Denominator is 100_000. function swap( address pool, address tokenIn, address tokenOut, address recipient, uint priceImpactTolerance ) external; /// @dev Initializer for proxied adapter function init(address platform) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/SignedMath.sol) pragma solidity ^0.8.20; /** * @dev Standard signed math utilities missing in the Solidity language. */ library SignedMath { /** * @dev Returns the largest of two signed numbers. */ function max(int256 a, int256 b) internal pure returns (int256) { return a > b ? a : b; } /** * @dev Returns the smallest of two signed numbers. */ function min(int256 a, int256 b) internal pure returns (int256) { return a < b ? a : b; } /** * @dev Returns the average of two signed numbers without overflow. * The result is rounded towards zero. */ function average(int256 a, int256 b) internal pure returns (int256) { // Formula from the book "Hacker's Delight" int256 x = (a & b) + ((a ^ b) >> 1); return x + (int256(uint256(x) >> 255) & (a ^ b)); } /** * @dev Returns the absolute unsigned value of a signed value. */ function abs(int256 n) internal pure returns (uint256) { unchecked { // must be unchecked in order to support `n = type(int256).min` return uint256(n >= 0 ? n : -n); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol) pragma solidity ^0.8.20; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165 { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/IERC721.sol) pragma solidity ^0.8.20; import {IERC165} from "../../utils/introspection/IERC165.sol"; /** * @dev Required interface of an ERC721 compliant contract. */ interface IERC721 is IERC165 { /** * @dev Emitted when `tokenId` token is transferred from `from` to `to`. */ event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. */ event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets. */ event ApprovalForAll(address indexed owner, address indexed operator, bool approved); /** * @dev Returns the number of tokens in ``owner``'s account. */ function balanceOf(address owner) external view returns (uint256 balance); /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) external view returns (address owner); /** * @dev Safely transfers `tokenId` token from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon * a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external; /** * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients * are aware of the ERC721 protocol to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or * {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon * a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom(address from, address to, uint256 tokenId) external; /** * @dev Transfers `tokenId` token from `from` to `to`. * * WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721 * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must * understand this adds an external call which potentially creates a reentrancy vulnerability. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom(address from, address to, uint256 tokenId) external; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the address zero. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll} */ function isApprovedForAll(address owner, address operator) external view returns (bool); }
{ "remappings": [ "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/", "@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/", "@solady/=lib/solady/src/", "ds-test/=lib/forge-std/lib/ds-test/src/", "erc4626-tests/=lib/openzeppelin-contracts-upgradeable/lib/erc4626-tests/", "forge-std/=lib/forge-std/src/", "openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/", "openzeppelin/=lib/openzeppelin-contracts-upgradeable/contracts/", "solady/=lib/solady/", "openzeppelin-contracts/=lib/openzeppelin-contracts/" ], "optimizer": { "enabled": true, "runs": 200 }, "metadata": { "useLiteralContent": false, "bytecodeHash": "ipfs", "appendCBOR": true }, "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } }, "evmVersion": "shanghai", "viaIR": false, "libraries": { "src/core/libs/CommonLib.sol": { "CommonLib": "0x74f98426D3Aca169FE2A9BD0e2063768c4b3A102" }, "src/strategies/libs/SiloAdvancedLib.sol": { "SiloAdvancedLib": "0xd8D8A4dFC948D6fAAe0ccCEE0b0bC45c17eFBbB1" }, "src/strategies/libs/StrategyLib.sol": { "StrategyLib": "0x23bb12C39EB120cC055567557dd190DB388AF026" } } }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"address","name":"target","type":"address"}],"name":"AddressEmptyCode","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"AddressInsufficientBalance","type":"error"},{"inputs":[],"name":"FailedInnerCall","type":"error"},{"inputs":[],"name":"IncorrectMsgSender","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"SafeERC20FailedOperation","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"ltv","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"leverage","type":"uint256"}],"name":"LeverageLendingHealth","type":"event"},{"inputs":[],"name":"INTERNAL_PRECISION","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"address","name":"collateralAsset","type":"address"},{"internalType":"address","name":"borrowAsset","type":"address"},{"internalType":"address","name":"lendingVault","type":"address"},{"internalType":"address","name":"borrowingVault","type":"address"}],"internalType":"struct ILeverageLendingStrategy.LeverageLendingAddresses","name":"v","type":"tuple"}],"name":"calcTotal","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"lendingVault","type":"address"},{"internalType":"uint256","name":"targetLeveragePercent","type":"uint256"}],"name":"getLtvData","outputs":[{"internalType":"uint256","name":"maxLtv","type":"uint256"},{"internalType":"uint256","name":"maxLeverage","type":"uint256"},{"internalType":"uint256","name":"targetLeverage","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"lendVault","type":"address"},{"internalType":"address","name":"debtVault","type":"address"}],"name":"getPrices","outputs":[{"internalType":"uint256","name":"priceCtoB","type":"uint256"},{"internalType":"uint256","name":"priceBtoC","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"lendingVault","type":"address"}],"name":"totalCollateral","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"borrowingVault","type":"address"}],"name":"totalDebt","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"}]
Contract Creation Code
612514610035600b8282823980515f1a60731461002957634e487b7160e01b5f525f60045260245ffd5b305f52607381538281f3fe730000000000000000000000000000000000000000301460806040526004361061009b575f3560e01c80633cf7210d1161006e5780633cf7210d1461012f5780635bd923f5146101575780637e059b221461017f578063dd081d8b14610192578063f91afc87146101c0575f80fd5b80630dcd3d681461009f5780630f0b0594146100c057806312eef520146101055780631ff517ff1461011c575b5f80fd5b8180156100aa575f80fd5b506100be6100b9366004611f3f565b6101d3565b005b6100d36100ce366004611f8d565b610fa1565b604080519687526020870195909552938501929092526060840152608083015260a082015260c0015b60405180910390f35b61010e61271081565b6040519081526020016100fc565b61010e61012a366004611fb7565b61129a565b61014261013d366004611fd2565b611309565b604080519283526020830191909152016100fc565b61016a610165366004611f8d565b6117db565b604080519283529015156020830152016100fc565b61010e61018d366004611fb7565b611b1b565b6101a56101a0366004611f8d565b611bbd565b604080519384526020840192909252908201526060016100fc565b61010e6101ce36600461203f565b611ced565b835460048501546001600160a01b039182169116338114610207576040516370a8bfcd60e11b815260040160405180910390fd5b60016005870154600160a01b900460ff166004811115610229576102296120ce565b0361052157600686015460118701546040516371a1ff0960e11b81527323bb12c39eb120cc055567557dd190db388af0269163e343fe1291610276918c918b9189918c91906004016120e2565b602060405180830381865af4158015610291573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906102b59190612116565b5060028701546040516370a0823160e01b81523060048201526001600160a01b039182169163b7ec8d4b91908616906370a0823190602401602060405180830381865afa158015610308573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061032c9190612116565b3060016040518463ffffffff1660e01b815260040161034d9392919061214d565b6020604051808303815f875af1158015610369573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061038d9190612116565b506003870154604051633545906160e21b815260048101839052306024820181905260448201526001600160a01b039091169063d5164184906064016020604051808303815f875af11580156103e5573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906104099190612116565b50610429826104188688612184565b6001600160a01b0389169190611d52565b600387015460405163e3d670d760e01b81526001600160a01b0388811660048301529091169063acb70815907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af415801561048f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906104b39190612116565b6040516001600160e01b031960e084901b16815260048101919091523060248201526044016020604051808303815f875af11580156104f4573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906105189190612116565b50505f60068701555b60026005870154600160a01b900460ff166004811115610543576105436120ce565b0361087d5760078601546011870154600388015460405163acb7081560e01b8152600481018890523060248201526001600160a01b039091169063acb70815906044016020604051808303815f875af11580156105a2573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906105c69190612116565b5060028801546001600160a01b03165f6105df82611b1b565b90506105ed6103e882612197565b6105f790826121b6565b9050816001600160a01b031663b8337c2a6106128684611da9565b303060016040518563ffffffff1660e01b815260040161063594939291906121c9565b6020604051808303815f875af1158015610651573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906106759190612116565b505060405163e3d670d760e01b81526001600160a01b03861660048201527323bb12c39eb120cc055567557dd190db388af026915063e343fe12908b9087908b9061070b908890879063e3d670d790602401602060405180830381865af41580156106e2573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906107069190612116565b611da9565b866040518663ffffffff1660e01b815260040161072c9594939291906120e2565b602060405180830381865af4158015610747573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061076b9190612116565b5061078b8361077a8789612184565b6001600160a01b038a169190611d52565b60405163e3d670d760e01b81526001600160a01b03881660048201527323bb12c39eb120cc055567557dd190db388af0269063e343fe12908b908a908890859063e3d670d790602401602060405180830381865af41580156107ef573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906108139190612116565b866040518663ffffffff1660e01b81526004016108349594939291906120e2565b602060405180830381865af415801561084f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906108739190612116565b50505f6007880155505b60036005870154600160a01b900460ff16600481111561089f5761089f6120ce565b03610ba0576002860154600387015460405163e3d670d760e01b81526001600160a01b038881166004830152928316929091169063acb70815907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015610913573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906109379190612116565b6040516001600160e01b031960e084901b16815260048101919091523060248201526044016020604051808303815f875af1158015610978573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061099c9190612116565b506007870154604051635c19be1560e11b81526001600160a01b0383169163b8337c2a916109d49190309081906001906004016121c9565b6020604051808303815f875af11580156109f0573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a149190612116565b50600787015460128801546040516371a1ff0960e11b81527323bb12c39eb120cc055567557dd190db388af0269263e343fe1292610a5a928d9289928d926004016120e2565b602060405180830381865af4158015610a75573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a999190612116565b50610aa8826104188688612184565b600387015460405163e3d670d760e01b81526001600160a01b0388811660048301529091169063acb70815907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015610b0e573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b329190612116565b6040516001600160e01b031960e084901b16815260048101919091523060248201526044016020604051808303815f875af1158015610b73573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b979190612116565b50505f60078701555b60046005870154600160a01b900460ff166004811115610bc257610bc26120ce565b03610f30576006860154600e8701546040516370a0823160e01b81523060048201527323bb12c39eb120cc055567557dd190db388af0269163e343fe12918b918a918891612710916001600160a01b038516906370a0823190602401602060405180830381865afa158015610c39573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610c5d9190612116565b610c6791906121fd565b610c719190612197565b8c601201546040518663ffffffff1660e01b8152600401610c969594939291906120e2565b602060405180830381865af4158015610cb1573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610cd59190612116565b5060028701546040516370a0823160e01b81523060048201526001600160a01b039182169163b7ec8d4b91908616906370a0823190602401602060405180830381865afa158015610d28573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610d4c9190612116565b3060016040518463ffffffff1660e01b8152600401610d6d9392919061214d565b6020604051808303815f875af1158015610d89573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610dad9190612116565b506003870154604051633545906160e21b815260048101839052306024820181905260448201526001600160a01b039091169063d5164184906064016020604051808303815f875af1158015610e05573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610e299190612116565b50610e38826104188688612184565b600387015460405163e3d670d760e01b81526001600160a01b0388811660048301529091169063acb70815907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015610e9e573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610ec29190612116565b6040516001600160e01b031960e084901b16815260048101919091523060248201526044016020604051808303815f875af1158015610f03573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610f279190612116565b50505f60068701555b5f80610f3c8989610fa1565b50505092505091507fb83dc6ff11ec1f33d17651f75f3998b69e170ade8f9072b116beaa5e6d037e1e8282604051610f7e929190918252602082015260400190565b60405180910390a150505050600593909301805460ff60a01b1916905550505050565b60028101548154600583015460405163f5125d3f60e01b81526001600160a01b03938416600482018190523060248301525f94859485948594859485949093811692169063f5125d3f90604401602060405180830381865afa158015611009573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061102d9190612116565b9750670de0b6b3a76400006110446127108a6121fd565b61104e9190612197565b975061105982611b1b565b60405163e3d670d760e01b81526001600160a01b03831660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af41580156110af573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906110d39190612116565b6110dd9190612184565b60038a01549095506110f7906001600160a01b031661129a565b93505f8a6001600160a01b03166349b5fdb46040518163ffffffff1660e01b8152600401602060405180830381865afa158015611136573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061115a9190612224565b90505f6111678c8c6117db565b506040516341976e0960e01b81526001600160a01b0385811660048301529192505f918416906341976e09906024016040805180830381865afa1580156111b0573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906111d4919061224e565b5090505f846001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611214573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906112389190612278565b61124390600a612378565b61124d838b6121fd565b6112579190612197565b905082611266612710836121fd565b6112709190612197565b99508c6008015496506112838688611bbd565b905050809b50505050505050509295509295509295565b604051635f30114960e01b81523060048201525f906001600160a01b03831690635f301149906024015b602060405180830381865afa1580156112df573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906113039190612116565b92915050565b5f805f846001600160a01b03166379502c556040518163ffffffff1660e01b8152600401602060405180830381865afa158015611348573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061136c9190612224565b60405163e48a5f7b60e01b81526001600160a01b0387811660048301529192505f9183169063e48a5f7b9060240161022060405180830381865afa1580156113b6573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906113da9190612386565b60e081015160405163e48a5f7b60e01b81526001600160a01b03888116600483015292935090915f919085169063e48a5f7b9060240161022060405180830381865afa15801561142c573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906114509190612386565b60e08101519091506001600160a01b0383161580159061147757506001600160a01b038116155b1561158d57826001600160a01b03166313b0be3385606001516001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa1580156114cb573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906114ef9190612278565b6114fa90600a612378565b60608701516040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401602060405180830381865afa158015611547573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061156b9190612116565b9650611586876ec097ce7bc90715b34b9f1000000000612197565b95506117cf565b6001600160a01b0383161580156115ac57506001600160a01b03811615155b156116c257806001600160a01b03166313b0be3383606001516001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611600573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906116249190612278565b61162f90600a612378565b60608501516040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401602060405180830381865afa15801561167c573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906116a09190612116565b95506116bb866ec097ce7bc90715b34b9f1000000000612197565b96506117cf565b826001600160a01b03166313b0be3385606001516001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611711573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117359190612278565b61174090600a612378565b60608701516040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401602060405180830381865afa15801561178d573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117b19190612116565b96506117cc876ec097ce7bc90715b34b9f1000000000612197565b95505b50505050509250929050565b5f805f846001600160a01b03166349b5fdb46040518163ffffffff1660e01b8152600401602060405180830381865afa15801561181a573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061183e9190612224565b6002850154855460018701549293506001600160a01b039182169290821691165f61186884611b1b565b60405163e3d670d760e01b81526001600160a01b03851660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af41580156118be573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118e29190612116565b6118ec9190612184565b6040516341976e0960e01b81526001600160a01b0385811660048301529192505f918291908816906341976e09906024016040805180830381865afa158015611937573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061195b919061224e565b915091505f856001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa15801561199c573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906119c09190612278565b6119cb90600a612378565b6119d584866121fd565b6119df9190612197565b60038c01549091505f906119fb906001600160a01b031661129a565b6040516341976e0960e01b81526001600160a01b0388811660048301529192505f918291908c16906341976e09906024016040805180830381865afa158015611a46573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611a6a919061224e565b915091505f886001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611aab573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611acf9190612278565b611ada90600a612378565b611ae484866121fd565b611aee9190612197565b9050611afa81866121b6565b9d50858015611b065750815b9c505050505050505050505050509250929050565b60405163e3d670d760e01b81526001600160a01b038216600482018190525f916307a2d13a907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015611b7b573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611b9f9190612116565b6040518263ffffffff1660e01b81526004016112c491815260200190565b5f805f80856001600160a01b03166379502c556040518163ffffffff1660e01b8152600401602060405180830381865afa158015611bfd573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611c219190612224565b60405163e48a5f7b60e01b81526001600160a01b0388811660048301529192505f9183169063e48a5f7b9060240161022060405180830381865afa158015611c6b573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611c8f9190612386565b61014081015195509050611cab85670de0b6b3a76400006121b6565b611cbf612710670de0b6b3a76400006121fd565b611cc99190612197565b9350612710611cd887866121fd565b611ce29190612197565b925050509250925092565b5f80611d0183604001518460600151611309565b9150505f670de0b6b3a764000082611d1c866060015161129a565b611d2691906121fd565b611d309190612197565b905080611d408560400151611b1b565b611d4a91906121b6565b949350505050565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663a9059cbb60e01b179052611da4908490611dc0565b505050565b5f818310611db75781611db9565b825b9392505050565b5f611dd46001600160a01b03841683611e26565b905080515f14158015611df8575080806020019051810190611df69190612499565b155b15611da457604051635274afe760e01b81526001600160a01b03841660048201526024015b60405180910390fd5b6060611db983835f845f80856001600160a01b03168486604051611e4a91906124b2565b5f6040518083038185875af1925050503d805f8114611e84576040519150601f19603f3d011682016040523d82523d5f602084013e611e89565b606091505b5091509150611e99868383611ea3565b9695505050505050565b606082611eb857611eb382611eff565b611db9565b8151158015611ecf57506001600160a01b0384163b155b15611ef857604051639996b31560e01b81526001600160a01b0385166004820152602401611e1d565b5080611db9565b805115611f0f5780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b50565b6001600160a01b0381168114611f28575f80fd5b5f805f805f60a08688031215611f53575f80fd5b8535611f5e81611f2b565b9450602086013593506040860135611f7581611f2b565b94979396509394606081013594506080013592915050565b5f8060408385031215611f9e575f80fd5b8235611fa981611f2b565b946020939093013593505050565b5f60208284031215611fc7575f80fd5b8135611db981611f2b565b5f8060408385031215611fe3575f80fd5b8235611fee81611f2b565b91506020830135611ffe81611f2b565b809150509250929050565b604051610220810167ffffffffffffffff8111828210171561203957634e487b7160e01b5f52604160045260245ffd5b60405290565b5f6080828403121561204f575f80fd5b6040516080810181811067ffffffffffffffff8211171561207e57634e487b7160e01b5f52604160045260245ffd5b604052823561208c81611f2b565b8152602083013561209c81611f2b565b602082015260408301356120af81611f2b565b604082015260608301356120c281611f2b565b60608201529392505050565b634e487b7160e01b5f52602160045260245ffd5b6001600160a01b03958616815293851660208501529190931660408301526060820192909252608081019190915260a00190565b5f60208284031215612126575f80fd5b5051919050565b6002811061214957634e487b7160e01b5f52602160045260245ffd5b9052565b8381526001600160a01b038316602082015260608101611d4a604083018461212d565b634e487b7160e01b5f52601160045260245ffd5b8082018082111561130357611303612170565b5f826121b157634e487b7160e01b5f52601260045260245ffd5b500490565b8181038181111561130357611303612170565b8481526001600160a01b03848116602083015283166040820152608081016121f4606083018461212d565b95945050505050565b808202811582820484141761130357611303612170565b805161221f81611f2b565b919050565b5f60208284031215612234575f80fd5b8151611db981611f2b565b8051801515811461221f575f80fd5b5f806040838503121561225f575f80fd5b8251915061226f6020840161223f565b90509250929050565b5f60208284031215612288575f80fd5b815160ff81168114611db9575f80fd5b600181815b808511156122d257815f19048211156122b8576122b8612170565b808516156122c557918102915b93841c939080029061229d565b509250929050565b5f826122e857506001611303565b816122f457505f611303565b816001811461230a576002811461231457612330565b6001915050611303565b60ff84111561232557612325612170565b50506001821b611303565b5060208310610133831016604e8410600b8410161715612353575081810a611303565b61235d8383612298565b805f190482111561237057612370612170565b029392505050565b5f611db960ff8416836122da565b5f6102208284031215612397575f80fd5b61239f612009565b82518152602083015160208201526123b960408401612214565b60408201526123ca60608401612214565b60608201526123db60808401612214565b60808201526123ec60a08401612214565b60a08201526123fd60c08401612214565b60c082015261240e60e08401612214565b60e0820152610100612421818501612214565b90820152610120612433848201612214565b908201526101408381015190820152610160808401519082015261018080840151908201526101a080840151908201526101c080840151908201526101e061247c818501612214565b9082015261020061248e84820161223f565b908201529392505050565b5f602082840312156124a9575f80fd5b611db98261223f565b5f82515f5b818110156124d157602081860181015185830152016124b7565b505f92019182525091905056fea2646970667358221220ef167c7be66c48bbe7f3ee8a58eaf06fd1f00a57b09804e2411d465e32c5834a64736f6c63430008170033
Deployed Bytecode
0x73d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1301460806040526004361061009b575f3560e01c80633cf7210d1161006e5780633cf7210d1461012f5780635bd923f5146101575780637e059b221461017f578063dd081d8b14610192578063f91afc87146101c0575f80fd5b80630dcd3d681461009f5780630f0b0594146100c057806312eef520146101055780631ff517ff1461011c575b5f80fd5b8180156100aa575f80fd5b506100be6100b9366004611f3f565b6101d3565b005b6100d36100ce366004611f8d565b610fa1565b604080519687526020870195909552938501929092526060840152608083015260a082015260c0015b60405180910390f35b61010e61271081565b6040519081526020016100fc565b61010e61012a366004611fb7565b61129a565b61014261013d366004611fd2565b611309565b604080519283526020830191909152016100fc565b61016a610165366004611f8d565b6117db565b604080519283529015156020830152016100fc565b61010e61018d366004611fb7565b611b1b565b6101a56101a0366004611f8d565b611bbd565b604080519384526020840192909252908201526060016100fc565b61010e6101ce36600461203f565b611ced565b835460048501546001600160a01b039182169116338114610207576040516370a8bfcd60e11b815260040160405180910390fd5b60016005870154600160a01b900460ff166004811115610229576102296120ce565b0361052157600686015460118701546040516371a1ff0960e11b81527323bb12c39eb120cc055567557dd190db388af0269163e343fe1291610276918c918b9189918c91906004016120e2565b602060405180830381865af4158015610291573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906102b59190612116565b5060028701546040516370a0823160e01b81523060048201526001600160a01b039182169163b7ec8d4b91908616906370a0823190602401602060405180830381865afa158015610308573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061032c9190612116565b3060016040518463ffffffff1660e01b815260040161034d9392919061214d565b6020604051808303815f875af1158015610369573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061038d9190612116565b506003870154604051633545906160e21b815260048101839052306024820181905260448201526001600160a01b039091169063d5164184906064016020604051808303815f875af11580156103e5573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906104099190612116565b50610429826104188688612184565b6001600160a01b0389169190611d52565b600387015460405163e3d670d760e01b81526001600160a01b0388811660048301529091169063acb70815907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af415801561048f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906104b39190612116565b6040516001600160e01b031960e084901b16815260048101919091523060248201526044016020604051808303815f875af11580156104f4573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906105189190612116565b50505f60068701555b60026005870154600160a01b900460ff166004811115610543576105436120ce565b0361087d5760078601546011870154600388015460405163acb7081560e01b8152600481018890523060248201526001600160a01b039091169063acb70815906044016020604051808303815f875af11580156105a2573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906105c69190612116565b5060028801546001600160a01b03165f6105df82611b1b565b90506105ed6103e882612197565b6105f790826121b6565b9050816001600160a01b031663b8337c2a6106128684611da9565b303060016040518563ffffffff1660e01b815260040161063594939291906121c9565b6020604051808303815f875af1158015610651573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906106759190612116565b505060405163e3d670d760e01b81526001600160a01b03861660048201527323bb12c39eb120cc055567557dd190db388af026915063e343fe12908b9087908b9061070b908890879063e3d670d790602401602060405180830381865af41580156106e2573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906107069190612116565b611da9565b866040518663ffffffff1660e01b815260040161072c9594939291906120e2565b602060405180830381865af4158015610747573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061076b9190612116565b5061078b8361077a8789612184565b6001600160a01b038a169190611d52565b60405163e3d670d760e01b81526001600160a01b03881660048201527323bb12c39eb120cc055567557dd190db388af0269063e343fe12908b908a908890859063e3d670d790602401602060405180830381865af41580156107ef573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906108139190612116565b866040518663ffffffff1660e01b81526004016108349594939291906120e2565b602060405180830381865af415801561084f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906108739190612116565b50505f6007880155505b60036005870154600160a01b900460ff16600481111561089f5761089f6120ce565b03610ba0576002860154600387015460405163e3d670d760e01b81526001600160a01b038881166004830152928316929091169063acb70815907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015610913573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906109379190612116565b6040516001600160e01b031960e084901b16815260048101919091523060248201526044016020604051808303815f875af1158015610978573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061099c9190612116565b506007870154604051635c19be1560e11b81526001600160a01b0383169163b8337c2a916109d49190309081906001906004016121c9565b6020604051808303815f875af11580156109f0573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a149190612116565b50600787015460128801546040516371a1ff0960e11b81527323bb12c39eb120cc055567557dd190db388af0269263e343fe1292610a5a928d9289928d926004016120e2565b602060405180830381865af4158015610a75573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a999190612116565b50610aa8826104188688612184565b600387015460405163e3d670d760e01b81526001600160a01b0388811660048301529091169063acb70815907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015610b0e573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b329190612116565b6040516001600160e01b031960e084901b16815260048101919091523060248201526044016020604051808303815f875af1158015610b73573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b979190612116565b50505f60078701555b60046005870154600160a01b900460ff166004811115610bc257610bc26120ce565b03610f30576006860154600e8701546040516370a0823160e01b81523060048201527323bb12c39eb120cc055567557dd190db388af0269163e343fe12918b918a918891612710916001600160a01b038516906370a0823190602401602060405180830381865afa158015610c39573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610c5d9190612116565b610c6791906121fd565b610c719190612197565b8c601201546040518663ffffffff1660e01b8152600401610c969594939291906120e2565b602060405180830381865af4158015610cb1573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610cd59190612116565b5060028701546040516370a0823160e01b81523060048201526001600160a01b039182169163b7ec8d4b91908616906370a0823190602401602060405180830381865afa158015610d28573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610d4c9190612116565b3060016040518463ffffffff1660e01b8152600401610d6d9392919061214d565b6020604051808303815f875af1158015610d89573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610dad9190612116565b506003870154604051633545906160e21b815260048101839052306024820181905260448201526001600160a01b039091169063d5164184906064016020604051808303815f875af1158015610e05573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610e299190612116565b50610e38826104188688612184565b600387015460405163e3d670d760e01b81526001600160a01b0388811660048301529091169063acb70815907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015610e9e573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610ec29190612116565b6040516001600160e01b031960e084901b16815260048101919091523060248201526044016020604051808303815f875af1158015610f03573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610f279190612116565b50505f60068701555b5f80610f3c8989610fa1565b50505092505091507fb83dc6ff11ec1f33d17651f75f3998b69e170ade8f9072b116beaa5e6d037e1e8282604051610f7e929190918252602082015260400190565b60405180910390a150505050600593909301805460ff60a01b1916905550505050565b60028101548154600583015460405163f5125d3f60e01b81526001600160a01b03938416600482018190523060248301525f94859485948594859485949093811692169063f5125d3f90604401602060405180830381865afa158015611009573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061102d9190612116565b9750670de0b6b3a76400006110446127108a6121fd565b61104e9190612197565b975061105982611b1b565b60405163e3d670d760e01b81526001600160a01b03831660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af41580156110af573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906110d39190612116565b6110dd9190612184565b60038a01549095506110f7906001600160a01b031661129a565b93505f8a6001600160a01b03166349b5fdb46040518163ffffffff1660e01b8152600401602060405180830381865afa158015611136573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061115a9190612224565b90505f6111678c8c6117db565b506040516341976e0960e01b81526001600160a01b0385811660048301529192505f918416906341976e09906024016040805180830381865afa1580156111b0573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906111d4919061224e565b5090505f846001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611214573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906112389190612278565b61124390600a612378565b61124d838b6121fd565b6112579190612197565b905082611266612710836121fd565b6112709190612197565b99508c6008015496506112838688611bbd565b905050809b50505050505050509295509295509295565b604051635f30114960e01b81523060048201525f906001600160a01b03831690635f301149906024015b602060405180830381865afa1580156112df573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906113039190612116565b92915050565b5f805f846001600160a01b03166379502c556040518163ffffffff1660e01b8152600401602060405180830381865afa158015611348573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061136c9190612224565b60405163e48a5f7b60e01b81526001600160a01b0387811660048301529192505f9183169063e48a5f7b9060240161022060405180830381865afa1580156113b6573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906113da9190612386565b60e081015160405163e48a5f7b60e01b81526001600160a01b03888116600483015292935090915f919085169063e48a5f7b9060240161022060405180830381865afa15801561142c573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906114509190612386565b60e08101519091506001600160a01b0383161580159061147757506001600160a01b038116155b1561158d57826001600160a01b03166313b0be3385606001516001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa1580156114cb573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906114ef9190612278565b6114fa90600a612378565b60608701516040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401602060405180830381865afa158015611547573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061156b9190612116565b9650611586876ec097ce7bc90715b34b9f1000000000612197565b95506117cf565b6001600160a01b0383161580156115ac57506001600160a01b03811615155b156116c257806001600160a01b03166313b0be3383606001516001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611600573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906116249190612278565b61162f90600a612378565b60608501516040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401602060405180830381865afa15801561167c573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906116a09190612116565b95506116bb866ec097ce7bc90715b34b9f1000000000612197565b96506117cf565b826001600160a01b03166313b0be3385606001516001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611711573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117359190612278565b61174090600a612378565b60608701516040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401602060405180830381865afa15801561178d573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117b19190612116565b96506117cc876ec097ce7bc90715b34b9f1000000000612197565b95505b50505050509250929050565b5f805f846001600160a01b03166349b5fdb46040518163ffffffff1660e01b8152600401602060405180830381865afa15801561181a573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061183e9190612224565b6002850154855460018701549293506001600160a01b039182169290821691165f61186884611b1b565b60405163e3d670d760e01b81526001600160a01b03851660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af41580156118be573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118e29190612116565b6118ec9190612184565b6040516341976e0960e01b81526001600160a01b0385811660048301529192505f918291908816906341976e09906024016040805180830381865afa158015611937573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061195b919061224e565b915091505f856001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa15801561199c573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906119c09190612278565b6119cb90600a612378565b6119d584866121fd565b6119df9190612197565b60038c01549091505f906119fb906001600160a01b031661129a565b6040516341976e0960e01b81526001600160a01b0388811660048301529192505f918291908c16906341976e09906024016040805180830381865afa158015611a46573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611a6a919061224e565b915091505f886001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611aab573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611acf9190612278565b611ada90600a612378565b611ae484866121fd565b611aee9190612197565b9050611afa81866121b6565b9d50858015611b065750815b9c505050505050505050505050509250929050565b60405163e3d670d760e01b81526001600160a01b038216600482018190525f916307a2d13a907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015611b7b573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611b9f9190612116565b6040518263ffffffff1660e01b81526004016112c491815260200190565b5f805f80856001600160a01b03166379502c556040518163ffffffff1660e01b8152600401602060405180830381865afa158015611bfd573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611c219190612224565b60405163e48a5f7b60e01b81526001600160a01b0388811660048301529192505f9183169063e48a5f7b9060240161022060405180830381865afa158015611c6b573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611c8f9190612386565b61014081015195509050611cab85670de0b6b3a76400006121b6565b611cbf612710670de0b6b3a76400006121fd565b611cc99190612197565b9350612710611cd887866121fd565b611ce29190612197565b925050509250925092565b5f80611d0183604001518460600151611309565b9150505f670de0b6b3a764000082611d1c866060015161129a565b611d2691906121fd565b611d309190612197565b905080611d408560400151611b1b565b611d4a91906121b6565b949350505050565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663a9059cbb60e01b179052611da4908490611dc0565b505050565b5f818310611db75781611db9565b825b9392505050565b5f611dd46001600160a01b03841683611e26565b905080515f14158015611df8575080806020019051810190611df69190612499565b155b15611da457604051635274afe760e01b81526001600160a01b03841660048201526024015b60405180910390fd5b6060611db983835f845f80856001600160a01b03168486604051611e4a91906124b2565b5f6040518083038185875af1925050503d805f8114611e84576040519150601f19603f3d011682016040523d82523d5f602084013e611e89565b606091505b5091509150611e99868383611ea3565b9695505050505050565b606082611eb857611eb382611eff565b611db9565b8151158015611ecf57506001600160a01b0384163b155b15611ef857604051639996b31560e01b81526001600160a01b0385166004820152602401611e1d565b5080611db9565b805115611f0f5780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b50565b6001600160a01b0381168114611f28575f80fd5b5f805f805f60a08688031215611f53575f80fd5b8535611f5e81611f2b565b9450602086013593506040860135611f7581611f2b565b94979396509394606081013594506080013592915050565b5f8060408385031215611f9e575f80fd5b8235611fa981611f2b565b946020939093013593505050565b5f60208284031215611fc7575f80fd5b8135611db981611f2b565b5f8060408385031215611fe3575f80fd5b8235611fee81611f2b565b91506020830135611ffe81611f2b565b809150509250929050565b604051610220810167ffffffffffffffff8111828210171561203957634e487b7160e01b5f52604160045260245ffd5b60405290565b5f6080828403121561204f575f80fd5b6040516080810181811067ffffffffffffffff8211171561207e57634e487b7160e01b5f52604160045260245ffd5b604052823561208c81611f2b565b8152602083013561209c81611f2b565b602082015260408301356120af81611f2b565b604082015260608301356120c281611f2b565b60608201529392505050565b634e487b7160e01b5f52602160045260245ffd5b6001600160a01b03958616815293851660208501529190931660408301526060820192909252608081019190915260a00190565b5f60208284031215612126575f80fd5b5051919050565b6002811061214957634e487b7160e01b5f52602160045260245ffd5b9052565b8381526001600160a01b038316602082015260608101611d4a604083018461212d565b634e487b7160e01b5f52601160045260245ffd5b8082018082111561130357611303612170565b5f826121b157634e487b7160e01b5f52601260045260245ffd5b500490565b8181038181111561130357611303612170565b8481526001600160a01b03848116602083015283166040820152608081016121f4606083018461212d565b95945050505050565b808202811582820484141761130357611303612170565b805161221f81611f2b565b919050565b5f60208284031215612234575f80fd5b8151611db981611f2b565b8051801515811461221f575f80fd5b5f806040838503121561225f575f80fd5b8251915061226f6020840161223f565b90509250929050565b5f60208284031215612288575f80fd5b815160ff81168114611db9575f80fd5b600181815b808511156122d257815f19048211156122b8576122b8612170565b808516156122c557918102915b93841c939080029061229d565b509250929050565b5f826122e857506001611303565b816122f457505f611303565b816001811461230a576002811461231457612330565b6001915050611303565b60ff84111561232557612325612170565b50506001821b611303565b5060208310610133831016604e8410600b8410161715612353575081810a611303565b61235d8383612298565b805f190482111561237057612370612170565b029392505050565b5f611db960ff8416836122da565b5f6102208284031215612397575f80fd5b61239f612009565b82518152602083015160208201526123b960408401612214565b60408201526123ca60608401612214565b60608201526123db60808401612214565b60808201526123ec60a08401612214565b60a08201526123fd60c08401612214565b60c082015261240e60e08401612214565b60e0820152610100612421818501612214565b90820152610120612433848201612214565b908201526101408381015190820152610160808401519082015261018080840151908201526101a080840151908201526101c080840151908201526101e061247c818501612214565b9082015261020061248e84820161223f565b908201529392505050565b5f602082840312156124a9575f80fd5b611db98261223f565b5f82515f5b818110156124d157602081860181015185830152016124b7565b505f92019182525091905056fea2646970667358221220ef167c7be66c48bbe7f3ee8a58eaf06fd1f00a57b09804e2411d465e32c5834a64736f6c63430008170033
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 31 Chains
Chain | Token | Portfolio % | Price | Amount | Value |
---|
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.