ETH Price: $2,136.48 (+18.81%)

Transaction Decoder

Block:
22130326 at Mar-26-2025 09:57:23 AM +UTC
Transaction Fee:
0.000045902305334722 ETH $0.10
Gas Used:
48,859 Gas / 0.939485158 Gwei

Emitted Events:

Account State Difference:

  Address   Before After State Difference Code
0x113aA7aa...F732400CF
0.01 Eth
Nonce: 3861
0.009954097694665278 Eth
Nonce: 3862
0.000045902305334722
0x7A1EE70D...5160423f9
(beaverbuild)
14.96893176708192256 Eth14.96895619658192256 Eth0.0000244295

Execution Trace

NFTDropCollection.setApprovalForAll( operator=0x1E0049783F008A0085193E00003D00cd54003c71, approved=True )
  • NFTDropCollection.setApprovalForAll( operator=0x1E0049783F008A0085193E00003D00cd54003c71, approved=True )
    File 1 of 2: NFTDropCollection
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol";
    import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
    import "@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol";
    import "@openzeppelin/contracts-upgradeable/token/ERC721/extensions/ERC721BurnableUpgradeable.sol";
    import "@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol";
    import "@openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol";
    import "@openzeppelin/contracts/utils/Strings.sol";
    import "./interfaces/internal/INFTDropCollectionInitializer.sol";
    import "./interfaces/internal/INFTDropCollectionMint.sol";
    import "./mixins/collections/CollectionRoyalties.sol";
    import "./mixins/collections/SequentialMintCollection.sol";
    import "./mixins/roles/AdminRole.sol";
    import "./mixins/roles/MinterRole.sol";
    import "./mixins/shared/ContractFactory.sol";
    /**
     * @title A contract to batch mint a collection of NFTs.
     * @notice A 10% royalty to the creator is included which may be split with collaborators.
     * @dev A collection can have up to 4,294,967,295 (2^32-1) tokens
     * @author batu-inal & HardlyDifficult
     */
    contract NFTDropCollection is
      INFTDropCollectionInitializer,
      INFTDropCollectionMint,
      IGetRoyalties,
      IGetFees,
      IRoyaltyInfo,
      ITokenCreator,
      ContractFactory,
      Initializable,
      ContextUpgradeable,
      ERC165Upgradeable,
      AccessControlUpgradeable,
      AdminRole,
      MinterRole,
      ERC721Upgradeable,
      ERC721BurnableUpgradeable,
      SequentialMintCollection,
      CollectionRoyalties
    {
      using Strings for uint256;
      /****** Slot 0 (after inheritance) ******/
      /**
       * @notice The address to pay the proceeds/royalties for the collection.
       * @dev If this is set to address(0) then the proceeds go to the creator.
       */
      address payable private paymentAddress;
      /**
       * @notice Whether the collection is revealed or not.
       */
      bool public isRevealed;
      // 88 bits free space
      /****** Slot 1 ******/
      /**
       * @notice The base URI used for all NFTs in this collection.
       * @dev The `<tokenId>.json` is appended to this to obtain an NFT's `tokenURI`.
       *      e.g. The URI for `tokenId`: "1" with `baseURI`: "ipfs://foo/" is "ipfs://foo/1.json".
       * @return The base URI used by this collection.
       */
      string public baseURI;
      /****** End of storage ******/
      /**
       * @notice Emitted when the collection is revealed.
       * @param baseURI The base URI for the collection.
       * @param isRevealed Whether the collection is revealed.
       */
      event URIUpdated(string baseURI, bool isRevealed);
      modifier validBaseURI(string calldata baseURI_) {
        require(bytes(baseURI_).length > 0, "NFTDropCollection: `baseURI_` must be set");
        _;
      }
      modifier onlyWhileUnrevealed() {
        require(!isRevealed, "NFTDropCollection: Already revealed");
        _;
      }
      /**
       * @notice Initialize the template's immutable variables.
       * @param _contractFactory The factory which will be used to create collection contracts.
       */
      constructor(address _contractFactory)
        ContractFactory(_contractFactory) // solhint-disable-next-line no-empty-blocks
      {}
      /**
       * @notice Called by the contract factory on creation.
       * @param _creator The creator of this collection.
       * This account is the default admin for this collection.
       * @param _name The collection's `name`.
       * @param _symbol The collection's `symbol`.
       * @param baseURI_ The base URI for the collection.
       * @param _isRevealed Whether the collection is revealed or not.
       * @param _maxTokenId The max token id for this collection.
       * @param _approvedMinter An optional address to grant the MINTER_ROLE.
       * Set to address(0) if only admins should be granted permission to mint.
       * @param _paymentAddress The address that will receive royalties and mint payments.
       */
      function initialize(
        address payable _creator,
        string calldata _name,
        string calldata _symbol,
        string calldata baseURI_,
        bool _isRevealed,
        uint32 _maxTokenId,
        address _approvedMinter,
        address payable _paymentAddress
      ) external initializer onlyContractFactory validBaseURI(baseURI_) {
        // Initialize the NFT
        __ERC721_init(_name, _symbol);
        _initializeSequentialMintCollection(_creator, _maxTokenId);
        // Initialize royalties
        if (_paymentAddress != address(0)) {
          // If no payment address was defined, `.owner` will be returned in getTokenCreatorPaymentAddress() below.
          paymentAddress = _paymentAddress;
        }
        // Initialize URI
        baseURI = baseURI_;
        isRevealed = _isRevealed;
        // Initialize access control
        AdminRole._initializeAdminRole(_creator);
        if (_approvedMinter != address(0)) {
          MinterRole._initializeMinterRole(_approvedMinter);
        }
      }
      /**
       * @notice Allows the collection admin to burn a specific token if they currently own the NFT.
       * @param tokenId The ID of the NFT to burn.
       * @dev The function here asserts `onlyAdmin` while the super confirms ownership.
       */
      function burn(uint256 tokenId) public override onlyAdmin {
        super.burn(tokenId);
      }
      /**
       * @notice Mint `count` number of NFTs for the `to` address.
       * @dev This is only callable by an address with either the MINTER_ROLE or the DEFAULT_ADMIN_ROLE.
       * @param count The number of NFTs to mint.
       * @param to The address to mint the NFTs for.
       * @return firstTokenId The tokenId for the first NFT minted.
       * The other minted tokens are assigned sequentially, so `firstTokenId` - `firstTokenId + count - 1` were minted.
       */
      function mintCountTo(uint16 count, address to) external onlyMinterOrAdmin returns (uint256 firstTokenId) {
        require(count != 0, "NFTDropCollection: `count` must be greater than 0");
        unchecked {
          // If +1 overflows then +count would also overflow, since count > 0.
          firstTokenId = latestTokenId + 1;
        }
        latestTokenId = latestTokenId + count;
        uint256 lastTokenId = latestTokenId;
        require(lastTokenId <= maxTokenId, "NFTDropCollection: Exceeds max tokenId");
        for (uint256 i = firstTokenId; i <= lastTokenId; ) {
          _safeMint(to, i);
          unchecked {
            ++i;
          }
        }
      }
      /**
       * @notice Allows a collection admin to reveal the collection's final content.
       * @dev Once revealed, the collection's content is immutable.
       * Use `updatePreRevealContent` to update content while unrevealed.
       * @param baseURI_ The base URI of the final content for this collection.
       */
      function reveal(string calldata baseURI_) external onlyAdmin validBaseURI(baseURI_) onlyWhileUnrevealed {
        isRevealed = true;
        // Set the new base URI.
        baseURI = baseURI_;
        emit URIUpdated(baseURI_, true);
      }
      /**
       * @notice Allows a collection admin to destroy this contract only if
       * no NFTs have been minted yet or the minted NFTs have been burned.
       * @dev Once destructed, a new collection could be deployed to this address (although that's discouraged).
       */
      function selfDestruct() external onlyAdmin {
        _selfDestruct();
      }
      /**
       * @notice Allows the owner to set a max tokenID.
       * This provides a guarantee to collectors about the limit of this collection contract.
       * @dev Once this value has been set, it may be decreased but can never be increased.
       * This max may be more than the final `totalSupply` if 1 or more tokens were burned.
       * @param _maxTokenId The max tokenId to set, all NFTs must have a tokenId less than or equal to this value.
       */
      function updateMaxTokenId(uint32 _maxTokenId) external onlyAdmin {
        _updateMaxTokenId(_maxTokenId);
      }
      /**
       * @notice Allows a collection admin to update the pre-reveal content.
       * @dev Use `reveal` to reveal the final content for this collection.
       * @param baseURI_ The base URI of the pre-reveal content.
       */
      function updatePreRevealContent(string calldata baseURI_)
        external
        validBaseURI(baseURI_)
        onlyWhileUnrevealed
        onlyAdmin
      {
        baseURI = baseURI_;
        emit URIUpdated(baseURI_, false);
      }
      function _burn(uint256 tokenId) internal override(ERC721Upgradeable, SequentialMintCollection) {
        super._burn(tokenId);
      }
      /**
       * @inheritdoc CollectionRoyalties
       */
      function getTokenCreatorPaymentAddress(
        uint256 /* tokenId */
      ) public view override returns (address payable creatorPaymentAddress) {
        creatorPaymentAddress = paymentAddress;
        if (creatorPaymentAddress == address(0)) {
          creatorPaymentAddress = owner;
        }
      }
      /**
       * @notice Get the number of tokens which can still be minted.
       * @return count The max number of additional NFTs that can be minted by this collection.
       */
      function numberOfTokensAvailableToMint() external view returns (uint256 count) {
        // Mint ensures that latestTokenId is always <= maxTokenId
        unchecked {
          count = maxTokenId - latestTokenId;
        }
      }
      /**
       * @inheritdoc IERC165Upgradeable
       */
      function supportsInterface(bytes4 interfaceId)
        public
        view
        override(ERC165Upgradeable, AccessControlUpgradeable, ERC721Upgradeable, CollectionRoyalties)
        returns (bool interfaceSupported)
      {
        interfaceSupported = (interfaceId == type(INFTDropCollectionMint).interfaceId ||
          super.supportsInterface(interfaceId));
      }
      /**
       * @inheritdoc IERC721MetadataUpgradeable
       */
      function tokenURI(uint256 tokenId) public view override returns (string memory uri) {
        _requireMinted(tokenId);
        uri = string.concat(baseURI, tokenId.toString(), ".json");
      }
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /**
     * @notice The required interface for collections to support the NFTDropMarket.
     * @dev This interface must be registered as a ERC165 supported interface to support the NFTDropMarket.
     * @author batu-inal & HardlyDifficult
     */
    interface INFTDropCollectionMint {
      function mintCountTo(uint16 count, address to) external returns (uint256 firstTokenId);
      function numberOfTokensAvailableToMint() external view returns (uint256 count);
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /**
     * @author batu-inal & HardlyDifficult
     */
    interface INFTDropCollectionInitializer {
      function initialize(
        address payable _creator,
        string calldata _name,
        string calldata _symbol,
        string calldata _baseURI,
        bool isRevealed,
        uint32 _maxTokenId,
        address _approvedMinter,
        address payable _paymentAddress
      ) external;
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol";
    import "../../interfaces/standards/royalties/IGetFees.sol";
    import "../../interfaces/standards/royalties/IGetRoyalties.sol";
    import "../../interfaces/standards/royalties/IRoyaltyInfo.sol";
    import "../../interfaces/standards/royalties/ITokenCreator.sol";
    import "../shared/Constants.sol";
    /**
     * @title Defines various royalty APIs for broad marketplace support.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract CollectionRoyalties is IGetRoyalties, IGetFees, IRoyaltyInfo, ITokenCreator, ERC165Upgradeable {
      /**
       * @inheritdoc IGetFees
       */
      function getFeeRecipients(uint256 tokenId) external view returns (address payable[] memory recipients) {
        recipients = new address payable[](1);
        recipients[0] = getTokenCreatorPaymentAddress(tokenId);
      }
      /**
       * @inheritdoc IGetFees
       * @dev The tokenId param is ignored since all NFTs return the same value.
       */
      function getFeeBps(
        uint256 /* tokenId */
      ) external pure returns (uint256[] memory royaltiesInBasisPoints) {
        royaltiesInBasisPoints = new uint256[](1);
        royaltiesInBasisPoints[0] = ROYALTY_IN_BASIS_POINTS;
      }
      /**
       * @inheritdoc IGetRoyalties
       */
      function getRoyalties(uint256 tokenId)
        external
        view
        returns (address payable[] memory recipients, uint256[] memory royaltiesInBasisPoints)
      {
        recipients = new address payable[](1);
        recipients[0] = getTokenCreatorPaymentAddress(tokenId);
        royaltiesInBasisPoints = new uint256[](1);
        royaltiesInBasisPoints[0] = ROYALTY_IN_BASIS_POINTS;
      }
      /**
       * @notice The address to pay the creator proceeds/royalties for the collection.
       * @param tokenId The ID of the NFT to get the creator payment address for.
       * @return creatorPaymentAddress The address to which royalties should be paid.
       */
      function getTokenCreatorPaymentAddress(uint256 tokenId)
        public
        view
        virtual
        returns (address payable creatorPaymentAddress);
      /**
       * @inheritdoc IRoyaltyInfo
       */
      function royaltyInfo(uint256 tokenId, uint256 salePrice)
        external
        view
        returns (address receiver, uint256 royaltyAmount)
      {
        receiver = getTokenCreatorPaymentAddress(tokenId);
        unchecked {
          royaltyAmount = salePrice / ROYALTY_RATIO;
        }
      }
      /**
       * @inheritdoc IERC165Upgradeable
       * @dev Checks the supported royalty interfaces.
       */
      function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool interfaceSupported) {
        interfaceSupported = (interfaceId == type(IRoyaltyInfo).interfaceId ||
          interfaceId == type(ITokenCreator).interfaceId ||
          interfaceId == type(IGetRoyalties).interfaceId ||
          interfaceId == type(IGetFees).interfaceId ||
          super.supportsInterface(interfaceId));
      }
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
    import "@openzeppelin/contracts-upgradeable/token/ERC721/extensions/ERC721BurnableUpgradeable.sol";
    import "../../interfaces/standards/royalties/ITokenCreator.sol";
    /**
     * @title Extends the OZ ERC721 implementation for collections which mint sequential token IDs.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract SequentialMintCollection is ITokenCreator, Initializable, ERC721BurnableUpgradeable {
      /****** Slot 0 (after inheritance) ******/
      /**
       * @notice The creator/owner of this NFT collection.
       * @dev This is the default royalty recipient if a different `paymentAddress` was not provided.
       * @return The collection's creator/owner address.
       */
      address payable public owner;
      /**
       * @notice The tokenId of the most recently created NFT.
       * @dev Minting starts at tokenId 1. Each mint will use this value + 1.
       * @return The most recently minted tokenId, or 0 if no NFTs have been minted yet.
       */
      uint32 public latestTokenId;
      /**
       * @notice The max tokenId which can be minted.
       * @dev This max may be less than the final `totalSupply` if 1 or more tokens were burned.
       * @return The max tokenId which can be minted.
       */
      uint32 public maxTokenId;
      /**
       * @notice Tracks how many tokens have been burned.
       * @dev This number is used to calculate the total supply efficiently.
       */
      uint32 private burnCounter;
      /****** End of storage ******/
      /**
       * @notice Emitted when the max tokenId supported by this collection is updated.
       * @param maxTokenId The new max tokenId. All NFTs in this collection will have a tokenId less than
       * or equal to this value.
       */
      event MaxTokenIdUpdated(uint256 indexed maxTokenId);
      /**
       * @notice Emitted when this collection is self destructed by the creator/owner/admin.
       * @param admin The account which requested this contract be self destructed.
       */
      event SelfDestruct(address indexed admin);
      modifier onlyOwner() {
        require(msg.sender == owner, "SequentialMintCollection: Caller is not owner");
        _;
      }
      function _initializeSequentialMintCollection(address payable _creator, uint32 _maxTokenId) internal onlyInitializing {
        owner = _creator;
        maxTokenId = _maxTokenId;
      }
      /**
       * @notice Allows the collection owner to destroy this contract only if
       * no NFTs have been minted yet or the minted NFTs have been burned.
       */
      function _selfDestruct() internal {
        require(totalSupply() == 0, "SequentialMintCollection: Any NFTs minted must be burned first");
        emit SelfDestruct(msg.sender);
        selfdestruct(payable(msg.sender));
      }
      /**
       * @notice Allows the owner to set a max tokenID.
       * This provides a guarantee to collectors about the limit of this collection contract, if applicable.
       * @dev Once this value has been set, it may be decreased but can never be increased.
       * @param _maxTokenId The max tokenId to set, all NFTs must have a tokenId less than or equal to this value.
       */
      function _updateMaxTokenId(uint32 _maxTokenId) internal {
        require(_maxTokenId != 0, "SequentialMintCollection: Max token ID may not be cleared");
        require(maxTokenId == 0 || _maxTokenId < maxTokenId, "SequentialMintCollection: Max token ID may not increase");
        require(latestTokenId <= _maxTokenId, "SequentialMintCollection: Max token ID must be >= last mint");
        maxTokenId = _maxTokenId;
        emit MaxTokenIdUpdated(_maxTokenId);
      }
      function _burn(uint256 tokenId) internal virtual override {
        unchecked {
          // Number of burned tokens cannot exceed latestTokenId which is the same size.
          ++burnCounter;
        }
        super._burn(tokenId);
      }
      /**
       * @inheritdoc ITokenCreator
       * @dev The tokenId param is ignored since all NFTs return the same value.
       */
      function tokenCreator(
        uint256 /* tokenId */
      ) external view returns (address payable creator) {
        creator = owner;
      }
      /**
       * @notice Returns the total amount of tokens stored by the contract.
       * @dev From the ERC-721 enumerable standard.
       * @return supply The total number of NFTs tracked by this contract.
       */
      function totalSupply() public view returns (uint256 supply) {
        unchecked {
          // Number of tokens minted is always >= burned tokens.
          supply = latestTokenId - burnCounter;
        }
      }
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
    import "@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol";
    /**
     * @title Defines a role for admin accounts.
     * @dev Wraps the default admin role from OpenZeppelin's AccessControl for easy integration.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract AdminRole is Initializable, AccessControlUpgradeable {
      modifier onlyAdmin() {
        require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "AdminRole: caller does not have the Admin role");
        _;
      }
      function _initializeAdminRole(address admin) internal onlyInitializing {
        // Grant the role to a specified account
        _grantRole(DEFAULT_ADMIN_ROLE, admin);
      }
      /**
       * @notice Adds an account as an approved admin.
       * @dev Only callable by existing admins, as enforced by `grantRole`.
       * @param account The address to be approved.
       */
      function grantAdmin(address account) external {
        grantRole(DEFAULT_ADMIN_ROLE, account);
      }
      /**
       * @notice Removes an account from the set of approved admins.
       * @dev Only callable by existing admins, as enforced by `revokeRole`.
       * @param account The address to be removed.
       */
      function revokeAdmin(address account) external {
        revokeRole(DEFAULT_ADMIN_ROLE, account);
      }
      /**
       * @notice Checks if the account provided is an admin.
       * @param account The address to check.
       * @return approved True if the account is an admin.
       * @dev This call is used by the royalty registry contract.
       */
      function isAdmin(address account) public view returns (bool approved) {
        approved = hasRole(DEFAULT_ADMIN_ROLE, account);
      }
      /**
       * @notice This empty reserved space is put in place to allow future versions to add new
       * variables without shifting down storage in the inheritance chain.
       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
       */
      uint256[1_000] private __gap;
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol";
    /**
     * @title Stores a reference to the factory which is used to create contract proxies.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract ContractFactory {
      using AddressUpgradeable for address;
      /**
       * @notice The address of the factory which was used to create this contract.
       * @return The factory contract address.
       */
      address public immutable contractFactory;
      modifier onlyContractFactory() {
        require(msg.sender == contractFactory, "ContractFactory: Caller is not the factory");
        _;
      }
      /**
       * @notice Initialize the template's immutable variables.
       * @param _contractFactory The factory which will be used to create these contracts.
       */
      constructor(address _contractFactory) {
        require(_contractFactory.isContract(), "ContractFactory: Factory is not a contract");
        contractFactory = _contractFactory;
      }
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
    import "@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol";
    import "./AdminRole.sol";
    /**
     * @title Defines a role for minter accounts.
     * @dev Wraps a role from OpenZeppelin's AccessControl for easy integration.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract MinterRole is Initializable, AccessControlUpgradeable, AdminRole {
      /**
       * @notice The `role` type used for approve minters.
       * @return `keccak256("MINTER_ROLE")`
       */
      bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");
      modifier onlyMinterOrAdmin() {
        require(isMinter(msg.sender) || isAdmin(msg.sender), "MinterRole: Must have the minter or admin role");
        _;
      }
      function _initializeMinterRole(address minter) internal onlyInitializing {
        // Grant the role to a specified account
        _grantRole(MINTER_ROLE, minter);
      }
      /**
       * @notice Adds an account as an approved minter.
       * @dev Only callable by admins, as enforced by `grantRole`.
       * @param account The address to be approved.
       */
      function grantMinter(address account) external {
        grantRole(MINTER_ROLE, account);
      }
      /**
       * @notice Removes an account from the set of approved minters.
       * @dev Only callable by admins, as enforced by `revokeRole`.
       * @param account The address to be removed.
       */
      function revokeMinter(address account) external {
        revokeRole(MINTER_ROLE, account);
      }
      /**
       * @notice Checks if the account provided is an minter.
       * @param account The address to check.
       * @return approved True if the account is an minter.
       */
      function isMinter(address account) public view returns (bool approved) {
        approved = hasRole(MINTER_ROLE, account);
      }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (access/AccessControl.sol)
    pragma solidity ^0.8.0;
    import "./IAccessControlUpgradeable.sol";
    import "../utils/ContextUpgradeable.sol";
    import "../utils/StringsUpgradeable.sol";
    import "../utils/introspection/ERC165Upgradeable.sol";
    import "../proxy/utils/Initializable.sol";
    /**
     * @dev Contract module that allows children to implement role-based access
     * control mechanisms. This is a lightweight version that doesn't allow enumerating role
     * members except through off-chain means by accessing the contract event logs. Some
     * applications may benefit from on-chain enumerability, for those cases see
     * {AccessControlEnumerable}.
     *
     * Roles are referred to by their `bytes32` identifier. These should be exposed
     * in the external API and be unique. The best way to achieve this is by
     * using `public constant` hash digests:
     *
     * ```
     * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
     * ```
     *
     * Roles can be used to represent a set of permissions. To restrict access to a
     * function call, use {hasRole}:
     *
     * ```
     * function foo() public {
     *     require(hasRole(MY_ROLE, msg.sender));
     *     ...
     * }
     * ```
     *
     * Roles can be granted and revoked dynamically via the {grantRole} and
     * {revokeRole} functions. Each role has an associated admin role, and only
     * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
     *
     * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
     * that only accounts with this role will be able to grant or revoke other
     * roles. More complex role relationships can be created by using
     * {_setRoleAdmin}.
     *
     * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
     * grant and revoke this role. Extra precautions should be taken to secure
     * accounts that have been granted it.
     */
    abstract contract AccessControlUpgradeable is Initializable, ContextUpgradeable, IAccessControlUpgradeable, ERC165Upgradeable {
        function __AccessControl_init() internal onlyInitializing {
        }
        function __AccessControl_init_unchained() internal onlyInitializing {
        }
        struct RoleData {
            mapping(address => bool) members;
            bytes32 adminRole;
        }
        mapping(bytes32 => RoleData) private _roles;
        bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
        /**
         * @dev Modifier that checks that an account has a specific role. Reverts
         * with a standardized message including the required role.
         *
         * The format of the revert reason is given by the following regular expression:
         *
         *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
         *
         * _Available since v4.1._
         */
        modifier onlyRole(bytes32 role) {
            _checkRole(role);
            _;
        }
        /**
         * @dev See {IERC165-supportsInterface}.
         */
        function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
            return interfaceId == type(IAccessControlUpgradeable).interfaceId || super.supportsInterface(interfaceId);
        }
        /**
         * @dev Returns `true` if `account` has been granted `role`.
         */
        function hasRole(bytes32 role, address account) public view virtual override returns (bool) {
            return _roles[role].members[account];
        }
        /**
         * @dev Revert with a standard message if `_msgSender()` is missing `role`.
         * Overriding this function changes the behavior of the {onlyRole} modifier.
         *
         * Format of the revert message is described in {_checkRole}.
         *
         * _Available since v4.6._
         */
        function _checkRole(bytes32 role) internal view virtual {
            _checkRole(role, _msgSender());
        }
        /**
         * @dev Revert with a standard message if `account` is missing `role`.
         *
         * The format of the revert reason is given by the following regular expression:
         *
         *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
         */
        function _checkRole(bytes32 role, address account) internal view virtual {
            if (!hasRole(role, account)) {
                revert(
                    string(
                        abi.encodePacked(
                            "AccessControl: account ",
                            StringsUpgradeable.toHexString(uint160(account), 20),
                            " is missing role ",
                            StringsUpgradeable.toHexString(uint256(role), 32)
                        )
                    )
                );
            }
        }
        /**
         * @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 virtual override 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.
         *
         * May emit a {RoleGranted} event.
         */
        function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
            _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.
         *
         * May emit a {RoleRevoked} event.
         */
        function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
            _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 revoked `role`, emits a {RoleRevoked}
         * event.
         *
         * Requirements:
         *
         * - the caller must be `account`.
         *
         * May emit a {RoleRevoked} event.
         */
        function renounceRole(bytes32 role, address account) public virtual override {
            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.
         *
         * May emit a {RoleGranted} event.
         *
         * [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}.
         * ====
         *
         * NOTE: This function is deprecated in favor of {_grantRole}.
         */
        function _setupRole(bytes32 role, address account) internal virtual {
            _grantRole(role, account);
        }
        /**
         * @dev Sets `adminRole` as ``role``'s admin role.
         *
         * Emits a {RoleAdminChanged} event.
         */
        function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
            bytes32 previousAdminRole = getRoleAdmin(role);
            _roles[role].adminRole = adminRole;
            emit RoleAdminChanged(role, previousAdminRole, adminRole);
        }
        /**
         * @dev Grants `role` to `account`.
         *
         * Internal function without access restriction.
         *
         * May emit a {RoleGranted} event.
         */
        function _grantRole(bytes32 role, address account) internal virtual {
            if (!hasRole(role, account)) {
                _roles[role].members[account] = true;
                emit RoleGranted(role, account, _msgSender());
            }
        }
        /**
         * @dev Revokes `role` from `account`.
         *
         * Internal function without access restriction.
         *
         * May emit a {RoleRevoked} event.
         */
        function _revokeRole(bytes32 role, address account) internal virtual {
            if (hasRole(role, account)) {
                _roles[role].members[account] = false;
                emit RoleRevoked(role, account, _msgSender());
            }
        }
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[49] private __gap;
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (proxy/utils/Initializable.sol)
    pragma solidity ^0.8.2;
    import "../../utils/AddressUpgradeable.sol";
    /**
     * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
     * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
     * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
     * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
     *
     * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
     * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
     * case an upgrade adds a module that needs to be initialized.
     *
     * For example:
     *
     * [.hljs-theme-light.nopadding]
     * ```
     * contract MyToken is ERC20Upgradeable {
     *     function initialize() initializer public {
     *         __ERC20_init("MyToken", "MTK");
     *     }
     * }
     * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
     *     function initializeV2() reinitializer(2) public {
     *         __ERC20Permit_init("MyToken");
     *     }
     * }
     * ```
     *
     * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
     * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
     *
     * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
     * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
     *
     * [CAUTION]
     * ====
     * Avoid leaving a contract uninitialized.
     *
     * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
     * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
     * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
     *
     * [.hljs-theme-light.nopadding]
     * ```
     * /// @custom:oz-upgrades-unsafe-allow constructor
     * constructor() {
     *     _disableInitializers();
     * }
     * ```
     * ====
     */
    abstract contract Initializable {
        /**
         * @dev Indicates that the contract has been initialized.
         * @custom:oz-retyped-from bool
         */
        uint8 private _initialized;
        /**
         * @dev Indicates that the contract is in the process of being initialized.
         */
        bool private _initializing;
        /**
         * @dev Triggered when the contract has been initialized or reinitialized.
         */
        event Initialized(uint8 version);
        /**
         * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
         * `onlyInitializing` functions can be used to initialize parent contracts. Equivalent to `reinitializer(1)`.
         */
        modifier initializer() {
            bool isTopLevelCall = !_initializing;
            require(
                (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
                "Initializable: contract is already initialized"
            );
            _initialized = 1;
            if (isTopLevelCall) {
                _initializing = true;
            }
            _;
            if (isTopLevelCall) {
                _initializing = false;
                emit Initialized(1);
            }
        }
        /**
         * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
         * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
         * used to initialize parent contracts.
         *
         * `initializer` is equivalent to `reinitializer(1)`, so a reinitializer may be used after the original
         * initialization step. This is essential to configure modules that are added through upgrades and that require
         * initialization.
         *
         * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
         * a contract, executing them in the right order is up to the developer or operator.
         */
        modifier reinitializer(uint8 version) {
            require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
            _initialized = version;
            _initializing = true;
            _;
            _initializing = false;
            emit Initialized(version);
        }
        /**
         * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
         * {initializer} and {reinitializer} modifiers, directly or indirectly.
         */
        modifier onlyInitializing() {
            require(_initializing, "Initializable: contract is not initializing");
            _;
        }
        /**
         * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
         * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
         * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
         * through proxies.
         */
        function _disableInitializers() internal virtual {
            require(!_initializing, "Initializable: contract is initializing");
            if (_initialized < type(uint8).max) {
                _initialized = type(uint8).max;
                emit Initialized(type(uint8).max);
            }
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/ERC721.sol)
    pragma solidity ^0.8.0;
    import "./IERC721Upgradeable.sol";
    import "./IERC721ReceiverUpgradeable.sol";
    import "./extensions/IERC721MetadataUpgradeable.sol";
    import "../../utils/AddressUpgradeable.sol";
    import "../../utils/ContextUpgradeable.sol";
    import "../../utils/StringsUpgradeable.sol";
    import "../../utils/introspection/ERC165Upgradeable.sol";
    import "../../proxy/utils/Initializable.sol";
    /**
     * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
     * the Metadata extension, but not including the Enumerable extension, which is available separately as
     * {ERC721Enumerable}.
     */
    contract ERC721Upgradeable is Initializable, ContextUpgradeable, ERC165Upgradeable, IERC721Upgradeable, IERC721MetadataUpgradeable {
        using AddressUpgradeable for address;
        using StringsUpgradeable for uint256;
        // Token name
        string private _name;
        // Token symbol
        string private _symbol;
        // Mapping from token ID to owner address
        mapping(uint256 => address) private _owners;
        // Mapping owner address to token count
        mapping(address => uint256) private _balances;
        // Mapping from token ID to approved address
        mapping(uint256 => address) private _tokenApprovals;
        // Mapping from owner to operator approvals
        mapping(address => mapping(address => bool)) private _operatorApprovals;
        /**
         * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
         */
        function __ERC721_init(string memory name_, string memory symbol_) internal onlyInitializing {
            __ERC721_init_unchained(name_, symbol_);
        }
        function __ERC721_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
            _name = name_;
            _symbol = symbol_;
        }
        /**
         * @dev See {IERC165-supportsInterface}.
         */
        function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165Upgradeable, IERC165Upgradeable) returns (bool) {
            return
                interfaceId == type(IERC721Upgradeable).interfaceId ||
                interfaceId == type(IERC721MetadataUpgradeable).interfaceId ||
                super.supportsInterface(interfaceId);
        }
        /**
         * @dev See {IERC721-balanceOf}.
         */
        function balanceOf(address owner) public view virtual override returns (uint256) {
            require(owner != address(0), "ERC721: address zero is not a valid owner");
            return _balances[owner];
        }
        /**
         * @dev See {IERC721-ownerOf}.
         */
        function ownerOf(uint256 tokenId) public view virtual override returns (address) {
            address owner = _owners[tokenId];
            require(owner != address(0), "ERC721: invalid token ID");
            return owner;
        }
        /**
         * @dev See {IERC721Metadata-name}.
         */
        function name() public view virtual override returns (string memory) {
            return _name;
        }
        /**
         * @dev See {IERC721Metadata-symbol}.
         */
        function symbol() public view virtual override returns (string memory) {
            return _symbol;
        }
        /**
         * @dev See {IERC721Metadata-tokenURI}.
         */
        function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
            _requireMinted(tokenId);
            string memory baseURI = _baseURI();
            return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
        }
        /**
         * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
         * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
         * by default, can be overridden in child contracts.
         */
        function _baseURI() internal view virtual returns (string memory) {
            return "";
        }
        /**
         * @dev See {IERC721-approve}.
         */
        function approve(address to, uint256 tokenId) public virtual override {
            address owner = ERC721Upgradeable.ownerOf(tokenId);
            require(to != owner, "ERC721: approval to current owner");
            require(
                _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                "ERC721: approve caller is not token owner nor approved for all"
            );
            _approve(to, tokenId);
        }
        /**
         * @dev See {IERC721-getApproved}.
         */
        function getApproved(uint256 tokenId) public view virtual override returns (address) {
            _requireMinted(tokenId);
            return _tokenApprovals[tokenId];
        }
        /**
         * @dev See {IERC721-setApprovalForAll}.
         */
        function setApprovalForAll(address operator, bool approved) public virtual override {
            _setApprovalForAll(_msgSender(), operator, approved);
        }
        /**
         * @dev See {IERC721-isApprovedForAll}.
         */
        function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
            return _operatorApprovals[owner][operator];
        }
        /**
         * @dev See {IERC721-transferFrom}.
         */
        function transferFrom(
            address from,
            address to,
            uint256 tokenId
        ) public virtual override {
            //solhint-disable-next-line max-line-length
            require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved");
            _transfer(from, to, tokenId);
        }
        /**
         * @dev See {IERC721-safeTransferFrom}.
         */
        function safeTransferFrom(
            address from,
            address to,
            uint256 tokenId
        ) public virtual override {
            safeTransferFrom(from, to, tokenId, "");
        }
        /**
         * @dev See {IERC721-safeTransferFrom}.
         */
        function safeTransferFrom(
            address from,
            address to,
            uint256 tokenId,
            bytes memory data
        ) public virtual override {
            require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved");
            _safeTransfer(from, to, tokenId, data);
        }
        /**
         * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
         * are aware of the ERC721 protocol to prevent tokens from being forever locked.
         *
         * `data` is additional data, it has no specified format and it is sent in call to `to`.
         *
         * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
         * implement alternative mechanisms to perform token transfer, such as signature-based.
         *
         * Requirements:
         *
         * - `from` cannot be the zero address.
         * - `to` cannot be the zero address.
         * - `tokenId` token must exist and be owned by `from`.
         * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
         *
         * Emits a {Transfer} event.
         */
        function _safeTransfer(
            address from,
            address to,
            uint256 tokenId,
            bytes memory data
        ) internal virtual {
            _transfer(from, to, tokenId);
            require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer");
        }
        /**
         * @dev Returns whether `tokenId` exists.
         *
         * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
         *
         * Tokens start existing when they are minted (`_mint`),
         * and stop existing when they are burned (`_burn`).
         */
        function _exists(uint256 tokenId) internal view virtual returns (bool) {
            return _owners[tokenId] != address(0);
        }
        /**
         * @dev Returns whether `spender` is allowed to manage `tokenId`.
         *
         * Requirements:
         *
         * - `tokenId` must exist.
         */
        function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
            address owner = ERC721Upgradeable.ownerOf(tokenId);
            return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
        }
        /**
         * @dev Safely mints `tokenId` and transfers it to `to`.
         *
         * Requirements:
         *
         * - `tokenId` must not exist.
         * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
         *
         * Emits a {Transfer} event.
         */
        function _safeMint(address to, uint256 tokenId) internal virtual {
            _safeMint(to, tokenId, "");
        }
        /**
         * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
         * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
         */
        function _safeMint(
            address to,
            uint256 tokenId,
            bytes memory data
        ) internal virtual {
            _mint(to, tokenId);
            require(
                _checkOnERC721Received(address(0), to, tokenId, data),
                "ERC721: transfer to non ERC721Receiver implementer"
            );
        }
        /**
         * @dev Mints `tokenId` and transfers it to `to`.
         *
         * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
         *
         * Requirements:
         *
         * - `tokenId` must not exist.
         * - `to` cannot be the zero address.
         *
         * Emits a {Transfer} event.
         */
        function _mint(address to, uint256 tokenId) internal virtual {
            require(to != address(0), "ERC721: mint to the zero address");
            require(!_exists(tokenId), "ERC721: token already minted");
            _beforeTokenTransfer(address(0), to, tokenId);
            _balances[to] += 1;
            _owners[tokenId] = to;
            emit Transfer(address(0), to, tokenId);
            _afterTokenTransfer(address(0), to, tokenId);
        }
        /**
         * @dev Destroys `tokenId`.
         * The approval is cleared when the token is burned.
         *
         * Requirements:
         *
         * - `tokenId` must exist.
         *
         * Emits a {Transfer} event.
         */
        function _burn(uint256 tokenId) internal virtual {
            address owner = ERC721Upgradeable.ownerOf(tokenId);
            _beforeTokenTransfer(owner, address(0), tokenId);
            // Clear approvals
            _approve(address(0), tokenId);
            _balances[owner] -= 1;
            delete _owners[tokenId];
            emit Transfer(owner, address(0), tokenId);
            _afterTokenTransfer(owner, address(0), tokenId);
        }
        /**
         * @dev Transfers `tokenId` from `from` to `to`.
         *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
         *
         * Requirements:
         *
         * - `to` cannot be the zero address.
         * - `tokenId` token must be owned by `from`.
         *
         * Emits a {Transfer} event.
         */
        function _transfer(
            address from,
            address to,
            uint256 tokenId
        ) internal virtual {
            require(ERC721Upgradeable.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
            require(to != address(0), "ERC721: transfer to the zero address");
            _beforeTokenTransfer(from, to, tokenId);
            // Clear approvals from the previous owner
            _approve(address(0), tokenId);
            _balances[from] -= 1;
            _balances[to] += 1;
            _owners[tokenId] = to;
            emit Transfer(from, to, tokenId);
            _afterTokenTransfer(from, to, tokenId);
        }
        /**
         * @dev Approve `to` to operate on `tokenId`
         *
         * Emits an {Approval} event.
         */
        function _approve(address to, uint256 tokenId) internal virtual {
            _tokenApprovals[tokenId] = to;
            emit Approval(ERC721Upgradeable.ownerOf(tokenId), to, tokenId);
        }
        /**
         * @dev Approve `operator` to operate on all of `owner` tokens
         *
         * Emits an {ApprovalForAll} event.
         */
        function _setApprovalForAll(
            address owner,
            address operator,
            bool approved
        ) internal virtual {
            require(owner != operator, "ERC721: approve to caller");
            _operatorApprovals[owner][operator] = approved;
            emit ApprovalForAll(owner, operator, approved);
        }
        /**
         * @dev Reverts if the `tokenId` has not been minted yet.
         */
        function _requireMinted(uint256 tokenId) internal view virtual {
            require(_exists(tokenId), "ERC721: invalid token ID");
        }
        /**
         * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
         * The call is not executed if the target address is not a contract.
         *
         * @param from address representing the previous owner of the given token ID
         * @param to target address that will receive the tokens
         * @param tokenId uint256 ID of the token to be transferred
         * @param data bytes optional data to send along with the call
         * @return bool whether the call correctly returned the expected magic value
         */
        function _checkOnERC721Received(
            address from,
            address to,
            uint256 tokenId,
            bytes memory data
        ) private returns (bool) {
            if (to.isContract()) {
                try IERC721ReceiverUpgradeable(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
                    return retval == IERC721ReceiverUpgradeable.onERC721Received.selector;
                } catch (bytes memory reason) {
                    if (reason.length == 0) {
                        revert("ERC721: transfer to non ERC721Receiver implementer");
                    } else {
                        /// @solidity memory-safe-assembly
                        assembly {
                            revert(add(32, reason), mload(reason))
                        }
                    }
                }
            } else {
                return true;
            }
        }
        /**
         * @dev Hook that is called before any token transfer. This includes minting
         * and burning.
         *
         * Calling conditions:
         *
         * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
         * transferred to `to`.
         * - When `from` is zero, `tokenId` will be minted for `to`.
         * - When `to` is zero, ``from``'s `tokenId` will be burned.
         * - `from` and `to` are never both zero.
         *
         * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
         */
        function _beforeTokenTransfer(
            address from,
            address to,
            uint256 tokenId
        ) internal virtual {}
        /**
         * @dev Hook that is called after any transfer of tokens. This includes
         * minting and burning.
         *
         * Calling conditions:
         *
         * - when `from` and `to` are both non-zero.
         * - `from` and `to` are never both zero.
         *
         * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
         */
        function _afterTokenTransfer(
            address from,
            address to,
            uint256 tokenId
        ) internal virtual {}
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[44] private __gap;
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/extensions/ERC721Burnable.sol)
    pragma solidity ^0.8.0;
    import "../ERC721Upgradeable.sol";
    import "../../../utils/ContextUpgradeable.sol";
    import "../../../proxy/utils/Initializable.sol";
    /**
     * @title ERC721 Burnable Token
     * @dev ERC721 Token that can be burned (destroyed).
     */
    abstract contract ERC721BurnableUpgradeable is Initializable, ContextUpgradeable, ERC721Upgradeable {
        function __ERC721Burnable_init() internal onlyInitializing {
        }
        function __ERC721Burnable_init_unchained() internal onlyInitializing {
        }
        /**
         * @dev Burns `tokenId`. See {ERC721-_burn}.
         *
         * Requirements:
         *
         * - The caller must own `tokenId` or be an approved operator.
         */
        function burn(uint256 tokenId) public virtual {
            //solhint-disable-next-line max-line-length
            require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved");
            _burn(tokenId);
        }
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[50] private __gap;
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
    pragma solidity ^0.8.0;
    import "../proxy/utils/Initializable.sol";
    /**
     * @dev Provides information about the current execution context, including the
     * sender of the transaction and its data. While these are generally available
     * via msg.sender and msg.data, they should not be accessed in such a direct
     * manner, since when dealing with meta-transactions the account sending and
     * paying for execution may not be the actual sender (as far as an application
     * is concerned).
     *
     * This contract is only required for intermediate, library-like contracts.
     */
    abstract contract ContextUpgradeable is Initializable {
        function __Context_init() internal onlyInitializing {
        }
        function __Context_init_unchained() internal onlyInitializing {
        }
        function _msgSender() internal view virtual returns (address) {
            return msg.sender;
        }
        function _msgData() internal view virtual returns (bytes calldata) {
            return msg.data;
        }
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[50] private __gap;
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev String operations.
     */
    library Strings {
        bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
        uint8 private constant _ADDRESS_LENGTH = 20;
        /**
         * @dev Converts a `uint256` to its ASCII `string` decimal representation.
         */
        function toString(uint256 value) internal pure returns (string memory) {
            // Inspired by OraclizeAPI's implementation - MIT licence
            // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
            if (value == 0) {
                return "0";
            }
            uint256 temp = value;
            uint256 digits;
            while (temp != 0) {
                digits++;
                temp /= 10;
            }
            bytes memory buffer = new bytes(digits);
            while (value != 0) {
                digits -= 1;
                buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                value /= 10;
            }
            return string(buffer);
        }
        /**
         * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
         */
        function toHexString(uint256 value) internal pure returns (string memory) {
            if (value == 0) {
                return "0x00";
            }
            uint256 temp = value;
            uint256 length = 0;
            while (temp != 0) {
                length++;
                temp >>= 8;
            }
            return toHexString(value, length);
        }
        /**
         * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
         */
        function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
            bytes memory buffer = new bytes(2 * length + 2);
            buffer[0] = "0";
            buffer[1] = "x";
            for (uint256 i = 2 * length + 1; i > 1; --i) {
                buffer[i] = _HEX_SYMBOLS[value & 0xf];
                value >>= 4;
            }
            require(value == 0, "Strings: hex length insufficient");
            return string(buffer);
        }
        /**
         * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
         */
        function toHexString(address addr) internal pure returns (string memory) {
            return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
    pragma solidity ^0.8.0;
    import "./IERC165Upgradeable.sol";
    import "../../proxy/utils/Initializable.sol";
    /**
     * @dev Implementation of the {IERC165} interface.
     *
     * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
     * for the additional interface id that will be supported. For example:
     *
     * ```solidity
     * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
     *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
     * }
     * ```
     *
     * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
     */
    abstract contract ERC165Upgradeable is Initializable, IERC165Upgradeable {
        function __ERC165_init() internal onlyInitializing {
        }
        function __ERC165_init_unchained() internal onlyInitializing {
        }
        /**
         * @dev See {IERC165-supportsInterface}.
         */
        function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
            return interfaceId == type(IERC165Upgradeable).interfaceId;
        }
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[50] private __gap;
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /// Constant values shared across mixins.
    /**
     * @dev 100% in basis points.
     */
    uint256 constant BASIS_POINTS = 10_000;
    /**
     * @dev The default admin role defined by OZ ACL modules.
     */
    bytes32 constant DEFAULT_ADMIN_ROLE = 0x00;
    /**
     * @dev Cap the number of royalty recipients.
     * A cap is required to ensure gas costs are not too high when a sale is settled.
     */
    uint256 constant MAX_ROYALTY_RECIPIENTS = 5;
    /**
     * @dev The minimum increase of 10% required when making an offer or placing a bid.
     */
    uint256 constant MIN_PERCENT_INCREMENT_DENOMINATOR = BASIS_POINTS / 1_000;
    /**
     * @dev The gas limit used when making external read-only calls.
     * This helps to ensure that external calls does not prevent the market from executing.
     */
    uint256 constant READ_ONLY_GAS_LIMIT = 40_000;
    /**
     * @dev Default royalty cut paid out on secondary sales.
     * Set to 10% of the secondary sale.
     */
    uint96 constant ROYALTY_IN_BASIS_POINTS = 1_000;
    /**
     * @dev 10%, expressed as a denominator for more efficient calculations.
     */
    uint256 constant ROYALTY_RATIO = BASIS_POINTS / ROYALTY_IN_BASIS_POINTS;
    /**
     * @dev The gas limit to send ETH to multiple recipients, enough for a 5-way split.
     */
    uint256 constant SEND_VALUE_GAS_LIMIT_MULTIPLE_RECIPIENTS = 210_000;
    /**
     * @dev The gas limit to send ETH to a single recipient, enough for a contract with a simple receiver.
     */
    uint256 constant SEND_VALUE_GAS_LIMIT_SINGLE_RECIPIENT = 20_000;
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /**
     * @notice Interface for EIP-2981: NFT Royalty Standard.
     * For more see: https://eips.ethereum.org/EIPS/eip-2981.
     */
    interface IRoyaltyInfo {
      /**
       * @notice Get the creator royalties to be sent.
       * @param tokenId The ID of the NFT to get royalties for.
       * @param salePrice The total price of the sale.
       * @return receiver The address to which royalties should be sent.
       * @return royaltyAmount The total amount that should be sent to the `receiver`.
       */
      function royaltyInfo(uint256 tokenId, uint256 salePrice)
        external
        view
        returns (address receiver, uint256 royaltyAmount);
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /**
     * @notice An interface for communicating fees to 3rd party marketplaces.
     * @dev Originally implemented in mainnet contract 0x44d6e8933f8271abcf253c72f9ed7e0e4c0323b3
     */
    interface IGetFees {
      /**
       * @notice Get the recipient addresses to which creator royalties should be sent.
       * @dev The expected royalty amounts are communicated with `getFeeBps`.
       * @param tokenId The ID of the NFT to get royalties for.
       * @return recipients An array of addresses to which royalties should be sent.
       */
      function getFeeRecipients(uint256 tokenId) external view returns (address payable[] memory recipients);
      /**
       * @notice Get the creator royalty amounts to be sent to each recipient, in basis points.
       * @dev The expected recipients are communicated with `getFeeRecipients`.
       * @param tokenId The ID of the NFT to get royalties for.
       * @return royaltiesInBasisPoints The array of fees to be sent to each recipient, in basis points.
       */
      function getFeeBps(uint256 tokenId) external view returns (uint256[] memory royaltiesInBasisPoints);
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    interface IGetRoyalties {
      /**
       * @notice Get the creator royalties to be sent.
       * @dev The data is the same as when calling `getFeeRecipients` and `getFeeBps` separately.
       * @param tokenId The ID of the NFT to get royalties for.
       * @return recipients An array of addresses to which royalties should be sent.
       * @return royaltiesInBasisPoints The array of fees to be sent to each recipient, in basis points.
       */
      function getRoyalties(uint256 tokenId)
        external
        view
        returns (address payable[] memory recipients, uint256[] memory royaltiesInBasisPoints);
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    interface ITokenCreator {
      /**
       * @notice Returns the creator of this NFT collection.
       * @param tokenId The ID of the NFT to get the creator payment address for.
       * @return creator The creator of this collection.
       */
      function tokenCreator(uint256 tokenId) external view returns (address payable creator);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev Interface of the ERC165 standard, as defined in the
     * https://eips.ethereum.org/EIPS/eip-165[EIP].
     *
     * Implementers can declare support of contract interfaces, which can then be
     * queried by others ({ERC165Checker}).
     *
     * For an implementation, see {ERC165}.
     */
    interface IERC165Upgradeable {
        /**
         * @dev Returns true if this contract implements the interface defined by
         * `interfaceId`. See the corresponding
         * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
         * to learn more about how these ids are created.
         *
         * This function call must use less than 30 000 gas.
         */
        function supportsInterface(bytes4 interfaceId) external view returns (bool);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol)
    pragma solidity ^0.8.1;
    /**
     * @dev Collection of functions related to the address type
     */
    library AddressUpgradeable {
        /**
         * @dev Returns true if `account` is a contract.
         *
         * [IMPORTANT]
         * ====
         * It is unsafe to assume that an address for which this function returns
         * false is an externally-owned account (EOA) and not a contract.
         *
         * Among others, `isContract` will return false for the following
         * types of addresses:
         *
         *  - an externally-owned account
         *  - a contract in construction
         *  - an address where a contract will be created
         *  - an address where a contract lived, but was destroyed
         * ====
         *
         * [IMPORTANT]
         * ====
         * You shouldn't rely on `isContract` to protect against flash loan attacks!
         *
         * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
         * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
         * constructor.
         * ====
         */
        function isContract(address account) internal view returns (bool) {
            // This method relies on extcodesize/address.code.length, which returns 0
            // for contracts in construction, since the code is only stored at the end
            // of the constructor execution.
            return account.code.length > 0;
        }
        /**
         * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
         * `recipient`, forwarding all available gas and reverting on errors.
         *
         * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
         * of certain opcodes, possibly making contracts go over the 2300 gas limit
         * imposed by `transfer`, making them unable to receive funds via
         * `transfer`. {sendValue} removes this limitation.
         *
         * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
         *
         * IMPORTANT: because control is transferred to `recipient`, care must be
         * taken to not create reentrancy vulnerabilities. Consider using
         * {ReentrancyGuard} or the
         * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
         */
        function sendValue(address payable recipient, uint256 amount) internal {
            require(address(this).balance >= amount, "Address: insufficient balance");
            (bool success, ) = recipient.call{value: amount}("");
            require(success, "Address: unable to send value, recipient may have reverted");
        }
        /**
         * @dev Performs a Solidity function call using a low level `call`. A
         * plain `call` is an unsafe replacement for a function call: use this
         * function instead.
         *
         * If `target` reverts with a revert reason, it is bubbled up by this
         * function (like regular Solidity function calls).
         *
         * Returns the raw returned data. To convert to the expected return value,
         * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
         *
         * Requirements:
         *
         * - `target` must be a contract.
         * - calling `target` with `data` must not revert.
         *
         * _Available since v3.1._
         */
        function functionCall(address target, bytes memory data) internal returns (bytes memory) {
            return functionCall(target, data, "Address: low-level call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
         * `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCall(
            address target,
            bytes memory data,
            string memory errorMessage
        ) internal returns (bytes memory) {
            return functionCallWithValue(target, data, 0, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but also transferring `value` wei to `target`.
         *
         * Requirements:
         *
         * - the calling contract must have an ETH balance of at least `value`.
         * - the called Solidity function must be `payable`.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(
            address target,
            bytes memory data,
            uint256 value
        ) internal returns (bytes memory) {
            return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
        }
        /**
         * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
         * with `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(
            address target,
            bytes memory data,
            uint256 value,
            string memory errorMessage
        ) internal returns (bytes memory) {
            require(address(this).balance >= value, "Address: insufficient balance for call");
            require(isContract(target), "Address: call to non-contract");
            (bool success, bytes memory returndata) = target.call{value: value}(data);
            return verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
            return functionStaticCall(target, data, "Address: low-level static call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(
            address target,
            bytes memory data,
            string memory errorMessage
        ) internal view returns (bytes memory) {
            require(isContract(target), "Address: static call to non-contract");
            (bool success, bytes memory returndata) = target.staticcall(data);
            return verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
         * revert reason using the provided one.
         *
         * _Available since v4.3._
         */
        function verifyCallResult(
            bool success,
            bytes memory returndata,
            string memory errorMessage
        ) internal pure returns (bytes memory) {
            if (success) {
                return returndata;
            } else {
                // Look for revert reason and bubble it up if present
                if (returndata.length > 0) {
                    // The easiest way to bubble the revert reason is using memory via assembly
                    /// @solidity memory-safe-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/IERC721.sol)
    pragma solidity ^0.8.0;
    import "../../utils/introspection/IERC165Upgradeable.sol";
    /**
     * @dev Required interface of an ERC721 compliant contract.
     */
    interface IERC721Upgradeable is IERC165Upgradeable {
        /**
         * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
         */
        event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
        /**
         * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
         */
        event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
        /**
         * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
         */
        event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
        /**
         * @dev Returns the number of tokens in ``owner``'s account.
         */
        function balanceOf(address owner) external view returns (uint256 balance);
        /**
         * @dev Returns the owner of the `tokenId` token.
         *
         * Requirements:
         *
         * - `tokenId` must exist.
         */
        function ownerOf(uint256 tokenId) external view returns (address owner);
        /**
         * @dev Safely transfers `tokenId` token from `from` to `to`.
         *
         * Requirements:
         *
         * - `from` cannot be the zero address.
         * - `to` cannot be the zero address.
         * - `tokenId` token must exist and be owned by `from`.
         * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
         * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
         *
         * Emits a {Transfer} event.
         */
        function safeTransferFrom(
            address from,
            address to,
            uint256 tokenId,
            bytes calldata data
        ) external;
        /**
         * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
         * are aware of the ERC721 protocol to prevent tokens from being forever locked.
         *
         * Requirements:
         *
         * - `from` cannot be the zero address.
         * - `to` cannot be the zero address.
         * - `tokenId` token must exist and be owned by `from`.
         * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
         * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
         *
         * Emits a {Transfer} event.
         */
        function safeTransferFrom(
            address from,
            address to,
            uint256 tokenId
        ) external;
        /**
         * @dev Transfers `tokenId` token from `from` to `to`.
         *
         * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
         *
         * Requirements:
         *
         * - `from` cannot be the zero address.
         * - `to` cannot be the zero address.
         * - `tokenId` token must be owned by `from`.
         * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(
            address from,
            address to,
            uint256 tokenId
        ) external;
        /**
         * @dev Gives permission to `to` to transfer `tokenId` token to another account.
         * The approval is cleared when the token is transferred.
         *
         * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
         *
         * Requirements:
         *
         * - The caller must own the token or be an approved operator.
         * - `tokenId` must exist.
         *
         * Emits an {Approval} event.
         */
        function approve(address to, uint256 tokenId) external;
        /**
         * @dev Approve or remove `operator` as an operator for the caller.
         * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
         *
         * Requirements:
         *
         * - The `operator` cannot be the caller.
         *
         * Emits an {ApprovalForAll} event.
         */
        function setApprovalForAll(address operator, bool _approved) external;
        /**
         * @dev Returns the account approved for `tokenId` token.
         *
         * Requirements:
         *
         * - `tokenId` must exist.
         */
        function getApproved(uint256 tokenId) external view returns (address operator);
        /**
         * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
         *
         * See {setApprovalForAll}
         */
        function isApprovedForAll(address owner, address operator) external view returns (bool);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)
    pragma solidity ^0.8.0;
    /**
     * @title ERC721 token receiver interface
     * @dev Interface for any contract that wants to support safeTransfers
     * from ERC721 asset contracts.
     */
    interface IERC721ReceiverUpgradeable {
        /**
         * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
         * by `operator` from `from`, this function is called.
         *
         * It must return its Solidity selector to confirm the token transfer.
         * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
         *
         * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
         */
        function onERC721Received(
            address operator,
            address from,
            uint256 tokenId,
            bytes calldata data
        ) external returns (bytes4);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev String operations.
     */
    library StringsUpgradeable {
        bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
        uint8 private constant _ADDRESS_LENGTH = 20;
        /**
         * @dev Converts a `uint256` to its ASCII `string` decimal representation.
         */
        function toString(uint256 value) internal pure returns (string memory) {
            // Inspired by OraclizeAPI's implementation - MIT licence
            // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
            if (value == 0) {
                return "0";
            }
            uint256 temp = value;
            uint256 digits;
            while (temp != 0) {
                digits++;
                temp /= 10;
            }
            bytes memory buffer = new bytes(digits);
            while (value != 0) {
                digits -= 1;
                buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                value /= 10;
            }
            return string(buffer);
        }
        /**
         * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
         */
        function toHexString(uint256 value) internal pure returns (string memory) {
            if (value == 0) {
                return "0x00";
            }
            uint256 temp = value;
            uint256 length = 0;
            while (temp != 0) {
                length++;
                temp >>= 8;
            }
            return toHexString(value, length);
        }
        /**
         * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
         */
        function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
            bytes memory buffer = new bytes(2 * length + 2);
            buffer[0] = "0";
            buffer[1] = "x";
            for (uint256 i = 2 * length + 1; i > 1; --i) {
                buffer[i] = _HEX_SYMBOLS[value & 0xf];
                value >>= 4;
            }
            require(value == 0, "Strings: hex length insufficient");
            return string(buffer);
        }
        /**
         * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
         */
        function toHexString(address addr) internal pure returns (string memory) {
            return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
    pragma solidity ^0.8.0;
    import "../IERC721Upgradeable.sol";
    /**
     * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
     * @dev See https://eips.ethereum.org/EIPS/eip-721
     */
    interface IERC721MetadataUpgradeable is IERC721Upgradeable {
        /**
         * @dev Returns the token collection name.
         */
        function name() external view returns (string memory);
        /**
         * @dev Returns the token collection symbol.
         */
        function symbol() external view returns (string memory);
        /**
         * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
         */
        function tokenURI(uint256 tokenId) external view returns (string memory);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev External interface of AccessControl declared to support ERC165 detection.
     */
    interface IAccessControlUpgradeable {
        /**
         * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
         *
         * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
         * {RoleAdminChanged} not being emitted signaling this.
         *
         * _Available since v3.1._
         */
        event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
        /**
         * @dev Emitted when `account` is granted `role`.
         *
         * `sender` is the account that originated the contract call, an admin role
         * bearer except when using {AccessControl-_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) external view returns (bool);
        /**
         * @dev Returns the admin role that controls `role`. See {grantRole} and
         * {revokeRole}.
         *
         * To change a role's admin, use {AccessControl-_setRoleAdmin}.
         */
        function getRoleAdmin(bytes32 role) external view returns (bytes32);
        /**
         * @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) external;
        /**
         * @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) external;
        /**
         * @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) external;
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../contracts/NFTDropCollection.sol";
    contract $NFTDropCollection is NFTDropCollection {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor(address _contractFactory) NFTDropCollection(_contractFactory) {}
        function $_burn(uint256 tokenId) external {
            return super._burn(tokenId);
        }
        function $_initializeSequentialMintCollection(address payable _creator,uint32 _maxTokenId) external {
            return super._initializeSequentialMintCollection(_creator,_maxTokenId);
        }
        function $_selfDestruct() external {
            return super._selfDestruct();
        }
        function $_updateMaxTokenId(uint32 _maxTokenId) external {
            return super._updateMaxTokenId(_maxTokenId);
        }
        function $__ERC721Burnable_init() external {
            return super.__ERC721Burnable_init();
        }
        function $__ERC721Burnable_init_unchained() external {
            return super.__ERC721Burnable_init_unchained();
        }
        function $__ERC721_init(string calldata name_,string calldata symbol_) external {
            return super.__ERC721_init(name_,symbol_);
        }
        function $__ERC721_init_unchained(string calldata name_,string calldata symbol_) external {
            return super.__ERC721_init_unchained(name_,symbol_);
        }
        function $_baseURI() external view returns (string memory) {
            return super._baseURI();
        }
        function $_safeTransfer(address from,address to,uint256 tokenId,bytes calldata data) external {
            return super._safeTransfer(from,to,tokenId,data);
        }
        function $_exists(uint256 tokenId) external view returns (bool) {
            return super._exists(tokenId);
        }
        function $_isApprovedOrOwner(address spender,uint256 tokenId) external view returns (bool) {
            return super._isApprovedOrOwner(spender,tokenId);
        }
        function $_safeMint(address to,uint256 tokenId) external {
            return super._safeMint(to,tokenId);
        }
        function $_safeMint(address to,uint256 tokenId,bytes calldata data) external {
            return super._safeMint(to,tokenId,data);
        }
        function $_mint(address to,uint256 tokenId) external {
            return super._mint(to,tokenId);
        }
        function $_transfer(address from,address to,uint256 tokenId) external {
            return super._transfer(from,to,tokenId);
        }
        function $_approve(address to,uint256 tokenId) external {
            return super._approve(to,tokenId);
        }
        function $_setApprovalForAll(address owner,address operator,bool approved) external {
            return super._setApprovalForAll(owner,operator,approved);
        }
        function $_requireMinted(uint256 tokenId) external view {
            return super._requireMinted(tokenId);
        }
        function $_beforeTokenTransfer(address from,address to,uint256 tokenId) external {
            return super._beforeTokenTransfer(from,to,tokenId);
        }
        function $_afterTokenTransfer(address from,address to,uint256 tokenId) external {
            return super._afterTokenTransfer(from,to,tokenId);
        }
        function $_initializeMinterRole(address minter) external {
            return super._initializeMinterRole(minter);
        }
        function $_initializeAdminRole(address admin) external {
            return super._initializeAdminRole(admin);
        }
        function $__AccessControl_init() external {
            return super.__AccessControl_init();
        }
        function $__AccessControl_init_unchained() external {
            return super.__AccessControl_init_unchained();
        }
        function $_checkRole(bytes32 role) external view {
            return super._checkRole(role);
        }
        function $_checkRole(bytes32 role,address account) external view {
            return super._checkRole(role,account);
        }
        function $_setupRole(bytes32 role,address account) external {
            return super._setupRole(role,account);
        }
        function $_setRoleAdmin(bytes32 role,bytes32 adminRole) external {
            return super._setRoleAdmin(role,adminRole);
        }
        function $_grantRole(bytes32 role,address account) external {
            return super._grantRole(role,account);
        }
        function $_revokeRole(bytes32 role,address account) external {
            return super._revokeRole(role,account);
        }
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $__Context_init() external {
            return super.__Context_init();
        }
        function $__Context_init_unchained() external {
            return super.__Context_init_unchained();
        }
        function $_msgSender() external view returns (address) {
            return super._msgSender();
        }
        function $_msgData() external view returns (bytes memory) {
            return super._msgData();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/interfaces/internal/INFTDropCollectionInitializer.sol";
    abstract contract $INFTDropCollectionInitializer is INFTDropCollectionInitializer {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/interfaces/internal/INFTDropCollectionMint.sol";
    abstract contract $INFTDropCollectionMint is INFTDropCollectionMint {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../../contracts/interfaces/standards/royalties/IGetFees.sol";
    abstract contract $IGetFees is IGetFees {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../../contracts/interfaces/standards/royalties/IGetRoyalties.sol";
    abstract contract $IGetRoyalties is IGetRoyalties {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../../contracts/interfaces/standards/royalties/IRoyaltyInfo.sol";
    abstract contract $IRoyaltyInfo is IRoyaltyInfo {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../../contracts/interfaces/standards/royalties/ITokenCreator.sol";
    abstract contract $ITokenCreator is ITokenCreator {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/collections/CollectionRoyalties.sol";
    abstract contract $CollectionRoyalties is CollectionRoyalties {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/collections/SequentialMintCollection.sol";
    contract $SequentialMintCollection is SequentialMintCollection {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        function $_initializeSequentialMintCollection(address payable _creator,uint32 _maxTokenId) external {
            return super._initializeSequentialMintCollection(_creator,_maxTokenId);
        }
        function $_selfDestruct() external {
            return super._selfDestruct();
        }
        function $_updateMaxTokenId(uint32 _maxTokenId) external {
            return super._updateMaxTokenId(_maxTokenId);
        }
        function $_burn(uint256 tokenId) external {
            return super._burn(tokenId);
        }
        function $__ERC721Burnable_init() external {
            return super.__ERC721Burnable_init();
        }
        function $__ERC721Burnable_init_unchained() external {
            return super.__ERC721Burnable_init_unchained();
        }
        function $__ERC721_init(string calldata name_,string calldata symbol_) external {
            return super.__ERC721_init(name_,symbol_);
        }
        function $__ERC721_init_unchained(string calldata name_,string calldata symbol_) external {
            return super.__ERC721_init_unchained(name_,symbol_);
        }
        function $_baseURI() external view returns (string memory) {
            return super._baseURI();
        }
        function $_safeTransfer(address from,address to,uint256 tokenId,bytes calldata data) external {
            return super._safeTransfer(from,to,tokenId,data);
        }
        function $_exists(uint256 tokenId) external view returns (bool) {
            return super._exists(tokenId);
        }
        function $_isApprovedOrOwner(address spender,uint256 tokenId) external view returns (bool) {
            return super._isApprovedOrOwner(spender,tokenId);
        }
        function $_safeMint(address to,uint256 tokenId) external {
            return super._safeMint(to,tokenId);
        }
        function $_safeMint(address to,uint256 tokenId,bytes calldata data) external {
            return super._safeMint(to,tokenId,data);
        }
        function $_mint(address to,uint256 tokenId) external {
            return super._mint(to,tokenId);
        }
        function $_transfer(address from,address to,uint256 tokenId) external {
            return super._transfer(from,to,tokenId);
        }
        function $_approve(address to,uint256 tokenId) external {
            return super._approve(to,tokenId);
        }
        function $_setApprovalForAll(address owner,address operator,bool approved) external {
            return super._setApprovalForAll(owner,operator,approved);
        }
        function $_requireMinted(uint256 tokenId) external view {
            return super._requireMinted(tokenId);
        }
        function $_beforeTokenTransfer(address from,address to,uint256 tokenId) external {
            return super._beforeTokenTransfer(from,to,tokenId);
        }
        function $_afterTokenTransfer(address from,address to,uint256 tokenId) external {
            return super._afterTokenTransfer(from,to,tokenId);
        }
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $__Context_init() external {
            return super.__Context_init();
        }
        function $__Context_init_unchained() external {
            return super.__Context_init_unchained();
        }
        function $_msgSender() external view returns (address) {
            return super._msgSender();
        }
        function $_msgData() external view returns (bytes memory) {
            return super._msgData();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/roles/AdminRole.sol";
    contract $AdminRole is AdminRole {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        function $_initializeAdminRole(address admin) external {
            return super._initializeAdminRole(admin);
        }
        function $__AccessControl_init() external {
            return super.__AccessControl_init();
        }
        function $__AccessControl_init_unchained() external {
            return super.__AccessControl_init_unchained();
        }
        function $_checkRole(bytes32 role) external view {
            return super._checkRole(role);
        }
        function $_checkRole(bytes32 role,address account) external view {
            return super._checkRole(role,account);
        }
        function $_setupRole(bytes32 role,address account) external {
            return super._setupRole(role,account);
        }
        function $_setRoleAdmin(bytes32 role,bytes32 adminRole) external {
            return super._setRoleAdmin(role,adminRole);
        }
        function $_grantRole(bytes32 role,address account) external {
            return super._grantRole(role,account);
        }
        function $_revokeRole(bytes32 role,address account) external {
            return super._revokeRole(role,account);
        }
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $__Context_init() external {
            return super.__Context_init();
        }
        function $__Context_init_unchained() external {
            return super.__Context_init_unchained();
        }
        function $_msgSender() external view returns (address) {
            return super._msgSender();
        }
        function $_msgData() external view returns (bytes memory) {
            return super._msgData();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/roles/MinterRole.sol";
    contract $MinterRole is MinterRole {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        function $_initializeMinterRole(address minter) external {
            return super._initializeMinterRole(minter);
        }
        function $_initializeAdminRole(address admin) external {
            return super._initializeAdminRole(admin);
        }
        function $__AccessControl_init() external {
            return super.__AccessControl_init();
        }
        function $__AccessControl_init_unchained() external {
            return super.__AccessControl_init_unchained();
        }
        function $_checkRole(bytes32 role) external view {
            return super._checkRole(role);
        }
        function $_checkRole(bytes32 role,address account) external view {
            return super._checkRole(role,account);
        }
        function $_setupRole(bytes32 role,address account) external {
            return super._setupRole(role,account);
        }
        function $_setRoleAdmin(bytes32 role,bytes32 adminRole) external {
            return super._setRoleAdmin(role,adminRole);
        }
        function $_grantRole(bytes32 role,address account) external {
            return super._grantRole(role,account);
        }
        function $_revokeRole(bytes32 role,address account) external {
            return super._revokeRole(role,account);
        }
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $__Context_init() external {
            return super.__Context_init();
        }
        function $__Context_init_unchained() external {
            return super.__Context_init_unchained();
        }
        function $_msgSender() external view returns (address) {
            return super._msgSender();
        }
        function $_msgData() external view returns (bytes memory) {
            return super._msgData();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/shared/Constants.sol";
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/shared/ContractFactory.sol";
    contract $ContractFactory is ContractFactory {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor(address _contractFactory) ContractFactory(_contractFactory) {}
        receive() external payable {}
    }
    

    File 2 of 2: NFTDropCollection
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol";
    import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
    import "@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol";
    import "@openzeppelin/contracts-upgradeable/token/ERC721/extensions/ERC721BurnableUpgradeable.sol";
    import "@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol";
    import "@openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol";
    import "@openzeppelin/contracts/utils/Strings.sol";
    import "./interfaces/internal/INFTDropCollectionInitializer.sol";
    import "./interfaces/internal/INFTDropCollectionMint.sol";
    import "./mixins/collections/CollectionRoyalties.sol";
    import "./mixins/collections/SequentialMintCollection.sol";
    import "./mixins/roles/AdminRole.sol";
    import "./mixins/roles/MinterRole.sol";
    import "./mixins/shared/ContractFactory.sol";
    /**
     * @title A contract to batch mint a collection of NFTs.
     * @notice A 10% royalty to the creator is included which may be split with collaborators.
     * @dev A collection can have up to 4,294,967,295 (2^32-1) tokens
     * @author batu-inal & HardlyDifficult
     */
    contract NFTDropCollection is
      INFTDropCollectionInitializer,
      INFTDropCollectionMint,
      IGetRoyalties,
      IGetFees,
      IRoyaltyInfo,
      ITokenCreator,
      ContractFactory,
      Initializable,
      ContextUpgradeable,
      ERC165Upgradeable,
      AccessControlUpgradeable,
      AdminRole,
      MinterRole,
      ERC721Upgradeable,
      ERC721BurnableUpgradeable,
      SequentialMintCollection,
      CollectionRoyalties
    {
      using Strings for uint256;
      /****** Slot 0 (after inheritance) ******/
      /**
       * @notice The address to pay the proceeds/royalties for the collection.
       * @dev If this is set to address(0) then the proceeds go to the creator.
       */
      address payable private paymentAddress;
      /**
       * @notice Whether the collection is revealed or not.
       */
      bool public isRevealed;
      // 88 bits free space
      /****** Slot 1 ******/
      /**
       * @notice The base URI used for all NFTs in this collection.
       * @dev The `<tokenId>.json` is appended to this to obtain an NFT's `tokenURI`.
       *      e.g. The URI for `tokenId`: "1" with `baseURI`: "ipfs://foo/" is "ipfs://foo/1.json".
       * @return The base URI used by this collection.
       */
      string public baseURI;
      /****** End of storage ******/
      /**
       * @notice Emitted when the collection is revealed.
       * @param baseURI The base URI for the collection.
       * @param isRevealed Whether the collection is revealed.
       */
      event URIUpdated(string baseURI, bool isRevealed);
      modifier validBaseURI(string calldata baseURI_) {
        require(bytes(baseURI_).length > 0, "NFTDropCollection: `baseURI_` must be set");
        _;
      }
      modifier onlyWhileUnrevealed() {
        require(!isRevealed, "NFTDropCollection: Already revealed");
        _;
      }
      /**
       * @notice Initialize the template's immutable variables.
       * @param _contractFactory The factory which will be used to create collection contracts.
       */
      constructor(address _contractFactory)
        ContractFactory(_contractFactory) // solhint-disable-next-line no-empty-blocks
      {}
      /**
       * @notice Called by the contract factory on creation.
       * @param _creator The creator of this collection.
       * This account is the default admin for this collection.
       * @param _name The collection's `name`.
       * @param _symbol The collection's `symbol`.
       * @param baseURI_ The base URI for the collection.
       * @param _isRevealed Whether the collection is revealed or not.
       * @param _maxTokenId The max token id for this collection.
       * @param _approvedMinter An optional address to grant the MINTER_ROLE.
       * Set to address(0) if only admins should be granted permission to mint.
       * @param _paymentAddress The address that will receive royalties and mint payments.
       */
      function initialize(
        address payable _creator,
        string calldata _name,
        string calldata _symbol,
        string calldata baseURI_,
        bool _isRevealed,
        uint32 _maxTokenId,
        address _approvedMinter,
        address payable _paymentAddress
      ) external initializer onlyContractFactory validBaseURI(baseURI_) {
        // Initialize the NFT
        __ERC721_init(_name, _symbol);
        _initializeSequentialMintCollection(_creator, _maxTokenId);
        // Initialize royalties
        if (_paymentAddress != address(0)) {
          // If no payment address was defined, `.owner` will be returned in getTokenCreatorPaymentAddress() below.
          paymentAddress = _paymentAddress;
        }
        // Initialize URI
        baseURI = baseURI_;
        isRevealed = _isRevealed;
        // Initialize access control
        AdminRole._initializeAdminRole(_creator);
        if (_approvedMinter != address(0)) {
          MinterRole._initializeMinterRole(_approvedMinter);
        }
      }
      /**
       * @notice Allows the collection admin to burn a specific token if they currently own the NFT.
       * @param tokenId The ID of the NFT to burn.
       * @dev The function here asserts `onlyAdmin` while the super confirms ownership.
       */
      function burn(uint256 tokenId) public override onlyAdmin {
        super.burn(tokenId);
      }
      /**
       * @notice Mint `count` number of NFTs for the `to` address.
       * @dev This is only callable by an address with either the MINTER_ROLE or the DEFAULT_ADMIN_ROLE.
       * @param count The number of NFTs to mint.
       * @param to The address to mint the NFTs for.
       * @return firstTokenId The tokenId for the first NFT minted.
       * The other minted tokens are assigned sequentially, so `firstTokenId` - `firstTokenId + count - 1` were minted.
       */
      function mintCountTo(uint16 count, address to) external onlyMinterOrAdmin returns (uint256 firstTokenId) {
        require(count != 0, "NFTDropCollection: `count` must be greater than 0");
        unchecked {
          // If +1 overflows then +count would also overflow, since count > 0.
          firstTokenId = latestTokenId + 1;
        }
        latestTokenId = latestTokenId + count;
        uint256 lastTokenId = latestTokenId;
        require(lastTokenId <= maxTokenId, "NFTDropCollection: Exceeds max tokenId");
        for (uint256 i = firstTokenId; i <= lastTokenId; ) {
          _safeMint(to, i);
          unchecked {
            ++i;
          }
        }
      }
      /**
       * @notice Allows a collection admin to reveal the collection's final content.
       * @dev Once revealed, the collection's content is immutable.
       * Use `updatePreRevealContent` to update content while unrevealed.
       * @param baseURI_ The base URI of the final content for this collection.
       */
      function reveal(string calldata baseURI_) external onlyAdmin validBaseURI(baseURI_) onlyWhileUnrevealed {
        isRevealed = true;
        // Set the new base URI.
        baseURI = baseURI_;
        emit URIUpdated(baseURI_, true);
      }
      /**
       * @notice Allows a collection admin to destroy this contract only if
       * no NFTs have been minted yet or the minted NFTs have been burned.
       * @dev Once destructed, a new collection could be deployed to this address (although that's discouraged).
       */
      function selfDestruct() external onlyAdmin {
        _selfDestruct();
      }
      /**
       * @notice Allows the owner to set a max tokenID.
       * This provides a guarantee to collectors about the limit of this collection contract.
       * @dev Once this value has been set, it may be decreased but can never be increased.
       * This max may be more than the final `totalSupply` if 1 or more tokens were burned.
       * @param _maxTokenId The max tokenId to set, all NFTs must have a tokenId less than or equal to this value.
       */
      function updateMaxTokenId(uint32 _maxTokenId) external onlyAdmin {
        _updateMaxTokenId(_maxTokenId);
      }
      /**
       * @notice Allows a collection admin to update the pre-reveal content.
       * @dev Use `reveal` to reveal the final content for this collection.
       * @param baseURI_ The base URI of the pre-reveal content.
       */
      function updatePreRevealContent(string calldata baseURI_)
        external
        validBaseURI(baseURI_)
        onlyWhileUnrevealed
        onlyAdmin
      {
        baseURI = baseURI_;
        emit URIUpdated(baseURI_, false);
      }
      function _burn(uint256 tokenId) internal override(ERC721Upgradeable, SequentialMintCollection) {
        super._burn(tokenId);
      }
      /**
       * @inheritdoc CollectionRoyalties
       */
      function getTokenCreatorPaymentAddress(
        uint256 /* tokenId */
      ) public view override returns (address payable creatorPaymentAddress) {
        creatorPaymentAddress = paymentAddress;
        if (creatorPaymentAddress == address(0)) {
          creatorPaymentAddress = owner;
        }
      }
      /**
       * @notice Get the number of tokens which can still be minted.
       * @return count The max number of additional NFTs that can be minted by this collection.
       */
      function numberOfTokensAvailableToMint() external view returns (uint256 count) {
        // Mint ensures that latestTokenId is always <= maxTokenId
        unchecked {
          count = maxTokenId - latestTokenId;
        }
      }
      /**
       * @inheritdoc IERC165Upgradeable
       */
      function supportsInterface(bytes4 interfaceId)
        public
        view
        override(ERC165Upgradeable, AccessControlUpgradeable, ERC721Upgradeable, CollectionRoyalties)
        returns (bool interfaceSupported)
      {
        interfaceSupported = (interfaceId == type(INFTDropCollectionMint).interfaceId ||
          super.supportsInterface(interfaceId));
      }
      /**
       * @inheritdoc IERC721MetadataUpgradeable
       */
      function tokenURI(uint256 tokenId) public view override returns (string memory uri) {
        _requireMinted(tokenId);
        uri = string.concat(baseURI, tokenId.toString(), ".json");
      }
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /**
     * @notice The required interface for collections to support the NFTDropMarket.
     * @dev This interface must be registered as a ERC165 supported interface to support the NFTDropMarket.
     * @author batu-inal & HardlyDifficult
     */
    interface INFTDropCollectionMint {
      function mintCountTo(uint16 count, address to) external returns (uint256 firstTokenId);
      function numberOfTokensAvailableToMint() external view returns (uint256 count);
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /**
     * @author batu-inal & HardlyDifficult
     */
    interface INFTDropCollectionInitializer {
      function initialize(
        address payable _creator,
        string calldata _name,
        string calldata _symbol,
        string calldata _baseURI,
        bool isRevealed,
        uint32 _maxTokenId,
        address _approvedMinter,
        address payable _paymentAddress
      ) external;
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol";
    import "../../interfaces/standards/royalties/IGetFees.sol";
    import "../../interfaces/standards/royalties/IGetRoyalties.sol";
    import "../../interfaces/standards/royalties/IRoyaltyInfo.sol";
    import "../../interfaces/standards/royalties/ITokenCreator.sol";
    import "../shared/Constants.sol";
    /**
     * @title Defines various royalty APIs for broad marketplace support.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract CollectionRoyalties is IGetRoyalties, IGetFees, IRoyaltyInfo, ITokenCreator, ERC165Upgradeable {
      /**
       * @inheritdoc IGetFees
       */
      function getFeeRecipients(uint256 tokenId) external view returns (address payable[] memory recipients) {
        recipients = new address payable[](1);
        recipients[0] = getTokenCreatorPaymentAddress(tokenId);
      }
      /**
       * @inheritdoc IGetFees
       * @dev The tokenId param is ignored since all NFTs return the same value.
       */
      function getFeeBps(
        uint256 /* tokenId */
      ) external pure returns (uint256[] memory royaltiesInBasisPoints) {
        royaltiesInBasisPoints = new uint256[](1);
        royaltiesInBasisPoints[0] = ROYALTY_IN_BASIS_POINTS;
      }
      /**
       * @inheritdoc IGetRoyalties
       */
      function getRoyalties(uint256 tokenId)
        external
        view
        returns (address payable[] memory recipients, uint256[] memory royaltiesInBasisPoints)
      {
        recipients = new address payable[](1);
        recipients[0] = getTokenCreatorPaymentAddress(tokenId);
        royaltiesInBasisPoints = new uint256[](1);
        royaltiesInBasisPoints[0] = ROYALTY_IN_BASIS_POINTS;
      }
      /**
       * @notice The address to pay the creator proceeds/royalties for the collection.
       * @param tokenId The ID of the NFT to get the creator payment address for.
       * @return creatorPaymentAddress The address to which royalties should be paid.
       */
      function getTokenCreatorPaymentAddress(uint256 tokenId)
        public
        view
        virtual
        returns (address payable creatorPaymentAddress);
      /**
       * @inheritdoc IRoyaltyInfo
       */
      function royaltyInfo(uint256 tokenId, uint256 salePrice)
        external
        view
        returns (address receiver, uint256 royaltyAmount)
      {
        receiver = getTokenCreatorPaymentAddress(tokenId);
        unchecked {
          royaltyAmount = salePrice / ROYALTY_RATIO;
        }
      }
      /**
       * @inheritdoc IERC165Upgradeable
       * @dev Checks the supported royalty interfaces.
       */
      function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool interfaceSupported) {
        interfaceSupported = (interfaceId == type(IRoyaltyInfo).interfaceId ||
          interfaceId == type(ITokenCreator).interfaceId ||
          interfaceId == type(IGetRoyalties).interfaceId ||
          interfaceId == type(IGetFees).interfaceId ||
          super.supportsInterface(interfaceId));
      }
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
    import "@openzeppelin/contracts-upgradeable/token/ERC721/extensions/ERC721BurnableUpgradeable.sol";
    import "../../interfaces/standards/royalties/ITokenCreator.sol";
    /**
     * @title Extends the OZ ERC721 implementation for collections which mint sequential token IDs.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract SequentialMintCollection is ITokenCreator, Initializable, ERC721BurnableUpgradeable {
      /****** Slot 0 (after inheritance) ******/
      /**
       * @notice The creator/owner of this NFT collection.
       * @dev This is the default royalty recipient if a different `paymentAddress` was not provided.
       * @return The collection's creator/owner address.
       */
      address payable public owner;
      /**
       * @notice The tokenId of the most recently created NFT.
       * @dev Minting starts at tokenId 1. Each mint will use this value + 1.
       * @return The most recently minted tokenId, or 0 if no NFTs have been minted yet.
       */
      uint32 public latestTokenId;
      /**
       * @notice The max tokenId which can be minted.
       * @dev This max may be less than the final `totalSupply` if 1 or more tokens were burned.
       * @return The max tokenId which can be minted.
       */
      uint32 public maxTokenId;
      /**
       * @notice Tracks how many tokens have been burned.
       * @dev This number is used to calculate the total supply efficiently.
       */
      uint32 private burnCounter;
      /****** End of storage ******/
      /**
       * @notice Emitted when the max tokenId supported by this collection is updated.
       * @param maxTokenId The new max tokenId. All NFTs in this collection will have a tokenId less than
       * or equal to this value.
       */
      event MaxTokenIdUpdated(uint256 indexed maxTokenId);
      /**
       * @notice Emitted when this collection is self destructed by the creator/owner/admin.
       * @param admin The account which requested this contract be self destructed.
       */
      event SelfDestruct(address indexed admin);
      modifier onlyOwner() {
        require(msg.sender == owner, "SequentialMintCollection: Caller is not owner");
        _;
      }
      function _initializeSequentialMintCollection(address payable _creator, uint32 _maxTokenId) internal onlyInitializing {
        owner = _creator;
        maxTokenId = _maxTokenId;
      }
      /**
       * @notice Allows the collection owner to destroy this contract only if
       * no NFTs have been minted yet or the minted NFTs have been burned.
       */
      function _selfDestruct() internal {
        require(totalSupply() == 0, "SequentialMintCollection: Any NFTs minted must be burned first");
        emit SelfDestruct(msg.sender);
        selfdestruct(payable(msg.sender));
      }
      /**
       * @notice Allows the owner to set a max tokenID.
       * This provides a guarantee to collectors about the limit of this collection contract, if applicable.
       * @dev Once this value has been set, it may be decreased but can never be increased.
       * @param _maxTokenId The max tokenId to set, all NFTs must have a tokenId less than or equal to this value.
       */
      function _updateMaxTokenId(uint32 _maxTokenId) internal {
        require(_maxTokenId != 0, "SequentialMintCollection: Max token ID may not be cleared");
        require(maxTokenId == 0 || _maxTokenId < maxTokenId, "SequentialMintCollection: Max token ID may not increase");
        require(latestTokenId <= _maxTokenId, "SequentialMintCollection: Max token ID must be >= last mint");
        maxTokenId = _maxTokenId;
        emit MaxTokenIdUpdated(_maxTokenId);
      }
      function _burn(uint256 tokenId) internal virtual override {
        unchecked {
          // Number of burned tokens cannot exceed latestTokenId which is the same size.
          ++burnCounter;
        }
        super._burn(tokenId);
      }
      /**
       * @inheritdoc ITokenCreator
       * @dev The tokenId param is ignored since all NFTs return the same value.
       */
      function tokenCreator(
        uint256 /* tokenId */
      ) external view returns (address payable creator) {
        creator = owner;
      }
      /**
       * @notice Returns the total amount of tokens stored by the contract.
       * @dev From the ERC-721 enumerable standard.
       * @return supply The total number of NFTs tracked by this contract.
       */
      function totalSupply() public view returns (uint256 supply) {
        unchecked {
          // Number of tokens minted is always >= burned tokens.
          supply = latestTokenId - burnCounter;
        }
      }
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
    import "@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol";
    /**
     * @title Defines a role for admin accounts.
     * @dev Wraps the default admin role from OpenZeppelin's AccessControl for easy integration.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract AdminRole is Initializable, AccessControlUpgradeable {
      modifier onlyAdmin() {
        require(hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "AdminRole: caller does not have the Admin role");
        _;
      }
      function _initializeAdminRole(address admin) internal onlyInitializing {
        // Grant the role to a specified account
        _grantRole(DEFAULT_ADMIN_ROLE, admin);
      }
      /**
       * @notice Adds an account as an approved admin.
       * @dev Only callable by existing admins, as enforced by `grantRole`.
       * @param account The address to be approved.
       */
      function grantAdmin(address account) external {
        grantRole(DEFAULT_ADMIN_ROLE, account);
      }
      /**
       * @notice Removes an account from the set of approved admins.
       * @dev Only callable by existing admins, as enforced by `revokeRole`.
       * @param account The address to be removed.
       */
      function revokeAdmin(address account) external {
        revokeRole(DEFAULT_ADMIN_ROLE, account);
      }
      /**
       * @notice Checks if the account provided is an admin.
       * @param account The address to check.
       * @return approved True if the account is an admin.
       * @dev This call is used by the royalty registry contract.
       */
      function isAdmin(address account) public view returns (bool approved) {
        approved = hasRole(DEFAULT_ADMIN_ROLE, account);
      }
      /**
       * @notice This empty reserved space is put in place to allow future versions to add new
       * variables without shifting down storage in the inheritance chain.
       * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
       */
      uint256[1_000] private __gap;
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol";
    /**
     * @title Stores a reference to the factory which is used to create contract proxies.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract ContractFactory {
      using AddressUpgradeable for address;
      /**
       * @notice The address of the factory which was used to create this contract.
       * @return The factory contract address.
       */
      address public immutable contractFactory;
      modifier onlyContractFactory() {
        require(msg.sender == contractFactory, "ContractFactory: Caller is not the factory");
        _;
      }
      /**
       * @notice Initialize the template's immutable variables.
       * @param _contractFactory The factory which will be used to create these contracts.
       */
      constructor(address _contractFactory) {
        require(_contractFactory.isContract(), "ContractFactory: Factory is not a contract");
        contractFactory = _contractFactory;
      }
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
    import "@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol";
    import "./AdminRole.sol";
    /**
     * @title Defines a role for minter accounts.
     * @dev Wraps a role from OpenZeppelin's AccessControl for easy integration.
     * @author batu-inal & HardlyDifficult
     */
    abstract contract MinterRole is Initializable, AccessControlUpgradeable, AdminRole {
      /**
       * @notice The `role` type used for approve minters.
       * @return `keccak256("MINTER_ROLE")`
       */
      bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");
      modifier onlyMinterOrAdmin() {
        require(isMinter(msg.sender) || isAdmin(msg.sender), "MinterRole: Must have the minter or admin role");
        _;
      }
      function _initializeMinterRole(address minter) internal onlyInitializing {
        // Grant the role to a specified account
        _grantRole(MINTER_ROLE, minter);
      }
      /**
       * @notice Adds an account as an approved minter.
       * @dev Only callable by admins, as enforced by `grantRole`.
       * @param account The address to be approved.
       */
      function grantMinter(address account) external {
        grantRole(MINTER_ROLE, account);
      }
      /**
       * @notice Removes an account from the set of approved minters.
       * @dev Only callable by admins, as enforced by `revokeRole`.
       * @param account The address to be removed.
       */
      function revokeMinter(address account) external {
        revokeRole(MINTER_ROLE, account);
      }
      /**
       * @notice Checks if the account provided is an minter.
       * @param account The address to check.
       * @return approved True if the account is an minter.
       */
      function isMinter(address account) public view returns (bool approved) {
        approved = hasRole(MINTER_ROLE, account);
      }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (access/AccessControl.sol)
    pragma solidity ^0.8.0;
    import "./IAccessControlUpgradeable.sol";
    import "../utils/ContextUpgradeable.sol";
    import "../utils/StringsUpgradeable.sol";
    import "../utils/introspection/ERC165Upgradeable.sol";
    import "../proxy/utils/Initializable.sol";
    /**
     * @dev Contract module that allows children to implement role-based access
     * control mechanisms. This is a lightweight version that doesn't allow enumerating role
     * members except through off-chain means by accessing the contract event logs. Some
     * applications may benefit from on-chain enumerability, for those cases see
     * {AccessControlEnumerable}.
     *
     * Roles are referred to by their `bytes32` identifier. These should be exposed
     * in the external API and be unique. The best way to achieve this is by
     * using `public constant` hash digests:
     *
     * ```
     * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
     * ```
     *
     * Roles can be used to represent a set of permissions. To restrict access to a
     * function call, use {hasRole}:
     *
     * ```
     * function foo() public {
     *     require(hasRole(MY_ROLE, msg.sender));
     *     ...
     * }
     * ```
     *
     * Roles can be granted and revoked dynamically via the {grantRole} and
     * {revokeRole} functions. Each role has an associated admin role, and only
     * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
     *
     * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
     * that only accounts with this role will be able to grant or revoke other
     * roles. More complex role relationships can be created by using
     * {_setRoleAdmin}.
     *
     * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
     * grant and revoke this role. Extra precautions should be taken to secure
     * accounts that have been granted it.
     */
    abstract contract AccessControlUpgradeable is Initializable, ContextUpgradeable, IAccessControlUpgradeable, ERC165Upgradeable {
        function __AccessControl_init() internal onlyInitializing {
        }
        function __AccessControl_init_unchained() internal onlyInitializing {
        }
        struct RoleData {
            mapping(address => bool) members;
            bytes32 adminRole;
        }
        mapping(bytes32 => RoleData) private _roles;
        bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
        /**
         * @dev Modifier that checks that an account has a specific role. Reverts
         * with a standardized message including the required role.
         *
         * The format of the revert reason is given by the following regular expression:
         *
         *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
         *
         * _Available since v4.1._
         */
        modifier onlyRole(bytes32 role) {
            _checkRole(role);
            _;
        }
        /**
         * @dev See {IERC165-supportsInterface}.
         */
        function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
            return interfaceId == type(IAccessControlUpgradeable).interfaceId || super.supportsInterface(interfaceId);
        }
        /**
         * @dev Returns `true` if `account` has been granted `role`.
         */
        function hasRole(bytes32 role, address account) public view virtual override returns (bool) {
            return _roles[role].members[account];
        }
        /**
         * @dev Revert with a standard message if `_msgSender()` is missing `role`.
         * Overriding this function changes the behavior of the {onlyRole} modifier.
         *
         * Format of the revert message is described in {_checkRole}.
         *
         * _Available since v4.6._
         */
        function _checkRole(bytes32 role) internal view virtual {
            _checkRole(role, _msgSender());
        }
        /**
         * @dev Revert with a standard message if `account` is missing `role`.
         *
         * The format of the revert reason is given by the following regular expression:
         *
         *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
         */
        function _checkRole(bytes32 role, address account) internal view virtual {
            if (!hasRole(role, account)) {
                revert(
                    string(
                        abi.encodePacked(
                            "AccessControl: account ",
                            StringsUpgradeable.toHexString(uint160(account), 20),
                            " is missing role ",
                            StringsUpgradeable.toHexString(uint256(role), 32)
                        )
                    )
                );
            }
        }
        /**
         * @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 virtual override 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.
         *
         * May emit a {RoleGranted} event.
         */
        function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
            _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.
         *
         * May emit a {RoleRevoked} event.
         */
        function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
            _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 revoked `role`, emits a {RoleRevoked}
         * event.
         *
         * Requirements:
         *
         * - the caller must be `account`.
         *
         * May emit a {RoleRevoked} event.
         */
        function renounceRole(bytes32 role, address account) public virtual override {
            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.
         *
         * May emit a {RoleGranted} event.
         *
         * [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}.
         * ====
         *
         * NOTE: This function is deprecated in favor of {_grantRole}.
         */
        function _setupRole(bytes32 role, address account) internal virtual {
            _grantRole(role, account);
        }
        /**
         * @dev Sets `adminRole` as ``role``'s admin role.
         *
         * Emits a {RoleAdminChanged} event.
         */
        function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
            bytes32 previousAdminRole = getRoleAdmin(role);
            _roles[role].adminRole = adminRole;
            emit RoleAdminChanged(role, previousAdminRole, adminRole);
        }
        /**
         * @dev Grants `role` to `account`.
         *
         * Internal function without access restriction.
         *
         * May emit a {RoleGranted} event.
         */
        function _grantRole(bytes32 role, address account) internal virtual {
            if (!hasRole(role, account)) {
                _roles[role].members[account] = true;
                emit RoleGranted(role, account, _msgSender());
            }
        }
        /**
         * @dev Revokes `role` from `account`.
         *
         * Internal function without access restriction.
         *
         * May emit a {RoleRevoked} event.
         */
        function _revokeRole(bytes32 role, address account) internal virtual {
            if (hasRole(role, account)) {
                _roles[role].members[account] = false;
                emit RoleRevoked(role, account, _msgSender());
            }
        }
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[49] private __gap;
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (proxy/utils/Initializable.sol)
    pragma solidity ^0.8.2;
    import "../../utils/AddressUpgradeable.sol";
    /**
     * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
     * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
     * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
     * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
     *
     * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
     * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
     * case an upgrade adds a module that needs to be initialized.
     *
     * For example:
     *
     * [.hljs-theme-light.nopadding]
     * ```
     * contract MyToken is ERC20Upgradeable {
     *     function initialize() initializer public {
     *         __ERC20_init("MyToken", "MTK");
     *     }
     * }
     * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
     *     function initializeV2() reinitializer(2) public {
     *         __ERC20Permit_init("MyToken");
     *     }
     * }
     * ```
     *
     * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
     * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
     *
     * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
     * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
     *
     * [CAUTION]
     * ====
     * Avoid leaving a contract uninitialized.
     *
     * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
     * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
     * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
     *
     * [.hljs-theme-light.nopadding]
     * ```
     * /// @custom:oz-upgrades-unsafe-allow constructor
     * constructor() {
     *     _disableInitializers();
     * }
     * ```
     * ====
     */
    abstract contract Initializable {
        /**
         * @dev Indicates that the contract has been initialized.
         * @custom:oz-retyped-from bool
         */
        uint8 private _initialized;
        /**
         * @dev Indicates that the contract is in the process of being initialized.
         */
        bool private _initializing;
        /**
         * @dev Triggered when the contract has been initialized or reinitialized.
         */
        event Initialized(uint8 version);
        /**
         * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
         * `onlyInitializing` functions can be used to initialize parent contracts. Equivalent to `reinitializer(1)`.
         */
        modifier initializer() {
            bool isTopLevelCall = !_initializing;
            require(
                (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
                "Initializable: contract is already initialized"
            );
            _initialized = 1;
            if (isTopLevelCall) {
                _initializing = true;
            }
            _;
            if (isTopLevelCall) {
                _initializing = false;
                emit Initialized(1);
            }
        }
        /**
         * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
         * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
         * used to initialize parent contracts.
         *
         * `initializer` is equivalent to `reinitializer(1)`, so a reinitializer may be used after the original
         * initialization step. This is essential to configure modules that are added through upgrades and that require
         * initialization.
         *
         * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
         * a contract, executing them in the right order is up to the developer or operator.
         */
        modifier reinitializer(uint8 version) {
            require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
            _initialized = version;
            _initializing = true;
            _;
            _initializing = false;
            emit Initialized(version);
        }
        /**
         * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
         * {initializer} and {reinitializer} modifiers, directly or indirectly.
         */
        modifier onlyInitializing() {
            require(_initializing, "Initializable: contract is not initializing");
            _;
        }
        /**
         * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
         * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
         * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
         * through proxies.
         */
        function _disableInitializers() internal virtual {
            require(!_initializing, "Initializable: contract is initializing");
            if (_initialized < type(uint8).max) {
                _initialized = type(uint8).max;
                emit Initialized(type(uint8).max);
            }
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/ERC721.sol)
    pragma solidity ^0.8.0;
    import "./IERC721Upgradeable.sol";
    import "./IERC721ReceiverUpgradeable.sol";
    import "./extensions/IERC721MetadataUpgradeable.sol";
    import "../../utils/AddressUpgradeable.sol";
    import "../../utils/ContextUpgradeable.sol";
    import "../../utils/StringsUpgradeable.sol";
    import "../../utils/introspection/ERC165Upgradeable.sol";
    import "../../proxy/utils/Initializable.sol";
    /**
     * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
     * the Metadata extension, but not including the Enumerable extension, which is available separately as
     * {ERC721Enumerable}.
     */
    contract ERC721Upgradeable is Initializable, ContextUpgradeable, ERC165Upgradeable, IERC721Upgradeable, IERC721MetadataUpgradeable {
        using AddressUpgradeable for address;
        using StringsUpgradeable for uint256;
        // Token name
        string private _name;
        // Token symbol
        string private _symbol;
        // Mapping from token ID to owner address
        mapping(uint256 => address) private _owners;
        // Mapping owner address to token count
        mapping(address => uint256) private _balances;
        // Mapping from token ID to approved address
        mapping(uint256 => address) private _tokenApprovals;
        // Mapping from owner to operator approvals
        mapping(address => mapping(address => bool)) private _operatorApprovals;
        /**
         * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
         */
        function __ERC721_init(string memory name_, string memory symbol_) internal onlyInitializing {
            __ERC721_init_unchained(name_, symbol_);
        }
        function __ERC721_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
            _name = name_;
            _symbol = symbol_;
        }
        /**
         * @dev See {IERC165-supportsInterface}.
         */
        function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165Upgradeable, IERC165Upgradeable) returns (bool) {
            return
                interfaceId == type(IERC721Upgradeable).interfaceId ||
                interfaceId == type(IERC721MetadataUpgradeable).interfaceId ||
                super.supportsInterface(interfaceId);
        }
        /**
         * @dev See {IERC721-balanceOf}.
         */
        function balanceOf(address owner) public view virtual override returns (uint256) {
            require(owner != address(0), "ERC721: address zero is not a valid owner");
            return _balances[owner];
        }
        /**
         * @dev See {IERC721-ownerOf}.
         */
        function ownerOf(uint256 tokenId) public view virtual override returns (address) {
            address owner = _owners[tokenId];
            require(owner != address(0), "ERC721: invalid token ID");
            return owner;
        }
        /**
         * @dev See {IERC721Metadata-name}.
         */
        function name() public view virtual override returns (string memory) {
            return _name;
        }
        /**
         * @dev See {IERC721Metadata-symbol}.
         */
        function symbol() public view virtual override returns (string memory) {
            return _symbol;
        }
        /**
         * @dev See {IERC721Metadata-tokenURI}.
         */
        function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
            _requireMinted(tokenId);
            string memory baseURI = _baseURI();
            return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
        }
        /**
         * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
         * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
         * by default, can be overridden in child contracts.
         */
        function _baseURI() internal view virtual returns (string memory) {
            return "";
        }
        /**
         * @dev See {IERC721-approve}.
         */
        function approve(address to, uint256 tokenId) public virtual override {
            address owner = ERC721Upgradeable.ownerOf(tokenId);
            require(to != owner, "ERC721: approval to current owner");
            require(
                _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                "ERC721: approve caller is not token owner nor approved for all"
            );
            _approve(to, tokenId);
        }
        /**
         * @dev See {IERC721-getApproved}.
         */
        function getApproved(uint256 tokenId) public view virtual override returns (address) {
            _requireMinted(tokenId);
            return _tokenApprovals[tokenId];
        }
        /**
         * @dev See {IERC721-setApprovalForAll}.
         */
        function setApprovalForAll(address operator, bool approved) public virtual override {
            _setApprovalForAll(_msgSender(), operator, approved);
        }
        /**
         * @dev See {IERC721-isApprovedForAll}.
         */
        function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
            return _operatorApprovals[owner][operator];
        }
        /**
         * @dev See {IERC721-transferFrom}.
         */
        function transferFrom(
            address from,
            address to,
            uint256 tokenId
        ) public virtual override {
            //solhint-disable-next-line max-line-length
            require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved");
            _transfer(from, to, tokenId);
        }
        /**
         * @dev See {IERC721-safeTransferFrom}.
         */
        function safeTransferFrom(
            address from,
            address to,
            uint256 tokenId
        ) public virtual override {
            safeTransferFrom(from, to, tokenId, "");
        }
        /**
         * @dev See {IERC721-safeTransferFrom}.
         */
        function safeTransferFrom(
            address from,
            address to,
            uint256 tokenId,
            bytes memory data
        ) public virtual override {
            require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved");
            _safeTransfer(from, to, tokenId, data);
        }
        /**
         * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
         * are aware of the ERC721 protocol to prevent tokens from being forever locked.
         *
         * `data` is additional data, it has no specified format and it is sent in call to `to`.
         *
         * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
         * implement alternative mechanisms to perform token transfer, such as signature-based.
         *
         * Requirements:
         *
         * - `from` cannot be the zero address.
         * - `to` cannot be the zero address.
         * - `tokenId` token must exist and be owned by `from`.
         * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
         *
         * Emits a {Transfer} event.
         */
        function _safeTransfer(
            address from,
            address to,
            uint256 tokenId,
            bytes memory data
        ) internal virtual {
            _transfer(from, to, tokenId);
            require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer");
        }
        /**
         * @dev Returns whether `tokenId` exists.
         *
         * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
         *
         * Tokens start existing when they are minted (`_mint`),
         * and stop existing when they are burned (`_burn`).
         */
        function _exists(uint256 tokenId) internal view virtual returns (bool) {
            return _owners[tokenId] != address(0);
        }
        /**
         * @dev Returns whether `spender` is allowed to manage `tokenId`.
         *
         * Requirements:
         *
         * - `tokenId` must exist.
         */
        function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
            address owner = ERC721Upgradeable.ownerOf(tokenId);
            return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
        }
        /**
         * @dev Safely mints `tokenId` and transfers it to `to`.
         *
         * Requirements:
         *
         * - `tokenId` must not exist.
         * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
         *
         * Emits a {Transfer} event.
         */
        function _safeMint(address to, uint256 tokenId) internal virtual {
            _safeMint(to, tokenId, "");
        }
        /**
         * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
         * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
         */
        function _safeMint(
            address to,
            uint256 tokenId,
            bytes memory data
        ) internal virtual {
            _mint(to, tokenId);
            require(
                _checkOnERC721Received(address(0), to, tokenId, data),
                "ERC721: transfer to non ERC721Receiver implementer"
            );
        }
        /**
         * @dev Mints `tokenId` and transfers it to `to`.
         *
         * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
         *
         * Requirements:
         *
         * - `tokenId` must not exist.
         * - `to` cannot be the zero address.
         *
         * Emits a {Transfer} event.
         */
        function _mint(address to, uint256 tokenId) internal virtual {
            require(to != address(0), "ERC721: mint to the zero address");
            require(!_exists(tokenId), "ERC721: token already minted");
            _beforeTokenTransfer(address(0), to, tokenId);
            _balances[to] += 1;
            _owners[tokenId] = to;
            emit Transfer(address(0), to, tokenId);
            _afterTokenTransfer(address(0), to, tokenId);
        }
        /**
         * @dev Destroys `tokenId`.
         * The approval is cleared when the token is burned.
         *
         * Requirements:
         *
         * - `tokenId` must exist.
         *
         * Emits a {Transfer} event.
         */
        function _burn(uint256 tokenId) internal virtual {
            address owner = ERC721Upgradeable.ownerOf(tokenId);
            _beforeTokenTransfer(owner, address(0), tokenId);
            // Clear approvals
            _approve(address(0), tokenId);
            _balances[owner] -= 1;
            delete _owners[tokenId];
            emit Transfer(owner, address(0), tokenId);
            _afterTokenTransfer(owner, address(0), tokenId);
        }
        /**
         * @dev Transfers `tokenId` from `from` to `to`.
         *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
         *
         * Requirements:
         *
         * - `to` cannot be the zero address.
         * - `tokenId` token must be owned by `from`.
         *
         * Emits a {Transfer} event.
         */
        function _transfer(
            address from,
            address to,
            uint256 tokenId
        ) internal virtual {
            require(ERC721Upgradeable.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
            require(to != address(0), "ERC721: transfer to the zero address");
            _beforeTokenTransfer(from, to, tokenId);
            // Clear approvals from the previous owner
            _approve(address(0), tokenId);
            _balances[from] -= 1;
            _balances[to] += 1;
            _owners[tokenId] = to;
            emit Transfer(from, to, tokenId);
            _afterTokenTransfer(from, to, tokenId);
        }
        /**
         * @dev Approve `to` to operate on `tokenId`
         *
         * Emits an {Approval} event.
         */
        function _approve(address to, uint256 tokenId) internal virtual {
            _tokenApprovals[tokenId] = to;
            emit Approval(ERC721Upgradeable.ownerOf(tokenId), to, tokenId);
        }
        /**
         * @dev Approve `operator` to operate on all of `owner` tokens
         *
         * Emits an {ApprovalForAll} event.
         */
        function _setApprovalForAll(
            address owner,
            address operator,
            bool approved
        ) internal virtual {
            require(owner != operator, "ERC721: approve to caller");
            _operatorApprovals[owner][operator] = approved;
            emit ApprovalForAll(owner, operator, approved);
        }
        /**
         * @dev Reverts if the `tokenId` has not been minted yet.
         */
        function _requireMinted(uint256 tokenId) internal view virtual {
            require(_exists(tokenId), "ERC721: invalid token ID");
        }
        /**
         * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
         * The call is not executed if the target address is not a contract.
         *
         * @param from address representing the previous owner of the given token ID
         * @param to target address that will receive the tokens
         * @param tokenId uint256 ID of the token to be transferred
         * @param data bytes optional data to send along with the call
         * @return bool whether the call correctly returned the expected magic value
         */
        function _checkOnERC721Received(
            address from,
            address to,
            uint256 tokenId,
            bytes memory data
        ) private returns (bool) {
            if (to.isContract()) {
                try IERC721ReceiverUpgradeable(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
                    return retval == IERC721ReceiverUpgradeable.onERC721Received.selector;
                } catch (bytes memory reason) {
                    if (reason.length == 0) {
                        revert("ERC721: transfer to non ERC721Receiver implementer");
                    } else {
                        /// @solidity memory-safe-assembly
                        assembly {
                            revert(add(32, reason), mload(reason))
                        }
                    }
                }
            } else {
                return true;
            }
        }
        /**
         * @dev Hook that is called before any token transfer. This includes minting
         * and burning.
         *
         * Calling conditions:
         *
         * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
         * transferred to `to`.
         * - When `from` is zero, `tokenId` will be minted for `to`.
         * - When `to` is zero, ``from``'s `tokenId` will be burned.
         * - `from` and `to` are never both zero.
         *
         * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
         */
        function _beforeTokenTransfer(
            address from,
            address to,
            uint256 tokenId
        ) internal virtual {}
        /**
         * @dev Hook that is called after any transfer of tokens. This includes
         * minting and burning.
         *
         * Calling conditions:
         *
         * - when `from` and `to` are both non-zero.
         * - `from` and `to` are never both zero.
         *
         * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
         */
        function _afterTokenTransfer(
            address from,
            address to,
            uint256 tokenId
        ) internal virtual {}
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[44] private __gap;
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/extensions/ERC721Burnable.sol)
    pragma solidity ^0.8.0;
    import "../ERC721Upgradeable.sol";
    import "../../../utils/ContextUpgradeable.sol";
    import "../../../proxy/utils/Initializable.sol";
    /**
     * @title ERC721 Burnable Token
     * @dev ERC721 Token that can be burned (destroyed).
     */
    abstract contract ERC721BurnableUpgradeable is Initializable, ContextUpgradeable, ERC721Upgradeable {
        function __ERC721Burnable_init() internal onlyInitializing {
        }
        function __ERC721Burnable_init_unchained() internal onlyInitializing {
        }
        /**
         * @dev Burns `tokenId`. See {ERC721-_burn}.
         *
         * Requirements:
         *
         * - The caller must own `tokenId` or be an approved operator.
         */
        function burn(uint256 tokenId) public virtual {
            //solhint-disable-next-line max-line-length
            require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved");
            _burn(tokenId);
        }
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[50] private __gap;
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
    pragma solidity ^0.8.0;
    import "../proxy/utils/Initializable.sol";
    /**
     * @dev Provides information about the current execution context, including the
     * sender of the transaction and its data. While these are generally available
     * via msg.sender and msg.data, they should not be accessed in such a direct
     * manner, since when dealing with meta-transactions the account sending and
     * paying for execution may not be the actual sender (as far as an application
     * is concerned).
     *
     * This contract is only required for intermediate, library-like contracts.
     */
    abstract contract ContextUpgradeable is Initializable {
        function __Context_init() internal onlyInitializing {
        }
        function __Context_init_unchained() internal onlyInitializing {
        }
        function _msgSender() internal view virtual returns (address) {
            return msg.sender;
        }
        function _msgData() internal view virtual returns (bytes calldata) {
            return msg.data;
        }
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[50] private __gap;
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev String operations.
     */
    library Strings {
        bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
        uint8 private constant _ADDRESS_LENGTH = 20;
        /**
         * @dev Converts a `uint256` to its ASCII `string` decimal representation.
         */
        function toString(uint256 value) internal pure returns (string memory) {
            // Inspired by OraclizeAPI's implementation - MIT licence
            // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
            if (value == 0) {
                return "0";
            }
            uint256 temp = value;
            uint256 digits;
            while (temp != 0) {
                digits++;
                temp /= 10;
            }
            bytes memory buffer = new bytes(digits);
            while (value != 0) {
                digits -= 1;
                buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                value /= 10;
            }
            return string(buffer);
        }
        /**
         * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
         */
        function toHexString(uint256 value) internal pure returns (string memory) {
            if (value == 0) {
                return "0x00";
            }
            uint256 temp = value;
            uint256 length = 0;
            while (temp != 0) {
                length++;
                temp >>= 8;
            }
            return toHexString(value, length);
        }
        /**
         * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
         */
        function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
            bytes memory buffer = new bytes(2 * length + 2);
            buffer[0] = "0";
            buffer[1] = "x";
            for (uint256 i = 2 * length + 1; i > 1; --i) {
                buffer[i] = _HEX_SYMBOLS[value & 0xf];
                value >>= 4;
            }
            require(value == 0, "Strings: hex length insufficient");
            return string(buffer);
        }
        /**
         * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
         */
        function toHexString(address addr) internal pure returns (string memory) {
            return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
    pragma solidity ^0.8.0;
    import "./IERC165Upgradeable.sol";
    import "../../proxy/utils/Initializable.sol";
    /**
     * @dev Implementation of the {IERC165} interface.
     *
     * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
     * for the additional interface id that will be supported. For example:
     *
     * ```solidity
     * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
     *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
     * }
     * ```
     *
     * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
     */
    abstract contract ERC165Upgradeable is Initializable, IERC165Upgradeable {
        function __ERC165_init() internal onlyInitializing {
        }
        function __ERC165_init_unchained() internal onlyInitializing {
        }
        /**
         * @dev See {IERC165-supportsInterface}.
         */
        function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
            return interfaceId == type(IERC165Upgradeable).interfaceId;
        }
        /**
         * @dev This empty reserved space is put in place to allow future versions to add new
         * variables without shifting down storage in the inheritance chain.
         * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
         */
        uint256[50] private __gap;
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /// Constant values shared across mixins.
    /**
     * @dev 100% in basis points.
     */
    uint256 constant BASIS_POINTS = 10_000;
    /**
     * @dev The default admin role defined by OZ ACL modules.
     */
    bytes32 constant DEFAULT_ADMIN_ROLE = 0x00;
    /**
     * @dev Cap the number of royalty recipients.
     * A cap is required to ensure gas costs are not too high when a sale is settled.
     */
    uint256 constant MAX_ROYALTY_RECIPIENTS = 5;
    /**
     * @dev The minimum increase of 10% required when making an offer or placing a bid.
     */
    uint256 constant MIN_PERCENT_INCREMENT_DENOMINATOR = BASIS_POINTS / 1_000;
    /**
     * @dev The gas limit used when making external read-only calls.
     * This helps to ensure that external calls does not prevent the market from executing.
     */
    uint256 constant READ_ONLY_GAS_LIMIT = 40_000;
    /**
     * @dev Default royalty cut paid out on secondary sales.
     * Set to 10% of the secondary sale.
     */
    uint96 constant ROYALTY_IN_BASIS_POINTS = 1_000;
    /**
     * @dev 10%, expressed as a denominator for more efficient calculations.
     */
    uint256 constant ROYALTY_RATIO = BASIS_POINTS / ROYALTY_IN_BASIS_POINTS;
    /**
     * @dev The gas limit to send ETH to multiple recipients, enough for a 5-way split.
     */
    uint256 constant SEND_VALUE_GAS_LIMIT_MULTIPLE_RECIPIENTS = 210_000;
    /**
     * @dev The gas limit to send ETH to a single recipient, enough for a contract with a simple receiver.
     */
    uint256 constant SEND_VALUE_GAS_LIMIT_SINGLE_RECIPIENT = 20_000;
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /**
     * @notice Interface for EIP-2981: NFT Royalty Standard.
     * For more see: https://eips.ethereum.org/EIPS/eip-2981.
     */
    interface IRoyaltyInfo {
      /**
       * @notice Get the creator royalties to be sent.
       * @param tokenId The ID of the NFT to get royalties for.
       * @param salePrice The total price of the sale.
       * @return receiver The address to which royalties should be sent.
       * @return royaltyAmount The total amount that should be sent to the `receiver`.
       */
      function royaltyInfo(uint256 tokenId, uint256 salePrice)
        external
        view
        returns (address receiver, uint256 royaltyAmount);
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    /**
     * @notice An interface for communicating fees to 3rd party marketplaces.
     * @dev Originally implemented in mainnet contract 0x44d6e8933f8271abcf253c72f9ed7e0e4c0323b3
     */
    interface IGetFees {
      /**
       * @notice Get the recipient addresses to which creator royalties should be sent.
       * @dev The expected royalty amounts are communicated with `getFeeBps`.
       * @param tokenId The ID of the NFT to get royalties for.
       * @return recipients An array of addresses to which royalties should be sent.
       */
      function getFeeRecipients(uint256 tokenId) external view returns (address payable[] memory recipients);
      /**
       * @notice Get the creator royalty amounts to be sent to each recipient, in basis points.
       * @dev The expected recipients are communicated with `getFeeRecipients`.
       * @param tokenId The ID of the NFT to get royalties for.
       * @return royaltiesInBasisPoints The array of fees to be sent to each recipient, in basis points.
       */
      function getFeeBps(uint256 tokenId) external view returns (uint256[] memory royaltiesInBasisPoints);
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    interface IGetRoyalties {
      /**
       * @notice Get the creator royalties to be sent.
       * @dev The data is the same as when calling `getFeeRecipients` and `getFeeBps` separately.
       * @param tokenId The ID of the NFT to get royalties for.
       * @return recipients An array of addresses to which royalties should be sent.
       * @return royaltiesInBasisPoints The array of fees to be sent to each recipient, in basis points.
       */
      function getRoyalties(uint256 tokenId)
        external
        view
        returns (address payable[] memory recipients, uint256[] memory royaltiesInBasisPoints);
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity ^0.8.12;
    interface ITokenCreator {
      /**
       * @notice Returns the creator of this NFT collection.
       * @param tokenId The ID of the NFT to get the creator payment address for.
       * @return creator The creator of this collection.
       */
      function tokenCreator(uint256 tokenId) external view returns (address payable creator);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev Interface of the ERC165 standard, as defined in the
     * https://eips.ethereum.org/EIPS/eip-165[EIP].
     *
     * Implementers can declare support of contract interfaces, which can then be
     * queried by others ({ERC165Checker}).
     *
     * For an implementation, see {ERC165}.
     */
    interface IERC165Upgradeable {
        /**
         * @dev Returns true if this contract implements the interface defined by
         * `interfaceId`. See the corresponding
         * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
         * to learn more about how these ids are created.
         *
         * This function call must use less than 30 000 gas.
         */
        function supportsInterface(bytes4 interfaceId) external view returns (bool);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol)
    pragma solidity ^0.8.1;
    /**
     * @dev Collection of functions related to the address type
     */
    library AddressUpgradeable {
        /**
         * @dev Returns true if `account` is a contract.
         *
         * [IMPORTANT]
         * ====
         * It is unsafe to assume that an address for which this function returns
         * false is an externally-owned account (EOA) and not a contract.
         *
         * Among others, `isContract` will return false for the following
         * types of addresses:
         *
         *  - an externally-owned account
         *  - a contract in construction
         *  - an address where a contract will be created
         *  - an address where a contract lived, but was destroyed
         * ====
         *
         * [IMPORTANT]
         * ====
         * You shouldn't rely on `isContract` to protect against flash loan attacks!
         *
         * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
         * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
         * constructor.
         * ====
         */
        function isContract(address account) internal view returns (bool) {
            // This method relies on extcodesize/address.code.length, which returns 0
            // for contracts in construction, since the code is only stored at the end
            // of the constructor execution.
            return account.code.length > 0;
        }
        /**
         * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
         * `recipient`, forwarding all available gas and reverting on errors.
         *
         * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
         * of certain opcodes, possibly making contracts go over the 2300 gas limit
         * imposed by `transfer`, making them unable to receive funds via
         * `transfer`. {sendValue} removes this limitation.
         *
         * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
         *
         * IMPORTANT: because control is transferred to `recipient`, care must be
         * taken to not create reentrancy vulnerabilities. Consider using
         * {ReentrancyGuard} or the
         * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
         */
        function sendValue(address payable recipient, uint256 amount) internal {
            require(address(this).balance >= amount, "Address: insufficient balance");
            (bool success, ) = recipient.call{value: amount}("");
            require(success, "Address: unable to send value, recipient may have reverted");
        }
        /**
         * @dev Performs a Solidity function call using a low level `call`. A
         * plain `call` is an unsafe replacement for a function call: use this
         * function instead.
         *
         * If `target` reverts with a revert reason, it is bubbled up by this
         * function (like regular Solidity function calls).
         *
         * Returns the raw returned data. To convert to the expected return value,
         * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
         *
         * Requirements:
         *
         * - `target` must be a contract.
         * - calling `target` with `data` must not revert.
         *
         * _Available since v3.1._
         */
        function functionCall(address target, bytes memory data) internal returns (bytes memory) {
            return functionCall(target, data, "Address: low-level call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
         * `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCall(
            address target,
            bytes memory data,
            string memory errorMessage
        ) internal returns (bytes memory) {
            return functionCallWithValue(target, data, 0, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but also transferring `value` wei to `target`.
         *
         * Requirements:
         *
         * - the calling contract must have an ETH balance of at least `value`.
         * - the called Solidity function must be `payable`.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(
            address target,
            bytes memory data,
            uint256 value
        ) internal returns (bytes memory) {
            return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
        }
        /**
         * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
         * with `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(
            address target,
            bytes memory data,
            uint256 value,
            string memory errorMessage
        ) internal returns (bytes memory) {
            require(address(this).balance >= value, "Address: insufficient balance for call");
            require(isContract(target), "Address: call to non-contract");
            (bool success, bytes memory returndata) = target.call{value: value}(data);
            return verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
            return functionStaticCall(target, data, "Address: low-level static call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(
            address target,
            bytes memory data,
            string memory errorMessage
        ) internal view returns (bytes memory) {
            require(isContract(target), "Address: static call to non-contract");
            (bool success, bytes memory returndata) = target.staticcall(data);
            return verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
         * revert reason using the provided one.
         *
         * _Available since v4.3._
         */
        function verifyCallResult(
            bool success,
            bytes memory returndata,
            string memory errorMessage
        ) internal pure returns (bytes memory) {
            if (success) {
                return returndata;
            } else {
                // Look for revert reason and bubble it up if present
                if (returndata.length > 0) {
                    // The easiest way to bubble the revert reason is using memory via assembly
                    /// @solidity memory-safe-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/IERC721.sol)
    pragma solidity ^0.8.0;
    import "../../utils/introspection/IERC165Upgradeable.sol";
    /**
     * @dev Required interface of an ERC721 compliant contract.
     */
    interface IERC721Upgradeable is IERC165Upgradeable {
        /**
         * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
         */
        event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
        /**
         * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
         */
        event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
        /**
         * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
         */
        event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
        /**
         * @dev Returns the number of tokens in ``owner``'s account.
         */
        function balanceOf(address owner) external view returns (uint256 balance);
        /**
         * @dev Returns the owner of the `tokenId` token.
         *
         * Requirements:
         *
         * - `tokenId` must exist.
         */
        function ownerOf(uint256 tokenId) external view returns (address owner);
        /**
         * @dev Safely transfers `tokenId` token from `from` to `to`.
         *
         * Requirements:
         *
         * - `from` cannot be the zero address.
         * - `to` cannot be the zero address.
         * - `tokenId` token must exist and be owned by `from`.
         * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
         * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
         *
         * Emits a {Transfer} event.
         */
        function safeTransferFrom(
            address from,
            address to,
            uint256 tokenId,
            bytes calldata data
        ) external;
        /**
         * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
         * are aware of the ERC721 protocol to prevent tokens from being forever locked.
         *
         * Requirements:
         *
         * - `from` cannot be the zero address.
         * - `to` cannot be the zero address.
         * - `tokenId` token must exist and be owned by `from`.
         * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
         * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
         *
         * Emits a {Transfer} event.
         */
        function safeTransferFrom(
            address from,
            address to,
            uint256 tokenId
        ) external;
        /**
         * @dev Transfers `tokenId` token from `from` to `to`.
         *
         * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
         *
         * Requirements:
         *
         * - `from` cannot be the zero address.
         * - `to` cannot be the zero address.
         * - `tokenId` token must be owned by `from`.
         * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(
            address from,
            address to,
            uint256 tokenId
        ) external;
        /**
         * @dev Gives permission to `to` to transfer `tokenId` token to another account.
         * The approval is cleared when the token is transferred.
         *
         * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
         *
         * Requirements:
         *
         * - The caller must own the token or be an approved operator.
         * - `tokenId` must exist.
         *
         * Emits an {Approval} event.
         */
        function approve(address to, uint256 tokenId) external;
        /**
         * @dev Approve or remove `operator` as an operator for the caller.
         * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
         *
         * Requirements:
         *
         * - The `operator` cannot be the caller.
         *
         * Emits an {ApprovalForAll} event.
         */
        function setApprovalForAll(address operator, bool _approved) external;
        /**
         * @dev Returns the account approved for `tokenId` token.
         *
         * Requirements:
         *
         * - `tokenId` must exist.
         */
        function getApproved(uint256 tokenId) external view returns (address operator);
        /**
         * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
         *
         * See {setApprovalForAll}
         */
        function isApprovedForAll(address owner, address operator) external view returns (bool);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)
    pragma solidity ^0.8.0;
    /**
     * @title ERC721 token receiver interface
     * @dev Interface for any contract that wants to support safeTransfers
     * from ERC721 asset contracts.
     */
    interface IERC721ReceiverUpgradeable {
        /**
         * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
         * by `operator` from `from`, this function is called.
         *
         * It must return its Solidity selector to confirm the token transfer.
         * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
         *
         * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
         */
        function onERC721Received(
            address operator,
            address from,
            uint256 tokenId,
            bytes calldata data
        ) external returns (bytes4);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev String operations.
     */
    library StringsUpgradeable {
        bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
        uint8 private constant _ADDRESS_LENGTH = 20;
        /**
         * @dev Converts a `uint256` to its ASCII `string` decimal representation.
         */
        function toString(uint256 value) internal pure returns (string memory) {
            // Inspired by OraclizeAPI's implementation - MIT licence
            // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
            if (value == 0) {
                return "0";
            }
            uint256 temp = value;
            uint256 digits;
            while (temp != 0) {
                digits++;
                temp /= 10;
            }
            bytes memory buffer = new bytes(digits);
            while (value != 0) {
                digits -= 1;
                buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                value /= 10;
            }
            return string(buffer);
        }
        /**
         * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
         */
        function toHexString(uint256 value) internal pure returns (string memory) {
            if (value == 0) {
                return "0x00";
            }
            uint256 temp = value;
            uint256 length = 0;
            while (temp != 0) {
                length++;
                temp >>= 8;
            }
            return toHexString(value, length);
        }
        /**
         * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
         */
        function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
            bytes memory buffer = new bytes(2 * length + 2);
            buffer[0] = "0";
            buffer[1] = "x";
            for (uint256 i = 2 * length + 1; i > 1; --i) {
                buffer[i] = _HEX_SYMBOLS[value & 0xf];
                value >>= 4;
            }
            require(value == 0, "Strings: hex length insufficient");
            return string(buffer);
        }
        /**
         * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
         */
        function toHexString(address addr) internal pure returns (string memory) {
            return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
    pragma solidity ^0.8.0;
    import "../IERC721Upgradeable.sol";
    /**
     * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
     * @dev See https://eips.ethereum.org/EIPS/eip-721
     */
    interface IERC721MetadataUpgradeable is IERC721Upgradeable {
        /**
         * @dev Returns the token collection name.
         */
        function name() external view returns (string memory);
        /**
         * @dev Returns the token collection symbol.
         */
        function symbol() external view returns (string memory);
        /**
         * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
         */
        function tokenURI(uint256 tokenId) external view returns (string memory);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev External interface of AccessControl declared to support ERC165 detection.
     */
    interface IAccessControlUpgradeable {
        /**
         * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
         *
         * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
         * {RoleAdminChanged} not being emitted signaling this.
         *
         * _Available since v3.1._
         */
        event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
        /**
         * @dev Emitted when `account` is granted `role`.
         *
         * `sender` is the account that originated the contract call, an admin role
         * bearer except when using {AccessControl-_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) external view returns (bool);
        /**
         * @dev Returns the admin role that controls `role`. See {grantRole} and
         * {revokeRole}.
         *
         * To change a role's admin, use {AccessControl-_setRoleAdmin}.
         */
        function getRoleAdmin(bytes32 role) external view returns (bytes32);
        /**
         * @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) external;
        /**
         * @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) external;
        /**
         * @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) external;
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../contracts/NFTDropCollection.sol";
    contract $NFTDropCollection is NFTDropCollection {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor(address _contractFactory) NFTDropCollection(_contractFactory) {}
        function $_burn(uint256 tokenId) external {
            return super._burn(tokenId);
        }
        function $_initializeSequentialMintCollection(address payable _creator,uint32 _maxTokenId) external {
            return super._initializeSequentialMintCollection(_creator,_maxTokenId);
        }
        function $_selfDestruct() external {
            return super._selfDestruct();
        }
        function $_updateMaxTokenId(uint32 _maxTokenId) external {
            return super._updateMaxTokenId(_maxTokenId);
        }
        function $__ERC721Burnable_init() external {
            return super.__ERC721Burnable_init();
        }
        function $__ERC721Burnable_init_unchained() external {
            return super.__ERC721Burnable_init_unchained();
        }
        function $__ERC721_init(string calldata name_,string calldata symbol_) external {
            return super.__ERC721_init(name_,symbol_);
        }
        function $__ERC721_init_unchained(string calldata name_,string calldata symbol_) external {
            return super.__ERC721_init_unchained(name_,symbol_);
        }
        function $_baseURI() external view returns (string memory) {
            return super._baseURI();
        }
        function $_safeTransfer(address from,address to,uint256 tokenId,bytes calldata data) external {
            return super._safeTransfer(from,to,tokenId,data);
        }
        function $_exists(uint256 tokenId) external view returns (bool) {
            return super._exists(tokenId);
        }
        function $_isApprovedOrOwner(address spender,uint256 tokenId) external view returns (bool) {
            return super._isApprovedOrOwner(spender,tokenId);
        }
        function $_safeMint(address to,uint256 tokenId) external {
            return super._safeMint(to,tokenId);
        }
        function $_safeMint(address to,uint256 tokenId,bytes calldata data) external {
            return super._safeMint(to,tokenId,data);
        }
        function $_mint(address to,uint256 tokenId) external {
            return super._mint(to,tokenId);
        }
        function $_transfer(address from,address to,uint256 tokenId) external {
            return super._transfer(from,to,tokenId);
        }
        function $_approve(address to,uint256 tokenId) external {
            return super._approve(to,tokenId);
        }
        function $_setApprovalForAll(address owner,address operator,bool approved) external {
            return super._setApprovalForAll(owner,operator,approved);
        }
        function $_requireMinted(uint256 tokenId) external view {
            return super._requireMinted(tokenId);
        }
        function $_beforeTokenTransfer(address from,address to,uint256 tokenId) external {
            return super._beforeTokenTransfer(from,to,tokenId);
        }
        function $_afterTokenTransfer(address from,address to,uint256 tokenId) external {
            return super._afterTokenTransfer(from,to,tokenId);
        }
        function $_initializeMinterRole(address minter) external {
            return super._initializeMinterRole(minter);
        }
        function $_initializeAdminRole(address admin) external {
            return super._initializeAdminRole(admin);
        }
        function $__AccessControl_init() external {
            return super.__AccessControl_init();
        }
        function $__AccessControl_init_unchained() external {
            return super.__AccessControl_init_unchained();
        }
        function $_checkRole(bytes32 role) external view {
            return super._checkRole(role);
        }
        function $_checkRole(bytes32 role,address account) external view {
            return super._checkRole(role,account);
        }
        function $_setupRole(bytes32 role,address account) external {
            return super._setupRole(role,account);
        }
        function $_setRoleAdmin(bytes32 role,bytes32 adminRole) external {
            return super._setRoleAdmin(role,adminRole);
        }
        function $_grantRole(bytes32 role,address account) external {
            return super._grantRole(role,account);
        }
        function $_revokeRole(bytes32 role,address account) external {
            return super._revokeRole(role,account);
        }
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $__Context_init() external {
            return super.__Context_init();
        }
        function $__Context_init_unchained() external {
            return super.__Context_init_unchained();
        }
        function $_msgSender() external view returns (address) {
            return super._msgSender();
        }
        function $_msgData() external view returns (bytes memory) {
            return super._msgData();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/interfaces/internal/INFTDropCollectionInitializer.sol";
    abstract contract $INFTDropCollectionInitializer is INFTDropCollectionInitializer {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/interfaces/internal/INFTDropCollectionMint.sol";
    abstract contract $INFTDropCollectionMint is INFTDropCollectionMint {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../../contracts/interfaces/standards/royalties/IGetFees.sol";
    abstract contract $IGetFees is IGetFees {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../../contracts/interfaces/standards/royalties/IGetRoyalties.sol";
    abstract contract $IGetRoyalties is IGetRoyalties {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../../contracts/interfaces/standards/royalties/IRoyaltyInfo.sol";
    abstract contract $IRoyaltyInfo is IRoyaltyInfo {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../../contracts/interfaces/standards/royalties/ITokenCreator.sol";
    abstract contract $ITokenCreator is ITokenCreator {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/collections/CollectionRoyalties.sol";
    abstract contract $CollectionRoyalties is CollectionRoyalties {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/collections/SequentialMintCollection.sol";
    contract $SequentialMintCollection is SequentialMintCollection {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        function $_initializeSequentialMintCollection(address payable _creator,uint32 _maxTokenId) external {
            return super._initializeSequentialMintCollection(_creator,_maxTokenId);
        }
        function $_selfDestruct() external {
            return super._selfDestruct();
        }
        function $_updateMaxTokenId(uint32 _maxTokenId) external {
            return super._updateMaxTokenId(_maxTokenId);
        }
        function $_burn(uint256 tokenId) external {
            return super._burn(tokenId);
        }
        function $__ERC721Burnable_init() external {
            return super.__ERC721Burnable_init();
        }
        function $__ERC721Burnable_init_unchained() external {
            return super.__ERC721Burnable_init_unchained();
        }
        function $__ERC721_init(string calldata name_,string calldata symbol_) external {
            return super.__ERC721_init(name_,symbol_);
        }
        function $__ERC721_init_unchained(string calldata name_,string calldata symbol_) external {
            return super.__ERC721_init_unchained(name_,symbol_);
        }
        function $_baseURI() external view returns (string memory) {
            return super._baseURI();
        }
        function $_safeTransfer(address from,address to,uint256 tokenId,bytes calldata data) external {
            return super._safeTransfer(from,to,tokenId,data);
        }
        function $_exists(uint256 tokenId) external view returns (bool) {
            return super._exists(tokenId);
        }
        function $_isApprovedOrOwner(address spender,uint256 tokenId) external view returns (bool) {
            return super._isApprovedOrOwner(spender,tokenId);
        }
        function $_safeMint(address to,uint256 tokenId) external {
            return super._safeMint(to,tokenId);
        }
        function $_safeMint(address to,uint256 tokenId,bytes calldata data) external {
            return super._safeMint(to,tokenId,data);
        }
        function $_mint(address to,uint256 tokenId) external {
            return super._mint(to,tokenId);
        }
        function $_transfer(address from,address to,uint256 tokenId) external {
            return super._transfer(from,to,tokenId);
        }
        function $_approve(address to,uint256 tokenId) external {
            return super._approve(to,tokenId);
        }
        function $_setApprovalForAll(address owner,address operator,bool approved) external {
            return super._setApprovalForAll(owner,operator,approved);
        }
        function $_requireMinted(uint256 tokenId) external view {
            return super._requireMinted(tokenId);
        }
        function $_beforeTokenTransfer(address from,address to,uint256 tokenId) external {
            return super._beforeTokenTransfer(from,to,tokenId);
        }
        function $_afterTokenTransfer(address from,address to,uint256 tokenId) external {
            return super._afterTokenTransfer(from,to,tokenId);
        }
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $__Context_init() external {
            return super.__Context_init();
        }
        function $__Context_init_unchained() external {
            return super.__Context_init_unchained();
        }
        function $_msgSender() external view returns (address) {
            return super._msgSender();
        }
        function $_msgData() external view returns (bytes memory) {
            return super._msgData();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/roles/AdminRole.sol";
    contract $AdminRole is AdminRole {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        function $_initializeAdminRole(address admin) external {
            return super._initializeAdminRole(admin);
        }
        function $__AccessControl_init() external {
            return super.__AccessControl_init();
        }
        function $__AccessControl_init_unchained() external {
            return super.__AccessControl_init_unchained();
        }
        function $_checkRole(bytes32 role) external view {
            return super._checkRole(role);
        }
        function $_checkRole(bytes32 role,address account) external view {
            return super._checkRole(role,account);
        }
        function $_setupRole(bytes32 role,address account) external {
            return super._setupRole(role,account);
        }
        function $_setRoleAdmin(bytes32 role,bytes32 adminRole) external {
            return super._setRoleAdmin(role,adminRole);
        }
        function $_grantRole(bytes32 role,address account) external {
            return super._grantRole(role,account);
        }
        function $_revokeRole(bytes32 role,address account) external {
            return super._revokeRole(role,account);
        }
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $__Context_init() external {
            return super.__Context_init();
        }
        function $__Context_init_unchained() external {
            return super.__Context_init_unchained();
        }
        function $_msgSender() external view returns (address) {
            return super._msgSender();
        }
        function $_msgData() external view returns (bytes memory) {
            return super._msgData();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/roles/MinterRole.sol";
    contract $MinterRole is MinterRole {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor() {}
        function $_initializeMinterRole(address minter) external {
            return super._initializeMinterRole(minter);
        }
        function $_initializeAdminRole(address admin) external {
            return super._initializeAdminRole(admin);
        }
        function $__AccessControl_init() external {
            return super.__AccessControl_init();
        }
        function $__AccessControl_init_unchained() external {
            return super.__AccessControl_init_unchained();
        }
        function $_checkRole(bytes32 role) external view {
            return super._checkRole(role);
        }
        function $_checkRole(bytes32 role,address account) external view {
            return super._checkRole(role,account);
        }
        function $_setupRole(bytes32 role,address account) external {
            return super._setupRole(role,account);
        }
        function $_setRoleAdmin(bytes32 role,bytes32 adminRole) external {
            return super._setRoleAdmin(role,adminRole);
        }
        function $_grantRole(bytes32 role,address account) external {
            return super._grantRole(role,account);
        }
        function $_revokeRole(bytes32 role,address account) external {
            return super._revokeRole(role,account);
        }
        function $__ERC165_init() external {
            return super.__ERC165_init();
        }
        function $__ERC165_init_unchained() external {
            return super.__ERC165_init_unchained();
        }
        function $__Context_init() external {
            return super.__Context_init();
        }
        function $__Context_init_unchained() external {
            return super.__Context_init_unchained();
        }
        function $_msgSender() external view returns (address) {
            return super._msgSender();
        }
        function $_msgData() external view returns (bytes memory) {
            return super._msgData();
        }
        function $_disableInitializers() external {
            return super._disableInitializers();
        }
        receive() external payable {}
    }
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/shared/Constants.sol";
    // SPDX-License-Identifier: UNLICENSED
    pragma solidity >=0.6.0;
    import "../../../contracts/mixins/shared/ContractFactory.sol";
    contract $ContractFactory is ContractFactory {
        bytes32 public __hh_exposed_bytecode_marker = "hardhat-exposed";
        constructor(address _contractFactory) ContractFactory(_contractFactory) {}
        receive() external payable {}
    }