ETH Price: $2,271.13 (-6.40%)

Transaction Decoder

Block:
12353674 at May-02-2021 08:21:41 AM +UTC
Transaction Fee:
0.0050133468 ETH $11.39
Gas Used:
217,028 Gas / 23.1 Gwei

Emitted Events:

266 0xaeb960ed44c8a4ce848c50ef451f472a503456b2.0xd03c77ba06fdea91615ddd289bcef4a278bcbf729ba06c5d12b6fd9d5a0998d2( 0xd03c77ba06fdea91615ddd289bcef4a278bcbf729ba06c5d12b6fd9d5a0998d2, 0x0000000000000000000000009fc5107b38c62d896c986566b21ae53fb3180db3, 0x0000000000000000000000000000000000000000000000000000000000000000, 00000000000000000000000000000000000000000000000000cc15203449a674 )
267 0xaeb960ed44c8a4ce848c50ef451f472a503456b2.0xd03c77ba06fdea91615ddd289bcef4a278bcbf729ba06c5d12b6fd9d5a0998d2( 0xd03c77ba06fdea91615ddd289bcef4a278bcbf729ba06c5d12b6fd9d5a0998d2, 0x00000000000000000000000067d6bf82d79eaefd58fead56aeef682e93985b98, 0x0000000000000000000000000000000000000000000000000000000000000000, 00000000000000000000000000000000000000000000000000d2e6567c97e127 )
268 SorareTokens.Approval( owner=0x67d6bf82...e93985b98, approved=0x00000000...000000000, tokenId=98027806136079037760950821598718145981849199429304515655942085186890014869526 )
269 SorareTokens.Transfer( from=0x67d6bf82...e93985b98, to=0x9fC5107B...Fb3180dB3, tokenId=98027806136079037760950821598718145981849199429304515655942085186890014869526 )
270 0xaeb960ed44c8a4ce848c50ef451f472a503456b2.0x43eb744b69e2ba057b09224246fa56336142aad9761bcd000ffd900a59431795( 0x43eb744b69e2ba057b09224246fa56336142aad9761bcd000ffd900a59431795, 0x0000000000000000000000000000000008dfb6f7d48a1355b71af1c588a53c65, 00000000000000000000000000000000000000000000000000000000000000a0, 00000000000000000000000067d6bf82d79eaefd58fead56aeef682e93985b98, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000009fc5107b38c62d896c986566b21ae53fb3180db3, 0000000000000000000000000000000008dfb6f7d48a1355b71af1c588a53c65, 0000000000000000000000009fc5107b38c62d896c986566b21ae53fb3180db3, 00000000000000000000000067d6bf82d79eaefd58fead56aeef682e93985b98, 000000000000000000000000000000000000000000000000005fec5b60ef8000, 0000000000000000000000000000000000000000000000000000000000000000, 00000000000000000000000000000000000000000000000000000000000000e0, 0000000000000000000000000000000000000000000000000000000000000100, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000001, d8b9c5a69558ba84d9b1605d6e44891df0a33963c65b2b228cf56c9e9f334816 )

Account State Difference:

  Address   Before After State Difference Code
0x1273B354...6E8e8654c
9.744649756356248774 Eth
Nonce: 76868
9.739636409556248774 Eth
Nonce: 76869
0.0050133468
0x629A673A...ac21A6205
0xAEb960eD...a503456b2
(Sorare: Exchange)
(Ethermine)
366.275791147455055027 Eth366.280804494255055027 Eth0.0050133468

Execution Trace

