Source Code
Overview
S Balance
0 SS Value
$0.00View more zero value Internal Transactions in Advanced View mode
Advanced mode:
Cross-Chain Transactions
Loading...
Loading
This contract contains unverified libraries: StrategyLib
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 Name:
CompoundV2Strategy
Compiler Version
v0.8.28+commit.7893614a
Optimization Enabled:
Yes with 200 runs
Other Settings:
cancun EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;
import {CommonLib} from "../core/libs/CommonLib.sol";
import {IComptroller} from "../integrations/compoundv2/IComptroller.sol";
import {IControllable} from "../interfaces/IControllable.sol";
import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol";
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {IFactory} from "../interfaces/IFactory.sol";
import {IPlatform} from "../interfaces/IPlatform.sol";
import {IPriceReader} from "../interfaces/IPriceReader.sol";
import {IStrategy} from "../interfaces/IStrategy.sol";
import {IVToken} from "../integrations/compoundv2/IVToken.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {SharedLib} from "./libs/SharedLib.sol";
import {StrategyBase} from "./base/StrategyBase.sol";
import {StrategyIdLib} from "./libs/StrategyIdLib.sol";
import {StrategyLib} from "./libs/StrategyLib.sol";
import {VaultTypeLib} from "../core/libs/VaultTypeLib.sol";
/// @title Earns APR by lending assets on Compound V2 protocol.
/// @author dvpublic (https://github.com/dvpublic)
/// Changelog:
/// 1.0.1: StrategyBase 2.5.1
contract CompoundV2Strategy is StrategyBase {
using SafeERC20 for IERC20;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CONSTANTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @inheritdoc IControllable
string public constant VERSION = "1.0.1";
// keccak256(abi.encode(uint256(keccak256("erc7201:stability.CompoundV2Strategy")) - 1)) & ~bytes32(uint256(0xff));
bytes32 private constant COMPOUND_V2_STRATEGY_STORAGE_LOCATION =
0x521f61dff1434739ba1cce3408ca24814df0ac37d5c1f8d308e97ca6d9831800; // erc7201:stability.CompoundV2Strategy
error MintError(uint errorCode);
error RedeemError(uint errorCode);
error AccrueInterestError(uint errorCode);
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* STORAGE */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @custom:storage-location erc7201:stability.CompoundV2Strategy
struct CompoundV2StrategyStorage {
uint lastSharePrice;
}
//region ----------------------- Initialization
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* INITIALIZATION */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @inheritdoc IStrategy
function initialize(address[] memory addresses, uint[] memory nums, int24[] memory ticks) public initializer {
if (addresses.length != 3 || nums.length != 0 || ticks.length != 0) {
revert IControllable.IncorrectInitParams();
}
address[] memory _assets = new address[](1);
_assets[0] = IVToken(addresses[2]).underlying();
__StrategyBase_init(
addresses[0], // platform
StrategyIdLib.COMPOUND_V2,
addresses[1], // vault
_assets,
addresses[2], // underlying
type(uint).max
);
IERC20(_assets[0]).forceApprove(addresses[2], type(uint).max);
}
//endregion ----------------------- Initialization
//region ----------------------- View functions
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* VIEW FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @inheritdoc IStrategy
function strategyLogicId() public pure override returns (string memory) {
return StrategyIdLib.COMPOUND_V2;
}
/// @inheritdoc IStrategy
function description() external view returns (string memory) {
StrategyBaseStorage storage __$__ = _getStrategyBaseStorage();
return _generateDescription(__$__._underlying);
}
/// @inheritdoc IStrategy
function extra() external pure returns (bytes32) {
//slither-disable-next-line too-many-digits
return CommonLib.bytesToBytes32(abi.encodePacked(bytes3(0x00d395), bytes3(0x000000)));
}
/// @inheritdoc IStrategy
function getSpecificName() external view override returns (string memory, bool) {
address _underlying = _getStrategyBaseStorage()._underlying;
string memory shortAddr = SharedLib.shortAddress(_underlying);
return (string.concat(IERC20Metadata(_underlying).symbol(), " ", shortAddr), true);
}
/// @inheritdoc IStrategy
function supportedVaultTypes() external pure override returns (string[] memory types) {
types = new string[](1);
types[0] = VaultTypeLib.COMPOUNDING;
}
/// @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;
variants = new string[](len);
addresses = new address[](len);
nums = new uint[](0);
ticks = new int24[](0);
for (uint i; i < len; ++i) {
variants[i] = _generateDescription(params.initAddresses[i]);
addresses[i] = params.initAddresses[i];
}
}
/// @inheritdoc IStrategy
function isHardWorkOnDepositAllowed() external pure returns (bool) {
return true;
}
/// @inheritdoc IStrategy
function total() public view override returns (uint) {
address _underlying = _getStrategyBaseStorage()._underlying;
// total is a number of cTokens on the strategy balance
// this number is changes on deposit/withdraw only
return StrategyLib.balance(_underlying);
}
/// @inheritdoc IStrategy
function getAssetsProportions() external pure override returns (uint[] memory proportions) {
proportions = new uint[](1);
proportions[0] = 1e18;
}
/// @inheritdoc IStrategy
function getRevenue() public view override returns (address[] memory assets_, uint[] memory amounts) {
address _underlying = _getStrategyBaseStorage()._underlying;
uint newPrice = _getSharePrice(_underlying);
(assets_, amounts) = _getRevenue(newPrice, _underlying);
}
/// @inheritdoc IStrategy
function autoCompoundingByUnderlyingProtocol() public pure override returns (bool) {
return true;
}
/// @inheritdoc IStrategy
function isReadyForHardWork() external pure override returns (bool isReady) {
isReady = true;
}
/// @inheritdoc IStrategy
function poolTvl() public view override returns (uint tvlUsd) {
address _underlying = _getStrategyBaseStorage()._underlying;
address asset = IVToken(_underlying).underlying();
IPriceReader priceReader = IPriceReader(IPlatform(platform()).priceReader());
// get price of 1 amount of asset in USD with decimals 18
// slither-disable-next-line unused-return
(uint price,) = priceReader.getPrice(asset);
uint totalSupply = IVToken(_underlying).totalSupply(); // 8 decimals
uint exchangeRate = IVToken(_underlying).exchangeRateStored(); // underlying decimals * 1e18 / 1e8
uint underlyingTotal = _tokensToAmount(totalSupply, exchangeRate);
return underlyingTotal * price / (10 ** IERC20Metadata(asset).decimals());
}
/// @inheritdoc IStrategy
function maxWithdrawAssets(uint mode) public view override returns (uint[] memory amounts) {
address _underlying = _getStrategyBaseStorage()._underlying;
address asset = IVToken(_underlying).underlying();
// currently available liquidity in the pool
uint availableLiquidity = IERC20(asset).balanceOf(_underlying);
// balance of the strategy
uint cTokenBalance = IVToken(_underlying).balanceOf(address(this)); // 8 decimals
uint exchangeRate = IVToken(_underlying).exchangeRateStored(); // underlying decimals * 1e18 / 1e8
uint underlyingBalance = _tokensToAmount(cTokenBalance, exchangeRate);
amounts = new uint[](1);
amounts[0] = mode == 0 ? Math.min(underlyingBalance, availableLiquidity) : underlyingBalance;
}
/// @notice IStrategy
function maxDepositAssets() public view override returns (uint[] memory amounts) {
address _underlying = _getStrategyBaseStorage()._underlying;
uint supplyCap = IComptroller(IVToken(_underlying).comptroller()).supplyCaps(_underlying);
if (supplyCap != type(uint).max) {
uint vTokenSupply = IVToken(_underlying).totalSupply();
uint totalSupply = _tokensToAmount(vTokenSupply, IVToken(_underlying).exchangeRateStored());
amounts = new uint[](1);
amounts[0] = supplyCap > totalSupply
? (supplyCap - totalSupply) * 99_9 / 100_0 // 99.9% of the supply cap
: 0;
}
return amounts;
}
//endregion ----------------------- View functions
//region ----------------------- Strategy base
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* STRATEGY BASE */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @inheritdoc StrategyBase
//slither-disable-next-line unused-return
function _depositAssets(uint[] memory amounts, bool) internal override returns (uint value) {
CompoundV2StrategyStorage storage $ = _getStorage();
StrategyBaseStorage storage $base = _getStrategyBaseStorage();
IVToken _market = IVToken($base._underlying);
uint cTokenBalanceBefore = StrategyLib.balance(address(_market));
if (amounts[0] != 0) {
uint errorCode = _market.mint(amounts[0]);
require(errorCode == 0, MintError(errorCode));
// value is amount of minted cTokens
value = StrategyLib.balance(address(_market)) - cTokenBalanceBefore;
if ($.lastSharePrice == 0) {
$.lastSharePrice = _getSharePrice(address(_market));
}
}
return value;
}
/// @inheritdoc StrategyBase
function _liquidateRewards(
address, /*exchangeAsset*/
address[] memory, /*rewardAssets_*/
uint[] memory /*rewardAmounts_*/
) internal override returns (uint earnedExchangeAsset) {
// do nothing
}
/// @inheritdoc StrategyBase
function _processRevenue(
address[] memory, /*assets_*/
uint[] memory /*amountsRemaining*/
) internal override returns (bool needCompound) {
// do nothing
}
/// @inheritdoc StrategyBase
function _compound() internal override {
// do nothing
}
/// @inheritdoc StrategyBase
function _previewDepositAssets(uint[] memory amountsMax)
internal
view
override
returns (uint[] memory amountsConsumed, uint value)
{
StrategyBaseStorage storage $base = _getStrategyBaseStorage();
amountsConsumed = new uint[](1);
amountsConsumed[0] = amountsMax[0];
value = _amountToTokens(amountsMax[0], IVToken($base._underlying).exchangeRateStored());
}
/// @inheritdoc StrategyBase
function _previewDepositAssets(
address[] memory, /*assets_*/
uint[] memory amountsMax
) internal view override returns (uint[] memory amountsConsumed, uint value) {
return _previewDepositAssets(amountsMax);
}
/// @inheritdoc StrategyBase
function _withdrawAssets(uint value, address receiver) internal override returns (uint[] memory amountsOut) {
StrategyBaseStorage storage $base = _getStrategyBaseStorage();
return _withdrawAssets($base._assets, value, receiver);
}
/// @inheritdoc StrategyBase
//slither-disable-next-line unused-return
function _withdrawAssets(
address[] memory,
uint value,
address receiver
) internal override returns (uint[] memory amountsOut) {
amountsOut = new uint[](1);
StrategyBaseStorage storage __$__ = _getStrategyBaseStorage();
IVToken _market = IVToken(__$__._underlying);
address depositedAsset = _market.underlying();
uint initialValue = StrategyLib.balance(depositedAsset);
uint errorCode = _market.redeem(value);
require(errorCode == 0, RedeemError(errorCode));
amountsOut[0] = StrategyLib.balance(depositedAsset) - initialValue;
IERC20(depositedAsset).safeTransfer(receiver, amountsOut[0]);
}
/// @inheritdoc StrategyBase
function _assetsAmounts() internal view override returns (address[] memory assets_, uint[] memory amounts_) {
StrategyBaseStorage storage $base = _getStrategyBaseStorage();
assets_ = $base._assets;
amounts_ = new uint[](1);
amounts_[0] =
_tokensToAmount(StrategyLib.balance($base._underlying), IVToken($base._underlying).exchangeRateStored());
}
/// @inheritdoc StrategyBase
function _claimRevenue()
internal
override
returns (
address[] memory __assets,
uint[] memory __amounts,
address[] memory __rewardAssets,
uint[] memory __rewardAmounts
)
{
CompoundV2StrategyStorage storage $ = _getStorage();
StrategyBaseStorage storage $base = _getStrategyBaseStorage();
address market = $base._underlying;
uint errorCode = IVToken(market).accrueInterest();
require(errorCode == 0, AccrueInterestError(errorCode));
uint newPrice = _getSharePrice(market);
(__assets, __amounts) = _getRevenue(newPrice, market);
$.lastSharePrice = newPrice;
__rewardAssets = new address[](0);
__rewardAmounts = new uint[](0);
}
/// @inheritdoc StrategyBase
function _depositUnderlying(uint amount) internal override returns (uint[] memory amountsConsumed) {
CompoundV2StrategyStorage storage $ = _getStorage();
StrategyBaseStorage storage __$__ = _getStrategyBaseStorage();
amountsConsumed = _previewDepositUnderlying(amount);
if ($.lastSharePrice == 0) {
$.lastSharePrice = _getSharePrice(__$__._underlying);
}
}
/// @inheritdoc StrategyBase
function _withdrawUnderlying(uint amount, address receiver) internal override {
StrategyBaseStorage storage __$__ = _getStrategyBaseStorage();
IERC20(__$__._underlying).safeTransfer(receiver, amount);
}
function _previewDepositUnderlying(uint amount) internal view override returns (uint[] memory amountsConsumed) {
StrategyBaseStorage storage $base = _getStrategyBaseStorage();
amountsConsumed = new uint[](1);
amountsConsumed[0] = _tokensToAmount(amount, IVToken($base._underlying).exchangeRateStored());
}
//endregion ----------------------- Strategy base
//region ----------------------- Internal logic
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* INTERNAL LOGIC */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
function _getStorage() internal pure returns (CompoundV2StrategyStorage storage $) {
//slither-disable-next-line assembly
assembly {
$.slot := COMPOUND_V2_STRATEGY_STORAGE_LOCATION
}
}
function _getSharePrice(address u) internal view returns (uint) {
return IVToken(u).exchangeRateStored();
}
function _getRevenue(
uint newPrice,
address u
) internal view returns (address[] memory __assets, uint[] memory amounts) {
CompoundV2StrategyStorage storage $ = _getStorage();
__assets = assets();
amounts = new uint[](1);
uint oldPrice = $.lastSharePrice;
if (newPrice > oldPrice && oldPrice != 0) {
// deposited asset balance
uint userBalanceCTokens = IVToken(u).balanceOf(address(this));
// share price already takes into account accumulated interest
amounts[0] = _tokensToAmount(userBalanceCTokens, (newPrice - oldPrice));
}
}
function _generateDescription(address market_) internal view returns (string memory) {
//slither-disable-next-line calls-loop
return string.concat(
"Supply ",
IERC20Metadata(IVToken(market_).underlying()).symbol(),
" to ",
IVToken(market_).name(),
SharedLib.shortAddress(market_)
);
}
/// @param exchangeRate The exchange rate of cTokens to underlying asset = underlying decimals * 1e18 / 1e8
function _tokensToAmount(uint cTokens, uint exchangeRate) internal pure returns (uint amount) {
return cTokens * exchangeRate / 1e18;
}
function _amountToTokens(uint amount, uint exchangeRate) internal pure returns (uint cTokens) {
return amount * 1e18 / exchangeRate;
}
//endregion ----------------------- Internal logic
}// 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.28;
/// @notice Restored from Sonic.0xccAdFCFaa71407707fb3dC93D7d83950171aA2c9
/// @dev https://github.com/EnclaveLabs/enclabs-protocol
interface IComptroller {
error ActionPaused(address market, uint8 action);
error BorrowActionNotPaused();
error BorrowCapExceeded(address market, uint256 cap);
error BorrowCapIsNotZero();
error CollateralExceedsThreshold(
uint256 expectedLessThanOrEqualTo,
uint256 actual
);
error CollateralFactorIsNotZero();
error ComptrollerMismatch();
error DelegationStatusUnchanged();
error EnterMarketActionNotPaused();
error ExitMarketActionNotPaused();
error InsufficientCollateral(
uint256 collateralToSeize,
uint256 availableCollateral
);
error InsufficientLiquidity();
error InsufficientShortfall();
error InvalidCollateralFactor();
error InvalidLiquidationThreshold();
error LiquidateActionNotPaused();
error MarketAlreadyListed(address market);
error MarketNotCollateral(address vToken, address user);
error MarketNotListed(address market);
error MaxLoopsLimitExceeded(uint256 loopsLimit, uint256 requiredLoops);
error MinimalCollateralViolated(
uint256 expectedGreaterThan,
uint256 actual
);
error MintActionNotPaused();
error NonzeroBorrowBalance();
error PriceError(address vToken);
error RedeemActionNotPaused();
error RepayActionNotPaused();
error SeizeActionNotPaused();
error SnapshotError(address vToken, address user);
error SupplyCapExceeded(address market, uint256 cap);
error SupplyCapIsNotZero();
error TooMuchRepay();
error TransferActionNotPaused();
error Unauthorized(
address sender,
address calledContract,
string methodSignature
);
error UnexpectedSender(address expectedSender, address actualSender);
error ZeroAddressNotAllowed();
event ActionPausedMarket(address vToken, uint8 action, bool pauseState);
event DelegateUpdated(
address indexed approver,
address indexed delegate,
bool approved
);
event Initialized(uint8 version);
event IsForcedLiquidationEnabledUpdated(
address indexed vToken,
bool enable
);
event MarketEntered(address indexed vToken, address indexed account);
event MarketExited(address indexed vToken, address indexed account);
event MarketSupported(address vToken);
event MarketUnlisted(address indexed vToken);
event MaxLoopsLimitUpdated(
uint256 oldMaxLoopsLimit,
uint256 newmaxLoopsLimit
);
event NewAccessControlManager(
address oldAccessControlManager,
address newAccessControlManager
);
event NewBorrowCap(address indexed vToken, uint256 newBorrowCap);
event NewCloseFactor(
uint256 oldCloseFactorMantissa,
uint256 newCloseFactorMantissa
);
event NewCollateralFactor(
address vToken,
uint256 oldCollateralFactorMantissa,
uint256 newCollateralFactorMantissa
);
event NewLiquidationIncentive(
uint256 oldLiquidationIncentiveMantissa,
uint256 newLiquidationIncentiveMantissa
);
event NewLiquidationThreshold(
address vToken,
uint256 oldLiquidationThresholdMantissa,
uint256 newLiquidationThresholdMantissa
);
event NewMinLiquidatableCollateral(
uint256 oldMinLiquidatableCollateral,
uint256 newMinLiquidatableCollateral
);
event NewPriceOracle(address oldPriceOracle, address newPriceOracle);
event NewPrimeToken(address oldPrimeToken, address newPrimeToken);
event NewRewardsDistributor(
address indexed rewardsDistributor,
address indexed rewardToken
);
event NewSupplyCap(address indexed vToken, uint256 newSupplyCap);
event OwnershipTransferStarted(
address indexed previousOwner,
address indexed newOwner
);
event OwnershipTransferred(
address indexed previousOwner,
address indexed newOwner
);
function acceptOwnership() external;
function accessControlManager() external view returns (address);
function accountAssets(address, uint256) external view returns (address);
function actionPaused(address market, uint8 action) external view returns (bool);
function addRewardsDistributor(address _rewardsDistributor) external;
function allMarkets(uint256) external view returns (address);
function approvedDelegates(address, address) external view returns (bool);
function borrowCaps(address) external view returns (uint256);
function borrowVerify(address vToken, address borrower, uint256 borrowAmount) external;
function checkMembership(address account, address vToken) external view returns (bool);
function closeFactorMantissa() external view returns (uint256);
function enterMarkets(address[] memory vTokens) external returns (uint256[] memory);
function exitMarket(address vTokenAddress) external returns (uint256);
function getAccountLiquidity(address account) external view returns (
uint256 error,
uint256 liquidity,
uint256 shortfall
);
function getAllMarkets() external view returns (address[] memory);
function getAssetsIn(address account) external view returns (address[] memory);
function getBorrowingPower(address account) external view returns (
uint256 error,
uint256 liquidity,
uint256 shortfall
);
function getHypotheticalAccountLiquidity(
address account,
address vTokenModify,
uint256 redeemTokens,
uint256 borrowAmount
) external view returns (
uint256 error,
uint256 liquidity,
uint256 shortfall
);
function getRewardDistributors() external view returns (address[] memory);
function getRewardsByMarket(address vToken) external view returns (
RewardSpeeds[] memory rewardSpeeds
);
function healAccount(address user) external;
function initialize(uint256 loopLimit, address accessControlManager) external;
function isComptroller() external pure returns (bool);
function isForcedLiquidationEnabled(address) external view returns (bool);
function isMarketListed(address vToken) external view returns (bool);
function liquidateAccount(address borrower, LiquidationOrder[] memory orders) external;
function liquidateBorrowVerify(
address vTokenBorrowed,
address vTokenCollateral,
address liquidator,
address borrower,
uint256 actualRepayAmount,
uint256 seizeTokens
) external;
function liquidateCalculateSeizeTokens(
address vTokenBorrowed,
address vTokenCollateral,
uint256 actualRepayAmount
) external view returns (uint256 error, uint256 tokensToSeize);
function liquidationIncentiveMantissa() external view returns (uint256);
function markets(address) external view returns (
bool isListed,
uint256 collateralFactorMantissa,
uint256 liquidationThresholdMantissa
);
function maxLoopsLimit() external view returns (uint256);
function minLiquidatableCollateral() external view returns (uint256);
function mintVerify(address vToken, address minter, uint256 actualMintAmount, uint256 mintTokens) external;
function oracle() external view returns (address);
function owner() external view returns (address);
function pendingOwner() external view returns (address);
function poolRegistry() external view returns (address);
function preBorrowHook(address vToken, address borrower, uint256 borrowAmount) external;
function preLiquidateHook(
address vTokenBorrowed,
address vTokenCollateral,
address borrower,
uint256 repayAmount,
bool skipLiquidityCheck
) external;
function preMintHook(address vToken, address minter, uint256 mintAmount) external;
function preRedeemHook(address vToken, address redeemer, uint256 redeemTokens) external;
function preRepayHook(address vToken, address borrower) external;
function preSeizeHook(
address vTokenCollateral,
address seizerContract,
address liquidator,
address borrower
) external;
function preTransferHook(address vToken, address src, address dst, uint256 transferTokens) external;
function prime() external view returns (address);
function redeemVerify(address vToken, address redeemer, uint256 redeemAmount, uint256 redeemTokens) external;
function renounceOwnership() external;
function repayBorrowVerify(
address vToken,
address payer,
address borrower,
uint256 actualRepayAmount,
uint256 borrowerIndex
) external;
function seizeVerify(
address vTokenCollateral,
address vTokenBorrowed,
address liquidator,
address borrower,
uint256 seizeTokens
) external;
function setAccessControlManager(address accessControlManager_) external;
function setActionsPaused(address[] memory marketsList, uint8[] memory actionsList, bool paused) external;
function setCloseFactor(uint256 newCloseFactorMantissa) external;
function setCollateralFactor(
address vToken,
uint256 newCollateralFactorMantissa,
uint256 newLiquidationThresholdMantissa
) external;
function setForcedLiquidation(address vTokenBorrowed, bool enable) external;
function setLiquidationIncentive(uint256 newLiquidationIncentiveMantissa) external;
function setMarketBorrowCaps(address[] memory vTokens, uint256[] memory newBorrowCaps) external;
function setMarketSupplyCaps(address[] memory vTokens, uint256[] memory newSupplyCaps) external;
function setMaxLoopsLimit(uint256 limit) external;
function setMinLiquidatableCollateral(uint256 newMinLiquidatableCollateral) external;
function setPriceOracle(address newOracle) external;
function setPrimeToken(address _prime) external;
function supplyCaps(address) external view returns (uint256);
function supportMarket(address vToken) external;
function transferOwnership(address newOwner) external;
function transferVerify(address vToken, address src, address dst, uint256 transferTokens) external;
function unlistMarket(address market) external returns (uint256);
function updateDelegate(address delegate, bool approved) external;
function updatePrices(address account) external;
struct RewardSpeeds {
address rewardToken;
uint256 supplySpeed;
uint256 borrowSpeed;
}
struct LiquidationOrder {
address vTokenCollateral;
address vTokenBorrowed;
uint256 repayAmount;
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;
/// @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)
/// @author dvpublic (https://github.com/dvpublic)
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();
error InsufficientBalance();
error IncorrectBalance();
error IncorrectLtv(uint ltv);
error TooLowValue(uint value);
error IncorrectAssetsList(address[] assets_, address[] expectedAssets_);
//endregion -- Custom Errors -----
event ContractInitialized(address platform, uint ts, uint block);
/// @notice Stability Platform main contract address
function platform() external view returns (address);
/// @notice Version of contract implementation
/// @dev SemVer scheme MAJOR.MINOR.PATCH
//slither-disable-next-line naming-convention
function VERSION() external view returns (string memory);
/// @notice Block number when contract was initialized
function createdBlock() external view returns (uint);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/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) (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
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.28;
/// @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_);
event RevenueRouter(address revenueRouter_);
event MetaVaultFactory(address metaVaultFactory);
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* 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 revenueRouter;
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* 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 Platform revenue distributor
/// @return Address of the revenue distributor proxy
function revenueRouter() external view returns (address);
/// @notice Factory of MetaVaults
/// @return Address of the MetaVault factory
function metaVaultFactory() 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
);
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* 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;
}// 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);
event VaultWithSafeSharePriceAdded(address vault);
event VaultWithSafeSharePriceRemoved(address vault);
//endregion -- Events -----
//region --------------------------- Errors
error NotWhitelistedTransientCache();
//endregion --------------------------- Errors
/// @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 Price of vault share
/// @dev Price of 1.0 amount of vault token
/// @param vault Address of vault
/// @return price USD price with 18 decimals
/// @return safe Safe to use this price on-chain
function getVaultPrice(address vault) external view returns (uint price, bool safe);
/// @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 Get vaults that have organic safe share price that can be used on-chain
function vaultsWithSafeSharePrice() external view returns (address[] memory vaults);
/// @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;
/// @notice Remove oracle adapter from PriceReader
/// Only operator (multisig is operator too) can add adapter
/// @param adapter_ Address of price oracle proxy
function removeAdapter(address adapter_) external;
/// @notice Add vaults that have organic safe share price that can be used on-chain
/// Only operator (multisig is operator too) can add adapter
/// @param vaults Addresses of vaults
function addSafeSharePrices(address[] memory vaults) external;
/// @notice Remove vaults that have organic safe share price that can be used on-chain
/// Only operator (multisig is operator too) can add adapter
/// @param vaults Addresses of vaults
function removeSafeSharePrices(address[] memory vaults) external;
/// @notice Check if the user is whitelisted for using transient cache
function whitelistTransientCache(address user_) external view returns (bool);
/// @notice Add user to whitelist of users allowed to use the transient cache
function changeWhitelistTransientCache(address user, bool add) external;
/// @notice Save asset price to transient cache
/// @param asset Pass 0 to clear the cache
function preCalculatePriceTx(address asset) external;
/// @notice Save vault price to transient cache
/// Second call with the same vault will be ignored and won't not change the price
/// @param vault Pass 0 to clear the cache
function preCalculateVaultPriceTx(address vault) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;
import {IERC165} from "@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;
/// @inheritdoc IStrategy
uint fuseOn;
}
enum FuseMode {
FUSE_OFF_0,
/// @notice Fuse mode is on (emergency stop was called).
/// All assets were transferred from the underlying pool to the strategy balance, no deposits are allowed.
FUSE_ON_1
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* 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 5 decimals. 100_000 - 100% APR, 9_955 - 9.96% APR.
function lastApr() external view returns (uint);
/// @dev Last APR of compounded assets registered by HardWork.
/// Can be used on-chain.
/// @return APR with 5 decimals. 100_000 - 100% APR, 9_955 - 9.96% APR.
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 Amounts 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 Consumed 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 Amount 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 Amount 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;
/// @notice Total amount of assets available in the lending protocol for withdraw
/// It's normal situation when user is not able to withdraw all
/// because there are not enough reserves available in the protocol right now
/// @dev This function is replaced by more flexible maxWithdrawAssets(uint mode) function.
function maxWithdrawAssets() external view returns (uint[] memory amounts);
/// @notice Total amount of assets available in the lending protocol for withdraw
/// It's normal situation when user is not able to withdraw all
/// because there are not enough reserves available in the protocol right now
/// @param mode 0 - Return amount that can be withdrawn in assets
/// 1 - Return amount that can be withdrawn in underlying
/// @return amounts Empty array (zero length) is returned if all available amount can be withdrawn
function maxWithdrawAssets(uint mode) external view returns (uint[] memory amounts);
/// @notice Underlying pool TVL in the terms of USD
function poolTvl() external view returns (uint tvlUsd);
/// @notice return FUSE_ON_1 if emergency was called and all actives were transferred to the vault
function fuseMode() external view returns (uint);
/// @notice Maximum amounts of assets that can be deposited into the strategy
/// @return amounts Empty array (zero length) is returned if there are no limits on deposits
function maxDepositAssets() external view returns (uint[] memory amounts);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;
/// @notice Restored from Sonic.0x87C69a8fB7F04b7890F48A1577a83788683A2036
/// @dev https://github.com/EnclaveLabs/enclabs-protocol
interface IVToken {
error AddReservesFactorFreshCheck(uint256 actualAddAmount);
error BorrowCashNotAvailable();
error BorrowFreshnessCheck();
error DelegateNotApproved();
error ForceLiquidateBorrowUnauthorized();
error HealBorrowUnauthorized();
error InvalidBlocksPerYear();
error InvalidTimeBasedConfiguration();
error LiquidateAccrueCollateralInterestFailed(uint256 errorCode);
error LiquidateCloseAmountIsUintMax();
error LiquidateCloseAmountIsZero();
error LiquidateCollateralFreshnessCheck();
error LiquidateFreshnessCheck();
error LiquidateLiquidatorIsBorrower();
error LiquidateSeizeLiquidatorIsBorrower();
error MintFreshnessCheck();
error ProtocolSeizeShareTooBig();
error RedeemFreshnessCheck();
error RedeemTransferOutNotPossible();
error ReduceReservesCashNotAvailable();
error ReduceReservesCashValidation();
error ReduceReservesFreshCheck();
error RepayBorrowFreshnessCheck();
error SetInterestRateModelFreshCheck();
error SetReserveFactorBoundsCheck();
error SetReserveFactorFreshCheck();
error TransferNotAllowed();
error Unauthorized(
address sender,
address calledContract,
string methodSignature
);
error ZeroAddressNotAllowed();
event AccrueInterest(
uint256 cashPrior,
uint256 interestAccumulated,
uint256 borrowIndex,
uint256 totalBorrows
);
event Approval(
address indexed owner,
address indexed spender,
uint256 amount
);
event BadDebtIncreased(
address indexed borrower,
uint256 badDebtDelta,
uint256 badDebtOld,
uint256 badDebtNew
);
event BadDebtRecovered(uint256 badDebtOld, uint256 badDebtNew);
event Borrow(
address indexed borrower,
uint256 borrowAmount,
uint256 accountBorrows,
uint256 totalBorrows
);
event HealBorrow(
address indexed payer,
address indexed borrower,
uint256 repayAmount
);
event Initialized(uint8 version);
event LiquidateBorrow(
address indexed liquidator,
address indexed borrower,
uint256 repayAmount,
address indexed vTokenCollateral,
uint256 seizeTokens
);
event Mint(
address indexed minter,
uint256 mintAmount,
uint256 mintTokens,
uint256 accountBalance
);
event NewAccessControlManager(
address oldAccessControlManager,
address newAccessControlManager
);
event NewComptroller(
address indexed oldComptroller,
address indexed newComptroller
);
event NewMarketInterestRateModel(
address indexed oldInterestRateModel,
address indexed newInterestRateModel
);
event NewProtocolSeizeShare(
uint256 oldProtocolSeizeShareMantissa,
uint256 newProtocolSeizeShareMantissa
);
event NewProtocolShareReserve(
address indexed oldProtocolShareReserve,
address indexed newProtocolShareReserve
);
event NewReduceReservesBlockDelta(
uint256 oldReduceReservesBlockOrTimestampDelta,
uint256 newReduceReservesBlockOrTimestampDelta
);
event NewReserveFactor(
uint256 oldReserveFactorMantissa,
uint256 newReserveFactorMantissa
);
event NewShortfallContract(
address indexed oldShortfall,
address indexed newShortfall
);
event OwnershipTransferStarted(
address indexed previousOwner,
address indexed newOwner
);
event OwnershipTransferred(
address indexed previousOwner,
address indexed newOwner
);
event ProtocolSeize(
address indexed from,
address indexed to,
uint256 amount
);
event Redeem(
address indexed redeemer,
uint256 redeemAmount,
uint256 redeemTokens,
uint256 accountBalance
);
event RepayBorrow(
address indexed payer,
address indexed borrower,
uint256 repayAmount,
uint256 accountBorrows,
uint256 totalBorrows
);
event ReservesAdded(
address indexed benefactor,
uint256 addAmount,
uint256 newTotalReserves
);
event SpreadReservesReduced(
address indexed protocolShareReserve,
uint256 reduceAmount,
uint256 newTotalReserves
);
event SweepToken(address indexed token);
event Transfer(address indexed from, address indexed to, uint256 amount);
function NO_ERROR() external view returns (uint256);
function acceptOwnership() external;
function accessControlManager() external view returns (address);
function accrualBlockNumber() external view returns (uint256);
function accrueInterest() external returns (uint256);
function addReserves(uint256 addAmount) external;
function allowance(address owner, address spender) external view returns (uint256);
function approve(address spender, uint256 amount) external returns (bool);
function badDebt() external view returns (uint256);
function badDebtRecovered(uint256 recoveredAmount_) external;
function balanceOf(address owner) external view returns (uint256);
function balanceOfUnderlying(address owner) external returns (uint256);
function blocksOrSecondsPerYear() external view returns (uint256);
function borrow(uint256 borrowAmount) external returns (uint256);
function borrowBalanceCurrent(address account) external returns (uint256);
function borrowBalanceStored(address account) external view returns (uint256);
function borrowBehalf(address borrower, uint256 borrowAmount) external returns (uint256);
function borrowIndex() external view returns (uint256);
function borrowRatePerBlock() external view returns (uint256);
function comptroller() external view returns (address);
function decimals() external view returns (uint8);
function decreaseAllowance(address spender, uint256 subtractedValue) external returns (bool);
function exchangeRateCurrent() external returns (uint256);
function exchangeRateStored() external view returns (uint256);
function forceLiquidateBorrow(
address liquidator,
address borrower,
uint256 repayAmount,
address vTokenCollateral,
bool skipLiquidityCheck
) external;
function getAccountSnapshot(address account) external view returns (
uint256 error,
uint256 vTokenBalance,
uint256 borrowBalance,
uint256 exchangeRate
);
function getBlockNumberOrTimestamp() external view returns (uint256);
function getCash() external view returns (uint256);
function healBorrow(address payer, address borrower, uint256 repayAmount) external;
function increaseAllowance(address spender, uint256 addedValue) external returns (bool);
function initialize(
address underlying_,
address comptroller_,
address interestRateModel_,
uint256 initialExchangeRateMantissa_,
string memory name_,
string memory symbol_,
uint8 decimals_,
address admin_,
address accessControlManager_,
RiskManagementInit memory riskManagement,
uint256 reserveFactorMantissa_
) external;
function interestRateModel() external view returns (address);
function isTimeBased() external view returns (bool);
function isVToken() external pure returns (bool);
function liquidateBorrow(address borrower, uint256 repayAmount, address vTokenCollateral) external returns (uint256);
function mint(uint256 mintAmount) external returns (uint256);
function mintBehalf(address minter, uint256 mintAmount) external returns (uint256);
function name() external view returns (string memory);
function owner() external view returns (address);
function pendingOwner() external view returns (address);
function protocolSeizeShareMantissa() external view returns (uint256);
function protocolShareReserve() external view returns (address);
function redeem(uint256 redeemTokens) external returns (uint256);
function redeemBehalf(address redeemer, uint256 redeemTokens) external returns (uint256);
function redeemUnderlying(uint256 redeemAmount) external returns (uint256);
function redeemUnderlyingBehalf(address redeemer, uint256 redeemAmount) external returns (uint256);
function reduceReserves(uint256 reduceAmount) external;
function reduceReservesBlockDelta() external view returns (uint256);
function reduceReservesBlockNumber() external view returns (uint256);
function renounceOwnership() external;
function repayBorrow(uint256 repayAmount) external returns (uint256);
function repayBorrowBehalf(address borrower, uint256 repayAmount) external returns (uint256);
function reserveFactorMantissa() external view returns (uint256);
function seize(address liquidator, address borrower, uint256 seizeTokens) external;
function setAccessControlManager(address accessControlManager_) external;
function setInterestRateModel(address newInterestRateModel) external;
function setProtocolSeizeShare(uint256 newProtocolSeizeShareMantissa_) external;
function setProtocolShareReserve(address protocolShareReserve_) external;
function setReduceReservesBlockDelta(uint256 _newReduceReservesBlockOrTimestampDelta) external;
function setReserveFactor(uint256 newReserveFactorMantissa) external;
function setShortfallContract(address shortfall_) external;
function shortfall() external view returns (address);
function supplyRatePerBlock() external view returns (uint256);
function sweepToken(address token) external;
function symbol() external view returns (string memory);
function totalBorrows() external view returns (uint256);
function totalBorrowsCurrent() external returns (uint256);
function totalReserves() external view returns (uint256);
function totalSupply() external view returns (uint256);
function transfer(address dst, uint256 amount) external returns (bool);
function transferFrom(address src, address dst, uint256 amount) external returns (bool);
function transferOwnership(address newOwner) external;
function underlying() external view returns (address);
struct RiskManagementInit {
address shortfall;
address protocolShareReserve;
}
}// 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
// 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
pragma solidity ^0.8.23;
import {Strings} from "@openzeppelin/contracts/utils/Strings.sol";
library SharedLib {
function shortAddress(address addr) internal pure returns (string memory) {
bytes memory s = bytes(Strings.toHexString(addr));
bytes memory shortAddr = new bytes(12);
shortAddr[0] = "0";
shortAddr[1] = "x";
shortAddr[2] = s[2];
shortAddr[3] = s[3];
shortAddr[4] = s[4];
shortAddr[5] = s[5];
shortAddr[6] = ".";
shortAddr[7] = ".";
shortAddr[8] = s[38];
shortAddr[9] = s[39];
shortAddr[10] = s[40];
shortAddr[11] = s[41];
return string(shortAddr);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;
import {SafeERC20, IERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
import {Controllable, IControllable} from "../../core/base/Controllable.sol";
import {VaultTypeLib} from "../../core/libs/VaultTypeLib.sol";
import {StrategyLib} from "../libs/StrategyLib.sol";
import {IStrategy} from "../../interfaces/IStrategy.sol";
import {IVault} from "../../interfaces/IVault.sol";
/// @dev Base universal strategy
/// Changelog:
/// 2.5.1: add maxWithdrawAssets(uint) - #360
/// 2.5.0: add maxDepositAssets - #330
/// 2.4.0: add poolTvl, maxWithdrawAssets - #326
/// 2.3.0: add fuseMode - #305
/// 2.2.0: extractFees use RevenueRouter
/// 2.1.3: call hardWorkMintFeeCallback always
/// 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.5.1";
// 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_);
}
//region -------------------- Restricted actions
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* 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, __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);
} else {
(, uint[] memory __assetsAmounts) = assetsAmounts();
uint[] memory virtualRevenueAmounts = new uint[](__assets.length);
virtualRevenueAmounts[0] = __assetsAmounts[0] * (block.timestamp - $.lastHardWork) / 365 days / 15;
IVault(_vault).hardWorkMintFeeCallback(__assets, virtualRevenueAmounts);
}
// 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));
// Activate fuse mode. In the fuse mode all assets are transferred
// from the underlying pool to the strategy balance, no deposits are allowed after that.
_getStrategyBaseStorage().fuseOn = uint(IStrategy.FuseMode.FUSE_ON_1);
}
/// @inheritdoc IStrategy
function setCustomPriceImpactTolerance(uint priceImpactTolerance) external onlyOperator {
StrategyBaseStorage storage $ = _getStrategyBaseStorage();
$.customPriceImpactTolerance = priceImpactTolerance;
}
//endregion -------------------- Restricted actions
//region -------------------- View functions
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* 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;
}
/// @notice IStrategy
function maxWithdrawAssets() public view virtual returns (uint[] memory amounts) {
return maxWithdrawAssets(0);
}
/// @notice IStrategy
function maxWithdrawAssets(uint /*mode*/ ) public view virtual returns (uint[] memory amounts) {
// by default zero-length array is returned to indicate that all available amounts can be withdrawn
return amounts;
}
/// @inheritdoc IStrategy
function poolTvl() public view virtual returns (uint tvlUsd) {
// by default max uint is returned to indicate that pool TVL is not calculated
return type(uint).max;
}
/// @notice IStrategy
function maxDepositAssets() public view virtual returns (uint[] memory amounts) {
// by default zero-length array is returned to indicate that there are no limits on deposit amounts
return amounts;
}
//endregion -------------------- View functions
//region -------------------- Default implementations
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* Default implementations */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @inheritdoc IStrategy
function fuseMode() external view returns (uint) {
return _getStrategyBaseStorage().fuseOn;
}
/// @dev Invest underlying asset. Asset must be already on strategy contract balance.
/// @return Consumed amounts of invested assets
function _depositUnderlying(uint /*amount*/ ) internal virtual returns (uint[] memory /*amountsConsumed*/ ) {
revert(_getStrategyBaseStorage()._underlying == address(0) ? "no underlying" : "not implemented");
}
/// @dev Withdraw 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();
}
}
//endregion -------------------- Default implementations
//region -------------------- Must be implemented by derived contracts
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* 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);
}
//endregion -------------------- Must be implemented by derived contracts
//region -------------------- Internal logic
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* 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();
}
}
//endregion -------------------- Internal logic
}// 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";
string internal constant GAMMA_EQUALIZER_FARM = "Gamma Equalizer Farm";
string internal constant ICHI_EQUALIZER_FARM = "Ichi Equalizer Farm";
string internal constant SILO = "Silo";
string internal constant AAVE = "Aave";
string internal constant EULER = "Euler"; // https://euler.finance/
string internal constant SILO_MANAGED_FARM = "Silo Managed Farm";
string internal constant SILO_ALMF_FARM = "Silo Advanced Leverage Merkl Farm";
string internal constant AAVE_MERKL_FARM = "Aave Merkl Farm";
string internal constant COMPOUND_V2 = "Compound V2";
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;
import {ERC20Upgradeable} from "@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol";
import {SafeERC20, IERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {ConstantsLib} from "../../core/libs/ConstantsLib.sol";
import {CommonLib} from "../../core/libs/CommonLib.sol";
import {IPlatform} from "../../interfaces/IPlatform.sol";
import {IVaultManager} from "../../interfaces/IVaultManager.sol";
import {IFactory} from "../../interfaces/IFactory.sol";
import {IPriceReader} from "../../interfaces/IPriceReader.sol";
import {ISwapper} from "../../interfaces/ISwapper.sol";
import {IStrategy} from "../../interfaces/IStrategy.sol";
import {IFarmingStrategy} from "../../interfaces/IFarmingStrategy.sol";
import {IRevenueRouter} from "../../interfaces/IRevenueRouter.sol";
library StrategyLib {
using SafeERC20 for IERC20;
/// @dev Reward pools may have low liquidity and up to 2% 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);
}
$._rewardsOnBalance = new uint[](len);
}
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,
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.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) {
try vars.platform.revenueRouter() returns (address revenueReceiver) {
IERC20(assets_[i]).forceApprove(revenueReceiver, vars.amountPlatform);
IRevenueRouter(revenueReceiver).processFeeAsset(assets_[i], vars.amountPlatform);
} catch {
// can be only in old strategy upgrade tests
}
/*// 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;
library VaultTypeLib {
string internal constant COMPOUNDING = "Compounding";
string internal constant REWARDING = "Rewarding";
string internal constant REWARDING_MANAGED = "Rewarding Managed";
string internal constant MULTIVAULT = "MultiVault";
string internal constant METAVAULT = "MetaVault";
}// 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;
library ConstantsLib {
uint internal constant DENOMINATOR = 100_000;
address internal constant DEAD_ADDRESS = 0xdEad000000000000000000000000000000000000;
}// 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/introspection/IERC165.sol)
pragma solidity ^0.8.20;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/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
pragma solidity ^0.8.28;
import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
import {ERC165} from "@openzeppelin/contracts/utils/introspection/ERC165.sol";
import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
import {SlotsLib} from "../libs/SlotsLib.sol";
import {IControllable} from "../../interfaces/IControllable.sol";
import {IPlatform} from "../../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.1";
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 {
require(platform_ != address(0) && IPlatform(platform_).multisig() != address(0), 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 {
require(IPlatform(platform()).governance() == msg.sender, NotGovernance());
}
function _requireMultisig() internal view {
require(IPlatform(platform()).multisig() == msg.sender, NotMultisig());
}
function _requireGovernanceOrMultisig() internal view {
IPlatform _platform = IPlatform(platform());
require(
_platform.governance() == msg.sender || _platform.multisig() == msg.sender, NotGovernanceAndNotMultisig()
);
}
function _requireOperator() internal view {
require(IPlatform(platform()).isOperator(msg.sender), NotOperator());
}
function _requireFactory() internal view {
require(IPlatform(platform()).factory() == msg.sender, NotFactory());
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;
import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
import {IStrategy} from "./IStrategy.sol";
import {IStabilityVault} from "./IStabilityVault.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, IStabilityVault {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
error NotEnoughBalanceToPay();
error FuseTrigger();
error ExceedSlippageExactAsset(address asset, uint mintToUser, uint minToMint);
error NotEnoughAmountToInitSupply(uint mintAmount, uint initialShares);
error StrategyZeroDeposit();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* EVENTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
event HardWorkGas(uint gasUsed, uint gasCost, bool compensated);
event DoHardWorkOnDepositChanged(bool oldValue, bool newValue);
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;
/// @inheritdoc IStabilityVault
bool lastBlockDefenseDisabled;
}
/// @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 */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @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);
/// @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 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;
}// 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;
/// @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;
/// @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.28;
import {EnumerableSet} from "@openzeppelin/contracts/utils/structs/EnumerableSet.sol";
interface IRevenueRouter {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* EVENTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
event EpochFlip(uint periodEnded, uint totalStblRevenue);
event AddedUnit(uint unitIndex, UnitType unitType, string name, address feeTreasury);
event UpdatedUnit(uint unitIndex, UnitType unitType, string name, address feeTreasury);
event UnitEpochRevenue(uint periodEnded, string unitName, uint stblRevenue);
event ProcessUnitRevenue(uint unitIndex, uint stblGot);
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
error WaitForNewPeriod();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* DATA TYPES */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @custom:storage-location erc7201:stability.RevenueRouter
struct RevenueRouterStorage {
address stbl;
address xStbl;
address xStaking;
address feeTreasury;
uint xShare;
uint activePeriod;
uint pendingRevenue;
Unit[] units;
address[] aavePools;
EnumerableSet.AddressSet vaultsAccumulated;
}
enum UnitType {
Core,
AaveMarkets,
Assets
}
struct Unit {
UnitType unitType;
string name;
uint pendingRevenue;
address feeTreasury;
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* GOV ACTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @notice Add new Unit
function addUnit(UnitType unitType, string calldata name, address feeTreasury) external;
/// @notice Update Unit
function updateUnit(uint unitIndex, UnitType unitType, string calldata name, address feeTreasury) external;
/// @notice Setup Aave pool list
function setAavePools(address[] calldata pools) external;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* USER ACTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @notice Update the epoch (period) -- callable once a week at >= Thursday 0 UTC
/// @return newPeriod The new period
function updatePeriod() external returns (uint newPeriod);
/// @notice Process platform fee in form of an asset
function processFeeAsset(address asset, uint amount) external;
/// @notice Process platform fee in form of an vault shares
function processFeeVault(address vault, uint amount) external;
/// @notice Claim unit fees and swap to STBL
function processUnitRevenue(uint unitIndex) external;
/// @notice Claim units fees and swap to STBL
function processUnitsRevenue() external;
/// @notice Withdraw assets from accumulated vaults and swap to STBL
function processAccumulatedVaults(uint maxVaultsForWithdraw) external;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* VIEW FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @notice Show all Units
function units() external view returns (Unit[] memory);
/// @notice The period used for rewarding
/// @return The block.timestamp divided by 1 week in seconds
function getPeriod() external view returns (uint);
/// @notice Current active period
function activePeriod() external view returns (uint);
/// @notice Accumulated STBL amount for next distribution by core unit (vault fees)
function pendingRevenue() external view returns (uint);
/// @notice Accumulated STBL amount for next distribution by unit
function pendingRevenue(uint unitIndex) external view returns (uint);
/// @notice Get Aave pool list to mintToTreasury calls
function aavePools() external view returns (address[] memory);
/// @notice Get vault addresses that contract hold on balance, but not withdrew yet
function vaultsAccumulated() external view returns (address[] memory);
}// 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
pragma solidity ^0.8.28;
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol";
/// @notice Base interface of Stability Vault
interface IStabilityVault is IERC20, IERC20Metadata {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
error WaitAFewBlocks();
error ExceedSlippage(uint mintToUser, uint minToMint);
error ExceedMaxSupply(uint maxSupply);
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 MaxSupply(uint maxShares);
event VaultName(string newName);
event VaultSymbol(string newSymbol);
event LastBlockDefenseDisabled(bool isDisabled);
//region --------------------------------------- View functions
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* VIEW FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @notice Underlying assets
function assets() external view returns (address[] memory);
/// @notice Immutable vault type ID
function vaultType() external view returns (string memory);
/// @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);
/// @dev USD price of share with 18 decimals.
/// Not trusted vault share price can be manipulated, used only OFF-CHAIN.
/// @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
/// Not trusted vault share price can be manipulated, used only OFF-CHAIN.
/// @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 Minimum 6 blocks between deposit and withdraw check disabled
function lastBlockDefenseDisabled() external view returns (bool);
/// @return amount Maximum amount that can be withdrawn from the vault for the given account.
/// This is max amount that can be passed to `withdraw` function.
/// The implementation should take into account IStrategy.maxWithdrawAssets
/// @dev It's alias of IStabilityVault.maxWithdraw(account, 0) for backwords compatibility.
function maxWithdraw(address account) external view returns (uint amount);
/// @return amount Maximum amount that can be withdrawn from the vault for the given account.
/// This is max amount that can be passed to `withdraw` function.
/// The implementation should take into account IStrategy.maxWithdrawAssets
/// @param mode 0 - Return amount that can be withdrawn in assets
/// 1 - Return amount that can be withdrawn in underlying
function maxWithdraw(address account, uint mode) external view returns (uint amount);
/// @return maxAmounts Maximum amounts that can be deposited to the vault for the given account.
/// This is max amounts of {assets} that can be passed to `depositAssets` function as {amountsMax}.
/// The implementation should take into account IStrategy.maxDepositAssets
/// Return type(uint).max if there is no limit for the asset.
function maxDeposit(address account) external view returns (uint[] memory maxAmounts);
//endregion --------------------------------------- View functions
//region --------------------------------------- Write functions
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* WRITE FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @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 Changing ERC20 name of vault
function setName(string calldata newName) external;
/// @dev Changing ERC20 symbol of vault
function setSymbol(string calldata newSymbol) external;
/// @dev Enable or disable last block check
function setLastBlockDefenseDisabled(bool isDisabled) external;
//endregion --------------------------------------- Write functions
}// 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
// 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": "cancun",
"viaIR": false,
"libraries": {
"src/strategies/CompoundV2Strategy.sol": {
"CommonLib": "0x72a237cb9caaf0716bb4f717e32e79ce6460e5d3",
"StrategyLib": "0x5404dd7dc0dfc2bb746dc8320caf6f07c16ba21c"
}
}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"uint256","name":"errorCode","type":"uint256"}],"name":"AccrueInterestError","type":"error"},{"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":[{"internalType":"address[]","name":"assets_","type":"address[]"},{"internalType":"address[]","name":"expectedAssets_","type":"address[]"}],"name":"IncorrectAssetsList","type":"error"},{"inputs":[],"name":"IncorrectBalance","type":"error"},{"inputs":[],"name":"IncorrectInitParams","type":"error"},{"inputs":[{"internalType":"uint256","name":"ltv","type":"uint256"}],"name":"IncorrectLtv","type":"error"},{"inputs":[],"name":"IncorrectMsgSender","type":"error"},{"inputs":[],"name":"IncorrectZeroArgument","type":"error"},{"inputs":[],"name":"InsufficientBalance","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[{"internalType":"uint256","name":"errorCode","type":"uint256"}],"name":"MintError","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":"uint256","name":"errorCode","type":"uint256"}],"name":"RedeemError","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"SafeERC20FailedOperation","type":"error"},{"inputs":[{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"length","type":"uint256"}],"name":"StringsInsufficientHexLength","type":"error"},{"inputs":[{"internalType":"uint256","name":"value","type":"uint256"}],"name":"TooLowValue","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"},{"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_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":"pure","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":"fuseMode","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","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":"view","type":"function"},{"inputs":[],"name":"getSpecificName","outputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"bool","name":"","type":"bool"}],"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":"maxDepositAssets","outputs":[{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxWithdrawAssets","outputs":[{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"mode","type":"uint256"}],"name":"maxWithdrawAssets","outputs":[{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"platform","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"poolTvl","outputs":[{"internalType":"uint256","name":"tvlUsd","type":"uint256"}],"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":[{"internalType":"uint256","name":"priceImpactTolerance","type":"uint256"}],"name":"setCustomPriceImpactTolerance","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":"pure","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
6080604052348015600e575f5ffd5b5060156019565b60c9565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00805468010000000000000000900460ff161560685760405163f92ee8a960e01b815260040160405180910390fd5b80546001600160401b039081161460c65780546001600160401b0319166001600160401b0390811782556040519081527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b50565b61465a806100d65f395ff3fe608060405234801561000f575f5ffd5b5060043610610255575f3560e01c806371a9730511610140578063b600585a116100bf578063f1faf05011610084578063f1faf050146104d2578063f815c4ff146104da578063f985b0bc146104e2578063fbfa77cf146104f5578063fdff667c146104fd578063ffa1ad741461043c575f5ffd5b8063b600585a14610486578063b6c8cdef1461041d578063b9f5be4114610499578063bd5a7468146104ac578063ead0bc47146104bf575f5ffd5b80638c3aefa7116101055780638c3aefa714610434578063936725ec1461043c5780639736374e1461041d57806399f428cf14610460578063a2b7722c14610473575f5ffd5b806371a97305146104005780637284e4161461041557806374bac4291461041d57806383ecf6531461042457806389816e301461042c575f5ffd5b80634875c968116101d757806359498ab71161019c57806359498ab71461039b5780635b0f088a146103a357806367cf905a146103c757806367fde573146103cf5780636d989439146103d75780636f307dc3146103f8575f5ffd5b80634875c9681461030d57806348d7d9eb1461033d5780634bde38c8146103535780634fa5d8541461037357806350f4e4191461037b575f5ffd5b80632d433b281161021d5780632d433b28146102bd5780632ddbd13a146102e057806341760fe6146102e857806341affeb8146102f05780634593144c14610305575f5ffd5b806301ffc9a71461025957806313e63180146102815780631639ba9814610297578063190024e01461029f5780631ec71e05146102a7575b5f5ffd5b61026c610267366004613854565b610512565b60405190151581526020015b60405180910390f35b61028961053c565b604051908152602001610278565b61028961054e565b610289610560565b6102af610601565b6040516102789291906138a9565b6102d06102cb3660046138e0565b6106b7565b60405161027894939291906139c8565b610289610910565b6102896109a3565b6103036102fe366004613bb3565b6109b5565b005b610289610c93565b60408051808201909152600b81526a21b7b6b837bab732102b1960a91b60208201525b6040516102789190613ca0565b610345610cc6565b604051610278929190613cb2565b61035b610d02565b6040516001600160a01b039091168152602001610278565b610303610d31565b61038e610389366004613cd6565b61114b565b6040516102789190613d2c565b61034561116a565b61033060405180604001604052806005815260200164322e352e3160d81b81525081565b61038e6111fc565b610303611248565b6103ea6103e5366004613d3e565b611272565b604051610278929190613da1565b61035b611377565b610408611392565b6040516102789190613dc2565b6103306113fb565b600161026c565b61038e611420565b61028961142b565b61038e6116e5565b61033060405180604001604052806005815260200164312e302e3160d81b81525081565b61030361046e366004613dd4565b611922565b610289610481366004613e02565b611938565b6103ea610494366004613d3e565b611972565b61038e6104a7366004613e33565b611a64565b6103036104ba366004613e33565b611a77565b61038e6104cd366004613e33565b611a92565b610289611cbf565b610289611cd1565b61038e6104f0366004613e4a565b611ce3565b61035b611d8c565b610505611da4565b6040516102789190613e75565b5f6001600160e01b03198216630314af3360e01b1480610536575061053682611e16565b92915050565b5f610545611e4a565b60020154905090565b5f610557611e4a565b60090154905090565b6040805161d39560e81b60208201525f6023820181905282516006818403018152602683019384905263bfe370d960e01b909352917372a237cb9caaf0716bb4f717e32e79ce6460e5d39163bfe370d9916105bd91602a01613ca0565b602060405180830381865af41580156105d8573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906105fc9190613e87565b905090565b60605f5f61060d611e4a565b600601546001600160a01b031690505f61062682611e6e565b9050816001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015610663573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f1916820160405261068a9190810190613e9e565b8160405160200161069c929190613f47565b60405160208183030381529060405260019350935050509091565b6060806060805f856001600160a01b031663c45a01556040518163ffffffff1660e01b8152600401602060405180830381865afa1580156106fa573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061071e9190613f66565b6001600160a01b0316639ad87ce461075460408051808201909152600b81526a21b7b6b837bab732102b1960a91b602082015290565b805190602001206040518263ffffffff1660e01b815260040161077991815260200190565b5f60405180830381865afa158015610793573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526107ba9190810190614040565b805151909150806001600160401b038111156107d8576107d8613a49565b60405190808252806020026020018201604052801561080b57816020015b60608152602001906001900390816107f65790505b509550806001600160401b0381111561082657610826613a49565b60405190808252806020026020018201604052801561084f578160200160208202803683370190505b50604080515f80825260208201818152828401909352929750955093505b818110156109065761089a835f0151828151811061088d5761088d614162565b6020026020010151612194565b8782815181106108ac576108ac614162565b6020026020010181905250825f015181815181106108cc576108cc614162565b60200260200101518682815181106108e6576108e6614162565b6001600160a01b039092166020928302919091019091015260010161086d565b5050509193509193565b5f5f61091a611e4a565b6006015460405163e3d670d760e01b81526001600160a01b03909116600482018190529150735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015610979573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061099d9190613e87565b91505090565b5f6109ac611e4a565b600a0154905090565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff1615906001600160401b03165f811580156109f95750825b90505f826001600160401b03166001148015610a145750303b155b905081158015610a22575080155b15610a405760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff191660011785558315610a6a57845460ff60401b1916600160401b1785555b87516003141580610a7b5750865115155b80610a865750855115155b15610aa4576040516363cf6b6160e01b815260040160405180910390fd5b6040805160018082528183019092525f916020808301908036833701905050905088600281518110610ad857610ad8614162565b60200260200101516001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b1b573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b3f9190613f66565b815f81518110610b5157610b51614162565b60200260200101906001600160a01b031690816001600160a01b031681525050610bf0895f81518110610b8657610b86614162565b60200260200101516040518060400160405280600b81526020016a21b7b6b837bab732102b1960a91b8152508b600181518110610bc557610bc5614162565b6020026020010151848d600281518110610be157610be1614162565b60200260200101515f196122ea565b610c4289600281518110610c0657610c06614162565b60200260200101515f19835f81518110610c2257610c22614162565b60200260200101516001600160a01b031661238e9092919063ffffffff16565b508315610c8957845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b5f6105fc610cc260017f812a673dfca07956350df10f8a654925f561d7a0da09bdbe79e653939a14d9f161418a565b5490565b6060805f610cd2611e4a565b600601546001600160a01b031690505f610ceb82612451565b9050610cf781836124b2565b909590945092505050565b5f6105fc610cc260017faa116a42804728f23983458454b6eb9c6ddf3011db9f9addaf3cd7508d85b0d661418a565b610d396125a3565b610d416125d6565b5f610d4a611e4a565b805460408051637299470360e11b815281519394506001600160a01b03909216925f92849263e5328e06926004808401938290030181865afa158015610d92573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610db691906141ac565b5090508015611146575f610dc8610d02565b60088501549091505f808080610ddc612653565b93509350935093505f610ded600190565b610ec357610e0d858781518110610e0657610e06614162565b505f919050565b848781518110610e1f57610e1f614162565b60200260200101818151610e3391906141d6565b9052506040516308dc79a160e01b81525f90735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c906308dc79a190610e75908b908e908b908b906004016141e9565b5f60405180830381865af4158015610e8f573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052610eb69190810190614231565b50505060018901546110d1565b604051633596603f60e01b8152735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c90633596603f90610efa908790600401613d2c565b602060405180830381865af4158015610f15573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610f399190614262565b15610f9e576040516336ac731760e11b81526001600160a01b038a1690636d58e62e90610f6c9088908890600401613cb2565b5f604051808303815f87803b158015610f83575f5ffd5b505af1158015610f95573d5f5f3e3d5ffd5b505050506110ba565b5f610fa761116a565b9150505f86516001600160401b03811115610fc457610fc4613a49565b604051908082528060200260200182016040528015610fed578160200160208202803683370190505b509050600f6301e133808d6002015442611007919061418a565b845f8151811061101957611019614162565b602002602001015161102b919061427b565b6110359190614292565b61103f9190614292565b815f8151811061105157611051614162565b60209081029190910101526040516336ac731760e11b81526001600160a01b038c1690636d58e62e9061108a908a908590600401613cb2565b5f604051808303815f87803b1580156110a1575f5ffd5b505af11580156110b3573d5f5f3e3d5ffd5b5050505050505b6110cf855f81518110610e0657610e06614162565b505b60405163640f244560e01b8152735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063640f244590611112908d908b908a908a908f9089906004016142b1565b5f6040518083038186803b158015611128575f5ffd5b505af415801561113a573d5f5f3e3d5ffd5b50505050505050505050505b505050565b60606111556125a3565b61116084848461275e565b90505b9392505050565b6060806111756129ff565b604051633f8b51a560e21b81529193509150735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063fe2d4694906111b39085908590600401613cb2565b5f60405180830381865af41580156111cd573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526111f49190810190614302565b915091509091565b60408051600180825281830190925260609160208083019080368337019050509050670de0b6b3a7640000815f8151811061123957611239614162565b60200260200101818152505090565b611250612b95565b61126161125b610910565b30612caf565b50600161126c611e4a565b600a0155565b60605f835160011480156112be5750611289611e4a565b6006015484516001600160a01b039091169085905f906112ab576112ab614162565b60200260200101516001600160a01b0316145b80156112f557505f6001600160a01b0316845f815181106112e1576112e1614162565b60200260200101516001600160a01b031614155b1561136157825160011461131c57604051630ef9926760e21b815260040160405180910390fd5b825f8151811061132e5761132e614162565b6020026020010151905061135a835f8151811061134d5761134d614162565b6020026020010151612d29565b9150611370565b61136b8484612d34565b915091505b9250929050565b5f611380611e4a565b600601546001600160a01b0316919050565b606061139c611e4a565b6005018054806020026020016040519081016040528092919081815260200182805480156113f157602002820191905f5260205f20905b81546001600160a01b031681526001909101906020018083116113d3575b5050505050905090565b60605f611406611e4a565b600681015490915061099d906001600160a01b0316612194565b60606105fc5f611a92565b5f5f611435611e4a565b6006015f9054906101000a90046001600160a01b031690505f816001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa15801561148a573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906114ae9190613f66565b90505f6114b9610d02565b6001600160a01b03166349b5fdb46040518163ffffffff1660e01b8152600401602060405180830381865afa1580156114f4573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906115189190613f66565b6040516341976e0960e01b81526001600160a01b0384811660048301529192505f918316906341976e09906024016040805180830381865afa158015611560573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061158491906141ac565b5090505f846001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156115c4573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906115e89190613e87565b90505f856001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa158015611627573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061164b9190613e87565b90505f6116588383612d41565b9050856001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611696573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906116ba919061435b565b6116c590600a61445e565b6116cf858361427b565b6116d99190614292565b97505050505050505090565b60605f6116f0611e4a565b6006015f9054906101000a90046001600160a01b031690505f816001600160a01b0316635fe3b5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611745573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117699190613f66565b6040516302c3bcbb60e01b81526001600160a01b03848116600483015291909116906302c3bcbb90602401602060405180830381865afa1580156117af573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117d39190613e87565b90505f19811461191d575f826001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561181a573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061183e9190613e87565b90505f6118aa82856001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa158015611881573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118a59190613e87565b612d41565b604080516001808252818301909252919250602080830190803683370190505094508083116118d9575f6118fc565b6103e86118e6828561418a565b6118f2906103e761427b565b6118fc9190614292565b855f8151811061190e5761190e614162565b60200260200101818152505050505b505090565b61192a6125a3565b6119348282612d5f565b5050565b5f6119416125a3565b5f61194a611e4a565b905080600201545f0361195e574260028201555b611969836001612d84565b9150505b919050565b60605f835160011480156119be5750611989611e4a565b6006015484516001600160a01b039091169085905f906119ab576119ab614162565b60200260200101516001600160a01b0316145b80156119f557505f6001600160a01b0316845f815181106119e1576119e1614162565b60200260200101516001600160a01b031614155b15611a5a578251600114611a1c57604051630ef9926760e21b815260040160405180910390fd5b825f81518110611a2e57611a2e614162565b6020026020010151905061135a835f81518110611a4d57611a4d614162565b6020026020010151612f9c565b61136b848461303a565b6060611a6e6125a3565b61053682613046565b611a7f613096565b5f611a88611e4a565b6009019190915550565b60605f611a9d611e4a565b6006015f9054906101000a90046001600160a01b031690505f816001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa158015611af2573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611b169190613f66565b6040516370a0823160e01b81526001600160a01b0384811660048301529192505f918316906370a0823190602401602060405180830381865afa158015611b5f573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611b839190613e87565b6040516370a0823160e01b81523060048201529091505f906001600160a01b038516906370a0823190602401602060405180830381865afa158015611bca573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611bee9190613e87565b90505f846001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa158015611c2d573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611c519190613e87565b90505f611c5e8383612d41565b604080516001808252818301909252919250602080830190803683370190505096508715611c8c5780611c96565b611c968185613123565b875f81518110611ca857611ca8614162565b602002602001018181525050505050505050919050565b5f611cc8611e4a565b60040154905090565b5f611cda611e4a565b60030154905090565b6060611ced6125a3565b735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c6325567aef611d0f611e4a565b6040516001600160e01b031960e084901b168152600481019190915260248101879052604481018690526001600160a01b03851660648201526084015f60405180830381865af4158015611d65573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526111609190810190614231565b5f611d95611e4a565b546001600160a01b0316919050565b604080516001808252818301909252606091816020015b6060815260200190600190039081611dbb5790505090506040518060400160405280600b81526020016a436f6d706f756e64696e6760a81b815250815f81518110611e0857611e08614162565b602002602001018190525090565b5f6001600160e01b03198216630f1ec81f60e41b148061053657506301ffc9a760e01b6001600160e01b0319831614610536565b7fb14b643f49bed6a2c6693bbd50f68dc950245db265c66acadbfa51ccc8c3ba0090565b60605f611e7a83613138565b60408051600c8082528183019092529192505f9190602082018180368337019050509050600360fc1b815f81518110611eb557611eb5614162565b60200101906001600160f81b03191690815f1a905350600f60fb1b81600181518110611ee357611ee3614162565b60200101906001600160f81b03191690815f1a90535081600281518110611f0c57611f0c614162565b602001015160f81c60f81b81600281518110611f2a57611f2a614162565b60200101906001600160f81b03191690815f1a90535081600381518110611f5357611f53614162565b602001015160f81c60f81b81600381518110611f7157611f71614162565b60200101906001600160f81b03191690815f1a90535081600481518110611f9a57611f9a614162565b602001015160f81c60f81b81600481518110611fb857611fb8614162565b60200101906001600160f81b03191690815f1a90535081600581518110611fe157611fe1614162565b602001015160f81c60f81b81600581518110611fff57611fff614162565b60200101906001600160f81b03191690815f1a905350601760f91b8160068151811061202d5761202d614162565b60200101906001600160f81b03191690815f1a905350601760f91b8160078151811061205b5761205b614162565b60200101906001600160f81b03191690815f1a9053508160268151811061208457612084614162565b602001015160f81c60f81b816008815181106120a2576120a2614162565b60200101906001600160f81b03191690815f1a905350816027815181106120cb576120cb614162565b602001015160f81c60f81b816009815181106120e9576120e9614162565b60200101906001600160f81b03191690815f1a9053508160288151811061211257612112614162565b602001015160f81c60f81b81600a8151811061213057612130614162565b60200101906001600160f81b03191690815f1a9053508160298151811061215957612159614162565b602001015160f81c60f81b81600b8151811061217757612177614162565b60200101906001600160f81b03191690815f1a9053509392505050565b6060816001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa1580156121d2573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906121f69190613f66565b6001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015612230573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526122579190810190613e9e565b826001600160a01b03166306fdde036040518163ffffffff1660e01b81526004015f60405180830381865afa158015612292573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526122b99190810190613e9e565b6122c284611e6e565b6040516020016122d49392919061446c565b6040516020818303038152906040529050919050565b6122f261314e565b6122fb86613197565b5f612304611e4a565b600881018390556006810180546001600160a01b0319166001600160a01b03861617905584519091508690869086908690869060078701905f908890829061235590600584019060208a01906137dd565b5081546001600160a01b03808a166101009390930a928302920219161790555061237f868261452a565b50505050505050505050505050565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663095ea7b360e01b1790526123df84826132f4565b61244b576040516001600160a01b0384811660248301525f604483015261244191869182169063095ea7b3906064015b604051602081830303815290604052915060e01b6020820180516001600160e01b038381831617835250505050613395565b61244b8482613395565b50505050565b5f816001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa15801561248e573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906105369190613e87565b6060805f5160206146055f395f51905f526124cb611392565b60408051600180825281830190925291945060208083019080368337505082549193505080861180156124fd57508015155b1561259a576040516370a0823160e01b81523060048201525f906001600160a01b038716906370a0823190602401602060405180830381865afa158015612546573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061256a9190613e87565b905061257a816118a5848a61418a565b845f8151811061258c5761258c614162565b602002602001018181525050505b50509250929050565b6125ab611e4a565b546001600160a01b031633146125d4576040516362df054560e01b815260040160405180910390fd5b565b306001600160a01b03166374bac4296040518163ffffffff1660e01b8152600401602060405180830381865afa158015612612573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906126369190614262565b6125d4576040516309ea311f60e11b815260040160405180910390fd5b60608080805f5160206146055f395f51905f525f61266f611e4a565b90505f816006015f9054906101000a90046001600160a01b031690505f816001600160a01b031663a6afed956040518163ffffffff1660e01b81526004016020604051808303815f875af11580156126c9573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906126ed9190613e87565b905080801561271b57604051633f8e520960e11b815260040161271291815260200190565b60405180910390fd5b505f61272683612451565b905061273281846124b2565b91909555604080515f80825260208201908152818301909252959a919950949750939550929350505050565b604080516001808252818301909252606091602080830190803683370190505090505f612789611e4a565b90505f816006015f9054906101000a90046001600160a01b031690505f816001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa1580156127e2573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906128069190613f66565b60405163e3d670d760e01b81526001600160a01b03821660048201529091505f90735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612861573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906128859190613e87565b60405163db006a7560e01b8152600481018990529091505f906001600160a01b0385169063db006a75906024016020604051808303815f875af11580156128ce573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906128f29190613e87565b9050808015612917576040516305ee2ff160e11b815260040161271291815260200190565b5060405163e3d670d760e01b81526001600160a01b03841660048201528290735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612970573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906129949190613e87565b61299e919061418a565b865f815181106129b0576129b0614162565b6020026020010181815250506129f387875f815181106129d2576129d2614162565b6020026020010151856001600160a01b03166133f69092919063ffffffff16565b50505050509392505050565b6060805f612a0b611e4a565b60058101805460408051602080840282018101909252828152939450830182828015612a5e57602002820191905f5260205f20905b81546001600160a01b03168152600190910190602001808311612a40575b5093965060019350612a6f92505050565b604051908082528060200260200182016040528015612a98578160200160208202803683370190505b50600682015460405163e3d670d760e01b81526001600160a01b039091166004820152909250612b7290735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612afc573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612b209190613e87565b826006015f9054906101000a90046001600160a01b03166001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa158015611881573d5f5f3e3d5ffd5b825f81518110612b8457612b84614162565b602002602001018181525050509091565b5f612b9e610d02565b9050336001600160a01b0316816001600160a01b0316635aa6e6756040518163ffffffff1660e01b8152600401602060405180830381865afa158015612be6573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612c0a9190613f66565b6001600160a01b03161480612c8f5750336001600160a01b0316816001600160a01b0316634783c35b6040518163ffffffff1660e01b8152600401602060405180830381865afa158015612c60573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612c849190613f66565b6001600160a01b0316145b612cac576040516354299b6f60e01b815260040160405180910390fd5b50565b60605f612cba611e4a565b9050612d2181600501805480602002602001604051908101604052809291908181526020018280548015612d1557602002820191905f5260205f20905b81546001600160a01b03168152600190910190602001808311612cf7575b5050505050858561275e565b949350505050565b606061053682612f9c565b60605f61136b848461303a565b5f670de0b6b3a7640000612d55838561427b565b6111639190614292565b5f612d68611e4a565b6006810154909150611146906001600160a01b031683856133f6565b5f5f5160206146055f395f51905f5281612d9c611e4a565b600681015460405163e3d670d760e01b81526001600160a01b03909116600482018190529192505f90735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612dff573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612e239190613e87565b9050865f81518110612e3757612e37614162565b60200260200101515f14612f92575f826001600160a01b031663a0712d68895f81518110612e6757612e67614162565b60200260200101516040518263ffffffff1660e01b8152600401612e8d91815260200190565b6020604051808303815f875af1158015612ea9573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612ecd9190613e87565b9050808015612ef257604051638c32d69360e01b815260040161271291815260200190565b5060405163e3d670d760e01b81526001600160a01b03841660048201528290735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612f4b573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612f6f9190613e87565b612f79919061418a565b85549096505f03612f9057612f8d83612451565b85555b505b5050505092915050565b60605f612fa7611e4a565b6040805160018082528183019092529192506020808301908036833750505060068201546040805163182df0f560e01b815290519294506130169286926001600160a01b03169163182df0f59160048083019260209291908290030181865afa158015611881573d5f5f3e3d5ffd5b825f8151811061302857613028614162565b60200260200101818152505050919050565b60605f61136b83613427565b60605f5160206146055f395f51905f525f61305f611e4a565b905061306a84612f9c565b82549093505f0361308f57600681015461308c906001600160a01b0316612451565b82555b5050919050565b61309e610d02565b6040516336b87bd760e11b81523360048201526001600160a01b039190911690636d70f7ae90602401602060405180830381865afa1580156130e2573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906131069190614262565b6125d457604051631f0853c160e21b815260040160405180910390fd5b5f8183106131315781611163565b5090919050565b60606105366001600160a01b038316601461352d565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff166125d457604051631afcd79f60e31b815260040160405180910390fd5b61319f61314e565b6001600160a01b0381161580159061322857505f6001600160a01b0316816001600160a01b0316634783c35b6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156131f8573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061321c9190613f66565b6001600160a01b031614155b613245576040516371c42ac360e01b815260040160405180910390fd5b61327861327360017faa116a42804728f23983458454b6eb9c6ddf3011db9f9addaf3cd7508d85b0d661418a565b829055565b6132aa436132a760017f812a673dfca07956350df10f8a654925f561d7a0da09bdbe79e653939a14d9f161418a565b55565b604080516001600160a01b0383168152426020820152438183015290517f1a2dd071001ebf6e03174e3df5b305795a4ad5d41d8fdb9ba41dbbe2367134269181900360600190a150565b5f5f5f846001600160a01b03168460405161330f91906145e4565b5f604051808303815f865af19150503d805f8114613348576040519150601f19603f3d011682016040523d82523d5f602084013e61334d565b606091505b50915091508180156133775750805115806133775750808060200190518101906133779190614262565b801561338c57505f856001600160a01b03163b115b95945050505050565b5f6133a96001600160a01b0384168361369e565b905080515f141580156133cd5750808060200190518101906133cb9190614262565b155b1561114657604051635274afe760e01b81526001600160a01b0384166004820152602401612712565b6040516001600160a01b0383811660248301526044820183905261114691859182169063a9059cbb9060640161240f565b60605f5f613433611e4a565b60408051600180825281830190925291925060208083019080368337019050509250835f8151811061346757613467614162565b6020026020010151835f8151811061348157613481614162565b602002602001018181525050613525845f815181106134a2576134a2614162565b6020026020010151826006015f9054906101000a90046001600160a01b03166001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa1580156134fc573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906135209190613e87565b6136ab565b915050915091565b6060825f61353c84600261427b565b6135479060026141d6565b6001600160401b0381111561355e5761355e613a49565b6040519080825280601f01601f191660200182016040528015613588576020820181803683370190505b509050600360fc1b815f815181106135a2576135a2614162565b60200101906001600160f81b03191690815f1a905350600f60fb1b816001815181106135d0576135d0614162565b60200101906001600160f81b03191690815f1a9053505f6135f285600261427b565b6135fd9060016141d6565b90505b6001811115613674576f181899199a1a9b1b9c1cb0b131b232b360811b83600f166010811061363157613631614162565b1a60f81b82828151811061364757613647614162565b60200101906001600160f81b03191690815f1a90535060049290921c9161366d816145ef565b9050613600565b508115612d215760405163e22e27eb60e01b81526004810186905260248101859052604401612712565b606061116383835f6136bf565b5f81612d5584670de0b6b3a764000061427b565b6060814710156136e45760405163cd78605960e01b8152306004820152602401612712565b5f5f856001600160a01b031684866040516136ff91906145e4565b5f6040518083038185875af1925050503d805f8114613739576040519150601f19603f3d011682016040523d82523d5f602084013e61373e565b606091505b509150915061374e868383613758565b9695505050505050565b60608261376d57613768826137b4565b611163565b815115801561378457506001600160a01b0384163b155b156137ad57604051639996b31560e01b81526001600160a01b0385166004820152602401612712565b5080611163565b8051156137c45780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b828054828255905f5260205f20908101928215613830579160200282015b8281111561383057825182546001600160a01b0319166001600160a01b039091161782556020909201916001909101906137fb565b5061383c929150613840565b5090565b5b8082111561383c575f8155600101613841565b5f60208284031215613864575f5ffd5b81356001600160e01b031981168114611163575f5ffd5b5f81518084528060208401602086015e5f602082860101526020601f19601f83011685010191505092915050565b604081525f6138bb604083018561387b565b905082151560208301529392505050565b6001600160a01b0381168114612cac575f5ffd5b5f602082840312156138f0575f5ffd5b8135611163816138cc565b5f82825180855260208501945060208160051b830101602085015f5b8381101561394957601f1985840301885261393383835161387b565b6020988901989093509190910190600101613917565b50909695505050505050565b5f8151808452602084019350602083015f5b8281101561398e5781516001600160a01b0316865260209586019590910190600101613967565b5093949350505050565b5f8151808452602084019350602083015f5b8281101561398e5781518652602095860195909101906001016139aa565b608081525f6139da60808301876138fb565b82810360208401526139ec8187613955565b90508281036040840152613a008186613998565b8381036060850152845180825260208087019350909101905f5b81811015613a3b57835160020b835260209384019390920191600101613a1a565b509098975050505050505050565b634e487b7160e01b5f52604160045260245ffd5b604051606081016001600160401b0381118282101715613a7f57613a7f613a49565b60405290565b604051601f8201601f191681016001600160401b0381118282101715613aad57613aad613a49565b604052919050565b5f6001600160401b03821115613acd57613acd613a49565b5060051b60200190565b5f82601f830112613ae6575f5ffd5b8135613af9613af482613ab5565b613a85565b8082825260208201915060208360051b860101925085831115613b1a575f5ffd5b602085015b83811015613b40578035613b32816138cc565b835260209283019201613b1f565b5095945050505050565b5f82601f830112613b59575f5ffd5b8135613b67613af482613ab5565b8082825260208201915060208360051b860101925085831115613b88575f5ffd5b602085015b83811015613b40578035835260209283019201613b8d565b8060020b8114612cac575f5ffd5b5f5f5f60608486031215613bc5575f5ffd5b83356001600160401b03811115613bda575f5ffd5b613be686828701613ad7565b93505060208401356001600160401b03811115613c01575f5ffd5b613c0d86828701613b4a565b92505060408401356001600160401b03811115613c28575f5ffd5b8401601f81018613613c38575f5ffd5b8035613c46613af482613ab5565b8082825260208201915060208360051b850101925088831115613c67575f5ffd5b6020840193505b82841015613c92578335613c8181613ba5565b825260209384019390910190613c6e565b809450505050509250925092565b602081525f611163602083018461387b565b604081525f613cc46040830185613955565b828103602084015261338c8185613998565b5f5f5f60608486031215613ce8575f5ffd5b83356001600160401b03811115613cfd575f5ffd5b613d0986828701613ad7565b935050602084013591506040840135613d21816138cc565b809150509250925092565b602081525f6111636020830184613998565b5f5f60408385031215613d4f575f5ffd5b82356001600160401b03811115613d64575f5ffd5b613d7085828601613ad7565b92505060208301356001600160401b03811115613d8b575f5ffd5b613d9785828601613b4a565b9150509250929050565b604081525f613db36040830185613998565b90508260208301529392505050565b602081525f6111636020830184613955565b5f5f60408385031215613de5575f5ffd5b823591506020830135613df7816138cc565b809150509250929050565b5f60208284031215613e12575f5ffd5b81356001600160401b03811115613e27575f5ffd5b612d2184828501613b4a565b5f60208284031215613e43575f5ffd5b5035919050565b5f5f5f60608486031215613e5c575f5ffd5b83359250602084013591506040840135613d21816138cc565b602081525f61116360208301846138fb565b5f60208284031215613e97575f5ffd5b5051919050565b5f60208284031215613eae575f5ffd5b81516001600160401b03811115613ec3575f5ffd5b8201601f81018413613ed3575f5ffd5b80516001600160401b03811115613eec57613eec613a49565b613eff601f8201601f1916602001613a85565b818152856020838501011115613f13575f5ffd5b8160208401602083015e5f91810160200191909152949350505050565b5f81518060208401855e5f93019283525090919050565b5f613f528285613f30565b600160fd1b815261338c6001820185613f30565b5f60208284031215613f76575f5ffd5b8151611163816138cc565b5f82601f830112613f90575f5ffd5b8151613f9e613af482613ab5565b8082825260208201915060208360051b860101925085831115613fbf575f5ffd5b602085015b83811015613b40578051613fd7816138cc565b835260209283019201613fc4565b5f82601f830112613ff4575f5ffd5b8151614002613af482613ab5565b8082825260208201915060208360051b860101925085831115614023575f5ffd5b602085015b83811015613b40578051835260209283019201614028565b5f60208284031215614050575f5ffd5b81516001600160401b03811115614065575f5ffd5b820160608185031215614076575f5ffd5b61407e613a5d565b81516001600160401b03811115614093575f5ffd5b61409f86828501613f81565b82525060208201516001600160401b038111156140ba575f5ffd5b6140c686828501613fe5565b60208301525060408201516001600160401b038111156140e4575f5ffd5b80830192505084601f8301126140f8575f5ffd5b8151614106613af482613ab5565b8082825260208201915060208360051b860101925087831115614127575f5ffd5b6020850194505b8285101561415257845161414181613ba5565b82526020948501949091019061412e565b6040840152509095945050505050565b634e487b7160e01b5f52603260045260245ffd5b634e487b7160e01b5f52601160045260245ffd5b8181038181111561053657610536614176565b8051801515811461196d575f5ffd5b5f5f604083850312156141bd575f5ffd5b825191506141cd6020840161419d565b90509250929050565b8082018082111561053657610536614176565b6001600160a01b038581168252841660208201526080604082018190525f9061421490830185613955565b82810360608401526142268185613998565b979650505050505050565b5f60208284031215614241575f5ffd5b81516001600160401b03811115614256575f5ffd5b612d2184828501613fe5565b5f60208284031215614272575f5ffd5b6111638261419d565b808202811582820484141761053657610536614176565b5f826142ac57634e487b7160e01b5f52601260045260245ffd5b500490565b8681526001600160a01b038616602082015260c0604082018190525f906142da90830187613955565b82810360608401526142ec8187613998565b6080840195909552505060a00152949350505050565b5f5f60408385031215614313575f5ffd5b82516001600160401b03811115614328575f5ffd5b61433485828601613f81565b92505060208301516001600160401b0381111561434f575f5ffd5b613d9785828601613fe5565b5f6020828403121561436b575f5ffd5b815160ff81168114611163575f5ffd5b6001815b60018411156143b65780850481111561439a5761439a614176565b60018416156143a857908102905b60019390931c92800261437f565b935093915050565b5f826143cc57506001610536565b816143d857505f610536565b81600181146143ee57600281146143f857614414565b6001915050610536565b60ff84111561440957614409614176565b50506001821b610536565b5060208310610133831016604e8410600b8410161715614437575081810a610536565b6144435f19848461437b565b805f190482111561445657614456614176565b029392505050565b5f61116360ff8416836143be565b66029bab838363c960cd1b81525f6144876007830186613f30565b630103a37960e51b815261374e6144a16004830187613f30565b85613f30565b600181811c908216806144bb57607f821691505b6020821081036144d957634e487b7160e01b5f52602260045260245ffd5b50919050565b601f82111561114657805f5260205f20601f840160051c810160208510156145045750805b601f840160051c820191505b81811015614523575f8155600101614510565b5050505050565b81516001600160401b0381111561454357614543613a49565b6145578161455184546144a7565b846144df565b6020601f821160018114614589575f83156145725750848201515b5f19600385901b1c1916600184901b178455614523565b5f84815260208120601f198516915b828110156145b85787850151825560209485019460019092019101614598565b50848210156145d557868401515f19600387901b60f8161c191681555b50505050600190811b01905550565b5f6111638284613f30565b5f816145fd576145fd614176565b505f19019056fe521f61dff1434739ba1cce3408ca24814df0ac37d5c1f8d308e97ca6d9831800a264697066735822122066b61bff74d01bbc836c733e1110c83a70e194960fbf1a104a897a9adcf2b19664736f6c634300081c0033
Deployed Bytecode
0x608060405234801561000f575f5ffd5b5060043610610255575f3560e01c806371a9730511610140578063b600585a116100bf578063f1faf05011610084578063f1faf050146104d2578063f815c4ff146104da578063f985b0bc146104e2578063fbfa77cf146104f5578063fdff667c146104fd578063ffa1ad741461043c575f5ffd5b8063b600585a14610486578063b6c8cdef1461041d578063b9f5be4114610499578063bd5a7468146104ac578063ead0bc47146104bf575f5ffd5b80638c3aefa7116101055780638c3aefa714610434578063936725ec1461043c5780639736374e1461041d57806399f428cf14610460578063a2b7722c14610473575f5ffd5b806371a97305146104005780637284e4161461041557806374bac4291461041d57806383ecf6531461042457806389816e301461042c575f5ffd5b80634875c968116101d757806359498ab71161019c57806359498ab71461039b5780635b0f088a146103a357806367cf905a146103c757806367fde573146103cf5780636d989439146103d75780636f307dc3146103f8575f5ffd5b80634875c9681461030d57806348d7d9eb1461033d5780634bde38c8146103535780634fa5d8541461037357806350f4e4191461037b575f5ffd5b80632d433b281161021d5780632d433b28146102bd5780632ddbd13a146102e057806341760fe6146102e857806341affeb8146102f05780634593144c14610305575f5ffd5b806301ffc9a71461025957806313e63180146102815780631639ba9814610297578063190024e01461029f5780631ec71e05146102a7575b5f5ffd5b61026c610267366004613854565b610512565b60405190151581526020015b60405180910390f35b61028961053c565b604051908152602001610278565b61028961054e565b610289610560565b6102af610601565b6040516102789291906138a9565b6102d06102cb3660046138e0565b6106b7565b60405161027894939291906139c8565b610289610910565b6102896109a3565b6103036102fe366004613bb3565b6109b5565b005b610289610c93565b60408051808201909152600b81526a21b7b6b837bab732102b1960a91b60208201525b6040516102789190613ca0565b610345610cc6565b604051610278929190613cb2565b61035b610d02565b6040516001600160a01b039091168152602001610278565b610303610d31565b61038e610389366004613cd6565b61114b565b6040516102789190613d2c565b61034561116a565b61033060405180604001604052806005815260200164322e352e3160d81b81525081565b61038e6111fc565b610303611248565b6103ea6103e5366004613d3e565b611272565b604051610278929190613da1565b61035b611377565b610408611392565b6040516102789190613dc2565b6103306113fb565b600161026c565b61038e611420565b61028961142b565b61038e6116e5565b61033060405180604001604052806005815260200164312e302e3160d81b81525081565b61030361046e366004613dd4565b611922565b610289610481366004613e02565b611938565b6103ea610494366004613d3e565b611972565b61038e6104a7366004613e33565b611a64565b6103036104ba366004613e33565b611a77565b61038e6104cd366004613e33565b611a92565b610289611cbf565b610289611cd1565b61038e6104f0366004613e4a565b611ce3565b61035b611d8c565b610505611da4565b6040516102789190613e75565b5f6001600160e01b03198216630314af3360e01b1480610536575061053682611e16565b92915050565b5f610545611e4a565b60020154905090565b5f610557611e4a565b60090154905090565b6040805161d39560e81b60208201525f6023820181905282516006818403018152602683019384905263bfe370d960e01b909352917372a237cb9caaf0716bb4f717e32e79ce6460e5d39163bfe370d9916105bd91602a01613ca0565b602060405180830381865af41580156105d8573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906105fc9190613e87565b905090565b60605f5f61060d611e4a565b600601546001600160a01b031690505f61062682611e6e565b9050816001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015610663573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f1916820160405261068a9190810190613e9e565b8160405160200161069c929190613f47565b60405160208183030381529060405260019350935050509091565b6060806060805f856001600160a01b031663c45a01556040518163ffffffff1660e01b8152600401602060405180830381865afa1580156106fa573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061071e9190613f66565b6001600160a01b0316639ad87ce461075460408051808201909152600b81526a21b7b6b837bab732102b1960a91b602082015290565b805190602001206040518263ffffffff1660e01b815260040161077991815260200190565b5f60405180830381865afa158015610793573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526107ba9190810190614040565b805151909150806001600160401b038111156107d8576107d8613a49565b60405190808252806020026020018201604052801561080b57816020015b60608152602001906001900390816107f65790505b509550806001600160401b0381111561082657610826613a49565b60405190808252806020026020018201604052801561084f578160200160208202803683370190505b50604080515f80825260208201818152828401909352929750955093505b818110156109065761089a835f0151828151811061088d5761088d614162565b6020026020010151612194565b8782815181106108ac576108ac614162565b6020026020010181905250825f015181815181106108cc576108cc614162565b60200260200101518682815181106108e6576108e6614162565b6001600160a01b039092166020928302919091019091015260010161086d565b5050509193509193565b5f5f61091a611e4a565b6006015460405163e3d670d760e01b81526001600160a01b03909116600482018190529150735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015610979573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061099d9190613e87565b91505090565b5f6109ac611e4a565b600a0154905090565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff1615906001600160401b03165f811580156109f95750825b90505f826001600160401b03166001148015610a145750303b155b905081158015610a22575080155b15610a405760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff191660011785558315610a6a57845460ff60401b1916600160401b1785555b87516003141580610a7b5750865115155b80610a865750855115155b15610aa4576040516363cf6b6160e01b815260040160405180910390fd5b6040805160018082528183019092525f916020808301908036833701905050905088600281518110610ad857610ad8614162565b60200260200101516001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b1b573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b3f9190613f66565b815f81518110610b5157610b51614162565b60200260200101906001600160a01b031690816001600160a01b031681525050610bf0895f81518110610b8657610b86614162565b60200260200101516040518060400160405280600b81526020016a21b7b6b837bab732102b1960a91b8152508b600181518110610bc557610bc5614162565b6020026020010151848d600281518110610be157610be1614162565b60200260200101515f196122ea565b610c4289600281518110610c0657610c06614162565b60200260200101515f19835f81518110610c2257610c22614162565b60200260200101516001600160a01b031661238e9092919063ffffffff16565b508315610c8957845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b5f6105fc610cc260017f812a673dfca07956350df10f8a654925f561d7a0da09bdbe79e653939a14d9f161418a565b5490565b6060805f610cd2611e4a565b600601546001600160a01b031690505f610ceb82612451565b9050610cf781836124b2565b909590945092505050565b5f6105fc610cc260017faa116a42804728f23983458454b6eb9c6ddf3011db9f9addaf3cd7508d85b0d661418a565b610d396125a3565b610d416125d6565b5f610d4a611e4a565b805460408051637299470360e11b815281519394506001600160a01b03909216925f92849263e5328e06926004808401938290030181865afa158015610d92573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610db691906141ac565b5090508015611146575f610dc8610d02565b60088501549091505f808080610ddc612653565b93509350935093505f610ded600190565b610ec357610e0d858781518110610e0657610e06614162565b505f919050565b848781518110610e1f57610e1f614162565b60200260200101818151610e3391906141d6565b9052506040516308dc79a160e01b81525f90735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c906308dc79a190610e75908b908e908b908b906004016141e9565b5f60405180830381865af4158015610e8f573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052610eb69190810190614231565b50505060018901546110d1565b604051633596603f60e01b8152735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c90633596603f90610efa908790600401613d2c565b602060405180830381865af4158015610f15573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610f399190614262565b15610f9e576040516336ac731760e11b81526001600160a01b038a1690636d58e62e90610f6c9088908890600401613cb2565b5f604051808303815f87803b158015610f83575f5ffd5b505af1158015610f95573d5f5f3e3d5ffd5b505050506110ba565b5f610fa761116a565b9150505f86516001600160401b03811115610fc457610fc4613a49565b604051908082528060200260200182016040528015610fed578160200160208202803683370190505b509050600f6301e133808d6002015442611007919061418a565b845f8151811061101957611019614162565b602002602001015161102b919061427b565b6110359190614292565b61103f9190614292565b815f8151811061105157611051614162565b60209081029190910101526040516336ac731760e11b81526001600160a01b038c1690636d58e62e9061108a908a908590600401613cb2565b5f604051808303815f87803b1580156110a1575f5ffd5b505af11580156110b3573d5f5f3e3d5ffd5b5050505050505b6110cf855f81518110610e0657610e06614162565b505b60405163640f244560e01b8152735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063640f244590611112908d908b908a908a908f9089906004016142b1565b5f6040518083038186803b158015611128575f5ffd5b505af415801561113a573d5f5f3e3d5ffd5b50505050505050505050505b505050565b60606111556125a3565b61116084848461275e565b90505b9392505050565b6060806111756129ff565b604051633f8b51a560e21b81529193509150735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063fe2d4694906111b39085908590600401613cb2565b5f60405180830381865af41580156111cd573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526111f49190810190614302565b915091509091565b60408051600180825281830190925260609160208083019080368337019050509050670de0b6b3a7640000815f8151811061123957611239614162565b60200260200101818152505090565b611250612b95565b61126161125b610910565b30612caf565b50600161126c611e4a565b600a0155565b60605f835160011480156112be5750611289611e4a565b6006015484516001600160a01b039091169085905f906112ab576112ab614162565b60200260200101516001600160a01b0316145b80156112f557505f6001600160a01b0316845f815181106112e1576112e1614162565b60200260200101516001600160a01b031614155b1561136157825160011461131c57604051630ef9926760e21b815260040160405180910390fd5b825f8151811061132e5761132e614162565b6020026020010151905061135a835f8151811061134d5761134d614162565b6020026020010151612d29565b9150611370565b61136b8484612d34565b915091505b9250929050565b5f611380611e4a565b600601546001600160a01b0316919050565b606061139c611e4a565b6005018054806020026020016040519081016040528092919081815260200182805480156113f157602002820191905f5260205f20905b81546001600160a01b031681526001909101906020018083116113d3575b5050505050905090565b60605f611406611e4a565b600681015490915061099d906001600160a01b0316612194565b60606105fc5f611a92565b5f5f611435611e4a565b6006015f9054906101000a90046001600160a01b031690505f816001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa15801561148a573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906114ae9190613f66565b90505f6114b9610d02565b6001600160a01b03166349b5fdb46040518163ffffffff1660e01b8152600401602060405180830381865afa1580156114f4573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906115189190613f66565b6040516341976e0960e01b81526001600160a01b0384811660048301529192505f918316906341976e09906024016040805180830381865afa158015611560573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061158491906141ac565b5090505f846001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156115c4573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906115e89190613e87565b90505f856001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa158015611627573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061164b9190613e87565b90505f6116588383612d41565b9050856001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611696573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906116ba919061435b565b6116c590600a61445e565b6116cf858361427b565b6116d99190614292565b97505050505050505090565b60605f6116f0611e4a565b6006015f9054906101000a90046001600160a01b031690505f816001600160a01b0316635fe3b5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611745573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117699190613f66565b6040516302c3bcbb60e01b81526001600160a01b03848116600483015291909116906302c3bcbb90602401602060405180830381865afa1580156117af573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117d39190613e87565b90505f19811461191d575f826001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561181a573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061183e9190613e87565b90505f6118aa82856001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa158015611881573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118a59190613e87565b612d41565b604080516001808252818301909252919250602080830190803683370190505094508083116118d9575f6118fc565b6103e86118e6828561418a565b6118f2906103e761427b565b6118fc9190614292565b855f8151811061190e5761190e614162565b60200260200101818152505050505b505090565b61192a6125a3565b6119348282612d5f565b5050565b5f6119416125a3565b5f61194a611e4a565b905080600201545f0361195e574260028201555b611969836001612d84565b9150505b919050565b60605f835160011480156119be5750611989611e4a565b6006015484516001600160a01b039091169085905f906119ab576119ab614162565b60200260200101516001600160a01b0316145b80156119f557505f6001600160a01b0316845f815181106119e1576119e1614162565b60200260200101516001600160a01b031614155b15611a5a578251600114611a1c57604051630ef9926760e21b815260040160405180910390fd5b825f81518110611a2e57611a2e614162565b6020026020010151905061135a835f81518110611a4d57611a4d614162565b6020026020010151612f9c565b61136b848461303a565b6060611a6e6125a3565b61053682613046565b611a7f613096565b5f611a88611e4a565b6009019190915550565b60605f611a9d611e4a565b6006015f9054906101000a90046001600160a01b031690505f816001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa158015611af2573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611b169190613f66565b6040516370a0823160e01b81526001600160a01b0384811660048301529192505f918316906370a0823190602401602060405180830381865afa158015611b5f573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611b839190613e87565b6040516370a0823160e01b81523060048201529091505f906001600160a01b038516906370a0823190602401602060405180830381865afa158015611bca573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611bee9190613e87565b90505f846001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa158015611c2d573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611c519190613e87565b90505f611c5e8383612d41565b604080516001808252818301909252919250602080830190803683370190505096508715611c8c5780611c96565b611c968185613123565b875f81518110611ca857611ca8614162565b602002602001018181525050505050505050919050565b5f611cc8611e4a565b60040154905090565b5f611cda611e4a565b60030154905090565b6060611ced6125a3565b735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c6325567aef611d0f611e4a565b6040516001600160e01b031960e084901b168152600481019190915260248101879052604481018690526001600160a01b03851660648201526084015f60405180830381865af4158015611d65573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526111609190810190614231565b5f611d95611e4a565b546001600160a01b0316919050565b604080516001808252818301909252606091816020015b6060815260200190600190039081611dbb5790505090506040518060400160405280600b81526020016a436f6d706f756e64696e6760a81b815250815f81518110611e0857611e08614162565b602002602001018190525090565b5f6001600160e01b03198216630f1ec81f60e41b148061053657506301ffc9a760e01b6001600160e01b0319831614610536565b7fb14b643f49bed6a2c6693bbd50f68dc950245db265c66acadbfa51ccc8c3ba0090565b60605f611e7a83613138565b60408051600c8082528183019092529192505f9190602082018180368337019050509050600360fc1b815f81518110611eb557611eb5614162565b60200101906001600160f81b03191690815f1a905350600f60fb1b81600181518110611ee357611ee3614162565b60200101906001600160f81b03191690815f1a90535081600281518110611f0c57611f0c614162565b602001015160f81c60f81b81600281518110611f2a57611f2a614162565b60200101906001600160f81b03191690815f1a90535081600381518110611f5357611f53614162565b602001015160f81c60f81b81600381518110611f7157611f71614162565b60200101906001600160f81b03191690815f1a90535081600481518110611f9a57611f9a614162565b602001015160f81c60f81b81600481518110611fb857611fb8614162565b60200101906001600160f81b03191690815f1a90535081600581518110611fe157611fe1614162565b602001015160f81c60f81b81600581518110611fff57611fff614162565b60200101906001600160f81b03191690815f1a905350601760f91b8160068151811061202d5761202d614162565b60200101906001600160f81b03191690815f1a905350601760f91b8160078151811061205b5761205b614162565b60200101906001600160f81b03191690815f1a9053508160268151811061208457612084614162565b602001015160f81c60f81b816008815181106120a2576120a2614162565b60200101906001600160f81b03191690815f1a905350816027815181106120cb576120cb614162565b602001015160f81c60f81b816009815181106120e9576120e9614162565b60200101906001600160f81b03191690815f1a9053508160288151811061211257612112614162565b602001015160f81c60f81b81600a8151811061213057612130614162565b60200101906001600160f81b03191690815f1a9053508160298151811061215957612159614162565b602001015160f81c60f81b81600b8151811061217757612177614162565b60200101906001600160f81b03191690815f1a9053509392505050565b6060816001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa1580156121d2573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906121f69190613f66565b6001600160a01b03166395d89b416040518163ffffffff1660e01b81526004015f60405180830381865afa158015612230573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526122579190810190613e9e565b826001600160a01b03166306fdde036040518163ffffffff1660e01b81526004015f60405180830381865afa158015612292573d5f5f3e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526122b99190810190613e9e565b6122c284611e6e565b6040516020016122d49392919061446c565b6040516020818303038152906040529050919050565b6122f261314e565b6122fb86613197565b5f612304611e4a565b600881018390556006810180546001600160a01b0319166001600160a01b03861617905584519091508690869086908690869060078701905f908890829061235590600584019060208a01906137dd565b5081546001600160a01b03808a166101009390930a928302920219161790555061237f868261452a565b50505050505050505050505050565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663095ea7b360e01b1790526123df84826132f4565b61244b576040516001600160a01b0384811660248301525f604483015261244191869182169063095ea7b3906064015b604051602081830303815290604052915060e01b6020820180516001600160e01b038381831617835250505050613395565b61244b8482613395565b50505050565b5f816001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa15801561248e573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906105369190613e87565b6060805f5160206146055f395f51905f526124cb611392565b60408051600180825281830190925291945060208083019080368337505082549193505080861180156124fd57508015155b1561259a576040516370a0823160e01b81523060048201525f906001600160a01b038716906370a0823190602401602060405180830381865afa158015612546573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061256a9190613e87565b905061257a816118a5848a61418a565b845f8151811061258c5761258c614162565b602002602001018181525050505b50509250929050565b6125ab611e4a565b546001600160a01b031633146125d4576040516362df054560e01b815260040160405180910390fd5b565b306001600160a01b03166374bac4296040518163ffffffff1660e01b8152600401602060405180830381865afa158015612612573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906126369190614262565b6125d4576040516309ea311f60e11b815260040160405180910390fd5b60608080805f5160206146055f395f51905f525f61266f611e4a565b90505f816006015f9054906101000a90046001600160a01b031690505f816001600160a01b031663a6afed956040518163ffffffff1660e01b81526004016020604051808303815f875af11580156126c9573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906126ed9190613e87565b905080801561271b57604051633f8e520960e11b815260040161271291815260200190565b60405180910390fd5b505f61272683612451565b905061273281846124b2565b91909555604080515f80825260208201908152818301909252959a919950949750939550929350505050565b604080516001808252818301909252606091602080830190803683370190505090505f612789611e4a565b90505f816006015f9054906101000a90046001600160a01b031690505f816001600160a01b0316636f307dc36040518163ffffffff1660e01b8152600401602060405180830381865afa1580156127e2573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906128069190613f66565b60405163e3d670d760e01b81526001600160a01b03821660048201529091505f90735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612861573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906128859190613e87565b60405163db006a7560e01b8152600481018990529091505f906001600160a01b0385169063db006a75906024016020604051808303815f875af11580156128ce573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906128f29190613e87565b9050808015612917576040516305ee2ff160e11b815260040161271291815260200190565b5060405163e3d670d760e01b81526001600160a01b03841660048201528290735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612970573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906129949190613e87565b61299e919061418a565b865f815181106129b0576129b0614162565b6020026020010181815250506129f387875f815181106129d2576129d2614162565b6020026020010151856001600160a01b03166133f69092919063ffffffff16565b50505050509392505050565b6060805f612a0b611e4a565b60058101805460408051602080840282018101909252828152939450830182828015612a5e57602002820191905f5260205f20905b81546001600160a01b03168152600190910190602001808311612a40575b5093965060019350612a6f92505050565b604051908082528060200260200182016040528015612a98578160200160208202803683370190505b50600682015460405163e3d670d760e01b81526001600160a01b039091166004820152909250612b7290735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612afc573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612b209190613e87565b826006015f9054906101000a90046001600160a01b03166001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa158015611881573d5f5f3e3d5ffd5b825f81518110612b8457612b84614162565b602002602001018181525050509091565b5f612b9e610d02565b9050336001600160a01b0316816001600160a01b0316635aa6e6756040518163ffffffff1660e01b8152600401602060405180830381865afa158015612be6573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612c0a9190613f66565b6001600160a01b03161480612c8f5750336001600160a01b0316816001600160a01b0316634783c35b6040518163ffffffff1660e01b8152600401602060405180830381865afa158015612c60573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612c849190613f66565b6001600160a01b0316145b612cac576040516354299b6f60e01b815260040160405180910390fd5b50565b60605f612cba611e4a565b9050612d2181600501805480602002602001604051908101604052809291908181526020018280548015612d1557602002820191905f5260205f20905b81546001600160a01b03168152600190910190602001808311612cf7575b5050505050858561275e565b949350505050565b606061053682612f9c565b60605f61136b848461303a565b5f670de0b6b3a7640000612d55838561427b565b6111639190614292565b5f612d68611e4a565b6006810154909150611146906001600160a01b031683856133f6565b5f5f5160206146055f395f51905f5281612d9c611e4a565b600681015460405163e3d670d760e01b81526001600160a01b03909116600482018190529192505f90735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612dff573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612e239190613e87565b9050865f81518110612e3757612e37614162565b60200260200101515f14612f92575f826001600160a01b031663a0712d68895f81518110612e6757612e67614162565b60200260200101516040518263ffffffff1660e01b8152600401612e8d91815260200190565b6020604051808303815f875af1158015612ea9573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612ecd9190613e87565b9050808015612ef257604051638c32d69360e01b815260040161271291815260200190565b5060405163e3d670d760e01b81526001600160a01b03841660048201528290735404dd7dc0dfc2bb746dc8320caf6f07c16ba21c9063e3d670d790602401602060405180830381865af4158015612f4b573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612f6f9190613e87565b612f79919061418a565b85549096505f03612f9057612f8d83612451565b85555b505b5050505092915050565b60605f612fa7611e4a565b6040805160018082528183019092529192506020808301908036833750505060068201546040805163182df0f560e01b815290519294506130169286926001600160a01b03169163182df0f59160048083019260209291908290030181865afa158015611881573d5f5f3e3d5ffd5b825f8151811061302857613028614162565b60200260200101818152505050919050565b60605f61136b83613427565b60605f5160206146055f395f51905f525f61305f611e4a565b905061306a84612f9c565b82549093505f0361308f57600681015461308c906001600160a01b0316612451565b82555b5050919050565b61309e610d02565b6040516336b87bd760e11b81523360048201526001600160a01b039190911690636d70f7ae90602401602060405180830381865afa1580156130e2573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906131069190614262565b6125d457604051631f0853c160e21b815260040160405180910390fd5b5f8183106131315781611163565b5090919050565b60606105366001600160a01b038316601461352d565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff166125d457604051631afcd79f60e31b815260040160405180910390fd5b61319f61314e565b6001600160a01b0381161580159061322857505f6001600160a01b0316816001600160a01b0316634783c35b6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156131f8573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061321c9190613f66565b6001600160a01b031614155b613245576040516371c42ac360e01b815260040160405180910390fd5b61327861327360017faa116a42804728f23983458454b6eb9c6ddf3011db9f9addaf3cd7508d85b0d661418a565b829055565b6132aa436132a760017f812a673dfca07956350df10f8a654925f561d7a0da09bdbe79e653939a14d9f161418a565b55565b604080516001600160a01b0383168152426020820152438183015290517f1a2dd071001ebf6e03174e3df5b305795a4ad5d41d8fdb9ba41dbbe2367134269181900360600190a150565b5f5f5f846001600160a01b03168460405161330f91906145e4565b5f604051808303815f865af19150503d805f8114613348576040519150601f19603f3d011682016040523d82523d5f602084013e61334d565b606091505b50915091508180156133775750805115806133775750808060200190518101906133779190614262565b801561338c57505f856001600160a01b03163b115b95945050505050565b5f6133a96001600160a01b0384168361369e565b905080515f141580156133cd5750808060200190518101906133cb9190614262565b155b1561114657604051635274afe760e01b81526001600160a01b0384166004820152602401612712565b6040516001600160a01b0383811660248301526044820183905261114691859182169063a9059cbb9060640161240f565b60605f5f613433611e4a565b60408051600180825281830190925291925060208083019080368337019050509250835f8151811061346757613467614162565b6020026020010151835f8151811061348157613481614162565b602002602001018181525050613525845f815181106134a2576134a2614162565b6020026020010151826006015f9054906101000a90046001600160a01b03166001600160a01b031663182df0f56040518163ffffffff1660e01b8152600401602060405180830381865afa1580156134fc573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906135209190613e87565b6136ab565b915050915091565b6060825f61353c84600261427b565b6135479060026141d6565b6001600160401b0381111561355e5761355e613a49565b6040519080825280601f01601f191660200182016040528015613588576020820181803683370190505b509050600360fc1b815f815181106135a2576135a2614162565b60200101906001600160f81b03191690815f1a905350600f60fb1b816001815181106135d0576135d0614162565b60200101906001600160f81b03191690815f1a9053505f6135f285600261427b565b6135fd9060016141d6565b90505b6001811115613674576f181899199a1a9b1b9c1cb0b131b232b360811b83600f166010811061363157613631614162565b1a60f81b82828151811061364757613647614162565b60200101906001600160f81b03191690815f1a90535060049290921c9161366d816145ef565b9050613600565b508115612d215760405163e22e27eb60e01b81526004810186905260248101859052604401612712565b606061116383835f6136bf565b5f81612d5584670de0b6b3a764000061427b565b6060814710156136e45760405163cd78605960e01b8152306004820152602401612712565b5f5f856001600160a01b031684866040516136ff91906145e4565b5f6040518083038185875af1925050503d805f8114613739576040519150601f19603f3d011682016040523d82523d5f602084013e61373e565b606091505b509150915061374e868383613758565b9695505050505050565b60608261376d57613768826137b4565b611163565b815115801561378457506001600160a01b0384163b155b156137ad57604051639996b31560e01b81526001600160a01b0385166004820152602401612712565b5080611163565b8051156137c45780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b828054828255905f5260205f20908101928215613830579160200282015b8281111561383057825182546001600160a01b0319166001600160a01b039091161782556020909201916001909101906137fb565b5061383c929150613840565b5090565b5b8082111561383c575f8155600101613841565b5f60208284031215613864575f5ffd5b81356001600160e01b031981168114611163575f5ffd5b5f81518084528060208401602086015e5f602082860101526020601f19601f83011685010191505092915050565b604081525f6138bb604083018561387b565b905082151560208301529392505050565b6001600160a01b0381168114612cac575f5ffd5b5f602082840312156138f0575f5ffd5b8135611163816138cc565b5f82825180855260208501945060208160051b830101602085015f5b8381101561394957601f1985840301885261393383835161387b565b6020988901989093509190910190600101613917565b50909695505050505050565b5f8151808452602084019350602083015f5b8281101561398e5781516001600160a01b0316865260209586019590910190600101613967565b5093949350505050565b5f8151808452602084019350602083015f5b8281101561398e5781518652602095860195909101906001016139aa565b608081525f6139da60808301876138fb565b82810360208401526139ec8187613955565b90508281036040840152613a008186613998565b8381036060850152845180825260208087019350909101905f5b81811015613a3b57835160020b835260209384019390920191600101613a1a565b509098975050505050505050565b634e487b7160e01b5f52604160045260245ffd5b604051606081016001600160401b0381118282101715613a7f57613a7f613a49565b60405290565b604051601f8201601f191681016001600160401b0381118282101715613aad57613aad613a49565b604052919050565b5f6001600160401b03821115613acd57613acd613a49565b5060051b60200190565b5f82601f830112613ae6575f5ffd5b8135613af9613af482613ab5565b613a85565b8082825260208201915060208360051b860101925085831115613b1a575f5ffd5b602085015b83811015613b40578035613b32816138cc565b835260209283019201613b1f565b5095945050505050565b5f82601f830112613b59575f5ffd5b8135613b67613af482613ab5565b8082825260208201915060208360051b860101925085831115613b88575f5ffd5b602085015b83811015613b40578035835260209283019201613b8d565b8060020b8114612cac575f5ffd5b5f5f5f60608486031215613bc5575f5ffd5b83356001600160401b03811115613bda575f5ffd5b613be686828701613ad7565b93505060208401356001600160401b03811115613c01575f5ffd5b613c0d86828701613b4a565b92505060408401356001600160401b03811115613c28575f5ffd5b8401601f81018613613c38575f5ffd5b8035613c46613af482613ab5565b8082825260208201915060208360051b850101925088831115613c67575f5ffd5b6020840193505b82841015613c92578335613c8181613ba5565b825260209384019390910190613c6e565b809450505050509250925092565b602081525f611163602083018461387b565b604081525f613cc46040830185613955565b828103602084015261338c8185613998565b5f5f5f60608486031215613ce8575f5ffd5b83356001600160401b03811115613cfd575f5ffd5b613d0986828701613ad7565b935050602084013591506040840135613d21816138cc565b809150509250925092565b602081525f6111636020830184613998565b5f5f60408385031215613d4f575f5ffd5b82356001600160401b03811115613d64575f5ffd5b613d7085828601613ad7565b92505060208301356001600160401b03811115613d8b575f5ffd5b613d9785828601613b4a565b9150509250929050565b604081525f613db36040830185613998565b90508260208301529392505050565b602081525f6111636020830184613955565b5f5f60408385031215613de5575f5ffd5b823591506020830135613df7816138cc565b809150509250929050565b5f60208284031215613e12575f5ffd5b81356001600160401b03811115613e27575f5ffd5b612d2184828501613b4a565b5f60208284031215613e43575f5ffd5b5035919050565b5f5f5f60608486031215613e5c575f5ffd5b83359250602084013591506040840135613d21816138cc565b602081525f61116360208301846138fb565b5f60208284031215613e97575f5ffd5b5051919050565b5f60208284031215613eae575f5ffd5b81516001600160401b03811115613ec3575f5ffd5b8201601f81018413613ed3575f5ffd5b80516001600160401b03811115613eec57613eec613a49565b613eff601f8201601f1916602001613a85565b818152856020838501011115613f13575f5ffd5b8160208401602083015e5f91810160200191909152949350505050565b5f81518060208401855e5f93019283525090919050565b5f613f528285613f30565b600160fd1b815261338c6001820185613f30565b5f60208284031215613f76575f5ffd5b8151611163816138cc565b5f82601f830112613f90575f5ffd5b8151613f9e613af482613ab5565b8082825260208201915060208360051b860101925085831115613fbf575f5ffd5b602085015b83811015613b40578051613fd7816138cc565b835260209283019201613fc4565b5f82601f830112613ff4575f5ffd5b8151614002613af482613ab5565b8082825260208201915060208360051b860101925085831115614023575f5ffd5b602085015b83811015613b40578051835260209283019201614028565b5f60208284031215614050575f5ffd5b81516001600160401b03811115614065575f5ffd5b820160608185031215614076575f5ffd5b61407e613a5d565b81516001600160401b03811115614093575f5ffd5b61409f86828501613f81565b82525060208201516001600160401b038111156140ba575f5ffd5b6140c686828501613fe5565b60208301525060408201516001600160401b038111156140e4575f5ffd5b80830192505084601f8301126140f8575f5ffd5b8151614106613af482613ab5565b8082825260208201915060208360051b860101925087831115614127575f5ffd5b6020850194505b8285101561415257845161414181613ba5565b82526020948501949091019061412e565b6040840152509095945050505050565b634e487b7160e01b5f52603260045260245ffd5b634e487b7160e01b5f52601160045260245ffd5b8181038181111561053657610536614176565b8051801515811461196d575f5ffd5b5f5f604083850312156141bd575f5ffd5b825191506141cd6020840161419d565b90509250929050565b8082018082111561053657610536614176565b6001600160a01b038581168252841660208201526080604082018190525f9061421490830185613955565b82810360608401526142268185613998565b979650505050505050565b5f60208284031215614241575f5ffd5b81516001600160401b03811115614256575f5ffd5b612d2184828501613fe5565b5f60208284031215614272575f5ffd5b6111638261419d565b808202811582820484141761053657610536614176565b5f826142ac57634e487b7160e01b5f52601260045260245ffd5b500490565b8681526001600160a01b038616602082015260c0604082018190525f906142da90830187613955565b82810360608401526142ec8187613998565b6080840195909552505060a00152949350505050565b5f5f60408385031215614313575f5ffd5b82516001600160401b03811115614328575f5ffd5b61433485828601613f81565b92505060208301516001600160401b0381111561434f575f5ffd5b613d9785828601613fe5565b5f6020828403121561436b575f5ffd5b815160ff81168114611163575f5ffd5b6001815b60018411156143b65780850481111561439a5761439a614176565b60018416156143a857908102905b60019390931c92800261437f565b935093915050565b5f826143cc57506001610536565b816143d857505f610536565b81600181146143ee57600281146143f857614414565b6001915050610536565b60ff84111561440957614409614176565b50506001821b610536565b5060208310610133831016604e8410600b8410161715614437575081810a610536565b6144435f19848461437b565b805f190482111561445657614456614176565b029392505050565b5f61116360ff8416836143be565b66029bab838363c960cd1b81525f6144876007830186613f30565b630103a37960e51b815261374e6144a16004830187613f30565b85613f30565b600181811c908216806144bb57607f821691505b6020821081036144d957634e487b7160e01b5f52602260045260245ffd5b50919050565b601f82111561114657805f5260205f20601f840160051c810160208510156145045750805b601f840160051c820191505b81811015614523575f8155600101614510565b5050505050565b81516001600160401b0381111561454357614543613a49565b6145578161455184546144a7565b846144df565b6020601f821160018114614589575f83156145725750848201515b5f19600385901b1c1916600184901b178455614523565b5f84815260208120601f198516915b828110156145b85787850151825560209485019460019092019101614598565b50848210156145d557868401515f19600387901b60f8161c191681555b50505050600190811b01905550565b5f6111638284613f30565b5f816145fd576145fd614176565b505f19019056fe521f61dff1434739ba1cce3408ca24814df0ac37d5c1f8d308e97ca6d9831800a264697066735822122066b61bff74d01bbc836c733e1110c83a70e194960fbf1a104a897a9adcf2b19664736f6c634300081c0033
Loading...
Loading
Loading...
Loading
Loading...
Loading
0x8D19C8C72E7e3EDe130F1e0f299ee94116F7330E
Net Worth in USD
$0.00
Net Worth in S
0
Multichain Portfolio | 35 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
Loading...
Loading
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.