creation_sourcecode: //SPDX-License-Identifier: Unlicensed
  
  pragma solidity ^0.8.19;
  
  
  /**
   * @dev String operations.
   */
  library Strings {
      bytes16 private constant _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) {
          unchecked {
              uint256 length = log10(value) + 1;
              string memory buffer = new string(length);
              uint256 ptr;
              /// @solidity memory-safe-assembly
              assembly {
                  ptr := add(buffer, add(32, length))
              }
              while (true) {
                  ptr--;
                  /// @solidity memory-safe-assembly
                  assembly {
                      mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                  }
                  value /= 10;
                  if (value == 0) break;
              }
              return buffer;
          }
      }
  
     /**
       * @dev Return the log in base 10, rounded down, of a positive value.
       * Returns 0 if given 0.
       */
      function log10(uint256 value) internal pure returns (uint256) {
          uint256 result = 0;
          unchecked {
              if (value >= 10 ** 64) {
                  value /= 10 ** 64;
                  result += 64;
              }
              if (value >= 10 ** 32) {
                  value /= 10 ** 32;
                  result += 32;
              }
              if (value >= 10 ** 16) {
                  value /= 10 ** 16;
                  result += 16;
              }
              if (value >= 10 ** 8) {
                  value /= 10 ** 8;
                  result += 8;
              }
              if (value >= 10 ** 4) {
                  value /= 10 ** 4;
                  result += 4;
              }
              if (value >= 10 ** 2) {
                  value /= 10 ** 2;
                  result += 2;
              }
              if (value >= 10 ** 1) {
                  result += 1;
              }
          }
          return result;
      }
  
  }
  
  pragma solidity ^0.8.19;
  
  /**
   * @dev Interface of the ERC165 standard, as defined in the
   * https://eips.ethereum.org/EIPS/eip-165[EIP].
   *
   * Implementers can declare support of contract interfaces, which can then be
   * queried by others ({ERC165Checker}).
   *
   * For an implementation, see {ERC165}.
   */
  interface IERC165 {
      /**
       * @dev Returns true if this contract implements the interface defined by
       * `interfaceId`. See the corresponding
       * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
       * to learn more about how these ids are created.
       *
       * This function call must use less than 30 000 gas.
       */
      function supportsInterface(bytes4 interfaceId) external view returns (bool);
  }
  
  /**
   * @dev Implementation of the {IERC165} interface.
   *
   * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
   * for the additional interface id that will be supported. For example:
   *
   * ```solidity
   * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
   *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
   * }
   * ```
   *
   * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
   */
  abstract contract ERC165 is IERC165 {
      /**
       * @dev See {IERC165-supportsInterface}.
       */
      function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
          return interfaceId == type(IERC165).interfaceId;
      }
  }
  
  pragma solidity ^0.8.19;
  
  /**
   * @dev Provides information about the current execution context, including the
   * sender of the transaction and its data. While these are generally available
   * via msg.sender and msg.data, they should not be accessed in such a direct
   * manner, since when dealing with meta-transactions the account sending and
   * paying for execution may not be the actual sender (as far as an application
   * is concerned).
   *
   * This contract is only required for intermediate, library-like contracts.
   */
  abstract contract Context {
      function _msgSender() internal view virtual returns (address) {
          return msg.sender;
      }
  
      function _msgData() internal view virtual returns (bytes calldata) {
          return msg.data;
      }
  
      function _contextSuffixLength() internal view virtual returns (uint256) {
          return 0;
      }
  }
  
  pragma solidity ^0.8.19;
  
  /**
   * @dev Collection of functions related to the address type
   */
  library Address {
      /**
       * @dev Returns true if `account` is a contract.
       *
       * [IMPORTANT]
       * ====
       * It is unsafe to assume that an address for which this function returns
       * false is an externally-owned account (EOA) and not a contract.
       *
       * Among others, `isContract` will return false for the following
       * types of addresses:
       *
       *  - an externally-owned account
       *  - a contract in construction
       *  - an address where a contract will be created
       *  - an address where a contract lived, but was destroyed
       *
       * Furthermore, `isContract` will also return true if the target contract within
       * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
       * which only has an effect at the end of a transaction.
       * ====
       *
       * [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://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
       *
       * IMPORTANT: because control is transferred to `recipient`, care must be
       * taken to not create reentrancy vulnerabilities. Consider using
       * {ReentrancyGuard} or the
       * https://solidity.readthedocs.io/en/v0.8.0/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, "balance");
  
          (bool success, ) = recipient.call{value: amount}("");
          require(success, "unable to send, recipient 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 functionCallWithValue(target, data, 0, "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, "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, "insufficient balance");
          (bool success, bytes memory returndata) = target.call{value: value}(data);
          return verifyCallResultFromTarget(target, 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, "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) {
          (bool success, bytes memory returndata) = target.staticcall(data);
          return verifyCallResultFromTarget(target, success, returndata, errorMessage);
      }
  
      /**
       * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
       * but performing a delegate call.
       *
       * _Available since v3.4._
       */
      function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
          return functionDelegateCall(target, data, "delegate failed");
      }
  
      /**
       * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
       * but performing a delegate call.
       *
       * _Available since v3.4._
       */
      function functionDelegateCall(
          address target,
          bytes memory data,
          string memory errorMessage
      ) internal returns (bytes memory) {
          (bool success, bytes memory returndata) = target.delegatecall(data);
          return verifyCallResultFromTarget(target, success, returndata, errorMessage);
      }
  
      /**
       * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
       * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
       *
       * _Available since v4.8._
       */
      function verifyCallResultFromTarget(
          address target,
          bool success,
          bytes memory returndata,
          string memory errorMessage
      ) internal view returns (bytes memory) {
          if (success) {
              if (returndata.length == 0) {
                  // only check isContract if the call was successful and the return data is empty
                  // otherwise we already know that it was a contract
                  require(isContract(target), "call to non-contract");
              }
              return returndata;
          } else {
              _revert(returndata, errorMessage);
          }
      }
  
      /**
       * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
       * revert reason or 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 {
              _revert(returndata, errorMessage);
          }
      }
  
      function _revert(bytes memory returndata, string memory errorMessage) private pure {
          // Look for revert reason and bubble it up if present
          if (returndata.length > 0) {
              // The easiest way to bubble the revert reason is using memory via assembly
              /// @solidity memory-safe-assembly
              assembly {
                  let returndata_size := mload(returndata)
                  revert(add(32, returndata), returndata_size)
              }
          } else {
              revert(errorMessage);
          }
      }
  }
  
  pragma solidity ^0.8.19;
  
  /**
   * @title ERC721 token receiver interface
   * @dev Interface for any contract that wants to support safeTransfers
   * from ERC721 asset contracts.
   */
  interface IERC721Receiver {
      /**
       * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
       * by `operator` from `from`, this function is called.
       *
       * It must return its Solidity selector to confirm the token transfer.
       * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
       *
       * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
       */
      function onERC721Received(
          address operator,
          address from,
          uint256 tokenId,
          bytes calldata data
      ) external returns (bytes4);
  }
  
  pragma solidity ^0.8.19;
  
  
  /**
   * @dev Required interface of an ERC721 compliant contract.
   */
  interface IERC721 is IERC165 {
      /**
       * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
       */
      event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
  
      /**
       * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
       */
      event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
  
      /**
       * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
       */
      event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
  
      /**
       * @dev Returns the number of tokens in ``owner``'s account.
       */
      function balanceOf(address owner) external view returns (uint256 balance);
  
      /**
       * @dev Returns the owner of the `tokenId` token.
       *
       * Requirements:
       *
       * - `tokenId` must exist.
       */
      function ownerOf(uint256 tokenId) external view returns (address owner);
  
      /**
       * @dev Safely transfers `tokenId` token from `from` to `to`.
       *
       * Requirements:
       *
       * - `from` cannot be the zero address.
       * - `to` cannot be the zero address.
       * - `tokenId` token must exist and be owned by `from`.
       * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
       * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
       *
       * Emits a {Transfer} event.
       */
      function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
  
      /**
       * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
       * are aware of the ERC721 protocol to prevent tokens from being forever locked.
       *
       * Requirements:
       *
       * - `from` cannot be the zero address.
       * - `to` cannot be the zero address.
       * - `tokenId` token must exist and be owned by `from`.
       * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
       * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
       *
       * Emits a {Transfer} event.
       */
      function safeTransferFrom(address from, address to, uint256 tokenId) external;
  
      /**
       * @dev Transfers `tokenId` token from `from` to `to`.
       *
       * WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
       * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
       * understand this adds an external call which potentially creates a reentrancy vulnerability.
       *
       * Requirements:
       *
       * - `from` cannot be the zero address.
       * - `to` cannot be the zero address.
       * - `tokenId` token must be owned by `from`.
       * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
       *
       * Emits a {Transfer} event.
       */
      function transferFrom(address from, address to, uint256 tokenId) external;
  
      /**
       * @dev Gives permission to `to` to transfer `tokenId` token to another account.
       * The approval is cleared when the token is transferred.
       *
       * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
       *
       * Requirements:
       *
       * - The caller must own the token or be an approved operator.
       * - `tokenId` must exist.
       *
       * Emits an {Approval} event.
       */
      function approve(address to, uint256 tokenId) external;
  
      /**
       * @dev Approve or remove `operator` as an operator for the caller.
       * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
       *
       * Requirements:
       *
       * - The `operator` cannot be the 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);
  }
  
  /**
   * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
   * @dev See https://eips.ethereum.org/EIPS/eip-721
   */
  interface IERC721Metadata is IERC721 {
      /**
       * @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);
  }
  
  pragma solidity ^0.8.19;
  
  
  /// @title EIP-721 Metadata Update Extension
  interface IERC4906 is IERC165, IERC721 {
      /// @dev This event emits when the metadata of a token is changed.
      /// So that the third-party platforms such as NFT market could
      /// timely update the images and related attributes of the NFT.
      event MetadataUpdate(uint256 _tokenId);
  
      /// @dev This event emits when the metadata of a range of tokens is changed.
      /// So that the third-party platforms such as NFT market could
      /// timely update the images and related attributes of the NFTs.
      event BatchMetadataUpdate(uint256 _fromTokenId, uint256 _toTokenId);
  }
  
  
  
  /**
   * @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 ERC721 is Context, ERC165, IERC721, IERC721Metadata {
      using Address for address;
      using Strings 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.
       */
      constructor(string memory name_, string memory symbol_) {
          _name = name_;
          _symbol = symbol_;
      }
  
      /**
       * @dev See {IERC165-supportsInterface}.
       */
      function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
          return
              interfaceId == type(IERC721).interfaceId ||
              interfaceId == type(IERC721Metadata).interfaceId ||
              super.supportsInterface(interfaceId);
      }
  
      /**
       * @dev See {IERC721-balanceOf}.
       */
      function balanceOf(address owner) public view virtual override returns (uint256) {
          require(owner != address(0));
          return _balances[owner];
      }
  
      /**
       * @dev See {IERC721-ownerOf}.
       */
      function ownerOf(uint256 tokenId) public view virtual override returns (address) {
          address owner = _ownerOf(tokenId);
          require(owner != address(0));
          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 = ERC721.ownerOf(tokenId);
          require(to != owner);
  
          require(
              _msgSender() == owner || isApprovedForAll(owner, _msgSender())
          );
  
          _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));
  
          _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));
          _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));
      }
  
      /**
       * @dev Returns the owner of the `tokenId`. Does NOT revert if token doesn't exist
       */
      function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
          return _owners[tokenId];
      }
  
      /**
       * @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 _ownerOf(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 = ERC721.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)
          );
      }
  
      /**
       * @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), "bad address");
          require(!_exists(tokenId), "exists");
  
          _beforeTokenTransfer(address(0), to, tokenId, 1);
  
          // Check that tokenId was not minted by `_beforeTokenTransfer` hook
          require(!_exists(tokenId), "3");
  
          unchecked {
              // Will not overflow unless all 2**256 token ids are minted to the same owner.
              // Given that tokens are minted one by one, it is impossible in practice that
              // this ever happens. Might change if we allow batch minting.
              // The ERC fails to describe this case.
              _balances[to] += 1;
          }
  
          _owners[tokenId] = to;
  
          emit Transfer(address(0), to, tokenId);
  
          _afterTokenTransfer(address(0), to, tokenId, 1);
      }
  
      /**
       * @dev Destroys `tokenId`.
       * The approval is cleared when the token is burned.
       * This is an internal function that does not check if the sender is authorized to operate on the token.
       *
       * Requirements:
       *
       * - `tokenId` must exist.
       *
       * Emits a {Transfer} event.
       */
      function _burn(uint256 tokenId) internal virtual {
          address owner = ERC721.ownerOf(tokenId);
  
          _beforeTokenTransfer(owner, address(0), tokenId, 1);
  
          // Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
          owner = ERC721.ownerOf(tokenId);
  
          // Clear approvals
          delete _tokenApprovals[tokenId];
  
          unchecked {
              // Cannot overflow, as that would require more tokens to be burned/transferred
              // out than the owner initially received through minting and transferring in.
              _balances[owner] -= 1;
          }
          delete _owners[tokenId];
  
          emit Transfer(owner, address(0), tokenId);
  
          _afterTokenTransfer(owner, address(0), tokenId, 1);
      }
  
      /**
       * @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(ERC721.ownerOf(tokenId) == from);
          require(to != address(0));
  
          _beforeTokenTransfer(from, to, tokenId, 1);
  
          // Check that tokenId was not transferred by `_beforeTokenTransfer` hook
          require(ERC721.ownerOf(tokenId) == from);
  
          // Clear approvals from the previous owner
          delete _tokenApprovals[tokenId];
  
          unchecked {
              // `_balances[from]` cannot overflow for the same reason as described in `_burn`:
              // `from`'s balance is the number of token held, which is at least one before the current
              // transfer.
              // `_balances[to]` could overflow in the conditions described in `_mint`. That would require
              // all 2**256 token ids to be minted, which in practice is impossible.
              _balances[from] -= 1;
              _balances[to] += 1;
          }
          _owners[tokenId] = to;
  
          emit Transfer(from, to, tokenId);
  
          _afterTokenTransfer(from, to, tokenId, 1);
      }
  
      /**
       * @dev Approve `to` to operate on `tokenId`
       *
       * Emits an {Approval} event.
       */
      function _approve(address to, uint256 tokenId) internal virtual {
          _tokenApprovals[tokenId] = to;
          emit Approval(ERC721.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);
          _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));
      }
  
      /**
       * @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 IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
                  return retval == IERC721Receiver.onERC721Received.selector;
              } catch (bytes memory reason) {
                  if (reason.length == 0) {
                      revert("non ERC721 recv impl");
                  } 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. If {ERC721Consecutive} is
       * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
       *
       * Calling conditions:
       *
       * - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
       * - When `from` is zero, the tokens will be minted for `to`.
       * - When `to` is zero, ``from``'s tokens will be burned.
       * - `from` and `to` are never both zero.
       * - `batchSize` is non-zero.
       *
       * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
       */
      function _beforeTokenTransfer(address from, address to, uint256 firstTokenId, uint256 batchSize) internal virtual {}
  
      /**
       * @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
       * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
       *
       * Calling conditions:
       *
       * - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
       * - When `from` is zero, the tokens were minted for `to`.
       * - When `to` is zero, ``from``'s tokens were burned.
       * - `from` and `to` are never both zero.
       * - `batchSize` is non-zero.
       *
       * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
       */
      function _afterTokenTransfer(address from, address to, uint256 firstTokenId, uint256 batchSize) internal virtual {}
  
      /**
       * @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
       *
       * WARNING: Anyone calling this MUST ensure that the balances remain consistent with the ownership. The invariant
       * being that for any address `a` the value returned by `balanceOf(a)` must be equal to the number of tokens such
       * that `ownerOf(tokenId)` is `a`.
       */
      // solhint-disable-next-line func-name-mixedcase
      function __unsafe_increaseBalance(address account, uint256 amount) internal {
          _balances[account] += amount;
      }
  }
  
  pragma solidity ^0.8.19;
  
  
  /**
   * @dev Contract module which provides a basic access control mechanism, where
   * there is an account (an owner) that can be granted exclusive access to
   * specific functions.
   *
   * By default, the owner account will be the one that deploys the contract. This
   * can later be changed with {transferOwnership}.
   *
   * This module is used through inheritance. It will make available the modifier
   * `onlyOwner`, which can be applied to your functions to restrict their use to
   * the owner.
   */
  abstract contract Ownable is Context {
      address private _owner;
  
      event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
  
      /**
       * @dev Initializes the contract setting the deployer as the initial owner.
       */
      constructor() {
          _transferOwnership(_msgSender());
      }
  
      /**
       * @dev Throws if called by any account other than the owner.
       */
      modifier onlyOwner() {
          _checkOwner();
          _;
      }
  
      /**
       * @dev Returns the address of the current owner.
       */
      function owner() public view virtual returns (address) {
          return _owner;
      }
  
      /**
       * @dev Throws if the sender is not the owner.
       */
      function _checkOwner() internal view virtual {
          require(owner() == _msgSender());
      }
  
      /**
       * @dev Leaves the contract without owner. It will not be possible to call
       * `onlyOwner` functions. Can only be called by the current owner.
       *
       * NOTE: Renouncing ownership will leave the contract without an owner,
       * thereby disabling any functionality that is only available to the owner.
       */
      function renounceOwnership() public virtual onlyOwner {
          _transferOwnership(address(0));
      }
  
      /**
       * @dev Transfers ownership of the contract to a new account (`newOwner`).
       * Can only be called by the current owner.
       */
      function transferOwnership(address newOwner) public virtual onlyOwner {
          require(newOwner != address(0));
          _transferOwnership(newOwner);
      }
  
      /**
       * @dev Transfers ownership of the contract to a new account (`newOwner`).
       * Internal function without access restriction.
       */
      function _transferOwnership(address newOwner) internal virtual {
          address oldOwner = _owner;
          _owner = newOwner;
          emit OwnershipTransferred(oldOwner, newOwner);
      }
  }
  
  /**
   * @dev ERC721 token with storage based token URI management.
   */
  abstract contract ERC721URIStorage is IERC4906, ERC721 {
      using Strings for uint256;
  
      // Optional mapping for token URIs
      mapping(uint256 => string) private _tokenURIs;
  
      /**
       * @dev See {IERC165-supportsInterface}
       */
      function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721, IERC165) returns (bool) {
          return interfaceId == bytes4(0x49064906) || super.supportsInterface(interfaceId);
      }
  
      /**
       * @dev See {IERC721Metadata-tokenURI}.
       */
      function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
          _requireMinted(tokenId);
  
          string memory _tokenURI = _tokenURIs[tokenId];
          string memory base = _baseURI();
  
          // If there is no base URI, return the token URI.
          if (bytes(base).length == 0) {
              return _tokenURI;
          }
          // If both are set, concatenate the baseURI and tokenURI (via abi.encodePacked).
          if (bytes(_tokenURI).length > 0) {
              return string(abi.encodePacked(base, _tokenURI));
          }
  
          return super.tokenURI(tokenId);
      }
  
      /**
       * @dev Sets `_tokenURI` as the tokenURI of `tokenId`.
       *
       * Emits {MetadataUpdate}.
       *
       * Requirements:
       *
       * - `tokenId` must exist.
       */
      function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {
          require(_exists(tokenId));
          _tokenURIs[tokenId] = _tokenURI;
  
          emit MetadataUpdate(tokenId);
      }
  
      /**
       * @dev See {ERC721-_burn}. This override additionally checks to see if a
       * token-specific URI was set for the token, and if so, it deletes the token URI from
       * the storage mapping.
       */
      function _burn(uint256 tokenId) internal virtual override {
          super._burn(tokenId);
  
          if (bytes(_tokenURIs[tokenId]).length != 0) {
              delete _tokenURIs[tokenId];
          }
      }
  }
  
  interface IERC20 {
  
      function totalSupply() external view returns (uint256);
  
      /**
       * @dev Returns the amount of tokens owned by `account`.
       */
      function balanceOf(address account) external view returns (uint256);
  
      /**
       * @dev Moves `amount` tokens from the caller's account to `recipient`.
       *
       * Returns a boolean value indicating whether the operation succeeded.
       *
       * Emits a {Transfer} event.
       */
      function transfer(address recipient, uint256 amount) external returns (bool);
  
      /**
       * @dev Returns the remaining number of tokens that `spender` will be
       * allowed to spend on behalf of `owner` through {transferFrom}. This is
       * zero by default.
       *
       * This value changes when {approve} or {transferFrom} are called.
       */
      function allowance(address owner, address spender) external view returns (uint256);
  
      /**
       * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
       *
       * Returns a boolean value indicating whether the operation succeeded.
       *
       * IMPORTANT: Beware that changing an allowance with this method brings the risk
       * that someone may use both the old and the new allowance by unfortunate
       * transaction ordering. One possible solution to mitigate this race
       * condition is to first reduce the spender's allowance to 0 and set the
       * desired value afterwards:
       * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
       *
       * Emits an {Approval} event.
       */
      function approve(address spender, uint256 amount) external returns (bool);
  
      /**
       * @dev Moves `amount` tokens from `sender` to `recipient` using the
       * allowance mechanism. `amount` is then deducted from the caller's
       * allowance.
       *
       * Returns a boolean value indicating whether the operation succeeded.
       *
       * Emits a {Transfer} event.
       */
      function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
  
      /**
       * @dev Emitted when `value` tokens are moved from one account (`from`) to
       * another (`to`).
       *
       * Note that `value` may be zero.
       */
      event Transfer(address indexed from, address indexed to, uint256 value);
  
      /**
       * @dev Emitted when the allowance of a `spender` for an `owner` is set by
       * a call to {approve}. `value` is the new allowance.
       */
      event Approval(address indexed owner, address indexed spender, uint256 value);
  }
  
  pragma solidity ^0.8.19;
  
  contract RabbitNFT is ERC721URIStorage, Ownable {
  
      string public tokenName;
      string public tokenSymbol;
      string public baseTokenURI;
      mapping(address => bool) public isMinter;
  
      uint256 public totalSupply;
      uint256 public MAX_SUPPLY = ~uint256(0);
      uint256 public releaseDate;
  
      // User can lock assets
      mapping(address => bool) public locked; 
  
      // Initialize the contract with endpoint
      constructor( 
          string memory _name,
          string memory _symbol,
          string memory _baseUri,
          address _owner,
          address _lootboxAddress
      ) ERC721(_name, _symbol) {
          tokenName = _name;
          tokenSymbol = _symbol;
          baseTokenURI = _baseUri;
         
          isMinter[_lootboxAddress] = true;
  
           transferOwnership(_owner);
      }
  
      function setMaxSupply(uint256 max) external onlyOwner {
          require( MAX_SUPPLY == ~uint256(0) , "already set");
          require( max >= totalSupply, "MAX_SUPPLY" );
          MAX_SUPPLY = max;
      }
  
      function setReleaseDate(uint256 timestamp) external onlyOwner {
          require( timestamp > block.timestamp , "not in the future");
          require( timestamp < (block.timestamp + 180 days), "too far in the future" );
          releaseDate = timestamp;
      }
  
      function _baseURI() internal view override returns (string memory) {
          return baseTokenURI;
      }
  
      function setBaseURI(string memory baseURI) external onlyOwner {
          baseTokenURI = baseURI;
      }
  
      function setTokenURI(uint256 tokenId, string memory _tokenURI) external onlyMinter {
          _setTokenURI(tokenId, _tokenURI);
      }
  
      // Update user minter status
      function setMinter(address _minter, bool _status) external onlyOwner {
          isMinter[_minter] = _status;
      }
  
      // Set token name and symbol
      function setToken(string memory _tokenName, string memory _tokenSymbol) external onlyOwner {
          tokenName = _tokenName;
          tokenSymbol = _tokenSymbol;
      }
  
      // Mint NFT
      function mint(
          address to,
          uint256 id
      ) external onlyMinter {
  
          require(totalSupply < MAX_SUPPLY, "MAX_SUPPLY");
          require(block.timestamp > releaseDate, "before");
          
          _mint(to, id);
  
          totalSupply ++;
      }
  
      // Batch mint NFTs
      function mintBatch(
          address to,
          uint256[] memory ids
      ) external onlyMinter {
          uint256 N = ids.length;
  
          require((totalSupply + N) <= MAX_SUPPLY, "MAX_SUPPLY");
          require(block.timestamp > releaseDate, "before");
          
          for (uint256 i; i < N; ++i) {
              _mint(to, ids[i]);
          }
          totalSupply += N;
      }
  
      // Burn NFT
      function burn(uint256 id) external {
          require(ownerOf(id) == msg.sender, "not owner");
  
          _burn(id);
  
          totalSupply --;
      }
  
      // Batch burn NFTs
      function burnBatch(uint256[] memory ids) external {   
          uint256 N = ids.length;
          require(totalSupply + N <= MAX_SUPPLY, "MAX_SUPPLY");
  
          for (uint256 i; i < N; ++i) {
              require(ownerOf(ids[i]) == msg.sender, "not owner");
              _burn(ids[i]);
          }
          totalSupply -= N;
      }
  
      modifier onlyMinter() {
          require(
              isMinter[msg.sender],
              "only minter"
           );
          _;
      }
  
      // Not allowed to transfer NFT to contract address
      // Do not transfer if user locked NFT
      function _beforeTokenTransfer(
          address from,
          address to,
          uint256 tokenId,
          uint256 batchSize
      ) internal virtual override {
          super._beforeTokenTransfer(from, to, tokenId, batchSize);
  
          require( !locked[from], "LOCKED" );
          require(to != address(this), "not allowed");
      }
  
      // User can lock transfer of NFT
      function lockTransfer() external {
          locked[ msg.sender ] = true;
      }
  
      // User can unlock transfer of NFT
      function unlockTransfer() external {
          locked[msg.sender ] = false;
      }
  
      // Recover ETH sent by mistake
      function rescueETH() external onlyOwner {
          payable( msg.sender ).transfer( address(this).balance );
      }
  
      // Recover ERC20 tokens sent by mistake
      function rescueERC20(address tokenAddress) external onlyOwner {
          IERC20 token = IERC20(tokenAddress);
          uint256 amount = token.balanceOf(address(this));
          require(amount > 0);
  
          bool success = token.transfer(msg.sender, amount);
          require(success);
      }
      
      // Recover NFT sent by mistake
      function recoverNFT(address nftContract, address to, uint256 tokenId) external onlyOwner {
          require(nftContract != address(0), "bad address");
  
          IERC721 nft = IERC721(nftContract);
          require(nft.ownerOf(tokenId) == address(this), "not owner");
  
          nft.safeTransferFrom(address(this), to, tokenId);
      }
  }