Sorare: Exchange.223da1ba( )
  • SorareTokens.ownerOf( tokenId=98027806136079037760950821598718145981849199429304515655942085186890014869526 ) => ( 0x67d6bf82d79EAeFD58FeAD56AeEf682e93985b98 )
  • 0xdb404188f3428f80fcac37a2ee7a3391f5d28c48.9a5f14b2( )
    • Null: 0x000...001.8330dd51( )
    • 0xdb404188f3428f80fcac37a2ee7a3391f5d28c48.9a5f14b2( )
      • Null: 0x000...001.60ec0483( )
      • 0xe2fd97cdd6182c1223ff8bc6344abaf7132b51d5.40125765( )
        • SorareTokens.safeTransferFrom( from=0x67d6bf82d79EAeFD58FeAD56AeEf682e93985b98, to=0x9fC5107B38C62d896c986566b21Ae53Fb3180dB3, tokenId=98027806136079037760950821598718145981849199429304515655942085186890014869526 )
          pragma solidity 0.6.6;
          
          
          contract Context {
              // Empty internal constructor, to prevent people from mistakenly deploying
              // an instance of this contract, which should be used via inheritance.
              constructor () internal { }
          
              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;
              }
          }
          
          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);
          }
          
          interface 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) external view returns (uint256 balance);
          
              /**
               * @dev Returns the owner of the NFT specified by `tokenId`.
               */
              function ownerOf(uint256 tokenId) external 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 {setApprovalForAll}.
               */
              function safeTransferFrom(address from, address to, uint256 tokenId) external;
              /**
               * @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 {setApprovalForAll}.
               */
              function transferFrom(address from, address to, uint256 tokenId) external;
              function approve(address to, uint256 tokenId) external;
              function getApproved(uint256 tokenId) external view returns (address operator);
          
              function setApprovalForAll(address operator, bool _approved) external;
              function isApprovedForAll(address owner, address operator) external view returns (bool);
          
          
              function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
          }
          
          interface 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);
          }
          
          interface IERC721Enumerable is IERC721 {
              function totalSupply() external view returns (uint256);
              function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256 tokenId);
          
              function tokenByIndex(uint256 index) external view returns (uint256);
          }
          
          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) public view override 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 virtual {
                  require(interfaceId != 0xffffffff, "ERC165: invalid interface id");
                  _supportedInterfaces[interfaceId] = true;
              }
          }
          
          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) {
                  // Solidity only automatically asserts when dividing by 0
                  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;
              }
          }
          
          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));
              }
          }
          
          library EnumerableMap {
              // To implement this library for multiple types with as little code
              // repetition as possible, we write it in terms of a generic Map type with
              // bytes32 keys and values.
              // The Map implementation uses private functions, and user-facing
              // implementations (such as Uint256ToAddressMap) are just wrappers around
              // the underlying Map.
              // This means that we can only create new EnumerableMaps for types that fit
              // in bytes32.
          
              struct MapEntry {
                  bytes32 _key;
                  bytes32 _value;
              }
          
              struct Map {
                  // Storage of map keys and values
                  MapEntry[] _entries;
          
                  // Position of the entry defined by a key in the `entries` array, plus 1
                  // because index 0 means a key is not in the map.
                  mapping (bytes32 => uint256) _indexes;
              }
          
              /**
               * @dev Adds a key-value pair to a map, or updates the value for an existing
               * key. O(1).
               *
               * Returns true if the key was added to the map, that is if it was not
               * already present.
               */
              function _set(Map storage map, bytes32 key, bytes32 value) private returns (bool) {
                  // We read and store the key's index to prevent multiple reads from the same storage slot
                  uint256 keyIndex = map._indexes[key];
          
                  if (keyIndex == 0) { // Equivalent to !contains(map, key)
                      map._entries.push(MapEntry({ _key: key, _value: value }));
                      // The entry is stored at length-1, but we add 1 to all indexes
                      // and use 0 as a sentinel value
                      map._indexes[key] = map._entries.length;
                      return true;
                  } else {
                      map._entries[keyIndex - 1]._value = value;
                      return false;
                  }
              }
          
              /**
               * @dev Removes a key-value pair from a map. O(1).
               *
               * Returns true if the key was removed from the map, that is if it was present.
               */
              function _remove(Map storage map, bytes32 key) private returns (bool) {
                  // We read and store the key's index to prevent multiple reads from the same storage slot
                  uint256 keyIndex = map._indexes[key];
          
                  if (keyIndex != 0) { // Equivalent to contains(map, key)
                      // To delete a key-value pair from the _entries array in O(1), we swap the entry to delete with the last one
                      // in the array, and then remove the last entry (sometimes called as 'swap and pop').
                      // This modifies the order of the array, as noted in {at}.
          
                      uint256 toDeleteIndex = keyIndex - 1;
                      uint256 lastIndex = map._entries.length - 1;
          
                      // When the entry 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.
          
                      MapEntry storage lastEntry = map._entries[lastIndex];
          
                      // Move the last entry to the index where the entry to delete is
                      map._entries[toDeleteIndex] = lastEntry;
                      // Update the index for the moved entry
                      map._indexes[lastEntry._key] = toDeleteIndex + 1; // All indexes are 1-based
          
                      // Delete the slot where the moved entry was stored
                      map._entries.pop();
          
                      // Delete the index for the deleted slot
                      delete map._indexes[key];
          
                      return true;
                  } else {
                      return false;
                  }
              }
          
              /**
               * @dev Returns true if the key is in the map. O(1).
               */
              function _contains(Map storage map, bytes32 key) private view returns (bool) {
                  return map._indexes[key] != 0;
              }
          
              /**
               * @dev Returns the number of key-value pairs in the map. O(1).
               */
              function _length(Map storage map) private view returns (uint256) {
                  return map._entries.length;
              }
          
             /**
              * @dev Returns the key-value pair stored at position `index` in the map. O(1).
              *
              * Note that there are no guarantees on the ordering of entries inside the
              * array, and it may change when more entries are added or removed.
              *
              * Requirements:
              *
              * - `index` must be strictly less than {length}.
              */
              function _at(Map storage map, uint256 index) private view returns (bytes32, bytes32) {
                  require(map._entries.length > index, "EnumerableMap: index out of bounds");
          
                  MapEntry storage entry = map._entries[index];
                  return (entry._key, entry._value);
              }
          
              /**
               * @dev Returns the value associated with `key`.  O(1).
               *
               * Requirements:
               *
               * - `key` must be in the map.
               */
              function _get(Map storage map, bytes32 key) private view returns (bytes32) {
                  return _get(map, key, "EnumerableMap: nonexistent key");
              }
          
              /**
               * @dev Same as {_get}, with a custom error message when `key` is not in the map.
               */
              function _get(Map storage map, bytes32 key, string memory errorMessage) private view returns (bytes32) {
                  uint256 keyIndex = map._indexes[key];
                  require(keyIndex != 0, errorMessage); // Equivalent to contains(map, key)
                  return map._entries[keyIndex - 1]._value; // All indexes are 1-based
              }
          
              // UintToAddressMap
          
              struct UintToAddressMap {
                  Map _inner;
              }
          
              /**
               * @dev Adds a key-value pair to a map, or updates the value for an existing
               * key. O(1).
               *
               * Returns true if the key was added to the map, that is if it was not
               * already present.
               */
              function set(UintToAddressMap storage map, uint256 key, address value) internal returns (bool) {
                  return _set(map._inner, bytes32(key), bytes32(uint256(value)));
              }
          
              /**
               * @dev Removes a value from a set. O(1).
               *
               * Returns true if the key was removed from the map, that is if it was present.
               */
              function remove(UintToAddressMap storage map, uint256 key) internal returns (bool) {
                  return _remove(map._inner, bytes32(key));
              }
          
              /**
               * @dev Returns true if the key is in the map. O(1).
               */
              function contains(UintToAddressMap storage map, uint256 key) internal view returns (bool) {
                  return _contains(map._inner, bytes32(key));
              }
          
              /**
               * @dev Returns the number of elements in the map. O(1).
               */
              function length(UintToAddressMap storage map) internal view returns (uint256) {
                  return _length(map._inner);
              }
          
             /**
              * @dev Returns the element 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(UintToAddressMap storage map, uint256 index) internal view returns (uint256, address) {
                  (bytes32 key, bytes32 value) = _at(map._inner, index);
                  return (uint256(key), address(uint256(value)));
              }
          
              /**
               * @dev Returns the value associated with `key`.  O(1).
               *
               * Requirements:
               *
               * - `key` must be in the map.
               */
              function get(UintToAddressMap storage map, uint256 key) internal view returns (address) {
                  return address(uint256(_get(map._inner, bytes32(key))));
              }
          
              /**
               * @dev Same as {get}, with a custom error message when `key` is not in the map.
               */
              function get(UintToAddressMap storage map, uint256 key, string memory errorMessage) internal view returns (address) {
                  return address(uint256(_get(map._inner, bytes32(key), errorMessage)));
              }
          }
          
          library Strings {
              /**
               * @dev Converts a `uint256` to its ASCII `string` 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);
                  uint256 index = digits - 1;
                  temp = value;
                  while (temp != 0) {
                      buffer[index--] = byte(uint8(48 + temp % 10));
                      temp /= 10;
                  }
                  return string(buffer);
              }
          }
          
          /**
           * @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 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, _msgSender()));
           *     ...
           * }
           * ```
           *
           * 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}.
           */
          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 `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.
               */
              function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
                  _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());
                  }
              }
          }
          
          /**
           * @title ERC721 token receiver interface
           * @dev Interface for any contract that wants to support safeTransfers
           * from ERC721 asset contracts.
           */
          abstract contract IERC721Receiver {
              /**
               * @notice Handle the receipt of an NFT
               * @dev The ERC721 smart contract calls this function on the recipient
               * after a {IERC721-safeTransferFrom}. 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 virtual returns (bytes4);
          }
          
          contract ERC721 is Context, ERC165, IERC721, IERC721Metadata, IERC721Enumerable {
              using SafeMath for uint256;
              using Address for address;
              using EnumerableSet for EnumerableSet.UintSet;
              using EnumerableMap for EnumerableMap.UintToAddressMap;
              using Strings for uint256;
          
              // 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 holder address to their (enumerable) set of owned tokens
              mapping (address => EnumerableSet.UintSet) private _holderTokens;
          
              // Enumerable mapping from token ids to their owners
              EnumerableMap.UintToAddressMap private _tokenOwners;
          
              // 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;
          
              // Token name
              string private _name;
          
              // Token symbol
              string private _symbol;
          
              // Optional mapping for token URIs
              mapping(uint256 => string) private _tokenURIs;
          
              // Base URI
              string private _baseURI;
          
              /*
               *     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)')) == 0xe985e9c5
               *     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;
          
              /*
               *     bytes4(keccak256('name()')) == 0x06fdde03
               *     bytes4(keccak256('symbol()')) == 0x95d89b41
               *     bytes4(keccak256('tokenURI(uint256)')) == 0xc87b56dd
               *
               *     => 0x06fdde03 ^ 0x95d89b41 ^ 0xc87b56dd == 0x5b5e139f
               */
              bytes4 private constant _INTERFACE_ID_ERC721_METADATA = 0x5b5e139f;
          
              /*
               *     bytes4(keccak256('totalSupply()')) == 0x18160ddd
               *     bytes4(keccak256('tokenOfOwnerByIndex(address,uint256)')) == 0x2f745c59
               *     bytes4(keccak256('tokenByIndex(uint256)')) == 0x4f6ccce7
               *
               *     => 0x18160ddd ^ 0x2f745c59 ^ 0x4f6ccce7 == 0x780e9d63
               */
              bytes4 private constant _INTERFACE_ID_ERC721_ENUMERABLE = 0x780e9d63;
          
              constructor (string memory name, string memory symbol) public {
                  _name = name;
                  _symbol = symbol;
          
                  // register the supported interfaces to conform to ERC721 via ERC165
                  _registerInterface(_INTERFACE_ID_ERC721);
                  _registerInterface(_INTERFACE_ID_ERC721_METADATA);
                  _registerInterface(_INTERFACE_ID_ERC721_ENUMERABLE);
              }
          
              /**
               * @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 override returns (uint256) {
                  require(owner != address(0), "ERC721: balance query for the zero address");
          
                  return _holderTokens[owner].length();
              }
          
              /**
               * @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 override returns (address) {
                  return _tokenOwners.get(tokenId, "ERC721: owner query for nonexistent token");
              }
          
              /**
               * @dev Gets the token name.
               * @return string representing the token name
               */
              function name() public view override returns (string memory) {
                  return _name;
              }
          
              /**
               * @dev Gets the token symbol.
               * @return string representing the token symbol
               */
              function symbol() public view override returns (string memory) {
                  return _symbol;
              }
          
              /**
               * @dev Returns the URI for a given token ID. May return an empty string.
               *
               * If a base URI is set (via {_setBaseURI}), it is added as a prefix to the
               * token's own URI (via {_setTokenURI}).
               *
               * If there is a base URI but no token URI, the token's ID will be used as
               * its URI when appending it to the base URI. This pattern for autogenerated
               * token URIs can lead to large gas savings.
               *
               * .Examples
               * |===
               * |`_setBaseURI()` |`_setTokenURI()` |`tokenURI()`
               * | ""
               * | ""
               * | ""
               * | ""
               * | "token.uri/123"
               * | "token.uri/123"
               * | "token.uri/"
               * | "123"
               * | "token.uri/123"
               * | "token.uri/"
               * | ""
               * | "token.uri/<tokenId>"
               * |===
               *
               * Requirements:
               *
               * - `tokenId` must exist.
               */
              function tokenURI(uint256 tokenId) public view override returns (string memory) {
                  require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
          
                  string memory _tokenURI = _tokenURIs[tokenId];
          
                  // If there is no base URI, return the token URI.
                  if (bytes(_baseURI).length == 0) {
                      return _tokenURI;
                  }
                  // If both are set, concatenate the baseURI and tokenURI (via abi.encodePacked).
                  if (bytes(_tokenURI).length > 0) {
                      return string(abi.encodePacked(_baseURI, _tokenURI));
                  }
                  // If there is a baseURI but no tokenURI, concatenate the tokenID to the baseURI.
                  return string(abi.encodePacked(_baseURI, tokenId.toString()));
              }
          
              /**
              * @dev Returns the base URI set via {_setBaseURI}. This will be
              * automatically added as a prefix in {tokenURI} to each token's URI, or
              * to the token ID if no specific URI is set for that token ID.
              */
              function baseURI() public view returns (string memory) {
                  return _baseURI;
              }
          
              /**
               * @dev Gets the token ID at a given index of the tokens list of the requested owner.
               * @param owner address owning the tokens list to be accessed
               * @param index uint256 representing the index to be accessed of the requested tokens list
               * @return uint256 token ID at the given index of the tokens list owned by the requested address
               */
              function tokenOfOwnerByIndex(address owner, uint256 index) public view override returns (uint256) {
                  return _holderTokens[owner].at(index);
              }
          
              /**
               * @dev Gets the total amount of tokens stored by the contract.
               * @return uint256 representing the total amount of tokens
               */
              function totalSupply() public view override returns (uint256) {
                  // _tokenOwners are indexed by tokenIds, so .length() returns the number of tokenIds
                  return _tokenOwners.length();
              }
          
              /**
               * @dev Gets the token ID at a given index of all the tokens in this contract
               * Reverts if the index is greater or equal to the total number of tokens.
               * @param index uint256 representing the index to be accessed of the tokens list
               * @return uint256 token ID at the given index of the tokens list
               */
              function tokenByIndex(uint256 index) public view override returns (uint256) {
                  (uint256 tokenId, ) = _tokenOwners.at(index);
                  return tokenId;
              }
          
              /**
               * @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 virtual override {
                  address owner = ownerOf(tokenId);
                  require(to != owner, "ERC721: approval to current owner");
          
                  require(_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                      "ERC721: approve caller is not owner nor approved for all"
                  );
          
                  _approve(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 override 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 operator operator address to set the approval
               * @param approved representing the status of the approval to be set
               */
              function setApprovalForAll(address operator, bool approved) public virtual override {
                  require(operator != _msgSender(), "ERC721: approve to caller");
          
                  _operatorApprovals[_msgSender()][operator] = approved;
                  emit ApprovalForAll(_msgSender(), operator, 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 override 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 virtual override {
                  //solhint-disable-next-line max-line-length
                  require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
          
                  _transfer(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 {IERC721Receiver-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 virtual override {
                  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 {IERC721Receiver-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 _msgSender() 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 virtual override {
                  require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                  _safeTransfer(from, to, tokenId, _data);
              }
          
              /**
               * @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 _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 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) {
                  return _tokenOwners.contains(tokenId);
              }
          
              /**
               * @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 safely mint a new token.
               * Reverts if the given token ID already exists.
               * 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.
               * @param to The address that will own the minted token
               * @param tokenId uint256 ID of the token to be minted
               */
              function _safeMint(address to, uint256 tokenId) internal virtual {
                  _safeMint(to, tokenId, "");
              }
          
              /**
               * @dev Internal function to safely mint a new token.
               * Reverts if the given token ID already exists.
               * 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.
               * @param to The address that will own the minted token
               * @param tokenId uint256 ID of the token to be minted
               * @param _data bytes data to send along with a safe transfer check
               */
              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 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 virtual {
                  require(to != address(0), "ERC721: mint to the zero address");
                  require(!_exists(tokenId), "ERC721: token already minted");
          
                  _beforeTokenTransfer(address(0), to, tokenId);
          
                  _holderTokens[to].add(tokenId);
          
                  _tokenOwners.set(tokenId, to);
          
                  emit Transfer(address(0), to, 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 virtual {
                  address owner = ownerOf(tokenId);
          
                  _beforeTokenTransfer(owner, address(0), tokenId);
          
                  // Clear approvals
                  _approve(address(0), tokenId);
          
                  // Clear metadata (if any)
                  if (bytes(_tokenURIs[tokenId]).length != 0) {
                      delete _tokenURIs[tokenId];
                  }
          
                  _holderTokens[owner].remove(tokenId);
          
                  _tokenOwners.remove(tokenId);
          
                  emit Transfer(owner, address(0), 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 _transfer(address from, address to, uint256 tokenId) internal virtual {
                  require(ownerOf(tokenId) == from, "ERC721: transfer of token that is not own");
                  require(to != address(0), "ERC721: transfer to the zero address");
          
                  _beforeTokenTransfer(from, to, tokenId);
          
                  // Clear approvals from the previous owner
                  _approve(address(0), tokenId);
          
                  _holderTokens[from].remove(tokenId);
                  _holderTokens[to].add(tokenId);
          
                  _tokenOwners.set(tokenId, to);
          
                  emit Transfer(from, to, tokenId);
              }
          
              /**
               * @dev Internal function to set the token URI for a given token.
               *
               * Reverts if the token ID does not exist.
               *
               * TIP: If all token IDs share a prefix (for example, if your URIs look like
               * `https://api.myproject.com/token/<id>`), use {_setBaseURI} to store
               * it and save gas.
               */
              function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {
                  require(_exists(tokenId), "ERC721Metadata: URI set of nonexistent token");
                  _tokenURIs[tokenId] = _tokenURI;
              }
          
              /**
               * @dev Internal function to set the base URI for all token IDs. It is
               * automatically added as a prefix to the value returned in {tokenURI},
               * or to the token ID if {tokenURI} is empty.
               */
              function _setBaseURI(string memory baseURI_) internal virtual {
                  _baseURI = baseURI_;
              }
          
              /**
               * @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()) {
                      return true;
                  }
                  // solhint-disable-next-line avoid-low-level-calls
                  (bool success, bytes memory returndata) = to.call(abi.encodeWithSelector(
                      IERC721Receiver(to).onERC721Received.selector,
                      _msgSender(),
                      from,
                      tokenId,
                      _data
                  ));
                  if (!success) {
                      if (returndata.length > 0) {
                          // solhint-disable-next-line no-inline-assembly
                          assembly {
                              let returndata_size := mload(returndata)
                              revert(add(32, returndata), returndata_size)
                          }
                      } else {
                          revert("ERC721: transfer to non ERC721Receiver implementer");
                      }
                  } else {
                      bytes4 retval = abi.decode(returndata, (bytes4));
                      return (retval == _ERC721_RECEIVED);
                  }
              }
          
              function _approve(address to, uint256 tokenId) private {
                  _tokenApprovals[tokenId] = to;
                  emit Approval(ownerOf(tokenId), to, tokenId);
              }
          
              /**
               * @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 { }
          }
          
          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 () internal {
                  address msgSender = _msgSender();
                  _owner = msgSender;
                  emit OwnershipTransferred(address(0), msgSender);
              }
          
              /**
               * @dev Returns the address of the current owner.
               */
              function owner() public view 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;
              }
          }
          
          contract MinterAccess is Ownable, AccessControl {
              bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");
          
              modifier onlyMinter {
                  require(hasRole(MINTER_ROLE, _msgSender()), "Sender is not a minter");
                  _;
              }
          
              constructor() public {
                  _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);
                  _setupRole(MINTER_ROLE, msg.sender);
              }
          
              function addMinter(address account) external {
                  grantRole(MINTER_ROLE, account);
              }
          
              function renounceMinter(address account) external {
                  renounceRole(MINTER_ROLE, account);
              }
          
              function revokeMinter(address account) external {
                  revokeRole(MINTER_ROLE, account);
              }
          }
          
          interface ISorareCards {
              function createCard(
                  uint256 playerId,
                  uint16 season,
                  uint8 scarcity,
                  uint16 serialNumber,
                  bytes32 metadata,
                  uint16 clubId
              ) external returns (uint256);
          
              function getCard(uint256 _cardId)
                  external
                  view
                  returns (
                      uint256 playerId,
                      uint16 season,
                      uint256 scarcity,
                      uint16 serialNumber,
                      bytes memory metadata,
                      uint16 clubId
                  );
          
              function getPlayer(uint256 playerId)
                  external
                  view
                  returns (
                      string memory name,
                      uint16 yearOfBirth,
                      uint8 monthOfBirth,
                      uint8 dayOfBirth
                  );
          
              function getClub(uint16 clubId)
                  external
                  view
                  returns (
                      string memory name,
                      string memory country,
                      string memory city,
                      uint16 yearFounded
                  );
          
              function cardExists(uint256 cardId) external view returns (bool);
          }
          
          contract RelayRecipient is Ownable {
              address private _relayAddress;
          
              constructor(address relayAddress) public {
                  require(relayAddress != address(0), "Custom relay address is required");
                  _relayAddress = relayAddress;
              }
          
              function blockRelay() public onlyOwner {
                  _relayAddress = address(this);
              }
          
              function getRelayAddress() public view returns (address) {
                  return _relayAddress;
              }
          
              /**
               * @dev Replacement for msg.sender. Returns the actual sender of a transaction: msg.sender for regular transactions,
               * and the end-user for relayed calls (where msg.sender is actually `Relay` contract).
               *
               * IMPORTANT: Contracts derived from {GSNRecipient} should never use `msg.sender`, and use {_msgSender} instead.
               */
              // prettier-ignore
              function _msgSender() internal override virtual view returns (address payable) {
                  if (msg.sender != _relayAddress) {
                      return msg.sender;
                  } else {
                      return _getRelayedCallSender();
                  }
              }
          
              /**
               * @dev Replacement for msg.data. Returns the actual calldata of a transaction: msg.data for regular transactions,
               * and a reduced version for relayed calls (where msg.data contains additional information).
               *
               * IMPORTANT: Contracts derived from {GSNRecipient} should never use `msg.data`, and use {_msgData} instead.
               */
              // prettier-ignore
              function _msgData() internal override virtual view returns (bytes memory) {
                  if (msg.sender != _relayAddress) {
                      return msg.data;
                  } else {
                      return _getRelayedCallData();
                  }
              }
          
              function _getRelayedCallSender()
                  private
                  pure
                  returns (address payable result)
              {
                  // We need to read 20 bytes (an address) located at array index msg.data.length - 20. In memory, the array
                  // is prefixed with a 32-byte length value, so we first add 32 to get the memory read index. However, doing
                  // so would leave the address in the upper 20 bytes of the 32-byte word, which is inconvenient and would
                  // require bit shifting. We therefore subtract 12 from the read index so the address lands on the lower 20
                  // bytes. This can always be done due to the 32-byte prefix.
          
                  // The final memory read index is msg.data.length - 20 + 32 - 12 = msg.data.length. Using inline assembly is the
                  // easiest/most-efficient way to perform this operation.
          
                  // These fields are not accessible from assembly
                  bytes memory array = msg.data;
                  uint256 index = msg.data.length;
          
                  // solhint-disable-next-line no-inline-assembly
                  assembly {
                      // Load the 32 bytes word from memory with the address on the lower 20 bytes, and mask those.
                      result := and(
                          mload(add(array, index)),
                          0xffffffffffffffffffffffffffffffffffffffff
                      )
                  }
                  return result;
              }
          
              function _getRelayedCallData() private pure returns (bytes memory) {
                  // RelayHub appends the sender address at the end of the calldata, so in order to retrieve the actual msg.data,
                  // we must strip the last 20 bytes (length of an address type) from it.
          
                  uint256 actualDataLength = msg.data.length - 20;
                  bytes memory actualData = new bytes(actualDataLength);
          
                  for (uint256 i = 0; i < actualDataLength; ++i) {
                      actualData[i] = msg.data[i];
                  }
          
                  return actualData;
              }
          }
          
          library NFTClient {
              bytes4 public constant interfaceIdERC721 = 0x80ac58cd;
          
              function requireERC721(address _candidate) public view {
                  require(
                      IERC721Enumerable(_candidate).supportsInterface(interfaceIdERC721),
                      "IS_NOT_721_TOKEN"
                  );
              }
          
              function transferTokens(
                  IERC721Enumerable _nftContract,
                  address _from,
                  address _to,
                  uint256[] memory _tokenIds
              ) public {
                  for (uint256 index = 0; index < _tokenIds.length; index++) {
                      if (_tokenIds[index] == 0) {
                          break;
                      }
          
                      _nftContract.safeTransferFrom(_from, _to, _tokenIds[index]);
                  }
              }
          
              function transferAll(
                  IERC721Enumerable _nftContract,
                  address _sender,
                  address _receiver
              ) public {
                  uint256 balance = _nftContract.balanceOf(_sender);
                  while (balance > 0) {
                      _nftContract.safeTransferFrom(
                          _sender,
                          _receiver,
                          _nftContract.tokenOfOwnerByIndex(_sender, balance - 1)
                      );
                      balance--;
                  }
              }
          
              // /// @dev Pagination of owner tokens
              // /// @param owner - address of the token owner
              // /// @param page - page number
              // /// @param rows - number of rows per page
              function tokensOfOwner(
                  address _nftContract,
                  address owner,
                  uint8 page,
                  uint8 rows
              ) public view returns (uint256[] memory) {
                  requireERC721(_nftContract);
          
                  IERC721Enumerable nftContract = IERC721Enumerable(_nftContract);
          
                  uint256 tokenCount = nftContract.balanceOf(owner);
                  uint256 offset = page * rows;
                  uint256 range = offset > tokenCount
                      ? 0
                      : min(tokenCount - offset, rows);
                  uint256[] memory tokens = new uint256[](range);
                  for (uint256 index = 0; index < range; index++) {
                      tokens[index] = nftContract.tokenOfOwnerByIndex(
                          owner,
                          offset + index
                      );
                  }
                  return tokens;
              }
          
              function min(uint256 a, uint256 b) private pure returns (uint256) {
                  return a > b ? b : a;
              }
          }
          
          interface ISorareTokens {
              function createCardAndMintToken(
                  uint256 playerId,
                  uint16 season,
                  uint8 scarcity,
                  uint16 serialNumber,
                  bytes32 metadata,
                  uint16 clubId,
                  address to
              ) external returns (uint256);
          
              function mintToken(uint256 cardId, address to) external returns (uint256);
          }
          
          interface INextContract {
              function migrateTokens(uint256[] calldata tokenIds, address to) external;
          }
          
          contract SorareTokens is
              MinterAccess,
              RelayRecipient,
              ERC721("Sorare", "SOR"),
              ISorareTokens
          {
              ISorareCards public sorareCards;
              INextContract public nextContract;
          
              constructor(address sorareCardsAddress, address relayAddress)
                  public
                  RelayRecipient(relayAddress)
              {
                  require(
                      sorareCardsAddress != address(0),
                      "SorareCards address is required"
                  );
                  sorareCards = ISorareCards(sorareCardsAddress);
              }
          
              /// @dev Set the prefix for the tokenURIs.
              function setTokenURIPrefix(string memory prefix) public onlyOwner {
                  _setBaseURI(prefix);
              }
          
              /// @dev Set the potential next version contract
              function setNextContract(address nextContractAddress) public onlyOwner {
                  require(
                      address(nextContract) == address(0),
                      "NextContract already set"
                  );
                  nextContract = INextContract(nextContractAddress);
              }
          
              /// @dev Creates a new card in the Cards contract and mints the token
              // prettier-ignore
              function createCardAndMintToken(
                  uint256 playerId,
                  uint16 season,
                  uint8 scarcity,
                  uint16 serialNumber,
                  bytes32 metadata,
                  uint16 clubId,
                  address to
              ) public onlyMinter override returns (uint256) {
                  uint256 cardId = sorareCards.createCard(
                      playerId,
                      season,
                      scarcity,
                      serialNumber,
                      metadata,
                      clubId
                  );
          
                  _mint(to, cardId);
                  return cardId;
              }
          
              /// @dev Mints a token for an existing card
              // prettier-ignore
              function mintToken(uint256 cardId, address to)
                  public
                  override
                  onlyMinter
                  returns (uint256)
              {
                  require(sorareCards.cardExists(cardId), "Card does not exist");
          
                  _mint(to, cardId);
                  return cardId;
              }
          
              /// @dev Migrates tokens to a potential new version of this contract
              /// @param tokenIds - list of tokens to transfer
              function migrateTokens(uint256[] calldata tokenIds) external {
                  require(address(nextContract) != address(0), "Next contract not set");
          
                  for (uint256 index = 0; index < tokenIds.length; index++) {
                      transferFrom(_msgSender(), address(this), tokenIds[index]);
                  }
          
                  nextContract.migrateTokens(tokenIds, _msgSender());
              }
          
              /// @dev Pagination of owner tokens
              /// @param owner - address of the token owner
              /// @param page - page number
              /// @param rows - number of rows per page
              function tokensOfOwner(address owner, uint8 page, uint8 rows)
                  public
                  view
                  returns (uint256[] memory)
              {
                  return NFTClient.tokensOfOwner(address(this), owner, page, rows);
              }
          
              function getCard(uint256 tokenId)
                  public
                  view
                  returns (
                      uint256 playerId,
                      uint16 season,
                      uint256 scarcity,
                      uint16 serialNumber,
                      bytes memory metadata,
                      uint16 clubId
                  )
              {
                  (
                      playerId,
                      season,
                      scarcity,
                      serialNumber,
                      metadata,
                      clubId
                  ) = sorareCards.getCard(tokenId);
              }
          
              function getPlayer(uint256 playerId)
                  external
                  view
                  returns (
                      string memory name,
                      uint16 yearOfBirth,
                      uint8 monthOfBirth,
                      uint8 dayOfBirth
                  )
              {
                  (name, yearOfBirth, monthOfBirth, dayOfBirth) = sorareCards.getPlayer(
                      playerId
                  );
              }
          
              // prettier-ignore
              function getClub(uint16 clubId)
                  external
                  view
                  returns (
                      string memory name,
                      string memory country,
                      string memory city,
                      uint16 yearFounded
                  )
              {
                  (name, country, city, yearFounded) = sorareCards.getClub(clubId);
              }
          
              // prettier-ignore
              function _msgSender() internal view override(RelayRecipient, Context) returns (address payable) {
                  return RelayRecipient._msgSender();
              }
          
              // prettier-ignore
              function _msgData() internal view override(RelayRecipient, Context) returns (bytes memory) {
                  return RelayRecipient._msgData();
              }
          }