ETH Price: $2,397.29 (+7.26%)

Transaction Decoder

Block:
15651857 at Oct-01-2022 07:36:11 AM +UTC
Transaction Fee:
0.000957991003780419 ETH $2.30
Gas Used:
160,317 Gas / 5.975604607 Gwei

Emitted Events:

102 WETH9.Transfer( src=0x5e2474Ef1596ACEC4A7DB53E7f666dB1d1132afb, dst=[Receiver] AggregationRouterV4, wad=3754768136763227701 )
103 InitializedProxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x0000000000000000000000004000492bb9fdde20be1a4e4ef8a95282115bd5bd, 0x0000000000000000000000005e2474ef1596acec4a7db53e7f666db1d1132afb, 000000000000000000000000000000000000000000771d2fa45345aa90000000 )
104 InitializedProxy.0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925( 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925, 0x0000000000000000000000004000492bb9fdde20be1a4e4ef8a95282115bd5bd, 0x0000000000000000000000001111111254fb6c44bac0bed2854e76f90643097d, ffffffffffffffffffffffffffffffffffffffffff88e2d05bacba556fffffff )
105 0x5e2474ef1596acec4a7db53e7f666db1d1132afb.0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67( 0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67, 0x0000000000000000000000001111111254fb6c44bac0bed2854e76f90643097d, 0x0000000000000000000000001111111254fb6c44bac0bed2854e76f90643097d, ffffffffffffffffffffffffffffffffffffffffffffffffcbe46245f245c1cb, 000000000000000000000000000000000000000000771d2fa45345aa90000000, 0000000000000000000000000000000000001ae34072aab6c375bca995440089, 0000000000000000000000000000000000000000000015f3abff85d044a6c2ba, 000000000000000000000000000000000000000000000000000000000002b269 )
106 WETH9.Withdrawal( src=[Receiver] AggregationRouterV4, wad=3754768136763227701 )

Account State Difference:

  Address   Before After State Difference Code
0x4000492b...2115Bd5bD
4.830391245757266838 Eth
Nonce: 3706
8.58420139151671412 Eth
Nonce: 3707
3.753810145759447282
(Coinbase: MEV Builder)
0.036985734537386546 Eth0.037114320746264861 Eth0.000128586208878315
0x5e2474Ef...1d1132afb
(Uniswap V3: PEBBLE)
0xC02aaA39...83C756Cc2 4,062,457.511321778437067066 Eth4,062,453.756553641673839365 Eth3.754768136763227701
0xDC98c554...93D0aa4A8

Execution Trace

