ETH Price: $1,955.20 (+6.46%)

Transaction Decoder

Block:
22175971 at Apr-01-2025 06:53:11 PM +UTC
Transaction Fee:
0.000694702665743663 ETH $1.36
Gas Used:
331,063 Gas / 2.098400201 Gwei

Emitted Events:

102 WalletSimple.Deposited( from=Forwarder, value=13637720000000000, data=0x )
103 Forwarder.ForwarderDeposited( from=[Receiver] 0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43, value=13637720000000000, data=0x )

Account State Difference:

  Address   Before After State Difference Code
0x0168d103...b359Bab45 0.000000950886468 Eth0.027434160886468 Eth0.02743321
0x0b7c9173...9eD5C8354 0.00000055 Eth0.00299094 Eth0.00299039
0x1a58D408...93ab1E13e 0.000041920926532624 Eth0.00015027025 Eth0.000108349323467376
0x1f49291C...36Ff56943 0.02200026 Eth0.03250844 Eth0.01050818
0x21e24341...10734bf89 0.000065329999392 Eth0.153796749999392 Eth0.15373142
0x3Af9EC8D...EFFEaB6B3 0 Eth0.03752955 Eth0.03752955
(Titan Builder)
9.437141888017324364 Eth9.437472951017324364 Eth0.000331063
0x4baC6243...19f90aa34 0.490675752964472558 Eth0.590471692964472558 Eth0.09979594
0x5231f792...B076e48d0 0.000007791430962 Eth0.010512631430962 Eth0.01050484
0x5ab9ac1e...39Fe7237a 0.02578168 Eth0.06809703 Eth0.04231535
0x6e0174D6...708C97076 0.00681133 Eth0.0131139 Eth0.00630257
0x7147990f...896e087E5 0.000034605701774935 Eth0.033390595701774935 Eth0.03335599
0x752c420A...76b664A8d 0.17395139 Eth0.22590117 Eth0.05194978
0x7830c87C...31FA86F43
(Coinbase: Deposit)
92.249172054748329166 Eth
Nonce: 2263109
92.248477352082585503 Eth
Nonce: 2263110
0.000694702665743663
0x80AE0a90...b72a19848 0.030784500698014581 Eth0.064579700698014581 Eth0.0337952
0x838B027C...E9d16bf03 6.058796698977138057 Eth6.155485978977138057 Eth0.09668928
0x87B5D1cD...E061AbdcC 0.2964 Eth0.32265492 Eth0.02625492
0x8A9eB18E...E6c34Bb01 0.38651812 Eth0.44069427 Eth0.05417615
0x97Bcaa99...b88DCf51a 0.000058432572762414 Eth0.00015027025 Eth0.000091837677237586
0x99Abe738...9F72b64C7 0.009264031626950128 Eth0.484264031626950128 Eth0.475
0x9b8821fa...5BC3f100F
0 Eth
Nonce: 0
0.00014479725 Eth
Nonce: 0
0.00014479725From: 0 To: 0
0xA257920c...4DcD64F68 0.433818761927320871 Eth0.435826641927320871 Eth0.00200788
0xA2938181...5Bf257A44 4.810881050680559216 Eth4.824518770680559216 Eth0.01363772
0xA9D1e08C...FB81d3E43
(Coinbase 10)
3,305.635107167007304278 Eth3,304.367258492756599316 Eth1.267848674250704962
0xC620d420...DdFfB24F6 0.06785382 Eth0.07637352 Eth0.0085197
0xd7ABDAc8...1c977E88E 0 Eth0.0524 Eth0.0524
0xe16FCbbC...C172d4F87 0.000032400192258 Eth0.002054380192258 Eth0.00202198
0xfFCc9905...fd16E916d 0.10225958 Eth0.12884322 Eth0.02658364

Execution Trace

Coinbase 10.1a1da075( )
  • ETH 0.00299039 0x0b7c91734c21e66e08469799d734a399ed5c8354.CALL( )
  • ETH 0.0524 0xd7abdac8062f5ee2b815805a27b30fb1c977e88e.CALL( )
  • ETH 0.0085197 0xc620d420f3d2187e8db4cde4b7043dcddffb24f6.CALL( )
  • ETH 0.09668928 0x838b027c4cc987e806032b5b37dcd21e9d16bf03.CALL( )
  • ETH 0.0337952 0x80ae0a9059d34e5553289591ed87c0eb72a19848.CALL( )
  • ETH 0.00014479725 0x9b8821fad0b9bd5f8024e59ac9da9205bc3f100f.CALL( )
  • ETH 0.04231535 0x5ab9ac1e92626c1ad9d8bfbde65e53d39fe7237a.CALL( )
  • ETH 0.02625492 0x87b5d1cd780009686bea5e7983ad987e061abdcc.CALL( )
  • ETH 0.15373142 0x21e243416db99888a8797812ee0bee510734bf89.CALL( )
  • ETH 0.05417615 0x8a9eb18e3a6f8e4289ce0eff6b8befee6c34bb01.CALL( )
  • ETH 0.475 0x99abe738c6648337ee30bd2596627a09f72b64c7.CALL( )
  • ETH 0.03752955 0x3af9ec8d955a5339441ba6badf21f44effeab6b3.CALL( )
  • ETH 0.000091837677237586 0x97bcaa99cb2af0affc8a024d286611bb88dcf51a.CALL( )
  • ETH 0.000108349323467376 0x1a58d408c4059c745d33617bcfebbc293ab1e13e.CALL( )
  • ETH 0.01363772 Forwarder.CALL( )
    • ETH 0.01363772 Forwarder.DELEGATECALL( )
      • ETH 0.01363772 WalletSimple.CALL( )
        • ETH 0.01363772 WalletSimple.DELEGATECALL( )
        • ETH 0.02743321 0x0168d103836cd2ca39de2f3b47b381fb359bab45.CALL( )
        • ETH 0.05194978 0x752c420a0edf8aa97721a60da0dba6776b664a8d.CALL( )
        • ETH 0.01050484 0x5231f792beb9d6b8462e890af25c7a6b076e48d0.CALL( )
        • ETH 0.03335599 0x7147990f18e0c8aca38f19c8730b55f896e087e5.CALL( )
        • ETH 0.00200788 0xa257920cf413065387e4221401ad1c24dcd64f68.CALL( )
        • ETH 0.01050818 0x1f49291c6c7303c90245087578a45d036ff56943.CALL( )
        • ETH 0.00630257 0x6e0174d6c7083c57248d017af8f2b9a708c97076.CALL( )
        • ETH 0.02658364 0xffcc9905e55d9df836e84f8d684164ffd16e916d.CALL( )
        • ETH 0.09979594 0x4bac6243348ccaed7c11d130dffd2ef19f90aa34.CALL( )
        • ETH 0.00202198 0xe16fcbbce2a98347907a3b6bbadfd08c172d4f87.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;
              }
          }