ETH Price: $2,521.59 (-0.18%)

Transaction Decoder

Block:
19761790 at Apr-29-2024 03:14:35 PM +UTC
Transaction Fee:
0.001238829304995384 ETH $3.12
Gas Used:
118,303 Gas / 10.471664328 Gwei

Account State Difference:

  Address   Before After State Difference Code
(Titan Builder)
11.791290805658029677 Eth11.791291397173029677 Eth0.000000591515
0x61157968...74ad1C3b6
0.557977631126631272 Eth
Nonce: 7
0.556738801821635888 Eth
Nonce: 8
0.001238829304995384

Execution Trace

AggregationRouterV5.swap( executor=0x5F515F6C524B18cA30f7783Fb58Dd4bE2e9904EC, desc=[{name:srcToken, type:address, order:1, indexed:false, value:0x6De037ef9aD2725EB40118Bb1702EBb27e4Aeb24, valueString:0x6De037ef9aD2725EB40118Bb1702EBb27e4Aeb24}, {name:dstToken, type:address, order:2, indexed:false, value:0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE, valueString:0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE}, {name:srcReceiver, type:address, order:3, indexed:false, value:0x5F515F6C524B18cA30f7783Fb58Dd4bE2e9904EC, valueString:0x5F515F6C524B18cA30f7783Fb58Dd4bE2e9904EC}, {name:dstReceiver, type:address, order:4, indexed:false, value:0x61157968CE4D84b13BF8C1921Cf34F574ad1C3b6, valueString:0x61157968CE4D84b13BF8C1921Cf34F574ad1C3b6}, {name:amount, type:uint256, order:5, indexed:false, value:42329358960000000000, valueString:42329358960000000000}, {name:minReturnAmount, type:uint256, order:6, indexed:false, value:102334989001494545, valueString:102334989001494545}, {name:flags, type:uint256, order:7, indexed:false, value:4, valueString:4}], permit=0x, data=0x3B1F8B06AA084614C92C6CE29CCA4B38F1DBA6A1AC35FF30F8CD7F2467D4380179EE74C327A37630B062EBC18F0F98DA2CDE8EC15F3A31C4F6022DDDB75A99590000000000000000000000000000000002B300029D00026100006800004E802026678DCD6DE037EF9AD2725EB40118BB1702EBB27E4AEB24D17A89F1BB2C9CD6D6D8C34E3C847E2E3DDC11D80000000000000000000000000000000000000000000000000594A61CF99E1A000020D6BDBF786DE037EF9AD2725EB40118BB1702EBB27E4AEB2400A0860A32EC00000000000000000000000000000000000000000000000245DB7197232E46000001D051201111111254EEB25477B68FB85ED929F73A9605826DE037EF9AD2725EB40118BB1702EBB27E4AEB2401043ECA9C0A0000000000000000000000000000000000000000662FB936000000000098AFC8000000000000000000000000C02AAA39B223FE8D0A0E5C4F27EAD9083C756CC20000000000000000000000006DE037EF9AD2725EB40118BB1702EBB27E4AEB24000000000000000000000000CE5BE4B74B6217D14606C744EC8024562A56E4060000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000016D56DBD03FF18F00000000000000000000000000000000000000000000000245DB7197232E4600000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041833F7A907F0A792294430C3A0AB417B3D4DC07064C4328138FB0D849BAECA2F6023CBB191C110F805119C7FD1533F323C9F24D78727FEB2F9522280F99688A861B000000000000000000000000000000000000000000000000000000000000004101C02AAA39B223FE8D0A0E5C4F27EAD9083C756CC200042E1A7D4D0000000000000000000000000000000000000000000000000000000000000000C0611111111254EEB25477B68FB85ED929F73A960582 ) => ( returnAmount=3311956922, spentAmount=0 )
  • AdminUpgradeabilityProxy.23b872dd( )
    • RenderToken.transferFrom( _from=0x61157968CE4D84b13BF8C1921Cf34F574ad1C3b6, _to=0x5F515F6C524B18cA30f7783Fb58Dd4bE2e9904EC, _value=42329358960000000000 ) => ( True )
    • 0x5f515f6c524b18ca30f7783fb58dd4be2e9904ec.4b64e492( )
      • Null: 0x000...001.f540770c( )
      • 0x5f515f6c524b18ca30f7783fb58dd4be2e9904ec.26678dcd( )
        • AdminUpgradeabilityProxy.a9059cbb( )
          • RenderToken.transfer( _to=0xd17a89F1bB2C9cD6d6d8C34E3C847E2E3Ddc11d8, _value=402128910120000000 ) => ( True )
          • 0x5f515f6c524b18ca30f7783fb58dd4be2e9904ec.d6bdbf78( )
            • AdminUpgradeabilityProxy.70a08231( )
              • RenderToken.balanceOf( _owner=0x5F515F6C524B18cA30f7783Fb58Dd4bE2e9904EC ) => ( 41927230049880000001 )
              • 0x5f515f6c524b18ca30f7783fb58dd4be2e9904ec.860a32ec( )
                • AdminUpgradeabilityProxy.095ea7b3( )
                  • RenderToken.approve( _spender=0x1111111254EEB25477B68fb85Ed929f73A960582, _value=41927230049880000000 ) => ( True )
                  • AggregationRouterV5.fillOrderRFQ( order=[{name:info, type:uint256, order:1, indexed:false, value:31625165149222595445829185480, valueString:31625165149222595445829185480}, {name:makerAsset, type:address, order:2, indexed:false, value:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2, valueString:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2}, {name:takerAsset, type:address, order:3, indexed:false, value:0x6De037ef9aD2725EB40118Bb1702EBb27e4Aeb24, valueString:0x6De037ef9aD2725EB40118Bb1702EBb27e4Aeb24}, {name:maker, type:address, order:4, indexed:false, value:0xce5Be4b74b6217D14606c744EC8024562a56e406, valueString:0xce5Be4b74b6217D14606c744EC8024562a56e406}, {name:allowedSender, type:address, order:5, indexed:false, value:0x0000000000000000000000000000000000000000, valueString:0x0000000000000000000000000000000000000000}, {name:makingAmount, type:uint256, order:6, indexed:false, value:102833868591067535, valueString:102833868591067535}, {name:takingAmount, type:uint256, order:7, indexed:false, value:41927230049880000000, valueString:41927230049880000000}], signature=0x833F7A907F0A792294430C3A0AB417B3D4DC07064C4328138FB0D849BAECA2F6023CBB191C110F805119C7FD1533F323C9F24D78727FEB2F9522280F99688A861B, flagsAndAmount=41927230049880000000 ) => ( 3311956922, 0, )
                    • Null: 0x000...001.dddfe529( )
                      File 1 of 3: AggregationRouterV5
                      /*
                                                                                 ,▄▓▓██▌   ,╓▄▄▓▓▓▓▓▓▓▓▄▄▄,,
                                                                              ,▓██▓███▓▄▓███▓╬╬╬╬╬╬╬╬╬╬╬╬╬▓███▓▄,
                                                                        ▄█   ▓██╬╣███████╬▓▀╬╬▓▓▓████████████▓█████▄,
                                                                       ▓██▌ ▓██╬╣██████╬▓▌  ██████████████████████▌╙╙▀ⁿ
                                                                      ▐████████╬▓████▓▓█╨ ▄ ╟█████████▓▓╬╬╬╬╬▓▓█████▓▄
                                                        └▀▓▓▄╓        ╟█▓╣█████▓██████▀ ╓█▌ ███████▓▓▓▓▓╬╬╬╬╬╬╬╬╬╬╬╬▓██▓▄
                                                           └▀████▓▄╥  ▐██╬╬██████████╙ Æ▀─ ▓███▀╚╠╬╩▀▀███████▓▓╬╬╬╬╬╬╬╬╬██▄
                                                              └▀██▓▀▀█████▓╬▓██████▀     ▄█████▒╠"      └╙▓██████▓╬╬╬╬╬╬╬╬██▄
                                                                 └▀██▄,└╙▀▀████▌└╙    ^"▀╙╙╙"╙██      @▄    ╙▀███████╬╬╬╬╬╬╬██µ
                                                                    └▀██▓▄, ██▌       ╒       ╙█▓     ]▓█▓╔    ▀███████▓╬╬╬╬╬▓█▌
                                                                        ▀█████       ▓         ╟█▌    ]╠██▓░▒╓   ▀████████╬╬╬╬╣█▌
                                                                        ▐████      ╓█▀█▌      ,██▌    ╚Å███▓▒▒╠╓  ╙█████████╬╬╬╣█▌
                                                                        └████     ▓█░░▓█      ▀▀▀    φ▒╫████▒▒▒▒╠╓  █████████▓╬╬▓█µ
                                                                         ╘███µ ▌▄█▓▄▓▀`     ,▀    ,╔╠░▓██████▌╠▒▒▒φ  ██████████╬╬██
                                                                         ▐████µ╙▓▀`     ,▀╙,╔╔φφφ╠░▄▓███████▌░▓╙▒▒▒╠ └██╬███████╬▓█⌐
                                                                         ╫██ ▓▌         ▌φ▒▒░▓██████████████▌▒░▓╚▒▒▒╠ ▓██╬▓██████╣█▌
                                                                         ██▌           ▌╔▒▒▄████████████████▒▒▒░▌╠▒▒▒≥▐██▓╬╬███████▌
                                                                         ██▌      ,╓φ╠▓«▒▒▓████▀  ▀█████████▌▒▒▒╟░▒▒▒▒▐███╬╬╣████▓█▌
                                                                        ▐██      ╠▒▄▓▓███▓████└     ▀████████▌▒▒░▌╚▒▒▒▐███▓╬╬████ ╙▌
                                                                        ███  )  ╠▒░░░▒░╬████▀        └████████░▒▒░╬∩▒▒▓████╬╬╣███
                                                                       ▓██    ╠╠▒▒▐█▀▀▌`░╫██           ███████▒▒▒▒░▒▒½█████╬╬╣███
                                                                      ███ ,█▄ ╠▒▒▒╫▌,▄▀,▒╫██           ╟██████▒▒▒░╣⌠▒▓█████╬╬╣██▌
                                                                     ╘██µ ██` ╠▒▒░██╬φ╠▄▓██`            ██████░░▌φ╠░▓█████▓╬╬▓██
                                                                      ╟██  .φ╠▒░▄█▀░░▄██▀└              █████▌▒╣φ▒░▓██████╬╬╣██
                                                                       ▀██▄▄▄╓▄███████▀                ▐█████░▓φ▒▄███████▓╬╣██
                                                                         ╙▀▀▀██▀└                      ████▓▄▀φ▄▓████████╬▓█▀
                                                                                                      ▓███╬╩╔╣██████████▓██└
                                                                                                    ╓████▀▄▓████████▀████▀
                                                                                                  ,▓███████████████─]██╙
                                                                                               ,▄▓██████████████▀└  ╙
                                                                                          ,╓▄▓███████████████▀╙
                                                                                   `"▀▀▀████████▀▀▀▀`▄███▀▀└
                                                                                                    └└
                      
                      
                      
                                          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 |
                                                                      \__|  \__| \______/  \______/    \____/  \_______|\__|
                      */
                      
                      // SPDX-License-Identifier: MIT
                      
                      // File contracts/interfaces/IClipperExchangeInterface.sol
                      
                      
                      pragma solidity 0.8.17;
                      
                      /// @title Clipper interface subset used in swaps
                      interface IClipperExchangeInterface {
                          struct Signature {
                              uint8 v;
                              bytes32 r;
                              bytes32 s;
                          }
                      
                          function sellEthForToken(address outputToken, uint256 inputAmount, uint256 outputAmount, uint256 goodUntil, address destinationAddress, Signature calldata theSignature, bytes calldata auxiliaryData) external payable;
                          function sellTokenForEth(address inputToken, uint256 inputAmount, uint256 outputAmount, uint256 goodUntil, address destinationAddress, Signature calldata theSignature, bytes calldata auxiliaryData) external;
                          function swap(address inputToken, address outputToken, uint256 inputAmount, uint256 outputAmount, uint256 goodUntil, address destinationAddress, Signature calldata theSignature, bytes calldata auxiliaryData) external;
                      }
                      
                      
                      // File contracts/helpers/RouterErrors.sol
                      
                      
                      pragma solidity 0.8.17;
                      
                      library RouterErrors {
                          error ReturnAmountIsNotEnough();
                          error InvalidMsgValue();
                          error ERC20TransferFailed();
                      }
                      
                      
                      // File @1inch/solidity-utils/contracts/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      abstract contract EthReceiver {
                          error EthDepositRejected();
                      
                          receive() external payable {
                              _receive();
                          }
                      
                          function _receive() internal virtual {
                              // solhint-disable-next-line avoid-tx-origin
                              if (msg.sender == tx.origin) revert EthDepositRejected();
                          }
                      }
                      
                      
                      // File @openzeppelin/contracts/token/ERC20/[email protected]
                      
                      // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol)
                      
                      pragma solidity ^0.8.0;
                      
                      /**
                       * @dev Interface of the ERC20 standard as defined in the EIP.
                       */
                      interface IERC20 {
                          /**
                           * @dev Emitted when `value` tokens are moved from one account (`from`) to
                           * another (`to`).
                           *
                           * Note that `value` may be zero.
                           */
                          event Transfer(address indexed from, address indexed to, uint256 value);
                      
                          /**
                           * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                           * a call to {approve}. `value` is the new allowance.
                           */
                          event Approval(address indexed owner, address indexed spender, uint256 value);
                      
                          /**
                           * @dev Returns the amount of tokens in existence.
                           */
                          function totalSupply() external view returns (uint256);
                      
                          /**
                           * @dev Returns the amount of tokens owned by `account`.
                           */
                          function balanceOf(address account) external view returns (uint256);
                      
                          /**
                           * @dev Moves `amount` tokens from the caller's account to `to`.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * Emits a {Transfer} event.
                           */
                          function transfer(address to, uint256 amount) external returns (bool);
                      
                          /**
                           * @dev Returns the remaining number of tokens that `spender` will be
                           * allowed to spend on behalf of `owner` through {transferFrom}. This is
                           * zero by default.
                           *
                           * This value changes when {approve} or {transferFrom} are called.
                           */
                          function allowance(address owner, address spender) external view returns (uint256);
                      
                          /**
                           * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * IMPORTANT: Beware that changing an allowance with this method brings the risk
                           * that someone may use both the old and the new allowance by unfortunate
                           * transaction ordering. One possible solution to mitigate this race
                           * condition is to first reduce the spender's allowance to 0 and set the
                           * desired value afterwards:
                           * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                           *
                           * Emits an {Approval} event.
                           */
                          function approve(address spender, uint256 amount) external returns (bool);
                      
                          /**
                           * @dev Moves `amount` tokens from `from` to `to` using the
                           * allowance mechanism. `amount` is then deducted from the caller's
                           * allowance.
                           *
                           * Returns a boolean value indicating whether the operation succeeded.
                           *
                           * Emits a {Transfer} event.
                           */
                          function transferFrom(
                              address from,
                              address to,
                              uint256 amount
                          ) external returns (bool);
                      }
                      
                      
                      // File @1inch/solidity-utils/contracts/interfaces/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      
                      interface IDaiLikePermit {
                          function permit(address holder, address spender, uint256 nonce, uint256 expiry, bool allowed, uint8 v, bytes32 r, bytes32 s) external;
                      }
                      
                      
                      // File @1inch/solidity-utils/contracts/libraries/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      library RevertReasonForwarder {
                          function reRevert() internal pure {
                              // bubble up revert reason from latest external call
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let ptr := mload(0x40)
                                  returndatacopy(ptr, 0, returndatasize())
                                  revert(ptr, returndatasize())
                              }
                          }
                      }
                      
                      
                      // File @openzeppelin/contracts/token/ERC20/extensions/[email protected]
                      
                      // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-IERC20Permit.sol)
                      
                      pragma solidity ^0.8.0;
                      
                      /**
                       * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
                       * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
                       *
                       * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
                       * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
                       * need to send a transaction, and thus is not required to hold Ether at all.
                       */
                      interface IERC20Permit {
                          /**
                           * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
                           * given ``owner``'s signed approval.
                           *
                           * IMPORTANT: The same issues {IERC20-approve} has related to transaction
                           * ordering also apply here.
                           *
                           * Emits an {Approval} event.
                           *
                           * Requirements:
                           *
                           * - `spender` cannot be the zero address.
                           * - `deadline` must be a timestamp in the future.
                           * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
                           * over the EIP712-formatted function arguments.
                           * - the signature must use ``owner``'s current nonce (see {nonces}).
                           *
                           * For more information on the signature format, see the
                           * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
                           * section].
                           */
                          function permit(
                              address owner,
                              address spender,
                              uint256 value,
                              uint256 deadline,
                              uint8 v,
                              bytes32 r,
                              bytes32 s
                          ) external;
                      
                          /**
                           * @dev Returns the current nonce for `owner`. This value must be
                           * included whenever a signature is generated for {permit}.
                           *
                           * Every successful call to {permit} increases ``owner``'s nonce by one. This
                           * prevents a signature from being used multiple times.
                           */
                          function nonces(address owner) external view returns (uint256);
                      
                          /**
                           * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
                           */
                          // solhint-disable-next-line func-name-mixedcase
                          function DOMAIN_SEPARATOR() external view returns (bytes32);
                      }
                      
                      
                      // File @1inch/solidity-utils/contracts/libraries/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      
                      
                      
                      library SafeERC20 {
                          error SafeTransferFailed();
                          error SafeTransferFromFailed();
                          error ForceApproveFailed();
                          error SafeIncreaseAllowanceFailed();
                          error SafeDecreaseAllowanceFailed();
                          error SafePermitBadLength();
                      
                          // Ensures method do not revert or return boolean `true`, admits call to non-smart-contract
                          function safeTransferFrom(IERC20 token, address from, address to, uint256 amount) internal {
                              bytes4 selector = token.transferFrom.selector;
                              bool success;
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let data := mload(0x40)
                      
                                  mstore(data, selector)
                                  mstore(add(data, 0x04), from)
                                  mstore(add(data, 0x24), to)
                                  mstore(add(data, 0x44), amount)
                                  success := call(gas(), token, 0, data, 100, 0x0, 0x20)
                                  if success {
                                      switch returndatasize()
                                      case 0 { success := gt(extcodesize(token), 0) }
                                      default { success := and(gt(returndatasize(), 31), eq(mload(0), 1)) }
                                  }
                              }
                              if (!success) revert SafeTransferFromFailed();
                          }
                      
                          // Ensures method do not revert or return boolean `true`, admits call to non-smart-contract
                          function safeTransfer(IERC20 token, address to, uint256 value) internal {
                              if (!_makeCall(token, token.transfer.selector, to, value)) {
                                  revert SafeTransferFailed();
                              }
                          }
                      
                          // If `approve(from, to, amount)` fails, try to `approve(from, to, 0)` before retry
                          function forceApprove(IERC20 token, address spender, uint256 value) internal {
                              if (!_makeCall(token, token.approve.selector, spender, value)) {
                                  if (!_makeCall(token, token.approve.selector, spender, 0) ||
                                      !_makeCall(token, token.approve.selector, spender, value))
                                  {
                                      revert ForceApproveFailed();
                                  }
                              }
                          }
                      
                          function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                              uint256 allowance = token.allowance(address(this), spender);
                              if (value > type(uint256).max - allowance) revert SafeIncreaseAllowanceFailed();
                              forceApprove(token, spender, allowance + value);
                          }
                      
                          function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                              uint256 allowance = token.allowance(address(this), spender);
                              if (value > allowance) revert SafeDecreaseAllowanceFailed();
                              forceApprove(token, spender, allowance - value);
                          }
                      
                          function safePermit(IERC20 token, bytes calldata permit) internal {
                              bool success;
                              if (permit.length == 32 * 7) {
                                  success = _makeCalldataCall(token, IERC20Permit.permit.selector, permit);
                              } else if (permit.length == 32 * 8) {
                                  success = _makeCalldataCall(token, IDaiLikePermit.permit.selector, permit);
                              } else {
                                  revert SafePermitBadLength();
                              }
                              if (!success) RevertReasonForwarder.reRevert();
                          }
                      
                          function _makeCall(IERC20 token, bytes4 selector, address to, uint256 amount) private returns(bool success) {
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let data := mload(0x40)
                      
                                  mstore(data, selector)
                                  mstore(add(data, 0x04), to)
                                  mstore(add(data, 0x24), amount)
                                  success := call(gas(), token, 0, data, 0x44, 0x0, 0x20)
                                  if success {
                                      switch returndatasize()
                                      case 0 { success := gt(extcodesize(token), 0) }
                                      default { success := and(gt(returndatasize(), 31), eq(mload(0), 1)) }
                                  }
                              }
                          }
                      
                          function _makeCalldataCall(IERC20 token, bytes4 selector, bytes calldata args) private returns(bool success) {
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let len := add(4, args.length)
                                  let data := mload(0x40)
                      
                                  mstore(data, selector)
                                  calldatacopy(add(data, 0x04), args.offset, args.length)
                                  success := call(gas(), token, 0, data, len, 0x0, 0x20)
                                  if success {
                                      switch returndatasize()
                                      case 0 { success := gt(extcodesize(token), 0) }
                                      default { success := and(gt(returndatasize(), 31), eq(mload(0), 1)) }
                                  }
                              }
                          }
                      }
                      
                      
                      // File @1inch/solidity-utils/contracts/interfaces/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      interface IWETH is IERC20 {
                          function deposit() external payable;
                          function withdraw(uint256 amount) external;
                      }
                      
                      
                      // File contracts/routers/ClipperRouter.sol
                      
                      
                      pragma solidity 0.8.17;
                      
                      
                      
                      
                      
                      
                      /// @title Clipper router that allows to use `ClipperExchangeInterface` for swaps
                      contract ClipperRouter is EthReceiver {
                          using SafeERC20 for IERC20;
                      
                          uint256 private constant _SIGNATURE_S_MASK = 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff;
                          uint256 private constant _SIGNATURE_V_SHIFT = 255;
                          bytes6 private constant _INCH_TAG_WITH_LENGTH_PREFIX = "\x051INCH";
                          IERC20 private constant _ETH = IERC20(address(0));
                          IWETH private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                      
                          constructor(IWETH weth) {
                              _WETH = weth;
                          }
                      
                          /// @notice Same as `clipperSwapTo` but calls permit first,
                          /// allowing to approve token spending and make a swap in one transaction.
                          /// @dev See tests for examples
                          /// @param recipient Address that will receive swap funds
                          /// @param srcToken Source token
                          /// @param dstToken Destination token
                          /// @param inputAmount Amount of source tokens to swap
                          /// @param outputAmount Amount of destination tokens to receive
                          /// @param goodUntil Timestamp until the swap will be valid
                          /// @param r Clipper order signature (r part)
                          /// @param vs Clipper order signature (vs part)
                          /// @param permit Should contain valid permit that can be used in `IERC20Permit.permit` calls.
                          /// @return returnAmount Amount of destination tokens received
                          function clipperSwapToWithPermit(
                              IClipperExchangeInterface clipperExchange,
                              address payable recipient,
                              IERC20 srcToken,
                              IERC20 dstToken,
                              uint256 inputAmount,
                              uint256 outputAmount,
                              uint256 goodUntil,
                              bytes32 r,
                              bytes32 vs,
                              bytes calldata permit
                          ) external returns(uint256 returnAmount) {
                              srcToken.safePermit(permit);
                              return clipperSwapTo(clipperExchange, recipient, srcToken, dstToken, inputAmount, outputAmount, goodUntil, r, vs);
                          }
                      
                          /// @notice Same as `clipperSwapTo` but uses `msg.sender` as recipient
                          /// @param srcToken Source token
                          /// @param dstToken Destination token
                          /// @param inputAmount Amount of source tokens to swap
                          /// @param outputAmount Amount of destination tokens to receive
                          /// @param goodUntil Timestamp until the swap will be valid
                          /// @param r Clipper order signature (r part)
                          /// @param vs Clipper order signature (vs part)
                          /// @return returnAmount Amount of destination tokens received
                          function clipperSwap(
                              IClipperExchangeInterface clipperExchange,
                              IERC20 srcToken,
                              IERC20 dstToken,
                              uint256 inputAmount,
                              uint256 outputAmount,
                              uint256 goodUntil,
                              bytes32 r,
                              bytes32 vs
                          ) external payable returns(uint256 returnAmount) {
                              return clipperSwapTo(clipperExchange, payable(msg.sender), srcToken, dstToken, inputAmount, outputAmount, goodUntil, r, vs);
                          }
                      
                          /// @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 inputAmount Amount of source tokens to swap
                          /// @param outputAmount Amount of destination tokens to receive
                          /// @param goodUntil Timestamp until the swap will be valid
                          /// @param r Clipper order signature (r part)
                          /// @param vs Clipper order signature (vs part)
                          /// @return returnAmount Amount of destination tokens received
                          function clipperSwapTo(
                              IClipperExchangeInterface clipperExchange,
                              address payable recipient,
                              IERC20 srcToken,
                              IERC20 dstToken,
                              uint256 inputAmount,
                              uint256 outputAmount,
                              uint256 goodUntil,
                              bytes32 r,
                              bytes32 vs
                          ) public payable returns(uint256 returnAmount) {
                              bool srcETH = srcToken == _ETH;
                              if (srcETH) {
                                  if (msg.value != inputAmount) revert RouterErrors.InvalidMsgValue();
                              } else if (srcToken == _WETH) {
                                  srcETH = true;
                                  if (msg.value != 0) revert RouterErrors.InvalidMsgValue();
                                  // _WETH.transferFrom(msg.sender, address(this), inputAmount);
                                  // _WETH.withdraw(inputAmount);
                                  address weth = address(_WETH);
                                  bytes4 transferFromSelector = _WETH.transferFrom.selector;
                                  bytes4 withdrawSelector = _WETH.withdraw.selector;
                                  /// @solidity memory-safe-assembly
                                  assembly { // solhint-disable-line no-inline-assembly
                                      let ptr := mload(0x40)
                      
                                      mstore(ptr, transferFromSelector)
                                      mstore(add(ptr, 0x04), caller())
                                      mstore(add(ptr, 0x24), address())
                                      mstore(add(ptr, 0x44), inputAmount)
                                      if iszero(call(gas(), weth, 0, ptr, 0x64, 0, 0)) {
                                          returndatacopy(ptr, 0, returndatasize())
                                          revert(ptr, returndatasize())
                                      }
                      
                                      mstore(ptr, withdrawSelector)
                                      mstore(add(ptr, 0x04), inputAmount)
                                      if iszero(call(gas(), weth, 0, ptr, 0x24, 0, 0)) {
                                          returndatacopy(ptr, 0, returndatasize())
                                          revert(ptr, returndatasize())
                                      }
                                  }
                              } else {
                                  if (msg.value != 0) revert RouterErrors.InvalidMsgValue();
                                  srcToken.safeTransferFrom(msg.sender, address(clipperExchange), inputAmount);
                              }
                      
                              if (srcETH) {
                                  // clipperExchange.sellEthForToken{value: inputAmount}(address(dstToken), inputAmount, outputAmount, goodUntil, recipient, signature, _INCH_TAG);
                                  address clipper = address(clipperExchange);
                                  bytes4 selector = clipperExchange.sellEthForToken.selector;
                                  /// @solidity memory-safe-assembly
                                  assembly { // solhint-disable-line no-inline-assembly
                                      let ptr := mload(0x40)
                      
                                      mstore(ptr, selector)
                                      mstore(add(ptr, 0x04), dstToken)
                                      mstore(add(ptr, 0x24), inputAmount)
                                      mstore(add(ptr, 0x44), outputAmount)
                                      mstore(add(ptr, 0x64), goodUntil)
                                      mstore(add(ptr, 0x84), recipient)
                                      mstore(add(ptr, 0xa4), add(27, shr(_SIGNATURE_V_SHIFT, vs)))
                                      mstore(add(ptr, 0xc4), r)
                                      mstore(add(ptr, 0xe4), and(vs, _SIGNATURE_S_MASK))
                                      mstore(add(ptr, 0x104), 0x120)
                                      mstore(add(ptr, 0x143), _INCH_TAG_WITH_LENGTH_PREFIX)
                                      if iszero(call(gas(), clipper, inputAmount, ptr, 0x149, 0, 0)) {
                                          returndatacopy(ptr, 0, returndatasize())
                                          revert(ptr, returndatasize())
                                      }
                                  }
                              } else if (dstToken == _ETH || dstToken == _WETH) {
                                  // clipperExchange.sellTokenForEth(address(srcToken), inputAmount, outputAmount, goodUntil, recipient, signature, _INCH_TAG);
                                  address clipper = address(clipperExchange);
                                  bytes4 selector = clipperExchange.sellTokenForEth.selector;
                                  /// @solidity memory-safe-assembly
                                  assembly { // solhint-disable-line no-inline-assembly
                                      let ptr := mload(0x40)
                      
                                      mstore(ptr, selector)
                                      mstore(add(ptr, 0x04), srcToken)
                                      mstore(add(ptr, 0x24), inputAmount)
                                      mstore(add(ptr, 0x44), outputAmount)
                                      mstore(add(ptr, 0x64), goodUntil)
                                      switch iszero(dstToken)
                                      case 1 {
                                          mstore(add(ptr, 0x84), recipient)
                                      }
                                      default {
                                          mstore(add(ptr, 0x84), address())
                                      }
                                      mstore(add(ptr, 0xa4), add(27, shr(_SIGNATURE_V_SHIFT, vs)))
                                      mstore(add(ptr, 0xc4), r)
                                      mstore(add(ptr, 0xe4), and(vs, _SIGNATURE_S_MASK))
                                      mstore(add(ptr, 0x104), 0x120)
                                      mstore(add(ptr, 0x143), _INCH_TAG_WITH_LENGTH_PREFIX)
                                      if iszero(call(gas(), clipper, 0, ptr, 0x149, 0, 0)) {
                                          returndatacopy(ptr, 0, returndatasize())
                                          revert(ptr, returndatasize())
                                      }
                                  }
                      
                                  if (dstToken == _WETH) {
                                      // _WETH.deposit{value: outputAmount}();
                                      // _WETH.transfer(recipient, outputAmount);
                                      address weth = address(_WETH);
                                      bytes4 depositSelector = _WETH.deposit.selector;
                                      bytes4 transferSelector = _WETH.transfer.selector;
                                      /// @solidity memory-safe-assembly
                                      assembly { // solhint-disable-line no-inline-assembly
                                          let ptr := mload(0x40)
                      
                                          mstore(ptr, depositSelector)
                                          if iszero(call(gas(), weth, outputAmount, ptr, 0x04, 0, 0)) {
                                              returndatacopy(ptr, 0, returndatasize())
                                              revert(ptr, returndatasize())
                                          }
                      
                                          mstore(ptr, transferSelector)
                                          mstore(add(ptr, 0x04), recipient)
                                          mstore(add(ptr, 0x24), outputAmount)
                                          if iszero(call(gas(), weth, 0, ptr, 0x44, 0, 0)) {
                                              returndatacopy(ptr, 0, returndatasize())
                                              revert(ptr, returndatasize())
                                          }
                                      }
                                  }
                              } else {
                                  // clipperExchange.swap(address(srcToken), address(dstToken), inputAmount, outputAmount, goodUntil, recipient, signature, _INCH_TAG);
                                  address clipper = address(clipperExchange);
                                  bytes4 selector = clipperExchange.swap.selector;
                                  /// @solidity memory-safe-assembly
                                  assembly { // solhint-disable-line no-inline-assembly
                                      let ptr := mload(0x40)
                      
                                      mstore(ptr, selector)
                                      mstore(add(ptr, 0x04), srcToken)
                                      mstore(add(ptr, 0x24), dstToken)
                                      mstore(add(ptr, 0x44), inputAmount)
                                      mstore(add(ptr, 0x64), outputAmount)
                                      mstore(add(ptr, 0x84), goodUntil)
                                      mstore(add(ptr, 0xa4), recipient)
                                      mstore(add(ptr, 0xc4), add(27, shr(_SIGNATURE_V_SHIFT, vs)))
                                      mstore(add(ptr, 0xe4), r)
                                      mstore(add(ptr, 0x104), and(vs, _SIGNATURE_S_MASK))
                                      mstore(add(ptr, 0x124), 0x140)
                                      mstore(add(ptr, 0x163), _INCH_TAG_WITH_LENGTH_PREFIX)
                                      if iszero(call(gas(), clipper, 0, ptr, 0x169, 0, 0)) {
                                          returndatacopy(ptr, 0, returndatasize())
                                          revert(ptr, returndatasize())
                                      }
                                  }
                              }
                      
                              return outputAmount;
                          }
                      }
                      
                      
                      // File contracts/interfaces/IAggregationExecutor.sol
                      
                      
                      pragma solidity 0.8.17;
                      
                      /// @title Interface for making arbitrary calls during swap
                      interface IAggregationExecutor {
                          /// @notice propagates information about original msg.sender and executes arbitrary data
                          function execute(address msgSender) external payable;  // 0x4b64e492
                      }
                      
                      
                      // File @1inch/solidity-utils/contracts/interfaces/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      
                      interface IERC20MetadataUppercase {
                          function NAME() external view returns (string memory);  // solhint-disable-line func-name-mixedcase
                          function SYMBOL() external view returns (string memory);  // solhint-disable-line func-name-mixedcase
                      }
                      
                      
                      // File @1inch/solidity-utils/contracts/libraries/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      /// @title Library with gas-efficient string operations
                      library StringUtil {
                          function toHex(uint256 value) internal pure returns (string memory) {
                              return toHex(abi.encodePacked(value));
                          }
                      
                          function toHex(address value) internal pure returns (string memory) {
                              return toHex(abi.encodePacked(value));
                          }
                      
                          function toHex(bytes memory data) internal pure returns (string memory result) {
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  function _toHex16(input) -> output {
                                      output := or(
                                          and(input, 0xFFFFFFFFFFFFFFFF000000000000000000000000000000000000000000000000),
                                          shr(64, and(input, 0x0000000000000000FFFFFFFFFFFFFFFF00000000000000000000000000000000))
                                      )
                                      output := or(
                                          and(output, 0xFFFFFFFF000000000000000000000000FFFFFFFF000000000000000000000000),
                                          shr(32, and(output, 0x00000000FFFFFFFF000000000000000000000000FFFFFFFF0000000000000000))
                                      )
                                      output := or(
                                          and(output, 0xFFFF000000000000FFFF000000000000FFFF000000000000FFFF000000000000),
                                          shr(16, and(output, 0x0000FFFF000000000000FFFF000000000000FFFF000000000000FFFF00000000))
                                      )
                                      output := or(
                                          and(output, 0xFF000000FF000000FF000000FF000000FF000000FF000000FF000000FF000000),
                                          shr(8, and(output, 0x00FF000000FF000000FF000000FF000000FF000000FF000000FF000000FF0000))
                                      )
                                      output := or(
                                          shr(4, and(output, 0xF000F000F000F000F000F000F000F000F000F000F000F000F000F000F000F000)),
                                          shr(8, and(output, 0x0F000F000F000F000F000F000F000F000F000F000F000F000F000F000F000F00))
                                      )
                                      output := add(
                                          add(0x3030303030303030303030303030303030303030303030303030303030303030, output),
                                          mul(
                                              and(
                                                  shr(4, add(output, 0x0606060606060606060606060606060606060606060606060606060606060606)),
                                                  0x0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F
                                              ),
                                              7   // Change 7 to 39 for lower case output
                                          )
                                      )
                                  }
                      
                                  result := mload(0x40)
                                  let length := mload(data)
                                  let resultLength := shl(1, length)
                                  let toPtr := add(result, 0x22)          // 32 bytes for length + 2 bytes for '0x'
                                  mstore(0x40, add(toPtr, resultLength))  // move free memory pointer
                                  mstore(add(result, 2), 0x3078)          // 0x3078 is right aligned so we write to `result + 2`
                                                                          // to store the last 2 bytes in the beginning of the string
                                  mstore(result, add(resultLength, 2))    // extra 2 bytes for '0x'
                      
                                  for {
                                      let fromPtr := add(data, 0x20)
                                      let endPtr := add(fromPtr, length)
                                  } lt(fromPtr, endPtr) {
                                      fromPtr := add(fromPtr, 0x20)
                                  } {
                                      let rawData := mload(fromPtr)
                                      let hexData := _toHex16(rawData)
                                      mstore(toPtr, hexData)
                                      toPtr := add(toPtr, 0x20)
                                      hexData := _toHex16(shl(128, rawData))
                                      mstore(toPtr, hexData)
                                      toPtr := add(toPtr, 0x20)
                                  }
                              }
                          }
                      }
                      
                      
                      // File @openzeppelin/contracts/token/ERC20/extensions/[email protected]
                      
                      // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
                      
                      pragma solidity ^0.8.0;
                      
                      /**
                       * @dev Interface for the optional metadata functions from the ERC20 standard.
                       *
                       * _Available since v4.1._
                       */
                      interface IERC20Metadata is IERC20 {
                          /**
                           * @dev Returns the name of the token.
                           */
                          function name() external view returns (string memory);
                      
                          /**
                           * @dev Returns the symbol of the token.
                           */
                          function symbol() external view returns (string memory);
                      
                          /**
                           * @dev Returns the decimals places of the token.
                           */
                          function decimals() external view returns (uint8);
                      }
                      
                      
                      // File @1inch/solidity-utils/contracts/libraries/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      
                      
                      
                      
                      library UniERC20 {
                          using SafeERC20 for IERC20;
                      
                          error InsufficientBalance();
                          error ApproveCalledOnETH();
                          error NotEnoughValue();
                          error FromIsNotSender();
                          error ToIsNotThis();
                          error ETHTransferFailed();
                      
                          uint256 private constant _RAW_CALL_GAS_LIMIT = 5000;
                          IERC20 private constant _ETH_ADDRESS = IERC20(0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE);
                          IERC20 private constant _ZERO_ADDRESS = IERC20(address(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);
                              }
                          }
                      
                          /// @dev note that this function does nothing in case of zero amount
                          function uniTransfer(IERC20 token, address payable to, uint256 amount) internal {
                              if (amount > 0) {
                                  if (isETH(token)) {
                                      if (address(this).balance < amount) revert InsufficientBalance();
                                      // solhint-disable-next-line avoid-low-level-calls
                                      (bool success, ) = to.call{value: amount, gas: _RAW_CALL_GAS_LIMIT}("");
                                      if (!success) revert ETHTransferFailed();
                                  } else {
                                      token.safeTransfer(to, amount);
                                  }
                              }
                          }
                      
                          /// @dev note that this function does nothing in case of zero amount
                          function uniTransferFrom(IERC20 token, address payable from, address to, uint256 amount) internal {
                              if (amount > 0) {
                                  if (isETH(token)) {
                                      if (msg.value < amount) revert NotEnoughValue();
                                      if (from != msg.sender) revert FromIsNotSender();
                                      if (to != address(this)) revert ToIsNotThis();
                                      if (msg.value > amount) {
                                          // Return remainder if exist
                                          unchecked {
                                              // solhint-disable-next-line avoid-low-level-calls
                                              (bool success, ) = from.call{value: msg.value - amount, gas: _RAW_CALL_GAS_LIMIT}("");
                                              if (!success) revert ETHTransferFailed();
                                          }
                                      }
                                  } else {
                                      token.safeTransferFrom(from, to, amount);
                                  }
                              }
                          }
                      
                          function uniSymbol(IERC20 token) internal view returns(string memory) {
                              return _uniDecode(token, IERC20Metadata.symbol.selector, IERC20MetadataUppercase.SYMBOL.selector);
                          }
                      
                          function uniName(IERC20 token) internal view returns(string memory) {
                              return _uniDecode(token, IERC20Metadata.name.selector, IERC20MetadataUppercase.NAME.selector);
                          }
                      
                          function uniApprove(IERC20 token, address to, uint256 amount) internal {
                              if (isETH(token)) revert ApproveCalledOnETH();
                      
                              token.forceApprove(to, amount);
                          }
                      
                          /// 20K gas is provided to account for possible implementations of name/symbol
                          /// (token implementation might be behind proxy or store the value in storage)
                          function _uniDecode(IERC20 token, bytes4 lowerCaseSelector, bytes4 upperCaseSelector) private view returns(string memory result) {
                              if (isETH(token)) {
                                  return "ETH";
                              }
                      
                              (bool success, bytes memory data) = address(token).staticcall{ gas: 20000 }(
                                  abi.encodeWithSelector(lowerCaseSelector)
                              );
                              if (!success) {
                                  (success, data) = address(token).staticcall{ gas: 20000 }(
                                      abi.encodeWithSelector(upperCaseSelector)
                                  );
                              }
                      
                              if (success && data.length >= 0x40) {
                                  (uint256 offset, uint256 len) = abi.decode(data, (uint256, uint256));
                                  if (offset == 0x20 && len > 0 && data.length == 0x40 + len) {
                                      /// @solidity memory-safe-assembly
                                      assembly { // solhint-disable-line no-inline-assembly
                                          result := add(data, 0x20)
                                      }
                                      return result;
                                  }
                              }
                      
                              if (success && data.length == 32) {
                                  uint256 len = 0;
                                  while (len < data.length && data[len] >= 0x20 && data[len] <= 0x7E) {
                                      unchecked {
                                          len++;
                                      }
                                  }
                      
                                  if (len > 0) {
                                      /// @solidity memory-safe-assembly
                                      assembly { // solhint-disable-line no-inline-assembly
                                          mstore(data, len)
                                      }
                                      return string(data);
                                  }
                              }
                      
                              return StringUtil.toHex(address(token));
                          }
                      }
                      
                      
                      // File contracts/routers/GenericRouter.sol
                      
                      
                      pragma solidity 0.8.17;
                      
                      
                      
                      
                      
                      contract GenericRouter is EthReceiver {
                          using UniERC20 for IERC20;
                          using SafeERC20 for IERC20;
                      
                          error ZeroMinReturn();
                          error ZeroReturnAmount();
                      
                          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;
                          }
                      
                          /// @notice Performs a swap, delegating all calls encoded in `data` to `executor`. See tests for usage examples
                          /// @dev router keeps 1 wei of every token on the contract balance for gas optimisations reasons. This affects first swap of every token by leaving 1 wei on the contract.
                          /// @param executor Aggregation executor that executes calls described in `data`
                          /// @param desc Swap description
                          /// @param permit Should contain valid permit that can be used in `IERC20Permit.permit` calls.
                          /// @param data Encoded calls that `caller` should execute in between of swaps
                          /// @return returnAmount Resulting token amount
                          /// @return spentAmount Source token amount
                          function swap(
                              IAggregationExecutor executor,
                              SwapDescription calldata desc,
                              bytes calldata permit,
                              bytes calldata data
                          )
                              external
                              payable
                              returns (
                                  uint256 returnAmount,
                                  uint256 spentAmount
                              )
                          {
                              if (desc.minReturnAmount == 0) revert ZeroMinReturn();
                      
                              IERC20 srcToken = desc.srcToken;
                              IERC20 dstToken = desc.dstToken;
                      
                              bool srcETH = srcToken.isETH();
                              if (desc.flags & _REQUIRES_EXTRA_ETH != 0) {
                                  if (msg.value <= (srcETH ? desc.amount : 0)) revert RouterErrors.InvalidMsgValue();
                              } else {
                                  if (msg.value != (srcETH ? desc.amount : 0)) revert RouterErrors.InvalidMsgValue();
                              }
                      
                              if (!srcETH) {
                                  if (permit.length > 0) {
                                      srcToken.safePermit(permit);
                                  }
                                  srcToken.safeTransferFrom(msg.sender, desc.srcReceiver, desc.amount);
                              }
                      
                              _execute(executor, msg.sender, desc.amount, data);
                      
                              spentAmount = desc.amount;
                              // we leave 1 wei on the router for gas optimisations reasons
                              returnAmount = dstToken.uniBalanceOf(address(this));
                              if (returnAmount == 0) revert ZeroReturnAmount();
                              unchecked { returnAmount--; }
                      
                              if (desc.flags & _PARTIAL_FILL != 0) {
                                  uint256 unspentAmount = srcToken.uniBalanceOf(address(this));
                                  if (unspentAmount > 1) {
                                      // we leave 1 wei on the router for gas optimisations reasons
                                      unchecked { unspentAmount--; }
                                      spentAmount -= unspentAmount;
                                      srcToken.uniTransfer(payable(msg.sender), unspentAmount);
                                  }
                                  if (returnAmount * desc.amount < desc.minReturnAmount * spentAmount) revert RouterErrors.ReturnAmountIsNotEnough();
                              } else {
                                  if (returnAmount < desc.minReturnAmount) revert RouterErrors.ReturnAmountIsNotEnough();
                              }
                      
                              address payable dstReceiver = (desc.dstReceiver == address(0)) ? payable(msg.sender) : desc.dstReceiver;
                              dstToken.uniTransfer(dstReceiver, returnAmount);
                          }
                      
                          function _execute(
                              IAggregationExecutor executor,
                              address srcTokenOwner,
                              uint256 inputAmount,
                              bytes calldata data
                          ) private {
                              bytes4 executeSelector = executor.execute.selector;
                              /// @solidity memory-safe-assembly
                              assembly {  // solhint-disable-line no-inline-assembly
                                  let ptr := mload(0x40)
                      
                                  mstore(ptr, executeSelector)
                                  mstore(add(ptr, 0x04), srcTokenOwner)
                                  calldatacopy(add(ptr, 0x24), data.offset, data.length)
                                  mstore(add(add(ptr, 0x24), data.length), inputAmount)
                      
                                  if iszero(call(gas(), executor, callvalue(), ptr, add(0x44, data.length), 0, 0)) {
                                      returndatacopy(ptr, 0, returndatasize())
                                      revert(ptr, returndatasize())
                                  }
                              }
                          }
                      }
                      
                      
                      // File contracts/routers/UnoswapRouter.sol
                      
                      
                      pragma solidity 0.8.17;
                      
                      
                      
                      
                      contract UnoswapRouter is EthReceiver {
                          using SafeERC20 for IERC20;
                      
                          error ReservesCallFailed();
                          error SwapAmountTooLarge();
                      
                          bytes4 private constant _TRANSFER_FROM_CALL_SELECTOR = 0x23b872dd;
                          bytes4 private constant _WETH_DEPOSIT_CALL_SELECTOR = 0xd0e30db0;
                          bytes4 private constant _WETH_WITHDRAW_CALL_SELECTOR = 0x2e1a7d4d;
                          bytes4 private constant _ERC20_TRANSFER_CALL_SELECTOR = 0xa9059cbb;
                          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
                          address private constant _WETH = 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2;
                          bytes4 private constant _UNISWAP_PAIR_RESERVES_CALL_SELECTOR = 0x0902f1ac;
                          bytes4 private constant _UNISWAP_PAIR_SWAP_CALL_SELECTOR = 0x022c0d9f;
                          uint256 private constant _DENOMINATOR = 1e9;
                          uint256 private constant _NUMERATOR_OFFSET = 160;
                          uint256 private constant _MAX_SWAP_AMOUNT = (1 << 112) - 1;  // type(uint112).max;
                      
                          /// @notice Same as `unoswapTo` but calls permit first,
                          /// allowing to approve token spending and make a swap in one transaction.
                          /// @param recipient Address that will receive swapped 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 unoswapToWithPermit(
                              address payable recipient,
                              IERC20 srcToken,
                              uint256 amount,
                              uint256 minReturn,
                              uint256[] calldata pools,
                              bytes calldata permit
                          ) external returns(uint256 returnAmount) {
                              srcToken.safePermit(permit);
                              return _unoswap(recipient, 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 recipient Address that will receive swapped 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
                          function unoswapTo(
                              address payable recipient,
                              IERC20 srcToken,
                              uint256 amount,
                              uint256 minReturn,
                              uint256[] calldata pools
                          ) external payable returns(uint256 returnAmount) {
                              return _unoswap(recipient, 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,
                              uint256[] calldata pools
                          ) external payable returns(uint256 returnAmount) {
                              return _unoswap(payable(msg.sender), srcToken, amount, minReturn, pools);
                          }
                      
                          function _unoswap(
                              address payable recipient,
                              IERC20 srcToken,
                              uint256 amount,
                              uint256 minReturn,
                              uint256[] calldata pools
                          ) private returns(uint256 returnAmount) {
                              assembly {  // solhint-disable-line no-inline-assembly
                                  function reRevert() {
                                      returndatacopy(0, 0, returndatasize())
                                      revert(0, returndatasize())
                                  }
                      
                                  function validateERC20Transfer(status) {
                                      if iszero(status) {
                                          reRevert()
                                      }
                                      let success := or(
                                          iszero(returndatasize()),                       // empty return data
                                          and(gt(returndatasize(), 31), eq(mload(0), 1))  // true in return data
                                      )
                                      if iszero(success) {
                                          mstore(0, 0xf27f64e400000000000000000000000000000000000000000000000000000000)  // ERC20TransferFailed()
                                          revert(0, 4)
                                      }
                                  }
                      
                                  function swap(emptyPtr, swapAmount, pair, reversed, numerator, to) -> ret {
                                      mstore(emptyPtr, _UNISWAP_PAIR_RESERVES_CALL_SELECTOR)
                                      if iszero(staticcall(gas(), pair, emptyPtr, 0x4, emptyPtr, 0x40)) {
                                          reRevert()
                                      }
                                      if iszero(eq(returndatasize(), 0x60)) {
                                          mstore(0, 0x85cd58dc00000000000000000000000000000000000000000000000000000000)  // ReservesCallFailed()
                                          revert(0, 4)
                                      }
                      
                                      let reserve0 := mload(emptyPtr)
                                      let reserve1 := mload(add(emptyPtr, 0x20))
                                      if reversed {
                                          let tmp := reserve0
                                          reserve0 := reserve1
                                          reserve1 := tmp
                                      }
                                      // this will not overflow as reserve0, reserve1 and ret fit to 112 bit and numerator and _DENOMINATOR fit to 32 bit
                                      ret := mul(swapAmount, numerator)
                                      ret := div(mul(ret, reserve1), add(ret, mul(reserve0, _DENOMINATOR)))
                      
                                      mstore(emptyPtr, _UNISWAP_PAIR_SWAP_CALL_SELECTOR)
                                      reversed := iszero(reversed)
                                      mstore(add(emptyPtr, 0x04), mul(ret, iszero(reversed)))
                                      mstore(add(emptyPtr, 0x24), mul(ret, reversed))
                                      mstore(add(emptyPtr, 0x44), to)
                                      mstore(add(emptyPtr, 0x64), 0x80)
                                      mstore(add(emptyPtr, 0x84), 0)
                                      if iszero(call(gas(), pair, 0, emptyPtr, 0xa4, 0, 0)) {
                                          reRevert()
                                      }
                                  }
                      
                                  // make sure that input amount fits in 112 bit
                                  if gt(amount, _MAX_SWAP_AMOUNT) {
                                      mstore(0, 0xcf0b4d3a00000000000000000000000000000000000000000000000000000000)  // SwapAmountTooLarge()
                                      revert(0, 4)
                                  }
                      
                                  let emptyPtr := mload(0x40)
                                  mstore(0x40, add(emptyPtr, 0xc0))
                      
                                  let poolsEndOffset := add(pools.offset, shl(5, pools.length))
                                  let rawPair := calldataload(pools.offset)
                                  switch srcToken
                                  case 0 {
                                      if iszero(eq(amount, callvalue())) {
                                          mstore(0, 0x1841b4e100000000000000000000000000000000000000000000000000000000)  // InvalidMsgValue()
                                          revert(0, 4)
                                      }
                      
                                      mstore(emptyPtr, _WETH_DEPOSIT_CALL_SELECTOR)
                                      if iszero(call(gas(), _WETH, amount, emptyPtr, 0x4, 0, 0)) {
                                          reRevert()
                                      }
                      
                                      mstore(emptyPtr, _ERC20_TRANSFER_CALL_SELECTOR)
                                      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() {
                                          mstore(0, 0x1841b4e100000000000000000000000000000000000000000000000000000000)  // InvalidMsgValue()
                                          revert(0, 4)
                                      }
                      
                                      mstore(emptyPtr, _TRANSFER_FROM_CALL_SELECTOR)
                                      mstore(add(emptyPtr, 0x4), caller())
                                      mstore(add(emptyPtr, 0x24), and(rawPair, _ADDRESS_MASK))
                                      mstore(add(emptyPtr, 0x44), amount)
                                      validateERC20Transfer(
                                          call(gas(), srcToken, 0, emptyPtr, 0x64, 0, 0x20)
                                      )
                                  }
                      
                                  returnAmount := amount
                      
                                  for {let i := add(pools.offset, 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)),
                                          recipient
                                      )
                                  }
                                  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)
                                      mstore(add(emptyPtr, 0x04), returnAmount)
                                      if iszero(call(gas(), _WETH, 0, emptyPtr, 0x24, 0, 0)) {
                                          reRevert()
                                      }
                      
                                      if iszero(call(gas(), recipient, returnAmount, 0, 0, 0, 0)) {
                                          reRevert()
                                      }
                                  }
                              }
                              if (returnAmount < minReturn) revert RouterErrors.ReturnAmountIsNotEnough();
                          }
                      }
                      
                      
                      // File contracts/interfaces/IUniswapV3Pool.sol
                      
                      pragma solidity 0.8.17;
                      
                      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.8.17;
                      
                      /// @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 @openzeppelin/contracts/utils/[email protected]
                      
                      // OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol)
                      
                      pragma solidity ^0.8.1;
                      
                      /**
                       * @dev Collection of functions related to the address type
                       */
                      library Address {
                          /**
                           * @dev Returns true if `account` is a contract.
                           *
                           * [IMPORTANT]
                           * ====
                           * It is unsafe to assume that an address for which this function returns
                           * false is an externally-owned account (EOA) and not a contract.
                           *
                           * Among others, `isContract` will return false for the following
                           * types of addresses:
                           *
                           *  - an externally-owned account
                           *  - a contract in construction
                           *  - an address where a contract will be created
                           *  - an address where a contract lived, but was destroyed
                           * ====
                           *
                           * [IMPORTANT]
                           * ====
                           * You shouldn't rely on `isContract` to protect against flash loan attacks!
                           *
                           * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
                           * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
                           * constructor.
                           * ====
                           */
                          function isContract(address account) internal view returns (bool) {
                              // This method relies on extcodesize/address.code.length, which returns 0
                              // for contracts in construction, since the code is only stored at the end
                              // of the constructor execution.
                      
                              return account.code.length > 0;
                          }
                      
                          /**
                           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                           * `recipient`, forwarding all available gas and reverting on errors.
                           *
                           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                           * of certain opcodes, possibly making contracts go over the 2300 gas limit
                           * imposed by `transfer`, making them unable to receive funds via
                           * `transfer`. {sendValue} removes this limitation.
                           *
                           * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                           *
                           * IMPORTANT: because control is transferred to `recipient`, care must be
                           * taken to not create reentrancy vulnerabilities. Consider using
                           * {ReentrancyGuard} or the
                           * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                           */
                          function sendValue(address payable recipient, uint256 amount) internal {
                              require(address(this).balance >= amount, "Address: insufficient balance");
                      
                              (bool success, ) = recipient.call{value: amount}("");
                              require(success, "Address: unable to send value, recipient may have reverted");
                          }
                      
                          /**
                           * @dev Performs a Solidity function call using a low level `call`. A
                           * plain `call` is an unsafe replacement for a function call: use this
                           * function instead.
                           *
                           * If `target` reverts with a revert reason, it is bubbled up by this
                           * function (like regular Solidity function calls).
                           *
                           * Returns the raw returned data. To convert to the expected return value,
                           * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                           *
                           * Requirements:
                           *
                           * - `target` must be a contract.
                           * - calling `target` with `data` must not revert.
                           *
                           * _Available since v3.1._
                           */
                          function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                              return functionCall(target, data, "Address: low-level call failed");
                          }
                      
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                           * `errorMessage` as a fallback revert reason when `target` reverts.
                           *
                           * _Available since v3.1._
                           */
                          function functionCall(
                              address target,
                              bytes memory data,
                              string memory errorMessage
                          ) internal returns (bytes memory) {
                              return functionCallWithValue(target, data, 0, errorMessage);
                          }
                      
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                           * but also transferring `value` wei to `target`.
                           *
                           * Requirements:
                           *
                           * - the calling contract must have an ETH balance of at least `value`.
                           * - the called Solidity function must be `payable`.
                           *
                           * _Available since v3.1._
                           */
                          function functionCallWithValue(
                              address target,
                              bytes memory data,
                              uint256 value
                          ) internal returns (bytes memory) {
                              return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                          }
                      
                          /**
                           * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                           * with `errorMessage` as a fallback revert reason when `target` reverts.
                           *
                           * _Available since v3.1._
                           */
                          function functionCallWithValue(
                              address target,
                              bytes memory data,
                              uint256 value,
                              string memory errorMessage
                          ) internal returns (bytes memory) {
                              require(address(this).balance >= value, "Address: insufficient balance for call");
                              require(isContract(target), "Address: call to non-contract");
                      
                              (bool success, bytes memory returndata) = target.call{value: value}(data);
                              return verifyCallResult(success, returndata, errorMessage);
                          }
                      
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                           * but performing a static call.
                           *
                           * _Available since v3.3._
                           */
                          function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                              return functionStaticCall(target, data, "Address: low-level static call failed");
                          }
                      
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                           * but performing a static call.
                           *
                           * _Available since v3.3._
                           */
                          function functionStaticCall(
                              address target,
                              bytes memory data,
                              string memory errorMessage
                          ) internal view returns (bytes memory) {
                              require(isContract(target), "Address: static call to non-contract");
                      
                              (bool success, bytes memory returndata) = target.staticcall(data);
                              return verifyCallResult(success, returndata, errorMessage);
                          }
                      
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                           * but performing a delegate call.
                           *
                           * _Available since v3.4._
                           */
                          function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                              return functionDelegateCall(target, data, "Address: low-level delegate call failed");
                          }
                      
                          /**
                           * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                           * but performing a delegate call.
                           *
                           * _Available since v3.4._
                           */
                          function functionDelegateCall(
                              address target,
                              bytes memory data,
                              string memory errorMessage
                          ) internal returns (bytes memory) {
                              require(isContract(target), "Address: delegate call to non-contract");
                      
                              (bool success, bytes memory returndata) = target.delegatecall(data);
                              return verifyCallResult(success, returndata, errorMessage);
                          }
                      
                          /**
                           * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
                           * revert reason using the provided one.
                           *
                           * _Available since v4.3._
                           */
                          function verifyCallResult(
                              bool success,
                              bytes memory returndata,
                              string memory errorMessage
                          ) internal pure returns (bytes memory) {
                              if (success) {
                                  return returndata;
                              } else {
                                  // Look for revert reason and bubble it up if present
                                  if (returndata.length > 0) {
                                      // The easiest way to bubble the revert reason is using memory via assembly
                                      /// @solidity memory-safe-assembly
                                      assembly {
                                          let returndata_size := mload(returndata)
                                          revert(add(32, returndata), returndata_size)
                                      }
                                  } else {
                                      revert(errorMessage);
                                  }
                              }
                          }
                      }
                      
                      
                      // File @openzeppelin/contracts/utils/math/[email protected]
                      
                      // OpenZeppelin Contracts (last updated v4.7.0) (utils/math/SafeCast.sol)
                      
                      pragma solidity ^0.8.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 uint248 from uint256, reverting on
                           * overflow (when the input is greater than largest uint248).
                           *
                           * Counterpart to Solidity's `uint248` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 248 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint248(uint256 value) internal pure returns (uint248) {
                              require(value <= type(uint248).max, "SafeCast: value doesn't fit in 248 bits");
                              return uint248(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint240 from uint256, reverting on
                           * overflow (when the input is greater than largest uint240).
                           *
                           * Counterpart to Solidity's `uint240` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 240 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint240(uint256 value) internal pure returns (uint240) {
                              require(value <= type(uint240).max, "SafeCast: value doesn't fit in 240 bits");
                              return uint240(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint232 from uint256, reverting on
                           * overflow (when the input is greater than largest uint232).
                           *
                           * Counterpart to Solidity's `uint232` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 232 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint232(uint256 value) internal pure returns (uint232) {
                              require(value <= type(uint232).max, "SafeCast: value doesn't fit in 232 bits");
                              return uint232(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint224 from uint256, reverting on
                           * overflow (when the input is greater than largest uint224).
                           *
                           * Counterpart to Solidity's `uint224` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 224 bits
                           *
                           * _Available since v4.2._
                           */
                          function toUint224(uint256 value) internal pure returns (uint224) {
                              require(value <= type(uint224).max, "SafeCast: value doesn't fit in 224 bits");
                              return uint224(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint216 from uint256, reverting on
                           * overflow (when the input is greater than largest uint216).
                           *
                           * Counterpart to Solidity's `uint216` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 216 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint216(uint256 value) internal pure returns (uint216) {
                              require(value <= type(uint216).max, "SafeCast: value doesn't fit in 216 bits");
                              return uint216(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint208 from uint256, reverting on
                           * overflow (when the input is greater than largest uint208).
                           *
                           * Counterpart to Solidity's `uint208` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 208 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint208(uint256 value) internal pure returns (uint208) {
                              require(value <= type(uint208).max, "SafeCast: value doesn't fit in 208 bits");
                              return uint208(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint200 from uint256, reverting on
                           * overflow (when the input is greater than largest uint200).
                           *
                           * Counterpart to Solidity's `uint200` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 200 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint200(uint256 value) internal pure returns (uint200) {
                              require(value <= type(uint200).max, "SafeCast: value doesn't fit in 200 bits");
                              return uint200(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint192 from uint256, reverting on
                           * overflow (when the input is greater than largest uint192).
                           *
                           * Counterpart to Solidity's `uint192` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 192 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint192(uint256 value) internal pure returns (uint192) {
                              require(value <= type(uint192).max, "SafeCast: value doesn't fit in 192 bits");
                              return uint192(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint184 from uint256, reverting on
                           * overflow (when the input is greater than largest uint184).
                           *
                           * Counterpart to Solidity's `uint184` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 184 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint184(uint256 value) internal pure returns (uint184) {
                              require(value <= type(uint184).max, "SafeCast: value doesn't fit in 184 bits");
                              return uint184(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint176 from uint256, reverting on
                           * overflow (when the input is greater than largest uint176).
                           *
                           * Counterpart to Solidity's `uint176` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 176 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint176(uint256 value) internal pure returns (uint176) {
                              require(value <= type(uint176).max, "SafeCast: value doesn't fit in 176 bits");
                              return uint176(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint168 from uint256, reverting on
                           * overflow (when the input is greater than largest uint168).
                           *
                           * Counterpart to Solidity's `uint168` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 168 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint168(uint256 value) internal pure returns (uint168) {
                              require(value <= type(uint168).max, "SafeCast: value doesn't fit in 168 bits");
                              return uint168(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint160 from uint256, reverting on
                           * overflow (when the input is greater than largest uint160).
                           *
                           * Counterpart to Solidity's `uint160` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 160 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint160(uint256 value) internal pure returns (uint160) {
                              require(value <= type(uint160).max, "SafeCast: value doesn't fit in 160 bits");
                              return uint160(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint152 from uint256, reverting on
                           * overflow (when the input is greater than largest uint152).
                           *
                           * Counterpart to Solidity's `uint152` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 152 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint152(uint256 value) internal pure returns (uint152) {
                              require(value <= type(uint152).max, "SafeCast: value doesn't fit in 152 bits");
                              return uint152(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint144 from uint256, reverting on
                           * overflow (when the input is greater than largest uint144).
                           *
                           * Counterpart to Solidity's `uint144` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 144 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint144(uint256 value) internal pure returns (uint144) {
                              require(value <= type(uint144).max, "SafeCast: value doesn't fit in 144 bits");
                              return uint144(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint136 from uint256, reverting on
                           * overflow (when the input is greater than largest uint136).
                           *
                           * Counterpart to Solidity's `uint136` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 136 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint136(uint256 value) internal pure returns (uint136) {
                              require(value <= type(uint136).max, "SafeCast: value doesn't fit in 136 bits");
                              return uint136(value);
                          }
                      
                          /**
                           * @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
                           *
                           * _Available since v2.5._
                           */
                          function toUint128(uint256 value) internal pure returns (uint128) {
                              require(value <= type(uint128).max, "SafeCast: value doesn't fit in 128 bits");
                              return uint128(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint120 from uint256, reverting on
                           * overflow (when the input is greater than largest uint120).
                           *
                           * Counterpart to Solidity's `uint120` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 120 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint120(uint256 value) internal pure returns (uint120) {
                              require(value <= type(uint120).max, "SafeCast: value doesn't fit in 120 bits");
                              return uint120(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint112 from uint256, reverting on
                           * overflow (when the input is greater than largest uint112).
                           *
                           * Counterpart to Solidity's `uint112` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 112 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint112(uint256 value) internal pure returns (uint112) {
                              require(value <= type(uint112).max, "SafeCast: value doesn't fit in 112 bits");
                              return uint112(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint104 from uint256, reverting on
                           * overflow (when the input is greater than largest uint104).
                           *
                           * Counterpart to Solidity's `uint104` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 104 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint104(uint256 value) internal pure returns (uint104) {
                              require(value <= type(uint104).max, "SafeCast: value doesn't fit in 104 bits");
                              return uint104(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint96 from uint256, reverting on
                           * overflow (when the input is greater than largest uint96).
                           *
                           * Counterpart to Solidity's `uint96` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 96 bits
                           *
                           * _Available since v4.2._
                           */
                          function toUint96(uint256 value) internal pure returns (uint96) {
                              require(value <= type(uint96).max, "SafeCast: value doesn't fit in 96 bits");
                              return uint96(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint88 from uint256, reverting on
                           * overflow (when the input is greater than largest uint88).
                           *
                           * Counterpart to Solidity's `uint88` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 88 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint88(uint256 value) internal pure returns (uint88) {
                              require(value <= type(uint88).max, "SafeCast: value doesn't fit in 88 bits");
                              return uint88(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint80 from uint256, reverting on
                           * overflow (when the input is greater than largest uint80).
                           *
                           * Counterpart to Solidity's `uint80` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 80 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint80(uint256 value) internal pure returns (uint80) {
                              require(value <= type(uint80).max, "SafeCast: value doesn't fit in 80 bits");
                              return uint80(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint72 from uint256, reverting on
                           * overflow (when the input is greater than largest uint72).
                           *
                           * Counterpart to Solidity's `uint72` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 72 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint72(uint256 value) internal pure returns (uint72) {
                              require(value <= type(uint72).max, "SafeCast: value doesn't fit in 72 bits");
                              return uint72(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
                           *
                           * _Available since v2.5._
                           */
                          function toUint64(uint256 value) internal pure returns (uint64) {
                              require(value <= type(uint64).max, "SafeCast: value doesn't fit in 64 bits");
                              return uint64(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint56 from uint256, reverting on
                           * overflow (when the input is greater than largest uint56).
                           *
                           * Counterpart to Solidity's `uint56` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 56 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint56(uint256 value) internal pure returns (uint56) {
                              require(value <= type(uint56).max, "SafeCast: value doesn't fit in 56 bits");
                              return uint56(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint48 from uint256, reverting on
                           * overflow (when the input is greater than largest uint48).
                           *
                           * Counterpart to Solidity's `uint48` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 48 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint48(uint256 value) internal pure returns (uint48) {
                              require(value <= type(uint48).max, "SafeCast: value doesn't fit in 48 bits");
                              return uint48(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint40 from uint256, reverting on
                           * overflow (when the input is greater than largest uint40).
                           *
                           * Counterpart to Solidity's `uint40` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 40 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint40(uint256 value) internal pure returns (uint40) {
                              require(value <= type(uint40).max, "SafeCast: value doesn't fit in 40 bits");
                              return uint40(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
                           *
                           * _Available since v2.5._
                           */
                          function toUint32(uint256 value) internal pure returns (uint32) {
                              require(value <= type(uint32).max, "SafeCast: value doesn't fit in 32 bits");
                              return uint32(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted uint24 from uint256, reverting on
                           * overflow (when the input is greater than largest uint24).
                           *
                           * Counterpart to Solidity's `uint24` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 24 bits
                           *
                           * _Available since v4.7._
                           */
                          function toUint24(uint256 value) internal pure returns (uint24) {
                              require(value <= type(uint24).max, "SafeCast: value doesn't fit in 24 bits");
                              return uint24(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
                           *
                           * _Available since v2.5._
                           */
                          function toUint16(uint256 value) internal pure returns (uint16) {
                              require(value <= type(uint16).max, "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
                           *
                           * _Available since v2.5._
                           */
                          function toUint8(uint256 value) internal pure returns (uint8) {
                              require(value <= type(uint8).max, "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.
                           *
                           * _Available since v3.0._
                           */
                          function toUint256(int256 value) internal pure returns (uint256) {
                              require(value >= 0, "SafeCast: value must be positive");
                              return uint256(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int248 from int256, reverting on
                           * overflow (when the input is less than smallest int248 or
                           * greater than largest int248).
                           *
                           * Counterpart to Solidity's `int248` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 248 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt248(int256 value) internal pure returns (int248) {
                              require(value >= type(int248).min && value <= type(int248).max, "SafeCast: value doesn't fit in 248 bits");
                              return int248(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int240 from int256, reverting on
                           * overflow (when the input is less than smallest int240 or
                           * greater than largest int240).
                           *
                           * Counterpart to Solidity's `int240` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 240 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt240(int256 value) internal pure returns (int240) {
                              require(value >= type(int240).min && value <= type(int240).max, "SafeCast: value doesn't fit in 240 bits");
                              return int240(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int232 from int256, reverting on
                           * overflow (when the input is less than smallest int232 or
                           * greater than largest int232).
                           *
                           * Counterpart to Solidity's `int232` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 232 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt232(int256 value) internal pure returns (int232) {
                              require(value >= type(int232).min && value <= type(int232).max, "SafeCast: value doesn't fit in 232 bits");
                              return int232(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int224 from int256, reverting on
                           * overflow (when the input is less than smallest int224 or
                           * greater than largest int224).
                           *
                           * Counterpart to Solidity's `int224` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 224 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt224(int256 value) internal pure returns (int224) {
                              require(value >= type(int224).min && value <= type(int224).max, "SafeCast: value doesn't fit in 224 bits");
                              return int224(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int216 from int256, reverting on
                           * overflow (when the input is less than smallest int216 or
                           * greater than largest int216).
                           *
                           * Counterpart to Solidity's `int216` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 216 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt216(int256 value) internal pure returns (int216) {
                              require(value >= type(int216).min && value <= type(int216).max, "SafeCast: value doesn't fit in 216 bits");
                              return int216(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int208 from int256, reverting on
                           * overflow (when the input is less than smallest int208 or
                           * greater than largest int208).
                           *
                           * Counterpart to Solidity's `int208` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 208 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt208(int256 value) internal pure returns (int208) {
                              require(value >= type(int208).min && value <= type(int208).max, "SafeCast: value doesn't fit in 208 bits");
                              return int208(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int200 from int256, reverting on
                           * overflow (when the input is less than smallest int200 or
                           * greater than largest int200).
                           *
                           * Counterpart to Solidity's `int200` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 200 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt200(int256 value) internal pure returns (int200) {
                              require(value >= type(int200).min && value <= type(int200).max, "SafeCast: value doesn't fit in 200 bits");
                              return int200(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int192 from int256, reverting on
                           * overflow (when the input is less than smallest int192 or
                           * greater than largest int192).
                           *
                           * Counterpart to Solidity's `int192` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 192 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt192(int256 value) internal pure returns (int192) {
                              require(value >= type(int192).min && value <= type(int192).max, "SafeCast: value doesn't fit in 192 bits");
                              return int192(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int184 from int256, reverting on
                           * overflow (when the input is less than smallest int184 or
                           * greater than largest int184).
                           *
                           * Counterpart to Solidity's `int184` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 184 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt184(int256 value) internal pure returns (int184) {
                              require(value >= type(int184).min && value <= type(int184).max, "SafeCast: value doesn't fit in 184 bits");
                              return int184(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int176 from int256, reverting on
                           * overflow (when the input is less than smallest int176 or
                           * greater than largest int176).
                           *
                           * Counterpart to Solidity's `int176` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 176 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt176(int256 value) internal pure returns (int176) {
                              require(value >= type(int176).min && value <= type(int176).max, "SafeCast: value doesn't fit in 176 bits");
                              return int176(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int168 from int256, reverting on
                           * overflow (when the input is less than smallest int168 or
                           * greater than largest int168).
                           *
                           * Counterpart to Solidity's `int168` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 168 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt168(int256 value) internal pure returns (int168) {
                              require(value >= type(int168).min && value <= type(int168).max, "SafeCast: value doesn't fit in 168 bits");
                              return int168(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int160 from int256, reverting on
                           * overflow (when the input is less than smallest int160 or
                           * greater than largest int160).
                           *
                           * Counterpart to Solidity's `int160` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 160 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt160(int256 value) internal pure returns (int160) {
                              require(value >= type(int160).min && value <= type(int160).max, "SafeCast: value doesn't fit in 160 bits");
                              return int160(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int152 from int256, reverting on
                           * overflow (when the input is less than smallest int152 or
                           * greater than largest int152).
                           *
                           * Counterpart to Solidity's `int152` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 152 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt152(int256 value) internal pure returns (int152) {
                              require(value >= type(int152).min && value <= type(int152).max, "SafeCast: value doesn't fit in 152 bits");
                              return int152(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int144 from int256, reverting on
                           * overflow (when the input is less than smallest int144 or
                           * greater than largest int144).
                           *
                           * Counterpart to Solidity's `int144` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 144 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt144(int256 value) internal pure returns (int144) {
                              require(value >= type(int144).min && value <= type(int144).max, "SafeCast: value doesn't fit in 144 bits");
                              return int144(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int136 from int256, reverting on
                           * overflow (when the input is less than smallest int136 or
                           * greater than largest int136).
                           *
                           * Counterpart to Solidity's `int136` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 136 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt136(int256 value) internal pure returns (int136) {
                              require(value >= type(int136).min && value <= type(int136).max, "SafeCast: value doesn't fit in 136 bits");
                              return int136(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 >= type(int128).min && value <= type(int128).max, "SafeCast: value doesn't fit in 128 bits");
                              return int128(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int120 from int256, reverting on
                           * overflow (when the input is less than smallest int120 or
                           * greater than largest int120).
                           *
                           * Counterpart to Solidity's `int120` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 120 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt120(int256 value) internal pure returns (int120) {
                              require(value >= type(int120).min && value <= type(int120).max, "SafeCast: value doesn't fit in 120 bits");
                              return int120(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int112 from int256, reverting on
                           * overflow (when the input is less than smallest int112 or
                           * greater than largest int112).
                           *
                           * Counterpart to Solidity's `int112` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 112 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt112(int256 value) internal pure returns (int112) {
                              require(value >= type(int112).min && value <= type(int112).max, "SafeCast: value doesn't fit in 112 bits");
                              return int112(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int104 from int256, reverting on
                           * overflow (when the input is less than smallest int104 or
                           * greater than largest int104).
                           *
                           * Counterpart to Solidity's `int104` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 104 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt104(int256 value) internal pure returns (int104) {
                              require(value >= type(int104).min && value <= type(int104).max, "SafeCast: value doesn't fit in 104 bits");
                              return int104(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int96 from int256, reverting on
                           * overflow (when the input is less than smallest int96 or
                           * greater than largest int96).
                           *
                           * Counterpart to Solidity's `int96` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 96 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt96(int256 value) internal pure returns (int96) {
                              require(value >= type(int96).min && value <= type(int96).max, "SafeCast: value doesn't fit in 96 bits");
                              return int96(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int88 from int256, reverting on
                           * overflow (when the input is less than smallest int88 or
                           * greater than largest int88).
                           *
                           * Counterpart to Solidity's `int88` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 88 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt88(int256 value) internal pure returns (int88) {
                              require(value >= type(int88).min && value <= type(int88).max, "SafeCast: value doesn't fit in 88 bits");
                              return int88(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int80 from int256, reverting on
                           * overflow (when the input is less than smallest int80 or
                           * greater than largest int80).
                           *
                           * Counterpart to Solidity's `int80` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 80 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt80(int256 value) internal pure returns (int80) {
                              require(value >= type(int80).min && value <= type(int80).max, "SafeCast: value doesn't fit in 80 bits");
                              return int80(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int72 from int256, reverting on
                           * overflow (when the input is less than smallest int72 or
                           * greater than largest int72).
                           *
                           * Counterpart to Solidity's `int72` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 72 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt72(int256 value) internal pure returns (int72) {
                              require(value >= type(int72).min && value <= type(int72).max, "SafeCast: value doesn't fit in 72 bits");
                              return int72(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 >= type(int64).min && value <= type(int64).max, "SafeCast: value doesn't fit in 64 bits");
                              return int64(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int56 from int256, reverting on
                           * overflow (when the input is less than smallest int56 or
                           * greater than largest int56).
                           *
                           * Counterpart to Solidity's `int56` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 56 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt56(int256 value) internal pure returns (int56) {
                              require(value >= type(int56).min && value <= type(int56).max, "SafeCast: value doesn't fit in 56 bits");
                              return int56(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int48 from int256, reverting on
                           * overflow (when the input is less than smallest int48 or
                           * greater than largest int48).
                           *
                           * Counterpart to Solidity's `int48` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 48 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt48(int256 value) internal pure returns (int48) {
                              require(value >= type(int48).min && value <= type(int48).max, "SafeCast: value doesn't fit in 48 bits");
                              return int48(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int40 from int256, reverting on
                           * overflow (when the input is less than smallest int40 or
                           * greater than largest int40).
                           *
                           * Counterpart to Solidity's `int40` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 40 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt40(int256 value) internal pure returns (int40) {
                              require(value >= type(int40).min && value <= type(int40).max, "SafeCast: value doesn't fit in 40 bits");
                              return int40(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 >= type(int32).min && value <= type(int32).max, "SafeCast: value doesn't fit in 32 bits");
                              return int32(value);
                          }
                      
                          /**
                           * @dev Returns the downcasted int24 from int256, reverting on
                           * overflow (when the input is less than smallest int24 or
                           * greater than largest int24).
                           *
                           * Counterpart to Solidity's `int24` operator.
                           *
                           * Requirements:
                           *
                           * - input must fit into 24 bits
                           *
                           * _Available since v4.7._
                           */
                          function toInt24(int256 value) internal pure returns (int24) {
                              require(value >= type(int24).min && value <= type(int24).max, "SafeCast: value doesn't fit in 24 bits");
                              return int24(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 >= type(int16).min && value <= type(int16).max, "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 >= type(int8).min && value <= type(int8).max, "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.
                           *
                           * _Available since v3.0._
                           */
                          function toInt256(uint256 value) internal pure returns (int256) {
                              // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive
                              require(value <= uint256(type(int256).max), "SafeCast: value doesn't fit in an int256");
                              return int256(value);
                          }
                      }
                      
                      
                      // File contracts/routers/UnoswapV3Router.sol
                      
                      
                      pragma solidity 0.8.17;
                      
                      
                      
                      
                      
                      
                      
                      
                      
                      contract UnoswapV3Router is EthReceiver, IUniswapV3SwapCallback {
                          using Address for address payable;
                          using SafeERC20 for IERC20;
                      
                          error EmptyPools();
                          error BadPool();
                      
                          uint256 private constant _ONE_FOR_ZERO_MASK = 1 << 255;
                          uint256 private constant _WETH_UNWRAP_MASK = 1 << 253;
                          bytes32 private constant _POOL_INIT_CODE_HASH = 0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54;
                          bytes32 private constant _FF_FACTORY = 0xff1F98431c8aD98523631AE4a59f267346ea31F9840000000000000000000000;
                          // concatenation of token0(), token1() fee(), transfer() and transferFrom() selectors
                          bytes32 private constant _SELECTORS = 0x0dfe1681d21220a7ddca3f43a9059cbb23b872dd000000000000000000000000;
                          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(IWETH weth) {
                              _WETH = 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) {
                              srcToken.safePermit(permit);
                              return _uniswapV3Swap(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 _uniswapV3Swap(payable(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
                          ) external payable returns(uint256 returnAmount) {
                              return _uniswapV3Swap(recipient, amount, minReturn, pools);
                          }
                      
                          function _uniswapV3Swap(
                              address payable recipient,
                              uint256 amount,
                              uint256 minReturn,
                              uint256[] calldata pools
                          ) private returns(uint256 returnAmount) {
                              unchecked {
                                  uint256 len = pools.length;
                                  if (len == 0) revert EmptyPools();
                                  uint256 lastIndex = len - 1;
                                  returnAmount = amount;
                                  bool wrapWeth = msg.value > 0;
                                  bool unwrapWeth = pools[lastIndex] & _WETH_UNWRAP_MASK > 0;
                                  if (wrapWeth) {
                                      if (msg.value != amount) revert RouterErrors.InvalidMsgValue();
                                      _WETH.deposit{value: amount}();
                                  }
                                  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);
                                  }
                      
                                  if (returnAmount < minReturn) revert RouterErrors.ReturnAmountIsNotEnough();
                      
                                  if (unwrapWeth) {
                                      _WETH.withdraw(returnAmount);
                                      recipient.sendValue(returnAmount);
                                  }
                              }
                          }
                      
                          /// @inheritdoc IUniswapV3SwapCallback
                          function uniswapV3SwapCallback(
                              int256 amount0Delta,
                              int256 amount1Delta,
                              bytes calldata /* data */
                          ) external override {
                              assembly {  // solhint-disable-line no-inline-assembly
                                  function reRevert() {
                                      returndatacopy(0, 0, returndatasize())
                                      revert(0, returndatasize())
                                  }
                      
                                  function validateERC20Transfer(status) {
                                      if iszero(status) {
                                          reRevert()
                                      }
                                      let success := or(
                                          iszero(returndatasize()),                       // empty return data
                                          and(gt(returndatasize(), 31), eq(mload(0), 1))  // true in return data
                                      )
                                      if iszero(success) {
                                          mstore(0, 0xf27f64e400000000000000000000000000000000000000000000000000000000)  // ERC20TransferFailed()
                                          revert(0, 4)
                                      }
                                  }
                      
                                  let emptyPtr := mload(0x40)
                                  let resultPtr := add(emptyPtr, 0x15)  // 0x15 = _FF_FACTORY size
                      
                                  mstore(emptyPtr, _SELECTORS)
                                  if iszero(staticcall(gas(), caller(), emptyPtr, 0x4, resultPtr, 0x20)) {
                                      reRevert()
                                  }
                                  if iszero(staticcall(gas(), caller(), add(emptyPtr, 0x4), 0x4, add(resultPtr, 0x20), 0x20)) {
                                      reRevert()
                                  }
                                  if iszero(staticcall(gas(), caller(), add(emptyPtr, 0x8), 0x4, add(resultPtr, 0x40), 0x20)) {
                                      reRevert()
                                  }
                      
                                  let token
                                  let amount
                                  switch sgt(amount0Delta, 0)
                                  case 1 {
                                      token := mload(resultPtr)
                                      amount := amount0Delta
                                  }
                                  default {
                                      token := mload(add(resultPtr, 0x20))
                                      amount := amount1Delta
                                  }
                      
                                  mstore(emptyPtr, _FF_FACTORY)
                                  mstore(resultPtr, keccak256(resultPtr, 0x60)) // Compute the inner hash in-place
                                  mstore(add(resultPtr, 0x20), _POOL_INIT_CODE_HASH)
                                  let pool := and(keccak256(emptyPtr, 0x55), _ADDRESS_MASK)
                                  if xor(pool, caller()) {
                                      mstore(0, 0xb2c0272200000000000000000000000000000000000000000000000000000000)  // BadPool()
                                      revert(0, 4)
                                  }
                      
                                  let payer := calldataload(0x84)
                                  mstore(emptyPtr, _SELECTORS)
                                  switch eq(payer, address())
                                  case 1 {
                                      // token.safeTransfer(msg.sender,amount)
                                      mstore(add(emptyPtr, 0x10), caller())
                                      mstore(add(emptyPtr, 0x30), amount)
                                      validateERC20Transfer(
                                          call(gas(), token, 0, add(emptyPtr, 0x0c), 0x44, 0, 0x20)
                                      )
                                  }
                                  default {
                                      // token.safeTransferFrom(payer, msg.sender, amount);
                                      mstore(add(emptyPtr, 0x14), payer)
                                      mstore(add(emptyPtr, 0x34), caller())
                                      mstore(add(emptyPtr, 0x54), amount)
                                      validateERC20Transfer(
                                          call(gas(), token, 0, add(emptyPtr, 0x10), 0x64, 0, 0x20)
                                      )
                                  }
                              }
                          }
                      
                          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(address(uint160(pool))).swap(
                                      recipient,
                                      zeroForOne,
                                      SafeCast.toInt256(amount),
                                      _MIN_SQRT_RATIO,
                                      abi.encode(payer)
                                  );
                                  return SafeCast.toUint256(-amount1);
                              } else {
                                  (int256 amount0,) = IUniswapV3Pool(address(uint160(pool))).swap(
                                      recipient,
                                      zeroForOne,
                                      SafeCast.toInt256(amount),
                                      _MAX_SQRT_RATIO,
                                      abi.encode(payer)
                                  );
                                  return SafeCast.toUint256(-amount0);
                              }
                          }
                      }
                      
                      
                      // File @1inch/solidity-utils/contracts/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      abstract contract OnlyWethReceiver is EthReceiver {
                          address private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                      
                          constructor(address weth) {
                              _WETH = address(weth);
                          }
                      
                          function _receive() internal virtual override {
                              if (msg.sender != _WETH) revert EthDepositRejected();
                          }
                      }
                      
                      
                      // File @openzeppelin/contracts/interfaces/[email protected]
                      
                      // OpenZeppelin Contracts v4.4.1 (interfaces/IERC1271.sol)
                      
                      pragma solidity ^0.8.0;
                      
                      /**
                       * @dev Interface of the ERC1271 standard signature validation method for
                       * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].
                       *
                       * _Available since v4.1._
                       */
                      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 @1inch/solidity-utils/contracts/libraries/[email protected]
                      
                      
                      pragma solidity ^0.8.0;
                      
                      library ECDSA {
                          // 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.
                          uint256 private constant _S_BOUNDARY = 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0 + 1;
                          uint256 private constant _COMPACT_S_MASK = 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff;
                          uint256 private constant _COMPACT_V_SHIFT = 255;
                      
                          function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal view returns(address signer) {
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  if lt(s, _S_BOUNDARY) {
                                      let ptr := mload(0x40)
                      
                                      mstore(ptr, hash)
                                      mstore(add(ptr, 0x20), v)
                                      mstore(add(ptr, 0x40), r)
                                      mstore(add(ptr, 0x60), s)
                                      mstore(0, 0)
                                      pop(staticcall(gas(), 0x1, ptr, 0x80, 0, 0x20))
                                      signer := mload(0)
                                  }
                              }
                          }
                      
                          function recover(bytes32 hash, bytes32 r, bytes32 vs) internal view returns(address signer) {
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let s := and(vs, _COMPACT_S_MASK)
                                  if lt(s, _S_BOUNDARY) {
                                      let ptr := mload(0x40)
                      
                                      mstore(ptr, hash)
                                      mstore(add(ptr, 0x20), add(27, shr(_COMPACT_V_SHIFT, vs)))
                                      mstore(add(ptr, 0x40), r)
                                      mstore(add(ptr, 0x60), s)
                                      mstore(0, 0)
                                      pop(staticcall(gas(), 0x1, ptr, 0x80, 0, 0x20))
                                      signer := mload(0)
                                  }
                              }
                          }
                      
                          /// WARNING!!!
                          /// There is a known signature malleability issue with two representations of signatures!
                          /// Even though this function is able to verify both standard 65-byte and compact 64-byte EIP-2098 signatures
                          /// one should never use raw signatures for any kind of invalidation logic in their code.
                          /// As the standard and compact representations are interchangeable any invalidation logic that relies on
                          /// signature uniqueness will get rekt.
                          /// More info: https://github.com/OpenZeppelin/openzeppelin-contracts/security/advisories/GHSA-4h98-2769-gh6h
                          function recover(bytes32 hash, bytes calldata signature) internal view returns(address signer) {
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let ptr := mload(0x40)
                      
                                  // memory[ptr:ptr+0x80] = (hash, v, r, s)
                                  switch signature.length
                                  case 65 {
                                      // memory[ptr+0x20:ptr+0x80] = (v, r, s)
                                      mstore(add(ptr, 0x20), byte(0, calldataload(add(signature.offset, 0x40))))
                                      calldatacopy(add(ptr, 0x40), signature.offset, 0x40)
                                  }
                                  case 64 {
                                      // memory[ptr+0x20:ptr+0x80] = (v, r, s)
                                      let vs := calldataload(add(signature.offset, 0x20))
                                      mstore(add(ptr, 0x20), add(27, shr(_COMPACT_V_SHIFT, vs)))
                                      calldatacopy(add(ptr, 0x40), signature.offset, 0x20)
                                      mstore(add(ptr, 0x60), and(vs, _COMPACT_S_MASK))
                                  }
                                  default {
                                      ptr := 0
                                  }
                      
                                  if ptr {
                                      if lt(mload(add(ptr, 0x60)), _S_BOUNDARY) {
                                          // memory[ptr:ptr+0x20] = (hash)
                                          mstore(ptr, hash)
                      
                                          mstore(0, 0)
                                          pop(staticcall(gas(), 0x1, ptr, 0x80, 0, 0x20))
                                          signer := mload(0)
                                      }
                                  }
                              }
                          }
                      
                          function recoverOrIsValidSignature(address signer, bytes32 hash, bytes calldata signature) internal view returns(bool success) {
                              if (signer == address(0)) return false;
                              if ((signature.length == 64 || signature.length == 65) && recover(hash, signature) == signer) {
                                  return true;
                              }
                              return isValidSignature(signer, hash, signature);
                          }
                      
                          function recoverOrIsValidSignature(address signer, bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal view returns(bool success) {
                              if (signer == address(0)) return false;
                              if (recover(hash, v, r, s) == signer) {
                                  return true;
                              }
                              return isValidSignature(signer, hash, v, r, s);
                          }
                      
                          function recoverOrIsValidSignature(address signer, bytes32 hash, bytes32 r, bytes32 vs) internal view returns(bool success) {
                              if (signer == address(0)) return false;
                              if (recover(hash, r, vs) == signer) {
                                  return true;
                              }
                              return isValidSignature(signer, hash, r, vs);
                          }
                      
                          function recoverOrIsValidSignature65(address signer, bytes32 hash, bytes32 r, bytes32 vs) internal view returns(bool success) {
                              if (signer == address(0)) return false;
                              if (recover(hash, r, vs) == signer) {
                                  return true;
                              }
                              return isValidSignature65(signer, hash, r, vs);
                          }
                      
                          function isValidSignature(address signer, bytes32 hash, bytes calldata signature) internal view returns(bool success) {
                              // (bool success, bytes memory data) = signer.staticcall(abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, signature));
                              // return success && data.length >= 4 && abi.decode(data, (bytes4)) == IERC1271.isValidSignature.selector;
                              bytes4 selector = IERC1271.isValidSignature.selector;
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let ptr := mload(0x40)
                      
                                  mstore(ptr, selector)
                                  mstore(add(ptr, 0x04), hash)
                                  mstore(add(ptr, 0x24), 0x40)
                                  mstore(add(ptr, 0x44), signature.length)
                                  calldatacopy(add(ptr, 0x64), signature.offset, signature.length)
                                  if staticcall(gas(), signer, ptr, add(0x64, signature.length), 0, 0x20) {
                                      success := and(eq(selector, mload(0)), eq(returndatasize(), 0x20))
                                  }
                              }
                          }
                      
                          function isValidSignature(address signer, bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal view returns(bool success) {
                              bytes4 selector = IERC1271.isValidSignature.selector;
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let ptr := mload(0x40)
                      
                                  mstore(ptr, selector)
                                  mstore(add(ptr, 0x04), hash)
                                  mstore(add(ptr, 0x24), 0x40)
                                  mstore(add(ptr, 0x44), 65)
                                  mstore(add(ptr, 0x64), r)
                                  mstore(add(ptr, 0x84), s)
                                  mstore8(add(ptr, 0xa4), v)
                                  if staticcall(gas(), signer, ptr, 0xa5, 0, 0x20) {
                                      success := and(eq(selector, mload(0)), eq(returndatasize(), 0x20))
                                  }
                              }
                          }
                      
                          function isValidSignature(address signer, bytes32 hash, bytes32 r, bytes32 vs) internal view returns(bool success) {
                              // (bool success, bytes memory data) = signer.staticcall(abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, abi.encodePacked(r, vs)));
                              // return success && data.length >= 4 && abi.decode(data, (bytes4)) == IERC1271.isValidSignature.selector;
                              bytes4 selector = IERC1271.isValidSignature.selector;
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let ptr := mload(0x40)
                      
                                  mstore(ptr, selector)
                                  mstore(add(ptr, 0x04), hash)
                                  mstore(add(ptr, 0x24), 0x40)
                                  mstore(add(ptr, 0x44), 64)
                                  mstore(add(ptr, 0x64), r)
                                  mstore(add(ptr, 0x84), vs)
                                  if staticcall(gas(), signer, ptr, 0xa4, 0, 0x20) {
                                      success := and(eq(selector, mload(0)), eq(returndatasize(), 0x20))
                                  }
                              }
                          }
                      
                          function isValidSignature65(address signer, bytes32 hash, bytes32 r, bytes32 vs) internal view returns(bool success) {
                              // (bool success, bytes memory data) = signer.staticcall(abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, abi.encodePacked(r, vs & ~uint256(1 << 255), uint8(vs >> 255))));
                              // return success && data.length >= 4 && abi.decode(data, (bytes4)) == IERC1271.isValidSignature.selector;
                              bytes4 selector = IERC1271.isValidSignature.selector;
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let ptr := mload(0x40)
                      
                                  mstore(ptr, selector)
                                  mstore(add(ptr, 0x04), hash)
                                  mstore(add(ptr, 0x24), 0x40)
                                  mstore(add(ptr, 0x44), 65)
                                  mstore(add(ptr, 0x64), r)
                                  mstore(add(ptr, 0x84), and(vs, _COMPACT_S_MASK))
                                  mstore8(add(ptr, 0xa4), add(27, shr(_COMPACT_V_SHIFT, vs)))
                                  if staticcall(gas(), signer, ptr, 0xa5, 0, 0x20) {
                                      success := and(eq(selector, mload(0)), eq(returndatasize(), 0x20))
                                  }
                              }
                          }
                      
                          function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 res) {
                              // 32 is the length in bytes of hash, enforced by the type signature above
                              // return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash));
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  mstore(0, 0x19457468657265756d205369676e6564204d6573736167653a0a333200000000) // "\x19Ethereum Signed Message:\n32"
                                  mstore(28, hash)
                                  res := keccak256(0, 60)
                              }
                          }
                      
                          function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 res) {
                              // return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash));
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let ptr := mload(0x40)
                                  mstore(ptr, 0x1901000000000000000000000000000000000000000000000000000000000000) // "\x19\x01"
                                  mstore(add(ptr, 0x02), domainSeparator)
                                  mstore(add(ptr, 0x22), structHash)
                                  res := keccak256(ptr, 66)
                              }
                          }
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      library OrderRFQLib {
                          struct OrderRFQ {
                              uint256 info;  // lowest 64 bits is the order id, next 64 bits is the expiration timestamp
                              address makerAsset;
                              address takerAsset;
                              address maker;
                              address allowedSender;  // equals to Zero address on public orders
                              uint256 makingAmount;
                              uint256 takingAmount;
                          }
                      
                          bytes32 constant internal _LIMIT_ORDER_RFQ_TYPEHASH = keccak256(
                              "OrderRFQ("
                                  "uint256 info,"
                                  "address makerAsset,"
                                  "address takerAsset,"
                                  "address maker,"
                                  "address allowedSender,"
                                  "uint256 makingAmount,"
                                  "uint256 takingAmount"
                              ")"
                          );
                      
                          function hash(OrderRFQ memory order, bytes32 domainSeparator) internal pure returns(bytes32 result) {
                              bytes32 typehash = _LIMIT_ORDER_RFQ_TYPEHASH;
                              bytes32 orderHash;
                              // this assembly is memory unsafe :(
                              assembly { // solhint-disable-line no-inline-assembly
                                  let ptr := sub(order, 0x20)
                      
                                  // keccak256(abi.encode(_LIMIT_ORDER_RFQ_TYPEHASH, order));
                                  let tmp := mload(ptr)
                                  mstore(ptr, typehash)
                                  orderHash := keccak256(ptr, 0x100)
                                  mstore(ptr, tmp)
                              }
                              return ECDSA.toTypedDataHash(domainSeparator, orderHash);
                          }
                      }
                      
                      
                      // File @openzeppelin/contracts/utils/[email protected]
                      
                      // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
                      
                      pragma solidity ^0.8.0;
                      
                      /**
                       * @dev String operations.
                       */
                      library Strings {
                          bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
                          uint8 private constant _ADDRESS_LENGTH = 20;
                      
                          /**
                           * @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] = _HEX_SYMBOLS[value & 0xf];
                                  value >>= 4;
                              }
                              require(value == 0, "Strings: hex length insufficient");
                              return string(buffer);
                          }
                      
                          /**
                           * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
                           */
                          function toHexString(address addr) internal pure returns (string memory) {
                              return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
                          }
                      }
                      
                      
                      // File @openzeppelin/contracts/utils/cryptography/[email protected]
                      
                      // OpenZeppelin Contracts v4.4.1 (utils/cryptography/draft-EIP712.sol)
                      
                      pragma solidity ^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;
                          address private immutable _CACHED_THIS;
                      
                          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 = block.chainid;
                              _CACHED_DOMAIN_SEPARATOR = _buildDomainSeparator(typeHash, hashedName, hashedVersion);
                              _CACHED_THIS = address(this);
                              _TYPE_HASH = typeHash;
                          }
                      
                          /**
                           * @dev Returns the domain separator for the current chain.
                           */
                          function _domainSeparatorV4() internal view returns (bytes32) {
                              if (address(this) == _CACHED_THIS && block.chainid == _CACHED_CHAIN_ID) {
                                  return _CACHED_DOMAIN_SEPARATOR;
                              } else {
                                  return _buildDomainSeparator(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION);
                              }
                          }
                      
                          function _buildDomainSeparator(
                              bytes32 typeHash,
                              bytes32 nameHash,
                              bytes32 versionHash
                          ) private view returns (bytes32) {
                              return keccak256(abi.encode(typeHash, nameHash, versionHash, block.chainid, 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 ECDSA.toTypedDataHash(_domainSeparatorV4(), structHash);
                          }
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/libraries/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      library Errors {
                          error InvalidMsgValue();
                          error ETHTransferFailed();
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/helpers/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      /// @title A helper contract for calculations related to order amounts
                      library AmountCalculator {
                          /// @notice Calculates maker amount
                          /// @return Result Floored maker amount
                          function getMakingAmount(uint256 orderMakerAmount, uint256 orderTakerAmount, uint256 swapTakerAmount) internal pure returns(uint256) {
                              return swapTakerAmount * orderMakerAmount / orderTakerAmount;
                          }
                      
                          /// @notice Calculates taker amount
                          /// @return Result Ceiled taker amount
                          function getTakingAmount(uint256 orderMakerAmount, uint256 orderTakerAmount, uint256 swapMakerAmount) internal pure returns(uint256) {
                              return (swapMakerAmount * orderTakerAmount + orderMakerAmount - 1) / orderMakerAmount;
                          }
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      
                      
                      
                      
                      
                      
                      /// @title RFQ Limit Order mixin
                      abstract contract OrderRFQMixin is EIP712, OnlyWethReceiver {
                          using SafeERC20 for IERC20;
                          using OrderRFQLib for OrderRFQLib.OrderRFQ;
                      
                          error RFQZeroTargetIsForbidden();
                          error RFQPrivateOrder();
                          error RFQBadSignature();
                          error OrderExpired();
                          error MakingAmountExceeded();
                          error TakingAmountExceeded();
                          error RFQSwapWithZeroAmount();
                          error InvalidatedOrder();
                      
                          /**
                           * @notice Emitted when RFQ gets filled
                           * @param orderHash Hash of the order
                           * @param makingAmount Amount of the maker asset that was transferred from maker to taker
                           */
                          event OrderFilledRFQ(
                              bytes32 orderHash,
                              uint256 makingAmount
                          );
                      
                          uint256 private constant _RAW_CALL_GAS_LIMIT = 5000;
                          uint256 private constant _MAKER_AMOUNT_FLAG = 1 << 255;
                          uint256 private constant _SIGNER_SMART_CONTRACT_HINT = 1 << 254;
                          uint256 private constant _IS_VALID_SIGNATURE_65_BYTES = 1 << 253;
                          uint256 private constant _UNWRAP_WETH_FLAG = 1 << 252;
                          uint256 private constant _AMOUNT_MASK = ~(
                              _MAKER_AMOUNT_FLAG |
                              _SIGNER_SMART_CONTRACT_HINT |
                              _IS_VALID_SIGNATURE_65_BYTES |
                              _UNWRAP_WETH_FLAG
                          );
                      
                          IWETH private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                          mapping(address => mapping(uint256 => uint256)) private _invalidator;
                      
                          constructor(IWETH weth) OnlyWethReceiver(address(weth)) {
                              _WETH = weth;
                          }
                      
                          /**
                           * @notice Returns bitmask for double-spend invalidators based on lowest byte of order.info and filled quotes
                           * @param maker Maker address
                           * @param slot Slot number to return bitmask for
                           * @return result Each bit represents whether corresponding was already invalidated
                           */
                          function invalidatorForOrderRFQ(address maker, uint256 slot) external view returns(uint256 /* result */) {
                              return _invalidator[maker][slot];
                          }
                      
                          /**
                           * @notice Cancels order's quote
                           * @param orderInfo Order info (only order id in lowest 64 bits is used)
                           */
                          function cancelOrderRFQ(uint256 orderInfo) external {
                              _invalidateOrder(msg.sender, orderInfo, 0);
                          }
                      
                          /// @notice Cancels multiple order's quotes
                          function cancelOrderRFQ(uint256 orderInfo, uint256 additionalMask) external {
                              _invalidateOrder(msg.sender, orderInfo, additionalMask);
                          }
                      
                          /**
                           * @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 flagsAndAmount Fill configuration flags with amount packed in one slot
                           * @return filledMakingAmount Actual amount transferred from maker to taker
                           * @return filledTakingAmount Actual amount transferred from taker to maker
                           * @return orderHash Hash of the filled order
                           */
                          function fillOrderRFQ(
                              OrderRFQLib.OrderRFQ memory order,
                              bytes calldata signature,
                              uint256 flagsAndAmount
                          ) external payable returns(uint256 /* filledMakingAmount */, uint256 /* filledTakingAmount */, bytes32 /* orderHash */) {
                              return fillOrderRFQTo(order, signature, flagsAndAmount, msg.sender);
                          }
                      
                          /**
                           * @notice Fills order's quote, fully or partially, with compact signature
                           * @param order Order quote to fill
                           * @param r R component of signature
                           * @param vs VS component of signature
                           * @param flagsAndAmount Fill configuration flags with amount packed in one slot
                           * - Bits 0-252 contain the amount to fill
                           * - Bit 253 is used to indicate whether signature is 64-bit (0) or 65-bit (1)
                           * - Bit 254 is used to indicate whether smart contract (1) signed the order or not (0)
                           * - Bit 255 is used to indicate whether maker (1) or taker amount (0) is given in the amount parameter
                           * @return filledMakingAmount Actual amount transferred from maker to taker
                           * @return filledTakingAmount Actual amount transferred from taker to maker
                           * @return orderHash Hash of the filled order
                           */
                          function fillOrderRFQCompact(
                              OrderRFQLib.OrderRFQ memory order,
                              bytes32 r,
                              bytes32 vs,
                              uint256 flagsAndAmount
                          ) external payable returns(uint256 filledMakingAmount, uint256 filledTakingAmount, bytes32 orderHash) {
                              orderHash = order.hash(_domainSeparatorV4());
                              if (flagsAndAmount & _SIGNER_SMART_CONTRACT_HINT != 0) {
                                  if (flagsAndAmount & _IS_VALID_SIGNATURE_65_BYTES != 0) {
                                      if (!ECDSA.isValidSignature65(order.maker, orderHash, r, vs)) revert RFQBadSignature();
                                  } else {
                                      if (!ECDSA.isValidSignature(order.maker, orderHash, r, vs)) revert RFQBadSignature();
                                  }
                              } else {
                                  if(!ECDSA.recoverOrIsValidSignature(order.maker, orderHash, r, vs)) revert RFQBadSignature();
                              }
                      
                              (filledMakingAmount, filledTakingAmount) = _fillOrderRFQTo(order, flagsAndAmount, msg.sender);
                              emit OrderFilledRFQ(orderHash, filledMakingAmount);
                          }
                      
                          /**
                           * @notice Same as `fillOrderRFQTo` but calls permit first.
                           * It allows 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 flagsAndAmount Fill configuration flags with amount packed in one slot
                           * @param target Address that will receive swap funds
                           * @param permit Should consist of abiencoded token address and encoded `IERC20Permit.permit` call.
                           * @return filledMakingAmount Actual amount transferred from maker to taker
                           * @return filledTakingAmount Actual amount transferred from taker to maker
                           * @return orderHash Hash of the filled order
                           * @dev See tests for examples
                           */
                          function fillOrderRFQToWithPermit(
                              OrderRFQLib.OrderRFQ memory order,
                              bytes calldata signature,
                              uint256 flagsAndAmount,
                              address target,
                              bytes calldata permit
                          ) external returns(uint256 /* filledMakingAmount */, uint256 /* filledTakingAmount */, bytes32 /* orderHash */) {
                              IERC20(order.takerAsset).safePermit(permit);
                              return fillOrderRFQTo(order, signature, flagsAndAmount, 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 flagsAndAmount Fill configuration flags with amount packed in one slot
                           * @param target Address that will receive swap funds
                           * @return filledMakingAmount Actual amount transferred from maker to taker
                           * @return filledTakingAmount Actual amount transferred from taker to maker
                           * @return orderHash Hash of the filled order
                           */
                          function fillOrderRFQTo(
                              OrderRFQLib.OrderRFQ memory order,
                              bytes calldata signature,
                              uint256 flagsAndAmount,
                              address target
                          ) public payable returns(uint256 filledMakingAmount, uint256 filledTakingAmount, bytes32 orderHash) {
                              orderHash = order.hash(_domainSeparatorV4());
                              if (flagsAndAmount & _SIGNER_SMART_CONTRACT_HINT != 0) {
                                  if (flagsAndAmount & _IS_VALID_SIGNATURE_65_BYTES != 0 && signature.length != 65) revert RFQBadSignature();
                                  if (!ECDSA.isValidSignature(order.maker, orderHash, signature)) revert RFQBadSignature();
                              } else {
                                  if(!ECDSA.recoverOrIsValidSignature(order.maker, orderHash, signature)) revert RFQBadSignature();
                              }
                              (filledMakingAmount, filledTakingAmount) = _fillOrderRFQTo(order, flagsAndAmount, target);
                              emit OrderFilledRFQ(orderHash, filledMakingAmount);
                          }
                      
                          function _fillOrderRFQTo(
                              OrderRFQLib.OrderRFQ memory order,
                              uint256 flagsAndAmount,
                              address target
                          ) private returns(uint256 makingAmount, uint256 takingAmount) {
                              if (target == address(0)) revert RFQZeroTargetIsForbidden();
                      
                              address maker = order.maker;
                      
                              // Validate order
                              if (order.allowedSender != address(0) && order.allowedSender != msg.sender) revert RFQPrivateOrder();
                      
                              {  // Stack too deep
                                  uint256 info = order.info;
                                  // Check time expiration
                                  uint256 expiration = uint128(info) >> 64;
                                  if (expiration != 0 && block.timestamp > expiration) revert OrderExpired(); // solhint-disable-line not-rely-on-time
                                  _invalidateOrder(maker, info, 0);
                              }
                      
                              {  // Stack too deep
                                  uint256 orderMakingAmount = order.makingAmount;
                                  uint256 orderTakingAmount = order.takingAmount;
                                  uint256 amount = flagsAndAmount & _AMOUNT_MASK;
                                  // Compute partial fill if needed
                                  if (amount == 0) {
                                      // zero amount means whole order
                                      makingAmount = orderMakingAmount;
                                      takingAmount = orderTakingAmount;
                                  }
                                  else if (flagsAndAmount & _MAKER_AMOUNT_FLAG != 0) {
                                      if (amount > orderMakingAmount) revert MakingAmountExceeded();
                                      makingAmount = amount;
                                      takingAmount = AmountCalculator.getTakingAmount(orderMakingAmount, orderTakingAmount, makingAmount);
                                  }
                                  else {
                                      if (amount > orderTakingAmount) revert TakingAmountExceeded();
                                      takingAmount = amount;
                                      makingAmount = AmountCalculator.getMakingAmount(orderMakingAmount, orderTakingAmount, takingAmount);
                                  }
                              }
                      
                              if (makingAmount == 0 || takingAmount == 0) revert RFQSwapWithZeroAmount();
                      
                              // Maker => Taker
                              if (order.makerAsset == address(_WETH) && flagsAndAmount & _UNWRAP_WETH_FLAG != 0) {
                                  _WETH.transferFrom(maker, address(this), makingAmount);
                                  _WETH.withdraw(makingAmount);
                                  // solhint-disable-next-line avoid-low-level-calls
                                  (bool success, ) = target.call{value: makingAmount, gas: _RAW_CALL_GAS_LIMIT}("");
                                  if (!success) revert Errors.ETHTransferFailed();
                              } else {
                                  IERC20(order.makerAsset).safeTransferFrom(maker, target, makingAmount);
                              }
                      
                              // Taker => Maker
                              if (order.takerAsset == address(_WETH) && msg.value > 0) {
                                  if (msg.value != takingAmount) revert Errors.InvalidMsgValue();
                                  _WETH.deposit{ value: takingAmount }();
                                  _WETH.transfer(maker, takingAmount);
                              } else {
                                  if (msg.value != 0) revert Errors.InvalidMsgValue();
                                  IERC20(order.takerAsset).safeTransferFrom(msg.sender, maker, takingAmount);
                              }
                          }
                      
                          function _invalidateOrder(address maker, uint256 orderInfo, uint256 additionalMask) private {
                              uint256 invalidatorSlot = uint64(orderInfo) >> 8;
                              uint256 invalidatorBits = (1 << uint8(orderInfo)) | additionalMask;
                              mapping(uint256 => uint256) storage invalidatorStorage = _invalidator[maker];
                              uint256 invalidator = invalidatorStorage[invalidatorSlot];
                              if (invalidator & invalidatorBits == invalidatorBits) revert InvalidatedOrder();
                              invalidatorStorage[invalidatorSlot] = invalidator | invalidatorBits;
                          }
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      library OrderLib {
                          struct Order {
                              uint256 salt;
                              address makerAsset;
                              address takerAsset;
                              address maker;
                              address receiver;
                              address allowedSender;  // equals to Zero address on public orders
                              uint256 makingAmount;
                              uint256 takingAmount;
                              uint256 offsets;
                              // bytes makerAssetData;
                              // bytes takerAssetData;
                              // bytes getMakingAmount; // this.staticcall(abi.encodePacked(bytes, swapTakerAmount)) => (swapMakerAmount)
                              // bytes getTakingAmount; // this.staticcall(abi.encodePacked(bytes, swapMakerAmount)) => (swapTakerAmount)
                              // bytes predicate;       // this.staticcall(bytes) => (bool)
                              // bytes permit;          // On first fill: permit.1.call(abi.encodePacked(permit.selector, permit.2))
                              // bytes preInteraction;
                              // bytes postInteraction;
                              bytes interactions; // concat(makerAssetData, takerAssetData, getMakingAmount, getTakingAmount, predicate, permit, preIntercation, postInteraction)
                          }
                      
                          bytes32 constant internal _LIMIT_ORDER_TYPEHASH = keccak256(
                              "Order("
                                  "uint256 salt,"
                                  "address makerAsset,"
                                  "address takerAsset,"
                                  "address maker,"
                                  "address receiver,"
                                  "address allowedSender,"
                                  "uint256 makingAmount,"
                                  "uint256 takingAmount,"
                                  "uint256 offsets,"
                                  "bytes interactions"
                              ")"
                          );
                      
                          enum DynamicField {
                              MakerAssetData,
                              TakerAssetData,
                              GetMakingAmount,
                              GetTakingAmount,
                              Predicate,
                              Permit,
                              PreInteraction,
                              PostInteraction
                          }
                      
                          function getterIsFrozen(bytes calldata getter) internal pure returns(bool) {
                              return getter.length == 1 && getter[0] == "x";
                          }
                      
                          function _get(Order calldata order, DynamicField field) private pure returns(bytes calldata) {
                              uint256 bitShift = uint256(field) << 5; // field * 32
                              return order.interactions[
                                  uint32((order.offsets << 32) >> bitShift):
                                  uint32(order.offsets >> bitShift)
                              ];
                          }
                      
                          function makerAssetData(Order calldata order) internal pure returns(bytes calldata) {
                              return _get(order, DynamicField.MakerAssetData);
                          }
                      
                          function takerAssetData(Order calldata order) internal pure returns(bytes calldata) {
                              return _get(order, DynamicField.TakerAssetData);
                          }
                      
                          function getMakingAmount(Order calldata order) internal pure returns(bytes calldata) {
                              return _get(order, DynamicField.GetMakingAmount);
                          }
                      
                          function getTakingAmount(Order calldata order) internal pure returns(bytes calldata) {
                              return _get(order, DynamicField.GetTakingAmount);
                          }
                      
                          function predicate(Order calldata order) internal pure returns(bytes calldata) {
                              return _get(order, DynamicField.Predicate);
                          }
                      
                          function permit(Order calldata order) internal pure returns(bytes calldata) {
                              return _get(order, DynamicField.Permit);
                          }
                      
                          function preInteraction(Order calldata order) internal pure returns(bytes calldata) {
                              return _get(order, DynamicField.PreInteraction);
                          }
                      
                          function postInteraction(Order calldata order) internal pure returns(bytes calldata) {
                              return _get(order, DynamicField.PostInteraction);
                          }
                      
                          function hash(Order calldata order, bytes32 domainSeparator) internal pure returns(bytes32 result) {
                              bytes calldata interactions = order.interactions;
                              bytes32 typehash = _LIMIT_ORDER_TYPEHASH;
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let ptr := mload(0x40)
                      
                                  // keccak256(abi.encode(_LIMIT_ORDER_TYPEHASH, orderWithoutInteractions, keccak256(order.interactions)));
                                  calldatacopy(ptr, interactions.offset, interactions.length)
                                  mstore(add(ptr, 0x140), keccak256(ptr, interactions.length))
                                  calldatacopy(add(ptr, 0x20), order, 0x120)
                                  mstore(ptr, typehash)
                                  result := keccak256(ptr, 0x160)
                              }
                              result = ECDSA.toTypedDataHash(domainSeparator, result);
                          }
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/libraries/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      /// @title Library with gas efficient alternatives to `abi.decode`
                      library ArgumentsDecoder {
                          error IncorrectDataLength();
                      
                          function decodeUint256(bytes calldata data, uint256 offset) internal pure returns(uint256 value) {
                              unchecked { if (data.length < offset + 32) revert IncorrectDataLength(); }
                              // no memory ops inside so this insertion is automatically memory safe
                              assembly { // solhint-disable-line no-inline-assembly
                                  value := calldataload(add(data.offset, offset))
                              }
                          }
                      
                          function decodeSelector(bytes calldata data) internal pure returns(bytes4 value) {
                              if (data.length < 4) revert IncorrectDataLength();
                              // no memory ops inside so this insertion is automatically memory safe
                              assembly { // solhint-disable-line no-inline-assembly
                                  value := calldataload(data.offset)
                              }
                          }
                      
                          function decodeTailCalldata(bytes calldata data, uint256 tailOffset) internal pure returns(bytes calldata args) {
                              if (data.length < tailOffset) revert IncorrectDataLength();
                              // no memory ops inside so this insertion is automatically memory safe
                              assembly {  // solhint-disable-line no-inline-assembly
                                  args.offset := add(data.offset, tailOffset)
                                  args.length := sub(data.length, tailOffset)
                              }
                          }
                      
                          function decodeTargetAndCalldata(bytes calldata data) internal pure returns(address target, bytes calldata args) {
                              if (data.length < 20) revert IncorrectDataLength();
                              // no memory ops inside so this insertion is automatically memory safe
                              assembly {  // solhint-disable-line no-inline-assembly
                                  target := shr(96, calldataload(data.offset))
                                  args.offset := add(data.offset, 20)
                                  args.length := sub(data.length, 20)
                              }
                          }
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/helpers/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      /// @title A helper contract for managing nonce of tx sender
                      contract NonceManager {
                          error AdvanceNonceFailed();
                          event NonceIncreased(address indexed maker, uint256 newNonce);
                      
                          mapping(address => uint256) public nonce;
                      
                          /// @notice Advances nonce by one
                          function increaseNonce() external {
                              advanceNonce(1);
                          }
                      
                          /// @notice Advances nonce by specified amount
                          function advanceNonce(uint8 amount) public {
                              if (amount == 0) revert AdvanceNonceFailed();
                              uint256 newNonce = nonce[msg.sender] + amount;
                              nonce[msg.sender] = newNonce;
                              emit NonceIncreased(msg.sender, newNonce);
                          }
                      
                          /// @notice Checks if `makerAddress` has specified `makerNonce`
                          /// @return Result True if `makerAddress` has specified nonce. Otherwise, false
                          function nonceEquals(address makerAddress, uint256 makerNonce) public view returns(bool) {
                              return nonce[makerAddress] == makerNonce;
                          }
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/helpers/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      
                      /// @title A helper contract for executing boolean functions on arbitrary target call results
                      contract PredicateHelper is NonceManager {
                          using ArgumentsDecoder for bytes;
                      
                          error ArbitraryStaticCallFailed();
                      
                          /// @notice Calls every target with corresponding data
                          /// @return Result True if call to any target returned True. Otherwise, false
                          function or(uint256 offsets, bytes calldata data) public view returns(bool) {
                              uint256 current;
                              uint256 previous;
                              for (uint256 i = 0; (current = uint32(offsets >> i)) != 0; i += 32) {
                                  (bool success, uint256 res) = _selfStaticCall(data[previous:current]);
                                  if (success && res == 1) {
                                      return true;
                                  }
                                  previous = current;
                              }
                              return false;
                          }
                      
                          /// @notice Calls every target with corresponding data
                          /// @return Result True if calls to all targets returned True. Otherwise, false
                          function and(uint256 offsets, bytes calldata data) public view returns(bool) {
                              uint256 current;
                              uint256 previous;
                              for (uint256 i = 0; (current = uint32(offsets >> i)) != 0; i += 32) {
                                  (bool success, uint256 res) = _selfStaticCall(data[previous:current]);
                                  if (!success || res != 1) {
                                      return false;
                                  }
                                  previous = current;
                              }
                              return true;
                          }
                      
                          /// @notice Calls target with specified data and tests if it's equal to the value
                          /// @param value Value to test
                          /// @return Result True if call to target returns the same value as `value`. Otherwise, false
                          function eq(uint256 value, bytes calldata data) public view returns(bool) {
                              (bool success, uint256 res) = _selfStaticCall(data);
                              return success && res == value;
                          }
                      
                          /// @notice Calls target with specified data and tests if it's lower than value
                          /// @param value Value to test
                          /// @return Result True if call to target returns value which is lower than `value`. Otherwise, false
                          function lt(uint256 value, bytes calldata data) public view returns(bool) {
                              (bool success, uint256 res) = _selfStaticCall(data);
                              return success && res < value;
                          }
                      
                          /// @notice Calls target with specified data and tests if it's bigger than value
                          /// @param value Value to test
                          /// @return Result True if call to target returns value which is bigger than `value`. Otherwise, false
                          function gt(uint256 value, bytes calldata data) public view returns(bool) {
                              (bool success, uint256 res) = _selfStaticCall(data);
                              return success && res > value;
                          }
                      
                          /// @notice Checks passed time against block timestamp
                          /// @return Result True if current block timestamp is lower than `time`. Otherwise, false
                          function timestampBelow(uint256 time) public view returns(bool) {
                              return block.timestamp < time;  // solhint-disable-line not-rely-on-time
                          }
                      
                          /// @notice Performs an arbitrary call to target with data
                          /// @return Result Bytes transmuted to uint256
                          function arbitraryStaticCall(address target, bytes calldata data) public view returns(uint256) {
                              (bool success, uint256 res) = _staticcallForUint(target, data);
                              if (!success) revert ArbitraryStaticCallFailed();
                              return res;
                          }
                      
                          function timestampBelowAndNonceEquals(uint256 timeNonceAccount) public view returns(bool) {
                              uint256 _time = uint48(timeNonceAccount >> 208);
                              uint256 _nonce = uint48(timeNonceAccount >> 160);
                              address _account = address(uint160(timeNonceAccount));
                              return timestampBelow(_time) && nonceEquals(_account, _nonce);
                          }
                      
                          function _selfStaticCall(bytes calldata data) internal view returns(bool, uint256) {
                              uint256 selector = uint32(data.decodeSelector());
                              uint256 arg = data.decodeUint256(4);
                      
                              // special case for the most often used predicate
                              if (selector == uint32(this.timestampBelowAndNonceEquals.selector)) {  // 0x2cc2878d
                                  return (true, timestampBelowAndNonceEquals(arg) ? 1 : 0);
                              }
                      
                              if (selector < uint32(this.arbitraryStaticCall.selector)) {  // 0xbf15fcd8
                                  if (selector < uint32(this.eq.selector)) {  // 0x6fe7b0ba
                                      if (selector == uint32(this.gt.selector)) {  // 0x4f38e2b8
                                          return (true, gt(arg, data.decodeTailCalldata(100)) ? 1 : 0);
                                      } else if (selector == uint32(this.timestampBelow.selector)) {  // 0x63592c2b
                                          return (true, timestampBelow(arg) ? 1 : 0);
                                      }
                                  } else {
                                      if (selector == uint32(this.eq.selector)) {  // 0x6fe7b0ba
                                          return (true, eq(arg, data.decodeTailCalldata(100)) ? 1 : 0);
                                      } else if (selector == uint32(this.or.selector)) {  // 0x74261145
                                          return (true, or(arg, data.decodeTailCalldata(100)) ? 1 : 0);
                                      }
                                  }
                              } else {
                                  if (selector < uint32(this.lt.selector)) {  // 0xca4ece22
                                      if (selector == uint32(this.arbitraryStaticCall.selector)) {  // 0xbf15fcd8
                                          return (true, arbitraryStaticCall(address(uint160(arg)), data.decodeTailCalldata(100)));
                                      } else if (selector == uint32(this.and.selector)) {  // 0xbfa75143
                                          return (true, and(arg, data.decodeTailCalldata(100)) ? 1 : 0);
                                      }
                                  } else {
                                      if (selector == uint32(this.lt.selector)) {  // 0xca4ece22
                                          return (true, lt(arg, data.decodeTailCalldata(100)) ? 1 : 0);
                                      } else if (selector == uint32(this.nonceEquals.selector)) {  // 0xcf6fc6e3
                                          return (true, nonceEquals(address(uint160(arg)), data.decodeUint256(0x24)) ? 1 : 0);
                                      }
                                  }
                              }
                      
                              return _staticcallForUint(address(this), data);
                          }
                      
                          function _staticcallForUint(address target, bytes calldata input) private view returns(bool success, uint256 res) {
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let data := mload(0x40)
                      
                                  calldatacopy(data, input.offset, input.length)
                                  success := staticcall(gas(), target, data, input.length, 0x0, 0x20)
                                  success := and(success, eq(returndatasize(), 32))
                                  if success {
                                      res := mload(0)
                                  }
                              }
                          }
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/interfaces/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      interface IOrderMixin {
                          /**
                           * @notice Returns unfilled amount for order. Throws if order does not exist
                           * @param orderHash Order's hash. Can be obtained by the `hashOrder` function
                           * @return amount Unfilled amount
                           */
                          function remaining(bytes32 orderHash) external view returns(uint256 amount);
                      
                          /**
                           * @notice Returns unfilled amount for order
                           * @param orderHash Order's hash. Can be obtained by the `hashOrder` function
                           * @return rawAmount Unfilled amount of order plus one if order exists. Otherwise 0
                           */
                          function remainingRaw(bytes32 orderHash) external view returns(uint256 rawAmount);
                      
                          /**
                           * @notice Same as `remainingRaw` but for multiple orders
                           * @param orderHashes Array of hashes
                           * @return rawAmounts Array of amounts for each order plus one if order exists or 0 otherwise
                           */
                          function remainingsRaw(bytes32[] memory orderHashes) external view returns(uint256[] memory rawAmounts);
                      
                          /**
                           * @notice Checks order predicate
                           * @param order Order to check predicate for
                           * @return result Predicate evaluation result. True if predicate allows to fill the order, false otherwise
                           */
                          function checkPredicate(OrderLib.Order calldata order) external view returns(bool result);
                      
                          /**
                           * @notice Returns order hash according to EIP712 standard
                           * @param order Order to get hash for
                           * @return orderHash Hash of the order
                           */
                          function hashOrder(OrderLib.Order calldata order) external view returns(bytes32);
                      
                          /**
                           * @notice Delegates execution to custom implementation. Could be used to validate if `transferFrom` works properly
                           * @dev The function always reverts and returns the simulation results in revert data.
                           * @param target Addresses that will be delegated
                           * @param data Data that will be passed to delegatee
                           */
                          function simulate(address target, bytes calldata data) external;
                      
                          /**
                           * @notice Cancels order.
                           * @dev Order is cancelled by setting remaining amount to _ORDER_FILLED value
                           * @param order Order quote to cancel
                           * @return orderRemaining Unfilled amount of order before cancellation
                           * @return orderHash Hash of the filled order
                           */
                          function cancelOrder(OrderLib.Order calldata order) external returns(uint256 orderRemaining, bytes32 orderHash);
                      
                          /**
                           * @notice Fills an order. If one doesn't exist (first fill) it will be created using order.makerAssetData
                           * @param order Order quote to fill
                           * @param signature Signature to confirm quote ownership
                           * @param interaction A call data for InteractiveNotificationReceiver. Taker may execute interaction after getting maker assets and before sending taker assets.
                           * @param makingAmount Making amount
                           * @param takingAmount Taking amount
                           * @param skipPermitAndThresholdAmount Specifies maximum allowed takingAmount when takingAmount is zero, otherwise specifies minimum allowed makingAmount. Top-most bit specifies whether taker wants to skip maker's permit.
                           * @return actualMakingAmount Actual amount transferred from maker to taker
                           * @return actualTakingAmount Actual amount transferred from taker to maker
                           * @return orderHash Hash of the filled order
                           */
                          function fillOrder(
                              OrderLib.Order calldata order,
                              bytes calldata signature,
                              bytes calldata interaction,
                              uint256 makingAmount,
                              uint256 takingAmount,
                              uint256 skipPermitAndThresholdAmount
                          ) external payable returns(uint256 actualMakingAmount, uint256 actualTakingAmount, bytes32 orderHash);
                      
                          /**
                           * @notice Same as `fillOrderTo` 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`
                           * @dev See tests for examples
                           * @param order Order quote to fill
                           * @param signature Signature to confirm quote ownership
                           * @param interaction A call data for InteractiveNotificationReceiver. Taker may execute interaction after getting maker assets and before sending taker assets.
                           * @param makingAmount Making amount
                           * @param takingAmount Taking amount
                           * @param skipPermitAndThresholdAmount Specifies maximum allowed takingAmount when takingAmount is zero, otherwise specifies minimum allowed makingAmount. Top-most bit specifies whether taker wants to skip maker's permit.
                           * @param target Address that will receive swap funds
                           * @param permit Should consist of abiencoded token address and encoded `IERC20Permit.permit` call.
                           * @return actualMakingAmount Actual amount transferred from maker to taker
                           * @return actualTakingAmount Actual amount transferred from taker to maker
                           * @return orderHash Hash of the filled order
                           */
                          function fillOrderToWithPermit(
                              OrderLib.Order calldata order,
                              bytes calldata signature,
                              bytes calldata interaction,
                              uint256 makingAmount,
                              uint256 takingAmount,
                              uint256 skipPermitAndThresholdAmount,
                              address target,
                              bytes calldata permit
                          ) external returns(uint256 actualMakingAmount, uint256 actualTakingAmount, bytes32 orderHash);
                      
                          /**
                           * @notice Same as `fillOrder` but allows to specify funds destination instead of `msg.sender`
                           * @param order_ Order quote to fill
                           * @param signature Signature to confirm quote ownership
                           * @param interaction A call data for InteractiveNotificationReceiver. Taker may execute interaction after getting maker assets and before sending taker assets.
                           * @param makingAmount Making amount
                           * @param takingAmount Taking amount
                           * @param skipPermitAndThresholdAmount Specifies maximum allowed takingAmount when takingAmount is zero, otherwise specifies minimum allowed makingAmount. Top-most bit specifies whether taker wants to skip maker's permit.
                           * @param target Address that will receive swap funds
                           * @return actualMakingAmount Actual amount transferred from maker to taker
                           * @return actualTakingAmount Actual amount transferred from taker to maker
                           * @return orderHash Hash of the filled order
                           */
                          function fillOrderTo(
                              OrderLib.Order calldata order_,
                              bytes calldata signature,
                              bytes calldata interaction,
                              uint256 makingAmount,
                              uint256 takingAmount,
                              uint256 skipPermitAndThresholdAmount,
                              address target
                          ) external payable returns(uint256 actualMakingAmount, uint256 actualTakingAmount, bytes32 orderHash);
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/interfaces/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      /// @title Interface for interactor which acts between `maker => taker` and `taker => maker` transfers.
                      interface PreInteractionNotificationReceiver {
                          function fillOrderPreInteraction(
                              bytes32 orderHash,
                              address maker,
                              address taker,
                              uint256 makingAmount,
                              uint256 takingAmount,
                              uint256 remainingAmount,
                              bytes memory interactiveData
                          ) external;
                      }
                      
                      interface PostInteractionNotificationReceiver {
                          /// @notice Callback method that gets called after taker transferred funds to maker but before
                          /// the opposite transfer happened
                          function fillOrderPostInteraction(
                              bytes32 orderHash,
                              address maker,
                              address taker,
                              uint256 makingAmount,
                              uint256 takingAmount,
                              uint256 remainingAmount,
                              bytes memory interactiveData
                          ) external;
                      }
                      
                      interface InteractionNotificationReceiver {
                          function fillOrderInteraction(
                              address taker,
                              uint256 makingAmount,
                              uint256 takingAmount,
                              bytes memory interactiveData
                          ) external returns(uint256 offeredTakingAmount);
                      }
                      
                      
                      // File @1inch/limit-order-protocol/contracts/[email protected]
                      
                      
                      pragma solidity 0.8.17;
                      
                      
                      
                      
                      
                      
                      
                      
                      
                      
                      
                      /// @title Regular Limit Order mixin
                      abstract contract OrderMixin is IOrderMixin, EIP712, PredicateHelper {
                          using SafeERC20 for IERC20;
                          using ArgumentsDecoder for bytes;
                          using OrderLib for OrderLib.Order;
                      
                          error UnknownOrder();
                          error AccessDenied();
                          error AlreadyFilled();
                          error PermitLengthTooLow();
                          error ZeroTargetIsForbidden();
                          error RemainingAmountIsZero();
                          error PrivateOrder();
                          error BadSignature();
                          error ReentrancyDetected();
                          error PredicateIsNotTrue();
                          error OnlyOneAmountShouldBeZero();
                          error TakingAmountTooHigh();
                          error MakingAmountTooLow();
                          error SwapWithZeroAmount();
                          error TransferFromMakerToTakerFailed();
                          error TransferFromTakerToMakerFailed();
                          error WrongAmount();
                          error WrongGetter();
                          error GetAmountCallFailed();
                          error TakingAmountIncreased();
                          error SimulationResults(bool success, bytes res);
                      
                          /// @notice Emitted every time order gets filled, including partial fills
                          event OrderFilled(
                              address indexed maker,
                              bytes32 orderHash,
                              uint256 remaining
                          );
                      
                          /// @notice Emitted when order gets cancelled
                          event OrderCanceled(
                              address indexed maker,
                              bytes32 orderHash,
                              uint256 remainingRaw
                          );
                      
                          uint256 constant private _ORDER_DOES_NOT_EXIST = 0;
                          uint256 constant private _ORDER_FILLED = 1;
                          uint256 constant private _SKIP_PERMIT_FLAG = 1 << 255;
                          uint256 constant private _THRESHOLD_MASK = ~_SKIP_PERMIT_FLAG;
                      
                          IWETH private immutable _WETH;  // solhint-disable-line var-name-mixedcase
                          /// @notice Stores unfilled amounts for each order plus one.
                          /// Therefore 0 means order doesn't exist and 1 means order was filled
                          mapping(bytes32 => uint256) private _remaining;
                      
                          constructor(IWETH weth) {
                              _WETH = weth;
                          }
                      
                          /**
                           * @notice See {IOrderMixin-remaining}.
                           */
                          function remaining(bytes32 orderHash) external view returns(uint256 /* amount */) {
                              uint256 amount = _remaining[orderHash];
                              if (amount == _ORDER_DOES_NOT_EXIST) revert UnknownOrder();
                              unchecked { return amount - 1; }
                          }
                      
                          /**
                           * @notice See {IOrderMixin-remainingRaw}.
                           */
                          function remainingRaw(bytes32 orderHash) external view returns(uint256 /* rawAmount */) {
                              return _remaining[orderHash];
                          }
                      
                          /**
                           * @notice See {IOrderMixin-remainingsRaw}.
                           */
                          function remainingsRaw(bytes32[] memory orderHashes) external view returns(uint256[] memory /* rawAmounts */) {
                              uint256[] memory results = new uint256[](orderHashes.length);
                              for (uint256 i = 0; i < orderHashes.length; i++) {
                                  results[i] = _remaining[orderHashes[i]];
                              }
                              return results;
                          }
                      
                          /**
                           * @notice See {IOrderMixin-simulate}.
                           */
                          function simulate(address target, bytes calldata data) external {
                              // solhint-disable-next-line avoid-low-level-calls
                              (bool success, bytes memory result) = target.delegatecall(data);
                              revert SimulationResults(success, result);
                          }
                      
                          /**
                           * @notice See {IOrderMixin-cancelOrder}.
                           */
                          function cancelOrder(OrderLib.Order calldata order) external returns(uint256 orderRemaining, bytes32 orderHash) {
                              if (order.maker != msg.sender) revert AccessDenied();
                      
                              orderHash = hashOrder(order);
                              orderRemaining = _remaining[orderHash];
                              if (orderRemaining == _ORDER_FILLED) revert AlreadyFilled();
                              emit OrderCanceled(msg.sender, orderHash, orderRemaining);
                              _remaining[orderHash] = _ORDER_FILLED;
                          }
                      
                          /**
                           * @notice See {IOrderMixin-fillOrder}.
                           */
                          function fillOrder(
                              OrderLib.Order calldata order,
                              bytes calldata signature,
                              bytes calldata interaction,
                              uint256 makingAmount,
                              uint256 takingAmount,
                              uint256 skipPermitAndThresholdAmount
                          ) external payable returns(uint256 /* actualMakingAmount */, uint256 /* actualTakingAmount */, bytes32 /* orderHash */) {
                              return fillOrderTo(order, signature, interaction, makingAmount, takingAmount, skipPermitAndThresholdAmount, msg.sender);
                          }
                      
                          /**
                           * @notice See {IOrderMixin-fillOrderToWithPermit}.
                           */
                          function fillOrderToWithPermit(
                              OrderLib.Order calldata order,
                              bytes calldata signature,
                              bytes calldata interaction,
                              uint256 makingAmount,
                              uint256 takingAmount,
                              uint256 skipPermitAndThresholdAmount,
                              address target,
                              bytes calldata permit
                          ) external returns(uint256 /* actualMakingAmount */, uint256 /* actualTakingAmount */, bytes32 /* orderHash */) {
                              if (permit.length < 20) revert PermitLengthTooLow();
                              {  // Stack too deep
                                  (address token, bytes calldata permitData) = permit.decodeTargetAndCalldata();
                                  IERC20(token).safePermit(permitData);
                              }
                              return fillOrderTo(order, signature, interaction, makingAmount, takingAmount, skipPermitAndThresholdAmount, target);
                          }
                      
                          /**
                           * @notice See {IOrderMixin-fillOrderTo}.
                           */
                          function fillOrderTo(
                              OrderLib.Order calldata order_,
                              bytes calldata signature,
                              bytes calldata interaction,
                              uint256 makingAmount,
                              uint256 takingAmount,
                              uint256 skipPermitAndThresholdAmount,
                              address target
                          ) public payable returns(uint256 actualMakingAmount, uint256 actualTakingAmount, bytes32 orderHash) {
                              if (target == address(0)) revert ZeroTargetIsForbidden();
                              orderHash = hashOrder(order_);
                      
                              OrderLib.Order calldata order = order_; // Helps with "Stack too deep"
                              actualMakingAmount = makingAmount;
                              actualTakingAmount = takingAmount;
                      
                              uint256 remainingMakingAmount = _remaining[orderHash];
                              if (remainingMakingAmount == _ORDER_FILLED) revert RemainingAmountIsZero();
                              if (order.allowedSender != address(0) && order.allowedSender != msg.sender) revert PrivateOrder();
                              if (remainingMakingAmount == _ORDER_DOES_NOT_EXIST) {
                                  // First fill: validate order and permit maker asset
                                  if (!ECDSA.recoverOrIsValidSignature(order.maker, orderHash, signature)) revert BadSignature();
                                  remainingMakingAmount = order.makingAmount;
                      
                                  bytes calldata permit = order.permit();
                                  if (skipPermitAndThresholdAmount & _SKIP_PERMIT_FLAG == 0 && permit.length >= 20) {
                                      // proceed only if taker is willing to execute permit and its length is enough to store address
                                      (address token, bytes calldata permitCalldata) = permit.decodeTargetAndCalldata();
                                      IERC20(token).safePermit(permitCalldata);
                                      if (_remaining[orderHash] != _ORDER_DOES_NOT_EXIST) revert ReentrancyDetected();
                                  }
                              } else {
                                  unchecked { remainingMakingAmount -= 1; }
                              }
                      
                              // Check if order is valid
                              if (order.predicate().length > 0) {
                                  if (!checkPredicate(order)) revert PredicateIsNotTrue();
                              }
                      
                              // Compute maker and taker assets amount
                              if ((actualTakingAmount == 0) == (actualMakingAmount == 0)) {
                                  revert OnlyOneAmountShouldBeZero();
                              } else if (actualTakingAmount == 0) {
                                  if (actualMakingAmount > remainingMakingAmount) {
                                      actualMakingAmount = remainingMakingAmount;
                                  }
                                  actualTakingAmount = _getTakingAmount(order.getTakingAmount(), order.makingAmount, actualMakingAmount, order.takingAmount, remainingMakingAmount, orderHash);
                                  uint256 thresholdAmount = skipPermitAndThresholdAmount & _THRESHOLD_MASK;
                                  // check that actual rate is not worse than what was expected
                                  // actualTakingAmount / actualMakingAmount <= thresholdAmount / makingAmount
                                  if (actualTakingAmount * makingAmount > thresholdAmount * actualMakingAmount) revert TakingAmountTooHigh();
                              } else {
                                  actualMakingAmount = _getMakingAmount(order.getMakingAmount(), order.takingAmount, actualTakingAmount, order.makingAmount, remainingMakingAmount, orderHash);
                                  if (actualMakingAmount > remainingMakingAmount) {
                                      actualMakingAmount = remainingMakingAmount;
                                      actualTakingAmount = _getTakingAmount(order.getTakingAmount(), order.makingAmount, actualMakingAmount, order.takingAmount, remainingMakingAmount, orderHash);
                                      if (actualTakingAmount > takingAmount) revert TakingAmountIncreased();
                                  }
                                  uint256 thresholdAmount = skipPermitAndThresholdAmount & _THRESHOLD_MASK;
                                  // check that actual rate is not worse than what was expected
                                  // actualMakingAmount / actualTakingAmount >= thresholdAmount / takingAmount
                                  if (actualMakingAmount * takingAmount < thresholdAmount * actualTakingAmount) revert MakingAmountTooLow();
                              }
                      
                              if (actualMakingAmount == 0 || actualTakingAmount == 0) revert SwapWithZeroAmount();
                      
                              // Update remaining amount in storage
                              unchecked {
                                  remainingMakingAmount = remainingMakingAmount - actualMakingAmount;
                                  _remaining[orderHash] = remainingMakingAmount + 1;
                              }
                              emit OrderFilled(order_.maker, orderHash, remainingMakingAmount);
                      
                              // Maker can handle funds interactively
                              if (order.preInteraction().length >= 20) {
                                  // proceed only if interaction length is enough to store address
                                  (address interactionTarget, bytes calldata interactionData) = order.preInteraction().decodeTargetAndCalldata();
                                  PreInteractionNotificationReceiver(interactionTarget).fillOrderPreInteraction(
                                      orderHash, order.maker, msg.sender, actualMakingAmount, actualTakingAmount, remainingMakingAmount, interactionData
                                  );
                              }
                      
                              // Maker => Taker
                              if (!_callTransferFrom(
                                  order.makerAsset,
                                  order.maker,
                                  target,
                                  actualMakingAmount,
                                  order.makerAssetData()
                              )) revert TransferFromMakerToTakerFailed();
                      
                              if (interaction.length >= 20) {
                                  // proceed only if interaction length is enough to store address
                                  (address interactionTarget, bytes calldata interactionData) = interaction.decodeTargetAndCalldata();
                                  uint256 offeredTakingAmount = InteractionNotificationReceiver(interactionTarget).fillOrderInteraction(
                                      msg.sender, actualMakingAmount, actualTakingAmount, interactionData
                                  );
                      
                                  if (offeredTakingAmount > actualTakingAmount &&
                                      !OrderLib.getterIsFrozen(order.getMakingAmount()) &&
                                      !OrderLib.getterIsFrozen(order.getTakingAmount()))
                                  {
                                      actualTakingAmount = offeredTakingAmount;
                                  }
                              }
                      
                              // Taker => Maker
                              if (order.takerAsset == address(_WETH) && msg.value > 0) {
                                  if (msg.value < actualTakingAmount) revert Errors.InvalidMsgValue();
                                  if (msg.value > actualTakingAmount) {
                                      unchecked {
                                          (bool success, ) = msg.sender.call{value: msg.value - actualTakingAmount}("");  // solhint-disable-line avoid-low-level-calls
                                          if (!success) revert Errors.ETHTransferFailed();
                                      }
                                  }
                                  _WETH.deposit{ value: actualTakingAmount }();
                                  _WETH.transfer(order.receiver == address(0) ? order.maker : order.receiver, actualTakingAmount);
                              } else {
                                  if (msg.value != 0) revert Errors.InvalidMsgValue();
                                  if (!_callTransferFrom(
                                      order.takerAsset,
                                      msg.sender,
                                      order.receiver == address(0) ? order.maker : order.receiver,
                                      actualTakingAmount,
                                      order.takerAssetData()
                                  )) revert TransferFromTakerToMakerFailed();
                              }
                      
                              // Maker can handle funds interactively
                              if (order.postInteraction().length >= 20) {
                                  // proceed only if interaction length is enough to store address
                                  (address interactionTarget, bytes calldata interactionData) = order.postInteraction().decodeTargetAndCalldata();
                                  PostInteractionNotificationReceiver(interactionTarget).fillOrderPostInteraction(
                                       orderHash, order.maker, msg.sender, actualMakingAmount, actualTakingAmount, remainingMakingAmount, interactionData
                                  );
                              }
                          }
                      
                          /**
                           * @notice See {IOrderMixin-checkPredicate}.
                           */
                          function checkPredicate(OrderLib.Order calldata order) public view returns(bool) {
                              (bool success, uint256 res) = _selfStaticCall(order.predicate());
                              return success && res == 1;
                          }
                      
                          /**
                           * @notice See {IOrderMixin-hashOrder}.
                           */
                          function hashOrder(OrderLib.Order calldata order) public view returns(bytes32) {
                              return order.hash(_domainSeparatorV4());
                          }
                      
                          function _callTransferFrom(address asset, address from, address to, uint256 amount, bytes calldata input) private returns(bool success) {
                              bytes4 selector = IERC20.transferFrom.selector;
                              /// @solidity memory-safe-assembly
                              assembly { // solhint-disable-line no-inline-assembly
                                  let data := mload(0x40)
                      
                                  mstore(data, selector)
                                  mstore(add(data, 0x04), from)
                                  mstore(add(data, 0x24), to)
                                  mstore(add(data, 0x44), amount)
                                  calldatacopy(add(data, 0x64), input.offset, input.length)
                                  let status := call(gas(), asset, 0, data, add(0x64, input.length), 0x0, 0x20)
                                  success := and(status, or(iszero(returndatasize()), and(gt(returndatasize(), 31), eq(mload(0), 1))))
                              }
                          }
                      
                          function _getMakingAmount(
                              bytes calldata getter,
                              uint256 orderTakingAmount,
                              uint256 requestedTakingAmount,
                              uint256 orderMakingAmount,
                              uint256 remainingMakingAmount,
                              bytes32 orderHash
                          ) private view returns(uint256) {
                              if (getter.length == 0) {
                                  // Linear proportion
                                  return AmountCalculator.getMakingAmount(orderMakingAmount, orderTakingAmount, requestedTakingAmount);
                              }
                              return _callGetter(getter, orderTakingAmount, requestedTakingAmount, orderMakingAmount, remainingMakingAmount, orderHash);
                          }
                      
                          function _getTakingAmount(
                              bytes calldata getter,
                              uint256 orderMakingAmount,
                              uint256 requestedMakingAmount,
                              uint256 orderTakingAmount,
                              uint256 remainingMakingAmount,
                              bytes32 orderHash
                          ) private view returns(uint256) {
                              if (getter.length == 0) {
                                  // Linear proportion
                                  return AmountCalculator.getTakingAmount(orderMakingAmount, orderTakingAmount, requestedMakingAmount);
                              }
                              return _callGetter(getter, orderMakingAmount, requestedMakingAmount, orderTakingAmount, remainingMakingAmount, orderHash);
                          }
                      
                          function _callGetter(
                              bytes calldata getter,
                              uint256 orderExpectedAmount,
                              uint256 requestedAmount,
                              uint256 orderResultAmount,
                              uint256 remainingMakingAmount,
                              bytes32 orderHash
                          ) private view returns(uint256) {
                              if (getter.length == 1) {
                                  if (OrderLib.getterIsFrozen(getter)) {
                                      // On "x" getter calldata only exact amount is allowed
                                      if (requestedAmount != orderExpectedAmount) revert WrongAmount();
                                      return orderResultAmount;
                                  } else {
                                      revert WrongGetter();
                                  }
                              } else {
                                  (address target, bytes calldata data) = getter.decodeTargetAndCalldata();
                                  (bool success, bytes memory result) = target.staticcall(abi.encodePacked(data, requestedAmount, remainingMakingAmount, orderHash));
                                  if (!success || result.length != 32) revert GetAmountCallFailed();
                                  return abi.decode(result, (uint256));
                              }
                          }
                      }
                      
                      
                      // File @openzeppelin/contracts/utils/[email protected]
                      
                      // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
                      
                      pragma solidity ^0.8.0;
                      
                      /**
                       * @dev Provides information about the current execution context, including the
                       * sender of the transaction and its data. While these are generally available
                       * via msg.sender and msg.data, they should not be accessed in such a direct
                       * manner, since when dealing with meta-transactions the account sending and
                       * paying for execution may not be the actual sender (as far as an application
                       * is concerned).
                       *
                       * This contract is only required for intermediate, library-like contracts.
                       */
                      abstract contract Context {
                          function _msgSender() internal view virtual returns (address) {
                              return msg.sender;
                          }
                      
                          function _msgData() internal view virtual returns (bytes calldata) {
                              return msg.data;
                          }
                      }
                      
                      
                      // File @openzeppelin/contracts/access/[email protected]
                      
                      // OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)
                      
                      pragma solidity ^0.8.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() {
                              _transferOwnership(_msgSender());
                          }
                      
                          /**
                           * @dev Throws if called by any account other than the owner.
                           */
                          modifier onlyOwner() {
                              _checkOwner();
                              _;
                          }
                      
                          /**
                           * @dev Returns the address of the current owner.
                           */
                          function owner() public view virtual returns (address) {
                              return _owner;
                          }
                      
                          /**
                           * @dev Throws if the sender is not the owner.
                           */
                          function _checkOwner() internal view virtual {
                              require(owner() == _msgSender(), "Ownable: caller is not the owner");
                          }
                      
                          /**
                           * @dev Leaves the contract without owner. It will not be possible to call
                           * `onlyOwner` functions 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 {
                              _transferOwnership(address(0));
                          }
                      
                          /**
                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                           * Can only be called by the current owner.
                           */
                          function transferOwnership(address newOwner) public virtual onlyOwner {
                              require(newOwner != address(0), "Ownable: new owner is the zero address");
                              _transferOwnership(newOwner);
                          }
                      
                          /**
                           * @dev Transfers ownership of the contract to a new account (`newOwner`).
                           * Internal function without access restriction.
                           */
                          function _transferOwnership(address newOwner) internal virtual {
                              address oldOwner = _owner;
                              _owner = newOwner;
                              emit OwnershipTransferred(oldOwner, newOwner);
                          }
                      }
                      
                      
                      // File contracts/AggregationRouterV5.sol
                      
                      
                      pragma solidity 0.8.17;
                      
                      
                      
                      
                      
                      
                      
                      
                      
                      /// @notice Main contract incorporates a number of routers to perform swaps and limit orders protocol to fill limit orders
                      contract AggregationRouterV5 is EIP712("1inch Aggregation Router", "5"), Ownable,
                          ClipperRouter, GenericRouter, UnoswapRouter, UnoswapV3Router, OrderMixin, OrderRFQMixin
                      {
                          using UniERC20 for IERC20;
                      
                          error ZeroAddress();
                      
                          /**
                           * @dev Sets the wrapped eth token and clipper exhange interface
                           * Both values are immutable: they can only be set once during
                           * construction.
                           */
                          constructor(IWETH weth)
                              UnoswapV3Router(weth)
                              ClipperRouter(weth)
                              OrderMixin(weth)
                              OrderRFQMixin(weth)
                          {
                              if (address(weth) == address(0)) revert ZeroAddress();
                          }
                      
                          /**
                           * @notice Retrieves funds accidently sent directly to the contract address
                           * @param token ERC20 token to retrieve
                           * @param amount amount to retrieve
                           */
                          function rescueFunds(IERC20 token, uint256 amount) external onlyOwner {
                              token.uniTransfer(payable(msg.sender), amount);
                          }
                      
                          /**
                           * @notice Destroys the contract and sends eth to sender. Use with caution.
                           * The only case when the use of the method is justified is if there is an exploit found.
                           * And the damage from the exploit is greater than from just an urgent contract change.
                           */
                          function destroy() external onlyOwner {
                              selfdestruct(payable(msg.sender));
                          }
                      
                          function _receive() internal override(EthReceiver, OnlyWethReceiver) {
                              EthReceiver._receive();
                          }
                      }

                      File 2 of 3: AdminUpgradeabilityProxy
                      /**
                       *Submitted for verification at Etherscan.io on 2018-10-22
                      */
                      
                      pragma solidity ^0.4.24;
                      
                      // File: contracts/upgradeability/Proxy.sol
                      
                      /**
                       * @title Proxy
                       * @dev Implements delegation of calls to other contracts, with proper
                       * forwarding of return values and bubbling of failures.
                       * It defines a fallback function that delegates all calls to the address
                       * returned by the abstract _implementation() internal function.
                       */
                      contract Proxy {
                        /**
                         * @dev Fallback function.
                         * Implemented entirely in `_fallback`.
                         */
                        function () payable external {
                          _fallback();
                        }
                      
                        /**
                         * @return The Address of the implementation.
                         */
                        function _implementation() internal view returns (address);
                      
                        /**
                         * @dev Delegates execution to an implementation contract.
                         * This is a low level function that doesn't return to its internal call site.
                         * It will return to the external caller whatever the implementation returns.
                         * @param implementation Address to delegate.
                         */
                        function _delegate(address implementation) internal {
                          assembly {
                            // Copy msg.data. We take full control of memory in this inline assembly
                            // block because it will not return to Solidity code. We overwrite the
                            // Solidity scratch pad at memory position 0.
                            calldatacopy(0, 0, calldatasize)
                      
                            // Call the implementation.
                            // out and outsize are 0 because we don't know the size yet.
                            let result := delegatecall(gas, implementation, 0, calldatasize, 0, 0)
                      
                            // Copy the returned data.
                            returndatacopy(0, 0, returndatasize)
                      
                            switch result
                            // delegatecall returns 0 on error.
                            case 0 { revert(0, returndatasize) }
                            default { return(0, returndatasize) }
                          }
                        }
                      
                        /**
                         * @dev Function that is run as the first thing in the fallback function.
                         * Can be redefined in derived contracts to add functionality.
                         * Redefinitions must call super._willFallback().
                         */
                        function _willFallback() internal {
                        }
                      
                        /**
                         * @dev fallback implementation.
                         * Extracted to enable manual triggering.
                         */
                        function _fallback() internal {
                          _willFallback();
                          _delegate(_implementation());
                        }
                      }
                      
                      // File: openzeppelin-solidity/contracts/AddressUtils.sol
                      
                      /**
                       * Utility library of inline functions on addresses
                       */
                      library AddressUtils {
                      
                        /**
                         * Returns whether the target address is a contract
                         * @dev This function will return false if invoked during the constructor of a contract,
                         *  as the code is not actually created until after the constructor finishes.
                         * @param addr address to check
                         * @return whether the target address is a contract
                         */
                        function isContract(address addr) internal view returns (bool) {
                          uint256 size;
                          // XXX Currently there is no better way to check if there is a contract in an address
                          // than to check the size of the code at that address.
                          // See https://ethereum.stackexchange.com/a/14016/36603
                          // for more details about how this works.
                          // TODO Check this again before the Serenity release, because all addresses will be
                          // contracts then.
                          // solium-disable-next-line security/no-inline-assembly
                          assembly { size := extcodesize(addr) }
                          return size > 0;
                        }
                      
                      }
                      
                      // File: contracts/upgradeability/UpgradeabilityProxy.sol
                      
                      /**
                       * @title UpgradeabilityProxy
                       * @dev This contract implements a proxy that allows to change the
                       * implementation address to which it will delegate.
                       * Such a change is called an implementation upgrade.
                       */
                      contract UpgradeabilityProxy is Proxy {
                        /**
                         * @dev Emitted when the implementation is upgraded.
                         * @param implementation Address of the new implementation.
                         */
                        event Upgraded(address indexed implementation);
                      
                        /**
                         * @dev Storage slot with the address of the current implementation.
                         * This is the keccak-256 hash of "org.zeppelinos.proxy.implementation", and is
                         * validated in the constructor.
                         */
                        bytes32 private constant IMPLEMENTATION_SLOT = 0x7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c3;
                      
                        /**
                         * @dev Contract constructor.
                         * @param _implementation Address of the initial implementation.
                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                         * It should include the signature and the parameters of the function to be called, as described in
                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                         */
                        constructor(address _implementation, bytes _data) public payable {
                          assert(IMPLEMENTATION_SLOT == keccak256("org.zeppelinos.proxy.implementation"));
                          _setImplementation(_implementation);
                          if(_data.length > 0) {
                            require(_implementation.delegatecall(_data));
                          }
                        }
                      
                        /**
                         * @dev Returns the current implementation.
                         * @return Address of the current implementation
                         */
                        function _implementation() internal view returns (address impl) {
                          bytes32 slot = IMPLEMENTATION_SLOT;
                          assembly {
                            impl := sload(slot)
                          }
                        }
                      
                        /**
                         * @dev Upgrades the proxy to a new implementation.
                         * @param newImplementation Address of the new implementation.
                         */
                        function _upgradeTo(address newImplementation) internal {
                          _setImplementation(newImplementation);
                          emit Upgraded(newImplementation);
                        }
                      
                        /**
                         * @dev Sets the implementation address of the proxy.
                         * @param newImplementation Address of the new implementation.
                         */
                        function _setImplementation(address newImplementation) private {
                          require(AddressUtils.isContract(newImplementation), "Cannot set a proxy implementation to a non-contract address");
                      
                          bytes32 slot = IMPLEMENTATION_SLOT;
                      
                          assembly {
                            sstore(slot, newImplementation)
                          }
                        }
                      }
                      
                      // File: contracts/upgradeability/AdminUpgradeabilityProxy.sol
                      
                      /**
                       * @title AdminUpgradeabilityProxy
                       * @dev This contract combines an upgradeability proxy with an authorization
                       * mechanism for administrative tasks.
                       * All external functions in this contract must be guarded by the
                       * `ifAdmin` modifier. See ethereum/solidity#3864 for a Solidity
                       * feature proposal that would enable this to be done automatically.
                       */
                      contract AdminUpgradeabilityProxy is UpgradeabilityProxy {
                        /**
                         * @dev Emitted when the administration has been transferred.
                         * @param previousAdmin Address of the previous admin.
                         * @param newAdmin Address of the new admin.
                         */
                        event AdminChanged(address previousAdmin, address newAdmin);
                      
                        /**
                         * @dev Storage slot with the admin of the contract.
                         * This is the keccak-256 hash of "org.zeppelinos.proxy.admin", and is
                         * validated in the constructor.
                         */
                        bytes32 private constant ADMIN_SLOT = 0x10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b;
                      
                        /**
                         * @dev Modifier to check whether the `msg.sender` is the admin.
                         * If it is, it will run the function. Otherwise, it will delegate the call
                         * to the implementation.
                         */
                        modifier ifAdmin() {
                          if (msg.sender == _admin()) {
                            _;
                          } else {
                            _fallback();
                          }
                        }
                      
                        /**
                         * Contract constructor.
                         * It sets the `msg.sender` as the proxy administrator.
                         * @param _implementation address of the initial implementation.
                         * @param _data Data to send as msg.data to the implementation to initialize the proxied contract.
                         * It should include the signature and the parameters of the function to be called, as described in
                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                         * This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.
                         */
                        constructor(address _implementation, bytes _data) UpgradeabilityProxy(_implementation, _data) public payable {
                          assert(ADMIN_SLOT == keccak256("org.zeppelinos.proxy.admin"));
                      
                          _setAdmin(msg.sender);
                        }
                      
                        /**
                         * @return The address of the proxy admin.
                         */
                        function admin() external view ifAdmin returns (address) {
                          return _admin();
                        }
                      
                        /**
                         * @return The address of the implementation.
                         */
                        function implementation() external view ifAdmin returns (address) {
                          return _implementation();
                        }
                      
                        /**
                         * @dev Changes the admin of the proxy.
                         * Only the current admin can call this function.
                         * @param newAdmin Address to transfer proxy administration to.
                         */
                        function changeAdmin(address newAdmin) external ifAdmin {
                          require(newAdmin != address(0), "Cannot change the admin of a proxy to the zero address");
                          emit AdminChanged(_admin(), newAdmin);
                          _setAdmin(newAdmin);
                        }
                      
                        /**
                         * @dev Upgrade the backing implementation of the proxy.
                         * Only the admin can call this function.
                         * @param newImplementation Address of the new implementation.
                         */
                        function upgradeTo(address newImplementation) external ifAdmin {
                          _upgradeTo(newImplementation);
                        }
                      
                        /**
                         * @dev Upgrade the backing implementation of the proxy and call a function
                         * on the new implementation.
                         * This is useful to initialize the proxied contract.
                         * @param newImplementation Address of the new implementation.
                         * @param data Data to send as msg.data in the low level call.
                         * It should include the signature and the parameters of the function to be called, as described in
                         * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.
                         */
                        function upgradeToAndCall(address newImplementation, bytes data) payable external ifAdmin {
                          _upgradeTo(newImplementation);
                          require(newImplementation.delegatecall(data));
                        }
                      
                        /**
                         * @return The admin slot.
                         */
                        function _admin() internal view returns (address adm) {
                          bytes32 slot = ADMIN_SLOT;
                          assembly {
                            adm := sload(slot)
                          }
                        }
                      
                        /**
                         * @dev Sets the address of the proxy admin.
                         * @param newAdmin Address of the new proxy admin.
                         */
                        function _setAdmin(address newAdmin) internal {
                          bytes32 slot = ADMIN_SLOT;
                      
                          assembly {
                            sstore(slot, newAdmin)
                          }
                        }
                      
                        /**
                         * @dev Only fall back when the sender is not the admin.
                         */
                        function _willFallback() internal {
                          require(msg.sender != _admin(), "Cannot call fallback function from the proxy admin");
                          super._willFallback();
                        }
                      }

                      File 3 of 3: RenderToken
                      pragma solidity ^0.4.24;
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/node_modules/openzeppelin-zos/contracts/token/ERC20/ERC20Basic.sol
                      
                      /**
                       * @title ERC20Basic
                       * @dev Simpler version of ERC20 interface
                       * @dev see https://github.com/ethereum/EIPs/issues/179
                       */
                      contract ERC20Basic {
                        function totalSupply() public view returns (uint256);
                        function balanceOf(address who) public view returns (uint256);
                        function transfer(address to, uint256 value) public returns (bool);
                        event Transfer(address indexed from, address indexed to, uint256 value);
                      }
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/node_modules/openzeppelin-zos/contracts/token/ERC20/ERC20.sol
                      
                      /**
                       * @title ERC20 interface
                       * @dev see https://github.com/ethereum/EIPs/issues/20
                       */
                      contract ERC20 is ERC20Basic {
                        function allowance(address owner, address spender) public view returns (uint256);
                        function transferFrom(address from, address to, uint256 value) public returns (bool);
                        function approve(address spender, uint256 value) public returns (bool);
                        event Approval(address indexed owner, address indexed spender, uint256 value);
                      }
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/node_modules/openzeppelin-zos/contracts/token/ERC20/SafeERC20.sol
                      
                      /**
                       * @title SafeERC20
                       * @dev Wrappers around ERC20 operations that throw on failure.
                       * To use this library you can add a `using SafeERC20 for ERC20;` statement to your contract,
                       * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                       */
                      library SafeERC20 {
                        function safeTransfer(ERC20Basic token, address to, uint256 value) internal {
                          assert(token.transfer(to, value));
                        }
                      
                        function safeTransferFrom(
                          ERC20 token,
                          address from,
                          address to,
                          uint256 value
                        )
                          internal
                        {
                          assert(token.transferFrom(from, to, value));
                        }
                      
                        function safeApprove(ERC20 token, address spender, uint256 value) internal {
                          assert(token.approve(spender, value));
                        }
                      }
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/node_modules/zos-lib/contracts/migrations/Migratable.sol
                      
                      /**
                       * @title Migratable
                       * Helper contract to support intialization and migration schemes between
                       * different implementations of a contract in the context of upgradeability.
                       * To use it, replace the constructor with a function that has the
                       * `isInitializer` modifier starting with `"0"` as `migrationId`.
                       * When you want to apply some migration code during an upgrade, increase
                       * the `migrationId`. Or, if the migration code must be applied only after
                       * another migration has been already applied, use the `isMigration` modifier.
                       * This helper supports multiple inheritance.
                       * WARNING: It is the developer's responsibility to ensure that migrations are
                       * applied in a correct order, or that they are run at all.
                       * See `Initializable` for a simpler version.
                       */
                      contract Migratable {
                        /**
                         * @dev Emitted when the contract applies a migration.
                         * @param contractName Name of the Contract.
                         * @param migrationId Identifier of the migration applied.
                         */
                        event Migrated(string contractName, string migrationId);
                      
                        /**
                         * @dev Mapping of the already applied migrations.
                         * (contractName => (migrationId => bool))
                         */
                        mapping (string => mapping (string => bool)) internal migrated;
                      
                        /**
                         * @dev Internal migration id used to specify that a contract has already been initialized.
                         */
                        string constant private INITIALIZED_ID = "initialized";
                      
                      
                        /**
                         * @dev Modifier to use in the initialization function of a contract.
                         * @param contractName Name of the contract.
                         * @param migrationId Identifier of the migration.
                         */
                        modifier isInitializer(string contractName, string migrationId) {
                          validateMigrationIsPending(contractName, INITIALIZED_ID);
                          validateMigrationIsPending(contractName, migrationId);
                          _;
                          emit Migrated(contractName, migrationId);
                          migrated[contractName][migrationId] = true;
                          migrated[contractName][INITIALIZED_ID] = true;
                        }
                      
                        /**
                         * @dev Modifier to use in the migration of a contract.
                         * @param contractName Name of the contract.
                         * @param requiredMigrationId Identifier of the previous migration, required
                         * to apply new one.
                         * @param newMigrationId Identifier of the new migration to be applied.
                         */
                        modifier isMigration(string contractName, string requiredMigrationId, string newMigrationId) {
                          require(isMigrated(contractName, requiredMigrationId), "Prerequisite migration ID has not been run yet");
                          validateMigrationIsPending(contractName, newMigrationId);
                          _;
                          emit Migrated(contractName, newMigrationId);
                          migrated[contractName][newMigrationId] = true;
                        }
                      
                        /**
                         * @dev Returns true if the contract migration was applied.
                         * @param contractName Name of the contract.
                         * @param migrationId Identifier of the migration.
                         * @return true if the contract migration was applied, false otherwise.
                         */
                        function isMigrated(string contractName, string migrationId) public view returns(bool) {
                          return migrated[contractName][migrationId];
                        }
                      
                        /**
                         * @dev Initializer that marks the contract as initialized.
                         * It is important to run this if you had deployed a previous version of a Migratable contract.
                         * For more information see https://github.com/zeppelinos/zos-lib/issues/158.
                         */
                        function initialize() isInitializer("Migratable", "1.2.1") public {
                        }
                      
                        /**
                         * @dev Reverts if the requested migration was already executed.
                         * @param contractName Name of the contract.
                         * @param migrationId Identifier of the migration.
                         */
                        function validateMigrationIsPending(string contractName, string migrationId) private {
                          require(!isMigrated(contractName, migrationId), "Requested target migration ID has already been run");
                        }
                      }
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/node_modules/openzeppelin-zos/contracts/ownership/Ownable.sol
                      
                      /**
                       * @title Ownable
                       * @dev The Ownable contract has an owner address, and provides basic authorization control
                       * functions, this simplifies the implementation of "user permissions".
                       */
                      contract Ownable is Migratable {
                        address public owner;
                      
                      
                        event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                      
                        /**
                         * @dev The Ownable constructor sets the original `owner` of the contract to the sender
                         * account.
                         */
                        function initialize(address _sender) public isInitializer("Ownable", "1.9.0") {
                          owner = _sender;
                        }
                      
                        /**
                         * @dev Throws if called by any account other than the owner.
                         */
                        modifier onlyOwner() {
                          require(msg.sender == owner);
                          _;
                        }
                      
                        /**
                         * @dev Allows the current owner to transfer control of the contract to a newOwner.
                         * @param newOwner The address to transfer ownership to.
                         */
                        function transferOwnership(address newOwner) public onlyOwner {
                          require(newOwner != address(0));
                          emit OwnershipTransferred(owner, newOwner);
                          owner = newOwner;
                        }
                      
                      }
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/node_modules/openzeppelin-zos/contracts/math/SafeMath.sol
                      
                      /**
                       * @title SafeMath
                       * @dev Math operations with safety checks that throw on error
                       */
                      library SafeMath {
                      
                        /**
                        * @dev Multiplies two numbers, throws on overflow.
                        */
                        function mul(uint256 a, uint256 b) internal pure returns (uint256 c) {
                          if (a == 0) {
                            return 0;
                          }
                          c = a * b;
                          assert(c / a == b);
                          return c;
                        }
                      
                        /**
                        * @dev Integer division of two numbers, truncating the quotient.
                        */
                        function div(uint256 a, uint256 b) internal pure returns (uint256) {
                          // assert(b > 0); // Solidity automatically throws when dividing by 0
                          // uint256 c = a / b;
                          // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                          return a / b;
                        }
                      
                        /**
                        * @dev Subtracts two numbers, throws on overflow (i.e. if subtrahend is greater than minuend).
                        */
                        function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                          assert(b <= a);
                          return a - b;
                        }
                      
                        /**
                        * @dev Adds two numbers, throws on overflow.
                        */
                        function add(uint256 a, uint256 b) internal pure returns (uint256 c) {
                          c = a + b;
                          assert(c >= a);
                          return c;
                        }
                      }
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/contracts/Escrow.sol
                      
                      /**
                       * @title Escrow
                       * @dev Escrow contract that works with RNDR token
                       * This contract holds tokens while render jobs are being completed
                       * and information on token allottment per job
                       */
                      contract Escrow is Migratable, Ownable {
                        using SafeERC20 for ERC20;
                        using SafeMath for uint256;
                      
                        // This is a mapping of job IDs to the number of tokens allotted to the job
                        mapping(string => uint256) private jobBalances;
                        // This is the address of the render token contract
                        address public renderTokenAddress;
                        // This is the address with authority to call the disburseJob function
                        address public disbursalAddress;
                      
                        // Emit new disbursal address when disbursalAddress has been changed
                        event DisbursalAddressUpdate(address disbursalAddress);
                        // Emit the jobId along with the new balance of the job
                        // Used on job creation, additional funding added to jobs, and job disbursal
                        // Internal systems for assigning jobs will watch this event to determine balances available
                        event JobBalanceUpdate(string _jobId, uint256 _balance);
                        // Emit new contract address when renderTokenAddress has been changed
                        event RenderTokenAddressUpdate(address renderTokenAddress);
                      
                        /**
                         * @dev Modifier to check if the message sender can call the disburseJob function
                         */
                        modifier canDisburse() {
                          require(msg.sender == disbursalAddress, "message sender not authorized to disburse funds");
                          _;
                        }
                      
                        /**
                         * @dev Initailization
                         * @param _owner because this contract uses proxies, owner must be passed in as a param
                         * @param _renderTokenAddress see renderTokenAddress
                         */
                        function initialize (address _owner, address _renderTokenAddress) public isInitializer("Escrow", "0") {
                          require(_owner != address(0), "_owner must not be null");
                          require(_renderTokenAddress != address(0), "_renderTokenAddress must not be null");
                          Ownable.initialize(_owner);
                          disbursalAddress = _owner;
                          renderTokenAddress = _renderTokenAddress;
                        }
                      
                        /**
                         * @dev Change the address authorized to distribute tokens for completed jobs
                         *
                         * Because there are no on-chain details to indicate who performed a render, an outside
                         * system must call the disburseJob function with the information needed to properly
                         * distribute tokens. This function updates the address with the authority to perform distributions
                         * @param _newDisbursalAddress see disbursalAddress
                         */
                        function changeDisbursalAddress(address _newDisbursalAddress) external onlyOwner {
                          disbursalAddress = _newDisbursalAddress;
                      
                          emit DisbursalAddressUpdate(disbursalAddress);
                        }
                      
                        /**
                         * @dev Change the address allowances will be sent to after job completion
                         *
                         * Ideally, this will not be used, but is included as a failsafe.
                         * RNDR is still in its infancy, and changes may need to be made to this
                         * contract and / or the renderToken contract. Including methods to update the
                         * addresses allows the contracts to update independently.
                         * If the RNDR token contract is ever migrated to another address for
                         * either added security or functionality, this will need to be called.
                         * @param _newRenderTokenAddress see renderTokenAddress
                         */
                        function changeRenderTokenAddress(address _newRenderTokenAddress) external onlyOwner {
                          require(_newRenderTokenAddress != address(0), "_newRenderTokenAddress must not be null");
                          renderTokenAddress = _newRenderTokenAddress;
                      
                          emit RenderTokenAddressUpdate(renderTokenAddress);
                        }
                      
                        /**
                         * @dev Send allowances to node(s) that performed a job
                         *
                         * This can only be called by the disbursalAddress, an accound owned
                         * by OTOY, and it provides the number of tokens to send to each node
                         * @param _jobId the ID of the job used in the jobBalances mapping
                         * @param _recipients the address(es) of the nodes that performed rendering
                         * @param _amounts the amount(s) to send to each address. These must be in the same
                         * order as the recipient addresses
                         */
                        function disburseJob(string _jobId, address[] _recipients, uint256[] _amounts) external canDisburse {
                          require(jobBalances[_jobId] > 0, "_jobId has no available balance");
                          require(_recipients.length == _amounts.length, "_recipients and _amounts must be the same length");
                      
                          for(uint256 i = 0; i < _recipients.length; i++) {
                            jobBalances[_jobId] = jobBalances[_jobId].sub(_amounts[i]);
                            ERC20(renderTokenAddress).safeTransfer(_recipients[i], _amounts[i]);
                          }
                      
                          emit JobBalanceUpdate(_jobId, jobBalances[_jobId]);
                        }
                      
                        /**
                         * @dev Add RNDR tokens to a job
                         *
                         * This can only be called by a function on the RNDR token contract
                         * @param _jobId the ID of the job used in the jobBalances mapping
                         * @param _tokens the number of tokens sent by the artist to fund the job
                         */
                        function fundJob(string _jobId, uint256 _tokens) external {
                          // Jobs can only be created by the address stored in the renderTokenAddress variable
                          require(msg.sender == renderTokenAddress, "message sender not authorized");
                          jobBalances[_jobId] = jobBalances[_jobId].add(_tokens);
                      
                          emit JobBalanceUpdate(_jobId, jobBalances[_jobId]);
                        }
                      
                        /**
                         * @dev See the tokens available for a job
                         *
                         * @param _jobId the ID used to lookup the job balance
                         */
                        function jobBalance(string _jobId) external view returns(uint256) {
                          return jobBalances[_jobId];
                        }
                      
                      }
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/contracts/MigratableERC20.sol
                      
                      /**
                       * @title MigratableERC20
                       * @dev This strategy carries out an optional migration of the token balances. This migration is performed and paid for
                       * @dev by the token holders. The new token contract starts with no initial supply and no balances. The only way to
                       * @dev "mint" the new tokens is for users to "turn in" their old ones. This is done by first approving the amount they
                       * @dev want to migrate via `ERC20.approve(newTokenAddress, amountToMigrate)` and then calling a function of the new
                       * @dev token called `migrateTokens`. The old tokens are sent to a burn address, and the holder receives an equal amount
                       * @dev in the new contract.
                       */
                      contract MigratableERC20 is Migratable {
                        using SafeERC20 for ERC20;
                      
                        /// Burn address where the old tokens are going to be transferred
                        address public constant BURN_ADDRESS = address(0xdead);
                      
                        /// Address of the old token contract
                        ERC20 public legacyToken;
                      
                        /**
                         * @dev Initializes the new token contract
                         * @param _legacyToken address of the old token contract
                         */
                        function initialize(address _legacyToken) isInitializer("OptInERC20Migration", "1.9.0") public {
                          legacyToken = ERC20(_legacyToken);
                        }
                      
                        /**
                         * @dev Migrates the total balance of the token holder to this token contract
                         * @dev This function will burn the old token balance and mint the same balance in the new token contract
                         */
                        function migrate() public {
                          uint256 amount = legacyToken.balanceOf(msg.sender);
                          migrateToken(amount);
                        }
                      
                        /**
                         * @dev Migrates the given amount of old-token balance to the new token contract
                         * @dev This function will burn a given amount of tokens from the old contract and mint the same amount in the new one
                         * @param _amount uint256 representing the amount of tokens to be migrated
                         */
                        function migrateToken(uint256 _amount) public {
                          migrateTokenTo(msg.sender, _amount);
                        }
                      
                        /**
                         * @dev Burns a given amount of the old token contract for a token holder and mints the same amount of
                         * @dev new tokens for a given recipient address
                         * @param _amount uint256 representing the amount of tokens to be migrated
                         * @param _to address the recipient that will receive the new minted tokens
                         */
                        function migrateTokenTo(address _to, uint256 _amount) public {
                          _mintMigratedTokens(_to, _amount);
                          legacyToken.safeTransferFrom(msg.sender, BURN_ADDRESS, _amount);
                        }
                      
                        /**
                         * @dev Internal minting function
                         * This function must be overwritten by the implementation
                         */
                        function _mintMigratedTokens(address _to, uint256 _amount) internal;
                      }
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/node_modules/openzeppelin-zos/contracts/token/ERC20/BasicToken.sol
                      
                      /**
                       * @title Basic token
                       * @dev Basic version of StandardToken, with no allowances.
                       */
                      contract BasicToken is ERC20Basic {
                        using SafeMath for uint256;
                      
                        mapping(address => uint256) balances;
                      
                        uint256 totalSupply_;
                      
                        /**
                        * @dev total number of tokens in existence
                        */
                        function totalSupply() public view returns (uint256) {
                          return totalSupply_;
                        }
                      
                        /**
                        * @dev transfer token for a specified address
                        * @param _to The address to transfer to.
                        * @param _value The amount to be transferred.
                        */
                        function transfer(address _to, uint256 _value) public returns (bool) {
                          require(_to != address(0));
                          require(_value <= balances[msg.sender]);
                      
                          balances[msg.sender] = balances[msg.sender].sub(_value);
                          balances[_to] = balances[_to].add(_value);
                          emit Transfer(msg.sender, _to, _value);
                          return true;
                        }
                      
                        /**
                        * @dev Gets the balance of the specified address.
                        * @param _owner The address to query the the balance of.
                        * @return An uint256 representing the amount owned by the passed address.
                        */
                        function balanceOf(address _owner) public view returns (uint256) {
                          return balances[_owner];
                        }
                      
                      }
                      
                      // File: /Users/matthewmcclure/repos/Token-Audit/node_modules/openzeppelin-zos/contracts/token/ERC20/StandardToken.sol
                      
                      /**
                       * @title Standard ERC20 token
                       *
                       * @dev Implementation of the basic standard token.
                       * @dev https://github.com/ethereum/EIPs/issues/20
                       * @dev Based on code by FirstBlood: https://github.com/Firstbloodio/token/blob/master/smart_contract/FirstBloodToken.sol
                       */
                      contract StandardToken is ERC20, BasicToken {
                      
                        mapping (address => mapping (address => uint256)) internal allowed;
                      
                      
                        /**
                         * @dev Transfer tokens from one address to another
                         * @param _from address The address which you want to send tokens from
                         * @param _to address The address which you want to transfer to
                         * @param _value uint256 the amount of tokens to be transferred
                         */
                        function transferFrom(address _from, address _to, uint256 _value) public returns (bool) {
                          require(_to != address(0));
                          require(_value <= balances[_from]);
                          require(_value <= allowed[_from][msg.sender]);
                      
                          balances[_from] = balances[_from].sub(_value);
                          balances[_to] = balances[_to].add(_value);
                          allowed[_from][msg.sender] = allowed[_from][msg.sender].sub(_value);
                          emit Transfer(_from, _to, _value);
                          return true;
                        }
                      
                        /**
                         * @dev Approve the passed address to spend the specified amount of tokens on behalf of msg.sender.
                         *
                         * 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
                         * @param _spender The address which will spend the funds.
                         * @param _value The amount of tokens to be spent.
                         */
                        function approve(address _spender, uint256 _value) public returns (bool) {
                          allowed[msg.sender][_spender] = _value;
                          emit Approval(msg.sender, _spender, _value);
                          return true;
                        }
                      
                        /**
                         * @dev Function to check the amount of tokens that an owner allowed to a spender.
                         * @param _owner address The address which owns the funds.
                         * @param _spender address The address which will spend the funds.
                         * @return A uint256 specifying the amount of tokens still available for the spender.
                         */
                        function allowance(address _owner, address _spender) public view returns (uint256) {
                          return allowed[_owner][_spender];
                        }
                      
                        /**
                         * @dev Increase the amount of tokens that an owner allowed to a spender.
                         *
                         * approve should be called when allowed[_spender] == 0. To increment
                         * allowed value is better to use this function to avoid 2 calls (and wait until
                         * the first transaction is mined)
                         * From MonolithDAO Token.sol
                         * @param _spender The address which will spend the funds.
                         * @param _addedValue The amount of tokens to increase the allowance by.
                         */
                        function increaseApproval(address _spender, uint _addedValue) public returns (bool) {
                          allowed[msg.sender][_spender] = allowed[msg.sender][_spender].add(_addedValue);
                          emit Approval(msg.sender, _spender, allowed[msg.sender][_spender]);
                          return true;
                        }
                      
                        /**
                         * @dev Decrease the amount of tokens that an owner allowed to a spender.
                         *
                         * approve should be called when allowed[_spender] == 0. To decrement
                         * allowed value is better to use this function to avoid 2 calls (and wait until
                         * the first transaction is mined)
                         * From MonolithDAO Token.sol
                         * @param _spender The address which will spend the funds.
                         * @param _subtractedValue The amount of tokens to decrease the allowance by.
                         */
                        function decreaseApproval(address _spender, uint _subtractedValue) public returns (bool) {
                          uint oldValue = allowed[msg.sender][_spender];
                          if (_subtractedValue > oldValue) {
                            allowed[msg.sender][_spender] = 0;
                          } else {
                            allowed[msg.sender][_spender] = oldValue.sub(_subtractedValue);
                          }
                          emit Approval(msg.sender, _spender, allowed[msg.sender][_spender]);
                          return true;
                        }
                      
                      }
                      
                      // File: contracts/RenderToken.sol
                      
                      // Escrow constract
                      
                      
                      
                      
                      
                      
                      /**
                       * @title RenderToken
                       * @dev ERC20 mintable token
                       * The token will be minted by the crowdsale contract only
                       */
                      contract RenderToken is Migratable, MigratableERC20, Ownable, StandardToken {
                      
                        string public constant name = "Render Token";
                        string public constant symbol = "RNDR";
                        uint8 public constant decimals = 18;
                      
                        // The address of the contract that manages job balances. Address is used for forwarding tokens
                        // that come in to fund jobs
                        address public escrowContractAddress;
                      
                        // Emit new contract address when escrowContractAddress has been changed
                        event EscrowContractAddressUpdate(address escrowContractAddress);
                        // Emit information related to tokens being escrowed
                        event TokensEscrowed(address indexed sender, string jobId, uint256 amount);
                        // Emit information related to legacy tokens being migrated
                        event TokenMigration(address indexed receiver, uint256 amount);
                      
                        /**
                         * @dev Initailization
                         * @param _owner because this contract uses proxies, owner must be passed in as a param
                         */
                        function initialize(address _owner, address _legacyToken) public isInitializer("RenderToken", "0") {
                          require(_owner != address(0), "_owner must not be null");
                          require(_legacyToken != address(0), "_legacyToken must not be null");
                          Ownable.initialize(_owner);
                          MigratableERC20.initialize(_legacyToken);
                        }
                      
                        /**
                         * @dev Take tokens prior to beginning a job
                         *
                         * This function is called by the artist, and it will transfer tokens
                         * to a separate escrow contract to be held until the job is completed
                         * @param _jobID is the ID of the job used within the ORC backend
                         * @param _amount is the number of RNDR tokens being held in escrow
                         */
                        function holdInEscrow(string _jobID, uint256 _amount) public {
                          require(transfer(escrowContractAddress, _amount), "token transfer to escrow address failed");
                          Escrow(escrowContractAddress).fundJob(_jobID, _amount);
                      
                          emit TokensEscrowed(msg.sender, _jobID, _amount);
                        }
                      
                        /**
                         * @dev Mints new tokens equal to the amount of legacy tokens burned
                         *
                         * This function is called internally, but triggered by a user choosing to
                         * migrate their balance.
                         * @param _to is the address tokens will be sent to
                         * @param _amount is the number of RNDR tokens being sent to the address
                         */
                        function _mintMigratedTokens(address _to, uint256 _amount) internal {
                          require(_to != address(0), "_to address must not be null");
                          totalSupply_ = totalSupply_.add(_amount);
                          balances[_to] = balances[_to].add(_amount);
                      
                          emit TokenMigration(_to, _amount);
                          emit Transfer(address(0), _to, _amount);
                        }
                      
                        /**
                         * @dev Set the address of the escrow contract
                         *
                         * This will dictate the contract that will hold tokens in escrow and keep
                         * a ledger of funds available for jobs.
                         * RNDR is still in its infancy, and changes may need to be made to this
                         * contract and / or the escrow contract. Including methods to update the
                         * addresses allows the contracts to update independently.
                         * If the escrow contract is ever migrated to another address for
                         * either added security or functionality, this will need to be called.
                         * @param _escrowAddress see escrowContractAddress
                         */
                        function setEscrowContractAddress(address _escrowAddress) public onlyOwner {
                          require(_escrowAddress != address(0), "_escrowAddress must not be null");
                          escrowContractAddress = _escrowAddress;
                      
                          emit EscrowContractAddressUpdate(escrowContractAddress);
                        }
                      
                      }