ETH Price: $2,344.32 (+7.56%)

Transaction Decoder

Block:
15848051 at Oct-28-2022 05:27:59 PM +UTC
Transaction Fee:
0.001498413523950096 ETH $3.51
Gas Used:
48,868 Gas / 30.662468772 Gwei

Emitted Events:

Account State Difference:

  Address   Before After State Difference Code
0xa8beC283...EadD6253c
12.723461093000907018 Eth
Nonce: 155
12.721962679476956922 Eth
Nonce: 156
0.001498413523950096
0xB228D7B6...788A8F172
(Flashbots: Builder)
1.202985692845781428 Eth1.203058994845781428 Eth0.000073302

Execution Trace

SingleEditionMintable.setApprovalForAll( operator=0x1E0049783F008A0085193E00003D00cd54003c71, approved=True )
  • SingleEditionMintable.setApprovalForAll( operator=0x1E0049783F008A0085193E00003D00cd54003c71, approved=True )
    File 1 of 2: SingleEditionMintable
    // SPDX-License-Identifier: GPL-3.0
    pragma solidity 0.8.6;
    interface IEditionSingleMintable {
      function mintEdition(address to) external returns (uint256);
      function mintEditions(address[] memory to) external returns (uint256);
      function numberCanMint() external view returns (uint256);
      function owner() external view returns (address);
    }// SPDX-License-Identifier: GPL-3.0
    /**
    █▄░█ █▀▀ ▀█▀   █▀▀ █▀▄ █ ▀█▀ █ █▀█ █▄░█ █▀
    █░▀█ █▀░ ░█░   ██▄ █▄▀ █ ░█░ █ █▄█ █░▀█ ▄█
    ▀█ █▀█ █▀█ ▄▀█
    █▄ █▄█ █▀▄ █▀█
     */
    pragma solidity 0.8.6;
    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 {CountersUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/CountersUpgradeable.sol";
    import {SharedNFTLogic} from "./SharedNFTLogic.sol";
    import {IEditionSingleMintable} from "./IEditionSingleMintable.sol";
    /**
        This is a smart contract for handling dynamic contract minting.
        @dev This allows creators to mint a unique serial edition of the same media within a custom contract
        @author iain nash
        Repository: https://github.com/ourzora/nft-editions
    */
    contract SingleEditionMintable is
        ERC721Upgradeable,
        IEditionSingleMintable,
        IERC2981Upgradeable,
        OwnableUpgradeable
    {
        using CountersUpgradeable for CountersUpgradeable.Counter;
        event PriceChanged(uint256 amount);
        event EditionSold(uint256 price, address owner);
        // metadata
        string private description;
        // Media Urls
        // animation_url field in the metadata
        string private animationUrl;
        // Hash for the associated animation
        bytes32 private animationHash;
        // Image in the metadata
        string private imageUrl;
        // Hash for the associated image
        bytes32 private imageHash;
        // Total size of edition that can be minted
        uint256 public editionSize;
        // Current token id minted
        CountersUpgradeable.Counter private atEditionId;
        // Royalty amount in bps
        uint256 royaltyBPS;
        // Addresses allowed to mint edition
        mapping(address => bool) allowedMinters;
        // Price for sale
        uint256 public salePrice;
        // NFT rendering logic contract
        SharedNFTLogic private immutable sharedNFTLogic;
        // Global constructor for factory
        constructor(SharedNFTLogic _sharedNFTLogic) {
            sharedNFTLogic = _sharedNFTLogic;
        }
        /**
          @param _owner User that owns and can mint the edition, gets royalty and sales payouts and can update the base url if needed.
          @param _name Name of edition, used in the title as "$NAME NUMBER/TOTAL"
          @param _symbol Symbol of the new token contract
          @param _description Description of edition, used in the description field of the NFT
          @param _imageUrl Image URL of the edition. Strongly encouraged to be used, if necessary, only animation URL can be used. One of animation and image url need to exist in a edition to render the NFT.
          @param _imageHash SHA256 of the given image in bytes32 format (0xHASH). If no image is included, the hash can be zero.
          @param _animationUrl Animation URL of the edition. Not required, but if omitted image URL needs to be included. This follows the opensea spec for NFTs
          @param _animationHash The associated hash of the animation in sha-256 bytes32 format. If animation is omitted the hash can be zero.
          @param _editionSize Number of editions that can be minted in total. If 0, unlimited editions can be minted.
          @param _royaltyBPS BPS of the royalty set on the contract. Can be 0 for no royalty.
          @dev Function to create a new edition. Can only be called by the allowed creator
               Sets the only allowed minter to the address that creates/owns the edition.
               This can be re-assigned or updated later
         */
        function initialize(
            address _owner,
            string memory _name,
            string memory _symbol,
            string memory _description,
            string memory _animationUrl,
            bytes32 _animationHash,
            string memory _imageUrl,
            bytes32 _imageHash,
            uint256 _editionSize,
            uint256 _royaltyBPS
        ) public initializer {
            __ERC721_init(_name, _symbol);
            __Ownable_init();
            // Set ownership to original sender of contract call
            transferOwnership(_owner);
            description = _description;
            animationUrl = _animationUrl;
            animationHash = _animationHash;
            imageUrl = _imageUrl;
            imageHash = _imageHash;
            editionSize = _editionSize;
            royaltyBPS = _royaltyBPS;
            // Set edition id start to be 1 not 0
            atEditionId.increment();
        }
        /// @dev returns the number of minted tokens within the edition
        function totalSupply() public view returns (uint256) {
            return atEditionId.current() - 1;
        }
        /**
            Simple eth-based sales function
            More complex sales functions can be implemented through ISingleEditionMintable interface
         */
        /**
          @dev This allows the user to purchase a edition edition
               at the given price in the contract.
         */
        function purchase() external payable returns (uint256) {
            require(salePrice > 0, "Not for sale");
            require(msg.value == salePrice, "Wrong price");
            address[] memory toMint = new address[](1);
            toMint[0] = msg.sender;
            emit EditionSold(salePrice, msg.sender);
            return _mintEditions(toMint);
        }
        /**
          @param _salePrice if sale price is 0 sale is stopped, otherwise that amount 
                           of ETH is needed to start the sale.
          @dev This sets a simple ETH sales price
               Setting a sales price allows users to mint the edition until it sells out.
               For more granular sales, use an external sales contract.
         */
        function setSalePrice(uint256 _salePrice) external onlyOwner {
            salePrice = _salePrice;
            emit PriceChanged(salePrice);
        }
        /**
          @dev This withdraws ETH from the contract to the contract owner.
         */
        function withdraw() external onlyOwner {
            (bool sent, ) = owner().call{value: address(this).balance, gas: 34_000}(
                ""
            );
            require(sent, "Failed to send ETH");
        }
        /**
          @dev This helper function checks if the msg.sender is allowed to mint the
                given edition id.
         */
        function _isAllowedToMint() internal view returns (bool) {
            if (owner() == msg.sender) {
                return true;
            }
            if (allowedMinters[address(0x0)]) {
                return true;
            }
            return allowedMinters[msg.sender];
        }
        /**
          @param to address to send the newly minted edition to
          @dev This mints one edition to the given address by an allowed minter on the edition instance.
         */
        function mintEdition(address to) external override returns (uint256) {
            require(_isAllowedToMint(), "Needs to be an allowed minter");
            address[] memory toMint = new address[](1);
            toMint[0] = to;
            return _mintEditions(toMint);
        }
        /**
          @param recipients list of addresses to send the newly minted editions to
          @dev This mints multiple editions to the given list of addresses.
         */
        function mintEditions(address[] memory recipients)
            external
            override
            returns (uint256)
        {
            require(_isAllowedToMint(), "Needs to be an allowed minter");
            return _mintEditions(recipients);
        }
        /**
            Simple override for owner interface.
         */
        function owner()
            public
            view
            override(OwnableUpgradeable, IEditionSingleMintable)
            returns (address)
        {
            return super.owner();
        }
        /**
          @param minter address to set approved minting status for
          @param allowed boolean if that address is allowed to mint
          @dev Sets the approved minting status of the given address.
               This requires that msg.sender is the owner of the given edition id.
               If the ZeroAddress (address(0x0)) is set as a minter,
                 anyone will be allowed to mint.
               This setup is similar to setApprovalForAll in the ERC721 spec.
         */
        function setApprovedMinter(address minter, bool allowed) public onlyOwner {
            allowedMinters[minter] = allowed;
        }
        /**
          @dev Allows for updates of edition urls by the owner of the edition.
               Only URLs can be updated (data-uris are supported), hashes cannot be updated.
         */
        function updateEditionURLs(
            string memory _imageUrl,
            string memory _animationUrl
        ) public onlyOwner {
            imageUrl = _imageUrl;
            animationUrl = _animationUrl;
        }
        /// Returns the number of editions allowed to mint (max_uint256 when open edition)
        function numberCanMint() public view override returns (uint256) {
            // Return max int if open edition
            if (editionSize == 0) {
                return type(uint256).max;
            }
            // atEditionId is one-indexed hence the need to remove one here
            return editionSize + 1 - atEditionId.current();
        }
        /**
            @param tokenId Token ID to burn
            User burn function for token id 
         */
        function burn(uint256 tokenId) public {
            require(_isApprovedOrOwner(_msgSender(), tokenId), "Not approved");
            _burn(tokenId);
        }
        /**
          @dev Private function to mint als without any access checks.
               Called by the public edition minting functions.
         */
        function _mintEditions(address[] memory recipients)
            internal
            returns (uint256)
        {
            uint256 startAt = atEditionId.current();
            uint256 endAt = startAt + recipients.length - 1;
            require(editionSize == 0 || endAt <= editionSize, "Sold out");
            while (atEditionId.current() <= endAt) {
                _mint(
                    recipients[atEditionId.current() - startAt],
                    atEditionId.current()
                );
                atEditionId.increment();
            }
            return atEditionId.current();
        }
        /**
          @dev Get URIs for edition NFT
          @return imageUrl, imageHash, animationUrl, animationHash
         */
        function getURIs()
            public
            view
            returns (
                string memory,
                bytes32,
                string memory,
                bytes32
            )
        {
            return (imageUrl, imageHash, animationUrl, animationHash);
        }
        /**
            @dev Get royalty information for token
            @param _salePrice Sale price for the token
         */
        function royaltyInfo(uint256, uint256 _salePrice)
            external
            view
            override
            returns (address receiver, uint256 royaltyAmount)
        {
            if (owner() == address(0x0)) {
                return (owner(), 0);
            }
            return (owner(), (_salePrice * royaltyBPS) / 10_000);
        }
        /**
            @dev Get URI for given token id
            @param tokenId token id to get uri for
            @return base64-encoded json metadata object
        */
        function tokenURI(uint256 tokenId)
            public
            view
            override
            returns (string memory)
        {
            require(_exists(tokenId), "No token");
            return
                sharedNFTLogic.createMetadataEdition(
                    name(),
                    description,
                    imageUrl,
                    animationUrl,
                    tokenId,
                    editionSize
                );
        }
        function supportsInterface(bytes4 interfaceId)
            public
            view
            override(ERC721Upgradeable, IERC165Upgradeable)
            returns (bool)
        {
            return
                type(IERC2981Upgradeable).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;
    /**
     * @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.6;
    import {StringsUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";
    import {Base64} from "base64-sol/base64.sol";
    import {IPublicSharedMetadata} from "./IPublicSharedMetadata.sol";
    /// Shared NFT logic for rendering metadata associated with editions
    /// @dev Can safely be used for generic base64Encode and numberToString functions
    contract SharedNFTLogic is IPublicSharedMetadata {
        /// @param unencoded bytes to base64-encode
        function base64Encode(bytes memory unencoded)
            public
            pure
            override
            returns (string memory)
        {
            return Base64.encode(unencoded);
        }
        /// Proxy to openzeppelin's toString function
        /// @param value number to return as a string
        function numberToString(uint256 value)
            public
            pure
            override
            returns (string memory)
        {
            return StringsUpgradeable.toString(value);
        }
        /// Generate edition metadata from storage information as base64-json blob
        /// Combines the media data and metadata
        /// @param name Name of NFT in metadata
        /// @param description Description of NFT in metadata
        /// @param imageUrl URL of image to render for edition
        /// @param animationUrl URL of animation to render for edition
        /// @param tokenOfEdition Token ID for specific token
        /// @param editionSize Size of entire edition to show
        function createMetadataEdition(
            string memory name,
            string memory description,
            string memory imageUrl,
            string memory animationUrl,
            uint256 tokenOfEdition,
            uint256 editionSize
        ) external pure returns (string memory) {
            string memory _tokenMediaData = tokenMediaData(
                imageUrl,
                animationUrl,
                tokenOfEdition
            );
            bytes memory json = createMetadataJSON(
                name,
                description,
                _tokenMediaData,
                tokenOfEdition,
                editionSize
            );
            return encodeMetadataJSON(json);
        }
        /// Function to create the metadata json string for the nft edition
        /// @param name Name of NFT in metadata
        /// @param description Description of NFT in metadata
        /// @param mediaData Data for media to include in json object
        /// @param tokenOfEdition Token ID for specific token
        /// @param editionSize Size of entire edition to show
        function createMetadataJSON(
            string memory name,
            string memory description,
            string memory mediaData,
            uint256 tokenOfEdition,
            uint256 editionSize
        ) public pure returns (bytes memory) {
            bytes memory editionSizeText;
            if (editionSize > 0) {
                editionSizeText = abi.encodePacked(
                    "/",
                    numberToString(editionSize)
                );
            }
            return
                abi.encodePacked(
                    '{"name": "',
                    name,
                    " ",
                    numberToString(tokenOfEdition),
                    editionSizeText,
                    '", "',
                    'description": "',
                    description,
                    '", "',
                    mediaData,
                    'properties": {"number": ',
                    numberToString(tokenOfEdition),
                    ', "name": "',
                    name,
                    '"}}'
                );
        }
        /// Encodes the argument json bytes into base64-data uri format
        /// @param json Raw json to base64 and turn into a data-uri
        function encodeMetadataJSON(bytes memory json)
            public
            pure
            override
            returns (string memory)
        {
            return
                string(
                    abi.encodePacked(
                        "data:application/json;base64,",
                        base64Encode(json)
                    )
                );
        }
        /// Generates edition metadata from storage information as base64-json blob
        /// Combines the media data and metadata
        /// @param imageUrl URL of image to render for edition
        /// @param animationUrl URL of animation to render for edition
        function tokenMediaData(
            string memory imageUrl,
            string memory animationUrl,
            uint256 tokenOfEdition
        ) public pure returns (string memory) {
            bool hasImage = bytes(imageUrl).length > 0;
            bool hasAnimation = bytes(animationUrl).length > 0;
            if (hasImage && hasAnimation) {
                return
                    string(
                        abi.encodePacked(
                            'image": "',
                            imageUrl,
                            "?id=",
                            numberToString(tokenOfEdition),
                            '", "animation_url": "',
                            animationUrl,
                            "?id=",
                            numberToString(tokenOfEdition),
                            '", "'
                        )
                    );
            }
            if (hasImage) {
                return
                    string(
                        abi.encodePacked(
                            'image": "',
                            imageUrl,
                            "?id=",
                            numberToString(tokenOfEdition),
                            '", "'
                        )
                    );
            }
            if (hasAnimation) {
                return
                    string(
                        abi.encodePacked(
                            'animation_url": "',
                            animationUrl,
                            "?id=",
                            numberToString(tokenOfEdition),
                            '", "'
                        )
                    );
            }
            return "";
        }
    }
    // 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;
    /**
     * @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;
    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";
    // SPDX-License-Identifier: MIT
    /// @title Base64
    /// @author Brecht Devos - <[email protected]>
    /// @notice Provides a function for encoding some bytes in base64
    library Base64 {
        string internal constant TABLE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
        function encode(bytes memory data) internal pure returns (string memory) {
            if (data.length == 0) return '';
            
            // load the table into memory
            string memory table = TABLE;
            // multiply by 4/3 rounded up
            uint256 encodedLen = 4 * ((data.length + 2) / 3);
            // add some extra buffer at the end required for the writing
            string memory result = new string(encodedLen + 32);
            assembly {
                // set the actual output length
                mstore(result, encodedLen)
                
                // prepare the lookup table
                let tablePtr := add(table, 1)
                
                // input ptr
                let dataPtr := data
                let endPtr := add(dataPtr, mload(data))
                
                // result ptr, jump over length
                let resultPtr := add(result, 32)
                
                // run over the input, 3 bytes at a time
                for {} lt(dataPtr, endPtr) {}
                {
                   dataPtr := add(dataPtr, 3)
                   
                   // read 3 bytes
                   let input := mload(dataPtr)
                   
                   // write 4 characters
                   mstore(resultPtr, shl(248, mload(add(tablePtr, and(shr(18, input), 0x3F)))))
                   resultPtr := add(resultPtr, 1)
                   mstore(resultPtr, shl(248, mload(add(tablePtr, and(shr(12, input), 0x3F)))))
                   resultPtr := add(resultPtr, 1)
                   mstore(resultPtr, shl(248, mload(add(tablePtr, and(shr( 6, input), 0x3F)))))
                   resultPtr := add(resultPtr, 1)
                   mstore(resultPtr, shl(248, mload(add(tablePtr, and(        input,  0x3F)))))
                   resultPtr := add(resultPtr, 1)
                }
                
                // padding with '='
                switch mod(mload(data), 3)
                case 1 { mstore(sub(resultPtr, 2), shl(240, 0x3d3d)) }
                case 2 { mstore(sub(resultPtr, 1), shl(248, 0x3d)) }
            }
            
            return result;
        }
    }
    // SPDX-License-Identifier: GPL-3.0
    pragma solidity 0.8.6;
    /// Shared public library for on-chain NFT functions
    interface IPublicSharedMetadata {
        /// @param unencoded bytes to base64-encode
        function base64Encode(bytes memory unencoded)
            external
            pure
            returns (string memory);
        /// Encodes the argument json bytes into base64-data uri format
        /// @param json Raw json to base64 and turn into a data-uri
        function encodeMetadataJSON(bytes memory json)
            external
            pure
            returns (string memory);
        /// Proxy to openzeppelin's toString function
        /// @param value number to return as a string
        function numberToString(uint256 value)
            external
            pure
            returns (string memory);
    }
    // SPDX-License-Identifier: GPL-3.0
    /**
    █▄░█ █▀▀ ▀█▀   █▀▀ █▀▄ █ ▀█▀ █ █▀█ █▄░█ █▀
    █░▀█ █▀░ ░█░   ██▄ █▄▀ █ ░█░ █ █▄█ █░▀█ ▄█
    ▀█ █▀█ █▀█ ▄▀█
    █▄ █▄█ █▀▄ █▀█
     */
    pragma solidity 0.8.6;
    import {ClonesUpgradeable} from "@openzeppelin/contracts-upgradeable/proxy/ClonesUpgradeable.sol";
    import {CountersUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/CountersUpgradeable.sol";
    import "./SingleEditionMintable.sol";
    contract SingleEditionMintableCreator {
        using CountersUpgradeable for CountersUpgradeable.Counter;
        /// Counter for current contract id upgraded
        CountersUpgradeable.Counter private atContract;
        /// Address for implementation of SingleEditionMintable to clone
        address public implementation;
        /// Initializes factory with address of implementation logic
        /// @param _implementation SingleEditionMintable logic implementation contract to clone
        constructor(address _implementation) {
            implementation = _implementation;
        }
        /// Creates a new edition contract as a factory with a deterministic address
        /// Important: None of these fields (except the Url fields with the same hash) can be changed after calling
        /// @param _name Name of the edition contract
        /// @param _symbol Symbol of the edition contract
        /// @param _description Metadata: Description of the edition entry
        /// @param _animationUrl Metadata: Animation url (optional) of the edition entry
        /// @param _animationHash Metadata: SHA-256 Hash of the animation (if no animation url, can be 0x0)
        /// @param _imageUrl Metadata: Image url (semi-required) of the edition entry
        /// @param _imageHash Metadata: SHA-256 hash of the Image of the edition entry (if not image, can be 0x0)
        /// @param _editionSize Total size of the edition (number of possible editions)
        /// @param _royaltyBPS BPS amount of royalty
        function createEdition(
            string memory _name,
            string memory _symbol,
            string memory _description,
            string memory _animationUrl,
            bytes32 _animationHash,
            string memory _imageUrl,
            bytes32 _imageHash,
            uint256 _editionSize,
            uint256 _royaltyBPS
        ) external returns (uint256) {
            uint256 newId = atContract.current();
            address newContract = ClonesUpgradeable.cloneDeterministic(
                implementation,
                bytes32(abi.encodePacked(newId))
            );
            SingleEditionMintable(newContract).initialize(
                msg.sender,
                _name,
                _symbol,
                _description,
                _animationUrl,
                _animationHash,
                _imageUrl,
                _imageHash,
                _editionSize,
                _royaltyBPS
            );
            emit CreatedEdition(newId, msg.sender, _editionSize, newContract);
            // Returns the ID of the recently created minting contract
            // Also increments for the next contract creation call
            atContract.increment();
            return newId;
        }
        /// Get edition given the created ID
        /// @param editionId id of edition to get contract for
        /// @return SingleEditionMintable Edition NFT contract
        function getEditionAtId(uint256 editionId)
            external
            view
            returns (SingleEditionMintable)
        {
            return
                SingleEditionMintable(
                    ClonesUpgradeable.predictDeterministicAddress(
                        implementation,
                        bytes32(abi.encodePacked(editionId)),
                        address(this)
                    )
                );
        }
        /// Emitted when a edition is created reserving the corresponding token IDs.
        /// @param editionId ID of newly created edition
        event CreatedEdition(
            uint256 indexed editionId,
            address indexed creator,
            uint256 editionSize,
            address editionContractAddress
        );
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.0;
    /**
     * @dev https://eips.ethereum.org/EIPS/eip-1167[EIP 1167] is a standard for
     * deploying minimal proxy contracts, also known as "clones".
     *
     * > To simply and cheaply clone contract functionality in an immutable way, this standard specifies
     * > a minimal bytecode implementation that delegates all calls to a known, fixed address.
     *
     * The library includes functions to deploy a proxy using either `create` (traditional deployment) or `create2`
     * (salted deterministic deployment). It also includes functions to predict the addresses of clones deployed using the
     * deterministic method.
     *
     * _Available since v3.4._
     */
    library ClonesUpgradeable {
        /**
         * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`.
         *
         * This function uses the create opcode, which should never revert.
         */
        function clone(address implementation) internal returns (address instance) {
            assembly {
                let ptr := mload(0x40)
                mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                mstore(add(ptr, 0x14), shl(0x60, implementation))
                mstore(add(ptr, 0x28), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000)
                instance := create(0, ptr, 0x37)
            }
            require(instance != address(0), "ERC1167: create failed");
        }
        /**
         * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`.
         *
         * This function uses the create2 opcode and a `salt` to deterministically deploy
         * the clone. Using the same `implementation` and `salt` multiple time will revert, since
         * the clones cannot be deployed twice at the same address.
         */
        function cloneDeterministic(address implementation, bytes32 salt) internal returns (address instance) {
            assembly {
                let ptr := mload(0x40)
                mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                mstore(add(ptr, 0x14), shl(0x60, implementation))
                mstore(add(ptr, 0x28), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000)
                instance := create2(0, ptr, 0x37, salt)
            }
            require(instance != address(0), "ERC1167: create2 failed");
        }
        /**
         * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}.
         */
        function predictDeterministicAddress(
            address implementation,
            bytes32 salt,
            address deployer
        ) internal pure returns (address predicted) {
            assembly {
                let ptr := mload(0x40)
                mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                mstore(add(ptr, 0x14), shl(0x60, implementation))
                mstore(add(ptr, 0x28), 0x5af43d82803e903d91602b57fd5bf3ff00000000000000000000000000000000)
                mstore(add(ptr, 0x38), shl(0x60, deployer))
                mstore(add(ptr, 0x4c), salt)
                mstore(add(ptr, 0x6c), keccak256(ptr, 0x37))
                predicted := keccak256(add(ptr, 0x37), 0x55)
            }
        }
        /**
         * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}.
         */
        function predictDeterministicAddress(address implementation, bytes32 salt)
            internal
            view
            returns (address predicted)
        {
            return predictDeterministicAddress(implementation, salt, address(this));
        }
    }
    

    File 2 of 2: SingleEditionMintable
    // SPDX-License-Identifier: GPL-3.0
    pragma solidity 0.8.6;
    interface IEditionSingleMintable {
      function mintEdition(address to) external returns (uint256);
      function mintEditions(address[] memory to) external returns (uint256);
      function numberCanMint() external view returns (uint256);
      function owner() external view returns (address);
    }// SPDX-License-Identifier: GPL-3.0
    /**
    █▄░█ █▀▀ ▀█▀   █▀▀ █▀▄ █ ▀█▀ █ █▀█ █▄░█ █▀
    █░▀█ █▀░ ░█░   ██▄ █▄▀ █ ░█░ █ █▄█ █░▀█ ▄█
    ▀█ █▀█ █▀█ ▄▀█
    █▄ █▄█ █▀▄ █▀█
     */
    pragma solidity 0.8.6;
    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 {CountersUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/CountersUpgradeable.sol";
    import {SharedNFTLogic} from "./SharedNFTLogic.sol";
    import {IEditionSingleMintable} from "./IEditionSingleMintable.sol";
    /**
        This is a smart contract for handling dynamic contract minting.
        @dev This allows creators to mint a unique serial edition of the same media within a custom contract
        @author iain nash
        Repository: https://github.com/ourzora/nft-editions
    */
    contract SingleEditionMintable is
        ERC721Upgradeable,
        IEditionSingleMintable,
        IERC2981Upgradeable,
        OwnableUpgradeable
    {
        using CountersUpgradeable for CountersUpgradeable.Counter;
        event PriceChanged(uint256 amount);
        event EditionSold(uint256 price, address owner);
        // metadata
        string private description;
        // Media Urls
        // animation_url field in the metadata
        string private animationUrl;
        // Hash for the associated animation
        bytes32 private animationHash;
        // Image in the metadata
        string private imageUrl;
        // Hash for the associated image
        bytes32 private imageHash;
        // Total size of edition that can be minted
        uint256 public editionSize;
        // Current token id minted
        CountersUpgradeable.Counter private atEditionId;
        // Royalty amount in bps
        uint256 royaltyBPS;
        // Addresses allowed to mint edition
        mapping(address => bool) allowedMinters;
        // Price for sale
        uint256 public salePrice;
        // NFT rendering logic contract
        SharedNFTLogic private immutable sharedNFTLogic;
        // Global constructor for factory
        constructor(SharedNFTLogic _sharedNFTLogic) {
            sharedNFTLogic = _sharedNFTLogic;
        }
        /**
          @param _owner User that owns and can mint the edition, gets royalty and sales payouts and can update the base url if needed.
          @param _name Name of edition, used in the title as "$NAME NUMBER/TOTAL"
          @param _symbol Symbol of the new token contract
          @param _description Description of edition, used in the description field of the NFT
          @param _imageUrl Image URL of the edition. Strongly encouraged to be used, if necessary, only animation URL can be used. One of animation and image url need to exist in a edition to render the NFT.
          @param _imageHash SHA256 of the given image in bytes32 format (0xHASH). If no image is included, the hash can be zero.
          @param _animationUrl Animation URL of the edition. Not required, but if omitted image URL needs to be included. This follows the opensea spec for NFTs
          @param _animationHash The associated hash of the animation in sha-256 bytes32 format. If animation is omitted the hash can be zero.
          @param _editionSize Number of editions that can be minted in total. If 0, unlimited editions can be minted.
          @param _royaltyBPS BPS of the royalty set on the contract. Can be 0 for no royalty.
          @dev Function to create a new edition. Can only be called by the allowed creator
               Sets the only allowed minter to the address that creates/owns the edition.
               This can be re-assigned or updated later
         */
        function initialize(
            address _owner,
            string memory _name,
            string memory _symbol,
            string memory _description,
            string memory _animationUrl,
            bytes32 _animationHash,
            string memory _imageUrl,
            bytes32 _imageHash,
            uint256 _editionSize,
            uint256 _royaltyBPS
        ) public initializer {
            __ERC721_init(_name, _symbol);
            __Ownable_init();
            // Set ownership to original sender of contract call
            transferOwnership(_owner);
            description = _description;
            animationUrl = _animationUrl;
            animationHash = _animationHash;
            imageUrl = _imageUrl;
            imageHash = _imageHash;
            editionSize = _editionSize;
            royaltyBPS = _royaltyBPS;
            // Set edition id start to be 1 not 0
            atEditionId.increment();
        }
        /// @dev returns the number of minted tokens within the edition
        function totalSupply() public view returns (uint256) {
            return atEditionId.current() - 1;
        }
        /**
            Simple eth-based sales function
            More complex sales functions can be implemented through ISingleEditionMintable interface
         */
        /**
          @dev This allows the user to purchase a edition edition
               at the given price in the contract.
         */
        function purchase() external payable returns (uint256) {
            require(salePrice > 0, "Not for sale");
            require(msg.value == salePrice, "Wrong price");
            address[] memory toMint = new address[](1);
            toMint[0] = msg.sender;
            emit EditionSold(salePrice, msg.sender);
            return _mintEditions(toMint);
        }
        /**
          @param _salePrice if sale price is 0 sale is stopped, otherwise that amount 
                           of ETH is needed to start the sale.
          @dev This sets a simple ETH sales price
               Setting a sales price allows users to mint the edition until it sells out.
               For more granular sales, use an external sales contract.
         */
        function setSalePrice(uint256 _salePrice) external onlyOwner {
            salePrice = _salePrice;
            emit PriceChanged(salePrice);
        }
        /**
          @dev This withdraws ETH from the contract to the contract owner.
         */
        function withdraw() external onlyOwner {
            (bool sent, ) = owner().call{value: address(this).balance, gas: 34_000}(
                ""
            );
            require(sent, "Failed to send ETH");
        }
        /**
          @dev This helper function checks if the msg.sender is allowed to mint the
                given edition id.
         */
        function _isAllowedToMint() internal view returns (bool) {
            if (owner() == msg.sender) {
                return true;
            }
            if (allowedMinters[address(0x0)]) {
                return true;
            }
            return allowedMinters[msg.sender];
        }
        /**
          @param to address to send the newly minted edition to
          @dev This mints one edition to the given address by an allowed minter on the edition instance.
         */
        function mintEdition(address to) external override returns (uint256) {
            require(_isAllowedToMint(), "Needs to be an allowed minter");
            address[] memory toMint = new address[](1);
            toMint[0] = to;
            return _mintEditions(toMint);
        }
        /**
          @param recipients list of addresses to send the newly minted editions to
          @dev This mints multiple editions to the given list of addresses.
         */
        function mintEditions(address[] memory recipients)
            external
            override
            returns (uint256)
        {
            require(_isAllowedToMint(), "Needs to be an allowed minter");
            return _mintEditions(recipients);
        }
        /**
            Simple override for owner interface.
         */
        function owner()
            public
            view
            override(OwnableUpgradeable, IEditionSingleMintable)
            returns (address)
        {
            return super.owner();
        }
        /**
          @param minter address to set approved minting status for
          @param allowed boolean if that address is allowed to mint
          @dev Sets the approved minting status of the given address.
               This requires that msg.sender is the owner of the given edition id.
               If the ZeroAddress (address(0x0)) is set as a minter,
                 anyone will be allowed to mint.
               This setup is similar to setApprovalForAll in the ERC721 spec.
         */
        function setApprovedMinter(address minter, bool allowed) public onlyOwner {
            allowedMinters[minter] = allowed;
        }
        /**
          @dev Allows for updates of edition urls by the owner of the edition.
               Only URLs can be updated (data-uris are supported), hashes cannot be updated.
         */
        function updateEditionURLs(
            string memory _imageUrl,
            string memory _animationUrl
        ) public onlyOwner {
            imageUrl = _imageUrl;
            animationUrl = _animationUrl;
        }
        /// Returns the number of editions allowed to mint (max_uint256 when open edition)
        function numberCanMint() public view override returns (uint256) {
            // Return max int if open edition
            if (editionSize == 0) {
                return type(uint256).max;
            }
            // atEditionId is one-indexed hence the need to remove one here
            return editionSize + 1 - atEditionId.current();
        }
        /**
            @param tokenId Token ID to burn
            User burn function for token id 
         */
        function burn(uint256 tokenId) public {
            require(_isApprovedOrOwner(_msgSender(), tokenId), "Not approved");
            _burn(tokenId);
        }
        /**
          @dev Private function to mint als without any access checks.
               Called by the public edition minting functions.
         */
        function _mintEditions(address[] memory recipients)
            internal
            returns (uint256)
        {
            uint256 startAt = atEditionId.current();
            uint256 endAt = startAt + recipients.length - 1;
            require(editionSize == 0 || endAt <= editionSize, "Sold out");
            while (atEditionId.current() <= endAt) {
                _mint(
                    recipients[atEditionId.current() - startAt],
                    atEditionId.current()
                );
                atEditionId.increment();
            }
            return atEditionId.current();
        }
        /**
          @dev Get URIs for edition NFT
          @return imageUrl, imageHash, animationUrl, animationHash
         */
        function getURIs()
            public
            view
            returns (
                string memory,
                bytes32,
                string memory,
                bytes32
            )
        {
            return (imageUrl, imageHash, animationUrl, animationHash);
        }
        /**
            @dev Get royalty information for token
            @param _salePrice Sale price for the token
         */
        function royaltyInfo(uint256, uint256 _salePrice)
            external
            view
            override
            returns (address receiver, uint256 royaltyAmount)
        {
            if (owner() == address(0x0)) {
                return (owner(), 0);
            }
            return (owner(), (_salePrice * royaltyBPS) / 10_000);
        }
        /**
            @dev Get URI for given token id
            @param tokenId token id to get uri for
            @return base64-encoded json metadata object
        */
        function tokenURI(uint256 tokenId)
            public
            view
            override
            returns (string memory)
        {
            require(_exists(tokenId), "No token");
            return
                sharedNFTLogic.createMetadataEdition(
                    name(),
                    description,
                    imageUrl,
                    animationUrl,
                    tokenId,
                    editionSize
                );
        }
        function supportsInterface(bytes4 interfaceId)
            public
            view
            override(ERC721Upgradeable, IERC165Upgradeable)
            returns (bool)
        {
            return
                type(IERC2981Upgradeable).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;
    /**
     * @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.6;
    import {StringsUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";
    import {Base64} from "base64-sol/base64.sol";
    import {IPublicSharedMetadata} from "./IPublicSharedMetadata.sol";
    /// Shared NFT logic for rendering metadata associated with editions
    /// @dev Can safely be used for generic base64Encode and numberToString functions
    contract SharedNFTLogic is IPublicSharedMetadata {
        /// @param unencoded bytes to base64-encode
        function base64Encode(bytes memory unencoded)
            public
            pure
            override
            returns (string memory)
        {
            return Base64.encode(unencoded);
        }
        /// Proxy to openzeppelin's toString function
        /// @param value number to return as a string
        function numberToString(uint256 value)
            public
            pure
            override
            returns (string memory)
        {
            return StringsUpgradeable.toString(value);
        }
        /// Generate edition metadata from storage information as base64-json blob
        /// Combines the media data and metadata
        /// @param name Name of NFT in metadata
        /// @param description Description of NFT in metadata
        /// @param imageUrl URL of image to render for edition
        /// @param animationUrl URL of animation to render for edition
        /// @param tokenOfEdition Token ID for specific token
        /// @param editionSize Size of entire edition to show
        function createMetadataEdition(
            string memory name,
            string memory description,
            string memory imageUrl,
            string memory animationUrl,
            uint256 tokenOfEdition,
            uint256 editionSize
        ) external pure returns (string memory) {
            string memory _tokenMediaData = tokenMediaData(
                imageUrl,
                animationUrl,
                tokenOfEdition
            );
            bytes memory json = createMetadataJSON(
                name,
                description,
                _tokenMediaData,
                tokenOfEdition,
                editionSize
            );
            return encodeMetadataJSON(json);
        }
        /// Function to create the metadata json string for the nft edition
        /// @param name Name of NFT in metadata
        /// @param description Description of NFT in metadata
        /// @param mediaData Data for media to include in json object
        /// @param tokenOfEdition Token ID for specific token
        /// @param editionSize Size of entire edition to show
        function createMetadataJSON(
            string memory name,
            string memory description,
            string memory mediaData,
            uint256 tokenOfEdition,
            uint256 editionSize
        ) public pure returns (bytes memory) {
            bytes memory editionSizeText;
            if (editionSize > 0) {
                editionSizeText = abi.encodePacked(
                    "/",
                    numberToString(editionSize)
                );
            }
            return
                abi.encodePacked(
                    '{"name": "',
                    name,
                    " ",
                    numberToString(tokenOfEdition),
                    editionSizeText,
                    '", "',
                    'description": "',
                    description,
                    '", "',
                    mediaData,
                    'properties": {"number": ',
                    numberToString(tokenOfEdition),
                    ', "name": "',
                    name,
                    '"}}'
                );
        }
        /// Encodes the argument json bytes into base64-data uri format
        /// @param json Raw json to base64 and turn into a data-uri
        function encodeMetadataJSON(bytes memory json)
            public
            pure
            override
            returns (string memory)
        {
            return
                string(
                    abi.encodePacked(
                        "data:application/json;base64,",
                        base64Encode(json)
                    )
                );
        }
        /// Generates edition metadata from storage information as base64-json blob
        /// Combines the media data and metadata
        /// @param imageUrl URL of image to render for edition
        /// @param animationUrl URL of animation to render for edition
        function tokenMediaData(
            string memory imageUrl,
            string memory animationUrl,
            uint256 tokenOfEdition
        ) public pure returns (string memory) {
            bool hasImage = bytes(imageUrl).length > 0;
            bool hasAnimation = bytes(animationUrl).length > 0;
            if (hasImage && hasAnimation) {
                return
                    string(
                        abi.encodePacked(
                            'image": "',
                            imageUrl,
                            "?id=",
                            numberToString(tokenOfEdition),
                            '", "animation_url": "',
                            animationUrl,
                            "?id=",
                            numberToString(tokenOfEdition),
                            '", "'
                        )
                    );
            }
            if (hasImage) {
                return
                    string(
                        abi.encodePacked(
                            'image": "',
                            imageUrl,
                            "?id=",
                            numberToString(tokenOfEdition),
                            '", "'
                        )
                    );
            }
            if (hasAnimation) {
                return
                    string(
                        abi.encodePacked(
                            'animation_url": "',
                            animationUrl,
                            "?id=",
                            numberToString(tokenOfEdition),
                            '", "'
                        )
                    );
            }
            return "";
        }
    }
    // 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;
    /**
     * @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;
    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";
    // SPDX-License-Identifier: MIT
    /// @title Base64
    /// @author Brecht Devos - <[email protected]>
    /// @notice Provides a function for encoding some bytes in base64
    library Base64 {
        string internal constant TABLE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
        function encode(bytes memory data) internal pure returns (string memory) {
            if (data.length == 0) return '';
            
            // load the table into memory
            string memory table = TABLE;
            // multiply by 4/3 rounded up
            uint256 encodedLen = 4 * ((data.length + 2) / 3);
            // add some extra buffer at the end required for the writing
            string memory result = new string(encodedLen + 32);
            assembly {
                // set the actual output length
                mstore(result, encodedLen)
                
                // prepare the lookup table
                let tablePtr := add(table, 1)
                
                // input ptr
                let dataPtr := data
                let endPtr := add(dataPtr, mload(data))
                
                // result ptr, jump over length
                let resultPtr := add(result, 32)
                
                // run over the input, 3 bytes at a time
                for {} lt(dataPtr, endPtr) {}
                {
                   dataPtr := add(dataPtr, 3)
                   
                   // read 3 bytes
                   let input := mload(dataPtr)
                   
                   // write 4 characters
                   mstore(resultPtr, shl(248, mload(add(tablePtr, and(shr(18, input), 0x3F)))))
                   resultPtr := add(resultPtr, 1)
                   mstore(resultPtr, shl(248, mload(add(tablePtr, and(shr(12, input), 0x3F)))))
                   resultPtr := add(resultPtr, 1)
                   mstore(resultPtr, shl(248, mload(add(tablePtr, and(shr( 6, input), 0x3F)))))
                   resultPtr := add(resultPtr, 1)
                   mstore(resultPtr, shl(248, mload(add(tablePtr, and(        input,  0x3F)))))
                   resultPtr := add(resultPtr, 1)
                }
                
                // padding with '='
                switch mod(mload(data), 3)
                case 1 { mstore(sub(resultPtr, 2), shl(240, 0x3d3d)) }
                case 2 { mstore(sub(resultPtr, 1), shl(248, 0x3d)) }
            }
            
            return result;
        }
    }
    // SPDX-License-Identifier: GPL-3.0
    pragma solidity 0.8.6;
    /// Shared public library for on-chain NFT functions
    interface IPublicSharedMetadata {
        /// @param unencoded bytes to base64-encode
        function base64Encode(bytes memory unencoded)
            external
            pure
            returns (string memory);
        /// Encodes the argument json bytes into base64-data uri format
        /// @param json Raw json to base64 and turn into a data-uri
        function encodeMetadataJSON(bytes memory json)
            external
            pure
            returns (string memory);
        /// Proxy to openzeppelin's toString function
        /// @param value number to return as a string
        function numberToString(uint256 value)
            external
            pure
            returns (string memory);
    }
    // SPDX-License-Identifier: GPL-3.0
    /**
    █▄░█ █▀▀ ▀█▀   █▀▀ █▀▄ █ ▀█▀ █ █▀█ █▄░█ █▀
    █░▀█ █▀░ ░█░   ██▄ █▄▀ █ ░█░ █ █▄█ █░▀█ ▄█
    ▀█ █▀█ █▀█ ▄▀█
    █▄ █▄█ █▀▄ █▀█
     */
    pragma solidity 0.8.6;
    import {ClonesUpgradeable} from "@openzeppelin/contracts-upgradeable/proxy/ClonesUpgradeable.sol";
    import {CountersUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/CountersUpgradeable.sol";
    import "./SingleEditionMintable.sol";
    contract SingleEditionMintableCreator {
        using CountersUpgradeable for CountersUpgradeable.Counter;
        /// Counter for current contract id upgraded
        CountersUpgradeable.Counter private atContract;
        /// Address for implementation of SingleEditionMintable to clone
        address public implementation;
        /// Initializes factory with address of implementation logic
        /// @param _implementation SingleEditionMintable logic implementation contract to clone
        constructor(address _implementation) {
            implementation = _implementation;
        }
        /// Creates a new edition contract as a factory with a deterministic address
        /// Important: None of these fields (except the Url fields with the same hash) can be changed after calling
        /// @param _name Name of the edition contract
        /// @param _symbol Symbol of the edition contract
        /// @param _description Metadata: Description of the edition entry
        /// @param _animationUrl Metadata: Animation url (optional) of the edition entry
        /// @param _animationHash Metadata: SHA-256 Hash of the animation (if no animation url, can be 0x0)
        /// @param _imageUrl Metadata: Image url (semi-required) of the edition entry
        /// @param _imageHash Metadata: SHA-256 hash of the Image of the edition entry (if not image, can be 0x0)
        /// @param _editionSize Total size of the edition (number of possible editions)
        /// @param _royaltyBPS BPS amount of royalty
        function createEdition(
            string memory _name,
            string memory _symbol,
            string memory _description,
            string memory _animationUrl,
            bytes32 _animationHash,
            string memory _imageUrl,
            bytes32 _imageHash,
            uint256 _editionSize,
            uint256 _royaltyBPS
        ) external returns (uint256) {
            uint256 newId = atContract.current();
            address newContract = ClonesUpgradeable.cloneDeterministic(
                implementation,
                bytes32(abi.encodePacked(newId))
            );
            SingleEditionMintable(newContract).initialize(
                msg.sender,
                _name,
                _symbol,
                _description,
                _animationUrl,
                _animationHash,
                _imageUrl,
                _imageHash,
                _editionSize,
                _royaltyBPS
            );
            emit CreatedEdition(newId, msg.sender, _editionSize, newContract);
            // Returns the ID of the recently created minting contract
            // Also increments for the next contract creation call
            atContract.increment();
            return newId;
        }
        /// Get edition given the created ID
        /// @param editionId id of edition to get contract for
        /// @return SingleEditionMintable Edition NFT contract
        function getEditionAtId(uint256 editionId)
            external
            view
            returns (SingleEditionMintable)
        {
            return
                SingleEditionMintable(
                    ClonesUpgradeable.predictDeterministicAddress(
                        implementation,
                        bytes32(abi.encodePacked(editionId)),
                        address(this)
                    )
                );
        }
        /// Emitted when a edition is created reserving the corresponding token IDs.
        /// @param editionId ID of newly created edition
        event CreatedEdition(
            uint256 indexed editionId,
            address indexed creator,
            uint256 editionSize,
            address editionContractAddress
        );
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.0;
    /**
     * @dev https://eips.ethereum.org/EIPS/eip-1167[EIP 1167] is a standard for
     * deploying minimal proxy contracts, also known as "clones".
     *
     * > To simply and cheaply clone contract functionality in an immutable way, this standard specifies
     * > a minimal bytecode implementation that delegates all calls to a known, fixed address.
     *
     * The library includes functions to deploy a proxy using either `create` (traditional deployment) or `create2`
     * (salted deterministic deployment). It also includes functions to predict the addresses of clones deployed using the
     * deterministic method.
     *
     * _Available since v3.4._
     */
    library ClonesUpgradeable {
        /**
         * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`.
         *
         * This function uses the create opcode, which should never revert.
         */
        function clone(address implementation) internal returns (address instance) {
            assembly {
                let ptr := mload(0x40)
                mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                mstore(add(ptr, 0x14), shl(0x60, implementation))
                mstore(add(ptr, 0x28), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000)
                instance := create(0, ptr, 0x37)
            }
            require(instance != address(0), "ERC1167: create failed");
        }
        /**
         * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`.
         *
         * This function uses the create2 opcode and a `salt` to deterministically deploy
         * the clone. Using the same `implementation` and `salt` multiple time will revert, since
         * the clones cannot be deployed twice at the same address.
         */
        function cloneDeterministic(address implementation, bytes32 salt) internal returns (address instance) {
            assembly {
                let ptr := mload(0x40)
                mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                mstore(add(ptr, 0x14), shl(0x60, implementation))
                mstore(add(ptr, 0x28), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000)
                instance := create2(0, ptr, 0x37, salt)
            }
            require(instance != address(0), "ERC1167: create2 failed");
        }
        /**
         * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}.
         */
        function predictDeterministicAddress(
            address implementation,
            bytes32 salt,
            address deployer
        ) internal pure returns (address predicted) {
            assembly {
                let ptr := mload(0x40)
                mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                mstore(add(ptr, 0x14), shl(0x60, implementation))
                mstore(add(ptr, 0x28), 0x5af43d82803e903d91602b57fd5bf3ff00000000000000000000000000000000)
                mstore(add(ptr, 0x38), shl(0x60, deployer))
                mstore(add(ptr, 0x4c), salt)
                mstore(add(ptr, 0x6c), keccak256(ptr, 0x37))
                predicted := keccak256(add(ptr, 0x37), 0x55)
            }
        }
        /**
         * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}.
         */
        function predictDeterministicAddress(address implementation, bytes32 salt)
            internal
            view
            returns (address predicted)
        {
            return predictDeterministicAddress(implementation, salt, address(this));
        }
    }