ETH Price: $2,426.80 (+7.39%)

Transaction Decoder

Block:
15391529 at Aug-22-2022 05:08:00 PM +UTC
Transaction Fee:
0.002870382749124776 ETH $6.97
Gas Used:
231,148 Gas / 12.417943262 Gwei

Emitted Events:

132 Registry.Transfer( from=[Sender] 0x208c4ac98cc79927d5f70b9b287809df7bb45bb9, to=TransparentUpgradeableProxy, tokenId=54031285922470889491816944390747356232094881781674572794386276212150917032004 )
133 Registry.Transfer( from=TransparentUpgradeableProxy, to=0x00000000...000000000, tokenId=54031285922470889491816944390747356232094881781674572794386276212150917032004 )
134 TransparentUpgradeableProxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x0000000000000000000000000000000000000000000000000000000000000000, 0x000000000000000000000000049aba7510f45ba5b64ea9e658e342f904db358d, 0x77749fc4bb570dab5ca0765c15f9a53363f804e91e64784fde8020518f166844 )
135 TransparentUpgradeableProxy.0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925( 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925, 0x000000000000000000000000049aba7510f45ba5b64ea9e658e342f904db358d, 0x000000000000000000000000932532aa4c0174b8453839a6e44ee09cc615f2b7, 0x77749fc4bb570dab5ca0765c15f9a53363f804e91e64784fde8020518f166844 )
136 MintableERC721PredicateProxy.0xe13244aa06bdc79480ed5fdc6ebe2bb37202fcdf33ecf45dc449f4201f3dc087( 0xe13244aa06bdc79480ed5fdc6ebe2bb37202fcdf33ecf45dc449f4201f3dc087, 0x000000000000000000000000049aba7510f45ba5b64ea9e658e342f904db358d, 0x000000000000000000000000208c4ac98cc79927d5f70b9b287809df7bb45bb9, 0x000000000000000000000000049aba7510f45ba5b64ea9e658e342f904db358d, 77749fc4bb570dab5ca0765c15f9a53363f804e91e64784fde8020518f166844 )
137 TransparentUpgradeableProxy.0x185c30856dadb58bf097c1f665a52ada7029752dbcad008ea3fefc73bee8c9fe( 0x185c30856dadb58bf097c1f665a52ada7029752dbcad008ea3fefc73bee8c9fe, 0x77749fc4bb570dab5ca0765c15f9a53363f804e91e64784fde8020518f166844 )
138 TransparentUpgradeableProxy.0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925( 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925, 0x000000000000000000000000049aba7510f45ba5b64ea9e658e342f904db358d, 0x0000000000000000000000000000000000000000000000000000000000000000, 0x77749fc4bb570dab5ca0765c15f9a53363f804e91e64784fde8020518f166844 )
139 TransparentUpgradeableProxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x000000000000000000000000049aba7510f45ba5b64ea9e658e342f904db358d, 0x000000000000000000000000932532aa4c0174b8453839a6e44ee09cc615f2b7, 0x77749fc4bb570dab5ca0765c15f9a53363f804e91e64784fde8020518f166844 )
140 StateSender.StateSynced( id=2280147, contractAddress=0xA6FA4fB5...9C5d1C0aa, data=0x87A7811F4BFEDEA3D341AD165680AE306B01AAEACC205D227629CF157DD9F821000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000A0000000000000000000000000208C4AC98CC79927D5F70B9B287809DF7BB45BB9000000000000000000000000049ABA7510F45BA5B64EA9E658E342F904DB358D0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000002077749FC4BB570DAB5CA0765C15F9A53363F804E91E64784FDE8020518F166844 )

Account State Difference:

  Address   Before After State Difference Code
0x049aba75...904DB358D
0x208C4Ac9...f7bB45BB9
0.200805560211629122 Eth
Nonce: 329
0.197935177462504346 Eth
Nonce: 330
0.002870382749124776
0x28e4F3a7...189A5bFbE
(Polygon (Matic): State Syncer)
0xD1E5b0FF...08b9Dacbe
(Ethermine)
899.446108291536877232 Eth899.446455013536877232 Eth0.000346722

Execution Trace

