ETH Price: $2,063.46 (-4.65%)

Transaction Decoder

Block:
23980146 at Dec-10-2025 05:09:11 AM +UTC
Transaction Fee:
0.000010041526287639 ETH $0.02
Gas Used:
53,361 Gas / 0.188180999 Gwei

Account State Difference:

  Address   Before After State Difference Code
(Fee Recipient: 0x10ed...18d)
0.295599124608857591 Eth0.295599247339157591 Eth0.0000001227303
0x29d80469...daC84b03a
1.670983062461019374 Eth
Nonce: 10340
1.670973020934731735 Eth
Nonce: 10341
0.000010041526287639
0xdAC17F95...13D831ec7

Execution Trace

0x889e60fe23071704a9994bc7903f4a08183be0c5.3ef13367( )
  • ForwarderV4.flushTokens( tokenContractAddress=0xdAC17F958D2ee523a2206206994597C13D831ec7 )
    • TetherToken.balanceOf( who=0x889E60fe23071704a9994bc7903F4a08183Be0C5 ) => ( 1499000000 )
    • TetherToken.transfer( _to=0xDD387c1d3804d92cc47ab1E809bb7a611c66EA22, _value=1499000000 )
      File 1 of 2: TetherToken
      pragma solidity ^0.4.17;
      
      /**
       * @title SafeMath
       * @dev Math operations with safety checks that throw on error
       */
      library SafeMath {
          function mul(uint256 a, uint256 b) internal pure returns (uint256) {
              if (a == 0) {
                  return 0;
              }
              uint256 c = a * b;
              assert(c / a == b);
              return c;
          }
      
          function div(uint256 a, uint256 b) internal pure returns (uint256) {
              // assert(b > 0); // Solidity automatically throws when dividing by 0
              uint256 c = a / b;
              // assert(a == b * c + a % b); // There is no case in which this doesn't hold
              return c;
          }
      
          function sub(uint256 a, uint256 b) internal pure returns (uint256) {
              assert(b <= a);
              return a - b;
          }
      
          function add(uint256 a, uint256 b) internal pure returns (uint256) {
              uint256 c = a + b;
              assert(c >= a);
              return c;
          }
      }
      
      /**
       * @title Ownable
       * @dev The Ownable contract has an owner address, and provides basic authorization control
       * functions, this simplifies the implementation of "user permissions".
       */
      contract Ownable {
          address public owner;
      
          /**
            * @dev The Ownable constructor sets the original `owner` of the contract to the sender
            * account.
            */
          function Ownable() public {
              owner = msg.sender;
          }
      
          /**
            * @dev Throws if called by any account other than the owner.
            */
          modifier onlyOwner() {
              require(msg.sender == owner);
              _;
          }
      
          /**
          * @dev Allows the current owner to transfer control of the contract to a newOwner.
          * @param newOwner The address to transfer ownership to.
          */
          function transferOwnership(address newOwner) public onlyOwner {
              if (newOwner != address(0)) {
                  owner = newOwner;
              }
          }
      
      }
      
      /**
       * @title ERC20Basic
       * @dev Simpler version of ERC20 interface
       * @dev see https://github.com/ethereum/EIPs/issues/20
       */
      contract ERC20Basic {
          uint public _totalSupply;
          function totalSupply() public constant returns (uint);
          function balanceOf(address who) public constant returns (uint);
          function transfer(address to, uint value) public;
          event Transfer(address indexed from, address indexed to, uint value);
      }
      
      /**
       * @title ERC20 interface
       * @dev see https://github.com/ethereum/EIPs/issues/20
       */
      contract ERC20 is ERC20Basic {
          function allowance(address owner, address spender) public constant returns (uint);
          function transferFrom(address from, address to, uint value) public;
          function approve(address spender, uint value) public;
          event Approval(address indexed owner, address indexed spender, uint value);
      }
      
      /**
       * @title Basic token
       * @dev Basic version of StandardToken, with no allowances.
       */
      contract BasicToken is Ownable, ERC20Basic {
          using SafeMath for uint;
      
          mapping(address => uint) public balances;
      
          // additional variables for use if transaction fees ever became necessary
          uint public basisPointsRate = 0;
          uint public maximumFee = 0;
      
          /**
          * @dev Fix for the ERC20 short address attack.
          */
          modifier onlyPayloadSize(uint size) {
              require(!(msg.data.length < size + 4));
              _;
          }
      
          /**
          * @dev transfer token for a specified address
          * @param _to The address to transfer to.
          * @param _value The amount to be transferred.
          */
          function transfer(address _to, uint _value) public onlyPayloadSize(2 * 32) {
              uint fee = (_value.mul(basisPointsRate)).div(10000);
              if (fee > maximumFee) {
                  fee = maximumFee;
              }
              uint sendAmount = _value.sub(fee);
              balances[msg.sender] = balances[msg.sender].sub(_value);
              balances[_to] = balances[_to].add(sendAmount);
              if (fee > 0) {
                  balances[owner] = balances[owner].add(fee);
                  Transfer(msg.sender, owner, fee);
              }
              Transfer(msg.sender, _to, sendAmount);
          }
      
          /**
          * @dev Gets the balance of the specified address.
          * @param _owner The address to query the the balance of.
          * @return An uint representing the amount owned by the passed address.
          */
          function balanceOf(address _owner) public constant returns (uint balance) {
              return balances[_owner];
          }
      
      }
      
      /**
       * @title Standard ERC20 token
       *
       * @dev Implementation of the basic standard token.
       * @dev https://github.com/ethereum/EIPs/issues/20
       * @dev Based oncode by FirstBlood: https://github.com/Firstbloodio/token/blob/master/smart_contract/FirstBloodToken.sol
       */
      contract StandardToken is BasicToken, ERC20 {
      
          mapping (address => mapping (address => uint)) public allowed;
      
          uint public constant MAX_UINT = 2**256 - 1;
      
          /**
          * @dev Transfer tokens from one address to another
          * @param _from address The address which you want to send tokens from
          * @param _to address The address which you want to transfer to
          * @param _value uint the amount of tokens to be transferred
          */
          function transferFrom(address _from, address _to, uint _value) public onlyPayloadSize(3 * 32) {
              var _allowance = allowed[_from][msg.sender];
      
              // Check is not needed because sub(_allowance, _value) will already throw if this condition is not met
              // if (_value > _allowance) throw;
      
              uint fee = (_value.mul(basisPointsRate)).div(10000);
              if (fee > maximumFee) {
                  fee = maximumFee;
              }
              if (_allowance < MAX_UINT) {
                  allowed[_from][msg.sender] = _allowance.sub(_value);
              }
              uint sendAmount = _value.sub(fee);
              balances[_from] = balances[_from].sub(_value);
              balances[_to] = balances[_to].add(sendAmount);
              if (fee > 0) {
                  balances[owner] = balances[owner].add(fee);
                  Transfer(_from, owner, fee);
              }
              Transfer(_from, _to, sendAmount);
          }
      
          /**
          * @dev Approve the passed address to spend the specified amount of tokens on behalf of msg.sender.
          * @param _spender The address which will spend the funds.
          * @param _value The amount of tokens to be spent.
          */
          function approve(address _spender, uint _value) public onlyPayloadSize(2 * 32) {
      
              // To change the approve amount you first have to reduce the addresses`
              //  allowance to zero by calling `approve(_spender, 0)` if it is not
              //  already 0 to mitigate the race condition described here:
              //  https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
              require(!((_value != 0) && (allowed[msg.sender][_spender] != 0)));
      
              allowed[msg.sender][_spender] = _value;
              Approval(msg.sender, _spender, _value);
          }
      
          /**
          * @dev Function to check the amount of tokens than an owner allowed to a spender.
          * @param _owner address The address which owns the funds.
          * @param _spender address The address which will spend the funds.
          * @return A uint specifying the amount of tokens still available for the spender.
          */
          function allowance(address _owner, address _spender) public constant returns (uint remaining) {
              return allowed[_owner][_spender];
          }
      
      }
      
      
      /**
       * @title Pausable
       * @dev Base contract which allows children to implement an emergency stop mechanism.
       */
      contract Pausable is Ownable {
        event Pause();
        event Unpause();
      
        bool public paused = false;
      
      
        /**
         * @dev Modifier to make a function callable only when the contract is not paused.
         */
        modifier whenNotPaused() {
          require(!paused);
          _;
        }
      
        /**
         * @dev Modifier to make a function callable only when the contract is paused.
         */
        modifier whenPaused() {
          require(paused);
          _;
        }
      
        /**
         * @dev called by the owner to pause, triggers stopped state
         */
        function pause() onlyOwner whenNotPaused public {
          paused = true;
          Pause();
        }
      
        /**
         * @dev called by the owner to unpause, returns to normal state
         */
        function unpause() onlyOwner whenPaused public {
          paused = false;
          Unpause();
        }
      }
      
      contract BlackList is Ownable, BasicToken {
      
          /////// Getters to allow the same blacklist to be used also by other contracts (including upgraded Tether) ///////
          function getBlackListStatus(address _maker) external constant returns (bool) {
              return isBlackListed[_maker];
          }
      
          function getOwner() external constant returns (address) {
              return owner;
          }
      
          mapping (address => bool) public isBlackListed;
          
          function addBlackList (address _evilUser) public onlyOwner {
              isBlackListed[_evilUser] = true;
              AddedBlackList(_evilUser);
          }
      
          function removeBlackList (address _clearedUser) public onlyOwner {
              isBlackListed[_clearedUser] = false;
              RemovedBlackList(_clearedUser);
          }
      
          function destroyBlackFunds (address _blackListedUser) public onlyOwner {
              require(isBlackListed[_blackListedUser]);
              uint dirtyFunds = balanceOf(_blackListedUser);
              balances[_blackListedUser] = 0;
              _totalSupply -= dirtyFunds;
              DestroyedBlackFunds(_blackListedUser, dirtyFunds);
          }
      
          event DestroyedBlackFunds(address _blackListedUser, uint _balance);
      
          event AddedBlackList(address _user);
      
          event RemovedBlackList(address _user);
      
      }
      
      contract UpgradedStandardToken is StandardToken{
          // those methods are called by the legacy contract
          // and they must ensure msg.sender to be the contract address
          function transferByLegacy(address from, address to, uint value) public;
          function transferFromByLegacy(address sender, address from, address spender, uint value) public;
          function approveByLegacy(address from, address spender, uint value) public;
      }
      
      contract TetherToken is Pausable, StandardToken, BlackList {
      
          string public name;
          string public symbol;
          uint public decimals;
          address public upgradedAddress;
          bool public deprecated;
      
          //  The contract can be initialized with a number of tokens
          //  All the tokens are deposited to the owner address
          //
          // @param _balance Initial supply of the contract
          // @param _name Token Name
          // @param _symbol Token symbol
          // @param _decimals Token decimals
          function TetherToken(uint _initialSupply, string _name, string _symbol, uint _decimals) public {
              _totalSupply = _initialSupply;
              name = _name;
              symbol = _symbol;
              decimals = _decimals;
              balances[owner] = _initialSupply;
              deprecated = false;
          }
      
          // Forward ERC20 methods to upgraded contract if this one is deprecated
          function transfer(address _to, uint _value) public whenNotPaused {
              require(!isBlackListed[msg.sender]);
              if (deprecated) {
                  return UpgradedStandardToken(upgradedAddress).transferByLegacy(msg.sender, _to, _value);
              } else {
                  return super.transfer(_to, _value);
              }
          }
      
          // Forward ERC20 methods to upgraded contract if this one is deprecated
          function transferFrom(address _from, address _to, uint _value) public whenNotPaused {
              require(!isBlackListed[_from]);
              if (deprecated) {
                  return UpgradedStandardToken(upgradedAddress).transferFromByLegacy(msg.sender, _from, _to, _value);
              } else {
                  return super.transferFrom(_from, _to, _value);
              }
          }
      
          // Forward ERC20 methods to upgraded contract if this one is deprecated
          function balanceOf(address who) public constant returns (uint) {
              if (deprecated) {
                  return UpgradedStandardToken(upgradedAddress).balanceOf(who);
              } else {
                  return super.balanceOf(who);
              }
          }
      
          // Forward ERC20 methods to upgraded contract if this one is deprecated
          function approve(address _spender, uint _value) public onlyPayloadSize(2 * 32) {
              if (deprecated) {
                  return UpgradedStandardToken(upgradedAddress).approveByLegacy(msg.sender, _spender, _value);
              } else {
                  return super.approve(_spender, _value);
              }
          }
      
          // Forward ERC20 methods to upgraded contract if this one is deprecated
          function allowance(address _owner, address _spender) public constant returns (uint remaining) {
              if (deprecated) {
                  return StandardToken(upgradedAddress).allowance(_owner, _spender);
              } else {
                  return super.allowance(_owner, _spender);
              }
          }
      
          // deprecate current contract in favour of a new one
          function deprecate(address _upgradedAddress) public onlyOwner {
              deprecated = true;
              upgradedAddress = _upgradedAddress;
              Deprecate(_upgradedAddress);
          }
      
          // deprecate current contract if favour of a new one
          function totalSupply() public constant returns (uint) {
              if (deprecated) {
                  return StandardToken(upgradedAddress).totalSupply();
              } else {
                  return _totalSupply;
              }
          }
      
          // Issue a new amount of tokens
          // these tokens are deposited into the owner address
          //
          // @param _amount Number of tokens to be issued
          function issue(uint amount) public onlyOwner {
              require(_totalSupply + amount > _totalSupply);
              require(balances[owner] + amount > balances[owner]);
      
              balances[owner] += amount;
              _totalSupply += amount;
              Issue(amount);
          }
      
          // Redeem tokens.
          // These tokens are withdrawn from the owner address
          // if the balance must be enough to cover the redeem
          // or the call will fail.
          // @param _amount Number of tokens to be issued
          function redeem(uint amount) public onlyOwner {
              require(_totalSupply >= amount);
              require(balances[owner] >= amount);
      
              _totalSupply -= amount;
              balances[owner] -= amount;
              Redeem(amount);
          }
      
          function setParams(uint newBasisPoints, uint newMaxFee) public onlyOwner {
              // Ensure transparency by hardcoding limit beyond which fees can never be added
              require(newBasisPoints < 20);
              require(newMaxFee < 50);
      
              basisPointsRate = newBasisPoints;
              maximumFee = newMaxFee.mul(10**decimals);
      
              Params(basisPointsRate, maximumFee);
          }
      
          // Called when new token are issued
          event Issue(uint amount);
      
          // Called when tokens are redeemed
          event Redeem(uint amount);
      
          // Called when contract is deprecated
          event Deprecate(address newAddress);
      
          // Called if contract ever adds fees
          event Params(uint feeBasisPoints, uint maxFee);
      }

      File 2 of 2: ForwarderV4
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/IERC1155.sol)
      pragma solidity ^0.8.20;
      import {IERC165} from "../../utils/introspection/IERC165.sol";
      /**
       * @dev Required interface of an ERC1155 compliant contract, as defined in the
       * https://eips.ethereum.org/EIPS/eip-1155[EIP].
       */
      interface IERC1155 is IERC165 {
          /**
           * @dev Emitted when `value` amount of tokens of 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 value 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 a `value` amount of tokens of type `id` from `from` to `to`.
           *
           * WARNING: This function can potentially allow a reentrancy attack when transferring tokens
           * to an untrusted contract, when invoking {onERC1155Received} on the receiver.
           * Ensure to follow the checks-effects-interactions pattern and consider employing
           * reentrancy guards when interacting with untrusted contracts.
           *
           * Emits a {TransferSingle} event.
           *
           * Requirements:
           *
           * - `to` cannot be the zero address.
           * - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
           * - `from` must have a balance of tokens of type `id` of at least `value` 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 value, bytes calldata data) external;
          /**
           * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
           *
           *
           * WARNING: This function can potentially allow a reentrancy attack when transferring tokens
           * to an untrusted contract, when invoking {onERC1155BatchReceived} on the receiver.
           * Ensure to follow the checks-effects-interactions pattern and consider employing
           * reentrancy guards when interacting with untrusted contracts.
           *
           * Emits a {TransferBatch} event.
           *
           * Requirements:
           *
           * - `ids` and `values` 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 values,
              bytes calldata data
          ) external;
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/IERC1155Receiver.sol)
      pragma solidity ^0.8.20;
      import {IERC165} from "../../utils/introspection/IERC165.sol";
      /**
       * @dev Interface that must be implemented by smart contracts in order to receive
       * ERC-1155 token transfers.
       */
      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.
           *
           * NOTE: 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.
           *
           * NOTE: 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 (last updated v5.0.0) (token/ERC1155/utils/ERC1155Holder.sol)
      pragma solidity ^0.8.20;
      import {IERC165, ERC165} from "../../../utils/introspection/ERC165.sol";
      import {IERC1155Receiver} from "../IERC1155Receiver.sol";
      /**
       * @dev Simple implementation of `IERC1155Receiver` that will allow a contract to hold ERC1155 tokens.
       *
       * IMPORTANT: When inheriting this contract, you must include a way to use the received tokens, otherwise they will be
       * stuck.
       */
      abstract contract ERC1155Holder 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);
          }
          function onERC1155Received(
              address,
              address,
              uint256,
              uint256,
              bytes memory
          ) public virtual override returns (bytes4) {
              return this.onERC1155Received.selector;
          }
          function onERC1155BatchReceived(
              address,
              address,
              uint256[] memory,
              uint256[] memory,
              bytes memory
          ) public virtual override returns (bytes4) {
              return this.onERC1155BatchReceived.selector;
          }
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/IERC721.sol)
      pragma solidity ^0.8.20;
      import {IERC165} from "../../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`.
           *
           * 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;
          /**
           * @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 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: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
           * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
           * understand this adds an external call which potentially creates a reentrancy vulnerability.
           *
           * 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 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 address zero.
           *
           * Emits an {ApprovalForAll} event.
           */
          function setApprovalForAll(address operator, bool approved) external;
          /**
           * @dev Returns the account approved for `tokenId` token.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           */
          function getApproved(uint256 tokenId) external view returns (address operator);
          /**
           * @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);
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/IERC721Receiver.sol)
      pragma solidity ^0.8.20;
      /**
       * @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 `IERC721Receiver.onERC721Received.selector`.
           */
          function onERC721Received(
              address operator,
              address from,
              uint256 tokenId,
              bytes calldata data
          ) external returns (bytes4);
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol)
      pragma solidity ^0.8.20;
      /**
       * @dev Collection of functions related to the address type
       */
      library Address {
          /**
           * @dev The ETH balance of the account is not enough to perform the operation.
           */
          error AddressInsufficientBalance(address account);
          /**
           * @dev There's no code at `target` (it is not a contract).
           */
          error AddressEmptyCode(address target);
          /**
           * @dev A call to an address target failed. The target may have reverted.
           */
          error FailedInnerCall();
          /**
           * @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://consensys.net/diligence/blog/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.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
           */
          function sendValue(address payable recipient, uint256 amount) internal {
              if (address(this).balance < amount) {
                  revert AddressInsufficientBalance(address(this));
              }
              (bool success, ) = recipient.call{value: amount}("");
              if (!success) {
                  revert FailedInnerCall();
              }
          }
          /**
           * @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 or custom error, it is bubbled
           * up by this function (like regular Solidity function calls). However, if
           * the call reverted with no returned reason, this function reverts with a
           * {FailedInnerCall} error.
           *
           * 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.
           */
          function functionCall(address target, bytes memory data) internal returns (bytes memory) {
              return functionCallWithValue(target, data, 0);
          }
          /**
           * @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`.
           */
          function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
              if (address(this).balance < value) {
                  revert AddressInsufficientBalance(address(this));
              }
              (bool success, bytes memory returndata) = target.call{value: value}(data);
              return verifyCallResultFromTarget(target, success, returndata);
          }
          /**
           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
           * but performing a static call.
           */
          function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
              (bool success, bytes memory returndata) = target.staticcall(data);
              return verifyCallResultFromTarget(target, success, returndata);
          }
          /**
           * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
           * but performing a delegate call.
           */
          function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
              (bool success, bytes memory returndata) = target.delegatecall(data);
              return verifyCallResultFromTarget(target, success, returndata);
          }
          /**
           * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target
           * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an
           * unsuccessful call.
           */
          function verifyCallResultFromTarget(
              address target,
              bool success,
              bytes memory returndata
          ) internal view returns (bytes memory) {
              if (!success) {
                  _revert(returndata);
              } else {
                  // only check if target is a contract if the call was successful and the return data is empty
                  // otherwise we already know that it was a contract
                  if (returndata.length == 0 && target.code.length == 0) {
                      revert AddressEmptyCode(target);
                  }
                  return returndata;
              }
          }
          /**
           * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the
           * revert reason or with a default {FailedInnerCall} error.
           */
          function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {
              if (!success) {
                  _revert(returndata);
              } else {
                  return returndata;
              }
          }
          /**
           * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}.
           */
          function _revert(bytes memory returndata) private pure {
              // Look for revert reason and bubble it up if present
              if (returndata.length > 0) {
                  // The easiest way to bubble the revert reason is using memory via assembly
                  /// @solidity memory-safe-assembly
                  assembly {
                      let returndata_size := mload(returndata)
                      revert(add(32, returndata), returndata_size)
                  }
              } else {
                  revert FailedInnerCall();
              }
          }
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/ERC165.sol)
      pragma solidity ^0.8.20;
      import {IERC165} from "./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);
       * }
       * ```
       */
      abstract contract ERC165 is IERC165 {
          /**
           * @dev See {IERC165-supportsInterface}.
           */
          function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
              return interfaceId == type(IERC165).interfaceId;
          }
      }
      // SPDX-License-Identifier: MIT
      // OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol)
      pragma solidity ^0.8.20;
      /**
       * @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: UNLICENSED
      pragma solidity 0.8.20;
      /**
       * 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
          view
          virtual
          returns (uint256 balance);
      }
      // SPDX-License-Identifier: Apache-2.0
      pragma solidity 0.8.20;
      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/ERC1155Holder.sol';
      import './ERC20Interface.sol';
      import './TransferHelper.sol';
      import './IForwarderV4.sol';
      /**
       * @title ForwarderV4
       * @notice This contract will forward any incoming Ether or token to the parent address of the contract
       */
      contract ForwarderV4 is IERC721Receiver, ERC1155Holder, IForwarderV4 {
        /// @notice Any funds sent to this contract will be forwarded to this address
        address public parentAddress;
        /// @notice Address which is allowed to call methods on this contract alongwith the parentAddress
        address public feeAddress;
        bool public autoFlush721 = true;
        bool public autoFlush1155 = true;
        /**
         * @notice Event triggered when a deposit is received in the forwarder
         * @param from Address from which the deposit is received
         * @param value Amount of Ether received
         * @param data Data sent along with the deposit
         */
        event ForwarderDeposited(address from, uint256 value, bytes data);
        /**
         * @notice Modifier that will execute internal code block only if the sender is from the allowed addresses
         */
        modifier onlyAllowedAddress() {
          require(
            msg.sender == parentAddress || msg.sender == feeAddress,
            'Address is not allowed'
          );
          _;
        }
        /**
         * @notice Modifier that will execute internal code block only if the contract has not been initialized yet
         */
        modifier onlyUninitialized() {
          require(parentAddress == address(0x0), 'Already initialized');
          _;
        }
        /**
         * @notice Default function; Gets called when Ether is deposited with no data, and forwards it to the parent address
         */
        receive() external payable {
          flush();
        }
        /**
         * @notice Default function; Gets called when data is sent but does not match any other function
         */
        fallback() external payable {
          flush();
        }
        /**
         * @notice Initialize the contract, and sets the destination address to that of the parent address
         * @param _parentAddress Address to which the funds should be forwarded
         * @param _feeAddress Address which is allowed to call methods on this contract alongwith the parentAddress
         * @param _autoFlush721 Whether to automatically flush ERC721 tokens or not
         * @param _autoFlush1155 Whether to automatically flush ERC1155 tokens or not
         */
        function init(
          address _parentAddress,
          address _feeAddress,
          bool _autoFlush721,
          bool _autoFlush1155
        ) external onlyUninitialized {
          require(_parentAddress != address(0x0), 'Invalid parent address');
          parentAddress = _parentAddress;
          require(_feeAddress != address(0x0), 'Invalid fee address');
          feeAddress = _feeAddress;
          uint256 value = address(this).balance;
          /// @notice set whether we want to automatically flush erc721/erc1155 tokens or not
          autoFlush721 = _autoFlush721;
          autoFlush1155 = _autoFlush1155;
          if (value == 0) {
            return;
          }
          /**
           * 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);
          (bool success, ) = parentAddress.call{ value: value }('');
          require(success, 'Flush failed');
        }
        /**
         * @inheritdoc IForwarderV4
         */
        function setAutoFlush721(bool autoFlush)
          external
          virtual
          override
          onlyAllowedAddress
        {
          autoFlush721 = autoFlush;
        }
        /**
         * @inheritdoc IForwarderV4
         */
        function setAutoFlush1155(bool autoFlush)
          external
          virtual
          override
          onlyAllowedAddress
        {
          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;
        }
        /**
         * @notice Method to allow for calls to other contracts. This method can only be called by the parent address
         * @param target The target contract address whose method needs to be called
         * @param value The amount of Ether to be sent
         * @param data The calldata to be sent
         */
        function callFromParent(
          address target,
          uint256 value,
          bytes calldata data
        ) external returns (bytes memory) {
          require(msg.sender == parentAddress, 'Only Parent');
          (bool success, bytes memory returnedData) = target.call{ value: value }(
            data
          );
          require(success, 'Parent call execution failed');
          return returnedData;
        }
        /**
         * @inheritdoc ERC1155Holder
         */
        function onERC1155Received(
          address _operator,
          address _from,
          uint256 id,
          uint256 value,
          bytes memory data
        ) public 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 ERC1155Holder
         */
        function onERC1155BatchReceived(
          address _operator,
          address _from,
          uint256[] memory ids,
          uint256[] memory values,
          bytes memory data
        ) public 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 IForwarderV4
         */
        function flushTokens(address tokenContractAddress)
          external
          virtual
          override
          onlyAllowedAddress
        {
          ERC20Interface instance = ERC20Interface(tokenContractAddress);
          address forwarderAddress = address(this);
          uint256 forwarderBalance = instance.balanceOf(forwarderAddress);
          if (forwarderBalance == 0) {
            return;
          }
          TransferHelper.safeTransfer(
            tokenContractAddress,
            parentAddress,
            forwarderBalance
          );
        }
        /**
         * @inheritdoc IForwarderV4
         */
        function flushERC721Token(address tokenContractAddress, uint256 tokenId)
          external
          virtual
          override
          onlyAllowedAddress
        {
          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 IForwarderV4
         */
        function flushERC1155Tokens(address tokenContractAddress, uint256 tokenId)
          external
          virtual
          override
          onlyAllowedAddress
        {
          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 IForwarderV4
         */
        function batchFlushERC1155Tokens(
          address tokenContractAddress,
          uint256[] calldata tokenIds
        ) external virtual override onlyAllowedAddress {
          IERC1155 instance = IERC1155(tokenContractAddress);
          require(
            instance.supportsInterface(type(IERC1155).interfaceId),
            'The caller does not support the IERC1155 interface'
          );
          address forwarderAddress = address(this);
          uint256 length = tokenIds.length;
          uint256[] memory amounts = new uint256[](tokenIds.length);
          for (uint256 i; i < length; i++) {
            amounts[i] = instance.balanceOf(forwarderAddress, tokenIds[i]);
          }
          instance.safeBatchTransferFrom(
            forwarderAddress,
            parentAddress,
            tokenIds,
            amounts,
            ''
          );
        }
        /**
         * @inheritdoc IForwarderV4
         */
        function batchFlushERC20Tokens(address[] calldata tokenContractAddresses)
          external
          virtual
          override
          onlyAllowedAddress
        {
          address forwarderAddress = address(this);
          uint256 length = tokenContractAddresses.length;
          for (uint256 i; i < length; i++) {
            ERC20Interface instance = ERC20Interface(tokenContractAddresses[i]);
            uint256 forwarderBalance = instance.balanceOf(forwarderAddress);
            if (forwarderBalance == 0) {
              continue;
            }
            TransferHelper.safeTransfer(
              tokenContractAddresses[i],
              parentAddress,
              forwarderBalance
            );
          }
        }
        /**
         * @notice Flush the entire balance of the contract to the parent address.
         */
        function flush() public {
          uint256 value = address(this).balance;
          if (value == 0) {
            return;
          }
          emit ForwarderDeposited(msg.sender, value, msg.data);
          (bool success, ) = parentAddress.call{ value: value }('');
          require(success, 'Flush failed');
        }
        /**
         * @inheritdoc IERC165
         */
        function supportsInterface(bytes4 interfaceId)
          public
          view
          virtual
          override(ERC1155Holder, IERC165)
          returns (bool)
        {
          return
            interfaceId == type(IForwarderV4).interfaceId ||
            super.supportsInterface(interfaceId);
        }
      }
      // SPDX-License-Identifier: Apache-2.0
      pragma solidity 0.8.20;
      import '@openzeppelin/contracts/utils/introspection/IERC165.sol';
      interface IForwarderV4 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 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;
        /**
         * Execute a batch erc20 transfer from the forwarder to the parent address.
         *
         * @param tokenContractAddresses the addresses of the ERC20 token contracts
         */
        function batchFlushERC20Tokens(address[] calldata tokenContractAddresses)
          external;
      }
      // 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.20;
      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);
        }
      }