AggregationRouterV4.uniswapV3Swap( amount=144000000000000000000000000, minReturn=3735994296079411562, pools=[72370055773322622139731865630967400553959678351764882612435088142149281327867] ) => ( returnAmount=3754768136763227701 )
  • Uniswap V3: PEBBLE.128acb08( )
    • WETH9.transfer( dst=0x1111111254fb6c44bAC0beD2854e76F90643097d, wad=3754768136763227701 ) => ( True )
    • InitializedProxy.70a08231( )
      • TokenVault.balanceOf( account=0x5e2474Ef1596ACEC4A7DB53E7f666dB1d1132afb ) => ( 11827708138726306543023030205 )
      • AggregationRouterV4.uniswapV3SwapCallback( amount0Delta=-3754768136763227701, amount1Delta=144000000000000000000000000, 0x0000000000000000000000004000492BB9FDDE20BE1A4E4EF8A95282115BD5BD )
        • Uniswap V3: PEBBLE.STATICCALL( )
        • Uniswap V3: PEBBLE.STATICCALL( )
        • Uniswap V3: PEBBLE.STATICCALL( )
        • InitializedProxy.23b872dd( )
          • TokenVault.transferFrom( sender=0x4000492bB9fDDE20BE1a4E4Ef8a95282115Bd5bD, recipient=0x5e2474Ef1596ACEC4A7DB53E7f666dB1d1132afb, amount=144000000000000000000000000 ) => ( True )
          • InitializedProxy.70a08231( )
            • TokenVault.balanceOf( account=0x5e2474Ef1596ACEC4A7DB53E7f666dB1d1132afb ) => ( 11971708138726306543023030205 )
            • WETH9.withdraw( wad=3754768136763227701 )
              • ETH 3.754768136763227701 AggregationRouterV4.CALL( )
              • ETH 3.754768136763227701 0x4000492bb9fdde20be1a4e4ef8a95282115bd5bd.CALL( )
                File 1 of 4: AggregationRouterV4
                /*
                                                                           ,▄▓▓██▌   ,╓▄▄▓▓▓▓▓▓▓▓▄▄▄,,
                                                                        ,▓██▓███▓▄▓███▓╬╬╬╬╬╬╬╬╬╬╬╬╬▓███▓▄,
                                                                  ▄█   ▓██╬╣███████╬▓▀╬╬▓▓▓████████████▓█████▄,
                                                                 ▓██▌ ▓██╬╣██████╬▓▌  ██████████████████████▌╙╙▀ⁿ
                                                                ▐████████╬▓████▓▓█╨ ▄ ╟█████████▓▓╬╬╬╬╬▓▓█████▓▄
                                                  └▀▓▓▄╓        ╟█▓╣█████▓██████▀ ╓█▌ ███████▓▓▓▓▓╬╬╬╬╬╬╬╬╬╬╬╬▓██▓▄
                                                     └▀████▓▄╥  ▐██╬╬██████████╙ Æ▀─ ▓███▀╚╠╬╩▀▀███████▓▓╬╬╬╬╬╬╬╬╬██▄
                                                        └▀██▓▀▀█████▓╬▓██████▀     ▄█████▒╠"      └╙▓██████▓╬╬╬╬╬╬╬╬██▄
                                                           └▀██▄,└╙▀▀████▌└╙    ^"▀╙╙╙"╙██      @▄    ╙▀███████╬╬╬╬╬╬╬██µ
                                                              └▀██▓▄, ██▌       ╒       ╙█▓     ]▓█▓╔    ▀███████▓╬╬╬╬╬▓█▌
                                                                  ▀█████       ▓         ╟█▌    ]╠██▓░▒╓   ▀████████╬╬╬╬╣█▌
                                                                  ▐████      ╓█▀█▌      ,██▌    ╚Å███▓▒▒╠╓  ╙█████████╬╬╬╣█▌
                                                                  └████     ▓█░░▓█      ▀▀▀    φ▒╫████▒▒▒▒╠╓  █████████▓╬╬▓█µ
                                                                   ╘███µ ▌▄█▓▄▓▀`     ,▀    ,╔╠░▓██████▌╠▒▒▒φ  ██████████╬╬██
                                                                   ▐████µ╙▓▀`     ,▀╙,╔╔φφφ╠░▄▓███████▌░▓╙▒▒▒╠ └██╬███████╬▓█⌐
                                                                   ╫██ ▓▌         ▌φ▒▒░▓██████████████▌▒░▓╚▒▒▒╠ ▓██╬▓██████╣█▌
                                                                   ██▌           ▌╔▒▒▄████████████████▒▒▒░▌╠▒▒▒≥▐██▓╬╬███████▌
                                                                   ██▌      ,╓φ╠▓«▒▒▓████▀  ▀█████████▌▒▒▒╟░▒▒▒▒▐███╬╬╣████▓█▌
                                                                  ▐██      ╠▒▄▓▓███▓████└     ▀████████▌▒▒░▌╚▒▒▒▐███▓╬╬████ ╙▌
                                                                  ███  )  ╠▒░░░▒░╬████▀        └████████░▒▒░╬∩▒▒▓████╬╬╣███
                                                                 ▓██    ╠╠▒▒▐█▀▀▌`░╫██           ███████▒▒▒▒░▒▒½█████╬╬╣███
                                                                ███ ,█▄ ╠▒▒▒╫▌,▄▀,▒╫██           ╟██████▒▒▒░╣⌠▒▓█████╬╬╣██▌
                                                               ╘██µ ██` ╠▒▒░██╬φ╠▄▓██`            ██████░░▌φ╠░▓█████▓╬╬▓██
                                                                ╟██  .φ╠▒░▄█▀░░▄██▀└              █████▌▒╣φ▒░▓██████╬╬╣██
                                                                 ▀██▄▄▄╓▄███████▀                ▐█████░▓φ▒▄███████▓╬╣██
                                                                   ╙▀▀▀██▀└                      ████▓▄▀φ▄▓████████╬▓█▀
                                                                                                ▓███╬╩╔╣██████████▓██└
                                                                                              ╓████▀▄▓████████▀████▀
                                                                                            ,▓███████████████─]██╙
                                                                                         ,▄▓██████████████▀└  ╙
                                                                                    ,╓▄▓███████████████▀╙
                                                                             `"▀▀▀████████▀▀▀▀`▄███▀▀└
                                                                                              └└
                
                
                
                                    11\   11\                     11\             11\   11\            11\                                       11\
                                  1111 |  \__|                    11 |            111\  11 |           11 |                                      11 |
                                  \_11 |  11\ 1111111\   1111111\ 1111111\        1111\ 11 | 111111\ 111111\   11\  11\  11\  111111\   111111\  11 |  11\
                                    11 |  11 |11  __11\ 11  _____|11  __11\       11 11\11 |11  __11\\_11  _|  11 | 11 | 11 |11  __11\ 11  __11\ 11 | 11  |
                                    11 |  11 |11 |  11 |11 /      11 |  11 |      11 \1111 |11111111 | 11 |    11 | 11 | 11 |11 /  11 |11 |  \__|111111  /
                                    11 |  11 |11 |  11 |11 |      11 |  11 |      11 |\111 |11   ____| 11 |11\ 11 | 11 | 11 |11 |  11 |11 |      11  _11<
                                  111111\ 11 |11 |  11 |\1111111\ 11 |  11 |      11 | \11 |\1111111\  \1111  |\11111\1111  |\111111  |11 |      11 | \11\
                                  \______|\__|\__|  \__| \_______|\__|  \__|      \__|  \__| \_______|  \____/  \_____\____/  \______/ \__|      \__|  \__|
                
                
                
                                               111111\                                                               11\     11\
                                              11  __11\                                                              11 |    \__|
                                              11 /  11 | 111111\   111111\   111111\   111111\   111111\   111111\ 111111\   11\  111111\  1111111\
                                              11111111 |11  __11\ 11  __11\ 11  __11\ 11  __11\ 11  __11\  \____11\\_11  _|  11 |11  __11\ 11  __11\
                                              11  __11 |11 /  11 |11 /  11 |11 |  \__|11111111 |11 /  11 | 1111111 | 11 |    11 |11 /  11 |11 |  11 |
                                              11 |  11 |11 |  11 |11 |  11 |11 |      11   ____|11 |  11 |11  __11 | 11 |11\ 11 |11 |  11 |11 |  11 |
                                              11 |  11 |\1111111 |\1111111 |11 |      \1111111\ \1111111 |\1111111 | \1111  |11 |\111111  |11 |  11 |
                                              \__|  \__| \____11 | \____11 |\__|       \_______| \____11 | \_______|  \____/ \__| \______/ \__|  \__|
                                                        11\   11 |11\   11 |                    11\   11 |
                                                        \111111  |\111111  |                    \111111  |
                                                         \______/  \______/                      \______/
                                                                1111111\                        11\
                                                                11  __11\                       11 |
                                                                11 |  11 | 111111\  11\   11\ 111111\    111111\   111111\
                                                                1111111  |11  __11\ 11 |  11 |\_11  _|  11  __11\ 11  __11\
                                                                11  __11< 11 /  11 |11 |  11 |  11 |    11111111 |11 |  \__|
                                                                11 |  11 |11 |  11 |11 |  11 |  11 |11\ 11   ____|11 |
                                                                11 |  11 |\111111  |\111111  |  \1111  |\1111111\ 11 |
                                                                \__|  \__| \______/  \______/    \____/  \_______|\__|
                */
                
                // File @openzeppelin/contracts/utils/[email protected]
                
                // SPDX-License-Identifier: MIT
                
                pragma solidity >=0.6.0 <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 GSN 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 payable) {
                        return msg.sender;
                    }
                
                    function _msgData() internal view virtual returns (bytes memory) {
                        this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                        return msg.data;
                    }
                }
                
                
                // File @openzeppelin/contracts/access/[email protected]
                
                
                pragma solidity ^0.7.0;
                
                /**
                 * @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 Ownable is Context {
                    address private _owner;
                
                    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                
                    /**
                     * @dev Initializes the contract setting the deployer as the initial owner.
                     */
                    constructor () {
                        address msgSender = _msgSender();
                        _owner = msgSender;
                        emit OwnershipTransferred(address(0), msgSender);
                    }
                
                    /**
                     * @dev Returns the address of the current owner.
                     */
                    function owner() public view virtual returns (address) {
                        return _owner;
                    }
                
                    /**
                     * @dev Throws if called by any account other than the owner.
                     */
                    modifier onlyOwner() {
                        require(owner() == _msgSender(), "Ownable: caller is not the owner");
                        _;
                    }
                
                    /**
                     * @dev Leaves the contract without owner. It will not be possible to call
                     * `onlyOwner` functions anymore. Can only be called by the current owner.
                     *
                     * NOTE: Renouncing ownership will leave the contract without an owner,
                     * thereby removing any functionality that is only available to the owner.
                     */
                    function renounceOwnership() public virtual onlyOwner {
                        emit OwnershipTransferred(_owner, address(0));
                        _owner = 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");
                        emit OwnershipTransferred(_owner, newOwner);
                        _owner = newOwner;
                    }
                }
                
                
                // File @openzeppelin/contracts/token/ERC20/[email protected]
                
                
                pragma solidity ^0.7.0;
                
                /**
                 * @dev Interface of the ERC20 standard as defined in the EIP.
                 */
                interface IERC20 {
                    /**
                     * @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 `recipient`.
                     *
                     * Returns a boolean value indicating whether the operation succeeded.
                     *
                     * Emits a {Transfer} event.
                     */
                    function transfer(address recipient, 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 `sender` to `recipient` 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 sender, address recipient, uint256 amount) external returns (bool);
                
                    /**
                     * @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);
                }
                
                
                // File @openzeppelin/contracts/math/[email protected]
                
                
                pragma solidity ^0.7.0;
                
                /**
                 * @dev Wrappers over Solidity's arithmetic operations with added overflow
                 * checks.
                 *
                 * Arithmetic operations in Solidity wrap on overflow. This can easily result
                 * in bugs, because programmers usually assume that an overflow raises an
                 * error, which is the standard behavior in high level programming languages.
                 * `SafeMath` restores this intuition by reverting the transaction when an
                 * operation overflows.
                 *
                 * Using this library instead of the unchecked operations eliminates an entire
                 * class of bugs, so it's recommended to use it always.
                 */
                library SafeMath {
                    /**
                     * @dev Returns the addition of two unsigned integers, with an overflow flag.
                     *
                     * _Available since v3.4._
                     */
                    function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                        uint256 c = a + b;
                        if (c < a) return (false, 0);
                        return (true, c);
                    }
                
                    /**
                     * @dev Returns the substraction of two unsigned integers, with an overflow flag.
                     *
                     * _Available since v3.4._
                     */
                    function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                        if (b > a) return (false, 0);
                        return (true, a - b);
                    }
                
                    /**
                     * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
                     *
                     * _Available since v3.4._
                     */
                    function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                        // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                        // benefit is lost if 'b' is also tested.
                        // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                        if (a == 0) return (true, 0);
                        uint256 c = a * b;
                        if (c / a != b) return (false, 0);
                        return (true, c);
                    }
                
                    /**
                     * @dev Returns the division of two unsigned integers, with a division by zero flag.
                     *
                     * _Available since v3.4._
                     */
                    function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                        if (b == 0) return (false, 0);
                        return (true, a / b);
                    }
                
                    /**
                     * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
                     *
                     * _Available since v3.4._
                     */
                    function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                        if (b == 0) return (false, 0);
                        return (true, a % b);
                    }
                
                    /**
                     * @dev Returns the addition of two unsigned integers, reverting on
                     * overflow.
                     *
                     * Counterpart to Solidity's `+` operator.
                     *
                     * Requirements:
                     *
                     * - Addition cannot overflow.
                     */
                    function add(uint256 a, uint256 b) internal pure returns (uint256) {
                        uint256 c = a + b;
                        require(c >= a, "SafeMath: addition overflow");
                        return c;
                    }
                
                    /**
                     * @dev Returns the subtraction of two unsigned integers, reverting on
                     * overflow (when the result is negative).
                     *
                     * Counterpart to Solidity's `-` operator.
                     *
                     * Requirements:
                     *
                     * - Subtraction cannot overflow.
                     */
                    function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                        require(b <= a, "SafeMath: subtraction overflow");
                        return a - b;
                    }
                
                    /**
                     * @dev Returns the multiplication of two unsigned integers, reverting on
                     * overflow.
                     *
                     * Counterpart to Solidity's `*` operator.
                     *
                     * Requirements:
                     *
                     * - Multiplication cannot overflow.
                     */
                    function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                        if (a == 0) return 0;
                        uint256 c = a * b;
                        require(c / a == b, "SafeMath: multiplication overflow");
                        return c;
                    }
                
                    /**
                     * @dev Returns the integer division of two unsigned integers, reverting on
                     * division by zero. The result is rounded towards zero.
                     *
                     * Counterpart to Solidity's `/` operator. Note: this function uses a
                     * `revert` opcode (which leaves remaining gas untouched) while Solidity
                     * uses an invalid opcode to revert (consuming all remaining gas).
                     *
                     * Requirements:
                     *
                     * - The divisor cannot be zero.
                     */
                    function div(uint256 a, uint256 b) internal pure returns (uint256) {
                        require(b > 0, "SafeMath: division by zero");
                        return a / b;
                    }
                
                    /**
                     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                     * reverting when dividing by zero.
                     *
                     * Counterpart to Solidity's `%` operator. This function uses a `revert`
                     * opcode (which leaves remaining gas untouched) while Solidity uses an
                     * invalid opcode to revert (consuming all remaining gas).
                     *
                     * Requirements:
                     *
                     * - The divisor cannot be zero.
                     */
                    function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                        require(b > 0, "SafeMath: modulo by zero");
                        return a % b;
                    }
                
                    /**
                     * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
                     * overflow (when the result is negative).
                     *
                     * CAUTION: This function is deprecated because it requires allocating memory for the error
                     * message unnecessarily. For custom revert reasons use {trySub}.
                     *
                     * Counterpart to Solidity's `-` operator.
                     *
                     * Requirements:
                     *
                     * - Subtraction cannot overflow.
                     */
                    function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                        require(b <= a, errorMessage);
                        return a - b;
                    }
                
                    /**
                     * @dev Returns the integer division of two unsigned integers, reverting with custom message on
                     * division by zero. The result is rounded towards zero.
                     *
                     * CAUTION: This function is deprecated because it requires allocating memory for the error
                     * message unnecessarily. For custom revert reasons use {tryDiv}.
                     *
                     * Counterpart to Solidity's `/` operator. Note: this function uses a
                     * `revert` opcode (which leaves remaining gas untouched) while Solidity
                     * uses an invalid opcode to revert (consuming all remaining gas).
                     *
                     * Requirements:
                     *
                     * - The divisor cannot be zero.
                     */
                    function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                        require(b > 0, errorMessage);
                        return a / b;
                    }
                
                    /**
                     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                     * reverting with custom message when dividing by zero.
                     *
                     * CAUTION: This function is deprecated because it requires allocating memory for the error
                     * message unnecessarily. For custom revert reasons use {tryMod}.
                     *
                     * Counterpart to Solidity's `%` operator. This function uses a `revert`
                     * opcode (which leaves remaining gas untouched) while Solidity uses an
                     * invalid opcode to revert (consuming all remaining gas).
                     *
                     * Requirements:
                     *
                     * - The divisor cannot be zero.
                     */
                    function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                        require(b > 0, errorMessage);
                        return a % b;
                    }
                }
                
                
                // File @openzeppelin/contracts/utils/[email protected]
                
                
                pragma solidity ^0.7.0;
                
                /**
                 * @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
                     * ====
                     */
                    function isContract(address account) internal view returns (bool) {
                        // This method relies on extcodesize, which returns 0 for contracts in
                        // construction, since the code is only stored at the end of the
                        // constructor execution.
                
                        uint256 size;
                        // solhint-disable-next-line no-inline-assembly
                        assembly { size := extcodesize(account) }
                        return size > 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");
                
                        // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                        (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");
                
                        // solhint-disable-next-line avoid-low-level-calls
                        (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");
                
                        // solhint-disable-next-line avoid-low-level-calls
                        (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");
                
                        // solhint-disable-next-line avoid-low-level-calls
                        (bool success, bytes memory returndata) = target.delegatecall(data);
                        return _verifyCallResult(success, returndata, errorMessage);
                    }
                
                    function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private 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
                
                                // solhint-disable-next-line no-inline-assembly
                                assembly {
                                    let returndata_size := mload(returndata)
                                    revert(add(32, returndata), returndata_size)
                                }
                            } else {
                                revert(errorMessage);
                            }
                        }
                    }
                }
                
                
                // File @openzeppelin/contracts/token/ERC20/[email protected]
                
                
                pragma solidity ^0.7.0;
                
                
                
                /**
                 * @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 SafeMath for uint256;
                    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'
                        // solhint-disable-next-line max-line-length
                        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).add(value);
                        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                    }
                
                    function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                        uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
                        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                    }
                
                    /**
                     * @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
                            // solhint-disable-next-line max-line-length
                            require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                        }
                    }
                }
                
                
                // File contracts/helpers/EthReceiver.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Base contract with common payable logics
                abstract contract EthReceiver {
                    receive() external payable {
                        // solhint-disable-next-line avoid-tx-origin
                        require(msg.sender != tx.origin, "ETH deposit rejected");
                    }
                }
                
                
                // File @openzeppelin/contracts/drafts/[email protected]
                
                
                pragma solidity >=0.6.0 <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);
                }
                
                
                // File contracts/helpers/RevertReasonParser.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Library that allows to parse unsuccessful arbitrary calls revert reasons.
                /// See https://solidity.readthedocs.io/en/latest/control-structures.html#revert for details.
                /// Note that we assume revert reason being abi-encoded as Error(string) so it may fail to parse reason
                /// if structured reverts appear in the future.
                ///
                /// All unsuccessful parsings get encoded as Unknown(data) string
                library RevertReasonParser {
                    bytes4 constant private _PANIC_SELECTOR = bytes4(keccak256("Panic(uint256)"));
                    bytes4 constant private _ERROR_SELECTOR = bytes4(keccak256("Error(string)"));
                
                    function parse(bytes memory data, string memory prefix) internal pure returns (string memory) {
                        if (data.length >= 4) {
                            bytes4 selector;
                            assembly {  // solhint-disable-line no-inline-assembly
                                selector := mload(add(data, 0x20))
                            }
                
                            // 68 = 4-byte selector + 32 bytes offset + 32 bytes length
                            if (selector == _ERROR_SELECTOR && data.length >= 68) {
                                uint256 offset;
                                bytes memory reason;
                                // solhint-disable no-inline-assembly
                                assembly {
                                    // 36 = 32 bytes data length + 4-byte selector
                                    offset := mload(add(data, 36))
                                    reason := add(data, add(36, offset))
                                }
                                /*
                                    revert reason is padded up to 32 bytes with ABI encoder: Error(string)
                                    also sometimes there is extra 32 bytes of zeros padded in the end:
                                    https://github.com/ethereum/solidity/issues/10170
                                    because of that we can't check for equality and instead check
                                    that offset + string length + extra 36 bytes is less than overall data length
                                */
                                require(data.length >= 36 + offset + reason.length, "Invalid revert reason");
                                return string(abi.encodePacked(prefix, "Error(", reason, ")"));
                            }
                            // 36 = 4-byte selector + 32 bytes integer
                            else if (selector == _PANIC_SELECTOR && data.length == 36) {
                                uint256 code;
                                // solhint-disable no-inline-assembly
                                assembly {
                                    // 36 = 32 bytes data length + 4-byte selector
                                    code := mload(add(data, 36))
                                }
                                return string(abi.encodePacked(prefix, "Panic(", _toHex(code), ")"));
                            }
                        }
                
                        return string(abi.encodePacked(prefix, "Unknown(", _toHex(data), ")"));
                    }
                
                    function _toHex(uint256 value) private pure returns(string memory) {
                        return _toHex(abi.encodePacked(value));
                    }
                
                    function _toHex(bytes memory data) private pure returns(string memory) {
                        bytes16 alphabet = 0x30313233343536373839616263646566;
                        bytes memory str = new bytes(2 + data.length * 2);
                        str[0] = "0";
                        str[1] = "x";
                        for (uint256 i = 0; i < data.length; i++) {
                            str[2 * i + 2] = alphabet[uint8(data[i] >> 4)];
                            str[2 * i + 3] = alphabet[uint8(data[i] & 0x0f)];
                        }
                        return string(str);
                    }
                }
                
                
                // File contracts/interfaces/IDaiLikePermit.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Interface for DAI-style permits
                interface IDaiLikePermit {
                    function permit(address holder, address spender, uint256 nonce, uint256 expiry, bool allowed, uint8 v, bytes32 r, bytes32 s) external;
                }
                
                
                // File contracts/helpers/Permitable.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                /// @title Base contract with common permit handling logics
                contract Permitable {
                    function _permit(address token, bytes calldata permit) internal {
                        if (permit.length > 0) {
                            bool success;
                            bytes memory result;
                            if (permit.length == 32 * 7) {
                                // solhint-disable-next-line avoid-low-level-calls
                                (success, result) = token.call(abi.encodePacked(IERC20Permit.permit.selector, permit));
                            } else if (permit.length == 32 * 8) {
                                // solhint-disable-next-line avoid-low-level-calls
                                (success, result) = token.call(abi.encodePacked(IDaiLikePermit.permit.selector, permit));
                            } else {
                                revert("Wrong permit length");
                            }
                            if (!success) {
                                revert(RevertReasonParser.parse(result, "Permit failed: "));
                            }
                        }
                    }
                }
                
                
                // File contracts/helpers/UniERC20.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                
                library UniERC20 {
                    using SafeMath for uint256;
                    using SafeERC20 for IERC20;
                
                    IERC20 private constant _ETH_ADDRESS = IERC20(0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE);
                    IERC20 private constant _ZERO_ADDRESS = IERC20(0);
                
                    function isETH(IERC20 token) internal pure returns (bool) {
                        return (token == _ZERO_ADDRESS || token == _ETH_ADDRESS);
                    }
                
                    function uniBalanceOf(IERC20 token, address account) internal view returns (uint256) {
                        if (isETH(token)) {
                            return account.balance;
                        } else {
                            return token.balanceOf(account);
                        }
                    }
                
                    function uniTransfer(IERC20 token, address payable to, uint256 amount) internal {
                        if (amount > 0) {
                            if (isETH(token)) {
                                to.transfer(amount);
                            } else {
                                token.safeTransfer(to, amount);
                            }
                        }
                    }
                
                    function uniApprove(IERC20 token, address to, uint256 amount) internal {
                        require(!isETH(token), "Approve called on ETH");
                
                        // solhint-disable-next-line avoid-low-level-calls
                        (bool success, bytes memory returndata) = address(token).call(abi.encodeWithSelector(token.approve.selector, to, amount));
                
                        if (!success || (returndata.length > 0 && !abi.decode(returndata, (bool)))) {
                            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, to, 0));
                            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, to, amount));
                        }
                    }
                
                    function _callOptionalReturn(IERC20 token, bytes memory data) private {
                        // solhint-disable-next-line avoid-low-level-calls
                        (bool success, bytes memory result) = address(token).call(data);
                        if (!success) {
                            revert(RevertReasonParser.parse(result, "Low-level call failed: "));
                        }
                
                        if (result.length > 0) { // Return data is optional
                            require(abi.decode(result, (bool)), "ERC20 operation did not succeed");
                        }
                    }
                }
                
                
                // File contracts/interfaces/IAggregationExecutor.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Interface for making arbitrary calls during swap
                interface IAggregationExecutor {
                    /// @notice Make calls on `msgSender` with specified data
                    function callBytes(address msgSender, bytes calldata data) external payable;  // 0x2636f7f8
                }
                
                
                // File @openzeppelin/contracts/drafts/[email protected]
                
                
                pragma solidity >=0.6.0 <0.8.0;
                
                /**
                 * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.
                 *
                 * The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,
                 * thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding
                 * they need in their contracts using a combination of `abi.encode` and `keccak256`.
                 *
                 * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding
                 * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA
                 * ({_hashTypedDataV4}).
                 *
                 * The implementation of the domain separator was designed to be as efficient as possible while still properly updating
                 * the chain id to protect against replay attacks on an eventual fork of the chain.
                 *
                 * NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method
                 * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].
                 *
                 * _Available since v3.4._
                 */
                abstract contract EIP712 {
                    /* solhint-disable var-name-mixedcase */
                    // Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to
                    // invalidate the cached domain separator if the chain id changes.
                    bytes32 private immutable _CACHED_DOMAIN_SEPARATOR;
                    uint256 private immutable _CACHED_CHAIN_ID;
                
                    bytes32 private immutable _HASHED_NAME;
                    bytes32 private immutable _HASHED_VERSION;
                    bytes32 private immutable _TYPE_HASH;
                    /* solhint-enable var-name-mixedcase */
                
                    /**
                     * @dev Initializes the domain separator and parameter caches.
                     *
                     * The meaning of `name` and `version` is specified in
                     * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:
                     *
                     * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.
                     * - `version`: the current major version of the signing domain.
                     *
                     * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart
                     * contract upgrade].
                     */
                    constructor(string memory name, string memory version) {
                        bytes32 hashedName = keccak256(bytes(name));
                        bytes32 hashedVersion = keccak256(bytes(version));
                        bytes32 typeHash = keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");
                        _HASHED_NAME = hashedName;
                        _HASHED_VERSION = hashedVersion;
                        _CACHED_CHAIN_ID = _getChainId();
                        _CACHED_DOMAIN_SEPARATOR = _buildDomainSeparator(typeHash, hashedName, hashedVersion);
                        _TYPE_HASH = typeHash;
                    }
                
                    /**
                     * @dev Returns the domain separator for the current chain.
                     */
                    function _domainSeparatorV4() internal view virtual returns (bytes32) {
                        if (_getChainId() == _CACHED_CHAIN_ID) {
                            return _CACHED_DOMAIN_SEPARATOR;
                        } else {
                            return _buildDomainSeparator(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION);
                        }
                    }
                
                    function _buildDomainSeparator(bytes32 typeHash, bytes32 name, bytes32 version) private view returns (bytes32) {
                        return keccak256(
                            abi.encode(
                                typeHash,
                                name,
                                version,
                                _getChainId(),
                                address(this)
                            )
                        );
                    }
                
                    /**
                     * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
                     * function returns the hash of the fully encoded EIP712 message for this domain.
                     *
                     * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
                     *
                     * ```solidity
                     * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
                     *     keccak256("Mail(address to,string contents)"),
                     *     mailTo,
                     *     keccak256(bytes(mailContents))
                     * )));
                     * address signer = ECDSA.recover(digest, signature);
                     * ```
                     */
                    function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {
                        return keccak256(abi.encodePacked("\x19\x01", _domainSeparatorV4(), structHash));
                    }
                
                    function _getChainId() private view returns (uint256 chainId) {
                        this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                        // solhint-disable-next-line no-inline-assembly
                        assembly {
                            chainId := chainid()
                        }
                    }
                }
                
                
                // File contracts/helpers/ECDSA.sol
                
                
                pragma solidity ^0.7.6;
                
                /**
                 * @dev Simplified copy of OpenZeppelin ECDSA library downgraded to 0.7.6
                 * https://github.com/OpenZeppelin/openzeppelin-contracts/blob/541e82144f691aa171c53ba8c3b32ef7f05b99a5/contracts/utils/cryptography/ECDSA.sol
                 *
                 * Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
                 *
                 * These functions can be used to verify that a message was signed by the holder
                 * of the private keys of a given address.
                 */
                library ECDSA {
                    /**
                     * @dev Returns the address that signed a hashed message (`hash`) with
                     * `signature` or error string. This address can then be used for verification purposes.
                     *
                     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
                     * this function rejects them by requiring the `s` value to be in the lower
                     * half order, and the `v` value to be either 27 or 28.
                     *
                     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
                     * verification to be secure: it is possible to craft signatures that
                     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
                     * this is by receiving a hash of the original message (which may otherwise
                     * be too long), and then calling {toEthSignedMessageHash} on it.
                     *
                     * Documentation for signature generation:
                     * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
                     * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
                     *
                     * _Available since v4.3._
                     */
                    function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address) {
                        // Check the signature length
                        // - case 65: r,s,v signature (standard)
                        // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
                        if (signature.length == 65) {
                            bytes32 r;
                            bytes32 s;
                            uint8 v;
                            // ecrecover takes the signature parameters, and the only way to get them
                            // currently is to use assembly.
                            assembly {  // solhint-disable-line no-inline-assembly
                                r := mload(add(signature, 0x20))
                                s := mload(add(signature, 0x40))
                                v := byte(0, mload(add(signature, 0x60)))
                            }
                            return tryRecover(hash, v, r, s);
                        } else if (signature.length == 64) {
                            bytes32 r;
                            bytes32 vs;
                            // ecrecover takes the signature parameters, and the only way to get them
                            // currently is to use assembly.
                            assembly {  // solhint-disable-line no-inline-assembly
                                r := mload(add(signature, 0x20))
                                vs := mload(add(signature, 0x40))
                            }
                            return tryRecover(hash, r, vs);
                        } else {
                            return address(0);
                        }
                    }
                
                    /**
                     * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
                     *
                     * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
                     *
                     * _Available since v4.3._
                     */
                    function tryRecover(
                        bytes32 hash,
                        bytes32 r,
                        bytes32 vs
                    ) internal pure returns (address) {
                        bytes32 s;
                        uint8 v;
                        assembly {  // solhint-disable-line no-inline-assembly
                            s := and(vs, 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff)
                            v := add(shr(255, vs), 27)
                        }
                        return tryRecover(hash, v, r, s);
                    }
                
                    /**
                     * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
                     * `r` and `s` signature fields separately.
                     *
                     * _Available since v4.3._
                     */
                    function tryRecover(
                        bytes32 hash,
                        uint8 v,
                        bytes32 r,
                        bytes32 s
                    ) internal pure returns (address) {
                        // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                        // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                        // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
                        // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                        //
                        // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                        // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                        // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                        // these malleable signatures as well.
                        if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                            return address(0);
                        }
                        if (v != 27 && v != 28) {
                            return address(0);
                        }
                
                        // If the signature is valid (and not malleable), return the signer address
                        address signer = ecrecover(hash, v, r, s);
                        if (signer == address(0)) {
                            return address(0);
                        }
                
                        return signer;
                    }
                }
                
                
                // File contracts/interfaces/IERC1271.sol
                
                
                pragma solidity ^0.7.6;
                
                /**
                 * @dev Interface of the ERC1271 standard signature validation method for
                 * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].
                 */
                interface IERC1271 {
                    /**
                     * @dev Should return whether the signature provided is valid for the provided data
                     * @param hash      Hash of the data to be signed
                     * @param signature Signature byte array associated with _data
                     */
                    function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);
                }
                
                
                // File contracts/interfaces/IWETH.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Interface for WETH tokens
                interface IWETH is IERC20 {
                    function deposit() external payable;
                    function withdraw(uint256 amount) external;
                }
                
                
                // File contracts/LimitOrderProtocolRFQ.sol
                
                
                pragma solidity ^0.7.6;
                pragma abicoder v2;
                
                
                
                
                
                
                
                contract LimitOrderProtocolRFQ is EthReceiver, EIP712("1inch RFQ", "2"), Permitable {
                    using SafeMath for uint256;
                    using SafeERC20 for IERC20;
                
                    event OrderFilledRFQ(
                        bytes32 orderHash,
                        uint256 makingAmount
                    );
                
                    struct OrderRFQ {
                        // lowest 64 bits is the order id, next 64 bits is the expiration timestamp
                        // highest bit is unwrap WETH flag which is set on taker's side
                        // [unwrap eth(1 bit) | unused (127 bits) | expiration timestamp(64 bits) | orderId (64 bits)]
                        uint256 info;
                        IERC20 makerAsset;
                        IERC20 takerAsset;
                        address maker;
                        address allowedSender;  // equals to Zero address on public orders
                        uint256 makingAmount;
                        uint256 takingAmount;
                    }
                
                    bytes32 constant public LIMIT_ORDER_RFQ_TYPEHASH = keccak256(
                        "OrderRFQ(uint256 info,address makerAsset,address takerAsset,address maker,address allowedSender,uint256 makingAmount,uint256 takingAmount)"
                    );
                    uint256 private constant _UNWRAP_WETH_MASK = 1 << 255;
                
                    IWETH private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                    mapping(address => mapping(uint256 => uint256)) private _invalidator;
                
                    constructor(address weth) {
                        _WETH = IWETH(weth);
                    }
                
                    // solhint-disable-next-line func-name-mixedcase
                    function DOMAIN_SEPARATOR() external view returns(bytes32) {
                        return _domainSeparatorV4();
                    }
                
                    /// @notice Returns bitmask for double-spend invalidators based on lowest byte of order.info and filled quotes
                    /// @return Result Each bit represents whenever corresponding quote was filled
                    function invalidatorForOrderRFQ(address maker, uint256 slot) external view returns(uint256) {
                        return _invalidator[maker][slot];
                    }
                
                    /// @notice Cancels order's quote
                    function cancelOrderRFQ(uint256 orderInfo) external {
                        _invalidateOrder(msg.sender, orderInfo);
                    }
                
                    /// @notice Fills order's quote, fully or partially (whichever is possible)
                    /// @param order Order quote to fill
                    /// @param signature Signature to confirm quote ownership
                    /// @param makingAmount Making amount
                    /// @param takingAmount Taking amount
                    function fillOrderRFQ(
                        OrderRFQ memory order,
                        bytes calldata signature,
                        uint256 makingAmount,
                        uint256 takingAmount
                    ) external payable returns(uint256 /* actualMakingAmount */, uint256 /* actualTakingAmount */) {
                        return fillOrderRFQTo(order, signature, makingAmount, takingAmount, payable(msg.sender));
                    }
                
                    /// @notice Fills Same as `fillOrderRFQ` but calls permit first,
                    /// allowing to approve token spending and make a swap in one transaction.
                    /// Also allows to specify funds destination instead of `msg.sender`
                    /// @param order Order quote to fill
                    /// @param signature Signature to confirm quote ownership
                    /// @param makingAmount Making amount
                    /// @param takingAmount Taking amount
                    /// @param target Address that will receive swap funds
                    /// @param permit Should consist of abiencoded token address and encoded `IERC20Permit.permit` call.
                    /// See tests for examples
                    function fillOrderRFQToWithPermit(
                        OrderRFQ memory order,
                        bytes calldata signature,
                        uint256 makingAmount,
                        uint256 takingAmount,
                        address payable target,
                        bytes calldata permit
                    ) external returns(uint256 /* actualMakingAmount */, uint256 /* actualTakingAmount */) {
                        _permit(address(order.takerAsset), permit);
                        return fillOrderRFQTo(order, signature, makingAmount, takingAmount, target);
                    }
                
                    /// @notice Same as `fillOrderRFQ` but allows to specify funds destination instead of `msg.sender`
                    /// @param order Order quote to fill
                    /// @param signature Signature to confirm quote ownership
                    /// @param makingAmount Making amount
                    /// @param takingAmount Taking amount
                    /// @param target Address that will receive swap funds
                    function fillOrderRFQTo(
                        OrderRFQ memory order,
                        bytes calldata signature,
                        uint256 makingAmount,
                        uint256 takingAmount,
                        address payable target
                    ) public payable returns(uint256 /* actualMakingAmount */, uint256 /* actualTakingAmount */) {
                        address maker = order.maker;
                        bool unwrapWETH = (order.info & _UNWRAP_WETH_MASK) > 0;
                        order.info = order.info & (_UNWRAP_WETH_MASK - 1);  // zero-out unwrap weth flag as it is taker-only
                        {  // Stack too deep
                            uint256 info = order.info;
                            // Check time expiration
                            uint256 expiration = uint128(info) >> 64;
                            require(expiration == 0 || block.timestamp <= expiration, "LOP: order expired");  // solhint-disable-line not-rely-on-time
                            _invalidateOrder(maker, info);
                        }
                
                        {  // stack too deep
                            uint256 orderMakingAmount = order.makingAmount;
                            uint256 orderTakingAmount = order.takingAmount;
                            // Compute partial fill if needed
                            if (takingAmount == 0 && makingAmount == 0) {
                                // Two zeros means whole order
                                makingAmount = orderMakingAmount;
                                takingAmount = orderTakingAmount;
                            }
                            else if (takingAmount == 0) {
                                require(makingAmount <= orderMakingAmount, "LOP: making amount exceeded");
                                takingAmount = orderTakingAmount.mul(makingAmount).add(orderMakingAmount - 1).div(orderMakingAmount);
                            }
                            else if (makingAmount == 0) {
                                require(takingAmount <= orderTakingAmount, "LOP: taking amount exceeded");
                                makingAmount = orderMakingAmount.mul(takingAmount).div(orderTakingAmount);
                            }
                            else {
                                revert("LOP: one of amounts should be 0");
                            }
                        }
                
                        require(makingAmount > 0 && takingAmount > 0, "LOP: can't swap 0 amount");
                
                        // Validate order
                        require(order.allowedSender == address(0) || order.allowedSender == msg.sender, "LOP: private order");
                        bytes32 orderHash = _hashTypedDataV4(keccak256(abi.encode(LIMIT_ORDER_RFQ_TYPEHASH, order)));
                        _validate(maker, orderHash, signature);
                
                        // Maker => Taker
                        if (order.makerAsset == _WETH && unwrapWETH) {
                            order.makerAsset.safeTransferFrom(maker, address(this), makingAmount);
                            _WETH.withdraw(makingAmount);
                            target.transfer(makingAmount);
                        } else {
                            order.makerAsset.safeTransferFrom(maker, target, makingAmount);
                        }
                        // Taker => Maker
                        if (order.takerAsset == _WETH && msg.value > 0) {
                            require(msg.value == takingAmount, "LOP: wrong msg.value");
                            _WETH.deposit{ value: takingAmount }();
                            _WETH.transfer(maker, takingAmount);
                        } else {
                            require(msg.value == 0, "LOP: wrong msg.value");
                            order.takerAsset.safeTransferFrom(msg.sender, maker, takingAmount);
                        }
                
                        emit OrderFilledRFQ(orderHash, makingAmount);
                        return (makingAmount, takingAmount);
                    }
                
                    function _validate(address signer, bytes32 orderHash, bytes calldata signature) private view {
                        if (ECDSA.tryRecover(orderHash, signature) != signer) {
                            (bool success, bytes memory result) = signer.staticcall(
                                abi.encodeWithSelector(IERC1271.isValidSignature.selector, orderHash, signature)
                            );
                            require(success && result.length == 32 && abi.decode(result, (bytes4)) == IERC1271.isValidSignature.selector, "LOP: bad signature");
                        }
                    }
                
                    function _invalidateOrder(address maker, uint256 orderInfo) private {
                        uint256 invalidatorSlot = uint64(orderInfo) >> 8;
                        uint256 invalidatorBit = 1 << uint8(orderInfo);
                        mapping(uint256 => uint256) storage invalidatorStorage = _invalidator[maker];
                        uint256 invalidator = invalidatorStorage[invalidatorSlot];
                        require(invalidator & invalidatorBit == 0, "LOP: invalidated order");
                        invalidatorStorage[invalidatorSlot] = invalidator | invalidatorBit;
                    }
                }
                
                
                // File contracts/UnoswapRouter.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                contract UnoswapRouter is EthReceiver, Permitable {
                    uint256 private constant _TRANSFER_FROM_CALL_SELECTOR_32 = 0x23b872dd00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _WETH_DEPOSIT_CALL_SELECTOR_32 = 0xd0e30db000000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _WETH_WITHDRAW_CALL_SELECTOR_32 = 0x2e1a7d4d00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _ERC20_TRANSFER_CALL_SELECTOR_32 = 0xa9059cbb00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _ADDRESS_MASK =   0x000000000000000000000000ffffffffffffffffffffffffffffffffffffffff;
                    uint256 private constant _REVERSE_MASK =   0x8000000000000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _WETH_MASK =      0x4000000000000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _NUMERATOR_MASK = 0x0000000000000000ffffffff0000000000000000000000000000000000000000;
                    /// @dev WETH address is network-specific and needs to be changed before deployment.
                    /// It can not be moved to immutable as immutables are not supported in assembly
                    uint256 private constant _WETH = 0x000000000000000000000000C02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2;
                    uint256 private constant _UNISWAP_PAIR_RESERVES_CALL_SELECTOR_32 = 0x0902f1ac00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _UNISWAP_PAIR_SWAP_CALL_SELECTOR_32 = 0x022c0d9f00000000000000000000000000000000000000000000000000000000;
                    uint256 private constant _DENOMINATOR = 1000000000;
                    uint256 private constant _NUMERATOR_OFFSET = 160;
                
                    /// @notice Same as `unoswap` but calls permit first,
                    /// allowing to approve token spending and make a swap in one transaction.
                    /// @param srcToken Source token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    /// @param permit Should contain valid permit that can be used in `IERC20Permit.permit` calls.
                    /// See tests for examples
                    function unoswapWithPermit(
                        IERC20 srcToken,
                        uint256 amount,
                        uint256 minReturn,
                        bytes32[] calldata pools,
                        bytes calldata permit
                    ) external returns(uint256 returnAmount) {
                        _permit(address(srcToken), permit);
                        return unoswap(srcToken, amount, minReturn, pools);
                    }
                
                    /// @notice Performs swap using Uniswap exchange. Wraps and unwraps ETH if required.
                    /// Sending non-zero `msg.value` for anything but ETH swaps is prohibited
                    /// @param srcToken Source token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    function unoswap(
                        IERC20 srcToken,
                        uint256 amount,
                        uint256 minReturn,
                        // solhint-disable-next-line no-unused-vars
                        bytes32[] calldata pools
                    ) public payable returns(uint256 returnAmount) {
                        assembly {  // solhint-disable-line no-inline-assembly
                            function reRevert() {
                                returndatacopy(0, 0, returndatasize())
                                revert(0, returndatasize())
                            }
                
                            function revertWithReason(m, len) {
                                mstore(0, 0x08c379a000000000000000000000000000000000000000000000000000000000)
                                mstore(0x20, 0x0000002000000000000000000000000000000000000000000000000000000000)
                                mstore(0x40, m)
                                revert(0, len)
                            }
                
                            function swap(emptyPtr, swapAmount, pair, reversed, numerator, dst) -> ret {
                                mstore(emptyPtr, _UNISWAP_PAIR_RESERVES_CALL_SELECTOR_32)
                                if iszero(staticcall(gas(), pair, emptyPtr, 0x4, emptyPtr, 0x40)) {
                                    reRevert()
                                }
                                if iszero(eq(returndatasize(), 0x60)) {
                                    revertWithReason(0x0000001472657365727665732063616c6c206661696c65640000000000000000, 0x59)  // "reserves call failed"
                                }
                
                                let reserve0 := mload(emptyPtr)
                                let reserve1 := mload(add(emptyPtr, 0x20))
                                if reversed {
                                    let tmp := reserve0
                                    reserve0 := reserve1
                                    reserve1 := tmp
                                }
                                ret := mul(swapAmount, numerator)
                                ret := div(mul(ret, reserve1), add(ret, mul(reserve0, _DENOMINATOR)))
                
                                mstore(emptyPtr, _UNISWAP_PAIR_SWAP_CALL_SELECTOR_32)
                                switch reversed
                                case 0 {
                                    mstore(add(emptyPtr, 0x04), 0)
                                    mstore(add(emptyPtr, 0x24), ret)
                                }
                                default {
                                    mstore(add(emptyPtr, 0x04), ret)
                                    mstore(add(emptyPtr, 0x24), 0)
                                }
                                mstore(add(emptyPtr, 0x44), dst)
                                mstore(add(emptyPtr, 0x64), 0x80)
                                mstore(add(emptyPtr, 0x84), 0)
                                if iszero(call(gas(), pair, 0, emptyPtr, 0xa4, 0, 0)) {
                                    reRevert()
                                }
                            }
                
                            let emptyPtr := mload(0x40)
                            mstore(0x40, add(emptyPtr, 0xc0))
                
                            let poolsOffset := add(calldataload(0x64), 0x4)
                            let poolsEndOffset := calldataload(poolsOffset)
                            poolsOffset := add(poolsOffset, 0x20)
                            poolsEndOffset := add(poolsOffset, mul(0x20, poolsEndOffset))
                            let rawPair := calldataload(poolsOffset)
                            switch srcToken
                            case 0 {
                                if iszero(eq(amount, callvalue())) {
                                    revertWithReason(0x00000011696e76616c6964206d73672e76616c75650000000000000000000000, 0x55)  // "invalid msg.value"
                                }
                
                                mstore(emptyPtr, _WETH_DEPOSIT_CALL_SELECTOR_32)
                                if iszero(call(gas(), _WETH, amount, emptyPtr, 0x4, 0, 0)) {
                                    reRevert()
                                }
                
                                mstore(emptyPtr, _ERC20_TRANSFER_CALL_SELECTOR_32)
                                mstore(add(emptyPtr, 0x4), and(rawPair, _ADDRESS_MASK))
                                mstore(add(emptyPtr, 0x24), amount)
                                if iszero(call(gas(), _WETH, 0, emptyPtr, 0x44, 0, 0)) {
                                    reRevert()
                                }
                            }
                            default {
                                if callvalue() {
                                    revertWithReason(0x00000011696e76616c6964206d73672e76616c75650000000000000000000000, 0x55)  // "invalid msg.value"
                                }
                
                                mstore(emptyPtr, _TRANSFER_FROM_CALL_SELECTOR_32)
                                mstore(add(emptyPtr, 0x4), caller())
                                mstore(add(emptyPtr, 0x24), and(rawPair, _ADDRESS_MASK))
                                mstore(add(emptyPtr, 0x44), amount)
                                if iszero(call(gas(), srcToken, 0, emptyPtr, 0x64, 0, 0)) {
                                    reRevert()
                                }
                            }
                
                            returnAmount := amount
                
                            for {let i := add(poolsOffset, 0x20)} lt(i, poolsEndOffset) {i := add(i, 0x20)} {
                                let nextRawPair := calldataload(i)
                
                                returnAmount := swap(
                                    emptyPtr,
                                    returnAmount,
                                    and(rawPair, _ADDRESS_MASK),
                                    and(rawPair, _REVERSE_MASK),
                                    shr(_NUMERATOR_OFFSET, and(rawPair, _NUMERATOR_MASK)),
                                    and(nextRawPair, _ADDRESS_MASK)
                                )
                
                                rawPair := nextRawPair
                            }
                
                            switch and(rawPair, _WETH_MASK)
                            case 0 {
                                returnAmount := swap(
                                    emptyPtr,
                                    returnAmount,
                                    and(rawPair, _ADDRESS_MASK),
                                    and(rawPair, _REVERSE_MASK),
                                    shr(_NUMERATOR_OFFSET, and(rawPair, _NUMERATOR_MASK)),
                                    caller()
                                )
                            }
                            default {
                                returnAmount := swap(
                                    emptyPtr,
                                    returnAmount,
                                    and(rawPair, _ADDRESS_MASK),
                                    and(rawPair, _REVERSE_MASK),
                                    shr(_NUMERATOR_OFFSET, and(rawPair, _NUMERATOR_MASK)),
                                    address()
                                )
                
                                mstore(emptyPtr, _WETH_WITHDRAW_CALL_SELECTOR_32)
                                mstore(add(emptyPtr, 0x04), returnAmount)
                                if iszero(call(gas(), _WETH, 0, emptyPtr, 0x24, 0, 0)) {
                                    reRevert()
                                }
                
                                if iszero(call(gas(), caller(), returnAmount, 0, 0, 0, 0)) {
                                    reRevert()
                                }
                            }
                
                            if lt(returnAmount, minReturn) {
                                revertWithReason(0x000000164d696e2072657475726e206e6f742072656163686564000000000000, 0x5a)  // "Min return not reached"
                            }
                        }
                    }
                }
                
                
                // File @openzeppelin/contracts/utils/[email protected]
                
                
                pragma solidity ^0.7.0;
                
                
                /**
                 * @dev Wrappers over Solidity's uintXX/intXX casting operators with added overflow
                 * checks.
                 *
                 * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can
                 * easily result in undesired exploitation or bugs, since developers usually
                 * assume that overflows raise errors. `SafeCast` restores this intuition by
                 * reverting the transaction when such an operation overflows.
                 *
                 * Using this library instead of the unchecked operations eliminates an entire
                 * class of bugs, so it's recommended to use it always.
                 *
                 * Can be combined with {SafeMath} and {SignedSafeMath} to extend it to smaller types, by performing
                 * all math on `uint256` and `int256` and then downcasting.
                 */
                library SafeCast {
                
                    /**
                     * @dev Returns the downcasted uint128 from uint256, reverting on
                     * overflow (when the input is greater than largest uint128).
                     *
                     * Counterpart to Solidity's `uint128` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 128 bits
                     */
                    function toUint128(uint256 value) internal pure returns (uint128) {
                        require(value < 2**128, "SafeCast: value doesn\'t fit in 128 bits");
                        return uint128(value);
                    }
                
                    /**
                     * @dev Returns the downcasted uint64 from uint256, reverting on
                     * overflow (when the input is greater than largest uint64).
                     *
                     * Counterpart to Solidity's `uint64` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 64 bits
                     */
                    function toUint64(uint256 value) internal pure returns (uint64) {
                        require(value < 2**64, "SafeCast: value doesn\'t fit in 64 bits");
                        return uint64(value);
                    }
                
                    /**
                     * @dev Returns the downcasted uint32 from uint256, reverting on
                     * overflow (when the input is greater than largest uint32).
                     *
                     * Counterpart to Solidity's `uint32` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 32 bits
                     */
                    function toUint32(uint256 value) internal pure returns (uint32) {
                        require(value < 2**32, "SafeCast: value doesn\'t fit in 32 bits");
                        return uint32(value);
                    }
                
                    /**
                     * @dev Returns the downcasted uint16 from uint256, reverting on
                     * overflow (when the input is greater than largest uint16).
                     *
                     * Counterpart to Solidity's `uint16` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 16 bits
                     */
                    function toUint16(uint256 value) internal pure returns (uint16) {
                        require(value < 2**16, "SafeCast: value doesn\'t fit in 16 bits");
                        return uint16(value);
                    }
                
                    /**
                     * @dev Returns the downcasted uint8 from uint256, reverting on
                     * overflow (when the input is greater than largest uint8).
                     *
                     * Counterpart to Solidity's `uint8` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 8 bits.
                     */
                    function toUint8(uint256 value) internal pure returns (uint8) {
                        require(value < 2**8, "SafeCast: value doesn\'t fit in 8 bits");
                        return uint8(value);
                    }
                
                    /**
                     * @dev Converts a signed int256 into an unsigned uint256.
                     *
                     * Requirements:
                     *
                     * - input must be greater than or equal to 0.
                     */
                    function toUint256(int256 value) internal pure returns (uint256) {
                        require(value >= 0, "SafeCast: value must be positive");
                        return uint256(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int128 from int256, reverting on
                     * overflow (when the input is less than smallest int128 or
                     * greater than largest int128).
                     *
                     * Counterpart to Solidity's `int128` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 128 bits
                     *
                     * _Available since v3.1._
                     */
                    function toInt128(int256 value) internal pure returns (int128) {
                        require(value >= -2**127 && value < 2**127, "SafeCast: value doesn\'t fit in 128 bits");
                        return int128(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int64 from int256, reverting on
                     * overflow (when the input is less than smallest int64 or
                     * greater than largest int64).
                     *
                     * Counterpart to Solidity's `int64` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 64 bits
                     *
                     * _Available since v3.1._
                     */
                    function toInt64(int256 value) internal pure returns (int64) {
                        require(value >= -2**63 && value < 2**63, "SafeCast: value doesn\'t fit in 64 bits");
                        return int64(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int32 from int256, reverting on
                     * overflow (when the input is less than smallest int32 or
                     * greater than largest int32).
                     *
                     * Counterpart to Solidity's `int32` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 32 bits
                     *
                     * _Available since v3.1._
                     */
                    function toInt32(int256 value) internal pure returns (int32) {
                        require(value >= -2**31 && value < 2**31, "SafeCast: value doesn\'t fit in 32 bits");
                        return int32(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int16 from int256, reverting on
                     * overflow (when the input is less than smallest int16 or
                     * greater than largest int16).
                     *
                     * Counterpart to Solidity's `int16` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 16 bits
                     *
                     * _Available since v3.1._
                     */
                    function toInt16(int256 value) internal pure returns (int16) {
                        require(value >= -2**15 && value < 2**15, "SafeCast: value doesn\'t fit in 16 bits");
                        return int16(value);
                    }
                
                    /**
                     * @dev Returns the downcasted int8 from int256, reverting on
                     * overflow (when the input is less than smallest int8 or
                     * greater than largest int8).
                     *
                     * Counterpart to Solidity's `int8` operator.
                     *
                     * Requirements:
                     *
                     * - input must fit into 8 bits.
                     *
                     * _Available since v3.1._
                     */
                    function toInt8(int256 value) internal pure returns (int8) {
                        require(value >= -2**7 && value < 2**7, "SafeCast: value doesn\'t fit in 8 bits");
                        return int8(value);
                    }
                
                    /**
                     * @dev Converts an unsigned uint256 into a signed int256.
                     *
                     * Requirements:
                     *
                     * - input must be less than or equal to maxInt256.
                     */
                    function toInt256(uint256 value) internal pure returns (int256) {
                        require(value < 2**255, "SafeCast: value doesn't fit in an int256");
                        return int256(value);
                    }
                }
                
                
                // File contracts/interfaces/IUniswapV3Pool.sol
                
                pragma solidity ^0.7.6;
                
                interface IUniswapV3Pool {
                    /// @notice Swap token0 for token1, or token1 for token0
                    /// @dev The caller of this method receives a callback in the form of IUniswapV3SwapCallback#uniswapV3SwapCallback
                    /// @param recipient The address to receive the output of the swap
                    /// @param zeroForOne The direction of the swap, true for token0 to token1, false for token1 to token0
                    /// @param amountSpecified The amount of the swap, which implicitly configures the swap as exact input (positive), or exact output (negative)
                    /// @param sqrtPriceLimitX96 The Q64.96 sqrt price limit. If zero for one, the price cannot be less than this
                    /// value after the swap. If one for zero, the price cannot be greater than this value after the swap
                    /// @param data Any data to be passed through to the callback
                    /// @return amount0 The delta of the balance of token0 of the pool, exact when negative, minimum when positive
                    /// @return amount1 The delta of the balance of token1 of the pool, exact when negative, minimum when positive
                    function swap(
                        address recipient,
                        bool zeroForOne,
                        int256 amountSpecified,
                        uint160 sqrtPriceLimitX96,
                        bytes calldata data
                    ) external returns (int256 amount0, int256 amount1);
                
                    /// @notice The first of the two tokens of the pool, sorted by address
                    /// @return The token contract address
                    function token0() external view returns (address);
                
                    /// @notice The second of the two tokens of the pool, sorted by address
                    /// @return The token contract address
                    function token1() external view returns (address);
                
                    /// @notice The pool's fee in hundredths of a bip, i.e. 1e-6
                    /// @return The fee
                    function fee() external view returns (uint24);
                }
                
                
                // File contracts/interfaces/IUniswapV3SwapCallback.sol
                
                pragma solidity ^0.7.6;
                
                /// @title Callback for IUniswapV3PoolActions#swap
                /// @notice Any contract that calls IUniswapV3PoolActions#swap must implement this interface
                interface IUniswapV3SwapCallback {
                    /// @notice Called to `msg.sender` after executing a swap via IUniswapV3Pool#swap.
                    /// @dev In the implementation you must pay the pool tokens owed for the swap.
                    /// The caller of this method must be checked to be a UniswapV3Pool deployed by the canonical UniswapV3Factory.
                    /// amount0Delta and amount1Delta can both be 0 if no tokens were swapped.
                    /// @param amount0Delta The amount of token0 that was sent (negative) or must be received (positive) by the pool by
                    /// the end of the swap. If positive, the callback must send that amount of token0 to the pool.
                    /// @param amount1Delta The amount of token1 that was sent (negative) or must be received (positive) by the pool by
                    /// the end of the swap. If positive, the callback must send that amount of token1 to the pool.
                    /// @param data Any data passed through by the caller via the IUniswapV3PoolActions#swap call
                    function uniswapV3SwapCallback(
                        int256 amount0Delta,
                        int256 amount1Delta,
                        bytes calldata data
                    ) external;
                }
                
                
                // File contracts/UnoswapV3Router.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                
                
                
                
                
                
                contract UnoswapV3Router is EthReceiver, Permitable, IUniswapV3SwapCallback {
                    using Address for address payable;
                    using SafeERC20 for IERC20;
                    using SafeMath for uint256;
                
                    uint256 private constant _ONE_FOR_ZERO_MASK = 1 << 255;
                    uint256 private constant _WETH_WRAP_MASK = 1 << 254;
                    uint256 private constant _WETH_UNWRAP_MASK = 1 << 253;
                    bytes32 private constant _POOL_INIT_CODE_HASH = 0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54;
                    bytes32 private constant _FF_FACTORY = 0xff1F98431c8aD98523631AE4a59f267346ea31F9840000000000000000000000;
                    bytes32 private constant _SELECTORS = 0x0dfe1681d21220a7ddca3f430000000000000000000000000000000000000000;
                    uint256 private constant _ADDRESS_MASK =   0x000000000000000000000000ffffffffffffffffffffffffffffffffffffffff;
                    /// @dev The minimum value that can be returned from #getSqrtRatioAtTick. Equivalent to getSqrtRatioAtTick(MIN_TICK)
                    uint160 private constant _MIN_SQRT_RATIO = 4295128739 + 1;
                    /// @dev The maximum value that can be returned from #getSqrtRatioAtTick. Equivalent to getSqrtRatioAtTick(MAX_TICK)
                    uint160 private constant _MAX_SQRT_RATIO = 1461446703485210103287273052203988822378723970342 - 1;
                    IWETH private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                
                    constructor(address weth) {
                        _WETH = IWETH(weth);
                    }
                
                    /// @notice Same as `uniswapV3SwapTo` but calls permit first,
                    /// allowing to approve token spending and make a swap in one transaction.
                    /// @param recipient Address that will receive swap funds
                    /// @param srcToken Source token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    /// @param permit Should contain valid permit that can be used in `IERC20Permit.permit` calls.
                    /// See tests for examples
                    function uniswapV3SwapToWithPermit(
                        address payable recipient,
                        IERC20 srcToken,
                        uint256 amount,
                        uint256 minReturn,
                        uint256[] calldata pools,
                        bytes calldata permit
                    ) external returns(uint256 returnAmount) {
                        _permit(address(srcToken), permit);
                        return uniswapV3SwapTo(recipient, amount, minReturn, pools);
                    }
                
                    /// @notice Same as `uniswapV3SwapTo` but uses `msg.sender` as recipient
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    function uniswapV3Swap(
                        uint256 amount,
                        uint256 minReturn,
                        uint256[] calldata pools
                    ) external payable returns(uint256 returnAmount) {
                        return uniswapV3SwapTo(msg.sender, amount, minReturn, pools);
                    }
                
                    /// @notice Performs swap using Uniswap V3 exchange. Wraps and unwraps ETH if required.
                    /// Sending non-zero `msg.value` for anything but ETH swaps is prohibited
                    /// @param recipient Address that will receive swap funds
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param pools Pools chain used for swaps. Pools src and dst tokens should match to make swap happen
                    function uniswapV3SwapTo(
                        address payable recipient,
                        uint256 amount,
                        uint256 minReturn,
                        uint256[] calldata pools
                    ) public payable returns(uint256 returnAmount) {
                        uint256 len = pools.length;
                        require(len > 0, "UNIV3R: empty pools");
                        uint256 lastIndex = len - 1;
                        returnAmount = amount;
                        bool wrapWeth = pools[0] & _WETH_WRAP_MASK > 0;
                        bool unwrapWeth = pools[lastIndex] & _WETH_UNWRAP_MASK > 0;
                        if (wrapWeth) {
                            require(msg.value == amount, "UNIV3R: wrong msg.value");
                            _WETH.deposit{value: amount}();
                        } else {
                            require(msg.value == 0, "UNIV3R: msg.value should be 0");
                        }
                        if (len > 1) {
                            returnAmount = _makeSwap(address(this), wrapWeth ? address(this) : msg.sender, pools[0], returnAmount);
                
                            for (uint256 i = 1; i < lastIndex; i++) {
                                returnAmount = _makeSwap(address(this), address(this), pools[i], returnAmount);
                            }
                            returnAmount = _makeSwap(unwrapWeth ? address(this) : recipient, address(this), pools[lastIndex], returnAmount);
                        } else {
                            returnAmount = _makeSwap(unwrapWeth ? address(this) : recipient, wrapWeth ? address(this) : msg.sender, pools[0], returnAmount);
                        }
                
                        require(returnAmount >= minReturn, "UNIV3R: min return");
                
                        if (unwrapWeth) {
                            _WETH.withdraw(returnAmount);
                            recipient.sendValue(returnAmount);
                        }
                    }
                
                    /// @inheritdoc IUniswapV3SwapCallback
                    function uniswapV3SwapCallback(
                        int256 amount0Delta,
                        int256 amount1Delta,
                        bytes calldata /* data */
                    ) external override {
                        IERC20 token0;
                        IERC20 token1;
                        bytes32 ffFactoryAddress = _FF_FACTORY;
                        bytes32 poolInitCodeHash = _POOL_INIT_CODE_HASH;
                        address payer;
                
                        assembly {  // solhint-disable-line no-inline-assembly
                            function reRevert() {
                                returndatacopy(0, 0, returndatasize())
                                revert(0, returndatasize())
                            }
                
                            function revertWithReason(m, len) {
                                mstore(0x00, 0x08c379a000000000000000000000000000000000000000000000000000000000)
                                mstore(0x20, 0x0000002000000000000000000000000000000000000000000000000000000000)
                                mstore(0x40, m)
                                revert(0, len)
                            }
                
                            let emptyPtr := mload(0x40)
                            let resultPtr := add(emptyPtr, 0x20)
                            mstore(emptyPtr, _SELECTORS)
                
                            if iszero(staticcall(gas(), caller(), emptyPtr, 0x4, resultPtr, 0x20)) {
                                reRevert()
                            }
                            token0 := mload(resultPtr)
                            if iszero(staticcall(gas(), caller(), add(emptyPtr, 0x4), 0x4, resultPtr, 0x20)) {
                                reRevert()
                            }
                            token1 := mload(resultPtr)
                            if iszero(staticcall(gas(), caller(), add(emptyPtr, 0x8), 0x4, resultPtr, 0x20)) {
                                reRevert()
                            }
                            let fee := mload(resultPtr)
                
                            let p := emptyPtr
                            mstore(p, ffFactoryAddress)
                            p := add(p, 21)
                            // Compute the inner hash in-place
                            mstore(p, token0)
                            mstore(add(p, 32), token1)
                            mstore(add(p, 64), fee)
                            mstore(p, keccak256(p, 96))
                            p := add(p, 32)
                            mstore(p, poolInitCodeHash)
                            let pool := and(keccak256(emptyPtr, 85), _ADDRESS_MASK)
                
                            if iszero(eq(pool, caller())) {
                                revertWithReason(0x00000010554e495633523a2062616420706f6f6c000000000000000000000000, 0x54)  // UNIV3R: bad pool
                            }
                
                            calldatacopy(emptyPtr, 0x84, 0x20)
                            payer := mload(emptyPtr)
                        }
                
                        if (amount0Delta > 0) {
                            if (payer == address(this)) {
                                token0.safeTransfer(msg.sender, uint256(amount0Delta));
                            } else {
                                token0.safeTransferFrom(payer, msg.sender, uint256(amount0Delta));
                            }
                        }
                        if (amount1Delta > 0) {
                            if (payer == address(this)) {
                                token1.safeTransfer(msg.sender, uint256(amount1Delta));
                            } else {
                                token1.safeTransferFrom(payer, msg.sender, uint256(amount1Delta));
                            }
                        }
                    }
                
                    function _makeSwap(address recipient, address payer, uint256 pool, uint256 amount) private returns (uint256) {
                        bool zeroForOne = pool & _ONE_FOR_ZERO_MASK == 0;
                        if (zeroForOne) {
                            (, int256 amount1) = IUniswapV3Pool(pool).swap(
                                recipient,
                                zeroForOne,
                                SafeCast.toInt256(amount),
                                _MIN_SQRT_RATIO,
                                abi.encode(payer)
                            );
                            return SafeCast.toUint256(-amount1);
                        } else {
                            (int256 amount0,) = IUniswapV3Pool(pool).swap(
                                recipient,
                                zeroForOne,
                                SafeCast.toInt256(amount),
                                _MAX_SQRT_RATIO,
                                abi.encode(payer)
                            );
                            return SafeCast.toUint256(-amount0);
                        }
                    }
                }
                
                
                // File contracts/interfaces/IClipperExchangeInterface.sol
                
                
                pragma solidity ^0.7.6;
                
                /// @title Clipper interface subset used in swaps
                interface IClipperExchangeInterface {
                    function sellTokenForToken(IERC20 inputToken, IERC20 outputToken, address recipient, uint256 minBuyAmount, bytes calldata auxiliaryData) external returns (uint256 boughtAmount);
                    function sellEthForToken(IERC20 outputToken, address recipient, uint256 minBuyAmount, bytes calldata auxiliaryData) external payable returns (uint256 boughtAmount);
                    function sellTokenForEth(IERC20 inputToken, address payable recipient, uint256 minBuyAmount, bytes calldata auxiliaryData) external returns (uint256 boughtAmount);
                    function theExchange() external returns (address payable);
                }
                
                
                // File contracts/ClipperRouter.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                
                
                
                /// @title Clipper router that allows to use `ClipperExchangeInterface` for swaps
                contract ClipperRouter is EthReceiver, Permitable {
                    using SafeERC20 for IERC20;
                
                    IWETH private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                    IERC20 private constant _ETH = IERC20(address(0));
                    bytes private constant _INCH_TAG = "1INCH";
                    IClipperExchangeInterface private immutable _clipperExchange;
                    address payable private immutable _clipperPool;
                
                    constructor(
                        address weth,
                        IClipperExchangeInterface clipperExchange
                    ) {
                        _clipperExchange = clipperExchange;
                        _clipperPool = clipperExchange.theExchange();
                        _WETH = IWETH(weth);
                    }
                
                    /// @notice Same as `clipperSwapTo` but calls permit first,
                    /// allowing to approve token spending and make a swap in one transaction.
                    /// @param recipient Address that will receive swap funds
                    /// @param srcToken Source token
                    /// @param dstToken Destination token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    /// @param permit Should contain valid permit that can be used in `IERC20Permit.permit` calls.
                    /// See tests for examples
                    function clipperSwapToWithPermit(
                        address payable recipient,
                        IERC20 srcToken,
                        IERC20 dstToken,
                        uint256 amount,
                        uint256 minReturn,
                        bytes calldata permit
                    ) external returns(uint256 returnAmount) {
                        _permit(address(srcToken), permit);
                        return clipperSwapTo(recipient, srcToken, dstToken, amount, minReturn);
                    }
                
                    /// @notice Same as `clipperSwapTo` but uses `msg.sender` as recipient
                    /// @param srcToken Source token
                    /// @param dstToken Destination token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    function clipperSwap(
                        IERC20 srcToken,
                        IERC20 dstToken,
                        uint256 amount,
                        uint256 minReturn
                    ) external payable returns(uint256 returnAmount) {
                        return clipperSwapTo(msg.sender, srcToken, dstToken, amount, minReturn);
                    }
                
                    /// @notice Performs swap using Clipper exchange. Wraps and unwraps ETH if required.
                    /// Sending non-zero `msg.value` for anything but ETH swaps is prohibited
                    /// @param recipient Address that will receive swap funds
                    /// @param srcToken Source token
                    /// @param dstToken Destination token
                    /// @param amount Amount of source tokens to swap
                    /// @param minReturn Minimal allowed returnAmount to make transaction commit
                    function clipperSwapTo(
                        address payable recipient,
                        IERC20 srcToken,
                        IERC20 dstToken,
                        uint256 amount,
                        uint256 minReturn
                    ) public payable returns(uint256 returnAmount) {
                        bool srcETH;
                        if (srcToken == _WETH) {
                            require(msg.value == 0, "CL1IN: msg.value should be 0");
                            _WETH.transferFrom(msg.sender, address(this), amount);
                            _WETH.withdraw(amount);
                            srcETH = true;
                        }
                        else if (srcToken == _ETH) {
                            require(msg.value == amount, "CL1IN: wrong msg.value");
                            srcETH = true;
                        }
                        else {
                            require(msg.value == 0, "CL1IN: msg.value should be 0");
                            srcToken.safeTransferFrom(msg.sender, _clipperPool, amount);
                        }
                
                        if (srcETH) {
                            _clipperPool.transfer(amount);
                            returnAmount = _clipperExchange.sellEthForToken(dstToken, recipient, minReturn, _INCH_TAG);
                        } else if (dstToken == _WETH) {
                            returnAmount = _clipperExchange.sellTokenForEth(srcToken, address(this), minReturn, _INCH_TAG);
                            _WETH.deposit{ value: returnAmount }();
                            _WETH.transfer(recipient, returnAmount);
                        } else if (dstToken == _ETH) {
                            returnAmount = _clipperExchange.sellTokenForEth(srcToken, recipient, minReturn, _INCH_TAG);
                        } else {
                            returnAmount = _clipperExchange.sellTokenForToken(srcToken, dstToken, recipient, minReturn, _INCH_TAG);
                        }
                    }
                }
                
                
                // File contracts/AggregationRouterV4.sol
                
                
                pragma solidity ^0.7.6;
                
                
                
                contract AggregationRouterV4 is Ownable, EthReceiver, Permitable, UnoswapRouter, UnoswapV3Router, LimitOrderProtocolRFQ, ClipperRouter {
                    using SafeMath for uint256;
                    using UniERC20 for IERC20;
                    using SafeERC20 for IERC20;
                
                    uint256 private constant _PARTIAL_FILL = 1 << 0;
                    uint256 private constant _REQUIRES_EXTRA_ETH = 1 << 1;
                
                    struct SwapDescription {
                        IERC20 srcToken;
                        IERC20 dstToken;
                        address payable srcReceiver;
                        address payable dstReceiver;
                        uint256 amount;
                        uint256 minReturnAmount;
                        uint256 flags;
                        bytes permit;
                    }
                
                    constructor(address weth, IClipperExchangeInterface _clipperExchange)
                        UnoswapV3Router(weth)
                        LimitOrderProtocolRFQ(weth)
                        ClipperRouter(weth, _clipperExchange)
                    {}  // solhint-disable-line no-empty-blocks
                
                    /// @notice Performs a swap, delegating all calls encoded in `data` to `caller`. See tests for usage examples
                    /// @param caller Aggregation executor that executes calls described in `data`
                    /// @param desc Swap description
                    /// @param data Encoded calls that `caller` should execute in between of swaps
                    /// @return returnAmount Resulting token amount
                    /// @return spentAmount Source token amount
                    /// @return gasLeft Gas left
                    function swap(
                        IAggregationExecutor caller,
                        SwapDescription calldata desc,
                        bytes calldata data
                    )
                        external
                        payable
                        returns (
                            uint256 returnAmount,
                            uint256 spentAmount,
                            uint256 gasLeft
                        )
                    {
                        require(desc.minReturnAmount > 0, "Min return should not be 0");
                        require(data.length > 0, "data should not be empty");
                
                        uint256 flags = desc.flags;
                        IERC20 srcToken = desc.srcToken;
                        IERC20 dstToken = desc.dstToken;
                
                        bool srcETH = srcToken.isETH();
                        if (flags & _REQUIRES_EXTRA_ETH != 0) {
                            require(msg.value > (srcETH ? desc.amount : 0), "Invalid msg.value");
                        } else {
                            require(msg.value == (srcETH ? desc.amount : 0), "Invalid msg.value");
                        }
                
                        if (!srcETH) {
                            _permit(address(srcToken), desc.permit);
                            srcToken.safeTransferFrom(msg.sender, desc.srcReceiver, desc.amount);
                        }
                
                        {
                            bytes memory callData = abi.encodePacked(caller.callBytes.selector, bytes12(0), msg.sender, data);
                            // solhint-disable-next-line avoid-low-level-calls
                            (bool success, bytes memory result) = address(caller).call{value: msg.value}(callData);
                            if (!success) {
                                revert(RevertReasonParser.parse(result, "callBytes failed: "));
                            }
                        }
                
                        spentAmount = desc.amount;
                        returnAmount = dstToken.uniBalanceOf(address(this));
                
                        if (flags & _PARTIAL_FILL != 0) {
                            uint256 unspentAmount = srcToken.uniBalanceOf(address(this));
                            if (unspentAmount > 0) {
                                spentAmount = spentAmount.sub(unspentAmount);
                                srcToken.uniTransfer(msg.sender, unspentAmount);
                            }
                            require(returnAmount.mul(desc.amount) >= desc.minReturnAmount.mul(spentAmount), "Return amount is not enough");
                        } else {
                            require(returnAmount >= desc.minReturnAmount, "Return amount is not enough");
                        }
                
                        address payable dstReceiver = (desc.dstReceiver == address(0)) ? msg.sender : desc.dstReceiver;
                        dstToken.uniTransfer(dstReceiver, returnAmount);
                
                        gasLeft = gasleft();
                    }
                
                    function rescueFunds(IERC20 token, uint256 amount) external onlyOwner {
                        token.uniTransfer(msg.sender, amount);
                    }
                
                    function destroy() external onlyOwner {
                        selfdestruct(msg.sender);
                    }
                }

                File 2 of 4: WETH9
                // Copyright (C) 2015, 2016, 2017 Dapphub
                
                // This program is free software: you can redistribute it and/or modify
                // it under the terms of the GNU General Public License as published by
                // the Free Software Foundation, either version 3 of the License, or
                // (at your option) any later version.
                
                // This program is distributed in the hope that it will be useful,
                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                // GNU General Public License for more details.
                
                // You should have received a copy of the GNU General Public License
                // along with this program.  If not, see <http://www.gnu.org/licenses/>.
                
                pragma solidity ^0.4.18;
                
                contract WETH9 {
                    string public name     = "Wrapped Ether";
                    string public symbol   = "WETH";
                    uint8  public decimals = 18;
                
                    event  Approval(address indexed src, address indexed guy, uint wad);
                    event  Transfer(address indexed src, address indexed dst, uint wad);
                    event  Deposit(address indexed dst, uint wad);
                    event  Withdrawal(address indexed src, uint wad);
                
                    mapping (address => uint)                       public  balanceOf;
                    mapping (address => mapping (address => uint))  public  allowance;
                
                    function() public payable {
                        deposit();
                    }
                    function deposit() public payable {
                        balanceOf[msg.sender] += msg.value;
                        Deposit(msg.sender, msg.value);
                    }
                    function withdraw(uint wad) public {
                        require(balanceOf[msg.sender] >= wad);
                        balanceOf[msg.sender] -= wad;
                        msg.sender.transfer(wad);
                        Withdrawal(msg.sender, wad);
                    }
                
                    function totalSupply() public view returns (uint) {
                        return this.balance;
                    }
                
                    function approve(address guy, uint wad) public returns (bool) {
                        allowance[msg.sender][guy] = wad;
                        Approval(msg.sender, guy, wad);
                        return true;
                    }
                
                    function transfer(address dst, uint wad) public returns (bool) {
                        return transferFrom(msg.sender, dst, wad);
                    }
                
                    function transferFrom(address src, address dst, uint wad)
                        public
                        returns (bool)
                    {
                        require(balanceOf[src] >= wad);
                
                        if (src != msg.sender && allowance[src][msg.sender] != uint(-1)) {
                            require(allowance[src][msg.sender] >= wad);
                            allowance[src][msg.sender] -= wad;
                        }
                
                        balanceOf[src] -= wad;
                        balanceOf[dst] += wad;
                
                        Transfer(src, dst, wad);
                
                        return true;
                    }
                }
                
                
                /*
                                    GNU GENERAL PUBLIC LICENSE
                                       Version 3, 29 June 2007
                
                 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
                 Everyone is permitted to copy and distribute verbatim copies
                 of this license document, but changing it is not allowed.
                
                                            Preamble
                
                  The GNU General Public License is a free, copyleft license for
                software and other kinds of works.
                
                  The licenses for most software and other practical works are designed
                to take away your freedom to share and change the works.  By contrast,
                the GNU General Public License is intended to guarantee your freedom to
                share and change all versions of a program--to make sure it remains free
                software for all its users.  We, the Free Software Foundation, use the
                GNU General Public License for most of our software; it applies also to
                any other work released this way by its authors.  You can apply it to
                your programs, too.
                
                  When we speak of free software, we are referring to freedom, not
                price.  Our General Public Licenses are designed to make sure that you
                have the freedom to distribute copies of free software (and charge for
                them if you wish), that you receive source code or can get it if you
                want it, that you can change the software or use pieces of it in new
                free programs, and that you know you can do these things.
                
                  To protect your rights, we need to prevent others from denying you
                these rights or asking you to surrender the rights.  Therefore, you have
                certain responsibilities if you distribute copies of the software, or if
                you modify it: responsibilities to respect the freedom of others.
                
                  For example, if you distribute copies of such a program, whether
                gratis or for a fee, you must pass on to the recipients the same
                freedoms that you received.  You must make sure that they, too, receive
                or can get the source code.  And you must show them these terms so they
                know their rights.
                
                  Developers that use the GNU GPL protect your rights with two steps:
                (1) assert copyright on the software, and (2) offer you this License
                giving you legal permission to copy, distribute and/or modify it.
                
                  For the developers' and authors' protection, the GPL clearly explains
                that there is no warranty for this free software.  For both users' and
                authors' sake, the GPL requires that modified versions be marked as
                changed, so that their problems will not be attributed erroneously to
                authors of previous versions.
                
                  Some devices are designed to deny users access to install or run
                modified versions of the software inside them, although the manufacturer
                can do so.  This is fundamentally incompatible with the aim of
                protecting users' freedom to change the software.  The systematic
                pattern of such abuse occurs in the area of products for individuals to
                use, which is precisely where it is most unacceptable.  Therefore, we
                have designed this version of the GPL to prohibit the practice for those
                products.  If such problems arise substantially in other domains, we
                stand ready to extend this provision to those domains in future versions
                of the GPL, as needed to protect the freedom of users.
                
                  Finally, every program is threatened constantly by software patents.
                States should not allow patents to restrict development and use of
                software on general-purpose computers, but in those that do, we wish to
                avoid the special danger that patents applied to a free program could
                make it effectively proprietary.  To prevent this, the GPL assures that
                patents cannot be used to render the program non-free.
                
                  The precise terms and conditions for copying, distribution and
                modification follow.
                
                                       TERMS AND CONDITIONS
                
                  0. Definitions.
                
                  "This License" refers to version 3 of the GNU General Public License.
                
                  "Copyright" also means copyright-like laws that apply to other kinds of
                works, such as semiconductor masks.
                
                  "The Program" refers to any copyrightable work licensed under this
                License.  Each licensee is addressed as "you".  "Licensees" and
                "recipients" may be individuals or organizations.
                
                  To "modify" a work means to copy from or adapt all or part of the work
                in a fashion requiring copyright permission, other than the making of an
                exact copy.  The resulting work is called a "modified version" of the
                earlier work or a work "based on" the earlier work.
                
                  A "covered work" means either the unmodified Program or a work based
                on the Program.
                
                  To "propagate" a work means to do anything with it that, without
                permission, would make you directly or secondarily liable for
                infringement under applicable copyright law, except executing it on a
                computer or modifying a private copy.  Propagation includes copying,
                distribution (with or without modification), making available to the
                public, and in some countries other activities as well.
                
                  To "convey" a work means any kind of propagation that enables other
                parties to make or receive copies.  Mere interaction with a user through
                a computer network, with no transfer of a copy, is not conveying.
                
                  An interactive user interface displays "Appropriate Legal Notices"
                to the extent that it includes a convenient and prominently visible
                feature that (1) displays an appropriate copyright notice, and (2)
                tells the user that there is no warranty for the work (except to the
                extent that warranties are provided), that licensees may convey the
                work under this License, and how to view a copy of this License.  If
                the interface presents a list of user commands or options, such as a
                menu, a prominent item in the list meets this criterion.
                
                  1. Source Code.
                
                  The "source code" for a work means the preferred form of the work
                for making modifications to it.  "Object code" means any non-source
                form of a work.
                
                  A "Standard Interface" means an interface that either is an official
                standard defined by a recognized standards body, or, in the case of
                interfaces specified for a particular programming language, one that
                is widely used among developers working in that language.
                
                  The "System Libraries" of an executable work include anything, other
                than the work as a whole, that (a) is included in the normal form of
                packaging a Major Component, but which is not part of that Major
                Component, and (b) serves only to enable use of the work with that
                Major Component, or to implement a Standard Interface for which an
                implementation is available to the public in source code form.  A
                "Major Component", in this context, means a major essential component
                (kernel, window system, and so on) of the specific operating system
                (if any) on which the executable work runs, or a compiler used to
                produce the work, or an object code interpreter used to run it.
                
                  The "Corresponding Source" for a work in object code form means all
                the source code needed to generate, install, and (for an executable
                work) run the object code and to modify the work, including scripts to
                control those activities.  However, it does not include the work's
                System Libraries, or general-purpose tools or generally available free
                programs which are used unmodified in performing those activities but
                which are not part of the work.  For example, Corresponding Source
                includes interface definition files associated with source files for
                the work, and the source code for shared libraries and dynamically
                linked subprograms that the work is specifically designed to require,
                such as by intimate data communication or control flow between those
                subprograms and other parts of the work.
                
                  The Corresponding Source need not include anything that users
                can regenerate automatically from other parts of the Corresponding
                Source.
                
                  The Corresponding Source for a work in source code form is that
                same work.
                
                  2. Basic Permissions.
                
                  All rights granted under this License are granted for the term of
                copyright on the Program, and are irrevocable provided the stated
                conditions are met.  This License explicitly affirms your unlimited
                permission to run the unmodified Program.  The output from running a
                covered work is covered by this License only if the output, given its
                content, constitutes a covered work.  This License acknowledges your
                rights of fair use or other equivalent, as provided by copyright law.
                
                  You may make, run and propagate covered works that you do not
                convey, without conditions so long as your license otherwise remains
                in force.  You may convey covered works to others for the sole purpose
                of having them make modifications exclusively for you, or provide you
                with facilities for running those works, provided that you comply with
                the terms of this License in conveying all material for which you do
                not control copyright.  Those thus making or running the covered works
                for you must do so exclusively on your behalf, under your direction
                and control, on terms that prohibit them from making any copies of
                your copyrighted material outside their relationship with you.
                
                  Conveying under any other circumstances is permitted solely under
                the conditions stated below.  Sublicensing is not allowed; section 10
                makes it unnecessary.
                
                  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
                
                  No covered work shall be deemed part of an effective technological
                measure under any applicable law fulfilling obligations under article
                11 of the WIPO copyright treaty adopted on 20 December 1996, or
                similar laws prohibiting or restricting circumvention of such
                measures.
                
                  When you convey a covered work, you waive any legal power to forbid
                circumvention of technological measures to the extent such circumvention
                is effected by exercising rights under this License with respect to
                the covered work, and you disclaim any intention to limit operation or
                modification of the work as a means of enforcing, against the work's
                users, your or third parties' legal rights to forbid circumvention of
                technological measures.
                
                  4. Conveying Verbatim Copies.
                
                  You may convey verbatim copies of the Program's source code as you
                receive it, in any medium, provided that you conspicuously and
                appropriately publish on each copy an appropriate copyright notice;
                keep intact all notices stating that this License and any
                non-permissive terms added in accord with section 7 apply to the code;
                keep intact all notices of the absence of any warranty; and give all
                recipients a copy of this License along with the Program.
                
                  You may charge any price or no price for each copy that you convey,
                and you may offer support or warranty protection for a fee.
                
                  5. Conveying Modified Source Versions.
                
                  You may convey a work based on the Program, or the modifications to
                produce it from the Program, in the form of source code under the
                terms of section 4, provided that you also meet all of these conditions:
                
                    a) The work must carry prominent notices stating that you modified
                    it, and giving a relevant date.
                
                    b) The work must carry prominent notices stating that it is
                    released under this License and any conditions added under section
                    7.  This requirement modifies the requirement in section 4 to
                    "keep intact all notices".
                
                    c) You must license the entire work, as a whole, under this
                    License to anyone who comes into possession of a copy.  This
                    License will therefore apply, along with any applicable section 7
                    additional terms, to the whole of the work, and all its parts,
                    regardless of how they are packaged.  This License gives no
                    permission to license the work in any other way, but it does not
                    invalidate such permission if you have separately received it.
                
                    d) If the work has interactive user interfaces, each must display
                    Appropriate Legal Notices; however, if the Program has interactive
                    interfaces that do not display Appropriate Legal Notices, your
                    work need not make them do so.
                
                  A compilation of a covered work with other separate and independent
                works, which are not by their nature extensions of the covered work,
                and which are not combined with it such as to form a larger program,
                in or on a volume of a storage or distribution medium, is called an
                "aggregate" if the compilation and its resulting copyright are not
                used to limit the access or legal rights of the compilation's users
                beyond what the individual works permit.  Inclusion of a covered work
                in an aggregate does not cause this License to apply to the other
                parts of the aggregate.
                
                  6. Conveying Non-Source Forms.
                
                  You may convey a covered work in object code form under the terms
                of sections 4 and 5, provided that you also convey the
                machine-readable Corresponding Source under the terms of this License,
                in one of these ways:
                
                    a) Convey the object code in, or embodied in, a physical product
                    (including a physical distribution medium), accompanied by the
                    Corresponding Source fixed on a durable physical medium
                    customarily used for software interchange.
                
                    b) Convey the object code in, or embodied in, a physical product
                    (including a physical distribution medium), accompanied by a
                    written offer, valid for at least three years and valid for as
                    long as you offer spare parts or customer support for that product
                    model, to give anyone who possesses the object code either (1) a
                    copy of the Corresponding Source for all the software in the
                    product that is covered by this License, on a durable physical
                    medium customarily used for software interchange, for a price no
                    more than your reasonable cost of physically performing this
                    conveying of source, or (2) access to copy the
                    Corresponding Source from a network server at no charge.
                
                    c) Convey individual copies of the object code with a copy of the
                    written offer to provide the Corresponding Source.  This
                    alternative is allowed only occasionally and noncommercially, and
                    only if you received the object code with such an offer, in accord
                    with subsection 6b.
                
                    d) Convey the object code by offering access from a designated
                    place (gratis or for a charge), and offer equivalent access to the
                    Corresponding Source in the same way through the same place at no
                    further charge.  You need not require recipients to copy the
                    Corresponding Source along with the object code.  If the place to
                    copy the object code is a network server, the Corresponding Source
                    may be on a different server (operated by you or a third party)
                    that supports equivalent copying facilities, provided you maintain
                    clear directions next to the object code saying where to find the
                    Corresponding Source.  Regardless of what server hosts the
                    Corresponding Source, you remain obligated to ensure that it is
                    available for as long as needed to satisfy these requirements.
                
                    e) Convey the object code using peer-to-peer transmission, provided
                    you inform other peers where the object code and Corresponding
                    Source of the work are being offered to the general public at no
                    charge under subsection 6d.
                
                  A separable portion of the object code, whose source code is excluded
                from the Corresponding Source as a System Library, need not be
                included in conveying the object code work.
                
                  A "User Product" is either (1) a "consumer product", which means any
                tangible personal property which is normally used for personal, family,
                or household purposes, or (2) anything designed or sold for incorporation
                into a dwelling.  In determining whether a product is a consumer product,
                doubtful cases shall be resolved in favor of coverage.  For a particular
                product received by a particular user, "normally used" refers to a
                typical or common use of that class of product, regardless of the status
                of the particular user or of the way in which the particular user
                actually uses, or expects or is expected to use, the product.  A product
                is a consumer product regardless of whether the product has substantial
                commercial, industrial or non-consumer uses, unless such uses represent
                the only significant mode of use of the product.
                
                  "Installation Information" for a User Product means any methods,
                procedures, authorization keys, or other information required to install
                and execute modified versions of a covered work in that User Product from
                a modified version of its Corresponding Source.  The information must
                suffice to ensure that the continued functioning of the modified object
                code is in no case prevented or interfered with solely because
                modification has been made.
                
                  If you convey an object code work under this section in, or with, or
                specifically for use in, a User Product, and the conveying occurs as
                part of a transaction in which the right of possession and use of the
                User Product is transferred to the recipient in perpetuity or for a
                fixed term (regardless of how the transaction is characterized), the
                Corresponding Source conveyed under this section must be accompanied
                by the Installation Information.  But this requirement does not apply
                if neither you nor any third party retains the ability to install
                modified object code on the User Product (for example, the work has
                been installed in ROM).
                
                  The requirement to provide Installation Information does not include a
                requirement to continue to provide support service, warranty, or updates
                for a work that has been modified or installed by the recipient, or for
                the User Product in which it has been modified or installed.  Access to a
                network may be denied when the modification itself materially and
                adversely affects the operation of the network or violates the rules and
                protocols for communication across the network.
                
                  Corresponding Source conveyed, and Installation Information provided,
                in accord with this section must be in a format that is publicly
                documented (and with an implementation available to the public in
                source code form), and must require no special password or key for
                unpacking, reading or copying.
                
                  7. Additional Terms.
                
                  "Additional permissions" are terms that supplement the terms of this
                License by making exceptions from one or more of its conditions.
                Additional permissions that are applicable to the entire Program shall
                be treated as though they were included in this License, to the extent
                that they are valid under applicable law.  If additional permissions
                apply only to part of the Program, that part may be used separately
                under those permissions, but the entire Program remains governed by
                this License without regard to the additional permissions.
                
                  When you convey a copy of a covered work, you may at your option
                remove any additional permissions from that copy, or from any part of
                it.  (Additional permissions may be written to require their own
                removal in certain cases when you modify the work.)  You may place
                additional permissions on material, added by you to a covered work,
                for which you have or can give appropriate copyright permission.
                
                  Notwithstanding any other provision of this License, for material you
                add to a covered work, you may (if authorized by the copyright holders of
                that material) supplement the terms of this License with terms:
                
                    a) Disclaiming warranty or limiting liability differently from the
                    terms of sections 15 and 16 of this License; or
                
                    b) Requiring preservation of specified reasonable legal notices or
                    author attributions in that material or in the Appropriate Legal
                    Notices displayed by works containing it; or
                
                    c) Prohibiting misrepresentation of the origin of that material, or
                    requiring that modified versions of such material be marked in
                    reasonable ways as different from the original version; or
                
                    d) Limiting the use for publicity purposes of names of licensors or
                    authors of the material; or
                
                    e) Declining to grant rights under trademark law for use of some
                    trade names, trademarks, or service marks; or
                
                    f) Requiring indemnification of licensors and authors of that
                    material by anyone who conveys the material (or modified versions of
                    it) with contractual assumptions of liability to the recipient, for
                    any liability that these contractual assumptions directly impose on
                    those licensors and authors.
                
                  All other non-permissive additional terms are considered "further
                restrictions" within the meaning of section 10.  If the Program as you
                received it, or any part of it, contains a notice stating that it is
                governed by this License along with a term that is a further
                restriction, you may remove that term.  If a license document contains
                a further restriction but permits relicensing or conveying under this
                License, you may add to a covered work material governed by the terms
                of that license document, provided that the further restriction does
                not survive such relicensing or conveying.
                
                  If you add terms to a covered work in accord with this section, you
                must place, in the relevant source files, a statement of the
                additional terms that apply to those files, or a notice indicating
                where to find the applicable terms.
                
                  Additional terms, permissive or non-permissive, may be stated in the
                form of a separately written license, or stated as exceptions;
                the above requirements apply either way.
                
                  8. Termination.
                
                  You may not propagate or modify a covered work except as expressly
                provided under this License.  Any attempt otherwise to propagate or
                modify it is void, and will automatically terminate your rights under
                this License (including any patent licenses granted under the third
                paragraph of section 11).
                
                  However, if you cease all violation of this License, then your
                license from a particular copyright holder is reinstated (a)
                provisionally, unless and until the copyright holder explicitly and
                finally terminates your license, and (b) permanently, if the copyright
                holder fails to notify you of the violation by some reasonable means
                prior to 60 days after the cessation.
                
                  Moreover, your license from a particular copyright holder is
                reinstated permanently if the copyright holder notifies you of the
                violation by some reasonable means, this is the first time you have
                received notice of violation of this License (for any work) from that
                copyright holder, and you cure the violation prior to 30 days after
                your receipt of the notice.
                
                  Termination of your rights under this section does not terminate the
                licenses of parties who have received copies or rights from you under
                this License.  If your rights have been terminated and not permanently
                reinstated, you do not qualify to receive new licenses for the same
                material under section 10.
                
                  9. Acceptance Not Required for Having Copies.
                
                  You are not required to accept this License in order to receive or
                run a copy of the Program.  Ancillary propagation of a covered work
                occurring solely as a consequence of using peer-to-peer transmission
                to receive a copy likewise does not require acceptance.  However,
                nothing other than this License grants you permission to propagate or
                modify any covered work.  These actions infringe copyright if you do
                not accept this License.  Therefore, by modifying or propagating a
                covered work, you indicate your acceptance of this License to do so.
                
                  10. Automatic Licensing of Downstream Recipients.
                
                  Each time you convey a covered work, the recipient automatically
                receives a license from the original licensors, to run, modify and
                propagate that work, subject to this License.  You are not responsible
                for enforcing compliance by third parties with this License.
                
                  An "entity transaction" is a transaction transferring control of an
                organization, or substantially all assets of one, or subdividing an
                organization, or merging organizations.  If propagation of a covered
                work results from an entity transaction, each party to that
                transaction who receives a copy of the work also receives whatever
                licenses to the work the party's predecessor in interest had or could
                give under the previous paragraph, plus a right to possession of the
                Corresponding Source of the work from the predecessor in interest, if
                the predecessor has it or can get it with reasonable efforts.
                
                  You may not impose any further restrictions on the exercise of the
                rights granted or affirmed under this License.  For example, you may
                not impose a license fee, royalty, or other charge for exercise of
                rights granted under this License, and you may not initiate litigation
                (including a cross-claim or counterclaim in a lawsuit) alleging that
                any patent claim is infringed by making, using, selling, offering for
                sale, or importing the Program or any portion of it.
                
                  11. Patents.
                
                  A "contributor" is a copyright holder who authorizes use under this
                License of the Program or a work on which the Program is based.  The
                work thus licensed is called the contributor's "contributor version".
                
                  A contributor's "essential patent claims" are all patent claims
                owned or controlled by the contributor, whether already acquired or
                hereafter acquired, that would be infringed by some manner, permitted
                by this License, of making, using, or selling its contributor version,
                but do not include claims that would be infringed only as a
                consequence of further modification of the contributor version.  For
                purposes of this definition, "control" includes the right to grant
                patent sublicenses in a manner consistent with the requirements of
                this License.
                
                  Each contributor grants you a non-exclusive, worldwide, royalty-free
                patent license under the contributor's essential patent claims, to
                make, use, sell, offer for sale, import and otherwise run, modify and
                propagate the contents of its contributor version.
                
                  In the following three paragraphs, a "patent license" is any express
                agreement or commitment, however denominated, not to enforce a patent
                (such as an express permission to practice a patent or covenant not to
                sue for patent infringement).  To "grant" such a patent license to a
                party means to make such an agreement or commitment not to enforce a
                patent against the party.
                
                  If you convey a covered work, knowingly relying on a patent license,
                and the Corresponding Source of the work is not available for anyone
                to copy, free of charge and under the terms of this License, through a
                publicly available network server or other readily accessible means,
                then you must either (1) cause the Corresponding Source to be so
                available, or (2) arrange to deprive yourself of the benefit of the
                patent license for this particular work, or (3) arrange, in a manner
                consistent with the requirements of this License, to extend the patent
                license to downstream recipients.  "Knowingly relying" means you have
                actual knowledge that, but for the patent license, your conveying the
                covered work in a country, or your recipient's use of the covered work
                in a country, would infringe one or more identifiable patents in that
                country that you have reason to believe are valid.
                
                  If, pursuant to or in connection with a single transaction or
                arrangement, you convey, or propagate by procuring conveyance of, a
                covered work, and grant a patent license to some of the parties
                receiving the covered work authorizing them to use, propagate, modify
                or convey a specific copy of the covered work, then the patent license
                you grant is automatically extended to all recipients of the covered
                work and works based on it.
                
                  A patent license is "discriminatory" if it does not include within
                the scope of its coverage, prohibits the exercise of, or is
                conditioned on the non-exercise of one or more of the rights that are
                specifically granted under this License.  You may not convey a covered
                work if you are a party to an arrangement with a third party that is
                in the business of distributing software, under which you make payment
                to the third party based on the extent of your activity of conveying
                the work, and under which the third party grants, to any of the
                parties who would receive the covered work from you, a discriminatory
                patent license (a) in connection with copies of the covered work
                conveyed by you (or copies made from those copies), or (b) primarily
                for and in connection with specific products or compilations that
                contain the covered work, unless you entered into that arrangement,
                or that patent license was granted, prior to 28 March 2007.
                
                  Nothing in this License shall be construed as excluding or limiting
                any implied license or other defenses to infringement that may
                otherwise be available to you under applicable patent law.
                
                  12. No Surrender of Others' Freedom.
                
                  If conditions are imposed on you (whether by court order, agreement or
                otherwise) that contradict the conditions of this License, they do not
                excuse you from the conditions of this License.  If you cannot convey a
                covered work so as to satisfy simultaneously your obligations under this
                License and any other pertinent obligations, then as a consequence you may
                not convey it at all.  For example, if you agree to terms that obligate you
                to collect a royalty for further conveying from those to whom you convey
                the Program, the only way you could satisfy both those terms and this
                License would be to refrain entirely from conveying the Program.
                
                  13. Use with the GNU Affero General Public License.
                
                  Notwithstanding any other provision of this License, you have
                permission to link or combine any covered work with a work licensed
                under version 3 of the GNU Affero General Public License into a single
                combined work, and to convey the resulting work.  The terms of this
                License will continue to apply to the part which is the covered work,
                but the special requirements of the GNU Affero General Public License,
                section 13, concerning interaction through a network will apply to the
                combination as such.
                
                  14. Revised Versions of this License.
                
                  The Free Software Foundation may publish revised and/or new versions of
                the GNU General Public License from time to time.  Such new versions will
                be similar in spirit to the present version, but may differ in detail to
                address new problems or concerns.
                
                  Each version is given a distinguishing version number.  If the
                Program specifies that a certain numbered version of the GNU General
                Public License "or any later version" applies to it, you have the
                option of following the terms and conditions either of that numbered
                version or of any later version published by the Free Software
                Foundation.  If the Program does not specify a version number of the
                GNU General Public License, you may choose any version ever published
                by the Free Software Foundation.
                
                  If the Program specifies that a proxy can decide which future
                versions of the GNU General Public License can be used, that proxy's
                public statement of acceptance of a version permanently authorizes you
                to choose that version for the Program.
                
                  Later license versions may give you additional or different
                permissions.  However, no additional obligations are imposed on any
                author or copyright holder as a result of your choosing to follow a
                later version.
                
                  15. Disclaimer of Warranty.
                
                  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
                APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
                HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
                OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
                THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
                PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
                IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
                ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
                
                  16. Limitation of Liability.
                
                  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
                WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
                THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
                GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
                USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
                DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
                PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
                EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
                SUCH DAMAGES.
                
                  17. Interpretation of Sections 15 and 16.
                
                  If the disclaimer of warranty and limitation of liability provided
                above cannot be given local legal effect according to their terms,
                reviewing courts shall apply local law that most closely approximates
                an absolute waiver of all civil liability in connection with the
                Program, unless a warranty or assumption of liability accompanies a
                copy of the Program in return for a fee.
                
                                     END OF TERMS AND CONDITIONS
                
                            How to Apply These Terms to Your New Programs
                
                  If you develop a new program, and you want it to be of the greatest
                possible use to the public, the best way to achieve this is to make it
                free software which everyone can redistribute and change under these terms.
                
                  To do so, attach the following notices to the program.  It is safest
                to attach them to the start of each source file to most effectively
                state the exclusion of warranty; and each file should have at least
                the "copyright" line and a pointer to where the full notice is found.
                
                    <one line to give the program's name and a brief idea of what it does.>
                    Copyright (C) <year>  <name of author>
                
                    This program is free software: you can redistribute it and/or modify
                    it under the terms of the GNU General Public License as published by
                    the Free Software Foundation, either version 3 of the License, or
                    (at your option) any later version.
                
                    This program is distributed in the hope that it will be useful,
                    but WITHOUT ANY WARRANTY; without even the implied warranty of
                    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                    GNU General Public License for more details.
                
                    You should have received a copy of the GNU General Public License
                    along with this program.  If not, see <http://www.gnu.org/licenses/>.
                
                Also add information on how to contact you by electronic and paper mail.
                
                  If the program does terminal interaction, make it output a short
                notice like this when it starts in an interactive mode:
                
                    <program>  Copyright (C) <year>  <name of author>
                    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
                    This is free software, and you are welcome to redistribute it
                    under certain conditions; type `show c' for details.
                
                The hypothetical commands `show w' and `show c' should show the appropriate
                parts of the General Public License.  Of course, your program's commands
                might be different; for a GUI interface, you would use an "about box".
                
                  You should also get your employer (if you work as a programmer) or school,
                if any, to sign a "copyright disclaimer" for the program, if necessary.
                For more information on this, and how to apply and follow the GNU GPL, see
                <http://www.gnu.org/licenses/>.
                
                  The GNU General Public License does not permit incorporating your program
                into proprietary programs.  If your program is a subroutine library, you
                may consider it more useful to permit linking proprietary applications with
                the library.  If this is what you want to do, use the GNU Lesser General
                Public License instead of this License.  But first, please read
                <http://www.gnu.org/philosophy/why-not-lgpl.html>.
                
                */

                File 3 of 4: InitializedProxy
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @title InitializedProxy
                 * @author Anna Carroll
                 */
                contract InitializedProxy {
                    // address of logic contract
                    address public immutable logic;
                    // ======== Constructor =========
                    constructor(
                        address _logic,
                        bytes memory _initializationCalldata
                    ) {
                        logic = _logic;
                        // Delegatecall into the logic contract, supplying initialization calldata
                        (bool _ok, bytes memory returnData) =
                            _logic.delegatecall(_initializationCalldata);
                        // Revert if delegatecall to implementation reverts
                        require(_ok, string(returnData));
                    }
                    // ======== Fallback =========
                    fallback() external payable {
                        address _impl = logic;
                        assembly {
                            let ptr := mload(0x40)
                            calldatacopy(ptr, 0, calldatasize())
                            let result := delegatecall(gas(), _impl, ptr, calldatasize(), 0, 0)
                            let size := returndatasize()
                            returndatacopy(ptr, 0, size)
                            switch result
                                case 0 {
                                    revert(ptr, size)
                                }
                                default {
                                    return(ptr, size)
                                }
                        }
                    }
                    // ======== Receive =========
                    receive() external payable {} // solhint-disable-line no-empty-blocks
                }

                File 4 of 4: TokenVault
                //SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "./Interfaces/IWETH.sol";
                import "./OpenZeppelin/math/Math.sol";
                import "./OpenZeppelin/token/ERC20/ERC20.sol";
                import "./OpenZeppelin/token/ERC721/ERC721.sol";
                import "./OpenZeppelin/token/ERC721/ERC721Holder.sol";
                import "./Settings.sol";
                import "./OpenZeppelin/upgradeable/token/ERC721/utils/ERC721HolderUpgradeable.sol";
                import "./OpenZeppelin/upgradeable/token/ERC20/ERC20Upgradeable.sol";
                contract TokenVault is ERC20Upgradeable, ERC721HolderUpgradeable {
                    using Address for address;
                    /// -----------------------------------
                    /// -------- BASIC INFORMATION --------
                    /// -----------------------------------
                    /// @notice weth address
                    address public constant weth = 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2;
                    /// -----------------------------------
                    /// -------- TOKEN INFORMATION --------
                    /// -----------------------------------
                    /// @notice the ERC721 token address of the vault's token
                    address public token;
                    /// @notice the ERC721 token ID of the vault's token
                    uint256 public id;
                    /// -------------------------------------
                    /// -------- AUCTION INFORMATION --------
                    /// -------------------------------------
                    /// @notice the unix timestamp end time of the token auction
                    uint256 public auctionEnd;
                    /// @notice the length of auctions
                    uint256 public auctionLength;
                    /// @notice reservePrice * votingTokens
                    uint256 public reserveTotal;
                    /// @notice the current price of the token during an auction
                    uint256 public livePrice;
                    /// @notice the current user winning the token auction
                    address payable public winning;
                    enum State { inactive, live, ended, redeemed }
                    State public auctionState;
                    /// -----------------------------------
                    /// -------- VAULT INFORMATION --------
                    /// -----------------------------------
                    /// @notice the governance contract which gets paid in ETH
                    address public immutable settings;
                    /// @notice the address who initially deposited the NFT
                    address public curator;
                    /// @notice the AUM fee paid to the curator yearly. 3 decimals. ie. 100 = 10%
                    uint256 public fee;
                    /// @notice the last timestamp where fees were claimed
                    uint256 public lastClaimed;
                    /// @notice a boolean to indicate if the vault has closed
                    bool public vaultClosed;
                    /// @notice the number of ownership tokens voting on the reserve price at any given time
                    uint256 public votingTokens;
                    /// @notice a mapping of users to their desired token price
                    mapping(address => uint256) public userPrices;
                    /// ------------------------
                    /// -------- EVENTS --------
                    /// ------------------------
                    /// @notice An event emitted when a user updates their price
                    event PriceUpdate(address indexed user, uint price);
                    /// @notice An event emitted when an auction starts
                    event Start(address indexed buyer, uint price);
                    /// @notice An event emitted when a bid is made
                    event Bid(address indexed buyer, uint price);
                    /// @notice An event emitted when an auction is won
                    event Won(address indexed buyer, uint price);
                    /// @notice An event emitted when someone redeems all tokens for the NFT
                    event Redeem(address indexed redeemer);
                    /// @notice An event emitted when someone cashes in ERC20 tokens for ETH from an ERC721 token sale
                    event Cash(address indexed owner, uint256 shares);
                    constructor(address _settings) {
                        settings = _settings;
                    }
                    function initialize(address _curator, address _token, uint256 _id, uint256 _supply, uint256 _listPrice, uint256 _fee, string memory _name, string memory _symbol) external initializer {
                        // initialize inherited contracts
                        __ERC20_init(_name, _symbol);
                        __ERC721Holder_init();
                        // set storage variables
                        token = _token;
                        id = _id;
                        reserveTotal = _listPrice * _supply;
                        auctionLength = 7 days;
                        curator = _curator;
                        fee = _fee;
                        lastClaimed = block.timestamp;
                        votingTokens = _listPrice == 0 ? 0 : _supply;
                        auctionState = State.inactive;
                        _mint(_curator, _supply);
                        userPrices[_curator] = _listPrice;
                    }
                    /// --------------------------------
                    /// -------- VIEW FUNCTIONS --------
                    /// --------------------------------
                    function reservePrice() public view returns(uint256) {
                        return votingTokens == 0 ? 0 : reserveTotal / votingTokens;
                    }
                    /// -------------------------------
                    /// -------- GOV FUNCTIONS --------
                    /// -------------------------------
                    /// @notice allow governance to boot a bad actor curator
                    /// @param _curator the new curator
                    function kickCurator(address _curator) external {
                        require(msg.sender == Ownable(settings).owner(), "kick:not gov");
                        curator = _curator;
                    }
                    /// @notice allow governance to remove bad reserve prices
                    function removeReserve(address _user) external {
                        require(msg.sender == Ownable(settings).owner(), "remove:not gov");
                        require(auctionState == State.inactive, "update:auction live cannot update price");
                        uint256 old = userPrices[_user];
                        require(0 != old, "update:not an update");
                        uint256 weight = balanceOf(_user);
                        votingTokens -= weight;
                        reserveTotal -= weight * old;
                        
                        userPrices[_user] = 0;
                        emit PriceUpdate(_user, 0);
                    }
                    /// -----------------------------------
                    /// -------- CURATOR FUNCTIONS --------
                    /// -----------------------------------
                    /// @notice allow curator to update the curator address
                    /// @param _curator the new curator
                    function updateCurator(address _curator) external {
                        require(msg.sender == curator, "update:not curator");
                        curator = _curator;
                    }
                    /// @notice allow curator to update the auction length
                    /// @param _length the new base price
                    function updateAuctionLength(uint256 _length) external {
                        require(msg.sender == curator, "update:not curator");
                        require(_length >= ISettings(settings).minAuctionLength() && _length <= ISettings(settings).maxAuctionLength(), "update:invalid auction length");
                        auctionLength = _length;
                    }
                    /// @notice allow the curator to change their fee
                    /// @param _fee the new fee
                    function updateFee(uint256 _fee) external {
                        require(msg.sender == curator, "update:not curator");
                        require(_fee <= ISettings(settings).maxCuratorFee(), "update:cannot increase fee this high");
                        _claimFees();
                        fee = _fee;
                    }
                    /// @notice external function to claim fees for the curator and governance
                    function claimFees() external {
                        _claimFees();
                    }
                    /// @dev interal fuction to calculate and mint fees
                    function _claimFees() internal {
                        require(auctionState != State.ended, "claim:cannot claim after auction ends");
                        // get how much in fees the curator would make in a year
                        uint256 currentAnnualFee = fee * totalSupply() / 1000; 
                        // get how much that is per second;
                        uint256 feePerSecond = currentAnnualFee / 31536000;
                        // get how many seconds they are eligible to claim
                        uint256 sinceLastClaim = block.timestamp - lastClaimed;
                        // get the amount of tokens to mint
                        uint256 curatorMint = sinceLastClaim * feePerSecond;
                        // now lets do the same for governance
                        address govAddress = ISettings(settings).feeReceiver();
                        uint256 govFee = ISettings(settings).governanceFee();
                        currentAnnualFee = govFee * totalSupply() / 1000; 
                        feePerSecond = currentAnnualFee / 31536000;
                        uint256 govMint = sinceLastClaim * feePerSecond;
                        lastClaimed = block.timestamp;
                        _mint(curator, curatorMint);
                        _mint(govAddress, govMint);
                    }
                    /// --------------------------------
                    /// -------- CORE FUNCTIONS --------
                    /// --------------------------------
                    /// @notice a function for an end user to update their desired sale price
                    /// @param _new the desired price in ETH
                    function updateUserPrice(uint256 _new) external {
                        require(auctionState == State.inactive, "update:auction live cannot update price");
                        uint256 old = userPrices[msg.sender];
                        require(_new != old, "update:not an update");
                        uint256 weight = balanceOf(msg.sender);
                        if (votingTokens == 0) {
                            votingTokens = weight;
                            reserveTotal = weight * _new;
                        }
                        // they are the only one voting
                        else if (weight == votingTokens && old != 0) {
                            reserveTotal = weight * _new;
                        }
                        // previously they were not voting
                        else if (old == 0) {
                            uint256 averageReserve = reserveTotal / votingTokens;
                            uint256 reservePriceMin = averageReserve * ISettings(settings).minReserveFactor() / 1000;
                            require(_new >= reservePriceMin, "update:reserve price too low");
                            uint256 reservePriceMax = averageReserve * ISettings(settings).maxReserveFactor() / 1000;
                            require(_new <= reservePriceMax, "update:reserve price too high");
                            votingTokens += weight;
                            reserveTotal += weight * _new;
                        } 
                        // they no longer want to vote
                        else if (_new == 0) {
                            votingTokens -= weight;
                            reserveTotal -= weight * old;
                        } 
                        // they are updating their vote
                        else {
                            uint256 averageReserve = (reserveTotal - (old * weight)) / (votingTokens - weight);
                            uint256 reservePriceMin = averageReserve * ISettings(settings).minReserveFactor() / 1000;
                            require(_new >= reservePriceMin, "update:reserve price too low");
                            uint256 reservePriceMax = averageReserve * ISettings(settings).maxReserveFactor() / 1000;
                            require(_new <= reservePriceMax, "update:reserve price too high");
                            reserveTotal = reserveTotal + (weight * _new) - (weight * old);
                        }
                        userPrices[msg.sender] = _new;
                        emit PriceUpdate(msg.sender, _new);
                    }
                    /// @notice an internal function used to update sender and receivers price on token transfer
                    /// @param _from the ERC20 token sender
                    /// @param _to the ERC20 token receiver
                    /// @param _amount the ERC20 token amount
                    function _beforeTokenTransfer(address _from, address _to, uint256 _amount) internal virtual override {
                        if (_from != address(0) && auctionState == State.inactive) {
                            uint256 fromPrice = userPrices[_from];
                            uint256 toPrice = userPrices[_to];
                            // only do something if users have different reserve price
                            if (toPrice != fromPrice) {
                                // new holder is not a voter
                                if (toPrice == 0) {
                                    // get the average reserve price ignoring the senders amount
                                    votingTokens -= _amount;
                                    reserveTotal -= _amount * fromPrice;
                                }
                                // old holder is not a voter
                                else if (fromPrice == 0) {
                                    votingTokens += _amount;
                                    reserveTotal += _amount * toPrice;
                                }
                                // both holders are voters
                                else {
                                    reserveTotal = reserveTotal + (_amount * toPrice) - (_amount * fromPrice);
                                }
                            }
                        }
                    }
                    /// @notice kick off an auction. Must send reservePrice in ETH
                    function start() external payable {
                        require(auctionState == State.inactive, "start:no auction starts");
                        require(msg.value >= reservePrice(), "start:too low bid");
                        require(votingTokens * 1000 >= ISettings(settings).minVotePercentage() * totalSupply(), "start:not enough voters");
                        
                        auctionEnd = block.timestamp + auctionLength;
                        auctionState = State.live;
                        livePrice = msg.value;
                        winning = payable(msg.sender);
                        emit Start(msg.sender, msg.value);
                    }
                    /// @notice an external function to bid on purchasing the vaults NFT. The msg.value is the bid amount
                    function bid() external payable {
                        require(auctionState == State.live, "bid:auction is not live");
                        uint256 increase = ISettings(settings).minBidIncrease() + 1000;
                        require(msg.value * 1000 >= livePrice * increase, "bid:too low bid");
                        require(block.timestamp < auctionEnd, "bid:auction ended");
                        // If bid is within 15 minutes of auction end, extend auction
                        if (auctionEnd - block.timestamp <= 15 minutes) {
                            auctionEnd += 15 minutes;
                        }
                        _sendWETH(winning, livePrice);
                        livePrice = msg.value;
                        winning = payable(msg.sender);
                        emit Bid(msg.sender, msg.value);
                    }
                    /// @notice an external function to end an auction after the timer has run out
                    function end() external {
                        require(auctionState == State.live, "end:vault has already closed");
                        require(block.timestamp >= auctionEnd, "end:auction live");
                        _claimFees();
                        // transfer erc721 to winner
                        IERC721(token).transferFrom(address(this), winning, id);
                        auctionState = State.ended;
                        emit Won(winning, livePrice);
                    }
                    /// @notice an external function to burn all ERC20 tokens to receive the ERC721 token
                    function redeem() external {
                        require(auctionState == State.inactive, "redeem:no redeeming");
                        _burn(msg.sender, totalSupply());
                        
                        // transfer erc721 to redeemer
                        IERC721(token).transferFrom(address(this), msg.sender, id);
                        
                        auctionState = State.redeemed;
                        emit Redeem(msg.sender);
                    }
                    /// @notice an external function to burn ERC20 tokens to receive ETH from ERC721 token purchase
                    function cash() external {
                        require(auctionState == State.ended, "cash:vault not closed yet");
                        uint256 bal = balanceOf(msg.sender);
                        require(bal > 0, "cash:no tokens to cash out");
                        uint256 share = bal * address(this).balance / totalSupply();
                        _burn(msg.sender, bal);
                        _sendETHOrWETH(payable(msg.sender), share);
                        emit Cash(msg.sender, share);
                    }
                    /// @dev internal helper function to send ETH and WETH on failure
                    function _sendWETH(address who, uint256 amount) internal {
                        IWETH(weth).deposit{value: amount}();
                        IWETH(weth).transfer(who, IWETH(weth).balanceOf(address(this)));
                    }
                    /// @dev internal helper function to send ETH and WETH on failure
                    function _sendETHOrWETH(address who, uint256 amount) internal {
                        // contracts get bet WETH because they can be mean
                        if (who.isContract()) {
                            IWETH(weth).deposit{value: amount}();
                            IWETH(weth).transfer(who, IWETH(weth).balanceOf(address(this)));
                        } else {
                            payable(who).transfer(amount);
                        }
                    }
                }//SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                interface IWETH {
                    function deposit() external payable;
                    function withdraw(uint) external;
                    function approve(address, uint) external returns(bool);
                    function transfer(address, uint) external returns(bool);
                    function transferFrom(address, address, uint) external returns(bool);
                    function balanceOf(address) external view returns(uint);
                }// SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @dev Standard math utilities missing in the Solidity language.
                 */
                library Math {
                    /**
                     * @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, so we distribute
                        return (a / 2) + (b / 2) + ((a % 2 + b % 2) / 2);
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "../../utils/Context.sol";
                import "./IERC20.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 guidelines: functions revert instead
                 * of 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 {
                    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 defaut value of {decimals} is 18. To select a different value for
                     * {decimals} you should overload it.
                     *
                     * All three of these values are immutable: they can only be set once during
                     * construction.
                     */
                    constructor (string memory name_, string memory symbol_) {
                        _name = name_;
                        _symbol = symbol_;
                    }
                    /**
                     * @dev Returns the name of the token.
                     */
                    function name() public view virtual returns (string memory) {
                        return _name;
                    }
                    /**
                     * @dev Returns the symbol of the token, usually a shorter version of the
                     * name.
                     */
                    function symbol() public view virtual returns (string memory) {
                        return _symbol;
                    }
                    /**
                     * @dev Returns the number of decimals used to get its user representation.
                     * For example, if `decimals` equals `2`, a balance of `505` tokens should
                     * be displayed to a user as `5,05` (`505 / 10 ** 2`).
                     *
                     * Tokens usually opt for a value of 18, imitating the relationship between
                     * Ether and Wei. This is the value {ERC20} uses, unless this function is
                     * overloaded;
                     *
                     * NOTE: This information is only used for _display_ purposes: it in
                     * no way affects any of the arithmetic of the contract, including
                     * {IERC20-balanceOf} and {IERC20-transfer}.
                     */
                    function decimals() public view virtual returns (uint8) {
                        return 18;
                    }
                    /**
                     * @dev See {IERC20-totalSupply}.
                     */
                    function totalSupply() public view virtual 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:
                     *
                     * - `recipient` cannot be the zero address.
                     * - the caller must have a balance of at least `amount`.
                     */
                    function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
                        _transfer(_msgSender(), recipient, 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}.
                     *
                     * Requirements:
                     *
                     * - `spender` cannot be the zero address.
                     */
                    function approve(address spender, uint256 amount) public virtual override returns (bool) {
                        _approve(_msgSender(), 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}.
                     *
                     * Requirements:
                     *
                     * - `sender` and `recipient` cannot be the zero address.
                     * - `sender` must have a balance of at least `amount`.
                     * - the caller must have allowance for ``sender``'s tokens of at least
                     * `amount`.
                     */
                    function transferFrom(address sender, address recipient, uint256 amount) public virtual override returns (bool) {
                        _transfer(sender, recipient, amount);
                        uint256 currentAllowance = _allowances[sender][_msgSender()];
                        require(currentAllowance >= amount, "ERC20: transfer amount exceeds allowance");
                        _approve(sender, _msgSender(), currentAllowance - 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) {
                        _approve(_msgSender(), spender, _allowances[_msgSender()][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) {
                        uint256 currentAllowance = _allowances[_msgSender()][spender];
                        require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
                        _approve(_msgSender(), spender, currentAllowance - subtractedValue);
                        return true;
                    }
                    /**
                     * @dev Moves tokens `amount` from `sender` to `recipient`.
                     *
                     * This is 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:
                     *
                     * - `sender` cannot be the zero address.
                     * - `recipient` cannot be the zero address.
                     * - `sender` must have a balance of at least `amount`.
                     */
                    function _transfer(address sender, address recipient, uint256 amount) internal virtual {
                        require(sender != address(0), "ERC20: transfer from the zero address");
                        require(recipient != address(0), "ERC20: transfer to the zero address");
                        _beforeTokenTransfer(sender, recipient, amount);
                        uint256 senderBalance = _balances[sender];
                        require(senderBalance >= amount, "ERC20: transfer amount exceeds balance");
                        _balances[sender] = senderBalance - amount;
                        _balances[recipient] += amount;
                        emit Transfer(sender, recipient, 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:
                     *
                     * - `to` 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);
                    }
                    /**
                     * @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");
                        _balances[account] = accountBalance - amount;
                        _totalSupply -= amount;
                        emit Transfer(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 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 to 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 { }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "../../utils/Context.sol";
                import "./IERC721.sol";
                import "./IERC721Metadata.sol";
                import "./IERC721Enumerable.sol";
                import "./IERC721Receiver.sol";
                import "../../introspection/ERC165.sol";
                import "../../utils/Address.sol";
                import "../../utils/EnumerableSet.sol";
                import "../../utils/EnumerableMap.sol";
                import "../../utils/Strings.sol";
                /**
                 * @title ERC721 Non-Fungible Token Standard basic implementation
                 * @dev see https://eips.ethereum.org/EIPS/eip-721
                 */
                contract ERC721 is Context, ERC165, IERC721, IERC721Metadata, IERC721Enumerable {
                    using Address for address;
                    using EnumerableSet for EnumerableSet.UintSet;
                    using EnumerableMap for EnumerableMap.UintToAddressMap;
                    using Strings for uint256;
                    // Mapping from holder address to their (enumerable) set of owned tokens
                    mapping (address => EnumerableSet.UintSet) private _holderTokens;
                    // Enumerable mapping from token ids to their owners
                    EnumerableMap.UintToAddressMap private _tokenOwners;
                    // Mapping from token ID to approved address
                    mapping (uint256 => address) private _tokenApprovals;
                    // Mapping from owner to operator approvals
                    mapping (address => mapping (address => bool)) private _operatorApprovals;
                    // Token name
                    string private _name;
                    // Token symbol
                    string private _symbol;
                    // Optional mapping for token URIs
                    mapping (uint256 => string) private _tokenURIs;
                    // Base URI
                    string private _baseURI;
                    /**
                     * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
                     */
                    constructor (string memory name_, string memory symbol_) {
                        _name = name_;
                        _symbol = symbol_;
                        // register the supported interfaces to conform to ERC721 via ERC165
                        _registerInterface(type(IERC721).interfaceId);
                        _registerInterface(type(IERC721Metadata).interfaceId);
                        _registerInterface(type(IERC721Enumerable).interfaceId);
                    }
                    /**
                     * @dev See {IERC721-balanceOf}.
                     */
                    function balanceOf(address owner) public view virtual override returns (uint256) {
                        require(owner != address(0), "ERC721: balance query for the zero address");
                        return _holderTokens[owner].length();
                    }
                    /**
                     * @dev See {IERC721-ownerOf}.
                     */
                    function ownerOf(uint256 tokenId) public view virtual override returns (address) {
                        return _tokenOwners.get(tokenId, "ERC721: owner query for nonexistent token");
                    }
                    /**
                     * @dev See {IERC721Metadata-name}.
                     */
                    function name() public view virtual override returns (string memory) {
                        return _name;
                    }
                    /**
                     * @dev See {IERC721Metadata-symbol}.
                     */
                    function symbol() public view virtual override returns (string memory) {
                        return _symbol;
                    }
                    /**
                     * @dev See {IERC721Metadata-tokenURI}.
                     */
                    function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                        require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                        string memory _tokenURI = _tokenURIs[tokenId];
                        string memory base = baseURI();
                        // If there is no base URI, return the token URI.
                        if (bytes(base).length == 0) {
                            return _tokenURI;
                        }
                        // If both are set, concatenate the baseURI and tokenURI (via abi.encodePacked).
                        if (bytes(_tokenURI).length > 0) {
                            return string(abi.encodePacked(base, _tokenURI));
                        }
                        // If there is a baseURI but no tokenURI, concatenate the tokenID to the baseURI.
                        return string(abi.encodePacked(base, tokenId.toString()));
                    }
                    /**
                    * @dev Returns the base URI set via {_setBaseURI}. This will be
                    * automatically added as a prefix in {tokenURI} to each token's URI, or
                    * to the token ID if no specific URI is set for that token ID.
                    */
                    function baseURI() public view virtual returns (string memory) {
                        return _baseURI;
                    }
                    /**
                     * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}.
                     */
                    function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual override returns (uint256) {
                        return _holderTokens[owner].at(index);
                    }
                    /**
                     * @dev See {IERC721Enumerable-totalSupply}.
                     */
                    function totalSupply() public view virtual override returns (uint256) {
                        // _tokenOwners are indexed by tokenIds, so .length() returns the number of tokenIds
                        return _tokenOwners.length();
                    }
                    /**
                     * @dev See {IERC721Enumerable-tokenByIndex}.
                     */
                    function tokenByIndex(uint256 index) public view virtual override returns (uint256) {
                        (uint256 tokenId, ) = _tokenOwners.at(index);
                        return tokenId;
                    }
                    /**
                     * @dev See {IERC721-approve}.
                     */
                    function approve(address to, uint256 tokenId) public virtual override {
                        address owner = ERC721.ownerOf(tokenId);
                        require(to != owner, "ERC721: approval to current owner");
                        require(_msgSender() == owner || ERC721.isApprovedForAll(owner, _msgSender()),
                            "ERC721: approve caller is not owner nor approved for all"
                        );
                        _approve(to, tokenId);
                    }
                    /**
                     * @dev See {IERC721-getApproved}.
                     */
                    function getApproved(uint256 tokenId) public view virtual override returns (address) {
                        require(_exists(tokenId), "ERC721: approved query for nonexistent token");
                        return _tokenApprovals[tokenId];
                    }
                    /**
                     * @dev See {IERC721-setApprovalForAll}.
                     */
                    function setApprovalForAll(address operator, bool approved) public virtual override {
                        require(operator != _msgSender(), "ERC721: approve to caller");
                        _operatorApprovals[_msgSender()][operator] = approved;
                        emit ApprovalForAll(_msgSender(), operator, approved);
                    }
                    /**
                     * @dev See {IERC721-isApprovedForAll}.
                     */
                    function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
                        return _operatorApprovals[owner][operator];
                    }
                    /**
                     * @dev See {IERC721-transferFrom}.
                     */
                    function transferFrom(address from, address to, uint256 tokenId) public virtual override {
                        //solhint-disable-next-line max-line-length
                        require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                        _transfer(from, to, tokenId);
                    }
                    /**
                     * @dev See {IERC721-safeTransferFrom}.
                     */
                    function safeTransferFrom(address from, address to, uint256 tokenId) public virtual override {
                        safeTransferFrom(from, to, tokenId, "");
                    }
                    /**
                     * @dev See {IERC721-safeTransferFrom}.
                     */
                    function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory _data) public virtual override {
                        require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                        _safeTransfer(from, to, tokenId, _data);
                    }
                    /**
                     * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
                     * are aware of the ERC721 protocol to prevent tokens from being forever locked.
                     *
                     * `_data` is additional data, it has no specified format and it is sent in call to `to`.
                     *
                     * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
                     * implement alternative mechanisms to perform token transfer, such as signature-based.
                     *
                     * Requirements:
                     *
                     * - `from` cannot be the zero address.
                     * - `to` cannot be the zero address.
                     * - `tokenId` token must exist and be owned by `from`.
                     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                     *
                     * Emits a {Transfer} event.
                     */
                    function _safeTransfer(address from, address to, uint256 tokenId, bytes memory _data) internal virtual {
                        _transfer(from, to, tokenId);
                        require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                    }
                    /**
                     * @dev Returns whether `tokenId` exists.
                     *
                     * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
                     *
                     * Tokens start existing when they are minted (`_mint`),
                     * and stop existing when they are burned (`_burn`).
                     */
                    function _exists(uint256 tokenId) internal view virtual returns (bool) {
                        return _tokenOwners.contains(tokenId);
                    }
                    /**
                     * @dev Returns whether `spender` is allowed to manage `tokenId`.
                     *
                     * Requirements:
                     *
                     * - `tokenId` must exist.
                     */
                    function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
                        require(_exists(tokenId), "ERC721: operator query for nonexistent token");
                        address owner = ERC721.ownerOf(tokenId);
                        return (spender == owner || getApproved(tokenId) == spender || ERC721.isApprovedForAll(owner, spender));
                    }
                    /**
                     * @dev Safely mints `tokenId` and transfers it to `to`.
                     *
                     * Requirements:
                     d*
                     * - `tokenId` must not exist.
                     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                     *
                     * Emits a {Transfer} event.
                     */
                    function _safeMint(address to, uint256 tokenId) internal virtual {
                        _safeMint(to, tokenId, "");
                    }
                    /**
                     * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
                     * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
                     */
                    function _safeMint(address to, uint256 tokenId, bytes memory _data) internal virtual {
                        _mint(to, tokenId);
                        require(_checkOnERC721Received(address(0), to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                    }
                    /**
                     * @dev Mints `tokenId` and transfers it to `to`.
                     *
                     * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
                     *
                     * Requirements:
                     *
                     * - `tokenId` must not exist.
                     * - `to` cannot be the zero address.
                     *
                     * Emits a {Transfer} event.
                     */
                    function _mint(address to, uint256 tokenId) internal virtual {
                        require(to != address(0), "ERC721: mint to the zero address");
                        require(!_exists(tokenId), "ERC721: token already minted");
                        _beforeTokenTransfer(address(0), to, tokenId);
                        _holderTokens[to].add(tokenId);
                        _tokenOwners.set(tokenId, to);
                        emit Transfer(address(0), to, tokenId);
                    }
                    /**
                     * @dev Destroys `tokenId`.
                     * The approval is cleared when the token is burned.
                     *
                     * Requirements:
                     *
                     * - `tokenId` must exist.
                     *
                     * Emits a {Transfer} event.
                     */
                    function _burn(uint256 tokenId) internal virtual {
                        address owner = ERC721.ownerOf(tokenId); // internal owner
                        _beforeTokenTransfer(owner, address(0), tokenId);
                        // Clear approvals
                        _approve(address(0), tokenId);
                        // Clear metadata (if any)
                        if (bytes(_tokenURIs[tokenId]).length != 0) {
                            delete _tokenURIs[tokenId];
                        }
                        _holderTokens[owner].remove(tokenId);
                        _tokenOwners.remove(tokenId);
                        emit Transfer(owner, address(0), tokenId);
                    }
                    /**
                     * @dev Transfers `tokenId` from `from` to `to`.
                     *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
                     *
                     * Requirements:
                     *
                     * - `to` cannot be the zero address.
                     * - `tokenId` token must be owned by `from`.
                     *
                     * Emits a {Transfer} event.
                     */
                    function _transfer(address from, address to, uint256 tokenId) internal virtual {
                        require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer of token that is not own"); // internal owner
                        require(to != address(0), "ERC721: transfer to the zero address");
                        _beforeTokenTransfer(from, to, tokenId);
                        // Clear approvals from the previous owner
                        _approve(address(0), tokenId);
                        _holderTokens[from].remove(tokenId);
                        _holderTokens[to].add(tokenId);
                        _tokenOwners.set(tokenId, to);
                        emit Transfer(from, to, tokenId);
                    }
                    /**
                     * @dev Sets `_tokenURI` as the tokenURI of `tokenId`.
                     *
                     * Requirements:
                     *
                     * - `tokenId` must exist.
                     */
                    function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {
                        require(_exists(tokenId), "ERC721Metadata: URI set of nonexistent token");
                        _tokenURIs[tokenId] = _tokenURI;
                    }
                    /**
                     * @dev Internal function to set the base URI for all token IDs. It is
                     * automatically added as a prefix to the value returned in {tokenURI},
                     * or to the token ID if {tokenURI} is empty.
                     */
                    function _setBaseURI(string memory baseURI_) internal virtual {
                        _baseURI = baseURI_;
                    }
                    /**
                     * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
                     * The call is not executed if the target address is not a contract.
                     *
                     * @param from address representing the previous owner of the given token ID
                     * @param to target address that will receive the tokens
                     * @param tokenId uint256 ID of the token to be transferred
                     * @param _data bytes optional data to send along with the call
                     * @return bool whether the call correctly returned the expected magic value
                     */
                    function _checkOnERC721Received(address from, address to, uint256 tokenId, bytes memory _data)
                        private returns (bool)
                    {
                        if (to.isContract()) {
                            try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, _data) returns (bytes4 retval) {
                                return retval == IERC721Receiver(to).onERC721Received.selector;
                            } catch (bytes memory reason) {
                                if (reason.length == 0) {
                                    revert("ERC721: transfer to non ERC721Receiver implementer");
                                } else {
                                    // solhint-disable-next-line no-inline-assembly
                                    assembly {
                                        revert(add(32, reason), mload(reason))
                                    }
                                }
                            }
                        } else {
                            return true;
                        }
                    }
                    function _approve(address to, uint256 tokenId) private {
                        _tokenApprovals[tokenId] = to;
                        emit Approval(ERC721.ownerOf(tokenId), to, tokenId); // internal owner
                    }
                    /**
                     * @dev Hook that is called before any token transfer. This includes minting
                     * and burning.
                     *
                     * Calling conditions:
                     *
                     * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
                     * transferred to `to`.
                     * - When `from` is zero, `tokenId` will be minted for `to`.
                     * - When `to` is zero, ``from``'s `tokenId` will be burned.
                     * - `from` cannot be the zero address.
                     * - `to` cannot be the zero address.
                     *
                     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
                     */
                    function _beforeTokenTransfer(address from, address to, uint256 tokenId) internal virtual { }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "./IERC721Receiver.sol";
                  /**
                   * @dev Implementation of the {IERC721Receiver} interface.
                   *
                   * Accepts all token transfers. 
                   * Make sure the contract is able to use its token with {IERC721-safeTransferFrom}, {IERC721-approve} or {IERC721-setApprovalForAll}.
                   */
                contract ERC721Holder is IERC721Receiver {
                    /**
                     * @dev See {IERC721Receiver-onERC721Received}.
                     *
                     * Always returns `IERC721Receiver.onERC721Received.selector`.
                     */
                    function onERC721Received(address, address, uint256, bytes memory) public virtual override returns (bytes4) {
                        return this.onERC721Received.selector;
                    }
                }
                //SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "./OpenZeppelin/access/Ownable.sol";
                import "./Interfaces/ISettings.sol";
                contract Settings is Ownable, ISettings {
                    /// @notice the maximum auction length
                    uint256 public override maxAuctionLength;
                    /// @notice the longest an auction can ever be
                    uint256 public constant maxMaxAuctionLength = 8 weeks;
                    /// @notice the minimum auction length
                    uint256 public override minAuctionLength;
                    /// @notice the shortest an auction can ever be
                    uint256 public constant minMinAuctionLength = 1 days;
                    /// @notice governance fee max
                    uint256 public override governanceFee;
                    /// @notice 10% fee is max
                    uint256 public constant maxGovFee = 100;
                    /// @notice max curator fee
                    uint256 public override maxCuratorFee;
                    /// @notice the % bid increase required for a new bid
                    uint256 public override minBidIncrease;
                    /// @notice 10% bid increase is max 
                    uint256 public constant maxMinBidIncrease = 100;
                    /// @notice 1% bid increase is min
                    uint256 public constant minMinBidIncrease = 10;
                    /// @notice the % of tokens required to be voting for an auction to start
                    uint256 public override minVotePercentage;
                    /// @notice the max % increase over the initial 
                    uint256 public override maxReserveFactor;
                    /// @notice the max % decrease from the initial
                    uint256 public override minReserveFactor;
                    /// @notice the address who receives auction fees
                    address payable public override feeReceiver;
                    event UpdateMaxAuctionLength(uint256 _old, uint256 _new);
                    event UpdateMinAuctionLength(uint256 _old, uint256 _new);
                    event UpdateGovernanceFee(uint256 _old, uint256 _new);
                    event UpdateCuratorFee(uint256 _old, uint256 _new);
                    event UpdateMinBidIncrease(uint256 _old, uint256 _new);
                    event UpdateMinVotePercentage(uint256 _old, uint256 _new);
                    event UpdateMaxReserveFactor(uint256 _old, uint256 _new);
                    event UpdateMinReserveFactor(uint256 _old, uint256 _new);
                    event UpdateFeeReceiver(address _old, address _new);
                    constructor() {
                        maxAuctionLength = 2 weeks;
                        minAuctionLength = 3 days;
                        feeReceiver = payable(msg.sender);
                        minReserveFactor = 500;  // 50%
                        maxReserveFactor = 2000; // 200%
                        minBidIncrease = 50;     // 5%
                        maxCuratorFee = 100;
                        minVotePercentage = 500; // 50%
                    }
                    function setMaxAuctionLength(uint256 _length) external onlyOwner {
                        require(_length <= maxMaxAuctionLength, "max auction length too high");
                        require(_length > minAuctionLength, "max auction length too low");
                        emit UpdateMaxAuctionLength(maxAuctionLength, _length);
                        maxAuctionLength = _length;
                    }
                    function setMinAuctionLength(uint256 _length) external onlyOwner {
                        require(_length >= minMinAuctionLength, "min auction length too low");
                        require(_length < maxAuctionLength, "min auction length too high");
                        emit UpdateMinAuctionLength(minAuctionLength, _length);
                        minAuctionLength = _length;
                    }
                    function setGovernanceFee(uint256 _fee) external onlyOwner {
                        require(_fee <= maxGovFee, "fee too high");
                        emit UpdateGovernanceFee(governanceFee, _fee);
                        governanceFee = _fee;
                    }
                    function setMaxCuratorFee(uint256 _fee) external onlyOwner {
                        emit UpdateCuratorFee(governanceFee, _fee);
                        maxCuratorFee = _fee;
                    }
                    function setMinBidIncrease(uint256 _min) external onlyOwner {
                        require(_min <= maxMinBidIncrease, "min bid increase too high");
                        require(_min >= minMinBidIncrease, "min bid increase too low");
                        emit UpdateMinBidIncrease(minBidIncrease, _min);
                        minBidIncrease = _min;
                    }
                    function setMinVotePercentage(uint256 _min) external onlyOwner {
                        // 1000 is 100%
                        require(_min <= 1000, "min vote percentage too high");
                        emit UpdateMinVotePercentage(minVotePercentage, _min);
                        minVotePercentage = _min;
                    }
                    function setMaxReserveFactor(uint256 _factor) external onlyOwner {
                        require(_factor > minReserveFactor, "max reserve factor too low");
                        emit UpdateMaxReserveFactor(maxReserveFactor, _factor);
                        maxReserveFactor = _factor;
                    }
                    function setMinReserveFactor(uint256 _factor) external onlyOwner {
                        require(_factor < maxReserveFactor, "min reserve factor too high");
                        emit UpdateMinReserveFactor(minReserveFactor, _factor);
                        minReserveFactor = _factor;
                    }
                    function setFeeReceiver(address payable _receiver) external onlyOwner {
                        require(_receiver != address(0), "fees cannot go to 0 address");
                        emit UpdateFeeReceiver(feeReceiver, _receiver);
                        feeReceiver = _receiver;
                    }
                }// SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "../IERC721ReceiverUpgradeable.sol";
                import "../../../proxy/utils/Initializable.sol";
                /**
                 * @dev Implementation of the {IERC721Receiver} interface.
                 *
                 * Accepts all token transfers.
                 * Make sure the contract is able to use its token with {IERC721-safeTransferFrom}, {IERC721-approve} or {IERC721-setApprovalForAll}.
                 */
                contract ERC721HolderUpgradeable is Initializable, IERC721ReceiverUpgradeable {
                    function __ERC721Holder_init() internal initializer {
                        __ERC721Holder_init_unchained();
                    }
                    function __ERC721Holder_init_unchained() internal initializer {
                    }
                    /**
                     * @dev See {IERC721Receiver-onERC721Received}.
                     *
                     * Always returns `IERC721Receiver.onERC721Received.selector`.
                     */
                    function onERC721Received(
                        address,
                        address,
                        uint256,
                        bytes memory
                    ) public virtual override returns (bytes4) {
                        return this.onERC721Received.selector;
                    }
                    uint256[50] private __gap;
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "./IERC20Upgradeable.sol";
                import "./extensions/IERC20MetadataUpgradeable.sol";
                import "../../utils/ContextUpgradeable.sol";
                import "../../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.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
                 * to implement supply mechanisms].
                 *
                 * We have followed general OpenZeppelin guidelines: functions revert instead
                 * of 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}.
                     *
                     * 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.
                     */
                    function __ERC20_init(string memory name_, string memory symbol_) internal initializer {
                        __Context_init_unchained();
                        __ERC20_init_unchained(name_, symbol_);
                    }
                    function __ERC20_init_unchained(string memory name_, string memory symbol_) internal initializer {
                        _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:
                     *
                     * - `recipient` cannot be the zero address.
                     * - the caller must have a balance of at least `amount`.
                     */
                    function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
                        _transfer(_msgSender(), recipient, 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}.
                     *
                     * Requirements:
                     *
                     * - `spender` cannot be the zero address.
                     */
                    function approve(address spender, uint256 amount) public virtual override returns (bool) {
                        _approve(_msgSender(), 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}.
                     *
                     * Requirements:
                     *
                     * - `sender` and `recipient` cannot be the zero address.
                     * - `sender` must have a balance of at least `amount`.
                     * - the caller must have allowance for ``sender``'s tokens of at least
                     * `amount`.
                     */
                    function transferFrom(
                        address sender,
                        address recipient,
                        uint256 amount
                    ) public virtual override returns (bool) {
                        _transfer(sender, recipient, amount);
                        uint256 currentAllowance = _allowances[sender][_msgSender()];
                        require(currentAllowance >= amount, "ERC20: transfer amount exceeds allowance");
                        unchecked {
                            _approve(sender, _msgSender(), currentAllowance - 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) {
                        _approve(_msgSender(), spender, _allowances[_msgSender()][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) {
                        uint256 currentAllowance = _allowances[_msgSender()][spender];
                        require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
                        unchecked {
                            _approve(_msgSender(), spender, currentAllowance - subtractedValue);
                        }
                        return true;
                    }
                    /**
                     * @dev Moves `amount` of tokens from `sender` to `recipient`.
                     *
                     * 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:
                     *
                     * - `sender` cannot be the zero address.
                     * - `recipient` cannot be the zero address.
                     * - `sender` must have a balance of at least `amount`.
                     */
                    function _transfer(
                        address sender,
                        address recipient,
                        uint256 amount
                    ) internal virtual {
                        require(sender != address(0), "ERC20: transfer from the zero address");
                        require(recipient != address(0), "ERC20: transfer to the zero address");
                        _beforeTokenTransfer(sender, recipient, amount);
                        uint256 senderBalance = _balances[sender];
                        require(senderBalance >= amount, "ERC20: transfer amount exceeds balance");
                        unchecked {
                            _balances[sender] = senderBalance - amount;
                        }
                        _balances[recipient] += amount;
                        emit Transfer(sender, recipient, amount);
                        _afterTokenTransfer(sender, recipient, 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 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 {}
                    uint256[45] private __gap;
                }
                // SPDX-License-Identifier: MIT
                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 GSN 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) {
                        this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                        return msg.data;
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @dev Interface of the ERC20 standard as defined in the EIP.
                 */
                interface IERC20 {
                    /**
                     * @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 `recipient`.
                     *
                     * Returns a boolean value indicating whether the operation succeeded.
                     *
                     * Emits a {Transfer} event.
                     */
                    function transfer(address recipient, 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 `sender` to `recipient` 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 sender, address recipient, uint256 amount) external returns (bool);
                    /**
                     * @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);
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "../../introspection/IERC165.sol";
                /**
                 * @dev Required interface of an ERC721 compliant contract.
                 */
                interface IERC721 is IERC165 {
                    /**
                     * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
                     */
                    event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                    /**
                     * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
                     */
                    event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                    /**
                     * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
                     */
                    event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                    /**
                     * @dev Returns the number of tokens in ``owner``'s account.
                     */
                    function balanceOf(address owner) external view returns (uint256 balance);
                    /**
                     * @dev Returns the owner of the `tokenId` token.
                     *
                     * Requirements:
                     *
                     * - `tokenId` must exist.
                     */
                    function ownerOf(uint256 tokenId) external view returns (address owner);
                    /**
                     * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
                     * are aware of the ERC721 protocol to prevent tokens from being forever locked.
                     *
                     * Requirements:
                     *
                     * - `from` cannot be the zero address.
                     * - `to` cannot be the zero address.
                     * - `tokenId` token must exist and be owned by `from`.
                     * - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
                     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                     *
                     * Emits a {Transfer} event.
                     */
                    function safeTransferFrom(address from, address to, uint256 tokenId) external;
                    /**
                     * @dev Transfers `tokenId` token from `from` to `to`.
                     *
                     * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
                     *
                     * Requirements:
                     *
                     * - `from` cannot be the zero address.
                     * - `to` cannot be the zero address.
                     * - `tokenId` token must be owned by `from`.
                     * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
                     *
                     * Emits a {Transfer} event.
                     */
                    function transferFrom(address from, address to, uint256 tokenId) external;
                    /**
                     * @dev Gives permission to `to` to transfer `tokenId` token to another account.
                     * The approval is cleared when the token is transferred.
                     *
                     * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
                     *
                     * Requirements:
                     *
                     * - The caller must own the token or be an approved operator.
                     * - `tokenId` must exist.
                     *
                     * Emits an {Approval} event.
                     */
                    function approve(address to, uint256 tokenId) external;
                    /**
                     * @dev Returns the account approved for `tokenId` token.
                     *
                     * Requirements:
                     *
                     * - `tokenId` must exist.
                     */
                    function getApproved(uint256 tokenId) external view returns (address operator);
                    /**
                     * @dev Approve or remove `operator` as an operator for the caller.
                     * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
                     *
                     * Requirements:
                     *
                     * - The `operator` cannot be the caller.
                     *
                     * Emits an {ApprovalForAll} event.
                     */
                    function setApprovalForAll(address operator, bool _approved) external;
                    /**
                     * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
                     *
                     * See {setApprovalForAll}
                     */
                    function isApprovedForAll(address owner, address operator) external view returns (bool);
                    /**
                      * @dev Safely transfers `tokenId` token from `from` to `to`.
                      *
                      * Requirements:
                      *
                      * - `from` cannot be the zero address.
                      * - `to` cannot be the zero address.
                      * - `tokenId` token must exist and be owned by `from`.
                      * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
                      * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                      *
                      * Emits a {Transfer} event.
                      */
                    function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "./IERC721.sol";
                /**
                 * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
                 * @dev See https://eips.ethereum.org/EIPS/eip-721
                 */
                interface IERC721Metadata is IERC721 {
                    /**
                     * @dev Returns the token collection name.
                     */
                    function name() external view returns (string memory);
                    /**
                     * @dev Returns the token collection symbol.
                     */
                    function symbol() external view returns (string memory);
                    /**
                     * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
                     */
                    function tokenURI(uint256 tokenId) external view returns (string memory);
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "./IERC721.sol";
                /**
                 * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
                 * @dev See https://eips.ethereum.org/EIPS/eip-721
                 */
                interface IERC721Enumerable is IERC721 {
                    /**
                     * @dev Returns the total amount of tokens stored by the contract.
                     */
                    function totalSupply() external view returns (uint256);
                    /**
                     * @dev Returns a token ID owned by `owner` at a given `index` of its token list.
                     * Use along with {balanceOf} to enumerate all of ``owner``'s tokens.
                     */
                    function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256 tokenId);
                    /**
                     * @dev Returns a token ID at a given `index` of all the tokens stored by the contract.
                     * Use along with {totalSupply} to enumerate all tokens.
                     */
                    function tokenByIndex(uint256 index) external view returns (uint256);
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @title ERC721 token receiver interface
                 * @dev Interface for any contract that wants to support safeTransfers
                 * from ERC721 asset contracts.
                 */
                interface IERC721Receiver {
                    /**
                     * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
                     * by `operator` from `from`, this function is called.
                     *
                     * It must return its Solidity selector to confirm the token transfer.
                     * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
                     *
                     * The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.
                     */
                    function onERC721Received(address operator, address from, uint256 tokenId, bytes calldata data) external returns (bytes4);
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "./IERC165.sol";
                /**
                 * @dev Implementation of the {IERC165} interface.
                 *
                 * Contracts may inherit from this and call {_registerInterface} to declare
                 * their support of an interface.
                 */
                abstract contract ERC165 is IERC165 {
                    /**
                     * @dev Mapping of interface ids to whether or not it's supported.
                     */
                    mapping(bytes4 => bool) private _supportedInterfaces;
                    constructor () {
                        // Derived contracts need only register support for their own interfaces,
                        // we register support for ERC165 itself here
                        _registerInterface(type(IERC165).interfaceId);
                    }
                    /**
                     * @dev See {IERC165-supportsInterface}.
                     *
                     * Time complexity O(1), guaranteed to always use less than 30 000 gas.
                     */
                    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                        return _supportedInterfaces[interfaceId];
                    }
                    /**
                     * @dev Registers the contract as an implementer of the interface defined by
                     * `interfaceId`. Support of the actual ERC165 interface is automatic and
                     * registering its interface id is not required.
                     *
                     * See {IERC165-supportsInterface}.
                     *
                     * Requirements:
                     *
                     * - `interfaceId` cannot be the ERC165 invalid interface (`0xffffffff`).
                     */
                    function _registerInterface(bytes4 interfaceId) internal virtual {
                        require(interfaceId != 0xffffffff, "ERC165: invalid interface id");
                        _supportedInterfaces[interfaceId] = true;
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @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
                     * ====
                     */
                    function isContract(address account) internal view returns (bool) {
                        // This method relies on extcodesize, which returns 0 for contracts in
                        // construction, since the code is only stored at the end of the
                        // constructor execution.
                        uint256 size;
                        // solhint-disable-next-line no-inline-assembly
                        assembly { size := extcodesize(account) }
                        return size > 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");
                        // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                        (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");
                        // solhint-disable-next-line avoid-low-level-calls
                        (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");
                        // solhint-disable-next-line avoid-low-level-calls
                        (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");
                        // solhint-disable-next-line avoid-low-level-calls
                        (bool success, bytes memory returndata) = target.delegatecall(data);
                        return _verifyCallResult(success, returndata, errorMessage);
                    }
                    function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private 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
                                // solhint-disable-next-line no-inline-assembly
                                assembly {
                                    let returndata_size := mload(returndata)
                                    revert(add(32, returndata), returndata_size)
                                }
                            } else {
                                revert(errorMessage);
                            }
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @dev Library for managing
                 * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
                 * types.
                 *
                 * Sets have the following properties:
                 *
                 * - Elements are added, removed, and checked for existence in constant time
                 * (O(1)).
                 * - Elements are enumerated in O(n). No guarantees are made on the ordering.
                 *
                 * ```
                 * contract Example {
                 *     // Add the library methods
                 *     using EnumerableSet for EnumerableSet.AddressSet;
                 *
                 *     // Declare a set state variable
                 *     EnumerableSet.AddressSet private mySet;
                 * }
                 * ```
                 *
                 * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
                 * and `uint256` (`UintSet`) are supported.
                 */
                library EnumerableSet {
                    // To implement this library for multiple types with as little code
                    // repetition as possible, we write it in terms of a generic Set type with
                    // bytes32 values.
                    // The Set implementation uses private functions, and user-facing
                    // implementations (such as AddressSet) are just wrappers around the
                    // underlying Set.
                    // This means that we can only create new EnumerableSets for types that fit
                    // in bytes32.
                    struct Set {
                        // Storage of set values
                        bytes32[] _values;
                        // Position of the value in the `values` array, plus 1 because index 0
                        // means a value is not in the set.
                        mapping (bytes32 => uint256) _indexes;
                    }
                    /**
                     * @dev Add a value to a set. O(1).
                     *
                     * Returns true if the value was added to the set, that is if it was not
                     * already present.
                     */
                    function _add(Set storage set, bytes32 value) private returns (bool) {
                        if (!_contains(set, value)) {
                            set._values.push(value);
                            // The value is stored at length-1, but we add 1 to all indexes
                            // and use 0 as a sentinel value
                            set._indexes[value] = set._values.length;
                            return true;
                        } else {
                            return false;
                        }
                    }
                    /**
                     * @dev Removes a value from a set. O(1).
                     *
                     * Returns true if the value was removed from the set, that is if it was
                     * present.
                     */
                    function _remove(Set storage set, bytes32 value) private returns (bool) {
                        // We read and store the value's index to prevent multiple reads from the same storage slot
                        uint256 valueIndex = set._indexes[value];
                        if (valueIndex != 0) { // Equivalent to contains(set, value)
                            // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
                            // the array, and then remove the last element (sometimes called as 'swap and pop').
                            // This modifies the order of the array, as noted in {at}.
                            uint256 toDeleteIndex = valueIndex - 1;
                            uint256 lastIndex = set._values.length - 1;
                            // When the value to delete is the last one, the swap operation is unnecessary. However, since this occurs
                            // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                            bytes32 lastvalue = set._values[lastIndex];
                            // Move the last value to the index where the value to delete is
                            set._values[toDeleteIndex] = lastvalue;
                            // Update the index for the moved value
                            set._indexes[lastvalue] = toDeleteIndex + 1; // All indexes are 1-based
                            // Delete the slot where the moved value was stored
                            set._values.pop();
                            // Delete the index for the deleted slot
                            delete set._indexes[value];
                            return true;
                        } else {
                            return false;
                        }
                    }
                    /**
                     * @dev Returns true if the value is in the set. O(1).
                     */
                    function _contains(Set storage set, bytes32 value) private view returns (bool) {
                        return set._indexes[value] != 0;
                    }
                    /**
                     * @dev Returns the number of values on the set. O(1).
                     */
                    function _length(Set storage set) private view returns (uint256) {
                        return set._values.length;
                    }
                   /**
                    * @dev Returns the value stored at position `index` in the set. O(1).
                    *
                    * Note that there are no guarantees on the ordering of values inside the
                    * array, and it may change when more values are added or removed.
                    *
                    * Requirements:
                    *
                    * - `index` must be strictly less than {length}.
                    */
                    function _at(Set storage set, uint256 index) private view returns (bytes32) {
                        require(set._values.length > index, "EnumerableSet: index out of bounds");
                        return set._values[index];
                    }
                    // Bytes32Set
                    struct Bytes32Set {
                        Set _inner;
                    }
                    /**
                     * @dev Add a value to a set. O(1).
                     *
                     * Returns true if the value was added to the set, that is if it was not
                     * already present.
                     */
                    function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                        return _add(set._inner, value);
                    }
                    /**
                     * @dev Removes a value from a set. O(1).
                     *
                     * Returns true if the value was removed from the set, that is if it was
                     * present.
                     */
                    function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                        return _remove(set._inner, value);
                    }
                    /**
                     * @dev Returns true if the value is in the set. O(1).
                     */
                    function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
                        return _contains(set._inner, value);
                    }
                    /**
                     * @dev Returns the number of values in the set. O(1).
                     */
                    function length(Bytes32Set storage set) internal view returns (uint256) {
                        return _length(set._inner);
                    }
                   /**
                    * @dev Returns the value stored at position `index` in the set. O(1).
                    *
                    * Note that there are no guarantees on the ordering of values inside the
                    * array, and it may change when more values are added or removed.
                    *
                    * Requirements:
                    *
                    * - `index` must be strictly less than {length}.
                    */
                    function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
                        return _at(set._inner, index);
                    }
                    // AddressSet
                    struct AddressSet {
                        Set _inner;
                    }
                    /**
                     * @dev Add a value to a set. O(1).
                     *
                     * Returns true if the value was added to the set, that is if it was not
                     * already present.
                     */
                    function add(AddressSet storage set, address value) internal returns (bool) {
                        return _add(set._inner, bytes32(uint256(uint160(value))));
                    }
                    /**
                     * @dev Removes a value from a set. O(1).
                     *
                     * Returns true if the value was removed from the set, that is if it was
                     * present.
                     */
                    function remove(AddressSet storage set, address value) internal returns (bool) {
                        return _remove(set._inner, bytes32(uint256(uint160(value))));
                    }
                    /**
                     * @dev Returns true if the value is in the set. O(1).
                     */
                    function contains(AddressSet storage set, address value) internal view returns (bool) {
                        return _contains(set._inner, bytes32(uint256(uint160(value))));
                    }
                    /**
                     * @dev Returns the number of values in the set. O(1).
                     */
                    function length(AddressSet storage set) internal view returns (uint256) {
                        return _length(set._inner);
                    }
                   /**
                    * @dev Returns the value stored at position `index` in the set. O(1).
                    *
                    * Note that there are no guarantees on the ordering of values inside the
                    * array, and it may change when more values are added or removed.
                    *
                    * Requirements:
                    *
                    * - `index` must be strictly less than {length}.
                    */
                    function at(AddressSet storage set, uint256 index) internal view returns (address) {
                        return address(uint160(uint256(_at(set._inner, index))));
                    }
                    // UintSet
                    struct UintSet {
                        Set _inner;
                    }
                    /**
                     * @dev Add a value to a set. O(1).
                     *
                     * Returns true if the value was added to the set, that is if it was not
                     * already present.
                     */
                    function add(UintSet storage set, uint256 value) internal returns (bool) {
                        return _add(set._inner, bytes32(value));
                    }
                    /**
                     * @dev Removes a value from a set. O(1).
                     *
                     * Returns true if the value was removed from the set, that is if it was
                     * present.
                     */
                    function remove(UintSet storage set, uint256 value) internal returns (bool) {
                        return _remove(set._inner, bytes32(value));
                    }
                    /**
                     * @dev Returns true if the value is in the set. O(1).
                     */
                    function contains(UintSet storage set, uint256 value) internal view returns (bool) {
                        return _contains(set._inner, bytes32(value));
                    }
                    /**
                     * @dev Returns the number of values on the set. O(1).
                     */
                    function length(UintSet storage set) internal view returns (uint256) {
                        return _length(set._inner);
                    }
                   /**
                    * @dev Returns the value stored at position `index` in the set. O(1).
                    *
                    * Note that there are no guarantees on the ordering of values inside the
                    * array, and it may change when more values are added or removed.
                    *
                    * Requirements:
                    *
                    * - `index` must be strictly less than {length}.
                    */
                    function at(UintSet storage set, uint256 index) internal view returns (uint256) {
                        return uint256(_at(set._inner, index));
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @dev Library for managing an enumerable variant of Solidity's
                 * https://solidity.readthedocs.io/en/latest/types.html#mapping-types[`mapping`]
                 * type.
                 *
                 * Maps have the following properties:
                 *
                 * - Entries are added, removed, and checked for existence in constant time
                 * (O(1)).
                 * - Entries are enumerated in O(n). No guarantees are made on the ordering.
                 *
                 * ```
                 * contract Example {
                 *     // Add the library methods
                 *     using EnumerableMap for EnumerableMap.UintToAddressMap;
                 *
                 *     // Declare a set state variable
                 *     EnumerableMap.UintToAddressMap private myMap;
                 * }
                 * ```
                 *
                 * As of v3.0.0, only maps of type `uint256 -> address` (`UintToAddressMap`) are
                 * supported.
                 */
                library EnumerableMap {
                    // To implement this library for multiple types with as little code
                    // repetition as possible, we write it in terms of a generic Map type with
                    // bytes32 keys and values.
                    // The Map implementation uses private functions, and user-facing
                    // implementations (such as Uint256ToAddressMap) are just wrappers around
                    // the underlying Map.
                    // This means that we can only create new EnumerableMaps for types that fit
                    // in bytes32.
                    struct MapEntry {
                        bytes32 _key;
                        bytes32 _value;
                    }
                    struct Map {
                        // Storage of map keys and values
                        MapEntry[] _entries;
                        // Position of the entry defined by a key in the `entries` array, plus 1
                        // because index 0 means a key is not in the map.
                        mapping (bytes32 => uint256) _indexes;
                    }
                    /**
                     * @dev Adds a key-value pair to a map, or updates the value for an existing
                     * key. O(1).
                     *
                     * Returns true if the key was added to the map, that is if it was not
                     * already present.
                     */
                    function _set(Map storage map, bytes32 key, bytes32 value) private returns (bool) {
                        // We read and store the key's index to prevent multiple reads from the same storage slot
                        uint256 keyIndex = map._indexes[key];
                        if (keyIndex == 0) { // Equivalent to !contains(map, key)
                            map._entries.push(MapEntry({ _key: key, _value: value }));
                            // The entry is stored at length-1, but we add 1 to all indexes
                            // and use 0 as a sentinel value
                            map._indexes[key] = map._entries.length;
                            return true;
                        } else {
                            map._entries[keyIndex - 1]._value = value;
                            return false;
                        }
                    }
                    /**
                     * @dev Removes a key-value pair from a map. O(1).
                     *
                     * Returns true if the key was removed from the map, that is if it was present.
                     */
                    function _remove(Map storage map, bytes32 key) private returns (bool) {
                        // We read and store the key's index to prevent multiple reads from the same storage slot
                        uint256 keyIndex = map._indexes[key];
                        if (keyIndex != 0) { // Equivalent to contains(map, key)
                            // To delete a key-value pair from the _entries array in O(1), we swap the entry to delete with the last one
                            // in the array, and then remove the last entry (sometimes called as 'swap and pop').
                            // This modifies the order of the array, as noted in {at}.
                            uint256 toDeleteIndex = keyIndex - 1;
                            uint256 lastIndex = map._entries.length - 1;
                            // When the entry to delete is the last one, the swap operation is unnecessary. However, since this occurs
                            // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                            MapEntry storage lastEntry = map._entries[lastIndex];
                            // Move the last entry to the index where the entry to delete is
                            map._entries[toDeleteIndex] = lastEntry;
                            // Update the index for the moved entry
                            map._indexes[lastEntry._key] = toDeleteIndex + 1; // All indexes are 1-based
                            // Delete the slot where the moved entry was stored
                            map._entries.pop();
                            // Delete the index for the deleted slot
                            delete map._indexes[key];
                            return true;
                        } else {
                            return false;
                        }
                    }
                    /**
                     * @dev Returns true if the key is in the map. O(1).
                     */
                    function _contains(Map storage map, bytes32 key) private view returns (bool) {
                        return map._indexes[key] != 0;
                    }
                    /**
                     * @dev Returns the number of key-value pairs in the map. O(1).
                     */
                    function _length(Map storage map) private view returns (uint256) {
                        return map._entries.length;
                    }
                   /**
                    * @dev Returns the key-value pair stored at position `index` in the map. O(1).
                    *
                    * Note that there are no guarantees on the ordering of entries inside the
                    * array, and it may change when more entries are added or removed.
                    *
                    * Requirements:
                    *
                    * - `index` must be strictly less than {length}.
                    */
                    function _at(Map storage map, uint256 index) private view returns (bytes32, bytes32) {
                        require(map._entries.length > index, "EnumerableMap: index out of bounds");
                        MapEntry storage entry = map._entries[index];
                        return (entry._key, entry._value);
                    }
                    /**
                     * @dev Tries to returns the value associated with `key`.  O(1).
                     * Does not revert if `key` is not in the map.
                     */
                    function _tryGet(Map storage map, bytes32 key) private view returns (bool, bytes32) {
                        uint256 keyIndex = map._indexes[key];
                        if (keyIndex == 0) return (false, 0); // Equivalent to contains(map, key)
                        return (true, map._entries[keyIndex - 1]._value); // All indexes are 1-based
                    }
                    /**
                     * @dev Returns the value associated with `key`.  O(1).
                     *
                     * Requirements:
                     *
                     * - `key` must be in the map.
                     */
                    function _get(Map storage map, bytes32 key) private view returns (bytes32) {
                        uint256 keyIndex = map._indexes[key];
                        require(keyIndex != 0, "EnumerableMap: nonexistent key"); // Equivalent to contains(map, key)
                        return map._entries[keyIndex - 1]._value; // All indexes are 1-based
                    }
                    /**
                     * @dev Same as {_get}, with a custom error message when `key` is not in the map.
                     *
                     * CAUTION: This function is deprecated because it requires allocating memory for the error
                     * message unnecessarily. For custom revert reasons use {_tryGet}.
                     */
                    function _get(Map storage map, bytes32 key, string memory errorMessage) private view returns (bytes32) {
                        uint256 keyIndex = map._indexes[key];
                        require(keyIndex != 0, errorMessage); // Equivalent to contains(map, key)
                        return map._entries[keyIndex - 1]._value; // All indexes are 1-based
                    }
                    // UintToAddressMap
                    struct UintToAddressMap {
                        Map _inner;
                    }
                    /**
                     * @dev Adds a key-value pair to a map, or updates the value for an existing
                     * key. O(1).
                     *
                     * Returns true if the key was added to the map, that is if it was not
                     * already present.
                     */
                    function set(UintToAddressMap storage map, uint256 key, address value) internal returns (bool) {
                        return _set(map._inner, bytes32(key), bytes32(uint256(uint160(value))));
                    }
                    /**
                     * @dev Removes a value from a set. O(1).
                     *
                     * Returns true if the key was removed from the map, that is if it was present.
                     */
                    function remove(UintToAddressMap storage map, uint256 key) internal returns (bool) {
                        return _remove(map._inner, bytes32(key));
                    }
                    /**
                     * @dev Returns true if the key is in the map. O(1).
                     */
                    function contains(UintToAddressMap storage map, uint256 key) internal view returns (bool) {
                        return _contains(map._inner, bytes32(key));
                    }
                    /**
                     * @dev Returns the number of elements in the map. O(1).
                     */
                    function length(UintToAddressMap storage map) internal view returns (uint256) {
                        return _length(map._inner);
                    }
                   /**
                    * @dev Returns the element stored at position `index` in the set. O(1).
                    * Note that there are no guarantees on the ordering of values inside the
                    * array, and it may change when more values are added or removed.
                    *
                    * Requirements:
                    *
                    * - `index` must be strictly less than {length}.
                    */
                    function at(UintToAddressMap storage map, uint256 index) internal view returns (uint256, address) {
                        (bytes32 key, bytes32 value) = _at(map._inner, index);
                        return (uint256(key), address(uint160(uint256(value))));
                    }
                    /**
                     * @dev Tries to returns the value associated with `key`.  O(1).
                     * Does not revert if `key` is not in the map.
                     *
                     * _Available since v3.4._
                     */
                    function tryGet(UintToAddressMap storage map, uint256 key) internal view returns (bool, address) {
                        (bool success, bytes32 value) = _tryGet(map._inner, bytes32(key));
                        return (success, address(uint160(uint256(value))));
                    }
                    /**
                     * @dev Returns the value associated with `key`.  O(1).
                     *
                     * Requirements:
                     *
                     * - `key` must be in the map.
                     */
                    function get(UintToAddressMap storage map, uint256 key) internal view returns (address) {
                        return address(uint160(uint256(_get(map._inner, bytes32(key)))));
                    }
                    /**
                     * @dev Same as {get}, with a custom error message when `key` is not in the map.
                     *
                     * CAUTION: This function is deprecated because it requires allocating memory for the error
                     * message unnecessarily. For custom revert reasons use {tryGet}.
                     */
                    function get(UintToAddressMap storage map, uint256 key, string memory errorMessage) internal view returns (address) {
                        return address(uint160(uint256(_get(map._inner, bytes32(key), errorMessage))));
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @dev String operations.
                 */
                library Strings {
                    bytes16 private constant alphabet = "0123456789abcdef";
                    /**
                     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
                     */
                    function toString(uint256 value) internal pure returns (string memory) {
                        // Inspired by OraclizeAPI's implementation - MIT licence
                        // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
                        if (value == 0) {
                            return "0";
                        }
                        uint256 temp = value;
                        uint256 digits;
                        while (temp != 0) {
                            digits++;
                            temp /= 10;
                        }
                        bytes memory buffer = new bytes(digits);
                        while (value != 0) {
                            digits -= 1;
                            buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                            value /= 10;
                        }
                        return string(buffer);
                    }
                    /**
                     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
                     */
                    function toHexString(uint256 value) internal pure returns (string memory) {
                        if (value == 0) {
                            return "0x00";
                        }
                        uint256 temp = value;
                        uint256 length = 0;
                        while (temp != 0) {
                            length++;
                            temp >>= 8;
                        }
                        return toHexString(value, length);
                    }
                    /**
                     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
                     */
                    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                        bytes memory buffer = new bytes(2 * length + 2);
                        buffer[0] = "0";
                        buffer[1] = "x";
                        for (uint256 i = 2 * length + 1; i > 1; --i) {
                            buffer[i] = alphabet[value & 0xf];
                            value >>= 4;
                        }
                        require(value == 0, "Strings: hex length insufficient");
                        return string(buffer);
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @dev Interface of the ERC165 standard, as defined in the
                 * https://eips.ethereum.org/EIPS/eip-165[EIP].
                 *
                 * Implementers can declare support of contract interfaces, which can then be
                 * queried by others ({ERC165Checker}).
                 *
                 * For an implementation, see {ERC165}.
                 */
                interface IERC165 {
                    /**
                     * @dev Returns true if this contract implements the interface defined by
                     * `interfaceId`. See the corresponding
                     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
                     * to learn more about how these ids are created.
                     *
                     * This function call must use less than 30 000 gas.
                     */
                    function supportsInterface(bytes4 interfaceId) external view returns (bool);
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                import "../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.
                 *
                 * 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 Ownable is Context {
                    address private _owner;
                    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                    /**
                     * @dev Initializes the contract setting the deployer as the initial owner.
                     */
                    constructor () {
                        address msgSender = _msgSender();
                        _owner = msgSender;
                        emit OwnershipTransferred(address(0), msgSender);
                    }
                    /**
                     * @dev Returns the address of the current owner.
                     */
                    function owner() public view virtual returns (address) {
                        return _owner;
                    }
                    /**
                     * @dev Throws if called by any account other than the owner.
                     */
                    modifier onlyOwner() {
                        require(owner() == _msgSender(), "Ownable: caller is not the owner");
                        _;
                    }
                    /**
                     * @dev Leaves the contract without owner. It will not be possible to call
                     * `onlyOwner` functions anymore. Can only be called by the current owner.
                     *
                     * NOTE: Renouncing ownership will leave the contract without an owner,
                     * thereby removing any functionality that is only available to the owner.
                     */
                    function renounceOwnership() public virtual onlyOwner {
                        emit OwnershipTransferred(_owner, address(0));
                        _owner = 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");
                        emit OwnershipTransferred(_owner, newOwner);
                        _owner = newOwner;
                    }
                }
                //SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                interface ISettings {
                    function maxAuctionLength() external returns(uint256);
                    function minAuctionLength() external returns(uint256);
                    function maxCuratorFee() external returns(uint256);
                    function governanceFee() external returns(uint256);
                    function minBidIncrease() external returns(uint256);
                    function minVotePercentage() external returns(uint256);
                    function maxReserveFactor() external returns(uint256);
                    function minReserveFactor() external returns(uint256);
                    function feeReceiver() external returns(address payable);
                }// SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @title ERC721 token receiver interface
                 * @dev Interface for any contract that wants to support safeTransfers
                 * from ERC721 asset contracts.
                 */
                interface IERC721ReceiverUpgradeable {
                    /**
                     * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
                     * by `operator` from `from`, this function is called.
                     *
                     * It must return its Solidity selector to confirm the token transfer.
                     * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
                     *
                     * The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.
                     */
                    function onERC721Received(
                        address operator,
                        address from,
                        uint256 tokenId,
                        bytes calldata data
                    ) external returns (bytes4);
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @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 a proxied contract can't have 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.
                 *
                 * 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.
                 */
                abstract contract Initializable {
                    /**
                     * @dev Indicates that the contract has been initialized.
                     */
                    bool private _initialized;
                    /**
                     * @dev Indicates that the contract is in the process of being initialized.
                     */
                    bool private _initializing;
                    /**
                     * @dev Modifier to protect an initializer function from being invoked twice.
                     */
                    modifier initializer() {
                        require(_initializing || !_initialized, "Initializable: contract is already initialized");
                        bool isTopLevelCall = !_initializing;
                        if (isTopLevelCall) {
                            _initializing = true;
                            _initialized = true;
                        }
                        _;
                        if (isTopLevelCall) {
                            _initializing = false;
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                pragma solidity ^0.8.0;
                /**
                 * @dev Interface of the ERC20 standard as defined in the EIP.
                 */
                interface IERC20Upgradeable {
                    /**
                     * @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 `recipient`.
                     *
                     * Returns a boolean value indicating whether the operation succeeded.
                     *
                     * Emits a {Transfer} event.
                     */
                    function transfer(address recipient, 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 `sender` to `recipient` 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 sender,
                        address recipient,
                        uint256 amount
                    ) external returns (bool);
                    /**
                     * @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);
                }
                // SPDX-License-Identifier: MIT
                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
                pragma solidity ^0.8.0;
                import "../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 initializer {
                        __Context_init_unchained();
                    }
                    function __Context_init_unchained() internal initializer {
                    }
                    function _msgSender() internal view virtual returns (address) {
                        return msg.sender;
                    }
                    function _msgData() internal view virtual returns (bytes calldata) {
                        return msg.data;
                    }
                    uint256[50] private __gap;
                }