Registry.safeTransferFrom( from=0x208C4Ac98cC79927d5F70b9b287809Df7bB45BB9, to=0x049aba7510f45BA5b64ea9E658E342F904DB358D, tokenId=54031285922470889491816944390747356232094881781674572794386276212150917032004, _data=0x0000000000000000000000000000000000000000000000000000000000000001 )
  • TransparentUpgradeableProxy.150b7a02( )
    • UNSRegistry.onERC721Received( 0x208C4Ac98cC79927d5F70b9b287809Df7bB45BB9, from=0x208C4Ac98cC79927d5F70b9b287809Df7bB45BB9, tokenId=54031285922470889491816944390747356232094881781674572794386276212150917032004, data=0x0000000000000000000000000000000000000000000000000000000000000001 )
      • Registry.burn( tokenId=54031285922470889491816944390747356232094881781674572794386276212150917032004 )
      • RootChainManagerProxy.e43009a6( )
        • RootChainManager.tokenToType( 0x049aba7510f45BA5b64ea9E658E342F904DB358D ) => ( D4392723C111FCB98B073FE55873EFB447BCD23CD3E49EC9EA2581930CD01DDC )
        • RootChainManagerProxy.e66f9603( )
          • RootChainManager.typeToPredicate( D4392723C111FCB98B073FE55873EFB447BCD23CD3E49EC9EA2581930CD01DDC ) => ( 0x932532aA4c0174b8453839A6E44eE09Cc615F2b7 )
          • RootChainManagerProxy.e3dec8fb( )
            • RootChainManager.depositFor( user=0x208C4Ac98cC79927d5F70b9b287809Df7bB45BB9, rootToken=0x049aba7510f45BA5b64ea9E658E342F904DB358D, depositData=0x77749FC4BB570DAB5CA0765C15F9A53363F804E91E64784FDE8020518F166844 )
              • MintableERC721PredicateProxy.e375b64e( )
                • MintableERC721Predicate.lockTokens( depositor=0x049aba7510f45BA5b64ea9E658E342F904DB358D, depositReceiver=0x208C4Ac98cC79927d5F70b9b287809Df7bB45BB9, rootToken=0x049aba7510f45BA5b64ea9E658E342F904DB358D, depositData=0x77749FC4BB570DAB5CA0765C15F9A53363F804E91E64784FDE8020518F166844 )
                • StateSender.syncState( receiver=0xA6FA4fB5f76172d178d61B04b0ecd319C5d1C0aa, data=0x87A7811F4BFEDEA3D341AD165680AE306B01AAEACC205D227629CF157DD9F821000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000A0000000000000000000000000208C4AC98CC79927D5F70B9B287809DF7BB45BB9000000000000000000000000049ABA7510F45BA5B64EA9E658E342F904DB358D0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000002077749FC4BB570DAB5CA0765C15F9A53363F804E91E64784FDE8020518F166844 )
                  safeTransferFrom[IERC721 (ln:61)]
                  File 1 of 8: Registry
                  // File: @openzeppelin/contracts/introspection/IERC165.sol
                  
                  pragma solidity ^0.5.0;
                  
                  /**
                   * @dev Interface of the ERC165 standard, as defined in the
                   * [EIP](https://eips.ethereum.org/EIPS/eip-165).
                   *
                   * 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
                       * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
                       * 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);
                  }
                  
                  // File: @openzeppelin/contracts/token/ERC721/IERC721.sol
                  
                  pragma solidity ^0.5.0;
                  
                  
                  /**
                   * @dev Required interface of an ERC721 compliant contract.
                   */
                  contract IERC721 is IERC165 {
                      event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
                      event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
                      event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
                  
                      /**
                       * @dev Returns the number of NFTs in `owner`'s account.
                       */
                      function balanceOf(address owner) public view returns (uint256 balance);
                  
                      /**
                       * @dev Returns the owner of the NFT specified by `tokenId`.
                       */
                      function ownerOf(uint256 tokenId) public view returns (address owner);
                  
                      /**
                       * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                       * another (`to`).
                       *
                       * 
                       *
                       * Requirements:
                       * - `from`, `to` cannot be zero.
                       * - `tokenId` must be owned by `from`.
                       * - If the caller is not `from`, it must be have been allowed to move this
                       * NFT by either `approve` or `setApproveForAll`.
                       */
                      function safeTransferFrom(address from, address to, uint256 tokenId) public;
                      /**
                       * @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to
                       * another (`to`).
                       *
                       * Requirements:
                       * - If the caller is not `from`, it must be approved to move this NFT by
                       * either `approve` or `setApproveForAll`.
                       */
                      function transferFrom(address from, address to, uint256 tokenId) public;
                      function approve(address to, uint256 tokenId) public;
                      function getApproved(uint256 tokenId) public view returns (address operator);
                  
                      function setApprovalForAll(address operator, bool _approved) public;
                      function isApprovedForAll(address owner, address operator) public view returns (bool);
                  
                  
                      function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public;
                  }
                  
                  // File: @openzeppelin/contracts/token/ERC721/IERC721Metadata.sol
                  
                  pragma solidity ^0.5.0;
                  
                  
                  /**
                   * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
                   * @dev See https://eips.ethereum.org/EIPS/eip-721
                   */
                  contract IERC721Metadata is IERC721 {
                      function name() external view returns (string memory);
                      function symbol() external view returns (string memory);
                      function tokenURI(uint256 tokenId) external view returns (string memory);
                  }
                  
                  // File: contracts/IRegistry.sol
                  
                  pragma solidity 0.5.12;
                  
                  
                  contract IRegistry is IERC721Metadata {
                  
                      event NewURI(uint256 indexed tokenId, string uri);
                  
                      event NewURIPrefix(string prefix);
                  
                      event Resolve(uint256 indexed tokenId, address indexed to);
                  
                      event Sync(address indexed resolver, uint256 indexed updateId, uint256 indexed tokenId);
                  
                      /**
                       * @dev Controlled function to set the token URI Prefix for all tokens.
                       * @param prefix string URI to assign
                       */
                      function controlledSetTokenURIPrefix(string calldata prefix) external;
                  
                      /**
                       * @dev Returns whether the given spender can transfer a given token ID.
                       * @param spender address of the spender to query
                       * @param tokenId uint256 ID of the token to be transferred
                       * @return bool whether the msg.sender is approved for the given token ID,
                       * is an operator of the owner, or is the owner of the token
                       */
                      function isApprovedOrOwner(address spender, uint256 tokenId) external view returns (bool);
                  
                      /**
                       * @dev Mints a new a child token.
                       * Calculates child token ID using a namehash function.
                       * Requires the msg.sender to be the owner, approved, or operator of tokenId.
                       * Requires the token not exist.
                       * @param to address to receive the ownership of the given token ID
                       * @param tokenId uint256 ID of the parent token
                       * @param label subdomain label of the child token ID
                       */
                      function mintChild(address to, uint256 tokenId, string calldata label) external;
                  
                      /**
                       * @dev Controlled function to mint a given token ID.
                       * Requires the msg.sender to be controller.
                       * Requires the token ID to not exist.
                       * @param to address the given token ID will be minted to
                       * @param label string that is a subdomain
                       * @param tokenId uint256 ID of the parent token
                       */
                      function controlledMintChild(address to, uint256 tokenId, string calldata label) external;
                  
                      /**
                       * @dev Transfers the ownership of a child token ID to another address.
                       * Calculates child token ID using a namehash function.
                       * Requires the msg.sender to be the owner, approved, or operator of tokenId.
                       * Requires the token already exist.
                       * @param from current owner of the token
                       * @param to address to receive the ownership of the given token ID
                       * @param tokenId uint256 ID of the token to be transferred
                       * @param label subdomain label of the child token ID
                       */
                      function transferFromChild(address from, address to, uint256 tokenId, string calldata label) external;
                  
                      /**
                       * @dev Controlled function to transfers the ownership of a token ID to
                       * another address.
                       * Requires the msg.sender to be controller.
                       * Requires the token already exist.
                       * @param from current owner of the token
                       * @param to address to receive the ownership of the given token ID
                       * @param tokenId uint256 ID of the token to be transferred
                       */
                      function controlledTransferFrom(address from, address to, uint256 tokenId) external;
                  
                      /**
                       * @dev Safely transfers the ownership of a child token ID to another address.
                       * Calculates child token ID using a namehash function.
                       * Implements a ERC721Reciever check unlike transferFromChild.
                       * Requires the msg.sender to be the owner, approved, or operator of tokenId.
                       * Requires the token already exist.
                       * @param from current owner of the token
                       * @param to address to receive the ownership of the given token ID
                       * @param tokenId uint256 parent ID of the token to be transferred
                       * @param label subdomain label of the child token ID
                       * @param _data bytes data to send along with a safe transfer check
                       */
                      function safeTransferFromChild(address from, address to, uint256 tokenId, string calldata label, bytes calldata _data) external;
                  
                      /// Shorthand for calling the above ^^^ safeTransferFromChild function with an empty _data parameter. Similar to ERC721.safeTransferFrom.
                      function safeTransferFromChild(address from, address to, uint256 tokenId, string calldata label) external;
                  
                      /**
                       * @dev Controlled frunction to safely transfers the ownership of a token ID
                       * to another address.
                       * Implements a ERC721Reciever check unlike controlledSafeTransferFrom.
                       * Requires the msg.sender to be controller.
                       * Requires the token already exist.
                       * @param from current owner of the token
                       * @param to address to receive the ownership of the given token ID
                       * @param tokenId uint256 parent ID of the token to be transferred
                       * @param _data bytes data to send along with a safe transfer check
                       */
                      function controlledSafeTransferFrom(address from, address to, uint256 tokenId, bytes calldata _data) external;
                  
                      /**
                       * @dev Burns a child token ID.
                       * Calculates child token ID using a namehash function.
                       * Requires the msg.sender to be the owner, approved, or operator of tokenId.
                       * Requires the token already exist.
                       * @param tokenId uint256 ID of the token to be transferred
                       * @param label subdomain label of the child token ID
                       */
                      function burnChild(uint256 tokenId, string calldata label) external;
                  
                      /**
                       * @dev Controlled function to burn a given token ID.
                       * Requires the msg.sender to be controller.
                       * Requires the token already exist.
                       * @param tokenId uint256 ID of the token to be burned
                       */
                      function controlledBurn(uint256 tokenId) external;
                  
                      /**
                       * @dev Sets the resolver of a given token ID to another address.
                       * Requires the msg.sender to be the owner, approved, or operator.
                       * @param to address the given token ID will resolve to
                       * @param tokenId uint256 ID of the token to be transferred
                       */
                      function resolveTo(address to, uint256 tokenId) external;
                  
                      /**
                       * @dev Gets the resolver of the specified token ID.
                       * @param tokenId uint256 ID of the token to query the resolver of
                       * @return address currently marked as the resolver of the given token ID
                       */
                      function resolverOf(uint256 tokenId) external view returns (address);
                  
                      /**
                       * @dev Controlled function to sets the resolver of a given token ID.
                       * Requires the msg.sender to be controller.
                       * @param to address the given token ID will resolve to
                       * @param tokenId uint256 ID of the token to be transferred
                       */
                      function controlledResolveTo(address to, uint256 tokenId) external;
                  
                  }
                  
                  // File: @openzeppelin/contracts/token/ERC721/IERC721Receiver.sol
                  
                  pragma solidity ^0.5.0;
                  
                  /**
                   * @title ERC721 token receiver interface
                   * @dev Interface for any contract that wants to support safeTransfers
                   * from ERC721 asset contracts.
                   */
                  contract IERC721Receiver {
                      /**
                       * @notice Handle the receipt of an NFT
                       * @dev The ERC721 smart contract calls this function on the recipient
                       * after a `safeTransfer`. This function MUST return the function selector,
                       * otherwise the caller will revert the transaction. The selector to be
                       * returned can be obtained as `this.onERC721Received.selector`. This
                       * function MAY throw to revert and reject the transfer.
                       * Note: the ERC721 contract address is always the message sender.
                       * @param operator The address which called `safeTransferFrom` function
                       * @param from The address which previously owned the token
                       * @param tokenId The NFT identifier which is being transferred
                       * @param data Additional data with no specified format
                       * @return bytes4 `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                       */
                      function onERC721Received(address operator, address from, uint256 tokenId, bytes memory data)
                      public returns (bytes4);
                  }
                  
                  // File: @openzeppelin/contracts/math/SafeMath.sol
                  
                  pragma solidity ^0.5.0;
                  
                  /**
                   * @dev Wrappers over Solidity's arithmetic operations with added overflow
                   * checks.
                   *
                   * Arithmetic operations in Solidity wrap on overflow. This can easily result
                   * in bugs, because programmers usually assume that an overflow raises an
                   * error, which is the standard behavior in high level programming languages.
                   * `SafeMath` restores this intuition by reverting the transaction when an
                   * operation overflows.
                   *
                   * Using this library instead of the unchecked operations eliminates an entire
                   * class of bugs, so it's recommended to use it always.
                   */
                  library SafeMath {
                      /**
                       * @dev Returns the addition of two unsigned integers, reverting on
                       * overflow.
                       *
                       * Counterpart to Solidity's `+` operator.
                       *
                       * Requirements:
                       * - Addition cannot overflow.
                       */
                      function add(uint256 a, uint256 b) internal pure returns (uint256) {
                          uint256 c = a + b;
                          require(c >= a, "SafeMath: addition overflow");
                  
                          return c;
                      }
                  
                      /**
                       * @dev Returns the subtraction of two unsigned integers, reverting on
                       * overflow (when the result is negative).
                       *
                       * Counterpart to Solidity's `-` operator.
                       *
                       * Requirements:
                       * - Subtraction cannot overflow.
                       */
                      function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                          require(b <= a, "SafeMath: subtraction overflow");
                          uint256 c = a - b;
                  
                          return c;
                      }
                  
                      /**
                       * @dev Returns the multiplication of two unsigned integers, reverting on
                       * overflow.
                       *
                       * Counterpart to Solidity's `*` operator.
                       *
                       * Requirements:
                       * - Multiplication cannot overflow.
                       */
                      function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                          // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                          // benefit is lost if 'b' is also tested.
                          // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                          if (a == 0) {
                              return 0;
                          }
                  
                          uint256 c = a * b;
                          require(c / a == b, "SafeMath: multiplication overflow");
                  
                          return c;
                      }
                  
                      /**
                       * @dev Returns the integer division of two unsigned integers. Reverts on
                       * division by zero. The result is rounded towards zero.
                       *
                       * Counterpart to Solidity's `/` operator. Note: this function uses a
                       * `revert` opcode (which leaves remaining gas untouched) while Solidity
                       * uses an invalid opcode to revert (consuming all remaining gas).
                       *
                       * Requirements:
                       * - The divisor cannot be zero.
                       */
                      function div(uint256 a, uint256 b) internal pure returns (uint256) {
                          // Solidity only automatically asserts when dividing by 0
                          require(b > 0, "SafeMath: division by zero");
                          uint256 c = a / b;
                          // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                  
                          return c;
                      }
                  
                      /**
                       * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                       * Reverts when dividing by zero.
                       *
                       * Counterpart to Solidity's `%` operator. This function uses a `revert`
                       * opcode (which leaves remaining gas untouched) while Solidity uses an
                       * invalid opcode to revert (consuming all remaining gas).
                       *
                       * Requirements:
                       * - The divisor cannot be zero.
                       */
                      function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                          require(b != 0, "SafeMath: modulo by zero");
                          return a % b;
                      }
                  }
                  
                  // File: @openzeppelin/contracts/utils/Address.sol
                  
                  pragma solidity ^0.5.0;
                  
                  /**
                   * @dev Collection of functions related to the address type,
                   */
                  library Address {
                      /**
                       * @dev Returns true if `account` is a contract.
                       *
                       * This test is non-exhaustive, and there may be false-negatives: during the
                       * execution of a contract's constructor, its address will be reported as
                       * not containing a contract.
                       *
                       * > It is unsafe to assume that an address for which this function returns
                       * false is an externally-owned account (EOA) and not a contract.
                       */
                      function isContract(address account) internal view returns (bool) {
                          // This method relies in extcodesize, which returns 0 for contracts in
                          // construction, since the code is only stored at the end of the
                          // constructor execution.
                  
                          uint256 size;
                          // solhint-disable-next-line no-inline-assembly
                          assembly { size := extcodesize(account) }
                          return size > 0;
                      }
                  }
                  
                  // File: @openzeppelin/contracts/drafts/Counters.sol
                  
                  pragma solidity ^0.5.0;
                  
                  
                  /**
                   * @title Counters
                   * @author Matt Condon (@shrugs)
                   * @dev Provides counters that can only be incremented or decremented by one. This can be used e.g. to track the number
                   * of elements in a mapping, issuing ERC721 ids, or counting request ids.
                   *
                   * Include with `using Counters for Counters.Counter;`
                   * Since it is not possible to overflow a 256 bit integer with increments of one, `increment` can skip the SafeMath
                   * overflow check, thereby saving gas. This does assume however correct usage, in that the underlying `_value` is never
                   * directly accessed.
                   */
                  library Counters {
                      using SafeMath for uint256;
                  
                      struct Counter {
                          // This variable should never be directly accessed by users of the library: interactions must be restricted to
                          // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
                          // this feature: see https://github.com/ethereum/solidity/issues/4637
                          uint256 _value; // default: 0
                      }
                  
                      function current(Counter storage counter) internal view returns (uint256) {
                          return counter._value;
                      }
                  
                      function increment(Counter storage counter) internal {
                          counter._value += 1;
                      }
                  
                      function decrement(Counter storage counter) internal {
                          counter._value = counter._value.sub(1);
                      }
                  }
                  
                  // File: @openzeppelin/contracts/introspection/ERC165.sol
                  
                  pragma solidity ^0.5.0;
                  
                  
                  /**
                   * @dev Implementation of the `IERC165` interface.
                   *
                   * Contracts may inherit from this and call `_registerInterface` to declare
                   * their support of an interface.
                   */
                  contract ERC165 is IERC165 {
                      /*
                       * bytes4(keccak256('supportsInterface(bytes4)')) == 0x01ffc9a7
                       */
                      bytes4 private constant _INTERFACE_ID_ERC165 = 0x01ffc9a7;
                  
                      /**
                       * @dev Mapping of interface ids to whether or not it's supported.
                       */
                      mapping(bytes4 => bool) private _supportedInterfaces;
                  
                      constructor () internal {
                          // Derived contracts need only register support for their own interfaces,
                          // we register support for ERC165 itself here
                          _registerInterface(_INTERFACE_ID_ERC165);
                      }
                  
                      /**
                       * @dev See `IERC165.supportsInterface`.
                       *
                       * Time complexity O(1), guaranteed to always use less than 30 000 gas.
                       */
                      function supportsInterface(bytes4 interfaceId) external view returns (bool) {
                          return _supportedInterfaces[interfaceId];
                      }
                  
                      /**
                       * @dev Registers the contract as an implementer of the interface defined by
                       * `interfaceId`. Support of the actual ERC165 interface is automatic and
                       * registering its interface id is not required.
                       *
                       * See `IERC165.supportsInterface`.
                       *
                       * Requirements:
                       *
                       * - `interfaceId` cannot be the ERC165 invalid interface (`0xffffffff`).
                       */
                      function _registerInterface(bytes4 interfaceId) internal {
                          require(interfaceId != 0xffffffff, "ERC165: invalid interface id");
                          _supportedInterfaces[interfaceId] = true;
                      }
                  }
                  
                  // File: @openzeppelin/contracts/token/ERC721/ERC721.sol
                  
                  pragma solidity ^0.5.0;
                  
                  
                  
                  
                  
                  
                  
                  /**
                   * @title ERC721 Non-Fungible Token Standard basic implementation
                   * @dev see https://eips.ethereum.org/EIPS/eip-721
                   */
                  contract ERC721 is ERC165, IERC721 {
                      using SafeMath for uint256;
                      using Address for address;
                      using Counters for Counters.Counter;
                  
                      // Equals to `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
                      // which can be also obtained as `IERC721Receiver(0).onERC721Received.selector`
                      bytes4 private constant _ERC721_RECEIVED = 0x150b7a02;
                  
                      // Mapping from token ID to owner
                      mapping (uint256 => address) private _tokenOwner;
                  
                      // Mapping from token ID to approved address
                      mapping (uint256 => address) private _tokenApprovals;
                  
                      // Mapping from owner to number of owned token
                      mapping (address => Counters.Counter) private _ownedTokensCount;
                  
                      // Mapping from owner to operator approvals
                      mapping (address => mapping (address => bool)) private _operatorApprovals;
                  
                      /*
                       *     bytes4(keccak256('balanceOf(address)')) == 0x70a08231
                       *     bytes4(keccak256('ownerOf(uint256)')) == 0x6352211e
                       *     bytes4(keccak256('approve(address,uint256)')) == 0x095ea7b3
                       *     bytes4(keccak256('getApproved(uint256)')) == 0x081812fc
                       *     bytes4(keccak256('setApprovalForAll(address,bool)')) == 0xa22cb465
                       *     bytes4(keccak256('isApprovedForAll(address,address)')) == 0xe985e9c
                       *     bytes4(keccak256('transferFrom(address,address,uint256)')) == 0x23b872dd
                       *     bytes4(keccak256('safeTransferFrom(address,address,uint256)')) == 0x42842e0e
                       *     bytes4(keccak256('safeTransferFrom(address,address,uint256,bytes)')) == 0xb88d4fde
                       *
                       *     => 0x70a08231 ^ 0x6352211e ^ 0x095ea7b3 ^ 0x081812fc ^
                       *        0xa22cb465 ^ 0xe985e9c ^ 0x23b872dd ^ 0x42842e0e ^ 0xb88d4fde == 0x80ac58cd
                       */
                      bytes4 private constant _INTERFACE_ID_ERC721 = 0x80ac58cd;
                  
                      constructor () public {
                          // register the supported interfaces to conform to ERC721 via ERC165
                          _registerInterface(_INTERFACE_ID_ERC721);
                      }
                  
                      /**
                       * @dev Gets the balance of the specified address.
                       * @param owner address to query the balance of
                       * @return uint256 representing the amount owned by the passed address
                       */
                      function balanceOf(address owner) public view returns (uint256) {
                          require(owner != address(0), "ERC721: balance query for the zero address");
                  
                          return _ownedTokensCount[owner].current();
                      }
                  
                      /**
                       * @dev Gets the owner of the specified token ID.
                       * @param tokenId uint256 ID of the token to query the owner of
                       * @return address currently marked as the owner of the given token ID
                       */
                      function ownerOf(uint256 tokenId) public view returns (address) {
                          address owner = _tokenOwner[tokenId];
                          require(owner != address(0), "ERC721: owner query for nonexistent token");
                  
                          return owner;
                      }
                  
                      /**
                       * @dev Approves another address to transfer the given token ID
                       * The zero address indicates there is no approved address.
                       * There can only be one approved address per token at a given time.
                       * Can only be called by the token owner or an approved operator.
                       * @param to address to be approved for the given token ID
                       * @param tokenId uint256 ID of the token to be approved
                       */
                      function approve(address to, uint256 tokenId) public {
                          address owner = ownerOf(tokenId);
                          require(to != owner, "ERC721: approval to current owner");
                  
                          require(msg.sender == owner || isApprovedForAll(owner, msg.sender),
                              "ERC721: approve caller is not owner nor approved for all"
                          );
                  
                          _tokenApprovals[tokenId] = to;
                          emit Approval(owner, to, tokenId);
                      }
                  
                      /**
                       * @dev Gets the approved address for a token ID, or zero if no address set
                       * Reverts if the token ID does not exist.
                       * @param tokenId uint256 ID of the token to query the approval of
                       * @return address currently approved for the given token ID
                       */
                      function getApproved(uint256 tokenId) public view returns (address) {
                          require(_exists(tokenId), "ERC721: approved query for nonexistent token");
                  
                          return _tokenApprovals[tokenId];
                      }
                  
                      /**
                       * @dev Sets or unsets the approval of a given operator
                       * An operator is allowed to transfer all tokens of the sender on their behalf.
                       * @param to operator address to set the approval
                       * @param approved representing the status of the approval to be set
                       */
                      function setApprovalForAll(address to, bool approved) public {
                          require(to != msg.sender, "ERC721: approve to caller");
                  
                          _operatorApprovals[msg.sender][to] = approved;
                          emit ApprovalForAll(msg.sender, to, approved);
                      }
                  
                      /**
                       * @dev Tells whether an operator is approved by a given owner.
                       * @param owner owner address which you want to query the approval of
                       * @param operator operator address which you want to query the approval of
                       * @return bool whether the given operator is approved by the given owner
                       */
                      function isApprovedForAll(address owner, address operator) public view returns (bool) {
                          return _operatorApprovals[owner][operator];
                      }
                  
                      /**
                       * @dev Transfers the ownership of a given token ID to another address.
                       * Usage of this method is discouraged, use `safeTransferFrom` whenever possible.
                       * Requires the msg.sender to be the owner, approved, or operator.
                       * @param from current owner of the token
                       * @param to address to receive the ownership of the given token ID
                       * @param tokenId uint256 ID of the token to be transferred
                       */
                      function transferFrom(address from, address to, uint256 tokenId) public {
                          //solhint-disable-next-line max-line-length
                          require(_isApprovedOrOwner(msg.sender, tokenId), "ERC721: transfer caller is not owner nor approved");
                  
                          _transferFrom(from, to, tokenId);
                      }
                  
                      /**
                       * @dev Safely transfers the ownership of a given token ID to another address
                       * If the target address is a contract, it must implement `onERC721Received`,
                       * which is called upon a safe transfer, and return the magic value
                       * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                       * the transfer is reverted.
                       * Requires the msg.sender to be the owner, approved, or operator
                       * @param from current owner of the token
                       * @param to address to receive the ownership of the given token ID
                       * @param tokenId uint256 ID of the token to be transferred
                       */
                      function safeTransferFrom(address from, address to, uint256 tokenId) public {
                          safeTransferFrom(from, to, tokenId, "");
                      }
                  
                      /**
                       * @dev Safely transfers the ownership of a given token ID to another address
                       * If the target address is a contract, it must implement `onERC721Received`,
                       * which is called upon a safe transfer, and return the magic value
                       * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`; otherwise,
                       * the transfer is reverted.
                       * Requires the msg.sender to be the owner, approved, or operator
                       * @param from current owner of the token
                       * @param to address to receive the ownership of the given token ID
                       * @param tokenId uint256 ID of the token to be transferred
                       * @param _data bytes data to send along with a safe transfer check
                       */
                      function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory _data) public {
                          transferFrom(from, to, tokenId);
                          require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
                      }
                  
                      /**
                       * @dev Returns whether the specified token exists.
                       * @param tokenId uint256 ID of the token to query the existence of
                       * @return bool whether the token exists
                       */
                      function _exists(uint256 tokenId) internal view returns (bool) {
                          address owner = _tokenOwner[tokenId];
                          return owner != address(0);
                      }
                  
                      /**
                       * @dev Returns whether the given spender can transfer a given token ID.
                       * @param spender address of the spender to query
                       * @param tokenId uint256 ID of the token to be transferred
                       * @return bool whether the msg.sender is approved for the given token ID,
                       * is an operator of the owner, or is the owner of the token
                       */
                      function _isApprovedOrOwner(address spender, uint256 tokenId) internal view returns (bool) {
                          require(_exists(tokenId), "ERC721: operator query for nonexistent token");
                          address owner = ownerOf(tokenId);
                          return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, spender));
                      }
                  
                      /**
                       * @dev Internal function to mint a new token.
                       * Reverts if the given token ID already exists.
                       * @param to The address that will own the minted token
                       * @param tokenId uint256 ID of the token to be minted
                       */
                      function _mint(address to, uint256 tokenId) internal {
                          require(to != address(0), "ERC721: mint to the zero address");
                          require(!_exists(tokenId), "ERC721: token already minted");
                  
                          _tokenOwner[tokenId] = to;
                          _ownedTokensCount[to].increment();
                  
                          emit Transfer(address(0), to, tokenId);
                      }
                  
                      /**
                       * @dev Internal function to burn a specific token.
                       * Reverts if the token does not exist.
                       * Deprecated, use _burn(uint256) instead.
                       * @param owner owner of the token to burn
                       * @param tokenId uint256 ID of the token being burned
                       */
                      function _burn(address owner, uint256 tokenId) internal {
                          require(ownerOf(tokenId) == owner, "ERC721: burn of token that is not own");
                  
                          _clearApproval(tokenId);
                  
                          _ownedTokensCount[owner].decrement();
                          _tokenOwner[tokenId] = address(0);
                  
                          emit Transfer(owner, address(0), tokenId);
                      }
                  
                      /**
                       * @dev Internal function to burn a specific token.
                       * Reverts if the token does not exist.
                       * @param tokenId uint256 ID of the token being burned
                       */
                      function _burn(uint256 tokenId) internal {
                          _burn(ownerOf(tokenId), tokenId);
                      }
                  
                      /**
                       * @dev Internal function to transfer ownership of a given token ID to another address.
                       * As opposed to transferFrom, this imposes no restrictions on msg.sender.
                       * @param from current owner of the token
                       * @param to address to receive the ownership of the given token ID
                       * @param tokenId uint256 ID of the token to be transferred
                       */
                      function _transferFrom(address from, address to, uint256 tokenId) internal {
                          require(ownerOf(tokenId) == from, "ERC721: transfer of token that is not own");
                          require(to != address(0), "ERC721: transfer to the zero address");
                  
                          _clearApproval(tokenId);
                  
                          _ownedTokensCount[from].decrement();
                          _ownedTokensCount[to].increment();
                  
                          _tokenOwner[tokenId] = to;
                  
                          emit Transfer(from, to, tokenId);
                      }
                  
                      /**
                       * @dev Internal function to invoke `onERC721Received` on a target address.
                       * The call is not executed if the target address is not a contract.
                       *
                       * This function is deprecated.
                       * @param from address representing the previous owner of the given token ID
                       * @param to target address that will receive the tokens
                       * @param tokenId uint256 ID of the token to be transferred
                       * @param _data bytes optional data to send along with the call
                       * @return bool whether the call correctly returned the expected magic value
                       */
                      function _checkOnERC721Received(address from, address to, uint256 tokenId, bytes memory _data)
                          internal returns (bool)
                      {
                          if (!to.isContract()) {
                              return true;
                          }
                  
                          bytes4 retval = IERC721Receiver(to).onERC721Received(msg.sender, from, tokenId, _data);
                          return (retval == _ERC721_RECEIVED);
                      }
                  
                      /**
                       * @dev Private function to clear current approval of a given token ID.
                       * @param tokenId uint256 ID of the token to be transferred
                       */
                      function _clearApproval(uint256 tokenId) private {
                          if (_tokenApprovals[tokenId] != address(0)) {
                              _tokenApprovals[tokenId] = address(0);
                          }
                      }
                  }
                  
                  // File: @openzeppelin/contracts/token/ERC721/ERC721Burnable.sol
                  
                  pragma solidity ^0.5.0;
                  
                  
                  /**
                   * @title ERC721 Burnable Token
                   * @dev ERC721 Token that can be irreversibly burned (destroyed).
                   */
                  contract ERC721Burnable is ERC721 {
                      /**
                       * @dev Burns a specific ERC721 token.
                       * @param tokenId uint256 id of the ERC721 token to be burned.
                       */
                      function burn(uint256 tokenId) public {
                          //solhint-disable-next-line max-line-length
                          require(_isApprovedOrOwner(msg.sender, tokenId), "ERC721Burnable: caller is not owner nor approved");
                          _burn(tokenId);
                      }
                  }
                  
                  // File: @openzeppelin/contracts/access/Roles.sol
                  
                  pragma solidity ^0.5.0;
                  
                  /**
                   * @title Roles
                   * @dev Library for managing addresses assigned to a Role.
                   */
                  library Roles {
                      struct Role {
                          mapping (address => bool) bearer;
                      }
                  
                      /**
                       * @dev Give an account access to this role.
                       */
                      function add(Role storage role, address account) internal {
                          require(!has(role, account), "Roles: account already has role");
                          role.bearer[account] = true;
                      }
                  
                      /**
                       * @dev Remove an account's access to this role.
                       */
                      function remove(Role storage role, address account) internal {
                          require(has(role, account), "Roles: account does not have role");
                          role.bearer[account] = false;
                      }
                  
                      /**
                       * @dev Check if an account has this role.
                       * @return bool
                       */
                      function has(Role storage role, address account) internal view returns (bool) {
                          require(account != address(0), "Roles: account is the zero address");
                          return role.bearer[account];
                      }
                  }
                  
                  // File: contracts/util/ControllerRole.sol
                  
                  pragma solidity 0.5.12;
                  
                  
                  // solium-disable error-reason
                  
                  /**
                   * @title ControllerRole
                   * @dev An Controller role defined using the Open Zeppelin Role system.
                   */
                  contract ControllerRole {
                  
                      using Roles for Roles.Role;
                  
                      // NOTE: Commented out standard Role events to save gas.
                      // event ControllerAdded(address indexed account);
                      // event ControllerRemoved(address indexed account);
                  
                      Roles.Role private _controllers;
                  
                      constructor () public {
                          _addController(msg.sender);
                      }
                  
                      modifier onlyController() {
                          require(isController(msg.sender));
                          _;
                      }
                  
                      function isController(address account) public view returns (bool) {
                          return _controllers.has(account);
                      }
                  
                      function addController(address account) public onlyController {
                          _addController(account);
                      }
                  
                      function renounceController() public {
                          _removeController(msg.sender);
                      }
                  
                      function _addController(address account) internal {
                          _controllers.add(account);
                          // emit ControllerAdded(account);
                      }
                  
                      function _removeController(address account) internal {
                          _controllers.remove(account);
                          // emit ControllerRemoved(account);
                      }
                  
                  }
                  
                  // File: contracts/Registry.sol
                  
                  pragma solidity 0.5.12;
                  
                  
                  
                  
                  // solium-disable no-empty-blocks,error-reason
                  
                  /**
                   * @title Registry
                   * @dev An ERC721 Token see https://eips.ethereum.org/EIPS/eip-721. With
                   * additional functions so other trusted contracts to interact with the tokens.
                   */
                  contract Registry is IRegistry, ControllerRole, ERC721Burnable {
                  
                      // Optional mapping for token URIs
                      mapping(uint256 => string) internal _tokenURIs;
                  
                      string internal _prefix;
                  
                      // Mapping from token ID to resolver address
                      mapping (uint256 => address) internal _tokenResolvers;
                  
                      // uint256(keccak256(abi.encodePacked(uint256(0x0), keccak256(abi.encodePacked("crypto")))))
                      uint256 private constant _CRYPTO_HASH =
                          0x0f4a10a4f46c288cea365fcf45cccf0e9d901b945b9829ccdb54c10dc3cb7a6f;
                  
                      modifier onlyApprovedOrOwner(uint256 tokenId) {
                          require(_isApprovedOrOwner(msg.sender, tokenId));
                          _;
                      }
                  
                      constructor () public {
                          _mint(address(0xdead), _CRYPTO_HASH);
                          // register the supported interfaces to conform to ERC721 via ERC165
                          _registerInterface(0x5b5e139f); // ERC721 Metadata Interface
                          _tokenURIs[root()] = "crypto";
                          emit NewURI(root(), "crypto");
                      }
                  
                      /// ERC721 Metadata extension
                  
                      function name() external view returns (string memory) {
                          return ".crypto";
                      }
                  
                      function symbol() external view returns (string memory) {
                          return "UD";
                      }
                  
                      function tokenURI(uint256 tokenId) external view returns (string memory) {
                          require(_exists(tokenId));
                          return string(abi.encodePacked(_prefix, _tokenURIs[tokenId]));
                      }
                  
                      function controlledSetTokenURIPrefix(string calldata prefix) external onlyController {
                          _prefix = prefix;
                          emit NewURIPrefix(prefix);
                      }
                  
                      /// Ownership
                  
                      function isApprovedOrOwner(address spender, uint256 tokenId) external view returns (bool) {
                          return _isApprovedOrOwner(spender, tokenId);
                      }
                  
                      /// Registry Constants
                  
                      function root() public pure returns (uint256) {
                          return _CRYPTO_HASH;
                      }
                  
                      function childIdOf(uint256 tokenId, string calldata label) external pure returns (uint256) {
                          return _childId(tokenId, label);
                      }
                  
                      /// Minting
                  
                      function mintChild(address to, uint256 tokenId, string calldata label) external onlyApprovedOrOwner(tokenId) {
                          _mintChild(to, tokenId, label);
                      }
                  
                      function controlledMintChild(address to, uint256 tokenId, string calldata label) external onlyController {
                          _mintChild(to, tokenId, label);
                      }
                  
                      function safeMintChild(address to, uint256 tokenId, string calldata label) external onlyApprovedOrOwner(tokenId) {
                          _safeMintChild(to, tokenId, label, "");
                      }
                  
                      function safeMintChild(address to, uint256 tokenId, string calldata label, bytes calldata _data)
                          external
                          onlyApprovedOrOwner(tokenId)
                      {
                          _safeMintChild(to, tokenId, label, _data);
                      }
                  
                      function controlledSafeMintChild(address to, uint256 tokenId, string calldata label, bytes calldata _data)
                          external
                          onlyController
                      {
                          _safeMintChild(to, tokenId, label, _data);
                      }
                  
                      /// Transfering
                  
                      function setOwner(address to, uint256 tokenId) external onlyApprovedOrOwner(tokenId)  {
                          super._transferFrom(ownerOf(tokenId), to, tokenId);
                      }
                  
                      function transferFromChild(address from, address to, uint256 tokenId, string calldata label)
                          external
                          onlyApprovedOrOwner(tokenId)
                      {
                          _transferFrom(from, to, _childId(tokenId, label));
                      }
                  
                      function controlledTransferFrom(address from, address to, uint256 tokenId) external onlyController {
                          _transferFrom(from, to, tokenId);
                      }
                  
                      function safeTransferFromChild(
                          address from,
                          address to,
                          uint256 tokenId,
                          string memory label,
                          bytes memory _data
                      ) public onlyApprovedOrOwner(tokenId) {
                          uint256 childId = _childId(tokenId, label);
                          _transferFrom(from, to, childId);
                          require(_checkOnERC721Received(from, to, childId, _data));
                      }
                  
                      function safeTransferFromChild(address from, address to, uint256 tokenId, string calldata label) external {
                          safeTransferFromChild(from, to, tokenId, label, "");
                      }
                  
                      function controlledSafeTransferFrom(address from, address to, uint256 tokenId, bytes calldata _data)
                          external
                          onlyController
                      {
                          _transferFrom(from, to, tokenId);
                          require(_checkOnERC721Received(from, to, tokenId, _data));
                      }
                  
                      /// Burning
                  
                      function burnChild(uint256 tokenId, string calldata label) external onlyApprovedOrOwner(tokenId) {
                          _burn(_childId(tokenId, label));
                      }
                  
                      function controlledBurn(uint256 tokenId) external onlyController {
                          _burn(tokenId);
                      }
                  
                      /// Resolution
                  
                      function resolverOf(uint256 tokenId) external view returns (address) {
                          address resolver = _tokenResolvers[tokenId];
                          require(resolver != address(0));
                          return resolver;
                      }
                  
                      function resolveTo(address to, uint256 tokenId) external onlyApprovedOrOwner(tokenId) {
                          _resolveTo(to, tokenId);
                      }
                  
                      function controlledResolveTo(address to, uint256 tokenId) external onlyController {
                          _resolveTo(to, tokenId);
                      }
                  
                      function sync(uint256 tokenId, uint256 updateId) external {
                          require(_tokenResolvers[tokenId] == msg.sender);
                          emit Sync(msg.sender, updateId, tokenId);
                      }
                  
                      /// Internal
                  
                      function _childId(uint256 tokenId, string memory label) internal pure returns (uint256) {
                          require(bytes(label).length != 0);
                          return uint256(keccak256(abi.encodePacked(tokenId, keccak256(abi.encodePacked(label)))));
                      }
                  
                      function _mintChild(address to, uint256 tokenId, string memory label) internal {
                          uint256 childId = _childId(tokenId, label);
                          _mint(to, childId);
                  
                          require(bytes(label).length != 0);
                          require(_exists(childId));
                  
                          bytes memory domain = abi.encodePacked(label, ".", _tokenURIs[tokenId]);
                  
                          _tokenURIs[childId] = string(domain);
                          emit NewURI(childId, string(domain));
                      }
                  
                      function _safeMintChild(address to, uint256 tokenId, string memory label, bytes memory _data) internal {
                          _mintChild(to, tokenId, label);
                          require(_checkOnERC721Received(address(0), to, _childId(tokenId, label), _data));
                      }
                  
                      function _transferFrom(address from, address to, uint256 tokenId) internal {
                          super._transferFrom(from, to, tokenId);
                          // Clear resolver (if any)
                          if (_tokenResolvers[tokenId] != address(0x0)) {
                              delete _tokenResolvers[tokenId];
                          }
                      }
                  
                      function _burn(uint256 tokenId) internal {
                          super._burn(tokenId);
                          // Clear resolver (if any)
                          if (_tokenResolvers[tokenId] != address(0x0)) {
                              delete _tokenResolvers[tokenId];
                          }
                          // Clear metadata (if any)
                          if (bytes(_tokenURIs[tokenId]).length != 0) {
                              delete _tokenURIs[tokenId];
                          }
                      }
                  
                      function _resolveTo(address to, uint256 tokenId) internal {
                          require(_exists(tokenId));
                          emit Resolve(tokenId, to);
                          _tokenResolvers[tokenId] = to;
                      }
                  
                  }

                  File 2 of 8: TransparentUpgradeableProxy
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  import "@openzeppelin/contracts/proxy/ERC1967/ERC1967Proxy.sol";
                  import "@openzeppelin/contracts/proxy/transparent/TransparentUpgradeableProxy.sol";
                  import "@openzeppelin/contracts/proxy/transparent/ProxyAdmin.sol";
                  // Kept for backwards compatibility with older versions of Hardhat and Truffle plugins.
                  contract AdminUpgradeabilityProxy is TransparentUpgradeableProxy {
                      constructor(address logic, address admin, bytes memory data) payable TransparentUpgradeableProxy(logic, admin, data) {}
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  import "../Proxy.sol";
                  import "./ERC1967Upgrade.sol";
                  /**
                   * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
                   * implementation address that can be changed. This address is stored in storage in the location specified by
                   * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
                   * implementation behind the proxy.
                   */
                  contract ERC1967Proxy is Proxy, ERC1967Upgrade {
                      /**
                       * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
                       *
                       * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
                       * function call, and allows initializating the storage of the proxy like a Solidity constructor.
                       */
                      constructor(address _logic, bytes memory _data) payable {
                          assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256("eip1967.proxy.implementation")) - 1));
                          _upgradeToAndCall(_logic, _data, false);
                      }
                      /**
                       * @dev Returns the current implementation address.
                       */
                      function _implementation() internal view virtual override returns (address impl) {
                          return ERC1967Upgrade._getImplementation();
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  import "../ERC1967/ERC1967Proxy.sol";
                  /**
                   * @dev This contract implements a proxy that is upgradeable by an admin.
                   *
                   * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
                   * clashing], which can potentially be used in an attack, this contract uses the
                   * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
                   * things that go hand in hand:
                   *
                   * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
                   * that call matches one of the admin functions exposed by the proxy itself.
                   * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
                   * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
                   * "admin cannot fallback to proxy target".
                   *
                   * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
                   * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
                   * to sudden errors when trying to call a function from the proxy implementation.
                   *
                   * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
                   * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
                   */
                  contract TransparentUpgradeableProxy is ERC1967Proxy {
                      /**
                       * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
                       * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.
                       */
                      constructor(address _logic, address admin_, bytes memory _data) payable ERC1967Proxy(_logic, _data) {
                          assert(_ADMIN_SLOT == bytes32(uint256(keccak256("eip1967.proxy.admin")) - 1));
                          _changeAdmin(admin_);
                      }
                      /**
                       * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
                       */
                      modifier ifAdmin() {
                          if (msg.sender == _getAdmin()) {
                              _;
                          } else {
                              _fallback();
                          }
                      }
                      /**
                       * @dev Returns the current admin.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.
                       *
                       * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
                       * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                       * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
                       */
                      function admin() external ifAdmin returns (address admin_) {
                          admin_ = _getAdmin();
                      }
                      /**
                       * @dev Returns the current implementation.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.
                       *
                       * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
                       * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                       * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
                       */
                      function implementation() external ifAdmin returns (address implementation_) {
                          implementation_ = _implementation();
                      }
                      /**
                       * @dev Changes the admin of the proxy.
                       *
                       * Emits an {AdminChanged} event.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.
                       */
                      function changeAdmin(address newAdmin) external virtual ifAdmin {
                          _changeAdmin(newAdmin);
                      }
                      /**
                       * @dev Upgrade the implementation of the proxy.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.
                       */
                      function upgradeTo(address newImplementation) external ifAdmin {
                          _upgradeToAndCall(newImplementation, bytes(""), false);
                      }
                      /**
                       * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
                       * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
                       * proxied contract.
                       *
                       * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.
                       */
                      function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {
                          _upgradeToAndCall(newImplementation, data, true);
                      }
                      /**
                       * @dev Returns the current admin.
                       */
                      function _admin() internal view virtual returns (address) {
                          return _getAdmin();
                      }
                      /**
                       * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.
                       */
                      function _beforeFallback() internal virtual override {
                          require(msg.sender != _getAdmin(), "TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                          super._beforeFallback();
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  import "./TransparentUpgradeableProxy.sol";
                  import "../../access/Ownable.sol";
                  /**
                   * @dev This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an
                   * explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.
                   */
                  contract ProxyAdmin is Ownable {
                      /**
                       * @dev Returns the current implementation of `proxy`.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function getProxyImplementation(TransparentUpgradeableProxy proxy) public view virtual returns (address) {
                          // We need to manually run the static call since the getter cannot be flagged as view
                          // bytes4(keccak256("implementation()")) == 0x5c60da1b
                          (bool success, bytes memory returndata) = address(proxy).staticcall(hex"5c60da1b");
                          require(success);
                          return abi.decode(returndata, (address));
                      }
                      /**
                       * @dev Returns the current admin of `proxy`.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function getProxyAdmin(TransparentUpgradeableProxy proxy) public view virtual returns (address) {
                          // We need to manually run the static call since the getter cannot be flagged as view
                          // bytes4(keccak256("admin()")) == 0xf851a440
                          (bool success, bytes memory returndata) = address(proxy).staticcall(hex"f851a440");
                          require(success);
                          return abi.decode(returndata, (address));
                      }
                      /**
                       * @dev Changes the admin of `proxy` to `newAdmin`.
                       *
                       * Requirements:
                       *
                       * - This contract must be the current admin of `proxy`.
                       */
                      function changeProxyAdmin(TransparentUpgradeableProxy proxy, address newAdmin) public virtual onlyOwner {
                          proxy.changeAdmin(newAdmin);
                      }
                      /**
                       * @dev Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function upgrade(TransparentUpgradeableProxy proxy, address implementation) public virtual onlyOwner {
                          proxy.upgradeTo(implementation);
                      }
                      /**
                       * @dev Upgrades `proxy` to `implementation` and calls a function on the new implementation. See
                       * {TransparentUpgradeableProxy-upgradeToAndCall}.
                       *
                       * Requirements:
                       *
                       * - This contract must be the admin of `proxy`.
                       */
                      function upgradeAndCall(TransparentUpgradeableProxy proxy, address implementation, bytes memory data) public payable virtual onlyOwner {
                          proxy.upgradeToAndCall{value: msg.value}(implementation, data);
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  /**
                   * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
                   * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
                   * be specified by overriding the virtual {_implementation} function.
                   *
                   * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
                   * different contract through the {_delegate} function.
                   *
                   * The success and return data of the delegated call will be returned back to the caller of the proxy.
                   */
                  abstract contract Proxy {
                      /**
                       * @dev Delegates the current call to `implementation`.
                       *
                       * This function does not return to its internall call site, it will return directly to the external caller.
                       */
                      function _delegate(address implementation) internal virtual {
                          // solhint-disable-next-line no-inline-assembly
                          assembly {
                              // Copy msg.data. We take full control of memory in this inline assembly
                              // block because it will not return to Solidity code. We overwrite the
                              // Solidity scratch pad at memory position 0.
                              calldatacopy(0, 0, calldatasize())
                              // Call the implementation.
                              // out and outsize are 0 because we don't know the size yet.
                              let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
                              // Copy the returned data.
                              returndatacopy(0, 0, returndatasize())
                              switch result
                              // delegatecall returns 0 on error.
                              case 0 { revert(0, returndatasize()) }
                              default { return(0, returndatasize()) }
                          }
                      }
                      /**
                       * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function
                       * and {_fallback} should delegate.
                       */
                      function _implementation() internal view virtual returns (address);
                      /**
                       * @dev Delegates the current call to the address returned by `_implementation()`.
                       *
                       * This function does not return to its internall call site, it will return directly to the external caller.
                       */
                      function _fallback() internal virtual {
                          _beforeFallback();
                          _delegate(_implementation());
                      }
                      /**
                       * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
                       * function in the contract matches the call data.
                       */
                      fallback () external payable virtual {
                          _fallback();
                      }
                      /**
                       * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
                       * is empty.
                       */
                      receive () external payable virtual {
                          _fallback();
                      }
                      /**
                       * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
                       * call, or as part of the Solidity `fallback` or `receive` functions.
                       *
                       * If overriden should call `super._beforeFallback()`.
                       */
                      function _beforeFallback() internal virtual {
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.2;
                  import "../beacon/IBeacon.sol";
                  import "../../utils/Address.sol";
                  import "../../utils/StorageSlot.sol";
                  /**
                   * @dev This abstract contract provides getters and event emitting update functions for
                   * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
                   *
                   * _Available since v4.1._
                   *
                   * @custom:oz-upgrades-unsafe-allow delegatecall
                   */
                  abstract contract ERC1967Upgrade {
                      // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
                      bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
                      /**
                       * @dev Storage slot with the address of the current implementation.
                       * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                      /**
                       * @dev Emitted when the implementation is upgraded.
                       */
                      event Upgraded(address indexed implementation);
                      /**
                       * @dev Returns the current implementation address.
                       */
                      function _getImplementation() internal view returns (address) {
                          return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                      }
                      /**
                       * @dev Stores a new address in the EIP1967 implementation slot.
                       */
                      function _setImplementation(address newImplementation) private {
                          require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                          StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                      }
                      /**
                       * @dev Perform implementation upgrade
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeTo(address newImplementation) internal {
                          _setImplementation(newImplementation);
                          emit Upgraded(newImplementation);
                      }
                      /**
                       * @dev Perform implementation upgrade with additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
                          _setImplementation(newImplementation);
                          emit Upgraded(newImplementation);
                          if (data.length > 0 || forceCall) {
                              Address.functionDelegateCall(newImplementation, data);
                          }
                      }
                      /**
                       * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
                       *
                       * Emits an {Upgraded} event.
                       */
                      function _upgradeToAndCallSecure(address newImplementation, bytes memory data, bool forceCall) internal {
                          address oldImplementation = _getImplementation();
                          // Initial upgrade and setup call
                          _setImplementation(newImplementation);
                          if (data.length > 0 || forceCall) {
                              Address.functionDelegateCall(newImplementation, data);
                          }
                          // Perform rollback test if not already in progress
                          StorageSlot.BooleanSlot storage rollbackTesting = StorageSlot.getBooleanSlot(_ROLLBACK_SLOT);
                          if (!rollbackTesting.value) {
                              // Trigger rollback using upgradeTo from the new implementation
                              rollbackTesting.value = true;
                              Address.functionDelegateCall(
                                  newImplementation,
                                  abi.encodeWithSignature(
                                      "upgradeTo(address)",
                                      oldImplementation
                                  )
                              );
                              rollbackTesting.value = false;
                              // Check rollback was effective
                              require(oldImplementation == _getImplementation(), "ERC1967Upgrade: upgrade breaks further upgrades");
                              // Finally reset to the new implementation and log the upgrade
                              _setImplementation(newImplementation);
                              emit Upgraded(newImplementation);
                          }
                      }
                      /**
                       * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
                       * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
                       *
                       * Emits a {BeaconUpgraded} event.
                       */
                      function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
                          _setBeacon(newBeacon);
                          emit BeaconUpgraded(newBeacon);
                          if (data.length > 0 || forceCall) {
                              Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                          }
                      }
                      /**
                       * @dev Storage slot with the admin of the contract.
                       * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
                       * validated in the constructor.
                       */
                      bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                      /**
                       * @dev Emitted when the admin account has changed.
                       */
                      event AdminChanged(address previousAdmin, address newAdmin);
                      /**
                       * @dev Returns the current admin.
                       */
                      function _getAdmin() internal view returns (address) {
                          return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
                      }
                      /**
                       * @dev Stores a new address in the EIP1967 admin slot.
                       */
                      function _setAdmin(address newAdmin) private {
                          require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                          StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
                      }
                      /**
                       * @dev Changes the admin of the proxy.
                       *
                       * Emits an {AdminChanged} event.
                       */
                      function _changeAdmin(address newAdmin) internal {
                          emit AdminChanged(_getAdmin(), newAdmin);
                          _setAdmin(newAdmin);
                      }
                      /**
                       * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
                       * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
                       */
                      bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
                      /**
                       * @dev Emitted when the beacon is upgraded.
                       */
                      event BeaconUpgraded(address indexed beacon);
                      /**
                       * @dev Returns the current beacon.
                       */
                      function _getBeacon() internal view returns (address) {
                          return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
                      }
                      /**
                       * @dev Stores a new beacon in the EIP1967 beacon slot.
                       */
                      function _setBeacon(address newBeacon) private {
                          require(
                              Address.isContract(newBeacon),
                              "ERC1967: new beacon is not a contract"
                          );
                          require(
                              Address.isContract(IBeacon(newBeacon).implementation()),
                              "ERC1967: beacon implementation is not a contract"
                          );
                          StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  /**
                   * @dev This is the interface that {BeaconProxy} expects of its beacon.
                   */
                  interface IBeacon {
                      /**
                       * @dev Must return an address that can be used as a delegate call target.
                       *
                       * {BeaconProxy} will check that this address is a contract.
                       */
                      function implementation() external view returns (address);
                  }
                  // SPDX-License-Identifier: MIT
                  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;
                          // solhint-disable-next-line no-inline-assembly
                          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");
                          // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                          (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");
                          // solhint-disable-next-line avoid-low-level-calls
                          (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");
                          // solhint-disable-next-line avoid-low-level-calls
                          (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");
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.delegatecall(data);
                          return _verifyCallResult(success, returndata, errorMessage);
                      }
                      function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private 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
                                  // solhint-disable-next-line no-inline-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  /**
                   * @dev Library for reading and writing primitive types to specific storage slots.
                   *
                   * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
                   * This library helps with reading and writing to such slots without the need for inline assembly.
                   *
                   * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
                   *
                   * Example usage to set ERC1967 implementation slot:
                   * ```
                   * contract ERC1967 {
                   *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                   *
                   *     function _getImplementation() internal view returns (address) {
                   *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                   *     }
                   *
                   *     function _setImplementation(address newImplementation) internal {
                   *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                   *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                   *     }
                   * }
                   * ```
                   *
                   * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
                   */
                  library StorageSlot {
                      struct AddressSlot {
                          address value;
                      }
                      struct BooleanSlot {
                          bool value;
                      }
                      struct Bytes32Slot {
                          bytes32 value;
                      }
                      struct Uint256Slot {
                          uint256 value;
                      }
                      /**
                       * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                       */
                      function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                       */
                      function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                       */
                      function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                       */
                      function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                          assembly {
                              r.slot := slot
                          }
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  import "../utils/Context.sol";
                  /**
                   * @dev Contract module which provides a basic access control mechanism, where
                   * there is an account (an owner) that can be granted exclusive access to
                   * specific functions.
                   *
                   * By default, the owner account will be the one that deploys the contract. This
                   * can later be changed with {transferOwnership}.
                   *
                   * This module is used through inheritance. It will make available the modifier
                   * `onlyOwner`, which can be applied to your functions to restrict their use to
                   * the owner.
                   */
                  abstract contract Ownable is Context {
                      address private _owner;
                      event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                      /**
                       * @dev Initializes the contract setting the deployer as the initial owner.
                       */
                      constructor () {
                          address msgSender = _msgSender();
                          _owner = msgSender;
                          emit OwnershipTransferred(address(0), msgSender);
                      }
                      /**
                       * @dev Returns the address of the current owner.
                       */
                      function owner() public view virtual returns (address) {
                          return _owner;
                      }
                      /**
                       * @dev Throws if called by any account other than the owner.
                       */
                      modifier onlyOwner() {
                          require(owner() == _msgSender(), "Ownable: caller is not the owner");
                          _;
                      }
                      /**
                       * @dev Leaves the contract without owner. It will not be possible to call
                       * `onlyOwner` functions anymore. Can only be called by the current owner.
                       *
                       * NOTE: Renouncing ownership will leave the contract without an owner,
                       * thereby removing any functionality that is only available to the owner.
                       */
                      function renounceOwnership() public virtual onlyOwner {
                          emit OwnershipTransferred(_owner, address(0));
                          _owner = address(0);
                      }
                      /**
                       * @dev Transfers ownership of the contract to a new account (`newOwner`).
                       * Can only be called by the current owner.
                       */
                      function transferOwnership(address newOwner) public virtual onlyOwner {
                          require(newOwner != address(0), "Ownable: new owner is the zero address");
                          emit OwnershipTransferred(_owner, newOwner);
                          _owner = newOwner;
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  /*
                   * @dev Provides information about the current execution context, including the
                   * sender of the transaction and its data. While these are generally available
                   * via msg.sender and msg.data, they should not be accessed in such a direct
                   * manner, since when dealing with meta-transactions the account sending and
                   * paying for execution may not be the actual sender (as far as an application
                   * is concerned).
                   *
                   * This contract is only required for intermediate, library-like contracts.
                   */
                  abstract contract Context {
                      function _msgSender() internal view virtual returns (address) {
                          return msg.sender;
                      }
                      function _msgData() internal view virtual returns (bytes calldata) {
                          this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                          return msg.data;
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.0;
                  import "../ERC1967/ERC1967Upgrade.sol";
                  /**
                   * @dev Base contract for building openzeppelin-upgrades compatible implementations for the {ERC1967Proxy}. It includes
                   * publicly available upgrade functions that are called by the plugin and by the secure upgrade mechanism to verify
                   * continuation of the upgradability.
                   *
                   * The {_authorizeUpgrade} function MUST be overridden to include access restriction to the upgrade mechanism.
                   *
                   * _Available since v4.1._
                   */
                  abstract contract UUPSUpgradeable is ERC1967Upgrade {
                      function upgradeTo(address newImplementation) external virtual {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallSecure(newImplementation, bytes(""), false);
                      }
                      function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual {
                          _authorizeUpgrade(newImplementation);
                          _upgradeToAndCallSecure(newImplementation, data, true);
                      }
                      function _authorizeUpgrade(address newImplementation) internal virtual;
                  }
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.8.2;
                  import "@openzeppelin/contracts/proxy/utils/UUPSUpgradeable.sol";
                  abstract contract Proxiable is UUPSUpgradeable {
                      function _authorizeUpgrade(address newImplementation) internal override {
                          _beforeUpgrade(newImplementation);
                      }
                      function _beforeUpgrade(address newImplementation) internal virtual;
                  }
                  contract ChildOfProxiable is Proxiable {
                      function _beforeUpgrade(address newImplementation) internal virtual override {}
                  }
                  

                  File 3 of 8: MintableERC721PredicateProxy
                  // File: contracts/common/Proxy/IERCProxy.sol
                  
                  pragma solidity 0.6.6;
                  
                  interface IERCProxy {
                      function proxyType() external pure returns (uint256 proxyTypeId);
                  
                      function implementation() external view returns (address codeAddr);
                  }
                  
                  // File: contracts/common/Proxy/Proxy.sol
                  
                  pragma solidity 0.6.6;
                  
                  
                  abstract contract Proxy is IERCProxy {
                      function delegatedFwd(address _dst, bytes memory _calldata) internal {
                          // solium-disable-next-line security/no-inline-assembly
                          assembly {
                              let result := delegatecall(
                                  sub(gas(), 10000),
                                  _dst,
                                  add(_calldata, 0x20),
                                  mload(_calldata),
                                  0,
                                  0
                              )
                              let size := returndatasize()
                  
                              let ptr := mload(0x40)
                              returndatacopy(ptr, 0, size)
                  
                              // revert instead of invalid() bc if the underlying call failed with invalid() it already wasted gas.
                              // if the call returned error data, forward it
                              switch result
                                  case 0 {
                                      revert(ptr, size)
                                  }
                                  default {
                                      return(ptr, size)
                                  }
                          }
                      }
                  
                      function proxyType() external virtual override pure returns (uint256 proxyTypeId) {
                          // Upgradeable proxy
                          proxyTypeId = 2;
                      }
                  
                      function implementation() external virtual override view returns (address);
                  }
                  
                  // File: contracts/common/Proxy/UpgradableProxy.sol
                  
                  pragma solidity 0.6.6;
                  
                  
                  contract UpgradableProxy is Proxy {
                      event ProxyUpdated(address indexed _new, address indexed _old);
                      event ProxyOwnerUpdate(address _new, address _old);
                  
                      bytes32 constant IMPLEMENTATION_SLOT = keccak256("matic.network.proxy.implementation");
                      bytes32 constant OWNER_SLOT = keccak256("matic.network.proxy.owner");
                  
                      constructor(address _proxyTo) public {
                          setProxyOwner(msg.sender);
                          setImplementation(_proxyTo);
                      }
                  
                      fallback() external payable {
                          delegatedFwd(loadImplementation(), msg.data);
                      }
                  
                      receive() external payable {
                          delegatedFwd(loadImplementation(), msg.data);
                      }
                  
                      modifier onlyProxyOwner() {
                          require(loadProxyOwner() == msg.sender, "NOT_OWNER");
                          _;
                      }
                  
                      function proxyOwner() external view returns(address) {
                          return loadProxyOwner();
                      }
                  
                      function loadProxyOwner() internal view returns(address) {
                          address _owner;
                          bytes32 position = OWNER_SLOT;
                          assembly {
                              _owner := sload(position)
                          }
                          return _owner;
                      }
                  
                      function implementation() external override view returns (address) {
                          return loadImplementation();
                      }
                  
                      function loadImplementation() internal view returns(address) {
                          address _impl;
                          bytes32 position = IMPLEMENTATION_SLOT;
                          assembly {
                              _impl := sload(position)
                          }
                          return _impl;
                      }
                  
                      function transferProxyOwnership(address newOwner) public onlyProxyOwner {
                          require(newOwner != address(0), "ZERO_ADDRESS");
                          emit ProxyOwnerUpdate(newOwner, loadProxyOwner());
                          setProxyOwner(newOwner);
                      }
                  
                      function setProxyOwner(address newOwner) private {
                          bytes32 position = OWNER_SLOT;
                          assembly {
                              sstore(position, newOwner)
                          }
                      }
                  
                      function updateImplementation(address _newProxyTo) public onlyProxyOwner {
                          require(_newProxyTo != address(0x0), "INVALID_PROXY_ADDRESS");
                          require(isContract(_newProxyTo), "DESTINATION_ADDRESS_IS_NOT_A_CONTRACT");
                  
                          emit ProxyUpdated(_newProxyTo, loadImplementation());
                          
                          setImplementation(_newProxyTo);
                      }
                  
                      function updateAndCall(address _newProxyTo, bytes memory data) payable public onlyProxyOwner {
                          updateImplementation(_newProxyTo);
                  
                          (bool success, bytes memory returnData) = address(this).call{value: msg.value}(data);
                          require(success, string(returnData));
                      }
                  
                      function setImplementation(address _newProxyTo) private {
                          bytes32 position = IMPLEMENTATION_SLOT;
                          assembly {
                              sstore(position, _newProxyTo)
                          }
                      }
                      
                      function isContract(address _target) internal view returns (bool) {
                          if (_target == address(0)) {
                              return false;
                          }
                  
                          uint256 size;
                          assembly {
                              size := extcodesize(_target)
                          }
                          return size > 0;
                      }
                  }
                  
                  // File: contracts/root/TokenPredicates/MintableERC721PredicateProxy.sol
                  
                  pragma solidity 0.6.6;
                  
                  
                  contract MintableERC721PredicateProxy is UpgradableProxy {
                      constructor(address _proxyTo)
                          public
                          UpgradableProxy(_proxyTo)
                      {}
                  }

                  File 4 of 8: StateSender
                  /**
                  Matic network contracts
                  */
                  
                  pragma solidity ^0.5.2;
                  
                  
                  contract Ownable {
                      address private _owner;
                  
                      event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
                  
                      /**
                       * @dev The Ownable constructor sets the original `owner` of the contract to the sender
                       * account.
                       */
                      constructor () internal {
                          _owner = msg.sender;
                          emit OwnershipTransferred(address(0), _owner);
                      }
                  
                      /**
                       * @return the address of the owner.
                       */
                      function owner() public view returns (address) {
                          return _owner;
                      }
                  
                      /**
                       * @dev Throws if called by any account other than the owner.
                       */
                      modifier onlyOwner() {
                          require(isOwner());
                          _;
                      }
                  
                      /**
                       * @return true if `msg.sender` is the owner of the contract.
                       */
                      function isOwner() public view returns (bool) {
                          return msg.sender == _owner;
                      }
                  
                      /**
                       * @dev Allows the current owner to relinquish control of the contract.
                       * It will not be possible to call the functions with the `onlyOwner`
                       * modifier anymore.
                       * @notice Renouncing ownership will leave the contract without an owner,
                       * thereby removing any functionality that is only available to the owner.
                       */
                      function renounceOwnership() public onlyOwner {
                          emit OwnershipTransferred(_owner, address(0));
                          _owner = address(0);
                      }
                  
                      /**
                       * @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 {
                          _transferOwnership(newOwner);
                      }
                  
                      /**
                       * @dev Transfers control of the contract to a newOwner.
                       * @param newOwner The address to transfer ownership to.
                       */
                      function _transferOwnership(address newOwner) internal {
                          require(newOwner != address(0));
                          emit OwnershipTransferred(_owner, newOwner);
                          _owner = newOwner;
                      }
                  }
                  
                  library SafeMath {
                      /**
                       * @dev Multiplies two unsigned integers, reverts on overflow.
                       */
                      function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                          // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                          // benefit is lost if 'b' is also tested.
                          // See: https://github.com/OpenZeppelin/openzeppelin-solidity/pull/522
                          if (a == 0) {
                              return 0;
                          }
                  
                          uint256 c = a * b;
                          require(c / a == b);
                  
                          return c;
                      }
                  
                      /**
                       * @dev Integer division of two unsigned integers truncating the quotient, reverts on division by zero.
                       */
                      function div(uint256 a, uint256 b) internal pure returns (uint256) {
                          // Solidity only automatically asserts when dividing by 0
                          require(b > 0);
                          uint256 c = a / b;
                          // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                  
                          return c;
                      }
                  
                      /**
                       * @dev Subtracts two unsigned integers, reverts on overflow (i.e. if subtrahend is greater than minuend).
                       */
                      function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                          require(b <= a);
                          uint256 c = a - b;
                  
                          return c;
                      }
                  
                      /**
                       * @dev Adds two unsigned integers, reverts on overflow.
                       */
                      function add(uint256 a, uint256 b) internal pure returns (uint256) {
                          uint256 c = a + b;
                          require(c >= a);
                  
                          return c;
                      }
                  
                      /**
                       * @dev Divides two unsigned integers and returns the remainder (unsigned integer modulo),
                       * reverts when dividing by zero.
                       */
                      function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                          require(b != 0);
                          return a % b;
                      }
                  }
                  
                  contract StateSender is Ownable {
                      using SafeMath for uint256;
                  
                      uint256 public counter;
                      mapping(address => address) public registrations;
                  
                      event NewRegistration(
                          address indexed user,
                          address indexed sender,
                          address indexed receiver
                      );
                      event RegistrationUpdated(
                          address indexed user,
                          address indexed sender,
                          address indexed receiver
                      );
                      event StateSynced(
                          uint256 indexed id,
                          address indexed contractAddress,
                          bytes data
                      );
                  
                      modifier onlyRegistered(address receiver) {
                          require(registrations[receiver] == msg.sender, "Invalid sender");
                          _;
                      }
                  
                      function syncState(address receiver, bytes calldata data)
                          external
                          onlyRegistered(receiver)
                      {
                          counter = counter.add(1);
                          emit StateSynced(counter, receiver, data);
                      }
                  
                      // register new contract for state sync
                      function register(address sender, address receiver) public {
                          require(
                              isOwner() || registrations[receiver] == msg.sender,
                              "StateSender.register: Not authorized to register"
                          );
                          registrations[receiver] = sender;
                          if (registrations[receiver] == address(0)) {
                              emit NewRegistration(msg.sender, sender, receiver);
                          } else {
                              emit RegistrationUpdated(msg.sender, sender, receiver);
                          }
                      }
                  }

                  File 5 of 8: UNSRegistry
                  // @author Unstoppable Domains, Inc.
                  // @date June 16th, 2021
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol';
                  import '@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol';
                  import './ChildRegistry.sol';
                  import './cns/ICNSRegistry.sol';
                  import './IUNSRegistry.sol';
                  import './RecordStorage.sol';
                  import './RootRegistry.sol';
                  import './metatx/ERC2771RegistryContext.sol';
                  import './metatx/UNSRegistryForwarder.sol';
                  /**
                   * @title UNSRegistry
                   * @dev An ERC721 Token see https://eips.ethereum.org/EIPS/eip-721. With
                   * additional functions so other trusted contracts to interact with the tokens.
                   */
                  contract UNSRegistry is
                      ERC721Upgradeable,
                      ERC2771RegistryContext,
                      RecordStorage,
                      UNSRegistryForwarder,
                      RootRegistry,
                      ChildRegistry,
                      IUNSRegistry
                  {
                      string public constant NAME = 'UNS: Registry';
                      string public constant VERSION = '0.5.0';
                      string internal _prefix;
                      address internal _mintingManager;
                      mapping(address => uint256) internal _reverses;
                      modifier onlyApprovedOrOwner(uint256 tokenId) {
                          require(_isApprovedOrOwner(_msgSender(), tokenId), 'Registry: SENDER_IS_NOT_APPROVED_OR_OWNER');
                          _;
                      }
                      modifier onlyMintingManager() {
                          require(_msgSender() == _mintingManager, 'Registry: SENDER_IS_NOT_MINTING_MANAGER');
                          _;
                      }
                      modifier protectTokenOperation(uint256 tokenId) {
                          if (isTrustedForwarder(msg.sender)) {
                              require(tokenId == _msgToken(), 'Registry: TOKEN_INVALID');
                          } else {
                              _invalidateNonce(tokenId);
                          }
                          _;
                      }
                      modifier onlyOwner(uint256 tokenId) {
                          require(ownerOf(tokenId) == _msgSender(), 'Registry: SENDER_IS_NOT_OWNER');
                          _;
                      }
                      function initialize(address mintingManager) public initializer {
                          _mintingManager = mintingManager;
                          __ERC721_init_unchained('Unstoppable Domains', 'UD');
                          __ERC2771RegistryContext_init_unchained();
                          __UNSRegistryForwarder_init_unchained();
                      }
                      /// ERC721 Metadata extension
                      function setTokenURIPrefix(string calldata prefix) external override onlyMintingManager {
                          _prefix = prefix;
                          emit NewURIPrefix(prefix);
                      }
                      /// Ownership
                      function isApprovedOrOwner(address spender, uint256 tokenId) external view override returns (bool) {
                          return _isApprovedOrOwner(spender, tokenId);
                      }
                      function approve(address to, uint256 tokenId)
                          public
                          override(IERC721Upgradeable, ERC721Upgradeable)
                          protectTokenOperation(tokenId)
                      {
                          super.approve(to, tokenId);
                      }
                      /// Registry Constants
                      function root() public pure returns (uint256) {
                          return 0;
                      }
                      function childIdOf(uint256 tokenId, string calldata label) external pure override returns (uint256) {
                          return _childId(tokenId, label);
                      }
                      function exists(uint256 tokenId) external view override(IUNSRegistry, IMintableERC721) returns (bool) {
                          return _exists(tokenId);
                      }
                      /// Minting
                      function mint(
                          address to,
                          uint256 tokenId,
                          string calldata uri
                      ) external override onlyMintingManager {
                          _mint(to, tokenId, uri);
                      }
                      function safeMint(
                          address to,
                          uint256 tokenId,
                          string calldata uri
                      ) external override onlyMintingManager {
                          _safeMint(to, tokenId, uri, '');
                      }
                      function safeMint(
                          address to,
                          uint256 tokenId,
                          string calldata uri,
                          bytes calldata data
                      ) external override onlyMintingManager {
                          _safeMint(to, tokenId, uri, data);
                      }
                      function mintWithRecords(
                          address to,
                          uint256 tokenId,
                          string calldata uri,
                          string[] calldata keys,
                          string[] calldata values
                      ) external override onlyMintingManager {
                          _mint(to, tokenId, uri);
                          _setMany(keys, values, tokenId);
                      }
                      function safeMintWithRecords(
                          address to,
                          uint256 tokenId,
                          string calldata uri,
                          string[] calldata keys,
                          string[] calldata values
                      ) external override onlyMintingManager {
                          _safeMintWithRecords(to, tokenId, uri, keys, values, '');
                      }
                      function safeMintWithRecords(
                          address to,
                          uint256 tokenId,
                          string calldata uri,
                          string[] calldata keys,
                          string[] calldata values,
                          bytes calldata data
                      ) external override onlyMintingManager {
                          _safeMintWithRecords(to, tokenId, uri, keys, values, data);
                      }
                      /// Transfering
                      function setOwner(address to, uint256 tokenId)
                          external
                          override
                          onlyApprovedOrOwner(tokenId)
                          protectTokenOperation(tokenId)
                      {
                          _transfer(ownerOf(tokenId), to, tokenId);
                      }
                      function transferFrom(
                          address from,
                          address to,
                          uint256 tokenId
                      )
                          public
                          override(IERC721Upgradeable, ERC721Upgradeable)
                          onlyApprovedOrOwner(tokenId)
                          protectTokenOperation(tokenId)
                      {
                          _reset(tokenId);
                          _transfer(from, to, tokenId);
                      }
                      function safeTransferFrom(
                          address from,
                          address to,
                          uint256 tokenId,
                          bytes memory data
                      )
                          public
                          override(IERC721Upgradeable, ERC721Upgradeable)
                          onlyApprovedOrOwner(tokenId)
                          protectTokenOperation(tokenId)
                      {
                          _reset(tokenId);
                          _safeTransfer(from, to, tokenId, data);
                      }
                      // Token's migration from CNS
                      // This is the keccak-256 hash of "uns.cns_registry" subtracted by 1
                      bytes32 internal constant _CNS_REGISTRY_SLOT = 0x8ffb960699dc2ba88f34d0e41c029c3c36c95149679fe1d0153a9582bec92378;
                      function setCNSRegistry(address registry) external override {
                          require(
                              StorageSlotUpgradeable.getAddressSlot(_CNS_REGISTRY_SLOT).value == address(0),
                              'Registry: CNS_REGISTRY_NOT_EMPTY'
                          );
                          StorageSlotUpgradeable.getAddressSlot(_CNS_REGISTRY_SLOT).value = registry;
                      }
                      function onERC721Received(
                          address,
                          address from,
                          uint256 tokenId,
                          bytes calldata data
                      ) external override returns (bytes4) {
                          if(_msgSender() == StorageSlotUpgradeable.getAddressSlot(_CNS_REGISTRY_SLOT).value) {
                              ICNSRegistry(_msgSender()).burn(tokenId);
                              if(data.length > 0 && abi.decode(data, (bool))) {
                                  _mint(address(this), tokenId);
                                  _deposit(from, tokenId);
                              } else {
                                  _mint(from, tokenId);
                              }
                              return UNSRegistry.onERC721Received.selector;
                          }
                          revert('Registry: ERC721_RECEIVING_PROHIBITED');
                      }
                      /// Burning
                      function burn(uint256 tokenId) external override onlyApprovedOrOwner(tokenId) protectTokenOperation(tokenId) {
                          _reset(tokenId);
                          _burn(tokenId);
                      }
                      /// Resolution
                      function resolverOf(uint256 tokenId) external view override returns (address) {
                          return _exists(tokenId) ? address(this) : address(0x0);
                      }
                      function set(
                          string calldata key,
                          string calldata value,
                          uint256 tokenId
                      ) external override onlyApprovedOrOwner(tokenId) protectTokenOperation(tokenId) {
                          _set(key, value, tokenId);
                      }
                      function setMany(
                          string[] calldata keys,
                          string[] calldata values,
                          uint256 tokenId
                      ) external override onlyApprovedOrOwner(tokenId) protectTokenOperation(tokenId) {
                          _setMany(keys, values, tokenId);
                      }
                      function setByHash(
                          uint256 keyHash,
                          string calldata value,
                          uint256 tokenId
                      ) external override onlyApprovedOrOwner(tokenId) protectTokenOperation(tokenId) {
                          _setByHash(keyHash, value, tokenId);
                      }
                      function setManyByHash(
                          uint256[] calldata keyHashes,
                          string[] calldata values,
                          uint256 tokenId
                      ) external override onlyApprovedOrOwner(tokenId) protectTokenOperation(tokenId) {
                          _setManyByHash(keyHashes, values, tokenId);
                      }
                      function reconfigure(
                          string[] calldata keys,
                          string[] calldata values,
                          uint256 tokenId
                      ) external override onlyApprovedOrOwner(tokenId) protectTokenOperation(tokenId) {
                          _reconfigure(keys, values, tokenId);
                      }
                      function reset(uint256 tokenId) external override onlyApprovedOrOwner(tokenId) protectTokenOperation(tokenId) {
                          _reset(tokenId);
                      }
                      /**
                       * @dev See {IRootRegistry-depositToPolygon}.
                       */
                      function depositToPolygon(uint256 tokenId) external override onlyApprovedOrOwner(tokenId) {
                          // A workaround for MintableERC721Predicate
                          // that requires a depositor to be equal to token owner:
                          // https://github.com/maticnetwork/pos-portal/blob/88dbf0a88fd68fa11f7a3b9d36629930f6b93a05/contracts/root/TokenPredicates/MintableERC721Predicate.sol#L94
                          _transfer(_msgSender(), address(this), tokenId);
                          _deposit(_msgSender(), tokenId);
                      }
                      /**
                       * @dev See {IRootRegistry-withdrawFromPolygon}.
                       */
                      function withdrawFromPolygon(
                          bytes calldata inputData,
                          uint256 tokenId,
                          string[] calldata keys,
                          string[] calldata values
                      ) external override {
                          _withdraw(inputData);
                          require(ownerOf(tokenId) == _msgSender(), 'Registry: SENDER_IS_NOT_OWNER');
                          _setMany(keys, values, tokenId);
                      }
                      /**
                       * @dev See {RootRegistry-mint(address,uint256)}.
                       */
                      function mint(address user, uint256 tokenId) external override onlyPredicate {
                          _mint(user, tokenId);
                      }
                      /**
                       * @dev See {RootRegistry-mint(address,uint256,bytes)}.
                       */
                      function mint(address user, uint256 tokenId, bytes calldata) external override onlyPredicate {
                          _mint(user, tokenId);
                      }
                      /**
                       * @dev See {IERC165-supportsInterface}.
                       */
                      function supportsInterface(bytes4 interfaceId)
                          public
                          view
                          override(ERC721Upgradeable, IERC165Upgradeable)
                          returns (bool)
                      {
                          return super.supportsInterface(interfaceId);
                      }
                      /**
                       * @dev See {IReverseRegistry-setReverse}.
                       */
                      function setReverse(uint256 tokenId) external override onlyOwner(tokenId) protectTokenOperation(tokenId) {
                          _setReverse(_msgSender(), tokenId);
                      }
                      /**
                       * @dev See {IReverseRegistry-removeReverse}.
                       */
                      function removeReverse() external override {
                          address sender = _msgSender();
                          require(_reverses[sender] != 0, 'Registry: REVERSE_RECORD_IS_EMPTY');
                          _removeReverse(sender);
                      }
                      /**
                       * @dev See {IReverseRegistry-reverseOf}.
                       */
                      function reverseOf(address addr) external view override returns (uint256) {
                          return _reverses[addr];
                      }
                      /// Internal
                      function _childId(uint256 tokenId, string memory label) internal pure returns (uint256) {
                          require(bytes(label).length != 0, 'Registry: LABEL_EMPTY');
                          return uint256(keccak256(abi.encodePacked(tokenId, keccak256(abi.encodePacked(label)))));
                      }
                      function _mint(
                          address to,
                          uint256 tokenId,
                          string memory uri
                      ) internal {
                          _mint(to, tokenId);
                          emit NewURI(tokenId, uri);
                          /// set reverse must be after emission of New URL event in order to keep events' order
                          _safeSetReverse(to, tokenId);
                      }
                      function _safeMint(
                          address to,
                          uint256 tokenId,
                          string memory uri,
                          bytes memory data
                      ) internal {
                          _safeMint(to, tokenId, data);
                          emit NewURI(tokenId, uri);
                          /// set reverse must be after emission of New URL event in order to keep events' order
                          _safeSetReverse(to, tokenId);
                      }
                      function _safeMintWithRecords(
                          address to,
                          uint256 tokenId,
                          string calldata uri,
                          string[] calldata keys,
                          string[] calldata values,
                          bytes memory data
                      ) internal {
                          _safeMint(to, tokenId, uri, data);
                          _setMany(keys, values, tokenId);
                      }
                      function _baseURI() internal view override(ERC721Upgradeable) returns (string memory) {
                          return _prefix;
                      }
                      function _msgSender() internal view override(ContextUpgradeable, ERC2771RegistryContext) returns (address) {
                          return super._msgSender();
                      }
                      function _msgData() internal view override(ContextUpgradeable, ERC2771RegistryContext) returns (bytes calldata) {
                          return super._msgData();
                      }
                      function _beforeTokenTransfer(address from, address to, uint256 amount) internal override {
                          super._beforeTokenTransfer(from, to, amount);
                          if(_reverses[from] != 0) {
                              _removeReverse(from);
                          }
                      }
                      function _setReverse(address addr, uint256 tokenId) internal {
                          _reverses[addr] = tokenId;
                          emit SetReverse(addr, tokenId);
                      }
                      function _safeSetReverse(address addr, uint256 tokenId) internal {
                          if(address(0xdead) != addr && _reverses[addr] == 0) {
                              _setReverse(addr, tokenId);
                          }
                      }
                      function _removeReverse(address addr) internal {
                          delete _reverses[addr];
                          emit RemoveReverse(addr);
                      }
                      // Reserved storage space to allow for layout changes in the future.
                      uint256[49] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/ERC721.sol)
                  pragma solidity ^0.8.0;
                  import "./IERC721Upgradeable.sol";
                  import "./IERC721ReceiverUpgradeable.sol";
                  import "./extensions/IERC721MetadataUpgradeable.sol";
                  import "../../utils/AddressUpgradeable.sol";
                  import "../../utils/ContextUpgradeable.sol";
                  import "../../utils/StringsUpgradeable.sol";
                  import "../../utils/introspection/ERC165Upgradeable.sol";
                  import "../../proxy/utils/Initializable.sol";
                  /**
                   * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
                   * the Metadata extension, but not including the Enumerable extension, which is available separately as
                   * {ERC721Enumerable}.
                   */
                  contract ERC721Upgradeable is Initializable, ContextUpgradeable, ERC165Upgradeable, IERC721Upgradeable, IERC721MetadataUpgradeable {
                      using AddressUpgradeable for address;
                      using StringsUpgradeable for uint256;
                      // Token name
                      string private _name;
                      // Token symbol
                      string private _symbol;
                      // Mapping from token ID to owner address
                      mapping(uint256 => address) private _owners;
                      // Mapping owner address to token count
                      mapping(address => uint256) private _balances;
                      // Mapping from token ID to approved address
                      mapping(uint256 => address) private _tokenApprovals;
                      // Mapping from owner to operator approvals
                      mapping(address => mapping(address => bool)) private _operatorApprovals;
                      /**
                       * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
                       */
                      function __ERC721_init(string memory name_, string memory symbol_) internal onlyInitializing {
                          __ERC721_init_unchained(name_, symbol_);
                      }
                      function __ERC721_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
                          _name = name_;
                          _symbol = symbol_;
                      }
                      /**
                       * @dev See {IERC165-supportsInterface}.
                       */
                      function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165Upgradeable, IERC165Upgradeable) returns (bool) {
                          return
                              interfaceId == type(IERC721Upgradeable).interfaceId ||
                              interfaceId == type(IERC721MetadataUpgradeable).interfaceId ||
                              super.supportsInterface(interfaceId);
                      }
                      /**
                       * @dev See {IERC721-balanceOf}.
                       */
                      function balanceOf(address owner) public view virtual override returns (uint256) {
                          require(owner != address(0), "ERC721: address zero is not a valid owner");
                          return _balances[owner];
                      }
                      /**
                       * @dev See {IERC721-ownerOf}.
                       */
                      function ownerOf(uint256 tokenId) public view virtual override returns (address) {
                          address owner = _owners[tokenId];
                          require(owner != address(0), "ERC721: invalid token ID");
                          return owner;
                      }
                      /**
                       * @dev See {IERC721Metadata-name}.
                       */
                      function name() public view virtual override returns (string memory) {
                          return _name;
                      }
                      /**
                       * @dev See {IERC721Metadata-symbol}.
                       */
                      function symbol() public view virtual override returns (string memory) {
                          return _symbol;
                      }
                      /**
                       * @dev See {IERC721Metadata-tokenURI}.
                       */
                      function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                          _requireMinted(tokenId);
                          string memory baseURI = _baseURI();
                          return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
                      }
                      /**
                       * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
                       * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
                       * by default, can be overridden in child contracts.
                       */
                      function _baseURI() internal view virtual returns (string memory) {
                          return "";
                      }
                      /**
                       * @dev See {IERC721-approve}.
                       */
                      function approve(address to, uint256 tokenId) public virtual override {
                          address owner = ERC721Upgradeable.ownerOf(tokenId);
                          require(to != owner, "ERC721: approval to current owner");
                          require(
                              _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                              "ERC721: approve caller is not token owner nor approved for all"
                          );
                          _approve(to, tokenId);
                      }
                      /**
                       * @dev See {IERC721-getApproved}.
                       */
                      function getApproved(uint256 tokenId) public view virtual override returns (address) {
                          _requireMinted(tokenId);
                          return _tokenApprovals[tokenId];
                      }
                      /**
                       * @dev See {IERC721-setApprovalForAll}.
                       */
                      function setApprovalForAll(address operator, bool approved) public virtual override {
                          _setApprovalForAll(_msgSender(), operator, approved);
                      }
                      /**
                       * @dev See {IERC721-isApprovedForAll}.
                       */
                      function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
                          return _operatorApprovals[owner][operator];
                      }
                      /**
                       * @dev See {IERC721-transferFrom}.
                       */
                      function transferFrom(
                          address from,
                          address to,
                          uint256 tokenId
                      ) public virtual override {
                          //solhint-disable-next-line max-line-length
                          require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved");
                          _transfer(from, to, tokenId);
                      }
                      /**
                       * @dev See {IERC721-safeTransferFrom}.
                       */
                      function safeTransferFrom(
                          address from,
                          address to,
                          uint256 tokenId
                      ) public virtual override {
                          safeTransferFrom(from, to, tokenId, "");
                      }
                      /**
                       * @dev See {IERC721-safeTransferFrom}.
                       */
                      function safeTransferFrom(
                          address from,
                          address to,
                          uint256 tokenId,
                          bytes memory data
                      ) public virtual override {
                          require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved");
                          _safeTransfer(from, to, tokenId, data);
                      }
                      /**
                       * @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.
                       *
                       * `data` is additional data, it has no specified format and it is sent in call to `to`.
                       *
                       * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
                       * implement alternative mechanisms to perform token transfer, such as signature-based.
                       *
                       * Requirements:
                       *
                       * - `from` cannot be the zero address.
                       * - `to` cannot be the zero address.
                       * - `tokenId` token must exist and be owned by `from`.
                       * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                       *
                       * Emits a {Transfer} event.
                       */
                      function _safeTransfer(
                          address from,
                          address to,
                          uint256 tokenId,
                          bytes memory data
                      ) internal virtual {
                          _transfer(from, to, tokenId);
                          require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer");
                      }
                      /**
                       * @dev Returns whether `tokenId` exists.
                       *
                       * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
                       *
                       * Tokens start existing when they are minted (`_mint`),
                       * and stop existing when they are burned (`_burn`).
                       */
                      function _exists(uint256 tokenId) internal view virtual returns (bool) {
                          return _owners[tokenId] != address(0);
                      }
                      /**
                       * @dev Returns whether `spender` is allowed to manage `tokenId`.
                       *
                       * Requirements:
                       *
                       * - `tokenId` must exist.
                       */
                      function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
                          address owner = ERC721Upgradeable.ownerOf(tokenId);
                          return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
                      }
                      /**
                       * @dev Safely mints `tokenId` and transfers it to `to`.
                       *
                       * Requirements:
                       *
                       * - `tokenId` must not exist.
                       * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
                       *
                       * Emits a {Transfer} event.
                       */
                      function _safeMint(address to, uint256 tokenId) internal virtual {
                          _safeMint(to, tokenId, "");
                      }
                      /**
                       * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
                       * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
                       */
                      function _safeMint(
                          address to,
                          uint256 tokenId,
                          bytes memory data
                      ) internal virtual {
                          _mint(to, tokenId);
                          require(
                              _checkOnERC721Received(address(0), to, tokenId, data),
                              "ERC721: transfer to non ERC721Receiver implementer"
                          );
                      }
                      /**
                       * @dev Mints `tokenId` and transfers it to `to`.
                       *
                       * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
                       *
                       * Requirements:
                       *
                       * - `tokenId` must not exist.
                       * - `to` cannot be the zero address.
                       *
                       * Emits a {Transfer} event.
                       */
                      function _mint(address to, uint256 tokenId) internal virtual {
                          require(to != address(0), "ERC721: mint to the zero address");
                          require(!_exists(tokenId), "ERC721: token already minted");
                          _beforeTokenTransfer(address(0), to, tokenId);
                          _balances[to] += 1;
                          _owners[tokenId] = to;
                          emit Transfer(address(0), to, tokenId);
                          _afterTokenTransfer(address(0), to, tokenId);
                      }
                      /**
                       * @dev Destroys `tokenId`.
                       * The approval is cleared when the token is burned.
                       *
                       * Requirements:
                       *
                       * - `tokenId` must exist.
                       *
                       * Emits a {Transfer} event.
                       */
                      function _burn(uint256 tokenId) internal virtual {
                          address owner = ERC721Upgradeable.ownerOf(tokenId);
                          _beforeTokenTransfer(owner, address(0), tokenId);
                          // Clear approvals
                          _approve(address(0), tokenId);
                          _balances[owner] -= 1;
                          delete _owners[tokenId];
                          emit Transfer(owner, address(0), tokenId);
                          _afterTokenTransfer(owner, address(0), tokenId);
                      }
                      /**
                       * @dev Transfers `tokenId` from `from` to `to`.
                       *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
                       *
                       * Requirements:
                       *
                       * - `to` cannot be the zero address.
                       * - `tokenId` token must be owned by `from`.
                       *
                       * Emits a {Transfer} event.
                       */
                      function _transfer(
                          address from,
                          address to,
                          uint256 tokenId
                      ) internal virtual {
                          require(ERC721Upgradeable.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
                          require(to != address(0), "ERC721: transfer to the zero address");
                          _beforeTokenTransfer(from, to, tokenId);
                          // Clear approvals from the previous owner
                          _approve(address(0), tokenId);
                          _balances[from] -= 1;
                          _balances[to] += 1;
                          _owners[tokenId] = to;
                          emit Transfer(from, to, tokenId);
                          _afterTokenTransfer(from, to, tokenId);
                      }
                      /**
                       * @dev Approve `to` to operate on `tokenId`
                       *
                       * Emits an {Approval} event.
                       */
                      function _approve(address to, uint256 tokenId) internal virtual {
                          _tokenApprovals[tokenId] = to;
                          emit Approval(ERC721Upgradeable.ownerOf(tokenId), to, tokenId);
                      }
                      /**
                       * @dev Approve `operator` to operate on all of `owner` tokens
                       *
                       * Emits an {ApprovalForAll} event.
                       */
                      function _setApprovalForAll(
                          address owner,
                          address operator,
                          bool approved
                      ) internal virtual {
                          require(owner != operator, "ERC721: approve to caller");
                          _operatorApprovals[owner][operator] = approved;
                          emit ApprovalForAll(owner, operator, approved);
                      }
                      /**
                       * @dev Reverts if the `tokenId` has not been minted yet.
                       */
                      function _requireMinted(uint256 tokenId) internal view virtual {
                          require(_exists(tokenId), "ERC721: invalid token ID");
                      }
                      /**
                       * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
                       * The call is not executed if the target address is not a contract.
                       *
                       * @param from address representing the previous owner of the given token ID
                       * @param to target address that will receive the tokens
                       * @param tokenId uint256 ID of the token to be transferred
                       * @param data bytes optional data to send along with the call
                       * @return bool whether the call correctly returned the expected magic value
                       */
                      function _checkOnERC721Received(
                          address from,
                          address to,
                          uint256 tokenId,
                          bytes memory data
                      ) private returns (bool) {
                          if (to.isContract()) {
                              try IERC721ReceiverUpgradeable(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
                                  return retval == IERC721ReceiverUpgradeable.onERC721Received.selector;
                              } catch (bytes memory reason) {
                                  if (reason.length == 0) {
                                      revert("ERC721: transfer to non ERC721Receiver implementer");
                                  } else {
                                      /// @solidity memory-safe-assembly
                                      assembly {
                                          revert(add(32, reason), mload(reason))
                                      }
                                  }
                              }
                          } else {
                              return true;
                          }
                      }
                      /**
                       * @dev Hook that is called before any token transfer. This includes minting
                       * and burning.
                       *
                       * Calling conditions:
                       *
                       * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
                       * transferred to `to`.
                       * - When `from` is zero, `tokenId` will be minted for `to`.
                       * - When `to` is zero, ``from``'s `tokenId` will be burned.
                       * - `from` and `to` are never both zero.
                       *
                       * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
                       */
                      function _beforeTokenTransfer(
                          address from,
                          address to,
                          uint256 tokenId
                      ) internal virtual {}
                      /**
                       * @dev Hook that is called after any transfer of tokens. This includes
                       * minting and burning.
                       *
                       * Calling conditions:
                       *
                       * - when `from` and `to` are both non-zero.
                       * - `from` and `to` are never both zero.
                       *
                       * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
                       */
                      function _afterTokenTransfer(
                          address from,
                          address to,
                          uint256 tokenId
                      ) internal virtual {}
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[44] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/StorageSlot.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev Library for reading and writing primitive types to specific storage slots.
                   *
                   * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
                   * This library helps with reading and writing to such slots without the need for inline assembly.
                   *
                   * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
                   *
                   * Example usage to set ERC1967 implementation slot:
                   * ```
                   * contract ERC1967 {
                   *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                   *
                   *     function _getImplementation() internal view returns (address) {
                   *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                   *     }
                   *
                   *     function _setImplementation(address newImplementation) internal {
                   *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                   *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                   *     }
                   * }
                   * ```
                   *
                   * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
                   */
                  library StorageSlotUpgradeable {
                      struct AddressSlot {
                          address value;
                      }
                      struct BooleanSlot {
                          bool value;
                      }
                      struct Bytes32Slot {
                          bytes32 value;
                      }
                      struct Uint256Slot {
                          uint256 value;
                      }
                      /**
                       * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                       */
                      function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                       */
                      function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                       */
                      function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                      /**
                       * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                       */
                      function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                          /// @solidity memory-safe-assembly
                          assembly {
                              r.slot := slot
                          }
                      }
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date December 20th, 2021
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol';
                  import '@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol';
                  import './IChildRegistry.sol';
                  abstract contract ChildRegistry is ERC721Upgradeable, IChildRegistry {
                      // limit batching of tokens due to gas limit restrictions
                      uint256 public constant BATCH_LIMIT = 20;
                      // This is the keccak-256 hash of "uns.polygon.child_chain_manager" subtracted by 1
                      bytes32 internal constant _CHILD_CHAIN_MANAGER_SLOT = 0x8bea9a6f8afd34f4e29c585f854e0cc5161431bf5fc299d468454d33dce53b87;
                      function setChildChainManager(address clientChainManager) external {
                          require(
                              StorageSlotUpgradeable.getAddressSlot(_CHILD_CHAIN_MANAGER_SLOT).value == address(0),
                              'Registry: CHILD_CHAIN_MANEGER_NOT_EMPTY'
                          );
                          StorageSlotUpgradeable.getAddressSlot(_CHILD_CHAIN_MANAGER_SLOT).value = clientChainManager;
                      }
                      function deposit(address user, bytes calldata depositData) external override {
                          require(
                              _msgSender() == StorageSlotUpgradeable.getAddressSlot(_CHILD_CHAIN_MANAGER_SLOT).value,
                              'Registry: INSUFFICIENT_PERMISSIONS'
                          );
                          // deposit single
                          if (depositData.length == 32) {
                              uint256 tokenId = abi.decode(depositData, (uint256));
                              _mint(user, tokenId);
                          // deposit batch
                          } else {
                              uint256[] memory tokenIds = abi.decode(depositData, (uint256[]));
                              uint256 length = tokenIds.length;
                              for (uint256 i; i < length; i++) {
                                  _mint(user, tokenIds[i]);
                              }
                          }
                      }
                      function withdraw(uint256 tokenId) external override {
                          require(_msgSender() == ownerOf(tokenId), "Registry: INVALID_TOKEN_OWNER");
                          _burn(tokenId);
                      }
                      function withdrawBatch(uint256[] calldata tokenIds) external override {
                          uint256 length = tokenIds.length;
                          require(length <= BATCH_LIMIT, "Registry: EXCEEDS_BATCH_LIMIT");
                          // Iteratively burn ERC721 tokens, for performing
                          // batch withdraw
                          for (uint256 i; i < length; i++) {
                              uint256 tokenId = tokenIds[i];
                              require(
                                  _msgSender() == ownerOf(tokenId),
                                  string(abi.encodePacked("Registry: INVALID_TOKEN_OWNER ", tokenId))
                              );
                              _burn(tokenId);
                          }
                          // At last emit this event, which will be used
                          // in MintableERC721 predicate contract on L1
                          // while verifying burn proof
                          emit WithdrawnBatch(_msgSender(), tokenIds);
                      }
                      function withdrawWithMetadata(uint256 tokenId) external override {
                          require(_msgSender() == ownerOf(tokenId), "Registry: INVALID_TOKEN_OWNER");
                          _burn(tokenId);
                      }
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date June 16th, 2021
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/token/ERC721/extensions/IERC721MetadataUpgradeable.sol';
                  interface ICNSRegistry is IERC721MetadataUpgradeable {
                      function isApprovedOrOwner(address spender, uint256 tokenId) external view returns (bool);
                      function resolverOf(uint256 tokenId) external view returns (address);
                      function childIdOf(uint256 tokenId, string calldata label) external view returns (uint256);
                      function burn(uint256 tokenId) external;
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date June 16th, 2021
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/token/ERC721/extensions/IERC721MetadataUpgradeable.sol';
                  import '@openzeppelin/contracts-upgradeable/token/ERC721/IERC721ReceiverUpgradeable.sol';
                  import './IERC1967.sol';
                  import './IRecordStorage.sol';
                  import './IReverseRegistry.sol';
                  import './IRootRegistry.sol';
                  import './IChildRegistry.sol';
                  interface IUNSRegistry is
                      IERC1967,
                      IERC721MetadataUpgradeable,
                      IERC721ReceiverUpgradeable,
                      IRecordStorage,
                      IReverseRegistry,
                      IRootRegistry,
                      IChildRegistry
                  {
                      event NewURI(uint256 indexed tokenId, string uri);
                      event NewURIPrefix(string prefix);
                      /**
                       * @dev Function to set the token URI Prefix for all tokens.
                       * @param prefix string URI to assign
                       */
                      function setTokenURIPrefix(string calldata prefix) external;
                      /**
                       * @dev Returns whether the given spender can transfer a given token ID.
                       * @param spender address of the spender to query
                       * @param tokenId uint256 ID of the token to be transferred
                       * @return bool whether the msg.sender is approved for the given token ID,
                       * is an operator of the owner, or is the owner of the token
                       */
                      function isApprovedOrOwner(address spender, uint256 tokenId) external view returns (bool);
                      /**
                       * @dev Gets the resolver of the specified token ID.
                       * @param tokenId uint256 ID of the token to query the resolver of
                       * @return address currently marked as the resolver of the given token ID
                       */
                      function resolverOf(uint256 tokenId) external view returns (address);
                      /**
                       * @dev Provides child token (subdomain) of provided tokenId.
                       * @param tokenId uint256 ID of the token
                       * @param label label of subdomain (for `aaa.bbb.crypto` it will be `aaa`)
                       */
                      function childIdOf(uint256 tokenId, string calldata label) external pure returns (uint256);
                      /**
                       * @dev Existence of token.
                       * @param tokenId uint256 ID of the token
                       */
                      function exists(uint256 tokenId) external override view returns (bool);
                      /**
                       * @dev Transfer domain ownership without resetting domain records.
                       * @param to address of new domain owner
                       * @param tokenId uint256 ID of the token to be transferred
                       */
                      function setOwner(address to, uint256 tokenId) external;
                      /**
                       * @dev Burns `tokenId`. See {ERC721-_burn}.
                       *
                       * Requirements:
                       *
                       * - The caller must own `tokenId` or be an approved operator.
                       */
                      function burn(uint256 tokenId) external;
                      /**
                       * @dev Mints token.
                       * @param to address to mint the new SLD to.
                       * @param tokenId id of token.
                       * @param uri domain URI.
                       */
                      function mint(
                          address to,
                          uint256 tokenId,
                          string calldata uri
                      ) external;
                      /**
                       * @dev Safely mints token.
                       * Implements a ERC721Reciever check unlike mint.
                       * @param to address to mint the new SLD to.
                       * @param tokenId id of token.
                       * @param uri domain URI.
                       */
                      function safeMint(
                          address to,
                          uint256 tokenId,
                          string calldata uri
                      ) external;
                      /**
                       * @dev Safely mints token.
                       * Implements a ERC721Reciever check unlike mint.
                       * @param to address to mint the new SLD to.
                       * @param tokenId id of token.
                       * @param uri domain URI.
                       * @param data bytes data to send along with a safe transfer check
                       */
                      function safeMint(
                          address to,
                          uint256 tokenId,
                          string calldata uri,
                          bytes calldata data
                      ) external;
                      /**
                       * @dev Mints token with records
                       * @param to address to mint the new SLD to
                       * @param tokenId id of token
                       * @param keys New record keys
                       * @param values New record values
                       * @param uri domain URI
                       */
                      function mintWithRecords(
                          address to,
                          uint256 tokenId,
                          string calldata uri,
                          string[] calldata keys,
                          string[] calldata values
                      ) external;
                      /**
                       * @dev Safely mints token with records
                       * @param to address to mint the new SLD to
                       * @param tokenId id of token
                       * @param keys New record keys
                       * @param values New record values
                       * @param uri domain URI
                       */
                      function safeMintWithRecords(
                          address to,
                          uint256 tokenId,
                          string calldata uri,
                          string[] calldata keys,
                          string[] calldata values
                      ) external;
                      /**
                       * @dev Safely mints token with records
                       * @param to address to mint the new SLD to
                       * @param tokenId id of token
                       * @param keys New record keys
                       * @param values New record values
                       * @param uri domain URI
                       * @param data bytes data to send along with a safe transfer check
                       */
                      function safeMintWithRecords(
                          address to,
                          uint256 tokenId,
                          string calldata uri,
                          string[] calldata keys,
                          string[] calldata values,
                          bytes calldata data
                      ) external;
                      /**
                       * @dev Stores CNS registry address.
                       * It's one-time operation required to set CNS registry address.
                       * UNS registry allows to receive ERC721 tokens only from CNS registry,
                       * by supporting ERC721Receiver interface.
                       * @param registry address of CNS registry contract
                       */
                      function setCNSRegistry(address registry) external;
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date June 16th, 2021
                  pragma solidity ^0.8.0;
                  import './IRecordStorage.sol';
                  import './KeyStorage.sol';
                  abstract contract RecordStorage is KeyStorage, IRecordStorage {
                      /// @dev mapping of presetIds to keyIds to values
                      mapping(uint256 => mapping(uint256 => string)) internal _records;
                      /// @dev mapping of tokenIds to presetIds
                      mapping(uint256 => uint256) internal _tokenPresets;
                      function get(string calldata key, uint256 tokenId) external view override returns (string memory value) {
                          value = _get(key, tokenId);
                      }
                      function getMany(string[] calldata keys, uint256 tokenId) external view override returns (string[] memory values) {
                          values = new string[](keys.length);
                          for (uint256 i = 0; i < keys.length; i++) {
                              values[i] = _get(keys[i], tokenId);
                          }
                      }
                      function getByHash(uint256 keyHash, uint256 tokenId)
                          external
                          view
                          override
                          returns (string memory key, string memory value)
                      {
                          (key, value) = _getByHash(keyHash, tokenId);
                      }
                      function getManyByHash(uint256[] calldata keyHashes, uint256 tokenId)
                          external
                          view
                          override
                          returns (string[] memory keys, string[] memory values)
                      {
                          keys = new string[](keyHashes.length);
                          values = new string[](keyHashes.length);
                          for (uint256 i = 0; i < keyHashes.length; i++) {
                              (keys[i], values[i]) = _getByHash(keyHashes[i], tokenId);
                          }
                      }
                      function _presetOf(uint256 tokenId) internal view virtual returns (uint256) {
                          return _tokenPresets[tokenId] == 0 ? tokenId : _tokenPresets[tokenId];
                      }
                      function _set(
                          string calldata key,
                          string calldata value,
                          uint256 tokenId
                      ) internal {
                          uint256 keyHash = uint256(keccak256(abi.encodePacked(key)));
                          _addKey(keyHash, key);
                          _set(keyHash, key, value, tokenId);
                      }
                      function _setMany(
                          string[] calldata keys,
                          string[] calldata values,
                          uint256 tokenId
                      ) internal {
                          for (uint256 i = 0; i < keys.length; i++) {
                              _set(keys[i], values[i], tokenId);
                          }
                      }
                      function _setByHash(
                          uint256 keyHash,
                          string calldata value,
                          uint256 tokenId
                      ) internal {
                          require(_existsKey(keyHash), 'RecordStorage: KEY_NOT_FOUND');
                          _set(keyHash, getKey(keyHash), value, tokenId);
                      }
                      function _setManyByHash(
                          uint256[] calldata keyHashes,
                          string[] calldata values,
                          uint256 tokenId
                      ) internal {
                          for (uint256 i = 0; i < keyHashes.length; i++) {
                              _setByHash(keyHashes[i], values[i], tokenId);
                          }
                      }
                      function _reconfigure(
                          string[] calldata keys,
                          string[] calldata values,
                          uint256 tokenId
                      ) internal {
                          _reset(tokenId);
                          _setMany(keys, values, tokenId);
                      }
                      function _reset(uint256 tokenId) internal {
                          _tokenPresets[tokenId] = uint256(keccak256(abi.encodePacked(_presetOf(tokenId))));
                          emit ResetRecords(tokenId);
                      }
                      function _get(string memory key, uint256 tokenId) private view returns (string memory) {
                          return _get(uint256(keccak256(abi.encodePacked(key))), tokenId);
                      }
                      function _getByHash(uint256 keyHash, uint256 tokenId)
                          private
                          view
                          returns (string memory key, string memory value)
                      {
                          key = getKey(keyHash);
                          value = _get(keyHash, tokenId);
                      }
                      function _get(uint256 keyHash, uint256 tokenId) private view returns (string memory) {
                          return _records[_presetOf(tokenId)][keyHash];
                      }
                      function _set(
                          uint256 keyHash,
                          string memory key,
                          string memory value,
                          uint256 tokenId
                      ) private {
                          if (bytes(_records[_presetOf(tokenId)][keyHash]).length == 0) {
                              emit NewKey(tokenId, key, key);
                          }
                          _records[_presetOf(tokenId)][keyHash] = value;
                          emit Set(tokenId, key, value, key, value);
                      }
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date December 20th, 2021
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol';
                  import '@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol';
                  import './IRootRegistry.sol';
                  import './@maticnetwork/IRootChainManager.sol';
                  import './@maticnetwork/RootChainManagerStorage.sol';
                  abstract contract RootRegistry is ERC721Upgradeable, IRootRegistry {
                      // This is the keccak-256 hash of "uns.polygon.root_chain_manager" subtracted by 1
                      bytes32 internal constant _ROOT_CHAIN_MANAGER_SLOT = 0xbe2bb46ac0377341a1ec5c3116d70fd5029d704bd46292e58f6265dd177ebafe;
                      modifier onlyPredicate() {
                          require(_msgSender() == _getPredicate(), 'Registry: INSUFFICIENT_PERMISSIONS');
                          _;
                      }
                      function setRootChainManager(address rootChainManager) external override {
                          require(
                              StorageSlotUpgradeable.getAddressSlot(_ROOT_CHAIN_MANAGER_SLOT).value == address(0),
                              'Registry: ROOT_CHAIN_MANEGER_NOT_EMPTY'
                          );
                          StorageSlotUpgradeable.getAddressSlot(_ROOT_CHAIN_MANAGER_SLOT).value = rootChainManager;
                      }
                      function _deposit(address to, uint256 tokenId) internal {
                          address predicate = _getPredicate();
                          _approve(predicate, tokenId);
                          address manager = StorageSlotUpgradeable.getAddressSlot(_ROOT_CHAIN_MANAGER_SLOT).value;
                          IRootChainManager(manager).depositFor(to, address(this), abi.encode(tokenId));
                      }
                      function _withdraw(bytes calldata inputData) internal {
                          address manager = StorageSlotUpgradeable.getAddressSlot(_ROOT_CHAIN_MANAGER_SLOT).value;
                          IRootChainManager(manager).exit(inputData);
                      }
                      function _getPredicate() internal view returns(address predicate) {
                          address manager = StorageSlotUpgradeable.getAddressSlot(_ROOT_CHAIN_MANAGER_SLOT).value;
                          bytes32 tokenType = RootChainManagerStorage(manager).tokenToType(address(this));
                          predicate = RootChainManagerStorage(manager).typeToPredicate(tokenType);
                      }
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date June 16th, 2021
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol';
                  import '@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol';
                  /**
                   * @dev https://eips.ethereum.org/EIPS/eip-2771[EIP 2771] is a standard for native meta transactions.
                   *
                   * A base contract to be inherited by any contract that want to receive forwarded transactions.
                   * The contract designed to be stateless, it supports a scenario when a inherited contract is
                   * TrustedForwarder and Recipient at the same time.
                   *
                   * The contract supports token based nonce, that is why standard calldata extended by tokenId.
                   *
                   * Forwarded calldata layout: {bytes:data}{address:from}{uint256:tokenId}
                   */
                  abstract contract ERC2771RegistryContext is Initializable, ContextUpgradeable {
                      // solhint-disable-next-line func-name-mixedcase
                      function __ERC2771RegistryContext_init() internal onlyInitializing {
                          __Context_init_unchained();
                          __ERC2771RegistryContext_init_unchained();
                      }
                      // solhint-disable-next-line func-name-mixedcase
                      function __ERC2771RegistryContext_init_unchained() internal onlyInitializing {}
                      /**
                       * @dev Return bool whether provided address is the trusted forwarder.
                       */
                      function isTrustedForwarder(address forwarder) public view virtual returns (bool) {
                          return forwarder == address(this);
                      }
                      /**
                       * @dev Return the tokenId of this call.
                       * If the call came through our trusted forwarder, return the original tokenId.
                       * otherwise, return zero tokenId.
                       */
                      function _msgToken() internal view virtual returns (uint256 tokenId) {
                          if (isTrustedForwarder(msg.sender)) {
                              assembly {
                                  tokenId := calldataload(sub(calldatasize(), 32))
                              }
                          }
                      }
                      /**
                       * @dev Return the sender of this call.
                       * If the call came through our trusted forwarder, return the original sender.
                       * otherwise, return `msg.sender`.
                       * Should be used in the contract anywhere instead of msg.sender
                       */
                      function _msgSender() internal view virtual override returns (address sender) {
                          if (isTrustedForwarder(msg.sender)) {
                              // The assembly code is more direct than the Solidity version using `abi.decode`.
                              assembly {
                                  sender := shr(96, calldataload(sub(calldatasize(), 52)))
                              }
                          } else {
                              return super._msgSender();
                          }
                      }
                      /**
                       * @dev Return the data of this call.
                       * If the call came through our trusted forwarder, return the original data.
                       * otherwise, return `msg.data`.
                       * Should be used in the contract anywhere instead of msg.data
                       */
                      function _msgData() internal view virtual override returns (bytes calldata) {
                          if (isTrustedForwarder(msg.sender)) {
                              return msg.data[:msg.data.length - 52];
                          } else {
                              return super._msgData();
                          }
                      }
                      uint256[50] private __gap;
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date June 16th, 2021
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol';
                  import './BaseForwarder.sol';
                  abstract contract EIP712UpgradeableGap {
                      /* solhint-disable var-name-mixedcase */
                      bytes32 private _HASHED_NAME;
                      bytes32 private _HASHED_VERSION;
                      uint256[50] private __gap;
                      /* solhint-enable var-name-mixedcase */
                  }
                  /**
                   * @dev https://eips.ethereum.org/EIPS/eip-2771[EIP 2771] is a standard for native meta transactions.
                   *
                   * A base contract to be inherited by any contract that want to forward transactions.
                   */
                  abstract contract UNSRegistryForwarder is Initializable, EIP712UpgradeableGap, BaseForwarder {
                      mapping(uint256 => uint256) private _nonces;
                      // solhint-disable-next-line func-name-mixedcase
                      function __UNSRegistryForwarder_init() internal onlyInitializing {
                          __UNSRegistryForwarder_init_unchained();
                      }
                      // solhint-disable-next-line func-name-mixedcase
                      function __UNSRegistryForwarder_init_unchained() internal onlyInitializing {}
                      function nonceOf(uint256 tokenId) public view override returns (uint256) {
                          return _nonces[tokenId];
                      }
                      function verify(ForwardRequest calldata req, bytes calldata signature) public view override returns (bool) {
                          return _verify(req, address(this), signature);
                      }
                      function execute(ForwardRequest calldata req, bytes calldata signature) public override returns (bytes memory) {
                          uint256 gas = gasleft();
                          require(verify(req, signature), 'UNSRegistryForwarder: SIGNATURE_INVALID');
                          return _execute(req.from, address(this), req.tokenId, gas, req.data, signature);
                      }
                      function _invalidateNonce(uint256 tokenId) internal override {
                          _nonces[tokenId] = _nonces[tokenId] + 1;
                      }
                      uint256[50] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/IERC721.sol)
                  pragma solidity ^0.8.0;
                  import "../../utils/introspection/IERC165Upgradeable.sol";
                  /**
                   * @dev Required interface of an ERC721 compliant contract.
                   */
                  interface IERC721Upgradeable is IERC165Upgradeable {
                      /**
                       * @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: 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 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 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 v4.6.0) (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 IERC721ReceiverUpgradeable {
                      /**
                       * @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 v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
                  pragma solidity ^0.8.0;
                  import "../IERC721Upgradeable.sol";
                  /**
                   * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
                   * @dev See https://eips.ethereum.org/EIPS/eip-721
                   */
                  interface IERC721MetadataUpgradeable is IERC721Upgradeable {
                      /**
                       * @dev Returns the token collection name.
                       */
                      function name() external view returns (string memory);
                      /**
                       * @dev Returns the token collection symbol.
                       */
                      function symbol() external view returns (string memory);
                      /**
                       * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
                       */
                      function tokenURI(uint256 tokenId) external view returns (string memory);
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol)
                  pragma solidity ^0.8.1;
                  /**
                   * @dev Collection of functions related to the address type
                   */
                  library AddressUpgradeable {
                      /**
                       * @dev Returns true if `account` is a contract.
                       *
                       * [IMPORTANT]
                       * ====
                       * It is unsafe to assume that an address for which this function returns
                       * false is an externally-owned account (EOA) and not a contract.
                       *
                       * Among others, `isContract` will return false for the following
                       * types of addresses:
                       *
                       *  - an externally-owned account
                       *  - a contract in construction
                       *  - an address where a contract will be created
                       *  - an address where a contract lived, but was destroyed
                       * ====
                       *
                       * [IMPORTANT]
                       * ====
                       * You shouldn't rely on `isContract` to protect against flash loan attacks!
                       *
                       * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
                       * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
                       * constructor.
                       * ====
                       */
                      function isContract(address account) internal view returns (bool) {
                          // This method relies on extcodesize/address.code.length, which returns 0
                          // for contracts in construction, since the code is only stored at the end
                          // of the constructor execution.
                          return account.code.length > 0;
                      }
                      /**
                       * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                       * `recipient`, forwarding all available gas and reverting on errors.
                       *
                       * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                       * of certain opcodes, possibly making contracts go over the 2300 gas limit
                       * imposed by `transfer`, making them unable to receive funds via
                       * `transfer`. {sendValue} removes this limitation.
                       *
                       * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                       *
                       * IMPORTANT: because control is transferred to `recipient`, care must be
                       * taken to not create reentrancy vulnerabilities. Consider using
                       * {ReentrancyGuard} or the
                       * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                       */
                      function sendValue(address payable recipient, uint256 amount) internal {
                          require(address(this).balance >= amount, "Address: insufficient balance");
                          (bool success, ) = recipient.call{value: amount}("");
                          require(success, "Address: unable to send value, recipient may have reverted");
                      }
                      /**
                       * @dev Performs a Solidity function call using a low level `call`. A
                       * plain `call` is an unsafe replacement for a function call: use this
                       * function instead.
                       *
                       * If `target` reverts with a revert reason, it is bubbled up by this
                       * function (like regular Solidity function calls).
                       *
                       * Returns the raw returned data. To convert to the expected return value,
                       * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                       *
                       * Requirements:
                       *
                       * - `target` must be a contract.
                       * - calling `target` with `data` must not revert.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                          return functionCall(target, data, "Address: low-level call failed");
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                       * `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCall(
                          address target,
                          bytes memory data,
                          string memory errorMessage
                      ) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, 0, errorMessage);
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but also transferring `value` wei to `target`.
                       *
                       * Requirements:
                       *
                       * - the calling contract must have an ETH balance of at least `value`.
                       * - the called Solidity function must be `payable`.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(
                          address target,
                          bytes memory data,
                          uint256 value
                      ) internal returns (bytes memory) {
                          return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                      }
                      /**
                       * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                       * with `errorMessage` as a fallback revert reason when `target` reverts.
                       *
                       * _Available since v3.1._
                       */
                      function functionCallWithValue(
                          address target,
                          bytes memory data,
                          uint256 value,
                          string memory errorMessage
                      ) internal returns (bytes memory) {
                          require(address(this).balance >= value, "Address: insufficient balance for call");
                          require(isContract(target), "Address: call to non-contract");
                          (bool success, bytes memory returndata) = target.call{value: value}(data);
                          return verifyCallResult(success, returndata, errorMessage);
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                          return functionStaticCall(target, data, "Address: low-level static call failed");
                      }
                      /**
                       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                       * but performing a static call.
                       *
                       * _Available since v3.3._
                       */
                      function functionStaticCall(
                          address target,
                          bytes memory data,
                          string memory errorMessage
                      ) internal view returns (bytes memory) {
                          require(isContract(target), "Address: static call to non-contract");
                          (bool success, bytes memory returndata) = target.staticcall(data);
                          return verifyCallResult(success, returndata, errorMessage);
                      }
                      /**
                       * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
                       * revert reason using the provided one.
                       *
                       * _Available since v4.3._
                       */
                      function verifyCallResult(
                          bool success,
                          bytes memory returndata,
                          string memory errorMessage
                      ) internal pure returns (bytes memory) {
                          if (success) {
                              return returndata;
                          } else {
                              // Look for revert reason and bubble it up if present
                              if (returndata.length > 0) {
                                  // The easiest way to bubble the revert reason is using memory via assembly
                                  /// @solidity memory-safe-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
                  pragma solidity ^0.8.0;
                  import "../proxy/utils/Initializable.sol";
                  /**
                   * @dev Provides information about the current execution context, including the
                   * sender of the transaction and its data. While these are generally available
                   * via msg.sender and msg.data, they should not be accessed in such a direct
                   * manner, since when dealing with meta-transactions the account sending and
                   * paying for execution may not be the actual sender (as far as an application
                   * is concerned).
                   *
                   * This contract is only required for intermediate, library-like contracts.
                   */
                  abstract contract ContextUpgradeable is Initializable {
                      function __Context_init() internal onlyInitializing {
                      }
                      function __Context_init_unchained() internal onlyInitializing {
                      }
                      function _msgSender() internal view virtual returns (address) {
                          return msg.sender;
                      }
                      function _msgData() internal view virtual returns (bytes calldata) {
                          return msg.data;
                      }
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[50] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev String operations.
                   */
                  library StringsUpgradeable {
                      bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
                      uint8 private constant _ADDRESS_LENGTH = 20;
                      /**
                       * @dev Converts a `uint256` to its ASCII `string` decimal representation.
                       */
                      function toString(uint256 value) internal pure returns (string memory) {
                          // Inspired by OraclizeAPI's implementation - MIT licence
                          // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
                          if (value == 0) {
                              return "0";
                          }
                          uint256 temp = value;
                          uint256 digits;
                          while (temp != 0) {
                              digits++;
                              temp /= 10;
                          }
                          bytes memory buffer = new bytes(digits);
                          while (value != 0) {
                              digits -= 1;
                              buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                              value /= 10;
                          }
                          return string(buffer);
                      }
                      /**
                       * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
                       */
                      function toHexString(uint256 value) internal pure returns (string memory) {
                          if (value == 0) {
                              return "0x00";
                          }
                          uint256 temp = value;
                          uint256 length = 0;
                          while (temp != 0) {
                              length++;
                              temp >>= 8;
                          }
                          return toHexString(value, length);
                      }
                      /**
                       * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
                       */
                      function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                          bytes memory buffer = new bytes(2 * length + 2);
                          buffer[0] = "0";
                          buffer[1] = "x";
                          for (uint256 i = 2 * length + 1; i > 1; --i) {
                              buffer[i] = _HEX_SYMBOLS[value & 0xf];
                              value >>= 4;
                          }
                          require(value == 0, "Strings: hex length insufficient");
                          return string(buffer);
                      }
                      /**
                       * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
                       */
                      function toHexString(address addr) internal pure returns (string memory) {
                          return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
                  pragma solidity ^0.8.0;
                  import "./IERC165Upgradeable.sol";
                  import "../../proxy/utils/Initializable.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 ERC165Upgradeable is Initializable, IERC165Upgradeable {
                      function __ERC165_init() internal onlyInitializing {
                      }
                      function __ERC165_init_unchained() internal onlyInitializing {
                      }
                      /**
                       * @dev See {IERC165-supportsInterface}.
                       */
                      function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                          return interfaceId == type(IERC165Upgradeable).interfaceId;
                      }
                      /**
                       * @dev This empty reserved space is put in place to allow future versions to add new
                       * variables without shifting down storage in the inheritance chain.
                       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
                       */
                      uint256[50] private __gap;
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (proxy/utils/Initializable.sol)
                  pragma solidity ^0.8.2;
                  import "../../utils/AddressUpgradeable.sol";
                  /**
                   * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
                   * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
                   * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
                   * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
                   *
                   * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
                   * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
                   * case an upgrade adds a module that needs to be initialized.
                   *
                   * For example:
                   *
                   * [.hljs-theme-light.nopadding]
                   * ```
                   * contract MyToken is ERC20Upgradeable {
                   *     function initialize() initializer public {
                   *         __ERC20_init("MyToken", "MTK");
                   *     }
                   * }
                   * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
                   *     function initializeV2() reinitializer(2) public {
                   *         __ERC20Permit_init("MyToken");
                   *     }
                   * }
                   * ```
                   *
                   * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
                   * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
                   *
                   * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
                   * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
                   *
                   * [CAUTION]
                   * ====
                   * Avoid leaving a contract uninitialized.
                   *
                   * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
                   * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
                   * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
                   *
                   * [.hljs-theme-light.nopadding]
                   * ```
                   * /// @custom:oz-upgrades-unsafe-allow constructor
                   * constructor() {
                   *     _disableInitializers();
                   * }
                   * ```
                   * ====
                   */
                  abstract contract Initializable {
                      /**
                       * @dev Indicates that the contract has been initialized.
                       * @custom:oz-retyped-from bool
                       */
                      uint8 private _initialized;
                      /**
                       * @dev Indicates that the contract is in the process of being initialized.
                       */
                      bool private _initializing;
                      /**
                       * @dev Triggered when the contract has been initialized or reinitialized.
                       */
                      event Initialized(uint8 version);
                      /**
                       * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
                       * `onlyInitializing` functions can be used to initialize parent contracts. Equivalent to `reinitializer(1)`.
                       */
                      modifier initializer() {
                          bool isTopLevelCall = !_initializing;
                          require(
                              (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
                              "Initializable: contract is already initialized"
                          );
                          _initialized = 1;
                          if (isTopLevelCall) {
                              _initializing = true;
                          }
                          _;
                          if (isTopLevelCall) {
                              _initializing = false;
                              emit Initialized(1);
                          }
                      }
                      /**
                       * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
                       * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
                       * used to initialize parent contracts.
                       *
                       * `initializer` is equivalent to `reinitializer(1)`, so a reinitializer may be used after the original
                       * initialization step. This is essential to configure modules that are added through upgrades and that require
                       * initialization.
                       *
                       * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
                       * a contract, executing them in the right order is up to the developer or operator.
                       */
                      modifier reinitializer(uint8 version) {
                          require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
                          _initialized = version;
                          _initializing = true;
                          _;
                          _initializing = false;
                          emit Initialized(version);
                      }
                      /**
                       * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
                       * {initializer} and {reinitializer} modifiers, directly or indirectly.
                       */
                      modifier onlyInitializing() {
                          require(_initializing, "Initializable: contract is not initializing");
                          _;
                      }
                      /**
                       * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
                       * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
                       * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
                       * through proxies.
                       */
                      function _disableInitializers() internal virtual {
                          require(!_initializing, "Initializable: contract is initializing");
                          if (_initialized < type(uint8).max) {
                              _initialized = type(uint8).max;
                              emit Initialized(type(uint8).max);
                          }
                      }
                  }
                  // 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 IERC165Upgradeable {
                      /**
                       * @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);
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date December 21st, 2021
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/token/ERC721/IERC721Upgradeable.sol';
                  import './@maticnetwork/IChildToken.sol';
                  interface IChildRegistry is IERC721Upgradeable, IChildToken {
                      event WithdrawnBatch(address indexed user, uint256[] tokenIds);
                      /**
                       * @notice called when user wants to withdraw token back to root chain
                       * @dev Should handle withraw by burning user's token.
                       * This transaction will be verified when exiting on root chain
                       * @param tokenId tokenId to withdraw
                       */
                      function withdraw(uint256 tokenId) external;
                      /**
                       * @notice called when user wants to withdraw multiple tokens back to root chain
                       * @dev Should burn user's tokens. This transaction will be verified when exiting on root chain
                       * @param tokenIds tokenId list to withdraw
                       */
                      function withdrawBatch(uint256[] calldata tokenIds) external;
                      /**
                       * @notice called when user wants to withdraw token back to root chain with token URI
                       * @dev Should handle withraw by burning user's token.
                       * This transaction will be verified when exiting on root chain
                       * @param tokenId tokenId to withdraw
                       */
                      function withdrawWithMetadata(uint256 tokenId) external;
                  }
                  pragma solidity ^0.8.0;
                  interface IChildToken {
                      /**
                       * @notice called when token is deposited on root chain
                       * @dev Should be callable only by ChildChainManager
                       * Should handle deposit by minting the required tokenId for user
                       * Make sure minting is done only by this function
                       * @param user user address for whom deposit is being done
                       * @param depositData abi encoded tokenId
                       */
                      function deposit(address user, bytes calldata depositData) external;
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date December 22nd, 2021
                  pragma solidity ^0.8.0;
                  interface IERC1967 {
                      /**
                       * @dev Emitted when the implementation is upgraded.
                       */
                      event Upgraded(address indexed implementation);
                      /**
                       * @dev Emitted when the admin account has changed.
                       */
                      event AdminChanged(address previousAdmin, address newAdmin);
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date June 16th, 2021
                  pragma solidity ^0.8.0;
                  import './IRecordReader.sol';
                  interface IRecordStorage is IRecordReader {
                      event Set(uint256 indexed tokenId, string indexed keyIndex, string indexed valueIndex, string key, string value);
                      event NewKey(uint256 indexed tokenId, string indexed keyIndex, string key);
                      event ResetRecords(uint256 indexed tokenId);
                      /**
                       * @dev Set record by key
                       * @param key The key set the value of
                       * @param value The value to set key to
                       * @param tokenId ERC-721 token id to set
                       */
                      function set(
                          string calldata key,
                          string calldata value,
                          uint256 tokenId
                      ) external;
                      /**
                       * @dev Set records by keys
                       * @param keys The keys set the values of
                       * @param values Records values
                       * @param tokenId ERC-721 token id of the domain
                       */
                      function setMany(
                          string[] memory keys,
                          string[] memory values,
                          uint256 tokenId
                      ) external;
                      /**
                       * @dev Set record by key hash
                       * @param keyHash The key hash set the value of
                       * @param value The value to set key to
                       * @param tokenId ERC-721 token id to set
                       */
                      function setByHash(
                          uint256 keyHash,
                          string calldata value,
                          uint256 tokenId
                      ) external;
                      /**
                       * @dev Set records by key hashes
                       * @param keyHashes The key hashes set the values of
                       * @param values Records values
                       * @param tokenId ERC-721 token id of the domain
                       */
                      function setManyByHash(
                          uint256[] calldata keyHashes,
                          string[] calldata values,
                          uint256 tokenId
                      ) external;
                      /**
                       * @dev Reset all domain records and set new ones
                       * @param keys New record keys
                       * @param values New record values
                       * @param tokenId ERC-721 token id of the domain
                       */
                      function reconfigure(
                          string[] memory keys,
                          string[] memory values,
                          uint256 tokenId
                      ) external;
                      /**
                       * @dev Function to reset all existing records on a domain.
                       * @param tokenId ERC-721 token id to set.
                       */
                      function reset(uint256 tokenId) external;
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date March 29th, 2022
                  pragma solidity ^0.8.0;
                  /**
                   * @title Reverse registry interface
                   */
                  interface IReverseRegistry {
                      /**
                       * @dev Emitted when the reverse record is set.
                       */
                      event SetReverse(address indexed addr, uint256 indexed tokenId);
                      /**
                       * @dev Emitted when the reverse record is removed.
                       */
                      event RemoveReverse(address indexed addr);
                      /**
                       * @dev Sets the reverse record associated with the calling account.
                       * @param tokenId The token to set for this address.
                       */
                      function setReverse(uint256 tokenId) external;
                      /**
                       * @dev Removes the reverse record associated with the calling account.
                       */
                      function removeReverse() external;
                      /**
                       * @dev Returns the reverse record for a given account's reverse record.
                       * @param addr The address of the reverse record.
                       * @return tokenId The token associated with the address.
                       */
                      function reverseOf(address addr) external view returns (uint256);
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date December 21st, 2021
                  pragma solidity ^0.8.0;
                  import './@maticnetwork/IMintableERC721.sol';
                  interface IRootRegistry is IMintableERC721 {
                      /**
                       * @dev Stores RootChainManager address.
                       * It's one-time operation required to set RootChainManager address.
                       * RootChainManager is a contract responsible for bridging Ethereum
                       * and Polygon networks.
                       * @param rootChainManager address of RootChainManager contract
                       */
                      function setRootChainManager(address rootChainManager) external;
                      /**
                       * @dev Deposits token to Polygon through RootChainManager contract.
                       * @param tokenId id of token
                       */
                      function depositToPolygon(uint256 tokenId) external;
                      /**
                       * @dev Exit from Polygon through RootChainManager contract.
                       *      It withdraws token with records update.
                       * @param tokenId id of token
                       * @param keys New record keys
                       * @param values New record values
                       */
                      function withdrawFromPolygon(
                          bytes calldata inputData,
                          uint256 tokenId,
                          string[] calldata keys,
                          string[] calldata values
                      ) external;
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date June 16th, 2021
                  pragma solidity ^0.8.0;
                  interface IRecordReader {
                      /**
                       * @dev Function to get record.
                       * @param key The key to query the value of.
                       * @param tokenId The token id to fetch.
                       * @return The value string.
                       */
                      function get(string calldata key, uint256 tokenId) external view returns (string memory);
                      /**
                       * @dev Function to get multiple record.
                       * @param keys The keys to query the value of.
                       * @param tokenId The token id to fetch.
                       * @return The values.
                       */
                      function getMany(string[] calldata keys, uint256 tokenId) external view returns (string[] memory);
                      /**
                       * @dev Function get value by provied key hash.
                       * @param keyHash The key to query the value of.
                       * @param tokenId The token id to set.
                       */
                      function getByHash(uint256 keyHash, uint256 tokenId) external view returns (string memory key, string memory value);
                      /**
                       * @dev Function get values by provied key hashes.
                       * @param keyHashes The key to query the value of.
                       * @param tokenId The token id to set.
                       */
                      function getManyByHash(uint256[] calldata keyHashes, uint256 tokenId)
                          external
                          view
                          returns (string[] memory keys, string[] memory values);
                  }
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/token/ERC721/IERC721Upgradeable.sol';
                  interface IMintableERC721 is IERC721Upgradeable {
                      /**
                       * @notice called by predicate contract to mint tokens while withdrawing
                       * @dev Should be callable only by MintableERC721Predicate
                       * Make sure minting is done only by this function
                       * @param user user address for whom token is being minted
                       * @param tokenId tokenId being minted
                       */
                      function mint(address user, uint256 tokenId) external;
                      /**
                       * @notice called by predicate contract to mint tokens while withdrawing with metadata from L2
                       * @dev Should be callable only by MintableERC721Predicate
                       * Make sure minting is only done either by this function/ 👆
                       * @param user user address for whom token is being minted
                       * @param tokenId tokenId being minted
                       * @param metaData Associated token metadata, to be decoded & set using `setTokenMetadata`
                       */
                      function mint(address user, uint256 tokenId, bytes calldata metaData) external;
                      /**
                       * @notice check if token already exists, return true if it does exist
                       * @dev this check will be used by the predicate to determine if the token needs to be minted or transfered
                       * @param tokenId tokenId being checked
                       */
                      function exists(uint256 tokenId) external view returns (bool);
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date June 16th, 2021
                  pragma solidity ^0.8.0;
                  abstract contract KeyStorage {
                      mapping(uint256 => string) private _keys;
                      function getKey(uint256 keyHash) public view returns (string memory) {
                          return _keys[keyHash];
                      }
                      function getKeys(uint256[] calldata hashes) public view returns (string[] memory values) {
                          values = new string[](hashes.length);
                          for (uint256 i = 0; i < hashes.length; i++) {
                              values[i] = getKey(hashes[i]);
                          }
                      }
                      function addKey(string memory key) external {
                          _addKey(uint256(keccak256(abi.encodePacked(key))), key);
                      }
                      function _existsKey(uint256 keyHash) internal view returns (bool) {
                          return bytes(_keys[keyHash]).length > 0;
                      }
                      function _addKey(uint256 keyHash, string memory key) internal {
                          if (!_existsKey(keyHash)) {
                              _keys[keyHash] = key;
                          }
                      }
                  }
                  pragma solidity ^0.8.0;
                  interface IRootChainManager {
                      event TokenMapped(
                          address indexed rootToken,
                          address indexed childToken,
                          bytes32 indexed tokenType
                      );
                      event PredicateRegistered(
                          bytes32 indexed tokenType,
                          address indexed predicateAddress
                      );
                      function registerPredicate(bytes32 tokenType, address predicateAddress)
                          external;
                      function mapToken(
                          address rootToken,
                          address childToken,
                          bytes32 tokenType
                      ) external;
                      function cleanMapToken(
                          address rootToken,
                          address childToken
                      ) external;
                      function remapToken(
                          address rootToken,
                          address childToken,
                          bytes32 tokenType
                      ) external;
                      function depositEtherFor(address user) external payable;
                      function depositFor(
                          address user,
                          address rootToken,
                          bytes calldata depositData
                      ) external;
                      function exit(bytes calldata inputData) external;
                  }
                  pragma solidity ^0.8.0;
                  abstract contract RootChainManagerStorage {
                      mapping(bytes32 => address) public typeToPredicate;
                      mapping(address => bytes32) public tokenToType;
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date August 12th, 2021
                  pragma solidity ^0.8.0;
                  import '@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol';
                  import '@openzeppelin/contracts-upgradeable/utils/cryptography/SignatureCheckerUpgradeable.sol';
                  import './IForwarder.sol';
                  abstract contract BaseForwarder is IForwarder {
                      using ECDSAUpgradeable for bytes32;
                      using SignatureCheckerUpgradeable for address;
                      function _verify(
                          ForwardRequest memory req,
                          address target,
                          bytes memory signature
                      ) internal view virtual returns (bool) {
                          uint256 nonce = this.nonceOf(req.tokenId);
                          bytes32 hash = keccak256(abi.encodePacked(keccak256(req.data), target, req.nonce)).toEthSignedMessageHash();
                          return req.nonce == nonce && req.from.isValidSignatureNow(hash, signature);
                      }
                      function _execute(
                          address from,
                          address to,
                          uint256 tokenId,
                          uint256 gas,
                          bytes memory data,
                          bytes memory signature
                      ) internal virtual returns (bytes memory) {
                          _invalidateNonce(tokenId);
                          (bool success, bytes memory returndata) = to.call{gas: gas}(_buildData(from, tokenId, data, signature));
                          // Validate that the relayer has sent enough gas for the call.
                          // See https://ronan.eth.link/blog/ethereum-gas-dangers/
                          assert(gasleft() > gas / 63);
                          return _verifyCallResult(success, returndata, 'BaseForwarder: CALL_FAILED');
                      }
                      function _invalidateNonce(
                          uint256 /* tokenId */
                      ) internal virtual {}
                      function _buildData(
                          address from,
                          uint256 tokenId,
                          bytes memory data,
                          bytes memory /* signature */
                      ) internal view virtual returns (bytes memory) {
                          return abi.encodePacked(data, from, tokenId);
                      }
                      function _verifyCallResult(
                          bool success,
                          bytes memory returndata,
                          string memory errorMessage
                      ) private 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
                                  //solhint-disable-next-line no-inline-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.0) (utils/cryptography/ECDSA.sol)
                  pragma solidity ^0.8.0;
                  import "../StringsUpgradeable.sol";
                  /**
                   * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
                   *
                   * These functions can be used to verify that a message was signed by the holder
                   * of the private keys of a given address.
                   */
                  library ECDSAUpgradeable {
                      enum RecoverError {
                          NoError,
                          InvalidSignature,
                          InvalidSignatureLength,
                          InvalidSignatureS,
                          InvalidSignatureV
                      }
                      function _throwError(RecoverError error) private pure {
                          if (error == RecoverError.NoError) {
                              return; // no error: do nothing
                          } else if (error == RecoverError.InvalidSignature) {
                              revert("ECDSA: invalid signature");
                          } else if (error == RecoverError.InvalidSignatureLength) {
                              revert("ECDSA: invalid signature length");
                          } else if (error == RecoverError.InvalidSignatureS) {
                              revert("ECDSA: invalid signature 's' value");
                          } else if (error == RecoverError.InvalidSignatureV) {
                              revert("ECDSA: invalid signature 'v' value");
                          }
                      }
                      /**
                       * @dev Returns the address that signed a hashed message (`hash`) with
                       * `signature` or error string. This address can then be used for verification purposes.
                       *
                       * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
                       * this function rejects them by requiring the `s` value to be in the lower
                       * half order, and the `v` value to be either 27 or 28.
                       *
                       * IMPORTANT: `hash` _must_ be the result of a hash operation for the
                       * verification to be secure: it is possible to craft signatures that
                       * recover to arbitrary addresses for non-hashed data. A safe way to ensure
                       * this is by receiving a hash of the original message (which may otherwise
                       * be too long), and then calling {toEthSignedMessageHash} on it.
                       *
                       * Documentation for signature generation:
                       * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
                       * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
                       *
                       * _Available since v4.3._
                       */
                      function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
                          // Check the signature length
                          // - case 65: r,s,v signature (standard)
                          // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
                          if (signature.length == 65) {
                              bytes32 r;
                              bytes32 s;
                              uint8 v;
                              // ecrecover takes the signature parameters, and the only way to get them
                              // currently is to use assembly.
                              /// @solidity memory-safe-assembly
                              assembly {
                                  r := mload(add(signature, 0x20))
                                  s := mload(add(signature, 0x40))
                                  v := byte(0, mload(add(signature, 0x60)))
                              }
                              return tryRecover(hash, v, r, s);
                          } else if (signature.length == 64) {
                              bytes32 r;
                              bytes32 vs;
                              // ecrecover takes the signature parameters, and the only way to get them
                              // currently is to use assembly.
                              /// @solidity memory-safe-assembly
                              assembly {
                                  r := mload(add(signature, 0x20))
                                  vs := mload(add(signature, 0x40))
                              }
                              return tryRecover(hash, r, vs);
                          } else {
                              return (address(0), RecoverError.InvalidSignatureLength);
                          }
                      }
                      /**
                       * @dev Returns the address that signed a hashed message (`hash`) with
                       * `signature`. This address can then be used for verification purposes.
                       *
                       * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
                       * this function rejects them by requiring the `s` value to be in the lower
                       * half order, and the `v` value to be either 27 or 28.
                       *
                       * IMPORTANT: `hash` _must_ be the result of a hash operation for the
                       * verification to be secure: it is possible to craft signatures that
                       * recover to arbitrary addresses for non-hashed data. A safe way to ensure
                       * this is by receiving a hash of the original message (which may otherwise
                       * be too long), and then calling {toEthSignedMessageHash} on it.
                       */
                      function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
                          (address recovered, RecoverError error) = tryRecover(hash, signature);
                          _throwError(error);
                          return recovered;
                      }
                      /**
                       * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
                       *
                       * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
                       *
                       * _Available since v4.3._
                       */
                      function tryRecover(
                          bytes32 hash,
                          bytes32 r,
                          bytes32 vs
                      ) internal pure returns (address, RecoverError) {
                          bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
                          uint8 v = uint8((uint256(vs) >> 255) + 27);
                          return tryRecover(hash, v, r, s);
                      }
                      /**
                       * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
                       *
                       * _Available since v4.2._
                       */
                      function recover(
                          bytes32 hash,
                          bytes32 r,
                          bytes32 vs
                      ) internal pure returns (address) {
                          (address recovered, RecoverError error) = tryRecover(hash, r, vs);
                          _throwError(error);
                          return recovered;
                      }
                      /**
                       * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
                       * `r` and `s` signature fields separately.
                       *
                       * _Available since v4.3._
                       */
                      function tryRecover(
                          bytes32 hash,
                          uint8 v,
                          bytes32 r,
                          bytes32 s
                      ) internal pure returns (address, RecoverError) {
                          // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                          // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                          // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
                          // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                          //
                          // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                          // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                          // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                          // these malleable signatures as well.
                          if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                              return (address(0), RecoverError.InvalidSignatureS);
                          }
                          if (v != 27 && v != 28) {
                              return (address(0), RecoverError.InvalidSignatureV);
                          }
                          // If the signature is valid (and not malleable), return the signer address
                          address signer = ecrecover(hash, v, r, s);
                          if (signer == address(0)) {
                              return (address(0), RecoverError.InvalidSignature);
                          }
                          return (signer, RecoverError.NoError);
                      }
                      /**
                       * @dev Overload of {ECDSA-recover} that receives the `v`,
                       * `r` and `s` signature fields separately.
                       */
                      function recover(
                          bytes32 hash,
                          uint8 v,
                          bytes32 r,
                          bytes32 s
                      ) internal pure returns (address) {
                          (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
                          _throwError(error);
                          return recovered;
                      }
                      /**
                       * @dev Returns an Ethereum Signed Message, created from a `hash`. This
                       * produces hash corresponding to the one signed with the
                       * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
                       * JSON-RPC method as part of EIP-191.
                       *
                       * See {recover}.
                       */
                      function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
                          // 32 is the length in bytes of hash,
                          // enforced by the type signature above
                          return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
                  32", hash));
                      }
                      /**
                       * @dev Returns an Ethereum Signed Message, created from `s`. This
                       * produces hash corresponding to the one signed with the
                       * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
                       * JSON-RPC method as part of EIP-191.
                       *
                       * See {recover}.
                       */
                      function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
                          return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
                  ", StringsUpgradeable.toString(s.length), s));
                      }
                      /**
                       * @dev Returns an Ethereum Signed Typed Data, created from a
                       * `domainSeparator` and a `structHash`. This produces hash corresponding
                       * to the one signed with the
                       * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
                       * JSON-RPC method as part of EIP-712.
                       *
                       * See {recover}.
                       */
                      function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
                          return keccak256(abi.encodePacked("\\x19\\x01", domainSeparator, structHash));
                      }
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts (last updated v4.7.1) (utils/cryptography/SignatureChecker.sol)
                  pragma solidity ^0.8.0;
                  import "./ECDSAUpgradeable.sol";
                  import "../AddressUpgradeable.sol";
                  import "../../interfaces/IERC1271Upgradeable.sol";
                  /**
                   * @dev Signature verification helper that can be used instead of `ECDSA.recover` to seamlessly support both ECDSA
                   * signatures from externally owned accounts (EOAs) as well as ERC1271 signatures from smart contract wallets like
                   * Argent and Gnosis Safe.
                   *
                   * _Available since v4.1._
                   */
                  library SignatureCheckerUpgradeable {
                      /**
                       * @dev Checks if a signature is valid for a given signer and data hash. If the signer is a smart contract, the
                       * signature is validated against that smart contract using ERC1271, otherwise it's validated using `ECDSA.recover`.
                       *
                       * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus
                       * change through time. It could return true at block N and false at block N+1 (or the opposite).
                       */
                      function isValidSignatureNow(
                          address signer,
                          bytes32 hash,
                          bytes memory signature
                      ) internal view returns (bool) {
                          (address recovered, ECDSAUpgradeable.RecoverError error) = ECDSAUpgradeable.tryRecover(hash, signature);
                          if (error == ECDSAUpgradeable.RecoverError.NoError && recovered == signer) {
                              return true;
                          }
                          (bool success, bytes memory result) = signer.staticcall(
                              abi.encodeWithSelector(IERC1271Upgradeable.isValidSignature.selector, hash, signature)
                          );
                          return (success &&
                              result.length == 32 &&
                              abi.decode(result, (bytes32)) == bytes32(IERC1271Upgradeable.isValidSignature.selector));
                      }
                  }
                  // @author Unstoppable Domains, Inc.
                  // @date August 11th, 2021
                  pragma solidity ^0.8.0;
                  interface IForwarder {
                      struct ForwardRequest {
                          address from;
                          uint256 nonce;
                          uint256 tokenId;
                          bytes data;
                      }
                      function nonceOf(uint256 tokenId) external view returns (uint256);
                      function verify(ForwardRequest calldata req, bytes calldata signature) external view returns (bool);
                      function execute(ForwardRequest calldata req, bytes calldata signature) external returns (bytes memory);
                  }
                  // SPDX-License-Identifier: MIT
                  // OpenZeppelin Contracts v4.4.1 (interfaces/IERC1271.sol)
                  pragma solidity ^0.8.0;
                  /**
                   * @dev Interface of the ERC1271 standard signature validation method for
                   * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].
                   *
                   * _Available since v4.1._
                   */
                  interface IERC1271Upgradeable {
                      /**
                       * @dev Should return whether the signature provided is valid for the provided data
                       * @param hash      Hash of the data to be signed
                       * @param signature Signature byte array associated with _data
                       */
                      function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);
                  }
                  

                  File 6 of 8: RootChainManagerProxy
                  // File: contracts/common/Proxy/IERCProxy.sol
                  
                  pragma solidity 0.6.6;
                  
                  interface IERCProxy {
                      function proxyType() external pure returns (uint256 proxyTypeId);
                  
                      function implementation() external view returns (address codeAddr);
                  }
                  
                  // File: contracts/common/Proxy/Proxy.sol
                  
                  pragma solidity 0.6.6;
                  
                  
                  abstract contract Proxy is IERCProxy {
                      function delegatedFwd(address _dst, bytes memory _calldata) internal {
                          // solium-disable-next-line security/no-inline-assembly
                          assembly {
                              let result := delegatecall(
                                  sub(gas(), 10000),
                                  _dst,
                                  add(_calldata, 0x20),
                                  mload(_calldata),
                                  0,
                                  0
                              )
                              let size := returndatasize()
                  
                              let ptr := mload(0x40)
                              returndatacopy(ptr, 0, size)
                  
                              // revert instead of invalid() bc if the underlying call failed with invalid() it already wasted gas.
                              // if the call returned error data, forward it
                              switch result
                                  case 0 {
                                      revert(ptr, size)
                                  }
                                  default {
                                      return(ptr, size)
                                  }
                          }
                      }
                  
                      function proxyType() external virtual override pure returns (uint256 proxyTypeId) {
                          // Upgradeable proxy
                          proxyTypeId = 2;
                      }
                  
                      function implementation() external virtual override view returns (address);
                  }
                  
                  // File: contracts/common/Proxy/UpgradableProxy.sol
                  
                  pragma solidity 0.6.6;
                  
                  
                  contract UpgradableProxy is Proxy {
                      event ProxyUpdated(address indexed _new, address indexed _old);
                      event ProxyOwnerUpdate(address _new, address _old);
                  
                      bytes32 constant IMPLEMENTATION_SLOT = keccak256("matic.network.proxy.implementation");
                      bytes32 constant OWNER_SLOT = keccak256("matic.network.proxy.owner");
                  
                      constructor(address _proxyTo) public {
                          setProxyOwner(msg.sender);
                          setImplementation(_proxyTo);
                      }
                  
                      fallback() external payable {
                          delegatedFwd(loadImplementation(), msg.data);
                      }
                  
                      receive() external payable {
                          delegatedFwd(loadImplementation(), msg.data);
                      }
                  
                      modifier onlyProxyOwner() {
                          require(loadProxyOwner() == msg.sender, "NOT_OWNER");
                          _;
                      }
                  
                      function proxyOwner() external view returns(address) {
                          return loadProxyOwner();
                      }
                  
                      function loadProxyOwner() internal view returns(address) {
                          address _owner;
                          bytes32 position = OWNER_SLOT;
                          assembly {
                              _owner := sload(position)
                          }
                          return _owner;
                      }
                  
                      function implementation() external override view returns (address) {
                          return loadImplementation();
                      }
                  
                      function loadImplementation() internal view returns(address) {
                          address _impl;
                          bytes32 position = IMPLEMENTATION_SLOT;
                          assembly {
                              _impl := sload(position)
                          }
                          return _impl;
                      }
                  
                      function transferProxyOwnership(address newOwner) public onlyProxyOwner {
                          require(newOwner != address(0), "ZERO_ADDRESS");
                          emit ProxyOwnerUpdate(newOwner, loadProxyOwner());
                          setProxyOwner(newOwner);
                      }
                  
                      function setProxyOwner(address newOwner) private {
                          bytes32 position = OWNER_SLOT;
                          assembly {
                              sstore(position, newOwner)
                          }
                      }
                  
                      function updateImplementation(address _newProxyTo) public onlyProxyOwner {
                          require(_newProxyTo != address(0x0), "INVALID_PROXY_ADDRESS");
                          require(isContract(_newProxyTo), "DESTINATION_ADDRESS_IS_NOT_A_CONTRACT");
                  
                          emit ProxyUpdated(_newProxyTo, loadImplementation());
                          
                          setImplementation(_newProxyTo);
                      }
                  
                      function updateAndCall(address _newProxyTo, bytes memory data) payable public onlyProxyOwner {
                          updateImplementation(_newProxyTo);
                  
                          (bool success, bytes memory returnData) = address(this).call{value: msg.value}(data);
                          require(success, string(returnData));
                      }
                  
                      function setImplementation(address _newProxyTo) private {
                          bytes32 position = IMPLEMENTATION_SLOT;
                          assembly {
                              sstore(position, _newProxyTo)
                          }
                      }
                      
                      function isContract(address _target) internal view returns (bool) {
                          if (_target == address(0)) {
                              return false;
                          }
                  
                          uint256 size;
                          assembly {
                              size := extcodesize(_target)
                          }
                          return size > 0;
                      }
                  }
                  
                  // File: contracts/root/RootChainManager/RootChainManagerProxy.sol
                  
                  pragma solidity 0.6.6;
                  
                  
                  contract RootChainManagerProxy is UpgradableProxy {
                      constructor(address _proxyTo)
                          public
                          UpgradableProxy(_proxyTo)
                      {}
                  }

                  File 7 of 8: RootChainManager
                  // File: @openzeppelin/contracts/math/SafeMath.sol
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.6.0;
                  /**
                   * @dev Wrappers over Solidity's arithmetic operations with added overflow
                   * checks.
                   *
                   * Arithmetic operations in Solidity wrap on overflow. This can easily result
                   * in bugs, because programmers usually assume that an overflow raises an
                   * error, which is the standard behavior in high level programming languages.
                   * `SafeMath` restores this intuition by reverting the transaction when an
                   * operation overflows.
                   *
                   * Using this library instead of the unchecked operations eliminates an entire
                   * class of bugs, so it's recommended to use it always.
                   */
                  library SafeMath {
                      /**
                       * @dev Returns the addition of two unsigned integers, reverting on
                       * overflow.
                       *
                       * Counterpart to Solidity's `+` operator.
                       *
                       * Requirements:
                       *
                       * - Addition cannot overflow.
                       */
                      function add(uint256 a, uint256 b) internal pure returns (uint256) {
                          uint256 c = a + b;
                          require(c >= a, "SafeMath: addition overflow");
                          return c;
                      }
                      /**
                       * @dev Returns the subtraction of two unsigned integers, reverting on
                       * overflow (when the result is negative).
                       *
                       * Counterpart to Solidity's `-` operator.
                       *
                       * Requirements:
                       *
                       * - Subtraction cannot overflow.
                       */
                      function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                          return sub(a, b, "SafeMath: subtraction overflow");
                      }
                      /**
                       * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
                       * overflow (when the result is negative).
                       *
                       * Counterpart to Solidity's `-` operator.
                       *
                       * Requirements:
                       *
                       * - Subtraction cannot overflow.
                       */
                      function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                          require(b <= a, errorMessage);
                          uint256 c = a - b;
                          return c;
                      }
                      /**
                       * @dev Returns the multiplication of two unsigned integers, reverting on
                       * overflow.
                       *
                       * Counterpart to Solidity's `*` operator.
                       *
                       * Requirements:
                       *
                       * - Multiplication cannot overflow.
                       */
                      function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                          // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                          // benefit is lost if 'b' is also tested.
                          // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                          if (a == 0) {
                              return 0;
                          }
                          uint256 c = a * b;
                          require(c / a == b, "SafeMath: multiplication overflow");
                          return c;
                      }
                      /**
                       * @dev Returns the integer division of two unsigned integers. Reverts on
                       * division by zero. The result is rounded towards zero.
                       *
                       * Counterpart to Solidity's `/` operator. Note: this function uses a
                       * `revert` opcode (which leaves remaining gas untouched) while Solidity
                       * uses an invalid opcode to revert (consuming all remaining gas).
                       *
                       * Requirements:
                       *
                       * - The divisor cannot be zero.
                       */
                      function div(uint256 a, uint256 b) internal pure returns (uint256) {
                          return div(a, b, "SafeMath: division by zero");
                      }
                      /**
                       * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
                       * division by zero. The result is rounded towards zero.
                       *
                       * Counterpart to Solidity's `/` operator. Note: this function uses a
                       * `revert` opcode (which leaves remaining gas untouched) while Solidity
                       * uses an invalid opcode to revert (consuming all remaining gas).
                       *
                       * Requirements:
                       *
                       * - The divisor cannot be zero.
                       */
                      function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                          require(b > 0, errorMessage);
                          uint256 c = a / b;
                          // assert(a == b * c + a % b); // There is no case in which this doesn't hold
                          return c;
                      }
                      /**
                       * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                       * Reverts when dividing by zero.
                       *
                       * Counterpart to Solidity's `%` operator. This function uses a `revert`
                       * opcode (which leaves remaining gas untouched) while Solidity uses an
                       * invalid opcode to revert (consuming all remaining gas).
                       *
                       * Requirements:
                       *
                       * - The divisor cannot be zero.
                       */
                      function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                          return mod(a, b, "SafeMath: modulo by zero");
                      }
                      /**
                       * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
                       * Reverts with custom message when dividing by zero.
                       *
                       * Counterpart to Solidity's `%` operator. This function uses a `revert`
                       * opcode (which leaves remaining gas untouched) while Solidity uses an
                       * invalid opcode to revert (consuming all remaining gas).
                       *
                       * Requirements:
                       *
                       * - The divisor cannot be zero.
                       */
                      function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                          require(b != 0, errorMessage);
                          return a % b;
                      }
                  }
                  // File: contracts/root/RootChainManager/IRootChainManager.sol
                  pragma solidity 0.6.6;
                  interface IRootChainManager {
                      event TokenMapped(
                          address indexed rootToken,
                          address indexed childToken,
                          bytes32 indexed tokenType
                      );
                      event PredicateRegistered(
                          bytes32 indexed tokenType,
                          address indexed predicateAddress
                      );
                      function registerPredicate(bytes32 tokenType, address predicateAddress)
                          external;
                      function mapToken(
                          address rootToken,
                          address childToken,
                          bytes32 tokenType
                      ) external;
                      function cleanMapToken(
                          address rootToken,
                          address childToken
                      ) external;
                      function remapToken(
                          address rootToken,
                          address childToken,
                          bytes32 tokenType
                      ) external;
                      function depositEtherFor(address user) external payable;
                      function depositFor(
                          address user,
                          address rootToken,
                          bytes calldata depositData
                      ) external;
                      function exit(bytes calldata inputData) external;
                  }
                  // File: contracts/root/StateSender/IStateSender.sol
                  pragma solidity 0.6.6;
                  interface IStateSender {
                      function syncState(address receiver, bytes calldata data) external;
                  }
                  // File: contracts/root/ICheckpointManager.sol
                  pragma solidity 0.6.6;
                  contract ICheckpointManager {
                      struct HeaderBlock {
                          bytes32 root;
                          uint256 start;
                          uint256 end;
                          uint256 createdAt;
                          address proposer;
                      }
                      /**
                       * @notice mapping of checkpoint header numbers to block details
                       * @dev These checkpoints are submited by plasma contracts
                       */
                      mapping(uint256 => HeaderBlock) public headerBlocks;
                  }
                  // File: contracts/root/RootChainManager/RootChainManagerStorage.sol
                  pragma solidity 0.6.6;
                  abstract contract RootChainManagerStorage {
                      mapping(bytes32 => address) public typeToPredicate;
                      mapping(address => address) public rootToChildToken;
                      mapping(address => address) public childToRootToken;
                      mapping(address => bytes32) public tokenToType;
                      mapping(bytes32 => bool) public processedExits;
                      IStateSender internal _stateSender;
                      ICheckpointManager internal _checkpointManager;
                      address public childChainManagerAddress;
                  }
                  // File: contracts/lib/RLPReader.sol
                  /*
                   * @author Hamdi Allam [email protected]
                   * Please reach out with any questions or concerns
                   * https://github.com/hamdiallam/Solidity-RLP/blob/e681e25a376dbd5426b509380bc03446f05d0f97/contracts/RLPReader.sol
                   */
                  pragma solidity 0.6.6;
                  library RLPReader {
                      uint8 constant STRING_SHORT_START = 0x80;
                      uint8 constant STRING_LONG_START  = 0xb8;
                      uint8 constant LIST_SHORT_START   = 0xc0;
                      uint8 constant LIST_LONG_START    = 0xf8;
                      uint8 constant WORD_SIZE = 32;
                      struct RLPItem {
                          uint len;
                          uint memPtr;
                      }
                      struct Iterator {
                          RLPItem item;   // Item that's being iterated over.
                          uint nextPtr;   // Position of the next item in the list.
                      }
                      /*
                      * @dev Returns the next element in the iteration. Reverts if it has not next element.
                      * @param self The iterator.
                      * @return The next element in the iteration.
                      */
                      function next(Iterator memory self) internal pure returns (RLPItem memory) {
                          require(hasNext(self));
                          uint ptr = self.nextPtr;
                          uint itemLength = _itemLength(ptr);
                          self.nextPtr = ptr + itemLength;
                          return RLPItem(itemLength, ptr);
                      }
                      /*
                      * @dev Returns true if the iteration has more elements.
                      * @param self The iterator.
                      * @return true if the iteration has more elements.
                      */
                      function hasNext(Iterator memory self) internal pure returns (bool) {
                          RLPItem memory item = self.item;
                          return self.nextPtr < item.memPtr + item.len;
                      }
                      /*
                      * @param item RLP encoded bytes
                      */
                      function toRlpItem(bytes memory item) internal pure returns (RLPItem memory) {
                          uint memPtr;
                          assembly {
                              memPtr := add(item, 0x20)
                          }
                          return RLPItem(item.length, memPtr);
                      }
                      /*
                      * @dev Create an iterator. Reverts if item is not a list.
                      * @param self The RLP item.
                      * @return An 'Iterator' over the item.
                      */
                      function iterator(RLPItem memory self) internal pure returns (Iterator memory) {
                          require(isList(self));
                          uint ptr = self.memPtr + _payloadOffset(self.memPtr);
                          return Iterator(self, ptr);
                      }
                      /*
                      * @param the RLP item.
                      */
                      function rlpLen(RLPItem memory item) internal pure returns (uint) {
                          return item.len;
                      }
                      /*
                       * @param the RLP item.
                       * @return (memPtr, len) pair: location of the item's payload in memory.
                       */
                      function payloadLocation(RLPItem memory item) internal pure returns (uint, uint) {
                          uint offset = _payloadOffset(item.memPtr);
                          uint memPtr = item.memPtr + offset;
                          uint len = item.len - offset; // data length
                          return (memPtr, len);
                      }
                      /*
                      * @param the RLP item.
                      */
                      function payloadLen(RLPItem memory item) internal pure returns (uint) {
                          (, uint len) = payloadLocation(item);
                          return len;
                      }
                      /*
                      * @param the RLP item containing the encoded list.
                      */
                      function toList(RLPItem memory item) internal pure returns (RLPItem[] memory) {
                          require(isList(item));
                          uint items = numItems(item);
                          RLPItem[] memory result = new RLPItem[](items);
                          uint memPtr = item.memPtr + _payloadOffset(item.memPtr);
                          uint dataLen;
                          for (uint i = 0; i < items; i++) {
                              dataLen = _itemLength(memPtr);
                              result[i] = RLPItem(dataLen, memPtr);
                              memPtr = memPtr + dataLen;
                          }
                          return result;
                      }
                      // @return indicator whether encoded payload is a list. negate this function call for isData.
                      function isList(RLPItem memory item) internal pure returns (bool) {
                          if (item.len == 0) return false;
                          uint8 byte0;
                          uint memPtr = item.memPtr;
                          assembly {
                              byte0 := byte(0, mload(memPtr))
                          }
                          if (byte0 < LIST_SHORT_START)
                              return false;
                          return true;
                      }
                      /*
                       * @dev A cheaper version of keccak256(toRlpBytes(item)) that avoids copying memory.
                       * @return keccak256 hash of RLP encoded bytes.
                       */
                      function rlpBytesKeccak256(RLPItem memory item) internal pure returns (bytes32) {
                          uint256 ptr = item.memPtr;
                          uint256 len = item.len;
                          bytes32 result;
                          assembly {
                              result := keccak256(ptr, len)
                          }
                          return result;
                      }
                      /*
                       * @dev A cheaper version of keccak256(toBytes(item)) that avoids copying memory.
                       * @return keccak256 hash of the item payload.
                       */
                      function payloadKeccak256(RLPItem memory item) internal pure returns (bytes32) {
                          (uint memPtr, uint len) = payloadLocation(item);
                          bytes32 result;
                          assembly {
                              result := keccak256(memPtr, len)
                          }
                          return result;
                      }
                      /** RLPItem conversions into data types **/
                      // @returns raw rlp encoding in bytes
                      function toRlpBytes(RLPItem memory item) internal pure returns (bytes memory) {
                          bytes memory result = new bytes(item.len);
                          if (result.length == 0) return result;
                          uint ptr;
                          assembly {
                              ptr := add(0x20, result)
                          }
                          copy(item.memPtr, ptr, item.len);
                          return result;
                      }
                      // any non-zero byte except "0x80" is considered true
                      function toBoolean(RLPItem memory item) internal pure returns (bool) {
                          require(item.len == 1);
                          uint result;
                          uint memPtr = item.memPtr;
                          assembly {
                              result := byte(0, mload(memPtr))
                          }
                          // SEE Github Issue #5.
                          // Summary: Most commonly used RLP libraries (i.e Geth) will encode
                          // "0" as "0x80" instead of as "0". We handle this edge case explicitly
                          // here.
                          if (result == 0 || result == STRING_SHORT_START) {
                              return false;
                          } else {
                              return true;
                          }
                      }
                      function toAddress(RLPItem memory item) internal pure returns (address) {
                          // 1 byte for the length prefix
                          require(item.len == 21);
                          return address(toUint(item));
                      }
                      function toUint(RLPItem memory item) internal pure returns (uint) {
                          require(item.len > 0 && item.len <= 33);
                          (uint memPtr, uint len) = payloadLocation(item);
                          uint result;
                          assembly {
                              result := mload(memPtr)
                              // shfit to the correct location if neccesary
                              if lt(len, 32) {
                                  result := div(result, exp(256, sub(32, len)))
                              }
                          }
                          return result;
                      }
                      // enforces 32 byte length
                      function toUintStrict(RLPItem memory item) internal pure returns (uint) {
                          // one byte prefix
                          require(item.len == 33);
                          uint result;
                          uint memPtr = item.memPtr + 1;
                          assembly {
                              result := mload(memPtr)
                          }
                          return result;
                      }
                      function toBytes(RLPItem memory item) internal pure returns (bytes memory) {
                          require(item.len > 0);
                          (uint memPtr, uint len) = payloadLocation(item);
                          bytes memory result = new bytes(len);
                          uint destPtr;
                          assembly {
                              destPtr := add(0x20, result)
                          }
                          copy(memPtr, destPtr, len);
                          return result;
                      }
                      /*
                      * Private Helpers
                      */
                      // @return number of payload items inside an encoded list.
                      function numItems(RLPItem memory item) private pure returns (uint) {
                          if (item.len == 0) return 0;
                          uint count = 0;
                          uint currPtr = item.memPtr + _payloadOffset(item.memPtr);
                          uint endPtr = item.memPtr + item.len;
                          while (currPtr < endPtr) {
                             currPtr = currPtr + _itemLength(currPtr); // skip over an item
                             count++;
                          }
                          return count;
                      }
                      // @return entire rlp item byte length
                      function _itemLength(uint memPtr) private pure returns (uint) {
                          uint itemLen;
                          uint byte0;
                          assembly {
                              byte0 := byte(0, mload(memPtr))
                          }
                          if (byte0 < STRING_SHORT_START)
                              itemLen = 1;
                          else if (byte0 < STRING_LONG_START)
                              itemLen = byte0 - STRING_SHORT_START + 1;
                          else if (byte0 < LIST_SHORT_START) {
                              assembly {
                                  let byteLen := sub(byte0, 0xb7) // # of bytes the actual length is
                                  memPtr := add(memPtr, 1) // skip over the first byte
                                  /* 32 byte word size */
                                  let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to get the len
                                  itemLen := add(dataLen, add(byteLen, 1))
                              }
                          }
                          else if (byte0 < LIST_LONG_START) {
                              itemLen = byte0 - LIST_SHORT_START + 1;
                          }
                          else {
                              assembly {
                                  let byteLen := sub(byte0, 0xf7)
                                  memPtr := add(memPtr, 1)
                                  let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to the correct length
                                  itemLen := add(dataLen, add(byteLen, 1))
                              }
                          }
                          return itemLen;
                      }
                      // @return number of bytes until the data
                      function _payloadOffset(uint memPtr) private pure returns (uint) {
                          uint byte0;
                          assembly {
                              byte0 := byte(0, mload(memPtr))
                          }
                          if (byte0 < STRING_SHORT_START)
                              return 0;
                          else if (byte0 < STRING_LONG_START || (byte0 >= LIST_SHORT_START && byte0 < LIST_LONG_START))
                              return 1;
                          else if (byte0 < LIST_SHORT_START)  // being explicit
                              return byte0 - (STRING_LONG_START - 1) + 1;
                          else
                              return byte0 - (LIST_LONG_START - 1) + 1;
                      }
                      /*
                      * @param src Pointer to source
                      * @param dest Pointer to destination
                      * @param len Amount of memory to copy from the source
                      */
                      function copy(uint src, uint dest, uint len) private pure {
                          if (len == 0) return;
                          // copy as many word sizes as possible
                          for (; len >= WORD_SIZE; len -= WORD_SIZE) {
                              assembly {
                                  mstore(dest, mload(src))
                              }
                              src += WORD_SIZE;
                              dest += WORD_SIZE;
                          }
                          if (len > 0) {
                              // left over bytes. Mask is used to remove unwanted bytes from the word
                              uint mask = 256 ** (WORD_SIZE - len) - 1;
                              assembly {
                                  let srcpart := and(mload(src), not(mask)) // zero out src
                                  let destpart := and(mload(dest), mask) // retrieve the bytes
                                  mstore(dest, or(destpart, srcpart))
                              }
                          }
                      }
                  }
                  // File: contracts/lib/ExitPayloadReader.sol
                  pragma solidity 0.6.6;
                  library ExitPayloadReader {
                    using RLPReader for bytes;
                    using RLPReader for RLPReader.RLPItem;
                    uint8 constant WORD_SIZE = 32;
                    struct ExitPayload {
                      RLPReader.RLPItem[] data;
                    }
                    struct Receipt {
                      RLPReader.RLPItem[] data;
                      bytes raw;
                      uint256 logIndex;
                    }
                    struct Log {
                      RLPReader.RLPItem data;
                      RLPReader.RLPItem[] list;
                    }
                    struct LogTopics {
                      RLPReader.RLPItem[] data;
                    }
                    // copy paste of private copy() from RLPReader to avoid changing of existing contracts
                    function copy(uint src, uint dest, uint len) private pure {
                          if (len == 0) return;
                          // copy as many word sizes as possible
                          for (; len >= WORD_SIZE; len -= WORD_SIZE) {
                              assembly {
                                  mstore(dest, mload(src))
                              }
                              src += WORD_SIZE;
                              dest += WORD_SIZE;
                          }
                          if (len == 0) return;
                          // left over bytes. Mask is used to remove unwanted bytes from the word
                          uint mask = 256 ** (WORD_SIZE - len) - 1;
                          assembly {
                              let srcpart := and(mload(src), not(mask)) // zero out src
                              let destpart := and(mload(dest), mask) // retrieve the bytes
                              mstore(dest, or(destpart, srcpart))
                          }
                      }
                    function toExitPayload(bytes memory data)
                          internal
                          pure
                          returns (ExitPayload memory)
                      {
                          RLPReader.RLPItem[] memory payloadData = data
                              .toRlpItem()
                              .toList();
                          return ExitPayload(payloadData);
                      }
                      function getHeaderNumber(ExitPayload memory payload) internal pure returns(uint256) {
                        return payload.data[0].toUint();
                      }
                      function getBlockProof(ExitPayload memory payload) internal pure returns(bytes memory) {
                        return payload.data[1].toBytes();
                      }
                      function getBlockNumber(ExitPayload memory payload) internal pure returns(uint256) {
                        return payload.data[2].toUint();
                      }
                      function getBlockTime(ExitPayload memory payload) internal pure returns(uint256) {
                        return payload.data[3].toUint();
                      }
                      function getTxRoot(ExitPayload memory payload) internal pure returns(bytes32) {
                        return bytes32(payload.data[4].toUint());
                      }
                      function getReceiptRoot(ExitPayload memory payload) internal pure returns(bytes32) {
                        return bytes32(payload.data[5].toUint());
                      }
                      function getReceipt(ExitPayload memory payload) internal pure returns(Receipt memory receipt) {
                        receipt.raw = payload.data[6].toBytes();
                        RLPReader.RLPItem memory receiptItem = receipt.raw.toRlpItem();
                        if (receiptItem.isList()) {
                            // legacy tx
                            receipt.data = receiptItem.toList();
                        } else {
                            // pop first byte before parsting receipt
                            bytes memory typedBytes = receipt.raw;
                            bytes memory result = new bytes(typedBytes.length - 1);
                            uint256 srcPtr;
                            uint256 destPtr;
                            assembly {
                                srcPtr := add(33, typedBytes)
                                destPtr := add(0x20, result)
                            }
                            copy(srcPtr, destPtr, result.length);
                            receipt.data = result.toRlpItem().toList();
                        }
                        receipt.logIndex = getReceiptLogIndex(payload);
                        return receipt;
                      }
                      function getReceiptProof(ExitPayload memory payload) internal pure returns(bytes memory) {
                        return payload.data[7].toBytes();
                      }
                      function getBranchMaskAsBytes(ExitPayload memory payload) internal pure returns(bytes memory) {
                        return payload.data[8].toBytes();
                      }
                      function getBranchMaskAsUint(ExitPayload memory payload) internal pure returns(uint256) {
                        return payload.data[8].toUint();
                      }
                      function getReceiptLogIndex(ExitPayload memory payload) internal pure returns(uint256) {
                        return payload.data[9].toUint();
                      }
                      // Receipt methods
                      function toBytes(Receipt memory receipt) internal pure returns(bytes memory) {
                          return receipt.raw;
                      }
                      function getLog(Receipt memory receipt) internal pure returns(Log memory) {
                          RLPReader.RLPItem memory logData = receipt.data[3].toList()[receipt.logIndex];
                          return Log(logData, logData.toList());
                      }
                      // Log methods
                      function getEmitter(Log memory log) internal pure returns(address) {
                        return RLPReader.toAddress(log.list[0]);
                      }
                      function getTopics(Log memory log) internal pure returns(LogTopics memory) {
                          return LogTopics(log.list[1].toList());
                      }
                      function getData(Log memory log) internal pure returns(bytes memory) {
                          return log.list[2].toBytes();
                      }
                      function toRlpBytes(Log memory log) internal pure returns(bytes memory) {
                        return log.data.toRlpBytes();
                      }
                      // LogTopics methods
                      function getField(LogTopics memory topics, uint256 index) internal pure returns(RLPReader.RLPItem memory) {
                        return topics.data[index];
                      }
                  }
                  // File: contracts/lib/MerklePatriciaProof.sol
                  /*
                   * @title MerklePatriciaVerifier
                   * @author Sam Mayo ([email protected])
                   *
                   * @dev Library for verifing merkle patricia proofs.
                   */
                  pragma solidity 0.6.6;
                  library MerklePatriciaProof {
                      /*
                       * @dev Verifies a merkle patricia proof.
                       * @param value The terminating value in the trie.
                       * @param encodedPath The path in the trie leading to value.
                       * @param rlpParentNodes The rlp encoded stack of nodes.
                       * @param root The root hash of the trie.
                       * @return The boolean validity of the proof.
                       */
                      function verify(
                          bytes memory value,
                          bytes memory encodedPath,
                          bytes memory rlpParentNodes,
                          bytes32 root
                      ) internal pure returns (bool) {
                          RLPReader.RLPItem memory item = RLPReader.toRlpItem(rlpParentNodes);
                          RLPReader.RLPItem[] memory parentNodes = RLPReader.toList(item);
                          bytes memory currentNode;
                          RLPReader.RLPItem[] memory currentNodeList;
                          bytes32 nodeKey = root;
                          uint256 pathPtr = 0;
                          bytes memory path = _getNibbleArray(encodedPath);
                          if (path.length == 0) {
                              return false;
                          }
                          for (uint256 i = 0; i < parentNodes.length; i++) {
                              if (pathPtr > path.length) {
                                  return false;
                              }
                              currentNode = RLPReader.toRlpBytes(parentNodes[i]);
                              if (nodeKey != keccak256(currentNode)) {
                                  return false;
                              }
                              currentNodeList = RLPReader.toList(parentNodes[i]);
                              if (currentNodeList.length == 17) {
                                  if (pathPtr == path.length) {
                                      if (
                                          keccak256(RLPReader.toBytes(currentNodeList[16])) ==
                                          keccak256(value)
                                      ) {
                                          return true;
                                      } else {
                                          return false;
                                      }
                                  }
                                  uint8 nextPathNibble = uint8(path[pathPtr]);
                                  if (nextPathNibble > 16) {
                                      return false;
                                  }
                                  nodeKey = bytes32(
                                      RLPReader.toUintStrict(currentNodeList[nextPathNibble])
                                  );
                                  pathPtr += 1;
                              } else if (currentNodeList.length == 2) {
                                  uint256 traversed = _nibblesToTraverse(
                                      RLPReader.toBytes(currentNodeList[0]),
                                      path,
                                      pathPtr
                                  );
                                  if (pathPtr + traversed == path.length) {
                                      //leaf node
                                      if (
                                          keccak256(RLPReader.toBytes(currentNodeList[1])) ==
                                          keccak256(value)
                                      ) {
                                          return true;
                                      } else {
                                          return false;
                                      }
                                  }
                                  //extension node
                                  if (traversed == 0) {
                                      return false;
                                  }
                                  pathPtr += traversed;
                                  nodeKey = bytes32(RLPReader.toUintStrict(currentNodeList[1]));
                              } else {
                                  return false;
                              }
                          }
                      }
                      function _nibblesToTraverse(
                          bytes memory encodedPartialPath,
                          bytes memory path,
                          uint256 pathPtr
                      ) private pure returns (uint256) {
                          uint256 len = 0;
                          // encodedPartialPath has elements that are each two hex characters (1 byte), but partialPath
                          // and slicedPath have elements that are each one hex character (1 nibble)
                          bytes memory partialPath = _getNibbleArray(encodedPartialPath);
                          bytes memory slicedPath = new bytes(partialPath.length);
                          // pathPtr counts nibbles in path
                          // partialPath.length is a number of nibbles
                          for (uint256 i = pathPtr; i < pathPtr + partialPath.length; i++) {
                              bytes1 pathNibble = path[i];
                              slicedPath[i - pathPtr] = pathNibble;
                          }
                          if (keccak256(partialPath) == keccak256(slicedPath)) {
                              len = partialPath.length;
                          } else {
                              len = 0;
                          }
                          return len;
                      }
                      // bytes b must be hp encoded
                      function _getNibbleArray(bytes memory b)
                          internal
                          pure
                          returns (bytes memory)
                      {
                          bytes memory nibbles = "";
                          if (b.length > 0) {
                              uint8 offset;
                              uint8 hpNibble = uint8(_getNthNibbleOfBytes(0, b));
                              if (hpNibble == 1 || hpNibble == 3) {
                                  nibbles = new bytes(b.length * 2 - 1);
                                  bytes1 oddNibble = _getNthNibbleOfBytes(1, b);
                                  nibbles[0] = oddNibble;
                                  offset = 1;
                              } else {
                                  nibbles = new bytes(b.length * 2 - 2);
                                  offset = 0;
                              }
                              for (uint256 i = offset; i < nibbles.length; i++) {
                                  nibbles[i] = _getNthNibbleOfBytes(i - offset + 2, b);
                              }
                          }
                          return nibbles;
                      }
                      function _getNthNibbleOfBytes(uint256 n, bytes memory str)
                          private
                          pure
                          returns (bytes1)
                      {
                          return
                              bytes1(
                                  n % 2 == 0 ? uint8(str[n / 2]) / 0x10 : uint8(str[n / 2]) % 0x10
                              );
                      }
                  }
                  // File: contracts/lib/Merkle.sol
                  pragma solidity 0.6.6;
                  library Merkle {
                      function checkMembership(
                          bytes32 leaf,
                          uint256 index,
                          bytes32 rootHash,
                          bytes memory proof
                      ) internal pure returns (bool) {
                          require(proof.length % 32 == 0, "Invalid proof length");
                          uint256 proofHeight = proof.length / 32;
                          // Proof of size n means, height of the tree is n+1.
                          // In a tree of height n+1, max #leafs possible is 2 ^ n
                          require(index < 2 ** proofHeight, "Leaf index is too big");
                          bytes32 proofElement;
                          bytes32 computedHash = leaf;
                          for (uint256 i = 32; i <= proof.length; i += 32) {
                              assembly {
                                  proofElement := mload(add(proof, i))
                              }
                              if (index % 2 == 0) {
                                  computedHash = keccak256(
                                      abi.encodePacked(computedHash, proofElement)
                                  );
                              } else {
                                  computedHash = keccak256(
                                      abi.encodePacked(proofElement, computedHash)
                                  );
                              }
                              index = index / 2;
                          }
                          return computedHash == rootHash;
                      }
                  }
                  // File: contracts/root/TokenPredicates/ITokenPredicate.sol
                  pragma solidity 0.6.6;
                  /// @title Token predicate interface for all pos portal predicates
                  /// @notice Abstract interface that defines methods for custom predicates
                  interface ITokenPredicate {
                      /**
                       * @notice Deposit tokens into pos portal
                       * @dev When `depositor` deposits tokens into pos portal, tokens get locked into predicate contract.
                       * @param depositor Address who wants to deposit tokens
                       * @param depositReceiver Address (address) who wants to receive tokens on side chain
                       * @param rootToken Token which gets deposited
                       * @param depositData Extra data for deposit (amount for ERC20, token id for ERC721 etc.) [ABI encoded]
                       */
                      function lockTokens(
                          address depositor,
                          address depositReceiver,
                          address rootToken,
                          bytes calldata depositData
                      ) external;
                      /**
                       * @notice Validates and processes exit while withdraw process
                       * @dev Validates exit log emitted on sidechain. Reverts if validation fails.
                       * @dev Processes withdraw based on custom logic. Example: transfer ERC20/ERC721, mint ERC721 if mintable withdraw
                       * @param sender Address
                       * @param rootToken Token which gets withdrawn
                       * @param logRLPList Valid sidechain log for data like amount, token id etc.
                       */
                      function exitTokens(
                          address sender,
                          address rootToken,
                          bytes calldata logRLPList
                      ) external;
                  }
                  // File: contracts/common/Initializable.sol
                  pragma solidity 0.6.6;
                  contract Initializable {
                      bool inited = false;
                      modifier initializer() {
                          require(!inited, "already inited");
                          _;
                          inited = true;
                      }
                  }
                  // File: contracts/common/EIP712Base.sol
                  pragma solidity 0.6.6;
                  contract EIP712Base is Initializable {
                      struct EIP712Domain {
                          string name;
                          string version;
                          address verifyingContract;
                          bytes32 salt;
                      }
                      string constant public ERC712_VERSION = "1";
                      bytes32 internal constant EIP712_DOMAIN_TYPEHASH = keccak256(
                          bytes(
                              "EIP712Domain(string name,string version,address verifyingContract,bytes32 salt)"
                          )
                      );
                      bytes32 internal domainSeperator;
                      // supposed to be called once while initializing.
                      // one of the contractsa that inherits this contract follows proxy pattern
                      // so it is not possible to do this in a constructor
                      function _initializeEIP712(
                          string memory name
                      )
                          internal
                          initializer
                      {
                          _setDomainSeperator(name);
                      }
                      function _setDomainSeperator(string memory name) internal {
                          domainSeperator = keccak256(
                              abi.encode(
                                  EIP712_DOMAIN_TYPEHASH,
                                  keccak256(bytes(name)),
                                  keccak256(bytes(ERC712_VERSION)),
                                  address(this),
                                  bytes32(getChainId())
                              )
                          );
                      }
                      function getDomainSeperator() public view returns (bytes32) {
                          return domainSeperator;
                      }
                      function getChainId() public pure returns (uint256) {
                          uint256 id;
                          assembly {
                              id := chainid()
                          }
                          return id;
                      }
                      /**
                       * Accept message hash and returns hash message in EIP712 compatible form
                       * So that it can be used to recover signer from signature signed using EIP712 formatted data
                       * https://eips.ethereum.org/EIPS/eip-712
                       * "\\\\x19" makes the encoding deterministic
                       * "\\\\x01" is the version byte to make it compatible to EIP-191
                       */
                      function toTypedMessageHash(bytes32 messageHash)
                          internal
                          view
                          returns (bytes32)
                      {
                          return
                              keccak256(
                                  abi.encodePacked("\\x19\\x01", getDomainSeperator(), messageHash)
                              );
                      }
                  }
                  // File: contracts/common/NativeMetaTransaction.sol
                  pragma solidity 0.6.6;
                  contract NativeMetaTransaction is EIP712Base {
                      using SafeMath for uint256;
                      bytes32 private constant META_TRANSACTION_TYPEHASH = keccak256(
                          bytes(
                              "MetaTransaction(uint256 nonce,address from,bytes functionSignature)"
                          )
                      );
                      event MetaTransactionExecuted(
                          address userAddress,
                          address payable relayerAddress,
                          bytes functionSignature
                      );
                      mapping(address => uint256) nonces;
                      /*
                       * Meta transaction structure.
                       * No point of including value field here as if user is doing value transfer then he has the funds to pay for gas
                       * He should call the desired function directly in that case.
                       */
                      struct MetaTransaction {
                          uint256 nonce;
                          address from;
                          bytes functionSignature;
                      }
                      function executeMetaTransaction(
                          address userAddress,
                          bytes memory functionSignature,
                          bytes32 sigR,
                          bytes32 sigS,
                          uint8 sigV
                      ) public payable returns (bytes memory) {
                          MetaTransaction memory metaTx = MetaTransaction({
                              nonce: nonces[userAddress],
                              from: userAddress,
                              functionSignature: functionSignature
                          });
                          require(
                              verify(userAddress, metaTx, sigR, sigS, sigV),
                              "Signer and signature do not match"
                          );
                          // increase nonce for user (to avoid re-use)
                          nonces[userAddress] = nonces[userAddress].add(1);
                          emit MetaTransactionExecuted(
                              userAddress,
                              msg.sender,
                              functionSignature
                          );
                          // Append userAddress and relayer address at the end to extract it from calling context
                          (bool success, bytes memory returnData) = address(this).call(
                              abi.encodePacked(functionSignature, userAddress)
                          );
                          require(success, "Function call not successful");
                          return returnData;
                      }
                      function hashMetaTransaction(MetaTransaction memory metaTx)
                          internal
                          pure
                          returns (bytes32)
                      {
                          return
                              keccak256(
                                  abi.encode(
                                      META_TRANSACTION_TYPEHASH,
                                      metaTx.nonce,
                                      metaTx.from,
                                      keccak256(metaTx.functionSignature)
                                  )
                              );
                      }
                      function getNonce(address user) public view returns (uint256 nonce) {
                          nonce = nonces[user];
                      }
                      function verify(
                          address signer,
                          MetaTransaction memory metaTx,
                          bytes32 sigR,
                          bytes32 sigS,
                          uint8 sigV
                      ) internal view returns (bool) {
                          require(signer != address(0), "NativeMetaTransaction: INVALID_SIGNER");
                          return
                              signer ==
                              ecrecover(
                                  toTypedMessageHash(hashMetaTransaction(metaTx)),
                                  sigV,
                                  sigR,
                                  sigS
                              );
                      }
                  }
                  // File: @openzeppelin/contracts/utils/EnumerableSet.sol
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.6.0;
                  /**
                   * @dev Library for managing
                   * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
                   * types.
                   *
                   * Sets have the following properties:
                   *
                   * - Elements are added, removed, and checked for existence in constant time
                   * (O(1)).
                   * - Elements are enumerated in O(n). No guarantees are made on the ordering.
                   *
                   * ```
                   * contract Example {
                   *     // Add the library methods
                   *     using EnumerableSet for EnumerableSet.AddressSet;
                   *
                   *     // Declare a set state variable
                   *     EnumerableSet.AddressSet private mySet;
                   * }
                   * ```
                   *
                   * As of v3.0.0, only sets of type `address` (`AddressSet`) and `uint256`
                   * (`UintSet`) are supported.
                   */
                  library EnumerableSet {
                      // To implement this library for multiple types with as little code
                      // repetition as possible, we write it in terms of a generic Set type with
                      // bytes32 values.
                      // The Set implementation uses private functions, and user-facing
                      // implementations (such as AddressSet) are just wrappers around the
                      // underlying Set.
                      // This means that we can only create new EnumerableSets for types that fit
                      // in bytes32.
                      struct Set {
                          // Storage of set values
                          bytes32[] _values;
                          // Position of the value in the `values` array, plus 1 because index 0
                          // means a value is not in the set.
                          mapping (bytes32 => uint256) _indexes;
                      }
                      /**
                       * @dev Add a value to a set. O(1).
                       *
                       * Returns true if the value was added to the set, that is if it was not
                       * already present.
                       */
                      function _add(Set storage set, bytes32 value) private returns (bool) {
                          if (!_contains(set, value)) {
                              set._values.push(value);
                              // The value is stored at length-1, but we add 1 to all indexes
                              // and use 0 as a sentinel value
                              set._indexes[value] = set._values.length;
                              return true;
                          } else {
                              return false;
                          }
                      }
                      /**
                       * @dev Removes a value from a set. O(1).
                       *
                       * Returns true if the value was removed from the set, that is if it was
                       * present.
                       */
                      function _remove(Set storage set, bytes32 value) private returns (bool) {
                          // We read and store the value's index to prevent multiple reads from the same storage slot
                          uint256 valueIndex = set._indexes[value];
                          if (valueIndex != 0) { // Equivalent to contains(set, value)
                              // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
                              // the array, and then remove the last element (sometimes called as 'swap and pop').
                              // This modifies the order of the array, as noted in {at}.
                              uint256 toDeleteIndex = valueIndex - 1;
                              uint256 lastIndex = set._values.length - 1;
                              // When the value to delete is the last one, the swap operation is unnecessary. However, since this occurs
                              // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                              bytes32 lastvalue = set._values[lastIndex];
                              // Move the last value to the index where the value to delete is
                              set._values[toDeleteIndex] = lastvalue;
                              // Update the index for the moved value
                              set._indexes[lastvalue] = toDeleteIndex + 1; // All indexes are 1-based
                              // Delete the slot where the moved value was stored
                              set._values.pop();
                              // Delete the index for the deleted slot
                              delete set._indexes[value];
                              return true;
                          } else {
                              return false;
                          }
                      }
                      /**
                       * @dev Returns true if the value is in the set. O(1).
                       */
                      function _contains(Set storage set, bytes32 value) private view returns (bool) {
                          return set._indexes[value] != 0;
                      }
                      /**
                       * @dev Returns the number of values on the set. O(1).
                       */
                      function _length(Set storage set) private view returns (uint256) {
                          return set._values.length;
                      }
                     /**
                      * @dev Returns the value stored at position `index` in the set. O(1).
                      *
                      * Note that there are no guarantees on the ordering of values inside the
                      * array, and it may change when more values are added or removed.
                      *
                      * Requirements:
                      *
                      * - `index` must be strictly less than {length}.
                      */
                      function _at(Set storage set, uint256 index) private view returns (bytes32) {
                          require(set._values.length > index, "EnumerableSet: index out of bounds");
                          return set._values[index];
                      }
                      // AddressSet
                      struct AddressSet {
                          Set _inner;
                      }
                      /**
                       * @dev Add a value to a set. O(1).
                       *
                       * Returns true if the value was added to the set, that is if it was not
                       * already present.
                       */
                      function add(AddressSet storage set, address value) internal returns (bool) {
                          return _add(set._inner, bytes32(uint256(value)));
                      }
                      /**
                       * @dev Removes a value from a set. O(1).
                       *
                       * Returns true if the value was removed from the set, that is if it was
                       * present.
                       */
                      function remove(AddressSet storage set, address value) internal returns (bool) {
                          return _remove(set._inner, bytes32(uint256(value)));
                      }
                      /**
                       * @dev Returns true if the value is in the set. O(1).
                       */
                      function contains(AddressSet storage set, address value) internal view returns (bool) {
                          return _contains(set._inner, bytes32(uint256(value)));
                      }
                      /**
                       * @dev Returns the number of values in the set. O(1).
                       */
                      function length(AddressSet storage set) internal view returns (uint256) {
                          return _length(set._inner);
                      }
                     /**
                      * @dev Returns the value stored at position `index` in the set. O(1).
                      *
                      * Note that there are no guarantees on the ordering of values inside the
                      * array, and it may change when more values are added or removed.
                      *
                      * Requirements:
                      *
                      * - `index` must be strictly less than {length}.
                      */
                      function at(AddressSet storage set, uint256 index) internal view returns (address) {
                          return address(uint256(_at(set._inner, index)));
                      }
                      // UintSet
                      struct UintSet {
                          Set _inner;
                      }
                      /**
                       * @dev Add a value to a set. O(1).
                       *
                       * Returns true if the value was added to the set, that is if it was not
                       * already present.
                       */
                      function add(UintSet storage set, uint256 value) internal returns (bool) {
                          return _add(set._inner, bytes32(value));
                      }
                      /**
                       * @dev Removes a value from a set. O(1).
                       *
                       * Returns true if the value was removed from the set, that is if it was
                       * present.
                       */
                      function remove(UintSet storage set, uint256 value) internal returns (bool) {
                          return _remove(set._inner, bytes32(value));
                      }
                      /**
                       * @dev Returns true if the value is in the set. O(1).
                       */
                      function contains(UintSet storage set, uint256 value) internal view returns (bool) {
                          return _contains(set._inner, bytes32(value));
                      }
                      /**
                       * @dev Returns the number of values on the set. O(1).
                       */
                      function length(UintSet storage set) internal view returns (uint256) {
                          return _length(set._inner);
                      }
                     /**
                      * @dev Returns the value stored at position `index` in the set. O(1).
                      *
                      * Note that there are no guarantees on the ordering of values inside the
                      * array, and it may change when more values are added or removed.
                      *
                      * Requirements:
                      *
                      * - `index` must be strictly less than {length}.
                      */
                      function at(UintSet storage set, uint256 index) internal view returns (uint256) {
                          return uint256(_at(set._inner, index));
                      }
                  }
                  // File: @openzeppelin/contracts/utils/Address.sol
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.6.2;
                  /**
                   * @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) {
                          // According to EIP-1052, 0x0 is the value returned for not-yet created accounts
                          // and 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470 is returned
                          // for accounts without code, i.e. `keccak256('')`
                          bytes32 codehash;
                          bytes32 accountHash = 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470;
                          // solhint-disable-next-line no-inline-assembly
                          assembly { codehash := extcodehash(account) }
                          return (codehash != accountHash && codehash != 0x0);
                      }
                      /**
                       * @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");
                          // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                          (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");
                          return _functionCallWithValue(target, data, value, errorMessage);
                      }
                      function _functionCallWithValue(address target, bytes memory data, uint256 weiValue, string memory errorMessage) private returns (bytes memory) {
                          require(isContract(target), "Address: call to non-contract");
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.call{ value: weiValue }(data);
                          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
                                  // solhint-disable-next-line no-inline-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                  }
                  // File: @openzeppelin/contracts/GSN/Context.sol
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.6.0;
                  /*
                   * @dev Provides information about the current execution context, including the
                   * sender of the transaction and its data. While these are generally available
                   * via msg.sender and msg.data, they should not be accessed in such a direct
                   * manner, since when dealing with GSN meta-transactions the account sending and
                   * paying for execution may not be the actual sender (as far as an application
                   * is concerned).
                   *
                   * This contract is only required for intermediate, library-like contracts.
                   */
                  abstract contract Context {
                      function _msgSender() internal view virtual returns (address payable) {
                          return msg.sender;
                      }
                      function _msgData() internal view virtual returns (bytes memory) {
                          this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                          return msg.data;
                      }
                  }
                  // File: @openzeppelin/contracts/access/AccessControl.sol
                  // SPDX-License-Identifier: MIT
                  pragma solidity ^0.6.0;
                  /**
                   * @dev Contract module that allows children to implement role-based access
                   * control mechanisms.
                   *
                   * Roles are referred to by their `bytes32` identifier. These should be exposed
                   * in the external API and be unique. The best way to achieve this is by
                   * using `public constant` hash digests:
                   *
                   * ```
                   * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
                   * ```
                   *
                   * Roles can be used to represent a set of permissions. To restrict access to a
                   * function call, use {hasRole}:
                   *
                   * ```
                   * function foo() public {
                   *     require(hasRole(MY_ROLE, msg.sender));
                   *     ...
                   * }
                   * ```
                   *
                   * Roles can be granted and revoked dynamically via the {grantRole} and
                   * {revokeRole} functions. Each role has an associated admin role, and only
                   * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
                   *
                   * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
                   * that only accounts with this role will be able to grant or revoke other
                   * roles. More complex role relationships can be created by using
                   * {_setRoleAdmin}.
                   *
                   * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
                   * grant and revoke this role. Extra precautions should be taken to secure
                   * accounts that have been granted it.
                   */
                  abstract contract AccessControl is Context {
                      using EnumerableSet for EnumerableSet.AddressSet;
                      using Address for address;
                      struct RoleData {
                          EnumerableSet.AddressSet members;
                          bytes32 adminRole;
                      }
                      mapping (bytes32 => RoleData) private _roles;
                      bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
                      /**
                       * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
                       *
                       * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
                       * {RoleAdminChanged} not being emitted signaling this.
                       *
                       * _Available since v3.1._
                       */
                      event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
                      /**
                       * @dev Emitted when `account` is granted `role`.
                       *
                       * `sender` is the account that originated the contract call, an admin role
                       * bearer except when using {_setupRole}.
                       */
                      event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
                      /**
                       * @dev Emitted when `account` is revoked `role`.
                       *
                       * `sender` is the account that originated the contract call:
                       *   - if using `revokeRole`, it is the admin role bearer
                       *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
                       */
                      event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
                      /**
                       * @dev Returns `true` if `account` has been granted `role`.
                       */
                      function hasRole(bytes32 role, address account) public view returns (bool) {
                          return _roles[role].members.contains(account);
                      }
                      /**
                       * @dev Returns the number of accounts that have `role`. Can be used
                       * together with {getRoleMember} to enumerate all bearers of a role.
                       */
                      function getRoleMemberCount(bytes32 role) public view returns (uint256) {
                          return _roles[role].members.length();
                      }
                      /**
                       * @dev Returns one of the accounts that have `role`. `index` must be a
                       * value between 0 and {getRoleMemberCount}, non-inclusive.
                       *
                       * Role bearers are not sorted in any particular way, and their ordering may
                       * change at any point.
                       *
                       * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
                       * you perform all queries on the same block. See the following
                       * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
                       * for more information.
                       */
                      function getRoleMember(bytes32 role, uint256 index) public view returns (address) {
                          return _roles[role].members.at(index);
                      }
                      /**
                       * @dev Returns the admin role that controls `role`. See {grantRole} and
                       * {revokeRole}.
                       *
                       * To change a role's admin, use {_setRoleAdmin}.
                       */
                      function getRoleAdmin(bytes32 role) public view returns (bytes32) {
                          return _roles[role].adminRole;
                      }
                      /**
                       * @dev Grants `role` to `account`.
                       *
                       * If `account` had not been already granted `role`, emits a {RoleGranted}
                       * event.
                       *
                       * Requirements:
                       *
                       * - the caller must have ``role``'s admin role.
                       */
                      function grantRole(bytes32 role, address account) public virtual {
                          require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to grant");
                          _grantRole(role, account);
                      }
                      /**
                       * @dev Revokes `role` from `account`.
                       *
                       * If `account` had been granted `role`, emits a {RoleRevoked} event.
                       *
                       * Requirements:
                       *
                       * - the caller must have ``role``'s admin role.
                       */
                      function revokeRole(bytes32 role, address account) public virtual {
                          require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to revoke");
                          _revokeRole(role, account);
                      }
                      /**
                       * @dev Revokes `role` from the calling account.
                       *
                       * Roles are often managed via {grantRole} and {revokeRole}: this function's
                       * purpose is to provide a mechanism for accounts to lose their privileges
                       * if they are compromised (such as when a trusted device is misplaced).
                       *
                       * If the calling account had been granted `role`, emits a {RoleRevoked}
                       * event.
                       *
                       * Requirements:
                       *
                       * - the caller must be `account`.
                       */
                      function renounceRole(bytes32 role, address account) public virtual {
                          require(account == _msgSender(), "AccessControl: can only renounce roles for self");
                          _revokeRole(role, account);
                      }
                      /**
                       * @dev Grants `role` to `account`.
                       *
                       * If `account` had not been already granted `role`, emits a {RoleGranted}
                       * event. Note that unlike {grantRole}, this function doesn't perform any
                       * checks on the calling account.
                       *
                       * [WARNING]
                       * ====
                       * This function should only be called from the constructor when setting
                       * up the initial roles for the system.
                       *
                       * Using this function in any other way is effectively circumventing the admin
                       * system imposed by {AccessControl}.
                       * ====
                       */
                      function _setupRole(bytes32 role, address account) internal virtual {
                          _grantRole(role, account);
                      }
                      /**
                       * @dev Sets `adminRole` as ``role``'s admin role.
                       *
                       * Emits a {RoleAdminChanged} event.
                       */
                      function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                          emit RoleAdminChanged(role, _roles[role].adminRole, adminRole);
                          _roles[role].adminRole = adminRole;
                      }
                      function _grantRole(bytes32 role, address account) private {
                          if (_roles[role].members.add(account)) {
                              emit RoleGranted(role, account, _msgSender());
                          }
                      }
                      function _revokeRole(bytes32 role, address account) private {
                          if (_roles[role].members.remove(account)) {
                              emit RoleRevoked(role, account, _msgSender());
                          }
                      }
                  }
                  // File: contracts/common/AccessControlMixin.sol
                  pragma solidity 0.6.6;
                  contract AccessControlMixin is AccessControl {
                      string private _revertMsg;
                      function _setupContractId(string memory contractId) internal {
                          _revertMsg = string(abi.encodePacked(contractId, ": INSUFFICIENT_PERMISSIONS"));
                      }
                      modifier only(bytes32 role) {
                          require(
                              hasRole(role, _msgSender()),
                              _revertMsg
                          );
                          _;
                      }
                  }
                  // File: contracts/common/ContextMixin.sol
                  pragma solidity 0.6.6;
                  abstract contract ContextMixin {
                      function msgSender()
                          internal
                          view
                          returns (address payable sender)
                      {
                          if (msg.sender == address(this)) {
                              bytes memory array = msg.data;
                              uint256 index = msg.data.length;
                              assembly {
                                  // Load the 32 bytes word from memory with the address on the lower 20 bytes, and mask those.
                                  sender := and(
                                      mload(add(array, index)),
                                      0xffffffffffffffffffffffffffffffffffffffff
                                  )
                              }
                          } else {
                              sender = msg.sender;
                          }
                          return sender;
                      }
                  }
                  // File: contracts/root/RootChainManager/RootChainManager.sol
                  pragma solidity 0.6.6;
                  contract RootChainManager is
                      IRootChainManager,
                      Initializable,
                      AccessControl, // included to match old storage layout while upgrading
                      RootChainManagerStorage, // created to match old storage layout while upgrading
                      AccessControlMixin,
                      NativeMetaTransaction,
                      ContextMixin
                  {
                      using ExitPayloadReader for bytes;
                      using ExitPayloadReader for ExitPayloadReader.ExitPayload;
                      using ExitPayloadReader for ExitPayloadReader.Log;
                      using ExitPayloadReader for ExitPayloadReader.Receipt;
                      using Merkle for bytes32;
                      using SafeMath for uint256;
                      // maybe DEPOSIT and MAP_TOKEN can be reduced to bytes4
                      bytes32 public constant DEPOSIT = keccak256("DEPOSIT");
                      bytes32 public constant MAP_TOKEN = keccak256("MAP_TOKEN");
                      address public constant ETHER_ADDRESS = 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE;
                      bytes32 public constant MAPPER_ROLE = keccak256("MAPPER_ROLE");
                      function _msgSender()
                          internal
                          override
                          view
                          returns (address payable sender)
                      {
                          return ContextMixin.msgSender();
                      }
                      /**
                       * @notice Deposit ether by directly sending to the contract
                       * The account sending ether receives WETH on child chain
                       */
                      receive() external payable {
                          _depositEtherFor(_msgSender());
                      }
                      /**
                       * @notice Initialize the contract after it has been proxified
                       * @dev meant to be called once immediately after deployment
                       * @param _owner the account that should be granted admin role
                       */
                      function initialize(
                          address _owner
                      )
                          external
                          initializer
                      {
                          _initializeEIP712("RootChainManager");
                          _setupContractId("RootChainManager");
                          _setupRole(DEFAULT_ADMIN_ROLE, _owner);
                          _setupRole(MAPPER_ROLE, _owner);
                      }
                      // adding seperate function setupContractId since initialize is already called with old implementation
                      function setupContractId()
                          external
                          only(DEFAULT_ADMIN_ROLE)
                      {
                          _setupContractId("RootChainManager");
                      }
                      // adding seperate function initializeEIP712 since initialize is already called with old implementation
                      function initializeEIP712()
                          external
                          only(DEFAULT_ADMIN_ROLE)
                      {
                          _setDomainSeperator("RootChainManager");
                      }
                      /**
                       * @notice Set the state sender, callable only by admins
                       * @dev This should be the state sender from plasma contracts
                       * It is used to send bytes from root to child chain
                       * @param newStateSender address of state sender contract
                       */
                      function setStateSender(address newStateSender)
                          external
                          only(DEFAULT_ADMIN_ROLE)
                      {
                          require(newStateSender != address(0), "RootChainManager: BAD_NEW_STATE_SENDER");
                          _stateSender = IStateSender(newStateSender);
                      }
                      /**
                       * @notice Get the address of contract set as state sender
                       * @return The address of state sender contract
                       */
                      function stateSenderAddress() external view returns (address) {
                          return address(_stateSender);
                      }
                      /**
                       * @notice Set the checkpoint manager, callable only by admins
                       * @dev This should be the plasma contract responsible for keeping track of checkpoints
                       * @param newCheckpointManager address of checkpoint manager contract
                       */
                      function setCheckpointManager(address newCheckpointManager)
                          external
                          only(DEFAULT_ADMIN_ROLE)
                      {
                          require(newCheckpointManager != address(0), "RootChainManager: BAD_NEW_CHECKPOINT_MANAGER");
                          _checkpointManager = ICheckpointManager(newCheckpointManager);
                      }
                      /**
                       * @notice Get the address of contract set as checkpoint manager
                       * @return The address of checkpoint manager contract
                       */
                      function checkpointManagerAddress() external view returns (address) {
                          return address(_checkpointManager);
                      }
                      /**
                       * @notice Set the child chain manager, callable only by admins
                       * @dev This should be the contract responsible to receive deposit bytes on child chain
                       * @param newChildChainManager address of child chain manager contract
                       */
                      function setChildChainManagerAddress(address newChildChainManager)
                          external
                          only(DEFAULT_ADMIN_ROLE)
                      {
                          require(newChildChainManager != address(0x0), "RootChainManager: INVALID_CHILD_CHAIN_ADDRESS");
                          childChainManagerAddress = newChildChainManager;
                      }
                      /**
                       * @notice Register a token predicate address against its type, callable only by ADMIN
                       * @dev A predicate is a contract responsible to process the token specific logic while locking or exiting tokens
                       * @param tokenType bytes32 unique identifier for the token type
                       * @param predicateAddress address of token predicate address
                       */
                      function registerPredicate(bytes32 tokenType, address predicateAddress)
                          external
                          override
                          only(DEFAULT_ADMIN_ROLE)
                      {
                          typeToPredicate[tokenType] = predicateAddress;
                          emit PredicateRegistered(tokenType, predicateAddress);
                      }
                      /**
                       * @notice Map a token to enable its movement via the PoS Portal, callable only by mappers
                       * @param rootToken address of token on root chain
                       * @param childToken address of token on child chain
                       * @param tokenType bytes32 unique identifier for the token type
                       */
                      function mapToken(
                          address rootToken,
                          address childToken,
                          bytes32 tokenType
                      ) external override only(MAPPER_ROLE) {
                          // explicit check if token is already mapped to avoid accidental remaps
                          require(
                              rootToChildToken[rootToken] == address(0) &&
                              childToRootToken[childToken] == address(0),
                              "RootChainManager: ALREADY_MAPPED"
                          );
                          _mapToken(rootToken, childToken, tokenType);
                      }
                      /**
                       * @notice Clean polluted token mapping
                       * @param rootToken address of token on root chain. Since rename token was introduced later stage,
                       * clean method is used to clean pollulated mapping
                       */
                      function cleanMapToken(
                          address rootToken,
                          address childToken
                      ) external override only(DEFAULT_ADMIN_ROLE) {
                          rootToChildToken[rootToken] = address(0);
                          childToRootToken[childToken] = address(0);
                          tokenToType[rootToken] = bytes32(0);
                          emit TokenMapped(rootToken, childToken, tokenToType[rootToken]);
                      }
                      /**
                       * @notice Remap a token that has already been mapped, properly cleans up old mapping
                       * Callable only by ADMIN
                       * @param rootToken address of token on root chain
                       * @param childToken address of token on child chain
                       * @param tokenType bytes32 unique identifier for the token type
                       */
                      function remapToken(
                          address rootToken,
                          address childToken,
                          bytes32 tokenType
                      ) external override only(DEFAULT_ADMIN_ROLE) {
                          // cleanup old mapping
                          address oldChildToken = rootToChildToken[rootToken];
                          address oldRootToken = childToRootToken[childToken];
                          if (rootToChildToken[oldRootToken] != address(0)) {
                              rootToChildToken[oldRootToken] = address(0);
                              tokenToType[oldRootToken] = bytes32(0);
                          }
                          if (childToRootToken[oldChildToken] != address(0)) {
                              childToRootToken[oldChildToken] = address(0);
                          }
                          _mapToken(rootToken, childToken, tokenType);
                      }
                      function _mapToken(
                          address rootToken,
                          address childToken,
                          bytes32 tokenType
                      ) private {
                          require(
                              typeToPredicate[tokenType] != address(0x0),
                              "RootChainManager: TOKEN_TYPE_NOT_SUPPORTED"
                          );
                          rootToChildToken[rootToken] = childToken;
                          childToRootToken[childToken] = rootToken;
                          tokenToType[rootToken] = tokenType;
                          emit TokenMapped(rootToken, childToken, tokenType);
                          bytes memory syncData = abi.encode(rootToken, childToken, tokenType);
                          _stateSender.syncState(
                              childChainManagerAddress,
                              abi.encode(MAP_TOKEN, syncData)
                          );
                      }
                      /**
                       * @notice Move ether from root to child chain, accepts ether transfer
                       * Keep in mind this ether cannot be used to pay gas on child chain
                       * Use Matic tokens deposited using plasma mechanism for that
                       * @param user address of account that should receive WETH on child chain
                       */
                      function depositEtherFor(address user) external override payable {
                          _depositEtherFor(user);
                      }
                      /**
                       * @notice Move tokens from root to child chain
                       * @dev This mechanism supports arbitrary tokens as long as its predicate has been registered and the token is mapped
                       * @param user address of account that should receive this deposit on child chain
                       * @param rootToken address of token that is being deposited
                       * @param depositData bytes data that is sent to predicate and child token contracts to handle deposit
                       */
                      function depositFor(
                          address user,
                          address rootToken,
                          bytes calldata depositData
                      ) external override {
                          require(
                              rootToken != ETHER_ADDRESS,
                              "RootChainManager: INVALID_ROOT_TOKEN"
                          );
                          _depositFor(user, rootToken, depositData);
                      }
                      function _depositEtherFor(address user) private {
                          bytes memory depositData = abi.encode(msg.value);
                          _depositFor(user, ETHER_ADDRESS, depositData);
                          // payable(typeToPredicate[tokenToType[ETHER_ADDRESS]]).transfer(msg.value);
                          // transfer doesn't work as expected when receiving contract is proxified so using call
                          (bool success, /* bytes memory data */) = typeToPredicate[tokenToType[ETHER_ADDRESS]].call{value: msg.value}("");
                          if (!success) {
                              revert("RootChainManager: ETHER_TRANSFER_FAILED");
                          }
                      }
                      function _depositFor(
                          address user,
                          address rootToken,
                          bytes memory depositData
                      ) private {
                          bytes32 tokenType = tokenToType[rootToken];
                          require(
                              rootToChildToken[rootToken] != address(0x0) &&
                                 tokenType != 0,
                              "RootChainManager: TOKEN_NOT_MAPPED"
                          );
                          address predicateAddress = typeToPredicate[tokenType];
                          require(
                              predicateAddress != address(0),
                              "RootChainManager: INVALID_TOKEN_TYPE"
                          );
                          require(
                              user != address(0),
                              "RootChainManager: INVALID_USER"
                          );
                          ITokenPredicate(predicateAddress).lockTokens(
                              _msgSender(),
                              user,
                              rootToken,
                              depositData
                          );
                          bytes memory syncData = abi.encode(user, rootToken, depositData);
                          _stateSender.syncState(
                              childChainManagerAddress,
                              abi.encode(DEPOSIT, syncData)
                          );
                      }
                      /**
                       * @notice exit tokens by providing proof
                       * @dev This function verifies if the transaction actually happened on child chain
                       * the transaction log is then sent to token predicate to handle it accordingly
                       *
                       * @param inputData RLP encoded data of the reference tx containing following list of fields
                       *  0 - headerNumber - Checkpoint header block number containing the reference tx
                       *  1 - blockProof - Proof that the block header (in the child chain) is a leaf in the submitted merkle root
                       *  2 - blockNumber - Block number containing the reference tx on child chain
                       *  3 - blockTime - Reference tx block time
                       *  4 - txRoot - Transactions root of block
                       *  5 - receiptRoot - Receipts root of block
                       *  6 - receipt - Receipt of the reference transaction
                       *  7 - receiptProof - Merkle proof of the reference receipt
                       *  8 - branchMask - 32 bits denoting the path of receipt in merkle tree
                       *  9 - receiptLogIndex - Log Index to read from the receipt
                       */
                      function exit(bytes calldata inputData) external override {
                          ExitPayloadReader.ExitPayload memory payload = inputData.toExitPayload();
                          bytes memory branchMaskBytes = payload.getBranchMaskAsBytes();
                          // checking if exit has already been processed
                          // unique exit is identified using hash of (blockNumber, branchMask, receiptLogIndex)
                          bytes32 exitHash = keccak256(
                              abi.encodePacked(
                                  payload.getBlockNumber(),
                                  // first 2 nibbles are dropped while generating nibble array
                                  // this allows branch masks that are valid but bypass exitHash check (changing first 2 nibbles only)
                                  // so converting to nibble array and then hashing it
                                  MerklePatriciaProof._getNibbleArray(branchMaskBytes),
                                  payload.getReceiptLogIndex()
                              )
                          );
                          require(
                              processedExits[exitHash] == false,
                              "RootChainManager: EXIT_ALREADY_PROCESSED"
                          );
                          processedExits[exitHash] = true;
                          ExitPayloadReader.Receipt memory receipt = payload.getReceipt();
                          ExitPayloadReader.Log memory log = receipt.getLog();
                          // log should be emmited only by the child token
                          address rootToken = childToRootToken[log.getEmitter()];
                          require(
                              rootToken != address(0),
                              "RootChainManager: TOKEN_NOT_MAPPED"
                          );
                          address predicateAddress = typeToPredicate[
                              tokenToType[rootToken]
                          ];
                          // branch mask can be maximum 32 bits
                          require(
                              payload.getBranchMaskAsUint() &
                              0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000 ==
                              0,
                              "RootChainManager: INVALID_BRANCH_MASK"
                          );
                          // verify receipt inclusion
                          require(
                              MerklePatriciaProof.verify(
                                  receipt.toBytes(),
                                  branchMaskBytes,
                                  payload.getReceiptProof(),
                                  payload.getReceiptRoot()
                              ),
                              "RootChainManager: INVALID_PROOF"
                          );
                          // verify checkpoint inclusion
                          _checkBlockMembershipInCheckpoint(
                              payload.getBlockNumber(),
                              payload.getBlockTime(),
                              payload.getTxRoot(),
                              payload.getReceiptRoot(),
                              payload.getHeaderNumber(),
                              payload.getBlockProof()
                          );
                          ITokenPredicate(predicateAddress).exitTokens(
                              _msgSender(),
                              rootToken,
                              log.toRlpBytes()
                          );
                      }
                      function _checkBlockMembershipInCheckpoint(
                          uint256 blockNumber,
                          uint256 blockTime,
                          bytes32 txRoot,
                          bytes32 receiptRoot,
                          uint256 headerNumber,
                          bytes memory blockProof
                      ) private view returns (uint256) {
                          (
                              bytes32 headerRoot,
                              uint256 startBlock,
                              ,
                              uint256 createdAt,
                          ) = _checkpointManager.headerBlocks(headerNumber);
                          require(
                              keccak256(
                                  abi.encodePacked(blockNumber, blockTime, txRoot, receiptRoot)
                              )
                                  .checkMembership(
                                  blockNumber.sub(startBlock),
                                  headerRoot,
                                  blockProof
                              ),
                              "RootChainManager: INVALID_HEADER"
                          );
                          return createdAt;
                      }
                  }
                  

                  File 8 of 8: MintableERC721Predicate
                  // File: @openzeppelin/contracts/token/ERC721/IERC721Receiver.sol
                  
                  // SPDX-License-Identifier: MIT
                  
                  pragma solidity ^0.6.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);
                  }
                  
                  // File: @openzeppelin/contracts/utils/EnumerableSet.sol
                  
                  // SPDX-License-Identifier: MIT
                  
                  pragma solidity ^0.6.0;
                  
                  /**
                   * @dev Library for managing
                   * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
                   * types.
                   *
                   * Sets have the following properties:
                   *
                   * - Elements are added, removed, and checked for existence in constant time
                   * (O(1)).
                   * - Elements are enumerated in O(n). No guarantees are made on the ordering.
                   *
                   * ```
                   * contract Example {
                   *     // Add the library methods
                   *     using EnumerableSet for EnumerableSet.AddressSet;
                   *
                   *     // Declare a set state variable
                   *     EnumerableSet.AddressSet private mySet;
                   * }
                   * ```
                   *
                   * As of v3.0.0, only sets of type `address` (`AddressSet`) and `uint256`
                   * (`UintSet`) are supported.
                   */
                  library EnumerableSet {
                      // To implement this library for multiple types with as little code
                      // repetition as possible, we write it in terms of a generic Set type with
                      // bytes32 values.
                      // The Set implementation uses private functions, and user-facing
                      // implementations (such as AddressSet) are just wrappers around the
                      // underlying Set.
                      // This means that we can only create new EnumerableSets for types that fit
                      // in bytes32.
                  
                      struct Set {
                          // Storage of set values
                          bytes32[] _values;
                  
                          // Position of the value in the `values` array, plus 1 because index 0
                          // means a value is not in the set.
                          mapping (bytes32 => uint256) _indexes;
                      }
                  
                      /**
                       * @dev Add a value to a set. O(1).
                       *
                       * Returns true if the value was added to the set, that is if it was not
                       * already present.
                       */
                      function _add(Set storage set, bytes32 value) private returns (bool) {
                          if (!_contains(set, value)) {
                              set._values.push(value);
                              // The value is stored at length-1, but we add 1 to all indexes
                              // and use 0 as a sentinel value
                              set._indexes[value] = set._values.length;
                              return true;
                          } else {
                              return false;
                          }
                      }
                  
                      /**
                       * @dev Removes a value from a set. O(1).
                       *
                       * Returns true if the value was removed from the set, that is if it was
                       * present.
                       */
                      function _remove(Set storage set, bytes32 value) private returns (bool) {
                          // We read and store the value's index to prevent multiple reads from the same storage slot
                          uint256 valueIndex = set._indexes[value];
                  
                          if (valueIndex != 0) { // Equivalent to contains(set, value)
                              // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
                              // the array, and then remove the last element (sometimes called as 'swap and pop').
                              // This modifies the order of the array, as noted in {at}.
                  
                              uint256 toDeleteIndex = valueIndex - 1;
                              uint256 lastIndex = set._values.length - 1;
                  
                              // When the value to delete is the last one, the swap operation is unnecessary. However, since this occurs
                              // so rarely, we still do the swap anyway to avoid the gas cost of adding an 'if' statement.
                  
                              bytes32 lastvalue = set._values[lastIndex];
                  
                              // Move the last value to the index where the value to delete is
                              set._values[toDeleteIndex] = lastvalue;
                              // Update the index for the moved value
                              set._indexes[lastvalue] = toDeleteIndex + 1; // All indexes are 1-based
                  
                              // Delete the slot where the moved value was stored
                              set._values.pop();
                  
                              // Delete the index for the deleted slot
                              delete set._indexes[value];
                  
                              return true;
                          } else {
                              return false;
                          }
                      }
                  
                      /**
                       * @dev Returns true if the value is in the set. O(1).
                       */
                      function _contains(Set storage set, bytes32 value) private view returns (bool) {
                          return set._indexes[value] != 0;
                      }
                  
                      /**
                       * @dev Returns the number of values on the set. O(1).
                       */
                      function _length(Set storage set) private view returns (uint256) {
                          return set._values.length;
                      }
                  
                     /**
                      * @dev Returns the value stored at position `index` in the set. O(1).
                      *
                      * Note that there are no guarantees on the ordering of values inside the
                      * array, and it may change when more values are added or removed.
                      *
                      * Requirements:
                      *
                      * - `index` must be strictly less than {length}.
                      */
                      function _at(Set storage set, uint256 index) private view returns (bytes32) {
                          require(set._values.length > index, "EnumerableSet: index out of bounds");
                          return set._values[index];
                      }
                  
                      // AddressSet
                  
                      struct AddressSet {
                          Set _inner;
                      }
                  
                      /**
                       * @dev Add a value to a set. O(1).
                       *
                       * Returns true if the value was added to the set, that is if it was not
                       * already present.
                       */
                      function add(AddressSet storage set, address value) internal returns (bool) {
                          return _add(set._inner, bytes32(uint256(value)));
                      }
                  
                      /**
                       * @dev Removes a value from a set. O(1).
                       *
                       * Returns true if the value was removed from the set, that is if it was
                       * present.
                       */
                      function remove(AddressSet storage set, address value) internal returns (bool) {
                          return _remove(set._inner, bytes32(uint256(value)));
                      }
                  
                      /**
                       * @dev Returns true if the value is in the set. O(1).
                       */
                      function contains(AddressSet storage set, address value) internal view returns (bool) {
                          return _contains(set._inner, bytes32(uint256(value)));
                      }
                  
                      /**
                       * @dev Returns the number of values in the set. O(1).
                       */
                      function length(AddressSet storage set) internal view returns (uint256) {
                          return _length(set._inner);
                      }
                  
                     /**
                      * @dev Returns the value stored at position `index` in the set. O(1).
                      *
                      * Note that there are no guarantees on the ordering of values inside the
                      * array, and it may change when more values are added or removed.
                      *
                      * Requirements:
                      *
                      * - `index` must be strictly less than {length}.
                      */
                      function at(AddressSet storage set, uint256 index) internal view returns (address) {
                          return address(uint256(_at(set._inner, index)));
                      }
                  
                  
                      // UintSet
                  
                      struct UintSet {
                          Set _inner;
                      }
                  
                      /**
                       * @dev Add a value to a set. O(1).
                       *
                       * Returns true if the value was added to the set, that is if it was not
                       * already present.
                       */
                      function add(UintSet storage set, uint256 value) internal returns (bool) {
                          return _add(set._inner, bytes32(value));
                      }
                  
                      /**
                       * @dev Removes a value from a set. O(1).
                       *
                       * Returns true if the value was removed from the set, that is if it was
                       * present.
                       */
                      function remove(UintSet storage set, uint256 value) internal returns (bool) {
                          return _remove(set._inner, bytes32(value));
                      }
                  
                      /**
                       * @dev Returns true if the value is in the set. O(1).
                       */
                      function contains(UintSet storage set, uint256 value) internal view returns (bool) {
                          return _contains(set._inner, bytes32(value));
                      }
                  
                      /**
                       * @dev Returns the number of values on the set. O(1).
                       */
                      function length(UintSet storage set) internal view returns (uint256) {
                          return _length(set._inner);
                      }
                  
                     /**
                      * @dev Returns the value stored at position `index` in the set. O(1).
                      *
                      * Note that there are no guarantees on the ordering of values inside the
                      * array, and it may change when more values are added or removed.
                      *
                      * Requirements:
                      *
                      * - `index` must be strictly less than {length}.
                      */
                      function at(UintSet storage set, uint256 index) internal view returns (uint256) {
                          return uint256(_at(set._inner, index));
                      }
                  }
                  
                  // File: @openzeppelin/contracts/utils/Address.sol
                  
                  // SPDX-License-Identifier: MIT
                  
                  pragma solidity ^0.6.2;
                  
                  /**
                   * @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) {
                          // According to EIP-1052, 0x0 is the value returned for not-yet created accounts
                          // and 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470 is returned
                          // for accounts without code, i.e. `keccak256('')`
                          bytes32 codehash;
                          bytes32 accountHash = 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470;
                          // solhint-disable-next-line no-inline-assembly
                          assembly { codehash := extcodehash(account) }
                          return (codehash != accountHash && codehash != 0x0);
                      }
                  
                      /**
                       * @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");
                  
                          // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                          (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");
                          return _functionCallWithValue(target, data, value, errorMessage);
                      }
                  
                      function _functionCallWithValue(address target, bytes memory data, uint256 weiValue, string memory errorMessage) private returns (bytes memory) {
                          require(isContract(target), "Address: call to non-contract");
                  
                          // solhint-disable-next-line avoid-low-level-calls
                          (bool success, bytes memory returndata) = target.call{ value: weiValue }(data);
                          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
                  
                                  // solhint-disable-next-line no-inline-assembly
                                  assembly {
                                      let returndata_size := mload(returndata)
                                      revert(add(32, returndata), returndata_size)
                                  }
                              } else {
                                  revert(errorMessage);
                              }
                          }
                      }
                  }
                  
                  // File: @openzeppelin/contracts/GSN/Context.sol
                  
                  // SPDX-License-Identifier: MIT
                  
                  pragma solidity ^0.6.0;
                  
                  /*
                   * @dev Provides information about the current execution context, including the
                   * sender of the transaction and its data. While these are generally available
                   * via msg.sender and msg.data, they should not be accessed in such a direct
                   * manner, since when dealing with GSN meta-transactions the account sending and
                   * paying for execution may not be the actual sender (as far as an application
                   * is concerned).
                   *
                   * This contract is only required for intermediate, library-like contracts.
                   */
                  abstract contract Context {
                      function _msgSender() internal view virtual returns (address payable) {
                          return msg.sender;
                      }
                  
                      function _msgData() internal view virtual returns (bytes memory) {
                          this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                          return msg.data;
                      }
                  }
                  
                  // File: @openzeppelin/contracts/access/AccessControl.sol
                  
                  // SPDX-License-Identifier: MIT
                  
                  pragma solidity ^0.6.0;
                  
                  
                  
                  
                  /**
                   * @dev Contract module that allows children to implement role-based access
                   * control mechanisms.
                   *
                   * Roles are referred to by their `bytes32` identifier. These should be exposed
                   * in the external API and be unique. The best way to achieve this is by
                   * using `public constant` hash digests:
                   *
                   * ```
                   * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
                   * ```
                   *
                   * Roles can be used to represent a set of permissions. To restrict access to a
                   * function call, use {hasRole}:
                   *
                   * ```
                   * function foo() public {
                   *     require(hasRole(MY_ROLE, msg.sender));
                   *     ...
                   * }
                   * ```
                   *
                   * Roles can be granted and revoked dynamically via the {grantRole} and
                   * {revokeRole} functions. Each role has an associated admin role, and only
                   * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
                   *
                   * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
                   * that only accounts with this role will be able to grant or revoke other
                   * roles. More complex role relationships can be created by using
                   * {_setRoleAdmin}.
                   *
                   * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
                   * grant and revoke this role. Extra precautions should be taken to secure
                   * accounts that have been granted it.
                   */
                  abstract contract AccessControl is Context {
                      using EnumerableSet for EnumerableSet.AddressSet;
                      using Address for address;
                  
                      struct RoleData {
                          EnumerableSet.AddressSet members;
                          bytes32 adminRole;
                      }
                  
                      mapping (bytes32 => RoleData) private _roles;
                  
                      bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
                  
                      /**
                       * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
                       *
                       * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
                       * {RoleAdminChanged} not being emitted signaling this.
                       *
                       * _Available since v3.1._
                       */
                      event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
                  
                      /**
                       * @dev Emitted when `account` is granted `role`.
                       *
                       * `sender` is the account that originated the contract call, an admin role
                       * bearer except when using {_setupRole}.
                       */
                      event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
                  
                      /**
                       * @dev Emitted when `account` is revoked `role`.
                       *
                       * `sender` is the account that originated the contract call:
                       *   - if using `revokeRole`, it is the admin role bearer
                       *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
                       */
                      event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
                  
                      /**
                       * @dev Returns `true` if `account` has been granted `role`.
                       */
                      function hasRole(bytes32 role, address account) public view returns (bool) {
                          return _roles[role].members.contains(account);
                      }
                  
                      /**
                       * @dev Returns the number of accounts that have `role`. Can be used
                       * together with {getRoleMember} to enumerate all bearers of a role.
                       */
                      function getRoleMemberCount(bytes32 role) public view returns (uint256) {
                          return _roles[role].members.length();
                      }
                  
                      /**
                       * @dev Returns one of the accounts that have `role`. `index` must be a
                       * value between 0 and {getRoleMemberCount}, non-inclusive.
                       *
                       * Role bearers are not sorted in any particular way, and their ordering may
                       * change at any point.
                       *
                       * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
                       * you perform all queries on the same block. See the following
                       * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
                       * for more information.
                       */
                      function getRoleMember(bytes32 role, uint256 index) public view returns (address) {
                          return _roles[role].members.at(index);
                      }
                  
                      /**
                       * @dev Returns the admin role that controls `role`. See {grantRole} and
                       * {revokeRole}.
                       *
                       * To change a role's admin, use {_setRoleAdmin}.
                       */
                      function getRoleAdmin(bytes32 role) public view returns (bytes32) {
                          return _roles[role].adminRole;
                      }
                  
                      /**
                       * @dev Grants `role` to `account`.
                       *
                       * If `account` had not been already granted `role`, emits a {RoleGranted}
                       * event.
                       *
                       * Requirements:
                       *
                       * - the caller must have ``role``'s admin role.
                       */
                      function grantRole(bytes32 role, address account) public virtual {
                          require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to grant");
                  
                          _grantRole(role, account);
                      }
                  
                      /**
                       * @dev Revokes `role` from `account`.
                       *
                       * If `account` had been granted `role`, emits a {RoleRevoked} event.
                       *
                       * Requirements:
                       *
                       * - the caller must have ``role``'s admin role.
                       */
                      function revokeRole(bytes32 role, address account) public virtual {
                          require(hasRole(_roles[role].adminRole, _msgSender()), "AccessControl: sender must be an admin to revoke");
                  
                          _revokeRole(role, account);
                      }
                  
                      /**
                       * @dev Revokes `role` from the calling account.
                       *
                       * Roles are often managed via {grantRole} and {revokeRole}: this function's
                       * purpose is to provide a mechanism for accounts to lose their privileges
                       * if they are compromised (such as when a trusted device is misplaced).
                       *
                       * If the calling account had been granted `role`, emits a {RoleRevoked}
                       * event.
                       *
                       * Requirements:
                       *
                       * - the caller must be `account`.
                       */
                      function renounceRole(bytes32 role, address account) public virtual {
                          require(account == _msgSender(), "AccessControl: can only renounce roles for self");
                  
                          _revokeRole(role, account);
                      }
                  
                      /**
                       * @dev Grants `role` to `account`.
                       *
                       * If `account` had not been already granted `role`, emits a {RoleGranted}
                       * event. Note that unlike {grantRole}, this function doesn't perform any
                       * checks on the calling account.
                       *
                       * [WARNING]
                       * ====
                       * This function should only be called from the constructor when setting
                       * up the initial roles for the system.
                       *
                       * Using this function in any other way is effectively circumventing the admin
                       * system imposed by {AccessControl}.
                       * ====
                       */
                      function _setupRole(bytes32 role, address account) internal virtual {
                          _grantRole(role, account);
                      }
                  
                      /**
                       * @dev Sets `adminRole` as ``role``'s admin role.
                       *
                       * Emits a {RoleAdminChanged} event.
                       */
                      function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                          emit RoleAdminChanged(role, _roles[role].adminRole, adminRole);
                          _roles[role].adminRole = adminRole;
                      }
                  
                      function _grantRole(bytes32 role, address account) private {
                          if (_roles[role].members.add(account)) {
                              emit RoleGranted(role, account, _msgSender());
                          }
                      }
                  
                      function _revokeRole(bytes32 role, address account) private {
                          if (_roles[role].members.remove(account)) {
                              emit RoleRevoked(role, account, _msgSender());
                          }
                      }
                  }
                  
                  // File: contracts/common/AccessControlMixin.sol
                  
                  pragma solidity 0.6.6;
                  
                  
                  contract AccessControlMixin is AccessControl {
                      string private _revertMsg;
                      function _setupContractId(string memory contractId) internal {
                          _revertMsg = string(abi.encodePacked(contractId, ": INSUFFICIENT_PERMISSIONS"));
                      }
                  
                      modifier only(bytes32 role) {
                          require(
                              hasRole(role, _msgSender()),
                              _revertMsg
                          );
                          _;
                      }
                  }
                  
                  // File: contracts/lib/RLPReader.sol
                  
                  /*
                   * @author Hamdi Allam [email protected]
                   * Please reach out with any questions or concerns
                   * https://github.com/hamdiallam/Solidity-RLP/blob/e681e25a376dbd5426b509380bc03446f05d0f97/contracts/RLPReader.sol
                   */
                  pragma solidity 0.6.6;
                  
                  library RLPReader {
                      uint8 constant STRING_SHORT_START = 0x80;
                      uint8 constant STRING_LONG_START = 0xb8;
                      uint8 constant LIST_SHORT_START = 0xc0;
                      uint8 constant LIST_LONG_START = 0xf8;
                      uint8 constant WORD_SIZE = 32;
                  
                      struct RLPItem {
                          uint256 len;
                          uint256 memPtr;
                      }
                  
                      /*
                       * @param item RLP encoded bytes
                       */
                      function toRlpItem(bytes memory item)
                          internal
                          pure
                          returns (RLPItem memory)
                      {
                          require(item.length > 0, "RLPReader: INVALID_BYTES_LENGTH");
                          uint256 memPtr;
                          assembly {
                              memPtr := add(item, 0x20)
                          }
                  
                          return RLPItem(item.length, memPtr);
                      }
                  
                      /*
                       * @param item RLP encoded list in bytes
                       */
                      function toList(RLPItem memory item)
                          internal
                          pure
                          returns (RLPItem[] memory)
                      {
                          require(isList(item), "RLPReader: ITEM_NOT_LIST");
                  
                          uint256 items = numItems(item);
                          RLPItem[] memory result = new RLPItem[](items);
                          uint256 listLength = _itemLength(item.memPtr);
                          require(listLength == item.len, "RLPReader: LIST_DECODED_LENGTH_MISMATCH");
                  
                          uint256 memPtr = item.memPtr + _payloadOffset(item.memPtr);
                          uint256 dataLen;
                          for (uint256 i = 0; i < items; i++) {
                              dataLen = _itemLength(memPtr);
                              result[i] = RLPItem(dataLen, memPtr);
                              memPtr = memPtr + dataLen;
                          }
                  
                          return result;
                      }
                  
                      // @return indicator whether encoded payload is a list. negate this function call for isData.
                      function isList(RLPItem memory item) internal pure returns (bool) {
                          uint8 byte0;
                          uint256 memPtr = item.memPtr;
                          assembly {
                              byte0 := byte(0, mload(memPtr))
                          }
                  
                          if (byte0 < LIST_SHORT_START) return false;
                          return true;
                      }
                  
                      /** RLPItem conversions into data types **/
                  
                      // @returns raw rlp encoding in bytes
                      function toRlpBytes(RLPItem memory item)
                          internal
                          pure
                          returns (bytes memory)
                      {
                          bytes memory result = new bytes(item.len);
                  
                          uint256 ptr;
                          assembly {
                              ptr := add(0x20, result)
                          }
                  
                          copy(item.memPtr, ptr, item.len);
                          return result;
                      }
                  
                      function toAddress(RLPItem memory item) internal pure returns (address) {
                          require(!isList(item), "RLPReader: DECODING_LIST_AS_ADDRESS");
                          // 1 byte for the length prefix
                          require(item.len == 21, "RLPReader: INVALID_ADDRESS_LENGTH");
                  
                          return address(toUint(item));
                      }
                  
                      function toUint(RLPItem memory item) internal pure returns (uint256) {
                          require(!isList(item), "RLPReader: DECODING_LIST_AS_UINT");
                          require(item.len <= 33, "RLPReader: INVALID_UINT_LENGTH");
                  
                          uint256 itemLength = _itemLength(item.memPtr);
                          require(itemLength == item.len, "RLPReader: UINT_DECODED_LENGTH_MISMATCH");
                  
                          uint256 offset = _payloadOffset(item.memPtr);
                          uint256 len = item.len - offset;
                          uint256 result;
                          uint256 memPtr = item.memPtr + offset;
                          assembly {
                              result := mload(memPtr)
                  
                              // shfit to the correct location if neccesary
                              if lt(len, 32) {
                                  result := div(result, exp(256, sub(32, len)))
                              }
                          }
                  
                          return result;
                      }
                  
                      // enforces 32 byte length
                      function toUintStrict(RLPItem memory item) internal pure returns (uint256) {
                          uint256 itemLength = _itemLength(item.memPtr);
                          require(itemLength == item.len, "RLPReader: UINT_STRICT_DECODED_LENGTH_MISMATCH");
                          // one byte prefix
                          require(item.len == 33, "RLPReader: INVALID_UINT_STRICT_LENGTH");
                  
                          uint256 result;
                          uint256 memPtr = item.memPtr + 1;
                          assembly {
                              result := mload(memPtr)
                          }
                  
                          return result;
                      }
                  
                      function toBytes(RLPItem memory item) internal pure returns (bytes memory) {
                          uint256 listLength = _itemLength(item.memPtr);
                          require(listLength == item.len, "RLPReader: BYTES_DECODED_LENGTH_MISMATCH");
                          uint256 offset = _payloadOffset(item.memPtr);
                  
                          uint256 len = item.len - offset; // data length
                          bytes memory result = new bytes(len);
                  
                          uint256 destPtr;
                          assembly {
                              destPtr := add(0x20, result)
                          }
                  
                          copy(item.memPtr + offset, destPtr, len);
                          return result;
                      }
                  
                      /*
                       * Private Helpers
                       */
                  
                      // @return number of payload items inside an encoded list.
                      function numItems(RLPItem memory item) private pure returns (uint256) {
                          // add `isList` check if `item` is expected to be passsed without a check from calling function
                          // require(isList(item), "RLPReader: NUM_ITEMS_NOT_LIST");
                  
                          uint256 count = 0;
                          uint256 currPtr = item.memPtr + _payloadOffset(item.memPtr);
                          uint256 endPtr = item.memPtr + item.len;
                          while (currPtr < endPtr) {
                              currPtr = currPtr + _itemLength(currPtr); // skip over an item
                              require(currPtr <= endPtr, "RLPReader: NUM_ITEMS_DECODED_LENGTH_MISMATCH");
                              count++;
                          }
                  
                          return count;
                      }
                  
                      // @return entire rlp item byte length
                      function _itemLength(uint256 memPtr) private pure returns (uint256) {
                          uint256 itemLen;
                          uint256 byte0;
                          assembly {
                              byte0 := byte(0, mload(memPtr))
                          }
                  
                          if (byte0 < STRING_SHORT_START) itemLen = 1;
                          else if (byte0 < STRING_LONG_START)
                              itemLen = byte0 - STRING_SHORT_START + 1;
                          else if (byte0 < LIST_SHORT_START) {
                              assembly {
                                  let byteLen := sub(byte0, 0xb7) // # of bytes the actual length is
                                  memPtr := add(memPtr, 1) // skip over the first byte
                  
                                  /* 32 byte word size */
                                  let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to get the len
                                  itemLen := add(dataLen, add(byteLen, 1))
                              }
                          } else if (byte0 < LIST_LONG_START) {
                              itemLen = byte0 - LIST_SHORT_START + 1;
                          } else {
                              assembly {
                                  let byteLen := sub(byte0, 0xf7)
                                  memPtr := add(memPtr, 1)
                  
                                  let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to the correct length
                                  itemLen := add(dataLen, add(byteLen, 1))
                              }
                          }
                  
                          return itemLen;
                      }
                  
                      // @return number of bytes until the data
                      function _payloadOffset(uint256 memPtr) private pure returns (uint256) {
                          uint256 byte0;
                          assembly {
                              byte0 := byte(0, mload(memPtr))
                          }
                  
                          if (byte0 < STRING_SHORT_START) return 0;
                          else if (
                              byte0 < STRING_LONG_START ||
                              (byte0 >= LIST_SHORT_START && byte0 < LIST_LONG_START)
                          ) return 1;
                          else if (byte0 < LIST_SHORT_START)
                              // being explicit
                              return byte0 - (STRING_LONG_START - 1) + 1;
                          else return byte0 - (LIST_LONG_START - 1) + 1;
                      }
                  
                      /*
                       * @param src Pointer to source
                       * @param dest Pointer to destination
                       * @param len Amount of memory to copy from the source
                       */
                      function copy(
                          uint256 src,
                          uint256 dest,
                          uint256 len
                      ) private pure {
                          if (len == 0) return;
                  
                          // copy as many word sizes as possible
                          for (; len >= WORD_SIZE; len -= WORD_SIZE) {
                              assembly {
                                  mstore(dest, mload(src))
                              }
                  
                              src += WORD_SIZE;
                              dest += WORD_SIZE;
                          }
                  
                          // left over bytes. Mask is used to remove unwanted bytes from the word
                          uint256 mask = 256**(WORD_SIZE - len) - 1;
                          assembly {
                              let srcpart := and(mload(src), not(mask)) // zero out src
                              let destpart := and(mload(dest), mask) // retrieve the bytes
                              mstore(dest, or(destpart, srcpart))
                          }
                      }
                  }
                  
                  // File: @openzeppelin/contracts/introspection/IERC165.sol
                  
                  // SPDX-License-Identifier: MIT
                  
                  pragma solidity ^0.6.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);
                  }
                  
                  // File: @openzeppelin/contracts/token/ERC721/IERC721.sol
                  
                  // SPDX-License-Identifier: MIT
                  
                  pragma solidity ^0.6.2;
                  
                  
                  /**
                   * @dev Required interface of an ERC721 compliant contract.
                   */
                  interface IERC721 is IERC165 {
                      /**
                       * @dev Emitted when `tokenId` token is transfered 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;
                  }
                  
                  // File: contracts/root/RootToken/IMintableERC721.sol
                  
                  pragma solidity 0.6.6;
                  
                  interface IMintableERC721 is IERC721 {
                      /**
                       * @notice called by predicate contract to mint tokens while withdrawing
                       * @dev Should be callable only by MintableERC721Predicate
                       * Make sure minting is done only by this function
                       * @param user user address for whom token is being minted
                       * @param tokenId tokenId being minted
                       */
                      function mint(address user, uint256 tokenId) external;
                  
                      /**
                       * @notice called by predicate contract to mint tokens while withdrawing with metadata from L2
                       * @dev Should be callable only by MintableERC721Predicate
                       * Make sure minting is only done either by this function/ ?
                       * @param user user address for whom token is being minted
                       * @param tokenId tokenId being minted
                       * @param metaData Associated token metadata, to be decoded & set using `setTokenMetadata`
                       *
                       * Note : If you're interested in taking token metadata from L2 to L1 during exit, you must
                       * implement this method
                       */
                      function mint(address user, uint256 tokenId, bytes calldata metaData) external;
                  
                      /**
                       * @notice check if token already exists, return true if it does exist
                       * @dev this check will be used by the predicate to determine if the token needs to be minted or transfered
                       * @param tokenId tokenId being checked
                       */
                      function exists(uint256 tokenId) external view returns (bool);
                  }
                  
                  // File: contracts/root/TokenPredicates/ITokenPredicate.sol
                  
                  pragma solidity 0.6.6;
                  
                  
                  /// @title Token predicate interface for all pos portal predicates
                  /// @notice Abstract interface that defines methods for custom predicates
                  interface ITokenPredicate {
                  
                      /**
                       * @notice Deposit tokens into pos portal
                       * @dev When `depositor` deposits tokens into pos portal, tokens get locked into predicate contract.
                       * @param depositor Address who wants to deposit tokens
                       * @param depositReceiver Address (address) who wants to receive tokens on side chain
                       * @param rootToken Token which gets deposited
                       * @param depositData Extra data for deposit (amount for ERC20, token id for ERC721 etc.) [ABI encoded]
                       */
                      function lockTokens(
                          address depositor,
                          address depositReceiver,
                          address rootToken,
                          bytes calldata depositData
                      ) external;
                  
                      /**
                       * @notice Validates and processes exit while withdraw process
                       * @dev Validates exit log emitted on sidechain. Reverts if validation fails.
                       * @dev Processes withdraw based on custom logic. Example: transfer ERC20/ERC721, mint ERC721 if mintable withdraw
                       * @param sender Address
                       * @param rootToken Token which gets withdrawn
                       * @param logRLPList Valid sidechain log for data like amount, token id etc.
                       */
                      function exitTokens(
                          address sender,
                          address rootToken,
                          bytes calldata logRLPList
                      ) external;
                  }
                  
                  // File: contracts/common/Initializable.sol
                  
                  pragma solidity 0.6.6;
                  
                  contract Initializable {
                      bool inited = false;
                  
                      modifier initializer() {
                          require(!inited, "already inited");
                          _;
                          inited = true;
                      }
                  }
                  
                  // File: contracts/root/TokenPredicates/MintableERC721Predicate.sol
                  
                  pragma solidity 0.6.6;
                  
                  
                  
                  
                  
                  
                  
                  contract MintableERC721Predicate is ITokenPredicate, AccessControlMixin, Initializable, IERC721Receiver {
                      using RLPReader for bytes;
                      using RLPReader for RLPReader.RLPItem;
                  
                      // keccak256("MANAGER_ROLE")
                      bytes32 public constant MANAGER_ROLE = 0x241ecf16d79d0f8dbfb92cbc07fe17840425976cf0667f022fe9877caa831b08;
                      // keccak256("MintableERC721")
                      bytes32 public constant TOKEN_TYPE = 0xd4392723c111fcb98b073fe55873efb447bcd23cd3e49ec9ea2581930cd01ddc;
                      // keccak256("Transfer(address,address,uint256)")
                      bytes32 public constant TRANSFER_EVENT_SIG = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef;
                      // keccak256("WithdrawnBatch(address,uint256[])")
                      bytes32 public constant WITHDRAW_BATCH_EVENT_SIG = 0xf871896b17e9cb7a64941c62c188a4f5c621b86800e3d15452ece01ce56073df;
                      // keccak256("TransferWithMetadata(address,address,uint256,bytes)")
                      bytes32 public constant TRANSFER_WITH_METADATA_EVENT_SIG = 0xf94915c6d1fd521cee85359239227480c7e8776d7caf1fc3bacad5c269b66a14;
                  
                      // limit batching of tokens due to gas limit restrictions
                      uint256 public constant BATCH_LIMIT = 20;
                  
                      event LockedMintableERC721(
                          address indexed depositor,
                          address indexed depositReceiver,
                          address indexed rootToken,
                          uint256 tokenId
                      );
                  
                      event LockedMintableERC721Batch(
                          address indexed depositor,
                          address indexed depositReceiver,
                          address indexed rootToken,
                          uint256[] tokenIds
                      );
                  
                      constructor() public {}
                  
                      function initialize(address _owner) external initializer {
                          _setupContractId("MintableERC721Predicate");
                          _setupRole(DEFAULT_ADMIN_ROLE, _owner);
                          _setupRole(MANAGER_ROLE, _owner);
                      }
                  
                      /**
                       * @notice accepts safe ERC721 transfer
                       */
                      function onERC721Received(
                          address,
                          address,
                          uint256,
                          bytes calldata
                      )
                          external
                          override
                          returns (bytes4)
                      {
                          return IERC721Receiver.onERC721Received.selector;
                      }
                  
                      /**
                       * @notice Lock ERC721 token(s) for deposit, callable only by manager
                       * @param depositor Address who wants to deposit token
                       * @param depositReceiver Address (address) who wants to receive token on child chain
                       * @param rootToken Token which gets deposited
                       * @param depositData ABI encoded tokenId(s). It's possible to deposit batch of tokens.
                       */
                      function lockTokens(
                          address depositor,
                          address depositReceiver,
                          address rootToken,
                          bytes calldata depositData
                      )
                          external
                          override
                          only(MANAGER_ROLE)
                      {
                  
                          // Locking single ERC721 token
                          if (depositData.length == 32) {
                  
                              uint256 tokenId = abi.decode(depositData, (uint256));
                  
                              // Emitting event that single token is getting locked in predicate
                              emit LockedMintableERC721(depositor, depositReceiver, rootToken, tokenId);
                  
                              // Transferring token to this address, which will be
                              // released when attempted to be unlocked
                              IMintableERC721(rootToken).safeTransferFrom(depositor, address(this), tokenId);
                  
                          } else {
                              // Locking a set a ERC721 token(s)
                  
                              uint256[] memory tokenIds = abi.decode(depositData, (uint256[]));
                  
                              // Emitting event that a set of ERC721 tokens are getting lockec
                              // in this predicate contract
                              emit LockedMintableERC721Batch(depositor, depositReceiver, rootToken, tokenIds);
                  
                              // These many tokens are attempted to be deposited
                              // by user
                              uint256 length = tokenIds.length;
                              require(length <= BATCH_LIMIT, "MintableERC721Predicate: EXCEEDS_BATCH_LIMIT");
                  
                              // Iteratively trying to transfer ERC721 token
                              // to this predicate address
                              for (uint256 i; i < length; i++) {
                  
                                  IMintableERC721(rootToken).safeTransferFrom(depositor, address(this), tokenIds[i]);
                  
                              }
                  
                          }
                  
                      }
                  
                      /**
                       * @notice Validates log signature, from and to address
                       * then checks if token already exists on root chain
                       * if token exits then transfers it to withdrawer
                       * if token doesn't exit then it is minted
                       * callable only by manager
                       * @param rootToken Token which gets withdrawn
                       * @param log Valid ERC721 burn log from child chain
                       */
                      function exitTokens(
                          address,
                          address rootToken,
                          bytes memory log
                      )
                          public
                          override
                          only(MANAGER_ROLE)
                      {
                          RLPReader.RLPItem[] memory logRLPList = log.toRlpItem().toList();
                          RLPReader.RLPItem[] memory logTopicRLPList = logRLPList[1].toList(); // topics
                  
                          // If it's a simple exit ( with out metadata coming from L2 to L1 )
                          if(bytes32(logTopicRLPList[0].toUint()) == TRANSFER_EVENT_SIG) {
                  
                              address withdrawer = address(logTopicRLPList[1].toUint()); // topic1 is from address
                  
                              require(
                                  address(logTopicRLPList[2].toUint()) == address(0), // topic2 is to address
                                  "MintableERC721Predicate: INVALID_RECEIVER"
                              );
                  
                              IMintableERC721 token = IMintableERC721(rootToken);
                  
                              uint256 tokenId = logTopicRLPList[3].toUint(); // topic3 is tokenId field
                              if (token.exists(tokenId)) {
                                  token.safeTransferFrom(
                                      address(this),
                                      withdrawer,
                                      tokenId
                                  );
                              } else {
                                  token.mint(withdrawer, tokenId);
                              }
                  
                          } else if (bytes32(logTopicRLPList[0].toUint()) == WITHDRAW_BATCH_EVENT_SIG) { // topic0 is event sig
                              // If it's a simple batch exit, where a set of
                              // ERC721s were burnt in child chain with event signature
                              // looking like `WithdrawnBatch(address indexed user, uint256[] tokenIds);`
                              //
                              // @note This doesn't allow transfer of metadata cross chain
                              // For that check below `else if` block
                  
                              address withdrawer = address(logTopicRLPList[1].toUint()); // topic1 is from address
                  
                              // RLP encoded tokenId list
                              bytes memory logData = logRLPList[2].toBytes();
                  
                              (uint256[] memory tokenIds) = abi.decode(logData, (uint256[]));
                              uint256 length = tokenIds.length;
                  
                              IMintableERC721 token = IMintableERC721(rootToken);
                  
                              for (uint256 i; i < length; i++) {
                  
                                  uint256 tokenId = tokenIds[i];
                  
                                  // Check if token exists or not
                                  //
                                  // If does, transfer token to withdrawer
                                  if (token.exists(tokenId)) {
                                      token.safeTransferFrom(
                                          address(this),
                                          withdrawer,
                                          tokenId
                                      );
                                  } else {
                                      // If token was minted on L2
                                      // we'll mint it here, on L1, during
                                      // exiting from L2
                                      token.mint(withdrawer, tokenId);
                                  }
                  
                              }
                  
                          } else if (bytes32(logTopicRLPList[0].toUint()) == TRANSFER_WITH_METADATA_EVENT_SIG) { 
                              // If this is NFT exit with metadata i.e. URI ?
                              //
                              // Note: If your token is only minted in L2, you can exit
                              // it with metadata. But if it was minted on L1, it'll be
                              // simply transferred to withdrawer address. And in that case,
                              // it's lot better to exit with `Transfer(address,address,uint256)`
                              // i.e. calling `withdraw` method on L2 contract
                              // event signature proof, which is defined under first `if` clause
                              //
                              // If you've called `withdrawWithMetadata`, you should submit
                              // proof of event signature `TransferWithMetadata(address,address,uint256,bytes)`
                  
                              address withdrawer = address(logTopicRLPList[1].toUint()); // topic1 is from address
                  
                              require(
                                  address(logTopicRLPList[2].toUint()) == address(0), // topic2 is to address
                                  "MintableERC721Predicate: INVALID_RECEIVER"
                              );
                  
                              IMintableERC721 token = IMintableERC721(rootToken);
                  
                              uint256 tokenId = logTopicRLPList[3].toUint(); // topic3 is tokenId field
                              if (token.exists(tokenId)) {
                                  token.safeTransferFrom(
                                      address(this),
                                      withdrawer,
                                      tokenId
                                  );
                              } else {
                                  // Minting with metadata received from L2 i.e. emitted
                                  // by event `TransferWithMetadata` during burning
                                  bytes memory logData = logRLPList[2].toBytes();
                                  bytes memory metaData = abi.decode(logData, (bytes));
                                  
                                  token.mint(withdrawer, tokenId, metaData);
                              }
                  
                          } else {
                              // Attempting to exit with some event signature from L2, which is
                              // not ( yet ) supported by L1 exit manager
                              revert("MintableERC721Predicate: INVALID_SIGNATURE");
                          }
                          
                      }
                  }