Source Code
Overview
ETH Balance
0 ETH
Eth Value
$0.00View more zero value Internal Transactions in Advanced View mode
Advanced mode:
Loading...
Loading
Loading...
Loading
Cross-Chain Transactions
Loading...
Loading
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Name:
LEZyVault
Compiler Version
v0.8.27+commit.40a35a09
Optimization Enabled:
Yes with 200 runs
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.27;
import {
ERC4626Upgradeable,
MathUpgradeable
} from "@openzeppelin-upgrades/contracts/token/ERC20/extensions/ERC4626Upgradeable.sol";
import {
IERC20MetadataUpgradeable
} from "@openzeppelin-upgrades/contracts/token/ERC20/extensions/IERC20MetadataUpgradeable.sol";
import {
IERC20Upgradeable
} from "@openzeppelin-upgrades/contracts/token/ERC20/IERC20Upgradeable.sol";
import {
PausableUpgradeable
} from "@openzeppelin-upgrades/contracts/security/PausableUpgradeable.sol";
import { Address } from "@openzeppelin/contracts/utils/Address.sol";
import { OwnableUpgradeable } from "@openzeppelin-upgrades/contracts/access/OwnableUpgradeable.sol";
import {
SafeERC20Upgradeable
} from "@openzeppelin-upgrades/contracts/token/ERC20/utils/SafeERC20Upgradeable.sol";
import { IBeacon, BeaconProxy } from "@openzeppelin/contracts/proxy/beacon/BeaconProxy.sol";
import "../Strategies/interfaces/IDelegateStrategy.sol";
import "../Errors/Errors.sol";
import "./LEZyVaultStorage.sol";
/**
* @title LEZyVault
* @author Renzo Protocol
* @notice Main vault contract implementing ERC4626 standard with additional yield strategies
* @dev This contract manages user deposits and integrates with various DeFi protocols through delegate strategies
* @dev WARNING: Rebasing Tokens Should not be used as underlying
* It supports whitelisting, performance fees, and pausable functionality
*/
contract LEZyVault is
ERC4626Upgradeable,
OwnableUpgradeable,
PausableUpgradeable,
LEZyVaultStorageV1
{
using MathUpgradeable for uint256;
using Address for address;
using EnumerableSet for EnumerableSet.AddressSet;
using SafeERC20Upgradeable for IERC20Upgradeable;
uint256 public constant BASIS_POINTS = 10000; // BASIS_POINTS used for percentage (10000 basis points equal 100%)
uint256 public constant SHARE_OFFSET = 1e3;
uint256 public constant BALANCE_OFFSET = 1e3;
IBeacon public immutable withdrawQueueBeacon;
/// @dev Event emit when delegate strategies added
event DelegateStrategyAdded(address[] delegateStrategies);
/// @dev Event emit when delegate strategies removed
event DelegateStrategyRemoved(address[] delegateStrategies);
/// @dev Event emitted when whitelist enabled is updated
event WhitelistEnabledUpdated(bool isEnabled);
/// @dev Event emit when whitelist is updated
event WhitelistUpdated(address[] accounts, bool[] status);
/// @dev Event emit when whitelistedEthSender updated
event EthSenderWhitelistUpdated(address[] accounts, bool[] status);
/// @dev Event emit when performanceFee configuration is updated
event PerformanceFeeConfigUpdated(uint256 performanceFeeBps, address feeRecipient);
/// @dev Event emitted when the vault is initialized
event VaultInitialized(
address indexed roleManager,
address indexed withdrawQueue,
uint256 performanceFeeBps,
address indexed feeRecipient
);
/// @dev Event emitted when total underlying is updated
event TotalUnderlyingUpdated(uint256 oldValue, uint256 newValue);
/// @dev Event emitted when highest rate is recorded
event HighestRateRecorded(uint256 newRate);
/// @dev Event emitted when performance fees are accrued
event PerformanceFeesAccrued(uint256 feeShares, uint256 feeAssets);
/// @dev Only allowed address to rebalance the vault
modifier onlyRebalanceAdmin() {
if (!roleManager.isRebalanceAdmin(msg.sender)) revert NotRebalanceAdmin();
_;
}
modifier onlyWithdrawQueue() {
if (_msgSender() != address(withdrawQueue)) revert NotWithdrawQueue();
_;
}
/// @dev Allows only whitelisted address
modifier onlyWhitelisted() {
if (depositWhitelistEnabled && !whitelist[_msgSender()]) revert NotWhitelisted();
_;
}
/// @dev Only allowed address to pause
modifier onlyPauser() {
if (!roleManager.isPauser(_msgSender())) revert NotPauser();
_;
}
/// @dev Only allowed address to track underlying
modifier onlyExchangeRateAdmin() {
if (!roleManager.isExchangeRateAdmin(_msgSender())) revert NotExchangeRateAdmin();
_;
}
constructor(IBeacon _withdrawQueueBeacon) {
if (address(_withdrawQueueBeacon) == address(0)) revert InvalidZeroInput();
withdrawQueueBeacon = _withdrawQueueBeacon;
_disableInitializers();
}
/**
* @notice Initializes the vault with configuration parameters
* @dev Can only be called once during deployment via proxy
* @param _asset The ERC20 token that the vault will accept as deposits
* @param name_ The name of the vault token
* @param symbol_ The symbol of the vault token
* @param _roleManager The RoleManager contract for access control
* @param _owner The initial owner of the vault
* @param _feeRecipient The address that will receive performance fees
* @param _feeBps The performance fee in basis points (max 10000)
* @param _withdrawCoolDownPeriod The cooldown period for withdrawals in seconds
*/
function initialize(
IERC20Upgradeable _asset,
string memory name_,
string memory symbol_,
IRoleManager _roleManager,
address _owner,
address _feeRecipient,
uint256 _feeBps,
uint256 _withdrawCoolDownPeriod
) external initializer {
// Check for zero values
if (
address(_asset) == address(0) ||
bytes(name_).length == 0 ||
bytes(symbol_).length == 0 ||
address(_roleManager) == address(0) ||
address(_owner) == address(0) ||
address(_feeRecipient) == address(0) ||
_feeBps == 0 ||
_withdrawCoolDownPeriod == 0
) revert InvalidZeroInput();
if (_feeBps > BASIS_POINTS) revert InvalidFeeBps();
__ERC4626_init(_asset);
__ERC20_init(name_, symbol_);
_transferOwnership(_owner);
roleManager = _roleManager;
feeRecipient = _feeRecipient;
performanceFeeBps = _feeBps;
// create withdraw queue for vault
withdrawQueue = IWithdrawQueue(
address(
new BeaconProxy(
address(withdrawQueueBeacon),
abi.encodeWithSelector(
IWithdrawQueue.initialize.selector,
_owner,
address(this),
_withdrawCoolDownPeriod
)
)
)
);
// record Initial rate as cached rate
_recordRate(totalAssets());
// Emit initialization event
emit VaultInitialized(
address(_roleManager),
address(withdrawQueue),
_feeBps,
_feeRecipient
);
}
/**
* @notice Pause the vault
* @dev permissioned call (onlyPuaser)
*/
function pause() external onlyPauser {
_pause();
}
/**
* @notice UnPause the vault
* @dev permissioned call (onlyOwner)
*/
function unpause() external onlyOwner {
_unpause();
}
/**
*************************
** OnlyOwner functions **
*************************
*/
/**
* @notice Adds new delegate strategies to the vault's allowed list
* @dev Only callable by owner. Strategies must have valid addresses
* @param delegateStrategies Array of strategy contract addresses to add
*/
function addDelegateStrategies(address[] calldata delegateStrategies) external onlyOwner {
if (delegateStrategies.length == 0) revert InvalidZeroInput();
for (uint256 i = 0; i < delegateStrategies.length; ) {
if (delegateStrategies[i] == address(0)) revert InvalidZeroInput();
// Add/Remove strategy according to status
allowedDelegateStrategy.add(delegateStrategies[i]);
unchecked {
++i;
}
}
emit DelegateStrategyAdded(delegateStrategies);
}
/**
* @notice Removes delegate strategies from the vault's allowed list
* @dev Only callable by owner. Strategies must have zero underlying value before removal
* @param delegateStrategies Array of strategy contract addresses to remove
*/
function removeDelegateStrategies(address[] calldata delegateStrategies) external onlyOwner {
if (delegateStrategies.length == 0) revert InvalidZeroInput();
for (uint256 i = 0; i < delegateStrategies.length; ) {
if (delegateStrategies[i] == address(0)) revert InvalidZeroInput();
_checkUnderlying(delegateStrategies[i]);
// Add/Remove strategy according to status
allowedDelegateStrategy.remove(delegateStrategies[i]);
unchecked {
++i;
}
}
emit DelegateStrategyRemoved(delegateStrategies);
}
/**
* @notice Updates the whitelist status for multiple accounts
* @dev Only callable by owner. Arrays must have matching lengths
* @param accounts Array of addresses to update whitelist status for
* @param status Array of boolean values indicating whitelist status
*/
function updateWhitelist(
address[] calldata accounts,
bool[] calldata status
) external onlyOwner {
// Check for the array length
if (accounts.length != status.length) revert MismatchedArrayLengths();
for (uint256 i = 0; i < accounts.length; ) {
// Check if account address is zero
if (accounts[i] == address(0)) revert InvalidZeroInput();
// Update whitelist
whitelist[accounts[i]] = status[i];
unchecked {
++i;
}
}
// Emit the event
emit WhitelistUpdated(accounts, status);
}
/**
* @notice Updates the ETH sender whitelist status for multiple accounts
* @dev Only callable by owner. Arrays must have matching lengths
* @param accounts Array of addresses to update ETH sender whitelist status for
* @param status Array of boolean values indicating ETH sender whitelist status
*/
function updateWhitelistedEthSender(
address[] calldata accounts,
bool[] calldata status
) external onlyOwner {
// Check for the array length
if (accounts.length != status.length) revert MismatchedArrayLengths();
for (uint256 i = 0; i < accounts.length; ) {
// Check if account address is zero
if (accounts[i] == address(0)) revert InvalidZeroInput();
// Update whitelist
whitelistedEthSender[accounts[i]] = status[i];
unchecked {
++i;
}
}
// Emit the event
emit EthSenderWhitelistUpdated(accounts, status);
}
/**
* @notice Configures the performance fee and fee recipient
* @dev Only callable by owner. Fee must be within valid range (0-5000 bps)
* @param _performanceFeeBps Performance fee in basis points (10000 = 100%)
* @param _feeRecipient Address that will receive performance fees
*/
function configurePerformanceFee(
uint256 _performanceFeeBps,
address _feeRecipient
) external onlyOwner {
if (_performanceFeeBps == 0 || _feeRecipient == address(0)) revert InvalidZeroInput();
if (_performanceFeeBps > BASIS_POINTS) revert InvalidFeeBps();
performanceFeeBps = _performanceFeeBps;
feeRecipient = _feeRecipient;
emit PerformanceFeeConfigUpdated(_performanceFeeBps, _feeRecipient);
}
/**
* @notice Sets the whitelist enabled status
* @dev permissioned call (onlyOwner)
* @dev Emits WhitelistEnabledUpdated event
* @param _isEnabled Boolean value indicating if whitelist is enabled
*/
function setDepositWhitelistEnabled(bool _isEnabled) external onlyOwner {
depositWhitelistEnabled = _isEnabled;
emit WhitelistEnabledUpdated(_isEnabled);
}
/**
*********************
** Admin functions **
*********************
*/
function manage(
address target,
bytes calldata payload
) external onlyRebalanceAdmin returns (bytes memory result) {
_isAllowedDelegateStrategy(target);
result = target.functionDelegateCall(payload);
_fillWithdrawQueue();
_trackUnderlying();
}
/**
* @notice Executes multiple management actions on delegate strategies
* @dev Only callable by rebalance admin. All targets must be allowed strategies
* @param targets Array of delegate strategy addresses to call
* @param payloads Array of encoded function calls to execute
* @return results Array of return data from the executed calls
*/
function manage(
address[] calldata targets,
bytes[] calldata payloads
) external onlyRebalanceAdmin returns (bytes[] memory results) {
if (targets.length == 0 || payloads.length == 0) revert InvalidZeroInput();
if (targets.length != payloads.length) revert MismatchedArrayLengths();
results = new bytes[](targets.length);
for (uint256 i = 0; i < targets.length; ) {
_isAllowedDelegateStrategy(targets[i]);
results[i] = targets[i].functionDelegateCall(payloads[i]);
unchecked {
++i;
}
}
_fillWithdrawQueue();
_trackUnderlying();
}
/**
* @notice Updates the vault's total underlying asset value
* @dev Only callable by exchange rate admin. Used to sync vault state with strategies
*/
function trackUnderlying() external onlyExchangeRateAdmin {
_trackUnderlying();
}
/**
********************************
** ERC4626 Override functions **
********************************
*/
/**
* @notice Deposits assets into the vault and mints shares
* @dev Overrides ERC4626 deposit. Only whitelisted addresses can deposit
* @param assets The amount of underlying assets to deposit
* @param receiver The address that will receive the minted shares
* @return The amount of shares minted
*/
function deposit(
uint256 assets,
address receiver
) public virtual override onlyWhitelisted returns (uint256) {
require(assets <= maxDeposit(receiver), "ERC4626: deposit more than max");
// convert To shares with total
uint256 shares = previewDeposit(assets);
_deposit(_msgSender(), receiver, assets, shares);
// Track total underlying
totalUnderlying += assets;
_fillWithdrawQueue();
return shares;
}
/**
* @notice Burns shares and updates the total assets accordingly
* @dev Only callable by the withdraw queue contract
* @param _shares The amount of shares to burn
* @param _assets The amount of assets to deduct from total underlying
*/
function burnSharesAndUpdateAssets(
uint256 _shares,
uint256 _assets
) external onlyWithdrawQueue {
// update shares
_burn(_msgSender(), _shares);
// update assets
totalUnderlying -= _assets;
}
/**
* @notice Withdraw is not supported directly - use withdraw queue instead
* @dev Always reverts. Users must use the withdraw queue for withdrawals
*/
function withdraw(
uint256 assets,
address receiver,
address owner
) public virtual override returns (uint256) {
revert();
}
/**
* @notice Mint is not supported
* @dev Always reverts. Use deposit function instead
*/
function mint(uint256 shares, address receiver) public virtual override returns (uint256) {
revert();
}
/**
* @notice Redeem is not supported directly - use withdraw queue instead
* @dev Always reverts. Users must use the withdraw queue for redemptions
*/
function redeem(
uint256 shares,
address receiver,
address owner
) public virtual override returns (uint256) {
revert();
}
/**
********************
** View functions **
********************
*/
function isAllowedDelegateStrategy(address _delegateStrategy) public view returns (bool) {
return allowedDelegateStrategy.contains(_delegateStrategy);
}
/** @dev See {IERC4626-convertToShares}. */
function convertToShares(uint256 assets) public view virtual override returns (uint256) {
return
_convertToSharesWithTotals(
assets,
totalSupply(),
totalAssets(),
MathUpgradeable.Rounding.Down
);
}
/** @dev See {IERC4626-convertToAssets}. */
function convertToAssets(uint256 shares) public view virtual override returns (uint256) {
return
_convertToAssetsWithTotals(
shares,
totalSupply(),
totalAssets(),
MathUpgradeable.Rounding.Down
);
}
/** @dev See {IERC4626-previewRedeem}. */
function previewDeposit(uint256 assets) public view virtual override returns (uint256) {
return
_convertToSharesWithTotals(
assets,
totalSupply(),
totalAssets(),
MathUpgradeable.Rounding.Down
);
}
/// @dev Preview Redeem is used by WithdrawQueue to calculate assets for shares
/** @dev See {IERC4626-previewRedeem}. */
function previewRedeem(uint256 shares) public view virtual override returns (uint256) {
return
_convertToAssetsWithTotals(
shares,
totalSupply(),
totalAssets(),
MathUpgradeable.Rounding.Down
);
}
/// @dev Revert as Mint is not supported
/** @dev See {IERC4626-previewMint}. */
function previewMint(uint256 shares) public view virtual override returns (uint256) {
revert();
}
/// @dev Revert as Withdraw is not supported
/** @dev See {IERC4626-previewWithdraw}. */
function previewWithdraw(uint256 assets) public view virtual override returns (uint256) {
revert();
}
/**
*************************************
** ERC4626 Override View functions **
*************************************
*/
function totalAssets() public view virtual override returns (uint256) {
return totalUnderlying;
}
/**
************************
** Internal Functions **
************************
*/
/// @dev Checks if _delegateStrategy is allowed
function _isAllowedDelegateStrategy(address _delegateStrategy) internal view {
if (!allowedDelegateStrategy.contains(_delegateStrategy))
revert UnAuthorizedStrategy(_delegateStrategy);
}
/// @notice Tracks Underlying value of the vault through delegate strategy
function _trackUnderlying() internal {
uint256 currentUnderlying = super.totalAssets() +
IERC20Upgradeable(asset()).balanceOf(address(withdrawQueue));
// get underlyingValue calldata
bytes memory underlyingPayload = abi.encodeWithSelector(
IDelegateStrategy.underlyingValue.selector,
asset()
);
for (uint256 i = 0; i < allowedDelegateStrategy.length(); ) {
currentUnderlying += abi.decode(
(allowedDelegateStrategy.at(i)).functionDelegateCall(underlyingPayload),
(uint256)
);
unchecked {
++i;
}
}
// Deduct performance fee
_accrueFee(currentUnderlying);
// Store old value for event
uint256 oldUnderlying = totalUnderlying;
// Update totalUnderlying
totalUnderlying = currentUnderlying;
// Emit event if value changed
if (oldUnderlying != currentUnderlying) {
emit TotalUnderlyingUpdated(oldUnderlying, currentUnderlying);
}
}
/// @dev Accrue Performance fee on the Interest Earned
function _accrueFee(uint256 currentUnderlying) internal {
uint256 newRate = _convertToAssetsWithTotals(
10 ** decimals(),
totalSupply(),
currentUnderlying,
MathUpgradeable.Rounding.Down
);
if (newRate > lastCachedHighestRate) {
// get the total gains from previous rate
uint256 totalInterest = currentUnderlying -
totalSupply().mulDiv(lastCachedHighestRate, 10 ** decimals());
// deduct fee
uint256 feeAssets = (totalInterest * performanceFeeBps) / BASIS_POINTS;
// fee shares to mint
// The fee assets is subtracted from the currentUnderlying in this calculation to compensate for the fact
// that currentUnderlying is already increased by the total interest (including the fee assets).
uint256 feeShares = _convertToSharesWithTotals(
feeAssets,
totalSupply(),
currentUnderlying - feeAssets,
MathUpgradeable.Rounding.Down
);
if (feeShares != 0) {
_mint(feeRecipient, feeShares);
// Emit event for performance fees accrued
emit PerformanceFeesAccrued(feeShares, feeAssets);
}
// record rate
_recordRate(currentUnderlying);
}
}
/// @dev Record the Highest rate
function _recordRate(uint256 _currentUnderlying) internal {
uint256 rate = _convertToAssetsWithTotals(
10 ** decimals(),
totalSupply(),
_currentUnderlying,
MathUpgradeable.Rounding.Down
);
// if current rate is greater than last cached highest rate
if (rate > lastCachedHighestRate) {
// record last cached highest rate
lastCachedHighestRate = rate;
// Emit event for new highest rate
emit HighestRateRecorded(rate);
}
}
/// @dev Check for 0 underlying value
function _checkUnderlying(address _delegateStrategy) internal view {
if (IDelegateStrategy(_delegateStrategy).underlyingValue(asset()) > 0)
revert NonZeroUnderlyingDelegateStrategy();
}
/// @dev Fill the Withdraw Queue from the balance
function _fillWithdrawQueue() internal {
// get the queue deficit
uint256 queueDeficit = withdrawQueue.getQueueDeficit();
if (queueDeficit > 0) {
// Get amount to fill the queue
uint256 amountToFill = super.totalAssets() > queueDeficit
? queueDeficit
: super.totalAssets();
if (amountToFill > 0) {
// Increase allowance to withdraw Queue
IERC20Upgradeable(asset()).safeIncreaseAllowance(
address(withdrawQueue),
amountToFill
);
// Fill the Withdraw Queue
withdrawQueue.fillWithdrawQueue(amountToFill);
}
}
}
/// @dev Returns the amount of assets that the vault would exchange for the amount of `shares` provided.
/// @dev It assumes that the arguments `newTotalSupply` and `newTotalAssets` are up to date.
function _convertToAssetsWithTotals(
uint256 shares,
uint256 newTotalSupply,
uint256 newTotalAssets,
MathUpgradeable.Rounding rounding
) internal view returns (uint256) {
return
shares.mulDiv(newTotalAssets + BALANCE_OFFSET, newTotalSupply + SHARE_OFFSET, rounding);
}
/// @dev Returns the amount of shares that the vault would exchange for the amount of `assets` provided.
/// @dev It assumes that the arguments `newTotalSupply` and `newTotalAssets` are up to date.
function _convertToSharesWithTotals(
uint256 assets,
uint256 newTotalSupply,
uint256 newTotalAssets,
MathUpgradeable.Rounding rounding
) internal view returns (uint256) {
return
assets.mulDiv(newTotalSupply + SHARE_OFFSET, newTotalAssets + BALANCE_OFFSET, rounding);
}
/**
* @notice Receives ETH sent to the contract
* @dev Only whitelisted addresses can send ETH to this contract
* @dev Warning : ETH can be sent directly via selfdestruct
*/
receive() external payable {
// only allow whitelisted address to send ETH
if (!whitelistedEthSender[_msgSender()]) revert();
// do nothing
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
pragma solidity ^0.8.0;
import "../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.
*
* By default, the owner account will be the one that deploys the contract. 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 {
address private _owner;
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the deployer as the initial owner.
*/
function __Ownable_init() internal onlyInitializing {
__Ownable_init_unchained();
}
function __Ownable_init_unchained() internal onlyInitializing {
_transferOwnership(_msgSender());
}
/**
* @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) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
require(owner() == _msgSender(), "Ownable: caller is not the owner");
}
/**
* @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 {
require(newOwner != address(0), "Ownable: new owner is the zero address");
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[49] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC4626.sol)
pragma solidity ^0.8.0;
import "../token/ERC20/IERC20Upgradeable.sol";
import "../token/ERC20/extensions/IERC20MetadataUpgradeable.sol";
/**
* @dev Interface of the ERC4626 "Tokenized Vault Standard", as defined in
* https://eips.ethereum.org/EIPS/eip-4626[ERC-4626].
*
* _Available since v4.7._
*/
interface IERC4626Upgradeable is IERC20Upgradeable, IERC20MetadataUpgradeable {
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 v4.9.0) (proxy/utils/Initializable.sol)
pragma solidity ^0.8.2;
import "../../utils/AddressUpgradeable.sol";
/**
* @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 Indicates that the contract has been initialized.
* @custom:oz-retyped-from bool
*/
uint8 private _initialized;
/**
* @dev Indicates that the contract is in the process of being initialized.
*/
bool private _initializing;
/**
* @dev Triggered when the contract has been initialized or reinitialized.
*/
event Initialized(uint8 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 functions marked with `initializer` can be nested in the context of a
* constructor.
*
* Emits an {Initialized} event.
*/
modifier initializer() {
bool isTopLevelCall = !_initializing;
require(
(isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
"Initializable: contract is already initialized"
);
_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 255 will prevent any future reinitialization.
*
* Emits an {Initialized} event.
*/
modifier reinitializer(uint8 version) {
require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
_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() {
require(_initializing, "Initializable: contract is not initializing");
_;
}
/**
* @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 {
require(!_initializing, "Initializable: contract is initializing");
if (_initialized != type(uint8).max) {
_initialized = type(uint8).max;
emit Initialized(type(uint8).max);
}
}
/**
* @dev Returns the highest version that has been initialized. See {reinitializer}.
*/
function _getInitializedVersion() internal view returns (uint8) {
return _initialized;
}
/**
* @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
*/
function _isInitializing() internal view returns (bool) {
return _initializing;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
pragma solidity ^0.8.0;
import "../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 {
/**
* @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);
bool private _paused;
/**
* @dev Initializes the contract in unpaused state.
*/
function __Pausable_init() internal onlyInitializing {
__Pausable_init_unchained();
}
function __Pausable_init_unchained() internal onlyInitializing {
_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) {
return _paused;
}
/**
* @dev Throws if the contract is paused.
*/
function _requireNotPaused() internal view virtual {
require(!paused(), "Pausable: paused");
}
/**
* @dev Throws if the contract is not paused.
*/
function _requirePaused() internal view virtual {
require(paused(), "Pausable: not paused");
}
/**
* @dev Triggers stopped state.
*
* Requirements:
*
* - The contract must not be paused.
*/
function _pause() internal virtual whenNotPaused {
_paused = true;
emit Paused(_msgSender());
}
/**
* @dev Returns to normal state.
*
* Requirements:
*
* - The contract must be paused.
*/
function _unpause() internal virtual whenPaused {
_paused = false;
emit Unpaused(_msgSender());
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[49] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)
pragma solidity ^0.8.0;
import "./IERC20Upgradeable.sol";
import "./extensions/IERC20MetadataUpgradeable.sol";
import "../../utils/ContextUpgradeable.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}.
* For a generic mechanism see {ERC20PresetMinterPauser}.
*
* 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.
*
* Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
* functions have been added to mitigate the well-known issues around setting
* allowances. See {IERC20-approve}.
*/
contract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20Upgradeable, IERC20MetadataUpgradeable {
mapping(address => uint256) private _balances;
mapping(address => mapping(address => 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.
*/
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 {
_name = name_;
_symbol = symbol_;
}
/**
* @dev Returns the name of the token.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev Returns the symbol of the token, usually a shorter version of the
* name.
*/
function symbol() public view virtual override 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 override returns (uint8) {
return 18;
}
/**
* @dev See {IERC20-totalSupply}.
*/
function totalSupply() public view virtual override returns (uint256) {
return _totalSupply;
}
/**
* @dev See {IERC20-balanceOf}.
*/
function balanceOf(address account) public view virtual override 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 `amount`.
*/
function transfer(address to, uint256 amount) public virtual override returns (bool) {
address owner = _msgSender();
_transfer(owner, to, amount);
return true;
}
/**
* @dev See {IERC20-allowance}.
*/
function allowance(address owner, address spender) public view virtual override returns (uint256) {
return _allowances[owner][spender];
}
/**
* @dev See {IERC20-approve}.
*
* NOTE: If `amount` 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 amount) public virtual override returns (bool) {
address owner = _msgSender();
_approve(owner, spender, amount);
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 `amount`.
* - the caller must have allowance for ``from``'s tokens of at least
* `amount`.
*/
function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {
address spender = _msgSender();
_spendAllowance(from, spender, amount);
_transfer(from, to, amount);
return true;
}
/**
* @dev Atomically increases the allowance granted to `spender` by the caller.
*
* This is an alternative to {approve} that can be used as a mitigation for
* problems described in {IERC20-approve}.
*
* Emits an {Approval} event indicating the updated allowance.
*
* Requirements:
*
* - `spender` cannot be the zero address.
*/
function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
address owner = _msgSender();
_approve(owner, spender, allowance(owner, spender) + addedValue);
return true;
}
/**
* @dev Atomically decreases the allowance granted to `spender` by the caller.
*
* This is an alternative to {approve} that can be used as a mitigation for
* problems described in {IERC20-approve}.
*
* Emits an {Approval} event indicating the updated allowance.
*
* Requirements:
*
* - `spender` cannot be the zero address.
* - `spender` must have allowance for the caller of at least
* `subtractedValue`.
*/
function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
address owner = _msgSender();
uint256 currentAllowance = allowance(owner, spender);
require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
unchecked {
_approve(owner, spender, currentAllowance - subtractedValue);
}
return true;
}
/**
* @dev Moves `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.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `from` must have a balance of at least `amount`.
*/
function _transfer(address from, address to, uint256 amount) internal virtual {
require(from != address(0), "ERC20: transfer from the zero address");
require(to != address(0), "ERC20: transfer to the zero address");
_beforeTokenTransfer(from, to, amount);
uint256 fromBalance = _balances[from];
require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
unchecked {
_balances[from] = fromBalance - amount;
// Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by
// decrementing then incrementing.
_balances[to] += amount;
}
emit Transfer(from, to, amount);
_afterTokenTransfer(from, to, amount);
}
/** @dev Creates `amount` tokens and assigns them to `account`, increasing
* the total supply.
*
* Emits a {Transfer} event with `from` set to the zero address.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function _mint(address account, uint256 amount) internal virtual {
require(account != address(0), "ERC20: mint to the zero address");
_beforeTokenTransfer(address(0), account, amount);
_totalSupply += amount;
unchecked {
// Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.
_balances[account] += amount;
}
emit Transfer(address(0), account, amount);
_afterTokenTransfer(address(0), account, amount);
}
/**
* @dev Destroys `amount` tokens from `account`, reducing the
* total supply.
*
* Emits a {Transfer} event with `to` set to the zero address.
*
* Requirements:
*
* - `account` cannot be the zero address.
* - `account` must have at least `amount` tokens.
*/
function _burn(address account, uint256 amount) internal virtual {
require(account != address(0), "ERC20: burn from the zero address");
_beforeTokenTransfer(account, address(0), amount);
uint256 accountBalance = _balances[account];
require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
unchecked {
_balances[account] = accountBalance - amount;
// Overflow not possible: amount <= accountBalance <= totalSupply.
_totalSupply -= amount;
}
emit Transfer(account, address(0), amount);
_afterTokenTransfer(account, address(0), amount);
}
/**
* @dev Sets `amount` 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.
*/
function _approve(address owner, address spender, uint256 amount) internal virtual {
require(owner != address(0), "ERC20: approve from the zero address");
require(spender != address(0), "ERC20: approve to the zero address");
_allowances[owner][spender] = amount;
emit Approval(owner, spender, amount);
}
/**
* @dev Updates `owner` s allowance for `spender` based on spent `amount`.
*
* Does not update the allowance amount in case of infinite allowance.
* Revert if not enough allowance is available.
*
* Might emit an {Approval} event.
*/
function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {
uint256 currentAllowance = allowance(owner, spender);
if (currentAllowance != type(uint256).max) {
require(currentAllowance >= amount, "ERC20: insufficient allowance");
unchecked {
_approve(owner, spender, currentAllowance - amount);
}
}
}
/**
* @dev Hook that is called before any transfer of tokens. This includes
* minting and burning.
*
* Calling conditions:
*
* - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
* will be transferred to `to`.
* - when `from` is zero, `amount` tokens will be minted for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens will be burned.
* - `from` and `to` are never both zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}
/**
* @dev Hook that is called after any transfer of tokens. This includes
* minting and burning.
*
* Calling conditions:
*
* - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
* has been transferred to `to`.
* - when `from` is zero, `amount` tokens have been minted for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens have been burned.
* - `from` and `to` are never both zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[45] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/ERC4626.sol)
pragma solidity ^0.8.0;
import "../ERC20Upgradeable.sol";
import "../utils/SafeERC20Upgradeable.sol";
import "../../../interfaces/IERC4626Upgradeable.sol";
import "../../../utils/math/MathUpgradeable.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].
* ====
*
* _Available since v4.7._
*/
abstract contract ERC4626Upgradeable is Initializable, ERC20Upgradeable, IERC4626Upgradeable {
using MathUpgradeable for uint256;
IERC20Upgradeable private _asset;
uint8 private _underlyingDecimals;
/**
* @dev Set the underlying asset contract. This must be an ERC20-compatible contract (ERC20 or ERC777).
*/
function __ERC4626_init(IERC20Upgradeable asset_) internal onlyInitializing {
__ERC4626_init_unchained(asset_);
}
function __ERC4626_init_unchained(IERC20Upgradeable asset_) internal onlyInitializing {
(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(IERC20Upgradeable asset_) private view returns (bool, uint8) {
(bool success, bytes memory encodedDecimals) = address(asset_).staticcall(
abi.encodeWithSelector(IERC20MetadataUpgradeable.decimals.selector)
);
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(IERC20MetadataUpgradeable, ERC20Upgradeable) returns (uint8) {
return _underlyingDecimals + _decimalsOffset();
}
/** @dev See {IERC4626-asset}. */
function asset() public view virtual override returns (address) {
return address(_asset);
}
/** @dev See {IERC4626-totalAssets}. */
function totalAssets() public view virtual override returns (uint256) {
return _asset.balanceOf(address(this));
}
/** @dev See {IERC4626-convertToShares}. */
function convertToShares(uint256 assets) public view virtual override returns (uint256) {
return _convertToShares(assets, MathUpgradeable.Rounding.Down);
}
/** @dev See {IERC4626-convertToAssets}. */
function convertToAssets(uint256 shares) public view virtual override returns (uint256) {
return _convertToAssets(shares, MathUpgradeable.Rounding.Down);
}
/** @dev See {IERC4626-maxDeposit}. */
function maxDeposit(address) public view virtual override returns (uint256) {
return type(uint256).max;
}
/** @dev See {IERC4626-maxMint}. */
function maxMint(address) public view virtual override returns (uint256) {
return type(uint256).max;
}
/** @dev See {IERC4626-maxWithdraw}. */
function maxWithdraw(address owner) public view virtual override returns (uint256) {
return _convertToAssets(balanceOf(owner), MathUpgradeable.Rounding.Down);
}
/** @dev See {IERC4626-maxRedeem}. */
function maxRedeem(address owner) public view virtual override returns (uint256) {
return balanceOf(owner);
}
/** @dev See {IERC4626-previewDeposit}. */
function previewDeposit(uint256 assets) public view virtual override returns (uint256) {
return _convertToShares(assets, MathUpgradeable.Rounding.Down);
}
/** @dev See {IERC4626-previewMint}. */
function previewMint(uint256 shares) public view virtual override returns (uint256) {
return _convertToAssets(shares, MathUpgradeable.Rounding.Up);
}
/** @dev See {IERC4626-previewWithdraw}. */
function previewWithdraw(uint256 assets) public view virtual override returns (uint256) {
return _convertToShares(assets, MathUpgradeable.Rounding.Up);
}
/** @dev See {IERC4626-previewRedeem}. */
function previewRedeem(uint256 shares) public view virtual override returns (uint256) {
return _convertToAssets(shares, MathUpgradeable.Rounding.Down);
}
/** @dev See {IERC4626-deposit}. */
function deposit(uint256 assets, address receiver) public virtual override returns (uint256) {
require(assets <= maxDeposit(receiver), "ERC4626: deposit more than max");
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 override returns (uint256) {
require(shares <= maxMint(receiver), "ERC4626: mint more than max");
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 override returns (uint256) {
require(assets <= maxWithdraw(owner), "ERC4626: withdraw more than max");
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 override returns (uint256) {
require(shares <= maxRedeem(owner), "ERC4626: redeem more than max");
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, MathUpgradeable.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, MathUpgradeable.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
SafeERC20Upgradeable.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);
SafeERC20Upgradeable.safeTransfer(_asset, receiver, assets);
emit Withdraw(caller, receiver, owner, assets, shares);
}
function _decimalsOffset() internal view virtual returns (uint8) {
return 0;
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[49] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC20Upgradeable.sol";
/**
* @dev Interface for the optional metadata functions from the ERC20 standard.
*
* _Available since v4.1._
*/
interface IERC20MetadataUpgradeable is IERC20Upgradeable {
/**
* @dev Returns the name of the token.
*/
function name() external view returns (string memory);
/**
* @dev Returns the symbol of the token.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the decimals places of the token.
*/
function decimals() external view returns (uint8);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)
pragma solidity ^0.8.0;
/**
* @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 IERC20PermitUpgradeable {
/**
* @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 v4.9.0) (token/ERC20/IERC20.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20Upgradeable {
/**
* @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 amount of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the amount of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves `amount` 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 amount) 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 `amount` 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 amount) external returns (bool);
/**
* @dev Moves `amount` tokens from `from` to `to` using the
* allowance mechanism. `amount` 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 amount) external returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)
pragma solidity ^0.8.0;
import "../IERC20Upgradeable.sol";
import "../extensions/IERC20PermitUpgradeable.sol";
import "../../../utils/AddressUpgradeable.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 SafeERC20Upgradeable {
using AddressUpgradeable for address;
/**
* @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(IERC20Upgradeable token, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, 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(IERC20Upgradeable token, address from, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
}
/**
* @dev Deprecated. This function has issues similar to the ones found in
* {IERC20-approve}, and its usage is discouraged.
*
* Whenever possible, use {safeIncreaseAllowance} and
* {safeDecreaseAllowance} instead.
*/
function safeApprove(IERC20Upgradeable token, address spender, uint256 value) internal {
// safeApprove should only be called when setting an initial allowance,
// or when resetting it to zero. To increase and decrease it, use
// 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
require(
(value == 0) || (token.allowance(address(this), spender) == 0),
"SafeERC20: approve from non-zero to non-zero allowance"
);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 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(IERC20Upgradeable token, address spender, uint256 value) internal {
uint256 oldAllowance = token.allowance(address(this), spender);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));
}
/**
* @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
* non-reverting calls are assumed to be successful.
*/
function safeDecreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {
unchecked {
uint256 oldAllowance = token.allowance(address(this), spender);
require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));
}
}
/**
* @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(IERC20Upgradeable token, address spender, uint256 value) internal {
bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);
if (!_callOptionalReturnBool(token, approvalCall)) {
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));
_callOptionalReturn(token, approvalCall);
}
}
/**
* @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.
* Revert on invalid signature.
*/
function safePermit(
IERC20PermitUpgradeable token,
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) internal {
uint256 nonceBefore = token.nonces(owner);
token.permit(owner, spender, value, deadline, v, r, s);
uint256 nonceAfter = token.nonces(owner);
require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed");
}
/**
* @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(IERC20Upgradeable 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, "SafeERC20: low-level call failed");
require(returndata.length == 0 || abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
}
/**
* @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(IERC20Upgradeable 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))) && AddressUpgradeable.isContract(address(token));
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library AddressUpgradeable {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @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.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @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, it is bubbled up by this
* function (like regular Solidity function calls).
*
* 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.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @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`.
*
* _Available since v3.1._
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) 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(errorMessage);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)
pragma solidity ^0.8.0;
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;
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[50] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library MathUpgradeable {
enum Rounding {
Down, // Toward negative infinity
Up, // Toward infinity
Zero // Toward zero
}
/**
* @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 up instead
* of rounding down.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
// (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; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod0 := mul(x, y)
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.
require(denominator > prod1, "Math: mulDiv overflow");
///////////////////////////////////////////////
// 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.
// Does not overflow because the denominator cannot be zero at this stage in the function.
uint256 twos = denominator & (~denominator + 1);
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 (rounding == Rounding.Up && 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 down.
*
* 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 + (rounding == Rounding.Up && result * result < a ? 1 : 0);
}
}
/**
* @dev Return the log in base 2, rounded down, of a positive value.
* 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 + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 10, rounded down, of a positive value.
* 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 + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 256, rounded down, of a positive value.
* 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 + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)
pragma solidity ^0.8.0;
/**
* @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
* proxy whose upgrades are fully controlled by the current implementation.
*/
interface IERC1822Proxiable {
/**
* @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
* address.
*
* IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
* bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
* function revert if invoked through a proxy.
*/
function proxiableUUID() external view returns (bytes32);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)
pragma solidity ^0.8.0;
/**
* @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.
*
* _Available since v4.8.3._
*/
interface IERC1967 {
/**
* @dev Emitted when the implementation is upgraded.
*/
event Upgraded(address indexed implementation);
/**
* @dev Emitted when the admin account has changed.
*/
event AdminChanged(address previousAdmin, address newAdmin);
/**
* @dev Emitted when the beacon is changed.
*/
event BeaconUpgraded(address indexed beacon);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (proxy/beacon/BeaconProxy.sol)
pragma solidity ^0.8.0;
import "./IBeacon.sol";
import "../Proxy.sol";
import "../ERC1967/ERC1967Upgrade.sol";
/**
* @dev This contract implements a proxy that gets the implementation address for each call from an {UpgradeableBeacon}.
*
* The beacon address is stored in storage slot `uint256(keccak256('eip1967.proxy.beacon')) - 1`, so that it doesn't
* conflict with the storage layout of the implementation behind the proxy.
*
* _Available since v3.4._
*/
contract BeaconProxy is Proxy, ERC1967Upgrade {
/**
* @dev Initializes the proxy with `beacon`.
*
* If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon. This
* will typically be an encoded function call, and allows initializing the storage of the proxy like a Solidity
* constructor.
*
* Requirements:
*
* - `beacon` must be a contract with the interface {IBeacon}.
*/
constructor(address beacon, bytes memory data) payable {
_upgradeBeaconToAndCall(beacon, data, false);
}
/**
* @dev Returns the current beacon address.
*/
function _beacon() internal view virtual returns (address) {
return _getBeacon();
}
/**
* @dev Returns the current implementation address of the associated beacon.
*/
function _implementation() internal view virtual override returns (address) {
return IBeacon(_getBeacon()).implementation();
}
/**
* @dev Changes the proxy to use a new beacon. Deprecated: see {_upgradeBeaconToAndCall}.
*
* If `data` is nonempty, it's used as data in a delegate call to the implementation returned by the beacon.
*
* Requirements:
*
* - `beacon` must be a contract.
* - The implementation returned by `beacon` must be a contract.
*/
function _setBeacon(address beacon, bytes memory data) internal virtual {
_upgradeBeaconToAndCall(beacon, data, false);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
pragma solidity ^0.8.0;
/**
* @dev This is the interface that {BeaconProxy} expects of its beacon.
*/
interface IBeacon {
/**
* @dev Must return an address that can be used as a delegate call target.
*
* {BeaconProxy} will check that this address is a contract.
*/
function implementation() external view returns (address);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)
pragma solidity ^0.8.2;
import "../beacon/IBeacon.sol";
import "../../interfaces/IERC1967.sol";
import "../../interfaces/draft-IERC1822.sol";
import "../../utils/Address.sol";
import "../../utils/StorageSlot.sol";
/**
* @dev This abstract contract provides getters and event emitting update functions for
* https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
*
* _Available since v4.1._
*/
abstract contract ERC1967Upgrade is IERC1967 {
// This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
/**
* @dev Storage slot with the address of the current implementation.
* This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
* validated in the constructor.
*/
bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
/**
* @dev Returns the current implementation address.
*/
function _getImplementation() internal view returns (address) {
return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
}
/**
* @dev Stores a new address in the EIP1967 implementation slot.
*/
function _setImplementation(address newImplementation) private {
require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
}
/**
* @dev Perform implementation upgrade
*
* Emits an {Upgraded} event.
*/
function _upgradeTo(address newImplementation) internal {
_setImplementation(newImplementation);
emit Upgraded(newImplementation);
}
/**
* @dev Perform implementation upgrade with additional setup call.
*
* Emits an {Upgraded} event.
*/
function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
_upgradeTo(newImplementation);
if (data.length > 0 || forceCall) {
Address.functionDelegateCall(newImplementation, data);
}
}
/**
* @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
*
* Emits an {Upgraded} event.
*/
function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {
// Upgrades from old implementations will perform a rollback test. This test requires the new
// implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
// this special case will break upgrade paths from old UUPS implementation to new ones.
if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {
_setImplementation(newImplementation);
} else {
try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
} catch {
revert("ERC1967Upgrade: new implementation is not UUPS");
}
_upgradeToAndCall(newImplementation, data, forceCall);
}
}
/**
* @dev Storage slot with the admin of the contract.
* This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
* validated in the constructor.
*/
bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
/**
* @dev Returns the current admin.
*/
function _getAdmin() internal view returns (address) {
return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
}
/**
* @dev Stores a new address in the EIP1967 admin slot.
*/
function _setAdmin(address newAdmin) private {
require(newAdmin != address(0), "ERC1967: new admin is the zero address");
StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
}
/**
* @dev Changes the admin of the proxy.
*
* Emits an {AdminChanged} event.
*/
function _changeAdmin(address newAdmin) internal {
emit AdminChanged(_getAdmin(), newAdmin);
_setAdmin(newAdmin);
}
/**
* @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
* This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
*/
bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
/**
* @dev Returns the current beacon.
*/
function _getBeacon() internal view returns (address) {
return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
}
/**
* @dev Stores a new beacon in the EIP1967 beacon slot.
*/
function _setBeacon(address newBeacon) private {
require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
require(
Address.isContract(IBeacon(newBeacon).implementation()),
"ERC1967: beacon implementation is not a contract"
);
StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
}
/**
* @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
* not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
*
* Emits a {BeaconUpgraded} event.
*/
function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
_setBeacon(newBeacon);
emit BeaconUpgraded(newBeacon);
if (data.length > 0 || forceCall) {
Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (proxy/Proxy.sol)
pragma solidity ^0.8.0;
/**
* @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
* instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
* be specified by overriding the virtual {_implementation} function.
*
* Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
* different contract through the {_delegate} function.
*
* The success and return data of the delegated call will be returned back to the caller of the proxy.
*/
abstract contract Proxy {
/**
* @dev Delegates the current call to `implementation`.
*
* This function does not return to its internal call site, it will return directly to the external caller.
*/
function _delegate(address implementation) internal virtual {
assembly {
// Copy msg.data. We take full control of memory in this inline assembly
// block because it will not return to Solidity code. We overwrite the
// Solidity scratch pad at memory position 0.
calldatacopy(0, 0, calldatasize())
// Call the implementation.
// out and outsize are 0 because we don't know the size yet.
let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
// Copy the returned data.
returndatacopy(0, 0, returndatasize())
switch result
// delegatecall returns 0 on error.
case 0 {
revert(0, returndatasize())
}
default {
return(0, returndatasize())
}
}
}
/**
* @dev This is a virtual function that should be overridden so it returns the address to which the fallback function
* and {_fallback} should delegate.
*/
function _implementation() internal view virtual returns (address);
/**
* @dev Delegates the current call to the address returned by `_implementation()`.
*
* This function does not return to its internal call site, it will return directly to the external caller.
*/
function _fallback() internal virtual {
_beforeFallback();
_delegate(_implementation());
}
/**
* @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
* function in the contract matches the call data.
*/
fallback() external payable virtual {
_fallback();
}
/**
* @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
* is empty.
*/
receive() external payable virtual {
_fallback();
}
/**
* @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
* call, or as part of the Solidity `fallback` or `receive` functions.
*
* If overridden should call `super._beforeFallback()`.
*/
function _beforeFallback() internal virtual {}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @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.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @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, it is bubbled up by this
* function (like regular Solidity function calls).
*
* 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.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @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`.
*
* _Available since v3.1._
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) 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(errorMessage);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)
// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
pragma solidity ^0.8.0;
/**
* @dev Library for reading and writing primitive types to specific storage slots.
*
* Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
* This library helps with reading and writing to such slots without the need for inline assembly.
*
* The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
*
* Example usage to set ERC1967 implementation slot:
* ```solidity
* contract ERC1967 {
* bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
*
* function _getImplementation() internal view returns (address) {
* return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
* }
*
* function _setImplementation(address newImplementation) internal {
* require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
* StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
* }
* }
* ```
*
* _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._
* _Available since v4.9 for `string`, `bytes`._
*/
library StorageSlot {
struct AddressSlot {
address value;
}
struct BooleanSlot {
bool value;
}
struct Bytes32Slot {
bytes32 value;
}
struct Uint256Slot {
uint256 value;
}
struct StringSlot {
string value;
}
struct BytesSlot {
bytes value;
}
/**
* @dev Returns an `AddressSlot` with member `value` located at `slot`.
*/
function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `BooleanSlot` with member `value` located at `slot`.
*/
function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
*/
function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `Uint256Slot` with member `value` located at `slot`.
*/
function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `StringSlot` with member `value` located at `slot`.
*/
function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `StringSlot` representation of the string storage pointer `store`.
*/
function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := store.slot
}
}
/**
* @dev Returns an `BytesSlot` with member `value` located at `slot`.
*/
function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
*/
function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := store.slot
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/structs/EnumerableSet.sol)
// This file was procedurally generated from scripts/generate/templates/EnumerableSet.js.
pragma solidity ^0.8.0;
/**
* @dev Library for managing
* https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
* types.
*
* Sets have the following properties:
*
* - Elements are added, removed, and checked for existence in constant time
* (O(1)).
* - Elements are enumerated in O(n). No guarantees are made on the ordering.
*
* ```solidity
* contract Example {
* // Add the library methods
* using EnumerableSet for EnumerableSet.AddressSet;
*
* // Declare a set state variable
* EnumerableSet.AddressSet private mySet;
* }
* ```
*
* As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
* and `uint256` (`UintSet`) are supported.
*
* [WARNING]
* ====
* Trying to delete such a structure from storage will likely result in data corruption, rendering the structure
* unusable.
* See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
*
* In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an
* array of EnumerableSet.
* ====
*/
library EnumerableSet {
// To implement this library for multiple types with as little code
// repetition as possible, we write it in terms of a generic Set type with
// bytes32 values.
// The Set implementation uses private functions, and user-facing
// implementations (such as AddressSet) are just wrappers around the
// underlying Set.
// This means that we can only create new EnumerableSets for types that fit
// in bytes32.
struct Set {
// Storage of set values
bytes32[] _values;
// Position of the value in the `values` array, plus 1 because index 0
// means a value is not in the set.
mapping(bytes32 => uint256) _indexes;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function _add(Set storage set, bytes32 value) private returns (bool) {
if (!_contains(set, value)) {
set._values.push(value);
// The value is stored at length-1, but we add 1 to all indexes
// and use 0 as a sentinel value
set._indexes[value] = set._values.length;
return true;
} else {
return false;
}
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function _remove(Set storage set, bytes32 value) private returns (bool) {
// We read and store the value's index to prevent multiple reads from the same storage slot
uint256 valueIndex = set._indexes[value];
if (valueIndex != 0) {
// Equivalent to contains(set, value)
// To delete an element from the _values array in O(1), we swap the element to delete with the last one in
// the array, and then remove the last element (sometimes called as 'swap and pop').
// This modifies the order of the array, as noted in {at}.
uint256 toDeleteIndex = valueIndex - 1;
uint256 lastIndex = set._values.length - 1;
if (lastIndex != toDeleteIndex) {
bytes32 lastValue = set._values[lastIndex];
// Move the last value to the index where the value to delete is
set._values[toDeleteIndex] = lastValue;
// Update the index for the moved value
set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex
}
// Delete the slot where the moved value was stored
set._values.pop();
// Delete the index for the deleted slot
delete set._indexes[value];
return true;
} else {
return false;
}
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function _contains(Set storage set, bytes32 value) private view returns (bool) {
return set._indexes[value] != 0;
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function _length(Set storage set) private view returns (uint256) {
return set._values.length;
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function _at(Set storage set, uint256 index) private view returns (bytes32) {
return set._values[index];
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function _values(Set storage set) private view returns (bytes32[] memory) {
return set._values;
}
// Bytes32Set
struct Bytes32Set {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _add(set._inner, value);
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _remove(set._inner, value);
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
return _contains(set._inner, value);
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(Bytes32Set storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
return _at(set._inner, index);
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
bytes32[] memory store = _values(set._inner);
bytes32[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
// AddressSet
struct AddressSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(AddressSet storage set, address value) internal returns (bool) {
return _add(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(AddressSet storage set, address value) internal returns (bool) {
return _remove(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(AddressSet storage set, address value) internal view returns (bool) {
return _contains(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(AddressSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(AddressSet storage set, uint256 index) internal view returns (address) {
return address(uint160(uint256(_at(set._inner, index))));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(AddressSet storage set) internal view returns (address[] memory) {
bytes32[] memory store = _values(set._inner);
address[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
// UintSet
struct UintSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(UintSet storage set, uint256 value) internal returns (bool) {
return _add(set._inner, bytes32(value));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(UintSet storage set, uint256 value) internal returns (bool) {
return _remove(set._inner, bytes32(value));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(UintSet storage set, uint256 value) internal view returns (bool) {
return _contains(set._inner, bytes32(value));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(UintSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(UintSet storage set, uint256 index) internal view returns (uint256) {
return uint256(_at(set._inner, index));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(UintSet storage set) internal view returns (uint256[] memory) {
bytes32[] memory store = _values(set._inner);
uint256[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
}// SPDX-License-Identifier: BUSL-1.1 pragma solidity 0.8.27; /** * @title Errors * @author Renzo Protocol * @notice This contract defines custom errors used throughout the LiquidVaults protocol * @dev All errors are defined as custom errors for gas efficiency */ /// @dev Error when Zero Input value error InvalidZeroInput(); /// @dev Error when caller is not Rebalance admin error NotRebalanceAdmin(); /// @dev Error when caller is not Exchange rate admin error NotExchangeRateAdmin(); /// @dev Error when array lengths do not match error MismatchedArrayLengths(); /// @dev Error when admin tries to execute Non whitelisted strategy error UnAuthorizedStrategy(address strategy); /// @dev Error when owner tries to remove non zero underlying delegate strategy error NonZeroUnderlyingDelegateStrategy(); /// @dev Error when Withdrawal is not claimable error WithdrawalNotClaimable(); /// @dev Error when caller try to claim invalidWithdrawIndex error InvalidWithdrawIndex(); /// @dev Error when called is not vault error NotUnderlyingVault(); /// @dev Error when caller is not Withdraw Queue error NotWithdrawQueue(); /// @dev Error when caller tries to create already existing vault error VaultAlreadyCreated(); /// @dev Error when caller is not whitelisted error NotWhitelisted(); /// @dev Error when fee bps out of range error InvalidFeeBps(); /// @dev Error when caller does not have pauser role error NotPauser(); /// @dev Error when eulerswap param is invalid error InvalidEquilibriumReserve(); /// @dev Error when pool is already installed for the euler account error PoolAlreadyInstalled(); /// @dev Error when unexpected asset address is passed in error InvalidAsset(); /// @dev Error when no pool is installed for the euler account when it is expected error NoPoolInstalled();
// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.27;
import { IWithdrawQueue } from "../WithdrawQueue/IWithdrawQueue.sol";
import { IRoleManager } from "../Permissions/IRoleManager.sol";
import { EnumerableSet } from "@openzeppelin/contracts/utils/structs/EnumerableSet.sol";
/**
* @title LEZyVaultStorageV1
* @author Renzo Protocol
* @notice Storage contract for LEZyVault implementation
* @dev This abstract contract defines the storage layout for the LEZyVault upgradeable contract
*/
abstract contract LEZyVaultStorageV1 {
/// @dev Tracks allowed DelegateStrategies
EnumerableSet.AddressSet internal allowedDelegateStrategy;
/// @dev Tracks the roleManager contract
IRoleManager public roleManager;
/// @dev Tracks total underlying value
uint256 public totalUnderlying;
/// @dev Tracks WithdrawQueue contract
IWithdrawQueue public withdrawQueue;
/// @dev track deposit whitelisted status
bool public depositWhitelistEnabled;
/// @dev tracks whitelisted addresses for deposits - requires whitelistEnabled to be true
mapping(address => bool) public whitelist;
/// @dev Track High watermark exchange rate
uint256 public lastCachedHighestRate;
/// @dev Track performance fee BPS
uint256 public performanceFeeBps;
/// @dev Tracks fee Recipient
address public feeRecipient;
/// @dev Tracks whitelisted addresses to allow sending ETH to vault
mapping(address => bool) public whitelistedEthSender;
}// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.27;
/**
* @title IRoleManager
* @author Renzo Protocol
* @notice Interface for the RoleManager contract that handles access control
* @dev This interface defines functions to check various role permissions
*/
interface IRoleManager {
/**
* @notice Checks if an address has the REBALANCE_ADMIN role
* @param potentialAddress The address to check
* @return bool True if the address has the REBALANCE_ADMIN role, false otherwise
*/
function isRebalanceAdmin(address potentialAddress) external view returns (bool);
/**
* @notice Checks if an address has the PAUSER role
* @param potentialAddress The address to check
* @return bool True if the address has the PAUSER role, false otherwise
*/
function isPauser(address potentialAddress) external view returns (bool);
/**
* @notice Checks if an address has the EXCHANGE_RATE_ADMIN role
* @param potentialAddress The address to check
* @return bool True if the address has the EXCHANGE_RATE_ADMIN role, false otherwise
*/
function isExchangeRateAdmin(address potentialAddress) external view returns (bool);
}// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.27;
/**
* @title IDelegateStrategy
* @author Renzo Protocol
* @notice Interface that all delegate strategies must implement
* @dev Delegate strategies are external contracts that manage vault assets in various DeFi protocols
*/
interface IDelegateStrategy {
/**
* @notice Returns the value of assets managed by this strategy
* @dev WARNING: Don't use balanceOf(this) to avoid double counting
* @param _asset The asset address to query the value for
* @return The total value of the specified asset managed by this strategy
*/
function underlyingValue(address _asset) external view returns (uint256);
}// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.27;
interface IWithdrawQueue {
function withdraw(uint256 _shares, address user) external;
function fillWithdrawQueue(uint256 _assetAmount) external;
function getQueueDeficit() external view returns (uint256);
function initialize(address _owner, address _vault, uint256 _cooldownPeriod) external;
function setWhiteListed(address[] calldata _accounts, bool[] calldata _accountsStatus) external;
}{
"optimizer": {
"enabled": true,
"runs": 200
},
"evmVersion": "paris",
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"metadata": {
"useLiteralContent": true
}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"contract IBeacon","name":"_withdrawQueueBeacon","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"InvalidFeeBps","type":"error"},{"inputs":[],"name":"InvalidZeroInput","type":"error"},{"inputs":[],"name":"MismatchedArrayLengths","type":"error"},{"inputs":[],"name":"NonZeroUnderlyingDelegateStrategy","type":"error"},{"inputs":[],"name":"NotExchangeRateAdmin","type":"error"},{"inputs":[],"name":"NotPauser","type":"error"},{"inputs":[],"name":"NotRebalanceAdmin","type":"error"},{"inputs":[],"name":"NotWhitelisted","type":"error"},{"inputs":[],"name":"NotWithdrawQueue","type":"error"},{"inputs":[{"internalType":"address","name":"strategy","type":"address"}],"name":"UnAuthorizedStrategy","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":false,"internalType":"address[]","name":"delegateStrategies","type":"address[]"}],"name":"DelegateStrategyAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address[]","name":"delegateStrategies","type":"address[]"}],"name":"DelegateStrategyRemoved","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":"address[]","name":"accounts","type":"address[]"},{"indexed":false,"internalType":"bool[]","name":"status","type":"bool[]"}],"name":"EthSenderWhitelistUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"newRate","type":"uint256"}],"name":"HighestRateRecorded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","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":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"performanceFeeBps","type":"uint256"},{"indexed":false,"internalType":"address","name":"feeRecipient","type":"address"}],"name":"PerformanceFeeConfigUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"feeShares","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"feeAssets","type":"uint256"}],"name":"PerformanceFeesAccrued","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"oldValue","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"newValue","type":"uint256"}],"name":"TotalUnderlyingUpdated","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":"roleManager","type":"address"},{"indexed":true,"internalType":"address","name":"withdrawQueue","type":"address"},{"indexed":false,"internalType":"uint256","name":"performanceFeeBps","type":"uint256"},{"indexed":true,"internalType":"address","name":"feeRecipient","type":"address"}],"name":"VaultInitialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"isEnabled","type":"bool"}],"name":"WhitelistEnabledUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address[]","name":"accounts","type":"address[]"},{"indexed":false,"internalType":"bool[]","name":"status","type":"bool[]"}],"name":"WhitelistUpdated","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"},{"inputs":[],"name":"BALANCE_OFFSET","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BASIS_POINTS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SHARE_OFFSET","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"delegateStrategies","type":"address[]"}],"name":"addDelegateStrategies","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":"amount","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":"_shares","type":"uint256"},{"internalType":"uint256","name":"_assets","type":"uint256"}],"name":"burnSharesAndUpdateAssets","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_performanceFeeBps","type":"uint256"},{"internalType":"address","name":"_feeRecipient","type":"address"}],"name":"configurePerformanceFee","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":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"deposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"depositWhitelistEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"feeRecipient","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20Upgradeable","name":"_asset","type":"address"},{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"},{"internalType":"contract IRoleManager","name":"_roleManager","type":"address"},{"internalType":"address","name":"_owner","type":"address"},{"internalType":"address","name":"_feeRecipient","type":"address"},{"internalType":"uint256","name":"_feeBps","type":"uint256"},{"internalType":"uint256","name":"_withdrawCoolDownPeriod","type":"uint256"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_delegateStrategy","type":"address"}],"name":"isAllowedDelegateStrategy","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lastCachedHighestRate","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"target","type":"address"},{"internalType":"bytes","name":"payload","type":"bytes"}],"name":"manage","outputs":[{"internalType":"bytes","name":"result","type":"bytes"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"targets","type":"address[]"},{"internalType":"bytes[]","name":"payloads","type":"bytes[]"}],"name":"manage","outputs":[{"internalType":"bytes[]","name":"results","type":"bytes[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"maxDeposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","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":[{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"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":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"performanceFeeBps","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"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":"","type":"uint256"}],"stateMutability":"view","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":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"delegateStrategies","type":"address[]"}],"name":"removeDelegateStrategies","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"roleManager","outputs":[{"internalType":"contract IRoleManager","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"_isEnabled","type":"bool"}],"name":"setDepositWhitelistEnabled","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalAssets","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalUnderlying","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"trackUnderlying","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","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":"amount","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":"accounts","type":"address[]"},{"internalType":"bool[]","name":"status","type":"bool[]"}],"name":"updateWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"bool[]","name":"status","type":"bool[]"}],"name":"updateWhitelistedEthSender","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"whitelist","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"whitelistedEthSender","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","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":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdrawQueue","outputs":[{"internalType":"contract IWithdrawQueue","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"withdrawQueueBeacon","outputs":[{"internalType":"contract IBeacon","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"stateMutability":"payable","type":"receive"}]Contract Creation Code
60a060405234801561001057600080fd5b5060405161446d38038061446d83398101604081905261002f91610130565b6001600160a01b0381166100565760405163862a606760e01b815260040160405180910390fd5b6001600160a01b03811660805261006b610071565b50610160565b600054610100900460ff16156100dd5760405162461bcd60e51b815260206004820152602760248201527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469604482015266616c697a696e6760c81b606482015260840160405180910390fd5b60005460ff9081161461012e576000805460ff191660ff9081179091556040519081527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b565b60006020828403121561014257600080fd5b81516001600160a01b038116811461015957600080fd5b9392505050565b6080516142eb61018260003960008181610a10015261132001526142eb6000f3fe6080604052600436106103845760003560e01c8063715018a6116101d1578063b9d4e87911610102578063dd62ed3e116100a0578063ef8b30f71161006f578063ef8b30f7146108d2578063f2fde38b146109be578063f5d4ee20146109de578063fd015286146109fe57600080fd5b8063dd62ed3e14610948578063e1f1c4a714610968578063eb1bb7591461097e578063eb2f8f771461099e57600080fd5b8063c6e6f592116100dc578063c6e6f592146108d2578063c70920bc146108f2578063ce96cb7714610908578063d905777e1461092857600080fd5b8063b9d4e879146108bb578063ba087652146108a0578063c63d75b61461063957600080fd5b80639c3a8e1b1161016f578063ad93b4b711610149578063ad93b4b714610496578063ae56c03f14610880578063b3d7f6b91461047b578063b460af94146108a057600080fd5b80639c3a8e1b14610829578063a457c2d714610840578063a9059cbb1461086057600080fd5b80638da5cb5b116101ab5780638da5cb5b146107aa57806394bf804d146107c857806395d89b41146107e35780639b19251a146107f857600080fd5b8063715018a6146107605780638456cb59146107755780638ac09f291461078a57600080fd5b806333320de3116102b657806346f5dfd61161025457806360125ff21161022357806360125ff2146106d55780636e553f65146106f55780636f3495eb1461071557806370a082311461072a57600080fd5b806346f5dfd61461067c5780634cdad5061461042b57806351a2d6d11461069d5780635c975abb146106bd57600080fd5b80633b12964a116102905780633b12964a146105f75780633f4ba83a14610624578063402d267d14610639578063469048401461065b57600080fd5b806333320de31461059957806338d52e0f146105b957806339509351146105d757600080fd5b806312bc426511610323578063236278a5116102fd578063236278a51461050157806323b872dd1461053257806327b86e0f14610552578063313ce5671461057257600080fd5b806312bc4265146104ac57806318160ddd146104cc578063213bf7f6146104e157600080fd5b806307a2d13a1161035f57806307a2d13a1461042b578063095ea7b31461044b5780630a28a4771461047b578063101395fa1461049657600080fd5b8062435da5146103ad57806301e1d114146103ea57806306fdde031461040957600080fd5b366103a857336000908152610104602052604090205460ff166103a657600080fd5b005b600080fd5b3480156103b957600080fd5b5060fd546103cd906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156103f657600080fd5b5060fe545b6040519081526020016103e1565b34801561041557600080fd5b5061041e610a32565b6040516103e191906131d9565b34801561043757600080fd5b506103fb6104463660046131ec565b610ac4565b34801561045757600080fd5b5061046b61046636600461321a565b610ae3565b60405190151581526020016103e1565b34801561048757600080fd5b506103fb6103a83660046131ec565b3480156104a257600080fd5b506103fb6103e881565b3480156104b857600080fd5b5061046b6104c7366004613246565b610afb565b3480156104d857600080fd5b506035546103fb565b3480156104ed57600080fd5b5061041e6104fc366004613263565b610b08565b34801561050d57600080fd5b5061046b61051c366004613246565b6101046020526000908152604090205460ff1681565b34801561053e57600080fd5b5061046b61054d3660046132e8565b610bfe565b34801561055e57600080fd5b506103a661056d366004613374565b610c22565b34801561057e57600080fd5b50610587610d4f565b60405160ff90911681526020016103e1565b3480156105a557600080fd5b506103a66105b43660046133b5565b610d6e565b3480156105c557600080fd5b506065546001600160a01b03166103cd565b3480156105e357600080fd5b5061046b6105f236600461321a565b610eb8565b34801561060357600080fd5b506106176106123660046133b5565b610eda565b6040516103e19190613424565b34801561063057600080fd5b506103a6611107565b34801561064557600080fd5b506103fb610654366004613246565b5060001990565b34801561066757600080fd5b50610103546103cd906001600160a01b031681565b34801561068857600080fd5b5060ff805461046b91600160a01b9091041681565b3480156106a957600080fd5b5060ff546103cd906001600160a01b031681565b3480156106c957600080fd5b5060c95460ff1661046b565b3480156106e157600080fd5b506103a66106f036600461352c565b611119565b34801561070157600080fd5b506103fb6107103660046135f1565b611438565b34801561072157600080fd5b506103a66114bc565b34801561073657600080fd5b506103fb610745366004613246565b6001600160a01b031660009081526033602052604090205490565b34801561076c57600080fd5b506103a661155b565b34801561078157600080fd5b506103a661156d565b34801561079657600080fd5b506103a66107a5366004613374565b61160c565b3480156107b657600080fd5b506097546001600160a01b03166103cd565b3480156107d457600080fd5b506103fb6103a83660046135f1565b3480156107ef57600080fd5b5061041e6116fe565b34801561080457600080fd5b5061046b610813366004613246565b6101006020526000908152604090205460ff1681565b34801561083557600080fd5b506103fb6101015481565b34801561084c57600080fd5b5061046b61085b36600461321a565b61170d565b34801561086c57600080fd5b5061046b61087b36600461321a565b611788565b34801561088c57600080fd5b506103a661089b3660046135f1565b611796565b3480156108ac57600080fd5b506103fb6103a8366004613621565b3480156108c757600080fd5b506103fb6101025481565b3480156108de57600080fd5b506103fb6108ed3660046131ec565b61184f565b3480156108fe57600080fd5b506103fb60fe5481565b34801561091457600080fd5b506103fb610923366004613246565b611869565b34801561093457600080fd5b506103fb610943366004613246565b61188d565b34801561095457600080fd5b506103fb610963366004613663565b6118ab565b34801561097457600080fd5b506103fb61271081565b34801561098a57600080fd5b506103a66109993660046133b5565b6118d6565b3480156109aa57600080fd5b506103a66109b936600461369f565b611a12565b3480156109ca57600080fd5b506103a66109d9366004613246565b611a72565b3480156109ea57600080fd5b506103a66109f93660046136bc565b611aeb565b348015610a0a57600080fd5b506103cd7f000000000000000000000000000000000000000000000000000000000000000081565b606060368054610a41906136de565b80601f0160208091040260200160405190810160405280929190818152602001828054610a6d906136de565b8015610aba5780601f10610a8f57610100808354040283529160200191610aba565b820191906000526020600020905b815481529060010190602001808311610a9d57829003601f168201915b5050505050905090565b6000610add82610ad360355490565b60fe546000611b44565b92915050565b600033610af1818585611b73565b5060019392505050565b6000610add60fb83611c97565b60fd5460405163061e70cb60e01b81523360048201526060916001600160a01b03169063061e70cb90602401602060405180830381865afa158015610b51573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b759190613718565b610b925760405163048fe0e160e21b815260040160405180910390fd5b610b9b84611cb9565b610be583838080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506001600160a01b03881692915050611cec565b9050610bef611d11565b610bf7611e44565b9392505050565b600033610c0c858285611fe1565b610c1785858561205b565b506001949350505050565b610c2a612206565b6000819003610c4c5760405163862a606760e01b815260040160405180910390fd5b60005b81811015610d11576000838383818110610c6b57610c6b613735565b9050602002016020810190610c809190613246565b6001600160a01b031603610ca75760405163862a606760e01b815260040160405180910390fd5b610cd6838383818110610cbc57610cbc613735565b9050602002016020810190610cd19190613246565b612260565b610d08838383818110610ceb57610ceb613735565b9050602002016020810190610d009190613246565b60fb9061230a565b50600101610c4f565b507fbabc6e5e2709bc7fc888125b698960edd9669d60550b920df577e6b9f53ed7cb8282604051610d43929190613795565b60405180910390a15050565b600080606554610d699190600160a01b900460ff166137bf565b905090565b610d76612206565b828114610d9657604051632b477e7160e11b815260040160405180910390fd5b60005b83811015610e74576000858583818110610db557610db5613735565b9050602002016020810190610dca9190613246565b6001600160a01b031603610df15760405163862a606760e01b815260040160405180910390fd5b828282818110610e0357610e03613735565b9050602002016020810190610e18919061369f565b6101006000878785818110610e2f57610e2f613735565b9050602002016020810190610e449190613246565b6001600160a01b031681526020810191909152604001600020805460ff1916911515919091179055600101610d99565b507faa9b4ef90f4ce69eff58dfa82ee849c9d5063df771c1320a024b5a9fb672254384848484604051610eaa94939291906137d8565b60405180910390a150505050565b600033610af1818585610ecb83836118ab565b610ed59190613836565b611b73565b60fd5460405163061e70cb60e01b81523360048201526060916001600160a01b03169063061e70cb90602401602060405180830381865afa158015610f23573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f479190613718565b610f645760405163048fe0e160e21b815260040160405180910390fd5b831580610f6f575081155b15610f8d5760405163862a606760e01b815260040160405180910390fd5b838214610fad57604051632b477e7160e11b815260040160405180910390fd5b836001600160401b03811115610fc557610fc5613489565b604051908082528060200260200182016040528015610ff857816020015b6060815260200190600190039081610fe35790505b50905060005b848110156110ee5761103586868381811061101b5761101b613735565b90506020020160208101906110309190613246565b611cb9565b6110c984848381811061104a5761104a613735565b905060200281019061105c9190613849565b8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152508a92508991508590508181106110a5576110a5613735565b90506020020160208101906110ba9190613246565b6001600160a01b031690611cec565b8282815181106110db576110db613735565b6020908102919091010152600101610ffe565b506110f7611d11565b6110ff611e44565b949350505050565b61110f612206565b61111761231f565b565b600054610100900460ff16158080156111395750600054600160ff909116105b806111535750303b158015611153575060005460ff166001145b6111bb5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084015b60405180910390fd5b6000805460ff1916600117905580156111de576000805461ff0019166101001790555b6001600160a01b03891615806111f357508751155b806111fd57508651155b8061120f57506001600160a01b038616155b8061122157506001600160a01b038516155b8061123357506001600160a01b038416155b8061123c575082155b80611245575081155b156112635760405163862a606760e01b815260040160405180910390fd5b61271083111561128657604051638bff87cf60e01b815260040160405180910390fd5b61128f89612371565b61129988886123a1565b6112a2856123d2565b60fd80546001600160a01b03199081166001600160a01b03898116919091179092556101038054909116868316179055610102849055604080519187166024830152306044830152606480830185905281518084039091018152608490920181526020820180516001600160e01b03166305e52ecf60e21b179052517f0000000000000000000000000000000000000000000000000000000000000000919061134a9061317c565b61135592919061388f565b604051809103906000f080158015611371573d6000803e3d6000fd5b5060ff80546001600160a01b0319166001600160a01b039290921691909117905560fe5461139e90612424565b60ff546040518481526001600160a01b0386811692811691908916907f864da491e43cbd713a095165bead9a80c1b01d4f8bfd9d359ed53b94a5f51cc59060200160405180910390a4801561142d576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050505050565b60ff8054600091600160a01b9091041680156114655750336000908152610100602052604090205460ff16155b1561148357604051630b094f2760e31b815260040160405180910390fd5b600061148e8461184f565b905061149c3384868461248a565b8360fe60008282546114ae9190613836565b90915550610bf79050611d11565b60fd546001600160a01b0316631f7d1388336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015611512573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906115369190613718565b61155357604051633e7845e160e21b815260040160405180910390fd5b611117611e44565b611563612206565b61111760006123d2565b60fd546001600160a01b03166346fbf68e336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156115c3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906115e79190613718565b6116045760405163492f678160e01b815260040160405180910390fd5b611117612508565b611614612206565b60008190036116365760405163862a606760e01b815260040160405180910390fd5b60005b818110156116cc57600083838381811061165557611655613735565b905060200201602081019061166a9190613246565b6001600160a01b0316036116915760405163862a606760e01b815260040160405180910390fd5b6116c38383838181106116a6576116a6613735565b90506020020160208101906116bb9190613246565b60fb90612545565b50600101611639565b507f3422968a100de53deaa12d2acce5eb5e89f18552ab04280b066f55998134be8a8282604051610d43929190613795565b606060378054610a41906136de565b6000338161171b82866118ab565b90508381101561177b5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084016111b2565b610c178286868403611b73565b600033610af181858561205b565b61179e612206565b8115806117b257506001600160a01b038116155b156117d05760405163862a606760e01b815260040160405180910390fd5b6127108211156117f357604051638bff87cf60e01b815260040160405180910390fd5b61010282905561010380546001600160a01b0319166001600160a01b0383169081179091556040805184815260208101929092527fef6604dc393a3dd4dcdb59bbd6bbd8a23ff087235aebd0a9a75e2ab06b06bfcf9101610d43565b6000610add8261185e60355490565b60fe545b600061255a565b6001600160a01b038116600090815260336020526040812054610add906000612577565b6001600160a01b038116600090815260336020526040812054610add565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b6118de612206565b8281146118fe57604051632b477e7160e11b815260040160405180910390fd5b60005b838110156119dc57600085858381811061191d5761191d613735565b90506020020160208101906119329190613246565b6001600160a01b0316036119595760405163862a606760e01b815260040160405180910390fd5b82828281811061196b5761196b613735565b9050602002016020810190611980919061369f565b610104600087878581811061199757611997613735565b90506020020160208101906119ac9190613246565b6001600160a01b031681526020810191909152604001600020805460ff1916911515919091179055600101611901565b507fcdaab68b083efebdbbfdd4fb770eb88a8108cca24c0c339cabfb3c5580b66f5e84848484604051610eaa94939291906137d8565b611a1a612206565b60ff8054821515600160a01b0260ff60a01b199091161790556040517f49d3057180a80162d2a0381be6848c15e0d117e900366482dd3b5443ca8db97490611a6790831515815260200190565b60405180910390a150565b611a7a612206565b6001600160a01b038116611adf5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016111b2565b611ae8816123d2565b50565b60ff546001600160a01b0316336001600160a01b031614611b1f576040516323116dc760e21b815260040160405180910390fd5b611b2933836125b2565b8060fe6000828254611b3b91906138b3565b90915550505050565b6000611b6a611b556103e885613836565b611b616103e887613836565b879190856126e6565b95945050505050565b6001600160a01b038316611bd55760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016111b2565b6001600160a01b038216611c365760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016111b2565b6001600160a01b0383811660008181526034602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b6001600160a01b03811660009081526001830160205260408120541515610bf7565b611cc460fb82611c97565b611ae8576040516388614d6f60e01b81526001600160a01b03821660048201526024016111b2565b6060610bf7838360405180606001604052806027815260200161428f60279139612741565b60ff546040805163117adc5b60e01b815290516000926001600160a01b03169163117adc5b9160048083019260209291908290030181865afa158015611d5b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611d7f91906138c6565b90508015611ae857600081611d926127af565b11611da457611d9f6127af565b611da6565b815b90508015611e405760ff54611de1906001600160a01b031682611dd16065546001600160a01b031690565b6001600160a01b0316919061281c565b60ff54604051638441952b60e01b8152600481018390526001600160a01b0390911690638441952b90602401600060405180830381600087803b158015611e2757600080fd5b505af1158015611e3b573d6000803e3d6000fd5b505050505b5050565b6000611e586065546001600160a01b031690565b60ff546040516370a0823160e01b81526001600160a01b0391821660048201529116906370a0823190602401602060405180830381865afa158015611ea1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611ec591906138c6565b611ecd6127af565b611ed79190613836565b905060006317cf780960e11b611ef56065546001600160a01b031690565b6040516001600160a01b03909116602482015260440160408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152905060005b611f4c60fb6128fc565b811015611f8957611f62826110ba60fb84612906565b806020019051810190611f7591906138c6565b611f7f9084613836565b9250600101611f42565b50611f9382612912565b60fe805490839055828114611fdc5760408051828152602081018590527f3e71705c981be4c1b2eb594db2facdb42124f8c29e8b77e7b417872626301ca1910160405180910390a15b505050565b6000611fed84846118ab565b9050600019811461205557818110156120485760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000060448201526064016111b2565b6120558484848403611b73565b50505050565b6001600160a01b0383166120bf5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b60648201526084016111b2565b6001600160a01b0382166121215760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016111b2565b6001600160a01b038316600090815260336020526040902054818110156121995760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b60648201526084016111b2565b6001600160a01b0380851660008181526033602052604080822086860390559286168082529083902080548601905591517fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef906121f99086815260200190565b60405180910390a3612055565b6097546001600160a01b031633146111175760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016111b2565b6000816001600160a01b0316632f9ef0126122836065546001600160a01b031690565b6040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156122c7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906122eb91906138c6565b1115611ae857604051636a98138560e01b815260040160405180910390fd5b6000610bf7836001600160a01b038416612a00565b612327612af3565b60c9805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600054610100900460ff166123985760405162461bcd60e51b81526004016111b2906138df565b611ae881612b3c565b600054610100900460ff166123c85760405162461bcd60e51b81526004016111b2906138df565b611e408282612bc1565b609780546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6000612447612431610d4f565b61243c90600a613a11565b603554846000611b44565b905061010154811115611e40576101018190556040518181527f3cb4ff844fcf16bc019a89519a863ded8ba67bb7e6ebc0a35d4d1b7704f89f8190602001610d43565b6065546124a2906001600160a01b0316853085612c01565b6124ac8382612c39565b826001600160a01b0316846001600160a01b03167fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d784846040516124fa929190918252602082015260400190565b60405180910390a350505050565b612510612cfa565b60c9805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586123543390565b6000610bf7836001600160a01b038416612d40565b6000611b6a61256b6103e886613836565b611b616103e886613836565b6000610bf761258560fe5490565b612590906001613836565b61259c6000600a613a11565b6035546125a99190613836565b859190856126e6565b6001600160a01b0382166126125760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016111b2565b6001600160a01b038216600090815260336020526040902054818110156126865760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b60648201526084016111b2565b6001600160a01b03831660008181526033602090815260408083208686039055603580548790039055518581529192917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a3505050565b6000806126f4868686612d8f565b9050600183600281111561270a5761270a613a20565b14801561272757506000848061272257612722613a36565b868809115b15611b6a57612737600182613836565b9695505050505050565b6060600080856001600160a01b03168560405161275e9190613a4c565b600060405180830381855af49150503d8060008114612799576040519150601f19603f3d011682016040523d82523d6000602084013e61279e565b606091505b509150915061273786838387612e79565b6065546040516370a0823160e01b81523060048201526000916001600160a01b0316906370a0823190602401602060405180830381865afa1580156127f8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d6991906138c6565b604051636eb1769f60e11b81523060048201526001600160a01b0383811660248301526000919085169063dd62ed3e90604401602060405180830381865afa15801561286c573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061289091906138c6565b90506120558463095ea7b360e01b856128a98686613836565b6040516001600160a01b03909216602483015260448201526064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152612ef2565b6000610add825490565b6000610bf78383612fc7565b600061291f612431610d4f565b905061010154811115611e405760006129526101015461293d610d4f565b61294890600a613a11565b6035549190612d8f565b61295c90846138b3565b9050600061271061010254836129729190613a68565b61297c9190613a7f565b905060006129978261298d60355490565b61186285896138b3565b905080156129f057610103546129b6906001600160a01b031682612c39565b60408051828152602081018490527fc1d58cf5b3594eed8669a609ed1ded7c288b948e1c5c21f244df05c9e4ac4a98910160405180910390a15b6129f985612424565b5050505050565b60008181526001830160205260408120548015612ae9576000612a246001836138b3565b8554909150600090612a38906001906138b3565b9050818114612a9d576000866000018281548110612a5857612a58613735565b9060005260206000200154905080876000018481548110612a7b57612a7b613735565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080612aae57612aae613aa1565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610add565b6000915050610add565b60c95460ff166111175760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b60448201526064016111b2565b600054610100900460ff16612b635760405162461bcd60e51b81526004016111b2906138df565b600080612b6f83612ff1565b9150915081612b7f576012612b81565b805b606580546001600160a01b039095166001600160a01b031960ff93909316600160a01b02929092166001600160a81b031990951694909417179092555050565b600054610100900460ff16612be85760405162461bcd60e51b81526004016111b2906138df565b6036612bf48382613afe565b506037611fdc8282613afe565b6040516001600160a01b03808516602483015283166044820152606481018290526120559085906323b872dd60e01b906084016128c5565b6001600160a01b038216612c8f5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016111b2565b8060356000828254612ca19190613836565b90915550506001600160a01b0382166000818152603360209081526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b60c95460ff16156111175760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b60448201526064016111b2565b6000818152600183016020526040812054612d8757508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610add565b506000610add565b6000808060001985870985870292508281108382030391505080600003612dc957838281612dbf57612dbf613a36565b0492505050610bf7565b808411612e105760405162461bcd60e51b81526020600482015260156024820152744d6174683a206d756c446976206f766572666c6f7760581b60448201526064016111b2565b60008486880960026001871981018816978890046003810283188082028403028082028403028082028403028082028403028082028403029081029092039091026000889003889004909101858311909403939093029303949094049190911702949350505050565b60608315612ee8578251600003612ee1576001600160a01b0385163b612ee15760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016111b2565b50816110ff565b6110ff83836130cd565b6000612f47826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166130f79092919063ffffffff16565b9050805160001480612f68575080806020019051810190612f689190613718565b611fdc5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b60648201526084016111b2565b6000826000018281548110612fde57612fde613735565b9060005260206000200154905092915050565b60408051600481526024810182526020810180516001600160e01b031663313ce56760e01b17905290516000918291829182916001600160a01b0387169161303891613a4c565b600060405180830381855afa9150503d8060008114613073576040519150601f19603f3d011682016040523d82523d6000602084013e613078565b606091505b509150915081801561308c57506020815110155b156130c0576000818060200190518101906130a791906138c6565b905060ff81116130be576001969095509350505050565b505b5060009485945092505050565b8151156130dd5781518083602001fd5b8060405162461bcd60e51b81526004016111b291906131d9565b60606110ff848460008585600080866001600160a01b0316858760405161311e9190613a4c565b60006040518083038185875af1925050503d806000811461315b576040519150601f19603f3d011682016040523d82523d6000602084013e613160565b606091505b509150915061317187838387612e79565b979650505050505050565b6106d280613bbd83390190565b60005b838110156131a457818101518382015260200161318c565b50506000910152565b600081518084526131c5816020860160208601613189565b601f01601f19169290920160200192915050565b602081526000610bf760208301846131ad565b6000602082840312156131fe57600080fd5b5035919050565b6001600160a01b0381168114611ae857600080fd5b6000806040838503121561322d57600080fd5b823561323881613205565b946020939093013593505050565b60006020828403121561325857600080fd5b8135610bf781613205565b60008060006040848603121561327857600080fd5b833561328381613205565b925060208401356001600160401b0381111561329e57600080fd5b8401601f810186136132af57600080fd5b80356001600160401b038111156132c557600080fd5b8660208284010111156132d757600080fd5b939660209190910195509293505050565b6000806000606084860312156132fd57600080fd5b833561330881613205565b9250602084013561331881613205565b929592945050506040919091013590565b60008083601f84011261333b57600080fd5b5081356001600160401b0381111561335257600080fd5b6020830191508360208260051b850101111561336d57600080fd5b9250929050565b6000806020838503121561338757600080fd5b82356001600160401b0381111561339d57600080fd5b6133a985828601613329565b90969095509350505050565b600080600080604085870312156133cb57600080fd5b84356001600160401b038111156133e157600080fd5b6133ed87828801613329565b90955093505060208501356001600160401b0381111561340c57600080fd5b61341887828801613329565b95989497509550505050565b6000602082016020835280845180835260408501915060408160051b86010192506020860160005b8281101561347d57603f198786030184526134688583516131ad565b9450602093840193919091019060010161344c565b50929695505050505050565b634e487b7160e01b600052604160045260246000fd5b600082601f8301126134b057600080fd5b81356001600160401b038111156134c9576134c9613489565b604051601f8201601f19908116603f011681016001600160401b03811182821017156134f7576134f7613489565b60405281815283820160200185101561350f57600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600080600080610100898b03121561354957600080fd5b883561355481613205565b975060208901356001600160401b0381111561356f57600080fd5b61357b8b828c0161349f565b97505060408901356001600160401b0381111561359757600080fd5b6135a38b828c0161349f565b96505060608901356135b481613205565b945060808901356135c481613205565b935060a08901356135d481613205565b979a969950949793969295929450505060c08201359160e0013590565b6000806040838503121561360457600080fd5b82359150602083013561361681613205565b809150509250929050565b60008060006060848603121561363657600080fd5b83359250602084013561364881613205565b9150604084013561365881613205565b809150509250925092565b6000806040838503121561367657600080fd5b823561368181613205565b9150602083013561361681613205565b8015158114611ae857600080fd5b6000602082840312156136b157600080fd5b8135610bf781613691565b600080604083850312156136cf57600080fd5b50508035926020909101359150565b600181811c908216806136f257607f821691505b60208210810361371257634e487b7160e01b600052602260045260246000fd5b50919050565b60006020828403121561372a57600080fd5b8151610bf781613691565b634e487b7160e01b600052603260045260246000fd5b81835260208301925060008160005b8481101561378b57813561376d81613205565b6001600160a01b03168652602095860195919091019060010161375a565b5093949350505050565b6020815260006110ff60208301848661374b565b634e487b7160e01b600052601160045260246000fd5b60ff8181168382160190811115610add57610add6137a9565b6040815260006137ec60408301868861374b565b82810360208085019190915284825285910160005b8581101561382a57823561381481613691565b1515825260209283019290910190600101613801565b50979650505050505050565b80820180821115610add57610add6137a9565b6000808335601e1984360301811261386057600080fd5b8301803591506001600160401b0382111561387a57600080fd5b60200191503681900382131561336d57600080fd5b6001600160a01b03831681526040602082018190526000906110ff908301846131ad565b81810381811115610add57610add6137a9565b6000602082840312156138d857600080fd5b5051919050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6001815b600184111561396557808504811115613949576139496137a9565b600184161561395757908102905b60019390931c92800261392e565b935093915050565b60008261397c57506001610add565b8161398957506000610add565b816001811461399f57600281146139a9576139c5565b6001915050610add565b60ff8411156139ba576139ba6137a9565b50506001821b610add565b5060208310610133831016604e8410600b84101617156139e8575081810a610add565b6139f5600019848461392a565b8060001904821115613a0957613a096137a9565b029392505050565b6000610bf760ff84168361396d565b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052601260045260246000fd5b60008251613a5e818460208701613189565b9190910192915050565b8082028115828204841417610add57610add6137a9565b600082613a9c57634e487b7160e01b600052601260045260246000fd5b500490565b634e487b7160e01b600052603160045260246000fd5b601f821115611fdc57806000526020600020601f840160051c81016020851015613ade5750805b601f840160051c820191505b818110156129f95760008155600101613aea565b81516001600160401b03811115613b1757613b17613489565b613b2b81613b2584546136de565b84613ab7565b6020601f821160018114613b5f5760008315613b475750848201515b600019600385901b1c1916600184901b1784556129f9565b600084815260208120601f198516915b82811015613b8f5787850151825560209485019460019092019101613b6f565b5084821015613bad5786840151600019600387901b60f8161c191681555b50505050600190811b0190555056fe60806040526040516106d23803806106d283398101604081905261002291610420565b61002e82826000610035565b5050610550565b61003e836100f6565b6040516001600160a01b038416907f1cf3b03a6cf19fa2baba4df148e9dcabedea7f8a5c07840e207e5c089be95d3e90600090a260008251118061007f5750805b156100f1576100ef836001600160a01b0316635c60da1b6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156100c5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906100e991906104e6565b8361027a565b505b505050565b6001600160a01b0381163b6101605760405162461bcd60e51b815260206004820152602560248201527f455243313936373a206e657720626561636f6e206973206e6f74206120636f6e6044820152641d1c9858dd60da1b60648201526084015b60405180910390fd5b6101d4816001600160a01b0316635c60da1b6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156101a1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101c591906104e6565b6001600160a01b03163b151590565b6102395760405162461bcd60e51b815260206004820152603060248201527f455243313936373a20626561636f6e20696d706c656d656e746174696f6e206960448201526f1cc81b9bdd08184818dbdb9d1c9858dd60821b6064820152608401610157565b7fa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d5080546001600160a01b0319166001600160a01b0392909216919091179055565b606061029f83836040518060600160405280602781526020016106ab602791396102a6565b9392505050565b6060600080856001600160a01b0316856040516102c39190610501565b600060405180830381855af49150503d80600081146102fe576040519150601f19603f3d011682016040523d82523d6000602084013e610303565b606091505b5090925090506103158683838761031f565b9695505050505050565b6060831561038e578251600003610387576001600160a01b0385163b6103875760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610157565b5081610398565b61039883836103a0565b949350505050565b8151156103b05781518083602001fd5b8060405162461bcd60e51b8152600401610157919061051d565b80516001600160a01b03811681146103e157600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b60005b838110156104175781810151838201526020016103ff565b50506000910152565b6000806040838503121561043357600080fd5b61043c836103ca565b60208401519092506001600160401b0381111561045857600080fd5b8301601f8101851361046957600080fd5b80516001600160401b03811115610482576104826103e6565b604051601f8201601f19908116603f011681016001600160401b03811182821017156104b0576104b06103e6565b6040528181528282016020018710156104c857600080fd5b6104d98260208301602086016103fc565b8093505050509250929050565b6000602082840312156104f857600080fd5b61029f826103ca565b600082516105138184602087016103fc565b9190910192915050565b602081526000825180602084015261053c8160408501602087016103fc565b601f01601f19169190910160400192915050565b61014c8061055f6000396000f3fe60806040523661001357610011610017565b005b6100115b610027610022610029565b6100c2565b565b600061005c7fa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50546001600160a01b031690565b6001600160a01b0316635c60da1b6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610099573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906100bd91906100e6565b905090565b3660008037600080366000845af43d6000803e8080156100e1573d6000f35b3d6000fd5b6000602082840312156100f857600080fd5b81516001600160a01b038116811461010f57600080fd5b939250505056fea2646970667358221220a7298eafd4a420fcef5cf3ba95e306b035678298d6386d26ef739ff71d7fe83a64736f6c634300081b0033416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220d912219f5801aa7cf89dc4683031a7dd2ae39316ed6a601504e93b1b9f3514d564736f6c634300081b003300000000000000000000000078629734f984f835c3d28d5d98078a9213a5b4a3
Deployed Bytecode
0x6080604052600436106103845760003560e01c8063715018a6116101d1578063b9d4e87911610102578063dd62ed3e116100a0578063ef8b30f71161006f578063ef8b30f7146108d2578063f2fde38b146109be578063f5d4ee20146109de578063fd015286146109fe57600080fd5b8063dd62ed3e14610948578063e1f1c4a714610968578063eb1bb7591461097e578063eb2f8f771461099e57600080fd5b8063c6e6f592116100dc578063c6e6f592146108d2578063c70920bc146108f2578063ce96cb7714610908578063d905777e1461092857600080fd5b8063b9d4e879146108bb578063ba087652146108a0578063c63d75b61461063957600080fd5b80639c3a8e1b1161016f578063ad93b4b711610149578063ad93b4b714610496578063ae56c03f14610880578063b3d7f6b91461047b578063b460af94146108a057600080fd5b80639c3a8e1b14610829578063a457c2d714610840578063a9059cbb1461086057600080fd5b80638da5cb5b116101ab5780638da5cb5b146107aa57806394bf804d146107c857806395d89b41146107e35780639b19251a146107f857600080fd5b8063715018a6146107605780638456cb59146107755780638ac09f291461078a57600080fd5b806333320de3116102b657806346f5dfd61161025457806360125ff21161022357806360125ff2146106d55780636e553f65146106f55780636f3495eb1461071557806370a082311461072a57600080fd5b806346f5dfd61461067c5780634cdad5061461042b57806351a2d6d11461069d5780635c975abb146106bd57600080fd5b80633b12964a116102905780633b12964a146105f75780633f4ba83a14610624578063402d267d14610639578063469048401461065b57600080fd5b806333320de31461059957806338d52e0f146105b957806339509351146105d757600080fd5b806312bc426511610323578063236278a5116102fd578063236278a51461050157806323b872dd1461053257806327b86e0f14610552578063313ce5671461057257600080fd5b806312bc4265146104ac57806318160ddd146104cc578063213bf7f6146104e157600080fd5b806307a2d13a1161035f57806307a2d13a1461042b578063095ea7b31461044b5780630a28a4771461047b578063101395fa1461049657600080fd5b8062435da5146103ad57806301e1d114146103ea57806306fdde031461040957600080fd5b366103a857336000908152610104602052604090205460ff166103a657600080fd5b005b600080fd5b3480156103b957600080fd5b5060fd546103cd906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156103f657600080fd5b5060fe545b6040519081526020016103e1565b34801561041557600080fd5b5061041e610a32565b6040516103e191906131d9565b34801561043757600080fd5b506103fb6104463660046131ec565b610ac4565b34801561045757600080fd5b5061046b61046636600461321a565b610ae3565b60405190151581526020016103e1565b34801561048757600080fd5b506103fb6103a83660046131ec565b3480156104a257600080fd5b506103fb6103e881565b3480156104b857600080fd5b5061046b6104c7366004613246565b610afb565b3480156104d857600080fd5b506035546103fb565b3480156104ed57600080fd5b5061041e6104fc366004613263565b610b08565b34801561050d57600080fd5b5061046b61051c366004613246565b6101046020526000908152604090205460ff1681565b34801561053e57600080fd5b5061046b61054d3660046132e8565b610bfe565b34801561055e57600080fd5b506103a661056d366004613374565b610c22565b34801561057e57600080fd5b50610587610d4f565b60405160ff90911681526020016103e1565b3480156105a557600080fd5b506103a66105b43660046133b5565b610d6e565b3480156105c557600080fd5b506065546001600160a01b03166103cd565b3480156105e357600080fd5b5061046b6105f236600461321a565b610eb8565b34801561060357600080fd5b506106176106123660046133b5565b610eda565b6040516103e19190613424565b34801561063057600080fd5b506103a6611107565b34801561064557600080fd5b506103fb610654366004613246565b5060001990565b34801561066757600080fd5b50610103546103cd906001600160a01b031681565b34801561068857600080fd5b5060ff805461046b91600160a01b9091041681565b3480156106a957600080fd5b5060ff546103cd906001600160a01b031681565b3480156106c957600080fd5b5060c95460ff1661046b565b3480156106e157600080fd5b506103a66106f036600461352c565b611119565b34801561070157600080fd5b506103fb6107103660046135f1565b611438565b34801561072157600080fd5b506103a66114bc565b34801561073657600080fd5b506103fb610745366004613246565b6001600160a01b031660009081526033602052604090205490565b34801561076c57600080fd5b506103a661155b565b34801561078157600080fd5b506103a661156d565b34801561079657600080fd5b506103a66107a5366004613374565b61160c565b3480156107b657600080fd5b506097546001600160a01b03166103cd565b3480156107d457600080fd5b506103fb6103a83660046135f1565b3480156107ef57600080fd5b5061041e6116fe565b34801561080457600080fd5b5061046b610813366004613246565b6101006020526000908152604090205460ff1681565b34801561083557600080fd5b506103fb6101015481565b34801561084c57600080fd5b5061046b61085b36600461321a565b61170d565b34801561086c57600080fd5b5061046b61087b36600461321a565b611788565b34801561088c57600080fd5b506103a661089b3660046135f1565b611796565b3480156108ac57600080fd5b506103fb6103a8366004613621565b3480156108c757600080fd5b506103fb6101025481565b3480156108de57600080fd5b506103fb6108ed3660046131ec565b61184f565b3480156108fe57600080fd5b506103fb60fe5481565b34801561091457600080fd5b506103fb610923366004613246565b611869565b34801561093457600080fd5b506103fb610943366004613246565b61188d565b34801561095457600080fd5b506103fb610963366004613663565b6118ab565b34801561097457600080fd5b506103fb61271081565b34801561098a57600080fd5b506103a66109993660046133b5565b6118d6565b3480156109aa57600080fd5b506103a66109b936600461369f565b611a12565b3480156109ca57600080fd5b506103a66109d9366004613246565b611a72565b3480156109ea57600080fd5b506103a66109f93660046136bc565b611aeb565b348015610a0a57600080fd5b506103cd7f00000000000000000000000078629734f984f835c3d28d5d98078a9213a5b4a381565b606060368054610a41906136de565b80601f0160208091040260200160405190810160405280929190818152602001828054610a6d906136de565b8015610aba5780601f10610a8f57610100808354040283529160200191610aba565b820191906000526020600020905b815481529060010190602001808311610a9d57829003601f168201915b5050505050905090565b6000610add82610ad360355490565b60fe546000611b44565b92915050565b600033610af1818585611b73565b5060019392505050565b6000610add60fb83611c97565b60fd5460405163061e70cb60e01b81523360048201526060916001600160a01b03169063061e70cb90602401602060405180830381865afa158015610b51573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b759190613718565b610b925760405163048fe0e160e21b815260040160405180910390fd5b610b9b84611cb9565b610be583838080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506001600160a01b03881692915050611cec565b9050610bef611d11565b610bf7611e44565b9392505050565b600033610c0c858285611fe1565b610c1785858561205b565b506001949350505050565b610c2a612206565b6000819003610c4c5760405163862a606760e01b815260040160405180910390fd5b60005b81811015610d11576000838383818110610c6b57610c6b613735565b9050602002016020810190610c809190613246565b6001600160a01b031603610ca75760405163862a606760e01b815260040160405180910390fd5b610cd6838383818110610cbc57610cbc613735565b9050602002016020810190610cd19190613246565b612260565b610d08838383818110610ceb57610ceb613735565b9050602002016020810190610d009190613246565b60fb9061230a565b50600101610c4f565b507fbabc6e5e2709bc7fc888125b698960edd9669d60550b920df577e6b9f53ed7cb8282604051610d43929190613795565b60405180910390a15050565b600080606554610d699190600160a01b900460ff166137bf565b905090565b610d76612206565b828114610d9657604051632b477e7160e11b815260040160405180910390fd5b60005b83811015610e74576000858583818110610db557610db5613735565b9050602002016020810190610dca9190613246565b6001600160a01b031603610df15760405163862a606760e01b815260040160405180910390fd5b828282818110610e0357610e03613735565b9050602002016020810190610e18919061369f565b6101006000878785818110610e2f57610e2f613735565b9050602002016020810190610e449190613246565b6001600160a01b031681526020810191909152604001600020805460ff1916911515919091179055600101610d99565b507faa9b4ef90f4ce69eff58dfa82ee849c9d5063df771c1320a024b5a9fb672254384848484604051610eaa94939291906137d8565b60405180910390a150505050565b600033610af1818585610ecb83836118ab565b610ed59190613836565b611b73565b60fd5460405163061e70cb60e01b81523360048201526060916001600160a01b03169063061e70cb90602401602060405180830381865afa158015610f23573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f479190613718565b610f645760405163048fe0e160e21b815260040160405180910390fd5b831580610f6f575081155b15610f8d5760405163862a606760e01b815260040160405180910390fd5b838214610fad57604051632b477e7160e11b815260040160405180910390fd5b836001600160401b03811115610fc557610fc5613489565b604051908082528060200260200182016040528015610ff857816020015b6060815260200190600190039081610fe35790505b50905060005b848110156110ee5761103586868381811061101b5761101b613735565b90506020020160208101906110309190613246565b611cb9565b6110c984848381811061104a5761104a613735565b905060200281019061105c9190613849565b8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152508a92508991508590508181106110a5576110a5613735565b90506020020160208101906110ba9190613246565b6001600160a01b031690611cec565b8282815181106110db576110db613735565b6020908102919091010152600101610ffe565b506110f7611d11565b6110ff611e44565b949350505050565b61110f612206565b61111761231f565b565b600054610100900460ff16158080156111395750600054600160ff909116105b806111535750303b158015611153575060005460ff166001145b6111bb5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084015b60405180910390fd5b6000805460ff1916600117905580156111de576000805461ff0019166101001790555b6001600160a01b03891615806111f357508751155b806111fd57508651155b8061120f57506001600160a01b038616155b8061122157506001600160a01b038516155b8061123357506001600160a01b038416155b8061123c575082155b80611245575081155b156112635760405163862a606760e01b815260040160405180910390fd5b61271083111561128657604051638bff87cf60e01b815260040160405180910390fd5b61128f89612371565b61129988886123a1565b6112a2856123d2565b60fd80546001600160a01b03199081166001600160a01b03898116919091179092556101038054909116868316179055610102849055604080519187166024830152306044830152606480830185905281518084039091018152608490920181526020820180516001600160e01b03166305e52ecf60e21b179052517f00000000000000000000000078629734f984f835c3d28d5d98078a9213a5b4a3919061134a9061317c565b61135592919061388f565b604051809103906000f080158015611371573d6000803e3d6000fd5b5060ff80546001600160a01b0319166001600160a01b039290921691909117905560fe5461139e90612424565b60ff546040518481526001600160a01b0386811692811691908916907f864da491e43cbd713a095165bead9a80c1b01d4f8bfd9d359ed53b94a5f51cc59060200160405180910390a4801561142d576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050505050565b60ff8054600091600160a01b9091041680156114655750336000908152610100602052604090205460ff16155b1561148357604051630b094f2760e31b815260040160405180910390fd5b600061148e8461184f565b905061149c3384868461248a565b8360fe60008282546114ae9190613836565b90915550610bf79050611d11565b60fd546001600160a01b0316631f7d1388336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015611512573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906115369190613718565b61155357604051633e7845e160e21b815260040160405180910390fd5b611117611e44565b611563612206565b61111760006123d2565b60fd546001600160a01b03166346fbf68e336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156115c3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906115e79190613718565b6116045760405163492f678160e01b815260040160405180910390fd5b611117612508565b611614612206565b60008190036116365760405163862a606760e01b815260040160405180910390fd5b60005b818110156116cc57600083838381811061165557611655613735565b905060200201602081019061166a9190613246565b6001600160a01b0316036116915760405163862a606760e01b815260040160405180910390fd5b6116c38383838181106116a6576116a6613735565b90506020020160208101906116bb9190613246565b60fb90612545565b50600101611639565b507f3422968a100de53deaa12d2acce5eb5e89f18552ab04280b066f55998134be8a8282604051610d43929190613795565b606060378054610a41906136de565b6000338161171b82866118ab565b90508381101561177b5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084016111b2565b610c178286868403611b73565b600033610af181858561205b565b61179e612206565b8115806117b257506001600160a01b038116155b156117d05760405163862a606760e01b815260040160405180910390fd5b6127108211156117f357604051638bff87cf60e01b815260040160405180910390fd5b61010282905561010380546001600160a01b0319166001600160a01b0383169081179091556040805184815260208101929092527fef6604dc393a3dd4dcdb59bbd6bbd8a23ff087235aebd0a9a75e2ab06b06bfcf9101610d43565b6000610add8261185e60355490565b60fe545b600061255a565b6001600160a01b038116600090815260336020526040812054610add906000612577565b6001600160a01b038116600090815260336020526040812054610add565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b6118de612206565b8281146118fe57604051632b477e7160e11b815260040160405180910390fd5b60005b838110156119dc57600085858381811061191d5761191d613735565b90506020020160208101906119329190613246565b6001600160a01b0316036119595760405163862a606760e01b815260040160405180910390fd5b82828281811061196b5761196b613735565b9050602002016020810190611980919061369f565b610104600087878581811061199757611997613735565b90506020020160208101906119ac9190613246565b6001600160a01b031681526020810191909152604001600020805460ff1916911515919091179055600101611901565b507fcdaab68b083efebdbbfdd4fb770eb88a8108cca24c0c339cabfb3c5580b66f5e84848484604051610eaa94939291906137d8565b611a1a612206565b60ff8054821515600160a01b0260ff60a01b199091161790556040517f49d3057180a80162d2a0381be6848c15e0d117e900366482dd3b5443ca8db97490611a6790831515815260200190565b60405180910390a150565b611a7a612206565b6001600160a01b038116611adf5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016111b2565b611ae8816123d2565b50565b60ff546001600160a01b0316336001600160a01b031614611b1f576040516323116dc760e21b815260040160405180910390fd5b611b2933836125b2565b8060fe6000828254611b3b91906138b3565b90915550505050565b6000611b6a611b556103e885613836565b611b616103e887613836565b879190856126e6565b95945050505050565b6001600160a01b038316611bd55760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016111b2565b6001600160a01b038216611c365760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016111b2565b6001600160a01b0383811660008181526034602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b6001600160a01b03811660009081526001830160205260408120541515610bf7565b611cc460fb82611c97565b611ae8576040516388614d6f60e01b81526001600160a01b03821660048201526024016111b2565b6060610bf7838360405180606001604052806027815260200161428f60279139612741565b60ff546040805163117adc5b60e01b815290516000926001600160a01b03169163117adc5b9160048083019260209291908290030181865afa158015611d5b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611d7f91906138c6565b90508015611ae857600081611d926127af565b11611da457611d9f6127af565b611da6565b815b90508015611e405760ff54611de1906001600160a01b031682611dd16065546001600160a01b031690565b6001600160a01b0316919061281c565b60ff54604051638441952b60e01b8152600481018390526001600160a01b0390911690638441952b90602401600060405180830381600087803b158015611e2757600080fd5b505af1158015611e3b573d6000803e3d6000fd5b505050505b5050565b6000611e586065546001600160a01b031690565b60ff546040516370a0823160e01b81526001600160a01b0391821660048201529116906370a0823190602401602060405180830381865afa158015611ea1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611ec591906138c6565b611ecd6127af565b611ed79190613836565b905060006317cf780960e11b611ef56065546001600160a01b031690565b6040516001600160a01b03909116602482015260440160408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152905060005b611f4c60fb6128fc565b811015611f8957611f62826110ba60fb84612906565b806020019051810190611f7591906138c6565b611f7f9084613836565b9250600101611f42565b50611f9382612912565b60fe805490839055828114611fdc5760408051828152602081018590527f3e71705c981be4c1b2eb594db2facdb42124f8c29e8b77e7b417872626301ca1910160405180910390a15b505050565b6000611fed84846118ab565b9050600019811461205557818110156120485760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000060448201526064016111b2565b6120558484848403611b73565b50505050565b6001600160a01b0383166120bf5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b60648201526084016111b2565b6001600160a01b0382166121215760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016111b2565b6001600160a01b038316600090815260336020526040902054818110156121995760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b60648201526084016111b2565b6001600160a01b0380851660008181526033602052604080822086860390559286168082529083902080548601905591517fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef906121f99086815260200190565b60405180910390a3612055565b6097546001600160a01b031633146111175760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016111b2565b6000816001600160a01b0316632f9ef0126122836065546001600160a01b031690565b6040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156122c7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906122eb91906138c6565b1115611ae857604051636a98138560e01b815260040160405180910390fd5b6000610bf7836001600160a01b038416612a00565b612327612af3565b60c9805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600054610100900460ff166123985760405162461bcd60e51b81526004016111b2906138df565b611ae881612b3c565b600054610100900460ff166123c85760405162461bcd60e51b81526004016111b2906138df565b611e408282612bc1565b609780546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6000612447612431610d4f565b61243c90600a613a11565b603554846000611b44565b905061010154811115611e40576101018190556040518181527f3cb4ff844fcf16bc019a89519a863ded8ba67bb7e6ebc0a35d4d1b7704f89f8190602001610d43565b6065546124a2906001600160a01b0316853085612c01565b6124ac8382612c39565b826001600160a01b0316846001600160a01b03167fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d784846040516124fa929190918252602082015260400190565b60405180910390a350505050565b612510612cfa565b60c9805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586123543390565b6000610bf7836001600160a01b038416612d40565b6000611b6a61256b6103e886613836565b611b616103e886613836565b6000610bf761258560fe5490565b612590906001613836565b61259c6000600a613a11565b6035546125a99190613836565b859190856126e6565b6001600160a01b0382166126125760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016111b2565b6001600160a01b038216600090815260336020526040902054818110156126865760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b60648201526084016111b2565b6001600160a01b03831660008181526033602090815260408083208686039055603580548790039055518581529192917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a3505050565b6000806126f4868686612d8f565b9050600183600281111561270a5761270a613a20565b14801561272757506000848061272257612722613a36565b868809115b15611b6a57612737600182613836565b9695505050505050565b6060600080856001600160a01b03168560405161275e9190613a4c565b600060405180830381855af49150503d8060008114612799576040519150601f19603f3d011682016040523d82523d6000602084013e61279e565b606091505b509150915061273786838387612e79565b6065546040516370a0823160e01b81523060048201526000916001600160a01b0316906370a0823190602401602060405180830381865afa1580156127f8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d6991906138c6565b604051636eb1769f60e11b81523060048201526001600160a01b0383811660248301526000919085169063dd62ed3e90604401602060405180830381865afa15801561286c573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061289091906138c6565b90506120558463095ea7b360e01b856128a98686613836565b6040516001600160a01b03909216602483015260448201526064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152612ef2565b6000610add825490565b6000610bf78383612fc7565b600061291f612431610d4f565b905061010154811115611e405760006129526101015461293d610d4f565b61294890600a613a11565b6035549190612d8f565b61295c90846138b3565b9050600061271061010254836129729190613a68565b61297c9190613a7f565b905060006129978261298d60355490565b61186285896138b3565b905080156129f057610103546129b6906001600160a01b031682612c39565b60408051828152602081018490527fc1d58cf5b3594eed8669a609ed1ded7c288b948e1c5c21f244df05c9e4ac4a98910160405180910390a15b6129f985612424565b5050505050565b60008181526001830160205260408120548015612ae9576000612a246001836138b3565b8554909150600090612a38906001906138b3565b9050818114612a9d576000866000018281548110612a5857612a58613735565b9060005260206000200154905080876000018481548110612a7b57612a7b613735565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080612aae57612aae613aa1565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610add565b6000915050610add565b60c95460ff166111175760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b60448201526064016111b2565b600054610100900460ff16612b635760405162461bcd60e51b81526004016111b2906138df565b600080612b6f83612ff1565b9150915081612b7f576012612b81565b805b606580546001600160a01b039095166001600160a01b031960ff93909316600160a01b02929092166001600160a81b031990951694909417179092555050565b600054610100900460ff16612be85760405162461bcd60e51b81526004016111b2906138df565b6036612bf48382613afe565b506037611fdc8282613afe565b6040516001600160a01b03808516602483015283166044820152606481018290526120559085906323b872dd60e01b906084016128c5565b6001600160a01b038216612c8f5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016111b2565b8060356000828254612ca19190613836565b90915550506001600160a01b0382166000818152603360209081526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b60c95460ff16156111175760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b60448201526064016111b2565b6000818152600183016020526040812054612d8757508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610add565b506000610add565b6000808060001985870985870292508281108382030391505080600003612dc957838281612dbf57612dbf613a36565b0492505050610bf7565b808411612e105760405162461bcd60e51b81526020600482015260156024820152744d6174683a206d756c446976206f766572666c6f7760581b60448201526064016111b2565b60008486880960026001871981018816978890046003810283188082028403028082028403028082028403028082028403028082028403029081029092039091026000889003889004909101858311909403939093029303949094049190911702949350505050565b60608315612ee8578251600003612ee1576001600160a01b0385163b612ee15760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016111b2565b50816110ff565b6110ff83836130cd565b6000612f47826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166130f79092919063ffffffff16565b9050805160001480612f68575080806020019051810190612f689190613718565b611fdc5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b60648201526084016111b2565b6000826000018281548110612fde57612fde613735565b9060005260206000200154905092915050565b60408051600481526024810182526020810180516001600160e01b031663313ce56760e01b17905290516000918291829182916001600160a01b0387169161303891613a4c565b600060405180830381855afa9150503d8060008114613073576040519150601f19603f3d011682016040523d82523d6000602084013e613078565b606091505b509150915081801561308c57506020815110155b156130c0576000818060200190518101906130a791906138c6565b905060ff81116130be576001969095509350505050565b505b5060009485945092505050565b8151156130dd5781518083602001fd5b8060405162461bcd60e51b81526004016111b291906131d9565b60606110ff848460008585600080866001600160a01b0316858760405161311e9190613a4c565b60006040518083038185875af1925050503d806000811461315b576040519150601f19603f3d011682016040523d82523d6000602084013e613160565b606091505b509150915061317187838387612e79565b979650505050505050565b6106d280613bbd83390190565b60005b838110156131a457818101518382015260200161318c565b50506000910152565b600081518084526131c5816020860160208601613189565b601f01601f19169290920160200192915050565b602081526000610bf760208301846131ad565b6000602082840312156131fe57600080fd5b5035919050565b6001600160a01b0381168114611ae857600080fd5b6000806040838503121561322d57600080fd5b823561323881613205565b946020939093013593505050565b60006020828403121561325857600080fd5b8135610bf781613205565b60008060006040848603121561327857600080fd5b833561328381613205565b925060208401356001600160401b0381111561329e57600080fd5b8401601f810186136132af57600080fd5b80356001600160401b038111156132c557600080fd5b8660208284010111156132d757600080fd5b939660209190910195509293505050565b6000806000606084860312156132fd57600080fd5b833561330881613205565b9250602084013561331881613205565b929592945050506040919091013590565b60008083601f84011261333b57600080fd5b5081356001600160401b0381111561335257600080fd5b6020830191508360208260051b850101111561336d57600080fd5b9250929050565b6000806020838503121561338757600080fd5b82356001600160401b0381111561339d57600080fd5b6133a985828601613329565b90969095509350505050565b600080600080604085870312156133cb57600080fd5b84356001600160401b038111156133e157600080fd5b6133ed87828801613329565b90955093505060208501356001600160401b0381111561340c57600080fd5b61341887828801613329565b95989497509550505050565b6000602082016020835280845180835260408501915060408160051b86010192506020860160005b8281101561347d57603f198786030184526134688583516131ad565b9450602093840193919091019060010161344c565b50929695505050505050565b634e487b7160e01b600052604160045260246000fd5b600082601f8301126134b057600080fd5b81356001600160401b038111156134c9576134c9613489565b604051601f8201601f19908116603f011681016001600160401b03811182821017156134f7576134f7613489565b60405281815283820160200185101561350f57600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600080600080610100898b03121561354957600080fd5b883561355481613205565b975060208901356001600160401b0381111561356f57600080fd5b61357b8b828c0161349f565b97505060408901356001600160401b0381111561359757600080fd5b6135a38b828c0161349f565b96505060608901356135b481613205565b945060808901356135c481613205565b935060a08901356135d481613205565b979a969950949793969295929450505060c08201359160e0013590565b6000806040838503121561360457600080fd5b82359150602083013561361681613205565b809150509250929050565b60008060006060848603121561363657600080fd5b83359250602084013561364881613205565b9150604084013561365881613205565b809150509250925092565b6000806040838503121561367657600080fd5b823561368181613205565b9150602083013561361681613205565b8015158114611ae857600080fd5b6000602082840312156136b157600080fd5b8135610bf781613691565b600080604083850312156136cf57600080fd5b50508035926020909101359150565b600181811c908216806136f257607f821691505b60208210810361371257634e487b7160e01b600052602260045260246000fd5b50919050565b60006020828403121561372a57600080fd5b8151610bf781613691565b634e487b7160e01b600052603260045260246000fd5b81835260208301925060008160005b8481101561378b57813561376d81613205565b6001600160a01b03168652602095860195919091019060010161375a565b5093949350505050565b6020815260006110ff60208301848661374b565b634e487b7160e01b600052601160045260246000fd5b60ff8181168382160190811115610add57610add6137a9565b6040815260006137ec60408301868861374b565b82810360208085019190915284825285910160005b8581101561382a57823561381481613691565b1515825260209283019290910190600101613801565b50979650505050505050565b80820180821115610add57610add6137a9565b6000808335601e1984360301811261386057600080fd5b8301803591506001600160401b0382111561387a57600080fd5b60200191503681900382131561336d57600080fd5b6001600160a01b03831681526040602082018190526000906110ff908301846131ad565b81810381811115610add57610add6137a9565b6000602082840312156138d857600080fd5b5051919050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6001815b600184111561396557808504811115613949576139496137a9565b600184161561395757908102905b60019390931c92800261392e565b935093915050565b60008261397c57506001610add565b8161398957506000610add565b816001811461399f57600281146139a9576139c5565b6001915050610add565b60ff8411156139ba576139ba6137a9565b50506001821b610add565b5060208310610133831016604e8410600b84101617156139e8575081810a610add565b6139f5600019848461392a565b8060001904821115613a0957613a096137a9565b029392505050565b6000610bf760ff84168361396d565b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052601260045260246000fd5b60008251613a5e818460208701613189565b9190910192915050565b8082028115828204841417610add57610add6137a9565b600082613a9c57634e487b7160e01b600052601260045260246000fd5b500490565b634e487b7160e01b600052603160045260246000fd5b601f821115611fdc57806000526020600020601f840160051c81016020851015613ade5750805b601f840160051c820191505b818110156129f95760008155600101613aea565b81516001600160401b03811115613b1757613b17613489565b613b2b81613b2584546136de565b84613ab7565b6020601f821160018114613b5f5760008315613b475750848201515b600019600385901b1c1916600184901b1784556129f9565b600084815260208120601f198516915b82811015613b8f5787850151825560209485019460019092019101613b6f565b5084821015613bad5786840151600019600387901b60f8161c191681555b50505050600190811b0190555056fe60806040526040516106d23803806106d283398101604081905261002291610420565b61002e82826000610035565b5050610550565b61003e836100f6565b6040516001600160a01b038416907f1cf3b03a6cf19fa2baba4df148e9dcabedea7f8a5c07840e207e5c089be95d3e90600090a260008251118061007f5750805b156100f1576100ef836001600160a01b0316635c60da1b6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156100c5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906100e991906104e6565b8361027a565b505b505050565b6001600160a01b0381163b6101605760405162461bcd60e51b815260206004820152602560248201527f455243313936373a206e657720626561636f6e206973206e6f74206120636f6e6044820152641d1c9858dd60da1b60648201526084015b60405180910390fd5b6101d4816001600160a01b0316635c60da1b6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156101a1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101c591906104e6565b6001600160a01b03163b151590565b6102395760405162461bcd60e51b815260206004820152603060248201527f455243313936373a20626561636f6e20696d706c656d656e746174696f6e206960448201526f1cc81b9bdd08184818dbdb9d1c9858dd60821b6064820152608401610157565b7fa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d5080546001600160a01b0319166001600160a01b0392909216919091179055565b606061029f83836040518060600160405280602781526020016106ab602791396102a6565b9392505050565b6060600080856001600160a01b0316856040516102c39190610501565b600060405180830381855af49150503d80600081146102fe576040519150601f19603f3d011682016040523d82523d6000602084013e610303565b606091505b5090925090506103158683838761031f565b9695505050505050565b6060831561038e578251600003610387576001600160a01b0385163b6103875760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610157565b5081610398565b61039883836103a0565b949350505050565b8151156103b05781518083602001fd5b8060405162461bcd60e51b8152600401610157919061051d565b80516001600160a01b03811681146103e157600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b60005b838110156104175781810151838201526020016103ff565b50506000910152565b6000806040838503121561043357600080fd5b61043c836103ca565b60208401519092506001600160401b0381111561045857600080fd5b8301601f8101851361046957600080fd5b80516001600160401b03811115610482576104826103e6565b604051601f8201601f19908116603f011681016001600160401b03811182821017156104b0576104b06103e6565b6040528181528282016020018710156104c857600080fd5b6104d98260208301602086016103fc565b8093505050509250929050565b6000602082840312156104f857600080fd5b61029f826103ca565b600082516105138184602087016103fc565b9190910192915050565b602081526000825180602084015261053c8160408501602087016103fc565b601f01601f19169190910160400192915050565b61014c8061055f6000396000f3fe60806040523661001357610011610017565b005b6100115b610027610022610029565b6100c2565b565b600061005c7fa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50546001600160a01b031690565b6001600160a01b0316635c60da1b6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610099573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906100bd91906100e6565b905090565b3660008037600080366000845af43d6000803e8080156100e1573d6000f35b3d6000fd5b6000602082840312156100f857600080fd5b81516001600160a01b038116811461010f57600080fd5b939250505056fea2646970667358221220a7298eafd4a420fcef5cf3ba95e306b035678298d6386d26ef739ff71d7fe83a64736f6c634300081b0033416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220d912219f5801aa7cf89dc4683031a7dd2ae39316ed6a601504e93b1b9f3514d564736f6c634300081b0033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
00000000000000000000000078629734f984f835c3d28d5d98078a9213a5b4a3
-----Decoded View---------------
Arg [0] : _withdrawQueueBeacon (address): 0x78629734f984F835c3d28d5d98078a9213a5b4A3
-----Encoded View---------------
1 Constructor Arguments found :
Arg [0] : 00000000000000000000000078629734f984f835c3d28d5d98078a9213a5b4a3
Loading...
Loading
Loading...
Loading
Net Worth in USD
$0.00
Net Worth in ETH
0
Multichain Portfolio | 35 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
Loading...
Loading
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.