ETH Price: $1,947.89 (+6.07%)
Gas: 1.52 Gwei

Transaction Decoder

Block:
22297977 at Apr-18-2025 07:29:11 PM +UTC
Transaction Fee:
0.000488005116641223 ETH $0.95
Gas Used:
344,167 Gas / 1.417931169 Gwei

Emitted Events:

14 WalletSimple.Deposited( from=Forwarder, value=36458300000000000, data=0x )
15 Forwarder.ForwarderDeposited( from=[Receiver] 0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43, value=36458300000000000, data=0x )

Account State Difference:

  Address   Before After State Difference Code
0x1246cD77...150726f0e 17.27066717983861153 Eth17.30712547983861153 Eth0.0364583
0x2342e088...877F4366d 0.050206906578114 Eth0.100409916578114 Eth0.05020301
0x35cA15F3...0f5F0fA67 0.742122212440822688 Eth0.748397762440822688 Eth0.00627555
0x4475E940...Bb152Ca7f 0.000024761218678688 Eth0.0000800975 Eth0.000055336281321312
0x4bC028DC...D73815D44 0.49477665 Eth0.5655094 Eth0.07073275
0x5e1c4D0A...969E471D3 0.000002562912723 Eth0.090867872912723 Eth0.09086531
0x723F6452...0bC9846F2 0.000000169926729 Eth0.053513989926729 Eth0.05351382
0x73F7b4Ac...B44Cb16B6 0.008497707115903795 Eth0.023056997115903795 Eth0.01455929
0x7830c87C...31FA86F43
(Coinbase: Deposit)
42.34517030197232326 Eth
Nonce: 2308223
42.344682296855682037 Eth
Nonce: 2308224
0.000488005116641223
0x7A648d3D...88adAD5c3 0.02929683 Eth0.03072639 Eth0.00142956
0x8B758F8D...dF154a67D 0.002842962839095196 Eth0.032521062839095196 Eth0.0296781
0x8de314e2...bD52F236a 0.00002551828046176 Eth0.0000800765 Eth0.00005455821953824
0x925b7b49...B51AeB9a3 0.000022810444201916 Eth0.0000800765 Eth0.000057266055798084
(beaverbuild)
6.21155593970359865 Eth6.21190010670359865 Eth0.000344167
0x9659713D...53FE8dAC8 31.35226547 Eth32.06348523 Eth0.71121976
0x98ffa0aB...B49dc5EDD 0.000148098617381889 Eth0.404496698617381889 Eth0.4043486
0xA9D1e08C...FB81d3E43
(Coinbase 10)
20,714.061163407647477772 Eth20,665.3203256156124734 Eth48.740837792035004372
0xB7A5330e...B31feb09a 0 Eth0.0129545 Eth0.0129545
0xBCcEcE0F...9C96cA956 0.000046742771653264 Eth0.0000800765 Eth0.000033333728346736
0xCBe52267...Dd978b68E 2.752623867165919 Eth8.646779457165919 Eth5.89415559
0xcCBFDeA0...75ff7771d 0.002655737597885669 Eth0.015078327597885669 Eth0.01242259
0xD787d010...923f87d9a 0.063494133197206 Eth0.094243393197206 Eth0.03074926
0xD88C4996...ea72d9580
0 Eth
Nonce: 0
0.00006466775 Eth
Nonce: 0
0.00006466775From: 0 To: 0
0xd998ad95...99B63e0d1 0.000183561830424 Eth0.007600461830424 Eth0.0074169
0xDe360410...e7bcdC27d 0.075908795524429489 Eth0.201272845524429489 Eth0.12536405
0xee88Ac75...27d097c23 0.000000008290086 Eth0.015908318290086 Eth0.01590831
0xF015A7ac...544f380c9 0.258312824619097949 Eth0.265215734619097949 Eth0.00690291
0xf1e9C0e8...5CD88b45e 0.030383260393613808 Eth41.180283960393613808 Eth41.1499007
0xf8cc094c...277D5A058 0.000027934229337 Eth0.015541704229337 Eth0.01551377

Execution Trace

