Overview
S Balance
S Value
$0.00More Info
Private Name Tags
ContractCreator
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:
SiloAdvancedLeverageStrategy
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 {CommonLib} from "../core/libs/CommonLib.sol"; import {ConstantsLib} from "../core/libs/ConstantsLib.sol"; import {StrategyBase} from "./base/StrategyBase.sol"; import {LeverageLendingBase} from "./base/LeverageLendingBase.sol"; import {StrategyIdLib} from "./libs/StrategyIdLib.sol"; import {StrategyLib} from "./libs/StrategyLib.sol"; import {SiloAdvancedLib} from "./libs/SiloAdvancedLib.sol"; import {IStrategy} from "../interfaces/IStrategy.sol"; import {IControllable} from "../interfaces/IControllable.sol"; import {IFactory} from "../interfaces/IFactory.sol"; import {IPlatform} from "../interfaces/IPlatform.sol"; import {ILeverageLendingStrategy} from "../interfaces/ILeverageLendingStrategy.sol"; import {ISilo} from "../integrations/silo/ISilo.sol"; import {ISiloConfig} from "../integrations/silo/ISiloConfig.sol"; import {ISiloLens} from "../integrations/silo/ISiloLens.sol"; import {IFlashLoanRecipient} from "../integrations/balancer/IFlashLoanRecipient.sol"; import {IBVault} from "../integrations/balancer/IBVault.sol"; /// @title Silo V2 advanced leverage strategy /// Changelog: /// 1.0.1: initVariants bugfix /// @author Alien Deployer (https://github.com/a17) contract SiloAdvancedLeverageStrategy is LeverageLendingBase, IFlashLoanRecipient { using SafeERC20 for IERC20; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CONSTANTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc IControllable string public constant VERSION = "1.0.1"; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* INITIALIZATION */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc IStrategy function initialize(address[] memory addresses, uint[] memory nums, int24[] memory ticks) public initializer { if (addresses.length != 6 || nums.length != 1 || ticks.length != 0) { revert IControllable.IncorrectInitParams(); } LeverageLendingStrategyBaseInitParams memory params; params.platform = addresses[0]; params.vault = addresses[1]; params.collateralAsset = IERC4626(addresses[2]).asset(); params.borrowAsset = IERC4626(addresses[3]).asset(); params.lendingVault = addresses[2]; params.borrowingVault = addresses[3]; params.flashLoanVault = addresses[4]; params.helper = addresses[5]; params.targetLeveragePercent = nums[0]; __LeverageLendingBase_init(params); IERC20(params.collateralAsset).forceApprove(params.lendingVault, type(uint).max); IERC20(params.borrowAsset).forceApprove(params.borrowingVault, type(uint).max); address swapper = IPlatform(params.platform).swapper(); IERC20(params.collateralAsset).forceApprove(swapper, type(uint).max); IERC20(params.borrowAsset).forceApprove(swapper, type(uint).max); LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); // Multiplier of flash amount for borrow on deposit. Default is 100_30 == 100.3%. $.depositParam0 = 100_30; // Multiplier of debt diff $.increaseLtvParam0 = 100_80; // Multiplier of swap borrow asset to collateral in flash loan callback $.increaseLtvParam1 = 99_00; // Multiplier of collateral diff $.decreaseLtvParam0 = 101_00; // Swap price impact tolerance $.swapPriceImpactTolerance0 = 1_000; $.swapPriceImpactTolerance1 = 1_000; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CALLBACKS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc IFlashLoanRecipient function receiveFlashLoan( address[] memory tokens, uint[] memory amounts, uint[] memory feeAmounts, bytes memory /*userData*/ ) external { // Flash loan is performed upon deposit and withdrawal LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); SiloAdvancedLib.receiveFlashLoan(platform(), $, tokens[0], amounts[0], feeAmounts[0]); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc IStrategy function isHardWorkOnDepositAllowed() external pure returns (bool) { return true; } /// @inheritdoc IStrategy function strategyLogicId() public pure override returns (string memory) { return StrategyIdLib.SILO_ADVANCED_LEVERAGE; } /// @inheritdoc IStrategy function initVariants(address platform_) public view returns (string[] memory variants, address[] memory addresses, uint[] memory nums, int24[] memory ticks) { IFactory.StrategyAvailableInitParams memory params = IFactory(IPlatform(platform_).factory()).strategyAvailableInitParams(keccak256(bytes(strategyLogicId()))); uint len = params.initAddresses.length / 4; variants = new string[](len); addresses = new address[](len * 4); nums = new uint[](len); ticks = new int24[](0); for (uint i; i < len; ++i) { address collateralAsset = IERC4626(params.initAddresses[i * 2]).asset(); address borrowAsset = IERC4626(params.initAddresses[i * 2 + 1]).asset(); variants[i] = _generateDescription(params.initAddresses[i * 2], collateralAsset, borrowAsset); addresses[i * 2] = params.initAddresses[i * 2]; addresses[i * 2 + 1] = params.initAddresses[i * 2 + 1]; addresses[i * 2 + 2] = params.initAddresses[i * 2 + 2]; addresses[i * 2 + 3] = params.initAddresses[i * 2 + 3]; nums[i] = params.initNums[i]; } } /// @inheritdoc IStrategy function description() external view returns (string memory) { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); return _generateDescription($.lendingVault, $.collateralAsset, $.borrowAsset); } /// @inheritdoc IStrategy function getSpecificName() external view override returns (string memory, bool) { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); address lendingVault = $.lendingVault; uint siloId = ISiloConfig(ISilo(lendingVault).config()).SILO_ID(); string memory borrowAssetSymbol = IERC20Metadata($.borrowAsset).symbol(); (,, uint targetLeverage) = SiloAdvancedLib.getLtvData(lendingVault, $.targetLeveragePercent); return ( string.concat(CommonLib.u2s(siloId), " ", borrowAssetSymbol, " ", _formatLeverageShort(targetLeverage)), false ); } /// @inheritdoc ILeverageLendingStrategy function realTvl() public view returns (uint tvl, bool trusted) { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); return SiloAdvancedLib.realTvl(platform(), $); } /// @inheritdoc ILeverageLendingStrategy function realSharePrice() public view returns (uint sharePrice, bool trusted) { uint _realTvl; (_realTvl, trusted) = realTvl(); uint totalSupply = IERC20(vault()).totalSupply(); if (totalSupply != 0) { sharePrice = _realTvl * 1e18 / totalSupply; } } /// @inheritdoc ILeverageLendingStrategy function health() public view returns ( uint ltv, uint maxLtv, uint leverage, uint collateralAmount, uint debtAmount, uint targetLeveragePercent ) { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); return SiloAdvancedLib.health(platform(), $); } /// @inheritdoc ILeverageLendingStrategy function getSupplyAndBorrowAprs() external view returns (uint supplyApr, uint borrowApr) { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); return _getDepositAndBorrowAprs($.helper, $.lendingVault, $.borrowingVault); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* LEVERAGE LENDING BASE */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ function _rebalanceDebt(uint newLtv) internal override returns (uint resultLtv) { (uint ltv,,, uint collateralAmount, uint debtAmount,) = health(); LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); LeverageLendingAddresses memory v = LeverageLendingAddresses({ collateralAsset: $.collateralAsset, borrowAsset: $.borrowAsset, lendingVault: $.lendingVault, borrowingVault: $.borrowingVault }); uint tvlPricedInCollateralAsset = SiloAdvancedLib.calcTotal(v); // here is the math that works: // collateral_value - debt_value = real_TVL // debt_value * PRECISION / collateral_value = LTV // --- // collateral_value = real_TVL * PRECISION / (PRECISION - LTV) uint newCollateralValue = tvlPricedInCollateralAsset * INTERNAL_PRECISION / (INTERNAL_PRECISION - newLtv); (uint priceCtoB,) = SiloAdvancedLib.getPrices(v.lendingVault, v.borrowingVault); uint newDebtAmount = newCollateralValue * newLtv / INTERNAL_PRECISION * priceCtoB / 1e18; address[] memory flashAssets = new address[](1); flashAssets[0] = v.borrowAsset; uint[] memory flashAmounts = new uint[](1); if (newLtv < ltv) { // need decrease debt and collateral $.tempAction = CurrentAction.DecreaseLtv; uint debtDiff = debtAmount - newDebtAmount; flashAmounts[0] = debtDiff; $.tempCollateralAmount = (collateralAmount - newCollateralValue) * $.decreaseLtvParam0 / INTERNAL_PRECISION; } else { // need increase debt and collateral $.tempAction = CurrentAction.IncreaseLtv; uint debtDiff = newDebtAmount - debtAmount; $.tempBorrowAmount = debtDiff; flashAmounts[0] = debtDiff * $.increaseLtvParam0 / INTERNAL_PRECISION; } IBVault($.flashLoanVault).flashLoan(address(this), flashAssets, flashAmounts, ""); $.tempAction = CurrentAction.None; (resultLtv,,,,,) = health(); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* STRATEGY BASE */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc StrategyBase function _assetsAmounts() internal view override returns (address[] memory assets_, uint[] memory amounts_) { assets_ = assets(); amounts_ = new uint[](1); LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); amounts_[0] = SiloAdvancedLib.totalCollateral($.lendingVault); } /// @inheritdoc StrategyBase function _claimRevenue() internal override returns ( address[] memory __assets, uint[] memory __amounts, address[] memory __rewardAssets, uint[] memory __rewardAmounts ) { __assets = assets(); __rewardAssets = new address[](0); __rewardAmounts = new uint[](0); __amounts = new uint[](1); LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); LeverageLendingAddresses memory v = LeverageLendingAddresses({ collateralAsset: $.collateralAsset, borrowAsset: $.borrowAsset, lendingVault: $.lendingVault, borrowingVault: $.borrowingVault }); StrategyBaseStorage storage $base = _getStrategyBaseStorage(); uint totalWas = $base.total; ISilo(v.lendingVault).accrueInterest(); ISilo(v.borrowingVault).accrueInterest(); uint totalNow = StrategyLib.balance(v.collateralAsset) + SiloAdvancedLib.calcTotal(v); if (totalNow > totalWas) { __amounts[0] = totalNow - totalWas; } $base.total = totalNow; { int earned = int(totalNow) - int(totalWas); (uint _realTvl,) = realTvl(); uint duration = block.timestamp - $base.lastHardWork; int realApr = StrategyLib.computeAprInt(_realTvl, earned, duration); (uint depositApr, uint borrowApr) = _getDepositAndBorrowAprs($.helper, v.lendingVault, v.borrowingVault); (uint sharePrice,) = realSharePrice(); emit LeverageLendingHardWork(realApr, earned, _realTvl, duration, sharePrice, depositApr, borrowApr); } (uint ltv,, uint leverage,,,) = health(); emit LeverageLendingHealth(ltv, leverage); } /// @inheritdoc StrategyBase function _previewDepositAssets(uint[] memory amountsMax) internal pure override(StrategyBase) returns (uint[] memory amountsConsumed, uint value) { amountsConsumed = new uint[](1); amountsConsumed[0] = amountsMax[0]; value = amountsConsumed[0]; } /// @inheritdoc StrategyBase function _depositAssets(uint[] memory amounts, bool /*claimRevenue*/ ) internal override returns (uint value) { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); $.tempAction = CurrentAction.Deposit; LeverageLendingAddresses memory v = LeverageLendingAddresses({ collateralAsset: $.collateralAsset, borrowAsset: $.borrowAsset, lendingVault: $.lendingVault, borrowingVault: $.borrowingVault }); address[] memory _assets = assets(); uint valueWas = StrategyLib.balance(_assets[0]) + SiloAdvancedLib.calcTotal(v); (,, uint targetLeverage) = SiloAdvancedLib.getLtvData(v.lendingVault, $.targetLeveragePercent); address[] memory flashAssets = new address[](1); flashAssets[0] = v.borrowAsset; uint[] memory flashAmounts = new uint[](1); flashAmounts[0] = amounts[0] * targetLeverage / INTERNAL_PRECISION; $.tempBorrowAmount = flashAmounts[0] * $.depositParam0 / INTERNAL_PRECISION; IBVault($.flashLoanVault).flashLoan(address(this), flashAssets, flashAmounts, ""); uint valueNow = StrategyLib.balance(_assets[0]) + SiloAdvancedLib.calcTotal(v); if (valueNow > valueWas) { //console.log('deposit profit', valueNow - valueWas); value = amounts[0] + (valueNow - valueWas); } else { //console.log('deposit loss', valueWas - valueNow); value = amounts[0] - (valueWas - valueNow); } StrategyBaseStorage storage $base = _getStrategyBaseStorage(); $base.total += value; } /// @inheritdoc StrategyBase function _withdrawAssets(uint value, address receiver) internal override returns (uint[] memory amountsOut) { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); $.tempAction = CurrentAction.Withdraw; LeverageLendingAddresses memory v = LeverageLendingAddresses({ collateralAsset: $.collateralAsset, borrowAsset: $.borrowAsset, lendingVault: $.lendingVault, borrowingVault: $.borrowingVault }); amountsOut = new uint[](1); uint valueWas = StrategyLib.balance(v.collateralAsset) + SiloAdvancedLib.calcTotal(v); (uint maxLtv, uint maxLeverage,) = SiloAdvancedLib.getLtvData(v.lendingVault, $.targetLeveragePercent); (uint priceCtoB,) = SiloAdvancedLib.getPrices(v.lendingVault, v.borrowingVault); { uint collateralAmountToWithdraw = value * maxLeverage / INTERNAL_PRECISION; $.tempCollateralAmount = collateralAmountToWithdraw; uint[] memory flashAmounts = new uint[](1); flashAmounts[0] = (collateralAmountToWithdraw * maxLtv / 1e18) * priceCtoB / 1e18; address[] memory flashAssets = new address[](1); flashAssets[0] = $.borrowAsset; IBVault($.flashLoanVault).flashLoan(address(this), flashAssets, flashAmounts, ""); } uint valueNow = StrategyLib.balance(v.collateralAsset) + SiloAdvancedLib.calcTotal(v); uint bal = StrategyLib.balance(v.collateralAsset); if (valueWas > valueNow) { //console.log('withdraw loss', valueWas - valueNow); amountsOut[0] = Math.min(value - (valueWas - valueNow), bal); } else { //console.log('withdraw profit', valueNow - valueWas); amountsOut[0] = Math.min(value + (valueNow - valueWas), bal); } IERC20(v.collateralAsset).safeTransfer(receiver, amountsOut[0]); StrategyBaseStorage storage $base = _getStrategyBaseStorage(); $base.total -= value; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* INTERNAL LOGIC */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ function _generateDescription( address lendingVault, address collateralAsset, address borrowAsset ) internal view returns (string memory) { uint siloId = ISiloConfig(ISilo(lendingVault).config()).SILO_ID(); return string.concat( "Supply ", IERC20Metadata(collateralAsset).symbol(), " and borrow ", IERC20Metadata(borrowAsset).symbol(), " on Silo V2 market ", CommonLib.u2s(siloId), " with leverage looping" ); } function _formatLeverageShort(uint amount) internal pure returns (string memory) { uint intAmount = amount / 100_00; uint decimalAmount = (amount - intAmount * 100_00) / 10_00; return string.concat("x", CommonLib.u2s(intAmount), ".", CommonLib.u2s(decimalAmount)); } function _getDepositAndBorrowAprs( address lens, address lendingVault, address debtVault ) internal view returns (uint depositApr, uint borrowApr) { depositApr = ISiloLens(lens).getDepositAPR(lendingVault) * ConstantsLib.DENOMINATOR / 1e18; borrowApr = ISiloLens(lens).getBorrowAPR(debtVault) * ConstantsLib.DENOMINATOR / 1e18; } }
// 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/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; library ConstantsLib { uint internal constant DENOMINATOR = 100_000; address internal constant DEAD_ADDRESS = 0xdEad000000000000000000000000000000000000; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import "../../core/base/Controllable.sol"; import "../../core/libs/VaultTypeLib.sol"; import "../libs/StrategyLib.sol"; import "../../interfaces/IStrategy.sol"; import "../../interfaces/IVault.sol"; /// @dev Base universal strategy /// Changelog: /// 2.1.2: call hardWorkMintFeeCallback only on positive amounts /// 2.1.1: extractFees fixed /// 2.1.0: customPriceImpactTolerance /// 2.0.0: previewDepositAssetsWrite; use platform.getCustomVaultFee /// 1.1.0: autoCompoundingByUnderlyingProtocol(), virtual total() /// @author Alien Deployer (https://github.com/a17) /// @author JodsMigel (https://github.com/JodsMigel) abstract contract StrategyBase is Controllable, IStrategy { using SafeERC20 for IERC20; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CONSTANTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Version of StrategyBase implementation string public constant VERSION_STRATEGY_BASE = "2.1.2"; // keccak256(abi.encode(uint256(keccak256("erc7201:stability.StrategyBase")) - 1)) & ~bytes32(uint256(0xff)); bytes32 private constant STRATEGYBASE_STORAGE_LOCATION = 0xb14b643f49bed6a2c6693bbd50f68dc950245db265c66acadbfa51ccc8c3ba00; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* INITIALIZATION */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ //slither-disable-next-line naming-convention function __StrategyBase_init( address platform_, string memory id_, address vault_, address[] memory assets_, address underlying_, uint exchangeAssetIndex_ ) internal onlyInitializing { __Controllable_init(platform_); StrategyBaseStorage storage $ = _getStrategyBaseStorage(); ($._id, $.vault, $._assets, $._underlying, $._exchangeAssetIndex) = (id_, vault_, assets_, underlying_, exchangeAssetIndex_); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* RESTRICTED ACTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ modifier onlyVault() { _requireVault(); _; } /// @inheritdoc IStrategy function depositAssets(uint[] memory amounts) external override onlyVault returns (uint value) { StrategyBaseStorage storage $ = _getStrategyBaseStorage(); if ($.lastHardWork == 0) { $.lastHardWork = block.timestamp; } _beforeDeposit(); return _depositAssets(amounts, true); } /// @inheritdoc IStrategy function withdrawAssets( address[] memory assets_, uint value, address receiver ) external virtual onlyVault returns (uint[] memory amountsOut) { _beforeWithdraw(); return _withdrawAssets(assets_, value, receiver); } function depositUnderlying(uint amount) external virtual override onlyVault returns (uint[] memory amountsConsumed) { _beforeDeposit(); return _depositUnderlying(amount); } function withdrawUnderlying(uint amount, address receiver) external virtual override onlyVault { _beforeWithdraw(); _withdrawUnderlying(amount, receiver); } /// @inheritdoc IStrategy function transferAssets( uint amount, uint total_, address receiver ) external onlyVault returns (uint[] memory amountsOut) { _beforeTransferAssets(); //slither-disable-next-line unused-return return StrategyLib.transferAssets(_getStrategyBaseStorage(), amount, total_, receiver); } /// @inheritdoc IStrategy function doHardWork() external onlyVault { _beforeDoHardWork(); StrategyBaseStorage storage $ = _getStrategyBaseStorage(); address _vault = $.vault; //slither-disable-next-line unused-return (uint tvl,) = IVault(_vault).tvl(); if (tvl > 0) { address _platform = platform(); uint exchangeAssetIndex = $._exchangeAssetIndex; ( address[] memory __assets, uint[] memory __amounts, address[] memory __rewardAssets, uint[] memory __rewardAmounts ) = _claimRevenue(); //slither-disable-next-line uninitialized-local uint totalBefore; if (!autoCompoundingByUnderlyingProtocol()) { __amounts[exchangeAssetIndex] += _liquidateRewards(__assets[exchangeAssetIndex], __rewardAssets, __rewardAmounts); uint[] memory amountsRemaining = StrategyLib.extractFees(_platform, _vault, $._id, __assets, __amounts); bool needCompound = _processRevenue(__assets, amountsRemaining); totalBefore = $.total; if (needCompound) { _compound(); } } else { // maybe this is not final logic // vault shares as fees can be used not only for autoCompoundingByUnderlyingProtocol strategies, // but for many strategies linked to CVault if this feature will be implemented if (StrategyLib.isPositiveAmountInArray(__amounts)) { IVault(_vault).hardWorkMintFeeCallback(__assets, __amounts); } // call empty method only for coverage or them can be overriden _liquidateRewards(__assets[0], __rewardAssets, __rewardAmounts); _processRevenue(__assets, __amounts); _compound(); } StrategyLib.emitApr($, _platform, __assets, __amounts, tvl, totalBefore); } } /// @inheritdoc IStrategy function emergencyStopInvesting() external onlyGovernanceOrMultisig { // slither-disable-next-line unused-return _withdrawAssets(total(), address(this)); } /// @inheritdoc IStrategy function setCustomPriceImpactTolerance(uint priceImpactTolerance) external onlyOperator { StrategyBaseStorage storage $ = _getStrategyBaseStorage(); $.customPriceImpactTolerance = priceImpactTolerance; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc IERC165 function supportsInterface(bytes4 interfaceId) public view virtual override(Controllable, IERC165) returns (bool) { return interfaceId == type(IStrategy).interfaceId || super.supportsInterface(interfaceId); } function strategyLogicId() public view virtual returns (string memory); /// @inheritdoc IStrategy function assets() public view virtual returns (address[] memory) { return _getStrategyBaseStorage()._assets; } /// @inheritdoc IStrategy function underlying() public view override returns (address) { return _getStrategyBaseStorage()._underlying; } /// @inheritdoc IStrategy function vault() public view override returns (address) { return _getStrategyBaseStorage().vault; } /// @inheritdoc IStrategy function total() public view virtual override returns (uint) { return _getStrategyBaseStorage().total; } /// @inheritdoc IStrategy function lastHardWork() public view override returns (uint) { return _getStrategyBaseStorage().lastHardWork; } /// @inheritdoc IStrategy function lastApr() public view override returns (uint) { return _getStrategyBaseStorage().lastApr; } /// @inheritdoc IStrategy function lastAprCompound() public view override returns (uint) { return _getStrategyBaseStorage().lastAprCompound; } /// @inheritdoc IStrategy function assetsAmounts() public view virtual returns (address[] memory assets_, uint[] memory amounts_) { (assets_, amounts_) = _assetsAmounts(); //slither-disable-next-line unused-return return StrategyLib.assetsAmountsWithBalances(assets_, amounts_); } /// @inheritdoc IStrategy function previewDepositAssets( address[] memory assets_, uint[] memory amountsMax ) public view virtual returns (uint[] memory amountsConsumed, uint value) { // nosemgrep if (assets_.length == 1 && assets_[0] == _getStrategyBaseStorage()._underlying && assets_[0] != address(0)) { if (amountsMax.length != 1) { revert IControllable.IncorrectArrayLength(); } value = amountsMax[0]; amountsConsumed = _previewDepositUnderlying(amountsMax[0]); } else { return _previewDepositAssets(assets_, amountsMax); } } /// @inheritdoc IStrategy function previewDepositAssetsWrite( address[] memory assets_, uint[] memory amountsMax ) external virtual returns (uint[] memory amountsConsumed, uint value) { // nosemgrep if (assets_.length == 1 && assets_[0] == _getStrategyBaseStorage()._underlying && assets_[0] != address(0)) { if (amountsMax.length != 1) { revert IControllable.IncorrectArrayLength(); } value = amountsMax[0]; amountsConsumed = _previewDepositUnderlyingWrite(amountsMax[0]); } else { return _previewDepositAssetsWrite(assets_, amountsMax); } } /// @inheritdoc IStrategy function autoCompoundingByUnderlyingProtocol() public view virtual returns (bool) { return false; } /// @inheritdoc IStrategy function customPriceImpactTolerance() public view returns (uint) { return _getStrategyBaseStorage().customPriceImpactTolerance; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* Default implementations */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Invest underlying asset. Asset must be already on strategy contract balance. /// @return Cosumed amounts of invested assets function _depositUnderlying(uint /*amount*/ ) internal virtual returns (uint[] memory /*amountsConsumed*/ ) { revert(_getStrategyBaseStorage()._underlying == address(0) ? "no underlying" : "not implemented"); } /// @dev Wothdraw underlying invested and send to receiver function _withdrawUnderlying(uint, /*amount*/ address /*receiver*/ ) internal virtual { revert(_getStrategyBaseStorage()._underlying == address(0) ? "no underlying" : "not implemented"); } /// @dev Calculation of consumed amounts and liquidity/underlying value for provided amount of underlying function _previewDepositUnderlying(uint /*amount*/ ) internal view virtual returns (uint[] memory /*amountsConsumed*/ ) {} function _previewDepositUnderlyingWrite(uint amount) internal view virtual returns (uint[] memory amountsConsumed) { return _previewDepositUnderlying(amount); } /// @dev Can be overrided by derived base strategies for custom logic function _beforeDeposit() internal virtual {} /// @dev Can be overrided by derived base strategies for custom logic function _beforeWithdraw() internal virtual {} /// @dev Can be overrided by derived base strategies for custom logic function _beforeTransferAssets() internal virtual {} /// @dev Can be overrided by derived base strategies for custom logic function _beforeDoHardWork() internal virtual { if (!IStrategy(this).isReadyForHardWork()) { revert NotReadyForHardWork(); } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* Must be implemented by derived contracts */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc IStrategy function supportedVaultTypes() external view virtual returns (string[] memory types); /// @dev Investing assets. Amounts must be on strategy contract balance. /// @param amounts Amounts of strategy assets to invest /// @param claimRevenue Claim revenue before investing /// @return value Output of liquidity value or underlying token amount function _depositAssets(uint[] memory amounts, bool claimRevenue) internal virtual returns (uint value); /// @dev Withdraw assets from investing and send to user. /// Here we give the user a choice of assets to withdraw if strategy support it. /// This full form of _withdrawAssets can be implemented only in inherited base strategy contract. /// @param assets_ Assets for withdrawal. Can contain not all strategy assets if it need. /// @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 ) internal virtual returns (uint[] memory amountsOut); /// @dev Withdraw strategy assets from investing and send to user. /// This light form of _withdrawAssets is suitable for implementation into final strategy contract. /// @param value Part of strategy total value to withdraw /// @param receiver User address /// @return amountsOut Amounts of assets sent to user function _withdrawAssets(uint value, address receiver) internal virtual returns (uint[] memory amountsOut); /// @dev Claim all possible revenue to strategy contract balance and calculate claimed revenue after previous HardWork /// @return __assets Strategy assets /// @return __amounts Amounts of claimed revenue in form of strategy assets /// @return __rewardAssets Farming reward assets /// @return __rewardAmounts Amounts of claimed farming rewards function _claimRevenue() internal virtual returns ( address[] memory __assets, uint[] memory __amounts, address[] memory __rewardAssets, uint[] memory __rewardAmounts ); function _processRevenue( address[] memory assets_, uint[] memory amountsRemaining ) internal virtual returns (bool needCompound); function _liquidateRewards( address exchangeAsset, address[] memory rewardAssets_, uint[] memory rewardAmounts_ ) internal virtual returns (uint earnedExchangeAsset); /// @dev Reinvest strategy assets of strategy contract balance function _compound() internal virtual; /// @dev Strategy assets and amounts that strategy invests. Without assets on strategy contract balance /// @return assets_ Strategy assets /// @return amounts_ Amounts invested function _assetsAmounts() internal view virtual returns (address[] memory assets_, uint[] memory amounts_); /// @dev Calculation of consumed amounts and liquidity/underlying value for provided strategy assets and amounts. /// @dev This full form of _previewDepositAssets can be implemented only in inherited base strategy contract /// @param assets_ Strategy assets or part of them, if necessary /// @param amountsMax Amounts of specified assets available for investing /// @return amountsConsumed Consumed amounts of assets when investing /// @return value Liquidity value or underlying token amount minted when investing function _previewDepositAssets( address[] memory assets_, uint[] memory amountsMax ) internal view virtual returns (uint[] memory amountsConsumed, uint value); /// @dev 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 Consumed amounts of assets when investing /// @return value Liquidity value or underlying token amount minted when investing function _previewDepositAssetsWrite( address[] memory assets_, uint[] memory amountsMax ) internal virtual returns (uint[] memory amountsConsumed, uint value) { return _previewDepositAssets(assets_, amountsMax); } /// @dev Calculation of consumed amounts and liquidity/underlying value for provided strategy assets and amounts. /// Light form of _previewDepositAssets is suitable for implementation into final strategy contract. /// @param amountsMax Amounts of specified assets available for investing /// @return amountsConsumed Consumed amounts of assets when investing /// @return value Liquidity value or underlying token amount minted when investing function _previewDepositAssets(uint[] memory amountsMax) internal view virtual returns (uint[] memory amountsConsumed, uint value); /// @dev Write version of _previewDepositAssets /// @param amountsMax Amounts of specified assets available for investing /// @return amountsConsumed Consumed amounts of assets when investing /// @return value Liquidity value or underlying token amount minted when investing function _previewDepositAssetsWrite(uint[] memory amountsMax) internal virtual returns (uint[] memory amountsConsumed, uint value) { return _previewDepositAssets(amountsMax); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* INTERNAL LOGIC */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ function _getStrategyBaseStorage() internal pure returns (StrategyBaseStorage storage $) { //slither-disable-next-line assembly assembly { $.slot := STRATEGYBASE_STORAGE_LOCATION } } function _requireVault() internal view { if (msg.sender != _getStrategyBaseStorage().vault) { revert IControllable.NotVault(); } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol"; import {StrategyBase} from "./StrategyBase.sol"; import {VaultTypeLib} from "../../core/libs/VaultTypeLib.sol"; import {CommonLib} from "../../core/libs/CommonLib.sol"; import {ILeverageLendingStrategy} from "../../interfaces/ILeverageLendingStrategy.sol"; import {IStrategy} from "../../interfaces/IStrategy.sol"; import {IHardWorker} from "../../interfaces/IHardWorker.sol"; import {IPlatform} from "../../interfaces/IPlatform.sol"; import {IControllable} from "../../interfaces/IControllable.sol"; /// @notice Base strategy for leverage lending /// Changelog: /// 1.1.0: targetLeveragePercent setup in strategy initializer; 8 universal configurable params /// @author Alien Deployer (https://github.com/a17) abstract contract LeverageLendingBase is StrategyBase, ILeverageLendingStrategy { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CONSTANTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Version of FarmingStrategyBase implementation string public constant VERSION_LEVERAGE_LENDING_STRATEGY_BASE = "1.1.0"; /// @dev 100_00 is 1.0 or 100% uint internal constant INTERNAL_PRECISION = 100_00; // keccak256(abi.encode(uint256(keccak256("erc7201:stability.LeverageLendingBase")) - 1)) & ~bytes32(uint256(0xff)); bytes32 private constant LEVERAGE_LENDING_STRATEGY_STORAGE_LOCATION = 0xbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f700; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* INITIALIZATION */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ //slither-disable-next-line naming-convention function __LeverageLendingBase_init(LeverageLendingStrategyBaseInitParams memory params) internal onlyInitializing { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); $.collateralAsset = params.collateralAsset; $.borrowAsset = params.borrowAsset; $.lendingVault = params.lendingVault; $.borrowingVault = params.borrowingVault; $.flashLoanVault = params.flashLoanVault; $.helper = params.helper; $.targetLeveragePercent = params.targetLeveragePercent; emit TargetLeveragePercent(params.targetLeveragePercent); address[] memory _assets = new address[](1); _assets[0] = params.collateralAsset; __StrategyBase_init(params.platform, params.strategyId, params.vault, _assets, address(0), type(uint).max); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* WRITE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc ILeverageLendingStrategy function rebalanceDebt(uint newLtv) external returns (uint resultLtv) { IPlatform _platform = IPlatform(platform()); IHardWorker hardworker = IHardWorker(_platform.hardWorker()); address rebalancer = _platform.rebalancer(); if ( msg.sender != rebalancer && !_platform.isOperator(msg.sender) && !hardworker.dedicatedServerMsgSender(msg.sender) ) { revert IControllable.IncorrectMsgSender(); } resultLtv = _rebalanceDebt(newLtv); } /// @inheritdoc ILeverageLendingStrategy function setTargetLeveragePercent(uint value) external onlyOperator { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); $.targetLeveragePercent = value; emit TargetLeveragePercent(value); } /// @inheritdoc ILeverageLendingStrategy function setUniversalParams(uint[] memory params) external onlyOperator { LeverageLendingBaseStorage storage $ = _getLeverageLendingBaseStorage(); $.depositParam0 = params[0]; $.depositParam1 = params[1]; $.withdrawParam0 = params[2]; $.withdrawParam1 = params[3]; $.increaseLtvParam0 = params[4]; $.increaseLtvParam1 = params[5]; $.decreaseLtvParam0 = params[6]; $.decreaseLtvParam1 = params[7]; $.swapPriceImpactTolerance0 = params[8]; $.swapPriceImpactTolerance1 = params[9]; emit UniversalParams(params); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* VIEW FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc IERC165 function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(ILeverageLendingStrategy).interfaceId || super.supportsInterface(interfaceId); } /// @inheritdoc IStrategy function supportedVaultTypes() external view virtual override returns (string[] memory types) { types = new string[](1); types[0] = VaultTypeLib.COMPOUNDING; } /// @inheritdoc IStrategy function getAssetsProportions() public pure returns (uint[] memory proportions) { proportions = new uint[](1); proportions[0] = 1e18; } /// @inheritdoc IStrategy function isReadyForHardWork() external pure virtual returns (bool isReady) { return true; } /// @inheritdoc IStrategy function extra() external pure returns (bytes32) { //slither-disable-next-line too-many-digits return CommonLib.bytesToBytes32(abi.encodePacked(bytes3(0xffffff), bytes3(0x000000))); } /// @inheritdoc IStrategy function autoCompoundingByUnderlyingProtocol() public view virtual override returns (bool) { return true; } /// @inheritdoc IStrategy function getRevenue() external pure virtual returns (address[] memory assets_, uint[] memory amounts) {} /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* STRATEGY BASE */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @inheritdoc StrategyBase function _compound() internal virtual override {} /// @inheritdoc StrategyBase function _processRevenue( address[] memory, /*assets_*/ uint[] memory /*amountsRemaining*/ ) internal pure virtual override returns (bool needCompound) { needCompound = true; } /// @inheritdoc StrategyBase function _previewDepositAssets( address[] memory, /*assets_*/ uint[] memory amountsMax ) internal view override(StrategyBase) returns (uint[] memory amountsConsumed, uint value) { return _previewDepositAssets(amountsMax); } function _withdrawAssets( address[] memory, /*assets_*/ uint value, address receiver ) internal virtual override returns (uint[] memory amountsOut) { return _withdrawAssets(value, receiver); } /// @inheritdoc StrategyBase function _liquidateRewards( address exchangeAsset, address[] memory rewardAssets_, uint[] memory rewardAmounts_ ) internal override returns (uint earnedExchangeAsset) {} /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* Must be implemented by derived contracts */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ function _rebalanceDebt(uint newLtv) internal virtual returns (uint resultLtv); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* INTERNAL LOGIC */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ function _getLeverageLendingBaseStorage() internal pure returns (LeverageLendingBaseStorage storage $) { //slither-disable-next-line assembly assembly { $.slot := LEVERAGE_LENDING_STRATEGY_STORAGE_LOCATION } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; library StrategyIdLib { string internal constant DEV = "Dev Alpha DeepSpaceSwap Farm"; string internal constant QUICKSWAPV3_STATIC_FARM = "QuickSwapV3 Static Farm"; string internal constant GAMMA_QUICKSWAP_MERKL_FARM = "Gamma QuickSwap Merkl Farm"; string internal constant GAMMA_RETRO_MERKL_FARM = "Gamma Retro Merkl Farm"; string internal constant GAMMA_UNISWAPV3_MERKL_FARM = "Gamma UniswapV3 Merkl Farm"; string internal constant COMPOUND_FARM = "Compound Farm"; string internal constant DEFIEDGE_QUICKSWAP_MERKL_FARM = "DefiEdge QuickSwap Merkl Farm"; string internal constant STEER_QUICKSWAP_MERKL_FARM = "Steer QuickSwap Merkl Farm"; string internal constant ICHI_QUICKSWAP_MERKL_FARM = "Ichi QuickSwap Merkl Farm"; string internal constant ICHI_RETRO_MERKL_FARM = "Ichi Retro Merkl Farm"; string internal constant QUICKSWAP_STATIC_MERKL_FARM = "QuickSwap Static Merkl Farm"; string internal constant CURVE_CONVEX_FARM = "Curve Convex Farm"; string internal constant YEARN = "Yearn"; string internal constant TRIDENT_PEARL_FARM = "Trident Pearl Farm"; string internal constant BEETS_STABLE_FARM = "Beets Stable Farm"; string internal constant BEETS_WEIGHTED_FARM = "Beets Weighted Farm"; string internal constant EQUALIZER_FARM = "Equalizer Farm"; string internal constant ICHI_SWAPX_FARM = "Ichi SwapX Farm"; string internal constant SWAPX_FARM = "SwapX Farm"; string internal constant SILO_FARM = "Silo Farm"; string internal constant ALM_SHADOW_FARM = "ALM Shadow Farm"; string internal constant SILO_LEVERAGE = "Silo Leverage"; string internal constant SILO_ADVANCED_LEVERAGE = "Silo Advanced Leverage"; }
// 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 {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 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 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 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 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; 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; 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 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 IFlashLoanRecipient { /** * @dev When `flashLoan` is called on the Vault, it invokes the `receiveFlashLoan` hook on the recipient. * * At the time of the call, the Vault will have transferred `amounts` for `tokens` to the recipient. Before this * call returns, the recipient must have transferred `amounts` plus `feeAmounts` for each token back to the * Vault, or else the entire flash loan will revert. * * `userData` is the same value passed in the `IVault.flashLoan` call. */ function receiveFlashLoan( address[] memory tokens, uint256[] memory amounts, uint256[] memory feeAmounts, bytes memory userData ) external; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; interface IAsset {} interface IBVault { // Internal Balance // // Users can deposit tokens into the Vault, where they are allocated to their Internal Balance, and later // transferred or withdrawn. It can also be used as a source of tokens when joining Pools, as a destination // when exiting them, and as either when performing swaps. This usage of Internal Balance results in greatly reduced // gas costs when compared to relying on plain ERC20 transfers, leading to large savings for frequent users. // // Internal Balance management features batching, which means a single contract call can be used to perform multiple // operations of different kinds, with different senders and recipients, at once. /** * @dev Returns `user`'s Internal Balance for a set of tokens. */ function getInternalBalance(address user, IERC20[] calldata tokens) external view returns (uint[] memory); /** * @dev Performs a set of user balance operations, which involve Internal Balance (deposit, withdraw or transfer) * and plain ERC20 transfers using the Vault's allowance. This last feature is particularly useful for relayers, as * it lets integrators reuse a user's Vault allowance. * * For each operation, if the caller is not `sender`, it must be an authorized relayer for them. */ function manageUserBalance(UserBalanceOp[] calldata ops) external payable; /** * @dev Data for `manageUserBalance` operations, which include the possibility for ETH to be sent and received * without manual WETH wrapping or unwrapping. */ struct UserBalanceOp { UserBalanceOpKind kind; IAsset asset; uint amount; address sender; address payable recipient; } // There are four possible operations in `manageUserBalance`: // // - DEPOSIT_INTERNAL // Increases the Internal Balance of the `recipient` account by transferring tokens from the corresponding // `sender`. The sender must have allowed the Vault to use their tokens via `IERC20.approve()`. // // ETH can be used by passing the ETH sentinel value as the asset and forwarding ETH in the call: it will be wrapped // and deposited as WETH. Any ETH amount remaining will be sent back to the caller (not the sender, which is // relevant for relayers). // // Emits an `InternalBalanceChanged` event. // // // - WITHDRAW_INTERNAL // Decreases the Internal Balance of the `sender` account by transferring tokens to the `recipient`. // // ETH can be used by passing the ETH sentinel value as the asset. This will deduct WETH instead, unwrap it and send // it to the recipient as ETH. // // Emits an `InternalBalanceChanged` event. // // // - TRANSFER_INTERNAL // Transfers tokens from the Internal Balance of the `sender` account to the Internal Balance of `recipient`. // // Reverts if the ETH sentinel value is passed. // // Emits an `InternalBalanceChanged` event. // // // - TRANSFER_EXTERNAL // Transfers tokens from `sender` to `recipient`, using the Vault's ERC20 allowance. This is typically used by // relayers, as it lets them reuse a user's Vault allowance. // // Reverts if the ETH sentinel value is passed. // // Emits an `ExternalBalanceTransfer` event. enum UserBalanceOpKind { DEPOSIT_INTERNAL, WITHDRAW_INTERNAL, TRANSFER_INTERNAL, TRANSFER_EXTERNAL } /** * @dev Emitted when a user's Internal Balance changes, either from calls to `manageUserBalance`, or through * interacting with Pools using Internal Balance. * * Because Internal Balance works exclusively with ERC20 tokens, ETH deposits and withdrawals will use the WETH * address. */ event InternalBalanceChanged(address indexed user, IERC20 indexed token, int delta); /** * @dev Emitted when a user's Vault ERC20 allowance is used by the Vault to transfer tokens to an external account. */ event ExternalBalanceTransfer(IERC20 indexed token, address indexed sender, address recipient, uint amount); // Pools // // There are three specialization settings for Pools, which allow for cheaper swaps at the cost of reduced // functionality: // // - General: no specialization, suited for all Pools. IGeneralPool is used for swap request callbacks, passing the // balance of all tokens in the Pool. These Pools have the largest swap costs (because of the extra storage reads), // which increase with the number of registered tokens. // // - Minimal Swap Info: IMinimalSwapInfoPool is used instead of IGeneralPool, which saves gas by only passing the // balance of the two tokens involved in the swap. This is suitable for some pricing algorithms, like the weighted // constant product one popularized by Balancer V1. Swap costs are smaller compared to general Pools, and are // independent of the number of registered tokens. // // - Two Token: only allows two tokens to be registered. This achieves the lowest possible swap gas cost. Like // minimal swap info Pools, these are called via IMinimalSwapInfoPool. enum PoolSpecialization { GENERAL, MINIMAL_SWAP_INFO, TWO_TOKEN } /** * @dev Registers the caller account as a Pool with a given specialization setting. Returns the Pool's ID, which * is used in all Pool-related functions. Pools cannot be deregistered, nor can the Pool's specialization be * changed. * * The caller is expected to be a smart contract that implements either `IGeneralPool` or `IMinimalSwapInfoPool`, * depending on the chosen specialization setting. This contract is known as the Pool's contract. * * Note that the same contract may register itself as multiple Pools with unique Pool IDs, or in other words, * multiple Pools may share the same contract. * * Emits a `PoolRegistered` event. */ function registerPool(PoolSpecialization specialization) external returns (bytes32); /** * @dev Emitted when a Pool is registered by calling `registerPool`. */ event PoolRegistered(bytes32 indexed poolId, address indexed poolAddress, PoolSpecialization specialization); /** * @dev Returns a Pool's contract address and specialization setting. */ function getPool(bytes32 poolId) external view returns (address, PoolSpecialization); /** * @dev Registers `tokens` for the `poolId` Pool. Must be called by the Pool's contract. * * Pools can only interact with tokens they have registered. Users join a Pool by transferring registered tokens, * exit by receiving registered tokens, and can only swap registered tokens. * * Each token can only be registered once. For Pools with the Two Token specialization, `tokens` must have a length * of two, that is, both tokens must be registered in the same `registerTokens` call, and they must be sorted in * ascending order. * * The `tokens` and `assetManagers` arrays must have the same length, and each entry in these indicates the Asset * Manager for the corresponding token. Asset Managers can manage a Pool's tokens via `managePoolBalance`, * depositing and withdrawing them directly, and can even set their balance to arbitrary amounts. They are therefore * expected to be highly secured smart contracts with sound design principles, and the decision to register an * Asset Manager should not be made lightly. * * Pools can choose not to assign an Asset Manager to a given token by passing in the zero address. Once an Asset * Manager is set, it cannot be changed except by deregistering the associated token and registering again with a * different Asset Manager. * * Emits a `TokensRegistered` event. */ function registerTokens(bytes32 poolId, IERC20[] calldata tokens, address[] calldata assetManagers) external; /** * @dev Emitted when a Pool registers tokens by calling `registerTokens`. */ event TokensRegistered(bytes32 indexed poolId, IERC20[] tokens, address[] assetManagers); /** * @dev Deregisters `tokens` for the `poolId` Pool. Must be called by the Pool's contract. * * Only registered tokens (via `registerTokens`) can be deregistered. Additionally, they must have zero total * balance. For Pools with the Two Token specialization, `tokens` must have a length of two, that is, both tokens * must be deregistered in the same `deregisterTokens` call. * * A deregistered token can be re-registered later on, possibly with a different Asset Manager. * * Emits a `TokensDeregistered` event. */ function deregisterTokens(bytes32 poolId, IERC20[] calldata tokens) external; /** * @dev Emitted when a Pool deregisters tokens by calling `deregisterTokens`. */ event TokensDeregistered(bytes32 indexed poolId, IERC20[] tokens); /** * @dev Returns detailed information for a Pool's registered token. * * `cash` is the number of tokens the Vault currently holds for the Pool. `managed` is the number of tokens * withdrawn and held outside the Vault by the Pool's token Asset Manager. The Pool's total balance for `token` * equals the sum of `cash` and `managed`. * * Internally, `cash` and `managed` are stored using 112 bits. No action can ever cause a Pool's token `cash`, * `managed` or `total` balance to be greater than 2^112 - 1. * * `lastChangeBlock` is the number of the block in which `token`'s total balance was last modified (via either a * join, exit, swap, or Asset Manager update). This value is useful to avoid so-called 'sandwich attacks', for * example when developing price oracles. A change of zero (e.g. caused by a swap with amount zero) is considered a * change for this purpose, and will update `lastChangeBlock`. * * `assetManager` is the Pool's token Asset Manager. */ function getPoolTokenInfo( bytes32 poolId, IERC20 token ) external view returns (uint cash, uint managed, uint lastChangeBlock, address assetManager); /** * @dev Returns a Pool's registered tokens, the total balance for each, and the latest block when *any* of * the tokens' `balances` changed. * * The order of the `tokens` array is the same order that will be used in `joinPool`, `exitPool`, as well as in all * Pool hooks (where applicable). Calls to `registerTokens` and `deregisterTokens` may change this order. * * If a Pool only registers tokens once, and these are sorted in ascending order, they will be stored in the same * order as passed to `registerTokens`. * * Total balances include both tokens held by the Vault and those withdrawn by the Pool's Asset Managers. These are * the amounts used by joins, exits and swaps. For a detailed breakdown of token balances, use `getPoolTokenInfo` * instead. * renamed IERC20[] to address[] */ function getPoolTokens(bytes32 poolId) external view returns (address[] memory tokens, uint[] memory balances, uint lastChangeBlock); /** * @dev Called by users to join a Pool, which transfers tokens from `sender` into the Pool's balance. This will * trigger custom Pool behavior, which will typically grant something in return to `recipient` - often tokenized * Pool shares. * * If the caller is not `sender`, it must be an authorized relayer for them. * * The `assets` and `maxAmountsIn` arrays must have the same length, and each entry indicates the maximum amount * to send for each asset. The amounts to send are decided by the Pool and not the Vault: it just enforces * these maximums. * * If joining a Pool that holds WETH, it is possible to send ETH directly: the Vault will do the wrapping. To enable * this mechanism, the IAsset sentinel value (the zero address) must be passed in the `assets` array instead of the * WETH address. Note that it is not possible to combine ETH and WETH in the same join. Any excess ETH will be sent * back to the caller (not the sender, which is important for relayers). * * `assets` must have the same length and order as the array returned by `getPoolTokens`. This prevents issues when * interacting with Pools that register and deregister tokens frequently. If sending ETH however, the array must be * sorted *before* replacing the WETH address with the ETH sentinel value (the zero address), which means the final * `assets` array might not be sorted. Pools with no registered tokens cannot be joined. * * If `fromInternalBalance` is true, the caller's Internal Balance will be preferred: ERC20 transfers will only * be made for the difference between the requested amount and Internal Balance (if any). Note that ETH cannot be * withdrawn from Internal Balance: attempting to do so will trigger a revert. * * This causes the Vault to call the `IBasePool.onJoinPool` hook on the Pool's contract, where Pools implement * their own custom logic. This typically requires additional information from the user (such as the expected number * of Pool shares). This can be encoded in the `userData` argument, which is ignored by the Vault and passed * directly to the Pool's contract, as is `recipient`. * * Emits a `PoolBalanceChanged` event. */ function joinPool( bytes32 poolId, address sender, address recipient, JoinPoolRequest calldata request ) external payable; enum JoinKind { INIT, EXACT_TOKENS_IN_FOR_BPT_OUT, TOKEN_IN_FOR_EXACT_BPT_OUT } enum ExitKind { EXACT_BPT_IN_FOR_ONE_TOKEN_OUT, EXACT_BPT_IN_FOR_TOKENS_OUT, BPT_IN_FOR_EXACT_TOKENS_OUT } /// @dev modified to address[] struct JoinPoolRequest { address[] assets; uint[] maxAmountsIn; bytes userData; bool fromInternalBalance; } /** * @dev Called by users to exit a Pool, which transfers tokens from the Pool's balance to `recipient`. This will * trigger custom Pool behavior, which will typically ask for something in return from `sender` - often tokenized * Pool shares. The amount of tokens that can be withdrawn is limited by the Pool's `cash` balance (see * `getPoolTokenInfo`). * * If the caller is not `sender`, it must be an authorized relayer for them. * * The `tokens` and `minAmountsOut` arrays must have the same length, and each entry in these indicates the minimum * token amount to receive for each token contract. The amounts to send are decided by the Pool and not the Vault: * it just enforces these minimums. * * If exiting a Pool that holds WETH, it is possible to receive ETH directly: the Vault will do the unwrapping. To * enable this mechanism, the IAsset sentinel value (the zero address) must be passed in the `assets` array instead * of the WETH address. Note that it is not possible to combine ETH and WETH in the same exit. * * `assets` must have the same length and order as the array returned by `getPoolTokens`. This prevents issues when * interacting with Pools that register and deregister tokens frequently. If receiving ETH however, the array must * be sorted *before* replacing the WETH address with the ETH sentinel value (the zero address), which means the * final `assets` array might not be sorted. Pools with no registered tokens cannot be exited. * * If `toInternalBalance` is true, the tokens will be deposited to `recipient`'s Internal Balance. Otherwise, * an ERC20 transfer will be performed. Note that ETH cannot be deposited to Internal Balance: attempting to * do so will trigger a revert. * * `minAmountsOut` is the minimum amount of tokens the user expects to get out of the Pool, for each token in the * `tokens` array. This array must match the Pool's registered tokens. * * This causes the Vault to call the `IBasePool.onExitPool` hook on the Pool's contract, where Pools implement * their own custom logic. This typically requires additional information from the user (such as the expected number * of Pool shares to return). This can be encoded in the `userData` argument, which is ignored by the Vault and * passed directly to the Pool's contract. * * Emits a `PoolBalanceChanged` event. */ function exitPool( bytes32 poolId, address sender, address payable recipient, ExitPoolRequest calldata request ) external; /// @dev modified to address[] struct ExitPoolRequest { address[] assets; uint[] minAmountsOut; bytes userData; bool toInternalBalance; } /** * @dev Emitted when a user joins or exits a Pool by calling `joinPool` or `exitPool`, respectively. */ event PoolBalanceChanged( bytes32 indexed poolId, address indexed liquidityProvider, IERC20[] tokens, int[] deltas, uint[] protocolFeeAmounts ); enum PoolBalanceChangeKind { JOIN, EXIT } // Swaps // // Users can swap tokens with Pools by calling the `swap` and `batchSwap` functions. To do this, // they need not trust Pool contracts in any way: all security checks are made by the Vault. They must however be // aware of the Pools' pricing algorithms in order to estimate the prices Pools will quote. // // The `swap` function executes a single swap, while `batchSwap` can perform multiple swaps in sequence. // In each individual swap, tokens of one kind are sent from the sender to the Pool (this is the 'token in'), // and tokens of another kind are sent from the Pool to the recipient in exchange (this is the 'token out'). // More complex swaps, such as one token in to multiple tokens out can be achieved by batching together // individual swaps. // // There are two swap kinds: // - 'given in' swaps, where the amount of tokens in (sent to the Pool) is known, and the Pool determines (via the // `onSwap` hook) the amount of tokens out (to send to the recipient). // - 'given out' swaps, where the amount of tokens out (received from the Pool) is known, and the Pool determines // (via the `onSwap` hook) the amount of tokens in (to receive from the sender). // // Additionally, it is possible to chain swaps using a placeholder input amount, which the Vault replaces with // the calculated output of the previous swap. If the previous swap was 'given in', this will be the calculated // tokenOut amount. If the previous swap was 'given out', it will use the calculated tokenIn amount. These extended // swaps are known as 'multihop' swaps, since they 'hop' through a number of intermediate tokens before arriving at // the final intended token. // // In all cases, tokens are only transferred in and out of the Vault (or withdrawn from and deposited into Internal // Balance) after all individual swaps have been completed, and the net token balance change computed. This makes // certain swap patterns, such as multihops, or swaps that interact with the same token pair in multiple Pools, cost // much less gas than they would otherwise. // // It also means that under certain conditions it is possible to perform arbitrage by swapping with multiple // Pools in a way that results in net token movement out of the Vault (profit), with no tokens being sent in (only // updating the Pool's internal accounting). // // To protect users from front-running or the market changing rapidly, they supply a list of 'limits' for each token // involved in the swap, where either the maximum number of tokens to send (by passing a positive value) or the // minimum amount of tokens to receive (by passing a negative value) is specified. // // Additionally, a 'deadline' timestamp can also be provided, forcing the swap to fail if it occurs after // this point in time (e.g. if the transaction failed to be included in a block promptly). // // If interacting with Pools that hold WETH, it is possible to both send and receive ETH directly: the Vault will do // the wrapping and unwrapping. To enable this mechanism, the IAsset sentinel value (the zero address) must be // passed in the `assets` array instead of the WETH address. Note that it is possible to combine ETH and WETH in the // same swap. Any excess ETH will be sent back to the caller (not the sender, which is relevant for relayers). // // Finally, Internal Balance can be used when either sending or receiving tokens. enum SwapKind { GIVEN_IN, GIVEN_OUT } /** * @dev Performs a swap with a single Pool. * * If the swap is 'given in' (the number of tokens to send to the Pool is known), it returns the amount of tokens * taken from the Pool, which must be greater than or equal to `limit`. * * If the swap is 'given out' (the number of tokens to take from the Pool is known), it returns the amount of tokens * sent to the Pool, which must be less than or equal to `limit`. * * Internal Balance usage and the recipient are determined by the `funds` struct. * * Emits a `Swap` event. */ function swap( SingleSwap calldata singleSwap, FundManagement calldata funds, uint limit, uint deadline ) external payable returns (uint); /** * @dev Data for a single swap executed by `swap`. `amount` is either `amountIn` or `amountOut` depending on * the `kind` value. * * `assetIn` and `assetOut` are either token addresses, or the IAsset sentinel value for ETH (the zero address). * Note that Pools never interact with ETH directly: it will be wrapped to or unwrapped from WETH by the Vault. * * The `userData` field is ignored by the Vault, but forwarded to the Pool in the `onSwap` hook, and may be * used to extend swap behavior. */ struct SingleSwap { bytes32 poolId; SwapKind kind; IAsset assetIn; IAsset assetOut; uint amount; bytes userData; } /** * @dev Performs a series of swaps with one or multiple Pools. In each individual swap, the caller determines either * the amount of tokens sent to or received from the Pool, depending on the `kind` value. * * Returns an array with the net Vault asset balance deltas. Positive amounts represent tokens (or ETH) sent to the * Vault, and negative amounts represent tokens (or ETH) sent by the Vault. Each delta corresponds to the asset at * the same index in the `assets` array. * * Swaps are executed sequentially, in the order specified by the `swaps` array. Each array element describes a * Pool, the token to be sent to this Pool, the token to receive from it, and an amount that is either `amountIn` or * `amountOut` depending on the swap kind. * * Multihop swaps can be executed by passing an `amount` value of zero for a swap. This will cause the amount in/out * of the previous swap to be used as the amount in for the current one. In a 'given in' swap, 'tokenIn' must equal * the previous swap's `tokenOut`. For a 'given out' swap, `tokenOut` must equal the previous swap's `tokenIn`. * * The `assets` array contains the addresses of all assets involved in the swaps. These are either token addresses, * or the IAsset sentinel value for ETH (the zero address). Each entry in the `swaps` array specifies tokens in and * out by referencing an index in `assets`. Note that Pools never interact with ETH directly: it will be wrapped to * or unwrapped from WETH by the Vault. * * Internal Balance usage, sender, and recipient are determined by the `funds` struct. The `limits` array specifies * the minimum or maximum amount of each token the vault is allowed to transfer. * * `batchSwap` can be used to make a single swap, like `swap` does, but doing so requires more gas than the * equivalent `swap` call. * * Emits `Swap` events. */ function batchSwap( SwapKind kind, BatchSwapStep[] calldata swaps, IAsset[] calldata assets, FundManagement calldata funds, int[] calldata limits, uint deadline ) external payable returns (int[] memory); /** * @dev Data for each individual swap executed by `batchSwap`. The asset in and out fields are indexes into the * `assets` array passed to that function, and ETH assets are converted to WETH. * * If `amount` is zero, the multihop mechanism is used to determine the actual amount based on the amount in/out * from the previous swap, depending on the swap kind. * * The `userData` field is ignored by the Vault, but forwarded to the Pool in the `onSwap` hook, and may be * used to extend swap behavior. */ struct BatchSwapStep { bytes32 poolId; uint assetInIndex; uint assetOutIndex; uint amount; bytes userData; } /** * @dev Emitted for each individual swap performed by `swap` or `batchSwap`. */ event Swap(bytes32 indexed poolId, IERC20 indexed tokenIn, IERC20 indexed tokenOut, uint amountIn, uint amountOut); /** * @dev All tokens in a swap are either sent from the `sender` account to the Vault, or from the Vault to the * `recipient` account. * * If the caller is not `sender`, it must be an authorized relayer for them. * * If `fromInternalBalance` is true, the `sender`'s Internal Balance will be preferred, performing an ERC20 * transfer for the difference between the requested amount and the User's Internal Balance (if any). The `sender` * must have allowed the Vault to use their tokens via `IERC20.approve()`. This matches the behavior of * `joinPool`. * * If `toInternalBalance` is true, tokens will be deposited to `recipient`'s internal balance instead of * transferred. This matches the behavior of `exitPool`. * * Note that ETH cannot be deposited to or withdrawn from Internal Balance: attempting to do so will trigger a * revert. */ struct FundManagement { address sender; bool fromInternalBalance; address payable recipient; bool toInternalBalance; } /** * @dev Simulates a call to `batchSwap`, returning an array of Vault asset deltas. Calls to `swap` cannot be * simulated directly, but an equivalent `batchSwap` call can and will yield the exact same result. * * Each element in the array corresponds to the asset at the same index, and indicates the number of tokens (or ETH) * the Vault would take from the sender (if positive) or send to the recipient (if negative). The arguments it * receives are the same that an equivalent `batchSwap` call would receive. * * Unlike `batchSwap`, this function performs no checks on the sender or recipient field in the `funds` struct. * This makes it suitable to be called by off-chain applications via eth_call without needing to hold tokens, * approve them for the Vault, or even know a user's address. * * Note that this function is not 'view' (due to implementation details): the client code must explicitly execute * eth_call instead of eth_sendTransaction. */ function queryBatchSwap( SwapKind kind, BatchSwapStep[] calldata swaps, IAsset[] calldata assets, FundManagement calldata funds ) external returns (int[] memory assetDeltas); // BasePool.sol /** * @dev Returns the amount of BPT that would be burned from `sender` if the `onExitPool` hook were called by the * Vault with the same arguments, along with the number of tokens `recipient` would receive. * * This function is not meant to be called directly, but rather from a helper contract that fetches current Vault * data, such as the protocol swap fee percentage and Pool balances. * * Like `IVault.queryBatchSwap`, this function is not view due to internal implementation details: the caller must * explicitly use eth_call instead of eth_sendTransaction. */ function queryExit( bytes32 poolId, address sender, address recipient, uint[] memory balances, uint lastChangeBlock, uint protocolSwapFeePercentage, bytes memory userData ) external returns (uint bptIn, uint[] memory amountsOut); function flashLoan( address recipient, address[] memory tokens, uint[] memory amounts, bytes memory userData ) external; }
// 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) (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-upgradeable/proxy/utils/Initializable.sol"; import "@openzeppelin/contracts/utils/introspection/ERC165.sol"; import "../libs/SlotsLib.sol"; import "../../interfaces/IControllable.sol"; import "../../interfaces/IPlatform.sol"; /// @dev Base core contract. /// It store an immutable platform proxy address in the storage and provides access control to inherited contracts. /// @author Alien Deployer (https://github.com/a17) /// @author 0xhokugava (https://github.com/0xhokugava) abstract contract Controllable is Initializable, IControllable, ERC165 { using SlotsLib for bytes32; string public constant CONTROLLABLE_VERSION = "1.0.0"; bytes32 internal constant _PLATFORM_SLOT = bytes32(uint(keccak256("eip1967.controllable.platform")) - 1); bytes32 internal constant _CREATED_BLOCK_SLOT = bytes32(uint(keccak256("eip1967.controllable.created_block")) - 1); /// @dev Prevent implementation init constructor() { _disableInitializers(); } /// @notice Initialize contract after setup it as proxy implementation /// Save block.timestamp in the "created" variable /// @dev Use it only once after first logic setup /// @param platform_ Platform address //slither-disable-next-line naming-convention function __Controllable_init(address platform_) internal onlyInitializing { if (platform_ == address(0) || IPlatform(platform_).multisig() == address(0)) { revert IncorrectZeroArgument(); } SlotsLib.set(_PLATFORM_SLOT, platform_); // syntax for forge coverage _CREATED_BLOCK_SLOT.set(block.number); emit ContractInitialized(platform_, block.timestamp, block.number); } modifier onlyGovernance() { _requireGovernance(); _; } modifier onlyMultisig() { _requireMultisig(); _; } modifier onlyGovernanceOrMultisig() { _requireGovernanceOrMultisig(); _; } modifier onlyOperator() { _requireOperator(); _; } modifier onlyFactory() { _requireFactory(); _; } // ************* SETTERS/GETTERS ******************* /// @inheritdoc IControllable function platform() public view override returns (address) { return _PLATFORM_SLOT.getAddress(); } /// @inheritdoc IControllable function createdBlock() external view override returns (uint) { return _CREATED_BLOCK_SLOT.getUint(); } /// @inheritdoc IERC165 function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IControllable).interfaceId || super.supportsInterface(interfaceId); } function _requireGovernance() internal view { if (IPlatform(platform()).governance() != msg.sender) { revert NotGovernance(); } } function _requireMultisig() internal view { if (!IPlatform(platform()).isOperator(msg.sender)) { revert NotMultisig(); } } function _requireGovernanceOrMultisig() internal view { IPlatform _platform = IPlatform(platform()); // nosemgrep if (_platform.governance() != msg.sender && _platform.multisig() != msg.sender) { revert NotGovernanceAndNotMultisig(); } } function _requireOperator() internal view { if (!IPlatform(platform()).isOperator(msg.sender)) { revert NotOperator(); } } function _requireFactory() internal view { if (IPlatform(platform()).factory() != msg.sender) { revert NotFactory(); } } }
// 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 "./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 // 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 pragma solidity ^0.8.23; /// @dev HardWork resolver and caller. Primary executor is server script, reserve executor is Gelato Automate. /// Hardwork is important task of any vault - claiming revenue and processing it by strategy, updating rewarding, /// compounding, declaring income and losses, related things. /// @author Alien Deployer (https://github.com/a17) /// @author JodsMigel (https://github.com/JodsMigel) interface IHardWorker { //region ----- Custom Errors ----- error NotExistWithObject(address notExistObject); error AlreadyExclude(address alreadyExcludedObject); error NotServerOrGelato(); error NotEnoughETH(); //endregion ----- Custom Errors ----- event Call(uint hardworks, uint gasUsed, uint gasCost, bool server); event DedicatedServerMsgSender(address indexed sender, bool allowed); event DedicatedGelatoMsgSender(address oldSender, address newSender); event Delays(uint delayServer, uint delayGelato); event GelatoTask(bytes32 id); event GelatoDeposit(uint amount); event MaxHwPerCall(uint maxHwPerCall_); event VaultExcludeStatusChanged(address vault, bool status); function getDelays() external view returns (uint delayServer, uint delayGelato); /// @notice Vaults that excluded from HardWork execution function excludedVaults(address vault) external view returns (bool); /// @notice Maximum vault HardWork calls per execution function maxHwPerCall() external view returns (uint); /// @notice Check dedicated server address allowance for execute vault HardWorks function dedicatedServerMsgSender(address sender) external view returns (bool allowed); /// @notice Dedicated Gelato OPS proxy for HardWorker contract address. /// OPS proxy is deployed at HardWorker initialization. /// @return Immutable Gelato dedicated msg.sender function dedicatedGelatoMsgSender() external view returns (address); /// @notice Checker method for calling from server script /// @return canExec Hard Work can be executed /// @return execPayload Vault addresses for HardWork function checkerServer() external view returns (bool canExec, bytes memory execPayload); /// @notice Checker method for calling from Gelato Automate /// @return canExec Hard Work can be executed /// @return execPayload Vault addresses for HardWork function checkerGelato() external view returns (bool canExec, bytes memory execPayload); /// @notice Gelato Automate task ID created by this contract function gelatoTaskId() external view returns (bytes32); /// @notice ETH balance of HardWork contract on Gelato /// @return ETH amount with 18 decimals function gelatoBalance() external view returns (uint); /// @notice Return minimum required ETH balance of HardWork contract on Gelato /// @return ETH amount with 18 decimals function gelatoMinBalance() external view returns (uint); /// @notice Setup allowance status for dedicated server address function setDedicatedServerMsgSender(address sender, bool allowed) external; /// @notice Setup delays between HardWorks in seconds /// @param delayServer_ Delay for server script /// @param delayGelato_ Delay for Gelato function setDelays(uint delayServer_, uint delayGelato_) external; /// @notice Set maximum vault HardWork calls per execution /// Only operator cal call this /// @param maxHwPerCall_ Max vault HardWorks per call(vaults) execution //slither-disable-next-line similar-names function setMaxHwPerCall(uint maxHwPerCall_) external; /// @notice Changing vault excluding status /// @param vaults_ Addresses of vaults /// @param status New status function changeVaultExcludeStatus(address[] memory vaults_, bool[] memory status) external; /// @notice Call vault HardWorks /// @param vaults Addresses of vault from checkerServer/checkerGelato output function call(address[] memory vaults) external; }
// 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; 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; /// @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 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 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 // 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 // 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) (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/introspection/ERC165.sol) pragma solidity ^0.8.20; import {IERC165} from "./IERC165.sol"; /** * @dev Implementation of the {IERC165} interface. * * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check * for the additional interface id that will be supported. For example: * * ```solidity * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId); * } * ``` */ abstract contract ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) { return interfaceId == type(IERC165).interfaceId; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; /// @title Minimal library for setting / getting slot variables (used in upgradable proxy contracts) library SlotsLib { /// @dev Gets a slot as an address function getAddress(bytes32 slot) internal view returns (address result) { assembly { result := sload(slot) } } /// @dev Gets a slot as uint256 function getUint(bytes32 slot) internal view returns (uint result) { assembly { result := sload(slot) } } /// @dev Sets a slot with address /// @notice Check address for 0 at the setter function set(bytes32 slot, address value) internal { assembly { sstore(slot, value) } } /// @dev Sets a slot with uint function set(bytes32 slot, uint value) internal { assembly { sstore(slot, value) } } }
// 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) (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 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) (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":"AlreadyExist","type":"error"},{"inputs":[],"name":"ETHTransferFailed","type":"error"},{"inputs":[],"name":"FailedInnerCall","type":"error"},{"inputs":[],"name":"IncorrectArrayLength","type":"error"},{"inputs":[],"name":"IncorrectInitParams","type":"error"},{"inputs":[],"name":"IncorrectMsgSender","type":"error"},{"inputs":[],"name":"IncorrectZeroArgument","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[],"name":"NotExist","type":"error"},{"inputs":[],"name":"NotFactory","type":"error"},{"inputs":[],"name":"NotGovernance","type":"error"},{"inputs":[],"name":"NotGovernanceAndNotMultisig","type":"error"},{"inputs":[],"name":"NotInitializing","type":"error"},{"inputs":[],"name":"NotMultisig","type":"error"},{"inputs":[],"name":"NotOperator","type":"error"},{"inputs":[],"name":"NotPlatform","type":"error"},{"inputs":[],"name":"NotReadyForHardWork","type":"error"},{"inputs":[],"name":"NotTheOwner","type":"error"},{"inputs":[],"name":"NotVault","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"SafeERC20FailedOperation","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"platform","type":"address"},{"indexed":false,"internalType":"uint256","name":"ts","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"block","type":"uint256"}],"name":"ContractInitialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"vaultManagerReceiverFee","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"strategyLogicReceiverFee","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"ecosystemRevenueReceiverFee","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"multisigReceiverFee","type":"uint256"}],"name":"ExtractFees","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"apr","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"compoundApr","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"earned","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"tvl","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"duration","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"sharePrice","type":"uint256"},{"indexed":false,"internalType":"uint256[]","name":"assetPrices","type":"uint256[]"}],"name":"HardWork","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"int256","name":"realApr","type":"int256"},{"indexed":false,"internalType":"int256","name":"earned","type":"int256"},{"indexed":false,"internalType":"uint256","name":"realTvl","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"duration","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"realSharePrice","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"supplyApr","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"borrowApr","type":"uint256"}],"name":"LeverageLendingHardWork","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"ltv","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"leverage","type":"uint256"}],"name":"LeverageLendingHealth","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"TargetLeveragePercent","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256[]","name":"params","type":"uint256[]"}],"name":"UniversalParams","type":"event"},{"inputs":[],"name":"CONTROLLABLE_VERSION","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VERSION","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VERSION_LEVERAGE_LENDING_STRATEGY_BASE","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VERSION_STRATEGY_BASE","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"assets","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"assetsAmounts","outputs":[{"internalType":"address[]","name":"assets_","type":"address[]"},{"internalType":"uint256[]","name":"amounts_","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"autoCompoundingByUnderlyingProtocol","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"createdBlock","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"customPriceImpactTolerance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"depositAssets","outputs":[{"internalType":"uint256","name":"value","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"depositUnderlying","outputs":[{"internalType":"uint256[]","name":"amountsConsumed","type":"uint256[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"description","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"doHardWork","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"emergencyStopInvesting","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"extra","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"getAssetsProportions","outputs":[{"internalType":"uint256[]","name":"proportions","type":"uint256[]"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"getRevenue","outputs":[{"internalType":"address[]","name":"assets_","type":"address[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"getSpecificName","outputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getSupplyAndBorrowAprs","outputs":[{"internalType":"uint256","name":"supplyApr","type":"uint256"},{"internalType":"uint256","name":"borrowApr","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"health","outputs":[{"internalType":"uint256","name":"ltv","type":"uint256"},{"internalType":"uint256","name":"maxLtv","type":"uint256"},{"internalType":"uint256","name":"leverage","type":"uint256"},{"internalType":"uint256","name":"collateralAmount","type":"uint256"},{"internalType":"uint256","name":"debtAmount","type":"uint256"},{"internalType":"uint256","name":"targetLeveragePercent","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"platform_","type":"address"}],"name":"initVariants","outputs":[{"internalType":"string[]","name":"variants","type":"string[]"},{"internalType":"address[]","name":"addresses","type":"address[]"},{"internalType":"uint256[]","name":"nums","type":"uint256[]"},{"internalType":"int24[]","name":"ticks","type":"int24[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"addresses","type":"address[]"},{"internalType":"uint256[]","name":"nums","type":"uint256[]"},{"internalType":"int24[]","name":"ticks","type":"int24[]"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"isHardWorkOnDepositAllowed","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"isReadyForHardWork","outputs":[{"internalType":"bool","name":"isReady","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"lastApr","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lastAprCompound","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lastHardWork","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"platform","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"assets_","type":"address[]"},{"internalType":"uint256[]","name":"amountsMax","type":"uint256[]"}],"name":"previewDepositAssets","outputs":[{"internalType":"uint256[]","name":"amountsConsumed","type":"uint256[]"},{"internalType":"uint256","name":"value","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"assets_","type":"address[]"},{"internalType":"uint256[]","name":"amountsMax","type":"uint256[]"}],"name":"previewDepositAssetsWrite","outputs":[{"internalType":"uint256[]","name":"amountsConsumed","type":"uint256[]"},{"internalType":"uint256","name":"value","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"realSharePrice","outputs":[{"internalType":"uint256","name":"sharePrice","type":"uint256"},{"internalType":"bool","name":"trusted","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"realTvl","outputs":[{"internalType":"uint256","name":"tvl","type":"uint256"},{"internalType":"bool","name":"trusted","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"newLtv","type":"uint256"}],"name":"rebalanceDebt","outputs":[{"internalType":"uint256","name":"resultLtv","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"tokens","type":"address[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"},{"internalType":"uint256[]","name":"feeAmounts","type":"uint256[]"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"receiveFlashLoan","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"priceImpactTolerance","type":"uint256"}],"name":"setCustomPriceImpactTolerance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"value","type":"uint256"}],"name":"setTargetLeveragePercent","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"params","type":"uint256[]"}],"name":"setUniversalParams","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"strategyLogicId","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"supportedVaultTypes","outputs":[{"internalType":"string[]","name":"types","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"total","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"total_","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"transferAssets","outputs":[{"internalType":"uint256[]","name":"amountsOut","type":"uint256[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"underlying","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"vault","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"assets_","type":"address[]"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"withdrawAssets","outputs":[{"internalType":"uint256[]","name":"amountsOut","type":"uint256[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"withdrawUnderlying","outputs":[],"stateMutability":"nonpayable","type":"function"}]
Contract Creation Code
608060405234801562000010575f80fd5b506200001b62000021565b620000d5565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00805468010000000000000000900460ff1615620000725760405163f92ee8a960e01b815260040160405180910390fd5b80546001600160401b0390811614620000d25780546001600160401b0319166001600160401b0390811782556040519081527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b50565b615bb180620000e35f395ff3fe608060405234801561000f575f80fd5b5060043610610281575f3560e01c80636f307dc311610156578063b9f5be41116100ca578063f1faf05011610084578063f1faf050146105bd578063f815c4ff146105c5578063f985b0bc146105cd578063fbfa77cf146105e0578063fdff667c146105e8578063ffa1ad74146105fd575f80fd5b8063b9f5be4114610542578063bd5a746814610555578063c322004514610568578063d91c8f6514610585578063eb42d0f3146105a2578063f04f2707146105aa575f80fd5b8063936725ec1161011b578063936725ec146104e55780639736374e146104a957806399f428cf14610509578063a2b7722c1461051c578063b600585a1461052f578063b6c8cdef146104a9575f80fd5b80636f307dc31461048457806371a973051461048c5780637284e416146104a157806374bac429146104a95780637633a22c146104b0575f80fd5b80634593144c116101f857806359498ab7116101b257806359498ab7146104145780635b0f088a1461041c5780635e210de41461044057806367cf905a1461045357806367fde5731461045b5780636d98943914610463575f80fd5b80634593144c146103805780634875c9681461038857806348d7d9eb146103ba5780634bde38c8146103cc5780634fa5d854146103ec57806350f4e419146103f4575f80fd5b80631ec71e05116102495780631ec71e0514610304578063216cdea71461031a57806323a2f9e01461032d5780632d433b28146103425780632ddbd13a1461036557806341affeb81461036d575f80fd5b806301ffc9a71461028557806313e63180146102ad5780631639ba98146102c357806318666357146102cb578063190024e0146102fc575b5f80fd5b610298610293366004614ab8565b610621565b60405190151581526020015b60405180910390f35b6102b561064b565b6040519081526020016102a4565b6102b561065d565b6102ef604051806040016040528060058152602001640312e312e360dc1b81525081565b6040516102a49190614b2c565b6102b561066f565b61030c610713565b6040516102a4929190614b3e565b6102b5610328366004614b61565b6109bb565b61034061033b366004614b61565b610ba8565b005b610355610350366004614b8c565b610c1b565b6040516102a49493929190614c71565b6102b56111a0565b61034061037b366004614e60565b6111b2565b6102b561175f565b60408051808201909152601681527553696c6f20416476616e636564204c6576657261676560501b60208201526102ef565b6060805b6040516102a4929190614f3e565b6103d4611792565b6040516001600160a01b0390911681526020016102a4565b6103406117c1565b610407610402366004614f62565b611ac3565b6040516102a49190614fb8565b6103be611ae2565b6102ef60405180604001604052806005815260200164191718971960d91b81525081565b61034061044e366004614fca565b611b74565b610407611d19565b610340611d65565b610476610471366004615003565b611d81565b6040516102a4929190615062565b6103d4611e86565b610494611ea1565b6040516102a49190615083565b6102ef611f0a565b6001610298565b6104b8611f5b565b604080519687526020870195909552938501929092526060840152608083015260a082015260c0016102a4565b6102ef604051806040016040528060058152602001640312e302e360dc1b81525081565b610340610517366004615095565b612012565b6102b561052a366004614fca565b612028565b61047661053d366004615003565b612062565b610407610550366004614b61565b61214f565b610340610563366004614b61565b612162565b61057061217d565b604080519283526020830191909152016102a4565b61058d6121df565b604080519283529015156020830152016102a4565b61058d61227d565b6103406105b83660046150e9565b612322565b6102b561241c565b6102b561242e565b6104076105db3660046151c9565b612440565b6103d46124e9565b6105f0612501565b6040516102a491906151f4565b6102ef60405180604001604052806005815260200164312e302e3160d81b81525081565b5f6001600160e01b031982166336e835d760e21b1480610645575061064582612573565b92915050565b5f610654612597565b60020154905090565b5f610666612597565b60090154905090565b604080516001600160e81b031960208201525f6023820181905282516006818403018152602683019384905263bfe370d960e01b909352917374f98426d3aca169fe2a9bd0e2063768c4b3a1029163bfe370d9916106cf91602a01614b2c565b602060405180830381865af41580156106ea573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061070e9190615206565b905090565b5f80516020615b3c83398151915254604080516379502c5560e01b815290516060925f925f80516020615b1c833981519152926001600160a01b0390921691849183916379502c55916004808201926020929091908290030181865afa15801561077f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906107a3919061521d565b6001600160a01b031663189e17e46040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107de573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906108029190615206565b90505f836001015f9054906101000a90046001600160a01b03166001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015610856573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f1916820160405261087d9190810190615238565b600885015460405163dd081d8b60e01b81526001600160a01b038616600482015260248101919091529091505f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb19063dd081d8b90604401606060405180830381865af41580156108e5573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061090991906152a0565b60405163be59b50760e01b8152600481018790529093507374f98426d3aca169fe2a9bd0e2063768c4b3a102925063be59b50791506024015f60405180830381865af415801561095b573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526109829190810190615238565b8261098c836125bb565b60405160200161099e939291906152cb565b6040516020818303038152906040525f9650965050505050509091565b5f806109c5611792565b90505f816001600160a01b031663396656406040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a04573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a28919061521d565b90505f826001600160a01b03166301d22ccd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a67573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a8b919061521d565b9050336001600160a01b03821614801590610b0957506040516336b87bd760e11b81523360048201526001600160a01b03841690636d70f7ae90602401602060405180830381865afa158015610ae3573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b079190615333565b155b8015610b785750604051630e19abf360e01b81523360048201526001600160a01b03831690630e19abf390602401602060405180830381865afa158015610b52573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b769190615333565b155b15610b96576040516370a8bfcd60e11b815260040160405180910390fd5b610b9f85612704565b95945050505050565b610bb0612ac7565b7fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f7088190556040518181525f80516020615b1c833981519152907f2bdd781a443b30701c9ab6bf87f6cb0d8424bf4f343f2eb4bb49e815193d80d2906020015b60405180910390a15050565b6060806060805f856001600160a01b031663c45a01556040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c5e573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610c82919061521d565b6001600160a01b0316639ad87ce4610cc360408051808201909152601681527553696c6f20416476616e636564204c6576657261676560501b602082015290565b805190602001206040518263ffffffff1660e01b8152600401610ce891815260200190565b5f60405180830381865afa158015610d02573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052610d29919081019061540d565b90505f6004825f015151610d3d919061552b565b9050806001600160401b03811115610d5757610d57614cf3565b604051908082528060200260200182016040528015610d8a57816020015b6060815260200190600190039081610d755790505b509550610d9881600461554a565b6001600160401b03811115610daf57610daf614cf3565b604051908082528060200260200182016040528015610dd8578160200160208202803683370190505b509450806001600160401b03811115610df357610df3614cf3565b604051908082528060200260200182016040528015610e1c578160200160208202803683370190505b50604080515f808252602082019092529195509093505b818110156111965782515f90610e4a83600261554a565b81518110610e5a57610e5a615561565b60200260200101516001600160a01b03166338d52e0f6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610e9d573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610ec1919061521d565b84519091505f90610ed384600261554a565b610ede906001615575565b81518110610eee57610eee615561565b60200260200101516001600160a01b03166338d52e0f6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f31573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610f55919061521d565b8551909150610f8890610f6985600261554a565b81518110610f7957610f79615561565b60200260200101518383612b56565b898481518110610f9a57610f9a615561565b60209081029190910101528451610fb284600261554a565b81518110610fc257610fc2615561565b602002602001015188846002610fd8919061554a565b81518110610fe857610fe8615561565b6001600160a01b0390921660209283029190910190910152845161100d84600261554a565b611018906001615575565b8151811061102857611028615561565b60200260200101518884600261103e919061554a565b611049906001615575565b8151811061105957611059615561565b6001600160a01b0390921660209283029190910190910152845161107e84600261554a565b611089906002615575565b8151811061109957611099615561565b6020026020010151888460026110af919061554a565b6110ba906002615575565b815181106110ca576110ca615561565b6001600160a01b039092166020928302919091019091015284516110ef84600261554a565b6110fa906003615575565b8151811061110a5761110a615561565b602002602001015188846002611120919061554a565b61112b906003615575565b8151811061113b5761113b615561565b6001600160a01b0390921660209283029190910182015285015180518490811061116757611167615561565b602002602001015187848151811061118157611181615561565b60209081029190910101525050600101610e33565b5050509193509193565b5f6111a9612597565b60010154905090565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff1615906001600160401b03165f811580156111f65750825b90505f826001600160401b031660011480156112115750303b155b90508115801561121f575080155b1561123d5760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff19166001178555831561126757845460ff60401b1916600160401b1785555b8751600614158061127a57508651600114155b806112855750855115155b156112a3576040516363cf6b6160e01b815260040160405180910390fd5b604080516101408101825260608082525f6020830181905292820183905281018290526080810182905260a0810182905260c0810182905260e081018290526101008101829052610120810191909152885f8151811061130557611305615561565b6020908102919091018101516001600160a01b03169082015288518990600190811061133357611333615561565b60209081029190910101516001600160a01b0316604082015288518990600290811061136157611361615561565b60200260200101516001600160a01b03166338d52e0f6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156113a4573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906113c8919061521d565b6001600160a01b031660608201528851899060039081106113eb576113eb615561565b60200260200101516001600160a01b03166338d52e0f6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561142e573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611452919061521d565b6001600160a01b0316608082015288518990600290811061147557611475615561565b60209081029190910101516001600160a01b031660a08201528851899060039081106114a3576114a3615561565b60209081029190910101516001600160a01b031660c08201528851899060049081106114d1576114d1615561565b60209081029190910101516001600160a01b031660e08201528851899060059081106114ff576114ff615561565b60209081029190910101516001600160a01b0316610100820152875188905f9061152b5761152b615561565b60200260200101518161012001818152505061154681612d7d565b61156d8160a001515f1983606001516001600160a01b0316612f2e9092919063ffffffff16565b6115948160c001515f1983608001516001600160a01b0316612f2e9092919063ffffffff16565b5f81602001516001600160a01b0316632b3297f96040518163ffffffff1660e01b8152600401602060405180830381865afa1580156115d5573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906115f9919061521d565b6060830151909150611616906001600160a01b0316825f19612f2e565b6080820151611630906001600160a01b0316825f19612f2e565b505061272e7fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f709556127607fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f70d556126ac7fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f70e556127747fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f70f556103e87fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f7118190557fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f71255831561175557845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b5f61070e61178e60017f812a673dfca07956350df10f8a654925f561d7a0da09bdbe79e653939a14d9f1615588565b5490565b5f61070e61178e60017faa116a42804728f23983458454b6eb9c6ddf3011db9f9addaf3cd7508d85b0d6615588565b6117c9612ff1565b6117d1613022565b5f6117da612597565b805460408051637299470360e11b815281519394506001600160a01b03909216925f92849263e5328e06926004808401938290030181865afa158015611822573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611846919061559b565b5090508015611abe575f611858611792565b60088501549091505f80808061186c61309f565b93509350935093505f61187d600190565b61195b5761189d85878151811061189657611896615561565b505f919050565b8487815181106118af576118af615561565b602002602001018181516118c39190615575565b915081815250505f7323bb12c39eb120cc055567557dd190db388af0266356cd528e898c8e6007018a8a6040518663ffffffff1660e01b815260040161190d9594939291906155fd565b5f60405180830381865af4158015611927573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f1916820160405261194e91908101906156cd565b5050506001890154611a49565b604051633596603f60e01b81527323bb12c39eb120cc055567557dd190db388af02690633596603f90611992908790600401614fb8565b602060405180830381865af41580156119ad573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906119d19190615333565b15611a32576040516336ac731760e11b81526001600160a01b038a1690636d58e62e90611a049088908890600401614f3e565b5f604051808303815f87803b158015611a1b575f80fd5b505af1158015611a2d573d5f803e3d5ffd5b505050505b611a47855f8151811061189657611896615561565b505b60405163640f244560e01b81527323bb12c39eb120cc055567557dd190db388af0269063640f244590611a8a908d908b908a908a908f9089906004016156fe565b5f6040518083038186803b158015611aa0575f80fd5b505af4158015611ab2573d5f803e3d5ffd5b50505050505050505050505b505050565b6060611acd612ff1565b611ad884848461351e565b90505b9392505050565b606080611aed61352a565b604051633f8b51a560e21b815291935091507323bb12c39eb120cc055567557dd190db388af0269063fe2d469490611b2b9085908590600401614f3e565b5f60405180830381865af4158015611b45573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052611b6c919081019061574f565b915091509091565b611b7c612ac7565b5f5f80516020615b1c8339815191529050815f81518110611b9f57611b9f615561565b6020026020010151816009018190555081600181518110611bc257611bc2615561565b602002602001015181600a018190555081600281518110611be557611be5615561565b602002602001015181600b018190555081600381518110611c0857611c08615561565b602002602001015181600c018190555081600481518110611c2b57611c2b615561565b602002602001015181600d018190555081600581518110611c4e57611c4e615561565b602002602001015181600e018190555081600681518110611c7157611c71615561565b602002602001015181600f018190555081600781518110611c9457611c94615561565b6020026020010151816010018190555081600881518110611cb757611cb7615561565b6020026020010151816011018190555081600981518110611cda57611cda615561565b602002602001015181601201819055507f108a9433cbd0bc99fd766b6026503c733edf97f6052da62a8c299e2cd9fb73ee82604051610c0f9190614fb8565b60408051600180825281830190925260609160208083019080368337019050509050670de0b6b3a7640000815f81518110611d5657611d56615561565b60200260200101818152505090565b611d6d61360c565b611d7e611d786111a0565b30613727565b50565b60605f83516001148015611dcd5750611d98612597565b6006015484516001600160a01b039091169085905f90611dba57611dba615561565b60200260200101516001600160a01b0316145b8015611e0457505f6001600160a01b0316845f81518110611df057611df0615561565b60200260200101516001600160a01b031614155b15611e70578251600114611e2b57604051630ef9926760e21b815260040160405180910390fd5b825f81518110611e3d57611e3d615561565b60200260200101519050611e69835f81518110611e5c57611e5c615561565b6020026020010151613dbe565b9150611e7f565b611e7a8484613dc6565b915091505b9250929050565b5f611e8f612597565b600601546001600160a01b0316919050565b6060611eab612597565b600501805480602002602001604051908101604052809291908181526020018280548015611f0057602002820191905f5260205f20905b81546001600160a01b03168152600190910190602001808311611ee2575b5050505050905090565b5f80516020615b3c833981519152545f80516020615b1c83398151915280545f80516020615afc83398151915254606093611f55926001600160a01b03918216929082169116612b56565b91505090565b5f80808080805f80516020615b1c83398151915273d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1630f0b0594611f91611792565b6040516001600160e01b031960e084901b1681526001600160a01b0390911660048201526024810184905260440160c060405180830381865af4158015611fda573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611ffe91906157a4565b949c939b5091995097509550909350915050565b61201a612ff1565b6120248282613dd3565b5050565b5f612031612ff1565b5f61203a612597565b905080600201545f0361204e574260028201555b612059836001613e64565b9150505b919050565b60605f835160011480156120ae5750612079612597565b6006015484516001600160a01b039091169085905f9061209b5761209b615561565b60200260200101516001600160a01b0316145b80156120e557505f6001600160a01b0316845f815181106120d1576120d1615561565b60200260200101516001600160a01b031614155b1561214557825160011461210c57604051630ef9926760e21b815260040160405180910390fd5b825f8151811061211e5761211e615561565b60200260200101519050611e69835f8151811061213d5761213d615561565b506060919050565b611e7a84846143c4565b6060612159612ff1565b610645826143d0565b61216a612ac7565b5f612173612597565b6009019190915550565b5f80516020615b5c833981519152545f80516020615b3c833981519152545f80516020615adc833981519152545f9283925f80516020615b1c833981519152926121d6926001600160a01b0390811692811691166143db565b92509250509091565b5f805f80516020615b1c83398151915273d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1635bd923f5612211611792565b6040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602481018490526044016040805180830381865af4158015612259573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906121d6919061559b565b5f805f6122886121df565b925090505f6122956124e9565b6001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156122d0573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906122f49190615206565b9050801561231c578061230f83670de0b6b3a764000061554a565b612319919061552b565b93505b50509091565b5f80516020615b1c83398151915273d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1630dcd3d68612352611792565b83885f8151811061236557612365615561565b6020026020010151885f8151811061237f5761237f615561565b6020026020010151885f8151811061239957612399615561565b60209081029190910101516040516001600160e01b031960e088901b1681526001600160a01b03958616600482015260248101949094529390911660448301526064820152608481019190915260a4015f6040518083038186803b1580156123ff575f80fd5b505af4158015612411573d5f803e3d5ffd5b505050505050505050565b5f612425612597565b60040154905090565b5f612437612597565b60030154905090565b606061244a612ff1565b7323bb12c39eb120cc055567557dd190db388af0266325567aef61246c612597565b6040516001600160e01b031960e084901b168152600481019190915260248101879052604481018690526001600160a01b03851660648201526084015f60405180830381865af41580156124c2573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052611ad891908101906156cd565b5f6124f2612597565b546001600160a01b0316919050565b604080516001808252818301909252606091816020015b60608152602001906001900390816125185790505090506040518060400160405280600b81526020016a436f6d706f756e64696e6760a81b815250815f8151811061256557612565615561565b602002602001018190525090565b5f6001600160e01b03198216631772b5ab60e11b1480610645575061064582614501565b7fb14b643f49bed6a2c6693bbd50f68dc950245db265c66acadbfa51ccc8c3ba0090565b60605f6125ca6127108461552b565b90505f6103e86125dc8361271061554a565b6125e69086615588565b6125f0919061552b565b60405163be59b50760e01b8152600481018490529091507374f98426d3aca169fe2a9bd0e2063768c4b3a1029063be59b507906024015f60405180830381865af4158015612640573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526126679190810190615238565b60405163be59b50760e01b8152600481018390527374f98426d3aca169fe2a9bd0e2063768c4b3a1029063be59b507906024015f60405180830381865af41580156126b4573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526126db9190810190615238565b6040516020016126ec9291906157ea565b60405160208183030381529060405292505050919050565b5f805f80612710611f5b565b5094509450505092505f61272e5f80516020615b1c83398151915290565b6040805160808101825282546001600160a01b03908116825260018401548116602083015260028401548116828401526003840154166060820152905163f91afc8760e01b8152919250905f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb19063f91afc87906127a5908590600401615832565b602060405180830381865af41580156127c0573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906127e49190615206565b90505f6127f389612710615588565b6127ff6127108461554a565b612809919061552b565b60408085015160608601519151633cf7210d60e01b81526001600160a01b039182166004820152911660248201529091505f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb190633cf7210d906044016040805180830381865af4158015612875573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612899919061586d565b5090505f670de0b6b3a7640000826127106128b48e8761554a565b6128be919061552b565b6128c8919061554a565b6128d2919061552b565b6040805160018082528183019092529192505f9190602080830190803683370190505090508560200151815f8151811061290e5761290e615561565b6001600160a01b0392909216602092830291909101909101526040805160018082528183019092525f918160200160208202803683370190505090508a8d10156129c45760058801805460ff60a01b1916600360a01b1790555f612972848b615588565b905080825f8151811061298757612987615561565b6020908102919091010152600f890154612710906129a5888e615588565b6129af919061554a565b6129b9919061552b565b60078a015550612a2b565b60058801805460ff60a01b1916600160a21b1790555f6129e48a85615588565b60068a01819055600d8a015490915061271090612a01908361554a565b612a0b919061552b565b825f81518110612a1d57612a1d615561565b602002602001018181525050505b600480890154604051632e1c224f60e11b81526001600160a01b0390911691635c38449e91612a60913091879187910161588f565b5f604051808303815f87803b158015612a77575f80fd5b505af1158015612a89573d5f803e3d5ffd5b5050505060058801805460ff60a01b19169055612aa4611f5b565b909192935090919250909150905050809c50505050505050505050505050919050565b612acf611792565b6040516336b87bd760e11b81523360048201526001600160a01b039190911690636d70f7ae90602401602060405180830381865afa158015612b13573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612b379190615333565b612b5457604051631f0853c160e21b815260040160405180910390fd5b565b60605f846001600160a01b03166379502c556040518163ffffffff1660e01b8152600401602060405180830381865afa158015612b95573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612bb9919061521d565b6001600160a01b031663189e17e46040518163ffffffff1660e01b8152600401602060405180830381865afa158015612bf4573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612c189190615206565b9050836001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015612c55573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052612c7c9190810190615238565b836001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015612cb7573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052612cde9190810190615238565b60405163be59b50760e01b8152600481018490527374f98426d3aca169fe2a9bd0e2063768c4b3a1029063be59b507906024015f60405180830381865af4158015612d2b573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052612d529190810190615238565b604051602001612d64939291906158df565b6040516020818303038152906040529150509392505050565b612d85614535565b60608101515f80516020615b1c83398151915280546001600160a01b03199081166001600160a01b0393841617825560808401515f80516020615afc8339815191528054831691851691909117905560a08401515f80516020615b3c8339815191528054831691851691909117905560c08401515f80516020615adc8339815191528054831691851691909117905560e08401517fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f704805483169185169190911790556101008401515f80516020615b5c83398151915280549092169316929092179091556101208201517fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f70881905560408051918252517f2bdd781a443b30701c9ab6bf87f6cb0d8424bf4f343f2eb4bb49e815193d80d2916020908290030190a16040805160018082528183019092525f91602080830190803683370190505090508260600151815f81518110612efe57612efe615561565b6001600160a01b0390921660209283029190910182015283015183516040850151611abe929190845f5f1961457e565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663095ea7b360e01b179052612f7f8482614622565b612feb576040516001600160a01b0384811660248301525f6044830152612fe191869182169063095ea7b3906064015b604051602081830303815290604052915060e01b6020820180516001600160e01b0383818316178352505050506146bf565b612feb84826146bf565b50505050565b612ff9612597565b546001600160a01b03163314612b54576040516362df054560e01b815260040160405180910390fd5b306001600160a01b03166374bac4296040518163ffffffff1660e01b8152600401602060405180830381865afa15801561305e573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906130829190615333565b612b54576040516309ea311f60e11b815260040160405180910390fd5b6060806060806130ad611ea1565b604080515f808252602080830191825260018385018181526080850190955294985091955093509091906060850190803683375050604080516080810182525f80516020615b1c83398151915280546001600160a01b0390811683525f80516020615afc83398151915254811660208401525f80516020615b3c833981519152548116938301939093525f80516020615adc8339815191525490921660608201529295509190505f61315d612597565b90505f8160010154905082604001516001600160a01b031663a6afed956040518163ffffffff1660e01b81526004016020604051808303815f875af11580156131a8573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906131cc9190615206565b5082606001516001600160a01b031663a6afed956040518163ffffffff1660e01b81526004016020604051808303815f875af115801561320e573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906132329190615206565b5060405163f91afc8760e01b81525f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb19063f91afc879061326c908790600401615832565b602060405180830381865af4158015613287573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906132ab9190615206565b845160405163e3d670d760e01b81526001600160a01b0390911660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015613304573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906133289190615206565b6133329190615575565b905081811115613365576133468282615588565b885f8151811061335857613358615561565b6020026020010181815250505b600183018190555f6133778383615990565b90505f6133826121df565b5090505f8560020154426133969190615588565b6040516377d6938160e11b81526004810184905260248101859052604481018290529091505f907323bb12c39eb120cc055567557dd190db388af0269063efad270290606401602060405180830381865af41580156133f7573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061341b9190615206565b90505f806134488b6005015f9054906101000a90046001600160a01b03168b604001518c606001516143db565b915091505f61345561227d565b5060408051868152602081018a9052908101889052606081018790526080810182905260a0810185905260c081018490529091507f55b344f7779d44f14b50a9ae3eb0959de12c0956ec73aeddb89c62c0bfce3aad9060e00160405180910390a1505050505050505f806134c7611f5b565b50505092505091507fb83dc6ff11ec1f33d17651f75f3998b69e170ade8f9072b116beaa5e6d037e1e8282604051613509929190918252602082015260400190565b60405180910390a15050505050505090919293565b6060611ad88383613727565b606080613535611ea1565b604080516001808252818301909252919350602080830190803683370190505090505f5f80516020615b1c8339815191526002810154604051633f02cd9160e11b81526001600160a01b03909116600482015290915073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb190637e059b2290602401602060405180830381865af41580156135c5573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906135e99190615206565b825f815181106135fb576135fb615561565b602002602001018181525050509091565b5f613615611792565b9050336001600160a01b0316816001600160a01b0316635aa6e6756040518163ffffffff1660e01b8152600401602060405180830381865afa15801561365d573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613681919061521d565b6001600160a01b0316141580156137095750336001600160a01b0316816001600160a01b0316634783c35b6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156136d9573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906136fd919061521d565b6001600160a01b031614155b15611d7e576040516354299b6f60e01b815260040160405180910390fd5b5f80516020615b5c833981519152805460ff60a01b1916600160a11b179055604080516080810182525f80516020615b1c83398151915280546001600160a01b0390811683525f80516020615afc8339815191525481166020808501919091525f80516020615b3c833981519152548216848601525f80516020615adc8339815191525490911660608481019190915284516001808252818701909652909492939290918281019080368337505060405163f91afc8760e01b81529194505f9173d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1915063f91afc8790613812908590600401615832565b602060405180830381865af415801561382d573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906138519190615206565b825160405163e3d670d760e01b81526001600160a01b0390911660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af41580156138aa573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906138ce9190615206565b6138d89190615575565b90505f8073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb163dd081d8b856040015187600801546040518363ffffffff1660e01b81526004016139319291906001600160a01b03929092168252602082015260400190565b606060405180830381865af415801561394c573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061397091906152a0565b5060408087015160608801519151633cf7210d60e01b81526001600160a01b0391821660048201529116602482015291935091505f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb190633cf7210d906044016040805180830381865af41580156139df573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613a03919061586d565b5090505f612710613a14848c61554a565b613a1e919061552b565b600788018190556040805160018082528183019092529192505f919060208083019080368337019050509050670de0b6b3a76400008381613a5f888661554a565b613a69919061552b565b613a73919061554a565b613a7d919061552b565b815f81518110613a8f57613a8f615561565b60209081029190910101526040805160018082528183019092525f9181602001602082028036833750505060018a015481519192506001600160a01b03169082905f90613ade57613ade615561565b6001600160a01b0392831660209182029290920101526004808b0154604051632e1c224f60e11b8152921691635c38449e91613b20913091869188910161588f565b5f604051808303815f87803b158015613b37575f80fd5b505af1158015613b49573d5f803e3d5ffd5b505060405163f91afc8760e01b81525f955073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1945063f91afc879350613b8992508a9150600401615832565b602060405180830381865af4158015613ba4573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613bc89190615206565b865160405163e3d670d760e01b81526001600160a01b0390911660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015613c21573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613c459190615206565b613c4f9190615575565b865160405163e3d670d760e01b81526001600160a01b0390911660048201529091505f907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015613cad573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613cd19190615206565b905081861115613d1b57613cf8613ce88388615588565b613cf2908d615588565b82614720565b895f81518110613d0a57613d0a615561565b602002602001018181525050613d51565b613d32613d288784615588565b613cf2908d615575565b895f81518110613d4457613d44615561565b6020026020010181815250505b613d8b8a8a5f81518110613d6757613d67615561565b6020026020010151895f01516001600160a01b03166147359092919063ffffffff16565b5f613d94612597565b90508b816001015f828254613da99190615588565b90915550999c9b505050505050505050505050565b606080610645565b60605f611e7a84846143c4565b5f613ddc612597565b600601546001600160a01b031614613e1b576040518060400160405280600f81526020016e1b9bdd081a5b5c1b195b595b9d1959608a1b815250613e42565b6040518060400160405280600d81526020016c6e6f20756e6465726c79696e6760981b8152505b60405162461bcd60e51b8152600401613e5b9190614b2c565b60405180910390fd5b5f80516020615b5c833981519152805460ff60a01b1916600160a01b179055604080516080810182525f80516020615b1c83398151915280546001600160a01b0390811683525f80516020615afc83398151915254811660208401525f80516020615b3c833981519152548116938301939093525f80516020615adc8339815191525490921660608201525f919082613efb611ea1565b90505f73d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb163f91afc87846040518263ffffffff1660e01b8152600401613f359190615832565b602060405180830381865af4158015613f50573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613f749190615206565b7323bb12c39eb120cc055567557dd190db388af02663e3d670d7845f81518110613fa057613fa0615561565b60200260200101516040518263ffffffff1660e01b8152600401613fd391906001600160a01b0391909116815260200190565b602060405180830381865af4158015613fee573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906140129190615206565b61401c9190615575565b6040808501516008870154915163dd081d8b60e01b81526001600160a01b03909116600482015260248101919091529091505f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb19063dd081d8b90604401606060405180830381865af415801561408a573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906140ae91906152a0565b6040805160018082528183019092529194505f9350909150602080830190803683370190505090508460200151815f815181106140ed576140ed615561565b6001600160a01b0392909216602092830291909101909101526040805160018082528183019092525f91816020016020820280368337019050509050612710838b5f8151811061413f5761413f615561565b6020026020010151614151919061554a565b61415b919061552b565b815f8151811061416d5761416d615561565b6020026020010181815250506127108760090154825f8151811061419357614193615561565b60200260200101516141a5919061554a565b6141af919061552b565b6006880155600480880154604051632e1c224f60e11b81526001600160a01b0390911691635c38449e916141e9913091879187910161588f565b5f604051808303815f87803b158015614200575f80fd5b505af1158015614212573d5f803e3d5ffd5b505060405163f91afc8760e01b81525f925073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1915063f91afc879061424f908a90600401615832565b602060405180830381865af415801561426a573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061428e9190615206565b7323bb12c39eb120cc055567557dd190db388af02663e3d670d7885f815181106142ba576142ba615561565b60200260200101516040518263ffffffff1660e01b81526004016142ed91906001600160a01b0391909116815260200190565b602060405180830381865af4158015614308573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061432c9190615206565b6143369190615575565b9050848111156143755761434a8582615588565b8b5f8151811061435c5761435c615561565b602002602001015161436e9190615575565b98506143a6565b61437f8186615588565b8b5f8151811061439157614391615561565b60200260200101516143a39190615588565b98505b5f6143af612597565b905089816001015f828254613da99190615575565b60605f611e7a83614766565b60605f613ddc612597565b6040516327b52bdb60e11b81526001600160a01b0383811660048301525f918291670de0b6b3a764000091620186a091881690634f6a57b690602401602060405180830381865afa158015614432573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906144569190615206565b614460919061554a565b61446a919061552b565b604051620707bd60e51b81526001600160a01b038581166004830152919350670de0b6b3a764000091620186a0919088169062e0f7a090602401602060405180830381865afa1580156144bf573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906144e39190615206565b6144ed919061554a565b6144f7919061552b565b9050935093915050565b5f6001600160e01b03198216630f1ec81f60e41b148061064557506301ffc9a760e01b6001600160e01b0319831614610645565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff16612b5457604051631afcd79f60e31b815260040160405180910390fd5b614586614535565b61458f866147e4565b5f614598612597565b600881018390556006810180546001600160a01b0319166001600160a01b03861617905584519091508690869086908690869060078701905f90889082906145e990600584019060208a0190614a41565b5081546001600160a01b03808a166101009390930a92830292021916179055506146138682615a01565b50505050505050505050505050565b5f805f846001600160a01b03168460405161463d9190615ac0565b5f604051808303815f865af19150503d805f8114614676576040519150601f19603f3d011682016040523d82523d5f602084013e61467b565b606091505b50915091508180156146a55750805115806146a55750808060200190518101906146a59190615333565b8015610b9f5750505050506001600160a01b03163b151590565b5f6146d36001600160a01b0384168361493f565b905080515f141580156146f75750808060200190518101906146f59190615333565b155b15611abe57604051635274afe760e01b81526001600160a01b0384166004820152602401613e5b565b5f81831061472e5781611adb565b5090919050565b6040516001600160a01b03838116602483015260448201839052611abe91859182169063a9059cbb90606401612faf565b6040805160018082528183019092526060915f919060208083019080368337019050509150825f8151811061479d5761479d615561565b6020026020010151825f815181106147b7576147b7615561565b602002602001018181525050815f815181106147d5576147d5615561565b60200260200101519050915091565b6147ec614535565b6001600160a01b038116158061487257505f6001600160a01b0316816001600160a01b0316634783c35b6040518163ffffffff1660e01b8152600401602060405180830381865afa158015614843573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190614867919061521d565b6001600160a01b0316145b15614890576040516371c42ac360e01b815260040160405180910390fd5b6148c36148be60017faa116a42804728f23983458454b6eb9c6ddf3011db9f9addaf3cd7508d85b0d6615588565b829055565b6148f5436148f260017f812a673dfca07956350df10f8a654925f561d7a0da09bdbe79e653939a14d9f1615588565b55565b604080516001600160a01b0383168152426020820152438183015290517f1a2dd071001ebf6e03174e3df5b305795a4ad5d41d8fdb9ba41dbbe2367134269181900360600190a150565b6060611adb83835f845f80856001600160a01b031684866040516149639190615ac0565b5f6040518083038185875af1925050503d805f811461499d576040519150601f19603f3d011682016040523d82523d5f602084013e6149a2565b606091505b50915091506149b28683836149bc565b9695505050505050565b6060826149d1576149cc82614a18565b611adb565b81511580156149e857506001600160a01b0384163b155b15614a1157604051639996b31560e01b81526001600160a01b0385166004820152602401613e5b565b5080611adb565b805115614a285780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b828054828255905f5260205f20908101928215614a94579160200282015b82811115614a9457825182546001600160a01b0319166001600160a01b03909116178255602090920191600190910190614a5f565b50614aa0929150614aa4565b5090565b5b80821115614aa0575f8155600101614aa5565b5f60208284031215614ac8575f80fd5b81356001600160e01b031981168114611adb575f80fd5b5f5b83811015614af9578181015183820152602001614ae1565b50505f910152565b5f8151808452614b18816020860160208601614adf565b601f01601f19169290920160200192915050565b602081525f611adb6020830184614b01565b604081525f614b506040830185614b01565b905082151560208301529392505050565b5f60208284031215614b71575f80fd5b5035919050565b6001600160a01b0381168114611d7e575f80fd5b5f60208284031215614b9c575f80fd5b8135611adb81614b78565b5f8282518085526020808601955060208260051b840101602086015f5b84811015614bf257601f19868403018952614be0838351614b01565b98840198925090830190600101614bc4565b5090979650505050505050565b5f815180845260208085019450602084015f5b83811015614c375781516001600160a01b031687529582019590820190600101614c12565b509495945050505050565b5f815180845260208085019450602084015f5b83811015614c3757815187529582019590820190600101614c55565b608081525f614c836080830187614ba7565b60208382036020850152614c978288614bff565b91508382036040850152614cab8287614c42565b8481036060860152855180825260208088019450909101905f5b81811015614ce457845160020b83529383019391830191600101614cc5565b50909998505050505050505050565b634e487b7160e01b5f52604160045260245ffd5b604051606081016001600160401b0381118282101715614d2957614d29614cf3565b60405290565b604051601f8201601f191681016001600160401b0381118282101715614d5757614d57614cf3565b604052919050565b5f6001600160401b03821115614d7757614d77614cf3565b5060051b60200190565b5f82601f830112614d90575f80fd5b81356020614da5614da083614d5f565b614d2f565b8083825260208201915060208460051b870101935086841115614dc6575f80fd5b602086015b84811015614deb578035614dde81614b78565b8352918301918301614dcb565b509695505050505050565b5f82601f830112614e05575f80fd5b81356020614e15614da083614d5f565b8083825260208201915060208460051b870101935086841115614e36575f80fd5b602086015b84811015614deb5780358352918301918301614e3b565b8060020b8114611d7e575f80fd5b5f805f60608486031215614e72575f80fd5b83356001600160401b0380821115614e88575f80fd5b614e9487838801614d81565b9450602091508186013581811115614eaa575f80fd5b614eb688828901614df6565b945050604086013581811115614eca575f80fd5b86019050601f81018713614edc575f80fd5b8035614eea614da082614d5f565b81815260059190911b82018301908381019089831115614f08575f80fd5b928401925b82841015614f2f578335614f2081614e52565b82529284019290840190614f0d565b80955050505050509250925092565b604081525f614f506040830185614bff565b8281036020840152610b9f8185614c42565b5f805f60608486031215614f74575f80fd5b83356001600160401b03811115614f89575f80fd5b614f9586828701614d81565b935050602084013591506040840135614fad81614b78565b809150509250925092565b602081525f611adb6020830184614c42565b5f60208284031215614fda575f80fd5b81356001600160401b03811115614fef575f80fd5b614ffb84828501614df6565b949350505050565b5f8060408385031215615014575f80fd5b82356001600160401b038082111561502a575f80fd5b61503686838701614d81565b9350602085013591508082111561504b575f80fd5b5061505885828601614df6565b9150509250929050565b604081525f6150746040830185614c42565b90508260208301529392505050565b602081525f611adb6020830184614bff565b5f80604083850312156150a6575f80fd5b8235915060208301356150b881614b78565b809150509250929050565b5f6001600160401b038211156150db576150db614cf3565b50601f01601f191660200190565b5f805f80608085870312156150fc575f80fd5b84356001600160401b0380821115615112575f80fd5b61511e88838901614d81565b95506020870135915080821115615133575f80fd5b61513f88838901614df6565b94506040870135915080821115615154575f80fd5b61516088838901614df6565b93506060870135915080821115615175575f80fd5b508501601f81018713615186575f80fd5b8035615194614da0826150c3565b8181528860208385010111156151a8575f80fd5b816020840160208301375f6020838301015280935050505092959194509250565b5f805f606084860312156151db575f80fd5b83359250602084013591506040840135614fad81614b78565b602081525f611adb6020830184614ba7565b5f60208284031215615216575f80fd5b5051919050565b5f6020828403121561522d575f80fd5b8151611adb81614b78565b5f60208284031215615248575f80fd5b81516001600160401b0381111561525d575f80fd5b8201601f8101841361526d575f80fd5b805161527b614da0826150c3565b81815285602083850101111561528f575f80fd5b610b9f826020830160208601614adf565b5f805f606084860312156152b2575f80fd5b8351925060208401519150604084015190509250925092565b5f84516152dc818460208901614adf565b8083019050600160fd1b80825285516152fc816001850160208a01614adf565b60019201918201528351615317816002840160208801614adf565b0160020195945050505050565b8051801515811461205d575f80fd5b5f60208284031215615343575f80fd5b611adb82615324565b5f82601f83011261535b575f80fd5b8151602061536b614da083614d5f565b8083825260208201915060208460051b87010193508684111561538c575f80fd5b602086015b84811015614deb5780516153a481614b78565b8352918301918301615391565b5f82601f8301126153c0575f80fd5b815160206153d0614da083614d5f565b8083825260208201915060208460051b8701019350868411156153f1575f80fd5b602086015b84811015614deb57805183529183019183016153f6565b5f602080838503121561541e575f80fd5b82516001600160401b0380821115615434575f80fd5b9084019060608287031215615447575f80fd5b61544f614d07565b82518281111561545d575f80fd5b6154698882860161534c565b825250838301518281111561547c575f80fd5b615488888286016153b1565b858301525060408301518281111561549e575f80fd5b80840193505086601f8401126154b2575f80fd5b825191506154c2614da083614d5f565b82815260059290921b830184019184810190888411156154e0575f80fd5b938501935b838510156155075784516154f881614e52565b825293850193908501906154e5565b6040830152509695505050505050565b634e487b7160e01b5f52601160045260245ffd5b5f8261554557634e487b7160e01b5f52601260045260245ffd5b500490565b808202811582820484141761064557610645615517565b634e487b7160e01b5f52603260045260245ffd5b8082018082111561064557610645615517565b8181038181111561064557610645615517565b5f80604083850312156155ac575f80fd5b825191506155bc60208401615324565b90509250929050565b600181811c908216806155d957607f821691505b6020821081036155f757634e487b7160e01b5f52602260045260245ffd5b50919050565b6001600160a01b038681168252851660208083019190915260a0604083015284545f91829161562b816155c5565b8060a087015260c060018084165f811461564c576001811461566857615695565b60ff19851660c08a015260c084151560051b8a01019650615695565b8b5f5260205f205f5b8581101561568c5781548b8201860152908301908701615671565b8a0160c0019750505b50505050505082810360608401526156ad8186614bff565b905082810360808401526156c18185614c42565b98975050505050505050565b5f602082840312156156dd575f80fd5b81516001600160401b038111156156f2575f80fd5b614ffb848285016153b1565b8681526001600160a01b038616602082015260c0604082018190525f9061572790830187614bff565b82810360608401526157398187614c42565b6080840195909552505060a00152949350505050565b5f8060408385031215615760575f80fd5b82516001600160401b0380821115615776575f80fd5b6157828683870161534c565b93506020850151915080821115615797575f80fd5b50615058858286016153b1565b5f805f805f8060c087890312156157b9575f80fd5b865195506020870151945060408701519350606087015192506080870151915060a087015190509295509295509295565b600f60fb1b81525f8351615805816001850160208801614adf565b601760f91b6001918401918201528351615826816002840160208801614adf565b01600201949350505050565b81516001600160a01b039081168252602080840151821690830152604080840151821690830152606092830151169181019190915260800190565b5f806040838503121561587e575f80fd5b505080516020909101519092909150565b6001600160a01b03841681526080602082018190525f906158b290830185614bff565b82810360408401526158c48185614c42565b83810360609094019390935250505f81526020019392505050565b66029bab838363c960cd1b81525f8451615900816007850160208901614adf565b6b01030b732103137b93937bb960a51b600791840191820152845161592c816013840160208901614adf565b7201037b71029b4b637902b191036b0b935b2ba1606d1b601392909101918201528351615960816026840160208801614adf565b752077697468206c65766572616765206c6f6f70696e6760501b60269290910191820152603c0195945050505050565b8181035f8312801583831316838312821617156159af576159af615517565b5092915050565b601f821115611abe57805f5260205f20601f840160051c810160208510156159db5750805b601f840160051c820191505b818110156159fa575f81556001016159e7565b5050505050565b81516001600160401b03811115615a1a57615a1a614cf3565b615a2e81615a2884546155c5565b846159b6565b602080601f831160018114615a61575f8415615a4a5750858301515b5f19600386901b1c1916600185901b178555615ab8565b5f85815260208120601f198616915b82811015615a8f57888601518255948401946001909101908401615a70565b5085821015615aac57878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b5f8251615ad1818460208701614adf565b919091019291505056febcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f703bcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f701bcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f700bcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f702bcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f705a264697066735822122037821627166f850b978824ff16c40c786c8c911f183212e2accc712d9b296bcb64736f6c63430008170033
Deployed Bytecode
0x608060405234801561000f575f80fd5b5060043610610281575f3560e01c80636f307dc311610156578063b9f5be41116100ca578063f1faf05011610084578063f1faf050146105bd578063f815c4ff146105c5578063f985b0bc146105cd578063fbfa77cf146105e0578063fdff667c146105e8578063ffa1ad74146105fd575f80fd5b8063b9f5be4114610542578063bd5a746814610555578063c322004514610568578063d91c8f6514610585578063eb42d0f3146105a2578063f04f2707146105aa575f80fd5b8063936725ec1161011b578063936725ec146104e55780639736374e146104a957806399f428cf14610509578063a2b7722c1461051c578063b600585a1461052f578063b6c8cdef146104a9575f80fd5b80636f307dc31461048457806371a973051461048c5780637284e416146104a157806374bac429146104a95780637633a22c146104b0575f80fd5b80634593144c116101f857806359498ab7116101b257806359498ab7146104145780635b0f088a1461041c5780635e210de41461044057806367cf905a1461045357806367fde5731461045b5780636d98943914610463575f80fd5b80634593144c146103805780634875c9681461038857806348d7d9eb146103ba5780634bde38c8146103cc5780634fa5d854146103ec57806350f4e419146103f4575f80fd5b80631ec71e05116102495780631ec71e0514610304578063216cdea71461031a57806323a2f9e01461032d5780632d433b28146103425780632ddbd13a1461036557806341affeb81461036d575f80fd5b806301ffc9a71461028557806313e63180146102ad5780631639ba98146102c357806318666357146102cb578063190024e0146102fc575b5f80fd5b610298610293366004614ab8565b610621565b60405190151581526020015b60405180910390f35b6102b561064b565b6040519081526020016102a4565b6102b561065d565b6102ef604051806040016040528060058152602001640312e312e360dc1b81525081565b6040516102a49190614b2c565b6102b561066f565b61030c610713565b6040516102a4929190614b3e565b6102b5610328366004614b61565b6109bb565b61034061033b366004614b61565b610ba8565b005b610355610350366004614b8c565b610c1b565b6040516102a49493929190614c71565b6102b56111a0565b61034061037b366004614e60565b6111b2565b6102b561175f565b60408051808201909152601681527553696c6f20416476616e636564204c6576657261676560501b60208201526102ef565b6060805b6040516102a4929190614f3e565b6103d4611792565b6040516001600160a01b0390911681526020016102a4565b6103406117c1565b610407610402366004614f62565b611ac3565b6040516102a49190614fb8565b6103be611ae2565b6102ef60405180604001604052806005815260200164191718971960d91b81525081565b61034061044e366004614fca565b611b74565b610407611d19565b610340611d65565b610476610471366004615003565b611d81565b6040516102a4929190615062565b6103d4611e86565b610494611ea1565b6040516102a49190615083565b6102ef611f0a565b6001610298565b6104b8611f5b565b604080519687526020870195909552938501929092526060840152608083015260a082015260c0016102a4565b6102ef604051806040016040528060058152602001640312e302e360dc1b81525081565b610340610517366004615095565b612012565b6102b561052a366004614fca565b612028565b61047661053d366004615003565b612062565b610407610550366004614b61565b61214f565b610340610563366004614b61565b612162565b61057061217d565b604080519283526020830191909152016102a4565b61058d6121df565b604080519283529015156020830152016102a4565b61058d61227d565b6103406105b83660046150e9565b612322565b6102b561241c565b6102b561242e565b6104076105db3660046151c9565b612440565b6103d46124e9565b6105f0612501565b6040516102a491906151f4565b6102ef60405180604001604052806005815260200164312e302e3160d81b81525081565b5f6001600160e01b031982166336e835d760e21b1480610645575061064582612573565b92915050565b5f610654612597565b60020154905090565b5f610666612597565b60090154905090565b604080516001600160e81b031960208201525f6023820181905282516006818403018152602683019384905263bfe370d960e01b909352917374f98426d3aca169fe2a9bd0e2063768c4b3a1029163bfe370d9916106cf91602a01614b2c565b602060405180830381865af41580156106ea573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061070e9190615206565b905090565b5f80516020615b3c83398151915254604080516379502c5560e01b815290516060925f925f80516020615b1c833981519152926001600160a01b0390921691849183916379502c55916004808201926020929091908290030181865afa15801561077f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906107a3919061521d565b6001600160a01b031663189e17e46040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107de573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906108029190615206565b90505f836001015f9054906101000a90046001600160a01b03166001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015610856573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f1916820160405261087d9190810190615238565b600885015460405163dd081d8b60e01b81526001600160a01b038616600482015260248101919091529091505f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb19063dd081d8b90604401606060405180830381865af41580156108e5573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061090991906152a0565b60405163be59b50760e01b8152600481018790529093507374f98426d3aca169fe2a9bd0e2063768c4b3a102925063be59b50791506024015f60405180830381865af415801561095b573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526109829190810190615238565b8261098c836125bb565b60405160200161099e939291906152cb565b6040516020818303038152906040525f9650965050505050509091565b5f806109c5611792565b90505f816001600160a01b031663396656406040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a04573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a28919061521d565b90505f826001600160a01b03166301d22ccd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a67573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a8b919061521d565b9050336001600160a01b03821614801590610b0957506040516336b87bd760e11b81523360048201526001600160a01b03841690636d70f7ae90602401602060405180830381865afa158015610ae3573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b079190615333565b155b8015610b785750604051630e19abf360e01b81523360048201526001600160a01b03831690630e19abf390602401602060405180830381865afa158015610b52573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b769190615333565b155b15610b96576040516370a8bfcd60e11b815260040160405180910390fd5b610b9f85612704565b95945050505050565b610bb0612ac7565b7fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f7088190556040518181525f80516020615b1c833981519152907f2bdd781a443b30701c9ab6bf87f6cb0d8424bf4f343f2eb4bb49e815193d80d2906020015b60405180910390a15050565b6060806060805f856001600160a01b031663c45a01556040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c5e573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610c82919061521d565b6001600160a01b0316639ad87ce4610cc360408051808201909152601681527553696c6f20416476616e636564204c6576657261676560501b602082015290565b805190602001206040518263ffffffff1660e01b8152600401610ce891815260200190565b5f60405180830381865afa158015610d02573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052610d29919081019061540d565b90505f6004825f015151610d3d919061552b565b9050806001600160401b03811115610d5757610d57614cf3565b604051908082528060200260200182016040528015610d8a57816020015b6060815260200190600190039081610d755790505b509550610d9881600461554a565b6001600160401b03811115610daf57610daf614cf3565b604051908082528060200260200182016040528015610dd8578160200160208202803683370190505b509450806001600160401b03811115610df357610df3614cf3565b604051908082528060200260200182016040528015610e1c578160200160208202803683370190505b50604080515f808252602082019092529195509093505b818110156111965782515f90610e4a83600261554a565b81518110610e5a57610e5a615561565b60200260200101516001600160a01b03166338d52e0f6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610e9d573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610ec1919061521d565b84519091505f90610ed384600261554a565b610ede906001615575565b81518110610eee57610eee615561565b60200260200101516001600160a01b03166338d52e0f6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f31573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610f55919061521d565b8551909150610f8890610f6985600261554a565b81518110610f7957610f79615561565b60200260200101518383612b56565b898481518110610f9a57610f9a615561565b60209081029190910101528451610fb284600261554a565b81518110610fc257610fc2615561565b602002602001015188846002610fd8919061554a565b81518110610fe857610fe8615561565b6001600160a01b0390921660209283029190910190910152845161100d84600261554a565b611018906001615575565b8151811061102857611028615561565b60200260200101518884600261103e919061554a565b611049906001615575565b8151811061105957611059615561565b6001600160a01b0390921660209283029190910190910152845161107e84600261554a565b611089906002615575565b8151811061109957611099615561565b6020026020010151888460026110af919061554a565b6110ba906002615575565b815181106110ca576110ca615561565b6001600160a01b039092166020928302919091019091015284516110ef84600261554a565b6110fa906003615575565b8151811061110a5761110a615561565b602002602001015188846002611120919061554a565b61112b906003615575565b8151811061113b5761113b615561565b6001600160a01b0390921660209283029190910182015285015180518490811061116757611167615561565b602002602001015187848151811061118157611181615561565b60209081029190910101525050600101610e33565b5050509193509193565b5f6111a9612597565b60010154905090565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff1615906001600160401b03165f811580156111f65750825b90505f826001600160401b031660011480156112115750303b155b90508115801561121f575080155b1561123d5760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff19166001178555831561126757845460ff60401b1916600160401b1785555b8751600614158061127a57508651600114155b806112855750855115155b156112a3576040516363cf6b6160e01b815260040160405180910390fd5b604080516101408101825260608082525f6020830181905292820183905281018290526080810182905260a0810182905260c0810182905260e081018290526101008101829052610120810191909152885f8151811061130557611305615561565b6020908102919091018101516001600160a01b03169082015288518990600190811061133357611333615561565b60209081029190910101516001600160a01b0316604082015288518990600290811061136157611361615561565b60200260200101516001600160a01b03166338d52e0f6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156113a4573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906113c8919061521d565b6001600160a01b031660608201528851899060039081106113eb576113eb615561565b60200260200101516001600160a01b03166338d52e0f6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561142e573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611452919061521d565b6001600160a01b0316608082015288518990600290811061147557611475615561565b60209081029190910101516001600160a01b031660a08201528851899060039081106114a3576114a3615561565b60209081029190910101516001600160a01b031660c08201528851899060049081106114d1576114d1615561565b60209081029190910101516001600160a01b031660e08201528851899060059081106114ff576114ff615561565b60209081029190910101516001600160a01b0316610100820152875188905f9061152b5761152b615561565b60200260200101518161012001818152505061154681612d7d565b61156d8160a001515f1983606001516001600160a01b0316612f2e9092919063ffffffff16565b6115948160c001515f1983608001516001600160a01b0316612f2e9092919063ffffffff16565b5f81602001516001600160a01b0316632b3297f96040518163ffffffff1660e01b8152600401602060405180830381865afa1580156115d5573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906115f9919061521d565b6060830151909150611616906001600160a01b0316825f19612f2e565b6080820151611630906001600160a01b0316825f19612f2e565b505061272e7fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f709556127607fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f70d556126ac7fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f70e556127747fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f70f556103e87fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f7118190557fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f71255831561175557845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b5f61070e61178e60017f812a673dfca07956350df10f8a654925f561d7a0da09bdbe79e653939a14d9f1615588565b5490565b5f61070e61178e60017faa116a42804728f23983458454b6eb9c6ddf3011db9f9addaf3cd7508d85b0d6615588565b6117c9612ff1565b6117d1613022565b5f6117da612597565b805460408051637299470360e11b815281519394506001600160a01b03909216925f92849263e5328e06926004808401938290030181865afa158015611822573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611846919061559b565b5090508015611abe575f611858611792565b60088501549091505f80808061186c61309f565b93509350935093505f61187d600190565b61195b5761189d85878151811061189657611896615561565b505f919050565b8487815181106118af576118af615561565b602002602001018181516118c39190615575565b915081815250505f7323bb12c39eb120cc055567557dd190db388af0266356cd528e898c8e6007018a8a6040518663ffffffff1660e01b815260040161190d9594939291906155fd565b5f60405180830381865af4158015611927573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f1916820160405261194e91908101906156cd565b5050506001890154611a49565b604051633596603f60e01b81527323bb12c39eb120cc055567557dd190db388af02690633596603f90611992908790600401614fb8565b602060405180830381865af41580156119ad573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906119d19190615333565b15611a32576040516336ac731760e11b81526001600160a01b038a1690636d58e62e90611a049088908890600401614f3e565b5f604051808303815f87803b158015611a1b575f80fd5b505af1158015611a2d573d5f803e3d5ffd5b505050505b611a47855f8151811061189657611896615561565b505b60405163640f244560e01b81527323bb12c39eb120cc055567557dd190db388af0269063640f244590611a8a908d908b908a908a908f9089906004016156fe565b5f6040518083038186803b158015611aa0575f80fd5b505af4158015611ab2573d5f803e3d5ffd5b50505050505050505050505b505050565b6060611acd612ff1565b611ad884848461351e565b90505b9392505050565b606080611aed61352a565b604051633f8b51a560e21b815291935091507323bb12c39eb120cc055567557dd190db388af0269063fe2d469490611b2b9085908590600401614f3e565b5f60405180830381865af4158015611b45573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052611b6c919081019061574f565b915091509091565b611b7c612ac7565b5f5f80516020615b1c8339815191529050815f81518110611b9f57611b9f615561565b6020026020010151816009018190555081600181518110611bc257611bc2615561565b602002602001015181600a018190555081600281518110611be557611be5615561565b602002602001015181600b018190555081600381518110611c0857611c08615561565b602002602001015181600c018190555081600481518110611c2b57611c2b615561565b602002602001015181600d018190555081600581518110611c4e57611c4e615561565b602002602001015181600e018190555081600681518110611c7157611c71615561565b602002602001015181600f018190555081600781518110611c9457611c94615561565b6020026020010151816010018190555081600881518110611cb757611cb7615561565b6020026020010151816011018190555081600981518110611cda57611cda615561565b602002602001015181601201819055507f108a9433cbd0bc99fd766b6026503c733edf97f6052da62a8c299e2cd9fb73ee82604051610c0f9190614fb8565b60408051600180825281830190925260609160208083019080368337019050509050670de0b6b3a7640000815f81518110611d5657611d56615561565b60200260200101818152505090565b611d6d61360c565b611d7e611d786111a0565b30613727565b50565b60605f83516001148015611dcd5750611d98612597565b6006015484516001600160a01b039091169085905f90611dba57611dba615561565b60200260200101516001600160a01b0316145b8015611e0457505f6001600160a01b0316845f81518110611df057611df0615561565b60200260200101516001600160a01b031614155b15611e70578251600114611e2b57604051630ef9926760e21b815260040160405180910390fd5b825f81518110611e3d57611e3d615561565b60200260200101519050611e69835f81518110611e5c57611e5c615561565b6020026020010151613dbe565b9150611e7f565b611e7a8484613dc6565b915091505b9250929050565b5f611e8f612597565b600601546001600160a01b0316919050565b6060611eab612597565b600501805480602002602001604051908101604052809291908181526020018280548015611f0057602002820191905f5260205f20905b81546001600160a01b03168152600190910190602001808311611ee2575b5050505050905090565b5f80516020615b3c833981519152545f80516020615b1c83398151915280545f80516020615afc83398151915254606093611f55926001600160a01b03918216929082169116612b56565b91505090565b5f80808080805f80516020615b1c83398151915273d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1630f0b0594611f91611792565b6040516001600160e01b031960e084901b1681526001600160a01b0390911660048201526024810184905260440160c060405180830381865af4158015611fda573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611ffe91906157a4565b949c939b5091995097509550909350915050565b61201a612ff1565b6120248282613dd3565b5050565b5f612031612ff1565b5f61203a612597565b905080600201545f0361204e574260028201555b612059836001613e64565b9150505b919050565b60605f835160011480156120ae5750612079612597565b6006015484516001600160a01b039091169085905f9061209b5761209b615561565b60200260200101516001600160a01b0316145b80156120e557505f6001600160a01b0316845f815181106120d1576120d1615561565b60200260200101516001600160a01b031614155b1561214557825160011461210c57604051630ef9926760e21b815260040160405180910390fd5b825f8151811061211e5761211e615561565b60200260200101519050611e69835f8151811061213d5761213d615561565b506060919050565b611e7a84846143c4565b6060612159612ff1565b610645826143d0565b61216a612ac7565b5f612173612597565b6009019190915550565b5f80516020615b5c833981519152545f80516020615b3c833981519152545f80516020615adc833981519152545f9283925f80516020615b1c833981519152926121d6926001600160a01b0390811692811691166143db565b92509250509091565b5f805f80516020615b1c83398151915273d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1635bd923f5612211611792565b6040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602481018490526044016040805180830381865af4158015612259573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906121d6919061559b565b5f805f6122886121df565b925090505f6122956124e9565b6001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156122d0573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906122f49190615206565b9050801561231c578061230f83670de0b6b3a764000061554a565b612319919061552b565b93505b50509091565b5f80516020615b1c83398151915273d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1630dcd3d68612352611792565b83885f8151811061236557612365615561565b6020026020010151885f8151811061237f5761237f615561565b6020026020010151885f8151811061239957612399615561565b60209081029190910101516040516001600160e01b031960e088901b1681526001600160a01b03958616600482015260248101949094529390911660448301526064820152608481019190915260a4015f6040518083038186803b1580156123ff575f80fd5b505af4158015612411573d5f803e3d5ffd5b505050505050505050565b5f612425612597565b60040154905090565b5f612437612597565b60030154905090565b606061244a612ff1565b7323bb12c39eb120cc055567557dd190db388af0266325567aef61246c612597565b6040516001600160e01b031960e084901b168152600481019190915260248101879052604481018690526001600160a01b03851660648201526084015f60405180830381865af41580156124c2573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052611ad891908101906156cd565b5f6124f2612597565b546001600160a01b0316919050565b604080516001808252818301909252606091816020015b60608152602001906001900390816125185790505090506040518060400160405280600b81526020016a436f6d706f756e64696e6760a81b815250815f8151811061256557612565615561565b602002602001018190525090565b5f6001600160e01b03198216631772b5ab60e11b1480610645575061064582614501565b7fb14b643f49bed6a2c6693bbd50f68dc950245db265c66acadbfa51ccc8c3ba0090565b60605f6125ca6127108461552b565b90505f6103e86125dc8361271061554a565b6125e69086615588565b6125f0919061552b565b60405163be59b50760e01b8152600481018490529091507374f98426d3aca169fe2a9bd0e2063768c4b3a1029063be59b507906024015f60405180830381865af4158015612640573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526126679190810190615238565b60405163be59b50760e01b8152600481018390527374f98426d3aca169fe2a9bd0e2063768c4b3a1029063be59b507906024015f60405180830381865af41580156126b4573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526126db9190810190615238565b6040516020016126ec9291906157ea565b60405160208183030381529060405292505050919050565b5f805f80612710611f5b565b5094509450505092505f61272e5f80516020615b1c83398151915290565b6040805160808101825282546001600160a01b03908116825260018401548116602083015260028401548116828401526003840154166060820152905163f91afc8760e01b8152919250905f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb19063f91afc87906127a5908590600401615832565b602060405180830381865af41580156127c0573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906127e49190615206565b90505f6127f389612710615588565b6127ff6127108461554a565b612809919061552b565b60408085015160608601519151633cf7210d60e01b81526001600160a01b039182166004820152911660248201529091505f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb190633cf7210d906044016040805180830381865af4158015612875573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612899919061586d565b5090505f670de0b6b3a7640000826127106128b48e8761554a565b6128be919061552b565b6128c8919061554a565b6128d2919061552b565b6040805160018082528183019092529192505f9190602080830190803683370190505090508560200151815f8151811061290e5761290e615561565b6001600160a01b0392909216602092830291909101909101526040805160018082528183019092525f918160200160208202803683370190505090508a8d10156129c45760058801805460ff60a01b1916600360a01b1790555f612972848b615588565b905080825f8151811061298757612987615561565b6020908102919091010152600f890154612710906129a5888e615588565b6129af919061554a565b6129b9919061552b565b60078a015550612a2b565b60058801805460ff60a01b1916600160a21b1790555f6129e48a85615588565b60068a01819055600d8a015490915061271090612a01908361554a565b612a0b919061552b565b825f81518110612a1d57612a1d615561565b602002602001018181525050505b600480890154604051632e1c224f60e11b81526001600160a01b0390911691635c38449e91612a60913091879187910161588f565b5f604051808303815f87803b158015612a77575f80fd5b505af1158015612a89573d5f803e3d5ffd5b5050505060058801805460ff60a01b19169055612aa4611f5b565b909192935090919250909150905050809c50505050505050505050505050919050565b612acf611792565b6040516336b87bd760e11b81523360048201526001600160a01b039190911690636d70f7ae90602401602060405180830381865afa158015612b13573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612b379190615333565b612b5457604051631f0853c160e21b815260040160405180910390fd5b565b60605f846001600160a01b03166379502c556040518163ffffffff1660e01b8152600401602060405180830381865afa158015612b95573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612bb9919061521d565b6001600160a01b031663189e17e46040518163ffffffff1660e01b8152600401602060405180830381865afa158015612bf4573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612c189190615206565b9050836001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015612c55573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052612c7c9190810190615238565b836001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015612cb7573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052612cde9190810190615238565b60405163be59b50760e01b8152600481018490527374f98426d3aca169fe2a9bd0e2063768c4b3a1029063be59b507906024015f60405180830381865af4158015612d2b573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052612d529190810190615238565b604051602001612d64939291906158df565b6040516020818303038152906040529150509392505050565b612d85614535565b60608101515f80516020615b1c83398151915280546001600160a01b03199081166001600160a01b0393841617825560808401515f80516020615afc8339815191528054831691851691909117905560a08401515f80516020615b3c8339815191528054831691851691909117905560c08401515f80516020615adc8339815191528054831691851691909117905560e08401517fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f704805483169185169190911790556101008401515f80516020615b5c83398151915280549092169316929092179091556101208201517fbcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f70881905560408051918252517f2bdd781a443b30701c9ab6bf87f6cb0d8424bf4f343f2eb4bb49e815193d80d2916020908290030190a16040805160018082528183019092525f91602080830190803683370190505090508260600151815f81518110612efe57612efe615561565b6001600160a01b0390921660209283029190910182015283015183516040850151611abe929190845f5f1961457e565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663095ea7b360e01b179052612f7f8482614622565b612feb576040516001600160a01b0384811660248301525f6044830152612fe191869182169063095ea7b3906064015b604051602081830303815290604052915060e01b6020820180516001600160e01b0383818316178352505050506146bf565b612feb84826146bf565b50505050565b612ff9612597565b546001600160a01b03163314612b54576040516362df054560e01b815260040160405180910390fd5b306001600160a01b03166374bac4296040518163ffffffff1660e01b8152600401602060405180830381865afa15801561305e573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906130829190615333565b612b54576040516309ea311f60e11b815260040160405180910390fd5b6060806060806130ad611ea1565b604080515f808252602080830191825260018385018181526080850190955294985091955093509091906060850190803683375050604080516080810182525f80516020615b1c83398151915280546001600160a01b0390811683525f80516020615afc83398151915254811660208401525f80516020615b3c833981519152548116938301939093525f80516020615adc8339815191525490921660608201529295509190505f61315d612597565b90505f8160010154905082604001516001600160a01b031663a6afed956040518163ffffffff1660e01b81526004016020604051808303815f875af11580156131a8573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906131cc9190615206565b5082606001516001600160a01b031663a6afed956040518163ffffffff1660e01b81526004016020604051808303815f875af115801561320e573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906132329190615206565b5060405163f91afc8760e01b81525f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb19063f91afc879061326c908790600401615832565b602060405180830381865af4158015613287573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906132ab9190615206565b845160405163e3d670d760e01b81526001600160a01b0390911660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015613304573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906133289190615206565b6133329190615575565b905081811115613365576133468282615588565b885f8151811061335857613358615561565b6020026020010181815250505b600183018190555f6133778383615990565b90505f6133826121df565b5090505f8560020154426133969190615588565b6040516377d6938160e11b81526004810184905260248101859052604481018290529091505f907323bb12c39eb120cc055567557dd190db388af0269063efad270290606401602060405180830381865af41580156133f7573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061341b9190615206565b90505f806134488b6005015f9054906101000a90046001600160a01b03168b604001518c606001516143db565b915091505f61345561227d565b5060408051868152602081018a9052908101889052606081018790526080810182905260a0810185905260c081018490529091507f55b344f7779d44f14b50a9ae3eb0959de12c0956ec73aeddb89c62c0bfce3aad9060e00160405180910390a1505050505050505f806134c7611f5b565b50505092505091507fb83dc6ff11ec1f33d17651f75f3998b69e170ade8f9072b116beaa5e6d037e1e8282604051613509929190918252602082015260400190565b60405180910390a15050505050505090919293565b6060611ad88383613727565b606080613535611ea1565b604080516001808252818301909252919350602080830190803683370190505090505f5f80516020615b1c8339815191526002810154604051633f02cd9160e11b81526001600160a01b03909116600482015290915073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb190637e059b2290602401602060405180830381865af41580156135c5573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906135e99190615206565b825f815181106135fb576135fb615561565b602002602001018181525050509091565b5f613615611792565b9050336001600160a01b0316816001600160a01b0316635aa6e6756040518163ffffffff1660e01b8152600401602060405180830381865afa15801561365d573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613681919061521d565b6001600160a01b0316141580156137095750336001600160a01b0316816001600160a01b0316634783c35b6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156136d9573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906136fd919061521d565b6001600160a01b031614155b15611d7e576040516354299b6f60e01b815260040160405180910390fd5b5f80516020615b5c833981519152805460ff60a01b1916600160a11b179055604080516080810182525f80516020615b1c83398151915280546001600160a01b0390811683525f80516020615afc8339815191525481166020808501919091525f80516020615b3c833981519152548216848601525f80516020615adc8339815191525490911660608481019190915284516001808252818701909652909492939290918281019080368337505060405163f91afc8760e01b81529194505f9173d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1915063f91afc8790613812908590600401615832565b602060405180830381865af415801561382d573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906138519190615206565b825160405163e3d670d760e01b81526001600160a01b0390911660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af41580156138aa573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906138ce9190615206565b6138d89190615575565b90505f8073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb163dd081d8b856040015187600801546040518363ffffffff1660e01b81526004016139319291906001600160a01b03929092168252602082015260400190565b606060405180830381865af415801561394c573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061397091906152a0565b5060408087015160608801519151633cf7210d60e01b81526001600160a01b0391821660048201529116602482015291935091505f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb190633cf7210d906044016040805180830381865af41580156139df573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613a03919061586d565b5090505f612710613a14848c61554a565b613a1e919061552b565b600788018190556040805160018082528183019092529192505f919060208083019080368337019050509050670de0b6b3a76400008381613a5f888661554a565b613a69919061552b565b613a73919061554a565b613a7d919061552b565b815f81518110613a8f57613a8f615561565b60209081029190910101526040805160018082528183019092525f9181602001602082028036833750505060018a015481519192506001600160a01b03169082905f90613ade57613ade615561565b6001600160a01b0392831660209182029290920101526004808b0154604051632e1c224f60e11b8152921691635c38449e91613b20913091869188910161588f565b5f604051808303815f87803b158015613b37575f80fd5b505af1158015613b49573d5f803e3d5ffd5b505060405163f91afc8760e01b81525f955073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1945063f91afc879350613b8992508a9150600401615832565b602060405180830381865af4158015613ba4573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613bc89190615206565b865160405163e3d670d760e01b81526001600160a01b0390911660048201527323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015613c21573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613c459190615206565b613c4f9190615575565b865160405163e3d670d760e01b81526001600160a01b0390911660048201529091505f907323bb12c39eb120cc055567557dd190db388af0269063e3d670d790602401602060405180830381865af4158015613cad573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613cd19190615206565b905081861115613d1b57613cf8613ce88388615588565b613cf2908d615588565b82614720565b895f81518110613d0a57613d0a615561565b602002602001018181525050613d51565b613d32613d288784615588565b613cf2908d615575565b895f81518110613d4457613d44615561565b6020026020010181815250505b613d8b8a8a5f81518110613d6757613d67615561565b6020026020010151895f01516001600160a01b03166147359092919063ffffffff16565b5f613d94612597565b90508b816001015f828254613da99190615588565b90915550999c9b505050505050505050505050565b606080610645565b60605f611e7a84846143c4565b5f613ddc612597565b600601546001600160a01b031614613e1b576040518060400160405280600f81526020016e1b9bdd081a5b5c1b195b595b9d1959608a1b815250613e42565b6040518060400160405280600d81526020016c6e6f20756e6465726c79696e6760981b8152505b60405162461bcd60e51b8152600401613e5b9190614b2c565b60405180910390fd5b5f80516020615b5c833981519152805460ff60a01b1916600160a01b179055604080516080810182525f80516020615b1c83398151915280546001600160a01b0390811683525f80516020615afc83398151915254811660208401525f80516020615b3c833981519152548116938301939093525f80516020615adc8339815191525490921660608201525f919082613efb611ea1565b90505f73d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb163f91afc87846040518263ffffffff1660e01b8152600401613f359190615832565b602060405180830381865af4158015613f50573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190613f749190615206565b7323bb12c39eb120cc055567557dd190db388af02663e3d670d7845f81518110613fa057613fa0615561565b60200260200101516040518263ffffffff1660e01b8152600401613fd391906001600160a01b0391909116815260200190565b602060405180830381865af4158015613fee573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906140129190615206565b61401c9190615575565b6040808501516008870154915163dd081d8b60e01b81526001600160a01b03909116600482015260248101919091529091505f9073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb19063dd081d8b90604401606060405180830381865af415801561408a573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906140ae91906152a0565b6040805160018082528183019092529194505f9350909150602080830190803683370190505090508460200151815f815181106140ed576140ed615561565b6001600160a01b0392909216602092830291909101909101526040805160018082528183019092525f91816020016020820280368337019050509050612710838b5f8151811061413f5761413f615561565b6020026020010151614151919061554a565b61415b919061552b565b815f8151811061416d5761416d615561565b6020026020010181815250506127108760090154825f8151811061419357614193615561565b60200260200101516141a5919061554a565b6141af919061552b565b6006880155600480880154604051632e1c224f60e11b81526001600160a01b0390911691635c38449e916141e9913091879187910161588f565b5f604051808303815f87803b158015614200575f80fd5b505af1158015614212573d5f803e3d5ffd5b505060405163f91afc8760e01b81525f925073d8d8a4dfc948d6faae0cccee0b0bc45c17efbbb1915063f91afc879061424f908a90600401615832565b602060405180830381865af415801561426a573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061428e9190615206565b7323bb12c39eb120cc055567557dd190db388af02663e3d670d7885f815181106142ba576142ba615561565b60200260200101516040518263ffffffff1660e01b81526004016142ed91906001600160a01b0391909116815260200190565b602060405180830381865af4158015614308573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061432c9190615206565b6143369190615575565b9050848111156143755761434a8582615588565b8b5f8151811061435c5761435c615561565b602002602001015161436e9190615575565b98506143a6565b61437f8186615588565b8b5f8151811061439157614391615561565b60200260200101516143a39190615588565b98505b5f6143af612597565b905089816001015f828254613da99190615575565b60605f611e7a83614766565b60605f613ddc612597565b6040516327b52bdb60e11b81526001600160a01b0383811660048301525f918291670de0b6b3a764000091620186a091881690634f6a57b690602401602060405180830381865afa158015614432573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906144569190615206565b614460919061554a565b61446a919061552b565b604051620707bd60e51b81526001600160a01b038581166004830152919350670de0b6b3a764000091620186a0919088169062e0f7a090602401602060405180830381865afa1580156144bf573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906144e39190615206565b6144ed919061554a565b6144f7919061552b565b9050935093915050565b5f6001600160e01b03198216630f1ec81f60e41b148061064557506301ffc9a760e01b6001600160e01b0319831614610645565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff16612b5457604051631afcd79f60e31b815260040160405180910390fd5b614586614535565b61458f866147e4565b5f614598612597565b600881018390556006810180546001600160a01b0319166001600160a01b03861617905584519091508690869086908690869060078701905f90889082906145e990600584019060208a0190614a41565b5081546001600160a01b03808a166101009390930a92830292021916179055506146138682615a01565b50505050505050505050505050565b5f805f846001600160a01b03168460405161463d9190615ac0565b5f604051808303815f865af19150503d805f8114614676576040519150601f19603f3d011682016040523d82523d5f602084013e61467b565b606091505b50915091508180156146a55750805115806146a55750808060200190518101906146a59190615333565b8015610b9f5750505050506001600160a01b03163b151590565b5f6146d36001600160a01b0384168361493f565b905080515f141580156146f75750808060200190518101906146f59190615333565b155b15611abe57604051635274afe760e01b81526001600160a01b0384166004820152602401613e5b565b5f81831061472e5781611adb565b5090919050565b6040516001600160a01b03838116602483015260448201839052611abe91859182169063a9059cbb90606401612faf565b6040805160018082528183019092526060915f919060208083019080368337019050509150825f8151811061479d5761479d615561565b6020026020010151825f815181106147b7576147b7615561565b602002602001018181525050815f815181106147d5576147d5615561565b60200260200101519050915091565b6147ec614535565b6001600160a01b038116158061487257505f6001600160a01b0316816001600160a01b0316634783c35b6040518163ffffffff1660e01b8152600401602060405180830381865afa158015614843573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190614867919061521d565b6001600160a01b0316145b15614890576040516371c42ac360e01b815260040160405180910390fd5b6148c36148be60017faa116a42804728f23983458454b6eb9c6ddf3011db9f9addaf3cd7508d85b0d6615588565b829055565b6148f5436148f260017f812a673dfca07956350df10f8a654925f561d7a0da09bdbe79e653939a14d9f1615588565b55565b604080516001600160a01b0383168152426020820152438183015290517f1a2dd071001ebf6e03174e3df5b305795a4ad5d41d8fdb9ba41dbbe2367134269181900360600190a150565b6060611adb83835f845f80856001600160a01b031684866040516149639190615ac0565b5f6040518083038185875af1925050503d805f811461499d576040519150601f19603f3d011682016040523d82523d5f602084013e6149a2565b606091505b50915091506149b28683836149bc565b9695505050505050565b6060826149d1576149cc82614a18565b611adb565b81511580156149e857506001600160a01b0384163b155b15614a1157604051639996b31560e01b81526001600160a01b0385166004820152602401613e5b565b5080611adb565b805115614a285780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b828054828255905f5260205f20908101928215614a94579160200282015b82811115614a9457825182546001600160a01b0319166001600160a01b03909116178255602090920191600190910190614a5f565b50614aa0929150614aa4565b5090565b5b80821115614aa0575f8155600101614aa5565b5f60208284031215614ac8575f80fd5b81356001600160e01b031981168114611adb575f80fd5b5f5b83811015614af9578181015183820152602001614ae1565b50505f910152565b5f8151808452614b18816020860160208601614adf565b601f01601f19169290920160200192915050565b602081525f611adb6020830184614b01565b604081525f614b506040830185614b01565b905082151560208301529392505050565b5f60208284031215614b71575f80fd5b5035919050565b6001600160a01b0381168114611d7e575f80fd5b5f60208284031215614b9c575f80fd5b8135611adb81614b78565b5f8282518085526020808601955060208260051b840101602086015f5b84811015614bf257601f19868403018952614be0838351614b01565b98840198925090830190600101614bc4565b5090979650505050505050565b5f815180845260208085019450602084015f5b83811015614c375781516001600160a01b031687529582019590820190600101614c12565b509495945050505050565b5f815180845260208085019450602084015f5b83811015614c3757815187529582019590820190600101614c55565b608081525f614c836080830187614ba7565b60208382036020850152614c978288614bff565b91508382036040850152614cab8287614c42565b8481036060860152855180825260208088019450909101905f5b81811015614ce457845160020b83529383019391830191600101614cc5565b50909998505050505050505050565b634e487b7160e01b5f52604160045260245ffd5b604051606081016001600160401b0381118282101715614d2957614d29614cf3565b60405290565b604051601f8201601f191681016001600160401b0381118282101715614d5757614d57614cf3565b604052919050565b5f6001600160401b03821115614d7757614d77614cf3565b5060051b60200190565b5f82601f830112614d90575f80fd5b81356020614da5614da083614d5f565b614d2f565b8083825260208201915060208460051b870101935086841115614dc6575f80fd5b602086015b84811015614deb578035614dde81614b78565b8352918301918301614dcb565b509695505050505050565b5f82601f830112614e05575f80fd5b81356020614e15614da083614d5f565b8083825260208201915060208460051b870101935086841115614e36575f80fd5b602086015b84811015614deb5780358352918301918301614e3b565b8060020b8114611d7e575f80fd5b5f805f60608486031215614e72575f80fd5b83356001600160401b0380821115614e88575f80fd5b614e9487838801614d81565b9450602091508186013581811115614eaa575f80fd5b614eb688828901614df6565b945050604086013581811115614eca575f80fd5b86019050601f81018713614edc575f80fd5b8035614eea614da082614d5f565b81815260059190911b82018301908381019089831115614f08575f80fd5b928401925b82841015614f2f578335614f2081614e52565b82529284019290840190614f0d565b80955050505050509250925092565b604081525f614f506040830185614bff565b8281036020840152610b9f8185614c42565b5f805f60608486031215614f74575f80fd5b83356001600160401b03811115614f89575f80fd5b614f9586828701614d81565b935050602084013591506040840135614fad81614b78565b809150509250925092565b602081525f611adb6020830184614c42565b5f60208284031215614fda575f80fd5b81356001600160401b03811115614fef575f80fd5b614ffb84828501614df6565b949350505050565b5f8060408385031215615014575f80fd5b82356001600160401b038082111561502a575f80fd5b61503686838701614d81565b9350602085013591508082111561504b575f80fd5b5061505885828601614df6565b9150509250929050565b604081525f6150746040830185614c42565b90508260208301529392505050565b602081525f611adb6020830184614bff565b5f80604083850312156150a6575f80fd5b8235915060208301356150b881614b78565b809150509250929050565b5f6001600160401b038211156150db576150db614cf3565b50601f01601f191660200190565b5f805f80608085870312156150fc575f80fd5b84356001600160401b0380821115615112575f80fd5b61511e88838901614d81565b95506020870135915080821115615133575f80fd5b61513f88838901614df6565b94506040870135915080821115615154575f80fd5b61516088838901614df6565b93506060870135915080821115615175575f80fd5b508501601f81018713615186575f80fd5b8035615194614da0826150c3565b8181528860208385010111156151a8575f80fd5b816020840160208301375f6020838301015280935050505092959194509250565b5f805f606084860312156151db575f80fd5b83359250602084013591506040840135614fad81614b78565b602081525f611adb6020830184614ba7565b5f60208284031215615216575f80fd5b5051919050565b5f6020828403121561522d575f80fd5b8151611adb81614b78565b5f60208284031215615248575f80fd5b81516001600160401b0381111561525d575f80fd5b8201601f8101841361526d575f80fd5b805161527b614da0826150c3565b81815285602083850101111561528f575f80fd5b610b9f826020830160208601614adf565b5f805f606084860312156152b2575f80fd5b8351925060208401519150604084015190509250925092565b5f84516152dc818460208901614adf565b8083019050600160fd1b80825285516152fc816001850160208a01614adf565b60019201918201528351615317816002840160208801614adf565b0160020195945050505050565b8051801515811461205d575f80fd5b5f60208284031215615343575f80fd5b611adb82615324565b5f82601f83011261535b575f80fd5b8151602061536b614da083614d5f565b8083825260208201915060208460051b87010193508684111561538c575f80fd5b602086015b84811015614deb5780516153a481614b78565b8352918301918301615391565b5f82601f8301126153c0575f80fd5b815160206153d0614da083614d5f565b8083825260208201915060208460051b8701019350868411156153f1575f80fd5b602086015b84811015614deb57805183529183019183016153f6565b5f602080838503121561541e575f80fd5b82516001600160401b0380821115615434575f80fd5b9084019060608287031215615447575f80fd5b61544f614d07565b82518281111561545d575f80fd5b6154698882860161534c565b825250838301518281111561547c575f80fd5b615488888286016153b1565b858301525060408301518281111561549e575f80fd5b80840193505086601f8401126154b2575f80fd5b825191506154c2614da083614d5f565b82815260059290921b830184019184810190888411156154e0575f80fd5b938501935b838510156155075784516154f881614e52565b825293850193908501906154e5565b6040830152509695505050505050565b634e487b7160e01b5f52601160045260245ffd5b5f8261554557634e487b7160e01b5f52601260045260245ffd5b500490565b808202811582820484141761064557610645615517565b634e487b7160e01b5f52603260045260245ffd5b8082018082111561064557610645615517565b8181038181111561064557610645615517565b5f80604083850312156155ac575f80fd5b825191506155bc60208401615324565b90509250929050565b600181811c908216806155d957607f821691505b6020821081036155f757634e487b7160e01b5f52602260045260245ffd5b50919050565b6001600160a01b038681168252851660208083019190915260a0604083015284545f91829161562b816155c5565b8060a087015260c060018084165f811461564c576001811461566857615695565b60ff19851660c08a015260c084151560051b8a01019650615695565b8b5f5260205f205f5b8581101561568c5781548b8201860152908301908701615671565b8a0160c0019750505b50505050505082810360608401526156ad8186614bff565b905082810360808401526156c18185614c42565b98975050505050505050565b5f602082840312156156dd575f80fd5b81516001600160401b038111156156f2575f80fd5b614ffb848285016153b1565b8681526001600160a01b038616602082015260c0604082018190525f9061572790830187614bff565b82810360608401526157398187614c42565b6080840195909552505060a00152949350505050565b5f8060408385031215615760575f80fd5b82516001600160401b0380821115615776575f80fd5b6157828683870161534c565b93506020850151915080821115615797575f80fd5b50615058858286016153b1565b5f805f805f8060c087890312156157b9575f80fd5b865195506020870151945060408701519350606087015192506080870151915060a087015190509295509295509295565b600f60fb1b81525f8351615805816001850160208801614adf565b601760f91b6001918401918201528351615826816002840160208801614adf565b01600201949350505050565b81516001600160a01b039081168252602080840151821690830152604080840151821690830152606092830151169181019190915260800190565b5f806040838503121561587e575f80fd5b505080516020909101519092909150565b6001600160a01b03841681526080602082018190525f906158b290830185614bff565b82810360408401526158c48185614c42565b83810360609094019390935250505f81526020019392505050565b66029bab838363c960cd1b81525f8451615900816007850160208901614adf565b6b01030b732103137b93937bb960a51b600791840191820152845161592c816013840160208901614adf565b7201037b71029b4b637902b191036b0b935b2ba1606d1b601392909101918201528351615960816026840160208801614adf565b752077697468206c65766572616765206c6f6f70696e6760501b60269290910191820152603c0195945050505050565b8181035f8312801583831316838312821617156159af576159af615517565b5092915050565b601f821115611abe57805f5260205f20601f840160051c810160208510156159db5750805b601f840160051c820191505b818110156159fa575f81556001016159e7565b5050505050565b81516001600160401b03811115615a1a57615a1a614cf3565b615a2e81615a2884546155c5565b846159b6565b602080601f831160018114615a61575f8415615a4a5750858301515b5f19600386901b1c1916600185901b178555615ab8565b5f85815260208120601f198616915b82811015615a8f57888601518255948401946001909101908401615a70565b5085821015615aac57878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b5f8251615ad1818460208701614adf565b919091019291505056febcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f703bcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f701bcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f700bcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f702bcea52cc71723df4e8ce4341004b27df2cc7bc9197584ea7d92bbe219528f705a264697066735822122037821627166f850b978824ff16c40c786c8c911f183212e2accc712d9b296bcb64736f6c63430008170033
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 31 Chains
Chain | Token | Portfolio % | Price | Amount | Value |
---|
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.