ETH Price: $2,430.80 (+0.36%)
Gas: 3.05 Gwei

Transaction Decoder

Block:
15057649 at Jul-01-2022 04:27:51 PM +UTC
Transaction Fee:
0.003900621712292337 ETH $9.48
Gas Used:
116,313 Gas / 33.535561049 Gwei

Emitted Events:

361 TheBeginningOfTheEnd.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x0000000000000000000000000000000000000000000000000000000000000000, 0x0000000000000000000000004bdd1d843965a0d670e01eeb9fa493db87532c46, 0x00000000000000000000000000000000000000000000000000000000000002c4 )

Account State Difference:

  Address   Before After State Difference Code
0x4BdD1d84...b87532C46
0.169910152895872357 Eth
Nonce: 111
0.16600953118358002 Eth
Nonce: 112
0.003900621712292337
0x7164d7Aa...Ce45d688D
(Ethermine)
1,111.316060938106032748 Eth1,111.316235407606032748 Eth0.0001744695

Execution Trace

TheBeginningOfTheEnd.mint( count=1 )
  • TheBeginningOfTheEnd.3dc8ded7( )
    • ERC721Base.__mint( to=0x4BdD1d843965a0d670e01eEB9Fa493db87532C46, tokenId=708 )
      File 1 of 2: TheBeginningOfTheEnd
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.9;
      import {ConfigSettings} from "gwei-slim-nft-contracts/contracts/base/ERC721Base.sol";
      import {ERC721Delegated} from "gwei-slim-nft-contracts/contracts/base/ERC721Delegated.sol";
      import "@openzeppelin/contracts/security/ReentrancyGuard.sol";
      import "@openzeppelin/contracts/utils/Counters.sol";
      import "@openzeppelin/contracts/utils/Address.sol";
      contract TheBeginningOfTheEnd is ERC721Delegated, ReentrancyGuard {
        using Counters for Counters.Counter;
        constructor(address baseFactory, string memory customBaseURI_)
          ERC721Delegated(
            baseFactory,
            "The Beginning Of The End",
            "TBoTE",
            ConfigSettings({
              royaltyBps: 650,
              uriBase: customBaseURI_,
              uriExtension: "",
              hasTransferHook: false
            })
          )
        {
          allowedMintCountMap[msg.sender] = 33;
          allowedMintCountMap[0xdf9e6a194F3d4DC2571158F4bA7CFA9696AA9274] = 3;
          allowedMintCountMap[0x6Fc5891d3daF91555f7b9C70eB9657A4dF59176f] = 3;
          allowedMintCountMap[0x7f5afC67d4C3AE0182354ea6e785FdEb20150f15] = 3;
          allowedMintCountMap[0x85cA7d812127677FFE9B5672DA40459348a8FF85] = 3;
          allowedMintCountMap[0x2EE54D8eB4F898c285b9fce4320D0bA6725E1704] = 3;
          allowedMintCountMap[0x8E74351b6C91e729395560438f6c85a16dD4cce4] = 3;
          allowedMintCountMap[0xECe055ea28bE3c1D9b08B8883b52700fFFaae20c] = 3;
          allowedMintCountMap[0xe6d6c64a981385f2e93196833a162655d6F8a8Fb] = 3;
          allowedMintCountMap[0xB58D73997C1CA0E1812c60A7eC69683eEFc098B8] = 3;
          allowedMintCountMap[0x4e07751EA822dBc8c71B1aC89e971Ed88a089b3f] = 3;
          allowedMintCountMap[0xCe6DB393C736A65e0B21d10A92B97418ABd0a2dE] = 3;
          allowedMintCountMap[0xD8f2c8dE147EdE45D00c1f1ba529Db5486F8b922] = 3;
          allowedMintCountMap[0xA7D775FB03F699bEAbbdc18FF97D1385feeB3EB9] = 3;
          allowedMintCountMap[0x819Aa1675c4baBa624A5E061F4F4cE05095A4AC2] = 3;
          allowedMintCountMap[0x7c192a1fF95c3254abc1B34B493E2fFCCdF3836F] = 3;
          allowedMintCountMap[0x85eEFFB8e62a2F196BDe282621368eb6839C6109] = 3;
          allowedMintCountMap[0x78161b0c34DA8bBf88DC73bC214d37616A927ae7] = 3;
          allowedMintCountMap[0xE0C9B6BeD7ecA8F9bCAaeC1763f73606967283c8] = 3;
          allowedMintCountMap[0xd17f430E0B973218576a37cc447F5910ED1BE9FE] = 3;
          allowedMintCountMap[0x9B5F74C8c979F3F34fc1aF43242FDf1683070D0D] = 3;
          allowedMintCountMap[0x85026596042Cf8CAB1b521bCca86C56cf2D2ecAe] = 2;
          allowedMintCountMap[0x580b1E94Dad298f5CD32E3C38B9faf4a25c08Ea4] = 2;
          allowedMintCountMap[0x91c2edF643304e983e35e572898B014AB0E7e64E] = 2;
          allowedMintCountMap[0x8A0ba5E4063C1FFA294FA6Bd9dE937f1B5BD4600] = 2;
          allowedMintCountMap[0x63C242920eD0e137cC7cBc6D2cDB5B1fccD050cE] = 2;
          allowedMintCountMap[0xfcfF7E05177619e187e337C5210685f06F725d13] = 2;
          allowedMintCountMap[0x324825B5B28b056d32757f0877411cb031810Ca9] = 2;
          allowedMintCountMap[0x28156730f1F2f588fcc3e9ED2f5793CAD354282c] = 2;
          allowedMintCountMap[0x3e051B18A633A48998CB1656817cA74DEbF37fab] = 2;
          allowedMintCountMap[0xf148d310ee342cd1A8ac15AFCF75BA7a7F6CB9Fb] = 2;
          allowedMintCountMap[0x53c68d3F629B53c27Cd658D41dC836F38603eD0c] = 2;
          allowedMintCountMap[0xD50a89b8f99EAFd815E1F552522632e673d1f73a] = 2;
          allowedMintCountMap[0x0e4230c3cbAFbACa98E1419721deC3D108767B72] = 2;
          allowedMintCountMap[0x91fe628414A41074Eb841da04B4D6992cF5f90e5] = 2;
          allowedMintCountMap[0x974Ab44B53a46875e4Cf0471FAEBF35b2F9d8561] = 2;
          allowedMintCountMap[0x199e024CD5eBB205c7A2EEBE4eBB33630D7b1d35] = 2;
          allowedMintCountMap[0xa0E84D22d5429C4E55d086F47D1BAb006E5ADEBB] = 2;
          allowedMintCountMap[0x4D2b5A91e41c933c190aaAbDa54B2Ed8765AEfAC] = 2;
          allowedMintCountMap[0xE436BeA44E9734220509E3d1fd501443eBFb2A7C] = 2;
          allowedMintCountMap[0x2C1C90B44Bf1f40A851B04146A358B053A74F067] = 2;
          allowedMintCountMap[0x20bE3D159eD81Ed9fa73432414Ea0460D1Ba94a5] = 2;
          allowedMintCountMap[0xA14626C73A39F4Ab461D3afAeCC3A4A8B2Aa6367] = 2;
          allowedMintCountMap[0xE1F0D43469492FcAc3eF69D8732bDBa1e65fcD63] = 2;
          allowedMintCountMap[0xAdBA3C3e04F77123e00cAB16FD1b9cD3cCCAB4aC] = 2;
          allowedMintCountMap[0x80f6391F15D77fD4051685121ea3BcC2cEc8959c] = 2;
          allowedMintCountMap[0x3d4c0f2f46b7c16117D1184Ed2B1878293614a86] = 2;
          allowedMintCountMap[0x060233eB6867f329C57586d9Be5BD918Ad06adF2] = 2;
          allowedMintCountMap[0xdf6B4D90860a0579d55737824Ce6f5aF7d378b7a] = 2;
          allowedMintCountMap[0x050f5Fb2314242c2560305574A35439aA006e0B6] = 2;
          allowedMintCountMap[0x3aAAE5C3c0f1F3b239cb6a5F02e105674De13bB2] = 2;
          allowedMintCountMap[0xFc2cEfF32e3a534b78C729fD23973CB9ce98FBAC] = 2;
          allowedMintCountMap[0xB67710d029B2A702d54E0F41BB5dC2ADd72C5DfF] = 2;
          allowedMintCountMap[0xa2DA32691EE54f3089d8328039Da3bFBa71f31A1] = 2;
          allowedMintCountMap[0xe4F93B524b742A6A76882C94D66F9d4f4B0583C5] = 2;
          allowedMintCountMap[0xf7f532af44b7DCd017f107EA7cc19F87f40c69e9] = 2;
          allowedMintCountMap[0x2DeD7A9a7C6aa52540E556c9660D505da0b10203] = 2;
          allowedMintCountMap[0x401B185d9a57a34e7888f6363AFf4B54E535A872] = 2;
          allowedMintCountMap[0xF338aE28794bc7a79c94Daaa8657aaC3CA65768b] = 2;
          allowedMintCountMap[0xC489042128d3ba383BcE79eaEef1dc69EfC40416] = 2;
          allowedMintCountMap[0xae68a4AB5228229391225283c899E88E4741c62A] = 2;
          allowedMintCountMap[0xEc44d23f2f2e1fB07d8B38207470Cf9d841e247D] = 2;
          allowedMintCountMap[0xf1d23725a29f80d6996b435D78b21596435B6c54] = 2;
          allowedMintCountMap[0xB6c64C6Ab138CF4439754566faA15E9c796f2B3b] = 2;
          allowedMintCountMap[0xc3E10c4b00D393F515B391b69504b76a219b2132] = 2;
          allowedMintCountMap[0xDfb5e6170eA423c4EF32bf49907B884e8Cb9dCed] = 2;
          allowedMintCountMap[0xA54cE875d138260315359b35a252303E75317efe] = 2;
          allowedMintCountMap[0x914d1eb2E0d63c29CF8df21830f1CabB9F53B377] = 2;
          allowedMintCountMap[0x7Fe178A16dC4b2EeCB34B860AB501a8AE017a729] = 2;
          allowedMintCountMap[0x8a622Bc901de1fa2384d42FFA79606e446eD788F] = 2;
          allowedMintCountMap[0x44B2945F9EC50ad1562c28CB7dF2077fC09F1427] = 2;
          allowedMintCountMap[0x68Db5E9B182Af5AffEfDBe102dEd829C018328f6] = 2;
          allowedMintCountMap[0xb5619Ba9D7f67254e4C53c8bE903d951B551C9a5] = 2;
          allowedMintCountMap[0x15B985DC531593b65d219C4f6947369345D713A0] = 2;
          allowedMintCountMap[0xD4BBe225b6A92cdadC69301Dd54C1Cf0E437B659] = 2;
          allowedMintCountMap[0x36c1238af9cd4D640e6c5D4184Fc88A2117265F3] = 2;
          allowedMintCountMap[0xe969C2dA5940eafe62e416983366A14F16B35FAe] = 2;
          allowedMintCountMap[0x0b8242F72ccf49E4C47C74d784fDd68e7bfdd62D] = 2;
          allowedMintCountMap[0x37328808192d370203F8dD85F7663C2E7FCd856f] = 2;
          allowedMintCountMap[0xe9F755Eba18CE85CAe770e0F4Ec0EC948c8d9779] = 2;
          allowedMintCountMap[0x8453B32B87e33ffE570Be91f1Ad1181F7037e0cf] = 2;
          allowedMintCountMap[0xAa73537FD1E34cd9E6bfD04270f9A0F160C39069] = 2;
          allowedMintCountMap[0xC7d21a6a1174fd3fa1E24b1BF2CfA1eE7b7FAa40] = 2;
          allowedMintCountMap[0xBe327B8AD8AEb1374962652b8B1B2465A0c234cA] = 2;
        }
        /** MINTING LIMITS **/
        mapping(address => uint256) private mintCountMap;
        mapping(address => uint256) private allowedMintCountMap;
        uint256 public constant MINT_LIMIT_PER_WALLET = 1;
        function max(uint256 a, uint256 b) private pure returns (uint256) {
          return a >= b ? a : b;
        }
        function allowedMintCount(address minter) public view returns (uint256) {
          if (saleIsActive) {
            return (
              max(allowedMintCountMap[minter], MINT_LIMIT_PER_WALLET) -
              mintCountMap[minter]
            );
          }
          return allowedMintCountMap[minter] - mintCountMap[minter];
        }
        function updateMintCount(address minter, uint256 count) private {
          mintCountMap[minter] += count;
        }
        /** MINTING **/
        uint256 public constant MAX_SUPPLY = 3333;
        uint256 public constant MAX_MULTIMINT = 3;
        Counters.Counter private supplyCounter;
        function mint(uint256 count) public nonReentrant {
          if (allowedMintCount(msg.sender) >= count) {
            updateMintCount(msg.sender, count);
          } else {
            revert(saleIsActive ? "Minting limit exceeded" : "Sale not active");
          }
          require(totalSupply() + count - 1 < MAX_SUPPLY, "Exceeds max supply");
          require(count <= MAX_MULTIMINT, "Mint at most 3 at a time");
          for (uint256 i = 0; i < count; i++) {
            _mint(msg.sender, totalSupply());
            supplyCounter.increment();
          }
        }
        function totalSupply() public view returns (uint256) {
          return supplyCounter.current();
        }
        /** ACTIVATION **/
        bool public saleIsActive = false;
        function setSaleIsActive(bool saleIsActive_) external onlyOwner {
          saleIsActive = saleIsActive_;
        }
        /** URI HANDLING **/
        function setBaseURI(string memory customBaseURI_) external onlyOwner {
          _setBaseURI(customBaseURI_, "");
        }
        function tokenURI(uint256 tokenId) public view returns (string memory) {
          return string(abi.encodePacked(_tokenURI(tokenId), ".json"));
        }
        /** PAYOUT **/
        function withdraw() public nonReentrant {
          uint256 balance = address(this).balance;
          Address.sendValue(payable(_owner()), balance);
        }
      }
      // Contract created with Studio 721 v1.5.0
      // https://721.so// SPDX-License-Identifier: GPL-3.0
      pragma solidity 0.8.9;
      import {ERC721Upgradeable} from "@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol";
      import {IERC2981Upgradeable, IERC165Upgradeable} from "@openzeppelin/contracts-upgradeable/interfaces/IERC2981Upgradeable.sol";
      import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
      import {StringsUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";
      import {CountersUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/CountersUpgradeable.sol";
      import {IBaseERC721Interface} from "./IBaseERC721Interface.sol";
      struct ConfigSettings {
          uint16 royaltyBps;
          string uriBase;
          string uriExtension;
          bool hasTransferHook;
      }
      /**
          This smart contract adds features and allows for a ownership only by another smart contract as fallback behavior
          while also implementing all normal ERC721 functions as expected
      */
      contract ERC721Base is
          ERC721Upgradeable,
          IBaseERC721Interface,
          IERC2981Upgradeable,
          OwnableUpgradeable
      {
          using CountersUpgradeable for CountersUpgradeable.Counter;
          // Minted counter for totalSupply()
          CountersUpgradeable.Counter private mintedCounter;
          modifier onlyInternal() {
              require(msg.sender == address(this), "Only internal");
              _;
          }
          /// on-chain record of when this contract was deployed
          uint256 public immutable deployedBlock;
          ConfigSettings public advancedConfig;
          /// Constructor called once when the base contract is deployed
          constructor() {
              // Can be used to verify contract implementation is correct at address
              deployedBlock = block.number;
          }
          /// Initializer that's called when a new child nft is setup
          /// @param newOwner Owner for the new derived nft
          /// @param _name name of NFT contract
          /// @param _symbol symbol of NFT contract
          /// @param settings configuration settings for uri, royalty, and hooks features
          function initialize(
              address newOwner,
              string memory _name,
              string memory _symbol,
              ConfigSettings memory settings
          ) public initializer {
              __ERC721_init(_name, _symbol);
              __Ownable_init();
              advancedConfig = settings;
              transferOwnership(newOwner);
          }
          /// Getter to expose appoval status to root contract
          function isApprovedForAll(address _owner, address operator)
              public
              view
              override
              returns (bool)
          {
              return
                  ERC721Upgradeable.isApprovedForAll(_owner, operator) ||
                  operator == address(this);
          }
          /// internal getter for approval by all
          /// When isApprovedForAll is overridden, this can be used to call original impl
          function __isApprovedForAll(address _owner, address operator)
              public
              view
              override
              returns (bool)
          {
              return isApprovedForAll(_owner, operator);
          }
          /// Hook that when enabled manually calls _beforeTokenTransfer on
          function _beforeTokenTransfer(
              address from,
              address to,
              uint256 tokenId
          ) internal override {
              if (advancedConfig.hasTransferHook) {
                  (bool success, ) = address(this).delegatecall(
                      abi.encodeWithSignature(
                          "_beforeTokenTransfer(address,address,uint256)",
                          from,
                          to,
                          tokenId
                      )
                  );
                  // Raise error again from result if error exists
                  assembly {
                      switch success
                      // delegatecall returns 0 on error.
                      case 0 {
                          returndatacopy(0, 0, returndatasize())
                          revert(0, returndatasize())
                      }
                  }
              }
          }
          /// Internal-only function to update the base uri
          function __setBaseURI(string memory uriBase, string memory uriExtension)
              public
              override
              onlyInternal
          {
              advancedConfig.uriBase = uriBase;
              advancedConfig.uriExtension = uriExtension;
          }
          /// @dev returns the number of minted tokens
          /// uses some extra gas but makes etherscan and users happy so :shrug:
          /// partial erc721enumerable implemntation
          function totalSupply() public view returns (uint256) {
              return mintedCounter.current();
          }
          /**
            Internal-only
            @param to address to send the newly minted NFT to
            @dev This mints one edition to the given address by an allowed minter on the edition instance.
           */
          function __mint(address to, uint256 tokenId)
              external
              override
              onlyInternal
          {
              _mint(to, tokenId);
              mintedCounter.increment();
          }
          /**
              @param tokenId Token ID to burn
              User burn function for token id 
           */
          function burn(uint256 tokenId) public {
              require(_isApprovedOrOwner(_msgSender(), tokenId), "Not allowed");
              _burn(tokenId);
              mintedCounter.decrement();
          }
          /// Internal only
          function __burn(uint256 tokenId) public onlyInternal {
              _burn(tokenId);
              mintedCounter.decrement();
          }
          /**
              Simple override for owner interface.
           */
          function owner()
              public
              view
              override(OwnableUpgradeable)
              returns (address)
          {
              return super.owner();
          }
          /// internal alias for overrides
          function __owner()
              public
              view
              override(IBaseERC721Interface)
              returns (address)
          {
              return owner();
          }
          /// Get royalty information for token
          /// ignored token id to get royalty info. able to override and set per-token royalties
          /// @param _salePrice sales price for token to determine royalty split
          function royaltyInfo(uint256, uint256 _salePrice)
              external
              view
              override
              returns (address receiver, uint256 royaltyAmount)
          {
              // If ownership is revoked, don't set royalties.
              if (owner() == address(0x0)) {
                  return (owner(), 0);
              }
              return (owner(), (_salePrice * advancedConfig.royaltyBps) / 10_000);
          }
          /// Default simple token-uri implementation. works for ipfs folders too
          /// @param tokenId token id ot get uri for
          /// @return default uri getter functionality
          function tokenURI(uint256 tokenId)
              public
              view
              override
              returns (string memory)
          {
              require(_exists(tokenId), "No token");
              return
                  string(
                      abi.encodePacked(
                          advancedConfig.uriBase,
                          StringsUpgradeable.toString(tokenId),
                          advancedConfig.uriExtension
                      )
                  );
          }
          /// internal base override
          function __tokenURI(uint256 tokenId)
              public
              view
              onlyInternal
              returns (string memory)
          {
              return tokenURI(tokenId);
          }
          /// Exposing token exists check for base contract
          function __exists(uint256 tokenId) external view override returns (bool) {
              return _exists(tokenId);
          }
          /// Getter for approved or owner
          function __isApprovedOrOwner(address spender, uint256 tokenId)
              external
              view
              override
              onlyInternal
              returns (bool)
          {
              return _isApprovedOrOwner(spender, tokenId);
          }
          /// IERC165 getter
          /// @param interfaceId interfaceId bytes4 to check support for
          function supportsInterface(bytes4 interfaceId)
              public
              view
              override(ERC721Upgradeable, IERC165Upgradeable)
              returns (bool)
          {
              return
                  type(IERC2981Upgradeable).interfaceId == interfaceId ||
                  type(IBaseERC721Interface).interfaceId == interfaceId ||
                  ERC721Upgradeable.supportsInterface(interfaceId);
          }
      }
      // SPDX-License-Identifier: GPL-3.0
      pragma solidity 0.8.9;
      import {StorageSlotUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol";
      import {IBaseERC721Interface, ConfigSettings} from "./ERC721Base.sol";
      contract ERC721Delegated {
          uint256[100000] gap;
          bytes32 internal constant _IMPLEMENTATION_SLOT =
              0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
          // Reference to base NFT implementation
          function implementation() public view returns (address) {
              return
                  StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;
          }
          function _initImplementation(address _nftImplementation) private {
              StorageSlotUpgradeable
                  .getAddressSlot(_IMPLEMENTATION_SLOT)
                  .value = _nftImplementation;
          }
          /// Constructor that sets up the
          constructor(
              address _nftImplementation,
              string memory name,
              string memory symbol,
              ConfigSettings memory settings
          ) {
              /// Removed for gas saving reasons, the check below implictly accomplishes this
              // require(
              //     _nftImplementation.supportsInterface(
              //         type(IBaseERC721Interface).interfaceId
              //     )
              // );
              _initImplementation(_nftImplementation);
              (bool success, ) = _nftImplementation.delegatecall(
                  abi.encodeWithSignature(
                      "initialize(address,string,string,(uint16,string,string,bool))",
                      msg.sender,
                      name,
                      symbol,
                      settings
                  )
              );
              require(success);
          }
          /// OnlyOwner implemntation that proxies to base ownable contract for info
          modifier onlyOwner() {
              require(msg.sender == base().__owner(), "Not owner");
              _;
          }
          /// Getter to return the base implementation contract to call methods from
          /// Don't expose base contract to parent due to need to call private internal base functions
          function base() private view returns (IBaseERC721Interface) {
              return IBaseERC721Interface(address(this));
          }
          // helpers to mimic Openzeppelin internal functions
          /// Getter for the contract owner
          /// @return address owner address
          function _owner() internal view returns (address) {
              return base().__owner();
          }
          /// Internal burn function, only accessible from within contract
          /// @param id nft id to burn
          function _burn(uint256 id) internal {
              base().__burn(id);
          }
          /// Internal mint function, only accessible from within contract
          /// @param to address to mint NFT to
          /// @param id nft id to mint
          function _mint(address to, uint256 id) internal {
              base().__mint(to, id);
          }
          /// Internal exists function to determine if fn exists
          /// @param id nft id to check if exists
          function _exists(uint256 id) internal view returns (bool) {
              return base().__exists(id);
          }
          /// Internal getter for tokenURI
          /// @param tokenId id of token to get tokenURI for
          function _tokenURI(uint256 tokenId) internal view returns (string memory) {
              return base().__tokenURI(tokenId);
          }
          /// is approved for all getter underlying getter
          /// @param owner to check
          /// @param operator to check
          function _isApprovedForAll(address owner, address operator)
              internal
              view
              returns (bool)
          {
              return base().__isApprovedForAll(owner, operator);
          }
          /// Internal getter for approved or owner for a given operator
          /// @param operator address of operator to check
          /// @param id id of nft to check for
          function _isApprovedOrOwner(address operator, uint256 id)
              internal
              view
              returns (bool)
          {
              return base().__isApprovedOrOwner(operator, id);
          }
          /// Sets the base URI of the contract. Allowed only by parent contract
          /// @param newUri new uri base (http://URI) followed by number string of nft followed by extension string
          /// @param newExtension optional uri extension
          function _setBaseURI(string memory newUri, string memory newExtension)
              internal
          {
              base().__setBaseURI(newUri, newExtension);
          }
          /**
           * @dev Delegates the current call to nftImplementation.
           *
           * This function does not return to its internall call site, it will return directly to the external caller.
           */
          function _fallback() internal virtual {
              address impl = implementation();
              assembly {
                  // Copy msg.data. We take full control of memory in this inline assembly
                  // block because it will not return to Solidity code. We overwrite the
                  // Solidity scratch pad at memory position 0.
                  calldatacopy(0, 0, calldatasize())
                  // Call the implementation.
                  // out and outsize are 0 because we don't know the size yet.
                  let result := delegatecall(gas(), impl, 0, calldatasize(), 0, 0)
                  // Copy the returned data.
                  returndatacopy(0, 0, returndatasize())
                  switch result
                  // delegatecall returns 0 on error.
                  case 0 {
                      revert(0, returndatasize())
                  }
                  default {
                      return(0, returndatasize())
                  }
              }
          }
          /**
           * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
           * function in the contract matches the call data.
           */
          fallback() external virtual {
              _fallback();
          }
          /**
           * @dev No base NFT functions receive any value
           */
          receive() external payable {
              revert();
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @dev Contract module that helps prevent reentrant calls to a function.
       *
       * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
       * available, which can be applied to functions to make sure there are no nested
       * (reentrant) calls to them.
       *
       * Note that because there is a single `nonReentrant` guard, functions marked as
       * `nonReentrant` may not call one another. This can be worked around by making
       * those functions `private`, and then adding `external` `nonReentrant` entry
       * points to them.
       *
       * TIP: If you would like to learn more about reentrancy and alternative ways
       * to protect against it, check out our blog post
       * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
       */
      abstract contract ReentrancyGuard {
          // Booleans are more expensive than uint256 or any type that takes up a full
          // word because each write operation emits an extra SLOAD to first read the
          // slot's contents, replace the bits taken up by the boolean, and then write
          // back. This is the compiler's defense against contract upgrades and
          // pointer aliasing, and it cannot be disabled.
          // The values being non-zero value makes deployment a bit more expensive,
          // but in exchange the refund on every call to nonReentrant will be lower in
          // amount. Since refunds are capped to a percentage of the total
          // transaction's gas, it is best to keep them low in cases like this one, to
          // increase the likelihood of the full refund coming into effect.
          uint256 private constant _NOT_ENTERED = 1;
          uint256 private constant _ENTERED = 2;
          uint256 private _status;
          constructor() {
              _status = _NOT_ENTERED;
          }
          /**
           * @dev Prevents a contract from calling itself, directly or indirectly.
           * Calling a `nonReentrant` function from another `nonReentrant`
           * function is not supported. It is possible to prevent this from happening
           * by making the `nonReentrant` function external, and make it call a
           * `private` function that does the actual work.
           */
          modifier nonReentrant() {
              // On the first call to nonReentrant, _notEntered will be true
              require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
              // Any calls to nonReentrant after this point will fail
              _status = _ENTERED;
              _;
              // By storing the original value once again, a refund is triggered (see
              // https://eips.ethereum.org/EIPS/eip-2200)
              _status = _NOT_ENTERED;
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @title Counters
       * @author Matt Condon (@shrugs)
       * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
       * of elements in a mapping, issuing ERC721 ids, or counting request ids.
       *
       * Include with `using Counters for Counters.Counter;`
       */
      library Counters {
          struct Counter {
              // This variable should never be directly accessed by users of the library: interactions must be restricted to
              // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
              // this feature: see https://github.com/ethereum/solidity/issues/4637
              uint256 _value; // default: 0
          }
          function current(Counter storage counter) internal view returns (uint256) {
              return counter._value;
          }
          function increment(Counter storage counter) internal {
              unchecked {
                  counter._value += 1;
              }
          }
          function decrement(Counter storage counter) internal {
              uint256 value = counter._value;
              require(value > 0, "Counter: decrement overflow");
              unchecked {
                  counter._value = value - 1;
              }
          }
          function reset(Counter storage counter) internal {
              counter._value = 0;
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @dev Collection of functions related to the address type
       */
      library Address {
          /**
           * @dev Returns true if `account` is a contract.
           *
           * [IMPORTANT]
           * ====
           * It is unsafe to assume that an address for which this function returns
           * false is an externally-owned account (EOA) and not a contract.
           *
           * Among others, `isContract` will return false for the following
           * types of addresses:
           *
           *  - an externally-owned account
           *  - a contract in construction
           *  - an address where a contract will be created
           *  - an address where a contract lived, but was destroyed
           * ====
           */
          function isContract(address account) internal view returns (bool) {
              // This method relies on extcodesize, which returns 0 for contracts in
              // construction, since the code is only stored at the end of the
              // constructor execution.
              uint256 size;
              assembly {
                  size := extcodesize(account)
              }
              return size > 0;
          }
          /**
           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
           * `recipient`, forwarding all available gas and reverting on errors.
           *
           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
           * of certain opcodes, possibly making contracts go over the 2300 gas limit
           * imposed by `transfer`, making them unable to receive funds via
           * `transfer`. {sendValue} removes this limitation.
           *
           * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
           *
           * IMPORTANT: because control is transferred to `recipient`, care must be
           * taken to not create reentrancy vulnerabilities. Consider using
           * {ReentrancyGuard} or the
           * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
           */
          function sendValue(address payable recipient, uint256 amount) internal {
              require(address(this).balance >= amount, "Address: insufficient balance");
              (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 Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
           * but performing a delegate call.
           *
           * _Available since v3.4._
           */
          function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
              return functionDelegateCall(target, data, "Address: low-level delegate call failed");
          }
          /**
           * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
           * but performing a delegate call.
           *
           * _Available since v3.4._
           */
          function functionDelegateCall(
              address target,
              bytes memory data,
              string memory errorMessage
          ) internal returns (bytes memory) {
              require(isContract(target), "Address: delegate call to non-contract");
              (bool success, bytes memory returndata) = target.delegatecall(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
                      assembly {
                          let returndata_size := mload(returndata)
                          revert(add(32, returndata), returndata_size)
                      }
                  } else {
                      revert(errorMessage);
                  }
              }
          }
      }
      // SPDX-License-Identifier: MIT
      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 initializer {
              __Context_init_unchained();
              __ERC165_init_unchained();
              __ERC721_init_unchained(name_, symbol_);
          }
          function __ERC721_init_unchained(string memory name_, string memory symbol_) internal initializer {
              _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: balance query for the zero address");
              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: owner query for nonexistent token");
              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) {
              require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
              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 overriden 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 owner nor approved for all"
              );
              _approve(to, tokenId);
          }
          /**
           * @dev See {IERC721-getApproved}.
           */
          function getApproved(uint256 tokenId) public view virtual override returns (address) {
              require(_exists(tokenId), "ERC721: approved query for nonexistent token");
              return _tokenApprovals[tokenId];
          }
          /**
           * @dev See {IERC721-setApprovalForAll}.
           */
          function setApprovalForAll(address operator, bool approved) public virtual override {
              require(operator != _msgSender(), "ERC721: approve to caller");
              _operatorApprovals[_msgSender()][operator] = approved;
              emit ApprovalForAll(_msgSender(), operator, approved);
          }
          /**
           * @dev 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: transfer caller is not 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: transfer caller is not 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) {
              require(_exists(tokenId), "ERC721: operator query for nonexistent token");
              address owner = ERC721Upgradeable.ownerOf(tokenId);
              return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, 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);
          }
          /**
           * @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);
          }
          /**
           * @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 of token that is not own");
              require(to != address(0), "ERC721: transfer to the zero address");
              _beforeTokenTransfer(from, to, tokenId);
              // Clear approvals from the previous owner
              _approve(address(0), tokenId);
              _balances[from] -= 1;
              _balances[to] += 1;
              _owners[tokenId] = to;
              emit Transfer(from, to, tokenId);
          }
          /**
           * @dev Approve `to` to operate on `tokenId`
           *
           * Emits a {Approval} event.
           */
          function _approve(address to, uint256 tokenId) internal virtual {
              _tokenApprovals[tokenId] = to;
              emit Approval(ERC721Upgradeable.ownerOf(tokenId), to, 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 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 {
                          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 {}
          uint256[44] private __gap;
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      import "./IERC165Upgradeable.sol";
      /**
       * @dev Interface for the NFT Royalty Standard
       */
      interface IERC2981Upgradeable is IERC165Upgradeable {
          /**
           * @dev Called with the sale price to determine how much royalty is owed and to whom.
           * @param tokenId - the NFT asset queried for royalty information
           * @param salePrice - the sale price of the NFT asset specified by `tokenId`
           * @return receiver - address of who should be sent the royalty payment
           * @return royaltyAmount - the royalty payment amount for `salePrice`
           */
          function royaltyInfo(uint256 tokenId, uint256 salePrice)
              external
              view
              returns (address receiver, uint256 royaltyAmount);
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      import "../utils/ContextUpgradeable.sol";
      import "../proxy/utils/Initializable.sol";
      /**
       * @dev Contract module which provides a basic access control mechanism, where
       * there is an account (an owner) that can be granted exclusive access to
       * specific functions.
       *
       * By default, the owner account will be the one that deploys the contract. This
       * can later be changed with {transferOwnership}.
       *
       * This module is used through inheritance. It will make available the modifier
       * `onlyOwner`, which can be applied to your functions to restrict their use to
       * the owner.
       */
      abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {
          address private _owner;
          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
          /**
           * @dev Initializes the contract setting the deployer as the initial owner.
           */
          function __Ownable_init() internal initializer {
              __Context_init_unchained();
              __Ownable_init_unchained();
          }
          function __Ownable_init_unchained() internal initializer {
              _setOwner(_msgSender());
          }
          /**
           * @dev Returns the address of the current owner.
           */
          function owner() public view virtual returns (address) {
              return _owner;
          }
          /**
           * @dev Throws if called by any account other than the owner.
           */
          modifier onlyOwner() {
              require(owner() == _msgSender(), "Ownable: caller is not the owner");
              _;
          }
          /**
           * @dev Leaves the contract without owner. It will not be possible to call
           * `onlyOwner` functions anymore. Can only be called by the current owner.
           *
           * NOTE: Renouncing ownership will leave the contract without an owner,
           * thereby removing any functionality that is only available to the owner.
           */
          function renounceOwnership() public virtual onlyOwner {
              _setOwner(address(0));
          }
          /**
           * @dev Transfers ownership of the contract to a new account (`newOwner`).
           * Can only be called by the current owner.
           */
          function transferOwnership(address newOwner) public virtual onlyOwner {
              require(newOwner != address(0), "Ownable: new owner is the zero address");
              _setOwner(newOwner);
          }
          function _setOwner(address newOwner) private {
              address oldOwner = _owner;
              _owner = newOwner;
              emit OwnershipTransferred(oldOwner, newOwner);
          }
          uint256[49] private __gap;
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @dev String operations.
       */
      library StringsUpgradeable {
          bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
          /**
           * @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);
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @title Counters
       * @author Matt Condon (@shrugs)
       * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
       * of elements in a mapping, issuing ERC721 ids, or counting request ids.
       *
       * Include with `using Counters for Counters.Counter;`
       */
      library CountersUpgradeable {
          struct Counter {
              // This variable should never be directly accessed by users of the library: interactions must be restricted to
              // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
              // this feature: see https://github.com/ethereum/solidity/issues/4637
              uint256 _value; // default: 0
          }
          function current(Counter storage counter) internal view returns (uint256) {
              return counter._value;
          }
          function increment(Counter storage counter) internal {
              unchecked {
                  counter._value += 1;
              }
          }
          function decrement(Counter storage counter) internal {
              uint256 value = counter._value;
              require(value > 0, "Counter: decrement overflow");
              unchecked {
                  counter._value = value - 1;
              }
          }
          function reset(Counter storage counter) internal {
              counter._value = 0;
          }
      }
      // SPDX-License-Identifier: GPL-3.0
      pragma solidity 0.8.9;
      /// Additional features and functions assigned to the
      /// Base721 contract for hooks and overrides
      interface IBaseERC721Interface {
          /*
           Exposing common NFT internal functionality for base contract overrides
           To save gas and make API cleaner this is only for new functionality not exposed in
           the core ERC721 contract
          */
          /// Mint an NFT. Allowed to mint by owner, approval or by the parent contract
          /// @param tokenId id to burn
          function __burn(uint256 tokenId) external;
          /// Mint an NFT. Allowed only by the parent contract
          /// @param to address to mint to
          /// @param tokenId token id to mint
          function __mint(address to, uint256 tokenId) external;
          /// Set the base URI of the contract. Allowed only by parent contract
          /// @param base base uri
          /// @param extension extension
          function __setBaseURI(string memory base, string memory extension) external;
          /* Exposes common internal read features for public use */
          /// Token exists
          /// @param tokenId token id to see if it exists
          function __exists(uint256 tokenId) external view returns (bool);
          /// Simple approval for operation check on token for address
          /// @param spender address spending/changing token
          /// @param tokenId tokenID to change / operate on
          function __isApprovedOrOwner(address spender, uint256 tokenId)
              external
              view
              returns (bool);
          function __isApprovedForAll(address owner, address operator)
              external
              view
              returns (bool);
          function __tokenURI(uint256 tokenId) external view returns (string memory);
          function __owner() external view returns (address);
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @dev Library for reading and writing primitive types to specific storage slots.
       *
       * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
       * This library helps with reading and writing to such slots without the need for inline assembly.
       *
       * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
       *
       * Example usage to set ERC1967 implementation slot:
       * ```
       * contract ERC1967 {
       *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
       *
       *     function _getImplementation() internal view returns (address) {
       *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
       *     }
       *
       *     function _setImplementation(address newImplementation) internal {
       *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
       *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
       *     }
       * }
       * ```
       *
       * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
       */
      library StorageSlotUpgradeable {
          struct AddressSlot {
              address value;
          }
          struct BooleanSlot {
              bool value;
          }
          struct Bytes32Slot {
              bytes32 value;
          }
          struct Uint256Slot {
              uint256 value;
          }
          /**
           * @dev Returns an `AddressSlot` with member `value` located at `slot`.
           */
          function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
              assembly {
                  r.slot := slot
              }
          }
          /**
           * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
           */
          function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
              assembly {
                  r.slot := slot
              }
          }
          /**
           * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
           */
          function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
              assembly {
                  r.slot := slot
              }
          }
          /**
           * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
           */
          function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
              assembly {
                  r.slot := slot
              }
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      import "../../utils/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`, checking first that contract recipients
           * are aware of the ERC721 protocol to prevent tokens from being forever locked.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId
          ) external;
          /**
           * @dev Transfers `tokenId` token from `from` to `to`.
           *
           * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           *
           * Emits a {Transfer} event.
           */
          function transferFrom(
              address from,
              address to,
              uint256 tokenId
          ) external;
          /**
           * @dev Gives permission to `to` to transfer `tokenId` token to another account.
           * The approval is cleared when the token is transferred.
           *
           * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
           *
           * Requirements:
           *
           * - The caller must own the token or be an approved operator.
           * - `tokenId` must exist.
           *
           * Emits an {Approval} event.
           */
          function approve(address to, uint256 tokenId) external;
          /**
           * @dev Returns the account approved for `tokenId` token.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           */
          function getApproved(uint256 tokenId) external view returns (address operator);
          /**
           * @dev Approve or remove `operator` as an operator for the caller.
           * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
           *
           * Requirements:
           *
           * - The `operator` cannot be the caller.
           *
           * Emits an {ApprovalForAll} event.
           */
          function setApprovalForAll(address operator, bool _approved) external;
          /**
           * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
           *
           * See {setApprovalForAll}
           */
          function isApprovedForAll(address owner, address operator) external view returns (bool);
          /**
           * @dev Safely transfers `tokenId` token from `from` to `to`.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId,
              bytes calldata data
          ) external;
      }
      // SPDX-License-Identifier: MIT
      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 `IERC721.onERC721Received.selector`.
           */
          function onERC721Received(
              address operator,
              address from,
              uint256 tokenId,
              bytes calldata data
          ) external returns (bytes4);
      }
      // SPDX-License-Identifier: MIT
      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
      pragma solidity ^0.8.0;
      /**
       * @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
           * ====
           */
          function isContract(address account) internal view returns (bool) {
              // This method relies on extcodesize, which returns 0 for contracts in
              // construction, since the code is only stored at the end of the
              // constructor execution.
              uint256 size;
              assembly {
                  size := extcodesize(account)
              }
              return size > 0;
          }
          /**
           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
           * `recipient`, forwarding all available gas and reverting on errors.
           *
           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
           * of certain opcodes, possibly making contracts go over the 2300 gas limit
           * imposed by `transfer`, making them unable to receive funds via
           * `transfer`. {sendValue} removes this limitation.
           *
           * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
           *
           * IMPORTANT: because control is transferred to `recipient`, care must be
           * taken to not create reentrancy vulnerabilities. Consider using
           * {ReentrancyGuard} or the
           * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
           */
          function sendValue(address payable recipient, uint256 amount) internal {
              require(address(this).balance >= amount, "Address: insufficient balance");
              (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
                      assembly {
                          let returndata_size := mload(returndata)
                          revert(add(32, returndata), returndata_size)
                      }
                  } else {
                      revert(errorMessage);
                  }
              }
          }
      }
      // SPDX-License-Identifier: MIT
      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 initializer {
              __Context_init_unchained();
          }
          function __Context_init_unchained() internal initializer {
          }
          function _msgSender() internal view virtual returns (address) {
              return msg.sender;
          }
          function _msgData() internal view virtual returns (bytes calldata) {
              return msg.data;
          }
          uint256[50] private __gap;
      }
      // SPDX-License-Identifier: MIT
      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 initializer {
              __ERC165_init_unchained();
          }
          function __ERC165_init_unchained() internal initializer {
          }
          /**
           * @dev See {IERC165-supportsInterface}.
           */
          function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
              return interfaceId == type(IERC165Upgradeable).interfaceId;
          }
          uint256[50] private __gap;
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @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 a proxied contract can't have 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.
       *
       * 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.
       */
      abstract contract Initializable {
          /**
           * @dev Indicates that the contract has been initialized.
           */
          bool private _initialized;
          /**
           * @dev Indicates that the contract is in the process of being initialized.
           */
          bool private _initializing;
          /**
           * @dev Modifier to protect an initializer function from being invoked twice.
           */
          modifier initializer() {
              require(_initializing || !_initialized, "Initializable: contract is already initialized");
              bool isTopLevelCall = !_initializing;
              if (isTopLevelCall) {
                  _initializing = true;
                  _initialized = true;
              }
              _;
              if (isTopLevelCall) {
                  _initializing = false;
              }
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      import "../utils/introspection/IERC165Upgradeable.sol";
      // SPDX-License-Identifier: MIT
      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);
      }
      

      File 2 of 2: ERC721Base
      // SPDX-License-Identifier: GPL-3.0
      pragma solidity 0.8.9;
      import {ERC721Upgradeable} from "@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol";
      import {IERC2981Upgradeable, IERC165Upgradeable} from "@openzeppelin/contracts-upgradeable/interfaces/IERC2981Upgradeable.sol";
      import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
      import {StringsUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";
      import {CountersUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/CountersUpgradeable.sol";
      import {IBaseERC721Interface} from "./IBaseERC721Interface.sol";
      struct ConfigSettings {
          uint16 royaltyBps;
          string uriBase;
          string uriExtension;
          bool hasTransferHook;
      }
      /**
          This smart contract adds features and allows for a ownership only by another smart contract as fallback behavior
          while also implementing all normal ERC721 functions as expected
      */
      contract ERC721Base is
          ERC721Upgradeable,
          IBaseERC721Interface,
          IERC2981Upgradeable,
          OwnableUpgradeable
      {
          using CountersUpgradeable for CountersUpgradeable.Counter;
          // Minted counter for totalSupply()
          CountersUpgradeable.Counter private mintedCounter;
          modifier onlyInternal() {
              require(msg.sender == address(this), "Only internal");
              _;
          }
          /// on-chain record of when this contract was deployed
          uint256 public immutable deployedBlock;
          ConfigSettings public advancedConfig;
          /// Constructor called once when the base contract is deployed
          constructor() {
              // Can be used to verify contract implementation is correct at address
              deployedBlock = block.number;
          }
          /// Initializer that's called when a new child nft is setup
          /// @param newOwner Owner for the new derived nft
          /// @param _name name of NFT contract
          /// @param _symbol symbol of NFT contract
          /// @param settings configuration settings for uri, royalty, and hooks features
          function initialize(
              address newOwner,
              string memory _name,
              string memory _symbol,
              ConfigSettings memory settings
          ) public initializer {
              __ERC721_init(_name, _symbol);
              __Ownable_init();
              advancedConfig = settings;
              transferOwnership(newOwner);
          }
          /// Getter to expose appoval status to root contract
          function isApprovedForAll(address _owner, address operator)
              public
              view
              override
              returns (bool)
          {
              return
                  ERC721Upgradeable.isApprovedForAll(_owner, operator) ||
                  operator == address(this);
          }
          /// internal getter for approval by all
          /// When isApprovedForAll is overridden, this can be used to call original impl
          function __isApprovedForAll(address _owner, address operator)
              public
              view
              override
              returns (bool)
          {
              return isApprovedForAll(_owner, operator);
          }
          /// Hook that when enabled manually calls _beforeTokenTransfer on
          function _beforeTokenTransfer(
              address from,
              address to,
              uint256 tokenId
          ) internal override {
              if (advancedConfig.hasTransferHook) {
                  (bool success, ) = address(this).delegatecall(
                      abi.encodeWithSignature(
                          "_beforeTokenTransfer(address,address,uint256)",
                          from,
                          to,
                          tokenId
                      )
                  );
                  // Raise error again from result if error exists
                  assembly {
                      switch success
                      // delegatecall returns 0 on error.
                      case 0 {
                          returndatacopy(0, 0, returndatasize())
                          revert(0, returndatasize())
                      }
                  }
              }
          }
          /// Internal-only function to update the base uri
          function __setBaseURI(string memory uriBase, string memory uriExtension)
              public
              override
              onlyInternal
          {
              advancedConfig.uriBase = uriBase;
              advancedConfig.uriExtension = uriExtension;
          }
          /// @dev returns the number of minted tokens
          /// uses some extra gas but makes etherscan and users happy so :shrug:
          /// partial erc721enumerable implemntation
          function totalSupply() public view returns (uint256) {
              return mintedCounter.current();
          }
          /**
            Internal-only
            @param to address to send the newly minted NFT to
            @dev This mints one edition to the given address by an allowed minter on the edition instance.
           */
          function __mint(address to, uint256 tokenId)
              external
              override
              onlyInternal
          {
              _mint(to, tokenId);
              mintedCounter.increment();
          }
          /**
              @param tokenId Token ID to burn
              User burn function for token id 
           */
          function burn(uint256 tokenId) public {
              require(_isApprovedOrOwner(_msgSender(), tokenId), "Not allowed");
              _burn(tokenId);
              mintedCounter.decrement();
          }
          /// Internal only
          function __burn(uint256 tokenId) public onlyInternal {
              _burn(tokenId);
              mintedCounter.decrement();
          }
          /**
              Simple override for owner interface.
           */
          function owner()
              public
              view
              override(OwnableUpgradeable)
              returns (address)
          {
              return super.owner();
          }
          /// internal alias for overrides
          function __owner()
              public
              view
              override(IBaseERC721Interface)
              returns (address)
          {
              return owner();
          }
          /// Get royalty information for token
          /// ignored token id to get royalty info. able to override and set per-token royalties
          /// @param _salePrice sales price for token to determine royalty split
          function royaltyInfo(uint256, uint256 _salePrice)
              external
              view
              override
              returns (address receiver, uint256 royaltyAmount)
          {
              // If ownership is revoked, don't set royalties.
              if (owner() == address(0x0)) {
                  return (owner(), 0);
              }
              return (owner(), (_salePrice * advancedConfig.royaltyBps) / 10_000);
          }
          /// Default simple token-uri implementation. works for ipfs folders too
          /// @param tokenId token id ot get uri for
          /// @return default uri getter functionality
          function tokenURI(uint256 tokenId)
              public
              view
              override
              returns (string memory)
          {
              require(_exists(tokenId), "No token");
              return
                  string(
                      abi.encodePacked(
                          advancedConfig.uriBase,
                          StringsUpgradeable.toString(tokenId),
                          advancedConfig.uriExtension
                      )
                  );
          }
          /// internal base override
          function __tokenURI(uint256 tokenId)
              public
              view
              onlyInternal
              returns (string memory)
          {
              return tokenURI(tokenId);
          }
          /// Exposing token exists check for base contract
          function __exists(uint256 tokenId) external view override returns (bool) {
              return _exists(tokenId);
          }
          /// Getter for approved or owner
          function __isApprovedOrOwner(address spender, uint256 tokenId)
              external
              view
              override
              onlyInternal
              returns (bool)
          {
              return _isApprovedOrOwner(spender, tokenId);
          }
          /// IERC165 getter
          /// @param interfaceId interfaceId bytes4 to check support for
          function supportsInterface(bytes4 interfaceId)
              public
              view
              override(ERC721Upgradeable, IERC165Upgradeable)
              returns (bool)
          {
              return
                  type(IERC2981Upgradeable).interfaceId == interfaceId ||
                  type(IBaseERC721Interface).interfaceId == interfaceId ||
                  ERC721Upgradeable.supportsInterface(interfaceId);
          }
      }
      // SPDX-License-Identifier: MIT
      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 initializer {
              __Context_init_unchained();
              __ERC165_init_unchained();
              __ERC721_init_unchained(name_, symbol_);
          }
          function __ERC721_init_unchained(string memory name_, string memory symbol_) internal initializer {
              _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: balance query for the zero address");
              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: owner query for nonexistent token");
              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) {
              require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
              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 overriden 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 owner nor approved for all"
              );
              _approve(to, tokenId);
          }
          /**
           * @dev See {IERC721-getApproved}.
           */
          function getApproved(uint256 tokenId) public view virtual override returns (address) {
              require(_exists(tokenId), "ERC721: approved query for nonexistent token");
              return _tokenApprovals[tokenId];
          }
          /**
           * @dev See {IERC721-setApprovalForAll}.
           */
          function setApprovalForAll(address operator, bool approved) public virtual override {
              require(operator != _msgSender(), "ERC721: approve to caller");
              _operatorApprovals[_msgSender()][operator] = approved;
              emit ApprovalForAll(_msgSender(), operator, approved);
          }
          /**
           * @dev 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: transfer caller is not 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: transfer caller is not 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) {
              require(_exists(tokenId), "ERC721: operator query for nonexistent token");
              address owner = ERC721Upgradeable.ownerOf(tokenId);
              return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, 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);
          }
          /**
           * @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);
          }
          /**
           * @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 of token that is not own");
              require(to != address(0), "ERC721: transfer to the zero address");
              _beforeTokenTransfer(from, to, tokenId);
              // Clear approvals from the previous owner
              _approve(address(0), tokenId);
              _balances[from] -= 1;
              _balances[to] += 1;
              _owners[tokenId] = to;
              emit Transfer(from, to, tokenId);
          }
          /**
           * @dev Approve `to` to operate on `tokenId`
           *
           * Emits a {Approval} event.
           */
          function _approve(address to, uint256 tokenId) internal virtual {
              _tokenApprovals[tokenId] = to;
              emit Approval(ERC721Upgradeable.ownerOf(tokenId), to, 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 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 {
                          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 {}
          uint256[44] private __gap;
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      import "./IERC165Upgradeable.sol";
      /**
       * @dev Interface for the NFT Royalty Standard
       */
      interface IERC2981Upgradeable is IERC165Upgradeable {
          /**
           * @dev Called with the sale price to determine how much royalty is owed and to whom.
           * @param tokenId - the NFT asset queried for royalty information
           * @param salePrice - the sale price of the NFT asset specified by `tokenId`
           * @return receiver - address of who should be sent the royalty payment
           * @return royaltyAmount - the royalty payment amount for `salePrice`
           */
          function royaltyInfo(uint256 tokenId, uint256 salePrice)
              external
              view
              returns (address receiver, uint256 royaltyAmount);
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      import "../utils/ContextUpgradeable.sol";
      import "../proxy/utils/Initializable.sol";
      /**
       * @dev Contract module which provides a basic access control mechanism, where
       * there is an account (an owner) that can be granted exclusive access to
       * specific functions.
       *
       * By default, the owner account will be the one that deploys the contract. This
       * can later be changed with {transferOwnership}.
       *
       * This module is used through inheritance. It will make available the modifier
       * `onlyOwner`, which can be applied to your functions to restrict their use to
       * the owner.
       */
      abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {
          address private _owner;
          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
          /**
           * @dev Initializes the contract setting the deployer as the initial owner.
           */
          function __Ownable_init() internal initializer {
              __Context_init_unchained();
              __Ownable_init_unchained();
          }
          function __Ownable_init_unchained() internal initializer {
              _setOwner(_msgSender());
          }
          /**
           * @dev Returns the address of the current owner.
           */
          function owner() public view virtual returns (address) {
              return _owner;
          }
          /**
           * @dev Throws if called by any account other than the owner.
           */
          modifier onlyOwner() {
              require(owner() == _msgSender(), "Ownable: caller is not the owner");
              _;
          }
          /**
           * @dev Leaves the contract without owner. It will not be possible to call
           * `onlyOwner` functions anymore. Can only be called by the current owner.
           *
           * NOTE: Renouncing ownership will leave the contract without an owner,
           * thereby removing any functionality that is only available to the owner.
           */
          function renounceOwnership() public virtual onlyOwner {
              _setOwner(address(0));
          }
          /**
           * @dev Transfers ownership of the contract to a new account (`newOwner`).
           * Can only be called by the current owner.
           */
          function transferOwnership(address newOwner) public virtual onlyOwner {
              require(newOwner != address(0), "Ownable: new owner is the zero address");
              _setOwner(newOwner);
          }
          function _setOwner(address newOwner) private {
              address oldOwner = _owner;
              _owner = newOwner;
              emit OwnershipTransferred(oldOwner, newOwner);
          }
          uint256[49] private __gap;
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @dev String operations.
       */
      library StringsUpgradeable {
          bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
          /**
           * @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);
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @title Counters
       * @author Matt Condon (@shrugs)
       * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
       * of elements in a mapping, issuing ERC721 ids, or counting request ids.
       *
       * Include with `using Counters for Counters.Counter;`
       */
      library CountersUpgradeable {
          struct Counter {
              // This variable should never be directly accessed by users of the library: interactions must be restricted to
              // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
              // this feature: see https://github.com/ethereum/solidity/issues/4637
              uint256 _value; // default: 0
          }
          function current(Counter storage counter) internal view returns (uint256) {
              return counter._value;
          }
          function increment(Counter storage counter) internal {
              unchecked {
                  counter._value += 1;
              }
          }
          function decrement(Counter storage counter) internal {
              uint256 value = counter._value;
              require(value > 0, "Counter: decrement overflow");
              unchecked {
                  counter._value = value - 1;
              }
          }
          function reset(Counter storage counter) internal {
              counter._value = 0;
          }
      }
      // SPDX-License-Identifier: GPL-3.0
      pragma solidity 0.8.9;
      /// Additional features and functions assigned to the
      /// Base721 contract for hooks and overrides
      interface IBaseERC721Interface {
          /*
           Exposing common NFT internal functionality for base contract overrides
           To save gas and make API cleaner this is only for new functionality not exposed in
           the core ERC721 contract
          */
          /// Mint an NFT. Allowed to mint by owner, approval or by the parent contract
          /// @param tokenId id to burn
          function __burn(uint256 tokenId) external;
          /// Mint an NFT. Allowed only by the parent contract
          /// @param to address to mint to
          /// @param tokenId token id to mint
          function __mint(address to, uint256 tokenId) external;
          /// Set the base URI of the contract. Allowed only by parent contract
          /// @param base base uri
          /// @param extension extension
          function __setBaseURI(string memory base, string memory extension) external;
          /* Exposes common internal read features for public use */
          /// Token exists
          /// @param tokenId token id to see if it exists
          function __exists(uint256 tokenId) external view returns (bool);
          /// Simple approval for operation check on token for address
          /// @param spender address spending/changing token
          /// @param tokenId tokenID to change / operate on
          function __isApprovedOrOwner(address spender, uint256 tokenId)
              external
              view
              returns (bool);
          function __isApprovedForAll(address owner, address operator)
              external
              view
              returns (bool);
          function __tokenURI(uint256 tokenId) external view returns (string memory);
          function __owner() external view returns (address);
      }
      // SPDX-License-Identifier: MIT
      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`, checking first that contract recipients
           * are aware of the ERC721 protocol to prevent tokens from being forever locked.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId
          ) external;
          /**
           * @dev Transfers `tokenId` token from `from` to `to`.
           *
           * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           *
           * Emits a {Transfer} event.
           */
          function transferFrom(
              address from,
              address to,
              uint256 tokenId
          ) external;
          /**
           * @dev Gives permission to `to` to transfer `tokenId` token to another account.
           * The approval is cleared when the token is transferred.
           *
           * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
           *
           * Requirements:
           *
           * - The caller must own the token or be an approved operator.
           * - `tokenId` must exist.
           *
           * Emits an {Approval} event.
           */
          function approve(address to, uint256 tokenId) external;
          /**
           * @dev Returns the account approved for `tokenId` token.
           *
           * Requirements:
           *
           * - `tokenId` must exist.
           */
          function getApproved(uint256 tokenId) external view returns (address operator);
          /**
           * @dev Approve or remove `operator` as an operator for the caller.
           * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
           *
           * Requirements:
           *
           * - The `operator` cannot be the caller.
           *
           * Emits an {ApprovalForAll} event.
           */
          function setApprovalForAll(address operator, bool _approved) external;
          /**
           * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
           *
           * See {setApprovalForAll}
           */
          function isApprovedForAll(address owner, address operator) external view returns (bool);
          /**
           * @dev Safely transfers `tokenId` token from `from` to `to`.
           *
           * Requirements:
           *
           * - `from` cannot be the zero address.
           * - `to` cannot be the zero address.
           * - `tokenId` token must exist and be owned by `from`.
           * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
           * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
           *
           * Emits a {Transfer} event.
           */
          function safeTransferFrom(
              address from,
              address to,
              uint256 tokenId,
              bytes calldata data
          ) external;
      }
      // SPDX-License-Identifier: MIT
      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 `IERC721.onERC721Received.selector`.
           */
          function onERC721Received(
              address operator,
              address from,
              uint256 tokenId,
              bytes calldata data
          ) external returns (bytes4);
      }
      // SPDX-License-Identifier: MIT
      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
      pragma solidity ^0.8.0;
      /**
       * @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
           * ====
           */
          function isContract(address account) internal view returns (bool) {
              // This method relies on extcodesize, which returns 0 for contracts in
              // construction, since the code is only stored at the end of the
              // constructor execution.
              uint256 size;
              assembly {
                  size := extcodesize(account)
              }
              return size > 0;
          }
          /**
           * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
           * `recipient`, forwarding all available gas and reverting on errors.
           *
           * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
           * of certain opcodes, possibly making contracts go over the 2300 gas limit
           * imposed by `transfer`, making them unable to receive funds via
           * `transfer`. {sendValue} removes this limitation.
           *
           * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
           *
           * IMPORTANT: because control is transferred to `recipient`, care must be
           * taken to not create reentrancy vulnerabilities. Consider using
           * {ReentrancyGuard} or the
           * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
           */
          function sendValue(address payable recipient, uint256 amount) internal {
              require(address(this).balance >= amount, "Address: insufficient balance");
              (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
                      assembly {
                          let returndata_size := mload(returndata)
                          revert(add(32, returndata), returndata_size)
                      }
                  } else {
                      revert(errorMessage);
                  }
              }
          }
      }
      // SPDX-License-Identifier: MIT
      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 initializer {
              __Context_init_unchained();
          }
          function __Context_init_unchained() internal initializer {
          }
          function _msgSender() internal view virtual returns (address) {
              return msg.sender;
          }
          function _msgData() internal view virtual returns (bytes calldata) {
              return msg.data;
          }
          uint256[50] private __gap;
      }
      // SPDX-License-Identifier: MIT
      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 initializer {
              __ERC165_init_unchained();
          }
          function __ERC165_init_unchained() internal initializer {
          }
          /**
           * @dev See {IERC165-supportsInterface}.
           */
          function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
              return interfaceId == type(IERC165Upgradeable).interfaceId;
          }
          uint256[50] private __gap;
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.0;
      /**
       * @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 a proxied contract can't have 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.
       *
       * 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.
       */
      abstract contract Initializable {
          /**
           * @dev Indicates that the contract has been initialized.
           */
          bool private _initialized;
          /**
           * @dev Indicates that the contract is in the process of being initialized.
           */
          bool private _initializing;
          /**
           * @dev Modifier to protect an initializer function from being invoked twice.
           */
          modifier initializer() {
              require(_initializing || !_initialized, "Initializable: contract is already initialized");
              bool isTopLevelCall = !_initializing;
              if (isTopLevelCall) {
                  _initializing = true;
                  _initialized = true;
              }
              _;
              if (isTopLevelCall) {
                  _initializing = false;
              }
          }
      }
      // SPDX-License-Identifier: MIT
      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
      pragma solidity ^0.8.0;
      import "../utils/introspection/IERC165Upgradeable.sol";