Overview
S Balance
S Value
$0.00More Info
Private Name Tags
ContractCreator
Latest 6 from a total of 6 transactions
Latest 6 internal transactions
Parent Transaction Hash | Block | From | To | |||
---|---|---|---|---|---|---|
15732013 | 27 days ago | Contract Creation | 0 S | |||
15731772 | 27 days ago | Contract Creation | 0 S | |||
15731509 | 27 days ago | Contract Creation | 0 S | |||
15730966 | 27 days ago | Contract Creation | 0 S | |||
15725664 | 27 days ago | Contract Creation | 0 S | |||
15725342 | 27 days ago | Contract Creation | 0 S |
Loading...
Loading
Contract Source Code Verified (Exact Match)
Contract Name:
VicunaAaveDeployer
Compiler Version
v0.8.23+commit.f704f362
Optimization Enabled:
Yes with 200 runs
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT pragma solidity ^0.8.23; import { StrategyFactory } from "./infra/StrategyFactory.sol"; import "./interfaces/beefy/IStrategyV7.sol"; import "./strategies/Aave/StrategyAaveSupplyOnly.sol"; import "./vaults/BeefyVaultV7Factory.sol"; import "./vaults/BeefyWrapper.sol"; import "./vaults/BeefyWrapperFactory.sol"; contract VicunaAaveDeployer { string public constant STRATEGY_NAME = "vifi-aave-supply-2"; address public constant NATIVE = address(0x039e2fB66102314Ce7b64Ce5Ce3E5183bc94aD38); address public constant REWARD = NATIVE; address public constant STRATEGIST = address(0xad1bB693975C16eC2cEEF65edD540BC735F8608B); address public constant SWAPPER = address(0x46112C2618B57a4e03492E727957123E5097dF25); address public constant KEEPER = address(0x2A86Ebd12573f4633453899156DA81345AC1d57D); address public constant FEE_RECIPIENT = STRATEGIST; address public constant FEE_CONFIGURATOR = address(0xB2983BC2FCBC44cC2dE16e7fE9b6c4242a820A82); address public constant OWNER = address(0xc4049acca995A4Ae3b7775dd46547494a96a1F53); BeefyVaultV7Factory public vaultFactory = BeefyVaultV7Factory(address(0x5d35CEE99eEF91f6F60cE8A0Fe4A746dFD6A5F06)); StrategyFactory public strategyFactory = StrategyFactory(address(0x9Df377a9c4FadFb1f7Bde79B92E31033D06a05A4)); event Deployed(string name, string symbol, address vault, address strategy, address wrapped); function deploy( string calldata name, string calldata wrapped_name, string calldata symbol, string calldata wrapped_symbol, address want, address aToken, address lendingPool, address incentiveController, uint256 amount ) public { BeefyVaultV7 vault = vaultFactory.cloneVault(); StrategyAaveSupplyOnly strategy = StrategyAaveSupplyOnly(payable(strategyFactory.createStrategy(STRATEGY_NAME))); StratFeeManagerInitializable.CommonAddresses memory addresses = StratFeeManagerInitializable.CommonAddresses({ strategist: STRATEGIST, unirouter: SWAPPER, vault: address(vault), keeper: KEEPER, beefyFeeRecipient: FEE_RECIPIENT, beefyFeeConfig: FEE_CONFIGURATOR }); vault.initialize(IStrategyV7(address(strategy)), name, symbol, 0); strategy.initialize(want, REWARD, NATIVE, aToken, lendingPool, incentiveController, addresses); strategy.setWithdrawalFee(0); _deposit(vault, want, amount); address wrapped = _wrap(wrapped_name, wrapped_symbol, vault); vault.transferOwnership(OWNER); strategy.transferOwnership(OWNER); emit Deployed(name, symbol, address(vault), address(strategy), wrapped); } function _deposit(BeefyVaultV7 vault, address want, uint256 amount) private { IERC20(want).transferFrom(msg.sender, address(this), amount); IERC20(want).approve(address(vault), amount); vault.deposit(amount); uint256 vaultTokenBalance = IERC20(address(vault)).balanceOf(address(this)); IERC20(address(vault)).transfer(msg.sender, vaultTokenBalance); } function _wrap(string calldata wrapped_name, string calldata wrapped_symbol, BeefyVaultV7 vault) private returns (address) { BeefyWrapper wrapper = new BeefyWrapper(); wrapper.initialize(address(vault), wrapped_name, wrapped_symbol); return address(wrapper); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC20/ERC20.sol) pragma solidity ^0.8.0; import "./IERC20.sol"; import "./extensions/IERC20Metadata.sol"; import "../../utils/Context.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.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How * to implement supply mechanisms]. * * 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 ERC20 is Context, IERC20, IERC20Metadata { 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}. * * The default value of {decimals} is 18. To select a different value for * {decimals} you should overload it. * * All two of these values are immutable: they can only be set once during * construction. */ constructor(string memory name_, string memory symbol_) { _name = name_; _symbol = symbol_; } /** * @dev Returns the name of the token. */ function name() public view virtual 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 value {ERC20} uses, unless this function is * 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; } _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; _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; } _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 {} }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-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. */ interface IERC20Permit { /** * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens, * given ``owner``'s signed approval. * * IMPORTANT: The same issues {IERC20-approve} has related to transaction * ordering also apply here. * * Emits an {Approval} event. * * Requirements: * * - `spender` cannot be the zero address. * - `deadline` must be a timestamp in the future. * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner` * over the EIP712-formatted function arguments. * - the signature must use ``owner``'s current nonce (see {nonces}). * * For more information on the signature format, see the * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP * section]. */ 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 v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol) pragma solidity ^0.8.0; import "../IERC20.sol"; /** * @dev Interface for the optional metadata functions from the ERC20 standard. * * _Available since v4.1._ */ interface IERC20Metadata is IERC20 { /** * @dev Returns the name of the token. */ function name() external view returns (string memory); /** * @dev Returns the symbol of the token. */ function symbol() external view returns (string memory); /** * @dev Returns the decimals places of the token. */ function decimals() external view returns (uint8); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @dev Emitted when `value` tokens are moved from one account (`from`) to * another (`to`). * * Note that `value` may be zero. */ event Transfer(address indexed from, address indexed to, uint256 value); /** * @dev Emitted when the allowance of a `spender` for an `owner` is set by * a call to {approve}. `value` is the new allowance. */ event Approval(address indexed owner, address indexed spender, uint256 value); /** * @dev Returns the 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.7.0) (token/ERC20/utils/SafeERC20.sol) pragma solidity ^0.8.0; import "../IERC20.sol"; import "../extensions/draft-IERC20Permit.sol"; import "../../../utils/Address.sol"; /** * @title SafeERC20 * @dev Wrappers around ERC20 operations that throw on failure (when the token * contract returns false). Tokens that return no value (and instead revert or * throw on failure) are also supported, non-reverting calls are assumed to be * successful. * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract, * which allows you to call the safe operations as `token.safeTransfer(...)`, etc. */ library SafeERC20 { using Address for address; function safeTransfer( IERC20 token, address to, uint256 value ) internal { _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value)); } function safeTransferFrom( IERC20 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( IERC20 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)); } function safeIncreaseAllowance( IERC20 token, address spender, uint256 value ) internal { uint256 newAllowance = token.allowance(address(this), spender) + value; _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance)); } function safeDecreaseAllowance( IERC20 token, address spender, uint256 value ) internal { unchecked { uint256 oldAllowance = token.allowance(address(this), spender); require(oldAllowance >= value, "SafeERC20: decreased allowance below zero"); uint256 newAllowance = oldAllowance - value; _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance)); } } function safePermit( IERC20Permit 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(IERC20 token, bytes memory data) private { // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that // the target address contains contract code and also asserts for success in the low-level call. bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed"); if (returndata.length > 0) { // Return data is optional require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed"); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.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 * ==== * * [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://diligence.consensys.net/posts/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.5.11/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 functionCall(target, data, "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"); require(isContract(target), "Address: call to non-contract"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResult(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) { require(isContract(target), "Address: static call to non-contract"); (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResult(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) { require(isContract(target), "Address: delegate call to non-contract"); (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason 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 { // 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 v4.4.1 (utils/Context.sol) pragma solidity ^0.8.0; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol) pragma solidity ^0.8.20; import {Context} from "../utils/Context.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * The initial owner is set to the address provided by the deployer. This can * later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract Ownable is Context { address private _owner; /** * @dev The caller account is not authorized to perform an operation. */ error OwnableUnauthorizedAccount(address account); /** * @dev The owner is not a valid owner account. (eg. `address(0)`) */ error OwnableInvalidOwner(address owner); event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the address provided by the deployer as the initial owner. */ constructor(address initialOwner) { if (initialOwner == address(0)) { revert OwnableInvalidOwner(address(0)); } _transferOwnership(initialOwner); } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _checkOwner(); _; } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if the sender is not the owner. */ function _checkOwner() internal view virtual { if (owner() != _msgSender()) { revert OwnableUnauthorizedAccount(_msgSender()); } } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby disabling any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { if (newOwner == address(0)) { revert OwnableInvalidOwner(address(0)); } _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/BeaconProxy.sol) pragma solidity ^0.8.20; import {IBeacon} from "./IBeacon.sol"; import {Proxy} from "../Proxy.sol"; import {ERC1967Utils} from "../ERC1967/ERC1967Utils.sol"; /** * @dev This contract implements a proxy that gets the implementation address for each call from an {UpgradeableBeacon}. * * The beacon address can only be set once during construction, and cannot be changed afterwards. It is stored in an * immutable variable to avoid unnecessary storage reads, and also in the beacon storage slot specified by * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] so that it can be accessed externally. * * CAUTION: Since the beacon address can never be changed, you must ensure that you either control the beacon, or trust * the beacon to not upgrade the implementation maliciously. * * IMPORTANT: Do not use the implementation logic to modify the beacon storage slot. Doing so would leave the proxy in * an inconsistent state where the beacon storage slot does not match the beacon address. */ contract BeaconProxy is Proxy { // An immutable address for the beacon to avoid unnecessary SLOADs before each delegate call. address private immutable _beacon; /** * @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}. * - If `data` is empty, `msg.value` must be zero. */ constructor(address beacon, bytes memory data) payable { ERC1967Utils.upgradeBeaconToAndCall(beacon, data); _beacon = beacon; } /** * @dev Returns the current implementation address of the associated beacon. */ function _implementation() internal view virtual override returns (address) { return IBeacon(_getBeacon()).implementation(); } /** * @dev Returns the beacon. */ function _getBeacon() internal view virtual returns (address) { return _beacon; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/IBeacon.sol) pragma solidity ^0.8.20; /** * @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. * * {UpgradeableBeacon} will check that this address is a contract. */ function implementation() external view returns (address); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/UpgradeableBeacon.sol) pragma solidity ^0.8.20; import {IBeacon} from "./IBeacon.sol"; import {Ownable} from "../../access/Ownable.sol"; /** * @dev This contract is used in conjunction with one or more instances of {BeaconProxy} to determine their * implementation contract, which is where they will delegate all function calls. * * An owner is able to change the implementation the beacon points to, thus upgrading the proxies that use this beacon. */ contract UpgradeableBeacon is IBeacon, Ownable { address private _implementation; /** * @dev The `implementation` of the beacon is invalid. */ error BeaconInvalidImplementation(address implementation); /** * @dev Emitted when the implementation returned by the beacon is changed. */ event Upgraded(address indexed implementation); /** * @dev Sets the address of the initial implementation, and the initial owner who can upgrade the beacon. */ constructor(address implementation_, address initialOwner) Ownable(initialOwner) { _setImplementation(implementation_); } /** * @dev Returns the current implementation address. */ function implementation() public view virtual returns (address) { return _implementation; } /** * @dev Upgrades the beacon to a new implementation. * * Emits an {Upgraded} event. * * Requirements: * * - msg.sender must be the owner of the contract. * - `newImplementation` must be a contract. */ function upgradeTo(address newImplementation) public virtual onlyOwner { _setImplementation(newImplementation); } /** * @dev Sets the implementation contract address for this beacon * * Requirements: * * - `newImplementation` must be a contract. */ function _setImplementation(address newImplementation) private { if (newImplementation.code.length == 0) { revert BeaconInvalidImplementation(newImplementation); } _implementation = newImplementation; emit Upgraded(newImplementation); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Utils.sol) pragma solidity ^0.8.20; import {IBeacon} from "../beacon/IBeacon.sol"; import {Address} from "../../utils/Address.sol"; import {StorageSlot} from "../../utils/StorageSlot.sol"; /** * @dev This abstract contract provides getters and event emitting update functions for * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots. */ library ERC1967Utils { // We re-declare ERC-1967 events here because they can't be used directly from IERC1967. // This will be fixed in Solidity 0.8.21. At that point we should remove these events. /** * @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); /** * @dev Storage slot with the address of the current implementation. * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1. */ // solhint-disable-next-line private-vars-leading-underscore bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; /** * @dev The `implementation` of the proxy is invalid. */ error ERC1967InvalidImplementation(address implementation); /** * @dev The `admin` of the proxy is invalid. */ error ERC1967InvalidAdmin(address admin); /** * @dev The `beacon` of the proxy is invalid. */ error ERC1967InvalidBeacon(address beacon); /** * @dev An upgrade function sees `msg.value > 0` that may be lost. */ error ERC1967NonPayable(); /** * @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 { if (newImplementation.code.length == 0) { revert ERC1967InvalidImplementation(newImplementation); } StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value = newImplementation; } /** * @dev Performs implementation upgrade with additional setup call if data is nonempty. * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected * to avoid stuck value in the contract. * * Emits an {IERC1967-Upgraded} event. */ function upgradeToAndCall(address newImplementation, bytes memory data) internal { _setImplementation(newImplementation); emit Upgraded(newImplementation); if (data.length > 0) { Address.functionDelegateCall(newImplementation, data); } else { _checkNonPayable(); } } /** * @dev Storage slot with the admin of the contract. * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1. */ // solhint-disable-next-line private-vars-leading-underscore bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103; /** * @dev Returns the current admin. * * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using * the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103` */ 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 { if (newAdmin == address(0)) { revert ERC1967InvalidAdmin(address(0)); } StorageSlot.getAddressSlot(ADMIN_SLOT).value = newAdmin; } /** * @dev Changes the admin of the proxy. * * Emits an {IERC1967-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 the keccak-256 hash of "eip1967.proxy.beacon" subtracted by 1. */ // solhint-disable-next-line private-vars-leading-underscore 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 { if (newBeacon.code.length == 0) { revert ERC1967InvalidBeacon(newBeacon); } StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon; address beaconImplementation = IBeacon(newBeacon).implementation(); if (beaconImplementation.code.length == 0) { revert ERC1967InvalidImplementation(beaconImplementation); } } /** * @dev Change the beacon and trigger a setup call if data is nonempty. * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected * to avoid stuck value in the contract. * * Emits an {IERC1967-BeaconUpgraded} event. * * CAUTION: Invoking this function has no effect on an instance of {BeaconProxy} since v5, since * it uses an immutable beacon without looking at the value of the ERC-1967 beacon slot for * efficiency. */ function upgradeBeaconToAndCall(address newBeacon, bytes memory data) internal { _setBeacon(newBeacon); emit BeaconUpgraded(newBeacon); if (data.length > 0) { Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data); } else { _checkNonPayable(); } } /** * @dev Reverts if `msg.value` is not zero. It can be used to avoid `msg.value` stuck in the contract * if an upgrade doesn't perform an initialization call. */ function _checkNonPayable() private { if (msg.value > 0) { revert ERC1967NonPayable(); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (proxy/Proxy.sol) pragma solidity ^0.8.20; /** * @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 { _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(); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol) pragma solidity ^0.8.20; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev The ETH balance of the account is not enough to perform the operation. */ error AddressInsufficientBalance(address account); /** * @dev There's no code at `target` (it is not a contract). */ error AddressEmptyCode(address target); /** * @dev A call to an address target failed. The target may have reverted. */ error FailedInnerCall(); /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { if (address(this).balance < amount) { revert AddressInsufficientBalance(address(this)); } (bool success, ) = recipient.call{value: amount}(""); if (!success) { revert FailedInnerCall(); } } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason or custom error, it is bubbled * up by this function (like regular Solidity function calls). However, if * the call reverted with no returned reason, this function reverts with a * {FailedInnerCall} error. * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { if (address(this).balance < value) { revert AddressInsufficientBalance(address(this)); } (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an * unsuccessful call. */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata ) internal view returns (bytes memory) { if (!success) { _revert(returndata); } else { // only check if target is a contract if the call was successful and the return data is empty // otherwise we already know that it was a contract if (returndata.length == 0 && target.code.length == 0) { revert AddressEmptyCode(target); } return returndata; } } /** * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the * revert reason or with a default {FailedInnerCall} error. */ function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) { if (!success) { _revert(returndata); } else { return returndata; } } /** * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}. */ function _revert(bytes memory returndata) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert FailedInnerCall(); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol) pragma solidity ^0.8.20; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } function _contextSuffixLength() internal view virtual returns (uint256) { return 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol) // This file was procedurally generated from scripts/generate/templates/StorageSlot.js. pragma solidity ^0.8.20; /** * @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(newImplementation.code.length > 0); * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; * } * } * ``` */ 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) (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/Clones.sol) pragma solidity ^0.8.0; /** * @dev https://eips.ethereum.org/EIPS/eip-1167[EIP 1167] is a standard for * deploying minimal proxy contracts, also known as "clones". * * > To simply and cheaply clone contract functionality in an immutable way, this standard specifies * > a minimal bytecode implementation that delegates all calls to a known, fixed address. * * The library includes functions to deploy a proxy using either `create` (traditional deployment) or `create2` * (salted deterministic deployment). It also includes functions to predict the addresses of clones deployed using the * deterministic method. * * _Available since v3.4._ */ library ClonesUpgradeable { /** * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`. * * This function uses the create opcode, which should never revert. */ function clone(address implementation) internal returns (address instance) { /// @solidity memory-safe-assembly assembly { // Cleans the upper 96 bits of the `implementation` word, then packs the first 3 bytes // of the `implementation` address with the bytecode before the address. mstore(0x00, or(shr(0xe8, shl(0x60, implementation)), 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000)) // Packs the remaining 17 bytes of `implementation` with the bytecode after the address. mstore(0x20, or(shl(0x78, implementation), 0x5af43d82803e903d91602b57fd5bf3)) instance := create(0, 0x09, 0x37) } require(instance != address(0), "ERC1167: create failed"); } /** * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`. * * This function uses the create2 opcode and a `salt` to deterministically deploy * the clone. Using the same `implementation` and `salt` multiple time will revert, since * the clones cannot be deployed twice at the same address. */ function cloneDeterministic(address implementation, bytes32 salt) internal returns (address instance) { /// @solidity memory-safe-assembly assembly { // Cleans the upper 96 bits of the `implementation` word, then packs the first 3 bytes // of the `implementation` address with the bytecode before the address. mstore(0x00, or(shr(0xe8, shl(0x60, implementation)), 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000)) // Packs the remaining 17 bytes of `implementation` with the bytecode after the address. mstore(0x20, or(shl(0x78, implementation), 0x5af43d82803e903d91602b57fd5bf3)) instance := create2(0, 0x09, 0x37, salt) } require(instance != address(0), "ERC1167: create2 failed"); } /** * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}. */ function predictDeterministicAddress( address implementation, bytes32 salt, address deployer ) internal pure returns (address predicted) { /// @solidity memory-safe-assembly assembly { let ptr := mload(0x40) mstore(add(ptr, 0x38), deployer) mstore(add(ptr, 0x24), 0x5af43d82803e903d91602b57fd5bf3ff) mstore(add(ptr, 0x14), implementation) mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73) mstore(add(ptr, 0x58), salt) mstore(add(ptr, 0x78), keccak256(add(ptr, 0x0c), 0x37)) predicted := keccak256(add(ptr, 0x43), 0x55) } } /** * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}. */ function predictDeterministicAddress( address implementation, bytes32 salt ) internal view returns (address predicted) { return predictDeterministicAddress(implementation, salt, address(this)); } }
// 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) (security/ReentrancyGuard.sol) pragma solidity ^0.8.0; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Contract module that helps prevent reentrant calls to a function. * * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier * available, which can be applied to functions to make sure there are no nested * (reentrant) calls to them. * * Note that because there is a single `nonReentrant` guard, functions marked as * `nonReentrant` may not call one another. This can be worked around by making * those functions `private`, and then adding `external` `nonReentrant` entry * points to them. * * TIP: If you would like to learn more about reentrancy and alternative ways * to protect against it, check out our blog post * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul]. */ abstract contract ReentrancyGuardUpgradeable is Initializable { // Booleans are more expensive than uint256 or any type that takes up a full // word because each write operation emits an extra SLOAD to first read the // slot's contents, replace the bits taken up by the boolean, and then write // back. This is the compiler's defense against contract upgrades and // pointer aliasing, and it cannot be disabled. // The values being non-zero value makes deployment a bit more expensive, // but in exchange the refund on every call to nonReentrant will be lower in // amount. Since refunds are capped to a percentage of the total // transaction's gas, it is best to keep them low in cases like this one, to // increase the likelihood of the full refund coming into effect. uint256 private constant _NOT_ENTERED = 1; uint256 private constant _ENTERED = 2; uint256 private _status; function __ReentrancyGuard_init() internal onlyInitializing { __ReentrancyGuard_init_unchained(); } function __ReentrancyGuard_init_unchained() internal onlyInitializing { _status = _NOT_ENTERED; } /** * @dev Prevents a contract from calling itself, directly or indirectly. * Calling a `nonReentrant` function from another `nonReentrant` * function is not supported. It is possible to prevent this from happening * by making the `nonReentrant` function external, and making it call a * `private` function that does the actual work. */ modifier nonReentrant() { _nonReentrantBefore(); _; _nonReentrantAfter(); } function _nonReentrantBefore() private { // On the first call to nonReentrant, _status will be _NOT_ENTERED require(_status != _ENTERED, "ReentrancyGuard: reentrant call"); // Any calls to nonReentrant after this point will fail _status = _ENTERED; } function _nonReentrantAfter() private { // By storing the original value once again, a refund is triggered (see // https://eips.ethereum.org/EIPS/eip-2200) _status = _NOT_ENTERED; } /** * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a * `nonReentrant` function in the call stack. */ function _reentrancyGuardEntered() internal view returns (bool) { return _status == _ENTERED; } /** * @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); } function _convertToAssets(uint256 shares, MathUpgradeable.Rounding rounding) internal view virtual returns (uint256) { return shares.mulDiv(totalAssets() + 1, totalSupply() + 1, 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 pragma solidity ^0.8.20; import "@openzeppelin-5/contracts/proxy/beacon/BeaconProxy.sol"; import "@openzeppelin-5/contracts/proxy/beacon/UpgradeableBeacon.sol"; import "@openzeppelin-5/contracts/access/Ownable.sol"; // Minimal proxy pattern for creating new Beefy strategies contract StrategyFactory is Ownable { /// @notice instance mapping to strategy name with version. mapping (string => UpgradeableBeacon) public instances; /// @notice approved rebalancer mapping mapping (address => bool) public rebalancers; /// @notice Pause state by strategyName mapping (string => bool) public strategyPause; /// @notice deployed strategy types string[] public strategyTypes; /// @notice The address of the native token address public native; /// @notice The address of the keeper address public keeper; /// @notice The beefy fee recipient address public beefyFeeRecipient; /// @notice The beefy fee config address public beefyFeeConfig; /// @notice Global pause state for all strategies that use this bool public globalPause; // Events event ProxyCreated(string strategyName, address proxy); event InstanceUpgraded(string strategyName, address newImplementation); event NewStrategyAdded(string strategyName, address implementation); event SetBeefyFeeRecipient(address beefyFeeRecipient); event SetBeefyFeeConfig(address beefyFeeConfig); event SetKeeper(address keeper); event GlobalPause(bool paused); event StratPause(string strategyName, bool paused); event RebalancerChanged(address rebalancer, bool isRebalancer); // Errors error NotManager(); error StratVersionExists(); /// @notice Throws if called by any account other than the owner or the keeper/ modifier onlyManager() { if (msg.sender != owner() && msg.sender != address(keeper)) revert NotManager(); _; } /// @notice Constructor initializes the keeper address constructor( address _native, address _keeper, address _beefyFeeRecipient, address _beefyFeeConfig ) Ownable(msg.sender) { native = _native; keeper = _keeper; beefyFeeRecipient = _beefyFeeRecipient; beefyFeeConfig = _beefyFeeConfig; } /** @notice Creates a new Beefy Strategy as a proxy of the template instance * @param _strategyName The name of the strategy * @return A reference to the new proxied Beefy Strategy */ function createStrategy(string calldata _strategyName) external returns (address) { // Create a new Beefy Strategy as a proxy of the template instance UpgradeableBeacon instance = instances[_strategyName]; BeaconProxy proxy = new BeaconProxy(address(instance), ""); emit ProxyCreated(_strategyName, address(proxy)); return address(proxy); } /** * @notice Upgrades the implementation of a strategy * @param _strategyName The name of the strategy * @param _newImplementation The new implementation address */ function upgradeTo(string calldata _strategyName, address _newImplementation) external onlyOwner { UpgradeableBeacon instance = instances[_strategyName]; instance.upgradeTo(_newImplementation); emit InstanceUpgraded(_strategyName, _newImplementation); } /** * @notice Adds a new strategy to the factory * @param _strategyName The name of the strategy * @param _implementation The implementation address */ function addStrategy(string calldata _strategyName, address _implementation) external onlyManager { if (address(instances[_strategyName]) != address(0)) revert StratVersionExists(); instances[_strategyName] = new UpgradeableBeacon(_implementation, address(this)); // Store in our deployed strategy type array strategyTypes.push(_strategyName); emit NewStrategyAdded(_strategyName, _implementation); } /** * @notice Pauses all strategies */ function pauseAllStrats() external onlyManager { globalPause = true; emit GlobalPause(true); } /** * @notice Unpauses all strategies */ function unpauseAllStrats() external onlyOwner { globalPause = false; emit GlobalPause(false); } function pauseStrategy(string calldata _strategyName) external onlyManager { strategyPause[_strategyName] = true; emit StratPause(_strategyName, true); } function unpauseStrategy(string calldata _strategyName) external onlyOwner { strategyPause[_strategyName] = false; emit StratPause(_strategyName, false); } /** * @notice Adds a rebalancer callable by the owner * @param _rebalancer The rebalancer address */ function addRebalancer(address _rebalancer) external onlyOwner { rebalancers[_rebalancer] = true; emit RebalancerChanged(_rebalancer, true); } /** * @notice Removes a rebalancer callable by a manager * @param _rebalancer The rebalancer address */ function removeRebalancer(address _rebalancer) external onlyManager { rebalancers[_rebalancer] = false; emit RebalancerChanged(_rebalancer, false); } /** * @notice set the beefy fee recipient address * @param _beefyFeeRecipient The new beefy fee recipient address */ function setBeefyFeeRecipient(address _beefyFeeRecipient) external onlyOwner { beefyFeeRecipient = _beefyFeeRecipient; emit SetBeefyFeeRecipient(_beefyFeeRecipient); } /** * @notice set the beefy fee config address * @param _beefyFeeConfig The new beefy fee config address */ function setBeefyFeeConfig(address _beefyFeeConfig) external onlyOwner { beefyFeeConfig = _beefyFeeConfig; emit SetBeefyFeeConfig(_beefyFeeConfig); } /** * @notice set the keeper address * @param _keeper The new keeper address */ function setKeeper(address _keeper) external onlyOwner { keeper = _keeper; emit SetKeeper(_keeper); } /** * @notice Gets the implementation of a strategy * @param _strategyName The name of the strategy * @return The implementation address */ function getImplementation(string calldata _strategyName) external view returns (address) { return instances[_strategyName].implementation(); } /** * @notice Gets the array of deployed strategies * @return The array of deployed strategies */ function getStrategyTypes() external view returns (string[] memory) { return strategyTypes; } }
// SPDX-License-Identifier: MIT pragma solidity >=0.6.0 <0.9.0; interface IAaveV3Incentives { function claimRewards(address[] calldata assets, uint256 amount, address to, address reward) external returns (uint256); function claimAllRewards(address[] calldata assets, address to) external returns (uint256); function getUserRewards(address[] calldata assets, address user, address reward) external view returns (uint256); }
// SPDX-License-Identifier: MIT pragma solidity >=0.6.0 <0.9.0; interface ILendingPool { function deposit(address asset, uint256 amount, address onBehalfOf, uint16 referralCode) external; function borrow(address asset, uint256 amount, uint256 interestRateMode, uint16 referralCode, address onBehalfOf) external; function repay(address asset, uint256 amount, uint256 rateMode, address onBehalfOf) external returns (uint256); function withdraw(address asset, uint256 amount, address to) external returns (uint256); function getUserAccountData(address user) external view returns ( uint256 totalCollateralETH, uint256 totalDebtETH, uint256 availableBorrowsETH, uint256 currentLiquidationThreshold, uint256 ltv, uint256 healthFactor ); function setUserEMode(uint8 categoryId) external; function getUserEMode(address user) external view returns (uint256); function getEModeCategoryData(uint8 categoryId) external view returns ( uint16 ltv, uint16 liquidationThreshold, uint16 liquidationBonus, address priceSource, string memory label ); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; interface IBeefySwapper { function swap( address fromToken, address toToken, uint256 amountIn ) external returns (uint256 amountOut); function swap( address fromToken, address toToken, uint256 amountIn, uint256 minAmountOut ) external returns (uint256 amountOut); function getAmountOut( address _fromToken, address _toToken, uint256 _amountIn ) external view returns (uint256 amountOut); function swapInfo( address _fromToken, address _toToken ) external view returns ( address router, bytes calldata data, uint256 amountIndex, uint256 minIndex, int8 minAmountSign ); struct SwapInfo { address router; bytes data; uint256 amountIndex; uint256 minIndex; int8 minAmountSign; } } interface ISimplifiedSwapInfo { function swapInfo(address _fromToken, address _toToken) external view returns (address router, bytes calldata data); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol"; interface IStrategyV7 { function vault() external view returns (address); function want() external view returns (IERC20Upgradeable); function beforeDeposit() external; function deposit() external; function withdraw(uint256) external; function balanceOf() external view returns (uint256); function balanceOfWant() external view returns (uint256); function balanceOfPool() external view returns (uint256); function harvest() external; function retireStrat() external; function panic() external; function pause() external; function unpause() external; function paused() external view returns (bool); function unirouter() external view returns (address); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; interface IFeeConfig { struct FeeCategory { uint256 total; uint256 beefy; uint256 call; uint256 strategist; string label; bool active; } struct AllFees { FeeCategory performance; uint256 deposit; uint256 withdraw; } function getFees(address strategy) external view returns (FeeCategory memory); function stratFeeId(address strategy) external view returns (uint256); function setStratFeeId(uint256 feeId) external; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "@openzeppelin-4/contracts/token/ERC20/ERC20.sol"; import "@openzeppelin-4/contracts/token/ERC20/utils/SafeERC20.sol"; import "../../interfaces/aave/IAaveV3Incentives.sol"; import "../../interfaces/aave/ILendingPool.sol"; import "../../interfaces/beefy/IBeefySwapper.sol"; import "../Common/StratFeeManagerInitializable.sol"; contract StrategyAaveSupplyOnly is StratFeeManagerInitializable { using SafeERC20 for IERC20; // Tokens used address public native; address public want; address public aToken; address[] public rewards; // Third party contracts address public lendingPool; address public incentivesController; bool public harvestOnDeposit; uint256 public lastHarvest; event StratHarvest(address indexed harvester, uint256 wantHarvested, uint256 tvl); event Deposit(uint256 tvl); event Withdraw(uint256 tvl); event ChargedFees(uint256 callFees, uint256 beefyFees, uint256 strategistFees); event SetReward(address reward); function initialize( address _want, address _reward, address _native, address _aToken, address _lendingPool, address _incentivesController, CommonAddresses calldata _commonAddresses ) external initializer { __StratFeeManager_init(_commonAddresses); want = _want; rewards.push(_reward); native = _native; lendingPool = _lendingPool; incentivesController = _incentivesController; aToken = _aToken; _giveAllowances(); } // puts the funds to work function deposit() public whenNotPaused { uint256 wantBal = balanceOfWant(); if (wantBal > 0) { ILendingPool(lendingPool).deposit(want, wantBal, address(this), 0); emit Deposit(balanceOf()); } } function withdraw(uint256 _amount) external { require(msg.sender == vault, "!vault"); uint256 wantBal = balanceOfWant(); if (wantBal < _amount) { ILendingPool(lendingPool).withdraw(want, _amount - wantBal, address(this)); wantBal = balanceOfWant(); } if (wantBal > _amount) { wantBal = _amount; } if (tx.origin != owner() && !paused()) { uint256 withdrawalFeeAmount = wantBal * withdrawalFee / WITHDRAWAL_MAX; wantBal = wantBal - withdrawalFeeAmount; } IERC20(want).safeTransfer(vault, wantBal); emit Withdraw(balanceOf()); } function beforeDeposit() external override { if (harvestOnDeposit) { require(msg.sender == vault, "!vault"); _harvest(tx.origin); } } function harvest() external virtual { _harvest(tx.origin); } function harvest(address callFeeRecipient) external virtual { _harvest(callFeeRecipient); } function managerHarvest() external onlyManager { _harvest(tx.origin); } // compounds earnings and charges performance fee function _harvest(address callFeeRecipient) internal whenNotPaused { address[] memory assets = new address[](1); assets[0] = aToken; IAaveV3Incentives(incentivesController).claimAllRewards(assets, address(this)); _swapRewards(); uint256 nativeBal = IERC20(native).balanceOf(address(this)); if (nativeBal > 0) { chargeFees(callFeeRecipient); _swapToWant(); uint256 wantHarvested = balanceOfWant(); deposit(); lastHarvest = block.timestamp; emit StratHarvest(msg.sender, wantHarvested, balanceOf()); } } // performance fees function chargeFees(address callFeeRecipient) internal { IFeeConfig.FeeCategory memory fees = getFees(); uint256 stratFees = IERC20(native).balanceOf(address(this)) * fees.total / DIVISOR; uint256 callFeeAmount = stratFees * fees.call / DIVISOR; IERC20(native).safeTransfer(callFeeRecipient, callFeeAmount); uint256 beefyFeeAmount = stratFees * fees.beefy / DIVISOR; IERC20(native).safeTransfer(beefyFeeRecipient, beefyFeeAmount); uint256 strategistFeeAmount = stratFees * fees.strategist / DIVISOR; IERC20(native).safeTransfer(strategist, strategistFeeAmount); emit ChargedFees(callFeeAmount, beefyFeeAmount, strategistFeeAmount); } // swap rewards to native function _swapRewards() internal { for (uint i; i < rewards.length; ++i) { address reward = rewards[i]; if (reward != native) { uint256 rewardBal = IERC20(reward).balanceOf(address(this)); if (rewardBal > 0) { IBeefySwapper(unirouter).swap(reward, native, rewardBal); } } } } // swap native to {want} function _swapToWant() internal { if (native != want) { uint256 nativeBal = IERC20(native).balanceOf(address(this)); IBeefySwapper(unirouter).swap(native, want, nativeBal); } } // calculate the total underlaying 'want' held by the strat. function balanceOf() public view returns (uint256) { return balanceOfWant() + balanceOfPool(); } // it calculates how much 'want' this contract holds. function balanceOfWant() public view returns (uint256) { return IERC20(want).balanceOf(address(this)); } // it calculates how much 'want' the strategy has working in the farm. function balanceOfPool() public view returns (uint256) { return IERC20(aToken).balanceOf(address(this)); } // returns rewards unharvested function rewardsAvailable() public pure returns (uint256) { return 0; } // native reward amount for calling harvest function callReward() public pure returns (uint256) { return 0; } function setHarvestOnDeposit(bool _harvestOnDeposit) external onlyManager { harvestOnDeposit = _harvestOnDeposit; if (harvestOnDeposit) { setWithdrawalFee(0); } else { setWithdrawalFee(10); } } function setReward(address _reward) external onlyManager { require(_reward != want, "reward != want"); require(_reward != aToken, "reward != aToken"); rewards.push(_reward); IERC20(_reward).safeApprove(unirouter, type(uint256).max); } function resetReward() external onlyManager { for (uint i; i < rewards.length; ++i) { IERC20(rewards[i]).safeApprove(unirouter, 0); } delete rewards; } // called as part of strat migration. Sends all the available funds back to the vault. function retireStrat() external { require(msg.sender == vault, "!vault"); ILendingPool(lendingPool).withdraw(want, type(uint).max, address(this)); uint256 wantBal = balanceOfWant(); IERC20(want).transfer(vault, wantBal); } // pauses deposits and withdraws all funds from third party systems. function panic() public onlyManager { ILendingPool(lendingPool).withdraw(want, type(uint).max, address(this)); pause(); } function pause() public onlyManager { _pause(); _removeAllowances(); } function unpause() external onlyManager { _unpause(); _giveAllowances(); deposit(); } function _giveAllowances() internal { IERC20(want).safeApprove(lendingPool, type(uint).max); IERC20(native).safeApprove(unirouter, type(uint).max); for (uint i; i < rewards.length; ++i) { IERC20(rewards[i]).safeApprove(unirouter, 0); IERC20(rewards[i]).safeApprove(unirouter, type(uint).max); } } function _removeAllowances() internal { IERC20(want).safeApprove(lendingPool, 0); IERC20(native).safeApprove(unirouter, 0); for (uint i; i < rewards.length; ++i) { IERC20(rewards[i]).safeApprove(unirouter, 0); } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol"; import "@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol"; import "../../interfaces/common/IFeeConfig.sol"; contract StratFeeManagerInitializable is OwnableUpgradeable, PausableUpgradeable { struct CommonAddresses { address vault; address unirouter; address keeper; address strategist; address beefyFeeRecipient; address beefyFeeConfig; } // common addresses for the strategy address public vault; address public unirouter; address public keeper; address public strategist; address public beefyFeeRecipient; IFeeConfig public beefyFeeConfig; uint256 constant DIVISOR = 1 ether; uint256 constant public WITHDRAWAL_FEE_CAP = 50; uint256 constant public WITHDRAWAL_MAX = 10000; uint256 internal withdrawalFee; event SetStratFeeId(uint256 feeId); event SetWithdrawalFee(uint256 withdrawalFee); event SetVault(address vault); event SetUnirouter(address unirouter); event SetKeeper(address keeper); event SetStrategist(address strategist); event SetBeefyFeeRecipient(address beefyFeeRecipient); event SetBeefyFeeConfig(address beefyFeeConfig); function __StratFeeManager_init(CommonAddresses calldata _commonAddresses) internal onlyInitializing { __Ownable_init(); __Pausable_init(); vault = _commonAddresses.vault; unirouter = _commonAddresses.unirouter; keeper = _commonAddresses.keeper; strategist = _commonAddresses.strategist; beefyFeeRecipient = _commonAddresses.beefyFeeRecipient; beefyFeeConfig = IFeeConfig(_commonAddresses.beefyFeeConfig); withdrawalFee = 10; } // checks that caller is either owner or keeper. modifier onlyManager() { _checkManager(); _; } function _checkManager() internal view { require(msg.sender == owner() || msg.sender == keeper, "!manager"); } // fetch fees from config contract function getFees() internal view returns (IFeeConfig.FeeCategory memory) { return beefyFeeConfig.getFees(address(this)); } // fetch fees from config contract and dynamic deposit/withdraw fees function getAllFees() external view returns (IFeeConfig.AllFees memory) { return IFeeConfig.AllFees(getFees(), depositFee(), withdrawFee()); } function getStratFeeId() external view returns (uint256) { return beefyFeeConfig.stratFeeId(address(this)); } function setStratFeeId(uint256 _feeId) external onlyManager { beefyFeeConfig.setStratFeeId(_feeId); emit SetStratFeeId(_feeId); } // adjust withdrawal fee function setWithdrawalFee(uint256 _fee) public onlyManager { require(_fee <= WITHDRAWAL_FEE_CAP, "!cap"); withdrawalFee = _fee; emit SetWithdrawalFee(_fee); } // set new vault (only for strategy upgrades) function setVault(address _vault) external onlyOwner { vault = _vault; emit SetVault(_vault); } // set new unirouter function setUnirouter(address _unirouter) external onlyOwner { unirouter = _unirouter; emit SetUnirouter(_unirouter); } // set new keeper to manage strat function setKeeper(address _keeper) external onlyManager { keeper = _keeper; emit SetKeeper(_keeper); } // set new strategist address to receive strat fees function setStrategist(address _strategist) external { require(msg.sender == strategist, "!strategist"); strategist = _strategist; emit SetStrategist(_strategist); } // set new beefy fee address to receive beefy fees function setBeefyFeeRecipient(address _beefyFeeRecipient) external onlyOwner { beefyFeeRecipient = _beefyFeeRecipient; emit SetBeefyFeeRecipient(_beefyFeeRecipient); } // set new fee config address to fetch fees function setBeefyFeeConfig(address _beefyFeeConfig) external onlyOwner { beefyFeeConfig = IFeeConfig(_beefyFeeConfig); emit SetBeefyFeeConfig(_beefyFeeConfig); } function depositFee() public virtual view returns (uint256) { return 0; } function withdrawFee() public virtual view returns (uint256) { return paused() ? 0 : withdrawalFee; } function beforeDeposit() external virtual {} }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol"; import "@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol"; import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol"; import "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol"; import "../interfaces/beefy/IStrategyV7.sol"; /** * @dev Implementation of a vault to deposit funds for yield optimizing. * This is the contract that receives funds and that users interface with. * The yield optimizing strategy itself is implemented in a separate 'Strategy.sol' contract. */ contract BeefyVaultV7 is ERC20Upgradeable, OwnableUpgradeable, ReentrancyGuardUpgradeable { using SafeERC20Upgradeable for IERC20Upgradeable; struct StratCandidate { address implementation; uint proposedTime; } // The last proposed strategy to switch to. StratCandidate public stratCandidate; // The strategy currently in use by the vault. IStrategyV7 public strategy; // The minimum time it has to pass before a strat candidate can be approved. uint256 public approvalDelay; event NewStratCandidate(address implementation); event UpgradeStrat(address implementation); /** * @dev Sets the value of {token} to the token that the vault will * hold as underlying value. It initializes the vault's own 'moo' token. * This token is minted when someone does a deposit. It is burned in order * to withdraw the corresponding portion of the underlying assets. * @param _strategy the address of the strategy. * @param _name the name of the vault token. * @param _symbol the symbol of the vault token. * @param _approvalDelay the delay before a new strat can be approved. */ function initialize( IStrategyV7 _strategy, string memory _name, string memory _symbol, uint256 _approvalDelay ) public initializer { __ERC20_init(_name, _symbol); __Ownable_init(); __ReentrancyGuard_init(); strategy = _strategy; approvalDelay = _approvalDelay; } function want() public view returns (IERC20Upgradeable) { return IERC20Upgradeable(strategy.want()); } /** * @dev It calculates the total underlying value of {token} held by the system. * It takes into account the vault contract balance, the strategy contract balance * and the balance deployed in other contracts as part of the strategy. */ function balance() public view returns (uint) { return want().balanceOf(address(this)) + IStrategyV7(strategy).balanceOf(); } /** * @dev Custom logic in here for how much the vault allows to be borrowed. * We return 100% of tokens for now. Under certain conditions we might * want to keep some of the system funds at hand in the vault, instead * of putting them to work. */ function available() public view returns (uint256) { return want().balanceOf(address(this)); } /** * @dev Function for various UIs to display the current value of one of our yield tokens. * Returns an uint256 with 18 decimals of how much underlying asset one vault share represents. */ function getPricePerFullShare() public view returns (uint256) { return totalSupply() == 0 ? 1e18 : balance() * 1e18 / totalSupply(); } /** * @dev A helper function to call deposit() with all the sender's funds. */ function depositAll() external { deposit(want().balanceOf(msg.sender)); } /** * @dev The entrypoint of funds into the system. People deposit with this function * into the vault. The vault is then in charge of sending funds into the strategy. */ function deposit(uint _amount) public nonReentrant { strategy.beforeDeposit(); uint256 _pool = balance(); want().safeTransferFrom(msg.sender, address(this), _amount); earn(); uint256 _after = balance(); _amount = _after - _pool; // Additional check for deflationary tokens uint256 shares = 0; if (totalSupply() == 0) { shares = _amount; } else { shares = (_amount * totalSupply()) / _pool; } _mint(msg.sender, shares); } /** * @dev Function to send funds into the strategy and put them to work. It's primarily called * by the vault's deposit() function. */ function earn() public { uint _bal = available(); want().safeTransfer(address(strategy), _bal); strategy.deposit(); } /** * @dev A helper function to call withdraw() with all the sender's funds. */ function withdrawAll() external { withdraw(balanceOf(msg.sender)); } /** * @dev Function to exit the system. The vault will withdraw the required tokens * from the strategy and pay up the token holder. A proportional number of IOU * tokens are burned in the process. */ function withdraw(uint256 _shares) public { uint256 r = (balance() * _shares) / totalSupply(); _burn(msg.sender, _shares); uint b = want().balanceOf(address(this)); if (b < r) { uint _withdraw = r - b; strategy.withdraw(_withdraw); uint _after = want().balanceOf(address(this)); uint _diff = _after - b; if (_diff < _withdraw) { r = b + _diff; } } want().safeTransfer(msg.sender, r); } /** * @dev Sets the candidate for the new strat to use with this vault. * @param _implementation The address of the candidate strategy. */ function proposeStrat(address _implementation) public onlyOwner { require(address(this) == IStrategyV7(_implementation).vault(), "Proposal not valid for this Vault"); require(want() == IStrategyV7(_implementation).want(), "Different want"); stratCandidate = StratCandidate({ implementation: _implementation, proposedTime: block.timestamp }); emit NewStratCandidate(_implementation); } /** * @dev It switches the active strat for the strat candidate. After upgrading, the * candidate implementation is set to the 0x00 address, and proposedTime to a time * happening in +100 years for safety. */ function upgradeStrat() public onlyOwner { require(stratCandidate.implementation != address(0), "There is no candidate"); require(stratCandidate.proposedTime + approvalDelay < block.timestamp, "Delay has not passed"); emit UpgradeStrat(stratCandidate.implementation); strategy.retireStrat(); strategy = IStrategyV7(stratCandidate.implementation); stratCandidate.implementation = address(0); stratCandidate.proposedTime = 5000000000; earn(); } /** * @dev Rescues random funds stuck that the strat can't handle. * @param _token address of the token to rescue. */ function inCaseTokensGetStuck(address _token) external onlyOwner { require(_token != address(want()), "!token"); uint256 amount = IERC20Upgradeable(_token).balanceOf(address(this)); IERC20Upgradeable(_token).safeTransfer(msg.sender, amount); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "./BeefyVaultV7.sol"; import "@openzeppelin/contracts-upgradeable/proxy/ClonesUpgradeable.sol"; // Beefy Finance Vault V7 Proxy Factory // Minimal proxy pattern for creating new Beefy vaults contract BeefyVaultV7Factory { using ClonesUpgradeable for address; // Contract template for deploying proxied Beefy vaults BeefyVaultV7 public instance; event ProxyCreated(address proxy); // Initializes the Factory with an instance of the Beefy Vault V7 constructor(address _instance) { if (_instance == address(0)) { instance = new BeefyVaultV7(); } else { instance = BeefyVaultV7(_instance); } } // Creates a new Beefy Vault V7 as a proxy of the template instance // A reference to the new proxied Beefy Vault V7 function cloneVault() external returns (BeefyVaultV7) { return BeefyVaultV7(cloneContract(address(instance))); } // Deploys and returns the address of a clone that mimics the behaviour of `implementation` function cloneContract(address implementation) public returns (address) { address proxy = implementation.clone(); emit ProxyCreated(proxy); return proxy; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import {ERC4626Upgradeable, ERC20Upgradeable, MathUpgradeable, IERC20MetadataUpgradeable} from "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/ERC4626Upgradeable.sol"; import {SafeERC20Upgradeable, IERC20Upgradeable} from "@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol"; /** * @dev Interface of a Beefy Vault */ interface IVault { function deposit(uint256) external; function withdraw(uint256) external; function balance() external view returns (uint256); function want() external view returns (IERC20MetadataUpgradeable); function totalSupply() external view returns (uint256); function name() external view returns (string memory); function symbol() external view returns (string memory); } /** * @title Beefy Wrapper ERC-4626 * @author kexley * @notice Implementation for an ERC-4626 wrapper of a Beefy Vault * @dev Wrapped Beefy Vault tokens can be minted by deposit of the underlying asset or by * wrapping Beefy Vault tokens in a 1:1 ratio. Wrapped Beefy Vault tokens can either be unwrapped * for an equal number of Beefy Vault tokens or redeemed for the underlying asset. * ERC4626 rules are strictly enforced, preview functions should return the correct values. * Only vaults which do not update their asset balance on deposit can be wrapped, i.e. vaults which * have profit locked or not harvesting on deposit, and the underlying balance is not updated on interactions. */ contract BeefyWrapper is ERC4626Upgradeable { using SafeERC20Upgradeable for IERC20Upgradeable; using MathUpgradeable for uint256; /** * @notice Error for when the shares are not minted correctly */ error MissingShares(); /** * @notice Address of the vault being wrapped */ address public vault; /** * @notice Initializes an ERC-4626 wrapper for a Beefy Vault token * @dev Called by the factory on cloning * @param _vault the address of the vault being wrapped * @param _name the name of the vault * @param _symbol the symbol of the vault's token */ function initialize( address _vault, string memory _name, string memory _symbol ) public initializer { vault = _vault; __ERC20_init(_name, _symbol); __ERC4626_init(IVault(vault).want()); IERC20Upgradeable(asset()).safeApprove(vault, type(uint256).max); } /** * @notice Wraps all vault tokens owned by the caller */ function wrapAll() external { wrap(IERC20Upgradeable(vault).balanceOf(msg.sender)); } /** * @notice Wraps an amount of vault tokens * @param amount the total amount of vault share tokens to be wrapped */ function wrap(uint256 amount) public { IERC20Upgradeable(vault).safeTransferFrom(msg.sender, address(this), amount); _mint(msg.sender, amount); } /** * @notice Unwraps all wrapped tokens owned by the caller */ function unwrapAll() external { unwrap(balanceOf(msg.sender)); } /** * @notice Unwraps an amount of vault tokens * @param amount the total amount of vault tokens to be unwrapped */ function unwrap(uint256 amount) public { _burn(msg.sender, amount); IERC20Upgradeable(vault).safeTransfer(msg.sender, amount); } /** * @notice Fetches the total assets held by the vault * @dev Returns the total assets held by the vault, not only the wrapper * @return totalAssets the total balance of assets held by the vault */ function totalAssets() public view virtual override returns (uint256) { return IVault(vault).balance(); } /** * @notice Fetches the total vault shares * @dev Returns the total vault shares, not the shares of the wrapper * @return totalSupply the total supply of vault shares */ function totalSupply() public view virtual override(ERC20Upgradeable, IERC20Upgradeable) returns (uint256) { return IERC20Upgradeable(vault).totalSupply(); } /** * @notice Deposit underlying assets to the vault and mint tokens to the receiver * @dev Overrides ERC-4626 internal deposit function. Deposits underlying assets to the vault * and mints the increase in vault shares to the receiver * @param caller the address of the sender of the assets * @param receiver the address of the receiver of the wrapped tokens * @param assets the amount of assets being deposited * @param shares the amount of shares being minted */ function _deposit( address caller, address receiver, uint256 assets, uint256 shares ) internal virtual override { IERC20Upgradeable(asset()).safeTransferFrom(caller, address(this), assets); uint256 balance = IERC20Upgradeable(vault).balanceOf(address(this)); IVault(vault).deposit(assets); /// Prevent harvest on deposit vaults from under-minting to the wrapper if (shares != IERC20Upgradeable(vault).balanceOf(address(this)) - balance) revert MissingShares(); _mint(receiver, shares); emit Deposit(caller, receiver, assets, shares); } /** * @notice Burn tokens and withdraw assets to receiver * @dev Overrides ERC-4626 internal withdraw function. Withdraws the underlying asset from the * vault and sends to the receiver * @param caller the address of the caller of the withdraw * @param receiver the address of the receiver of the assets * @param owner the address of the owner of the burnt shares * @param assets the amount of assets being withdrawn * @param shares the amount of shares being burnt */ function _withdraw( address caller, address receiver, address owner, uint256 assets, uint256 shares ) internal virtual override { if (caller != owner) { _spendAllowance(owner, caller, shares); } _burn(owner, shares); uint256 beforeWithdraw = IERC20Upgradeable(asset()).balanceOf(address(this)); IVault(vault).withdraw(shares); IERC20Upgradeable(asset()).safeTransfer(receiver, assets); /// Prevent assets from being left over in the wrapper uint256 afterWithdraw = IERC20Upgradeable(asset()).balanceOf(address(this)); if(afterWithdraw > beforeWithdraw) { uint256 leftover = afterWithdraw - beforeWithdraw; IVault(vault).deposit(leftover); } emit Withdraw(caller, receiver, owner, assets, shares); } /** * @dev Internal conversion function (from assets to shares) with support for rounding direction. */ function _convertToShares(uint256 assets, MathUpgradeable.Rounding rounding) internal view virtual override returns (uint256) { return assets.mulDiv(totalSupply(), totalAssets(), rounding); } /** * @dev Internal conversion function (from shares to assets) with support for rounding direction. */ function _convertToAssets(uint256 shares, MathUpgradeable.Rounding rounding) internal view virtual override returns (uint256) { return shares.mulDiv(totalAssets(), totalSupply(), rounding); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "./BeefyWrapper.sol"; import "@openzeppelin/contracts-upgradeable/proxy/ClonesUpgradeable.sol"; /** * @dev Interface of wrapper for initializing */ interface IWrapper { function initialize(address _vault, string memory _name, string memory _symbol) external; } /** * @title Beefy Wrapper ERC-4626 Factory * @author kexley * @notice Minimal factory for wrapping Beefy Vaults * @dev This factory creates lightweight ERC-4626 compliant wrappers for existing Beefy Vaults */ contract BeefyWrapperFactory { using ClonesUpgradeable for address; /** * @notice Immutable logic implementation address for a Beefy Vault wrapper */ address public immutable implementation; /** * @dev Emitted when a new proxy is deployed */ event ProxyCreated(address proxy); /** * @dev Deploys the instance of a wrapper and sets the implementation */ constructor() { implementation = address(new BeefyWrapper()); } /** * @notice Creates a new Beefy Vault wrapper * @dev Wrapper is initialized with "w" prepended to the vault name and symbol * @param _vault address of underlying Beefy Vault * @return proxy address of deployed wrapper */ function clone(address _vault) external returns (address proxy) { proxy = implementation.clone(); IWrapper(proxy).initialize( _vault, string.concat("W", IVault(_vault).name()), string.concat("w", IVault(_vault).symbol()) ); emit ProxyCreated(proxy); } }
{ "viaIR": true, "optimizer": { "enabled": true, "runs": 200 }, "evmVersion": "paris", "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } }, "libraries": {} }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"name","type":"string"},{"indexed":false,"internalType":"string","name":"symbol","type":"string"},{"indexed":false,"internalType":"address","name":"vault","type":"address"},{"indexed":false,"internalType":"address","name":"strategy","type":"address"},{"indexed":false,"internalType":"address","name":"wrapped","type":"address"}],"name":"Deployed","type":"event"},{"inputs":[],"name":"FEE_CONFIGURATOR","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"FEE_RECIPIENT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"KEEPER","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"OWNER","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"REWARD","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"STRATEGIST","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"STRATEGY_NAME","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SWAPPER","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"wrapped_name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"wrapped_symbol","type":"string"},{"internalType":"address","name":"want","type":"address"},{"internalType":"address","name":"aToken","type":"address"},{"internalType":"address","name":"lendingPool","type":"address"},{"internalType":"address","name":"incentiveController","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"deploy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"strategyFactory","outputs":[{"internalType":"contract StrategyFactory","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"vaultFactory","outputs":[{"internalType":"contract BeefyVaultV7Factory","name":"","type":"address"}],"stateMutability":"view","type":"function"}]
Contract Creation Code
6080806040523461005957739df377a9c4fadfb1f7bde79b92e31033d06a05a460018060a01b0319735d35cee99eef91f6f60ce8a0fe4a746dfd6a5f068160005416176000556001541617600155612c5a908161005f8239f35b600080fdfe608080604052600436101561001357600080fd5b6000803560e01c918263117803e314610ad0575081636edd544614610aa5578163700d85ae14610a7757816381cec8fc14610a49578163862a179e14610a1b5781639cfdede3146100a55781639ef35710146109f3578163a0cf0aea146109ee578163cab34c08146109ee578163d87b0529146100d3578163d8a06f73146100aa575063ebd09054146100a557600080fd5b610bd0565b346100d057806003193601126100d057546040516001600160a01b039091168152602090f35b80fd5b346100d0576101203660031901126100d0578060043567ffffffffffffffff81116109eb57610106903690600401610c33565b60243567ffffffffffffffff81116109e657610126903690600401610c33565b939060443567ffffffffffffffff81116107a957610148903690600401610c33565b60649691963567ffffffffffffffff81116107e05761016b903690600401610c33565b9093608435939091906001600160a01b03851685036109e25760a435946001600160a01b038616860361079a5760c435956001600160a01b03871687036109c75760e435966001600160a01b03881688036109de578954604051631c7c803160e01b81529a98906020908c9060049082908d906001600160a01b03165af19a8b156109d357899b61098b575b506001548990602090610231906001600160a01b0316610215610b48565b60405194858094819363116fd50160e01b835260048301610b87565b03925af1998a1561097f5799610937575b50604051918260c081011067ffffffffffffffff60c085011117610922578f60c0840160405260018060a01b038d1684527346112c2618b57a4e03492e727957123e5097df256020850152732a86ebd12573f4633453899156da81345ac1d57d604085015273ad1bb693975c16ec2ceef65edd540bc735f8608b606085015273ad1bb693975c16ec2ceef65edd540bc735f8608b608085015273b2983bc2fcbc44cc2de16e7fe9b6c4242a820a8260a085015260018060a01b038d163b156100d0578f908f8f8f90838f8f6103479761035991604051998a98899788966326896a5b60e11b885260018060a01b03166004880152608060248801526084870191610c61565b84810360031901604486015291610c61565b6064820183905203926001600160a01b03165af18015610913576108f8575b508f94939291906001600160a01b038b163b156108f4576040805163952cbad160e01b81526001600160a01b03878116600483015273039e2fb66102314ce7b64ce5ce3e5183bc94ad386024830181905260448301529586166064820152918516608483015291841660a48201528251841660c48201526020830151841660e4820152908201518316610104820152606082015183166101248201526080820151831661014482015260a0909101518216610164820152908390829061018490829084908d165af19081156108bd5783916108e0575b50506001600160a01b0387163b156108dc5760405163ac1e502560e01b8152600481018390528281602481836001600160a01b038d165af19081156108bd5783916108c8575b50506040516323b872dd60e01b815233600482015230602482015261010435604482015290602082606481866001600160a01b0386165af19081156108bd57602092610514926108a0575b5060405163095ea7b360e01b81526001600160a01b038c16600482015261010435602482015293849283919082906044820190565b03926001600160a01b03165af1801561082757610881575b506001600160a01b0387163b1561087d5760405163b6b55f2560e01b81526101043560048201528b908181602481836001600160a01b038e165af1801561079e57610869575b50506040516370a0823160e01b81523060048201526020816024816001600160a01b038c165afa908115610827578c91610832575b5060405163a9059cbb60e01b815233600482015260248101919091526020816044818f6001600160a01b038d165af18015610827576107f8575b5060405180611f8a81011067ffffffffffffffff611f8a830111176107e457908b939291611f8a610c9b823980611f8a8101039085f080156107c1576001600160a01b031696873b156107e057604051639065714760e01b81526001600160a01b038a166004820152606060248201529385938593849361066e9390929161034791606487019190610c61565b038183895af1801561079e576107cc575b50506001600160a01b0384163b1561079a5760405163f2fde38b60e01b80825273c4049acca995a4ae3b7775dd46547494a96a1f53600483018190528a928381602481836001600160a01b038d165af19081156107c15784916107ad575b50506001600160a01b0385163b156107a95760405191825260048201528181602481836001600160a01b0389165af1801561079e57610786575b50507f1a6c3371f2f1a2632b2a32f5fa364dac552cf5468a5b5c66ccdbf651d9473401966107649161075660405198899860a08a5260a08a0191610c61565b918783036020890152610c61565b6001600160a01b0393841660408601529216606084015260808301520390a180f35b61078f90610afc565b61079a578789610717565b8780fd5b6040513d84823e3d90fd5b8280fd5b6107b690610afc565b6107a957828c6106dd565b6040513d86823e3d90fd5b6107d590610afc565b61079a57878961067f565b8480fd5b634e487b7160e01b8c52604160045260248cfd5b6108199060203d602011610820575b6108118183610b26565b810190610c82565b508b6105e1565b503d610807565b6040513d8e823e3d90fd5b90506020813d602011610861575b8161084d60209383610b26565b8101031261085d575160206105a7565b8b80fd5b3d9150610840565b61087290610afc565b61087d578a8c610572565b8a80fd5b6108999060203d602011610820576108118183610b26565b508b61052c565b6108b690843d8611610820576108118183610b26565b508f6104df565b6040513d85823e3d90fd5b6108d190610afc565b6108dc57818e610494565b5080fd5b6108e990610afc565b6108dc57818e61044e565b8580fd5b919f909493929161090890610afc565b9e9091929338610378565b50508f604051903d90823e3d90fd5b50634e487b7160e01b8f52604160045260248ffd5b9098506020813d602011610977575b8161095360209383610b26565b8101031261097357516001600160a01b038116810361097357978f610242565b8e80fd5b3d9150610946565b604051903d90823e3d90fd5b909a506020813d6020116109cb575b816109a760209383610b26565b810103126109c757516001600160a01b03811681036109c757998f6101f7565b8880fd5b3d915061099a565b6040513d8b823e3d90fd5b8980fd5b8680fd5b505050fd5b50fd5b610c04565b346100d057806003193601126100d0576001546040516001600160a01b039091168152602090f35b346100d057806003193601126100d0576020604051732a86ebd12573f4633453899156da81345ac1d57d8152f35b346100d057806003193601126100d057602060405173b2983bc2fcbc44cc2de16e7fe9b6c4242a820a828152f35b346100d057806003193601126100d05760206040517346112c2618b57a4e03492e727957123e5097df258152f35b346100d057806003193601126100d057610acc610ac0610b48565b60405191829182610b87565b0390f35b346108dc57816003193601126108dc578073c4049acca995a4ae3b7775dd46547494a96a1f5360209252f35b67ffffffffffffffff8111610b1057604052565b634e487b7160e01b600052604160045260246000fd5b90601f8019910116810190811067ffffffffffffffff821117610b1057604052565b604051906040820182811067ffffffffffffffff821117610b105760405260128252713b34b33496b0b0bb3296b9bab838363c969960711b6020830152565b6020808252825181830181905290939260005b828110610bbc57505060409293506000838284010152601f8019910116010190565b818101860151848201604001528501610b9a565b34610bff576000366003190112610bff57602060405173ad1bb693975c16ec2ceef65edd540bc735f8608b8152f35b600080fd5b34610bff576000366003190112610bff57602060405173039e2fb66102314ce7b64ce5ce3e5183bc94ad388152f35b9181601f84011215610bff5782359167ffffffffffffffff8311610bff5760208381860195010111610bff57565b908060209392818452848401376000828201840152601f01601f1916010190565b90816020910312610bff57518015158103610bff579056fe6080806040523461001657611f6e908161001c8239f35b600080fdfe6080604052600436101561001257600080fd5b60003560e01c806301e1d11414610f6657806306fdde0314610ed057806307a2d13a14610cba578063095ea7b314610eaa5780630a28a47714610e8457806318160ddd14610e6957806323b872dd14610e31578063313ce56714610dee57806338d52e0f14610dc55780633950935114610d74578063402d267d146102e95780634982e3b714610d475780634c84c1c814610cbf5780634cdad50614610cba5780636e553f6514610c7657806370a082311461025d578063906571471461066157806394bf804d1461062457806395d89b4114610541578063a457c2d71461049a578063a9059cbb14610469578063b3d7f6b91461043a578063b460af941461038d578063ba087652146102ee578063c63d75b6146102e9578063c6e6f592146101b5578063ce96cb771461029e578063d905777e1461025d578063dd62ed3e1461020c578063de0e9a3e146101d8578063ea598cb0146101ba578063ef8b30f7146101b55763fbfa77cf1461018757600080fd5b346101b05760003660031901126101b0576097546040516001600160a01b039091168152602090f35b600080fd5b611151565b346101b05760203660031901126101b0576101d6600435611259565b005b346101b05760203660031901126101b0576101d66004356101f9813361199d565b60975433906001600160a01b0316611aa8565b346101b05760403660031901126101b057610225610ff9565b61022d61100f565b9060018060a01b038091166000526034602052604060002091166000526020526020604060002054604051908152f35b346101b05760203660031901126101b057602061029661027b610ff9565b6001600160a01b031660009081526033602052604090205490565b604051908152f35b346101b05760203660031901126101b0576001600160a01b036102bf610ff9565b16600052603360205260206102966040600020546102db611173565b6102e3611214565b91611d16565b611025565b346101b0576102fc3661111c565b6001600160a01b0381166000908152603360205260409020549091908311610348576020926102969161033f610330611173565b610338611214565b9084611d16565b9384913361178b565b60405162461bcd60e51b815260206004820152601d60248201527f455243343632363a2072656465656d206d6f7265207468616e206d61780000006044820152606490fd5b346101b05761039b3661111c565b90916103c56103bd8360018060a01b0316600052603360205260406000205490565b6102db611173565b81116103f557602092610296916103ec6103dd611214565b6103e5611173565b9083611bde565b9384923361178b565b60405162461bcd60e51b815260206004820152601f60248201527f455243343632363a207769746864726177206d6f7265207468616e206d6178006044820152606490fd5b346101b05760203660031901126101b0576020610296610458611173565b610460611214565b90600435611bde565b346101b05760403660031901126101b05761048f610485610ff9565b602435903361141b565b602060405160018152f35b346101b05760403660031901126101b0576104b3610ff9565b60243590336000526034602052604060002060018060a01b038216600052602052604060002054918083106104ee5761048f92039033611281565b60405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608490fd5b346101b05760003660031901126101b0576040516000603754610563816111da565b808452906020906001908181169081156105fa57506001146105a0575b61059c8561059081870382611097565b60405191829182610f81565b0390f35b6037600090815293507f42a7b7dd785cd69714a189dffb3fd7d7174edc9ece837694ce50f7078f7c31ae5b8385106105e7575050505081016020016105908261059c610580565b80548686018401529382019381016105cb565b86955061059c9693506020925061059094915060ff191682840152151560051b8201019293610580565b346101b05760403660031901126101b057602060043561029661064561100f565b91610659610651611173565b6103e5611214565b809333611598565b346101b05760603660031901126101b05761067a610ff9565b60243567ffffffffffffffff81116101b05761069a9036906004016110d5565b9060443567ffffffffffffffff81116101b0576106bb9036906004016110d5565b906000549060ff8260081c161591828093610c69575b8015610c52575b15610bf65760ff19811660011760005582610be4575b5060018060a01b03166bffffffffffffffffffffffff60a01b609754161760975561072960ff60005460081c166107248161172b565b61172b565b825167ffffffffffffffff8111610ae2576107456036546111da565b601f8111610b77575b506020601f8211600114610b035781929394600092610af8575b50508160011b916000199060031b1c1916176036555b815167ffffffffffffffff8111610ae25761079a6037546111da565b601f8111610a7d575b50602092601f82116001146109fb57928192936000926109f0575b50508160011b916000199060031b1c1916176037555b609754604051631f1fcd5160e01b81526001600160a01b0390911690602081600481855afa90811561099a576000916109ae575b5060018060a01b03169061082760ff60005460081c166107248161172b565b8161083181611e07565b90156109a6575b6065549060ff60a01b9060a01b16906affffffffffffffffffffff60a81b161717606555604051636eb1769f60e11b8152306004820152816024820152602081604481865afa90811561099a57600091610968575b50610904576108c6916040519163095ea7b360e01b602084015260248301526000196044830152604482526108c18261107b565b611c1e565b6108cc57005b61ff0019600054166000557f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498602060405160018152a1005b60405162461bcd60e51b815260206004820152603660248201527f5361666545524332303a20617070726f76652066726f6d206e6f6e2d7a65726f60448201527520746f206e6f6e2d7a65726f20616c6c6f77616e636560501b6064820152608490fd5b90506020813d602011610992575b8161098360209383611097565b810103126101b057518461088d565b3d9150610976565b6040513d6000823e3d90fd5b506012610838565b90506020813d6020116109e8575b816109c960209383611097565b810103126101b057516001600160a01b03811681036101b05783610808565b3d91506109bc565b0151905083806107be565b601f1982169360376000527f42a7b7dd785cd69714a189dffb3fd7d7174edc9ece837694ce50f7078f7c31ae9160005b868110610a655750836001959610610a4c575b505050811b016037556107d4565b015160001960f88460031b161c19169055838080610a3e565b91926020600181928685015181550194019201610a2b565b60376000527f42a7b7dd785cd69714a189dffb3fd7d7174edc9ece837694ce50f7078f7c31ae601f830160051c81019160208410610ad8575b601f0160051c01905b818110610acc57506107a3565b60008155600101610abf565b9091508190610ab6565b634e487b7160e01b600052604160045260246000fd5b015190508480610768565b6036600052600080516020611f198339815191529060005b601f1984168110610b5f5750600193949583601f19811610610b46575b505050811b0160365561077e565b015160001960f88460031b161c19169055848080610b38565b9091602060018192858a015181550193019101610b1b565b6036600052601f820160051c600080516020611f19833981519152019060208310610bce575b601f0160051c600080516020611f1983398151915201905b818110610bc2575061074e565b60008155600101610bb5565b600080516020611f198339815191529150610b9d565b61ffff191661010117600055846106ee565b60405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608490fd5b50303b1580156106d85750600160ff8216146106d8565b50600160ff8216106106d1565b346101b05760403660031901126101b0576020600435610296610c9761100f565b610cb1610ca2611214565b610caa611173565b9085611d16565b92839133611598565b610fca565b346101b05760003660031901126101b0576097546040516370a0823160e01b815233600482015290602090829060249082906001600160a01b03165afa801561099a57600090610d13575b6101d690611259565b506020813d602011610d3f575b81610d2d60209383611097565b810103126101b0576101d69051610d0a565b3d9150610d20565b346101b05760003660031901126101b0573360005260336020526101d66040600020546101f9813361199d565b346101b05760403660031901126101b05761048f610d90610ff9565b336000526034602052604060002060018060a01b038216600052602052610dbe60243560406000205461124c565b9033611281565b346101b05760003660031901126101b0576065546040516001600160a01b039091168152602090f35b346101b05760003660031901126101b05760ff60655460a01c1660ff8111610e1b57602090604051908152f35b634e487b7160e01b600052601160045260246000fd5b346101b05760603660031901126101b05761048f610e4d610ff9565b610e5561100f565b60443591610e64833383611383565b61141b565b346101b05760003660031901126101b0576020610296611214565b346101b05760203660031901126101b0576020610296610ea2611214565b610460611173565b346101b05760403660031901126101b05761048f610ec6610ff9565b6024359033611281565b346101b05760003660031901126101b0576040516000603654610ef2816111da565b808452906020906001908181169081156105fa5750600114610f1e5761059c8561059081870382611097565b603660009081529350600080516020611f198339815191525b838510610f53575050505081016020016105908261059c610580565b8054868601840152938201938101610f37565b346101b05760003660031901126101b0576020610296611173565b6020808252825181830181905290939260005b828110610fb657505060409293506000838284010152601f8019910116010190565b818101860151848201604001528501610f94565b346101b05760203660031901126101b0576020610296610fe8611173565b610ff0611214565b90600435611d16565b600435906001600160a01b03821682036101b057565b602435906001600160a01b03821682036101b057565b346101b05760203660031901126101b05761103e610ff9565b5060206040516000198152f35b67ffffffffffffffff8111610ae257604052565b6040810190811067ffffffffffffffff821117610ae257604052565b6080810190811067ffffffffffffffff821117610ae257604052565b90601f8019910116810190811067ffffffffffffffff821117610ae257604052565b67ffffffffffffffff8111610ae257601f01601f191660200190565b81601f820112156101b0578035906110ec826110b9565b926110fa6040519485611097565b828452602083830101116101b057816000926020809301838601378301015290565b60609060031901126101b057600435906001600160a01b039060243582811681036101b0579160443590811681036101b05790565b346101b05760203660031901126101b057602061029661116f611214565b610ff05b6097546040516316d3df1560e31b815290602090829060049082906001600160a01b03165afa90811561099a576000916111ab575090565b90506020813d6020116111d2575b816111c660209383611097565b810103126101b0575190565b3d91506111b9565b90600182811c9216801561120a575b60208310146111f457565b634e487b7160e01b600052602260045260246000fd5b91607f16916111e9565b6097546040516318160ddd60e01b815290602090829060049082906001600160a01b03165afa90811561099a576000916111ab575090565b91908201809211610e1b57565b60975461127f9190611279908290309033906001600160a01b0316611ae1565b33611b3a565b565b6001600160a01b0390811691821561133257169182156112e25760207f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925918360005260348252604060002085600052825280604060002055604051908152a3565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608490fd5b60405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b9060018060a01b03808316600052603460205260406000209082166000526020526040600020549260001984036113bb575b50505050565b8084106113d6576113cd930391611281565b388080806113b5565b60405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606490fd5b6001600160a01b0390811691821561153857169182156114e7576000828152603360205260408120549180831061149357604082827fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef95876020965260338652038282205586815220818154019055604051908152a3565b60405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608490fd5b60405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608490fd5b91908203918211610e1b57565b9290606554906000926115b78560018060a01b03948886309216611ae1565b609754604080516370a0823160e01b808252306004830152919660209387168483602481845afa9283156116ee5782936116fc575b50803b156116f85781809160248c8c51948593849263b6b55f2560e01b845260048401525af180156116ee576116df575b508387609754169360248a518096819382523060048301525afa9081156116d457906116a5575b61164e925061158b565b820361169457918184936116857fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d797969484611b3a565b855197885287015216941692a3565b845163539aca2d60e01b8152600490fd5b508282813d83116116cd575b6116bb8183611097565b810103126101b05761164e9151611644565b503d6116b1565b8851903d90823e3d90fd5b6116e89061104b565b3861161d565b89513d84823e3d90fd5b5080fd5b9092508481813d8311611724575b6117148183611097565b810103126116f8575191386115ec565b503d61170a565b1561173257565b60405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b6064820152608490fd5b9394936001600160a01b03808416949381831693926117b69189918289880361198c575b505061199d565b60655491600097826040948551906370a0823160e01b90818352306004840152826024816020968794165afa918215611932578c92611959575b508b8660975416803b156116f857819060248a5180948193632e1a7d4d60e01b83528a60048401525af1801561194f5761193c575b5061183589868860655416611aa8565b82866065541691602489518094819382523060048301525afa908115611932578c91611905575b5081811161189b575b50507ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db95969798995084519788528701521693a4565b8b916118a69161158b565b8560975416803b1561190157602483928951948593849263b6b55f2560e01b845260048401525af180156118f7576118df575b80611865565b6118e98b9161104b565b6118f357896118d9565b8980fd5b86513d8d823e3d90fd5b8280fd5b90508281813d831161192b575b61191c8183611097565b810103126101b057513861185c565b503d611912565b87513d8e823e3d90fd5b611948909c919c61104b565b9a38611825565b88513d8f823e3d90fd5b9091508281813d8311611985575b6119718183611097565b81010312611981575190386117f0565b8b80fd5b503d611967565b6119969183611383565b38826117af565b6001600160a01b03168015611a595780600052603360205260406000205491808310611a09576020817fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef92600095858752603384520360408620558060355403603555604051908152a3565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608490fd5b60405163a9059cbb60e01b60208201526001600160a01b03909216602483015260448083019390935291815261127f916108c18261107b565b6040516323b872dd60e01b60208201526001600160a01b03928316602482015292909116604483015260648083019390935291815260a081019181831067ffffffffffffffff841117610ae25761127f92604052611c1e565b6001600160a01b0316908115611b99577fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef602082611b7c60009460355461124c565b6035558484526033825260408420818154019055604051908152a3565b60405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606490fd5b9190611beb828285611d16565b928215611c085709611bfa5790565b60018101809111610e1b5790565b634e487b7160e01b600052601260045260246000fd5b60018060a01b031690611c7d604051611c368161105f565b6020938482527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564858301526000808587829751910182855af1611c77611dd7565b91611e83565b805191821591848315611cef575b505050905015611c985750565b6084906040519062461bcd60e51b82526004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152fd5b9193818094500103126116f857820151908115158203611d13575080388084611c8b565b80fd5b916000198284099282810292838086109503948086039514611dc95784831115611d8c578291096001821901821680920460028082600302188083028203028083028203028083028203028083028203028083028203028092029003029360018380600003040190848311900302920304170290565b60405162461bcd60e51b81526020600482015260156024820152744d6174683a206d756c446976206f766572666c6f7760581b6044820152606490fd5b505080925015611c08570490565b3d15611e02573d90611de8826110b9565b91611df66040519384611097565b82523d6000602084013e565b606090565b90604051602081019063313ce56760e01b825260048152611e278161105f565b5160009384928392916001600160a01b03165afa611e43611dd7565b9080611e77575b611e54575b508190565b602081805181010312611901576020015160ff8111611e4f576001925060ff1690565b50602081511015611e4a565b91929015611ee55750815115611e97575090565b3b15611ea05790565b60405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606490fd5b825190915015611ef85750805190602001fd5b60405162461bcd60e51b8152908190611f149060048301610f81565b0390fdfe4a11f94e20a93c79f6ec743a1954ec4fc2c08429ae2122118bf234b2185c81b8a2646970667358221220440ac32a7b4a614faf68d39d0a3b9de0700e734a48b42c3167dd318671b6b6d664736f6c63430008170033a2646970667358221220d0ee7008df9f65d6cceede53630780370490954efc90dbbe8e3d979255d8d5d064736f6c63430008170033
Deployed Bytecode
0x608080604052600436101561001357600080fd5b6000803560e01c918263117803e314610ad0575081636edd544614610aa5578163700d85ae14610a7757816381cec8fc14610a49578163862a179e14610a1b5781639cfdede3146100a55781639ef35710146109f3578163a0cf0aea146109ee578163cab34c08146109ee578163d87b0529146100d3578163d8a06f73146100aa575063ebd09054146100a557600080fd5b610bd0565b346100d057806003193601126100d057546040516001600160a01b039091168152602090f35b80fd5b346100d0576101203660031901126100d0578060043567ffffffffffffffff81116109eb57610106903690600401610c33565b60243567ffffffffffffffff81116109e657610126903690600401610c33565b939060443567ffffffffffffffff81116107a957610148903690600401610c33565b60649691963567ffffffffffffffff81116107e05761016b903690600401610c33565b9093608435939091906001600160a01b03851685036109e25760a435946001600160a01b038616860361079a5760c435956001600160a01b03871687036109c75760e435966001600160a01b03881688036109de578954604051631c7c803160e01b81529a98906020908c9060049082908d906001600160a01b03165af19a8b156109d357899b61098b575b506001548990602090610231906001600160a01b0316610215610b48565b60405194858094819363116fd50160e01b835260048301610b87565b03925af1998a1561097f5799610937575b50604051918260c081011067ffffffffffffffff60c085011117610922578f60c0840160405260018060a01b038d1684527346112c2618b57a4e03492e727957123e5097df256020850152732a86ebd12573f4633453899156da81345ac1d57d604085015273ad1bb693975c16ec2ceef65edd540bc735f8608b606085015273ad1bb693975c16ec2ceef65edd540bc735f8608b608085015273b2983bc2fcbc44cc2de16e7fe9b6c4242a820a8260a085015260018060a01b038d163b156100d0578f908f8f8f90838f8f6103479761035991604051998a98899788966326896a5b60e11b885260018060a01b03166004880152608060248801526084870191610c61565b84810360031901604486015291610c61565b6064820183905203926001600160a01b03165af18015610913576108f8575b508f94939291906001600160a01b038b163b156108f4576040805163952cbad160e01b81526001600160a01b03878116600483015273039e2fb66102314ce7b64ce5ce3e5183bc94ad386024830181905260448301529586166064820152918516608483015291841660a48201528251841660c48201526020830151841660e4820152908201518316610104820152606082015183166101248201526080820151831661014482015260a0909101518216610164820152908390829061018490829084908d165af19081156108bd5783916108e0575b50506001600160a01b0387163b156108dc5760405163ac1e502560e01b8152600481018390528281602481836001600160a01b038d165af19081156108bd5783916108c8575b50506040516323b872dd60e01b815233600482015230602482015261010435604482015290602082606481866001600160a01b0386165af19081156108bd57602092610514926108a0575b5060405163095ea7b360e01b81526001600160a01b038c16600482015261010435602482015293849283919082906044820190565b03926001600160a01b03165af1801561082757610881575b506001600160a01b0387163b1561087d5760405163b6b55f2560e01b81526101043560048201528b908181602481836001600160a01b038e165af1801561079e57610869575b50506040516370a0823160e01b81523060048201526020816024816001600160a01b038c165afa908115610827578c91610832575b5060405163a9059cbb60e01b815233600482015260248101919091526020816044818f6001600160a01b038d165af18015610827576107f8575b5060405180611f8a81011067ffffffffffffffff611f8a830111176107e457908b939291611f8a610c9b823980611f8a8101039085f080156107c1576001600160a01b031696873b156107e057604051639065714760e01b81526001600160a01b038a166004820152606060248201529385938593849361066e9390929161034791606487019190610c61565b038183895af1801561079e576107cc575b50506001600160a01b0384163b1561079a5760405163f2fde38b60e01b80825273c4049acca995a4ae3b7775dd46547494a96a1f53600483018190528a928381602481836001600160a01b038d165af19081156107c15784916107ad575b50506001600160a01b0385163b156107a95760405191825260048201528181602481836001600160a01b0389165af1801561079e57610786575b50507f1a6c3371f2f1a2632b2a32f5fa364dac552cf5468a5b5c66ccdbf651d9473401966107649161075660405198899860a08a5260a08a0191610c61565b918783036020890152610c61565b6001600160a01b0393841660408601529216606084015260808301520390a180f35b61078f90610afc565b61079a578789610717565b8780fd5b6040513d84823e3d90fd5b8280fd5b6107b690610afc565b6107a957828c6106dd565b6040513d86823e3d90fd5b6107d590610afc565b61079a57878961067f565b8480fd5b634e487b7160e01b8c52604160045260248cfd5b6108199060203d602011610820575b6108118183610b26565b810190610c82565b508b6105e1565b503d610807565b6040513d8e823e3d90fd5b90506020813d602011610861575b8161084d60209383610b26565b8101031261085d575160206105a7565b8b80fd5b3d9150610840565b61087290610afc565b61087d578a8c610572565b8a80fd5b6108999060203d602011610820576108118183610b26565b508b61052c565b6108b690843d8611610820576108118183610b26565b508f6104df565b6040513d85823e3d90fd5b6108d190610afc565b6108dc57818e610494565b5080fd5b6108e990610afc565b6108dc57818e61044e565b8580fd5b919f909493929161090890610afc565b9e9091929338610378565b50508f604051903d90823e3d90fd5b50634e487b7160e01b8f52604160045260248ffd5b9098506020813d602011610977575b8161095360209383610b26565b8101031261097357516001600160a01b038116810361097357978f610242565b8e80fd5b3d9150610946565b604051903d90823e3d90fd5b909a506020813d6020116109cb575b816109a760209383610b26565b810103126109c757516001600160a01b03811681036109c757998f6101f7565b8880fd5b3d915061099a565b6040513d8b823e3d90fd5b8980fd5b8680fd5b505050fd5b50fd5b610c04565b346100d057806003193601126100d0576001546040516001600160a01b039091168152602090f35b346100d057806003193601126100d0576020604051732a86ebd12573f4633453899156da81345ac1d57d8152f35b346100d057806003193601126100d057602060405173b2983bc2fcbc44cc2de16e7fe9b6c4242a820a828152f35b346100d057806003193601126100d05760206040517346112c2618b57a4e03492e727957123e5097df258152f35b346100d057806003193601126100d057610acc610ac0610b48565b60405191829182610b87565b0390f35b346108dc57816003193601126108dc578073c4049acca995a4ae3b7775dd46547494a96a1f5360209252f35b67ffffffffffffffff8111610b1057604052565b634e487b7160e01b600052604160045260246000fd5b90601f8019910116810190811067ffffffffffffffff821117610b1057604052565b604051906040820182811067ffffffffffffffff821117610b105760405260128252713b34b33496b0b0bb3296b9bab838363c969960711b6020830152565b6020808252825181830181905290939260005b828110610bbc57505060409293506000838284010152601f8019910116010190565b818101860151848201604001528501610b9a565b34610bff576000366003190112610bff57602060405173ad1bb693975c16ec2ceef65edd540bc735f8608b8152f35b600080fd5b34610bff576000366003190112610bff57602060405173039e2fb66102314ce7b64ce5ce3e5183bc94ad388152f35b9181601f84011215610bff5782359167ffffffffffffffff8311610bff5760208381860195010111610bff57565b908060209392818452848401376000828201840152601f01601f1916010190565b90816020910312610bff57518015158103610bff579056fe6080806040523461001657611f6e908161001c8239f35b600080fdfe6080604052600436101561001257600080fd5b60003560e01c806301e1d11414610f6657806306fdde0314610ed057806307a2d13a14610cba578063095ea7b314610eaa5780630a28a47714610e8457806318160ddd14610e6957806323b872dd14610e31578063313ce56714610dee57806338d52e0f14610dc55780633950935114610d74578063402d267d146102e95780634982e3b714610d475780634c84c1c814610cbf5780634cdad50614610cba5780636e553f6514610c7657806370a082311461025d578063906571471461066157806394bf804d1461062457806395d89b4114610541578063a457c2d71461049a578063a9059cbb14610469578063b3d7f6b91461043a578063b460af941461038d578063ba087652146102ee578063c63d75b6146102e9578063c6e6f592146101b5578063ce96cb771461029e578063d905777e1461025d578063dd62ed3e1461020c578063de0e9a3e146101d8578063ea598cb0146101ba578063ef8b30f7146101b55763fbfa77cf1461018757600080fd5b346101b05760003660031901126101b0576097546040516001600160a01b039091168152602090f35b600080fd5b611151565b346101b05760203660031901126101b0576101d6600435611259565b005b346101b05760203660031901126101b0576101d66004356101f9813361199d565b60975433906001600160a01b0316611aa8565b346101b05760403660031901126101b057610225610ff9565b61022d61100f565b9060018060a01b038091166000526034602052604060002091166000526020526020604060002054604051908152f35b346101b05760203660031901126101b057602061029661027b610ff9565b6001600160a01b031660009081526033602052604090205490565b604051908152f35b346101b05760203660031901126101b0576001600160a01b036102bf610ff9565b16600052603360205260206102966040600020546102db611173565b6102e3611214565b91611d16565b611025565b346101b0576102fc3661111c565b6001600160a01b0381166000908152603360205260409020549091908311610348576020926102969161033f610330611173565b610338611214565b9084611d16565b9384913361178b565b60405162461bcd60e51b815260206004820152601d60248201527f455243343632363a2072656465656d206d6f7265207468616e206d61780000006044820152606490fd5b346101b05761039b3661111c565b90916103c56103bd8360018060a01b0316600052603360205260406000205490565b6102db611173565b81116103f557602092610296916103ec6103dd611214565b6103e5611173565b9083611bde565b9384923361178b565b60405162461bcd60e51b815260206004820152601f60248201527f455243343632363a207769746864726177206d6f7265207468616e206d6178006044820152606490fd5b346101b05760203660031901126101b0576020610296610458611173565b610460611214565b90600435611bde565b346101b05760403660031901126101b05761048f610485610ff9565b602435903361141b565b602060405160018152f35b346101b05760403660031901126101b0576104b3610ff9565b60243590336000526034602052604060002060018060a01b038216600052602052604060002054918083106104ee5761048f92039033611281565b60405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608490fd5b346101b05760003660031901126101b0576040516000603754610563816111da565b808452906020906001908181169081156105fa57506001146105a0575b61059c8561059081870382611097565b60405191829182610f81565b0390f35b6037600090815293507f42a7b7dd785cd69714a189dffb3fd7d7174edc9ece837694ce50f7078f7c31ae5b8385106105e7575050505081016020016105908261059c610580565b80548686018401529382019381016105cb565b86955061059c9693506020925061059094915060ff191682840152151560051b8201019293610580565b346101b05760403660031901126101b057602060043561029661064561100f565b91610659610651611173565b6103e5611214565b809333611598565b346101b05760603660031901126101b05761067a610ff9565b60243567ffffffffffffffff81116101b05761069a9036906004016110d5565b9060443567ffffffffffffffff81116101b0576106bb9036906004016110d5565b906000549060ff8260081c161591828093610c69575b8015610c52575b15610bf65760ff19811660011760005582610be4575b5060018060a01b03166bffffffffffffffffffffffff60a01b609754161760975561072960ff60005460081c166107248161172b565b61172b565b825167ffffffffffffffff8111610ae2576107456036546111da565b601f8111610b77575b506020601f8211600114610b035781929394600092610af8575b50508160011b916000199060031b1c1916176036555b815167ffffffffffffffff8111610ae25761079a6037546111da565b601f8111610a7d575b50602092601f82116001146109fb57928192936000926109f0575b50508160011b916000199060031b1c1916176037555b609754604051631f1fcd5160e01b81526001600160a01b0390911690602081600481855afa90811561099a576000916109ae575b5060018060a01b03169061082760ff60005460081c166107248161172b565b8161083181611e07565b90156109a6575b6065549060ff60a01b9060a01b16906affffffffffffffffffffff60a81b161717606555604051636eb1769f60e11b8152306004820152816024820152602081604481865afa90811561099a57600091610968575b50610904576108c6916040519163095ea7b360e01b602084015260248301526000196044830152604482526108c18261107b565b611c1e565b6108cc57005b61ff0019600054166000557f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498602060405160018152a1005b60405162461bcd60e51b815260206004820152603660248201527f5361666545524332303a20617070726f76652066726f6d206e6f6e2d7a65726f60448201527520746f206e6f6e2d7a65726f20616c6c6f77616e636560501b6064820152608490fd5b90506020813d602011610992575b8161098360209383611097565b810103126101b057518461088d565b3d9150610976565b6040513d6000823e3d90fd5b506012610838565b90506020813d6020116109e8575b816109c960209383611097565b810103126101b057516001600160a01b03811681036101b05783610808565b3d91506109bc565b0151905083806107be565b601f1982169360376000527f42a7b7dd785cd69714a189dffb3fd7d7174edc9ece837694ce50f7078f7c31ae9160005b868110610a655750836001959610610a4c575b505050811b016037556107d4565b015160001960f88460031b161c19169055838080610a3e565b91926020600181928685015181550194019201610a2b565b60376000527f42a7b7dd785cd69714a189dffb3fd7d7174edc9ece837694ce50f7078f7c31ae601f830160051c81019160208410610ad8575b601f0160051c01905b818110610acc57506107a3565b60008155600101610abf565b9091508190610ab6565b634e487b7160e01b600052604160045260246000fd5b015190508480610768565b6036600052600080516020611f198339815191529060005b601f1984168110610b5f5750600193949583601f19811610610b46575b505050811b0160365561077e565b015160001960f88460031b161c19169055848080610b38565b9091602060018192858a015181550193019101610b1b565b6036600052601f820160051c600080516020611f19833981519152019060208310610bce575b601f0160051c600080516020611f1983398151915201905b818110610bc2575061074e565b60008155600101610bb5565b600080516020611f198339815191529150610b9d565b61ffff191661010117600055846106ee565b60405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608490fd5b50303b1580156106d85750600160ff8216146106d8565b50600160ff8216106106d1565b346101b05760403660031901126101b0576020600435610296610c9761100f565b610cb1610ca2611214565b610caa611173565b9085611d16565b92839133611598565b610fca565b346101b05760003660031901126101b0576097546040516370a0823160e01b815233600482015290602090829060249082906001600160a01b03165afa801561099a57600090610d13575b6101d690611259565b506020813d602011610d3f575b81610d2d60209383611097565b810103126101b0576101d69051610d0a565b3d9150610d20565b346101b05760003660031901126101b0573360005260336020526101d66040600020546101f9813361199d565b346101b05760403660031901126101b05761048f610d90610ff9565b336000526034602052604060002060018060a01b038216600052602052610dbe60243560406000205461124c565b9033611281565b346101b05760003660031901126101b0576065546040516001600160a01b039091168152602090f35b346101b05760003660031901126101b05760ff60655460a01c1660ff8111610e1b57602090604051908152f35b634e487b7160e01b600052601160045260246000fd5b346101b05760603660031901126101b05761048f610e4d610ff9565b610e5561100f565b60443591610e64833383611383565b61141b565b346101b05760003660031901126101b0576020610296611214565b346101b05760203660031901126101b0576020610296610ea2611214565b610460611173565b346101b05760403660031901126101b05761048f610ec6610ff9565b6024359033611281565b346101b05760003660031901126101b0576040516000603654610ef2816111da565b808452906020906001908181169081156105fa5750600114610f1e5761059c8561059081870382611097565b603660009081529350600080516020611f198339815191525b838510610f53575050505081016020016105908261059c610580565b8054868601840152938201938101610f37565b346101b05760003660031901126101b0576020610296611173565b6020808252825181830181905290939260005b828110610fb657505060409293506000838284010152601f8019910116010190565b818101860151848201604001528501610f94565b346101b05760203660031901126101b0576020610296610fe8611173565b610ff0611214565b90600435611d16565b600435906001600160a01b03821682036101b057565b602435906001600160a01b03821682036101b057565b346101b05760203660031901126101b05761103e610ff9565b5060206040516000198152f35b67ffffffffffffffff8111610ae257604052565b6040810190811067ffffffffffffffff821117610ae257604052565b6080810190811067ffffffffffffffff821117610ae257604052565b90601f8019910116810190811067ffffffffffffffff821117610ae257604052565b67ffffffffffffffff8111610ae257601f01601f191660200190565b81601f820112156101b0578035906110ec826110b9565b926110fa6040519485611097565b828452602083830101116101b057816000926020809301838601378301015290565b60609060031901126101b057600435906001600160a01b039060243582811681036101b0579160443590811681036101b05790565b346101b05760203660031901126101b057602061029661116f611214565b610ff05b6097546040516316d3df1560e31b815290602090829060049082906001600160a01b03165afa90811561099a576000916111ab575090565b90506020813d6020116111d2575b816111c660209383611097565b810103126101b0575190565b3d91506111b9565b90600182811c9216801561120a575b60208310146111f457565b634e487b7160e01b600052602260045260246000fd5b91607f16916111e9565b6097546040516318160ddd60e01b815290602090829060049082906001600160a01b03165afa90811561099a576000916111ab575090565b91908201809211610e1b57565b60975461127f9190611279908290309033906001600160a01b0316611ae1565b33611b3a565b565b6001600160a01b0390811691821561133257169182156112e25760207f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925918360005260348252604060002085600052825280604060002055604051908152a3565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608490fd5b60405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b9060018060a01b03808316600052603460205260406000209082166000526020526040600020549260001984036113bb575b50505050565b8084106113d6576113cd930391611281565b388080806113b5565b60405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606490fd5b6001600160a01b0390811691821561153857169182156114e7576000828152603360205260408120549180831061149357604082827fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef95876020965260338652038282205586815220818154019055604051908152a3565b60405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608490fd5b60405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608490fd5b91908203918211610e1b57565b9290606554906000926115b78560018060a01b03948886309216611ae1565b609754604080516370a0823160e01b808252306004830152919660209387168483602481845afa9283156116ee5782936116fc575b50803b156116f85781809160248c8c51948593849263b6b55f2560e01b845260048401525af180156116ee576116df575b508387609754169360248a518096819382523060048301525afa9081156116d457906116a5575b61164e925061158b565b820361169457918184936116857fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d797969484611b3a565b855197885287015216941692a3565b845163539aca2d60e01b8152600490fd5b508282813d83116116cd575b6116bb8183611097565b810103126101b05761164e9151611644565b503d6116b1565b8851903d90823e3d90fd5b6116e89061104b565b3861161d565b89513d84823e3d90fd5b5080fd5b9092508481813d8311611724575b6117148183611097565b810103126116f8575191386115ec565b503d61170a565b1561173257565b60405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b6064820152608490fd5b9394936001600160a01b03808416949381831693926117b69189918289880361198c575b505061199d565b60655491600097826040948551906370a0823160e01b90818352306004840152826024816020968794165afa918215611932578c92611959575b508b8660975416803b156116f857819060248a5180948193632e1a7d4d60e01b83528a60048401525af1801561194f5761193c575b5061183589868860655416611aa8565b82866065541691602489518094819382523060048301525afa908115611932578c91611905575b5081811161189b575b50507ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db95969798995084519788528701521693a4565b8b916118a69161158b565b8560975416803b1561190157602483928951948593849263b6b55f2560e01b845260048401525af180156118f7576118df575b80611865565b6118e98b9161104b565b6118f357896118d9565b8980fd5b86513d8d823e3d90fd5b8280fd5b90508281813d831161192b575b61191c8183611097565b810103126101b057513861185c565b503d611912565b87513d8e823e3d90fd5b611948909c919c61104b565b9a38611825565b88513d8f823e3d90fd5b9091508281813d8311611985575b6119718183611097565b81010312611981575190386117f0565b8b80fd5b503d611967565b6119969183611383565b38826117af565b6001600160a01b03168015611a595780600052603360205260406000205491808310611a09576020817fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef92600095858752603384520360408620558060355403603555604051908152a3565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608490fd5b60405163a9059cbb60e01b60208201526001600160a01b03909216602483015260448083019390935291815261127f916108c18261107b565b6040516323b872dd60e01b60208201526001600160a01b03928316602482015292909116604483015260648083019390935291815260a081019181831067ffffffffffffffff841117610ae25761127f92604052611c1e565b6001600160a01b0316908115611b99577fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef602082611b7c60009460355461124c565b6035558484526033825260408420818154019055604051908152a3565b60405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606490fd5b9190611beb828285611d16565b928215611c085709611bfa5790565b60018101809111610e1b5790565b634e487b7160e01b600052601260045260246000fd5b60018060a01b031690611c7d604051611c368161105f565b6020938482527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564858301526000808587829751910182855af1611c77611dd7565b91611e83565b805191821591848315611cef575b505050905015611c985750565b6084906040519062461bcd60e51b82526004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152fd5b9193818094500103126116f857820151908115158203611d13575080388084611c8b565b80fd5b916000198284099282810292838086109503948086039514611dc95784831115611d8c578291096001821901821680920460028082600302188083028203028083028203028083028203028083028203028083028203028092029003029360018380600003040190848311900302920304170290565b60405162461bcd60e51b81526020600482015260156024820152744d6174683a206d756c446976206f766572666c6f7760581b6044820152606490fd5b505080925015611c08570490565b3d15611e02573d90611de8826110b9565b91611df66040519384611097565b82523d6000602084013e565b606090565b90604051602081019063313ce56760e01b825260048152611e278161105f565b5160009384928392916001600160a01b03165afa611e43611dd7565b9080611e77575b611e54575b508190565b602081805181010312611901576020015160ff8111611e4f576001925060ff1690565b50602081511015611e4a565b91929015611ee55750815115611e97575090565b3b15611ea05790565b60405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606490fd5b825190915015611ef85750805190602001fd5b60405162461bcd60e51b8152908190611f149060048301610f81565b0390fdfe4a11f94e20a93c79f6ec743a1954ec4fc2c08429ae2122118bf234b2185c81b8a2646970667358221220440ac32a7b4a614faf68d39d0a3b9de0700e734a48b42c3167dd318671b6b6d664736f6c63430008170033a2646970667358221220d0ee7008df9f65d6cceede53630780370490954efc90dbbe8e3d979255d8d5d064736f6c63430008170033
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 34 Chains
Chain | Token | Portfolio % | Price | Amount | Value |
---|
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.