Source Code
Overview
ETH Balance
0 ETH
ETH Value
$0.00View more zero value Internal Transactions in Advanced View mode
Advanced mode:
Cross-Chain Transactions
Loading...
Loading
This contract contains unverified libraries: FeesHelper, MultiStrategyVaultHelper, RewardsHelper, StrategyHelper, VaultActionsHelper, WithdrawalQueueHelper, FeesHelper, MultiStrategyVaultHelper, RewardsHelper, StrategyHelper, VaultActionsHelper, WithdrawalQueueHelper, FeesHelper, MultiStrategyVaultHelper, RewardsHelper, StrategyHelper, VaultActionsHelper, WithdrawalQueueHelper
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Source Code Verified (Exact Match)
Contract Name:
ConcreteMultiStrategyVault
Compiler Version
v0.8.24+commit.e11b9ed9
Optimization Enabled:
Yes with 200 runs
Other Settings:
cancun EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
//SPDX-License-Identifier: AGPL-3.0
pragma solidity 0.8.24;
import {
ERC4626Upgradeable,
IERC20,
IERC20Metadata,
ERC20Upgradeable
} from "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/ERC4626Upgradeable.sol";
import {ReentrancyGuardUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/ReentrancyGuardUpgradeable.sol";
import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {PausableUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/PausableUpgradeable.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {
VaultFees, Strategy, IConcreteMultiStrategyVault, Allocation
} from "../interfaces/IConcreteMultiStrategyVault.sol";
import {Errors} from "../interfaces/Errors.sol";
import {IStrategy, ReturnedRewards} from "../interfaces/IStrategy.sol";
import {IWithdrawalQueue} from "../interfaces/IWithdrawalQueue.sol";
import {IParkingLot} from "../interfaces/IParkingLot.sol";
import {MultiStrategyVaultHelper} from "../libraries/MultiStrategyVaultHelper.sol";
import {MAX_BASIS_POINTS, PRECISION, DUST, SECONDS_PER_YEAR} from "../utils/Constants.sol";
import {WithdrawalQueueHelper} from "../libraries/WithdrawalQueueHelper.sol";
import {VaultActionsHelper} from "../libraries/VaultActions.sol";
import {RewardsHelper} from "../libraries/RewardsHelper.sol";
import {StrategyHelper} from "../libraries/StrategyHelper.sol";
import {FeesHelper} from "../libraries/FeesHelper.sol";
import {TokenHelper} from "@blueprint-finance/hub-and-spokes-libraries/src/libraries/TokenHelper.sol";
/**
* @title ConcreteMultiStrategyVault
* @author Concrete
* @notice An ERC4626 compliant vault that manages multiple yield generating strategies
* @dev This vault:
* - Implements ERC4626 standard for tokenized vaults
* - Manages multiple yield strategies simultaneously
* - Handles fee collection and distribution
* - Supports emergency pausing
* - Provides withdrawal queueing mechanism
*/
contract ConcreteMultiStrategyVault is
ERC4626Upgradeable,
Errors,
ReentrancyGuardUpgradeable,
PausableUpgradeable,
OwnableUpgradeable,
IConcreteMultiStrategyVault
{
using SafeERC20 for IERC20;
using Math for uint256;
uint256 public firstDeposit = 0;
/// @dev Public variable storing the address of the protectStrategy contract.
address public protectStrategy;
/// @dev Internal variable to store the number of decimals the vault's shares will have.
uint8 private _decimals;
/// @notice The offset applied to decimals to prevent inflation attacks.
/// @dev Public constant representing the offset applied to the vault's share decimals.
uint8 public constant decimalOffset = 9;
/// @notice The highest value of share price recorded, used for performance fee calculation.
/// @dev Public variable to store the high water mark for performance fee calculation.
uint256 public highWaterMark;
/// @notice The maximum amount of assets that can be deposited into the vault.
/// @dev Public variable to store the deposit limit of the vault.
uint256 public depositLimit;
/// @notice The timestamp at which the fees were last updated.
/// @dev Public variable to store the last update time of the fees.
uint256 public feesUpdatedAt;
/// @notice The recipient address for any fees collected by the vault.
/// @dev Public variable to store the address of the fee recipient.
address public feeRecipient;
/// @notice Indicates if the vault is in idle mode, where deposits are not passed to strategies.
/// @dev Public boolean indicating if the vault is idle.
bool public vaultIdle;
/// @notice Indicates if the vault withdrawals are paused
/// @dev Public boolean indicating if the vault withdrawals are paused
bool public withdrawalsPaused;
/// @notice The array of strategies that the vault can interact with.
/// @dev Public array storing the strategies associated with the vault.
Strategy[] internal strategies;
/// @notice The fee structure of the vault.
/// @dev Public variable storing the fees associated with the vault.
VaultFees private fees;
/// @notice The withdrawal queue associated with the vault.
/// @dev Public variable storing the withdrawal queue contract address associated with the vault.
IWithdrawalQueue public withdrawalQueue;
/// @notice The parking lot associated with the vault.
/// @dev Public variable storing the parking lot contract address associated with the vault.
IParkingLot public parkingLot;
/// @notice The minimum queue request associated with the vault.
/// @dev Public variable storing the minimum queue request associated with the vault.
uint256 public minQueueRequest;
//Rewards Management
/// @notice array to store all reward addresses
address[] private rewardAddresses;
/// @notice mapping to get the index of each reward address
mapping(address => uint256) public rewardIndex;
/// @notice mapping to store the reward index for each user and reward address
mapping(address => mapping(address => uint256)) public userRewardIndex;
/// @notice mapping to store the total rewards claimed by user for each reward address
mapping(address => mapping(address => uint256)) public totalRewardsClaimed;
/// @notice is withdrawal queue mandatory for withdrawals & redemptions.
bool public isQueueMandatory;
/// @notice Mapping to track whitelisted addresses
/// @dev Public mapping storing whether an address is whitelisted
mapping(address => bool) public whitelisted;
/// @notice Indicates if the whitelist is enabled
/// @dev Public boolean indicating if whitelist checks are active
bool public whitelistEnabled;
/// @notice storage gap for future upgrades
uint256[50] private __gap;
/// @notice event for vault initialization
event Initialized(address indexed vaultName, address indexed underlyingAsset);
/// @notice event for requested funds
event RequestedFunds(address indexed protectStrategy, uint256 amount);
/// @notice event for rewards harvested
event RewardsHarvested();
/// @notice event for minimum queue request updated
event MinimunQueueRequestUpdated(uint256 _oldMinQueueRequest, uint256 _newMinQueueRequest);
/// @notice event for address added to whitelist
event UserAddedToWhitelist(address indexed user);
/// @notice event for address removed from whitelist
event UserRemovedFromWhitelist(address indexed user);
/// @notice event for whitelist enabled updated
event WhitelistEnabledUpdated(bool oldWhitelistEnabled, bool newWhitelistEnabled);
/// @notice Modifier to restrict access to only the designated protection strategy account.
/// @dev Reverts the transaction if the sender is not the protection strategy account.
modifier onlyProtect() {
if (protectStrategy != _msgSender()) {
revert ProtectUnauthorizedAccount(_msgSender());
}
_;
}
/// @notice Modifier to check if the sender is whitelisted
/// @dev Reverts the transaction if the sender is not whitelisted when whitelist is enabled
modifier onlyWhitelisted(address user_) {
if (whitelistEnabled && !whitelisted[user_]) {
revert UserNotWhitelisted(user_);
}
_;
}
///@notice Modifier that allows protocol to take fees
modifier takeFees() {
if (firstDeposit == 0 || totalSupply() == 0) {
feesUpdatedAt = block.timestamp;
}
if (!paused()) {
uint256 totalFee = accruedProtocolFee() + accruedPerformanceFee();
uint256 shareValue = convertToAssets(1e18);
uint256 _totalAssets = totalAssets();
if (shareValue > highWaterMark) highWaterMark = shareValue;
if (totalFee > 0 && _totalAssets > 0) {
uint256 supply = totalSupply();
uint256 feeInShare =
supply == 0 ? totalFee : totalFee.mulDiv(supply, _totalAssets - totalFee, Math.Rounding.Floor);
_mint(feeRecipient, feeInShare);
feesUpdatedAt = block.timestamp;
}
}
_;
}
constructor() {
_disableInitializers();
}
function initialize(
IERC20 baseAsset_,
string memory shareName_,
string memory shareSymbol_,
Strategy[] memory strategies_,
address feeRecipient_,
VaultFees memory fees_,
uint256 depositLimit_,
address owner_,
bool isQueueMandatory_
) external virtual initializer nonReentrant {
_initialize(
baseAsset_,
shareName_,
shareSymbol_,
strategies_,
feeRecipient_,
fees_,
depositLimit_,
owner_,
isQueueMandatory_
);
}
/**
* @notice Initializes the vault with its core parameters
* @dev Sets up the vault's initial state including strategies, fees, and limits
* @param baseAsset_ The underlying asset token address
* @param shareName_ The name for the vault's share token
* @param shareSymbol_ The symbol for the vault's share token
* @param strategies_ Array of initial strategies
* @param feeRecipient_ Address to receive collected fees
* @param fees_ Initial fee structure
* @param depositLimit_ Maximum deposit amount allowed
* @param owner_ Address of the vault owner
*/
// slither didn't detect the nonReentrant modifier
// slither-disable-next-line reentrancy-no-eth,reentrancy-benign,calls-loop,costly-loop
function _initialize(
IERC20 baseAsset_,
string memory shareName_,
string memory shareSymbol_,
Strategy[] memory strategies_,
address feeRecipient_,
VaultFees memory fees_,
uint256 depositLimit_,
address owner_,
bool isQueueMandatory_
) internal {
__Pausable_init();
__ERC4626_init(baseAsset_);
__ERC20_init(shareName_, shareSymbol_);
__Ownable_init(owner_);
__ReentrancyGuard_init();
if (address(baseAsset_) == address(0)) revert InvalidAssetAddress();
(protectStrategy, _decimals) = MultiStrategyVaultHelper.validateVaultParameters(
baseAsset_, decimalOffset, strategies_, protectStrategy, strategies, fees_, fees
);
if (feeRecipient_ == address(0)) {
revert InvalidFeeRecipient();
}
feeRecipient = feeRecipient_;
highWaterMark = 1e9; // Set the initial high water mark for performance fee calculation.
depositLimit = depositLimit_;
isQueueMandatory = isQueueMandatory_;
whitelistEnabled = false; // Whitelist is disabled by default
// By default, the vault is not idle. It can be set to idle mode using toggleVaultIdle(true).
vaultIdle = false;
withdrawalsPaused = false;
feesUpdatedAt = block.timestamp;
emit Initialized(address(this), address(baseAsset_));
}
/**
* @notice Returns the decimals of the vault's shares.
* @dev Overrides the decimals function in inherited contracts to return the custom vault decimals.
* @return The decimals of the vault's shares.
*/
function decimals() public view override returns (uint8) {
return _decimals;
}
/**
* @notice Toggles the withdrawals paused state
* @dev Can only be called by the owner. Emits a `WithdrawalPausedToggled` event.
* @param withdrawalsPaused_ The new state of the withdrawals paused state
*/
function toggleWithdrawalsPaused(bool withdrawalsPaused_) external onlyOwner {
emit WithdrawalPausedToggled(withdrawalsPaused, withdrawalsPaused_);
withdrawalsPaused = withdrawalsPaused_;
}
/**
* @notice Pauses all deposit and withdrawal functions.
* @dev Can only be called by the owner. Emits a `Paused` event.
*/
function pause() public takeFees onlyOwner {
_pause();
}
function isUpgradeable() external pure virtual returns (bool) {
return false;
}
/**
* @notice Unpauses the vault, allowing deposit and withdrawal functions.
* @dev Can only be called by the owner. Emits an `Unpaused` event.
*/
function unpause() public takeFees onlyOwner {
_unpause();
feesUpdatedAt = block.timestamp;
}
/**
* @notice Sets the queue as mandatory (true) or optional (false)
* @dev Can only be called by the owner
*/
function setIsQueueMandatory(bool _isQueueMandatory) external onlyOwner {
bool previous = isQueueMandatory;
isQueueMandatory = _isQueueMandatory;
emit IsQueueMandatoryUpdated(previous, _isQueueMandatory);
}
/**
* @notice Sets the whitelist as enabled (true) or disabled (false)
* @dev Can only be called by the owner
* @param _whitelistEnabled The new state of the whitelist
*/
function setWhitelistEnabled(bool _whitelistEnabled) external onlyOwner {
emit WhitelistEnabledUpdated(whitelistEnabled, _whitelistEnabled);
whitelistEnabled = _whitelistEnabled;
}
// ========== WHITELISTING FUNCTIONS =============
/**
* @notice Adds an address to the whitelist
* @dev Can only be called by the owner. Emits an `UserAddedToWhitelist` event.
* @param user_ The address to add to the whitelist
*/
function addToWhitelist(address user_) external onlyOwner {
if (!whitelistEnabled) revert WhitelistDisabled();
if (user_ == address(0)) revert InvalidUserAddress();
if (whitelisted[user_]) revert UserAlreadyWhitelisted(user_);
whitelisted[user_] = true;
emit UserAddedToWhitelist(user_);
}
/**
* @notice Removes an address from the whitelist
* @dev Can only be called by the owner. Emits an `AddressRemovedFromWhitelist` event.
* @param user_ The address to remove from the whitelist
*/
function removeFromWhitelist(address user_) external onlyOwner {
if (!whitelistEnabled) revert WhitelistDisabled();
if (!whitelisted[user_]) revert UserNotWhitelisted(user_);
delete whitelisted[user_];
emit UserRemovedFromWhitelist(user_);
}
/**
* @notice Checks if an address is whitelisted
* @dev Returns true if whitelist is disabled or if the address is whitelisted
* @param user_ The address to check
* @return True if the address is whitelisted or whitelist is disabled
*/
function isWhitelisted(address user_) external view returns (bool) {
return _isWhitelisted(user_);
}
function _isWhitelisted(address user_) internal view returns (bool) {
return !whitelistEnabled || whitelisted[user_];
}
// ========== PUBLIC ENTRY DEPOSIT/WITHDRAW =============
/**
* @notice Allows a user to deposit assets into the vault in exchange for shares.
* @dev This function is a wrapper that calls the main deposit function with the sender's address as the receiver.
* @param assets_ The amount of assets to deposit.
* @return The number of shares minted for the deposited assets.
*/
function deposit(uint256 assets_) external returns (uint256) {
return deposit(assets_, msg.sender);
}
/**
* @notice Deposits assets into the vault on behalf of a receiver, in exchange for shares.
* @dev Calculates the deposit fee, mints shares to the fee recipient and the receiver, then transfers the assets from the sender.
* If the vault is not idle, it also allocates the assets into the strategies according to their allocation.
* @param assets_ The amount of assets to deposit.
* @param receiver_ The address for which the shares will be minted.
* @return shares The number of shares minted for the deposited assets.
*/
// We're not using the timestamp for comparisions
// slither-disable-next-line timestamp
function deposit(uint256 assets_, address receiver_)
public
override
nonReentrant
whenNotPaused
onlyWhitelisted(msg.sender)
takeFees
returns (uint256 shares)
{
_validateAndUpdateDepositTimestamps(receiver_);
if (totalAssets() + assets_ > depositLimit) {
revert MaxError();
}
// Calculate shares based on whether sender is fee recipient
if (msg.sender == feeRecipient) {
shares = _convertToShares(assets_, Math.Rounding.Floor);
} else {
// Calculate the fee in shares
uint256 feeShares = _convertToShares(
assets_.mulDiv(uint256(fees.depositFee), MAX_BASIS_POINTS, Math.Rounding.Ceil), Math.Rounding.Ceil
);
// Calculate the net shares to mint for the deposited assets
shares = _convertToShares(assets_, Math.Rounding.Floor) - feeShares;
// Mint fee shares to fee recipient
if (feeShares > 0) _mint(feeRecipient, feeShares);
}
if (shares <= DUST) revert ZeroAmount();
_mint(receiver_, shares);
IERC20(asset()).safeTransferFrom(msg.sender, address(this), assets_);
// Handle strategy allocation if vault is not idle
if (!vaultIdle) {
StrategyHelper.depositIntoStrategies(strategies, assets_, address(this), true);
}
emit Deposit(msg.sender, receiver_, assets_, shares);
}
/**
* @notice Allows a user to mint shares in exchange for assets.
* @dev This function is a wrapper that calls the main mint function with the sender's address as the receiver.
* @param shares_ The number of shares to mint.
* @return The amount of assets deposited in exchange for the minted shares.
*/
function mint(uint256 shares_) external returns (uint256) {
return mint(shares_, msg.sender);
}
/**
* @notice Mints shares on behalf of a receiver, in exchange for assets.
* @dev Calculates the deposit fee in shares, mints shares to the fee recipient and the receiver, then transfers the assets from the sender.
* If the vault is not idle, it also allocates the assets into the strategies according to their allocation.
* @param shares_ The number of shares to mint.
* @param receiver_ The address for which the shares will be minted.
* @return assets The amount of assets deposited in exchange for the minted shares.
*/
// We're not using the timestamp for comparisions
// slither-disable-next-line timestamp
function mint(uint256 shares_, address receiver_)
public
override
nonReentrant
whenNotPaused
onlyWhitelisted(msg.sender)
takeFees
returns (uint256 assets)
{
_validateAndUpdateDepositTimestamps(receiver_);
if (shares_ <= DUST) revert ZeroAmount();
// Calculate the deposit fee in shares
uint256 depositFee = uint256(fees.depositFee);
uint256 feeShares = msg.sender != feeRecipient
? shares_.mulDiv(MAX_BASIS_POINTS, MAX_BASIS_POINTS - depositFee, Math.Rounding.Ceil) - shares_
: 0;
// Calculate the total assets required for the minted shares, including fees
assets = _convertToAssets(shares_ + feeShares, Math.Rounding.Ceil);
if (totalAssets() + assets > depositLimit) revert MaxError();
if (assets > maxDeposit(receiver_)) revert MaxError();
// Mint shares to fee recipient and receiver
if (feeShares > 0) _mint(feeRecipient, feeShares);
_mint(receiver_, shares_);
// Transfer the assets from the sender to the vault
IERC20(asset()).safeTransferFrom(msg.sender, address(this), assets);
// If the vault is not idle, allocate the assets into strategies
if (!vaultIdle) {
StrategyHelper.depositIntoStrategies(strategies, assets, address(this), true);
}
emit Deposit(msg.sender, receiver_, assets, shares_);
}
/**
* @notice Redeems shares for the caller and sends the assets to the caller.
* @dev This is a convenience function that calls the main redeem function with the caller as both receiver and owner.
* @param shares_ The number of shares to redeem.
* @return assets The amount of assets returned in exchange for the redeemed shares.
*/
function redeem(uint256 shares_) external returns (uint256) {
return redeem(shares_, msg.sender, msg.sender);
}
/**
* @notice Redeems shares on behalf of an owner and sends the assets to a receiver.
* @dev Redeems the specified amount of shares from the owner's balance, deducts the withdrawal fee in shares, burns the shares, and sends the assets to the receiver.
* If the caller is not the owner, it requires approval.
* @param shares_ The number of shares to redeem.
* @param receiver_ The address to receive the assets.
* @param owner_ The owner of the shares being redeemed.
* @return assets The expected amount of assets returned in exchange for the redeemed shares calculated for current block.
*/
function redeem(uint256 shares_, address receiver_, address owner_)
public
override
nonReentrant
whenNotPaused
onlyWhitelisted(msg.sender)
takeFees
returns (uint256 assets)
{
VaultActionsHelper.validateRedeemParams(receiver_, shares_, maxRedeem(owner_));
if (shares_ <= DUST) revert ZeroAmount();
uint256 feeShares = msg.sender != feeRecipient
? shares_.mulDiv(uint256(fees.withdrawalFee), MAX_BASIS_POINTS, Math.Rounding.Ceil)
: 0;
assets = _convertToAssets(shares_ - feeShares, Math.Rounding.Floor);
_redeem(shares_, receiver_, owner_, feeShares, assets);
}
/**
* @notice Withdraws a specified amount of assets for the caller.
* @dev This is a convenience function that calls the main withdraw function with the caller as both receiver and owner.
* @param assets_ The amount of assets to withdraw.
* @return shares The number of shares burned in exchange for the withdrawn assets.
*/
function withdraw(uint256 assets_) external returns (uint256) {
return withdraw(assets_, msg.sender, msg.sender);
}
function maxWithdraw(address owner) public view virtual override returns (uint256) {
return _maxWithdraw(owner);
}
function _maxWithdraw(address owner) internal view returns (uint256) {
if (paused() || withdrawalsPaused || !_isWhitelisted(owner)) return 0;
// Get the raw max withdrawal amount
uint256 rawMaxWithdraw = _convertToAssets(balanceOf(owner), Math.Rounding.Floor);
// Calculate pending fees (in assets)
uint256 pendingFees = accruedProtocolFee() + accruedPerformanceFee();
uint256 ownerFees = pendingFees.mulDiv(rawMaxWithdraw, totalAssets(), Math.Rounding.Floor);
// Return max withdraw minus pending fees
uint256 maxWithdrawMinusFees = rawMaxWithdraw.mulDiv(MAX_BASIS_POINTS - fees.withdrawalFee, MAX_BASIS_POINTS, Math.Rounding.Floor)
- ownerFees;
if (address(withdrawalQueue) != address(0)) {
return maxWithdrawMinusFees;
} else {
uint256 availableAssets = getAvailableAssetsForWithdrawal();
return availableAssets >= maxWithdrawMinusFees ? maxWithdrawMinusFees : availableAssets;
}
}
function maxRedeem(address owner) public view virtual override returns (uint256) {
if (paused() || withdrawalsPaused || !_isWhitelisted(owner)) return 0;
uint256 userShares = balanceOf(owner);
if (address(withdrawalQueue) != address(0)) {
return userShares;
}
uint256 availableAssets = getAvailableAssetsForWithdrawal();
uint256 availableAssetsInShares = _convertToShares(availableAssets, Math.Rounding.Floor);
return availableAssetsInShares >= userShares ? userShares : availableAssetsInShares;
}
/**
* @notice Redeems shares corresponding to the specified amount of assets on behalf of an owner and sends corresponding assets to the receiver.
* @dev Calculates the number of shares equivalent to the assets requested, deducts the withdrawal fee in shares, burns the shares, and sends the corresponding assets to the receiver.
* If the caller is not the owner, it requires approval.
* @param assets_ The amount of assets to withdraw.
* @param receiver_ The address to receive the withdrawn assets.
* @param owner_ The owner of the shares equivalent to the assets being withdrawn.
* @return shares The number of shares burned in exchange for the withdrawn assets.
*/
// We're not using the timestamp for comparisions
// slither-disable-next-line timestamp
function withdraw(uint256 assets_, address receiver_, address owner_)
public
override
nonReentrant
whenNotPaused
onlyWhitelisted(msg.sender)
takeFees
returns (uint256 shares)
{
if (receiver_ == address(0)) revert InvalidRecipient();
if (assets_ > maxWithdraw(owner_)) revert MaxError();
shares = _convertToShares(assets_, Math.Rounding.Ceil);
if (shares <= DUST) revert ZeroAmount();
// If msg.sender is the withdrawal queue, go straght to the actual withdrawal
uint256 withdrawalFee = uint256(fees.withdrawalFee);
uint256 feeShares = msg.sender != feeRecipient
? shares.mulDiv(MAX_BASIS_POINTS, MAX_BASIS_POINTS - withdrawalFee, Math.Rounding.Ceil) - shares
: 0;
shares += feeShares;
_redeem(shares, receiver_, owner_, feeShares, assets_);
}
/**
* @notice Consumes allowance, burn shares, mint fees and transfer assets to receiver
* @dev internal function for redeem and withdraw
* @param sharesToRedeem The amount of shares to redeem including fees.
* @param receiver_ The address to receive the withdrawn assets.
* @param owner_ The owner of the shares equivalent to the assets being withdrawn.
* @param feeShares The owner of the shares equivalent to the assets being withdrawn.
*/
// We're not using the timestamp for comparisions
// slither-disable-next-line timestamp
function _redeem(uint256 sharesToRedeem, address receiver_, address owner_, uint256 feeShares, uint256 assets)
private
{
if (withdrawalsPaused) revert WithdrawalsPaused();
if (msg.sender != owner_) {
_spendAllowance(owner_, msg.sender, sharesToRedeem);
}
_burn(owner_, sharesToRedeem);
if (feeShares > 0) _mint(feeRecipient, feeShares);
uint256 availableAssetsForWithdrawal = getAvailableAssetsForWithdrawal();
WithdrawalQueueHelper.processWithdrawal(
assets,
sharesToRedeem - feeShares,
receiver_,
availableAssetsForWithdrawal,
asset(),
address(withdrawalQueue),
minQueueRequest,
strategies,
parkingLot,
isQueueMandatory
);
emit Withdraw(msg.sender, receiver_, owner_, assets, sharesToRedeem);
}
function getRewardTokens() public view returns (address[] memory) {
return rewardAddresses;
}
function getAvailableAssetsForWithdrawal() public view returns (uint256) {
return WithdrawalQueueHelper.getAvailableAssetsForWithdrawal(asset(), strategies);
}
/**
* @notice Updates the user rewards to the current reward index.
* @dev Calculates the rewards to be transferred to the user based on the difference between the current and previous reward indexes.
* @param userAddress The address of the user to update rewards for.
*/
//slither-disable-next-line unused-return,calls-loop,reentrancy-no-eth
function getUserRewards(address userAddress) external view returns (ReturnedRewards[] memory) {
return RewardsHelper.getUserRewards(
balanceOf(userAddress), userAddress, rewardAddresses, rewardIndex, userRewardIndex
);
}
// function to return all the rewards claimed by a user for all the reward tokens in the vault
function getTotalRewardsClaimed(address userAddress) external view returns (ReturnedRewards[] memory) {
return RewardsHelper.getTotalRewardsClaimed(rewardAddresses, totalRewardsClaimed, userAddress);
}
// ================= ACCOUNTING =====================
/**
* @notice Calculates the total assets under management in the vault, including those allocated to strategies.
* @dev Sums the balance of the vault's asset held directly and the assets managed by each strategy.
* @return total The total assets under management in the vault.
*/
function totalAssets() public view override returns (uint256 total) {
total = VaultActionsHelper.getTotalAssets(IERC20(asset()).balanceOf(address(this)), strategies);
}
/**
* @notice Calculates the total supply of the vault shares, including shares pending redemption.
* @dev Sums the balance of the vault's total supply and queue pending shares - unfinalizedAmount.
* @return total The total supply of the the vault shares.
*/
function totalSupply() public view override(ERC20Upgradeable, IERC20) returns (uint256 total) {
total = VaultActionsHelper.getTotalSupply(super.totalSupply(), withdrawalQueue);
}
/**
* @notice Provides a preview of the number of shares that would be minted for a given deposit amount, after fees.
* @dev Calculates the deposit fee and subtracts it from the deposit amount to determine the net amount for share conversion.
* @param assets_ The amount of assets to be deposited.
* @return The number of shares that would be minted for the given deposit amount.
*/
function previewDeposit(uint256 assets_) public view override returns (uint256) {
// Calculate gross shares first
uint256 grossShares = _convertToShares(assets_, Math.Rounding.Floor);
// Calculate fee shares using same formula and rounding as deposit
uint256 feeShares = msg.sender != feeRecipient
? _convertToShares(
assets_.mulDiv(uint256(fees.depositFee), MAX_BASIS_POINTS, Math.Rounding.Ceil), Math.Rounding.Ceil
)
: 0;
// Return net shares
return grossShares - feeShares;
}
/**
* @notice Provides a preview of the amount of assets required to mint a specific number of shares, after accounting for deposit fees.
* @dev Adds the deposit fee to the share amount to determine the gross amount for asset conversion.
* @param shares_ The number of shares to be minted.
* @return The amount of assets required to mint the specified number of shares.
*/
function previewMint(uint256 shares_) public view override returns (uint256) {
uint256 grossShares = shares_;
if (msg.sender != feeRecipient) {
grossShares = shares_.mulDiv(MAX_BASIS_POINTS, MAX_BASIS_POINTS - fees.depositFee, Math.Rounding.Ceil);
}
return _convertToAssets(grossShares, Math.Rounding.Ceil);
}
/**
* @notice Provides a preview of the number of shares that would be burned for a given withdrawal amount, after fees.
* @dev Calculates the withdrawal fee and adds it to the share amount to determine the gross shares for asset conversion.
* @param assets_ The amount of assets to be withdrawn.
* @return shares The number of shares that would be burned for the given withdrawal amount.
*/
function previewWithdraw(uint256 assets_) public view override returns (uint256 shares) {
shares = _convertToShares(assets_, Math.Rounding.Ceil);
shares = msg.sender != feeRecipient
? shares.mulDiv(MAX_BASIS_POINTS, MAX_BASIS_POINTS - fees.withdrawalFee, Math.Rounding.Floor)
: shares;
}
/**
* @notice Provides a preview of the amount of assets that would be redeemed for a specific number of shares, after withdrawal fees.
* @dev Subtracts the withdrawal fee from the share amount to determine the net shares for asset conversion.
* @param shares_ The number of shares to be redeemed.
* @return The amount of assets that would be redeemed for the specified number of shares.
*/
function previewRedeem(uint256 shares_) public view override returns (uint256) {
if (msg.sender == feeRecipient) {
// Fee recipient gets exact conversion
return _convertToAssets(shares_, Math.Rounding.Floor);
}
uint256 feeShares = shares_.mulDiv(uint256(fees.withdrawalFee), MAX_BASIS_POINTS, Math.Rounding.Ceil);
return _convertToAssets(shares_ - feeShares, Math.Rounding.Floor);
}
/**
* @notice Calculates the maximum amount of assets that can be minted, considering the deposit limit and current total assets.
* @dev Returns zero if the vault is paused, not whitelisted or if the total assets are equal to or exceed the deposit limit.
* @return The maximum amount of assets that can be minted.
*/
//We're not using the timestamp for comparisions
//slither-disable-next-line timestamp
function maxDeposit(address user) public view override returns (uint256) {
bool isZeroDepositLimit = (
paused() ||
!_isWhitelisted(user) ||
depositLimit == 0 ||
totalAssets() >= depositLimit
);
return isZeroDepositLimit ? 0 : depositLimit - totalAssets();
}
/**
* @notice Calculates the maximum amount of assets that can be minted, considering the deposit limit and current total assets.
* @dev Returns zero if the vault is paused or if the total assets are equal to or exceed the deposit limit.
* @return The maximum amount of assets that can be minted.
*/
//We're not using the timestamp for comparisions
//slither-disable-next-line timestamp
function maxMint(address user) public view override returns (uint256) {
if (paused() || depositLimit == 0 || !_isWhitelisted(user)) return 0;
if (depositLimit == type(uint256).max) return type(uint256).max;
uint256 supplyLimit = _convertToShares(depositLimit, Math.Rounding.Floor);
return supplyLimit - totalSupply();
}
/**
* @notice Converts an amount of assets to the equivalent amount of shares, considering the current share price and applying the specified rounding.
* @dev Utilizes the total supply and total assets to calculate the share price for conversion.
* @param assets The amount of assets to convert to shares.
* @param rounding The rounding direction to use for the conversion.
* @return shares The equivalent amount of shares for the given assets.
*/
function _convertToShares(uint256 assets, Math.Rounding rounding) internal view override returns (uint256 shares) {
shares = assets.mulDiv(totalSupply() + 10 ** decimalOffset, totalAssets() + 1, rounding);
}
/**
* @notice Converts an amount of shares to the equivalent amount of assets, considering the current share price and applying the specified rounding.
* @dev Utilizes the total assets and total supply to calculate the asset price for conversion.
* @param shares The amount of shares to convert to assets.
* @param rounding The rounding direction to use for the conversion.
* @return The equivalent amount of assets for the given shares.
*/
function _convertToAssets(uint256 shares, Math.Rounding rounding)
internal
view
virtual
override
returns (uint256)
{
return shares.mulDiv(totalAssets() + 1, totalSupply() + 10 ** decimalOffset, rounding);
}
// ============ FEE ACCOUNTING =====================
/**
* @notice Calculates the accrued protocol fee based on the current protocol fee rate and time elapsed.
* @dev The protocol fee is calculated as a percentage of the total assets, prorated over time since the last fee update.
* @return The accrued protocol fee in asset units.
*/
function accruedProtocolFee() public view whenNotPaused returns (uint256) {
// Only calculate if a protocol fee is set
return FeesHelper.accruedProtocolFee(fees.protocolFee, totalAssets(), feesUpdatedAt);
}
/**
* @notice Calculates the accrued performance fee based on the vault's performance relative to the high water mark.
* @dev The performance fee is calculated as a percentage of the profit (asset value increase) since the last high water mark update.
* @return fee The accrued performance fee in asset units.
*/
// We're not using the timestamp for comparisions
// slither-disable-next-line timestamp
function accruedPerformanceFee() public view returns (uint256) {
// Calculate the share value in assets
uint256 shareValue = convertToAssets(1e18);
// Only calculate if a performance fee is set and the share value exceeds the high water mark
return FeesHelper.accruedPerformanceFee(
fees.performanceFee, totalAssets(), shareValue, highWaterMark, asset(), fees
);
}
/**
* @notice Retrieves the current fee structure of the vault.
* @dev Returns the vault's fees including deposit, withdrawal, protocol, and performance fees.
* @return A `VaultFees` struct containing the current fee rates.
*/
function getVaultFees() public view returns (VaultFees memory) {
return fees;
}
// ============== FEE LOGIC ===================
/**
* @notice Placeholder function for taking portfolio and protocol fees.
* @dev This function is intended to be overridden with actual fee-taking logic.
*/
function takePortfolioAndProtocolFees() external nonReentrant takeFees onlyOwner {
// Intentionally left blank for override
}
/**
* @notice Updates the vault's fee structure.
* @dev Can only be called by the vault owner. Emits an event upon successful update.
* @param newFees_ The new fee structure to apply to the vault.
*/
function setVaultFees(VaultFees calldata newFees_) external takeFees onlyOwner {
fees = newFees_; // Update the fee structure
feesUpdatedAt = block.timestamp; // Record the time of the fee update
}
/**
* @notice Sets a new fee recipient address for the vault.
* @dev Can only be called by the vault owner. Reverts if the new recipient address is the zero address.
* @param newRecipient_ The address of the new fee recipient.
*/
function setFeeRecipient(address newRecipient_) external onlyOwner {
// Validate the new recipient address
if (newRecipient_ == address(0)) revert InvalidFeeRecipient();
// Emit an event for the fee recipient update
emit FeeRecipientUpdated(feeRecipient, newRecipient_);
feeRecipient = newRecipient_; // Update the fee recipient
}
/**
* @notice Sets a minimum amount required to queue a withdrawal request.
* @param minQueueRequest_ The address of the new fee recipient.
*/
function setMinimunQueueRequest(uint256 minQueueRequest_) external onlyOwner {
emit MinimunQueueRequestUpdated(minQueueRequest, minQueueRequest_);
minQueueRequest = minQueueRequest_;
}
/**
* @notice Sets a new fee recipient address for the vault.
* @dev Can only be called by the vault owner. Reverts if the new recipient address is the zero address.
* @param withdrawalQueue_ The address of the new withdrawlQueue.
*/
function setWithdrawalQueue(address withdrawalQueue_) external onlyOwner {
withdrawalQueue = WithdrawalQueueHelper.setWithdrawalQueue(address(withdrawalQueue), withdrawalQueue_);
}
/**
* @notice Sets a new parking lot address for the vault.
* @dev Can only be called by the vault owner. Reverts if the new parking lot address is the zero address.
* @param parkingLot_ The address of the new parking lot.
*/
function setParkingLot(address parkingLot_) external onlyOwner {
// Validate the new recipient address
if (parkingLot_ == address(0)) revert InvalidParkingLot();
// create a success
// Emit an event for the fee recipient update
address token = asset();
address currentParkingLot = address(parkingLot);
if (currentParkingLot != address(0)) TokenHelper.attemptForceApprove(token, currentParkingLot, 0, true);
TokenHelper.attemptForceApprove(token, parkingLot_, type(uint256).max, true);
emit ParkingLotUpdated(currentParkingLot, parkingLot_, true);
parkingLot = IParkingLot(parkingLot_); // Update the fee recipient
}
// ============= STRATEGIES ===================
/**
* @notice Retrieves the current strategies employed by the vault.
* @dev Returns an array of `Strategy` structs representing each strategy.
* @return An array of `Strategy` structs.
*/
function getStrategies() external view returns (Strategy[] memory) {
return strategies;
}
/**
* @notice Toggles the vault's idle state.
* @dev Can only be called by the vault owner. Emits a `ToggleVaultIdle` event with the previous and new state.
*/
function toggleVaultIdle() external onlyOwner {
emit ToggleVaultIdle(vaultIdle, !vaultIdle);
vaultIdle = !vaultIdle;
}
/**
* @notice Adds a new strategy or replaces an existing one.
* @dev Can only be called by the vault owner. Validates the total allocation does not exceed 100%.
* Emits a `StrategyAdded` or/and `StrategyRemoved` event.
* @param index_ The index at which to add or replace the strategy. If replacing, this is the index of the existing strategy.
* @param replace_ A boolean indicating whether to replace an existing strategy.
* @param newStrategy_ The new strategy to add or replace the existing one with.
*/
// slither didn't detect the nonReentrant modifier
// slither-disable-next-line reentrancy-no-eth
function addStrategy(uint256 index_, bool replace_, Strategy calldata newStrategy_)
external
nonReentrant
onlyOwner
takeFees
{
IStrategy newStrategy;
IStrategy removedStrategy;
(protectStrategy, newStrategy, removedStrategy) = StrategyHelper.addOrReplaceStrategy(
strategies, newStrategy_, replace_, index_, protectStrategy, IERC20(asset())
);
if (address(removedStrategy) != address(0)) {
emit StrategyRemoved(address(removedStrategy));
}
emit StrategyAdded(address(newStrategy));
}
/**
* @notice Adds a new strategy or replaces an existing one.
* @dev Can only be called by the vault owner. Validates that the index to be removed exists.
* Emits a `StrategyRemoved` event.
* @param index_ The index of the strategy to be removed.
*/
// slither didn't detect the nonReentrant modifier
// slither-disable-next-line reentrancy-no-eth
function removeStrategy(uint256 index_) public nonReentrant onlyOwner takeFees {
uint256 len = strategies.length;
if (index_ >= len) revert InvalidIndex(index_);
protectStrategy = StrategyHelper.removeStrategy(strategies, index_, protectStrategy, IERC20(asset()));
}
/// @notice Emergency function to force remove a strategy when it's unable to withdraw funds
/// @dev Should only be used when a strategy is permanently compromised or frozen
/// @param index_ The index of the strategy to remove
/// @param forceEject_ If true, bypasses the locked assets check
function emergencyRemoveStrategy(uint256 index_, bool forceEject_) external onlyOwner {
if (index_ >= strategies.length) revert InvalidIndex(index_);
protectStrategy = StrategyHelper.emergencyRemoveStrategy(strategies, asset(), index_, forceEject_, protectStrategy);
}
/**
* @notice ERC20 _update function override.
*/
function _update(address from, address to, uint256 value) internal override {
if (from != address(0)) updateUserRewardsToCurrent(from);
if (to != address(0)) updateUserRewardsToCurrent(to);
super._update(from, to, value);
}
/**
* @notice Changes strategies allocations.
* @dev Can only be called by the vault owner. Validates the total allocation does not exceed 100% and the length corresponds with the strategies array.
* Emits a `StrategyAllocationsChanged`
* @param allocations_ The array with the new allocations.
* @param redistribute A boolean indicating whether to redistributes allocations.
*/
function changeAllocations(Allocation[] calldata allocations_, bool redistribute)
external
nonReentrant
onlyOwner
takeFees
{
StrategyHelper.changeAllocations(strategies, allocations_, redistribute, asset());
}
/**
* @notice Pushes funds from the vault into all strategies based on their allocation.
* @dev Can only be called by the vault owner. Reverts if the vault is idle.
*/
function pushFundsToStrategies() public onlyOwner {
if (vaultIdle) revert VaultIsIdle();
// Call the library function to distribute assets
StrategyHelper.distributeAssetsToStrategies(strategies, IERC20(asset()).balanceOf(address(this)));
}
/**
* @notice Pulls funds back from all strategies into the vault.
* @dev Can only be called by the vault owner.
*/
// We are aware that we aren't using the return value
// We control both the length of the array and the external call
//slither-disable-next-line unused-return,calls-loop
function pullFundsFromStrategies() public onlyOwner {
StrategyHelper.pullFundsFromStrategies(strategies);
}
/**
* @notice Pulls funds back from a single strategy into the vault.
* @dev Can only be called by the vault owner.
* @param index_ The index of the strategy from which to pull funds.
*/
// We are aware that we aren't using the return value
// We control both the length of the array and the external call
//slither-disable-next-line unused-return,calls-loop
function pullFundsFromSingleStrategy(uint256 index_) public onlyOwner {
StrategyHelper.pullFundsFromSingleStrategy(strategies, index_);
}
/**
* @notice Pushes funds from the vault into a single strategy based on its allocation.
* @dev Can only be called by the vault owner. Reverts if the vault is idle.
* @param index_ The index of the strategy into which to push funds.
*/
function pushFundsIntoSingleStrategy(uint256 index_) external onlyOwner {
StrategyHelper.pushFundsIntoSingleStrategyNoAmount(
strategies, IERC20(asset()).balanceOf(address(this)), index_, vaultIdle
);
}
/**
* @notice Pushes the amount sent from the vault into a single strategy.
* @dev Can only be called by the vault owner. Reverts if the vault is idle.
* @param index_ The index of the strategy into which to push funds.
* @param amount The index of the strategy into which to push funds.
*/
function pushFundsIntoSingleStrategy(uint256 index_, uint256 amount) external onlyOwner {
StrategyHelper.pushFundsIntoSingleStrategy(
strategies, vaultIdle, IERC20(asset()).balanceOf(address(this)), index_, amount
);
}
/**
* @notice Sets a new deposit limit for the vault.
* @dev Can only be called by the vault owner. Emits a `DepositLimitSet` event with the new limit.
* @param newLimit_ The new deposit limit to set.
*/
function setDepositLimit(uint256 newLimit_) external onlyOwner {
depositLimit = newLimit_;
emit DepositLimitSet(newLimit_);
}
/**
* @notice Harvest rewards on every strategy.
* @dev Calculates de reward index for each reward found.
*/
//we control the external call
//slither-disable-next-line unused-return,calls-loop,reentrancy-no-eth
function harvestRewards(bytes calldata encodedData) external nonReentrant onlyOwner {
uint256[] memory indices;
bytes[] memory data;
if (encodedData.length != 0) {
(indices, data) = abi.decode(encodedData, (uint256[], bytes[]));
}
uint256 totalSupply = totalSupply();
bytes memory rewardsData;
uint256 lenIndices = indices.length;
uint256 lenStrategies = strategies.length;
uint256 lenRewards;
for (uint256 i; i < lenStrategies;) {
//We control both the length of the array and the external call
//slither-disable-next-line unused-return,calls-loop
for (uint256 k = 0; k < lenIndices;) {
if (indices[k] == i) {
rewardsData = data[k];
break;
}
rewardsData = "";
unchecked {
k++;
}
}
ReturnedRewards[] memory returnedRewards = strategies[i].strategy.harvestRewards(rewardsData);
lenRewards = returnedRewards.length;
for (uint256 j; j < lenRewards;) {
uint256 amount = returnedRewards[j].rewardAmount;
address rewardToken = returnedRewards[j].rewardAddress;
if (amount != 0) {
if (rewardIndex[rewardToken] == 0) {
rewardAddresses.push(rewardToken);
}
if (totalSupply > 0) {
rewardIndex[rewardToken] += amount.mulDiv(PRECISION, totalSupply, Math.Rounding.Floor);
}
}
unchecked {
j++;
}
}
unchecked {
i++;
}
}
emit RewardsHarvested();
}
/**
* @notice Updates the user rewards to the current reward index.
* @dev Calculates the rewards to be transferred to the user based on the difference between the current and previous reward indexes.
* @param userAddress The address of the user to update rewards for.
*/
//slither-disable-next-line unused-return,calls-loop,reentrancy-no-eth
function updateUserRewardsToCurrent(address userAddress) private {
RewardsHelper.updateUserRewardsToCurrent(
balanceOf(userAddress), userAddress, rewardAddresses, rewardIndex, userRewardIndex, totalRewardsClaimed
);
}
/**
* @notice Claims multiple withdrawal requests starting from the lasFinalizedRequestId.
* @dev This function allows the contract owner to claim multiple withdrawal requests in batches.
* @param maxRequests The maximum number of withdrawal requests to be processed in this batch.
*/
function batchClaimWithdrawal(uint256 maxRequests) external onlyOwner nonReentrant {
if (address(withdrawalQueue) == address(0)) revert QueueNotSet();
uint256 availableAssetsInShares = _convertToShares(getAvailableAssetsForWithdrawal(), Math.Rounding.Floor);
WithdrawalQueueHelper.BatchClaimParams memory params =
WithdrawalQueueHelper.BatchClaimParams(totalAssets(), totalSupply(), decimalOffset);
WithdrawalQueueHelper.batchClaim(
withdrawalQueue, maxRequests, availableAssetsInShares, asset(), strategies, parkingLot, params
);
}
function claimRewards() external {
updateUserRewardsToCurrent(msg.sender);
}
/**
* @notice Requests funds from available assets.
* @dev This function allows the protect strategy to request funds from available assets, withdraws from other strategies if necessary,
* and deposits the requested funds into the protect strategy.
* @param amount The amount of funds to request.
*/
//we control the external call, only callable by the protect strategy
//slither-disable-next-line calls-loop,,reentrancy-events
function requestFunds(uint256 amount) external onlyProtect {
uint256 acumulated = MultiStrategyVaultHelper.withdrawAssets(asset(), amount, protectStrategy, strategies);
WithdrawalQueueHelper.requestFunds(amount, acumulated, protectStrategy);
}
// Helper function ////////////////////////
function _validateAndUpdateDepositTimestamps(address receiver_) private {
if (receiver_ == address(0)) revert InvalidRecipient();
if (firstDeposit == 0) {
firstDeposit = block.timestamp;
}
}
}// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
import {IWithdrawalQueue} from "../interfaces/IWithdrawalQueue.sol";
import {Errors} from "../interfaces/Errors.sol";
import {Strategy} from "../interfaces/IConcreteMultiStrategyVault.sol";
import {IERC4626, IERC20} from "@openzeppelin/contracts/interfaces/IERC4626.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {ROUNDING_DELTA} from "../utils/Constants.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {IStrategy} from "../interfaces/IStrategy.sol";
import {TokenHelper} from "@blueprint-finance/hub-and-spokes-libraries/src/libraries/TokenHelper.sol";
import {IParkingLot} from "../interfaces/IParkingLot.sol";
import {Errors} from "../interfaces/Errors.sol";
library WithdrawalQueueHelper {
using Math for uint256;
using SafeERC20 for IERC20;
/// @notice event for withdrawal queue updated
event WithdrawalQueueUpdated(address oldWithdrawalQueue, address newWithdrawalQueue);
/// @notice event for requested funds
event RequestedFunds(address protectStrategy, uint256 amount);
event WithdrawalsFinalized(uint256 previousLastRequestId, uint256 newLastRequestId);
struct BatchClaimParams {
uint256 totalAssets;
uint256 totalSupply;
uint8 decimalOffset;
}
function getAvailableAssetsForWithdrawal(address asset, Strategy[] memory strategies)
external
view
returns (uint256)
{
uint256 totalAvailable = IERC20(asset).balanceOf(address(this));
uint256 len = strategies.length;
for (uint256 i; i < len;) {
Strategy memory strategy = strategies[i];
//We control both the length of the array and the external call
//slither-disable-next-line calls-loop
totalAvailable += strategy.strategy.getAvailableAssetsForWithdrawal();
unchecked {
i++;
}
}
return totalAvailable;
}
function processWithdrawal(
uint256 assets_,
uint256 shares_,
address receiver_,
uint256 availableAssets,
address asset,
address withdrawalQueue,
uint256 minQueueRequest,
Strategy[] memory strategies,
IParkingLot parkingLot,
bool forceQueue
) external {
if (!forceQueue && availableAssets >= assets_) {
// if queue is not mandatory and there is enough assets available withdraw using current rate
_withdrawStrategyFunds(assets_, receiver_, asset, strategies, parkingLot);
} else {
if (address(withdrawalQueue) == address(0)) {
revert Errors.InsufficientVaultFunds(address(this), shares_, availableAssets);
}
if (minQueueRequest != 0 && shares_ < minQueueRequest) {
revert Errors.InsufficientQueueRequest(shares_, minQueueRequest);
}
IWithdrawalQueue(withdrawalQueue).requestWithdrawal(receiver_, shares_);
}
}
function requestFunds(uint256 amount, uint256 acumulated, address protectStrategy) external {
//after requesting funds deposits them into the protect strategy
if (acumulated < amount) {
revert Errors.InsufficientFunds(IStrategy(address(this)), amount, acumulated);
}
//slither-disable-next-line unused-return
IStrategy(protectStrategy).deposit(amount, address(this));
emit RequestedFunds(protectStrategy, amount);
}
function setWithdrawalQueue(address oldWithdrawalQueue, address withdrawalQueue_)
external
returns (IWithdrawalQueue)
{
// Validate the new recipient address
if (withdrawalQueue_ == address(0)) revert Errors.InvalidWithdrawlQueue();
if (address(oldWithdrawalQueue) != address(0)) {
if (IWithdrawalQueue(oldWithdrawalQueue).unfinalizedAmount() != 0) {
revert Errors.UnfinalizedWithdrawal(address(oldWithdrawalQueue));
}
}
// Emit an event for the fee recipient update
emit WithdrawalQueueUpdated(address(oldWithdrawalQueue), withdrawalQueue_);
return IWithdrawalQueue(withdrawalQueue_); // Update the fee recipient
}
function batchClaim(
IWithdrawalQueue withdrawalQueue,
uint256 maxRequests,
uint256 availableAssetsInShares,
address asset,
Strategy[] memory strategies,
IParkingLot parkingLot,
BatchClaimParams memory params
) external {
uint256 lastFinalizedId = withdrawalQueue.getLastFinalizedRequestId();
uint256 lastCreatedId = withdrawalQueue.getLastRequestId();
uint256 newLastFinalized = lastFinalizedId;
uint256 max = lastCreatedId < lastFinalizedId + maxRequests ? lastCreatedId : lastFinalizedId + maxRequests;
for (uint256 i = lastFinalizedId + 1; i <= max;) {
uint256 newAvailiableAssetsInShares = claimWithdrawal(
i,
availableAssetsInShares,
withdrawalQueue,
asset,
strategies,
parkingLot,
params.totalAssets,
params.totalSupply,
params.decimalOffset
);
// slither-disable-next-line incorrect-equality
if (newAvailiableAssetsInShares == availableAssetsInShares) break;
availableAssetsInShares = newAvailiableAssetsInShares;
newLastFinalized = i;
unchecked {
i++;
}
}
if (newLastFinalized != lastFinalizedId) {
withdrawalQueue._finalize(newLastFinalized);
emit WithdrawalsFinalized(lastFinalizedId, newLastFinalized);
}
}
function claimWithdrawal(
uint256 _requestId,
uint256 availableAssetsInShares,
IWithdrawalQueue withdrawalQueue,
address asset,
Strategy[] memory strategies,
IParkingLot parkingLot,
uint256 totalAssets,
uint256 totalSupply,
uint8 decimalOffset
) public returns (uint256) {
(address recipient, uint256 amount, uint256 newAvailableAssetsInShares) =
withdrawalQueue.prepareWithdrawal(_requestId, availableAssetsInShares);
uint256 amountOfAsset = _convertToAssets(amount, Math.Rounding.Floor, totalAssets, totalSupply, decimalOffset); // claim using current rate
if (availableAssetsInShares != newAvailableAssetsInShares) {
_withdrawStrategyFunds(amountOfAsset, recipient, asset, strategies, parkingLot);
}
return newAvailableAssetsInShares;
}
function _convertToAssets(
uint256 shares,
Math.Rounding rounding,
uint256 totalAssets,
uint256 totalSupply,
uint8 decimalOffset
) internal view returns (uint256) {
return shares.mulDiv(totalAssets + 1, totalSupply + 10 ** decimalOffset, rounding);
}
function _handleDirectTransfer(uint256 amount_, address receiver_, IERC20 asset_, IParkingLot parkingLot)
internal
{
if (amount_ == 0) return;
bool result = TokenHelper.attemptSafeTransfer(address(asset_), receiver_, amount_, false);
if (!result) {
parkingLot.deposit(receiver_, amount_);
}
}
function _handleStrategyWithdrawal(
Strategy memory strategy,
uint256 amountToWithdraw,
address receiver_,
IParkingLot parkingLot
) internal returns (uint256) {
try strategy.strategy.withdraw(amountToWithdraw, receiver_, address(this)) {
return amountToWithdraw;
} catch {
strategy.strategy.withdraw(amountToWithdraw, address(this), address(this));
parkingLot.deposit(receiver_, amountToWithdraw);
return amountToWithdraw;
}
}
function _withdrawStrategyFunds(
uint256 amount_,
address receiver_,
address asset_,
Strategy[] memory strategies,
IParkingLot parkingLot
) internal {
IERC20 _asset = IERC20(asset_);
uint256 float = _asset.balanceOf(address(this));
if (amount_ <= float) {
_handleDirectTransfer(amount_, receiver_, _asset, parkingLot);
return;
}
uint256 pullFundsFromStrategies = amount_ - float;
uint256 totalAllocation = _getTotalAllocation(strategies);
uint256 totalWithdrawn;
for (uint256 i; i < strategies.length;) {
Strategy memory strategy = strategies[i];
uint256 withdrawable = strategy.strategy.getAvailableAssetsForWithdrawal();
uint256 amountToWithdraw = _calculateWithdrawalAmount(pullFundsFromStrategies, strategy, totalAllocation);
if (amountToWithdraw > withdrawable) {
revert Errors.InsufficientFunds(strategy.strategy, amountToWithdraw, withdrawable);
}
totalWithdrawn += _handleStrategyWithdrawal(strategy, amountToWithdraw, receiver_, parkingLot);
unchecked {
++i;
}
}
if (totalWithdrawn >= amount_) {
return;
}
uint256 fractionAmt = amount_ - totalWithdrawn;
if (fractionAmt <= (float + ROUNDING_DELTA)) {
uint256 net = fractionAmt > float ? float : fractionAmt;
totalWithdrawn = amount_;
_handleDirectTransfer(net, receiver_, _asset, parkingLot);
}
if (totalWithdrawn < amount_) {
revert Errors.InsufficientFunds(IStrategy(address(this)), amount_, totalWithdrawn);
}
}
function _calculateWithdrawalAmount(uint256 amount_, Strategy memory strategy, uint256 totalAllocation)
internal
pure
returns (uint256)
{
return amount_.mulDiv(strategy.allocation.amount, totalAllocation, Math.Rounding.Floor);
}
function _getTotalAllocation(Strategy[] memory strategies) internal view returns (uint256 totalAllocation) {
uint256 len = strategies.length;
for (uint256 i; i < len;) {
totalAllocation += strategies[i].allocation.amount;
unchecked {
++i;
}
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/ReentrancyGuard.sol)
pragma solidity ^0.8.20;
import {Initializable} from "../proxy/utils/Initializable.sol";
/**
* @dev Contract module that helps prevent reentrant calls to a function.
*
* Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
* available, which can be applied to functions to make sure there are no nested
* (reentrant) calls to them.
*
* Note that because there is a single `nonReentrant` guard, functions marked as
* `nonReentrant` may not call one another. This can be worked around by making
* those functions `private`, and then adding `external` `nonReentrant` entry
* points to them.
*
* TIP: If you would like to learn more about reentrancy and alternative ways
* to protect against it, check out our blog post
* https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
*/
abstract contract ReentrancyGuardUpgradeable is Initializable {
// Booleans are more expensive than uint256 or any type that takes up a full
// word because each write operation emits an extra SLOAD to first read the
// slot's contents, replace the bits taken up by the boolean, and then write
// back. This is the compiler's defense against contract upgrades and
// pointer aliasing, and it cannot be disabled.
// The values being non-zero value makes deployment a bit more expensive,
// but in exchange the refund on every call to nonReentrant will be lower in
// amount. Since refunds are capped to a percentage of the total
// transaction's gas, it is best to keep them low in cases like this one, to
// increase the likelihood of the full refund coming into effect.
uint256 private constant NOT_ENTERED = 1;
uint256 private constant ENTERED = 2;
/// @custom:storage-location erc7201:openzeppelin.storage.ReentrancyGuard
struct ReentrancyGuardStorage {
uint256 _status;
}
// keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ReentrancyGuard")) - 1)) & ~bytes32(uint256(0xff))
bytes32 private constant ReentrancyGuardStorageLocation = 0x9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00;
function _getReentrancyGuardStorage() private pure returns (ReentrancyGuardStorage storage $) {
assembly {
$.slot := ReentrancyGuardStorageLocation
}
}
/**
* @dev Unauthorized reentrant call.
*/
error ReentrancyGuardReentrantCall();
function __ReentrancyGuard_init() internal onlyInitializing {
__ReentrancyGuard_init_unchained();
}
function __ReentrancyGuard_init_unchained() internal onlyInitializing {
ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();
$._status = NOT_ENTERED;
}
/**
* @dev Prevents a contract from calling itself, directly or indirectly.
* Calling a `nonReentrant` function from another `nonReentrant`
* function is not supported. It is possible to prevent this from happening
* by making the `nonReentrant` function external, and making it call a
* `private` function that does the actual work.
*/
modifier nonReentrant() {
_nonReentrantBefore();
_;
_nonReentrantAfter();
}
function _nonReentrantBefore() private {
ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();
// On the first call to nonReentrant, _status will be NOT_ENTERED
if ($._status == ENTERED) {
revert ReentrancyGuardReentrantCall();
}
// Any calls to nonReentrant after this point will fail
$._status = ENTERED;
}
function _nonReentrantAfter() private {
ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();
// By storing the original value once again, a refund is triggered (see
// https://eips.ethereum.org/EIPS/eip-2200)
$._status = NOT_ENTERED;
}
/**
* @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
* `nonReentrant` function in the call stack.
*/
function _reentrancyGuardEntered() internal view returns (bool) {
ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();
return $._status == ENTERED;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/ERC4626.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 {ERC20Upgradeable} from "../ERC20Upgradeable.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {IERC4626} from "@openzeppelin/contracts/interfaces/IERC4626.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {Initializable} from "../../../proxy/utils/Initializable.sol";
/**
* @dev Implementation of the ERC4626 "Tokenized Vault Standard" as defined in
* https://eips.ethereum.org/EIPS/eip-4626[EIP-4626].
*
* This extension allows the minting and burning of "shares" (represented using the ERC20 inheritance) in exchange for
* underlying "assets" through standardized {deposit}, {mint}, {redeem} and {burn} workflows. This contract extends
* the ERC20 standard. Any additional extensions included along it would affect the "shares" token represented by this
* contract and not the "assets" token which is an independent contract.
*
* [CAUTION]
* ====
* In empty (or nearly empty) ERC-4626 vaults, deposits are at high risk of being stolen through frontrunning
* with a "donation" to the vault that inflates the price of a share. This is variously known as a donation or inflation
* attack and is essentially a problem of slippage. Vault deployers can protect against this attack by making an initial
* deposit of a non-trivial amount of the asset, such that price manipulation becomes infeasible. Withdrawals may
* similarly be affected by slippage. Users can protect against this attack as well as unexpected slippage in general by
* verifying the amount received is as expected, using a wrapper that performs these checks such as
* https://github.com/fei-protocol/ERC4626#erc4626router-and-base[ERC4626Router].
*
* Since v4.9, this implementation uses virtual assets and shares to mitigate that risk. The `_decimalsOffset()`
* corresponds to an offset in the decimal representation between the underlying asset's decimals and the vault
* decimals. This offset also determines the rate of virtual shares to virtual assets in the vault, which itself
* determines the initial exchange rate. While not fully preventing the attack, analysis shows that the default offset
* (0) makes it non-profitable, as a result of the value being captured by the virtual shares (out of the attacker's
* donation) matching the attacker's expected gains. With a larger offset, the attack becomes orders of magnitude more
* expensive than it is profitable. More details about the underlying math can be found
* xref:erc4626.adoc#inflation-attack[here].
*
* The drawback of this approach is that the virtual shares do capture (a very small) part of the value being accrued
* to the vault. Also, if the vault experiences losses, the users try to exit the vault, the virtual shares and assets
* will cause the first user to exit to experience reduced losses in detriment to the last users that will experience
* bigger losses. Developers willing to revert back to the pre-v4.9 behavior just need to override the
* `_convertToShares` and `_convertToAssets` functions.
*
* To learn more, check out our xref:ROOT:erc4626.adoc[ERC-4626 guide].
* ====
*/
abstract contract ERC4626Upgradeable is Initializable, ERC20Upgradeable, IERC4626 {
using Math for uint256;
/// @custom:storage-location erc7201:openzeppelin.storage.ERC4626
struct ERC4626Storage {
IERC20 _asset;
uint8 _underlyingDecimals;
}
// keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ERC4626")) - 1)) & ~bytes32(uint256(0xff))
bytes32 private constant ERC4626StorageLocation = 0x0773e532dfede91f04b12a73d3d2acd361424f41f76b4fb79f090161e36b4e00;
function _getERC4626Storage() private pure returns (ERC4626Storage storage $) {
assembly {
$.slot := ERC4626StorageLocation
}
}
/**
* @dev Attempted to deposit more assets than the max amount for `receiver`.
*/
error ERC4626ExceededMaxDeposit(address receiver, uint256 assets, uint256 max);
/**
* @dev Attempted to mint more shares than the max amount for `receiver`.
*/
error ERC4626ExceededMaxMint(address receiver, uint256 shares, uint256 max);
/**
* @dev Attempted to withdraw more assets than the max amount for `receiver`.
*/
error ERC4626ExceededMaxWithdraw(address owner, uint256 assets, uint256 max);
/**
* @dev Attempted to redeem more shares than the max amount for `receiver`.
*/
error ERC4626ExceededMaxRedeem(address owner, uint256 shares, uint256 max);
/**
* @dev Set the underlying asset contract. This must be an ERC20-compatible contract (ERC20 or ERC777).
*/
function __ERC4626_init(IERC20 asset_) internal onlyInitializing {
__ERC4626_init_unchained(asset_);
}
function __ERC4626_init_unchained(IERC20 asset_) internal onlyInitializing {
ERC4626Storage storage $ = _getERC4626Storage();
(bool success, uint8 assetDecimals) = _tryGetAssetDecimals(asset_);
$._underlyingDecimals = success ? assetDecimals : 18;
$._asset = asset_;
}
/**
* @dev Attempts to fetch the asset decimals. A return value of false indicates that the attempt failed in some way.
*/
function _tryGetAssetDecimals(IERC20 asset_) private view returns (bool, uint8) {
(bool success, bytes memory encodedDecimals) = address(asset_).staticcall(
abi.encodeCall(IERC20Metadata.decimals, ())
);
if (success && encodedDecimals.length >= 32) {
uint256 returnedDecimals = abi.decode(encodedDecimals, (uint256));
if (returnedDecimals <= type(uint8).max) {
return (true, uint8(returnedDecimals));
}
}
return (false, 0);
}
/**
* @dev Decimals are computed by adding the decimal offset on top of the underlying asset's decimals. This
* "original" value is cached during construction of the vault contract. If this read operation fails (e.g., the
* asset has not been created yet), a default of 18 is used to represent the underlying asset's decimals.
*
* See {IERC20Metadata-decimals}.
*/
function decimals() public view virtual override(IERC20Metadata, ERC20Upgradeable) returns (uint8) {
ERC4626Storage storage $ = _getERC4626Storage();
return $._underlyingDecimals + _decimalsOffset();
}
/** @dev See {IERC4626-asset}. */
function asset() public view virtual returns (address) {
ERC4626Storage storage $ = _getERC4626Storage();
return address($._asset);
}
/** @dev See {IERC4626-totalAssets}. */
function totalAssets() public view virtual returns (uint256) {
ERC4626Storage storage $ = _getERC4626Storage();
return $._asset.balanceOf(address(this));
}
/** @dev See {IERC4626-convertToShares}. */
function convertToShares(uint256 assets) public view virtual returns (uint256) {
return _convertToShares(assets, Math.Rounding.Floor);
}
/** @dev See {IERC4626-convertToAssets}. */
function convertToAssets(uint256 shares) public view virtual returns (uint256) {
return _convertToAssets(shares, Math.Rounding.Floor);
}
/** @dev See {IERC4626-maxDeposit}. */
function maxDeposit(address) public view virtual returns (uint256) {
return type(uint256).max;
}
/** @dev See {IERC4626-maxMint}. */
function maxMint(address) public view virtual returns (uint256) {
return type(uint256).max;
}
/** @dev See {IERC4626-maxWithdraw}. */
function maxWithdraw(address owner) public view virtual returns (uint256) {
return _convertToAssets(balanceOf(owner), Math.Rounding.Floor);
}
/** @dev See {IERC4626-maxRedeem}. */
function maxRedeem(address owner) public view virtual returns (uint256) {
return balanceOf(owner);
}
/** @dev See {IERC4626-previewDeposit}. */
function previewDeposit(uint256 assets) public view virtual returns (uint256) {
return _convertToShares(assets, Math.Rounding.Floor);
}
/** @dev See {IERC4626-previewMint}. */
function previewMint(uint256 shares) public view virtual returns (uint256) {
return _convertToAssets(shares, Math.Rounding.Ceil);
}
/** @dev See {IERC4626-previewWithdraw}. */
function previewWithdraw(uint256 assets) public view virtual returns (uint256) {
return _convertToShares(assets, Math.Rounding.Ceil);
}
/** @dev See {IERC4626-previewRedeem}. */
function previewRedeem(uint256 shares) public view virtual returns (uint256) {
return _convertToAssets(shares, Math.Rounding.Floor);
}
/** @dev See {IERC4626-deposit}. */
function deposit(uint256 assets, address receiver) public virtual returns (uint256) {
uint256 maxAssets = maxDeposit(receiver);
if (assets > maxAssets) {
revert ERC4626ExceededMaxDeposit(receiver, assets, maxAssets);
}
uint256 shares = previewDeposit(assets);
_deposit(_msgSender(), receiver, assets, shares);
return shares;
}
/** @dev See {IERC4626-mint}.
*
* As opposed to {deposit}, minting is allowed even if the vault is in a state where the price of a share is zero.
* In this case, the shares will be minted without requiring any assets to be deposited.
*/
function mint(uint256 shares, address receiver) public virtual returns (uint256) {
uint256 maxShares = maxMint(receiver);
if (shares > maxShares) {
revert ERC4626ExceededMaxMint(receiver, shares, maxShares);
}
uint256 assets = previewMint(shares);
_deposit(_msgSender(), receiver, assets, shares);
return assets;
}
/** @dev See {IERC4626-withdraw}. */
function withdraw(uint256 assets, address receiver, address owner) public virtual returns (uint256) {
uint256 maxAssets = maxWithdraw(owner);
if (assets > maxAssets) {
revert ERC4626ExceededMaxWithdraw(owner, assets, maxAssets);
}
uint256 shares = previewWithdraw(assets);
_withdraw(_msgSender(), receiver, owner, assets, shares);
return shares;
}
/** @dev See {IERC4626-redeem}. */
function redeem(uint256 shares, address receiver, address owner) public virtual returns (uint256) {
uint256 maxShares = maxRedeem(owner);
if (shares > maxShares) {
revert ERC4626ExceededMaxRedeem(owner, shares, maxShares);
}
uint256 assets = previewRedeem(shares);
_withdraw(_msgSender(), receiver, owner, assets, shares);
return assets;
}
/**
* @dev Internal conversion function (from assets to shares) with support for rounding direction.
*/
function _convertToShares(uint256 assets, Math.Rounding rounding) internal view virtual returns (uint256) {
return assets.mulDiv(totalSupply() + 10 ** _decimalsOffset(), totalAssets() + 1, rounding);
}
/**
* @dev Internal conversion function (from shares to assets) with support for rounding direction.
*/
function _convertToAssets(uint256 shares, Math.Rounding rounding) internal view virtual returns (uint256) {
return shares.mulDiv(totalAssets() + 1, totalSupply() + 10 ** _decimalsOffset(), rounding);
}
/**
* @dev Deposit/mint common workflow.
*/
function _deposit(address caller, address receiver, uint256 assets, uint256 shares) internal virtual {
ERC4626Storage storage $ = _getERC4626Storage();
// If _asset is ERC777, `transferFrom` can trigger a reentrancy BEFORE the transfer happens through the
// `tokensToSend` hook. On the other hand, the `tokenReceived` hook, that is triggered after the transfer,
// calls the vault, which is assumed not malicious.
//
// Conclusion: we need to do the transfer before we mint so that any reentrancy would happen before the
// assets are transferred and before the shares are minted, which is a valid state.
// slither-disable-next-line reentrancy-no-eth
SafeERC20.safeTransferFrom($._asset, caller, address(this), assets);
_mint(receiver, shares);
emit Deposit(caller, receiver, assets, shares);
}
/**
* @dev Withdraw/redeem common workflow.
*/
function _withdraw(
address caller,
address receiver,
address owner,
uint256 assets,
uint256 shares
) internal virtual {
ERC4626Storage storage $ = _getERC4626Storage();
if (caller != owner) {
_spendAllowance(owner, caller, shares);
}
// If _asset is ERC777, `transfer` can trigger a reentrancy AFTER the transfer happens through the
// `tokensReceived` hook. On the other hand, the `tokensToSend` hook, that is triggered before the transfer,
// calls the vault, which is assumed not malicious.
//
// Conclusion: we need to do the transfer after the burn so that any reentrancy would happen after the
// shares are burned and after the assets are transferred, which is a valid state.
_burn(owner, shares);
SafeERC20.safeTransfer($._asset, receiver, assets);
emit Withdraw(caller, receiver, owner, assets, shares);
}
function _decimalsOffset() internal view virtual returns (uint8) {
return 0;
}
}// 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) (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) (access/Ownable.sol)
pragma solidity ^0.8.20;
import {ContextUpgradeable} from "../utils/ContextUpgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* The initial owner is set to the address provided by the deployer. This can
* later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {
/// @custom:storage-location erc7201:openzeppelin.storage.Ownable
struct OwnableStorage {
address _owner;
}
// keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Ownable")) - 1)) & ~bytes32(uint256(0xff))
bytes32 private constant OwnableStorageLocation = 0x9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300;
function _getOwnableStorage() private pure returns (OwnableStorage storage $) {
assembly {
$.slot := OwnableStorageLocation
}
}
/**
* @dev The caller account is not authorized to perform an operation.
*/
error OwnableUnauthorizedAccount(address account);
/**
* @dev The owner is not a valid owner account. (eg. `address(0)`)
*/
error OwnableInvalidOwner(address owner);
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the address provided by the deployer as the initial owner.
*/
function __Ownable_init(address initialOwner) internal onlyInitializing {
__Ownable_init_unchained(initialOwner);
}
function __Ownable_init_unchained(address initialOwner) internal onlyInitializing {
if (initialOwner == address(0)) {
revert OwnableInvalidOwner(address(0));
}
_transferOwnership(initialOwner);
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
OwnableStorage storage $ = _getOwnableStorage();
return $._owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
if (owner() != _msgSender()) {
revert OwnableUnauthorizedAccount(_msgSender());
}
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby disabling any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
if (newOwner == address(0)) {
revert OwnableInvalidOwner(address(0));
}
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
OwnableStorage storage $ = _getOwnableStorage();
address oldOwner = $._owner;
$._owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
}//SPDX-License-Identifier: AGPL-3.0 pragma solidity 0.8.24; uint256 constant MAX_BASIS_POINTS = 10_000; // Maximum basis points value uint256 constant PRECISION = 1e36; uint32 constant DUST = 1e8; uint32 constant ROUNDING_DELTA = 10; uint256 constant SECONDS_PER_YEAR = 365.25 days;
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/ERC20.sol)
pragma solidity ^0.8.20;
import {IERC20} from "./IERC20.sol";
import {IERC20Metadata} from "./extensions/IERC20Metadata.sol";
import {Context} from "../../utils/Context.sol";
import {IERC20Errors} from "../../interfaces/draft-IERC6093.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 ERC20 is Context, IERC20, IERC20Metadata, IERC20Errors {
mapping(address account => uint256) private _balances;
mapping(address account => mapping(address spender => uint256)) private _allowances;
uint256 private _totalSupply;
string private _name;
string private _symbol;
/**
* @dev Sets the values for {name} and {symbol}.
*
* All two of these values are immutable: they can only be set once during
* construction.
*/
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
}
/**
* @dev Returns the name of the token.
*/
function name() public view virtual returns (string memory) {
return _name;
}
/**
* @dev Returns the symbol of the token, usually a shorter version of the
* name.
*/
function symbol() public view virtual returns (string memory) {
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) {
return _totalSupply;
}
/**
* @dev See {IERC20-balanceOf}.
*/
function balanceOf(address account) public view virtual returns (uint256) {
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) {
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 {
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 {
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
// 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
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC4626.sol)
pragma solidity ^0.8.20;
import {IERC20} from "../token/ERC20/IERC20.sol";
import {IERC20Metadata} from "../token/ERC20/extensions/IERC20Metadata.sol";
/**
* @dev Interface of the ERC4626 "Tokenized Vault Standard", as defined in
* https://eips.ethereum.org/EIPS/eip-4626[ERC-4626].
*/
interface IERC4626 is IERC20, IERC20Metadata {
event Deposit(address indexed sender, address indexed owner, uint256 assets, uint256 shares);
event Withdraw(
address indexed sender,
address indexed receiver,
address indexed owner,
uint256 assets,
uint256 shares
);
/**
* @dev Returns the address of the underlying token used for the Vault for accounting, depositing, and withdrawing.
*
* - MUST be an ERC-20 token contract.
* - MUST NOT revert.
*/
function asset() external view returns (address assetTokenAddress);
/**
* @dev Returns the total amount of the underlying asset that is “managed” by Vault.
*
* - SHOULD include any compounding that occurs from yield.
* - MUST be inclusive of any fees that are charged against assets in the Vault.
* - MUST NOT revert.
*/
function totalAssets() external view returns (uint256 totalManagedAssets);
/**
* @dev Returns the amount of shares that the Vault would exchange for the amount of assets provided, in an ideal
* scenario where all the conditions are met.
*
* - MUST NOT be inclusive of any fees that are charged against assets in the Vault.
* - MUST NOT show any variations depending on the caller.
* - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.
* - MUST NOT revert.
*
* NOTE: This calculation MAY NOT reflect the “per-user” price-per-share, and instead should reflect the
* “average-user’s” price-per-share, meaning what the average user should expect to see when exchanging to and
* from.
*/
function convertToShares(uint256 assets) external view returns (uint256 shares);
/**
* @dev Returns the amount of assets that the Vault would exchange for the amount of shares provided, in an ideal
* scenario where all the conditions are met.
*
* - MUST NOT be inclusive of any fees that are charged against assets in the Vault.
* - MUST NOT show any variations depending on the caller.
* - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.
* - MUST NOT revert.
*
* NOTE: This calculation MAY NOT reflect the “per-user” price-per-share, and instead should reflect the
* “average-user’s” price-per-share, meaning what the average user should expect to see when exchanging to and
* from.
*/
function convertToAssets(uint256 shares) external view returns (uint256 assets);
/**
* @dev Returns the maximum amount of the underlying asset that can be deposited into the Vault for the receiver,
* through a deposit call.
*
* - MUST return a limited value if receiver is subject to some deposit limit.
* - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of assets that may be deposited.
* - MUST NOT revert.
*/
function maxDeposit(address receiver) external view returns (uint256 maxAssets);
/**
* @dev Allows an on-chain or off-chain user to simulate the effects of their deposit at the current block, given
* current on-chain conditions.
*
* - MUST return as close to and no more than the exact amount of Vault shares that would be minted in a deposit
* call in the same transaction. I.e. deposit should return the same or more shares as previewDeposit if called
* in the same transaction.
* - MUST NOT account for deposit limits like those returned from maxDeposit and should always act as though the
* deposit would be accepted, regardless if the user has enough tokens approved, etc.
* - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.
* - MUST NOT revert.
*
* NOTE: any unfavorable discrepancy between convertToShares and previewDeposit SHOULD be considered slippage in
* share price or some other type of condition, meaning the depositor will lose assets by depositing.
*/
function previewDeposit(uint256 assets) external view returns (uint256 shares);
/**
* @dev Mints shares Vault shares to receiver by depositing exactly amount of underlying tokens.
*
* - MUST emit the Deposit event.
* - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the
* deposit execution, and are accounted for during deposit.
* - MUST revert if all of assets cannot be deposited (due to deposit limit being reached, slippage, the user not
* approving enough underlying tokens to the Vault contract, etc).
*
* NOTE: most implementations will require pre-approval of the Vault with the Vault’s underlying asset token.
*/
function deposit(uint256 assets, address receiver) external returns (uint256 shares);
/**
* @dev Returns the maximum amount of the Vault shares that can be minted for the receiver, through a mint call.
* - MUST return a limited value if receiver is subject to some mint limit.
* - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of shares that may be minted.
* - MUST NOT revert.
*/
function maxMint(address receiver) external view returns (uint256 maxShares);
/**
* @dev Allows an on-chain or off-chain user to simulate the effects of their mint at the current block, given
* current on-chain conditions.
*
* - MUST return as close to and no fewer than the exact amount of assets that would be deposited in a mint call
* in the same transaction. I.e. mint should return the same or fewer assets as previewMint if called in the
* same transaction.
* - MUST NOT account for mint limits like those returned from maxMint and should always act as though the mint
* would be accepted, regardless if the user has enough tokens approved, etc.
* - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.
* - MUST NOT revert.
*
* NOTE: any unfavorable discrepancy between convertToAssets and previewMint SHOULD be considered slippage in
* share price or some other type of condition, meaning the depositor will lose assets by minting.
*/
function previewMint(uint256 shares) external view returns (uint256 assets);
/**
* @dev Mints exactly shares Vault shares to receiver by depositing amount of underlying tokens.
*
* - MUST emit the Deposit event.
* - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the mint
* execution, and are accounted for during mint.
* - MUST revert if all of shares cannot be minted (due to deposit limit being reached, slippage, the user not
* approving enough underlying tokens to the Vault contract, etc).
*
* NOTE: most implementations will require pre-approval of the Vault with the Vault’s underlying asset token.
*/
function mint(uint256 shares, address receiver) external returns (uint256 assets);
/**
* @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the
* Vault, through a withdraw call.
*
* - MUST return a limited value if owner is subject to some withdrawal limit or timelock.
* - MUST NOT revert.
*/
function maxWithdraw(address owner) external view returns (uint256 maxAssets);
/**
* @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block,
* given current on-chain conditions.
*
* - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw
* call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if
* called
* in the same transaction.
* - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though
* the withdrawal would be accepted, regardless if the user has enough shares, etc.
* - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.
* - MUST NOT revert.
*
* NOTE: any unfavorable discrepancy between convertToShares and previewWithdraw SHOULD be considered slippage in
* share price or some other type of condition, meaning the depositor will lose assets by depositing.
*/
function previewWithdraw(uint256 assets) external view returns (uint256 shares);
/**
* @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver.
*
* - MUST emit the Withdraw event.
* - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the
* withdraw execution, and are accounted for during withdraw.
* - MUST revert if all of assets cannot be withdrawn (due to withdrawal limit being reached, slippage, the owner
* not having enough shares, etc).
*
* Note that some implementations will require pre-requesting to the Vault before a withdrawal may be performed.
* Those methods should be performed separately.
*/
function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares);
/**
* @dev Returns the maximum amount of Vault shares that can be redeemed from the owner balance in the Vault,
* through a redeem call.
*
* - MUST return a limited value if owner is subject to some withdrawal limit or timelock.
* - MUST return balanceOf(owner) if owner is not subject to any withdrawal limit or timelock.
* - MUST NOT revert.
*/
function maxRedeem(address owner) external view returns (uint256 maxShares);
/**
* @dev Allows an on-chain or off-chain user to simulate the effects of their redeemption at the current block,
* given current on-chain conditions.
*
* - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call
* in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the
* same transaction.
* - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the
* redemption would be accepted, regardless if the user has enough shares, etc.
* - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.
* - MUST NOT revert.
*
* NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in
* share price or some other type of condition, meaning the depositor will lose assets by redeeming.
*/
function previewRedeem(uint256 shares) external view returns (uint256 assets);
/**
* @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver.
*
* - MUST emit the Withdraw event.
* - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the
* redeem execution, and are accounted for during redeem.
* - MUST revert if all of shares cannot be redeemed (due to withdrawal limit being reached, slippage, the owner
* not having enough shares, etc).
*
* NOTE: some implementations will require pre-requesting to the Vault before a withdrawal may be performed.
* Those methods should be performed separately.
*/
function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol)
pragma solidity ^0.8.20;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
/**
* @dev Returns the value of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the value of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves a `value` amount of tokens from the caller's account to `to`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address to, uint256 value) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets a `value` amount of tokens as the allowance of `spender` over the
* caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 value) external returns (bool);
/**
* @dev Moves a `value` amount of tokens from `from` to `to` using the
* allowance mechanism. `value` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 value) external returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/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.1) (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;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
}// SPDX-License-Identifier: AGPL-3.0
pragma solidity ^0.8.24;
/// @title Errors
/// @author Leonhard Horstmeyer
/// @notice Provides functions related to policy calculations
library Errors {
/// @notice Error message for the case when the price of the collateral token in the borrow token is zero
error PriceOfCollateralTokenInBorrowTokenIsZero();
/// @notice Error message for the case when the current supply in collateral is zero
error CurrentSupplyInCollateralZero();
/// @notice Error message for the case when the current ltv is zero
error CurrentLtvIsZero();
/// @notice Error message for the case when the current debt is zero
error CurrentDebtIsZero();
/// @notice Error message for the case when the price quote denomination is zero
error PriceQuoteDenominationIsZero();
/// @notice Error message for the case when the denomination is invalid
error InvalidDenomination();
/// @notice Error message for the case when the number of claims is zero
error ClaimsMustNotBeZero(uint8 number_of_claims);
/// @notice Error message for the case when the number of claims exceeds the total claims
error TooManyClaims(uint8 number_of_claims, uint8 total_claims);
/// @notice Error message for the case when the quartic polynomial evaluates to a positive value
error PositiveQuarticValue(int256 value);
error CollateralValueBelowDebtValue();
error RepaymentExceedsUserBorrowedAmount();
error RepaymentExceedsConcreteBorrowedAmount();
error WithdrawalExceedsUserSuppliedAmount();
error WithdrawalExceedsConcreteSuppliedAmount();
error ExceedsWadPrecision();
// ==== Encoding Protection Data ==============
error FractionExceedsUnityInMillionth();
error FractionExceedsUnityInBP();
error NumberOfProtectionClaimsTooHigh();
error OpeningFeeExceedsPromisedAmount();
error CancellationFeeExceedsPromisedAmount();
error TrancheAmountExceedsPromisedAmount(uint8 trancheNumber);
error TrancheFeeExceedsPromisedAmount(uint8 trancheNumber);
error InvalidTrancheNumber(uint8 trancheNumber);
error InvalidRightsEncoding(uint8 rights);
error ExceedsUint96MaxPrecision();
error InvalidProtectionEndTime();
error TrancheAmountsDoNotSumToPromisedAmount();
error AssetDivergence();
error PriceFeedNotSupportedErrorOnExternalOracle(address asset);
error InvalidMorphoRewardsReceiver();
error InvalidAmountType(uint8 amountType);
error AmountDiviatesTooMuch(uint256 providedAmount, uint256 actualAmount, uint256 wiggleFactor);
error TransferFailed(address token, address recipient, uint256 amount);
error ApprovalFailed(address token, address spender, uint256 amount);
}// 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: AGPL-3.0
pragma solidity ^0.8.0;
import {IERC4626} from "@openzeppelin/contracts/interfaces/IERC4626.sol";
/// @title Errors Interface
/// @notice Defines custom errors for the smart contract operations.
interface Errors {
/// @notice Error for invalid asset address.
error InvalidAssetAddress();
/// @notice Error for mismatch between vault's asset and expected asset.
error VaultAssetMismatch();
/// @notice Error for invalid vault fees configuration.
error InvalidVaultFees();
/// @notice Error for invalid fee recipient address.
error InvalidFeeRecipient();
/// @notice Error for invalid parking lot address.
error InvalidParkingLot();
/// @notice Error for operations involving a zero amount.
error ZeroAmount();
/// @notice Error for operations involving a zero amount.
error InvalidAmount();
/// @notice Error for invalid recipient address.
error InvalidRecipient();
/// @notice Error for exceeding maximum allowed value or count.
error MaxError();
/// @notice Error for exceeding substraction.
error InvalidSubstraction();
error WithdrawalsPaused();
/// @notice Error for insufficient funds in a strategy.
/// @param strategy The strategy contract with insufficient funds.
/// @param amount The amount attempted to be withdrawn.
/// @param available The available amount in the strategy.
error InsufficientFunds(IERC4626 strategy, uint256 amount, uint256 available);
error QueueNotSet();
error InsufficientQueueRequest(uint256 assets, uint256 minRequest);
error InsufficientVaultFunds(address vault, uint256 amount, uint256 available);
/// @notice Error for total allotment exceeding allowed maximum.
error AllotmentTotalTooHigh();
/// @notice Error for invalid allocation index.
/// @param index The index of the allocation.
/// @param expectedIndex The expected index of the allocation.
error InvalidAllocationIndex(uint256 index, uint256 expectedIndex);
/// @notice Error for expired permit deadline.
/// @param deadline The deadline timestamp that has been exceeded.
error PermitDeadlineExpired(uint256 deadline);
/// @notice Error for invalid signer address.
/// @param signer The address of the invalid signer.
error InvalidSigner(address signer);
/// @notice Error for vault being in an idle state when an active state is required.
error VaultIsIdle();
/// @notice Error for invalid implementation identifier.
/// @param id The bytes32 identifier of the implementation.
error InvalidImplementation(bytes32 id);
/// @notice Error for failed initialization of a vault deployment.
error VaultDeployInitFailed();
/// @notice Error for an implementation identifier that already exists.
/// @param id The bytes32 identifier of the existing implementation.
error ImplementationAlreadyExists(bytes32 id);
/// @notice Error for a non-existent implementation identifier.
/// @param id The bytes32 identifier of the non-existent implementation.
error ImplementationDoesNotExist(bytes32 id);
/// @notice Error for attempting to add a vault that already exists.
error VaultAlreadyExists();
/// @notice error when the vault address is the zero address
error VaultZeroAddress();
error VaultNotUpgradeable();
/// @notice error when the vaultAddress does not exist
/// @param vault the address of the vault
error VaultDoesNotExist(address vault);
/// @notice error for the total vaults allowed is exceeded
/// @param total the total number of vaults if the addVault function is successful
error TotalVaultsAllowedExceeded(uint256 total);
/// @notice error for vault to token limit check
/// @param token the address of the token to add to vault mapping
/// @param total the total number of vaults if the addVault function is successful
error VaultByTokenLimitExceeded(address token, uint256 total);
/// @notice error for invalid withdrawl queue address (zero address)
error InvalidWithdrawlQueue();
/// @notice error for beneficiary address check is not zero address
error InvalidBeneficiary();
/// @notice error for zero deposit limit check
error InvalidDepositLimit();
/// @notice error when setting new withdrawl queue to check if the old withdrawl queue is unfinalized
/// @param queue the address of the withdrawl queue
error UnfinalizedWithdrawal(address queue);
/// @notice error for invalid token address
error InvalidToken();
/// @notice error for invalid rescuer address
error InvalidRescuer();
/// @notice error for ERC20 approve fail
error ERC20ApproveFail();
/// @notice error for vesting period check
error NotPassedYear();
/// @notice error for reward token address is zero address
error InvalidRewardTokenAddress();
/// @notice error for reward token already approved
error RewardTokenAlreadyApproved();
/// @notice error for reward token not approved
error RewardTokenNotApproved();
/// @notice error for checking a new reward token to be added to the strategy
/// @notice a new reward token must have accumulated fee accounted as zero
error AccumulatedFeeAccountedMustBeZero();
/// @notice error for checking the vault must have only one protect strategy
error MultipleProtectStrat();
/// @notice error for checking the strategy has no locked assets (before removing strategy)
/// @param strategy the address of the strategy
error StrategyHasLockedAssets(address strategy);
/// @notice error for checking the strategy index is out of bounds
/// @param index the index of the strategy
error InvalidIndex(uint256 index);
/// @notice error for checking the length of the arrays
/// @param argLength the length of the allocations array
/// @param expectedLength the expected length of the strategies array
error InvalidLength(uint256 argLength, uint256 expectedLength);
// TokenRegistry errors /////////////////////////////////////////////////
/// @notice Error for a token already being registered.
/// @param tokenAddress The address of the token.
error TokenAlreadyRegistered(address tokenAddress);
/// @notice Error for a token not being registered.
/// @param tokenAddress The address of the token.
error TokenNotRegistered(address tokenAddress);
/// @notice Error for a token not being a reward token.
/// @param tokenAddress The address of the token.
error NotValidRewardToken(address tokenAddress);
/// @notice Treasury on the TokenRegistry is already set.
error TreasuryAlreadySet(address attacker);
/// @notice Unregistered tokens cannot be rewards.
/// @param tokenAddress The address of the token.
error UnregisteredTokensCannotBeRewards(address tokenAddress);
/// @notice Error for a the treasury to be set to the zero address on constructor.
error InvalidTreasuryAddress();
// Swapper errors //////////////////////////////////////////////////////
/// @notice The amount of a reward token is not available for withdrawal.
/// @param token The address of the reward token.
/// @param amount The amount required.
error NotAvailableForWithdrawal(address token, uint256 amount);
/// @notice The treasury change request cooldown has not elapsed.
/// @param sender The address of the sender.
error TreasuryChangeRequestCooldownNotElapsed(address sender);
// RewardManager errors /////////////////////////////////////////////////
/// @notice The base reward rate must be less than 100%.
error SwapperBaseRewardrate();
/// @notice The maximum progression factor must be less than 100%.
error SwapperMaxProgressionFactor();
/// @notice The bonus reward rate for the user must be less than 100%.
error SwapperBonusRewardrateUser();
/// @notice The bonus reward rate for the ctToken must be less than 100%.
error SwapperBonusRewardrateCtToken();
/// @notice The bonus reward rate for the swap token must be less than 100%.
error SwapperBonusRewardrateSwapToken();
/// @notice Invalid Address
error InvalidUserAddress();
//Oracle plug
/// @notice Invalid Token Registry Address
error InvalidTokenRegistry();
//Claim Router errors //////////////////////////////////////////////////
/// @notice error for invalid vault registry address
error InvalidVaultRegistry();
/// @notice error for unauthorized account
error BlueprintUnauthorizedAccount(address account);
/// @notice error for invalid default admin address
error InvalidDefaultAdminAddress();
/// @notice error for no protection strategies found
error NoProtectionStrategiesFound();
/// @notice error for only vault caller
error OnlyVault(address caller);
//Protect strategy errors ///////////////////////////////////////////////
/// @notice error for unauthorized account
error ProtectUnauthorizedAccount(address account);
/// @notice error for claim router is unauthorized account
error ClaimRouterUnauthorizedAccount(address account);
/// @notice error for claim router address is zero address
error InvalidClaimRouterAddress();
//MultiSigStrategy
/// @notice error for unauthorized multi-sig account
error MultiSigUnauthorizedAccount(address account);
/// @notice Thrown when attempting to initialize with zero address for multi-sig
error InvalidMultiSigAddress();
/// @notice Thrown when attempting to withdraw when withdraw is disabled
error WithdrawDisabled();
/// @notice Thrown when deposit fails
error DepositFailed();
/// @notice Thrown when attempting to initialize with zero address for target vault
error InvalidTargetVaultAddress();
/// @notice Thrown when attempting to withdraw more than the available balance
error InsufficientUnderlyingBalance();
// Whitelist errors //////////////////////////////////////////////////////
/// @notice Thrown when attempting to add a non-whitelisted address to the whitelist
error UserNotWhitelisted(address user_);
/// @notice Thrown when attempting to add an already whitelisted address to the whitelist
error UserAlreadyWhitelisted(address user_);
/// @notice Thrown when attempting to call whitelist functions when whitelist is disabled
error WhitelistDisabled();
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/ERC4626.sol)
pragma solidity ^0.8.20;
import {IERC20, IERC20Metadata, ERC20} from "../ERC20.sol";
import {SafeERC20} from "../utils/SafeERC20.sol";
import {IERC4626} from "../../../interfaces/IERC4626.sol";
import {Math} from "../../../utils/math/Math.sol";
/**
* @dev Implementation of the ERC4626 "Tokenized Vault Standard" as defined in
* https://eips.ethereum.org/EIPS/eip-4626[EIP-4626].
*
* This extension allows the minting and burning of "shares" (represented using the ERC20 inheritance) in exchange for
* underlying "assets" through standardized {deposit}, {mint}, {redeem} and {burn} workflows. This contract extends
* the ERC20 standard. Any additional extensions included along it would affect the "shares" token represented by this
* contract and not the "assets" token which is an independent contract.
*
* [CAUTION]
* ====
* In empty (or nearly empty) ERC-4626 vaults, deposits are at high risk of being stolen through frontrunning
* with a "donation" to the vault that inflates the price of a share. This is variously known as a donation or inflation
* attack and is essentially a problem of slippage. Vault deployers can protect against this attack by making an initial
* deposit of a non-trivial amount of the asset, such that price manipulation becomes infeasible. Withdrawals may
* similarly be affected by slippage. Users can protect against this attack as well as unexpected slippage in general by
* verifying the amount received is as expected, using a wrapper that performs these checks such as
* https://github.com/fei-protocol/ERC4626#erc4626router-and-base[ERC4626Router].
*
* Since v4.9, this implementation uses virtual assets and shares to mitigate that risk. The `_decimalsOffset()`
* corresponds to an offset in the decimal representation between the underlying asset's decimals and the vault
* decimals. This offset also determines the rate of virtual shares to virtual assets in the vault, which itself
* determines the initial exchange rate. While not fully preventing the attack, analysis shows that the default offset
* (0) makes it non-profitable, as a result of the value being captured by the virtual shares (out of the attacker's
* donation) matching the attacker's expected gains. With a larger offset, the attack becomes orders of magnitude more
* expensive than it is profitable. More details about the underlying math can be found
* xref:erc4626.adoc#inflation-attack[here].
*
* The drawback of this approach is that the virtual shares do capture (a very small) part of the value being accrued
* to the vault. Also, if the vault experiences losses, the users try to exit the vault, the virtual shares and assets
* will cause the first user to exit to experience reduced losses in detriment to the last users that will experience
* bigger losses. Developers willing to revert back to the pre-v4.9 behavior just need to override the
* `_convertToShares` and `_convertToAssets` functions.
*
* To learn more, check out our xref:ROOT:erc4626.adoc[ERC-4626 guide].
* ====
*/
abstract contract ERC4626 is ERC20, IERC4626 {
using Math for uint256;
IERC20 private immutable _asset;
uint8 private immutable _underlyingDecimals;
/**
* @dev Attempted to deposit more assets than the max amount for `receiver`.
*/
error ERC4626ExceededMaxDeposit(address receiver, uint256 assets, uint256 max);
/**
* @dev Attempted to mint more shares than the max amount for `receiver`.
*/
error ERC4626ExceededMaxMint(address receiver, uint256 shares, uint256 max);
/**
* @dev Attempted to withdraw more assets than the max amount for `receiver`.
*/
error ERC4626ExceededMaxWithdraw(address owner, uint256 assets, uint256 max);
/**
* @dev Attempted to redeem more shares than the max amount for `receiver`.
*/
error ERC4626ExceededMaxRedeem(address owner, uint256 shares, uint256 max);
/**
* @dev Set the underlying asset contract. This must be an ERC20-compatible contract (ERC20 or ERC777).
*/
constructor(IERC20 asset_) {
(bool success, uint8 assetDecimals) = _tryGetAssetDecimals(asset_);
_underlyingDecimals = success ? assetDecimals : 18;
_asset = asset_;
}
/**
* @dev Attempts to fetch the asset decimals. A return value of false indicates that the attempt failed in some way.
*/
function _tryGetAssetDecimals(IERC20 asset_) private view returns (bool, uint8) {
(bool success, bytes memory encodedDecimals) = address(asset_).staticcall(
abi.encodeCall(IERC20Metadata.decimals, ())
);
if (success && encodedDecimals.length >= 32) {
uint256 returnedDecimals = abi.decode(encodedDecimals, (uint256));
if (returnedDecimals <= type(uint8).max) {
return (true, uint8(returnedDecimals));
}
}
return (false, 0);
}
/**
* @dev Decimals are computed by adding the decimal offset on top of the underlying asset's decimals. This
* "original" value is cached during construction of the vault contract. If this read operation fails (e.g., the
* asset has not been created yet), a default of 18 is used to represent the underlying asset's decimals.
*
* See {IERC20Metadata-decimals}.
*/
function decimals() public view virtual override(IERC20Metadata, ERC20) returns (uint8) {
return _underlyingDecimals + _decimalsOffset();
}
/** @dev See {IERC4626-asset}. */
function asset() public view virtual returns (address) {
return address(_asset);
}
/** @dev See {IERC4626-totalAssets}. */
function totalAssets() public view virtual returns (uint256) {
return _asset.balanceOf(address(this));
}
/** @dev See {IERC4626-convertToShares}. */
function convertToShares(uint256 assets) public view virtual returns (uint256) {
return _convertToShares(assets, Math.Rounding.Floor);
}
/** @dev See {IERC4626-convertToAssets}. */
function convertToAssets(uint256 shares) public view virtual returns (uint256) {
return _convertToAssets(shares, Math.Rounding.Floor);
}
/** @dev See {IERC4626-maxDeposit}. */
function maxDeposit(address) public view virtual returns (uint256) {
return type(uint256).max;
}
/** @dev See {IERC4626-maxMint}. */
function maxMint(address) public view virtual returns (uint256) {
return type(uint256).max;
}
/** @dev See {IERC4626-maxWithdraw}. */
function maxWithdraw(address owner) public view virtual returns (uint256) {
return _convertToAssets(balanceOf(owner), Math.Rounding.Floor);
}
/** @dev See {IERC4626-maxRedeem}. */
function maxRedeem(address owner) public view virtual returns (uint256) {
return balanceOf(owner);
}
/** @dev See {IERC4626-previewDeposit}. */
function previewDeposit(uint256 assets) public view virtual returns (uint256) {
return _convertToShares(assets, Math.Rounding.Floor);
}
/** @dev See {IERC4626-previewMint}. */
function previewMint(uint256 shares) public view virtual returns (uint256) {
return _convertToAssets(shares, Math.Rounding.Ceil);
}
/** @dev See {IERC4626-previewWithdraw}. */
function previewWithdraw(uint256 assets) public view virtual returns (uint256) {
return _convertToShares(assets, Math.Rounding.Ceil);
}
/** @dev See {IERC4626-previewRedeem}. */
function previewRedeem(uint256 shares) public view virtual returns (uint256) {
return _convertToAssets(shares, Math.Rounding.Floor);
}
/** @dev See {IERC4626-deposit}. */
function deposit(uint256 assets, address receiver) public virtual returns (uint256) {
uint256 maxAssets = maxDeposit(receiver);
if (assets > maxAssets) {
revert ERC4626ExceededMaxDeposit(receiver, assets, maxAssets);
}
uint256 shares = previewDeposit(assets);
_deposit(_msgSender(), receiver, assets, shares);
return shares;
}
/** @dev See {IERC4626-mint}.
*
* As opposed to {deposit}, minting is allowed even if the vault is in a state where the price of a share is zero.
* In this case, the shares will be minted without requiring any assets to be deposited.
*/
function mint(uint256 shares, address receiver) public virtual returns (uint256) {
uint256 maxShares = maxMint(receiver);
if (shares > maxShares) {
revert ERC4626ExceededMaxMint(receiver, shares, maxShares);
}
uint256 assets = previewMint(shares);
_deposit(_msgSender(), receiver, assets, shares);
return assets;
}
/** @dev See {IERC4626-withdraw}. */
function withdraw(uint256 assets, address receiver, address owner) public virtual returns (uint256) {
uint256 maxAssets = maxWithdraw(owner);
if (assets > maxAssets) {
revert ERC4626ExceededMaxWithdraw(owner, assets, maxAssets);
}
uint256 shares = previewWithdraw(assets);
_withdraw(_msgSender(), receiver, owner, assets, shares);
return shares;
}
/** @dev See {IERC4626-redeem}. */
function redeem(uint256 shares, address receiver, address owner) public virtual returns (uint256) {
uint256 maxShares = maxRedeem(owner);
if (shares > maxShares) {
revert ERC4626ExceededMaxRedeem(owner, shares, maxShares);
}
uint256 assets = previewRedeem(shares);
_withdraw(_msgSender(), receiver, owner, assets, shares);
return assets;
}
/**
* @dev Internal conversion function (from assets to shares) with support for rounding direction.
*/
function _convertToShares(uint256 assets, Math.Rounding rounding) internal view virtual returns (uint256) {
return assets.mulDiv(totalSupply() + 10 ** _decimalsOffset(), totalAssets() + 1, rounding);
}
/**
* @dev Internal conversion function (from shares to assets) with support for rounding direction.
*/
function _convertToAssets(uint256 shares, Math.Rounding rounding) internal view virtual returns (uint256) {
return shares.mulDiv(totalAssets() + 1, totalSupply() + 10 ** _decimalsOffset(), rounding);
}
/**
* @dev Deposit/mint common workflow.
*/
function _deposit(address caller, address receiver, uint256 assets, uint256 shares) internal virtual {
// If _asset is ERC777, `transferFrom` can trigger a reentrancy BEFORE the transfer happens through the
// `tokensToSend` hook. On the other hand, the `tokenReceived` hook, that is triggered after the transfer,
// calls the vault, which is assumed not malicious.
//
// Conclusion: we need to do the transfer before we mint so that any reentrancy would happen before the
// assets are transferred and before the shares are minted, which is a valid state.
// slither-disable-next-line reentrancy-no-eth
SafeERC20.safeTransferFrom(_asset, caller, address(this), assets);
_mint(receiver, shares);
emit Deposit(caller, receiver, assets, shares);
}
/**
* @dev Withdraw/redeem common workflow.
*/
function _withdraw(
address caller,
address receiver,
address owner,
uint256 assets,
uint256 shares
) internal virtual {
if (caller != owner) {
_spendAllowance(owner, caller, shares);
}
// If _asset is ERC777, `transfer` can trigger a reentrancy AFTER the transfer happens through the
// `tokensReceived` hook. On the other hand, the `tokensToSend` hook, that is triggered before the transfer,
// calls the vault, which is assumed not malicious.
//
// Conclusion: we need to do the transfer after the burn so that any reentrancy would happen after the
// shares are burned and after the assets are transferred, which is a valid state.
_burn(owner, shares);
SafeERC20.safeTransfer(_asset, receiver, assets);
emit Withdraw(caller, receiver, owner, assets, shares);
}
function _decimalsOffset() internal view virtual returns (uint8) {
return 0;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Metadata.sol)
pragma solidity ^0.8.20;
import {IERC20} from "../IERC20.sol";
/**
* @dev Interface for the optional metadata functions from the ERC20 standard.
*/
interface IERC20Metadata is IERC20 {
/**
* @dev Returns the name of the token.
*/
function name() external view returns (string memory);
/**
* @dev Returns the symbol of the token.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the decimals places of the token.
*/
function decimals() external view returns (uint8);
}//SPDX-License-Identifier: AGPL-3.0
pragma solidity 0.8.24;
interface IWithdrawalQueue {
function requestWithdrawal(address recipient, uint256 amount) external;
function prepareWithdrawal(uint256 _requestId, uint256 _avaliableAssets)
external
returns (address recipient, uint256 amount, uint256 avaliableAssets);
function unfinalizedAmount() external view returns (uint256);
function getLastFinalizedRequestId() external view returns (uint256);
function getLastRequestId() external view returns (uint256);
//slither-disable-next-line naming-convention
function _finalize(uint256 _lastRequestIdToBeFinalized) external;
}//SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {IStrategy, ReturnedRewards} from "../interfaces/IStrategy.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {IERC4626, IERC20} from "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/ERC4626Upgradeable.sol";
import {Strategy} from "../interfaces/IConcreteMultiStrategyVault.sol";
import {IWithdrawalQueue} from "../interfaces/IWithdrawalQueue.sol";
import {MAX_BASIS_POINTS, DUST} from "../utils/Constants.sol";
import {Errors} from "../interfaces/Errors.sol";
library VaultActionsHelper {
using SafeERC20 for IERC20;
using Math for uint256;
uint256 private constant PRECISION = 1e36;
function getTotalAssets(uint256 total, Strategy[] memory strategies) public view returns (uint256) {
for (uint256 i; i < strategies.length;) {
//We control both the length of the array and the external call
//slither-disable-next-line calls-loop
total += strategies[i].strategy.convertToAssets(strategies[i].strategy.balanceOf(address(this)));
unchecked {
i++;
}
}
return total;
}
function getTotalSupply(uint256 total, IWithdrawalQueue withdrawalQueue) public view returns (uint256) {
uint256 unfinalized = 0;
if (address(withdrawalQueue) != address(0)) {
unfinalized = withdrawalQueue.unfinalizedAmount();
}
return total + unfinalized;
}
function validateRedeemParams(address receiver_, uint256 shares_, uint256 maxRedeem_) external pure {
if (receiver_ == address(0)) revert Errors.InvalidRecipient();
if (shares_ == 0) revert Errors.ZeroAmount();
if (shares_ > maxRedeem_) revert Errors.MaxError();
}
}// SPDX-License-Identifier: AGPL-3.0
pragma solidity 0.8.24;
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {Errors} from "./Errors.sol";
library TokenHelper {
///@notice Attempts to transfer tokens to a recipient, optionally revets on failure
///@param token The token to transfer (may also be invalid token address)
///@param recipient The recipient of the transfer
///@param amount The amount to transfer
///@param revertOnBadAttempt Whether to revert on a failed transfer
///@return successfullTransfer Whether the transfer was successful
function attemptSafeTransfer(address token, address recipient, uint256 amount, bool revertOnBadAttempt)
internal
returns (bool successfullTransfer)
{
successfullTransfer =
_callOptionalReturnBool(IERC20(token), abi.encodeWithSelector(IERC20.transfer.selector, recipient, amount));
if (!successfullTransfer && revertOnBadAttempt) {
revert Errors.TransferFailed(token, recipient, amount);
}
}
///@notice Attempts to approve a spender to transfer tokens, optionally revets on failure
///@param token The token to be approved (may also be invalid token address)
///@param spender The spender to be approved
///@param amount The amount to approve
///@param revertOnBadAttempt Whether to revert on a failed approval
///@return successfullApproval Whether the approval was successful
function attemptForceApprove(address token, address spender, uint256 amount, bool revertOnBadAttempt)
internal
returns (bool successfullApproval)
{
bytes memory approvalCall = abi.encodeWithSelector(IERC20.approve.selector, spender, amount);
successfullApproval = _callOptionalReturnBool(IERC20(token), approvalCall);
if (!successfullApproval) {
// attempt to reset the approval to zero
successfullApproval =
_callOptionalReturnBool(IERC20(token), abi.encodeWithSelector(IERC20.approve.selector, spender, 0));
if (successfullApproval) {
// attempt to set the approval to the desired amount
successfullApproval = _callOptionalReturnBool(IERC20(token), approvalCall);
}
}
if (!successfullApproval && revertOnBadAttempt) {
revert Errors.ApprovalFailed(token, spender, amount);
}
}
// OPENZEPPELIN SAFE ERC20 HELPER FUNCTIONS ///////////////////////////////
/**
* @dev This code is taken from the SafeERC20 library of OpenZeppelin Contracts v5.1.0
* https://github.com/OpenZeppelin/openzeppelin-contracts/blob/v5.1.0/contracts/token/ERC20/utils/SafeERC20.sol
* @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 silently catches all reverts and returns a bool instead.
*/
function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {
bool success;
uint256 returnSize;
uint256 returnValue;
assembly ("memory-safe") {
success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)
returnSize := returndatasize()
returnValue := mload(0)
}
return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/Pausable.sol)
pragma solidity ^0.8.20;
import {ContextUpgradeable} from "../utils/ContextUpgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";
/**
* @dev Contract module which allows children to implement an emergency stop
* mechanism that can be triggered by an authorized account.
*
* This module is used through inheritance. It will make available the
* modifiers `whenNotPaused` and `whenPaused`, which can be applied to
* the functions of your contract. Note that they will not be pausable by
* simply including this module, only once the modifiers are put in place.
*/
abstract contract PausableUpgradeable is Initializable, ContextUpgradeable {
/// @custom:storage-location erc7201:openzeppelin.storage.Pausable
struct PausableStorage {
bool _paused;
}
// keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Pausable")) - 1)) & ~bytes32(uint256(0xff))
bytes32 private constant PausableStorageLocation = 0xcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f03300;
function _getPausableStorage() private pure returns (PausableStorage storage $) {
assembly {
$.slot := PausableStorageLocation
}
}
/**
* @dev Emitted when the pause is triggered by `account`.
*/
event Paused(address account);
/**
* @dev Emitted when the pause is lifted by `account`.
*/
event Unpaused(address account);
/**
* @dev The operation failed because the contract is paused.
*/
error EnforcedPause();
/**
* @dev The operation failed because the contract is not paused.
*/
error ExpectedPause();
/**
* @dev Initializes the contract in unpaused state.
*/
function __Pausable_init() internal onlyInitializing {
__Pausable_init_unchained();
}
function __Pausable_init_unchained() internal onlyInitializing {
PausableStorage storage $ = _getPausableStorage();
$._paused = false;
}
/**
* @dev Modifier to make a function callable only when the contract is not paused.
*
* Requirements:
*
* - The contract must not be paused.
*/
modifier whenNotPaused() {
_requireNotPaused();
_;
}
/**
* @dev Modifier to make a function callable only when the contract is paused.
*
* Requirements:
*
* - The contract must be paused.
*/
modifier whenPaused() {
_requirePaused();
_;
}
/**
* @dev Returns true if the contract is paused, and false otherwise.
*/
function paused() public view virtual returns (bool) {
PausableStorage storage $ = _getPausableStorage();
return $._paused;
}
/**
* @dev Throws if the contract is paused.
*/
function _requireNotPaused() internal view virtual {
if (paused()) {
revert EnforcedPause();
}
}
/**
* @dev Throws if the contract is not paused.
*/
function _requirePaused() internal view virtual {
if (!paused()) {
revert ExpectedPause();
}
}
/**
* @dev Triggers stopped state.
*
* Requirements:
*
* - The contract must not be paused.
*/
function _pause() internal virtual whenNotPaused {
PausableStorage storage $ = _getPausableStorage();
$._paused = true;
emit Paused(_msgSender());
}
/**
* @dev Returns to normal state.
*
* Requirements:
*
* - The contract must be paused.
*/
function _unpause() internal virtual whenPaused {
PausableStorage storage $ = _getPausableStorage();
$._paused = false;
emit Unpaused(_msgSender());
}
}// 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: AGPL-3.0
pragma solidity 0.8.24;
import {IStrategy} from "./IStrategy.sol";
// Example performanceFee: [{0000, 500, 300}, {501, 2000, 1000}, {2001, 5000, 2000}, {5001, 10000, 5000}]
// == 0-5% increase 3%, 5.01-20% increase 10%, 20.01-50% increase 20%, 50.01-100% increase 50%
struct GraduatedFee {
uint256 lowerBound;
uint256 upperBound;
uint64 fee;
}
///@notice VaultFees are represented in BPS
///@dev all downstream math needs to be / 10_000 because 10_000 bps == 100%
struct VaultFees {
uint64 depositFee;
uint64 withdrawalFee;
uint64 protocolFee;
GraduatedFee[] performanceFee;
}
struct Allocation {
uint256 index;
uint256 amount; // Represented in BPS of the amount of ETF that should go into strategy
}
struct Strategy {
IStrategy strategy;
Allocation allocation;
}
struct VaultInitParams {
address feeRecipient;
VaultFees fees;
uint256 depositLimit;
address owner;
}
interface IConcreteMultiStrategyVault {
event FeeRecipientUpdated(address indexed oldRecipient, address indexed newRecipient);
event ParkingLotUpdated(address indexed oldParkingLot, address indexed newParkingLot, bool successfulApproval);
event ToggleVaultIdle(bool pastValue, bool newValue);
event StrategyAdded(address newStrategy);
event StrategyRemoved(address oldStrategy);
event DepositLimitSet(uint256 limit);
event StrategyAllocationsChanged(Allocation[] newAllocations);
event WithdrawalQueueUpdated(address oldQueue, address newQueue);
event WithdrawalPausedToggled(bool pastValue, bool newValue);
event IsQueueMandatoryUpdated(bool pastValue, bool newValue);
function pause() external;
function unpause() external;
function setVaultFees(VaultFees calldata newFees_) external;
function setFeeRecipient(address newRecipient_) external;
function toggleVaultIdle() external;
function addStrategy(uint256 index_, bool replace_, Strategy calldata newStrategy_) external;
function removeStrategy(uint256 index_) external;
function emergencyRemoveStrategy(uint256 index_, bool forceEject_) external;
function changeAllocations(Allocation[] calldata allocations_, bool redistribute_) external;
function setDepositLimit(uint256 limit_) external;
function pushFundsToStrategies() external;
function pushFundsIntoSingleStrategy(uint256 index_, uint256 amount) external;
function pushFundsIntoSingleStrategy(uint256 index_) external;
function pullFundsFromStrategies() external;
function pullFundsFromSingleStrategy(uint256 index_) external;
function protectStrategy() external view returns (address);
function getAvailableAssetsForWithdrawal() external view returns (uint256);
function requestFunds(uint256 amount_) external;
function setWithdrawalQueue(address withdrawalQueue_) external;
function setParkingLot(address parkingLot_) external;
function batchClaimWithdrawal(uint256 maxRequests) external;
function harvestRewards(bytes calldata encodedData) external;
function setMinimunQueueRequest(uint256 minQueueRequest_) external;
function isUpgradeable() external pure returns (bool);
function toggleWithdrawalsPaused(bool withdrawalsPaused_) external;
function takePortfolioAndProtocolFees() external;
function setWhitelistEnabled(bool whitelistEnabled_) external;
function addToWhitelist(address user_) external;
function removeFromWhitelist(address user_) external;
function isWhitelisted(address user_) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)
pragma solidity ^0.8.20;
/**
* @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 Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
}//SPDX-License-Identifier: AGPL-3.0
pragma solidity 0.8.24;
interface IParkingLot {
function deposit(address recipient, uint256 amount) external;
}// 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: GPL-3.0
pragma solidity 0.8.24;
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {SECONDS_PER_YEAR, MAX_BASIS_POINTS} from "../utils/Constants.sol";
import {VaultFees, GraduatedFee} from "../interfaces/IConcreteMultiStrategyVault.sol";
import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol";
library FeesHelper {
using Math for uint256;
function accruedProtocolFee(uint256 protocolFee_, uint256 totalAssets_, uint256 feesUpdatedAt_)
external
view
returns (uint256)
{
// Only calculate if a protocol fee is set
if (protocolFee_ > 0) {
// Calculate the fee based on time elapsed and total assets, using floor rounding for precision
return protocolFee_.mulDiv(
totalAssets_ * (block.timestamp - feesUpdatedAt_), SECONDS_PER_YEAR, Math.Rounding.Floor
) / 10000; // Normalize the fee percentage
} else {
return 0;
}
}
function accruedPerformanceFee(
GraduatedFee[] memory performanceFee_,
uint256 totalAssets_,
uint256 shareValue_,
uint256 highWaterMark_,
address asset_,
VaultFees storage fees_
) external view returns (uint256 fee) {
if (performanceFee_.length > 0 && shareValue_ > highWaterMark_) {
fee =
calculateTieredFee(shareValue_, highWaterMark_, totalAssets_, fees_, IERC20Metadata(asset_).decimals());
}
}
/// @notice Calculates the tiered fee based on share value and high water mark.
/// @param shareValue The current value of a share in assets.
/// @param highWaterMark The high water mark for performance fee calculation.
/// @param totalAssets The total assets in the vault.
/// @param fees The fee structure containing performance fee tiers.
/// @return fee The calculated performance fee.
/// @dev This function Must only be called when the share value strictly exceeds the high water mark.
function calculateTieredFee(
uint256 shareValue,
uint256 highWaterMark,
uint256 totalAssets,
VaultFees storage fees,
uint256 underlayingDecimals
) public view returns (uint256 fee) {
if (shareValue <= highWaterMark) return 0;
uint256 excessAboveHighWaterMark = shareValue - highWaterMark;
// Calculate the percentage difference (diff) between share value and high water mark
uint256 diff = uint256(excessAboveHighWaterMark.mulDiv(MAX_BASIS_POINTS, highWaterMark, Math.Rounding.Floor));
// Loop through performance fee tiers
uint256 len = fees.performanceFee.length;
if (len == 0) return 0;
for (uint256 i = 0; i < len;) {
if (diff <= fees.performanceFee[i].upperBound && diff >= fees.performanceFee[i].lowerBound) {
fee = ((shareValue - highWaterMark) * totalAssets).mulDiv(
fees.performanceFee[i].fee, MAX_BASIS_POINTS * shareValue, Math.Rounding.Floor
);
break; // Exit loop once the correct tier is found
}
unchecked {
i++;
}
}
}
}//SPDX-License-Identifier: AGPL-3.0
pragma solidity 0.8.24;
import {IStrategy} from "../interfaces/IStrategy.sol";
import {Strategy, Allocation} from "../interfaces/IConcreteMultiStrategyVault.sol";
import {IERC20} from "@openzeppelin/contracts/token/ERC20/extensions/ERC4626.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {MAX_BASIS_POINTS} from "../utils/Constants.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {Errors} from "../interfaces/Errors.sol";
library StrategyHelper {
using SafeERC20 for IERC20;
using Math for uint256;
/// @notice event for strategy allocations changed
event StrategyAllocationsChanged(Allocation[] allocations_);
/// @notice event for strategy removed
event StrategyRemoved(address strategy);
function emergencyRemoveStrategy(
Strategy[] storage strategies,
address asset,
uint256 index_,
bool forceEject_,
address protectStrategy_
) external returns (address protectStrategy) {
IStrategy stratToRemove = strategies[index_].strategy;
protectStrategy = _resetProtectStrategy(address(stratToRemove), protectStrategy_);
if (forceEject_) {
// Skip the locked assets check and asset redemption
// Reset allowance to zero for the strategy being removed
IERC20(asset).forceApprove(address(stratToRemove), 0);
// Remove strategy from array and emit event
_removeStrategyFromArray(index_, strategies);
emit StrategyRemoved(address(stratToRemove));
} else {
// Normal removal process
removeStrategy(strategies, index_, protectStrategy, IERC20(asset));
}
}
function changeAllocations(
Strategy[] storage strategies,
Allocation[] calldata allocations_,
bool redistribute,
address asset
) external {
uint256 len = allocations_.length;
if (len != strategies.length) {
revert Errors.InvalidLength(len, strategies.length);
}
uint256 allotmentTotals = 0;
for (uint256 i; i < len;) {
allotmentTotals += allocations_[i].amount;
strategies[i].allocation = allocations_[i];
unchecked {
i++;
}
}
if (allotmentTotals > 10000) revert Errors.AllotmentTotalTooHigh();
if (redistribute) {
pullFundsFromStrategies(strategies);
distributeAssetsToStrategies(strategies, IERC20(asset).balanceOf(address(this)));
}
emit StrategyAllocationsChanged(allocations_);
}
/**
* @notice Pulls funds back from all strategies into the vault.
* @dev Can only be called by the vault owner.
*/
// We are aware that we aren't using the return value
// We control both the length of the array and the external call
//slither-disable-next-line unused-return,calls-loop
function pullFundsFromStrategies(Strategy[] storage strategies) public {
uint256 len = strategies.length;
for (uint256 i; i < len;) {
pullFundsFromSingleStrategy(strategies, i);
unchecked {
i++;
}
}
}
function pullFundsFromSingleStrategy(Strategy[] storage strategies, uint256 index_) public {
IStrategy strategy = strategies[index_].strategy;
if (strategy.balanceOf(address(this)) == 0) return;
// slither-disable-next-line unused-return
if (strategy.getAvailableAssetsForWithdrawal() != strategy.totalAssets()) {
strategy.withdraw(strategy.getAvailableAssetsForWithdrawal(), address(this), address(this));
return;
}
strategy.redeem(strategy.balanceOf(address(this)), address(this), address(this));
}
function pushFundsIntoSingleStrategyNoAmount(
Strategy[] storage strategies,
uint256 totalAssets,
uint256 index_,
bool vaultIdle
) external {
if (index_ >= strategies.length) revert Errors.InvalidIndex(index_);
if (vaultIdle) revert Errors.VaultIsIdle();
Strategy memory strategy = strategies[index_];
// slither-disable-next-line unused-return
strategy.strategy.deposit(
totalAssets.mulDiv(strategy.allocation.amount, MAX_BASIS_POINTS, Math.Rounding.Floor), address(this)
);
}
function pushFundsIntoSingleStrategy(
Strategy[] storage strategies,
bool vaultIdle,
uint256 balance,
uint256 index_,
uint256 amount
) external {
if (amount > balance) {
revert Errors.InsufficientVaultFunds(address(this), amount, balance);
}
if (vaultIdle) revert Errors.VaultIsIdle();
// slither-disable-next-line unused-return
strategies[index_].strategy.deposit(amount, address(this));
}
/// @notice Distributes assets to each strategy based on their allocation.
/// @param strategies The array of strategies, each with a specified allocation.
/// @param _totalAssets The total amount of assets to be distributed.
function distributeAssetsToStrategies(Strategy[] storage strategies, uint256 _totalAssets) public {
uint256 len = strategies.length;
for (uint256 i = 0; i < len;) {
// Calculate the amount to allocate to each strategy based on its allocation percentage
uint256 amountToDeposit =
_totalAssets.mulDiv(strategies[i].allocation.amount, MAX_BASIS_POINTS, Math.Rounding.Floor);
// Deposit the allocated amount into the strategy
strategies[i].strategy.deposit(amountToDeposit, address(this));
unchecked {
i++;
}
}
}
/// @notice Adds or replaces a strategy, ensuring allotment limits and setting protect strategy if needed.
/// @param strategies The storage array of current strategies.
/// @param newStrategy_ The new strategy to add or replace.
/// @param replace_ Boolean indicating if the strategy should replace an existing one.
/// @param index_ The index at which to replace the strategy if `replace_` is true.
/// @param protectStrategy The current protect strategy address, which may be updated.
/// @param asset The asset of the vault for approving the strategy.
/// @return protectStrategy The address of the new protect strategy.
/// @return newStrategyIfc The interface of the new strategy.
/// @return stratToBeReplacedIfc The interface of the strategy to be replaced. (could be empty if not replacing)
function addOrReplaceStrategy(
Strategy[] storage strategies,
Strategy memory newStrategy_,
bool replace_,
uint256 index_,
address protectStrategy_,
IERC20 asset
) public returns (address protectStrategy, IStrategy newStrategyIfc, IStrategy stratToBeReplacedIfc) {
// Calculate total allotments of current strategies
uint256 allotmentTotals = _getTotalAllotment(strategies);
// Adding or replacing strategy based on `replace_` flag
if (replace_) {
if (index_ >= strategies.length) revert Errors.InvalidIndex(index_);
// Ensure replacing doesn't exceed total allotment limit
if (
allotmentTotals - strategies[index_].allocation.amount + newStrategy_.allocation.amount
> MAX_BASIS_POINTS
) {
revert Errors.AllotmentTotalTooHigh();
}
// Replace the strategy at `index_`
stratToBeReplacedIfc = strategies[index_].strategy;
protectStrategy = _resetProtectStrategy(address(stratToBeReplacedIfc), protectStrategy_);
_resetStrategy(stratToBeReplacedIfc, asset);
strategies[index_] = newStrategy_;
// Ensure the strategy is at the correct index
if (newStrategy_.allocation.index != index_) {
newStrategy_.allocation.index = index_;
}
} else {
protectStrategy = protectStrategy_;
// Ensure adding new strategy doesn't exceed total allotment limit
if (allotmentTotals + newStrategy_.allocation.amount > MAX_BASIS_POINTS) {
revert Errors.AllotmentTotalTooHigh();
}
// Add the new strategy to the array
strategies.push(newStrategy_);
}
// Handle protect strategy assignment if applicable
if (newStrategy_.strategy.isProtectStrategy()) {
if (protectStrategy != address(0)) revert Errors.MultipleProtectStrat();
protectStrategy = address(newStrategy_.strategy);
}
// Approve the asset for the new strategy
asset.forceApprove(address(newStrategy_.strategy), type(uint256).max);
// Return the address of the new strategy
newStrategyIfc = newStrategy_.strategy;
}
/// @notice Removes a strategy, redeeming assets if necessary, and resets protect strategy if applicable.
/// @param strategies The storage array of current strategies.
/// @param index_ The index of the strategy to be removed.
/// @param protectStrategy_ The current protect strategy address, which may be updated.
/// @param asset The asset of the vault for resetting the allowance to the strategy.
/// @return protectStrategy The address of the removed strategy.
function removeStrategy(Strategy[] storage strategies, uint256 index_, address protectStrategy_, IERC20 asset)
public
returns (address protectStrategy)
{
IStrategy stratToBeRemoved_ = strategies[index_].strategy;
protectStrategy = _resetProtectStrategy(address(stratToBeRemoved_), protectStrategy_);
_resetStrategy(stratToBeRemoved_, asset);
_removeStrategyFromArray(index_, strategies);
emit StrategyRemoved(address(stratToBeRemoved_));
}
function _resetStrategy(IStrategy strategy_, IERC20 asset) internal {
// Check and redeem assets if not locked
if (strategy_.getAvailableAssetsForWithdrawal() != strategy_.totalAssets()) {
revert Errors.StrategyHasLockedAssets(address(strategy_));
}
// Redeem all assets from the strategy if it has any assets
if (strategy_.totalAssets() > 0) {
strategy_.redeem(strategy_.balanceOf(address(this)), address(this), address(this));
}
// Reset allowance to zero for the strategy
asset.forceApprove(address(strategy_), 0);
}
function _removeStrategyFromArray(uint256 index_, Strategy[] storage strategies) internal {
uint256 lastIndex = strategies.length - 1;
if (index_ != lastIndex) {
strategies[index_] = strategies[lastIndex];
strategies[index_].allocation.index = index_;
}
strategies.pop();
}
function _getTotalAllotment(Strategy[] memory strategies) internal view returns (uint256 allotmentTotals) {
uint256 len = strategies.length;
for (uint256 i; i < len;) {
allotmentTotals += strategies[i].allocation.amount;
unchecked {
++i;
}
}
}
function _resetProtectStrategy(address strategyAddress, address protectStrategy_) internal pure returns (address) {
// Reset protect strategy if the strategy being removed is the protect strategy
if (strategyAddress == protectStrategy_) {
return address(0);
}
return protectStrategy_;
}
function withdrawFromStrategies(
Strategy[] memory strategies,
uint256 amount_,
uint256 float_,
address receiver_,
address vaultAddress
) external returns (uint256) {
uint256 diff = amount_ - float_;
uint256 len = strategies.length;
uint256 totalWithdrawn = 0;
for (uint256 i; i < len;) {
Strategy memory strategy = strategies[i];
//We control both the length of the array and the external call
//slither-disable-next-line calls-loop
uint256 withdrawable = strategy.strategy.previewRedeem(strategy.strategy.balanceOf(vaultAddress));
if (diff.mulDiv(strategy.allocation.amount, MAX_BASIS_POINTS, Math.Rounding.Ceil) > withdrawable) {
revert Errors.InsufficientFunds(strategy.strategy, diff * strategy.allocation.amount, withdrawable);
}
uint256 amountToWithdraw = amount_.mulDiv(strategy.allocation.amount, MAX_BASIS_POINTS, Math.Rounding.Ceil);
//We control both the length of the array and the external call
//slither-disable-next-line unused-return,calls-loop
strategy.strategy.withdraw(amountToWithdraw, receiver_, vaultAddress);
totalWithdrawn += amountToWithdraw;
unchecked {
i++;
}
}
return totalWithdrawn;
}
function depositIntoStrategies(
Strategy[] memory strategies,
uint256 assets_,
address vaultAddress,
bool isRoundingFloor
) external {
Math.Rounding rounding = isRoundingFloor ? Math.Rounding.Floor : Math.Rounding.Ceil;
uint256 len = strategies.length;
for (uint256 i; i < len;) {
//We control both the length of the array and the external call
//slither-disable-next-line unused-return,calls-loop
strategies[i].strategy.deposit(
assets_.mulDiv(strategies[i].allocation.amount, MAX_BASIS_POINTS, rounding), vaultAddress
);
unchecked {
i++;
}
}
}
}//SPDX-License-Identifier: AGPL-3.0
pragma solidity 0.8.24;
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {MAX_BASIS_POINTS} from "../utils/Constants.sol";
import {VaultFees, Strategy} from "../interfaces/IConcreteMultiStrategyVault.sol";
import {IStrategy} from "../interfaces/IStrategy.sol";
import {Errors} from "../interfaces/Errors.sol";
library MultiStrategyVaultHelper {
using Math for uint256;
using SafeERC20 for IERC20;
/// @notice Initializes, validates, and approves the base asset for each strategy.
/// @param strategies_ The array of strategies to be initialized.
/// @param baseAsset_ The base asset (IERC20 token) for approval.
/// @param protectStrategy_ The address of the current protect strategy, if any.
/// @param strategies The storage array where validated strategies will be stored.
/// @return address The updated protect strategy address.
function initializeStrategies(
Strategy[] memory strategies_,
IERC20 baseAsset_,
address protectStrategy_,
Strategy[] storage strategies
) private returns (address) {
uint256 len = strategies_.length;
for (uint256 i = 0; i < len;) {
IStrategy currentStrategy = strategies_[i].strategy;
// Validate that the strategy asset matches the base asset
if (currentStrategy.asset() != address(baseAsset_)) {
revert Errors.VaultAssetMismatch();
}
// Check if the strategy is a protect strategy and ensure only one is allowed
if (currentStrategy.isProtectStrategy()) {
if (protectStrategy_ != address(0)) revert Errors.MultipleProtectStrat();
protectStrategy_ = address(currentStrategy);
}
// Add the validated strategy to the storage array
strategies.push(strategies_[i]);
// Approve the base asset for the strategy
baseAsset_.forceApprove(address(currentStrategy), type(uint256).max);
// Use unchecked increment to avoid gas cost for overflow checks (safe since len is controlled)
unchecked {
i++;
}
}
return protectStrategy_;
}
/// @notice Validates and assigns fee values from `fees_` to `fees`.
/// @param fees_ The input VaultFees structure containing fee values to validate and assign.
/// @param fees The storage VaultFees structure where validated fees will be stored.
function validateAndSetFees(VaultFees memory fees_, VaultFees storage fees) private {
// Validate basic fee values to ensure they don't exceed MAX_BASIS_POINTS
if (
fees_.depositFee >= MAX_BASIS_POINTS || fees_.withdrawalFee >= MAX_BASIS_POINTS
|| fees_.protocolFee >= MAX_BASIS_POINTS
) {
revert Errors.InvalidVaultFees();
}
// Assign validated fee values
fees.depositFee = fees_.depositFee;
fees.withdrawalFee = fees_.withdrawalFee;
fees.protocolFee = fees_.protocolFee;
// Copy the performanceFee array to storage with a loop
uint256 len = fees_.performanceFee.length;
for (uint256 i = 0; i < len;) {
fees.performanceFee.push(fees_.performanceFee[i]);
unchecked {
i++;
}
}
}
/**
* @notice Validates and initializes essential vault parameters, including the base asset, strategies, and fee structure.
* @dev Ensures the provided base asset address is valid, initializes strategies with allocations,
* adjusts decimals for the base asset, and validates and sets vault fees.
* Reverts if the base asset address is zero or if the fees or strategy allocations are invalid.
* @param baseAsset_ The IERC20 token that serves as the base asset of the vault.
* @param decimalOffset The offset to be added to the base asset's decimals to calculate vault decimals.
* @param strategies_ The array of strategies with allocation data to be initialized for the vault.
* @param protectStrategy_ The current protect strategy address, if any, to be used for specific operations.
* @param strategies The storage array where validated and initialized strategies will be stored.
* @param fees_ The memory VaultFees structure containing the initial fee values for the vault.
* @param fees The storage VaultFees structure where validated fees will be stored and used by the vault.
* @return protectStrategy The address of the protect strategy if set after initialization.
* @return decimals The calculated number of decimals for the vault based on the base asset and decimal offset.
* @custom:reverts InvalidAssetAddress if the base asset address is zero.
* @custom:reverts AllotmentTotalTooHigh if the total strategy allocations exceed 100%.
* @custom:reverts InvalidVaultFees if any fee value exceeds the maximum basis points allowed.
*/
function validateVaultParameters(
IERC20 baseAsset_,
uint8 decimalOffset,
Strategy[] memory strategies_,
address protectStrategy_,
Strategy[] storage strategies,
VaultFees memory fees_,
VaultFees storage fees
) public returns (address protectStrategy, uint8 decimals) {
if (address(baseAsset_) == address(0)) {
revert Errors.InvalidAssetAddress();
}
uint256 totalAllocation;
for (uint256 i = 0; i < strategies_.length;) {
totalAllocation += strategies_[i].allocation.amount;
unchecked {
i++;
}
}
if (totalAllocation > MAX_BASIS_POINTS) {
revert Errors.AllotmentTotalTooHigh();
}
protectStrategy = initializeStrategies(strategies_, baseAsset_, protectStrategy_, strategies);
decimals = IERC20Metadata(address(baseAsset_)).decimals() + decimalOffset;
validateAndSetFees(fees_, fees);
}
function withdrawAssets(address asset, uint256 amount, address protectStrategy, Strategy[] storage strategies)
public
returns (uint256)
{
uint256 availableAssets = IERC20(asset).balanceOf(address(this));
uint256 accumulated = availableAssets;
if (availableAssets < amount) {
// Calculate total allocation excluding protect strategy
uint256 totalAllocation = 0;
uint256 totalAvailable = 0;
for (uint256 i = 0; i < strategies.length; i++) {
if (address(strategies[i].strategy) != protectStrategy) {
totalAllocation += strategies[i].allocation.amount;
totalAvailable += strategies[i].strategy.getAvailableAssetsForWithdrawal();
}
}
// If we can't satisfy the request, return what we have
if (totalAvailable + availableAssets < amount) {
return accumulated + totalAvailable;
}
// withdraw proportionally
uint256 remainingToWithdraw = amount - availableAssets;
for (uint256 i = 0; i < strategies.length; i++) {
if (address(strategies[i].strategy) == protectStrategy) {
continue;
}
IStrategy currentStrategy = strategies[i].strategy;
uint256 availableInStrategy = currentStrategy.getAvailableAssetsForWithdrawal();
if (availableInStrategy == 0) {
continue;
}
// Calculate proportional withdrawal based on strategy's allocation
uint256 targetWithdraw =
remainingToWithdraw.mulDiv(strategies[i].allocation.amount, totalAllocation, Math.Rounding.Floor);
// Cap withdrawal at available amount
uint256 toWithdraw = Math.min(targetWithdraw, availableInStrategy);
if (toWithdraw > 0) {
currentStrategy.withdraw(toWithdraw, address(this), address(this));
accumulated += toWithdraw;
}
}
// If we still haven't met the target amount and have available funds,
// try to withdraw any remaining amount needed from strategies with remaining liquidity
if (accumulated < amount) {
uint256 stillNeeded = amount - accumulated;
for (uint256 i = 0; i < strategies.length && stillNeeded > 0; i++) {
if (address(strategies[i].strategy) == protectStrategy) {
continue;
}
IStrategy currentStrategy = strategies[i].strategy;
uint256 availableInStrategy = currentStrategy.getAvailableAssetsForWithdrawal();
if (availableInStrategy > 0) {
uint256 toWithdraw = Math.min(stillNeeded, availableInStrategy);
currentStrategy.withdraw(toWithdraw, address(this), address(this));
accumulated += toWithdraw;
stillNeeded -= toWithdraw;
}
}
}
}
return accumulated;
}
}//SPDX-License-Identifier: AGPL-3.0
pragma solidity 0.8.24;
import {IERC20} from "@openzeppelin/contracts/token/ERC20/extensions/ERC4626.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {ReturnedRewards} from "../interfaces/IStrategy.sol";
import {Math} from "@openzeppelin/contracts/utils/math/Math.sol";
import {TokenHelper} from "@blueprint-finance/hub-and-spokes-libraries/src/libraries/TokenHelper.sol";
import {PRECISION} from "../utils/Constants.sol";
library RewardsHelper {
using Math for uint256;
using SafeERC20 for IERC20;
/// @notice event for reward token added
event RewardTokenAdded(address token);
/// @notice event for reward token removed
event RewardTokenRemoved(address token);
/// @notice event for rewards claimed
event RewardsClaimed(address token, uint256 amount);
function getUserRewards(
uint256 userBalance,
address userAddress,
address[] memory rewardAddresses,
mapping(address => uint256) storage rewardIndex,
mapping(address => mapping(address => uint256)) storage userRewardIndex
) external view returns (ReturnedRewards[] memory) {
uint256 len = rewardAddresses.length;
ReturnedRewards[] memory returnedRewards = new ReturnedRewards[](len);
for (uint256 i; i < len;) {
uint256 tokenRewardIndex = rewardIndex[rewardAddresses[i]];
uint256 calculatedRewards = (tokenRewardIndex - userRewardIndex[userAddress][rewardAddresses[i]]).mulDiv(
userBalance, PRECISION, Math.Rounding.Floor
);
returnedRewards[i] = ReturnedRewards(rewardAddresses[i], calculatedRewards);
unchecked {
i++;
}
}
return returnedRewards;
}
function getTotalRewardsClaimed(
address[] storage rewardAddresses,
mapping(address => mapping(address => uint256)) storage totalRewardsClaimed,
address userAddress
) external view returns (ReturnedRewards[] memory claimedRewards) {
uint256 len = rewardAddresses.length;
claimedRewards = new ReturnedRewards[](len);
for (uint256 i; i < len;) {
claimedRewards[i] =
ReturnedRewards(rewardAddresses[i], totalRewardsClaimed[userAddress][rewardAddresses[i]]);
unchecked {
i++;
}
}
return claimedRewards;
}
function updateUserRewardsToCurrent(
uint256 userBalance_,
address userAddress_,
address[] memory rewardAddresses_,
mapping(address => uint256) storage rewardIndex_,
mapping(address => mapping(address => uint256)) storage userRewardIndex_,
mapping(address => mapping(address => uint256)) storage totalRewardsClaimed_
) external {
uint256 len = rewardAddresses_.length;
for (uint256 i; i < len;) {
uint256 tokenRewardIndex = rewardIndex_[rewardAddresses_[i]];
uint256 _userRewardIndex = userRewardIndex_[userAddress_][rewardAddresses_[i]];
userRewardIndex_[userAddress_][rewardAddresses_[i]] = tokenRewardIndex;
if (userBalance_ != 0) {
uint256 rewardsToTransfer =
(tokenRewardIndex - _userRewardIndex).mulDiv(userBalance_, PRECISION, Math.Rounding.Floor);
if (rewardsToTransfer != 0) {
TokenHelper.attemptSafeTransfer(
address(rewardAddresses_[i]), userAddress_, rewardsToTransfer, false
);
totalRewardsClaimed_[userAddress_][rewardAddresses_[i]] += rewardsToTransfer;
}
}
unchecked {
i++;
}
}
}
}//SPDX-License-Identifier: AGPL-3.0
pragma solidity 0.8.24;
import {IERC4626} from "@openzeppelin/contracts/token/ERC20/extensions/ERC4626.sol";
struct ReturnedRewards {
address rewardAddress;
uint256 rewardAmount;
}
interface IStrategy is IERC4626 {
function getAvailableAssetsForWithdrawal() external view returns (uint256);
function isProtectStrategy() external returns (bool);
function harvestRewards(bytes memory) external returns (ReturnedRewards[] memory);
}{
"evmVersion": "cancun",
"libraries": {
"node_modules/beacon-vaults-0.0.2/src/libraries/FeesHelper.sol": {
"FeesHelper": "0xF3670e6eaE0F3F19a5045Df3C5Ad3083C84A4780"
},
"node_modules/beacon-vaults-0.0.2/src/libraries/MultiStrategyVaultHelper.sol": {
"MultiStrategyVaultHelper": "0x70F2850F91d884b161740DB25C046a22Af641707"
},
"node_modules/beacon-vaults-0.0.2/src/libraries/RewardsHelper.sol": {
"RewardsHelper": "0x59DF83a2126D66F127B6b01d1Dfc3Ab9615f7518"
},
"node_modules/beacon-vaults-0.0.2/src/libraries/StrategyHelper.sol": {
"StrategyHelper": "0x30fbC520DA7Af7A1B1E16c882E3E43dbd5C3e72F"
},
"node_modules/beacon-vaults-0.0.2/src/libraries/VaultActions.sol": {
"VaultActionsHelper": "0x84CDC087BcD8F67F5DfF2e98beE11FF8AAa0f40C"
},
"node_modules/beacon-vaults-0.0.2/src/libraries/WithdrawalQueueHelper.sol": {
"WithdrawalQueueHelper": "0xeca5e1c4270c30DaAf9d33a9Ab24aBEd2f75E5f4"
},
"node_modules/beacon-vaults-0.0.3/src/libraries/FeesHelper.sol": {
"FeesHelper": "0x2a8Bc7De2Ca369ee0d2F183850Bd2BaF022290a3"
},
"node_modules/beacon-vaults-0.0.3/src/libraries/MultiStrategyVaultHelper.sol": {
"MultiStrategyVaultHelper": "0xb824F1c9bEEC8acC6c8Fc85a1DB3De8c9BdF0ed9"
},
"node_modules/beacon-vaults-0.0.3/src/libraries/RewardsHelper.sol": {
"RewardsHelper": "0xBeF2c40886E9077870853A7e367BAF2aD57E6305"
},
"node_modules/beacon-vaults-0.0.3/src/libraries/StrategyHelper.sol": {
"StrategyHelper": "0x407695283bCC9d92efbaF6F65Fe4373E2Cb2649e"
},
"node_modules/beacon-vaults-0.0.3/src/libraries/VaultActions.sol": {
"VaultActionsHelper": "0x466d6e33a42DCe4ab61C4E453cAf0e9CC6F1A966"
},
"node_modules/beacon-vaults-0.0.3/src/libraries/WithdrawalQueueHelper.sol": {
"WithdrawalQueueHelper": "0xb91CFCEa366E360f610a652Ee09a07D763CD5aFF"
},
"node_modules/earn-v1-release-0-5-1/src/libraries/FeesHelper.sol": {
"FeesHelper": "0x6a7bdC827eB3669AF20d3d55dcf3af1b5691Ea2E"
},
"node_modules/earn-v1-release-0-5-1/src/libraries/MultiStrategyVaultHelper.sol": {
"MultiStrategyVaultHelper": "0xFf1773d975Da0c000888C5715B7cf38968fF7819"
},
"node_modules/earn-v1-release-0-5-1/src/libraries/RewardsHelper.sol": {
"RewardsHelper": "0xF6880A04a5df3Ba54E5D196471927Daa4fCFc2D9"
},
"node_modules/earn-v1-release-0-5-1/src/libraries/StrategyHelper.sol": {
"StrategyHelper": "0x86d7F797636bD55fa3ad55B8C6954631c70C0F4e"
},
"node_modules/earn-v1-release-0-5-1/src/libraries/VaultActions.sol": {
"VaultActionsHelper": "0xE974c9E967E63701A889C7dEFBb49C6d7432475F"
},
"node_modules/earn-v1-release-0-5-1/src/libraries/WithdrawalQueueHelper.sol": {
"WithdrawalQueueHelper": "0xB64BD6df349823d883146980421c876FfA14E6D9"
}
},
"metadata": {
"appendCBOR": true,
"bytecodeHash": "ipfs",
"useLiteralContent": false
},
"optimizer": {
"enabled": true,
"runs": 200
},
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"remappings": [
"@openzeppelin/contracts/=node_modules/@openzeppelin/contracts/",
"@openzeppelin/contracts-upgradeable/=node_modules/@openzeppelin/contracts-upgradeable/",
"@blueprint-finance/=node_modules/@blueprint-finance/",
"@blueprint-finance/token-distribution-contracts/=node_modules/@blueprint-finance/token-distribution-contracts/",
"local/src/=src/",
"@morpho-org/=node_modules/@morpho-org/",
"@uniswap/=node_modules/@uniswap/",
"@layerzerolabs/lz-evm-oapp-v2/contracts/=node_modules/@layerzerolabs/lz-evm-oapp-v2/contracts/",
"@layerzerolabs/lz-evm-messagelib-v2/=node_modules/@layerzerolabs/lz-evm-messagelib-v2/",
"@layerzerolabs/lz-evm-protocol-v2/=node_modules/@layerzerolabs/lz-evm-protocol-v2/",
"@layerzerolabs/oapp-evm/contracts/=node_modules/@layerzerolabs/oapp-evm/contracts/",
"solidity-bytes-utils/=node_modules/solidity-bytes-utils/",
"base64-sol/=node_modules/base64-sol/",
"ds-test/=lib/forge-std/lib/ds-test/src/",
"earn-v1-vault-manager-v1/=node_modules/earn-v1-vault-manager-v1/",
"@blueprint-finance/multi-asset-vault/=node_modules/@blueprint-finance/multi-asset-vault/",
"@blueprint-finance/concrete-earn-beacon/=node_modules/@blueprint-finance/concrete-earn-beacon/",
"beacon-vaults-0.0.2/=node_modules/beacon-vaults-0.0.2/",
"beacon-vaults-0.0.3/=node_modules/beacon-vaults-0.0.3/",
"earn-v1-release-0-3-1/=node_modules/earn-v1-release-0-3-1/",
"earn-v1-release-0-3-12/=node_modules/earn-v1-release-0-3-12/",
"earn-v1-release-0-4-1/=node_modules/earn-v1-release-0-4-1/",
"earn-v1-release-0-5-1/=node_modules/earn-v1-release-0-5-1/",
"@gnosis.pm/safe-contracts/=node_modules/@gnosis.pm/safe-contracts/",
"eth-gas-reporter/=node_modules/eth-gas-reporter/",
"forge-std/=lib/forge-std/src/",
"hardhat/=node_modules/hardhat/",
"./=remappings.txt/"
],
"viaIR": true
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AccumulatedFeeAccountedMustBeZero","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":"AllotmentTotalTooHigh","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"ApprovalFailed","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"BlueprintUnauthorizedAccount","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"ClaimRouterUnauthorizedAccount","type":"error"},{"inputs":[],"name":"DepositFailed","type":"error"},{"inputs":[],"name":"ERC20ApproveFail","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"allowance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientAllowance","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC20InvalidApprover","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC20InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC20InvalidSender","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"}],"name":"ERC20InvalidSpender","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"uint256","name":"max","type":"uint256"}],"name":"ERC4626ExceededMaxDeposit","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"uint256","name":"max","type":"uint256"}],"name":"ERC4626ExceededMaxMint","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"uint256","name":"max","type":"uint256"}],"name":"ERC4626ExceededMaxRedeem","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"uint256","name":"max","type":"uint256"}],"name":"ERC4626ExceededMaxWithdraw","type":"error"},{"inputs":[],"name":"EnforcedPause","type":"error"},{"inputs":[],"name":"ExpectedPause","type":"error"},{"inputs":[],"name":"FailedInnerCall","type":"error"},{"inputs":[{"internalType":"bytes32","name":"id","type":"bytes32"}],"name":"ImplementationAlreadyExists","type":"error"},{"inputs":[{"internalType":"bytes32","name":"id","type":"bytes32"}],"name":"ImplementationDoesNotExist","type":"error"},{"inputs":[{"internalType":"contract IERC4626","name":"strategy","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"available","type":"uint256"}],"name":"InsufficientFunds","type":"error"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"uint256","name":"minRequest","type":"uint256"}],"name":"InsufficientQueueRequest","type":"error"},{"inputs":[],"name":"InsufficientUnderlyingBalance","type":"error"},{"inputs":[{"internalType":"address","name":"vault","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"available","type":"uint256"}],"name":"InsufficientVaultFunds","type":"error"},{"inputs":[{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"uint256","name":"expectedIndex","type":"uint256"}],"name":"InvalidAllocationIndex","type":"error"},{"inputs":[],"name":"InvalidAmount","type":"error"},{"inputs":[],"name":"InvalidAssetAddress","type":"error"},{"inputs":[],"name":"InvalidBeneficiary","type":"error"},{"inputs":[],"name":"InvalidClaimRouterAddress","type":"error"},{"inputs":[],"name":"InvalidDefaultAdminAddress","type":"error"},{"inputs":[],"name":"InvalidDepositLimit","type":"error"},{"inputs":[],"name":"InvalidFeeRecipient","type":"error"},{"inputs":[{"internalType":"bytes32","name":"id","type":"bytes32"}],"name":"InvalidImplementation","type":"error"},{"inputs":[{"internalType":"uint256","name":"index","type":"uint256"}],"name":"InvalidIndex","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[{"internalType":"uint256","name":"argLength","type":"uint256"},{"internalType":"uint256","name":"expectedLength","type":"uint256"}],"name":"InvalidLength","type":"error"},{"inputs":[],"name":"InvalidMultiSigAddress","type":"error"},{"inputs":[],"name":"InvalidParkingLot","type":"error"},{"inputs":[],"name":"InvalidRecipient","type":"error"},{"inputs":[],"name":"InvalidRescuer","type":"error"},{"inputs":[],"name":"InvalidRewardTokenAddress","type":"error"},{"inputs":[{"internalType":"address","name":"signer","type":"address"}],"name":"InvalidSigner","type":"error"},{"inputs":[],"name":"InvalidSubstraction","type":"error"},{"inputs":[],"name":"InvalidTargetVaultAddress","type":"error"},{"inputs":[],"name":"InvalidToken","type":"error"},{"inputs":[],"name":"InvalidTokenRegistry","type":"error"},{"inputs":[],"name":"InvalidTreasuryAddress","type":"error"},{"inputs":[],"name":"InvalidUserAddress","type":"error"},{"inputs":[],"name":"InvalidVaultFees","type":"error"},{"inputs":[],"name":"InvalidVaultRegistry","type":"error"},{"inputs":[],"name":"InvalidWithdrawlQueue","type":"error"},{"inputs":[],"name":"MathOverflowedMulDiv","type":"error"},{"inputs":[],"name":"MaxError","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"MultiSigUnauthorizedAccount","type":"error"},{"inputs":[],"name":"MultipleProtectStrat","type":"error"},{"inputs":[],"name":"NoProtectionStrategiesFound","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"NotAvailableForWithdrawal","type":"error"},{"inputs":[],"name":"NotInitializing","type":"error"},{"inputs":[],"name":"NotPassedYear","type":"error"},{"inputs":[{"internalType":"address","name":"tokenAddress","type":"address"}],"name":"NotValidRewardToken","type":"error"},{"inputs":[{"internalType":"address","name":"caller","type":"address"}],"name":"OnlyVault","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[{"internalType":"uint256","name":"deadline","type":"uint256"}],"name":"PermitDeadlineExpired","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"ProtectUnauthorizedAccount","type":"error"},{"inputs":[],"name":"QueueNotSet","type":"error"},{"inputs":[],"name":"ReentrancyGuardReentrantCall","type":"error"},{"inputs":[],"name":"RewardTokenAlreadyApproved","type":"error"},{"inputs":[],"name":"RewardTokenNotApproved","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"SafeERC20FailedOperation","type":"error"},{"inputs":[{"internalType":"address","name":"strategy","type":"address"}],"name":"StrategyHasLockedAssets","type":"error"},{"inputs":[],"name":"SwapperBaseRewardrate","type":"error"},{"inputs":[],"name":"SwapperBonusRewardrateCtToken","type":"error"},{"inputs":[],"name":"SwapperBonusRewardrateSwapToken","type":"error"},{"inputs":[],"name":"SwapperBonusRewardrateUser","type":"error"},{"inputs":[],"name":"SwapperMaxProgressionFactor","type":"error"},{"inputs":[{"internalType":"address","name":"tokenAddress","type":"address"}],"name":"TokenAlreadyRegistered","type":"error"},{"inputs":[{"internalType":"address","name":"tokenAddress","type":"address"}],"name":"TokenNotRegistered","type":"error"},{"inputs":[{"internalType":"uint256","name":"total","type":"uint256"}],"name":"TotalVaultsAllowedExceeded","type":"error"},{"inputs":[{"internalType":"address","name":"attacker","type":"address"}],"name":"TreasuryAlreadySet","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"TreasuryChangeRequestCooldownNotElapsed","type":"error"},{"inputs":[{"internalType":"address","name":"queue","type":"address"}],"name":"UnfinalizedWithdrawal","type":"error"},{"inputs":[{"internalType":"address","name":"tokenAddress","type":"address"}],"name":"UnregisteredTokensCannotBeRewards","type":"error"},{"inputs":[{"internalType":"address","name":"user_","type":"address"}],"name":"UserAlreadyWhitelisted","type":"error"},{"inputs":[{"internalType":"address","name":"user_","type":"address"}],"name":"UserNotWhitelisted","type":"error"},{"inputs":[],"name":"VaultAlreadyExists","type":"error"},{"inputs":[],"name":"VaultAssetMismatch","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"total","type":"uint256"}],"name":"VaultByTokenLimitExceeded","type":"error"},{"inputs":[],"name":"VaultDeployInitFailed","type":"error"},{"inputs":[{"internalType":"address","name":"vault","type":"address"}],"name":"VaultDoesNotExist","type":"error"},{"inputs":[],"name":"VaultIsIdle","type":"error"},{"inputs":[],"name":"VaultNotUpgradeable","type":"error"},{"inputs":[],"name":"VaultZeroAddress","type":"error"},{"inputs":[],"name":"WhitelistDisabled","type":"error"},{"inputs":[],"name":"WithdrawDisabled","type":"error"},{"inputs":[],"name":"WithdrawalsPaused","type":"error"},{"inputs":[],"name":"ZeroAmount","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"limit","type":"uint256"}],"name":"DepositLimitSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldRecipient","type":"address"},{"indexed":true,"internalType":"address","name":"newRecipient","type":"address"}],"name":"FeeRecipientUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultName","type":"address"},{"indexed":true,"internalType":"address","name":"underlyingAsset","type":"address"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"pastValue","type":"bool"},{"indexed":false,"internalType":"bool","name":"newValue","type":"bool"}],"name":"IsQueueMandatoryUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_oldMinQueueRequest","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_newMinQueueRequest","type":"uint256"}],"name":"MinimunQueueRequestUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldParkingLot","type":"address"},{"indexed":true,"internalType":"address","name":"newParkingLot","type":"address"},{"indexed":false,"internalType":"bool","name":"successfulApproval","type":"bool"}],"name":"ParkingLotUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"protectStrategy","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"RequestedFunds","type":"event"},{"anonymous":false,"inputs":[],"name":"RewardsHarvested","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"newStrategy","type":"address"}],"name":"StrategyAdded","type":"event"},{"anonymous":false,"inputs":[{"components":[{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"indexed":false,"internalType":"struct Allocation[]","name":"newAllocations","type":"tuple[]"}],"name":"StrategyAllocationsChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldStrategy","type":"address"}],"name":"StrategyRemoved","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"pastValue","type":"bool"},{"indexed":false,"internalType":"bool","name":"newValue","type":"bool"}],"name":"ToggleVaultIdle","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"}],"name":"UserAddedToWhitelist","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"}],"name":"UserRemovedFromWhitelist","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"oldWhitelistEnabled","type":"bool"},{"indexed":false,"internalType":"bool","name":"newWhitelistEnabled","type":"bool"}],"name":"WhitelistEnabledUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"pastValue","type":"bool"},{"indexed":false,"internalType":"bool","name":"newValue","type":"bool"}],"name":"WithdrawalPausedToggled","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldQueue","type":"address"},{"indexed":false,"internalType":"address","name":"newQueue","type":"address"}],"name":"WithdrawalQueueUpdated","type":"event"},{"inputs":[],"name":"accruedPerformanceFee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"accruedProtocolFee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"index_","type":"uint256"},{"internalType":"bool","name":"replace_","type":"bool"},{"components":[{"internalType":"contract IStrategy","name":"strategy","type":"address"},{"components":[{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"internalType":"struct Allocation","name":"allocation","type":"tuple"}],"internalType":"struct Strategy","name":"newStrategy_","type":"tuple"}],"name":"addStrategy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"user_","type":"address"}],"name":"addToWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"asset","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"maxRequests","type":"uint256"}],"name":"batchClaimWithdrawal","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"internalType":"struct Allocation[]","name":"allocations_","type":"tuple[]"},{"internalType":"bool","name":"redistribute","type":"bool"}],"name":"changeAllocations","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"claimRewards","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"name":"convertToAssets","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"convertToShares","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimalOffset","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets_","type":"uint256"},{"internalType":"address","name":"receiver_","type":"address"}],"name":"deposit","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets_","type":"uint256"}],"name":"deposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"depositLimit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"index_","type":"uint256"},{"internalType":"bool","name":"forceEject_","type":"bool"}],"name":"emergencyRemoveStrategy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"feeRecipient","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"feesUpdatedAt","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"firstDeposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getAvailableAssetsForWithdrawal","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getRewardTokens","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getStrategies","outputs":[{"components":[{"internalType":"contract IStrategy","name":"strategy","type":"address"},{"components":[{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"internalType":"struct Allocation","name":"allocation","type":"tuple"}],"internalType":"struct Strategy[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"userAddress","type":"address"}],"name":"getTotalRewardsClaimed","outputs":[{"components":[{"internalType":"address","name":"rewardAddress","type":"address"},{"internalType":"uint256","name":"rewardAmount","type":"uint256"}],"internalType":"struct ReturnedRewards[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"userAddress","type":"address"}],"name":"getUserRewards","outputs":[{"components":[{"internalType":"address","name":"rewardAddress","type":"address"},{"internalType":"uint256","name":"rewardAmount","type":"uint256"}],"internalType":"struct ReturnedRewards[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getVaultFees","outputs":[{"components":[{"internalType":"uint64","name":"depositFee","type":"uint64"},{"internalType":"uint64","name":"withdrawalFee","type":"uint64"},{"internalType":"uint64","name":"protocolFee","type":"uint64"},{"components":[{"internalType":"uint256","name":"lowerBound","type":"uint256"},{"internalType":"uint256","name":"upperBound","type":"uint256"},{"internalType":"uint64","name":"fee","type":"uint64"}],"internalType":"struct GraduatedFee[]","name":"performanceFee","type":"tuple[]"}],"internalType":"struct VaultFees","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes","name":"encodedData","type":"bytes"}],"name":"harvestRewards","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"highWaterMark","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC20","name":"baseAsset_","type":"address"},{"internalType":"string","name":"shareName_","type":"string"},{"internalType":"string","name":"shareSymbol_","type":"string"},{"components":[{"internalType":"contract IStrategy","name":"strategy","type":"address"},{"components":[{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"internalType":"struct Allocation","name":"allocation","type":"tuple"}],"internalType":"struct Strategy[]","name":"strategies_","type":"tuple[]"},{"internalType":"address","name":"feeRecipient_","type":"address"},{"components":[{"internalType":"uint64","name":"depositFee","type":"uint64"},{"internalType":"uint64","name":"withdrawalFee","type":"uint64"},{"internalType":"uint64","name":"protocolFee","type":"uint64"},{"components":[{"internalType":"uint256","name":"lowerBound","type":"uint256"},{"internalType":"uint256","name":"upperBound","type":"uint256"},{"internalType":"uint64","name":"fee","type":"uint64"}],"internalType":"struct GraduatedFee[]","name":"performanceFee","type":"tuple[]"}],"internalType":"struct VaultFees","name":"fees_","type":"tuple"},{"internalType":"uint256","name":"depositLimit_","type":"uint256"},{"internalType":"address","name":"owner_","type":"address"},{"internalType":"bool","name":"isQueueMandatory_","type":"bool"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"isQueueMandatory","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"isUpgradeable","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"user_","type":"address"}],"name":"isWhitelisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"maxDeposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"maxMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"maxRedeem","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"maxWithdraw","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"minQueueRequest","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares_","type":"uint256"},{"internalType":"address","name":"receiver_","type":"address"}],"name":"mint","outputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares_","type":"uint256"}],"name":"mint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"parkingLot","outputs":[{"internalType":"contract IParkingLot","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets_","type":"uint256"}],"name":"previewDeposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares_","type":"uint256"}],"name":"previewMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares_","type":"uint256"}],"name":"previewRedeem","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets_","type":"uint256"}],"name":"previewWithdraw","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"protectStrategy","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"index_","type":"uint256"}],"name":"pullFundsFromSingleStrategy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"pullFundsFromStrategies","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"index_","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"pushFundsIntoSingleStrategy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"index_","type":"uint256"}],"name":"pushFundsIntoSingleStrategy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"pushFundsToStrategies","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares_","type":"uint256"},{"internalType":"address","name":"receiver_","type":"address"},{"internalType":"address","name":"owner_","type":"address"}],"name":"redeem","outputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares_","type":"uint256"}],"name":"redeem","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"user_","type":"address"}],"name":"removeFromWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"index_","type":"uint256"}],"name":"removeStrategy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"requestFunds","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rewardIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"newLimit_","type":"uint256"}],"name":"setDepositLimit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newRecipient_","type":"address"}],"name":"setFeeRecipient","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_isQueueMandatory","type":"bool"}],"name":"setIsQueueMandatory","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"minQueueRequest_","type":"uint256"}],"name":"setMinimunQueueRequest","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"parkingLot_","type":"address"}],"name":"setParkingLot","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint64","name":"depositFee","type":"uint64"},{"internalType":"uint64","name":"withdrawalFee","type":"uint64"},{"internalType":"uint64","name":"protocolFee","type":"uint64"},{"components":[{"internalType":"uint256","name":"lowerBound","type":"uint256"},{"internalType":"uint256","name":"upperBound","type":"uint256"},{"internalType":"uint64","name":"fee","type":"uint64"}],"internalType":"struct GraduatedFee[]","name":"performanceFee","type":"tuple[]"}],"internalType":"struct VaultFees","name":"newFees_","type":"tuple"}],"name":"setVaultFees","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_whitelistEnabled","type":"bool"}],"name":"setWhitelistEnabled","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"withdrawalQueue_","type":"address"}],"name":"setWithdrawalQueue","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"takePortfolioAndProtocolFees","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"toggleVaultIdle","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"withdrawalsPaused_","type":"bool"}],"name":"toggleWithdrawalsPaused","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"totalAssets","outputs":[{"internalType":"uint256","name":"total","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"}],"name":"totalRewardsClaimed","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"total","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"}],"name":"userRewardIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"vaultIdle","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"whitelistEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"whitelisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets_","type":"uint256"}],"name":"withdraw","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets_","type":"uint256"},{"internalType":"address","name":"receiver_","type":"address"},{"internalType":"address","name":"owner_","type":"address"}],"name":"withdraw","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdrawalQueue","outputs":[{"internalType":"contract IWithdrawalQueue","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"withdrawalsPaused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"}]Contract Creation Code
60808060405234620000c0575f80557ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a009081549060ff8260401c16620000b157506001600160401b036002600160401b0319828216016200006b575b604051615f019081620000c58239f35b6001600160401b031990911681179091556040519081527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d290602090a15f80806200005b565b63f92ee8a960e01b8152600490fd5b5f80fdfe60806040526004361015610011575f80fd5b5f803560e01c806270e59514613ca557806301e1d11414613c8b578063052d9e7e14613c1c57806306fdde0314613b56578063078b0fb714613a8d57806307a2d13a14613a6f578063095ea7b3146139c05780630a28a4771461394d5780630c14935e14613933578063111c84531461390e5780631160265b146138ec57806313ee9df41461376657806318160ddd1461374c57806319e672461461372f5780631d2af0b9146136e25780631e8410da146136c557806323b872dd1461368d5780632a81196c1461327f5780632e1a7d4d1461325f578063313ce5671461323c57806332a8f9d4146127fc578063372500ab146127e357806337d5fe99146127bb57806337f1834e146127a157806338d52e0f1461276d5780633af32abf146127405780633f4ba83a14612630578063402d267d1461260d5780634657189914612536578063469048401461250e57806349d0ea97146124e65780634cdad506146124c857806351fb012d146124a65780635337e670146123dd57806355b8b781146122c857806359f7c8451461209e5780635c975abb1461206f57806366584f8c1461200e5780636bedc46c14611d805780636d3300e514611d135780636e2a6fe514611c9f5780636e553f6514611c7857806370a0823114611c33578063715018a614611bca57806372e7160114611b2657806375a046a514611aa6578063839e950f146119a65780638456cb59146118a857806388fba0661461182b5780638ab1d6811461178d5780638da5cb5b1461175857806394bf804d1461173157806395d89b411461164e5780639e2f0e22146116255780639f3d0a4814611607578063a039c129146115ba578063a0712d681461159a578063a5f5be541461157d578063a9059cbb1461154b578063acfd792814611530578063b39ed6d91461142d578063b3d7f6b9146113b2578063b3e3211414611379578063b45ba4a8146110ea578063b460af94146110d0578063b49a60bb14610fd2578063b6b55f2514610fb2578063ba08765214610f98578063bdc8144b14610f4a578063bf3bd25d14610df7578063c0cbbca614610c29578063c4f59f9b14610b63578063c63d75b614610b3f578063c6e6f59214610b20578063ce96cb7714610afc578063d1b39ae514610ae0578063d905777e14610abc578063d936547e14610a7d578063daa3a16314610a61578063db006a7514610a40578063dd62ed3e146109f8578063e43252d71461092e578063e74b981b146108ac578063e9f2838e14610886578063ecf7085814610868578063ef8b30f7146107fa578063f1f741b4146106b1578063f2fde38b14610684578063f4aa3efa1461044e5763f745d6ca146103f7575f80fd5b3461044b57602036600319011261044b57600435610413615078565b7f47ecb16e79d3795bad1b15b763dad4136c346b10a729a5e22a60ae3416b571ba6040600b548151908152836020820152a1600b5580f35b80fd5b503461044b57604036600319011261044b57600435906001600160401b038083116106805736602384011215610680578260040135908111610680573660248260061b85010111610680576104a1613db9565b6104a96153b8565b6104b1615078565b8254158015610671575b610668575b60ff5f80516020615e4c8339815191525416156105c3575b5f80516020615e0c833981519152547386d7f797636bd55fa3ad55b8c6954631c70c0f4e916001600160a01b0390911690823b156105bf5760405193632f42e93b60e21b85528060848601600660048801526080602488015252602460a48601970190865b81811061059f5750505091838086978194889615156044840152606483015203915af4801561059457610580575b5060015f80516020615e8c8339815191525580f35b61058990613f1c565b61044b57805f61056b565b6040513d84823e3d90fd5b82358952602080840135908a01526040988901989092019160010161053d565b8480fd5b6105dc6105ce614b56565b6105d66142dc565b9061449d565b6105e46150e3565b6105ec61409a565b90600254811161065f575b5081151580610656575b61060d575b50506104d8565b610633916106196143ff565b8061063e575090505b6005546001600160a01b03166154ba565b426004555f80610606565b61064b82610651946142cf565b91615b58565b610622565b50801515610601565b6002555f6105f7565b426004556104c0565b5061067a6143ff565b156104bb565b5080fd5b503461044b57602036600319011261044b576106ae6106a1613e15565b6106a9615078565b615007565b80f35b503461044b57602036600319011261044b576106cb615078565b6106d36153b8565b6009546001600160a01b03908116156107e85781906106f86106f36144aa565b61517b565b61070061409a565b916107096143ff565b6040519361071685613ee6565b84526020840190815260408401926009845273b64bd6df349823d883146980421c876ffa14e6d991836009541690845f80516020615e0c833981519152541694600a541690843b156107e457889660ff91604051998a988997889763408d459560e11b8952600489015260043560248901526044880152606487015261012060848701526107a76101248701614033565b9460a48701525160c48601525160e4850152511661010483015203915af4801561059457610580575060015f80516020615e8c8339815191525580f35b8880fd5b604051637c0c423f60e11b8152600490fd5b503461044b57602036600319011261044b5761085860209160043561081e8161517b565b6005549092906001600160a01b03163314610860575061084d610852916001600160401b0360075416906151ee565b615148565b906142cf565b604051908152f35b9050906142cf565b503461044b578060031936011261044b576020600354604051908152f35b503461044b578060031936011261044b57602060ff60055460a81c166040519015158152f35b503461044b57602036600319011261044b576108c6613e15565b6108ce615078565b6001600160a01b0390811690811561091c57816005549182167faaebcf1bfa00580e41d966056b48521fa9f202645c86d4ddf28113e617c1b1d38580a36001600160a01b0319161760055580f35b604051630ed1b8b360e31b8152600490fd5b503461044b57602036600319011261044b57610948613e15565b610950615078565b60ff60125416156109e6576001600160a01b031680156109d457808252601160205260ff6040832054166109bc57808252601160205260408220805460ff191660011790557f3ebdc59c5154f681813582b63e04d503c44f515f80fa2d558d663f4e3fdf508a8280a280f35b60249060405190634254a0ed60e01b82526004820152fd5b604051630702b3d960e41b8152600490fd5b60405163212c6e1d60e01b8152600490fd5b503461044b57604036600319011261044b57610a12613e15565b610a23610a1d613e2b565b91613e93565b9060018060a01b03165f52602052602060405f2054604051908152f35b503461044b57602036600319011261044b5760206108583333600435614d5a565b503461044b578060031936011261044b57602090604051908152f35b503461044b57602036600319011261044b5760209060ff906040906001600160a01b03610aa8613e15565b168152601184522054166040519015158152f35b503461044b57602036600319011261044b576020610858610adb613e15565b614f7a565b503461044b578060031936011261044b57602060405160098152f35b503461044b57602036600319011261044b576020610858610b1b613e15565b615895565b503461044b57602036600319011261044b57602061085860043561517b565b503461044b57602036600319011261044b576020610858610b5e613e15565b614f0e565b503461044b578060031936011261044b576040518091600c549081835260208093018092600c83527fdf6966c971051c3d54ec59162606531493a51404a002842f56009d7e5cf4a8c790835b818110610c0c5750505084610bc5910385613f2f565b60405193838594850191818652518092526040850193925b828110610bec57505050500390f35b83516001600160a01b031685528695509381019392810192600101610bdd565b82546001600160a01b031684529286019260019283019201610baf565b503461044b57602036600319011261044b57600435610c466153b8565b610c4e615078565b8154158015610de8575b610ddf575b60ff5f80516020615e4c833981519152541615610d7a575b600654811015610d62576001545f80516020615e0c8339815191525460405163266554c160e21b81526006600482015260248101939093526001600160a01b03918216604484015281166064830152906020816084817386d7f797636bd55fa3ad55b8c6954631c70c0f4e5af4908115610d57578391610d19575b50166001600160601b0360a01b600154161760015560015f80516020615e8c8339815191525580f35b90506020813d602011610d4f575b81610d3460209383613f2f565b81010312610d4b57610d459061401f565b5f610cf0565b8280fd5b3d9150610d27565b6040513d85823e3d90fd5b6024906040519063042a2e7160e11b82526004820152fd5b610d856105ce614b56565b610d8d6150e3565b610d9561409a565b906002548111610dd6575b5081151580610dcd575b610db6575b5050610c75565b610dc2916106196143ff565b426004555f80610daf565b50801515610daa565b6002555f610da0565b42600455610c5d565b50610df16143ff565b15610c58565b503461044b57602036600319011261044b576001546001600160a01b0390811690600435338303610f32578392825f80516020615e0c83398151915254169060405191630de492b960e11b8352600483015282602483015260448201526006606482015260208160848173ff1773d975da0c000888c5715b7cf38968ff78195af4908115610f27578491610eee575b5073b64bd6df349823d883146980421c876ffa14e6d9926001541692803b156105bf5784926064916040519586948593639db88c9360e01b85526004850152602484015260448301525af4801561059457610ede5750f35b610ee790613f1c565b61044b5780f35b9350506020833d602011610f1f575b81610f0a60209383613f2f565b81010312610f1b578392515f610e86565b5f80fd5b3d9150610efd565b6040513d86823e3d90fd5b6040516311dc66cd60e11b8152336004820152602490fd5b503461044b57602036600319011261044b577f5d2e73196f8ba1b44e887e2bcc9bcd1f3e657add341d4a0a632ffff00d6903f26020600435610f8a615078565b80600355604051908152a180f35b503461044b576020610858610fac36613fea565b91614d5a565b503461044b57602036600319011261044b576020610858336004356145d7565b503461044b578060031936011261044b57600654610fef81613fbf565b90610ffd6040519283613f2f565b8082526006835260209182810191845f80516020615e2c833981519152845b83831061107c57505050506040519280840191818552518092526040840192945b82811061104a5784840385f35b855180516001600160a01b0316855282015180518584015282015160408501529481019460609093019260010161103d565b60038760019260409a9997989a5161109381613f01565b848060a01b0386541681526040516110aa81613f01565b85870154815260028701548482015283820152815201920192019190969493959661101c565b503461044b5760206108586110e436613fea565b91614bc4565b503461044b5760a036600319011261044b57611104613db9565b6060366043190112610680576111186153b8565b611120615078565b815415801561136a575b611361575b60ff5f80516020615e4c8339815191525416156112fc575b6001545f80516020615e0c83398151915254604051630e1739ad60e31b815260066004820152926001600160a01b03929183169183169060443580851690819003610f1b576024860152606435604486015260843560648601521515608485015260043560a485015260c484015260e4830152606082610104817386d7f797636bd55fa3ad55b8c6954631c70c0f4e5af48015610d5757838493859261127a575b5091807f3f008fd510eae7a9e7bee13513d7b83bef8003d488b5a3d0b0da4de71d6846f1949281602095166001600160601b0360a01b6001541617600155168061124a575b5060405191168152a160015f80516020615e8c8339815191525580f35b837f09a1db4b80c32706328728508c941a6b954f31eb5affd32f236c1fd405f8fea491604051908152a15f61122d565b935050506060823d6060116112f4575b8161129760609383613f2f565b81010312610d4b5781816020926112ce7f3f008fd510eae7a9e7bee13513d7b83bef8003d488b5a3d0b0da4de71d6846f19561401f565b92816112e760406112e088850161401f565b930161401f565b94919650509193506111e8565b3d915061128a565b6113076105ce614b56565b61130f6150e3565b61131761409a565b906002548111611358575b508115158061134f575b611338575b5050611147565b611344916106196143ff565b426004555f80611331565b5080151561132c565b6002555f611322565b4260045561112f565b506113736143ff565b1561112a565b503461044b57602036600319011261044b576020906040906001600160a01b036113a1613e15565b168152600d83522054604051908152f35b503461044b57602036600319011261044b5760055460043591906001600160a01b031633036113e7575b602061085883615115565b906001600160401b0360075416916127109283039283116114195750611412602092610858926151ae565b91506113dc565b634e487b7160e01b81526011600452602490fd5b503461044b57602036600319011261044b57611447615078565b5f80516020615e0c833981519152546040516370a0823160e01b815230600482015282917386d7f797636bd55fa3ad55b8c6954631c70c0f4e9190602090829060249082906001600160a01b03165afa908115610d575783916114fb575b5060ff60055460a01c16823b156114f657608484926040519485938492633eb4e02160e11b84526006600485015260248401526004356044840152151560648301525af4801561059457610ede5750f35b505050fd5b9250506020823d602011611528575b8161151760209383613f2f565b81010312610f1b578291515f6114a5565b3d915061150a565b503461044b578060031936011261044b576020610858614b56565b503461044b57604036600319011261044b57611572611568613e15565b60243590336152ba565b602060405160018152f35b503461044b578060031936011261044b5760209054604051908152f35b503461044b57602036600319011261044b576020610858336004356148f0565b503461044b57604036600319011261044b576115d4613e15565b60406115de613e2b565b9260018060a01b038093168152600e6020522091165f52602052602060405f2054604051908152f35b503461044b578060031936011261044b576020600454604051908152f35b503461044b578060031936011261044b576001546040516001600160a01b039091168152602090f35b503461044b578060031936011261044b576040519080825f80516020615dac83398151915292835461167f8161418d565b93848452602095600192876001821691825f1461170d5750506001146116c7575b5050506116af92500383613f2f565b6116c3604051928284938452830190613dd7565b0390f35b8152859250905f80516020615e6c8339815191525b8583106116f55750506116af93508201015f80806116a0565b805483890185015287945086939092019181016116dc565b9350945050506116af94915060ff191682840152151560051b8201015f80806116a0565b503461044b57604036600319011261044b576020610858611750613e2b565b6004356148f0565b503461044b578060031936011261044b575f80516020615dcc833981519152546040516001600160a01b039091168152602090f35b503461044b57602036600319011261044b576117a7613e15565b6117af615078565b60ff60125416156109e6576001600160a01b03168082526011602052604082205460ff161561181357808252601160205260408220805460ff191690557fe285bb51ee9ef78b36fb9eca52aede9c9f4234d2bb72917200f87005edb25a558280a280f35b60249060405190632e6eba8560e11b82526004820152fd5b503461044b57602036600319011261044b577f522d3c2ddc88f29bac386c82e605c5bf322d91aa85997ef97a688539d9d6033360ff611868613dc8565b611870615078565b6118a2601054918381151516841984161760105560405193849316839092916020906040830194151583521515910152565b0390a180f35b503461044b578060031936011261044b578054158015611997575b61198e575b5f80516020615e4c83398151915260ff81541615611929575b6118e9615078565b6118f161554d565b600160ff198254161790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586020604051338152a180f35b6119346105ce614b56565b61193c6150e3565b61194461409a565b906002548111611985575b508115158061197c575b611965575b50506118e1565b611971916106196143ff565b426004555f8061195e565b50801515611959565b6002555f61194f565b426004556118c8565b506119a06143ff565b156118c3565b503461044b57604036600319011261044b576119c0615078565b807386d7f797636bd55fa3ad55b8c6954631c70c0f4e60ff60055460a01c166024602060018060a01b035f80516020615e0c8339815191525416604051928380926370a0823160e01b82523060048301525afa908115610f27578491611a71575b50823b156114f65760a4849260405194859384926312967a2960e31b845260066004850152151560248401526044830152600435606483015260243560848301525af4801561059457610ede5750f35b9350506020833d602011611a9e575b81611a8d60209383613f2f565b81010312610f1b578392515f611a21565b3d9150611a80565b503461044b57602036600319011261044b57611ac0613dc8565b611ac8615078565b6005546040805160ff60a884901c161515815283151560208201529192917ffdc806f366660aa3e77ed7f1da541577007de0e4b7e0c5d351ae99d2d01cc8f39190a160ff60a81b1990911690151560a81b60ff60a81b161760055580f35b503461044b57602036600319011261044b57611b40613e15565b604051630274467d60e11b8152600c6004820152600f60248201526001600160a01b039091166044820152818160648173f6880a04a5df3ba54e5d196471927daa4fcfc2d95af490811561059457826116c39392611ba7575b505060405191829182613e41565b611bc392503d8091833e611bbb8183613f2f565b8101906141c5565b5f80611b99565b503461044b578060031936011261044b57611be3615078565b5f80516020615dcc83398151915280546001600160a01b031981169091555f906001600160a01b03167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08280a380f35b503461044b57602036600319011261044b576020906040906001600160a01b03611c5b613e15565b1681525f80516020615d8c83398151915283522054604051908152f35b503461044b57604036600319011261044b576020610858611c97613e2b565b6004356145d7565b503461044b578060031936011261044b57611cb8615078565b6005546040805160ff60a084901c16158015825260208201819052917f40f0175b5fde6802a96ba1ba9eeaaa9564b53a1c021b6fcde51422b574abcdbd91a160ff60a01b1990911660a09190911b60ff60a01b161760055580f35b503461044b57602036600319011261044b57611d2d615078565b807386d7f797636bd55fa3ad55b8c6954631c70c0f4e803b15611d7d57816044916040519283809263dd40c63b60e01b82526006600483015260043560248301525af4801561059457610ede5750f35b50fd5b503461044b57602090600319602081360112610680576001600160401b0390600435828111611f8d57608081360392830112611f8d578354158015611fff575b611ff6575b60ff5f80516020615e4c833981519152541615611f91575b611de5615078565b82611df2826004016145c3565b16600754906fffffffffffffffff0000000000000000611e14602485016145c3565b60401b169067ffffffffffffffff60801b611e31604486016145c3565b60801b16926001600160401b0360c01b1617171760075560648101359160221901821215611f8d570190600482013591818311611f8d5760240160609060608402360381136105bf57600160401b8411611f795760085484600855808510611ef9575b506008855284925f80516020615dec833981519152915b858510611eba57864260045580f35b600384826001933586558a810135848701556002860185611edd604084016145c3565b166001600160401b031982541617905501930194019391611eab565b60039080600302906003820403611f655785600302600381048703611f51575f80516020615dec83398151915291820191015b818110611f3a575050611e94565b808884925588600182015588600282015501611f2c565b634e487b7160e01b88526011600452602488fd5b634e487b7160e01b87526011600452602487fd5b634e487b7160e01b85526041600452602485fd5b8380fd5b611f9c6105ce614b56565b611fa46150e3565b611fac61409a565b906002548111611fed575b5081151580611fe4575b611fcd575b5050611ddd565b611fd9916106196143ff565b426004555f80611fc6565b50801515611fc1565b6002555f611fb7565b42600455611dc5565b506120086143ff565b15611dc0565b503461044b578060031936011261044b57612027615078565b807386d7f797636bd55fa3ad55b8c6954631c70c0f4e803b15611d7d5781602491604051928380926356380c2b60e01b8252600660048301525af4801561059457610ede5750f35b503461044b578060031936011261044b57602060ff5f80516020615e4c83398151915254166040519015158152f35b503461044b57602080600319360112610680576120b9613e15565b6120c1615078565b6001600160a01b039081169182156122b6575f80516020615e0c83398151915254600a5483169216826121f5575b60405163095ea7b360e01b80848301528560248301525f19918260448201526044815261211b81613ecb565b6121258185615bcb565b9182156121aa575b505015806121a2575b61217e575050907f8a8682c8e0b406a8cfcc7c7c4ac90372d088ddb8dfaf1baea5435b69e832a43a839260405160018152a36001600160601b0360a01b600a541617600a5580f35b606492508460405192632d28f16360e21b8452600484015260248301526044820152fd5b506001612136565b6121d791925060405190868201528760248201525f6044820152604481526121d181613ecb565b84615bcb565b90816121e4575b8061212d565b6121ef915083615bcb565b5f6121de565b60405163095ea7b360e01b9081848201528460248201525f60448201526044815261221f81613ecb565b6122298184615bcb565b91821561226b575b50501580612263575b156120ef576064908360405191632d28f16360e21b8352600483015260248201525f6044820152fd5b50600161223a565b61229891925060405190858201528560248201525f60448201526044815261229281613ecb565b83615bcb565b90816122a5575b80612231565b6122b0915082615bcb565b5f61229f565b60405163dd2fe90160e01b8152600490fd5b5034610f1b575f366003190112610f1b576122e1615078565b60ff60055460a01c166123cb575f80516020615e0c833981519152546040516370a0823160e01b81523060048201527386d7f797636bd55fa3ad55b8c6954631c70c0f4e91602090829060249082906001600160a01b03165afa90811561238e575f91612399575b50813b15610f1b575f906044604051809481936338abfe2b60e01b83526006600484015260248301525af4801561238e57612382575080f35b61238c9150613f1c565b005b6040513d5f823e3d90fd5b90506020813d6020116123c3575b816123b460209383613f2f565b81010312610f1b57515f612349565b3d91506123a7565b6040516303eb29d960e01b8152600490fd5b34610f1b576020366003190112610f1b576123f6613e15565b6123fe615078565b6009546040516344401bd560e01b81526001600160a01b03918216600482015291811660248301529060208160448173b64bd6df349823d883146980421c876ffa14e6d95af490811561238e575f9161246b575b50166001600160601b0360a01b60095416176009555f80f35b90506020813d60201161249e575b8161248660209383613f2f565b81010312610f1b57518181168103610f1b5782612452565b3d9150612479565b34610f1b575f366003190112610f1b57602060ff601254166040519015158152f35b34610f1b576020366003190112610f1b576020610858600435614584565b34610f1b575f366003190112610f1b57600a546040516001600160a01b039091168152602090f35b34610f1b575f366003190112610f1b576005546040516001600160a01b039091168152602090f35b34610f1b575f366003190112610f1b5761254e6153b8565b5f541580156125fe575b6125f5575b60ff5f80516020615e4c833981519152541615612590575b61257d615078565b60015f80516020615e8c83398151915255005b61259b6105ce614b56565b6125a36150e3565b6125ab61409a565b9060025481116125ec575b50811515806125e3575b6125cc575b5050612575565b6125d8916106196143ff565b4260045580806125c5565b508015156125c0565b600255826125b6565b4260045561255d565b506126076143ff565b15612558565b34610f1b576020366003190112610f1b57602061085861262b613e15565b614516565b34610f1b575f366003190112610f1b575f54158015612731575b612728575b5f80516020615e4c83398151915260ff815416156126c3575b612670615078565b805460ff8116156126b15760ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa6020604051338152a142600455005b604051638dfc202b60e01b8152600490fd5b6126ce6105ce614b56565b6126d66150e3565b6126de61409a565b90600254811161271f575b5081151580612716575b6126ff575b5050612668565b61270b916106196143ff565b4260045581806126f8565b508015156126f3565b600255836126e9565b4260045561264f565b5061273a6143ff565b1561264a565b34610f1b576020366003190112610f1b57602061276361275e613e15565b615489565b6040519015158152f35b34610f1b575f366003190112610f1b575f80516020615e0c833981519152546040516001600160a01b039091168152602090f35b34610f1b575f366003190112610f1b5760206108586144aa565b34610f1b575f366003190112610f1b576009546040516001600160a01b039091168152602090f35b34610f1b575f366003190112610f1b5761238c336153e7565b34610f1b57610120366003190112610f1b576004356001600160a01b0381169003610f1b576024356001600160401b038111610f1b57612840903690600401613fa1565b6044356001600160401b038111610f1b5761285f903690600401613fa1565b6064356001600160401b038111610f1b5736602382011215610f1b5780600401359061288a82613fbf565b906128986040519283613f2f565b82825260208201906024606083950282010190368211610f1b57602401915b8183106131d35750506084359290506001600160a01b0383168303610f1b5760a4356001600160401b038111610f1b5760806003198236030112610f1b576040519061290282613ecb565b61290e81600401613fd6565b825261291c60248201613fd6565b602083015261292d60448201613fd6565b60408301526064810135906001600160401b038211610f1b57366023838301011215610f1b576004828201013561296381613fbf565b926129716040519485613f2f565b818452602084019236602460608502848401010111610f1b5780820160240193915b6024606085028284010101851061318a575050505050606082015260e4356001600160a01b0381169003610f1b5761010435948515158603610f1b575f80516020615eac83398151915254966001600160401b038816158061317c575b60016001600160401b038a16149081613172575b159081613169575b506131575760016001600160401b03198916175f80516020615eac8339815191525560ff8860401c161561312b575b612a436153b8565b612a4b615c12565b612a53615c12565b5f80516020615e4c833981519152805460ff19169055612a71615c12565b612a79615c12565b612a84600435615c6f565b9015613123575b5f80516020615e0c83398151915280546001600160a81b03191660a09290921b60ff60a01b16919091176004356001600160a01b0316179055612acc615c12565b612ad4615c12565b8051906001600160401b038211612ffd578190612afe5f80516020615d6c8339815191525461418d565b601f81116130a8575b50602090601f831160011461301c575f92613011575b50508160011b915f199060031b1c1916175f80516020615d6c833981519152555b8051906001600160401b038211612ffd578190612b685f80516020615dac8339815191525461418d565b601f8111612f82575b50602090601f8311600114612ef6575f92612eeb575b50508160011b915f199060031b1c1916175f80516020615dac833981519152555b612bb0615c12565b612bb8615c12565b612bc360e435615007565b612bcb615c12565b612bd3615c12565b60015f80516020615e8c833981519152556004356001600160a01b031615612ed95760015460405163c03e99d960e01b81526001600160a01b03600480358216908301526009602483015260e06044830152945160e48201819052909485946101048601949391909116915f5b818110612ea1575050506064840152600660848401526003198383030160a4840152602060a0606060808501936001600160401b0381511686526001600160401b038482015116848701526001600160401b036040820151166040870152015193608060608201528451809452019201905f5b818110612e60575050509080604092600760c4830152038173ff1773d975da0c000888c5715b7cf38968ff78195af490811561238e575f905f92612e15575b50600180546001600160a81b03191660a09390931b60ff60a01b16929092176001600160a01b039182161790915581161561091c5760058054633b9aca0060025560c4356003556010805494151560ff90811660ff1996871617909155601280549095169094556001600160b01b0319166001600160a01b039283161790554260049081556040519391903516307f3cd5ec01b1ae7cfec6ca1863e2cd6aa25d6d1702825803ff2b7cc95010fffdc25f80a360015f80516020615e8c8339815191525560401c1615612dc057005b60207fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29168ff0000000000000000195f80516020615eac83398151915254165f80516020615eac8339815191525560018152a1005b9150506040813d604011612e58575b81612e3160409383613f2f565b81010312610f1b576020612e448261401f565b9101519060ff82168203610f1b5785612cf2565b3d9150612e24565b919350916020606082612e9360019488516001600160401b03604080928051855260208101516020860152015116910152565b019401910191849392612cb3565b825180516001600160a01b03168752602090810151805182890152810151604088015288975060609096019590920191600101612c40565b604051630ccd248560e21b8152600490fd5b015190508880612b87565b92505f80516020615dac8339815191525f525f80516020615e6c833981519152905f935b601f1984168510612f67576001945083601f19811610612f4f575b505050811b015f80516020615dac83398151915255612ba8565b01515f1960f88460031b161c19169055888080612f35565b81810151835560209485019460019093019290910190612f1a565b9091505f80516020615dac8339815191525f52601f830160051c5f80516020615e6c8339815191520160208410612fe9575b908392915b601f820160051c5f80516020615e6c833981519152018110612fdb5750612b71565b5f8155849350600101612fb9565b505f80516020615e6c833981519152612fb4565b634e487b7160e01b5f52604160045260245ffd5b015190508980612b1d565b92505f80516020615d6c8339815191525f525f80516020615d4c833981519152905f935b601f198416851061308d576001945083601f19811610613075575b505050811b015f80516020615d6c83398151915255612b3e565b01515f1960f88460031b161c1916905589808061305b565b81810151835560209485019460019093019290910190613040565b9091505f80516020615d6c8339815191525f52601f830160051c5f80516020615d4c833981519152016020841061310f575b908392915b601f820160051c5f80516020615d4c8339815191520181106131015750612b07565b5f81558493506001016130df565b505f80516020615d4c8339815191526130da565b506012612a8b565b68ffffffffffffffffff19881668010000000000000001175f80516020615eac83398151915255612a3b565b60405163f92ee8a960e01b8152600490fd5b90501589612a0c565b303b159150612a04565b5060ff8860401c16156129f0565b606085360312610f1b5760608060206024956040516131a881613ee6565b89358152828a0135838201526131c060408b01613fd6565b6040820152815201960195935050612993565b82360360608112610f1b57604051906131eb82613f01565b8435906001600160a01b0382168203610f1b576040918352601f190112610f1b5760609160209160405161321e81613f01565b838701358152604087013584820152838201528152019201916128b7565b34610f1b575f366003190112610f1b57602060ff60015460a01c16604051908152f35b34610f1b576020366003190112610f1b5760206108583333600435614bc4565b34610f1b576020366003190112610f1b576004356001600160401b038111610f1b5736602382011215610f1b5780600401356001600160401b038111610f1b5760249181810190838201368111610f1b576132d86153b8565b6132e0615078565b60609260609461355f575b5050506132f66143ff565b916060928251600692600654945f5b868110613343577f429eabcd6b69e5ca232c6a9d2c5af1805e375e951df8e9bfe831b445e5f69b2b5f80a160015f80516020615e8c83398151915255005b5f5b8481106134fc575b5085548110156134e957855f5261339f5f8960018060a01b03600385025f80516020615e2c8339815191520154168c83604051809681958294630aa0465b60e21b845260206004850152830190613dd7565b03925af190811561238e575f916134cf575b508051905f5b8281106133c957505050600101613305565b60206133d58284614475565b510151906001600160a01b036133eb8285614475565b515116826133ff575b5060019150016133b7565b805f52600d60205260405f20541561344d575b6001928a80613423575b50506133f4565b61342c916159f2565b905f52600d60205261344360405f2091825461449d565b90558d808a61341c565b600c5492600160401b8410156134bc576001840180600c558410156134a957600c5f527fdf6966c971051c3d54ec59162606531493a51404a002842f56009d7e5cf4a8c790930180546001600160a01b03191682179055613412565b8e634e487b7160e01b5f5260326004525ffd5b8e634e487b7160e01b5f5260416004525ffd5b6134e391503d805f833e611bbb8183613f2f565b8a6133b1565b88634e487b7160e01b5f5260326004525ffd5b9750806135098984614475565b511461354c5760405160208101908082106001600160401b03831117613539576001916040525f81529801613345565b8a634e487b7160e01b5f5260416004525ffd5b966135579083614475565b51968961334d565b8294506040929193500312610f1b57828201356001600160401b038111610f1b5782019080604383011215610f1b57838201359260449261359f85613fbf565b946135ad6040519687613f2f565b80865284602087019160051b83010191848311610f1b578501905b82821061367d5750505082810135906001600160401b038211610f1b570181604382011215610f1b5784810135926135ff84613fbf565b9361360d6040519586613f2f565b80855281602086019160051b84010192848411610f1b57828101915b84831061363f57505050505050908380806132eb565b82356001600160401b038111610f1b57820186606382011215610f1b576020916136728883606489879601359101613f6b565b815201920191613629565b81358152602091820191016135c8565b34610f1b576060366003190112610f1b576115726136a9613e15565b6136b1613e2b565b604435916136c0833383615222565b6152ba565b34610f1b575f366003190112610f1b576020600254604051908152f35b34610f1b576040366003190112610f1b576136fb613e15565b613703613e2b565b9060018060a01b038091165f52600f60205260405f2091165f52602052602060405f2054604051908152f35b34610f1b575f366003190112610f1b576020600b54604051908152f35b34610f1b575f366003190112610f1b5760206108586143ff565b34610f1b575f366003190112610f1b5760405161378281613ecb565b5f81526020905f828201525f604082015260608080920152604051916137a783613ecb565b600754916001600160401b0393848416815282810193858160401c16855285604083019160801c168152600854906137de82613fbf565b916137ec6040519384613f2f565b80835285830160085f525f80516020615dec8339815191525f915b8383106138a657505050508690606084019283526040519788978789528160a08a01965116888a01525116604088015251166060860152519260808086015283518092528060c086019401925f905b8382106138635786860387f35b91849650828661389660019496988498516001600160401b03604080928051855260208101516020860152015116910152565b0196019201869594929391613856565b60038960019260409d98999b9a9c9d516138bf81613ee6565b85548152848601548382015289600287015416604082015281520192019201919099989697959499613807565b34610f1b575f366003190112610f1b57602060ff601054166040519015158152f35b34610f1b575f366003190112610f1b57602060ff60055460a01c166040519015158152f35b34610f1b575f366003190112610f1b5760206108586142dc565b34610f1b576020366003190112610f1b57613969600435615148565b6005546001600160a01b031633146139b8576001600160401b0360075460401c16906127109182039182116139a4576020916108589161595d565b634e487b7160e01b5f52601160045260245ffd5b602090610858565b34610f1b576040366003190112610f1b576139d9613e15565b602435903315613a57576001600160a01b0316908115613a3f576139fc33613e93565b825f526020528060405f20556040519081527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560203392a3602060405160018152f35b604051634a1406b160e11b81525f6004820152602490fd5b60405163e602df0560e01b81525f6004820152602490fd5b34610f1b576020366003190112610f1b5760206108586004356150b0565b34610f1b576020366003190112610f1b576001600160a01b03613aae613e15565b16805f525f80516020615d8c83398151915260205260405f205490604051916313d6991d60e31b83526004830152602482015260a060448201525f8180613af760a4820161426b565b600d6064830152600e6084830152038173f6880a04a5df3ba54e5d196471927daa4fcfc2d95af4801561238e576116c3915f91613b3c575b5060405191829182613e41565b613b5091503d805f833e611bbb8183613f2f565b82613b2f565b34610f1b575f366003190112610f1b576040515f80516020615d6c8339815191528054825f613b848361418d565b92838352602094600191866001821691825f14613bfa575050600114613bb3575b50506116af92500383613f2f565b8592505f525f80516020615d4c833981519152905f915b858310613be25750506116af93508201018580613ba5565b80548389018501528794508693909201918101613bca565b92509350506116af94915060ff191682840152151560051b8201018580613ba5565b34610f1b576020366003190112610f1b57613c35613dc8565b613c3d615078565b6012546040805160ff8084161515825284151560208301529293917f7a9ce9fadfad7fa30c993357b27d46d599daf8af9d701ff8efebdbcf40bb344591a160ff199092169115151617601255005b34610f1b575f366003190112610f1b57602061085861409a565b34610f1b576040366003190112610f1b57600435613cc1613db9565b613cc9615078565b600654821015613da0575f80516020615e0c833981519152546001546040516309a0b6b360e31b8152600660048201526001600160a01b0392831660248201526044810194909452911515606484015290811660848301529060208160a4817386d7f797636bd55fa3ad55b8c6954631c70c0f4e5af490811561238e575f91613d66575b50166001600160601b0360a01b60015416176001555f80f35b90506020813d602011613d98575b81613d8160209383613f2f565b81010312610f1b57613d929061401f565b82613d4d565b3d9150613d74565b60405163042a2e7160e11b815260048101839052602490fd5b602435908115158203610f1b57565b600435908115158203610f1b57565b91908251928382525f5b848110613e01575050825f602080949584010152601f8019910116010190565b602081830181015184830182015201613de1565b600435906001600160a01b0382168203610f1b57565b602435906001600160a01b0382168203610f1b57565b60208082019080835283518092528060408094019401925f905b838210613e6a57505050505090565b845180516001600160a01b03168752830151868401529485019493820193600190910190613e5b565b6001600160a01b03165f9081527f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace016020526040902090565b608081019081106001600160401b03821117612ffd57604052565b606081019081106001600160401b03821117612ffd57604052565b604081019081106001600160401b03821117612ffd57604052565b6001600160401b038111612ffd57604052565b90601f801991011681019081106001600160401b03821117612ffd57604052565b6001600160401b038111612ffd57601f01601f191660200190565b929192613f7782613f50565b91613f856040519384613f2f565b829481845281830111610f1b578281602093845f960137010152565b9080601f83011215610f1b57816020613fbc93359101613f6b565b90565b6001600160401b038111612ffd5760051b60200190565b35906001600160401b0382168203610f1b57565b6060906003190112610f1b57600435906001600160a01b03906024358281168103610f1b57916044359081168103610f1b5790565b51906001600160a01b0382168203610f1b57565b6006549081815260208091019160065f525f80516020615e2c833981519152915f905b828210614064575050505090565b83546001600160a01b03168552600180850154868301526002850154604087015260609095019460039094019390910190614056565b5f80516020615e0c833981519152546040516370a0823160e01b81523060048201526020918290829060249082906001600160a01b03165afa90811561238e575f91614160575b5060405190635aafb00160e11b825260048201526040602482015281818061410b60448201614033565b038173e974c9e967e63701a889c7defbb49c6d7432475f5af491821561238e575f9261413657505090565b90809250813d8311614159575b61414d8183613f2f565b81010312610f1b575190565b503d614143565b90508181813d8311614186575b6141778183613f2f565b81010312610f1b57515f6140e1565b503d61416d565b90600182811c921680156141bb575b60208310146141a757565b634e487b7160e01b5f52602260045260245ffd5b91607f169161419c565b906020918281830312610f1b578051906001600160401b038211610f1b570181601f82011215610f1b578051926141fb84613fbf565b9360409361420c6040519687613f2f565b818652828087019260061b85010193818511610f1b578301915b8483106142365750505050505090565b8583830312610f1b57838691825161424d81613f01565b6142568661401f565b81528286015183820152815201920191614226565b600c5490818152602080910191600c5f527fdf6966c971051c3d54ec59162606531493a51404a002842f56009d7e5cf4a8c7915f905b8282106142af575050505090565b83546001600160a01b0316855293840193600193840193909101906142a1565b919082039182116139a457565b6142e46150e3565b6142ec61409a565b906002906002549160018060a01b035f80516020615e0c83398151915254169260409260405195869463aabbf18d60e01b865260c4860160c0600488015260085480915260e487019560085f525f80516020615dec833981519152925f915b8383106143c757505050505091602095918594936024860152604485015260648401526084830152600760a48301520381736a7bdc827eb3669af20d3d55dcf3af1b5691ea2e5af490811561238e575f916143a4575090565b90506020813d6020116143bf575b8161414d60209383613f2f565b3d91506143b2565b8454895260018086015460208b0152858201546001600160401b03168a8401528c9a506060909901986003909501949092019161434b565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0254600954604051632389621360e11b815260048101929092526001600160a01b0316602482015260208160448173e974c9e967e63701a889c7defbb49c6d7432475f5af490811561238e575f916143a4575090565b80518210156144895760209160051b010190565b634e487b7160e01b5f52603260045260245ffd5b919082018092116139a457565b5f80516020615e0c83398151915254604080516369e4822760e01b81526001600160a01b0390921660048301526024820152602081806144ec60448201614033565b038173b64bd6df349823d883146980421c876ffa14e6d95af490811561238e575f916143a4575090565b60ff5f80516020615e4c8339815191525416908115614573575b508015614569575b8015614556575b15614548575f90565b613fbc60035461085261409a565b5061455f61409a565b600354111561453f565b5060035415614538565b61457d9150615489565b155f614530565b6005546001600160a01b031633146145ba576145b5613fbc916108526001600160401b0360075460401c16826151ee565b6150b0565b613fbc906150b0565b356001600160401b0381168103610f1b5790565b6145df6153b8565b6145e761554d565b60ff6012541680614850575b614838575f54158015614829575b614820575b60ff5f80516020615e4c8339815191525416156147bb575b61462782615577565b6146388161463361409a565b61449d565b600354106147a9576005546001600160a01b0390339082160361475d5761465e8261517b565b925b6305f5e10084111561474b5761467684826154ba565b61469483835f80516020615e0c833981519152541630903390615593565b60ff60055460a01c16156146eb575b60405192835283602084015216907fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d760403392a39060015f80516020615e8c83398151915255565b7386d7f797636bd55fa3ad55b8c6954631c70c0f4e803b15610f1b575f604051809263ed9add7360e01b82528180614727308a60048401614867565b03915af4801561238e5761473c575b506146a3565b61474590613f1c565b5f614736565b604051631f2a200560e01b8152600490fd5b61477561084d6001600160401b0360075416846151ee565b92614788846147838561517b565b6142cf565b9380614795575b50614660565b6147a39083600554166154ba565b5f61478f565b604051631264675f60e01b8152600490fd5b6147c66105ce614b56565b6147ce6150e3565b6147d661409a565b906002548111614817575b508115158061480e575b6147f7575b505061461e565b614803916106196143ff565b426004555f806147f0565b508015156147eb565b6002555f6147e1565b42600455614606565b506148326143ff565b15614601565b604051632e6eba8560e11b8152336004820152602490fd5b50335f52601160205260ff60405f205416156145f3565b909291608082016080835260065480915260a083019060065f525f80516020615e2c833981519152905f5b8181106148bc5750505060208301949094526001600160a01b031660408201526001606090910152565b82546001600160a01b0316845260018084015460208601526002840154604086015260609094019360039093019201614892565b6148f86153b8565b61490061554d565b60ff6012541680614b3f575b614838575f54158015614b30575b614b27575b60ff5f80516020615e4c833981519152541615614ac2575b61494082615577565b6305f5e10081111561474b576007546005546001600160a01b03916001600160401b03169082163314614aba576127109081039081116139a4578261478361498892826151ae565b925b61499c614997858561449d565b615115565b936149a98561463361409a565b600354106147a9576149ba82614516565b85116147a95780614aa6575b506149d183826154ba565b6149ef84835f80516020615e0c833981519152541630903390615593565b60ff60055460a01c1615614a46575b60405192848452602084015216907fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d760403392a39060015f80516020615e8c83398151915255565b7386d7f797636bd55fa3ad55b8c6954631c70c0f4e803b15610f1b575f604051809263ed9add7360e01b82528180614a82308b60048401614867565b03915af4801561238e57614a97575b506149fe565b614aa090613f1c565b5f614a91565b614ab49083600554166154ba565b5f6149c6565b505f9261498a565b614acd6105ce614b56565b614ad56150e3565b614add61409a565b906002548111614b1e575b5081151580614b15575b614afe575b5050614937565b614b0a916106196143ff565b426004555f80614af7565b50801515614af2565b6002555f614ae8565b4260045561491f565b50614b396143ff565b1561491a565b50335f52601160205260ff60405f2054161561490c565b614b5e61554d565b6001600160401b0360075460801c16614b7561409a565b6004549060405192632740b27d60e21b8452600484015260248301526044820152602081606481736a7bdc827eb3669af20d3d55dcf3af1b5691ea2e5af490811561238e575f916143a4575090565b919091614bcf6153b8565b614bd761554d565b60ff6012541680614d43575b614838575f54158015614d34575b614d2b575b60ff5f80516020615e4c833981519152541615614cc6575b6001600160a01b039183831615614cb457614c2881615895565b82116147a957614c3782615148565b906305f5e10082111561474b576001600160401b0360075460401c1693600554163314155f14614ca4576127109384039384116139a457614c89614c8283614783614c9097826151ae565b809361449d565b9485615656565b9060015f80516020615e8c83398151915255565b614c909350614c895f809361449d565b604051634e46966960e11b8152600490fd5b614cd16105ce614b56565b614cd96150e3565b614ce161409a565b906002548111614d22575b5081151580614d19575b614d02575b5050614c0e565b614d0e916106196143ff565b426004555f80614cfb565b50801515614cf6565b6002555f614cec565b42600455614bf6565b50614d3d6143ff565b15614bf1565b50335f52601160205260ff60405f20541615614be3565b9190915f91614d676153b8565b614d6f61554d565b60ff6012541680614ef7575b614838575f54158015614ee8575b614edf575b60ff5f80516020615e4c833981519152541615614e7a575b73e974c9e967e63701a889c7defbb49c6d7432475f614dc482614f7a565b90803b15610f1b576040516383ff48f560e01b81526001600160a01b03871660048201526024810185905260448101929092525f90829060649082905af4801561238e57614e67575b506305f5e10082111561474b57600554614c9093906001600160a01b03163314614e615750614e4a6001600160401b0360075460401c16836151ee565b905b614e596145b583856142cf565b948593615656565b90614e4c565b614e72919350613f1c565b5f915f614e0d565b614e856105ce614b56565b614e8d6150e3565b614e9561409a565b906002548111614ed6575b5081151580614ecd575b614eb6575b5050614da6565b614ec2916106196143ff565b426004555f80614eaf565b50801515614eaa565b6002555f614ea0565b42600455614d8e565b50614ef16143ff565b15614d89565b50335f52601160205260ff60405f20541615614d7b565b60ff5f80516020615e4c8339815191525416908115614f6f575b8115614f5e575b50614f5a576003545f19808214614f555750614f4d613fbc9161517b565b6108526143ff565b905090565b5f90565b614f689150615489565b155f614f2f565b600354159150614f28565b60ff5f80516020615e4c83398151915254168015614ff8575b8015614fe8575b614fe3576001600160a01b039081165f9081525f80516020615d8c8339815191526020526040902054600954909116613fbc57614fd86106f36144aa565b818110614f55575090565b505f90565b50614ff281615489565b15614f9a565b5060ff60055460a81c16614f93565b6001600160a01b03908116908115615060575f80516020615dcc83398151915280546001600160a01b031981168417909155167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e05f80a3565b604051631e4fbdf760e01b81525f6004820152602490fd5b5f80516020615dcc833981519152546001600160a01b0316330361509857565b60405163118cdaa760e01b8152336004820152602490fd5b6150b861409a565b600181018091116139a4576150cb6143ff565b90633b9aca0082018092116139a457613fbc92615b58565b6150eb61409a565b600181018091116139a4576150fe6143ff565b633b9aca0081018091116139a457613fbc91615adc565b61511d61409a565b600181018091116139a4576151306143ff565b90633b9aca0082018092116139a457613fbc92615206565b6151506143ff565b633b9aca0081018091116139a45761516661409a565b90600182018092116139a457613fbc92615206565b6151836143ff565b633b9aca0081018091116139a45761519961409a565b90600182018092116139a457613fbc92615b58565b906151b9818361595d565b9181156151da5761271090096151cc5790565b600181018091116139a45790565b634e487b7160e01b5f52601260045260245ffd5b90612710906151fd8184615a74565b92096151cc5790565b9190615213828285615b58565b9282156151da57096151cc5790565b61522b81613e93565b9060018060a01b0380841692835f5260205260405f2054935f198503615254575b505050505050565b8585106152895750811615613a57578115613a3f5761527290613e93565b905f526020520360405f20555f808080808061524c565b604051637dc7a0d960e11b81526001600160a01b039190911660048201526024810185905260448101869052606490fd5b90916001600160a01b03808316929083156153a0578416938415615388576152ea906152e5836153e7565b6153e7565b825f525f80516020615d8c8339815191528060205260405f205491838310615355575091806020927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef94865f5284520360405f2055845f5260405f20818154019055604051908152a3565b60405163391434e360e21b81526001600160a01b0391909116600482015260248101929092525060448101829052606490fd5b60405163ec442f0560e01b81525f6004820152602490fd5b604051634b637e8f60e11b81525f6004820152602490fd5b5f80516020615e8c83398151915260028154146153d55760029055565b604051633ee5aeb560e01b8152600490fd5b6001600160a01b03165f8181525f80516020615d8c833981519152602052604090205473f6880a04a5df3ba54e5d196471927daa4fcfc2d990813b15610f1b575f91604051938492631cdd916360e01b84526004840152602483015260c06044830152818061545860c4820161426b565b600d6064830152600e6084830152600f60a483015203915af4801561238e5761547e5750565b61548790613f1c565b565b60ff601254161590811561549b575090565b6001600160a01b03165f9081526011602052604090205460ff16919050565b6001600160a01b0381169182156153885760207fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef916154f95f946153e7565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0261552582825461449d565b90558484525f80516020615d8c833981519152825260408420818154019055604051908152a3565b60ff5f80516020615e4c833981519152541661556557565b60405163d93c066560e01b8152600490fd5b6001600160a01b031615614cb4575f541561558e57565b425f55565b6040516323b872dd60e01b602082019081526001600160a01b0393841660248301529383166044820152606480820195909552938452909160a08401906001600160401b03821185831017612ffd57615604935f9384936040521694519082865af16155fd615c40565b9083615ce8565b8051908115159182615632575b505061561a5750565b60249060405190635274afe760e01b82526004820152fd5b8192509060209181010312610f1b5760200151801590811503610f1b575f80615611565b939190929360ff60055460a81c16615883576001600160a01b038281169533879003615873575b86156153a05761568c846153e7565b865f525f80516020615d8c8339815191529384602052604094855f2054918583106158415750908491895f5260205203845f20557f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace028381540390555f877fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60208751878152a38061582e575b6157206144aa565b9561574073b64bd6df349823d883146980421c876ffa14e6d992856142cf565b91835f80516020615e0c833981519152541692846009541693600b5486600a54169060ff6010541690853b15610f1b575f978c948c519a8b998a98899863a49fe6f760e01b8a5260048a01526024890152169e8f60448801526064870152608486015260a485015260c484015261014060e48401526157c26101448401614033565b91610104840152151561012483015203915af4801561582457907ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db939291615815575b50815193845260208401523392a4565b61581e90613f1c565b5f615805565b83513d5f823e3d90fd5b61583c8183600554166154ba565b615718565b865163391434e360e21b81526001600160a01b0391909116600482015260248101929092525060448101849052606490fd5b61587e833386615222565b61567d565b604051636022a9e760e01b8152600490fd5b60ff5f80516020615e4c8339815191525416801561594e575b801561593e575b614fe3576001600160a01b039081165f9081525f80516020615d8c83398151915260205260409020546158e7906150b0565b6158fe6158f56105ce614b56565b8261064b61409a565b6001600160401b0360075460401c16916127109283039283116139a4576159289261478391615a74565b600954909116156159365790565b614fd86144aa565b5061594881615489565b156158b5565b5060ff60055460a81c166158ae565b61271091818302915f19848209938380861095039480860395146159e457848311156159d257829109815f038216809204600280826003021880830282030280830282030280830282030280830282030280830282030280920290030293600183805f03040190848311900302920304170290565b60405163227bc15360e01b8152600490fd5b5050809250156151da570490565b6ec097ce7bc90715b34b9f100000000091818302915f19848209938380861095039480860395146159e457848311156159d257829109815f038216809204600280826003021880830282030280830282030280830282030280830282030280830282030280920290030293600183805f03040190848311900302920304170290565b90808202905f1981840990828083109203918083039214615ad15761271090828211156159d2577fbc01a36e2eb1c432ca57a786c226809d495182a9930be0ded288ce703afb7e91940990828211900360fc1b910360041c170290565b505061271091500490565b90670de0b6b3a764000080830291905f19848209938380861095039480860395146159e457848311156159d257829109815f038216809204600280826003021880830282030280830282030280830282030280830282030280830282030280920290030293600183805f03040190848311900302920304170290565b9091828202915f19848209938380861095039480860395146159e457848311156159d257829109815f038216809204600280826003021880830282030280830282030280830282030280830282030280830282030280920290030293600183805f03040190848311900302920304170290565b905f602091828151910182855af1903d5f519083615bea575b50505090565b91925090615c0857506001600160a01b03163b15155b5f8080615be4565b6001915014615c00565b60ff5f80516020615eac8339815191525460401c1615615c2e57565b604051631afcd79f60e31b8152600490fd5b3d15615c6a573d90615c5182613f50565b91615c5f6040519384613f2f565b82523d5f602084013e565b606090565b5f8091604051602081019063313ce56760e01b825260048152615c9181613f01565b51916001600160a01b03165afa615ca6615c40565b9080615cdc575b615cb9575b505f905f90565b602081805181010312610f1b576020015160ff8111615cb2579060ff6001921690565b50602081511015615cad565b90615d0f5750805115615cfd57805190602001fd5b604051630a12f52160e11b8152600490fd5b81511580615d42575b615d20575090565b604051639996b31560e01b81526001600160a01b039091166004820152602490fd5b50803b15615d1856fe2ae08a8e29253f69ac5d979a101956ab8f8d9d7ded63fa7a83b16fc47648eab052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0352c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace049016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300f3f7a9fe364faab93b216da50a3214154f22a0a2b415b23a84c8169e8b636ee30773e532dfede91f04b12a73d3d2acd361424f41f76b4fb79f090161e36b4e00f652222313e28459528d920b65115c16c04f3efc82aaedc97be59f3f377c0d3fcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f0330046a2803e59a4de4e7a4c574b1243f25977ac4c77d5a1a4a609b5394cebb4a2aa9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00f0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00a2646970667358221220e0ed4bb5a2e29ea5defebd89c9f1c78c5595d6013729459d582110dec9d2e49d64736f6c63430008180033
Deployed Bytecode
0x60806040526004361015610011575f80fd5b5f803560e01c806270e59514613ca557806301e1d11414613c8b578063052d9e7e14613c1c57806306fdde0314613b56578063078b0fb714613a8d57806307a2d13a14613a6f578063095ea7b3146139c05780630a28a4771461394d5780630c14935e14613933578063111c84531461390e5780631160265b146138ec57806313ee9df41461376657806318160ddd1461374c57806319e672461461372f5780631d2af0b9146136e25780631e8410da146136c557806323b872dd1461368d5780632a81196c1461327f5780632e1a7d4d1461325f578063313ce5671461323c57806332a8f9d4146127fc578063372500ab146127e357806337d5fe99146127bb57806337f1834e146127a157806338d52e0f1461276d5780633af32abf146127405780633f4ba83a14612630578063402d267d1461260d5780634657189914612536578063469048401461250e57806349d0ea97146124e65780634cdad506146124c857806351fb012d146124a65780635337e670146123dd57806355b8b781146122c857806359f7c8451461209e5780635c975abb1461206f57806366584f8c1461200e5780636bedc46c14611d805780636d3300e514611d135780636e2a6fe514611c9f5780636e553f6514611c7857806370a0823114611c33578063715018a614611bca57806372e7160114611b2657806375a046a514611aa6578063839e950f146119a65780638456cb59146118a857806388fba0661461182b5780638ab1d6811461178d5780638da5cb5b1461175857806394bf804d1461173157806395d89b411461164e5780639e2f0e22146116255780639f3d0a4814611607578063a039c129146115ba578063a0712d681461159a578063a5f5be541461157d578063a9059cbb1461154b578063acfd792814611530578063b39ed6d91461142d578063b3d7f6b9146113b2578063b3e3211414611379578063b45ba4a8146110ea578063b460af94146110d0578063b49a60bb14610fd2578063b6b55f2514610fb2578063ba08765214610f98578063bdc8144b14610f4a578063bf3bd25d14610df7578063c0cbbca614610c29578063c4f59f9b14610b63578063c63d75b614610b3f578063c6e6f59214610b20578063ce96cb7714610afc578063d1b39ae514610ae0578063d905777e14610abc578063d936547e14610a7d578063daa3a16314610a61578063db006a7514610a40578063dd62ed3e146109f8578063e43252d71461092e578063e74b981b146108ac578063e9f2838e14610886578063ecf7085814610868578063ef8b30f7146107fa578063f1f741b4146106b1578063f2fde38b14610684578063f4aa3efa1461044e5763f745d6ca146103f7575f80fd5b3461044b57602036600319011261044b57600435610413615078565b7f47ecb16e79d3795bad1b15b763dad4136c346b10a729a5e22a60ae3416b571ba6040600b548151908152836020820152a1600b5580f35b80fd5b503461044b57604036600319011261044b57600435906001600160401b038083116106805736602384011215610680578260040135908111610680573660248260061b85010111610680576104a1613db9565b6104a96153b8565b6104b1615078565b8254158015610671575b610668575b60ff5f80516020615e4c8339815191525416156105c3575b5f80516020615e0c833981519152547386d7f797636bd55fa3ad55b8c6954631c70c0f4e916001600160a01b0390911690823b156105bf5760405193632f42e93b60e21b85528060848601600660048801526080602488015252602460a48601970190865b81811061059f5750505091838086978194889615156044840152606483015203915af4801561059457610580575b5060015f80516020615e8c8339815191525580f35b61058990613f1c565b61044b57805f61056b565b6040513d84823e3d90fd5b82358952602080840135908a01526040988901989092019160010161053d565b8480fd5b6105dc6105ce614b56565b6105d66142dc565b9061449d565b6105e46150e3565b6105ec61409a565b90600254811161065f575b5081151580610656575b61060d575b50506104d8565b610633916106196143ff565b8061063e575090505b6005546001600160a01b03166154ba565b426004555f80610606565b61064b82610651946142cf565b91615b58565b610622565b50801515610601565b6002555f6105f7565b426004556104c0565b5061067a6143ff565b156104bb565b5080fd5b503461044b57602036600319011261044b576106ae6106a1613e15565b6106a9615078565b615007565b80f35b503461044b57602036600319011261044b576106cb615078565b6106d36153b8565b6009546001600160a01b03908116156107e85781906106f86106f36144aa565b61517b565b61070061409a565b916107096143ff565b6040519361071685613ee6565b84526020840190815260408401926009845273b64bd6df349823d883146980421c876ffa14e6d991836009541690845f80516020615e0c833981519152541694600a541690843b156107e457889660ff91604051998a988997889763408d459560e11b8952600489015260043560248901526044880152606487015261012060848701526107a76101248701614033565b9460a48701525160c48601525160e4850152511661010483015203915af4801561059457610580575060015f80516020615e8c8339815191525580f35b8880fd5b604051637c0c423f60e11b8152600490fd5b503461044b57602036600319011261044b5761085860209160043561081e8161517b565b6005549092906001600160a01b03163314610860575061084d610852916001600160401b0360075416906151ee565b615148565b906142cf565b604051908152f35b9050906142cf565b503461044b578060031936011261044b576020600354604051908152f35b503461044b578060031936011261044b57602060ff60055460a81c166040519015158152f35b503461044b57602036600319011261044b576108c6613e15565b6108ce615078565b6001600160a01b0390811690811561091c57816005549182167faaebcf1bfa00580e41d966056b48521fa9f202645c86d4ddf28113e617c1b1d38580a36001600160a01b0319161760055580f35b604051630ed1b8b360e31b8152600490fd5b503461044b57602036600319011261044b57610948613e15565b610950615078565b60ff60125416156109e6576001600160a01b031680156109d457808252601160205260ff6040832054166109bc57808252601160205260408220805460ff191660011790557f3ebdc59c5154f681813582b63e04d503c44f515f80fa2d558d663f4e3fdf508a8280a280f35b60249060405190634254a0ed60e01b82526004820152fd5b604051630702b3d960e41b8152600490fd5b60405163212c6e1d60e01b8152600490fd5b503461044b57604036600319011261044b57610a12613e15565b610a23610a1d613e2b565b91613e93565b9060018060a01b03165f52602052602060405f2054604051908152f35b503461044b57602036600319011261044b5760206108583333600435614d5a565b503461044b578060031936011261044b57602090604051908152f35b503461044b57602036600319011261044b5760209060ff906040906001600160a01b03610aa8613e15565b168152601184522054166040519015158152f35b503461044b57602036600319011261044b576020610858610adb613e15565b614f7a565b503461044b578060031936011261044b57602060405160098152f35b503461044b57602036600319011261044b576020610858610b1b613e15565b615895565b503461044b57602036600319011261044b57602061085860043561517b565b503461044b57602036600319011261044b576020610858610b5e613e15565b614f0e565b503461044b578060031936011261044b576040518091600c549081835260208093018092600c83527fdf6966c971051c3d54ec59162606531493a51404a002842f56009d7e5cf4a8c790835b818110610c0c5750505084610bc5910385613f2f565b60405193838594850191818652518092526040850193925b828110610bec57505050500390f35b83516001600160a01b031685528695509381019392810192600101610bdd565b82546001600160a01b031684529286019260019283019201610baf565b503461044b57602036600319011261044b57600435610c466153b8565b610c4e615078565b8154158015610de8575b610ddf575b60ff5f80516020615e4c833981519152541615610d7a575b600654811015610d62576001545f80516020615e0c8339815191525460405163266554c160e21b81526006600482015260248101939093526001600160a01b03918216604484015281166064830152906020816084817386d7f797636bd55fa3ad55b8c6954631c70c0f4e5af4908115610d57578391610d19575b50166001600160601b0360a01b600154161760015560015f80516020615e8c8339815191525580f35b90506020813d602011610d4f575b81610d3460209383613f2f565b81010312610d4b57610d459061401f565b5f610cf0565b8280fd5b3d9150610d27565b6040513d85823e3d90fd5b6024906040519063042a2e7160e11b82526004820152fd5b610d856105ce614b56565b610d8d6150e3565b610d9561409a565b906002548111610dd6575b5081151580610dcd575b610db6575b5050610c75565b610dc2916106196143ff565b426004555f80610daf565b50801515610daa565b6002555f610da0565b42600455610c5d565b50610df16143ff565b15610c58565b503461044b57602036600319011261044b576001546001600160a01b0390811690600435338303610f32578392825f80516020615e0c83398151915254169060405191630de492b960e11b8352600483015282602483015260448201526006606482015260208160848173ff1773d975da0c000888c5715b7cf38968ff78195af4908115610f27578491610eee575b5073b64bd6df349823d883146980421c876ffa14e6d9926001541692803b156105bf5784926064916040519586948593639db88c9360e01b85526004850152602484015260448301525af4801561059457610ede5750f35b610ee790613f1c565b61044b5780f35b9350506020833d602011610f1f575b81610f0a60209383613f2f565b81010312610f1b578392515f610e86565b5f80fd5b3d9150610efd565b6040513d86823e3d90fd5b6040516311dc66cd60e11b8152336004820152602490fd5b503461044b57602036600319011261044b577f5d2e73196f8ba1b44e887e2bcc9bcd1f3e657add341d4a0a632ffff00d6903f26020600435610f8a615078565b80600355604051908152a180f35b503461044b576020610858610fac36613fea565b91614d5a565b503461044b57602036600319011261044b576020610858336004356145d7565b503461044b578060031936011261044b57600654610fef81613fbf565b90610ffd6040519283613f2f565b8082526006835260209182810191845f80516020615e2c833981519152845b83831061107c57505050506040519280840191818552518092526040840192945b82811061104a5784840385f35b855180516001600160a01b0316855282015180518584015282015160408501529481019460609093019260010161103d565b60038760019260409a9997989a5161109381613f01565b848060a01b0386541681526040516110aa81613f01565b85870154815260028701548482015283820152815201920192019190969493959661101c565b503461044b5760206108586110e436613fea565b91614bc4565b503461044b5760a036600319011261044b57611104613db9565b6060366043190112610680576111186153b8565b611120615078565b815415801561136a575b611361575b60ff5f80516020615e4c8339815191525416156112fc575b6001545f80516020615e0c83398151915254604051630e1739ad60e31b815260066004820152926001600160a01b03929183169183169060443580851690819003610f1b576024860152606435604486015260843560648601521515608485015260043560a485015260c484015260e4830152606082610104817386d7f797636bd55fa3ad55b8c6954631c70c0f4e5af48015610d5757838493859261127a575b5091807f3f008fd510eae7a9e7bee13513d7b83bef8003d488b5a3d0b0da4de71d6846f1949281602095166001600160601b0360a01b6001541617600155168061124a575b5060405191168152a160015f80516020615e8c8339815191525580f35b837f09a1db4b80c32706328728508c941a6b954f31eb5affd32f236c1fd405f8fea491604051908152a15f61122d565b935050506060823d6060116112f4575b8161129760609383613f2f565b81010312610d4b5781816020926112ce7f3f008fd510eae7a9e7bee13513d7b83bef8003d488b5a3d0b0da4de71d6846f19561401f565b92816112e760406112e088850161401f565b930161401f565b94919650509193506111e8565b3d915061128a565b6113076105ce614b56565b61130f6150e3565b61131761409a565b906002548111611358575b508115158061134f575b611338575b5050611147565b611344916106196143ff565b426004555f80611331565b5080151561132c565b6002555f611322565b4260045561112f565b506113736143ff565b1561112a565b503461044b57602036600319011261044b576020906040906001600160a01b036113a1613e15565b168152600d83522054604051908152f35b503461044b57602036600319011261044b5760055460043591906001600160a01b031633036113e7575b602061085883615115565b906001600160401b0360075416916127109283039283116114195750611412602092610858926151ae565b91506113dc565b634e487b7160e01b81526011600452602490fd5b503461044b57602036600319011261044b57611447615078565b5f80516020615e0c833981519152546040516370a0823160e01b815230600482015282917386d7f797636bd55fa3ad55b8c6954631c70c0f4e9190602090829060249082906001600160a01b03165afa908115610d575783916114fb575b5060ff60055460a01c16823b156114f657608484926040519485938492633eb4e02160e11b84526006600485015260248401526004356044840152151560648301525af4801561059457610ede5750f35b505050fd5b9250506020823d602011611528575b8161151760209383613f2f565b81010312610f1b578291515f6114a5565b3d915061150a565b503461044b578060031936011261044b576020610858614b56565b503461044b57604036600319011261044b57611572611568613e15565b60243590336152ba565b602060405160018152f35b503461044b578060031936011261044b5760209054604051908152f35b503461044b57602036600319011261044b576020610858336004356148f0565b503461044b57604036600319011261044b576115d4613e15565b60406115de613e2b565b9260018060a01b038093168152600e6020522091165f52602052602060405f2054604051908152f35b503461044b578060031936011261044b576020600454604051908152f35b503461044b578060031936011261044b576001546040516001600160a01b039091168152602090f35b503461044b578060031936011261044b576040519080825f80516020615dac83398151915292835461167f8161418d565b93848452602095600192876001821691825f1461170d5750506001146116c7575b5050506116af92500383613f2f565b6116c3604051928284938452830190613dd7565b0390f35b8152859250905f80516020615e6c8339815191525b8583106116f55750506116af93508201015f80806116a0565b805483890185015287945086939092019181016116dc565b9350945050506116af94915060ff191682840152151560051b8201015f80806116a0565b503461044b57604036600319011261044b576020610858611750613e2b565b6004356148f0565b503461044b578060031936011261044b575f80516020615dcc833981519152546040516001600160a01b039091168152602090f35b503461044b57602036600319011261044b576117a7613e15565b6117af615078565b60ff60125416156109e6576001600160a01b03168082526011602052604082205460ff161561181357808252601160205260408220805460ff191690557fe285bb51ee9ef78b36fb9eca52aede9c9f4234d2bb72917200f87005edb25a558280a280f35b60249060405190632e6eba8560e11b82526004820152fd5b503461044b57602036600319011261044b577f522d3c2ddc88f29bac386c82e605c5bf322d91aa85997ef97a688539d9d6033360ff611868613dc8565b611870615078565b6118a2601054918381151516841984161760105560405193849316839092916020906040830194151583521515910152565b0390a180f35b503461044b578060031936011261044b578054158015611997575b61198e575b5f80516020615e4c83398151915260ff81541615611929575b6118e9615078565b6118f161554d565b600160ff198254161790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586020604051338152a180f35b6119346105ce614b56565b61193c6150e3565b61194461409a565b906002548111611985575b508115158061197c575b611965575b50506118e1565b611971916106196143ff565b426004555f8061195e565b50801515611959565b6002555f61194f565b426004556118c8565b506119a06143ff565b156118c3565b503461044b57604036600319011261044b576119c0615078565b807386d7f797636bd55fa3ad55b8c6954631c70c0f4e60ff60055460a01c166024602060018060a01b035f80516020615e0c8339815191525416604051928380926370a0823160e01b82523060048301525afa908115610f27578491611a71575b50823b156114f65760a4849260405194859384926312967a2960e31b845260066004850152151560248401526044830152600435606483015260243560848301525af4801561059457610ede5750f35b9350506020833d602011611a9e575b81611a8d60209383613f2f565b81010312610f1b578392515f611a21565b3d9150611a80565b503461044b57602036600319011261044b57611ac0613dc8565b611ac8615078565b6005546040805160ff60a884901c161515815283151560208201529192917ffdc806f366660aa3e77ed7f1da541577007de0e4b7e0c5d351ae99d2d01cc8f39190a160ff60a81b1990911690151560a81b60ff60a81b161760055580f35b503461044b57602036600319011261044b57611b40613e15565b604051630274467d60e11b8152600c6004820152600f60248201526001600160a01b039091166044820152818160648173f6880a04a5df3ba54e5d196471927daa4fcfc2d95af490811561059457826116c39392611ba7575b505060405191829182613e41565b611bc392503d8091833e611bbb8183613f2f565b8101906141c5565b5f80611b99565b503461044b578060031936011261044b57611be3615078565b5f80516020615dcc83398151915280546001600160a01b031981169091555f906001600160a01b03167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08280a380f35b503461044b57602036600319011261044b576020906040906001600160a01b03611c5b613e15565b1681525f80516020615d8c83398151915283522054604051908152f35b503461044b57604036600319011261044b576020610858611c97613e2b565b6004356145d7565b503461044b578060031936011261044b57611cb8615078565b6005546040805160ff60a084901c16158015825260208201819052917f40f0175b5fde6802a96ba1ba9eeaaa9564b53a1c021b6fcde51422b574abcdbd91a160ff60a01b1990911660a09190911b60ff60a01b161760055580f35b503461044b57602036600319011261044b57611d2d615078565b807386d7f797636bd55fa3ad55b8c6954631c70c0f4e803b15611d7d57816044916040519283809263dd40c63b60e01b82526006600483015260043560248301525af4801561059457610ede5750f35b50fd5b503461044b57602090600319602081360112610680576001600160401b0390600435828111611f8d57608081360392830112611f8d578354158015611fff575b611ff6575b60ff5f80516020615e4c833981519152541615611f91575b611de5615078565b82611df2826004016145c3565b16600754906fffffffffffffffff0000000000000000611e14602485016145c3565b60401b169067ffffffffffffffff60801b611e31604486016145c3565b60801b16926001600160401b0360c01b1617171760075560648101359160221901821215611f8d570190600482013591818311611f8d5760240160609060608402360381136105bf57600160401b8411611f795760085484600855808510611ef9575b506008855284925f80516020615dec833981519152915b858510611eba57864260045580f35b600384826001933586558a810135848701556002860185611edd604084016145c3565b166001600160401b031982541617905501930194019391611eab565b60039080600302906003820403611f655785600302600381048703611f51575f80516020615dec83398151915291820191015b818110611f3a575050611e94565b808884925588600182015588600282015501611f2c565b634e487b7160e01b88526011600452602488fd5b634e487b7160e01b87526011600452602487fd5b634e487b7160e01b85526041600452602485fd5b8380fd5b611f9c6105ce614b56565b611fa46150e3565b611fac61409a565b906002548111611fed575b5081151580611fe4575b611fcd575b5050611ddd565b611fd9916106196143ff565b426004555f80611fc6565b50801515611fc1565b6002555f611fb7565b42600455611dc5565b506120086143ff565b15611dc0565b503461044b578060031936011261044b57612027615078565b807386d7f797636bd55fa3ad55b8c6954631c70c0f4e803b15611d7d5781602491604051928380926356380c2b60e01b8252600660048301525af4801561059457610ede5750f35b503461044b578060031936011261044b57602060ff5f80516020615e4c83398151915254166040519015158152f35b503461044b57602080600319360112610680576120b9613e15565b6120c1615078565b6001600160a01b039081169182156122b6575f80516020615e0c83398151915254600a5483169216826121f5575b60405163095ea7b360e01b80848301528560248301525f19918260448201526044815261211b81613ecb565b6121258185615bcb565b9182156121aa575b505015806121a2575b61217e575050907f8a8682c8e0b406a8cfcc7c7c4ac90372d088ddb8dfaf1baea5435b69e832a43a839260405160018152a36001600160601b0360a01b600a541617600a5580f35b606492508460405192632d28f16360e21b8452600484015260248301526044820152fd5b506001612136565b6121d791925060405190868201528760248201525f6044820152604481526121d181613ecb565b84615bcb565b90816121e4575b8061212d565b6121ef915083615bcb565b5f6121de565b60405163095ea7b360e01b9081848201528460248201525f60448201526044815261221f81613ecb565b6122298184615bcb565b91821561226b575b50501580612263575b156120ef576064908360405191632d28f16360e21b8352600483015260248201525f6044820152fd5b50600161223a565b61229891925060405190858201528560248201525f60448201526044815261229281613ecb565b83615bcb565b90816122a5575b80612231565b6122b0915082615bcb565b5f61229f565b60405163dd2fe90160e01b8152600490fd5b5034610f1b575f366003190112610f1b576122e1615078565b60ff60055460a01c166123cb575f80516020615e0c833981519152546040516370a0823160e01b81523060048201527386d7f797636bd55fa3ad55b8c6954631c70c0f4e91602090829060249082906001600160a01b03165afa90811561238e575f91612399575b50813b15610f1b575f906044604051809481936338abfe2b60e01b83526006600484015260248301525af4801561238e57612382575080f35b61238c9150613f1c565b005b6040513d5f823e3d90fd5b90506020813d6020116123c3575b816123b460209383613f2f565b81010312610f1b57515f612349565b3d91506123a7565b6040516303eb29d960e01b8152600490fd5b34610f1b576020366003190112610f1b576123f6613e15565b6123fe615078565b6009546040516344401bd560e01b81526001600160a01b03918216600482015291811660248301529060208160448173b64bd6df349823d883146980421c876ffa14e6d95af490811561238e575f9161246b575b50166001600160601b0360a01b60095416176009555f80f35b90506020813d60201161249e575b8161248660209383613f2f565b81010312610f1b57518181168103610f1b5782612452565b3d9150612479565b34610f1b575f366003190112610f1b57602060ff601254166040519015158152f35b34610f1b576020366003190112610f1b576020610858600435614584565b34610f1b575f366003190112610f1b57600a546040516001600160a01b039091168152602090f35b34610f1b575f366003190112610f1b576005546040516001600160a01b039091168152602090f35b34610f1b575f366003190112610f1b5761254e6153b8565b5f541580156125fe575b6125f5575b60ff5f80516020615e4c833981519152541615612590575b61257d615078565b60015f80516020615e8c83398151915255005b61259b6105ce614b56565b6125a36150e3565b6125ab61409a565b9060025481116125ec575b50811515806125e3575b6125cc575b5050612575565b6125d8916106196143ff565b4260045580806125c5565b508015156125c0565b600255826125b6565b4260045561255d565b506126076143ff565b15612558565b34610f1b576020366003190112610f1b57602061085861262b613e15565b614516565b34610f1b575f366003190112610f1b575f54158015612731575b612728575b5f80516020615e4c83398151915260ff815416156126c3575b612670615078565b805460ff8116156126b15760ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa6020604051338152a142600455005b604051638dfc202b60e01b8152600490fd5b6126ce6105ce614b56565b6126d66150e3565b6126de61409a565b90600254811161271f575b5081151580612716575b6126ff575b5050612668565b61270b916106196143ff565b4260045581806126f8565b508015156126f3565b600255836126e9565b4260045561264f565b5061273a6143ff565b1561264a565b34610f1b576020366003190112610f1b57602061276361275e613e15565b615489565b6040519015158152f35b34610f1b575f366003190112610f1b575f80516020615e0c833981519152546040516001600160a01b039091168152602090f35b34610f1b575f366003190112610f1b5760206108586144aa565b34610f1b575f366003190112610f1b576009546040516001600160a01b039091168152602090f35b34610f1b575f366003190112610f1b5761238c336153e7565b34610f1b57610120366003190112610f1b576004356001600160a01b0381169003610f1b576024356001600160401b038111610f1b57612840903690600401613fa1565b6044356001600160401b038111610f1b5761285f903690600401613fa1565b6064356001600160401b038111610f1b5736602382011215610f1b5780600401359061288a82613fbf565b906128986040519283613f2f565b82825260208201906024606083950282010190368211610f1b57602401915b8183106131d35750506084359290506001600160a01b0383168303610f1b5760a4356001600160401b038111610f1b5760806003198236030112610f1b576040519061290282613ecb565b61290e81600401613fd6565b825261291c60248201613fd6565b602083015261292d60448201613fd6565b60408301526064810135906001600160401b038211610f1b57366023838301011215610f1b576004828201013561296381613fbf565b926129716040519485613f2f565b818452602084019236602460608502848401010111610f1b5780820160240193915b6024606085028284010101851061318a575050505050606082015260e4356001600160a01b0381169003610f1b5761010435948515158603610f1b575f80516020615eac83398151915254966001600160401b038816158061317c575b60016001600160401b038a16149081613172575b159081613169575b506131575760016001600160401b03198916175f80516020615eac8339815191525560ff8860401c161561312b575b612a436153b8565b612a4b615c12565b612a53615c12565b5f80516020615e4c833981519152805460ff19169055612a71615c12565b612a79615c12565b612a84600435615c6f565b9015613123575b5f80516020615e0c83398151915280546001600160a81b03191660a09290921b60ff60a01b16919091176004356001600160a01b0316179055612acc615c12565b612ad4615c12565b8051906001600160401b038211612ffd578190612afe5f80516020615d6c8339815191525461418d565b601f81116130a8575b50602090601f831160011461301c575f92613011575b50508160011b915f199060031b1c1916175f80516020615d6c833981519152555b8051906001600160401b038211612ffd578190612b685f80516020615dac8339815191525461418d565b601f8111612f82575b50602090601f8311600114612ef6575f92612eeb575b50508160011b915f199060031b1c1916175f80516020615dac833981519152555b612bb0615c12565b612bb8615c12565b612bc360e435615007565b612bcb615c12565b612bd3615c12565b60015f80516020615e8c833981519152556004356001600160a01b031615612ed95760015460405163c03e99d960e01b81526001600160a01b03600480358216908301526009602483015260e06044830152945160e48201819052909485946101048601949391909116915f5b818110612ea1575050506064840152600660848401526003198383030160a4840152602060a0606060808501936001600160401b0381511686526001600160401b038482015116848701526001600160401b036040820151166040870152015193608060608201528451809452019201905f5b818110612e60575050509080604092600760c4830152038173ff1773d975da0c000888c5715b7cf38968ff78195af490811561238e575f905f92612e15575b50600180546001600160a81b03191660a09390931b60ff60a01b16929092176001600160a01b039182161790915581161561091c5760058054633b9aca0060025560c4356003556010805494151560ff90811660ff1996871617909155601280549095169094556001600160b01b0319166001600160a01b039283161790554260049081556040519391903516307f3cd5ec01b1ae7cfec6ca1863e2cd6aa25d6d1702825803ff2b7cc95010fffdc25f80a360015f80516020615e8c8339815191525560401c1615612dc057005b60207fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29168ff0000000000000000195f80516020615eac83398151915254165f80516020615eac8339815191525560018152a1005b9150506040813d604011612e58575b81612e3160409383613f2f565b81010312610f1b576020612e448261401f565b9101519060ff82168203610f1b5785612cf2565b3d9150612e24565b919350916020606082612e9360019488516001600160401b03604080928051855260208101516020860152015116910152565b019401910191849392612cb3565b825180516001600160a01b03168752602090810151805182890152810151604088015288975060609096019590920191600101612c40565b604051630ccd248560e21b8152600490fd5b015190508880612b87565b92505f80516020615dac8339815191525f525f80516020615e6c833981519152905f935b601f1984168510612f67576001945083601f19811610612f4f575b505050811b015f80516020615dac83398151915255612ba8565b01515f1960f88460031b161c19169055888080612f35565b81810151835560209485019460019093019290910190612f1a565b9091505f80516020615dac8339815191525f52601f830160051c5f80516020615e6c8339815191520160208410612fe9575b908392915b601f820160051c5f80516020615e6c833981519152018110612fdb5750612b71565b5f8155849350600101612fb9565b505f80516020615e6c833981519152612fb4565b634e487b7160e01b5f52604160045260245ffd5b015190508980612b1d565b92505f80516020615d6c8339815191525f525f80516020615d4c833981519152905f935b601f198416851061308d576001945083601f19811610613075575b505050811b015f80516020615d6c83398151915255612b3e565b01515f1960f88460031b161c1916905589808061305b565b81810151835560209485019460019093019290910190613040565b9091505f80516020615d6c8339815191525f52601f830160051c5f80516020615d4c833981519152016020841061310f575b908392915b601f820160051c5f80516020615d4c8339815191520181106131015750612b07565b5f81558493506001016130df565b505f80516020615d4c8339815191526130da565b506012612a8b565b68ffffffffffffffffff19881668010000000000000001175f80516020615eac83398151915255612a3b565b60405163f92ee8a960e01b8152600490fd5b90501589612a0c565b303b159150612a04565b5060ff8860401c16156129f0565b606085360312610f1b5760608060206024956040516131a881613ee6565b89358152828a0135838201526131c060408b01613fd6565b6040820152815201960195935050612993565b82360360608112610f1b57604051906131eb82613f01565b8435906001600160a01b0382168203610f1b576040918352601f190112610f1b5760609160209160405161321e81613f01565b838701358152604087013584820152838201528152019201916128b7565b34610f1b575f366003190112610f1b57602060ff60015460a01c16604051908152f35b34610f1b576020366003190112610f1b5760206108583333600435614bc4565b34610f1b576020366003190112610f1b576004356001600160401b038111610f1b5736602382011215610f1b5780600401356001600160401b038111610f1b5760249181810190838201368111610f1b576132d86153b8565b6132e0615078565b60609260609461355f575b5050506132f66143ff565b916060928251600692600654945f5b868110613343577f429eabcd6b69e5ca232c6a9d2c5af1805e375e951df8e9bfe831b445e5f69b2b5f80a160015f80516020615e8c83398151915255005b5f5b8481106134fc575b5085548110156134e957855f5261339f5f8960018060a01b03600385025f80516020615e2c8339815191520154168c83604051809681958294630aa0465b60e21b845260206004850152830190613dd7565b03925af190811561238e575f916134cf575b508051905f5b8281106133c957505050600101613305565b60206133d58284614475565b510151906001600160a01b036133eb8285614475565b515116826133ff575b5060019150016133b7565b805f52600d60205260405f20541561344d575b6001928a80613423575b50506133f4565b61342c916159f2565b905f52600d60205261344360405f2091825461449d565b90558d808a61341c565b600c5492600160401b8410156134bc576001840180600c558410156134a957600c5f527fdf6966c971051c3d54ec59162606531493a51404a002842f56009d7e5cf4a8c790930180546001600160a01b03191682179055613412565b8e634e487b7160e01b5f5260326004525ffd5b8e634e487b7160e01b5f5260416004525ffd5b6134e391503d805f833e611bbb8183613f2f565b8a6133b1565b88634e487b7160e01b5f5260326004525ffd5b9750806135098984614475565b511461354c5760405160208101908082106001600160401b03831117613539576001916040525f81529801613345565b8a634e487b7160e01b5f5260416004525ffd5b966135579083614475565b51968961334d565b8294506040929193500312610f1b57828201356001600160401b038111610f1b5782019080604383011215610f1b57838201359260449261359f85613fbf565b946135ad6040519687613f2f565b80865284602087019160051b83010191848311610f1b578501905b82821061367d5750505082810135906001600160401b038211610f1b570181604382011215610f1b5784810135926135ff84613fbf565b9361360d6040519586613f2f565b80855281602086019160051b84010192848411610f1b57828101915b84831061363f57505050505050908380806132eb565b82356001600160401b038111610f1b57820186606382011215610f1b576020916136728883606489879601359101613f6b565b815201920191613629565b81358152602091820191016135c8565b34610f1b576060366003190112610f1b576115726136a9613e15565b6136b1613e2b565b604435916136c0833383615222565b6152ba565b34610f1b575f366003190112610f1b576020600254604051908152f35b34610f1b576040366003190112610f1b576136fb613e15565b613703613e2b565b9060018060a01b038091165f52600f60205260405f2091165f52602052602060405f2054604051908152f35b34610f1b575f366003190112610f1b576020600b54604051908152f35b34610f1b575f366003190112610f1b5760206108586143ff565b34610f1b575f366003190112610f1b5760405161378281613ecb565b5f81526020905f828201525f604082015260608080920152604051916137a783613ecb565b600754916001600160401b0393848416815282810193858160401c16855285604083019160801c168152600854906137de82613fbf565b916137ec6040519384613f2f565b80835285830160085f525f80516020615dec8339815191525f915b8383106138a657505050508690606084019283526040519788978789528160a08a01965116888a01525116604088015251166060860152519260808086015283518092528060c086019401925f905b8382106138635786860387f35b91849650828661389660019496988498516001600160401b03604080928051855260208101516020860152015116910152565b0196019201869594929391613856565b60038960019260409d98999b9a9c9d516138bf81613ee6565b85548152848601548382015289600287015416604082015281520192019201919099989697959499613807565b34610f1b575f366003190112610f1b57602060ff601054166040519015158152f35b34610f1b575f366003190112610f1b57602060ff60055460a01c166040519015158152f35b34610f1b575f366003190112610f1b5760206108586142dc565b34610f1b576020366003190112610f1b57613969600435615148565b6005546001600160a01b031633146139b8576001600160401b0360075460401c16906127109182039182116139a4576020916108589161595d565b634e487b7160e01b5f52601160045260245ffd5b602090610858565b34610f1b576040366003190112610f1b576139d9613e15565b602435903315613a57576001600160a01b0316908115613a3f576139fc33613e93565b825f526020528060405f20556040519081527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560203392a3602060405160018152f35b604051634a1406b160e11b81525f6004820152602490fd5b60405163e602df0560e01b81525f6004820152602490fd5b34610f1b576020366003190112610f1b5760206108586004356150b0565b34610f1b576020366003190112610f1b576001600160a01b03613aae613e15565b16805f525f80516020615d8c83398151915260205260405f205490604051916313d6991d60e31b83526004830152602482015260a060448201525f8180613af760a4820161426b565b600d6064830152600e6084830152038173f6880a04a5df3ba54e5d196471927daa4fcfc2d95af4801561238e576116c3915f91613b3c575b5060405191829182613e41565b613b5091503d805f833e611bbb8183613f2f565b82613b2f565b34610f1b575f366003190112610f1b576040515f80516020615d6c8339815191528054825f613b848361418d565b92838352602094600191866001821691825f14613bfa575050600114613bb3575b50506116af92500383613f2f565b8592505f525f80516020615d4c833981519152905f915b858310613be25750506116af93508201018580613ba5565b80548389018501528794508693909201918101613bca565b92509350506116af94915060ff191682840152151560051b8201018580613ba5565b34610f1b576020366003190112610f1b57613c35613dc8565b613c3d615078565b6012546040805160ff8084161515825284151560208301529293917f7a9ce9fadfad7fa30c993357b27d46d599daf8af9d701ff8efebdbcf40bb344591a160ff199092169115151617601255005b34610f1b575f366003190112610f1b57602061085861409a565b34610f1b576040366003190112610f1b57600435613cc1613db9565b613cc9615078565b600654821015613da0575f80516020615e0c833981519152546001546040516309a0b6b360e31b8152600660048201526001600160a01b0392831660248201526044810194909452911515606484015290811660848301529060208160a4817386d7f797636bd55fa3ad55b8c6954631c70c0f4e5af490811561238e575f91613d66575b50166001600160601b0360a01b60015416176001555f80f35b90506020813d602011613d98575b81613d8160209383613f2f565b81010312610f1b57613d929061401f565b82613d4d565b3d9150613d74565b60405163042a2e7160e11b815260048101839052602490fd5b602435908115158203610f1b57565b600435908115158203610f1b57565b91908251928382525f5b848110613e01575050825f602080949584010152601f8019910116010190565b602081830181015184830182015201613de1565b600435906001600160a01b0382168203610f1b57565b602435906001600160a01b0382168203610f1b57565b60208082019080835283518092528060408094019401925f905b838210613e6a57505050505090565b845180516001600160a01b03168752830151868401529485019493820193600190910190613e5b565b6001600160a01b03165f9081527f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace016020526040902090565b608081019081106001600160401b03821117612ffd57604052565b606081019081106001600160401b03821117612ffd57604052565b604081019081106001600160401b03821117612ffd57604052565b6001600160401b038111612ffd57604052565b90601f801991011681019081106001600160401b03821117612ffd57604052565b6001600160401b038111612ffd57601f01601f191660200190565b929192613f7782613f50565b91613f856040519384613f2f565b829481845281830111610f1b578281602093845f960137010152565b9080601f83011215610f1b57816020613fbc93359101613f6b565b90565b6001600160401b038111612ffd5760051b60200190565b35906001600160401b0382168203610f1b57565b6060906003190112610f1b57600435906001600160a01b03906024358281168103610f1b57916044359081168103610f1b5790565b51906001600160a01b0382168203610f1b57565b6006549081815260208091019160065f525f80516020615e2c833981519152915f905b828210614064575050505090565b83546001600160a01b03168552600180850154868301526002850154604087015260609095019460039094019390910190614056565b5f80516020615e0c833981519152546040516370a0823160e01b81523060048201526020918290829060249082906001600160a01b03165afa90811561238e575f91614160575b5060405190635aafb00160e11b825260048201526040602482015281818061410b60448201614033565b038173e974c9e967e63701a889c7defbb49c6d7432475f5af491821561238e575f9261413657505090565b90809250813d8311614159575b61414d8183613f2f565b81010312610f1b575190565b503d614143565b90508181813d8311614186575b6141778183613f2f565b81010312610f1b57515f6140e1565b503d61416d565b90600182811c921680156141bb575b60208310146141a757565b634e487b7160e01b5f52602260045260245ffd5b91607f169161419c565b906020918281830312610f1b578051906001600160401b038211610f1b570181601f82011215610f1b578051926141fb84613fbf565b9360409361420c6040519687613f2f565b818652828087019260061b85010193818511610f1b578301915b8483106142365750505050505090565b8583830312610f1b57838691825161424d81613f01565b6142568661401f565b81528286015183820152815201920191614226565b600c5490818152602080910191600c5f527fdf6966c971051c3d54ec59162606531493a51404a002842f56009d7e5cf4a8c7915f905b8282106142af575050505090565b83546001600160a01b0316855293840193600193840193909101906142a1565b919082039182116139a457565b6142e46150e3565b6142ec61409a565b906002906002549160018060a01b035f80516020615e0c83398151915254169260409260405195869463aabbf18d60e01b865260c4860160c0600488015260085480915260e487019560085f525f80516020615dec833981519152925f915b8383106143c757505050505091602095918594936024860152604485015260648401526084830152600760a48301520381736a7bdc827eb3669af20d3d55dcf3af1b5691ea2e5af490811561238e575f916143a4575090565b90506020813d6020116143bf575b8161414d60209383613f2f565b3d91506143b2565b8454895260018086015460208b0152858201546001600160401b03168a8401528c9a506060909901986003909501949092019161434b565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0254600954604051632389621360e11b815260048101929092526001600160a01b0316602482015260208160448173e974c9e967e63701a889c7defbb49c6d7432475f5af490811561238e575f916143a4575090565b80518210156144895760209160051b010190565b634e487b7160e01b5f52603260045260245ffd5b919082018092116139a457565b5f80516020615e0c83398151915254604080516369e4822760e01b81526001600160a01b0390921660048301526024820152602081806144ec60448201614033565b038173b64bd6df349823d883146980421c876ffa14e6d95af490811561238e575f916143a4575090565b60ff5f80516020615e4c8339815191525416908115614573575b508015614569575b8015614556575b15614548575f90565b613fbc60035461085261409a565b5061455f61409a565b600354111561453f565b5060035415614538565b61457d9150615489565b155f614530565b6005546001600160a01b031633146145ba576145b5613fbc916108526001600160401b0360075460401c16826151ee565b6150b0565b613fbc906150b0565b356001600160401b0381168103610f1b5790565b6145df6153b8565b6145e761554d565b60ff6012541680614850575b614838575f54158015614829575b614820575b60ff5f80516020615e4c8339815191525416156147bb575b61462782615577565b6146388161463361409a565b61449d565b600354106147a9576005546001600160a01b0390339082160361475d5761465e8261517b565b925b6305f5e10084111561474b5761467684826154ba565b61469483835f80516020615e0c833981519152541630903390615593565b60ff60055460a01c16156146eb575b60405192835283602084015216907fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d760403392a39060015f80516020615e8c83398151915255565b7386d7f797636bd55fa3ad55b8c6954631c70c0f4e803b15610f1b575f604051809263ed9add7360e01b82528180614727308a60048401614867565b03915af4801561238e5761473c575b506146a3565b61474590613f1c565b5f614736565b604051631f2a200560e01b8152600490fd5b61477561084d6001600160401b0360075416846151ee565b92614788846147838561517b565b6142cf565b9380614795575b50614660565b6147a39083600554166154ba565b5f61478f565b604051631264675f60e01b8152600490fd5b6147c66105ce614b56565b6147ce6150e3565b6147d661409a565b906002548111614817575b508115158061480e575b6147f7575b505061461e565b614803916106196143ff565b426004555f806147f0565b508015156147eb565b6002555f6147e1565b42600455614606565b506148326143ff565b15614601565b604051632e6eba8560e11b8152336004820152602490fd5b50335f52601160205260ff60405f205416156145f3565b909291608082016080835260065480915260a083019060065f525f80516020615e2c833981519152905f5b8181106148bc5750505060208301949094526001600160a01b031660408201526001606090910152565b82546001600160a01b0316845260018084015460208601526002840154604086015260609094019360039093019201614892565b6148f86153b8565b61490061554d565b60ff6012541680614b3f575b614838575f54158015614b30575b614b27575b60ff5f80516020615e4c833981519152541615614ac2575b61494082615577565b6305f5e10081111561474b576007546005546001600160a01b03916001600160401b03169082163314614aba576127109081039081116139a4578261478361498892826151ae565b925b61499c614997858561449d565b615115565b936149a98561463361409a565b600354106147a9576149ba82614516565b85116147a95780614aa6575b506149d183826154ba565b6149ef84835f80516020615e0c833981519152541630903390615593565b60ff60055460a01c1615614a46575b60405192848452602084015216907fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d760403392a39060015f80516020615e8c83398151915255565b7386d7f797636bd55fa3ad55b8c6954631c70c0f4e803b15610f1b575f604051809263ed9add7360e01b82528180614a82308b60048401614867565b03915af4801561238e57614a97575b506149fe565b614aa090613f1c565b5f614a91565b614ab49083600554166154ba565b5f6149c6565b505f9261498a565b614acd6105ce614b56565b614ad56150e3565b614add61409a565b906002548111614b1e575b5081151580614b15575b614afe575b5050614937565b614b0a916106196143ff565b426004555f80614af7565b50801515614af2565b6002555f614ae8565b4260045561491f565b50614b396143ff565b1561491a565b50335f52601160205260ff60405f2054161561490c565b614b5e61554d565b6001600160401b0360075460801c16614b7561409a565b6004549060405192632740b27d60e21b8452600484015260248301526044820152602081606481736a7bdc827eb3669af20d3d55dcf3af1b5691ea2e5af490811561238e575f916143a4575090565b919091614bcf6153b8565b614bd761554d565b60ff6012541680614d43575b614838575f54158015614d34575b614d2b575b60ff5f80516020615e4c833981519152541615614cc6575b6001600160a01b039183831615614cb457614c2881615895565b82116147a957614c3782615148565b906305f5e10082111561474b576001600160401b0360075460401c1693600554163314155f14614ca4576127109384039384116139a457614c89614c8283614783614c9097826151ae565b809361449d565b9485615656565b9060015f80516020615e8c83398151915255565b614c909350614c895f809361449d565b604051634e46966960e11b8152600490fd5b614cd16105ce614b56565b614cd96150e3565b614ce161409a565b906002548111614d22575b5081151580614d19575b614d02575b5050614c0e565b614d0e916106196143ff565b426004555f80614cfb565b50801515614cf6565b6002555f614cec565b42600455614bf6565b50614d3d6143ff565b15614bf1565b50335f52601160205260ff60405f20541615614be3565b9190915f91614d676153b8565b614d6f61554d565b60ff6012541680614ef7575b614838575f54158015614ee8575b614edf575b60ff5f80516020615e4c833981519152541615614e7a575b73e974c9e967e63701a889c7defbb49c6d7432475f614dc482614f7a565b90803b15610f1b576040516383ff48f560e01b81526001600160a01b03871660048201526024810185905260448101929092525f90829060649082905af4801561238e57614e67575b506305f5e10082111561474b57600554614c9093906001600160a01b03163314614e615750614e4a6001600160401b0360075460401c16836151ee565b905b614e596145b583856142cf565b948593615656565b90614e4c565b614e72919350613f1c565b5f915f614e0d565b614e856105ce614b56565b614e8d6150e3565b614e9561409a565b906002548111614ed6575b5081151580614ecd575b614eb6575b5050614da6565b614ec2916106196143ff565b426004555f80614eaf565b50801515614eaa565b6002555f614ea0565b42600455614d8e565b50614ef16143ff565b15614d89565b50335f52601160205260ff60405f20541615614d7b565b60ff5f80516020615e4c8339815191525416908115614f6f575b8115614f5e575b50614f5a576003545f19808214614f555750614f4d613fbc9161517b565b6108526143ff565b905090565b5f90565b614f689150615489565b155f614f2f565b600354159150614f28565b60ff5f80516020615e4c83398151915254168015614ff8575b8015614fe8575b614fe3576001600160a01b039081165f9081525f80516020615d8c8339815191526020526040902054600954909116613fbc57614fd86106f36144aa565b818110614f55575090565b505f90565b50614ff281615489565b15614f9a565b5060ff60055460a81c16614f93565b6001600160a01b03908116908115615060575f80516020615dcc83398151915280546001600160a01b031981168417909155167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e05f80a3565b604051631e4fbdf760e01b81525f6004820152602490fd5b5f80516020615dcc833981519152546001600160a01b0316330361509857565b60405163118cdaa760e01b8152336004820152602490fd5b6150b861409a565b600181018091116139a4576150cb6143ff565b90633b9aca0082018092116139a457613fbc92615b58565b6150eb61409a565b600181018091116139a4576150fe6143ff565b633b9aca0081018091116139a457613fbc91615adc565b61511d61409a565b600181018091116139a4576151306143ff565b90633b9aca0082018092116139a457613fbc92615206565b6151506143ff565b633b9aca0081018091116139a45761516661409a565b90600182018092116139a457613fbc92615206565b6151836143ff565b633b9aca0081018091116139a45761519961409a565b90600182018092116139a457613fbc92615b58565b906151b9818361595d565b9181156151da5761271090096151cc5790565b600181018091116139a45790565b634e487b7160e01b5f52601260045260245ffd5b90612710906151fd8184615a74565b92096151cc5790565b9190615213828285615b58565b9282156151da57096151cc5790565b61522b81613e93565b9060018060a01b0380841692835f5260205260405f2054935f198503615254575b505050505050565b8585106152895750811615613a57578115613a3f5761527290613e93565b905f526020520360405f20555f808080808061524c565b604051637dc7a0d960e11b81526001600160a01b039190911660048201526024810185905260448101869052606490fd5b90916001600160a01b03808316929083156153a0578416938415615388576152ea906152e5836153e7565b6153e7565b825f525f80516020615d8c8339815191528060205260405f205491838310615355575091806020927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef94865f5284520360405f2055845f5260405f20818154019055604051908152a3565b60405163391434e360e21b81526001600160a01b0391909116600482015260248101929092525060448101829052606490fd5b60405163ec442f0560e01b81525f6004820152602490fd5b604051634b637e8f60e11b81525f6004820152602490fd5b5f80516020615e8c83398151915260028154146153d55760029055565b604051633ee5aeb560e01b8152600490fd5b6001600160a01b03165f8181525f80516020615d8c833981519152602052604090205473f6880a04a5df3ba54e5d196471927daa4fcfc2d990813b15610f1b575f91604051938492631cdd916360e01b84526004840152602483015260c06044830152818061545860c4820161426b565b600d6064830152600e6084830152600f60a483015203915af4801561238e5761547e5750565b61548790613f1c565b565b60ff601254161590811561549b575090565b6001600160a01b03165f9081526011602052604090205460ff16919050565b6001600160a01b0381169182156153885760207fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef916154f95f946153e7565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0261552582825461449d565b90558484525f80516020615d8c833981519152825260408420818154019055604051908152a3565b60ff5f80516020615e4c833981519152541661556557565b60405163d93c066560e01b8152600490fd5b6001600160a01b031615614cb4575f541561558e57565b425f55565b6040516323b872dd60e01b602082019081526001600160a01b0393841660248301529383166044820152606480820195909552938452909160a08401906001600160401b03821185831017612ffd57615604935f9384936040521694519082865af16155fd615c40565b9083615ce8565b8051908115159182615632575b505061561a5750565b60249060405190635274afe760e01b82526004820152fd5b8192509060209181010312610f1b5760200151801590811503610f1b575f80615611565b939190929360ff60055460a81c16615883576001600160a01b038281169533879003615873575b86156153a05761568c846153e7565b865f525f80516020615d8c8339815191529384602052604094855f2054918583106158415750908491895f5260205203845f20557f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace028381540390555f877fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60208751878152a38061582e575b6157206144aa565b9561574073b64bd6df349823d883146980421c876ffa14e6d992856142cf565b91835f80516020615e0c833981519152541692846009541693600b5486600a54169060ff6010541690853b15610f1b575f978c948c519a8b998a98899863a49fe6f760e01b8a5260048a01526024890152169e8f60448801526064870152608486015260a485015260c484015261014060e48401526157c26101448401614033565b91610104840152151561012483015203915af4801561582457907ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db939291615815575b50815193845260208401523392a4565b61581e90613f1c565b5f615805565b83513d5f823e3d90fd5b61583c8183600554166154ba565b615718565b865163391434e360e21b81526001600160a01b0391909116600482015260248101929092525060448101849052606490fd5b61587e833386615222565b61567d565b604051636022a9e760e01b8152600490fd5b60ff5f80516020615e4c8339815191525416801561594e575b801561593e575b614fe3576001600160a01b039081165f9081525f80516020615d8c83398151915260205260409020546158e7906150b0565b6158fe6158f56105ce614b56565b8261064b61409a565b6001600160401b0360075460401c16916127109283039283116139a4576159289261478391615a74565b600954909116156159365790565b614fd86144aa565b5061594881615489565b156158b5565b5060ff60055460a81c166158ae565b61271091818302915f19848209938380861095039480860395146159e457848311156159d257829109815f038216809204600280826003021880830282030280830282030280830282030280830282030280830282030280920290030293600183805f03040190848311900302920304170290565b60405163227bc15360e01b8152600490fd5b5050809250156151da570490565b6ec097ce7bc90715b34b9f100000000091818302915f19848209938380861095039480860395146159e457848311156159d257829109815f038216809204600280826003021880830282030280830282030280830282030280830282030280830282030280920290030293600183805f03040190848311900302920304170290565b90808202905f1981840990828083109203918083039214615ad15761271090828211156159d2577fbc01a36e2eb1c432ca57a786c226809d495182a9930be0ded288ce703afb7e91940990828211900360fc1b910360041c170290565b505061271091500490565b90670de0b6b3a764000080830291905f19848209938380861095039480860395146159e457848311156159d257829109815f038216809204600280826003021880830282030280830282030280830282030280830282030280830282030280920290030293600183805f03040190848311900302920304170290565b9091828202915f19848209938380861095039480860395146159e457848311156159d257829109815f038216809204600280826003021880830282030280830282030280830282030280830282030280830282030280920290030293600183805f03040190848311900302920304170290565b905f602091828151910182855af1903d5f519083615bea575b50505090565b91925090615c0857506001600160a01b03163b15155b5f8080615be4565b6001915014615c00565b60ff5f80516020615eac8339815191525460401c1615615c2e57565b604051631afcd79f60e31b8152600490fd5b3d15615c6a573d90615c5182613f50565b91615c5f6040519384613f2f565b82523d5f602084013e565b606090565b5f8091604051602081019063313ce56760e01b825260048152615c9181613f01565b51916001600160a01b03165afa615ca6615c40565b9080615cdc575b615cb9575b505f905f90565b602081805181010312610f1b576020015160ff8111615cb2579060ff6001921690565b50602081511015615cad565b90615d0f5750805115615cfd57805190602001fd5b604051630a12f52160e11b8152600490fd5b81511580615d42575b615d20575090565b604051639996b31560e01b81526001600160a01b039091166004820152602490fd5b50803b15615d1856fe2ae08a8e29253f69ac5d979a101956ab8f8d9d7ded63fa7a83b16fc47648eab052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0352c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace049016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300f3f7a9fe364faab93b216da50a3214154f22a0a2b415b23a84c8169e8b636ee30773e532dfede91f04b12a73d3d2acd361424f41f76b4fb79f090161e36b4e00f652222313e28459528d920b65115c16c04f3efc82aaedc97be59f3f377c0d3fcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f0330046a2803e59a4de4e7a4c574b1243f25977ac4c77d5a1a4a609b5394cebb4a2aa9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00f0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00a2646970667358221220e0ed4bb5a2e29ea5defebd89c9f1c78c5595d6013729459d582110dec9d2e49d64736f6c63430008180033
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 34 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.