Coinbase 10.1a1da075( )
  • ETH 0.00006466775 0xd88c49966fbcb9f6c6cb22c6a708a14ea72d9580.CALL( )
  • ETH 0.0129545 0xb7a5330e1f9a65256063c79571d7440b31feb09a.CALL( )
  • ETH 0.00005455821953824 0x8de314e285336e291a38b0ef14b28babd52f236a.CALL( )
  • ETH 0.000057266055798084 0x925b7b49e5e5d4990ae792042bc3e2fb51aeb9a3.CALL( )
  • ETH 0.000055336281321312 0x4475e940b301429bb59c4dc4bf8c218bb152ca7f.CALL( )
  • ETH 0.000033333728346736 0xbccece0f26d014da92aca7c83b3421e9c96ca956.CALL( )
  • ETH 0.0296781 0x8b758f8dc1561c7e18d0019540450cfdf154a67d.CALL( )
  • ETH 41.1499007 0xf1e9c0e82ef7bf1eaa79db15b190f625cd88b45e.CALL( )
  • ETH 0.07073275 0x4bc028dcef15bf49c5b7e48befda4bad73815d44.CALL( )
    • ETH 0.07073275 0x260ed59e7af355aacda4033e9a9ce87c3f052891.DELEGATECALL( )
    • ETH 0.0364583 Forwarder.CALL( )
      • ETH 0.0364583 Forwarder.DELEGATECALL( )
        • ETH 0.0364583 WalletSimple.CALL( )
          • ETH 0.0364583 WalletSimple.DELEGATECALL( )
          • ETH 0.01551377 0xf8cc094c87614029b1eb260164d2af1277d5a058.CALL( )
          • ETH 0.01590831 0xee88ac7592eefcbfc50a206b17ca49727d097c23.CALL( )
          • ETH 0.4043486 0x98ffa0ab5310dae46babff56932ac98b49dc5edd.CALL( )
          • ETH 0.05351382 0x723f6452167759f3eab82786029b9c20bc9846f2.CALL( )
          • ETH 0.05020301 0x2342e0881692b63c4833228ff8a2d14877f4366d.CALL( )
          • ETH 0.00690291 0xf015a7ac20a65cd6985a70114c39ee7544f380c9.CALL( )
          • ETH 0.00142956 0x7a648d3d6b0f9b24ef39499c0822da888adad5c3.CALL( )
          • ETH 0.01455929 0x73f7b4ac273f9f1604a6285706ee47eb44cb16b6.CALL( )
          • ETH 0.0074169 0xd998ad9582e85b191a9ffb8b0d3ad1399b63e0d1.CALL( )
          • ETH 0.12536405 0xde360410c79c159d1fbca4618c874a7e7bcdc27d.CALL( )
          • ETH 0.03074926 0xd787d01010ec393b3413345b88b7fdc923f87d9a.CALL( )
          • ETH 0.00627555 0x35ca15f3e6691ba7fb323080133a0160f5f0fa67.CALL( )
          • ETH 0.09086531 0x5e1c4d0a1df155ed6abc90bbb338614969e471d3.CALL( )
          • ETH 0.71121976 0x9659713d6fcd27c1d93c62732cd015853fe8dac8.CALL( )
          • ETH 5.89415559 0xcbe52267dddc6d3a8603f9ec37a19b0dd978b68e.CALL( )
          • ETH 0.01242259 0xccbfdea075b683a108c8163fbee81fb75ff7771d.CALL( )
            File 1 of 4: WalletSimple
            // SPDX-License-Identifier: Apache-2.0
            pragma solidity 0.8.10;
            import './TransferHelper.sol';
            import './ERC20Interface.sol';
            import './IForwarder.sol';
            /** ERC721, ERC1155 imports */
            import '@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol';
            import '@openzeppelin/contracts/token/ERC1155/utils/ERC1155Receiver.sol';
            /**
             *
             * WalletSimple
             * ============
             *
             * Basic multi-signer wallet designed for use in a co-signing environment where 2 signatures are required to move funds.
             * Typically used in a 2-of-3 signing configuration. Uses ecrecover to allow for 2 signatures in a single transaction.
             *
             * The first signature is created on the operation hash (see Data Formats) and passed to sendMultiSig/sendMultiSigToken
             * The signer is determined by verifyMultiSig().
             *
             * The second signature is created by the submitter of the transaction and determined by msg.signer.
             *
             * Data Formats
             * ============
             *
             * The signature is created with ethereumjs-util.ecsign(operationHash).
             * Like the eth_sign RPC call, it packs the values as a 65-byte array of [r, s, v].
             * Unlike eth_sign, the message is not prefixed.
             *
             * The operationHash the result of keccak256(prefix, toAddress, value, data, expireTime).
             * For ether transactions, `prefix` is "ETHER".
             * For token transaction, `prefix` is "ERC20" and `data` is the tokenContractAddress.
             *
             *
             */
            contract WalletSimple is IERC721Receiver, ERC1155Receiver {
              // Events
              event Deposited(address from, uint256 value, bytes data);
              event SafeModeActivated(address msgSender);
              event Transacted(
                address msgSender, // Address of the sender of the message initiating the transaction
                address otherSigner, // Address of the signer (second signature) used to initiate the transaction
                bytes32 operation, // Operation hash (see Data Formats)
                address toAddress, // The address the transaction was sent to
                uint256 value, // Amount of Wei sent to the address
                bytes data // Data sent when invoking the transaction
              );
              event BatchTransfer(address sender, address recipient, uint256 value);
              // this event shows the other signer and the operation hash that they signed
              // specific batch transfer events are emitted in Batcher
              event BatchTransacted(
                address msgSender, // Address of the sender of the message initiating the transaction
                address otherSigner, // Address of the signer (second signature) used to initiate the transaction
                bytes32 operation // Operation hash (see Data Formats)
              );
              // Public fields
              mapping(address => bool) public signers; // The addresses that can co-sign transactions on the wallet
              bool public safeMode = false; // When active, wallet may only send to signer addresses
              bool public initialized = false; // True if the contract has been initialized
              // Internal fields
              uint256 private constant MAX_SEQUENCE_ID_INCREASE = 10000;
              uint256 constant SEQUENCE_ID_WINDOW_SIZE = 10;
              uint256[SEQUENCE_ID_WINDOW_SIZE] recentSequenceIds;
              /**
               * Set up a simple multi-sig wallet by specifying the signers allowed to be used on this wallet.
               * 2 signers will be required to send a transaction from this wallet.
               * Note: The sender is NOT automatically added to the list of signers.
               * Signers CANNOT be changed once they are set
               *
               * @param allowedSigners An array of signers on the wallet
               */
              function init(address[] calldata allowedSigners) external onlyUninitialized {
                require(allowedSigners.length == 3, 'Invalid number of signers');
                for (uint8 i = 0; i < allowedSigners.length; i++) {
                  require(allowedSigners[i] != address(0), 'Invalid signer');
                  signers[allowedSigners[i]] = true;
                }
                initialized = true;
              }
              /**
               * Get the network identifier that signers must sign over
               * This provides protection signatures being replayed on other chains
               * This must be a virtual function because chain-specific contracts will need
               *    to override with their own network ids. It also can't be a field
               *    to allow this contract to be used by proxy with delegatecall, which will
               *    not pick up on state variables
               */
              function getNetworkId() internal virtual pure returns (string memory) {
                return 'ETHER';
              }
              /**
               * Get the network identifier that signers must sign over for token transfers
               * This provides protection signatures being replayed on other chains
               * This must be a virtual function because chain-specific contracts will need
               *    to override with their own network ids. It also can't be a field
               *    to allow this contract to be used by proxy with delegatecall, which will
               *    not pick up on state variables
               */
              function getTokenNetworkId() internal virtual pure returns (string memory) {
                return 'ERC20';
              }
              /**
               * Get the network identifier that signers must sign over for batch transfers
               * This provides protection signatures being replayed on other chains
               * This must be a virtual function because chain-specific contracts will need
               *    to override with their own network ids. It also can't be a field
               *    to allow this contract to be used by proxy with delegatecall, which will
               *    not pick up on state variables
               */
              function getBatchNetworkId() internal virtual pure returns (string memory) {
                return 'ETHER-Batch';
              }
              /**
               * Determine if an address is a signer on this wallet
               * @param signer address to check
               * returns boolean indicating whether address is signer or not
               */
              function isSigner(address signer) public view returns (bool) {
                return signers[signer];
              }
              /**
               * Modifier that will execute internal code block only if the sender is an authorized signer on this wallet
               */
              modifier onlySigner {
                require(isSigner(msg.sender), 'Non-signer in onlySigner method');
                _;
              }
              /**
               * Modifier that will execute internal code block only if the contract has not been initialized yet
               */
              modifier onlyUninitialized {
                require(!initialized, 'Contract already initialized');
                _;
              }
              /**
               * Gets called when a transaction is received with data that does not match any other method
               */
              fallback() external payable {
                if (msg.value > 0) {
                  // Fire deposited event if we are receiving funds
                  emit Deposited(msg.sender, msg.value, msg.data);
                }
              }
              /**
               * Gets called when a transaction is received with ether and no data
               */
              receive() external payable {
                if (msg.value > 0) {
                  // Fire deposited event if we are receiving funds
                  // message data is always empty for receive. If there is data it is sent to fallback function.
                  emit Deposited(msg.sender, msg.value, '');
                }
              }
              /**
               * Execute a multi-signature transaction from this wallet using 2 signers: one from msg.sender and the other from ecrecover.
               * Sequence IDs are numbers starting from 1. They are used to prevent replay attacks and may not be repeated.
               *
               * @param toAddress the destination address to send an outgoing transaction
               * @param value the amount in Wei to be sent
               * @param data the data to send to the toAddress when invoking the transaction
               * @param expireTime the number of seconds since 1970 for which this transaction is valid
               * @param sequenceId the unique sequence id obtainable from getNextSequenceId
               * @param signature see Data Formats
               */
              function sendMultiSig(
                address toAddress,
                uint256 value,
                bytes calldata data,
                uint256 expireTime,
                uint256 sequenceId,
                bytes calldata signature
              ) external onlySigner {
                // Verify the other signer
                bytes32 operationHash = keccak256(
                  abi.encodePacked(
                    getNetworkId(),
                    toAddress,
                    value,
                    data,
                    expireTime,
                    sequenceId
                  )
                );
                address otherSigner = verifyMultiSig(
                  toAddress,
                  operationHash,
                  signature,
                  expireTime,
                  sequenceId
                );
                // Success, send the transaction
                (bool success, ) = toAddress.call{ value: value }(data);
                require(success, 'Call execution failed');
                emit Transacted(
                  msg.sender,
                  otherSigner,
                  operationHash,
                  toAddress,
                  value,
                  data
                );
              }
              /**
               * Execute a batched multi-signature transaction from this wallet using 2 signers: one from msg.sender and the other from ecrecover.
               * Sequence IDs are numbers starting from 1. They are used to prevent replay attacks and may not be repeated.
               * The recipients and values to send are encoded in two arrays, where for index i, recipients[i] will be sent values[i].
               *
               * @param recipients The list of recipients to send to
               * @param values The list of values to send to
               * @param expireTime the number of seconds since 1970 for which this transaction is valid
               * @param sequenceId the unique sequence id obtainable from getNextSequenceId
               * @param signature see Data Formats
               */
              function sendMultiSigBatch(
                address[] calldata recipients,
                uint256[] calldata values,
                uint256 expireTime,
                uint256 sequenceId,
                bytes calldata signature
              ) external onlySigner {
                require(recipients.length != 0, 'Not enough recipients');
                require(
                  recipients.length == values.length,
                  'Unequal recipients and values'
                );
                require(recipients.length < 256, 'Too many recipients, max 255');
                // Verify the other signer
                bytes32 operationHash = keccak256(
                  abi.encodePacked(
                    getBatchNetworkId(),
                    recipients,
                    values,
                    expireTime,
                    sequenceId
                  )
                );
                // the first parameter (toAddress) is used to ensure transactions in safe mode only go to a signer
                // if in safe mode, we should use normal sendMultiSig to recover, so this check will always fail if in safe mode
                require(!safeMode, 'Batch in safe mode');
                address otherSigner = verifyMultiSig(
                  address(0x0),
                  operationHash,
                  signature,
                  expireTime,
                  sequenceId
                );
                batchTransfer(recipients, values);
                emit BatchTransacted(msg.sender, otherSigner, operationHash);
              }
              /**
               * Transfer funds in a batch to each of recipients
               * @param recipients The list of recipients to send to
               * @param values The list of values to send to recipients.
               *  The recipient with index i in recipients array will be sent values[i].
               *  Thus, recipients and values must be the same length
               */
              function batchTransfer(
                address[] calldata recipients,
                uint256[] calldata values
              ) internal {
                for (uint256 i = 0; i < recipients.length; i++) {
                  require(address(this).balance >= values[i], 'Insufficient funds');
                  (bool success, ) = recipients[i].call{ value: values[i] }('');
                  require(success, 'Call failed');
                  emit BatchTransfer(msg.sender, recipients[i], values[i]);
                }
              }
              /**
               * Execute a multi-signature token transfer from this wallet using 2 signers: one from msg.sender and the other from ecrecover.
               * Sequence IDs are numbers starting from 1. They are used to prevent replay attacks and may not be repeated.
               *
               * @param toAddress the destination address to send an outgoing transaction
               * @param value the amount in tokens to be sent
               * @param tokenContractAddress the address of the erc20 token contract
               * @param expireTime the number of seconds since 1970 for which this transaction is valid
               * @param sequenceId the unique sequence id obtainable from getNextSequenceId
               * @param signature see Data Formats
               */
              function sendMultiSigToken(
                address toAddress,
                uint256 value,
                address tokenContractAddress,
                uint256 expireTime,
                uint256 sequenceId,
                bytes calldata signature
              ) external onlySigner {
                // Verify the other signer
                bytes32 operationHash = keccak256(
                  abi.encodePacked(
                    getTokenNetworkId(),
                    toAddress,
                    value,
                    tokenContractAddress,
                    expireTime,
                    sequenceId
                  )
                );
                verifyMultiSig(toAddress, operationHash, signature, expireTime, sequenceId);
                TransferHelper.safeTransfer(tokenContractAddress, toAddress, value);
              }
              /**
               * Execute a token flush from one of the forwarder addresses. This transfer needs only a single signature and can be done by any signer
               *
               * @param forwarderAddress the address of the forwarder address to flush the tokens from
               * @param tokenContractAddress the address of the erc20 token contract
               */
              function flushForwarderTokens(
                address payable forwarderAddress,
                address tokenContractAddress
              ) external onlySigner {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.flushTokens(tokenContractAddress);
              }
              /**
               * Execute a ERC721 token flush from one of the forwarder addresses. This transfer needs only a single signature and can be done by any signer
               *
               * @param forwarderAddress the address of the forwarder address to flush the tokens from
               * @param tokenContractAddress the address of the erc20 token contract
               */
              function flushERC721ForwarderTokens(
                address payable forwarderAddress,
                address tokenContractAddress,
                uint256 tokenId
              ) external onlySigner {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.flushERC721Token(tokenContractAddress, tokenId);
              }
              /**
               * Execute a ERC1155 batch token flush from one of the forwarder addresses.
               * This transfer needs only a single signature and can be done by any signer.
               *
               * @param forwarderAddress the address of the forwarder address to flush the tokens from
               * @param tokenContractAddress the address of the erc1155 token contract
               */
              function batchFlushERC1155ForwarderTokens(
                address payable forwarderAddress,
                address tokenContractAddress,
                uint256[] calldata tokenIds
              ) external onlySigner {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.batchFlushERC1155Tokens(tokenContractAddress, tokenIds);
              }
              /**
               * Execute a ERC1155 token flush from one of the forwarder addresses.
               * This transfer needs only a single signature and can be done by any signer.
               *
               * @param forwarderAddress the address of the forwarder address to flush the tokens from
               * @param tokenContractAddress the address of the erc1155 token contract
               * @param tokenId the token id associated with the ERC1155
               */
              function flushERC1155ForwarderTokens(
                address payable forwarderAddress,
                address tokenContractAddress,
                uint256 tokenId
              ) external onlySigner {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.flushERC1155Tokens(tokenContractAddress, tokenId);
              }
              /**
               * Sets the autoflush 721 parameter on the forwarder.
               *
               * @param forwarderAddress the address of the forwarder to toggle.
               * @param autoFlush whether to autoflush erc721 tokens
               */
              function setAutoFlush721(address forwarderAddress, bool autoFlush)
                external
                onlySigner
              {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.setAutoFlush721(autoFlush);
              }
              /**
               * Sets the autoflush 721 parameter on the forwarder.
               *
               * @param forwarderAddress the address of the forwarder to toggle.
               * @param autoFlush whether to autoflush erc1155 tokens
               */
              function setAutoFlush1155(address forwarderAddress, bool autoFlush)
                external
                onlySigner
              {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.setAutoFlush1155(autoFlush);
              }
              /**
               * Do common multisig verification for both eth sends and erc20token transfers
               *
               * @param toAddress the destination address to send an outgoing transaction
               * @param operationHash see Data Formats
               * @param signature see Data Formats
               * @param expireTime the number of seconds since 1970 for which this transaction is valid
               * @param sequenceId the unique sequence id obtainable from getNextSequenceId
               * returns address that has created the signature
               */
              function verifyMultiSig(
                address toAddress,
                bytes32 operationHash,
                bytes calldata signature,
                uint256 expireTime,
                uint256 sequenceId
              ) private returns (address) {
                address otherSigner = recoverAddressFromSignature(operationHash, signature);
                // Verify if we are in safe mode. In safe mode, the wallet can only send to signers
                require(!safeMode || isSigner(toAddress), 'External transfer in safe mode');
                // Verify that the transaction has not expired
                require(expireTime >= block.timestamp, 'Transaction expired');
                // Try to insert the sequence ID. Will revert if the sequence id was invalid
                tryInsertSequenceId(sequenceId);
                require(isSigner(otherSigner), 'Invalid signer');
                require(otherSigner != msg.sender, 'Signers cannot be equal');
                return otherSigner;
              }
              /**
               * ERC721 standard callback function for when a ERC721 is transfered.
               *
               * @param _operator The address of the nft contract
               * @param _from The address of the sender
               * @param _tokenId The token id of the nft
               * @param _data Additional data with no specified format, sent in call to `_to`
               */
              function onERC721Received(
                address _operator,
                address _from,
                uint256 _tokenId,
                bytes memory _data
              ) external virtual override returns (bytes4) {
                return this.onERC721Received.selector;
              }
              /**
               * @inheritdoc IERC1155Receiver
               */
              function onERC1155Received(
                address _operator,
                address _from,
                uint256 id,
                uint256 value,
                bytes calldata data
              ) external virtual override returns (bytes4) {
                return this.onERC1155Received.selector;
              }
              /**
               * @inheritdoc IERC1155Receiver
               */
              function onERC1155BatchReceived(
                address _operator,
                address _from,
                uint256[] calldata ids,
                uint256[] calldata values,
                bytes calldata data
              ) external virtual override returns (bytes4) {
                return this.onERC1155BatchReceived.selector;
              }
              /**
               * Irrevocably puts contract into safe mode. When in this mode, transactions may only be sent to signing addresses.
               */
              function activateSafeMode() external onlySigner {
                safeMode = true;
                emit SafeModeActivated(msg.sender);
              }
              /**
               * Gets signer's address using ecrecover
               * @param operationHash see Data Formats
               * @param signature see Data Formats
               * returns address recovered from the signature
               */
              function recoverAddressFromSignature(
                bytes32 operationHash,
                bytes memory signature
              ) private pure returns (address) {
                require(signature.length == 65, 'Invalid signature - wrong length');
                // We need to unpack the signature, which is given as an array of 65 bytes (like eth.sign)
                bytes32 r;
                bytes32 s;
                uint8 v;
                // solhint-disable-next-line
                assembly {
                  r := mload(add(signature, 32))
                  s := mload(add(signature, 64))
                  v := and(mload(add(signature, 65)), 255)
                }
                if (v < 27) {
                  v += 27; // Ethereum versions are 27 or 28 as opposed to 0 or 1 which is submitted by some signing libs
                }
                // protect against signature malleability
                // S value must be in the lower half orader
                // reference: https://github.com/OpenZeppelin/openzeppelin-contracts/blob/051d340171a93a3d401aaaea46b4b62fa81e5d7c/contracts/cryptography/ECDSA.sol#L53
                require(
                  uint256(s) <=
                    0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0,
                  "ECDSA: invalid signature 's' value"
                );
                // note that this returns 0 if the signature is invalid
                // Since 0x0 can never be a signer, when the recovered signer address
                // is checked against our signer list, that 0x0 will cause an invalid signer failure
                return ecrecover(operationHash, v, r, s);
              }
              /**
               * Verify that the sequence id has not been used before and inserts it. Throws if the sequence ID was not accepted.
               * We collect a window of up to 10 recent sequence ids, and allow any sequence id that is not in the window and
               * greater than the minimum element in the window.
               * @param sequenceId to insert into array of stored ids
               */
              function tryInsertSequenceId(uint256 sequenceId) private onlySigner {
                // Keep a pointer to the lowest value element in the window
                uint256 lowestValueIndex = 0;
                // fetch recentSequenceIds into memory for function context to avoid unnecessary sloads
                  uint256[SEQUENCE_ID_WINDOW_SIZE] memory _recentSequenceIds
                 = recentSequenceIds;
                for (uint256 i = 0; i < SEQUENCE_ID_WINDOW_SIZE; i++) {
                  require(_recentSequenceIds[i] != sequenceId, 'Sequence ID already used');
                  if (_recentSequenceIds[i] < _recentSequenceIds[lowestValueIndex]) {
                    lowestValueIndex = i;
                  }
                }
                // The sequence ID being used is lower than the lowest value in the window
                // so we cannot accept it as it may have been used before
                require(
                  sequenceId > _recentSequenceIds[lowestValueIndex],
                  'Sequence ID below window'
                );
                // Block sequence IDs which are much higher than the lowest value
                // This prevents people blocking the contract by using very large sequence IDs quickly
                require(
                  sequenceId <=
                    (_recentSequenceIds[lowestValueIndex] + MAX_SEQUENCE_ID_INCREASE),
                  'Sequence ID above maximum'
                );
                recentSequenceIds[lowestValueIndex] = sequenceId;
              }
              /**
               * Gets the next available sequence ID for signing when using executeAndConfirm
               * returns the sequenceId one higher than the highest currently stored
               */
              function getNextSequenceId() external view returns (uint256) {
                uint256 highestSequenceId = 0;
                for (uint256 i = 0; i < SEQUENCE_ID_WINDOW_SIZE; i++) {
                  if (recentSequenceIds[i] > highestSequenceId) {
                    highestSequenceId = recentSequenceIds[i];
                  }
                }
                return highestSequenceId + 1;
              }
            }
            // SPDX-License-Identifier: GPL-3.0-or-later
            // source: https://github.com/Uniswap/solidity-lib/blob/master/contracts/libraries/TransferHelper.sol
            pragma solidity 0.8.10;
            import '@openzeppelin/contracts/utils/Address.sol';
            // helper methods for interacting with ERC20 tokens and sending ETH that do not consistently return true/false
            library TransferHelper {
              function safeTransfer(
                address token,
                address to,
                uint256 value
              ) internal {
                // bytes4(keccak256(bytes('transfer(address,uint256)')));
                (bool success, bytes memory data) = token.call(
                  abi.encodeWithSelector(0xa9059cbb, to, value)
                );
                require(
                  success && (data.length == 0 || abi.decode(data, (bool))),
                  'TransferHelper::safeTransfer: transfer failed'
                );
              }
              function safeTransferFrom(
                address token,
                address from,
                address to,
                uint256 value
              ) internal {
                // bytes4(keccak256(bytes('transferFrom(address,address,uint256)')));
                (bool success, bytes memory returndata) = token.call(
                  abi.encodeWithSelector(0x23b872dd, from, to, value)
                );
                Address.verifyCallResult(
                  success,
                  returndata,
                  'TransferHelper::transferFrom: transferFrom failed'
                );
              }
            }
            // SPDX-License-Identifier: UNLICENSED
            pragma solidity 0.8.10;
            /**
             * Contract that exposes the needed erc20 token functions
             */
            abstract contract ERC20Interface {
              // Send _value amount of tokens to address _to
              function transfer(address _to, uint256 _value)
                public
                virtual
                returns (bool success);
              // Get the account balance of another account with address _owner
              function balanceOf(address _owner)
                public
                virtual
                view
                returns (uint256 balance);
            }
            pragma solidity ^0.8.0;
            import '@openzeppelin/contracts/utils/introspection/IERC165.sol';
            interface IForwarder is IERC165 {
              /**
               * Sets the autoflush721 parameter.
               *
               * @param autoFlush whether to autoflush erc721 tokens
               */
              function setAutoFlush721(bool autoFlush) external;
              /**
               * Sets the autoflush1155 parameter.
               *
               * @param autoFlush whether to autoflush erc1155 tokens
               */
              function setAutoFlush1155(bool autoFlush) external;
              /**
               * Execute a token transfer of the full balance from the forwarder token to the parent address
               *
               * @param tokenContractAddress the address of the erc20 token contract
               */
              function flushTokens(address tokenContractAddress) external;
              /**
               * Execute a nft transfer from the forwarder to the parent address
               *
               * @param tokenContractAddress the address of the ERC721 NFT contract
               * @param tokenId The token id of the nft
               */
              function flushERC721Token(address tokenContractAddress, uint256 tokenId)
                external;
              /**
               * Execute a nft transfer from the forwarder to the parent address.
               *
               * @param tokenContractAddress the address of the ERC1155 NFT contract
               * @param tokenId The token id of the nft
               */
              function flushERC1155Tokens(address tokenContractAddress, uint256 tokenId)
                external;
              /**
               * Execute a batch nft transfer from the forwarder to the parent address.
               *
               * @param tokenContractAddress the address of the ERC1155 NFT contract
               * @param tokenIds The token ids of the nfts
               */
              function batchFlushERC1155Tokens(
                address tokenContractAddress,
                uint256[] calldata tokenIds
              ) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721Receiver.sol)
            pragma solidity ^0.8.0;
            /**
             * @title ERC721 token receiver interface
             * @dev Interface for any contract that wants to support safeTransfers
             * from ERC721 asset contracts.
             */
            interface IERC721Receiver {
                /**
                 * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
                 * by `operator` from `from`, this function is called.
                 *
                 * It must return its Solidity selector to confirm the token transfer.
                 * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
                 *
                 * The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.
                 */
                function onERC721Received(
                    address operator,
                    address from,
                    uint256 tokenId,
                    bytes calldata data
                ) external returns (bytes4);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/utils/ERC1155Receiver.sol)
            pragma solidity ^0.8.0;
            import "../IERC1155Receiver.sol";
            import "../../../utils/introspection/ERC165.sol";
            /**
             * @dev _Available since v3.1._
             */
            abstract contract ERC1155Receiver is ERC165, IERC1155Receiver {
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
                    return interfaceId == type(IERC1155Receiver).interfaceId || super.supportsInterface(interfaceId);
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/Address.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Collection of functions related to the address type
             */
            library Address {
                /**
                 * @dev Returns true if `account` is a contract.
                 *
                 * [IMPORTANT]
                 * ====
                 * It is unsafe to assume that an address for which this function returns
                 * false is an externally-owned account (EOA) and not a contract.
                 *
                 * Among others, `isContract` will return false for the following
                 * types of addresses:
                 *
                 *  - an externally-owned account
                 *  - a contract in construction
                 *  - an address where a contract will be created
                 *  - an address where a contract lived, but was destroyed
                 * ====
                 */
                function isContract(address account) internal view returns (bool) {
                    // This method relies on extcodesize, which returns 0 for contracts in
                    // construction, since the code is only stored at the end of the
                    // constructor execution.
                    uint256 size;
                    assembly {
                        size := extcodesize(account)
                    }
                    return size > 0;
                }
                /**
                 * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                 * `recipient`, forwarding all available gas and reverting on errors.
                 *
                 * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                 * of certain opcodes, possibly making contracts go over the 2300 gas limit
                 * imposed by `transfer`, making them unable to receive funds via
                 * `transfer`. {sendValue} removes this limitation.
                 *
                 * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                 *
                 * IMPORTANT: because control is transferred to `recipient`, care must be
                 * taken to not create reentrancy vulnerabilities. Consider using
                 * {ReentrancyGuard} or the
                 * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                 */
                function sendValue(address payable recipient, uint256 amount) internal {
                    require(address(this).balance >= amount, "Address: insufficient balance");
                    (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
                            assembly {
                                let returndata_size := mload(returndata)
                                revert(add(32, returndata), returndata_size)
                            }
                        } else {
                            revert(errorMessage);
                        }
                    }
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Interface of the ERC165 standard, as defined in the
             * https://eips.ethereum.org/EIPS/eip-165[EIP].
             *
             * Implementers can declare support of contract interfaces, which can then be
             * queried by others ({ERC165Checker}).
             *
             * For an implementation, see {ERC165}.
             */
            interface IERC165 {
                /**
                 * @dev Returns true if this contract implements the interface defined by
                 * `interfaceId`. See the corresponding
                 * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
                 * to learn more about how these ids are created.
                 *
                 * This function call must use less than 30 000 gas.
                 */
                function supportsInterface(bytes4 interfaceId) external view returns (bool);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/IERC1155Receiver.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev _Available since v3.1._
             */
            interface IERC1155Receiver is IERC165 {
                /**
                    @dev Handles the receipt of a single ERC1155 token type. This function is
                    called at the end of a `safeTransferFrom` after the balance has been updated.
                    To accept the transfer, this must return
                    `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
                    (i.e. 0xf23a6e61, or its own function selector).
                    @param operator The address which initiated the transfer (i.e. msg.sender)
                    @param from The address which previously owned the token
                    @param id The ID of the token being transferred
                    @param value The amount of tokens being transferred
                    @param data Additional data with no specified format
                    @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
                */
                function onERC1155Received(
                    address operator,
                    address from,
                    uint256 id,
                    uint256 value,
                    bytes calldata data
                ) external returns (bytes4);
                /**
                    @dev Handles the receipt of a multiple ERC1155 token types. This function
                    is called at the end of a `safeBatchTransferFrom` after the balances have
                    been updated. To accept the transfer(s), this must return
                    `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
                    (i.e. 0xbc197c81, or its own function selector).
                    @param operator The address which initiated the batch transfer (i.e. msg.sender)
                    @param from The address which previously owned the token
                    @param ids An array containing ids of each token being transferred (order and length must match values array)
                    @param values An array containing amounts of each token being transferred (order and length must match ids array)
                    @param data Additional data with no specified format
                    @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
                */
                function onERC1155BatchReceived(
                    address operator,
                    address from,
                    uint256[] calldata ids,
                    uint256[] calldata values,
                    bytes calldata data
                ) external returns (bytes4);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
            pragma solidity ^0.8.0;
            import "./IERC165.sol";
            /**
             * @dev Implementation of the {IERC165} interface.
             *
             * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
             * for the additional interface id that will be supported. For example:
             *
             * ```solidity
             * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
             *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
             * }
             * ```
             *
             * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
             */
            abstract contract ERC165 is IERC165 {
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                    return interfaceId == type(IERC165).interfaceId;
                }
            }
            

            File 2 of 4: Forwarder
            // SPDX-License-Identifier: Apache-2.0
            pragma solidity 0.8.10;
            import '@openzeppelin/contracts/token/ERC1155/IERC1155.sol';
            import '@openzeppelin/contracts/token/ERC721/IERC721.sol';
            import '@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol';
            import '@openzeppelin/contracts/token/ERC1155/utils/ERC1155Receiver.sol';
            import './ERC20Interface.sol';
            import './TransferHelper.sol';
            import './IForwarder.sol';
            /**
             * Contract that will forward any incoming Ether to the creator of the contract
             *
             */
            contract Forwarder is IERC721Receiver, ERC1155Receiver, IForwarder {
              // Address to which any funds sent to this contract will be forwarded
              address public parentAddress;
              bool public autoFlush721 = true;
              bool public autoFlush1155 = true;
              event ForwarderDeposited(address from, uint256 value, bytes data);
              /**
               * Initialize the contract, and sets the destination address to that of the creator
               */
              function init(
                address _parentAddress,
                bool _autoFlush721,
                bool _autoFlush1155
              ) external onlyUninitialized {
                parentAddress = _parentAddress;
                uint256 value = address(this).balance;
                // set whether we want to automatically flush erc721/erc1155 tokens or not
                autoFlush721 = _autoFlush721;
                autoFlush1155 = _autoFlush1155;
                if (value == 0) {
                  return;
                }
                (bool success, ) = parentAddress.call{ value: value }('');
                require(success, 'Flush failed');
                // NOTE: since we are forwarding on initialization,
                // we don't have the context of the original sender.
                // We still emit an event about the forwarding but set
                // the sender to the forwarder itself
                emit ForwarderDeposited(address(this), value, msg.data);
              }
              /**
               * Modifier that will execute internal code block only if the sender is the parent address
               */
              modifier onlyParent {
                require(msg.sender == parentAddress, 'Only Parent');
                _;
              }
              /**
               * Modifier that will execute internal code block only if the contract has not been initialized yet
               */
              modifier onlyUninitialized {
                require(parentAddress == address(0x0), 'Already initialized');
                _;
              }
              /**
               * Default function; Gets called when data is sent but does not match any other function
               */
              fallback() external payable {
                flush();
              }
              /**
               * Default function; Gets called when Ether is deposited with no data, and forwards it to the parent address
               */
              receive() external payable {
                flush();
              }
              /**
               * @inheritdoc IForwarder
               */
              function setAutoFlush721(bool autoFlush)
                external
                virtual
                override
                onlyParent
              {
                autoFlush721 = autoFlush;
              }
              /**
               * @inheritdoc IForwarder
               */
              function setAutoFlush1155(bool autoFlush)
                external
                virtual
                override
                onlyParent
              {
                autoFlush1155 = autoFlush;
              }
              /**
               * ERC721 standard callback function for when a ERC721 is transfered. The forwarder will send the nft
               * to the base wallet once the nft contract invokes this method after transfering the nft.
               *
               * @param _operator The address which called `safeTransferFrom` function
               * @param _from The address of the sender
               * @param _tokenId The token id of the nft
               * @param data Additional data with no specified format, sent in call to `_to`
               */
              function onERC721Received(
                address _operator,
                address _from,
                uint256 _tokenId,
                bytes memory data
              ) external virtual override returns (bytes4) {
                if (autoFlush721) {
                  IERC721 instance = IERC721(msg.sender);
                  require(
                    instance.supportsInterface(type(IERC721).interfaceId),
                    'The caller does not support the ERC721 interface'
                  );
                  // this won't work for ERC721 re-entrancy
                  instance.safeTransferFrom(address(this), parentAddress, _tokenId, data);
                }
                return this.onERC721Received.selector;
              }
              function callFromParent(
                address target,
                uint256 value,
                bytes calldata data
              ) external onlyParent returns (bytes memory) {
                (bool success, bytes memory returnedData) = target.call{ value: value }(
                  data
                );
                require(success, 'Parent call execution failed');
                return returnedData;
              }
              /**
               * @inheritdoc IERC1155Receiver
               */
              function onERC1155Received(
                address _operator,
                address _from,
                uint256 id,
                uint256 value,
                bytes calldata data
              ) external virtual override returns (bytes4) {
                IERC1155 instance = IERC1155(msg.sender);
                require(
                  instance.supportsInterface(type(IERC1155).interfaceId),
                  'The caller does not support the IERC1155 interface'
                );
                if (autoFlush1155) {
                  instance.safeTransferFrom(address(this), parentAddress, id, value, data);
                }
                return this.onERC1155Received.selector;
              }
              /**
               * @inheritdoc IERC1155Receiver
               */
              function onERC1155BatchReceived(
                address _operator,
                address _from,
                uint256[] calldata ids,
                uint256[] calldata values,
                bytes calldata data
              ) external virtual override returns (bytes4) {
                IERC1155 instance = IERC1155(msg.sender);
                require(
                  instance.supportsInterface(type(IERC1155).interfaceId),
                  'The caller does not support the IERC1155 interface'
                );
                if (autoFlush1155) {
                  instance.safeBatchTransferFrom(
                    address(this),
                    parentAddress,
                    ids,
                    values,
                    data
                  );
                }
                return this.onERC1155BatchReceived.selector;
              }
              /**
               * @inheritdoc IForwarder
               */
              function flushTokens(address tokenContractAddress)
                external
                virtual
                override
                onlyParent
              {
                ERC20Interface instance = ERC20Interface(tokenContractAddress);
                address forwarderAddress = address(this);
                uint256 forwarderBalance = instance.balanceOf(forwarderAddress);
                if (forwarderBalance == 0) {
                  return;
                }
                TransferHelper.safeTransfer(
                  tokenContractAddress,
                  parentAddress,
                  forwarderBalance
                );
              }
              /**
               * @inheritdoc IForwarder
               */
              function flushERC721Token(address tokenContractAddress, uint256 tokenId)
                external
                virtual
                override
                onlyParent
              {
                IERC721 instance = IERC721(tokenContractAddress);
                require(
                  instance.supportsInterface(type(IERC721).interfaceId),
                  'The tokenContractAddress does not support the ERC721 interface'
                );
                address ownerAddress = instance.ownerOf(tokenId);
                instance.transferFrom(ownerAddress, parentAddress, tokenId);
              }
              /**
               * @inheritdoc IForwarder
               */
              function flushERC1155Tokens(address tokenContractAddress, uint256 tokenId)
                external
                virtual
                override
                onlyParent
              {
                IERC1155 instance = IERC1155(tokenContractAddress);
                require(
                  instance.supportsInterface(type(IERC1155).interfaceId),
                  'The caller does not support the IERC1155 interface'
                );
                address forwarderAddress = address(this);
                uint256 forwarderBalance = instance.balanceOf(forwarderAddress, tokenId);
                instance.safeTransferFrom(
                  forwarderAddress,
                  parentAddress,
                  tokenId,
                  forwarderBalance,
                  ''
                );
              }
              /**
               * @inheritdoc IForwarder
               */
              function batchFlushERC1155Tokens(
                address tokenContractAddress,
                uint256[] calldata tokenIds
              ) external virtual override onlyParent {
                IERC1155 instance = IERC1155(tokenContractAddress);
                require(
                  instance.supportsInterface(type(IERC1155).interfaceId),
                  'The caller does not support the IERC1155 interface'
                );
                address forwarderAddress = address(this);
                uint256[] memory amounts = new uint256[](tokenIds.length);
                for (uint256 i = 0; i < tokenIds.length; i++) {
                  amounts[i] = instance.balanceOf(forwarderAddress, tokenIds[i]);
                }
                instance.safeBatchTransferFrom(
                  forwarderAddress,
                  parentAddress,
                  tokenIds,
                  amounts,
                  ''
                );
              }
              /**
               * Flush the entire balance of the contract to the parent address.
               */
              function flush() public {
                uint256 value = address(this).balance;
                if (value == 0) {
                  return;
                }
                (bool success, ) = parentAddress.call{ value: value }('');
                require(success, 'Flush failed');
                emit ForwarderDeposited(msg.sender, value, msg.data);
              }
              /**
               * @inheritdoc IERC165
               */
              function supportsInterface(bytes4 interfaceId)
                public
                virtual
                override(ERC1155Receiver, IERC165)
                view
                returns (bool)
              {
                return
                  interfaceId == type(IForwarder).interfaceId ||
                  super.supportsInterface(interfaceId);
              }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/IERC1155.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev Required interface of an ERC1155 compliant contract, as defined in the
             * https://eips.ethereum.org/EIPS/eip-1155[EIP].
             *
             * _Available since v3.1._
             */
            interface IERC1155 is IERC165 {
                /**
                 * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
                 */
                event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
                /**
                 * @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
                 * transfers.
                 */
                event TransferBatch(
                    address indexed operator,
                    address indexed from,
                    address indexed to,
                    uint256[] ids,
                    uint256[] values
                );
                /**
                 * @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
                 * `approved`.
                 */
                event ApprovalForAll(address indexed account, address indexed operator, bool approved);
                /**
                 * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
                 *
                 * If an {URI} event was emitted for `id`, the standard
                 * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
                 * returned by {IERC1155MetadataURI-uri}.
                 */
                event URI(string value, uint256 indexed id);
                /**
                 * @dev Returns the amount of tokens of token type `id` owned by `account`.
                 *
                 * Requirements:
                 *
                 * - `account` cannot be the zero address.
                 */
                function balanceOf(address account, uint256 id) external view returns (uint256);
                /**
                 * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
                 *
                 * Requirements:
                 *
                 * - `accounts` and `ids` must have the same length.
                 */
                function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids)
                    external
                    view
                    returns (uint256[] memory);
                /**
                 * @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
                 *
                 * Emits an {ApprovalForAll} event.
                 *
                 * Requirements:
                 *
                 * - `operator` cannot be the caller.
                 */
                function setApprovalForAll(address operator, bool approved) external;
                /**
                 * @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
                 *
                 * See {setApprovalForAll}.
                 */
                function isApprovedForAll(address account, address operator) external view returns (bool);
                /**
                 * @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
                 *
                 * Emits a {TransferSingle} event.
                 *
                 * Requirements:
                 *
                 * - `to` cannot be the zero address.
                 * - If the caller is not `from`, it must be have been approved to spend ``from``'s tokens via {setApprovalForAll}.
                 * - `from` must have a balance of tokens of type `id` of at least `amount`.
                 * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
                 * acceptance magic value.
                 */
                function safeTransferFrom(
                    address from,
                    address to,
                    uint256 id,
                    uint256 amount,
                    bytes calldata data
                ) external;
                /**
                 * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
                 *
                 * Emits a {TransferBatch} event.
                 *
                 * Requirements:
                 *
                 * - `ids` and `amounts` must have the same length.
                 * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
                 * acceptance magic value.
                 */
                function safeBatchTransferFrom(
                    address from,
                    address to,
                    uint256[] calldata ids,
                    uint256[] calldata amounts,
                    bytes calldata data
                ) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev Required interface of an ERC721 compliant contract.
             */
            interface IERC721 is IERC165 {
                /**
                 * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
                 */
                event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                /**
                 * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
                 */
                event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                /**
                 * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
                 */
                event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                /**
                 * @dev Returns the number of tokens in ``owner``'s account.
                 */
                function balanceOf(address owner) external view returns (uint256 balance);
                /**
                 * @dev Returns the owner of the `tokenId` token.
                 *
                 * Requirements:
                 *
                 * - `tokenId` must exist.
                 */
                function ownerOf(uint256 tokenId) external view returns (address owner);
                /**
                 * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
                 * are aware of the ERC721 protocol to prevent tokens from being forever locked.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `tokenId` token must exist and be owned by `from`.
                 * - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
                 * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                 *
                 * Emits a {Transfer} event.
                 */
                function safeTransferFrom(
                    address from,
                    address to,
                    uint256 tokenId
                ) external;
                /**
                 * @dev Transfers `tokenId` token from `from` to `to`.
                 *
                 * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `tokenId` token must be owned by `from`.
                 * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
                 *
                 * Emits a {Transfer} event.
                 */
                function transferFrom(
                    address from,
                    address to,
                    uint256 tokenId
                ) external;
                /**
                 * @dev Gives permission to `to` to transfer `tokenId` token to another account.
                 * The approval is cleared when the token is transferred.
                 *
                 * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
                 *
                 * Requirements:
                 *
                 * - The caller must own the token or be an approved operator.
                 * - `tokenId` must exist.
                 *
                 * Emits an {Approval} event.
                 */
                function approve(address to, uint256 tokenId) external;
                /**
                 * @dev Returns the account approved for `tokenId` token.
                 *
                 * Requirements:
                 *
                 * - `tokenId` must exist.
                 */
                function getApproved(uint256 tokenId) external view returns (address operator);
                /**
                 * @dev Approve or remove `operator` as an operator for the caller.
                 * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
                 *
                 * Requirements:
                 *
                 * - The `operator` cannot be the caller.
                 *
                 * Emits an {ApprovalForAll} event.
                 */
                function setApprovalForAll(address operator, bool _approved) external;
                /**
                 * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
                 *
                 * See {setApprovalForAll}
                 */
                function isApprovedForAll(address owner, address operator) external view returns (bool);
                /**
                 * @dev Safely transfers `tokenId` token from `from` to `to`.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `tokenId` token must exist and be owned by `from`.
                 * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
                 * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                 *
                 * Emits a {Transfer} event.
                 */
                function safeTransferFrom(
                    address from,
                    address to,
                    uint256 tokenId,
                    bytes calldata data
                ) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721Receiver.sol)
            pragma solidity ^0.8.0;
            /**
             * @title ERC721 token receiver interface
             * @dev Interface for any contract that wants to support safeTransfers
             * from ERC721 asset contracts.
             */
            interface IERC721Receiver {
                /**
                 * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
                 * by `operator` from `from`, this function is called.
                 *
                 * It must return its Solidity selector to confirm the token transfer.
                 * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
                 *
                 * The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.
                 */
                function onERC721Received(
                    address operator,
                    address from,
                    uint256 tokenId,
                    bytes calldata data
                ) external returns (bytes4);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/utils/ERC1155Receiver.sol)
            pragma solidity ^0.8.0;
            import "../IERC1155Receiver.sol";
            import "../../../utils/introspection/ERC165.sol";
            /**
             * @dev _Available since v3.1._
             */
            abstract contract ERC1155Receiver is ERC165, IERC1155Receiver {
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
                    return interfaceId == type(IERC1155Receiver).interfaceId || super.supportsInterface(interfaceId);
                }
            }
            // SPDX-License-Identifier: UNLICENSED
            pragma solidity 0.8.10;
            /**
             * Contract that exposes the needed erc20 token functions
             */
            abstract contract ERC20Interface {
              // Send _value amount of tokens to address _to
              function transfer(address _to, uint256 _value)
                public
                virtual
                returns (bool success);
              // Get the account balance of another account with address _owner
              function balanceOf(address _owner)
                public
                virtual
                view
                returns (uint256 balance);
            }
            // SPDX-License-Identifier: GPL-3.0-or-later
            // source: https://github.com/Uniswap/solidity-lib/blob/master/contracts/libraries/TransferHelper.sol
            pragma solidity 0.8.10;
            import '@openzeppelin/contracts/utils/Address.sol';
            // helper methods for interacting with ERC20 tokens and sending ETH that do not consistently return true/false
            library TransferHelper {
              function safeTransfer(
                address token,
                address to,
                uint256 value
              ) internal {
                // bytes4(keccak256(bytes('transfer(address,uint256)')));
                (bool success, bytes memory data) = token.call(
                  abi.encodeWithSelector(0xa9059cbb, to, value)
                );
                require(
                  success && (data.length == 0 || abi.decode(data, (bool))),
                  'TransferHelper::safeTransfer: transfer failed'
                );
              }
              function safeTransferFrom(
                address token,
                address from,
                address to,
                uint256 value
              ) internal {
                // bytes4(keccak256(bytes('transferFrom(address,address,uint256)')));
                (bool success, bytes memory returndata) = token.call(
                  abi.encodeWithSelector(0x23b872dd, from, to, value)
                );
                Address.verifyCallResult(
                  success,
                  returndata,
                  'TransferHelper::transferFrom: transferFrom failed'
                );
              }
            }
            pragma solidity ^0.8.0;
            import '@openzeppelin/contracts/utils/introspection/IERC165.sol';
            interface IForwarder is IERC165 {
              /**
               * Sets the autoflush721 parameter.
               *
               * @param autoFlush whether to autoflush erc721 tokens
               */
              function setAutoFlush721(bool autoFlush) external;
              /**
               * Sets the autoflush1155 parameter.
               *
               * @param autoFlush whether to autoflush erc1155 tokens
               */
              function setAutoFlush1155(bool autoFlush) external;
              /**
               * Execute a token transfer of the full balance from the forwarder token to the parent address
               *
               * @param tokenContractAddress the address of the erc20 token contract
               */
              function flushTokens(address tokenContractAddress) external;
              /**
               * Execute a nft transfer from the forwarder to the parent address
               *
               * @param tokenContractAddress the address of the ERC721 NFT contract
               * @param tokenId The token id of the nft
               */
              function flushERC721Token(address tokenContractAddress, uint256 tokenId)
                external;
              /**
               * Execute a nft transfer from the forwarder to the parent address.
               *
               * @param tokenContractAddress the address of the ERC1155 NFT contract
               * @param tokenId The token id of the nft
               */
              function flushERC1155Tokens(address tokenContractAddress, uint256 tokenId)
                external;
              /**
               * Execute a batch nft transfer from the forwarder to the parent address.
               *
               * @param tokenContractAddress the address of the ERC1155 NFT contract
               * @param tokenIds The token ids of the nfts
               */
              function batchFlushERC1155Tokens(
                address tokenContractAddress,
                uint256[] calldata tokenIds
              ) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Interface of the ERC165 standard, as defined in the
             * https://eips.ethereum.org/EIPS/eip-165[EIP].
             *
             * Implementers can declare support of contract interfaces, which can then be
             * queried by others ({ERC165Checker}).
             *
             * For an implementation, see {ERC165}.
             */
            interface IERC165 {
                /**
                 * @dev Returns true if this contract implements the interface defined by
                 * `interfaceId`. See the corresponding
                 * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
                 * to learn more about how these ids are created.
                 *
                 * This function call must use less than 30 000 gas.
                 */
                function supportsInterface(bytes4 interfaceId) external view returns (bool);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/IERC1155Receiver.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev _Available since v3.1._
             */
            interface IERC1155Receiver is IERC165 {
                /**
                    @dev Handles the receipt of a single ERC1155 token type. This function is
                    called at the end of a `safeTransferFrom` after the balance has been updated.
                    To accept the transfer, this must return
                    `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
                    (i.e. 0xf23a6e61, or its own function selector).
                    @param operator The address which initiated the transfer (i.e. msg.sender)
                    @param from The address which previously owned the token
                    @param id The ID of the token being transferred
                    @param value The amount of tokens being transferred
                    @param data Additional data with no specified format
                    @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
                */
                function onERC1155Received(
                    address operator,
                    address from,
                    uint256 id,
                    uint256 value,
                    bytes calldata data
                ) external returns (bytes4);
                /**
                    @dev Handles the receipt of a multiple ERC1155 token types. This function
                    is called at the end of a `safeBatchTransferFrom` after the balances have
                    been updated. To accept the transfer(s), this must return
                    `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
                    (i.e. 0xbc197c81, or its own function selector).
                    @param operator The address which initiated the batch transfer (i.e. msg.sender)
                    @param from The address which previously owned the token
                    @param ids An array containing ids of each token being transferred (order and length must match values array)
                    @param values An array containing amounts of each token being transferred (order and length must match ids array)
                    @param data Additional data with no specified format
                    @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
                */
                function onERC1155BatchReceived(
                    address operator,
                    address from,
                    uint256[] calldata ids,
                    uint256[] calldata values,
                    bytes calldata data
                ) external returns (bytes4);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
            pragma solidity ^0.8.0;
            import "./IERC165.sol";
            /**
             * @dev Implementation of the {IERC165} interface.
             *
             * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
             * for the additional interface id that will be supported. For example:
             *
             * ```solidity
             * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
             *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
             * }
             * ```
             *
             * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
             */
            abstract contract ERC165 is IERC165 {
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                    return interfaceId == type(IERC165).interfaceId;
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/Address.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Collection of functions related to the address type
             */
            library Address {
                /**
                 * @dev Returns true if `account` is a contract.
                 *
                 * [IMPORTANT]
                 * ====
                 * It is unsafe to assume that an address for which this function returns
                 * false is an externally-owned account (EOA) and not a contract.
                 *
                 * Among others, `isContract` will return false for the following
                 * types of addresses:
                 *
                 *  - an externally-owned account
                 *  - a contract in construction
                 *  - an address where a contract will be created
                 *  - an address where a contract lived, but was destroyed
                 * ====
                 */
                function isContract(address account) internal view returns (bool) {
                    // This method relies on extcodesize, which returns 0 for contracts in
                    // construction, since the code is only stored at the end of the
                    // constructor execution.
                    uint256 size;
                    assembly {
                        size := extcodesize(account)
                    }
                    return size > 0;
                }
                /**
                 * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                 * `recipient`, forwarding all available gas and reverting on errors.
                 *
                 * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                 * of certain opcodes, possibly making contracts go over the 2300 gas limit
                 * imposed by `transfer`, making them unable to receive funds via
                 * `transfer`. {sendValue} removes this limitation.
                 *
                 * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                 *
                 * IMPORTANT: because control is transferred to `recipient`, care must be
                 * taken to not create reentrancy vulnerabilities. Consider using
                 * {ReentrancyGuard} or the
                 * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                 */
                function sendValue(address payable recipient, uint256 amount) internal {
                    require(address(this).balance >= amount, "Address: insufficient balance");
                    (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
                            assembly {
                                let returndata_size := mload(returndata)
                                revert(add(32, returndata), returndata_size)
                            }
                        } else {
                            revert(errorMessage);
                        }
                    }
                }
            }
            

            File 3 of 4: Forwarder
            // SPDX-License-Identifier: Apache-2.0
            pragma solidity 0.8.10;
            import '@openzeppelin/contracts/token/ERC1155/IERC1155.sol';
            import '@openzeppelin/contracts/token/ERC721/IERC721.sol';
            import '@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol';
            import '@openzeppelin/contracts/token/ERC1155/utils/ERC1155Receiver.sol';
            import './ERC20Interface.sol';
            import './TransferHelper.sol';
            import './IForwarder.sol';
            /**
             * Contract that will forward any incoming Ether to the creator of the contract
             *
             */
            contract Forwarder is IERC721Receiver, ERC1155Receiver, IForwarder {
              // Address to which any funds sent to this contract will be forwarded
              address public parentAddress;
              bool public autoFlush721 = true;
              bool public autoFlush1155 = true;
              event ForwarderDeposited(address from, uint256 value, bytes data);
              /**
               * Initialize the contract, and sets the destination address to that of the creator
               */
              function init(
                address _parentAddress,
                bool _autoFlush721,
                bool _autoFlush1155
              ) external onlyUninitialized {
                parentAddress = _parentAddress;
                uint256 value = address(this).balance;
                // set whether we want to automatically flush erc721/erc1155 tokens or not
                autoFlush721 = _autoFlush721;
                autoFlush1155 = _autoFlush1155;
                if (value == 0) {
                  return;
                }
                (bool success, ) = parentAddress.call{ value: value }('');
                require(success, 'Flush failed');
                // NOTE: since we are forwarding on initialization,
                // we don't have the context of the original sender.
                // We still emit an event about the forwarding but set
                // the sender to the forwarder itself
                emit ForwarderDeposited(address(this), value, msg.data);
              }
              /**
               * Modifier that will execute internal code block only if the sender is the parent address
               */
              modifier onlyParent {
                require(msg.sender == parentAddress, 'Only Parent');
                _;
              }
              /**
               * Modifier that will execute internal code block only if the contract has not been initialized yet
               */
              modifier onlyUninitialized {
                require(parentAddress == address(0x0), 'Already initialized');
                _;
              }
              /**
               * Default function; Gets called when data is sent but does not match any other function
               */
              fallback() external payable {
                flush();
              }
              /**
               * Default function; Gets called when Ether is deposited with no data, and forwards it to the parent address
               */
              receive() external payable {
                flush();
              }
              /**
               * @inheritdoc IForwarder
               */
              function setAutoFlush721(bool autoFlush)
                external
                virtual
                override
                onlyParent
              {
                autoFlush721 = autoFlush;
              }
              /**
               * @inheritdoc IForwarder
               */
              function setAutoFlush1155(bool autoFlush)
                external
                virtual
                override
                onlyParent
              {
                autoFlush1155 = autoFlush;
              }
              /**
               * ERC721 standard callback function for when a ERC721 is transfered. The forwarder will send the nft
               * to the base wallet once the nft contract invokes this method after transfering the nft.
               *
               * @param _operator The address which called `safeTransferFrom` function
               * @param _from The address of the sender
               * @param _tokenId The token id of the nft
               * @param data Additional data with no specified format, sent in call to `_to`
               */
              function onERC721Received(
                address _operator,
                address _from,
                uint256 _tokenId,
                bytes memory data
              ) external virtual override returns (bytes4) {
                if (autoFlush721) {
                  IERC721 instance = IERC721(msg.sender);
                  require(
                    instance.supportsInterface(type(IERC721).interfaceId),
                    'The caller does not support the ERC721 interface'
                  );
                  // this won't work for ERC721 re-entrancy
                  instance.safeTransferFrom(address(this), parentAddress, _tokenId, data);
                }
                return this.onERC721Received.selector;
              }
              function callFromParent(
                address target,
                uint256 value,
                bytes calldata data
              ) external onlyParent returns (bytes memory) {
                (bool success, bytes memory returnedData) = target.call{ value: value }(
                  data
                );
                require(success, 'Parent call execution failed');
                return returnedData;
              }
              /**
               * @inheritdoc IERC1155Receiver
               */
              function onERC1155Received(
                address _operator,
                address _from,
                uint256 id,
                uint256 value,
                bytes calldata data
              ) external virtual override returns (bytes4) {
                IERC1155 instance = IERC1155(msg.sender);
                require(
                  instance.supportsInterface(type(IERC1155).interfaceId),
                  'The caller does not support the IERC1155 interface'
                );
                if (autoFlush1155) {
                  instance.safeTransferFrom(address(this), parentAddress, id, value, data);
                }
                return this.onERC1155Received.selector;
              }
              /**
               * @inheritdoc IERC1155Receiver
               */
              function onERC1155BatchReceived(
                address _operator,
                address _from,
                uint256[] calldata ids,
                uint256[] calldata values,
                bytes calldata data
              ) external virtual override returns (bytes4) {
                IERC1155 instance = IERC1155(msg.sender);
                require(
                  instance.supportsInterface(type(IERC1155).interfaceId),
                  'The caller does not support the IERC1155 interface'
                );
                if (autoFlush1155) {
                  instance.safeBatchTransferFrom(
                    address(this),
                    parentAddress,
                    ids,
                    values,
                    data
                  );
                }
                return this.onERC1155BatchReceived.selector;
              }
              /**
               * @inheritdoc IForwarder
               */
              function flushTokens(address tokenContractAddress)
                external
                virtual
                override
                onlyParent
              {
                ERC20Interface instance = ERC20Interface(tokenContractAddress);
                address forwarderAddress = address(this);
                uint256 forwarderBalance = instance.balanceOf(forwarderAddress);
                if (forwarderBalance == 0) {
                  return;
                }
                TransferHelper.safeTransfer(
                  tokenContractAddress,
                  parentAddress,
                  forwarderBalance
                );
              }
              /**
               * @inheritdoc IForwarder
               */
              function flushERC721Token(address tokenContractAddress, uint256 tokenId)
                external
                virtual
                override
                onlyParent
              {
                IERC721 instance = IERC721(tokenContractAddress);
                require(
                  instance.supportsInterface(type(IERC721).interfaceId),
                  'The tokenContractAddress does not support the ERC721 interface'
                );
                address ownerAddress = instance.ownerOf(tokenId);
                instance.transferFrom(ownerAddress, parentAddress, tokenId);
              }
              /**
               * @inheritdoc IForwarder
               */
              function flushERC1155Tokens(address tokenContractAddress, uint256 tokenId)
                external
                virtual
                override
                onlyParent
              {
                IERC1155 instance = IERC1155(tokenContractAddress);
                require(
                  instance.supportsInterface(type(IERC1155).interfaceId),
                  'The caller does not support the IERC1155 interface'
                );
                address forwarderAddress = address(this);
                uint256 forwarderBalance = instance.balanceOf(forwarderAddress, tokenId);
                instance.safeTransferFrom(
                  forwarderAddress,
                  parentAddress,
                  tokenId,
                  forwarderBalance,
                  ''
                );
              }
              /**
               * @inheritdoc IForwarder
               */
              function batchFlushERC1155Tokens(
                address tokenContractAddress,
                uint256[] calldata tokenIds
              ) external virtual override onlyParent {
                IERC1155 instance = IERC1155(tokenContractAddress);
                require(
                  instance.supportsInterface(type(IERC1155).interfaceId),
                  'The caller does not support the IERC1155 interface'
                );
                address forwarderAddress = address(this);
                uint256[] memory amounts = new uint256[](tokenIds.length);
                for (uint256 i = 0; i < tokenIds.length; i++) {
                  amounts[i] = instance.balanceOf(forwarderAddress, tokenIds[i]);
                }
                instance.safeBatchTransferFrom(
                  forwarderAddress,
                  parentAddress,
                  tokenIds,
                  amounts,
                  ''
                );
              }
              /**
               * Flush the entire balance of the contract to the parent address.
               */
              function flush() public {
                uint256 value = address(this).balance;
                if (value == 0) {
                  return;
                }
                (bool success, ) = parentAddress.call{ value: value }('');
                require(success, 'Flush failed');
                emit ForwarderDeposited(msg.sender, value, msg.data);
              }
              /**
               * @inheritdoc IERC165
               */
              function supportsInterface(bytes4 interfaceId)
                public
                virtual
                override(ERC1155Receiver, IERC165)
                view
                returns (bool)
              {
                return
                  interfaceId == type(IForwarder).interfaceId ||
                  super.supportsInterface(interfaceId);
              }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/IERC1155.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev Required interface of an ERC1155 compliant contract, as defined in the
             * https://eips.ethereum.org/EIPS/eip-1155[EIP].
             *
             * _Available since v3.1._
             */
            interface IERC1155 is IERC165 {
                /**
                 * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
                 */
                event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
                /**
                 * @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
                 * transfers.
                 */
                event TransferBatch(
                    address indexed operator,
                    address indexed from,
                    address indexed to,
                    uint256[] ids,
                    uint256[] values
                );
                /**
                 * @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
                 * `approved`.
                 */
                event ApprovalForAll(address indexed account, address indexed operator, bool approved);
                /**
                 * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
                 *
                 * If an {URI} event was emitted for `id`, the standard
                 * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
                 * returned by {IERC1155MetadataURI-uri}.
                 */
                event URI(string value, uint256 indexed id);
                /**
                 * @dev Returns the amount of tokens of token type `id` owned by `account`.
                 *
                 * Requirements:
                 *
                 * - `account` cannot be the zero address.
                 */
                function balanceOf(address account, uint256 id) external view returns (uint256);
                /**
                 * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
                 *
                 * Requirements:
                 *
                 * - `accounts` and `ids` must have the same length.
                 */
                function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids)
                    external
                    view
                    returns (uint256[] memory);
                /**
                 * @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
                 *
                 * Emits an {ApprovalForAll} event.
                 *
                 * Requirements:
                 *
                 * - `operator` cannot be the caller.
                 */
                function setApprovalForAll(address operator, bool approved) external;
                /**
                 * @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
                 *
                 * See {setApprovalForAll}.
                 */
                function isApprovedForAll(address account, address operator) external view returns (bool);
                /**
                 * @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
                 *
                 * Emits a {TransferSingle} event.
                 *
                 * Requirements:
                 *
                 * - `to` cannot be the zero address.
                 * - If the caller is not `from`, it must be have been approved to spend ``from``'s tokens via {setApprovalForAll}.
                 * - `from` must have a balance of tokens of type `id` of at least `amount`.
                 * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
                 * acceptance magic value.
                 */
                function safeTransferFrom(
                    address from,
                    address to,
                    uint256 id,
                    uint256 amount,
                    bytes calldata data
                ) external;
                /**
                 * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
                 *
                 * Emits a {TransferBatch} event.
                 *
                 * Requirements:
                 *
                 * - `ids` and `amounts` must have the same length.
                 * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
                 * acceptance magic value.
                 */
                function safeBatchTransferFrom(
                    address from,
                    address to,
                    uint256[] calldata ids,
                    uint256[] calldata amounts,
                    bytes calldata data
                ) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev Required interface of an ERC721 compliant contract.
             */
            interface IERC721 is IERC165 {
                /**
                 * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
                 */
                event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                /**
                 * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
                 */
                event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                /**
                 * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
                 */
                event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                /**
                 * @dev Returns the number of tokens in ``owner``'s account.
                 */
                function balanceOf(address owner) external view returns (uint256 balance);
                /**
                 * @dev Returns the owner of the `tokenId` token.
                 *
                 * Requirements:
                 *
                 * - `tokenId` must exist.
                 */
                function ownerOf(uint256 tokenId) external view returns (address owner);
                /**
                 * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
                 * are aware of the ERC721 protocol to prevent tokens from being forever locked.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `tokenId` token must exist and be owned by `from`.
                 * - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
                 * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                 *
                 * Emits a {Transfer} event.
                 */
                function safeTransferFrom(
                    address from,
                    address to,
                    uint256 tokenId
                ) external;
                /**
                 * @dev Transfers `tokenId` token from `from` to `to`.
                 *
                 * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `tokenId` token must be owned by `from`.
                 * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
                 *
                 * Emits a {Transfer} event.
                 */
                function transferFrom(
                    address from,
                    address to,
                    uint256 tokenId
                ) external;
                /**
                 * @dev Gives permission to `to` to transfer `tokenId` token to another account.
                 * The approval is cleared when the token is transferred.
                 *
                 * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
                 *
                 * Requirements:
                 *
                 * - The caller must own the token or be an approved operator.
                 * - `tokenId` must exist.
                 *
                 * Emits an {Approval} event.
                 */
                function approve(address to, uint256 tokenId) external;
                /**
                 * @dev Returns the account approved for `tokenId` token.
                 *
                 * Requirements:
                 *
                 * - `tokenId` must exist.
                 */
                function getApproved(uint256 tokenId) external view returns (address operator);
                /**
                 * @dev Approve or remove `operator` as an operator for the caller.
                 * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
                 *
                 * Requirements:
                 *
                 * - The `operator` cannot be the caller.
                 *
                 * Emits an {ApprovalForAll} event.
                 */
                function setApprovalForAll(address operator, bool _approved) external;
                /**
                 * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
                 *
                 * See {setApprovalForAll}
                 */
                function isApprovedForAll(address owner, address operator) external view returns (bool);
                /**
                 * @dev Safely transfers `tokenId` token from `from` to `to`.
                 *
                 * Requirements:
                 *
                 * - `from` cannot be the zero address.
                 * - `to` cannot be the zero address.
                 * - `tokenId` token must exist and be owned by `from`.
                 * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
                 * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                 *
                 * Emits a {Transfer} event.
                 */
                function safeTransferFrom(
                    address from,
                    address to,
                    uint256 tokenId,
                    bytes calldata data
                ) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721Receiver.sol)
            pragma solidity ^0.8.0;
            /**
             * @title ERC721 token receiver interface
             * @dev Interface for any contract that wants to support safeTransfers
             * from ERC721 asset contracts.
             */
            interface IERC721Receiver {
                /**
                 * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
                 * by `operator` from `from`, this function is called.
                 *
                 * It must return its Solidity selector to confirm the token transfer.
                 * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
                 *
                 * The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.
                 */
                function onERC721Received(
                    address operator,
                    address from,
                    uint256 tokenId,
                    bytes calldata data
                ) external returns (bytes4);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/utils/ERC1155Receiver.sol)
            pragma solidity ^0.8.0;
            import "../IERC1155Receiver.sol";
            import "../../../utils/introspection/ERC165.sol";
            /**
             * @dev _Available since v3.1._
             */
            abstract contract ERC1155Receiver is ERC165, IERC1155Receiver {
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
                    return interfaceId == type(IERC1155Receiver).interfaceId || super.supportsInterface(interfaceId);
                }
            }
            // SPDX-License-Identifier: UNLICENSED
            pragma solidity 0.8.10;
            /**
             * Contract that exposes the needed erc20 token functions
             */
            abstract contract ERC20Interface {
              // Send _value amount of tokens to address _to
              function transfer(address _to, uint256 _value)
                public
                virtual
                returns (bool success);
              // Get the account balance of another account with address _owner
              function balanceOf(address _owner)
                public
                virtual
                view
                returns (uint256 balance);
            }
            // SPDX-License-Identifier: GPL-3.0-or-later
            // source: https://github.com/Uniswap/solidity-lib/blob/master/contracts/libraries/TransferHelper.sol
            pragma solidity 0.8.10;
            import '@openzeppelin/contracts/utils/Address.sol';
            // helper methods for interacting with ERC20 tokens and sending ETH that do not consistently return true/false
            library TransferHelper {
              function safeTransfer(
                address token,
                address to,
                uint256 value
              ) internal {
                // bytes4(keccak256(bytes('transfer(address,uint256)')));
                (bool success, bytes memory data) = token.call(
                  abi.encodeWithSelector(0xa9059cbb, to, value)
                );
                require(
                  success && (data.length == 0 || abi.decode(data, (bool))),
                  'TransferHelper::safeTransfer: transfer failed'
                );
              }
              function safeTransferFrom(
                address token,
                address from,
                address to,
                uint256 value
              ) internal {
                // bytes4(keccak256(bytes('transferFrom(address,address,uint256)')));
                (bool success, bytes memory returndata) = token.call(
                  abi.encodeWithSelector(0x23b872dd, from, to, value)
                );
                Address.verifyCallResult(
                  success,
                  returndata,
                  'TransferHelper::transferFrom: transferFrom failed'
                );
              }
            }
            pragma solidity ^0.8.0;
            import '@openzeppelin/contracts/utils/introspection/IERC165.sol';
            interface IForwarder is IERC165 {
              /**
               * Sets the autoflush721 parameter.
               *
               * @param autoFlush whether to autoflush erc721 tokens
               */
              function setAutoFlush721(bool autoFlush) external;
              /**
               * Sets the autoflush1155 parameter.
               *
               * @param autoFlush whether to autoflush erc1155 tokens
               */
              function setAutoFlush1155(bool autoFlush) external;
              /**
               * Execute a token transfer of the full balance from the forwarder token to the parent address
               *
               * @param tokenContractAddress the address of the erc20 token contract
               */
              function flushTokens(address tokenContractAddress) external;
              /**
               * Execute a nft transfer from the forwarder to the parent address
               *
               * @param tokenContractAddress the address of the ERC721 NFT contract
               * @param tokenId The token id of the nft
               */
              function flushERC721Token(address tokenContractAddress, uint256 tokenId)
                external;
              /**
               * Execute a nft transfer from the forwarder to the parent address.
               *
               * @param tokenContractAddress the address of the ERC1155 NFT contract
               * @param tokenId The token id of the nft
               */
              function flushERC1155Tokens(address tokenContractAddress, uint256 tokenId)
                external;
              /**
               * Execute a batch nft transfer from the forwarder to the parent address.
               *
               * @param tokenContractAddress the address of the ERC1155 NFT contract
               * @param tokenIds The token ids of the nfts
               */
              function batchFlushERC1155Tokens(
                address tokenContractAddress,
                uint256[] calldata tokenIds
              ) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Interface of the ERC165 standard, as defined in the
             * https://eips.ethereum.org/EIPS/eip-165[EIP].
             *
             * Implementers can declare support of contract interfaces, which can then be
             * queried by others ({ERC165Checker}).
             *
             * For an implementation, see {ERC165}.
             */
            interface IERC165 {
                /**
                 * @dev Returns true if this contract implements the interface defined by
                 * `interfaceId`. See the corresponding
                 * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
                 * to learn more about how these ids are created.
                 *
                 * This function call must use less than 30 000 gas.
                 */
                function supportsInterface(bytes4 interfaceId) external view returns (bool);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/IERC1155Receiver.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev _Available since v3.1._
             */
            interface IERC1155Receiver is IERC165 {
                /**
                    @dev Handles the receipt of a single ERC1155 token type. This function is
                    called at the end of a `safeTransferFrom` after the balance has been updated.
                    To accept the transfer, this must return
                    `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
                    (i.e. 0xf23a6e61, or its own function selector).
                    @param operator The address which initiated the transfer (i.e. msg.sender)
                    @param from The address which previously owned the token
                    @param id The ID of the token being transferred
                    @param value The amount of tokens being transferred
                    @param data Additional data with no specified format
                    @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
                */
                function onERC1155Received(
                    address operator,
                    address from,
                    uint256 id,
                    uint256 value,
                    bytes calldata data
                ) external returns (bytes4);
                /**
                    @dev Handles the receipt of a multiple ERC1155 token types. This function
                    is called at the end of a `safeBatchTransferFrom` after the balances have
                    been updated. To accept the transfer(s), this must return
                    `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
                    (i.e. 0xbc197c81, or its own function selector).
                    @param operator The address which initiated the batch transfer (i.e. msg.sender)
                    @param from The address which previously owned the token
                    @param ids An array containing ids of each token being transferred (order and length must match values array)
                    @param values An array containing amounts of each token being transferred (order and length must match ids array)
                    @param data Additional data with no specified format
                    @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
                */
                function onERC1155BatchReceived(
                    address operator,
                    address from,
                    uint256[] calldata ids,
                    uint256[] calldata values,
                    bytes calldata data
                ) external returns (bytes4);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
            pragma solidity ^0.8.0;
            import "./IERC165.sol";
            /**
             * @dev Implementation of the {IERC165} interface.
             *
             * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
             * for the additional interface id that will be supported. For example:
             *
             * ```solidity
             * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
             *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
             * }
             * ```
             *
             * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
             */
            abstract contract ERC165 is IERC165 {
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                    return interfaceId == type(IERC165).interfaceId;
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/Address.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Collection of functions related to the address type
             */
            library Address {
                /**
                 * @dev Returns true if `account` is a contract.
                 *
                 * [IMPORTANT]
                 * ====
                 * It is unsafe to assume that an address for which this function returns
                 * false is an externally-owned account (EOA) and not a contract.
                 *
                 * Among others, `isContract` will return false for the following
                 * types of addresses:
                 *
                 *  - an externally-owned account
                 *  - a contract in construction
                 *  - an address where a contract will be created
                 *  - an address where a contract lived, but was destroyed
                 * ====
                 */
                function isContract(address account) internal view returns (bool) {
                    // This method relies on extcodesize, which returns 0 for contracts in
                    // construction, since the code is only stored at the end of the
                    // constructor execution.
                    uint256 size;
                    assembly {
                        size := extcodesize(account)
                    }
                    return size > 0;
                }
                /**
                 * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                 * `recipient`, forwarding all available gas and reverting on errors.
                 *
                 * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                 * of certain opcodes, possibly making contracts go over the 2300 gas limit
                 * imposed by `transfer`, making them unable to receive funds via
                 * `transfer`. {sendValue} removes this limitation.
                 *
                 * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                 *
                 * IMPORTANT: because control is transferred to `recipient`, care must be
                 * taken to not create reentrancy vulnerabilities. Consider using
                 * {ReentrancyGuard} or the
                 * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                 */
                function sendValue(address payable recipient, uint256 amount) internal {
                    require(address(this).balance >= amount, "Address: insufficient balance");
                    (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
                            assembly {
                                let returndata_size := mload(returndata)
                                revert(add(32, returndata), returndata_size)
                            }
                        } else {
                            revert(errorMessage);
                        }
                    }
                }
            }
            

            File 4 of 4: WalletSimple
            // SPDX-License-Identifier: Apache-2.0
            pragma solidity 0.8.10;
            import './TransferHelper.sol';
            import './ERC20Interface.sol';
            import './IForwarder.sol';
            /** ERC721, ERC1155 imports */
            import '@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol';
            import '@openzeppelin/contracts/token/ERC1155/utils/ERC1155Receiver.sol';
            /**
             *
             * WalletSimple
             * ============
             *
             * Basic multi-signer wallet designed for use in a co-signing environment where 2 signatures are required to move funds.
             * Typically used in a 2-of-3 signing configuration. Uses ecrecover to allow for 2 signatures in a single transaction.
             *
             * The first signature is created on the operation hash (see Data Formats) and passed to sendMultiSig/sendMultiSigToken
             * The signer is determined by verifyMultiSig().
             *
             * The second signature is created by the submitter of the transaction and determined by msg.signer.
             *
             * Data Formats
             * ============
             *
             * The signature is created with ethereumjs-util.ecsign(operationHash).
             * Like the eth_sign RPC call, it packs the values as a 65-byte array of [r, s, v].
             * Unlike eth_sign, the message is not prefixed.
             *
             * The operationHash the result of keccak256(prefix, toAddress, value, data, expireTime).
             * For ether transactions, `prefix` is "ETHER".
             * For token transaction, `prefix` is "ERC20" and `data` is the tokenContractAddress.
             *
             *
             */
            contract WalletSimple is IERC721Receiver, ERC1155Receiver {
              // Events
              event Deposited(address from, uint256 value, bytes data);
              event SafeModeActivated(address msgSender);
              event Transacted(
                address msgSender, // Address of the sender of the message initiating the transaction
                address otherSigner, // Address of the signer (second signature) used to initiate the transaction
                bytes32 operation, // Operation hash (see Data Formats)
                address toAddress, // The address the transaction was sent to
                uint256 value, // Amount of Wei sent to the address
                bytes data // Data sent when invoking the transaction
              );
              event BatchTransfer(address sender, address recipient, uint256 value);
              // this event shows the other signer and the operation hash that they signed
              // specific batch transfer events are emitted in Batcher
              event BatchTransacted(
                address msgSender, // Address of the sender of the message initiating the transaction
                address otherSigner, // Address of the signer (second signature) used to initiate the transaction
                bytes32 operation // Operation hash (see Data Formats)
              );
              // Public fields
              mapping(address => bool) public signers; // The addresses that can co-sign transactions on the wallet
              bool public safeMode = false; // When active, wallet may only send to signer addresses
              bool public initialized = false; // True if the contract has been initialized
              // Internal fields
              uint256 private constant MAX_SEQUENCE_ID_INCREASE = 10000;
              uint256 constant SEQUENCE_ID_WINDOW_SIZE = 10;
              uint256[SEQUENCE_ID_WINDOW_SIZE] recentSequenceIds;
              /**
               * Set up a simple multi-sig wallet by specifying the signers allowed to be used on this wallet.
               * 2 signers will be required to send a transaction from this wallet.
               * Note: The sender is NOT automatically added to the list of signers.
               * Signers CANNOT be changed once they are set
               *
               * @param allowedSigners An array of signers on the wallet
               */
              function init(address[] calldata allowedSigners) external onlyUninitialized {
                require(allowedSigners.length == 3, 'Invalid number of signers');
                for (uint8 i = 0; i < allowedSigners.length; i++) {
                  require(allowedSigners[i] != address(0), 'Invalid signer');
                  signers[allowedSigners[i]] = true;
                }
                initialized = true;
              }
              /**
               * Get the network identifier that signers must sign over
               * This provides protection signatures being replayed on other chains
               * This must be a virtual function because chain-specific contracts will need
               *    to override with their own network ids. It also can't be a field
               *    to allow this contract to be used by proxy with delegatecall, which will
               *    not pick up on state variables
               */
              function getNetworkId() internal virtual pure returns (string memory) {
                return 'ETHER';
              }
              /**
               * Get the network identifier that signers must sign over for token transfers
               * This provides protection signatures being replayed on other chains
               * This must be a virtual function because chain-specific contracts will need
               *    to override with their own network ids. It also can't be a field
               *    to allow this contract to be used by proxy with delegatecall, which will
               *    not pick up on state variables
               */
              function getTokenNetworkId() internal virtual pure returns (string memory) {
                return 'ERC20';
              }
              /**
               * Get the network identifier that signers must sign over for batch transfers
               * This provides protection signatures being replayed on other chains
               * This must be a virtual function because chain-specific contracts will need
               *    to override with their own network ids. It also can't be a field
               *    to allow this contract to be used by proxy with delegatecall, which will
               *    not pick up on state variables
               */
              function getBatchNetworkId() internal virtual pure returns (string memory) {
                return 'ETHER-Batch';
              }
              /**
               * Determine if an address is a signer on this wallet
               * @param signer address to check
               * returns boolean indicating whether address is signer or not
               */
              function isSigner(address signer) public view returns (bool) {
                return signers[signer];
              }
              /**
               * Modifier that will execute internal code block only if the sender is an authorized signer on this wallet
               */
              modifier onlySigner {
                require(isSigner(msg.sender), 'Non-signer in onlySigner method');
                _;
              }
              /**
               * Modifier that will execute internal code block only if the contract has not been initialized yet
               */
              modifier onlyUninitialized {
                require(!initialized, 'Contract already initialized');
                _;
              }
              /**
               * Gets called when a transaction is received with data that does not match any other method
               */
              fallback() external payable {
                if (msg.value > 0) {
                  // Fire deposited event if we are receiving funds
                  emit Deposited(msg.sender, msg.value, msg.data);
                }
              }
              /**
               * Gets called when a transaction is received with ether and no data
               */
              receive() external payable {
                if (msg.value > 0) {
                  // Fire deposited event if we are receiving funds
                  // message data is always empty for receive. If there is data it is sent to fallback function.
                  emit Deposited(msg.sender, msg.value, '');
                }
              }
              /**
               * Execute a multi-signature transaction from this wallet using 2 signers: one from msg.sender and the other from ecrecover.
               * Sequence IDs are numbers starting from 1. They are used to prevent replay attacks and may not be repeated.
               *
               * @param toAddress the destination address to send an outgoing transaction
               * @param value the amount in Wei to be sent
               * @param data the data to send to the toAddress when invoking the transaction
               * @param expireTime the number of seconds since 1970 for which this transaction is valid
               * @param sequenceId the unique sequence id obtainable from getNextSequenceId
               * @param signature see Data Formats
               */
              function sendMultiSig(
                address toAddress,
                uint256 value,
                bytes calldata data,
                uint256 expireTime,
                uint256 sequenceId,
                bytes calldata signature
              ) external onlySigner {
                // Verify the other signer
                bytes32 operationHash = keccak256(
                  abi.encodePacked(
                    getNetworkId(),
                    toAddress,
                    value,
                    data,
                    expireTime,
                    sequenceId
                  )
                );
                address otherSigner = verifyMultiSig(
                  toAddress,
                  operationHash,
                  signature,
                  expireTime,
                  sequenceId
                );
                // Success, send the transaction
                (bool success, ) = toAddress.call{ value: value }(data);
                require(success, 'Call execution failed');
                emit Transacted(
                  msg.sender,
                  otherSigner,
                  operationHash,
                  toAddress,
                  value,
                  data
                );
              }
              /**
               * Execute a batched multi-signature transaction from this wallet using 2 signers: one from msg.sender and the other from ecrecover.
               * Sequence IDs are numbers starting from 1. They are used to prevent replay attacks and may not be repeated.
               * The recipients and values to send are encoded in two arrays, where for index i, recipients[i] will be sent values[i].
               *
               * @param recipients The list of recipients to send to
               * @param values The list of values to send to
               * @param expireTime the number of seconds since 1970 for which this transaction is valid
               * @param sequenceId the unique sequence id obtainable from getNextSequenceId
               * @param signature see Data Formats
               */
              function sendMultiSigBatch(
                address[] calldata recipients,
                uint256[] calldata values,
                uint256 expireTime,
                uint256 sequenceId,
                bytes calldata signature
              ) external onlySigner {
                require(recipients.length != 0, 'Not enough recipients');
                require(
                  recipients.length == values.length,
                  'Unequal recipients and values'
                );
                require(recipients.length < 256, 'Too many recipients, max 255');
                // Verify the other signer
                bytes32 operationHash = keccak256(
                  abi.encodePacked(
                    getBatchNetworkId(),
                    recipients,
                    values,
                    expireTime,
                    sequenceId
                  )
                );
                // the first parameter (toAddress) is used to ensure transactions in safe mode only go to a signer
                // if in safe mode, we should use normal sendMultiSig to recover, so this check will always fail if in safe mode
                require(!safeMode, 'Batch in safe mode');
                address otherSigner = verifyMultiSig(
                  address(0x0),
                  operationHash,
                  signature,
                  expireTime,
                  sequenceId
                );
                batchTransfer(recipients, values);
                emit BatchTransacted(msg.sender, otherSigner, operationHash);
              }
              /**
               * Transfer funds in a batch to each of recipients
               * @param recipients The list of recipients to send to
               * @param values The list of values to send to recipients.
               *  The recipient with index i in recipients array will be sent values[i].
               *  Thus, recipients and values must be the same length
               */
              function batchTransfer(
                address[] calldata recipients,
                uint256[] calldata values
              ) internal {
                for (uint256 i = 0; i < recipients.length; i++) {
                  require(address(this).balance >= values[i], 'Insufficient funds');
                  (bool success, ) = recipients[i].call{ value: values[i] }('');
                  require(success, 'Call failed');
                  emit BatchTransfer(msg.sender, recipients[i], values[i]);
                }
              }
              /**
               * Execute a multi-signature token transfer from this wallet using 2 signers: one from msg.sender and the other from ecrecover.
               * Sequence IDs are numbers starting from 1. They are used to prevent replay attacks and may not be repeated.
               *
               * @param toAddress the destination address to send an outgoing transaction
               * @param value the amount in tokens to be sent
               * @param tokenContractAddress the address of the erc20 token contract
               * @param expireTime the number of seconds since 1970 for which this transaction is valid
               * @param sequenceId the unique sequence id obtainable from getNextSequenceId
               * @param signature see Data Formats
               */
              function sendMultiSigToken(
                address toAddress,
                uint256 value,
                address tokenContractAddress,
                uint256 expireTime,
                uint256 sequenceId,
                bytes calldata signature
              ) external onlySigner {
                // Verify the other signer
                bytes32 operationHash = keccak256(
                  abi.encodePacked(
                    getTokenNetworkId(),
                    toAddress,
                    value,
                    tokenContractAddress,
                    expireTime,
                    sequenceId
                  )
                );
                verifyMultiSig(toAddress, operationHash, signature, expireTime, sequenceId);
                TransferHelper.safeTransfer(tokenContractAddress, toAddress, value);
              }
              /**
               * Execute a token flush from one of the forwarder addresses. This transfer needs only a single signature and can be done by any signer
               *
               * @param forwarderAddress the address of the forwarder address to flush the tokens from
               * @param tokenContractAddress the address of the erc20 token contract
               */
              function flushForwarderTokens(
                address payable forwarderAddress,
                address tokenContractAddress
              ) external onlySigner {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.flushTokens(tokenContractAddress);
              }
              /**
               * Execute a ERC721 token flush from one of the forwarder addresses. This transfer needs only a single signature and can be done by any signer
               *
               * @param forwarderAddress the address of the forwarder address to flush the tokens from
               * @param tokenContractAddress the address of the erc20 token contract
               */
              function flushERC721ForwarderTokens(
                address payable forwarderAddress,
                address tokenContractAddress,
                uint256 tokenId
              ) external onlySigner {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.flushERC721Token(tokenContractAddress, tokenId);
              }
              /**
               * Execute a ERC1155 batch token flush from one of the forwarder addresses.
               * This transfer needs only a single signature and can be done by any signer.
               *
               * @param forwarderAddress the address of the forwarder address to flush the tokens from
               * @param tokenContractAddress the address of the erc1155 token contract
               */
              function batchFlushERC1155ForwarderTokens(
                address payable forwarderAddress,
                address tokenContractAddress,
                uint256[] calldata tokenIds
              ) external onlySigner {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.batchFlushERC1155Tokens(tokenContractAddress, tokenIds);
              }
              /**
               * Execute a ERC1155 token flush from one of the forwarder addresses.
               * This transfer needs only a single signature and can be done by any signer.
               *
               * @param forwarderAddress the address of the forwarder address to flush the tokens from
               * @param tokenContractAddress the address of the erc1155 token contract
               * @param tokenId the token id associated with the ERC1155
               */
              function flushERC1155ForwarderTokens(
                address payable forwarderAddress,
                address tokenContractAddress,
                uint256 tokenId
              ) external onlySigner {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.flushERC1155Tokens(tokenContractAddress, tokenId);
              }
              /**
               * Sets the autoflush 721 parameter on the forwarder.
               *
               * @param forwarderAddress the address of the forwarder to toggle.
               * @param autoFlush whether to autoflush erc721 tokens
               */
              function setAutoFlush721(address forwarderAddress, bool autoFlush)
                external
                onlySigner
              {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.setAutoFlush721(autoFlush);
              }
              /**
               * Sets the autoflush 721 parameter on the forwarder.
               *
               * @param forwarderAddress the address of the forwarder to toggle.
               * @param autoFlush whether to autoflush erc1155 tokens
               */
              function setAutoFlush1155(address forwarderAddress, bool autoFlush)
                external
                onlySigner
              {
                IForwarder forwarder = IForwarder(forwarderAddress);
                forwarder.setAutoFlush1155(autoFlush);
              }
              /**
               * Do common multisig verification for both eth sends and erc20token transfers
               *
               * @param toAddress the destination address to send an outgoing transaction
               * @param operationHash see Data Formats
               * @param signature see Data Formats
               * @param expireTime the number of seconds since 1970 for which this transaction is valid
               * @param sequenceId the unique sequence id obtainable from getNextSequenceId
               * returns address that has created the signature
               */
              function verifyMultiSig(
                address toAddress,
                bytes32 operationHash,
                bytes calldata signature,
                uint256 expireTime,
                uint256 sequenceId
              ) private returns (address) {
                address otherSigner = recoverAddressFromSignature(operationHash, signature);
                // Verify if we are in safe mode. In safe mode, the wallet can only send to signers
                require(!safeMode || isSigner(toAddress), 'External transfer in safe mode');
                // Verify that the transaction has not expired
                require(expireTime >= block.timestamp, 'Transaction expired');
                // Try to insert the sequence ID. Will revert if the sequence id was invalid
                tryInsertSequenceId(sequenceId);
                require(isSigner(otherSigner), 'Invalid signer');
                require(otherSigner != msg.sender, 'Signers cannot be equal');
                return otherSigner;
              }
              /**
               * ERC721 standard callback function for when a ERC721 is transfered.
               *
               * @param _operator The address of the nft contract
               * @param _from The address of the sender
               * @param _tokenId The token id of the nft
               * @param _data Additional data with no specified format, sent in call to `_to`
               */
              function onERC721Received(
                address _operator,
                address _from,
                uint256 _tokenId,
                bytes memory _data
              ) external virtual override returns (bytes4) {
                return this.onERC721Received.selector;
              }
              /**
               * @inheritdoc IERC1155Receiver
               */
              function onERC1155Received(
                address _operator,
                address _from,
                uint256 id,
                uint256 value,
                bytes calldata data
              ) external virtual override returns (bytes4) {
                return this.onERC1155Received.selector;
              }
              /**
               * @inheritdoc IERC1155Receiver
               */
              function onERC1155BatchReceived(
                address _operator,
                address _from,
                uint256[] calldata ids,
                uint256[] calldata values,
                bytes calldata data
              ) external virtual override returns (bytes4) {
                return this.onERC1155BatchReceived.selector;
              }
              /**
               * Irrevocably puts contract into safe mode. When in this mode, transactions may only be sent to signing addresses.
               */
              function activateSafeMode() external onlySigner {
                safeMode = true;
                emit SafeModeActivated(msg.sender);
              }
              /**
               * Gets signer's address using ecrecover
               * @param operationHash see Data Formats
               * @param signature see Data Formats
               * returns address recovered from the signature
               */
              function recoverAddressFromSignature(
                bytes32 operationHash,
                bytes memory signature
              ) private pure returns (address) {
                require(signature.length == 65, 'Invalid signature - wrong length');
                // We need to unpack the signature, which is given as an array of 65 bytes (like eth.sign)
                bytes32 r;
                bytes32 s;
                uint8 v;
                // solhint-disable-next-line
                assembly {
                  r := mload(add(signature, 32))
                  s := mload(add(signature, 64))
                  v := and(mload(add(signature, 65)), 255)
                }
                if (v < 27) {
                  v += 27; // Ethereum versions are 27 or 28 as opposed to 0 or 1 which is submitted by some signing libs
                }
                // protect against signature malleability
                // S value must be in the lower half orader
                // reference: https://github.com/OpenZeppelin/openzeppelin-contracts/blob/051d340171a93a3d401aaaea46b4b62fa81e5d7c/contracts/cryptography/ECDSA.sol#L53
                require(
                  uint256(s) <=
                    0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0,
                  "ECDSA: invalid signature 's' value"
                );
                // note that this returns 0 if the signature is invalid
                // Since 0x0 can never be a signer, when the recovered signer address
                // is checked against our signer list, that 0x0 will cause an invalid signer failure
                return ecrecover(operationHash, v, r, s);
              }
              /**
               * Verify that the sequence id has not been used before and inserts it. Throws if the sequence ID was not accepted.
               * We collect a window of up to 10 recent sequence ids, and allow any sequence id that is not in the window and
               * greater than the minimum element in the window.
               * @param sequenceId to insert into array of stored ids
               */
              function tryInsertSequenceId(uint256 sequenceId) private onlySigner {
                // Keep a pointer to the lowest value element in the window
                uint256 lowestValueIndex = 0;
                // fetch recentSequenceIds into memory for function context to avoid unnecessary sloads
                  uint256[SEQUENCE_ID_WINDOW_SIZE] memory _recentSequenceIds
                 = recentSequenceIds;
                for (uint256 i = 0; i < SEQUENCE_ID_WINDOW_SIZE; i++) {
                  require(_recentSequenceIds[i] != sequenceId, 'Sequence ID already used');
                  if (_recentSequenceIds[i] < _recentSequenceIds[lowestValueIndex]) {
                    lowestValueIndex = i;
                  }
                }
                // The sequence ID being used is lower than the lowest value in the window
                // so we cannot accept it as it may have been used before
                require(
                  sequenceId > _recentSequenceIds[lowestValueIndex],
                  'Sequence ID below window'
                );
                // Block sequence IDs which are much higher than the lowest value
                // This prevents people blocking the contract by using very large sequence IDs quickly
                require(
                  sequenceId <=
                    (_recentSequenceIds[lowestValueIndex] + MAX_SEQUENCE_ID_INCREASE),
                  'Sequence ID above maximum'
                );
                recentSequenceIds[lowestValueIndex] = sequenceId;
              }
              /**
               * Gets the next available sequence ID for signing when using executeAndConfirm
               * returns the sequenceId one higher than the highest currently stored
               */
              function getNextSequenceId() external view returns (uint256) {
                uint256 highestSequenceId = 0;
                for (uint256 i = 0; i < SEQUENCE_ID_WINDOW_SIZE; i++) {
                  if (recentSequenceIds[i] > highestSequenceId) {
                    highestSequenceId = recentSequenceIds[i];
                  }
                }
                return highestSequenceId + 1;
              }
            }
            // SPDX-License-Identifier: GPL-3.0-or-later
            // source: https://github.com/Uniswap/solidity-lib/blob/master/contracts/libraries/TransferHelper.sol
            pragma solidity 0.8.10;
            import '@openzeppelin/contracts/utils/Address.sol';
            // helper methods for interacting with ERC20 tokens and sending ETH that do not consistently return true/false
            library TransferHelper {
              function safeTransfer(
                address token,
                address to,
                uint256 value
              ) internal {
                // bytes4(keccak256(bytes('transfer(address,uint256)')));
                (bool success, bytes memory data) = token.call(
                  abi.encodeWithSelector(0xa9059cbb, to, value)
                );
                require(
                  success && (data.length == 0 || abi.decode(data, (bool))),
                  'TransferHelper::safeTransfer: transfer failed'
                );
              }
              function safeTransferFrom(
                address token,
                address from,
                address to,
                uint256 value
              ) internal {
                // bytes4(keccak256(bytes('transferFrom(address,address,uint256)')));
                (bool success, bytes memory returndata) = token.call(
                  abi.encodeWithSelector(0x23b872dd, from, to, value)
                );
                Address.verifyCallResult(
                  success,
                  returndata,
                  'TransferHelper::transferFrom: transferFrom failed'
                );
              }
            }
            // SPDX-License-Identifier: UNLICENSED
            pragma solidity 0.8.10;
            /**
             * Contract that exposes the needed erc20 token functions
             */
            abstract contract ERC20Interface {
              // Send _value amount of tokens to address _to
              function transfer(address _to, uint256 _value)
                public
                virtual
                returns (bool success);
              // Get the account balance of another account with address _owner
              function balanceOf(address _owner)
                public
                virtual
                view
                returns (uint256 balance);
            }
            pragma solidity ^0.8.0;
            import '@openzeppelin/contracts/utils/introspection/IERC165.sol';
            interface IForwarder is IERC165 {
              /**
               * Sets the autoflush721 parameter.
               *
               * @param autoFlush whether to autoflush erc721 tokens
               */
              function setAutoFlush721(bool autoFlush) external;
              /**
               * Sets the autoflush1155 parameter.
               *
               * @param autoFlush whether to autoflush erc1155 tokens
               */
              function setAutoFlush1155(bool autoFlush) external;
              /**
               * Execute a token transfer of the full balance from the forwarder token to the parent address
               *
               * @param tokenContractAddress the address of the erc20 token contract
               */
              function flushTokens(address tokenContractAddress) external;
              /**
               * Execute a nft transfer from the forwarder to the parent address
               *
               * @param tokenContractAddress the address of the ERC721 NFT contract
               * @param tokenId The token id of the nft
               */
              function flushERC721Token(address tokenContractAddress, uint256 tokenId)
                external;
              /**
               * Execute a nft transfer from the forwarder to the parent address.
               *
               * @param tokenContractAddress the address of the ERC1155 NFT contract
               * @param tokenId The token id of the nft
               */
              function flushERC1155Tokens(address tokenContractAddress, uint256 tokenId)
                external;
              /**
               * Execute a batch nft transfer from the forwarder to the parent address.
               *
               * @param tokenContractAddress the address of the ERC1155 NFT contract
               * @param tokenIds The token ids of the nfts
               */
              function batchFlushERC1155Tokens(
                address tokenContractAddress,
                uint256[] calldata tokenIds
              ) external;
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721Receiver.sol)
            pragma solidity ^0.8.0;
            /**
             * @title ERC721 token receiver interface
             * @dev Interface for any contract that wants to support safeTransfers
             * from ERC721 asset contracts.
             */
            interface IERC721Receiver {
                /**
                 * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
                 * by `operator` from `from`, this function is called.
                 *
                 * It must return its Solidity selector to confirm the token transfer.
                 * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
                 *
                 * The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.
                 */
                function onERC721Received(
                    address operator,
                    address from,
                    uint256 tokenId,
                    bytes calldata data
                ) external returns (bytes4);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/utils/ERC1155Receiver.sol)
            pragma solidity ^0.8.0;
            import "../IERC1155Receiver.sol";
            import "../../../utils/introspection/ERC165.sol";
            /**
             * @dev _Available since v3.1._
             */
            abstract contract ERC1155Receiver is ERC165, IERC1155Receiver {
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
                    return interfaceId == type(IERC1155Receiver).interfaceId || super.supportsInterface(interfaceId);
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/Address.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Collection of functions related to the address type
             */
            library Address {
                /**
                 * @dev Returns true if `account` is a contract.
                 *
                 * [IMPORTANT]
                 * ====
                 * It is unsafe to assume that an address for which this function returns
                 * false is an externally-owned account (EOA) and not a contract.
                 *
                 * Among others, `isContract` will return false for the following
                 * types of addresses:
                 *
                 *  - an externally-owned account
                 *  - a contract in construction
                 *  - an address where a contract will be created
                 *  - an address where a contract lived, but was destroyed
                 * ====
                 */
                function isContract(address account) internal view returns (bool) {
                    // This method relies on extcodesize, which returns 0 for contracts in
                    // construction, since the code is only stored at the end of the
                    // constructor execution.
                    uint256 size;
                    assembly {
                        size := extcodesize(account)
                    }
                    return size > 0;
                }
                /**
                 * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                 * `recipient`, forwarding all available gas and reverting on errors.
                 *
                 * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                 * of certain opcodes, possibly making contracts go over the 2300 gas limit
                 * imposed by `transfer`, making them unable to receive funds via
                 * `transfer`. {sendValue} removes this limitation.
                 *
                 * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                 *
                 * IMPORTANT: because control is transferred to `recipient`, care must be
                 * taken to not create reentrancy vulnerabilities. Consider using
                 * {ReentrancyGuard} or the
                 * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                 */
                function sendValue(address payable recipient, uint256 amount) internal {
                    require(address(this).balance >= amount, "Address: insufficient balance");
                    (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
                            assembly {
                                let returndata_size := mload(returndata)
                                revert(add(32, returndata), returndata_size)
                            }
                        } else {
                            revert(errorMessage);
                        }
                    }
                }
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
            pragma solidity ^0.8.0;
            /**
             * @dev Interface of the ERC165 standard, as defined in the
             * https://eips.ethereum.org/EIPS/eip-165[EIP].
             *
             * Implementers can declare support of contract interfaces, which can then be
             * queried by others ({ERC165Checker}).
             *
             * For an implementation, see {ERC165}.
             */
            interface IERC165 {
                /**
                 * @dev Returns true if this contract implements the interface defined by
                 * `interfaceId`. See the corresponding
                 * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
                 * to learn more about how these ids are created.
                 *
                 * This function call must use less than 30 000 gas.
                 */
                function supportsInterface(bytes4 interfaceId) external view returns (bool);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (token/ERC1155/IERC1155Receiver.sol)
            pragma solidity ^0.8.0;
            import "../../utils/introspection/IERC165.sol";
            /**
             * @dev _Available since v3.1._
             */
            interface IERC1155Receiver is IERC165 {
                /**
                    @dev Handles the receipt of a single ERC1155 token type. This function is
                    called at the end of a `safeTransferFrom` after the balance has been updated.
                    To accept the transfer, this must return
                    `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
                    (i.e. 0xf23a6e61, or its own function selector).
                    @param operator The address which initiated the transfer (i.e. msg.sender)
                    @param from The address which previously owned the token
                    @param id The ID of the token being transferred
                    @param value The amount of tokens being transferred
                    @param data Additional data with no specified format
                    @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
                */
                function onERC1155Received(
                    address operator,
                    address from,
                    uint256 id,
                    uint256 value,
                    bytes calldata data
                ) external returns (bytes4);
                /**
                    @dev Handles the receipt of a multiple ERC1155 token types. This function
                    is called at the end of a `safeBatchTransferFrom` after the balances have
                    been updated. To accept the transfer(s), this must return
                    `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
                    (i.e. 0xbc197c81, or its own function selector).
                    @param operator The address which initiated the batch transfer (i.e. msg.sender)
                    @param from The address which previously owned the token
                    @param ids An array containing ids of each token being transferred (order and length must match values array)
                    @param values An array containing amounts of each token being transferred (order and length must match ids array)
                    @param data Additional data with no specified format
                    @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
                */
                function onERC1155BatchReceived(
                    address operator,
                    address from,
                    uint256[] calldata ids,
                    uint256[] calldata values,
                    bytes calldata data
                ) external returns (bytes4);
            }
            // SPDX-License-Identifier: MIT
            // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
            pragma solidity ^0.8.0;
            import "./IERC165.sol";
            /**
             * @dev Implementation of the {IERC165} interface.
             *
             * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
             * for the additional interface id that will be supported. For example:
             *
             * ```solidity
             * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
             *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
             * }
             * ```
             *
             * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
             */
            abstract contract ERC165 is IERC165 {
                /**
                 * @dev See {IERC165-supportsInterface}.
                 */
                function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                    return interfaceId == type(IERC165).interfaceId;
                }
            }