ETH Price: $2,623.25 (+3.52%)

Transaction Decoder

Block:
22299172 at Apr-18-2025 11:29:11 PM +UTC
Transaction Fee:
0.00039938887754311 ETH $1.05
Gas Used:
300,235 Gas / 1.330254226 Gwei

Emitted Events:

40 WalletSimple.Deposited( from=Forwarder, value=8342150000000000, data=0x )
41 Forwarder.ForwarderDeposited( from=[Receiver] 0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43, value=8342150000000000, data=0x )

Account State Difference:

  Address   Before After State Difference Code
0x02E10558...537620149 6.421576846512771 Eth6.840165536512771 Eth0.41858869
0x0CCcD1AE...fb8F999C2 0 Eth0.00418484 Eth0.00418484
0x12D4df47...e4dB88414 0.00000128810871 Eth0.33137046810871 Eth0.33136918
0x1746768D...35d92A20a 0.13491433 Eth0.19723767 Eth0.06232334
0x17AeD821...a486136D2 0 Eth0.02270158 Eth0.02270158
0x1B4e9b03...6eCFbEd2B 0.10892652 Eth0.12204525 Eth0.01311873
0x1D5537c1...1c335b01D 0.30900503813034362 Eth0.43493019813034362 Eth0.12592516
0x244d73B9...5AB017B60 0.000024808835698532 Eth0.0000729995 Eth0.000048190664301468
0x257387fa...eE3334a38 0.000437990075417641 Eth0.031913140075417641 Eth0.03147515
0x3405ce3A...203b21303 0.125075434937323724 Eth2.256809984937323724 Eth2.13173455
0x47D166f5...04A2b897b 0.30705469 Eth0.49058541 Eth0.18353072
(Titan Builder)
10.192959522731920548 Eth10.193259757731920548 Eth0.000300235
0x5F54d5bc...9bC23711a 0.01466165349031797 Eth0.32947355349031797 Eth0.3148119
0x71Bd95E1...a51752055 0.439701387820576227 Eth1.686162857820576227 Eth1.24646147
0x7830c87C...31FA86F43
(Coinbase: Deposit)
42.10332243465174147 Eth
Nonce: 2308686
42.10292304577419836 Eth
Nonce: 2308687
0.00039938887754311
0x7C5b268d...2150D6168 0.00000151892685 Eth0.55086511892685 Eth0.5508636
0x8B2Cf9E5...d4179e660 0.008685594706658495 Eth0.638243994706658495 Eth0.6295584
0x8c49E061...FFFDad594 0 Eth0.01259038 Eth0.01259038
0xa5Da0A24...E07bAee50 1.2601980654020103 Eth1.7450083954020103 Eth0.48481033
0xA9D1e08C...FB81d3E43
(Coinbase 10)
18,943.15704680063208731 Eth18,932.370841103467785842 Eth10.786205697164301468
0xbc2B271c...13AB01722 34.08922345459985566 Eth37.32863790459985566 Eth3.23941445
0xbc7B4d90...8FAA2ac67 0.08855439110840726 Eth1.05967969110840726 Eth0.9711253
0xC382cf87...FE1525fE8 0.049109168652 Eth0.052256678652 Eth0.00314751
0xc55eDe66...8b3B2DcFa 56.811036852852335743 Eth56.819379002852335743 Eth0.00834215
0xEae5b176...39735D546
0 Eth
Nonce: 0
0.0000800765 Eth
Nonce: 0
0.0000800765From: 0 To: 0

Execution Trace

Coinbase 10.1a1da075( )
  • ETH 0.48481033 0xa5da0a24ee014c092a39d1c102dff52e07baee50.CALL( )
  • ETH 0.12592516 0x1d5537c115e5afdb3897752e53a96361c335b01d.CALL( )
  • ETH 0.3148119 0x5f54d5bcac9c2e1288e38fe82b2a7689bc23711a.CALL( )
  • ETH 0.02270158 0x17aed8218900ae98e1c8d9bcde5680ea486136d2.CALL( )
  • ETH 0.41858869 0x02e105584f79a2bb496e8915f140c4e537620149.CALL( )
  • ETH 0.06232334 0x1746768dcded5c8f34155a058fda21435d92a20a.CALL( )
  • ETH 0.00418484 0x0cccd1aedf616f19d739826c793c1dffb8f999c2.CALL( )
  • ETH 0.5508636 0x7c5b268d77294a90f591f9efc9952df2150d6168.CALL( )
  • ETH 0.6295584 0x8b2cf9e509ca084948c4ac37caa57fdd4179e660.CALL( )
  • ETH 0.01259038 0x8c49e0610c9420f918dcd5581bbe96dfffdad594.CALL( )
  • ETH 0.00314751 0xc382cf8736265108a5c222bb93eb0b2fe1525fe8.CALL( )
  • ETH 0.01311873 0x1b4e9b0362fa55fdc6ab716c78c9bfe6ecfbed2b.CALL( )
  • ETH 0.0000800765 0xeae5b17644188e2df85bc118b27b31b39735d546.CALL( )
  • ETH 0.33136918 0x12d4df47812270dba58c80af24035e8e4db88414.CALL( )
  • ETH 2.13173455 0x3405ce3a97eb67650330af4e90870ca203b21303.CALL( )
  • ETH 0.00834215 Forwarder.CALL( )
    • ETH 0.00834215 Forwarder.DELEGATECALL( )
      • ETH 0.00834215 WalletSimple.CALL( )
        • ETH 0.00834215 WalletSimple.DELEGATECALL( )
        • ETH 1.24646147 0x71bd95e1ea895ca304d55ebaac561dfa51752055.CALL( )
        • ETH 3.23941445 0xbc2b271c64dfaefe6fc8263b4335a0d13ab01722.CALL( )
        • ETH 0.9711253 0xbc7b4d90b4dca5f05490f59962564e78faa2ac67.CALL( )
        • ETH 0.18353072 0x47d166f5e0c0fb46dba97fa2c1e840804a2b897b.CALL( )
        • ETH 0.000048190664301468 0x244d73b925ec18cc5fef8bf0458ecf85ab017b60.CALL( )
        • ETH 0.03147515 0x257387fa61795060918f9c1ec9e913dee3334a38.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;
              }
          }