ETH Price: $1,905.24 (-0.32%)

Transaction Decoder

Block:
18175550 at Sep-20-2023 07:15:47 AM +UTC
Transaction Fee:
0.00388940821181055 ETH $7.41
Gas Used:
465,491 Gas / 8.35549605 Gwei

Emitted Events:

186 OperatorFilterRegistry.RegistrationUpdated( registrant=ErcForge721Template, registered=True )
187 OperatorFilterRegistry.SubscriptionUpdated( registrant=ErcForge721Template, subscription=0x3cc6CddA...f810dCeB6, subscribed=True )
188 ErcForgeDeployer.ContractCreated( contractAddress=ErcForge721Template )

Account State Difference:

  Address   Before After State Difference Code
0x00000000...67333cd4E
(Titan Builder)
35.81528532692607485 Eth35.81533187602607485 Eth0.0000465491
0x909A38c6...D5692127E
0xbb20Cd68...62d7Adb9F
0.030757870100106 Eth
Nonce: 40
0.02686846188829545 Eth
Nonce: 41
0.00388940821181055
0xC0fAb784...c88b53920
0 Eth
Nonce: 0
0 Eth
Nonce: 1
From: 0 To: 497590261154554171967157369623148839472586902540664793565547334040063514084375450760125665866864099665468403

Execution Trace

ErcForgeDeployer.createContract( contractType=721, name=3D Nakamigos 1:1, symbol=D&E, uri=https://api.ercforge.io/contract/119/token/, contractUri=https://api.ercforge.io/contract/119, royaltyAddresses=0xbb20Cd68F7CeA68fd896A834ed6D9E562d7Adb9F, royaltyFee=690, referrer=0xFC8FD03E4faF7e2B7780Bd17e82bc9FEB2D6Cf38 ) => ( 0xC0fAb784cCcc0a67A4A9ab7728cf185c88b53920 )
  • ErcForge721Template.3d602d80( )
  • ErcForge721Template.init( newOwner=0xbb20Cd68F7CeA68fd896A834ed6D9E562d7Adb9F, newName=3D Nakamigos 1:1, newSymbol=D&E, newBaseTokenURI=https://api.ercforge.io/contract/119/token/, newContractURI=https://api.ercforge.io/contract/119, royaltyReceiver=0xbb20Cd68F7CeA68fd896A834ed6D9E562d7Adb9F, royaltyFee=690 )
    • ErcForge721Template.init( newOwner=0xbb20Cd68F7CeA68fd896A834ed6D9E562d7Adb9F, newName=3D Nakamigos 1:1, newSymbol=D&E, newBaseTokenURI=https://api.ercforge.io/contract/119/token/, newContractURI=https://api.ercforge.io/contract/119, royaltyReceiver=0xbb20Cd68F7CeA68fd896A834ed6D9E562d7Adb9F, royaltyFee=690 )
      • OperatorFilterRegistry.registerAndSubscribe( registrant=0xC0fAb784cCcc0a67A4A9ab7728cf185c88b53920, subscription=0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6 )
        File 1 of 4: ErcForgeDeployer
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC1155/ERC1155.sol)
        pragma solidity ^0.8.0;
        import "./IERC1155.sol";
        import "./IERC1155Receiver.sol";
        import "./extensions/IERC1155MetadataURI.sol";
        import "../../utils/Address.sol";
        import "../../utils/Context.sol";
        import "../../utils/introspection/ERC165.sol";
        /**
         * @dev Implementation of the basic standard multi-token.
         * See https://eips.ethereum.org/EIPS/eip-1155
         * Originally based on code by Enjin: https://github.com/enjin/erc-1155
         *
         * _Available since v3.1._
         */
        contract ERC1155 is Context, ERC165, IERC1155, IERC1155MetadataURI {
            using Address for address;
            // Mapping from token ID to account balances
            mapping(uint256 => mapping(address => uint256)) private _balances;
            // Mapping from account to operator approvals
            mapping(address => mapping(address => bool)) private _operatorApprovals;
            // Used as the URI for all token types by relying on ID substitution, e.g. https://token-cdn-domain/{id}.json
            string private _uri;
            /**
             * @dev See {_setURI}.
             */
            constructor(string memory uri_) {
                _setURI(uri_);
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
                return
                    interfaceId == type(IERC1155).interfaceId ||
                    interfaceId == type(IERC1155MetadataURI).interfaceId ||
                    super.supportsInterface(interfaceId);
            }
            /**
             * @dev See {IERC1155MetadataURI-uri}.
             *
             * This implementation returns the same URI for *all* token types. It relies
             * on the token type ID substitution mechanism
             * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
             *
             * Clients calling this function must replace the `\\{id\\}` substring with the
             * actual token type ID.
             */
            function uri(uint256) public view virtual override returns (string memory) {
                return _uri;
            }
            /**
             * @dev See {IERC1155-balanceOf}.
             *
             * Requirements:
             *
             * - `account` cannot be the zero address.
             */
            function balanceOf(address account, uint256 id) public view virtual override returns (uint256) {
                require(account != address(0), "ERC1155: address zero is not a valid owner");
                return _balances[id][account];
            }
            /**
             * @dev See {IERC1155-balanceOfBatch}.
             *
             * Requirements:
             *
             * - `accounts` and `ids` must have the same length.
             */
            function balanceOfBatch(address[] memory accounts, uint256[] memory ids)
                public
                view
                virtual
                override
                returns (uint256[] memory)
            {
                require(accounts.length == ids.length, "ERC1155: accounts and ids length mismatch");
                uint256[] memory batchBalances = new uint256[](accounts.length);
                for (uint256 i = 0; i < accounts.length; ++i) {
                    batchBalances[i] = balanceOf(accounts[i], ids[i]);
                }
                return batchBalances;
            }
            /**
             * @dev See {IERC1155-setApprovalForAll}.
             */
            function setApprovalForAll(address operator, bool approved) public virtual override {
                _setApprovalForAll(_msgSender(), operator, approved);
            }
            /**
             * @dev See {IERC1155-isApprovedForAll}.
             */
            function isApprovedForAll(address account, address operator) public view virtual override returns (bool) {
                return _operatorApprovals[account][operator];
            }
            /**
             * @dev See {IERC1155-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 id,
                uint256 amount,
                bytes memory data
            ) public virtual override {
                require(
                    from == _msgSender() || isApprovedForAll(from, _msgSender()),
                    "ERC1155: caller is not token owner or approved"
                );
                _safeTransferFrom(from, to, id, amount, data);
            }
            /**
             * @dev See {IERC1155-safeBatchTransferFrom}.
             */
            function safeBatchTransferFrom(
                address from,
                address to,
                uint256[] memory ids,
                uint256[] memory amounts,
                bytes memory data
            ) public virtual override {
                require(
                    from == _msgSender() || isApprovedForAll(from, _msgSender()),
                    "ERC1155: caller is not token owner or approved"
                );
                _safeBatchTransferFrom(from, to, ids, amounts, data);
            }
            /**
             * @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
             *
             * Emits a {TransferSingle} event.
             *
             * Requirements:
             *
             * - `to` cannot be the zero address.
             * - `from` must have a balance of tokens of type `id` of at least `amount`.
             * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
             * acceptance magic value.
             */
            function _safeTransferFrom(
                address from,
                address to,
                uint256 id,
                uint256 amount,
                bytes memory data
            ) internal virtual {
                require(to != address(0), "ERC1155: transfer to the zero address");
                address operator = _msgSender();
                uint256[] memory ids = _asSingletonArray(id);
                uint256[] memory amounts = _asSingletonArray(amount);
                _beforeTokenTransfer(operator, from, to, ids, amounts, data);
                uint256 fromBalance = _balances[id][from];
                require(fromBalance >= amount, "ERC1155: insufficient balance for transfer");
                unchecked {
                    _balances[id][from] = fromBalance - amount;
                }
                _balances[id][to] += amount;
                emit TransferSingle(operator, from, to, id, amount);
                _afterTokenTransfer(operator, from, to, ids, amounts, data);
                _doSafeTransferAcceptanceCheck(operator, from, to, id, amount, data);
            }
            /**
             * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_safeTransferFrom}.
             *
             * Emits a {TransferBatch} event.
             *
             * Requirements:
             *
             * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
             * acceptance magic value.
             */
            function _safeBatchTransferFrom(
                address from,
                address to,
                uint256[] memory ids,
                uint256[] memory amounts,
                bytes memory data
            ) internal virtual {
                require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch");
                require(to != address(0), "ERC1155: transfer to the zero address");
                address operator = _msgSender();
                _beforeTokenTransfer(operator, from, to, ids, amounts, data);
                for (uint256 i = 0; i < ids.length; ++i) {
                    uint256 id = ids[i];
                    uint256 amount = amounts[i];
                    uint256 fromBalance = _balances[id][from];
                    require(fromBalance >= amount, "ERC1155: insufficient balance for transfer");
                    unchecked {
                        _balances[id][from] = fromBalance - amount;
                    }
                    _balances[id][to] += amount;
                }
                emit TransferBatch(operator, from, to, ids, amounts);
                _afterTokenTransfer(operator, from, to, ids, amounts, data);
                _doSafeBatchTransferAcceptanceCheck(operator, from, to, ids, amounts, data);
            }
            /**
             * @dev Sets a new URI for all token types, by relying on the token type ID
             * substitution mechanism
             * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
             *
             * By this mechanism, any occurrence of the `\\{id\\}` substring in either the
             * URI or any of the amounts in the JSON file at said URI will be replaced by
             * clients with the token type ID.
             *
             * For example, the `https://token-cdn-domain/\\{id\\}.json` URI would be
             * interpreted by clients as
             * `https://token-cdn-domain/000000000000000000000000000000000000000000000000000000000004cce0.json`
             * for token type ID 0x4cce0.
             *
             * See {uri}.
             *
             * Because these URIs cannot be meaningfully represented by the {URI} event,
             * this function emits no events.
             */
            function _setURI(string memory newuri) internal virtual {
                _uri = newuri;
            }
            /**
             * @dev Creates `amount` tokens of token type `id`, and assigns them to `to`.
             *
             * Emits a {TransferSingle} event.
             *
             * Requirements:
             *
             * - `to` cannot be the zero address.
             * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
             * acceptance magic value.
             */
            function _mint(
                address to,
                uint256 id,
                uint256 amount,
                bytes memory data
            ) internal virtual {
                require(to != address(0), "ERC1155: mint to the zero address");
                address operator = _msgSender();
                uint256[] memory ids = _asSingletonArray(id);
                uint256[] memory amounts = _asSingletonArray(amount);
                _beforeTokenTransfer(operator, address(0), to, ids, amounts, data);
                _balances[id][to] += amount;
                emit TransferSingle(operator, address(0), to, id, amount);
                _afterTokenTransfer(operator, address(0), to, ids, amounts, data);
                _doSafeTransferAcceptanceCheck(operator, address(0), to, id, amount, data);
            }
            /**
             * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}.
             *
             * Emits a {TransferBatch} event.
             *
             * Requirements:
             *
             * - `ids` and `amounts` must have the same length.
             * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
             * acceptance magic value.
             */
            function _mintBatch(
                address to,
                uint256[] memory ids,
                uint256[] memory amounts,
                bytes memory data
            ) internal virtual {
                require(to != address(0), "ERC1155: mint to the zero address");
                require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch");
                address operator = _msgSender();
                _beforeTokenTransfer(operator, address(0), to, ids, amounts, data);
                for (uint256 i = 0; i < ids.length; i++) {
                    _balances[ids[i]][to] += amounts[i];
                }
                emit TransferBatch(operator, address(0), to, ids, amounts);
                _afterTokenTransfer(operator, address(0), to, ids, amounts, data);
                _doSafeBatchTransferAcceptanceCheck(operator, address(0), to, ids, amounts, data);
            }
            /**
             * @dev Destroys `amount` tokens of token type `id` from `from`
             *
             * Emits a {TransferSingle} event.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `from` must have at least `amount` tokens of token type `id`.
             */
            function _burn(
                address from,
                uint256 id,
                uint256 amount
            ) internal virtual {
                require(from != address(0), "ERC1155: burn from the zero address");
                address operator = _msgSender();
                uint256[] memory ids = _asSingletonArray(id);
                uint256[] memory amounts = _asSingletonArray(amount);
                _beforeTokenTransfer(operator, from, address(0), ids, amounts, "");
                uint256 fromBalance = _balances[id][from];
                require(fromBalance >= amount, "ERC1155: burn amount exceeds balance");
                unchecked {
                    _balances[id][from] = fromBalance - amount;
                }
                emit TransferSingle(operator, from, address(0), id, amount);
                _afterTokenTransfer(operator, from, address(0), ids, amounts, "");
            }
            /**
             * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_burn}.
             *
             * Emits a {TransferBatch} event.
             *
             * Requirements:
             *
             * - `ids` and `amounts` must have the same length.
             */
            function _burnBatch(
                address from,
                uint256[] memory ids,
                uint256[] memory amounts
            ) internal virtual {
                require(from != address(0), "ERC1155: burn from the zero address");
                require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch");
                address operator = _msgSender();
                _beforeTokenTransfer(operator, from, address(0), ids, amounts, "");
                for (uint256 i = 0; i < ids.length; i++) {
                    uint256 id = ids[i];
                    uint256 amount = amounts[i];
                    uint256 fromBalance = _balances[id][from];
                    require(fromBalance >= amount, "ERC1155: burn amount exceeds balance");
                    unchecked {
                        _balances[id][from] = fromBalance - amount;
                    }
                }
                emit TransferBatch(operator, from, address(0), ids, amounts);
                _afterTokenTransfer(operator, from, address(0), ids, amounts, "");
            }
            /**
             * @dev Approve `operator` to operate on all of `owner` tokens
             *
             * Emits an {ApprovalForAll} event.
             */
            function _setApprovalForAll(
                address owner,
                address operator,
                bool approved
            ) internal virtual {
                require(owner != operator, "ERC1155: setting approval status for self");
                _operatorApprovals[owner][operator] = approved;
                emit ApprovalForAll(owner, operator, approved);
            }
            /**
             * @dev Hook that is called before any token transfer. This includes minting
             * and burning, as well as batched variants.
             *
             * The same hook is called on both single and batched variants. For single
             * transfers, the length of the `ids` and `amounts` arrays will be 1.
             *
             * Calling conditions (for each `id` and `amount` pair):
             *
             * - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
             * of token type `id` will be  transferred to `to`.
             * - When `from` is zero, `amount` tokens of token type `id` will be minted
             * for `to`.
             * - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
             * will be burned.
             * - `from` and `to` are never both zero.
             * - `ids` and `amounts` have the same, non-zero length.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _beforeTokenTransfer(
                address operator,
                address from,
                address to,
                uint256[] memory ids,
                uint256[] memory amounts,
                bytes memory data
            ) internal virtual {}
            /**
             * @dev Hook that is called after any token transfer. This includes minting
             * and burning, as well as batched variants.
             *
             * The same hook is called on both single and batched variants. For single
             * transfers, the length of the `id` and `amount` arrays will be 1.
             *
             * Calling conditions (for each `id` and `amount` pair):
             *
             * - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
             * of token type `id` will be  transferred to `to`.
             * - When `from` is zero, `amount` tokens of token type `id` will be minted
             * for `to`.
             * - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
             * will be burned.
             * - `from` and `to` are never both zero.
             * - `ids` and `amounts` have the same, non-zero length.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _afterTokenTransfer(
                address operator,
                address from,
                address to,
                uint256[] memory ids,
                uint256[] memory amounts,
                bytes memory data
            ) internal virtual {}
            function _doSafeTransferAcceptanceCheck(
                address operator,
                address from,
                address to,
                uint256 id,
                uint256 amount,
                bytes memory data
            ) private {
                if (to.isContract()) {
                    try IERC1155Receiver(to).onERC1155Received(operator, from, id, amount, data) returns (bytes4 response) {
                        if (response != IERC1155Receiver.onERC1155Received.selector) {
                            revert("ERC1155: ERC1155Receiver rejected tokens");
                        }
                    } catch Error(string memory reason) {
                        revert(reason);
                    } catch {
                        revert("ERC1155: transfer to non-ERC1155Receiver implementer");
                    }
                }
            }
            function _doSafeBatchTransferAcceptanceCheck(
                address operator,
                address from,
                address to,
                uint256[] memory ids,
                uint256[] memory amounts,
                bytes memory data
            ) private {
                if (to.isContract()) {
                    try IERC1155Receiver(to).onERC1155BatchReceived(operator, from, ids, amounts, data) returns (
                        bytes4 response
                    ) {
                        if (response != IERC1155Receiver.onERC1155BatchReceived.selector) {
                            revert("ERC1155: ERC1155Receiver rejected tokens");
                        }
                    } catch Error(string memory reason) {
                        revert(reason);
                    } catch {
                        revert("ERC1155: transfer to non-ERC1155Receiver implementer");
                    }
                }
            }
            function _asSingletonArray(uint256 element) private pure returns (uint256[] memory) {
                uint256[] memory array = new uint256[](1);
                array[0] = element;
                return array;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC1155/extensions/IERC1155MetadataURI.sol)
        pragma solidity ^0.8.0;
        import "../IERC1155.sol";
        /**
         * @dev Interface of the optional ERC1155MetadataExtension interface, as defined
         * in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[EIP].
         *
         * _Available since v3.1._
         */
        interface IERC1155MetadataURI is IERC1155 {
            /**
             * @dev Returns the URI for token type `id`.
             *
             * If the `\\{id\\}` substring is present in the URI, it must be replaced by
             * clients with the actual token type ID.
             */
            function uri(uint256 id) external view returns (string memory);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC1155/IERC1155.sol)
        pragma solidity ^0.8.0;
        import "../../utils/introspection/IERC165.sol";
        /**
         * @dev Required interface of an ERC1155 compliant contract, as defined in the
         * https://eips.ethereum.org/EIPS/eip-1155[EIP].
         *
         * _Available since v3.1._
         */
        interface IERC1155 is IERC165 {
            /**
             * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
             */
            event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
            /**
             * @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
             * transfers.
             */
            event TransferBatch(
                address indexed operator,
                address indexed from,
                address indexed to,
                uint256[] ids,
                uint256[] values
            );
            /**
             * @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
             * `approved`.
             */
            event ApprovalForAll(address indexed account, address indexed operator, bool approved);
            /**
             * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
             *
             * If an {URI} event was emitted for `id`, the standard
             * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
             * returned by {IERC1155MetadataURI-uri}.
             */
            event URI(string value, uint256 indexed id);
            /**
             * @dev Returns the amount of tokens of token type `id` owned by `account`.
             *
             * Requirements:
             *
             * - `account` cannot be the zero address.
             */
            function balanceOf(address account, uint256 id) external view returns (uint256);
            /**
             * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
             *
             * Requirements:
             *
             * - `accounts` and `ids` must have the same length.
             */
            function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids)
                external
                view
                returns (uint256[] memory);
            /**
             * @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
             *
             * Emits an {ApprovalForAll} event.
             *
             * Requirements:
             *
             * - `operator` cannot be the caller.
             */
            function setApprovalForAll(address operator, bool approved) external;
            /**
             * @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
             *
             * See {setApprovalForAll}.
             */
            function isApprovedForAll(address account, address operator) external view returns (bool);
            /**
             * @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
             *
             * Emits a {TransferSingle} event.
             *
             * Requirements:
             *
             * - `to` cannot be the zero address.
             * - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
             * - `from` must have a balance of tokens of type `id` of at least `amount`.
             * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
             * acceptance magic value.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 id,
                uint256 amount,
                bytes calldata data
            ) external;
            /**
             * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
             *
             * Emits a {TransferBatch} event.
             *
             * Requirements:
             *
             * - `ids` and `amounts` must have the same length.
             * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
             * acceptance magic value.
             */
            function safeBatchTransferFrom(
                address from,
                address to,
                uint256[] calldata ids,
                uint256[] calldata amounts,
                bytes calldata data
            ) external;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.5.0) (token/ERC1155/IERC1155Receiver.sol)
        pragma solidity ^0.8.0;
        import "../../utils/introspection/IERC165.sol";
        /**
         * @dev _Available since v3.1._
         */
        interface IERC1155Receiver is IERC165 {
            /**
             * @dev Handles the receipt of a single ERC1155 token type. This function is
             * called at the end of a `safeTransferFrom` after the balance has been updated.
             *
             * NOTE: To accept the transfer, this must return
             * `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
             * (i.e. 0xf23a6e61, or its own function selector).
             *
             * @param operator The address which initiated the transfer (i.e. msg.sender)
             * @param from The address which previously owned the token
             * @param id The ID of the token being transferred
             * @param value The amount of tokens being transferred
             * @param data Additional data with no specified format
             * @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
             */
            function onERC1155Received(
                address operator,
                address from,
                uint256 id,
                uint256 value,
                bytes calldata data
            ) external returns (bytes4);
            /**
             * @dev Handles the receipt of a multiple ERC1155 token types. This function
             * is called at the end of a `safeBatchTransferFrom` after the balances have
             * been updated.
             *
             * NOTE: To accept the transfer(s), this must return
             * `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
             * (i.e. 0xbc197c81, or its own function selector).
             *
             * @param operator The address which initiated the batch transfer (i.e. msg.sender)
             * @param from The address which previously owned the token
             * @param ids An array containing ids of each token being transferred (order and length must match values array)
             * @param values An array containing amounts of each token being transferred (order and length must match ids array)
             * @param data Additional data with no specified format
             * @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
             */
            function onERC1155BatchReceived(
                address operator,
                address from,
                uint256[] calldata ids,
                uint256[] calldata values,
                bytes calldata data
            ) external returns (bytes4);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
        pragma solidity ^0.8.1;
        /**
         * @dev Collection of functions related to the address type
         */
        library Address {
            /**
             * @dev Returns true if `account` is a contract.
             *
             * [IMPORTANT]
             * ====
             * It is unsafe to assume that an address for which this function returns
             * false is an externally-owned account (EOA) and not a contract.
             *
             * Among others, `isContract` will return false for the following
             * types of addresses:
             *
             *  - an externally-owned account
             *  - a contract in construction
             *  - an address where a contract will be created
             *  - an address where a contract lived, but was destroyed
             * ====
             *
             * [IMPORTANT]
             * ====
             * You shouldn't rely on `isContract` to protect against flash loan attacks!
             *
             * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
             * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
             * constructor.
             * ====
             */
            function isContract(address account) internal view returns (bool) {
                // This method relies on extcodesize/address.code.length, which returns 0
                // for contracts in construction, since the code is only stored at the end
                // of the constructor execution.
                return account.code.length > 0;
            }
            /**
             * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
             * `recipient`, forwarding all available gas and reverting on errors.
             *
             * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
             * of certain opcodes, possibly making contracts go over the 2300 gas limit
             * imposed by `transfer`, making them unable to receive funds via
             * `transfer`. {sendValue} removes this limitation.
             *
             * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
             *
             * IMPORTANT: because control is transferred to `recipient`, care must be
             * taken to not create reentrancy vulnerabilities. Consider using
             * {ReentrancyGuard} or the
             * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
             */
            function sendValue(address payable recipient, uint256 amount) internal {
                require(address(this).balance >= amount, "Address: insufficient balance");
                (bool success, ) = recipient.call{value: amount}("");
                require(success, "Address: unable to send value, recipient may have reverted");
            }
            /**
             * @dev Performs a Solidity function call using a low level `call`. A
             * plain `call` is an unsafe replacement for a function call: use this
             * function instead.
             *
             * If `target` reverts with a revert reason, it is bubbled up by this
             * function (like regular Solidity function calls).
             *
             * Returns the raw returned data. To convert to the expected return value,
             * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
             *
             * Requirements:
             *
             * - `target` must be a contract.
             * - calling `target` with `data` must not revert.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, "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");
                (bool success, bytes memory returndata) = target.call{value: value}(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                return functionStaticCall(target, data, "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) {
                (bool success, bytes memory returndata) = target.staticcall(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionDelegateCall(target, data, "Address: low-level delegate call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                (bool success, bytes memory returndata) = target.delegatecall(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
             * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
             *
             * _Available since v4.8._
             */
            function verifyCallResultFromTarget(
                address target,
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal view returns (bytes memory) {
                if (success) {
                    if (returndata.length == 0) {
                        // only check isContract if the call was successful and the return data is empty
                        // otherwise we already know that it was a contract
                        require(isContract(target), "Address: call to non-contract");
                    }
                    return returndata;
                } else {
                    _revert(returndata, errorMessage);
                }
            }
            /**
             * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
             * revert reason or using the provided one.
             *
             * _Available since v4.3._
             */
            function verifyCallResult(
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal pure returns (bytes memory) {
                if (success) {
                    return returndata;
                } else {
                    _revert(returndata, errorMessage);
                }
            }
            function _revert(bytes memory returndata, string memory errorMessage) private pure {
                // Look for revert reason and bubble it up if present
                if (returndata.length > 0) {
                    // The easiest way to bubble the revert reason is using memory via assembly
                    /// @solidity memory-safe-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Provides information about the current execution context, including the
         * sender of the transaction and its data. While these are generally available
         * via msg.sender and msg.data, they should not be accessed in such a direct
         * manner, since when dealing with meta-transactions the account sending and
         * paying for execution may not be the actual sender (as far as an application
         * is concerned).
         *
         * This contract is only required for intermediate, library-like contracts.
         */
        abstract contract Context {
            function _msgSender() internal view virtual returns (address) {
                return msg.sender;
            }
            function _msgData() internal view virtual returns (bytes calldata) {
                return msg.data;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
        pragma solidity ^0.8.0;
        import "./IERC165.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 ERC165 is IERC165 {
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                return interfaceId == type(IERC165).interfaceId;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC165 standard, as defined in the
         * https://eips.ethereum.org/EIPS/eip-165[EIP].
         *
         * Implementers can declare support of contract interfaces, which can then be
         * queried by others ({ERC165Checker}).
         *
         * For an implementation, see {ERC165}.
         */
        interface IERC165 {
            /**
             * @dev Returns true if this contract implements the interface defined by
             * `interfaceId`. See the corresponding
             * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
             * to learn more about how these ids are created.
             *
             * This function call must use less than 30 000 gas.
             */
            function supportsInterface(bytes4 interfaceId) external view returns (bool);
        }
        /*
         /$$$$$$$$                     /$$$$$$$$                                          /$$          
        | $$_____/                    | $$_____/                                         |__/          
        | $$        /$$$$$$   /$$$$$$$| $$     /$$$$$$   /$$$$$$   /$$$$$$   /$$$$$$      /$$  /$$$$$$ 
        | $$$$$    /$$__  $$ /$$_____/| $$$$$ /$$__  $$ /$$__  $$ /$$__  $$ /$$__  $$    | $$ /$$__  $$
        | $$__/   | $$  \\__/| $$      | $$__/| $$  \\ $$| $$  \\__/| $$  \\ $$| $$$$$$$$    | $$| $$  \\ $$
        | $$      | $$      | $$      | $$   | $$  | $$| $$      | $$  | $$| $$_____/    | $$| $$  | $$
        | $$$$$$$$| $$      |  $$$$$$$| $$   |  $$$$$$/| $$      |  $$$$$$$|  $$$$$$$ /$$| $$|  $$$$$$/
        |________/|__/       \\_______/|__/    \\______/ |__/       \\____  $$ \\_______/|__/|__/ \\______/ 
                                                                  /$$  \\ $$                            
                                                                 |  $$$$$$/                            
                                                                  \\______/                             
        */
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        import "../interface/IErcForgeInitiable.sol";
        import "@openzeppelin/contracts/token/ERC1155/ERC1155.sol";
        contract ErcForgeDeployer {
            mapping(uint256 => address) private _templateAddresses;
            address public fullDiscountTokenAddress;
            uint256 public fullDiscountTokenId;
            address owner;
            uint256 public fee = 0 gwei;
            uint256 public referrerDiscount = 0 gwei;
            uint256 public referrerReward = 0 gwei;
            uint256 public totalReferrerFunds;
            mapping(address => uint256) private _referrerFunds;
            bool public isPaused = false;
            event ContractCreated(address contractAddress);
            error NotOwner();
            constructor() {
                owner = msg.sender;
            }
            function setTemplateAddress(
                uint256 _templateType,
                address _address
            ) public {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                _templateAddresses[_templateType] = _address;
            }
            function getTemplateAddress(
                uint256 _templateType
            ) public view returns (address) {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                return _templateAddresses[_templateType];
            }
            function setFullDiscountToken(address _address, uint256 _id) public {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                fullDiscountTokenAddress = _address;
                fullDiscountTokenId = _id;
            }
            function setOwner(address _owner) public {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                owner = _owner;
            }
            function setFee(uint256 _fee) public {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                fee = _fee;
            }
            function setReferrerDiscount(uint256 _referrerDiscount) public {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                referrerDiscount = _referrerDiscount;
            }
            function setReferrerReward(uint256 _referrerReward) public {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                referrerReward = _referrerReward;
            }
            function setIsPaused(bool _isPaused) public {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                isPaused = _isPaused;
            }
            function getFee(bool hasReferrer) public view returns (uint256) {
                uint256 tmpFee = fee;
                if (hasReferrer) tmpFee -= referrerDiscount;
                if (fullDiscountTokenAddress != address(0)) {
                    ERC1155 fullDiscountToken = ERC1155(fullDiscountTokenAddress);
                    if (
                        fullDiscountToken.balanceOf(msg.sender, fullDiscountTokenId) > 0
                    ) tmpFee = 0;
                }
                return tmpFee;
            }
            function createContract(
                uint256 contractType,
                string memory name,
                string memory symbol,
                string memory uri,
                string memory contractUri,
                address royaltyAddresses,
                uint96 royaltyFee,
                address referrer
            ) public payable returns (address) {
                require(!isPaused, "Paused");
                require(
                    _templateAddresses[contractType] != address(0),
                    "Contract type not defined"
                );
                uint256 tmpFee = getFee(referrer != address(0));
                require(msg.value >= tmpFee, "Not enough funds");
                address clone = createClone(_templateAddresses[contractType]);
                IErcForgeInitiable token = IErcForgeInitiable(clone);
                token.init(
                    msg.sender,
                    name,
                    symbol,
                    uri,
                    contractUri,
                    royaltyAddresses,
                    royaltyFee
                );
                emit ContractCreated(clone);
                if (referrer != address(0) && tmpFee != 0) {
                    _referrerFunds[referrer] += referrerReward;
                    totalReferrerFunds += referrerReward;
                }
                return clone;
            }
            function createClone(address target) internal returns (address result) {
                bytes20 targetBytes = bytes20(target);
                assembly {
                    let clone := mload(0x40)
                    mstore(
                        clone,
                        0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000
                    )
                    mstore(add(clone, 0x14), targetBytes)
                    mstore(
                        add(clone, 0x28),
                        0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000
                    )
                    result := create(0, clone, 0x37)
                }
            }
            function withdraw() public {
                uint256 funds;
                if (msg.sender == owner)
                    funds = address(this).balance - totalReferrerFunds;
                else {
                    funds = _referrerFunds[msg.sender];
                    totalReferrerFunds -= funds;
                    _referrerFunds[msg.sender] = 0;
                }
                payable(msg.sender).transfer(funds);
            }
            function getBalance(address user) public view returns (uint256) {
                if (user == owner) return address(this).balance - totalReferrerFunds;
                else return _referrerFunds[user];
            }
        }
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        interface IErcForgeInitiable {
            function init(
                address newOwner,
                string memory newName,
                string memory newSymbol,
                string memory newBaseTokenURI,
                string memory newContractUri,
                address royaltyReceiver,
                uint96 royaltyFee
            ) external;
        }
        

        File 2 of 4: OperatorFilterRegistry
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)
        pragma solidity ^0.8.0;
        import "../utils/Context.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 Ownable is Context {
            address private _owner;
            event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
            /**
             * @dev Initializes the contract setting the deployer as the initial owner.
             */
            constructor() {
                _transferOwnership(_msgSender());
            }
            /**
             * @dev Throws if called by any account other than the owner.
             */
            modifier onlyOwner() {
                _checkOwner();
                _;
            }
            /**
             * @dev Returns the address of the current owner.
             */
            function owner() public view virtual returns (address) {
                return _owner;
            }
            /**
             * @dev Throws if the sender is not the owner.
             */
            function _checkOwner() internal view virtual {
                require(owner() == _msgSender(), "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 {
                _transferOwnership(address(0));
            }
            /**
             * @dev Transfers ownership of the contract to a new account (`newOwner`).
             * Can only be called by the current owner.
             */
            function transferOwnership(address newOwner) public virtual onlyOwner {
                require(newOwner != address(0), "Ownable: new owner is the zero address");
                _transferOwnership(newOwner);
            }
            /**
             * @dev Transfers ownership of the contract to a new account (`newOwner`).
             * Internal function without access restriction.
             */
            function _transferOwnership(address newOwner) internal virtual {
                address oldOwner = _owner;
                _owner = newOwner;
                emit OwnershipTransferred(oldOwner, newOwner);
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Provides information about the current execution context, including the
         * sender of the transaction and its data. While these are generally available
         * via msg.sender and msg.data, they should not be accessed in such a direct
         * manner, since when dealing with meta-transactions the account sending and
         * paying for execution may not be the actual sender (as far as an application
         * is concerned).
         *
         * This contract is only required for intermediate, library-like contracts.
         */
        abstract contract Context {
            function _msgSender() internal view virtual returns (address) {
                return msg.sender;
            }
            function _msgData() internal view virtual returns (bytes calldata) {
                return msg.data;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.7.0) (utils/structs/EnumerableSet.sol)
        // This file was procedurally generated from scripts/generate/templates/EnumerableSet.js.
        pragma solidity ^0.8.0;
        /**
         * @dev Library for managing
         * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
         * types.
         *
         * Sets have the following properties:
         *
         * - Elements are added, removed, and checked for existence in constant time
         * (O(1)).
         * - Elements are enumerated in O(n). No guarantees are made on the ordering.
         *
         * ```
         * contract Example {
         *     // Add the library methods
         *     using EnumerableSet for EnumerableSet.AddressSet;
         *
         *     // Declare a set state variable
         *     EnumerableSet.AddressSet private mySet;
         * }
         * ```
         *
         * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
         * and `uint256` (`UintSet`) are supported.
         *
         * [WARNING]
         * ====
         * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure
         * unusable.
         * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
         *
         * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an
         * array of EnumerableSet.
         * ====
         */
        library EnumerableSet {
            // To implement this library for multiple types with as little code
            // repetition as possible, we write it in terms of a generic Set type with
            // bytes32 values.
            // The Set implementation uses private functions, and user-facing
            // implementations (such as AddressSet) are just wrappers around the
            // underlying Set.
            // This means that we can only create new EnumerableSets for types that fit
            // in bytes32.
            struct Set {
                // Storage of set values
                bytes32[] _values;
                // Position of the value in the `values` array, plus 1 because index 0
                // means a value is not in the set.
                mapping(bytes32 => uint256) _indexes;
            }
            /**
             * @dev Add a value to a set. O(1).
             *
             * Returns true if the value was added to the set, that is if it was not
             * already present.
             */
            function _add(Set storage set, bytes32 value) private returns (bool) {
                if (!_contains(set, value)) {
                    set._values.push(value);
                    // The value is stored at length-1, but we add 1 to all indexes
                    // and use 0 as a sentinel value
                    set._indexes[value] = set._values.length;
                    return true;
                } else {
                    return false;
                }
            }
            /**
             * @dev Removes a value from a set. O(1).
             *
             * Returns true if the value was removed from the set, that is if it was
             * present.
             */
            function _remove(Set storage set, bytes32 value) private returns (bool) {
                // We read and store the value's index to prevent multiple reads from the same storage slot
                uint256 valueIndex = set._indexes[value];
                if (valueIndex != 0) {
                    // Equivalent to contains(set, value)
                    // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
                    // the array, and then remove the last element (sometimes called as 'swap and pop').
                    // This modifies the order of the array, as noted in {at}.
                    uint256 toDeleteIndex = valueIndex - 1;
                    uint256 lastIndex = set._values.length - 1;
                    if (lastIndex != toDeleteIndex) {
                        bytes32 lastValue = set._values[lastIndex];
                        // Move the last value to the index where the value to delete is
                        set._values[toDeleteIndex] = lastValue;
                        // Update the index for the moved value
                        set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex
                    }
                    // Delete the slot where the moved value was stored
                    set._values.pop();
                    // Delete the index for the deleted slot
                    delete set._indexes[value];
                    return true;
                } else {
                    return false;
                }
            }
            /**
             * @dev Returns true if the value is in the set. O(1).
             */
            function _contains(Set storage set, bytes32 value) private view returns (bool) {
                return set._indexes[value] != 0;
            }
            /**
             * @dev Returns the number of values on the set. O(1).
             */
            function _length(Set storage set) private view returns (uint256) {
                return set._values.length;
            }
            /**
             * @dev Returns the value stored at position `index` in the set. O(1).
             *
             * Note that there are no guarantees on the ordering of values inside the
             * array, and it may change when more values are added or removed.
             *
             * Requirements:
             *
             * - `index` must be strictly less than {length}.
             */
            function _at(Set storage set, uint256 index) private view returns (bytes32) {
                return set._values[index];
            }
            /**
             * @dev Return the entire set in an array
             *
             * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
             * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
             * this function has an unbounded cost, and using it as part of a state-changing function may render the function
             * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
             */
            function _values(Set storage set) private view returns (bytes32[] memory) {
                return set._values;
            }
            // Bytes32Set
            struct Bytes32Set {
                Set _inner;
            }
            /**
             * @dev Add a value to a set. O(1).
             *
             * Returns true if the value was added to the set, that is if it was not
             * already present.
             */
            function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                return _add(set._inner, value);
            }
            /**
             * @dev Removes a value from a set. O(1).
             *
             * Returns true if the value was removed from the set, that is if it was
             * present.
             */
            function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
                return _remove(set._inner, value);
            }
            /**
             * @dev Returns true if the value is in the set. O(1).
             */
            function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
                return _contains(set._inner, value);
            }
            /**
             * @dev Returns the number of values in the set. O(1).
             */
            function length(Bytes32Set storage set) internal view returns (uint256) {
                return _length(set._inner);
            }
            /**
             * @dev Returns the value stored at position `index` in the set. O(1).
             *
             * Note that there are no guarantees on the ordering of values inside the
             * array, and it may change when more values are added or removed.
             *
             * Requirements:
             *
             * - `index` must be strictly less than {length}.
             */
            function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
                return _at(set._inner, index);
            }
            /**
             * @dev Return the entire set in an array
             *
             * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
             * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
             * this function has an unbounded cost, and using it as part of a state-changing function may render the function
             * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
             */
            function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
                bytes32[] memory store = _values(set._inner);
                bytes32[] memory result;
                /// @solidity memory-safe-assembly
                assembly {
                    result := store
                }
                return result;
            }
            // AddressSet
            struct AddressSet {
                Set _inner;
            }
            /**
             * @dev Add a value to a set. O(1).
             *
             * Returns true if the value was added to the set, that is if it was not
             * already present.
             */
            function add(AddressSet storage set, address value) internal returns (bool) {
                return _add(set._inner, bytes32(uint256(uint160(value))));
            }
            /**
             * @dev Removes a value from a set. O(1).
             *
             * Returns true if the value was removed from the set, that is if it was
             * present.
             */
            function remove(AddressSet storage set, address value) internal returns (bool) {
                return _remove(set._inner, bytes32(uint256(uint160(value))));
            }
            /**
             * @dev Returns true if the value is in the set. O(1).
             */
            function contains(AddressSet storage set, address value) internal view returns (bool) {
                return _contains(set._inner, bytes32(uint256(uint160(value))));
            }
            /**
             * @dev Returns the number of values in the set. O(1).
             */
            function length(AddressSet storage set) internal view returns (uint256) {
                return _length(set._inner);
            }
            /**
             * @dev Returns the value stored at position `index` in the set. O(1).
             *
             * Note that there are no guarantees on the ordering of values inside the
             * array, and it may change when more values are added or removed.
             *
             * Requirements:
             *
             * - `index` must be strictly less than {length}.
             */
            function at(AddressSet storage set, uint256 index) internal view returns (address) {
                return address(uint160(uint256(_at(set._inner, index))));
            }
            /**
             * @dev Return the entire set in an array
             *
             * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
             * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
             * this function has an unbounded cost, and using it as part of a state-changing function may render the function
             * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
             */
            function values(AddressSet storage set) internal view returns (address[] memory) {
                bytes32[] memory store = _values(set._inner);
                address[] memory result;
                /// @solidity memory-safe-assembly
                assembly {
                    result := store
                }
                return result;
            }
            // UintSet
            struct UintSet {
                Set _inner;
            }
            /**
             * @dev Add a value to a set. O(1).
             *
             * Returns true if the value was added to the set, that is if it was not
             * already present.
             */
            function add(UintSet storage set, uint256 value) internal returns (bool) {
                return _add(set._inner, bytes32(value));
            }
            /**
             * @dev Removes a value from a set. O(1).
             *
             * Returns true if the value was removed from the set, that is if it was
             * present.
             */
            function remove(UintSet storage set, uint256 value) internal returns (bool) {
                return _remove(set._inner, bytes32(value));
            }
            /**
             * @dev Returns true if the value is in the set. O(1).
             */
            function contains(UintSet storage set, uint256 value) internal view returns (bool) {
                return _contains(set._inner, bytes32(value));
            }
            /**
             * @dev Returns the number of values in the set. O(1).
             */
            function length(UintSet storage set) internal view returns (uint256) {
                return _length(set._inner);
            }
            /**
             * @dev Returns the value stored at position `index` in the set. O(1).
             *
             * Note that there are no guarantees on the ordering of values inside the
             * array, and it may change when more values are added or removed.
             *
             * Requirements:
             *
             * - `index` must be strictly less than {length}.
             */
            function at(UintSet storage set, uint256 index) internal view returns (uint256) {
                return uint256(_at(set._inner, index));
            }
            /**
             * @dev Return the entire set in an array
             *
             * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
             * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
             * this function has an unbounded cost, and using it as part of a state-changing function may render the function
             * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
             */
            function values(UintSet storage set) internal view returns (uint256[] memory) {
                bytes32[] memory store = _values(set._inner);
                uint256[] memory result;
                /// @solidity memory-safe-assembly
                assembly {
                    result := store
                }
                return result;
            }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.13;
        import {EnumerableSet} from "openzeppelin-contracts/utils/structs/EnumerableSet.sol";
        interface IOperatorFilterRegistry {
            function isOperatorAllowed(address registrant, address operator) external returns (bool);
            function register(address registrant) external;
            function registerAndSubscribe(address registrant, address subscription) external;
            function registerAndCopyEntries(address registrant, address registrantToCopy) external;
            function updateOperator(address registrant, address operator, bool filtered) external;
            function updateOperators(address registrant, address[] calldata operators, bool filtered) external;
            function updateCodeHash(address registrant, bytes32 codehash, bool filtered) external;
            function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external;
            function subscribe(address registrant, address registrantToSubscribe) external;
            function unsubscribe(address registrant, bool copyExistingEntries) external;
            function subscriptionOf(address addr) external returns (address registrant);
            function subscribers(address registrant) external returns (address[] memory);
            function subscriberAt(address registrant, uint256 index) external returns (address);
            function copyEntriesOf(address registrant, address registrantToCopy) external;
            function isOperatorFiltered(address registrant, address operator) external returns (bool);
            function isCodeHashOfFiltered(address registrant, address operatorWithCode) external returns (bool);
            function isCodeHashFiltered(address registrant, bytes32 codeHash) external returns (bool);
            function filteredOperators(address addr) external returns (address[] memory);
            function filteredCodeHashes(address addr) external returns (bytes32[] memory);
            function filteredOperatorAt(address registrant, uint256 index) external returns (address);
            function filteredCodeHashAt(address registrant, uint256 index) external returns (bytes32);
            function isRegistered(address addr) external returns (bool);
            function codeHashOf(address addr) external returns (bytes32);
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.13;
        import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.sol";
        import {Ownable} from "openzeppelin-contracts/access/Ownable.sol";
        import {EnumerableSet} from "openzeppelin-contracts/utils/structs/EnumerableSet.sol";
        import {OperatorFilterRegistryErrorsAndEvents} from "./OperatorFilterRegistryErrorsAndEvents.sol";
        /**
         * @title  OperatorFilterRegistry
         * @notice Borrows heavily from the QQL BlacklistOperatorFilter contract:
         *         https://github.com/qql-art/contracts/blob/main/contracts/BlacklistOperatorFilter.sol
         * @notice This contracts allows tokens or token owners to register specific addresses or codeHashes that may be
         * *       restricted according to the isOperatorAllowed function.
         */
        contract OperatorFilterRegistry is IOperatorFilterRegistry, OperatorFilterRegistryErrorsAndEvents {
            using EnumerableSet for EnumerableSet.AddressSet;
            using EnumerableSet for EnumerableSet.Bytes32Set;
            /// @dev initialized accounts have a nonzero codehash (see https://eips.ethereum.org/EIPS/eip-1052)
            /// Note that this will also be a smart contract's codehash when making calls from its constructor.
            bytes32 constant EOA_CODEHASH = keccak256("");
            mapping(address => EnumerableSet.AddressSet) private _filteredOperators;
            mapping(address => EnumerableSet.Bytes32Set) private _filteredCodeHashes;
            mapping(address => address) private _registrations;
            mapping(address => EnumerableSet.AddressSet) private _subscribers;
            /**
             * @notice restricts method caller to the address or EIP-173 "owner()"
             */
            modifier onlyAddressOrOwner(address addr) {
                if (msg.sender != addr) {
                    try Ownable(addr).owner() returns (address owner) {
                        if (msg.sender != owner) {
                            revert OnlyAddressOrOwner();
                        }
                    } catch (bytes memory reason) {
                        if (reason.length == 0) {
                            revert NotOwnable();
                        } else {
                            /// @solidity memory-safe-assembly
                            assembly {
                                revert(add(32, reason), mload(reason))
                            }
                        }
                    }
                }
                _;
            }
            /**
             * @notice Returns true if operator is not filtered for a given token, either by address or codeHash. Also returns
             *         true if supplied registrant address is not registered.
             */
            function isOperatorAllowed(address registrant, address operator) external view returns (bool) {
                address registration = _registrations[registrant];
                if (registration != address(0)) {
                    EnumerableSet.AddressSet storage filteredOperatorsRef;
                    EnumerableSet.Bytes32Set storage filteredCodeHashesRef;
                    filteredOperatorsRef = _filteredOperators[registration];
                    filteredCodeHashesRef = _filteredCodeHashes[registration];
                    if (filteredOperatorsRef.contains(operator)) {
                        revert AddressFiltered(operator);
                    }
                    if (operator.code.length > 0) {
                        bytes32 codeHash = operator.codehash;
                        if (filteredCodeHashesRef.contains(codeHash)) {
                            revert CodeHashFiltered(operator, codeHash);
                        }
                    }
                }
                return true;
            }
            //////////////////
            // AUTH METHODS //
            //////////////////
            /**
             * @notice Registers an address with the registry. May be called by address itself or by EIP-173 owner.
             */
            function register(address registrant) external onlyAddressOrOwner(registrant) {
                if (_registrations[registrant] != address(0)) {
                    revert AlreadyRegistered();
                }
                _registrations[registrant] = registrant;
                emit RegistrationUpdated(registrant, true);
            }
            /**
             * @notice Unregisters an address with the registry and removes its subscription. May be called by address itself or by EIP-173 owner.
             *         Note that this does not remove any filtered addresses or codeHashes.
             *         Also note that any subscriptions to this registrant will still be active and follow the existing filtered addresses and codehashes.
             */
            function unregister(address registrant) external onlyAddressOrOwner(registrant) {
                address registration = _registrations[registrant];
                if (registration == address(0)) {
                    revert NotRegistered(registrant);
                }
                if (registration != registrant) {
                    _subscribers[registration].remove(registrant);
                    emit SubscriptionUpdated(registrant, registration, false);
                }
                _registrations[registrant] = address(0);
                emit RegistrationUpdated(registrant, false);
            }
            /**
             * @notice Registers an address with the registry and "subscribes" to another address's filtered operators and codeHashes.
             */
            function registerAndSubscribe(address registrant, address subscription) external onlyAddressOrOwner(registrant) {
                address registration = _registrations[registrant];
                if (registration != address(0)) {
                    revert AlreadyRegistered();
                }
                if (registrant == subscription) {
                    revert CannotSubscribeToSelf();
                }
                address subscriptionRegistration = _registrations[subscription];
                if (subscriptionRegistration == address(0)) {
                    revert NotRegistered(subscription);
                }
                if (subscriptionRegistration != subscription) {
                    revert CannotSubscribeToRegistrantWithSubscription(subscription);
                }
                _registrations[registrant] = subscription;
                _subscribers[subscription].add(registrant);
                emit RegistrationUpdated(registrant, true);
                emit SubscriptionUpdated(registrant, subscription, true);
            }
            /**
             * @notice Registers an address with the registry and copies the filtered operators and codeHashes from another
             *         address without subscribing.
             */
            function registerAndCopyEntries(address registrant, address registrantToCopy)
                external
                onlyAddressOrOwner(registrant)
            {
                if (registrantToCopy == registrant) {
                    revert CannotCopyFromSelf();
                }
                address registration = _registrations[registrant];
                if (registration != address(0)) {
                    revert AlreadyRegistered();
                }
                address registrantRegistration = _registrations[registrantToCopy];
                if (registrantRegistration == address(0)) {
                    revert NotRegistered(registrantToCopy);
                }
                _registrations[registrant] = registrant;
                emit RegistrationUpdated(registrant, true);
                _copyEntries(registrant, registrantToCopy);
            }
            /**
             * @notice Update an operator address for a registered address - when filtered is true, the operator is filtered.
             */
            function updateOperator(address registrant, address operator, bool filtered)
                external
                onlyAddressOrOwner(registrant)
            {
                address registration = _registrations[registrant];
                if (registration == address(0)) {
                    revert NotRegistered(registrant);
                }
                if (registration != registrant) {
                    revert CannotUpdateWhileSubscribed(registration);
                }
                EnumerableSet.AddressSet storage filteredOperatorsRef = _filteredOperators[registrant];
                if (!filtered) {
                    bool removed = filteredOperatorsRef.remove(operator);
                    if (!removed) {
                        revert AddressNotFiltered(operator);
                    }
                } else {
                    bool added = filteredOperatorsRef.add(operator);
                    if (!added) {
                        revert AddressAlreadyFiltered(operator);
                    }
                }
                emit OperatorUpdated(registrant, operator, filtered);
            }
            /**
             * @notice Update a codeHash for a registered address - when filtered is true, the codeHash is filtered.
             */
            function updateCodeHash(address registrant, bytes32 codeHash, bool filtered)
                external
                onlyAddressOrOwner(registrant)
            {
                if (codeHash == EOA_CODEHASH) {
                    revert CannotFilterEOAs();
                }
                address registration = _registrations[registrant];
                if (registration == address(0)) {
                    revert NotRegistered(registrant);
                }
                if (registration != registrant) {
                    revert CannotUpdateWhileSubscribed(registration);
                }
                EnumerableSet.Bytes32Set storage filteredCodeHashesRef = _filteredCodeHashes[registrant];
                if (!filtered) {
                    bool removed = filteredCodeHashesRef.remove(codeHash);
                    if (!removed) {
                        revert CodeHashNotFiltered(codeHash);
                    }
                } else {
                    bool added = filteredCodeHashesRef.add(codeHash);
                    if (!added) {
                        revert CodeHashAlreadyFiltered(codeHash);
                    }
                }
                emit CodeHashUpdated(registrant, codeHash, filtered);
            }
            /**
             * @notice Update multiple operators for a registered address - when filtered is true, the operators will be filtered. Reverts on duplicates.
             */
            function updateOperators(address registrant, address[] calldata operators, bool filtered)
                external
                onlyAddressOrOwner(registrant)
            {
                address registration = _registrations[registrant];
                if (registration == address(0)) {
                    revert NotRegistered(registrant);
                }
                if (registration != registrant) {
                    revert CannotUpdateWhileSubscribed(registration);
                }
                EnumerableSet.AddressSet storage filteredOperatorsRef = _filteredOperators[registrant];
                uint256 operatorsLength = operators.length;
                unchecked {
                    if (!filtered) {
                        for (uint256 i = 0; i < operatorsLength; ++i) {
                            address operator = operators[i];
                            bool removed = filteredOperatorsRef.remove(operator);
                            if (!removed) {
                                revert AddressNotFiltered(operator);
                            }
                        }
                    } else {
                        for (uint256 i = 0; i < operatorsLength; ++i) {
                            address operator = operators[i];
                            bool added = filteredOperatorsRef.add(operator);
                            if (!added) {
                                revert AddressAlreadyFiltered(operator);
                            }
                        }
                    }
                }
                emit OperatorsUpdated(registrant, operators, filtered);
            }
            /**
             * @notice Update multiple codeHashes for a registered address - when filtered is true, the codeHashes will be filtered. Reverts on duplicates.
             */
            function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered)
                external
                onlyAddressOrOwner(registrant)
            {
                address registration = _registrations[registrant];
                if (registration == address(0)) {
                    revert NotRegistered(registrant);
                }
                if (registration != registrant) {
                    revert CannotUpdateWhileSubscribed(registration);
                }
                EnumerableSet.Bytes32Set storage filteredCodeHashesRef = _filteredCodeHashes[registrant];
                uint256 codeHashesLength = codeHashes.length;
                unchecked {
                    if (!filtered) {
                        for (uint256 i = 0; i < codeHashesLength; ++i) {
                            bytes32 codeHash = codeHashes[i];
                            bool removed = filteredCodeHashesRef.remove(codeHash);
                            if (!removed) {
                                revert CodeHashNotFiltered(codeHash);
                            }
                        }
                    } else {
                        for (uint256 i = 0; i < codeHashesLength; ++i) {
                            bytes32 codeHash = codeHashes[i];
                            if (codeHash == EOA_CODEHASH) {
                                revert CannotFilterEOAs();
                            }
                            bool added = filteredCodeHashesRef.add(codeHash);
                            if (!added) {
                                revert CodeHashAlreadyFiltered(codeHash);
                            }
                        }
                    }
                }
                emit CodeHashesUpdated(registrant, codeHashes, filtered);
            }
            /**
             * @notice Subscribe an address to another registrant's filtered operators and codeHashes. Will remove previous
             *         subscription if present.
             *         Note that accounts with subscriptions may go on to subscribe to other accounts - in this case,
             *         subscriptions will not be forwarded. Instead the former subscription's existing entries will still be
             *         used.
             */
            function subscribe(address registrant, address newSubscription) external onlyAddressOrOwner(registrant) {
                if (registrant == newSubscription) {
                    revert CannotSubscribeToSelf();
                }
                if (newSubscription == address(0)) {
                    revert CannotSubscribeToZeroAddress();
                }
                address registration = _registrations[registrant];
                if (registration == address(0)) {
                    revert NotRegistered(registrant);
                }
                if (registration == newSubscription) {
                    revert AlreadySubscribed(newSubscription);
                }
                address newSubscriptionRegistration = _registrations[newSubscription];
                if (newSubscriptionRegistration == address(0)) {
                    revert NotRegistered(newSubscription);
                }
                if (newSubscriptionRegistration != newSubscription) {
                    revert CannotSubscribeToRegistrantWithSubscription(newSubscription);
                }
                if (registration != registrant) {
                    _subscribers[registration].remove(registrant);
                    emit SubscriptionUpdated(registrant, registration, false);
                }
                _registrations[registrant] = newSubscription;
                _subscribers[newSubscription].add(registrant);
                emit SubscriptionUpdated(registrant, newSubscription, true);
            }
            /**
             * @notice Unsubscribe an address from its current subscribed registrant, and optionally copy its filtered operators and codeHashes.
             */
            function unsubscribe(address registrant, bool copyExistingEntries) external onlyAddressOrOwner(registrant) {
                address registration = _registrations[registrant];
                if (registration == address(0)) {
                    revert NotRegistered(registrant);
                }
                if (registration == registrant) {
                    revert NotSubscribed();
                }
                _subscribers[registration].remove(registrant);
                _registrations[registrant] = registrant;
                emit SubscriptionUpdated(registrant, registration, false);
                if (copyExistingEntries) {
                    _copyEntries(registrant, registration);
                }
            }
            /**
             * @notice Copy filtered operators and codeHashes from a different registrantToCopy to addr.
             */
            function copyEntriesOf(address registrant, address registrantToCopy) external onlyAddressOrOwner(registrant) {
                if (registrant == registrantToCopy) {
                    revert CannotCopyFromSelf();
                }
                address registration = _registrations[registrant];
                if (registration == address(0)) {
                    revert NotRegistered(registrant);
                }
                if (registration != registrant) {
                    revert CannotUpdateWhileSubscribed(registration);
                }
                address registrantRegistration = _registrations[registrantToCopy];
                if (registrantRegistration == address(0)) {
                    revert NotRegistered(registrantToCopy);
                }
                _copyEntries(registrant, registrantToCopy);
            }
            /// @dev helper to copy entries from registrantToCopy to registrant and emit events
            function _copyEntries(address registrant, address registrantToCopy) private {
                EnumerableSet.AddressSet storage filteredOperatorsRef = _filteredOperators[registrantToCopy];
                EnumerableSet.Bytes32Set storage filteredCodeHashesRef = _filteredCodeHashes[registrantToCopy];
                uint256 filteredOperatorsLength = filteredOperatorsRef.length();
                uint256 filteredCodeHashesLength = filteredCodeHashesRef.length();
                unchecked {
                    for (uint256 i = 0; i < filteredOperatorsLength; ++i) {
                        address operator = filteredOperatorsRef.at(i);
                        bool added = _filteredOperators[registrant].add(operator);
                        if (added) {
                            emit OperatorUpdated(registrant, operator, true);
                        }
                    }
                    for (uint256 i = 0; i < filteredCodeHashesLength; ++i) {
                        bytes32 codehash = filteredCodeHashesRef.at(i);
                        bool added = _filteredCodeHashes[registrant].add(codehash);
                        if (added) {
                            emit CodeHashUpdated(registrant, codehash, true);
                        }
                    }
                }
            }
            //////////////////
            // VIEW METHODS //
            //////////////////
            /**
             * @notice Get the subscription address of a given registrant, if any.
             */
            function subscriptionOf(address registrant) external view returns (address subscription) {
                subscription = _registrations[registrant];
                if (subscription == address(0)) {
                    revert NotRegistered(registrant);
                } else if (subscription == registrant) {
                    subscription = address(0);
                }
            }
            /**
             * @notice Get the set of addresses subscribed to a given registrant.
             *         Note that order is not guaranteed as updates are made.
             */
            function subscribers(address registrant) external view returns (address[] memory) {
                return _subscribers[registrant].values();
            }
            /**
             * @notice Get the subscriber at a given index in the set of addresses subscribed to a given registrant.
             *         Note that order is not guaranteed as updates are made.
             */
            function subscriberAt(address registrant, uint256 index) external view returns (address) {
                return _subscribers[registrant].at(index);
            }
            /**
             * @notice Returns true if operator is filtered by a given address or its subscription.
             */
            function isOperatorFiltered(address registrant, address operator) external view returns (bool) {
                address registration = _registrations[registrant];
                if (registration != registrant) {
                    return _filteredOperators[registration].contains(operator);
                }
                return _filteredOperators[registrant].contains(operator);
            }
            /**
             * @notice Returns true if a codeHash is filtered by a given address or its subscription.
             */
            function isCodeHashFiltered(address registrant, bytes32 codeHash) external view returns (bool) {
                address registration = _registrations[registrant];
                if (registration != registrant) {
                    return _filteredCodeHashes[registration].contains(codeHash);
                }
                return _filteredCodeHashes[registrant].contains(codeHash);
            }
            /**
             * @notice Returns true if the hash of an address's code is filtered by a given address or its subscription.
             */
            function isCodeHashOfFiltered(address registrant, address operatorWithCode) external view returns (bool) {
                bytes32 codeHash = operatorWithCode.codehash;
                address registration = _registrations[registrant];
                if (registration != registrant) {
                    return _filteredCodeHashes[registration].contains(codeHash);
                }
                return _filteredCodeHashes[registrant].contains(codeHash);
            }
            /**
             * @notice Returns true if an address has registered
             */
            function isRegistered(address registrant) external view returns (bool) {
                return _registrations[registrant] != address(0);
            }
            /**
             * @notice Returns a list of filtered operators for a given address or its subscription.
             */
            function filteredOperators(address registrant) external view returns (address[] memory) {
                address registration = _registrations[registrant];
                if (registration != registrant) {
                    return _filteredOperators[registration].values();
                }
                return _filteredOperators[registrant].values();
            }
            /**
             * @notice Returns the set of filtered codeHashes for a given address or its subscription.
             *         Note that order is not guaranteed as updates are made.
             */
            function filteredCodeHashes(address registrant) external view returns (bytes32[] memory) {
                address registration = _registrations[registrant];
                if (registration != registrant) {
                    return _filteredCodeHashes[registration].values();
                }
                return _filteredCodeHashes[registrant].values();
            }
            /**
             * @notice Returns the filtered operator at the given index of the set of filtered operators for a given address or
             *         its subscription.
             *         Note that order is not guaranteed as updates are made.
             */
            function filteredOperatorAt(address registrant, uint256 index) external view returns (address) {
                address registration = _registrations[registrant];
                if (registration != registrant) {
                    return _filteredOperators[registration].at(index);
                }
                return _filteredOperators[registrant].at(index);
            }
            /**
             * @notice Returns the filtered codeHash at the given index of the list of filtered codeHashes for a given address or
             *         its subscription.
             *         Note that order is not guaranteed as updates are made.
             */
            function filteredCodeHashAt(address registrant, uint256 index) external view returns (bytes32) {
                address registration = _registrations[registrant];
                if (registration != registrant) {
                    return _filteredCodeHashes[registration].at(index);
                }
                return _filteredCodeHashes[registrant].at(index);
            }
            /// @dev Convenience method to compute the code hash of an arbitrary contract
            function codeHashOf(address a) external view returns (bytes32) {
                return a.codehash;
            }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.13;
        contract OperatorFilterRegistryErrorsAndEvents {
            error CannotFilterEOAs();
            error AddressAlreadyFiltered(address operator);
            error AddressNotFiltered(address operator);
            error CodeHashAlreadyFiltered(bytes32 codeHash);
            error CodeHashNotFiltered(bytes32 codeHash);
            error OnlyAddressOrOwner();
            error NotRegistered(address registrant);
            error AlreadyRegistered();
            error AlreadySubscribed(address subscription);
            error NotSubscribed();
            error CannotUpdateWhileSubscribed(address subscription);
            error CannotSubscribeToSelf();
            error CannotSubscribeToZeroAddress();
            error NotOwnable();
            error AddressFiltered(address filtered);
            error CodeHashFiltered(address account, bytes32 codeHash);
            error CannotSubscribeToRegistrantWithSubscription(address registrant);
            error CannotCopyFromSelf();
            event RegistrationUpdated(address indexed registrant, bool indexed registered);
            event OperatorUpdated(address indexed registrant, address indexed operator, bool indexed filtered);
            event OperatorsUpdated(address indexed registrant, address[] operators, bool indexed filtered);
            event CodeHashUpdated(address indexed registrant, bytes32 indexed codeHash, bool indexed filtered);
            event CodeHashesUpdated(address indexed registrant, bytes32[] codeHashes, bool indexed filtered);
            event SubscriptionUpdated(address indexed registrant, address indexed subscription, bool indexed subscribed);
        }
        

        File 3 of 4: ErcForge721Template
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.6.0) (interfaces/IERC2981.sol)
        pragma solidity ^0.8.0;
        import "../utils/introspection/IERC165.sol";
        /**
         * @dev Interface for the NFT Royalty Standard.
         *
         * A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal
         * support for royalty payments across all NFT marketplaces and ecosystem participants.
         *
         * _Available since v4.5._
         */
        interface IERC2981 is IERC165 {
            /**
             * @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of
             * exchange. The royalty amount is denominated and should be paid in that same unit of exchange.
             */
            function royaltyInfo(uint256 tokenId, uint256 salePrice)
                external
                view
                returns (address receiver, uint256 royaltyAmount);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
        pragma solidity ^0.8.0;
        import "../utils/Context.sol";
        /**
         * @dev Contract module which allows children to implement an emergency stop
         * mechanism that can be triggered by an authorized account.
         *
         * This module is used through inheritance. It will make available the
         * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
         * the functions of your contract. Note that they will not be pausable by
         * simply including this module, only once the modifiers are put in place.
         */
        abstract contract Pausable is Context {
            /**
             * @dev Emitted when the pause is triggered by `account`.
             */
            event Paused(address account);
            /**
             * @dev Emitted when the pause is lifted by `account`.
             */
            event Unpaused(address account);
            bool private _paused;
            /**
             * @dev Initializes the contract in unpaused state.
             */
            constructor() {
                _paused = false;
            }
            /**
             * @dev Modifier to make a function callable only when the contract is not paused.
             *
             * Requirements:
             *
             * - The contract must not be paused.
             */
            modifier whenNotPaused() {
                _requireNotPaused();
                _;
            }
            /**
             * @dev Modifier to make a function callable only when the contract is paused.
             *
             * Requirements:
             *
             * - The contract must be paused.
             */
            modifier whenPaused() {
                _requirePaused();
                _;
            }
            /**
             * @dev Returns true if the contract is paused, and false otherwise.
             */
            function paused() public view virtual returns (bool) {
                return _paused;
            }
            /**
             * @dev Throws if the contract is paused.
             */
            function _requireNotPaused() internal view virtual {
                require(!paused(), "Pausable: paused");
            }
            /**
             * @dev Throws if the contract is not paused.
             */
            function _requirePaused() internal view virtual {
                require(paused(), "Pausable: not paused");
            }
            /**
             * @dev Triggers stopped state.
             *
             * Requirements:
             *
             * - The contract must not be paused.
             */
            function _pause() internal virtual whenNotPaused {
                _paused = true;
                emit Paused(_msgSender());
            }
            /**
             * @dev Returns to normal state.
             *
             * Requirements:
             *
             * - The contract must be paused.
             */
            function _unpause() internal virtual whenPaused {
                _paused = false;
                emit Unpaused(_msgSender());
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.7.0) (token/common/ERC2981.sol)
        pragma solidity ^0.8.0;
        import "../../interfaces/IERC2981.sol";
        import "../../utils/introspection/ERC165.sol";
        /**
         * @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information.
         *
         * Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for
         * specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first.
         *
         * Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the
         * fee is specified in basis points by default.
         *
         * IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
         * https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to
         * voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
         *
         * _Available since v4.5._
         */
        abstract contract ERC2981 is IERC2981, ERC165 {
            struct RoyaltyInfo {
                address receiver;
                uint96 royaltyFraction;
            }
            RoyaltyInfo private _defaultRoyaltyInfo;
            mapping(uint256 => RoyaltyInfo) private _tokenRoyaltyInfo;
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {
                return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);
            }
            /**
             * @inheritdoc IERC2981
             */
            function royaltyInfo(uint256 _tokenId, uint256 _salePrice) public view virtual override returns (address, uint256) {
                RoyaltyInfo memory royalty = _tokenRoyaltyInfo[_tokenId];
                if (royalty.receiver == address(0)) {
                    royalty = _defaultRoyaltyInfo;
                }
                uint256 royaltyAmount = (_salePrice * royalty.royaltyFraction) / _feeDenominator();
                return (royalty.receiver, royaltyAmount);
            }
            /**
             * @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a
             * fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an
             * override.
             */
            function _feeDenominator() internal pure virtual returns (uint96) {
                return 10000;
            }
            /**
             * @dev Sets the royalty information that all ids in this contract will default to.
             *
             * Requirements:
             *
             * - `receiver` cannot be the zero address.
             * - `feeNumerator` cannot be greater than the fee denominator.
             */
            function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
                require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
                require(receiver != address(0), "ERC2981: invalid receiver");
                _defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
            }
            /**
             * @dev Removes default royalty information.
             */
            function _deleteDefaultRoyalty() internal virtual {
                delete _defaultRoyaltyInfo;
            }
            /**
             * @dev Sets the royalty information for a specific token id, overriding the global default.
             *
             * Requirements:
             *
             * - `receiver` cannot be the zero address.
             * - `feeNumerator` cannot be greater than the fee denominator.
             */
            function _setTokenRoyalty(
                uint256 tokenId,
                address receiver,
                uint96 feeNumerator
            ) internal virtual {
                require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
                require(receiver != address(0), "ERC2981: Invalid parameters");
                _tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);
            }
            /**
             * @dev Resets royalty information for the token id back to the global default.
             */
            function _resetTokenRoyalty(uint256 tokenId) internal virtual {
                delete _tokenRoyaltyInfo[tokenId];
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.2) (token/ERC721/ERC721.sol)
        pragma solidity ^0.8.0;
        import "./IERC721.sol";
        import "./IERC721Receiver.sol";
        import "./extensions/IERC721Metadata.sol";
        import "../../utils/Address.sol";
        import "../../utils/Context.sol";
        import "../../utils/Strings.sol";
        import "../../utils/introspection/ERC165.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 ERC721 is Context, ERC165, IERC721, IERC721Metadata {
            using Address for address;
            using Strings for uint256;
            // Token name
            string private _name;
            // Token symbol
            string private _symbol;
            // Mapping from token ID to owner address
            mapping(uint256 => address) private _owners;
            // Mapping owner address to token count
            mapping(address => uint256) private _balances;
            // Mapping from token ID to approved address
            mapping(uint256 => address) private _tokenApprovals;
            // Mapping from owner to operator approvals
            mapping(address => mapping(address => bool)) private _operatorApprovals;
            /**
             * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
             */
            constructor(string memory name_, string memory symbol_) {
                _name = name_;
                _symbol = symbol_;
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
                return
                    interfaceId == type(IERC721).interfaceId ||
                    interfaceId == type(IERC721Metadata).interfaceId ||
                    super.supportsInterface(interfaceId);
            }
            /**
             * @dev See {IERC721-balanceOf}.
             */
            function balanceOf(address owner) public view virtual override returns (uint256) {
                require(owner != address(0), "ERC721: address zero is not a valid owner");
                return _balances[owner];
            }
            /**
             * @dev See {IERC721-ownerOf}.
             */
            function ownerOf(uint256 tokenId) public view virtual override returns (address) {
                address owner = _ownerOf(tokenId);
                require(owner != address(0), "ERC721: invalid token ID");
                return owner;
            }
            /**
             * @dev See {IERC721Metadata-name}.
             */
            function name() public view virtual override returns (string memory) {
                return _name;
            }
            /**
             * @dev See {IERC721Metadata-symbol}.
             */
            function symbol() public view virtual override returns (string memory) {
                return _symbol;
            }
            /**
             * @dev See {IERC721Metadata-tokenURI}.
             */
            function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                _requireMinted(tokenId);
                string memory baseURI = _baseURI();
                return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
            }
            /**
             * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
             * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
             * by default, can be overridden in child contracts.
             */
            function _baseURI() internal view virtual returns (string memory) {
                return "";
            }
            /**
             * @dev See {IERC721-approve}.
             */
            function approve(address to, uint256 tokenId) public virtual override {
                address owner = ERC721.ownerOf(tokenId);
                require(to != owner, "ERC721: approval to current owner");
                require(
                    _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                    "ERC721: approve caller is not token owner or approved for all"
                );
                _approve(to, tokenId);
            }
            /**
             * @dev See {IERC721-getApproved}.
             */
            function getApproved(uint256 tokenId) public view virtual override returns (address) {
                _requireMinted(tokenId);
                return _tokenApprovals[tokenId];
            }
            /**
             * @dev See {IERC721-setApprovalForAll}.
             */
            function setApprovalForAll(address operator, bool approved) public virtual override {
                _setApprovalForAll(_msgSender(), operator, approved);
            }
            /**
             * @dev See {IERC721-isApprovedForAll}.
             */
            function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
                return _operatorApprovals[owner][operator];
            }
            /**
             * @dev See {IERC721-transferFrom}.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                //solhint-disable-next-line max-line-length
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
                _transfer(from, to, tokenId);
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                safeTransferFrom(from, to, tokenId, "");
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes memory data
            ) public virtual override {
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or 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 the owner of the `tokenId`. Does NOT revert if token doesn't exist
             */
            function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
                return _owners[tokenId];
            }
            /**
             * @dev Returns whether `tokenId` exists.
             *
             * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
             *
             * Tokens start existing when they are minted (`_mint`),
             * and stop existing when they are burned (`_burn`).
             */
            function _exists(uint256 tokenId) internal view virtual returns (bool) {
                return _ownerOf(tokenId) != address(0);
            }
            /**
             * @dev Returns whether `spender` is allowed to manage `tokenId`.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
                address owner = ERC721.ownerOf(tokenId);
                return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
            }
            /**
             * @dev Safely mints `tokenId` and transfers it to `to`.
             *
             * Requirements:
             *
             * - `tokenId` must not exist.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function _safeMint(address to, uint256 tokenId) internal virtual {
                _safeMint(to, tokenId, "");
            }
            /**
             * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
             * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
             */
            function _safeMint(
                address to,
                uint256 tokenId,
                bytes memory data
            ) internal virtual {
                _mint(to, tokenId);
                require(
                    _checkOnERC721Received(address(0), to, tokenId, data),
                    "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, 1);
                // Check that tokenId was not minted by `_beforeTokenTransfer` hook
                require(!_exists(tokenId), "ERC721: token already minted");
                unchecked {
                    // Will not overflow unless all 2**256 token ids are minted to the same owner.
                    // Given that tokens are minted one by one, it is impossible in practice that
                    // this ever happens. Might change if we allow batch minting.
                    // The ERC fails to describe this case.
                    _balances[to] += 1;
                }
                _owners[tokenId] = to;
                emit Transfer(address(0), to, tokenId);
                _afterTokenTransfer(address(0), to, tokenId, 1);
            }
            /**
             * @dev Destroys `tokenId`.
             * The approval is cleared when the token is burned.
             * This is an internal function that does not check if the sender is authorized to operate on the token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             *
             * Emits a {Transfer} event.
             */
            function _burn(uint256 tokenId) internal virtual {
                address owner = ERC721.ownerOf(tokenId);
                _beforeTokenTransfer(owner, address(0), tokenId, 1);
                // Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
                owner = ERC721.ownerOf(tokenId);
                // Clear approvals
                delete _tokenApprovals[tokenId];
                unchecked {
                    // Cannot overflow, as that would require more tokens to be burned/transferred
                    // out than the owner initially received through minting and transferring in.
                    _balances[owner] -= 1;
                }
                delete _owners[tokenId];
                emit Transfer(owner, address(0), tokenId);
                _afterTokenTransfer(owner, address(0), tokenId, 1);
            }
            /**
             * @dev Transfers `tokenId` from `from` to `to`.
             *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
             *
             * Requirements:
             *
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             *
             * Emits a {Transfer} event.
             */
            function _transfer(
                address from,
                address to,
                uint256 tokenId
            ) internal virtual {
                require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
                require(to != address(0), "ERC721: transfer to the zero address");
                _beforeTokenTransfer(from, to, tokenId, 1);
                // Check that tokenId was not transferred by `_beforeTokenTransfer` hook
                require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
                // Clear approvals from the previous owner
                delete _tokenApprovals[tokenId];
                unchecked {
                    // `_balances[from]` cannot overflow for the same reason as described in `_burn`:
                    // `from`'s balance is the number of token held, which is at least one before the current
                    // transfer.
                    // `_balances[to]` could overflow in the conditions described in `_mint`. That would require
                    // all 2**256 token ids to be minted, which in practice is impossible.
                    _balances[from] -= 1;
                    _balances[to] += 1;
                }
                _owners[tokenId] = to;
                emit Transfer(from, to, tokenId);
                _afterTokenTransfer(from, to, tokenId, 1);
            }
            /**
             * @dev Approve `to` to operate on `tokenId`
             *
             * Emits an {Approval} event.
             */
            function _approve(address to, uint256 tokenId) internal virtual {
                _tokenApprovals[tokenId] = to;
                emit Approval(ERC721.ownerOf(tokenId), to, tokenId);
            }
            /**
             * @dev Approve `operator` to operate on all of `owner` tokens
             *
             * Emits an {ApprovalForAll} event.
             */
            function _setApprovalForAll(
                address owner,
                address operator,
                bool approved
            ) internal virtual {
                require(owner != operator, "ERC721: approve to caller");
                _operatorApprovals[owner][operator] = approved;
                emit ApprovalForAll(owner, operator, approved);
            }
            /**
             * @dev Reverts if the `tokenId` has not been minted yet.
             */
            function _requireMinted(uint256 tokenId) internal view virtual {
                require(_exists(tokenId), "ERC721: invalid token ID");
            }
            /**
             * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
             * The call is not executed if the target address is not a contract.
             *
             * @param from address representing the previous owner of the given token ID
             * @param to target address that will receive the tokens
             * @param tokenId uint256 ID of the token to be transferred
             * @param data bytes optional data to send along with the call
             * @return bool whether the call correctly returned the expected magic value
             */
            function _checkOnERC721Received(
                address from,
                address to,
                uint256 tokenId,
                bytes memory data
            ) private returns (bool) {
                if (to.isContract()) {
                    try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
                        return retval == IERC721Receiver.onERC721Received.selector;
                    } catch (bytes memory reason) {
                        if (reason.length == 0) {
                            revert("ERC721: transfer to non ERC721Receiver implementer");
                        } else {
                            /// @solidity memory-safe-assembly
                            assembly {
                                revert(add(32, reason), mload(reason))
                            }
                        }
                    }
                } else {
                    return true;
                }
            }
            /**
             * @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is
             * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
             *
             * Calling conditions:
             *
             * - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
             * - When `from` is zero, the tokens will be minted for `to`.
             * - When `to` is zero, ``from``'s tokens will be burned.
             * - `from` and `to` are never both zero.
             * - `batchSize` is non-zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual {}
            /**
             * @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
             * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
             *
             * Calling conditions:
             *
             * - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
             * - When `from` is zero, the tokens were minted for `to`.
             * - When `to` is zero, ``from``'s tokens were burned.
             * - `from` and `to` are never both zero.
             * - `batchSize` is non-zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _afterTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual {}
            /**
             * @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
             *
             * WARNING: Anyone calling this MUST ensure that the balances remain consistent with the ownership. The invariant
             * being that for any address `a` the value returned by `balanceOf(a)` must be equal to the number of tokens such
             * that `ownerOf(tokenId)` is `a`.
             */
            // solhint-disable-next-line func-name-mixedcase
            function __unsafe_increaseBalance(address account, uint256 amount) internal {
                _balances[account] += amount;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/extensions/ERC721Burnable.sol)
        pragma solidity ^0.8.0;
        import "../ERC721.sol";
        import "../../../utils/Context.sol";
        /**
         * @title ERC721 Burnable Token
         * @dev ERC721 Token that can be burned (destroyed).
         */
        abstract contract ERC721Burnable is Context, ERC721 {
            /**
             * @dev Burns `tokenId`. See {ERC721-_burn}.
             *
             * Requirements:
             *
             * - The caller must own `tokenId` or be an approved operator.
             */
            function burn(uint256 tokenId) public virtual {
                //solhint-disable-next-line max-line-length
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
                _burn(tokenId);
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/extensions/ERC721Enumerable.sol)
        pragma solidity ^0.8.0;
        import "../ERC721.sol";
        import "./IERC721Enumerable.sol";
        /**
         * @dev This implements an optional extension of {ERC721} defined in the EIP that adds
         * enumerability of all the token ids in the contract as well as all token ids owned by each
         * account.
         */
        abstract contract ERC721Enumerable is ERC721, IERC721Enumerable {
            // Mapping from owner to list of owned token IDs
            mapping(address => mapping(uint256 => uint256)) private _ownedTokens;
            // Mapping from token ID to index of the owner tokens list
            mapping(uint256 => uint256) private _ownedTokensIndex;
            // Array with all token ids, used for enumeration
            uint256[] private _allTokens;
            // Mapping from token id to position in the allTokens array
            mapping(uint256 => uint256) private _allTokensIndex;
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC721) returns (bool) {
                return interfaceId == type(IERC721Enumerable).interfaceId || super.supportsInterface(interfaceId);
            }
            /**
             * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}.
             */
            function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual override returns (uint256) {
                require(index < ERC721.balanceOf(owner), "ERC721Enumerable: owner index out of bounds");
                return _ownedTokens[owner][index];
            }
            /**
             * @dev See {IERC721Enumerable-totalSupply}.
             */
            function totalSupply() public view virtual override returns (uint256) {
                return _allTokens.length;
            }
            /**
             * @dev See {IERC721Enumerable-tokenByIndex}.
             */
            function tokenByIndex(uint256 index) public view virtual override returns (uint256) {
                require(index < ERC721Enumerable.totalSupply(), "ERC721Enumerable: global index out of bounds");
                return _allTokens[index];
            }
            /**
             * @dev See {ERC721-_beforeTokenTransfer}.
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual override {
                super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
                if (batchSize > 1) {
                    // Will only trigger during construction. Batch transferring (minting) is not available afterwards.
                    revert("ERC721Enumerable: consecutive transfers not supported");
                }
                uint256 tokenId = firstTokenId;
                if (from == address(0)) {
                    _addTokenToAllTokensEnumeration(tokenId);
                } else if (from != to) {
                    _removeTokenFromOwnerEnumeration(from, tokenId);
                }
                if (to == address(0)) {
                    _removeTokenFromAllTokensEnumeration(tokenId);
                } else if (to != from) {
                    _addTokenToOwnerEnumeration(to, tokenId);
                }
            }
            /**
             * @dev Private function to add a token to this extension's ownership-tracking data structures.
             * @param to address representing the new owner of the given token ID
             * @param tokenId uint256 ID of the token to be added to the tokens list of the given address
             */
            function _addTokenToOwnerEnumeration(address to, uint256 tokenId) private {
                uint256 length = ERC721.balanceOf(to);
                _ownedTokens[to][length] = tokenId;
                _ownedTokensIndex[tokenId] = length;
            }
            /**
             * @dev Private function to add a token to this extension's token tracking data structures.
             * @param tokenId uint256 ID of the token to be added to the tokens list
             */
            function _addTokenToAllTokensEnumeration(uint256 tokenId) private {
                _allTokensIndex[tokenId] = _allTokens.length;
                _allTokens.push(tokenId);
            }
            /**
             * @dev Private function to remove a token from this extension's ownership-tracking data structures. Note that
             * while the token is not assigned a new owner, the `_ownedTokensIndex` mapping is _not_ updated: this allows for
             * gas optimizations e.g. when performing a transfer operation (avoiding double writes).
             * This has O(1) time complexity, but alters the order of the _ownedTokens array.
             * @param from address representing the previous owner of the given token ID
             * @param tokenId uint256 ID of the token to be removed from the tokens list of the given address
             */
            function _removeTokenFromOwnerEnumeration(address from, uint256 tokenId) private {
                // To prevent a gap in from's tokens array, we store the last token in the index of the token to delete, and
                // then delete the last slot (swap and pop).
                uint256 lastTokenIndex = ERC721.balanceOf(from) - 1;
                uint256 tokenIndex = _ownedTokensIndex[tokenId];
                // When the token to delete is the last token, the swap operation is unnecessary
                if (tokenIndex != lastTokenIndex) {
                    uint256 lastTokenId = _ownedTokens[from][lastTokenIndex];
                    _ownedTokens[from][tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
                    _ownedTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index
                }
                // This also deletes the contents at the last position of the array
                delete _ownedTokensIndex[tokenId];
                delete _ownedTokens[from][lastTokenIndex];
            }
            /**
             * @dev Private function to remove a token from this extension's token tracking data structures.
             * This has O(1) time complexity, but alters the order of the _allTokens array.
             * @param tokenId uint256 ID of the token to be removed from the tokens list
             */
            function _removeTokenFromAllTokensEnumeration(uint256 tokenId) private {
                // To prevent a gap in the tokens array, we store the last token in the index of the token to delete, and
                // then delete the last slot (swap and pop).
                uint256 lastTokenIndex = _allTokens.length - 1;
                uint256 tokenIndex = _allTokensIndex[tokenId];
                // When the token to delete is the last token, the swap operation is unnecessary. However, since this occurs so
                // rarely (when the last minted token is burnt) that we still do the swap here to avoid the gas cost of adding
                // an 'if' statement (like in _removeTokenFromOwnerEnumeration)
                uint256 lastTokenId = _allTokens[lastTokenIndex];
                _allTokens[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
                _allTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index
                // This also deletes the contents at the last position of the array
                delete _allTokensIndex[tokenId];
                _allTokens.pop();
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.2) (token/ERC721/extensions/ERC721Pausable.sol)
        pragma solidity ^0.8.0;
        import "../ERC721.sol";
        import "../../../security/Pausable.sol";
        /**
         * @dev ERC721 token with pausable token transfers, minting and burning.
         *
         * Useful for scenarios such as preventing trades until the end of an evaluation
         * period, or having an emergency switch for freezing all token transfers in the
         * event of a large bug.
         *
         * IMPORTANT: This contract does not include public pause and unpause functions. In
         * addition to inheriting this contract, you must define both functions, invoking the
         * {Pausable-_pause} and {Pausable-_unpause} internal functions, with appropriate
         * access control, e.g. using {AccessControl} or {Ownable}. Not doing so will
         * make the contract unpausable.
         */
        abstract contract ERC721Pausable is ERC721, Pausable {
            /**
             * @dev See {ERC721-_beforeTokenTransfer}.
             *
             * Requirements:
             *
             * - the contract must not be paused.
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual override {
                super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
                require(!paused(), "ERC721Pausable: token transfer while paused");
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.5.0) (token/ERC721/extensions/IERC721Enumerable.sol)
        pragma solidity ^0.8.0;
        import "../IERC721.sol";
        /**
         * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
         * @dev See https://eips.ethereum.org/EIPS/eip-721
         */
        interface IERC721Enumerable is IERC721 {
            /**
             * @dev Returns the total amount of tokens stored by the contract.
             */
            function totalSupply() external view returns (uint256);
            /**
             * @dev Returns a token ID owned by `owner` at a given `index` of its token list.
             * Use along with {balanceOf} to enumerate all of ``owner``'s tokens.
             */
            function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);
            /**
             * @dev Returns a token ID at a given `index` of all the tokens stored by the contract.
             * Use along with {totalSupply} to enumerate all tokens.
             */
            function tokenByIndex(uint256 index) external view returns (uint256);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
        pragma solidity ^0.8.0;
        import "../IERC721.sol";
        /**
         * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
         * @dev See https://eips.ethereum.org/EIPS/eip-721
         */
        interface IERC721Metadata is IERC721 {
            /**
             * @dev Returns the token collection name.
             */
            function name() external view returns (string memory);
            /**
             * @dev Returns the token collection symbol.
             */
            function symbol() external view returns (string memory);
            /**
             * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
             */
            function tokenURI(uint256 tokenId) external view returns (string memory);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/IERC721.sol)
        pragma solidity ^0.8.0;
        import "../../utils/introspection/IERC165.sol";
        /**
         * @dev Required interface of an ERC721 compliant contract.
         */
        interface IERC721 is IERC165 {
            /**
             * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
             */
            event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
             */
            event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
             */
            event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
            /**
             * @dev Returns the number of tokens in ``owner``'s account.
             */
            function balanceOf(address owner) external view returns (uint256 balance);
            /**
             * @dev Returns the owner of the `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function ownerOf(uint256 tokenId) external view returns (address owner);
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes calldata data
            ) external;
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
             * are aware of the ERC721 protocol to prevent tokens from being forever locked.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Transfers `tokenId` token from `from` to `to`.
             *
             * WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
             * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
             * understand this adds an external call which potentially creates a reentrancy vulnerability.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Gives permission to `to` to transfer `tokenId` token to another account.
             * The approval is cleared when the token is transferred.
             *
             * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
             *
             * Requirements:
             *
             * - The caller must own the token or be an approved operator.
             * - `tokenId` must exist.
             *
             * Emits an {Approval} event.
             */
            function approve(address to, uint256 tokenId) external;
            /**
             * @dev Approve or remove `operator` as an operator for the caller.
             * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
             *
             * Requirements:
             *
             * - The `operator` cannot be the caller.
             *
             * Emits an {ApprovalForAll} event.
             */
            function setApprovalForAll(address operator, bool _approved) external;
            /**
             * @dev Returns the account approved for `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function getApproved(uint256 tokenId) external view returns (address operator);
            /**
             * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
             *
             * See {setApprovalForAll}
             */
            function isApprovedForAll(address owner, address operator) external view returns (bool);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)
        pragma solidity ^0.8.0;
        /**
         * @title ERC721 token receiver interface
         * @dev Interface for any contract that wants to support safeTransfers
         * from ERC721 asset contracts.
         */
        interface IERC721Receiver {
            /**
             * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
             * by `operator` from `from`, this function is called.
             *
             * It must return its Solidity selector to confirm the token transfer.
             * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
             *
             * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
             */
            function onERC721Received(
                address operator,
                address from,
                uint256 tokenId,
                bytes calldata data
            ) external returns (bytes4);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
        pragma solidity ^0.8.1;
        /**
         * @dev Collection of functions related to the address type
         */
        library Address {
            /**
             * @dev Returns true if `account` is a contract.
             *
             * [IMPORTANT]
             * ====
             * It is unsafe to assume that an address for which this function returns
             * false is an externally-owned account (EOA) and not a contract.
             *
             * Among others, `isContract` will return false for the following
             * types of addresses:
             *
             *  - an externally-owned account
             *  - a contract in construction
             *  - an address where a contract will be created
             *  - an address where a contract lived, but was destroyed
             * ====
             *
             * [IMPORTANT]
             * ====
             * You shouldn't rely on `isContract` to protect against flash loan attacks!
             *
             * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
             * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
             * constructor.
             * ====
             */
            function isContract(address account) internal view returns (bool) {
                // This method relies on extcodesize/address.code.length, which returns 0
                // for contracts in construction, since the code is only stored at the end
                // of the constructor execution.
                return account.code.length > 0;
            }
            /**
             * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
             * `recipient`, forwarding all available gas and reverting on errors.
             *
             * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
             * of certain opcodes, possibly making contracts go over the 2300 gas limit
             * imposed by `transfer`, making them unable to receive funds via
             * `transfer`. {sendValue} removes this limitation.
             *
             * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
             *
             * IMPORTANT: because control is transferred to `recipient`, care must be
             * taken to not create reentrancy vulnerabilities. Consider using
             * {ReentrancyGuard} or the
             * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
             */
            function sendValue(address payable recipient, uint256 amount) internal {
                require(address(this).balance >= amount, "Address: insufficient balance");
                (bool success, ) = recipient.call{value: amount}("");
                require(success, "Address: unable to send value, recipient may have reverted");
            }
            /**
             * @dev Performs a Solidity function call using a low level `call`. A
             * plain `call` is an unsafe replacement for a function call: use this
             * function instead.
             *
             * If `target` reverts with a revert reason, it is bubbled up by this
             * function (like regular Solidity function calls).
             *
             * Returns the raw returned data. To convert to the expected return value,
             * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
             *
             * Requirements:
             *
             * - `target` must be a contract.
             * - calling `target` with `data` must not revert.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, "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");
                (bool success, bytes memory returndata) = target.call{value: value}(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                return functionStaticCall(target, data, "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) {
                (bool success, bytes memory returndata) = target.staticcall(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionDelegateCall(target, data, "Address: low-level delegate call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                (bool success, bytes memory returndata) = target.delegatecall(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
             * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
             *
             * _Available since v4.8._
             */
            function verifyCallResultFromTarget(
                address target,
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal view returns (bytes memory) {
                if (success) {
                    if (returndata.length == 0) {
                        // only check isContract if the call was successful and the return data is empty
                        // otherwise we already know that it was a contract
                        require(isContract(target), "Address: call to non-contract");
                    }
                    return returndata;
                } else {
                    _revert(returndata, errorMessage);
                }
            }
            /**
             * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
             * revert reason or using the provided one.
             *
             * _Available since v4.3._
             */
            function verifyCallResult(
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal pure returns (bytes memory) {
                if (success) {
                    return returndata;
                } else {
                    _revert(returndata, errorMessage);
                }
            }
            function _revert(bytes memory returndata, string memory errorMessage) private pure {
                // Look for revert reason and bubble it up if present
                if (returndata.length > 0) {
                    // The easiest way to bubble the revert reason is using memory via assembly
                    /// @solidity memory-safe-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Provides information about the current execution context, including the
         * sender of the transaction and its data. While these are generally available
         * via msg.sender and msg.data, they should not be accessed in such a direct
         * manner, since when dealing with meta-transactions the account sending and
         * paying for execution may not be the actual sender (as far as an application
         * is concerned).
         *
         * This contract is only required for intermediate, library-like contracts.
         */
        abstract contract Context {
            function _msgSender() internal view virtual returns (address) {
                return msg.sender;
            }
            function _msgData() internal view virtual returns (bytes calldata) {
                return msg.data;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Counters.sol)
        pragma solidity ^0.8.0;
        /**
         * @title Counters
         * @author Matt Condon (@shrugs)
         * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
         * of elements in a mapping, issuing ERC721 ids, or counting request ids.
         *
         * Include with `using Counters for Counters.Counter;`
         */
        library Counters {
            struct Counter {
                // This variable should never be directly accessed by users of the library: interactions must be restricted to
                // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
                // this feature: see https://github.com/ethereum/solidity/issues/4637
                uint256 _value; // default: 0
            }
            function current(Counter storage counter) internal view returns (uint256) {
                return counter._value;
            }
            function increment(Counter storage counter) internal {
                unchecked {
                    counter._value += 1;
                }
            }
            function decrement(Counter storage counter) internal {
                uint256 value = counter._value;
                require(value > 0, "Counter: decrement overflow");
                unchecked {
                    counter._value = value - 1;
                }
            }
            function reset(Counter storage counter) internal {
                counter._value = 0;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
        pragma solidity ^0.8.0;
        import "./IERC165.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 ERC165 is IERC165 {
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                return interfaceId == type(IERC165).interfaceId;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC165 standard, as defined in the
         * https://eips.ethereum.org/EIPS/eip-165[EIP].
         *
         * Implementers can declare support of contract interfaces, which can then be
         * queried by others ({ERC165Checker}).
         *
         * For an implementation, see {ERC165}.
         */
        interface IERC165 {
            /**
             * @dev Returns true if this contract implements the interface defined by
             * `interfaceId`. See the corresponding
             * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
             * to learn more about how these ids are created.
             *
             * This function call must use less than 30 000 gas.
             */
            function supportsInterface(bytes4 interfaceId) external view returns (bool);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Standard math utilities missing in the Solidity language.
         */
        library Math {
            enum Rounding {
                Down, // Toward negative infinity
                Up, // Toward infinity
                Zero // Toward zero
            }
            /**
             * @dev Returns the largest of two numbers.
             */
            function max(uint256 a, uint256 b) internal pure returns (uint256) {
                return a > b ? a : b;
            }
            /**
             * @dev Returns the smallest of two numbers.
             */
            function min(uint256 a, uint256 b) internal pure returns (uint256) {
                return a < b ? a : b;
            }
            /**
             * @dev Returns the average of two numbers. The result is rounded towards
             * zero.
             */
            function average(uint256 a, uint256 b) internal pure returns (uint256) {
                // (a + b) / 2 can overflow.
                return (a & b) + (a ^ b) / 2;
            }
            /**
             * @dev Returns the ceiling of the division of two numbers.
             *
             * This differs from standard division with `/` in that it rounds up instead
             * of rounding down.
             */
            function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
                // (a + b - 1) / b can overflow on addition, so we distribute.
                return a == 0 ? 0 : (a - 1) / b + 1;
            }
            /**
             * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
             * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
             * with further edits by Uniswap Labs also under MIT license.
             */
            function mulDiv(
                uint256 x,
                uint256 y,
                uint256 denominator
            ) internal pure returns (uint256 result) {
                unchecked {
                    // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
                    // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
                    // variables such that product = prod1 * 2^256 + prod0.
                    uint256 prod0; // Least significant 256 bits of the product
                    uint256 prod1; // Most significant 256 bits of the product
                    assembly {
                        let mm := mulmod(x, y, not(0))
                        prod0 := mul(x, y)
                        prod1 := sub(sub(mm, prod0), lt(mm, prod0))
                    }
                    // Handle non-overflow cases, 256 by 256 division.
                    if (prod1 == 0) {
                        return prod0 / denominator;
                    }
                    // Make sure the result is less than 2^256. Also prevents denominator == 0.
                    require(denominator > prod1);
                    ///////////////////////////////////////////////
                    // 512 by 256 division.
                    ///////////////////////////////////////////////
                    // Make division exact by subtracting the remainder from [prod1 prod0].
                    uint256 remainder;
                    assembly {
                        // Compute remainder using mulmod.
                        remainder := mulmod(x, y, denominator)
                        // Subtract 256 bit number from 512 bit number.
                        prod1 := sub(prod1, gt(remainder, prod0))
                        prod0 := sub(prod0, remainder)
                    }
                    // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
                    // See https://cs.stackexchange.com/q/138556/92363.
                    // Does not overflow because the denominator cannot be zero at this stage in the function.
                    uint256 twos = denominator & (~denominator + 1);
                    assembly {
                        // Divide denominator by twos.
                        denominator := div(denominator, twos)
                        // Divide [prod1 prod0] by twos.
                        prod0 := div(prod0, twos)
                        // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                        twos := add(div(sub(0, twos), twos), 1)
                    }
                    // Shift in bits from prod1 into prod0.
                    prod0 |= prod1 * twos;
                    // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
                    // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
                    // four bits. That is, denominator * inv = 1 mod 2^4.
                    uint256 inverse = (3 * denominator) ^ 2;
                    // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
                    // in modular arithmetic, doubling the correct bits in each step.
                    inverse *= 2 - denominator * inverse; // inverse mod 2^8
                    inverse *= 2 - denominator * inverse; // inverse mod 2^16
                    inverse *= 2 - denominator * inverse; // inverse mod 2^32
                    inverse *= 2 - denominator * inverse; // inverse mod 2^64
                    inverse *= 2 - denominator * inverse; // inverse mod 2^128
                    inverse *= 2 - denominator * inverse; // inverse mod 2^256
                    // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
                    // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
                    // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
                    // is no longer required.
                    result = prod0 * inverse;
                    return result;
                }
            }
            /**
             * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
             */
            function mulDiv(
                uint256 x,
                uint256 y,
                uint256 denominator,
                Rounding rounding
            ) internal pure returns (uint256) {
                uint256 result = mulDiv(x, y, denominator);
                if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
                    result += 1;
                }
                return result;
            }
            /**
             * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
             *
             * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
             */
            function sqrt(uint256 a) internal pure returns (uint256) {
                if (a == 0) {
                    return 0;
                }
                // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
                //
                // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
                // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
                //
                // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
                // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
                // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
                //
                // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
                uint256 result = 1 << (log2(a) >> 1);
                // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
                // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
                // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
                // into the expected uint128 result.
                unchecked {
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    return min(result, a / result);
                }
            }
            /**
             * @notice Calculates sqrt(a), following the selected rounding direction.
             */
            function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
                unchecked {
                    uint256 result = sqrt(a);
                    return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
                }
            }
            /**
             * @dev Return the log in base 2, rounded down, of a positive value.
             * Returns 0 if given 0.
             */
            function log2(uint256 value) internal pure returns (uint256) {
                uint256 result = 0;
                unchecked {
                    if (value >> 128 > 0) {
                        value >>= 128;
                        result += 128;
                    }
                    if (value >> 64 > 0) {
                        value >>= 64;
                        result += 64;
                    }
                    if (value >> 32 > 0) {
                        value >>= 32;
                        result += 32;
                    }
                    if (value >> 16 > 0) {
                        value >>= 16;
                        result += 16;
                    }
                    if (value >> 8 > 0) {
                        value >>= 8;
                        result += 8;
                    }
                    if (value >> 4 > 0) {
                        value >>= 4;
                        result += 4;
                    }
                    if (value >> 2 > 0) {
                        value >>= 2;
                        result += 2;
                    }
                    if (value >> 1 > 0) {
                        result += 1;
                    }
                }
                return result;
            }
            /**
             * @dev Return the log in base 2, following the selected rounding direction, of a positive value.
             * Returns 0 if given 0.
             */
            function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
                unchecked {
                    uint256 result = log2(value);
                    return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
                }
            }
            /**
             * @dev Return the log in base 10, rounded down, of a positive value.
             * Returns 0 if given 0.
             */
            function log10(uint256 value) internal pure returns (uint256) {
                uint256 result = 0;
                unchecked {
                    if (value >= 10**64) {
                        value /= 10**64;
                        result += 64;
                    }
                    if (value >= 10**32) {
                        value /= 10**32;
                        result += 32;
                    }
                    if (value >= 10**16) {
                        value /= 10**16;
                        result += 16;
                    }
                    if (value >= 10**8) {
                        value /= 10**8;
                        result += 8;
                    }
                    if (value >= 10**4) {
                        value /= 10**4;
                        result += 4;
                    }
                    if (value >= 10**2) {
                        value /= 10**2;
                        result += 2;
                    }
                    if (value >= 10**1) {
                        result += 1;
                    }
                }
                return result;
            }
            /**
             * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
             * Returns 0 if given 0.
             */
            function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
                unchecked {
                    uint256 result = log10(value);
                    return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0);
                }
            }
            /**
             * @dev Return the log in base 256, rounded down, of a positive value.
             * Returns 0 if given 0.
             *
             * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
             */
            function log256(uint256 value) internal pure returns (uint256) {
                uint256 result = 0;
                unchecked {
                    if (value >> 128 > 0) {
                        value >>= 128;
                        result += 16;
                    }
                    if (value >> 64 > 0) {
                        value >>= 64;
                        result += 8;
                    }
                    if (value >> 32 > 0) {
                        value >>= 32;
                        result += 4;
                    }
                    if (value >> 16 > 0) {
                        value >>= 16;
                        result += 2;
                    }
                    if (value >> 8 > 0) {
                        result += 1;
                    }
                }
                return result;
            }
            /**
             * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
             * Returns 0 if given 0.
             */
            function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
                unchecked {
                    uint256 result = log256(value);
                    return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0);
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)
        pragma solidity ^0.8.0;
        import "./math/Math.sol";
        /**
         * @dev String operations.
         */
        library Strings {
            bytes16 private constant _SYMBOLS = "0123456789abcdef";
            uint8 private constant _ADDRESS_LENGTH = 20;
            /**
             * @dev Converts a `uint256` to its ASCII `string` decimal representation.
             */
            function toString(uint256 value) internal pure returns (string memory) {
                unchecked {
                    uint256 length = Math.log10(value) + 1;
                    string memory buffer = new string(length);
                    uint256 ptr;
                    /// @solidity memory-safe-assembly
                    assembly {
                        ptr := add(buffer, add(32, length))
                    }
                    while (true) {
                        ptr--;
                        /// @solidity memory-safe-assembly
                        assembly {
                            mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                        }
                        value /= 10;
                        if (value == 0) break;
                    }
                    return buffer;
                }
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
             */
            function toHexString(uint256 value) internal pure returns (string memory) {
                unchecked {
                    return toHexString(value, Math.log256(value) + 1);
                }
            }
            /**
             * @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] = _SYMBOLS[value & 0xf];
                    value >>= 4;
                }
                require(value == 0, "Strings: hex length insufficient");
                return string(buffer);
            }
            /**
             * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
             */
            function toHexString(address addr) internal pure returns (string memory) {
                return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
            }
        }
        /*
         /$$$$$$$$                     /$$$$$$$$                                          /$$          
        | $$_____/                    | $$_____/                                         |__/          
        | $$        /$$$$$$   /$$$$$$$| $$     /$$$$$$   /$$$$$$   /$$$$$$   /$$$$$$      /$$  /$$$$$$ 
        | $$$$$    /$$__  $$ /$$_____/| $$$$$ /$$__  $$ /$$__  $$ /$$__  $$ /$$__  $$    | $$ /$$__  $$
        | $$__/   | $$  \\__/| $$      | $$__/| $$  \\ $$| $$  \\__/| $$  \\ $$| $$$$$$$$    | $$| $$  \\ $$
        | $$      | $$      | $$      | $$   | $$  | $$| $$      | $$  | $$| $$_____/    | $$| $$  | $$
        | $$$$$$$$| $$      |  $$$$$$$| $$   |  $$$$$$/| $$      |  $$$$$$$|  $$$$$$$ /$$| $$|  $$$$$$/
        |________/|__/       \\_______/|__/    \\______/ |__/       \\____  $$ \\_______/|__/|__/ \\______/ 
                                                                  /$$  \\ $$                            
                                                                 |  $$$$$$/                            
                                                                  \\______/                             
        */
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
        import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Enumerable.sol";
        import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Burnable.sol";
        import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Pausable.sol";
        import "@openzeppelin/contracts/utils/Counters.sol";
        import "./ErcForgeNftCore.sol";
        import "../interface/IErcForgeERC721Mintable.sol";
        import "../interface/IErcForgeInitiable.sol";
        contract ErcForge721Template is
            ERC721Enumerable,
            ERC721Burnable,
            ERC721Pausable,
            ErcForgeNftCore,
            IErcForgeInitiable
        {
            string public _name;
            string public _symbol;
            string public contractURI;
            string private _baseTokenURI;
            using Counters for Counters.Counter;
            Counters.Counter private _tokenIdTracker;
            uint256 public maxSupply;
            uint256 public price;
            constructor() ERC721("", "") {}
            function init(
                address newOwner,
                string memory newName,
                string memory newSymbol,
                string memory newBaseTokenURI,
                string memory newContractURI,
                address royaltyReceiver,
                uint96 royaltyFee
            ) public {
                _init(newOwner, royaltyReceiver, royaltyFee);
                _name = newName;
                _symbol = newSymbol;
                _baseTokenURI = newBaseTokenURI;
                contractURI = newContractURI;
                _tokenIdTracker.increment();
            }
            function _baseURI() internal view virtual override returns (string memory) {
                return _baseTokenURI;
            }
            function name() public view virtual override returns (string memory) {
                return _name;
            }
            function symbol() public view virtual override returns (string memory) {
                return _symbol;
            }
            function setBaseURI(string memory newURI) public onlyAdmin {
                _baseTokenURI = newURI;
            }
            function setContractURI(string memory newURI) public onlyAdmin {
                contractURI = newURI;
            }
            function setTokenPriceAndSupply(
                uint256 _price,
                uint256 _maxSupply
            ) public onlyAdmin {
                price = _price;
                maxSupply = _maxSupply;
            }
            function mint(address to) external payable {
                if (_tokenIdTracker.current() > maxSupply) {
                    revert NoSupply();
                }
                if (msg.value < price) {
                    revert NotEnoughFunds();
                }
                _mint(to, _tokenIdTracker.current());
                _tokenIdTracker.increment();
            }
            function airdrop(address[] calldata to) external onlyAdmin {
                for (uint256 i = 0; i < to.length; i++) {
                    _mint(to[i], _tokenIdTracker.current());
                    _tokenIdTracker.increment();
                }
            }
            /**
             * @dev Pauses all token transfers.
             */
            function pause() public onlyAdmin {
                _pause();
            }
            /**
             * @dev Unpauses all token transfers.
             */
            function unpause() public onlyAdmin {
                _unpause();
            }
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual override(ERC721, ERC721Enumerable, ERC721Pausable) {
                super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(
                bytes4 interfaceId
            )
                public
                view
                virtual
                override(ERC721, ERC721Enumerable, ERC2981)
                returns (bool)
            {
                return super.supportsInterface(interfaceId);
            }
            /**
             * @dev OperatorFilter
             */
            function setApprovalForAll(
                address operator,
                bool approved
            ) public override(ERC721, IERC721) onlyAllowedOperatorApproval(operator) {
                super.setApprovalForAll(operator, approved);
            }
            function approve(
                address operator,
                uint256 tokenId
            ) public override(ERC721, IERC721) onlyAllowedOperatorApproval(operator) {
                super.approve(operator, tokenId);
            }
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public override(ERC721, IERC721) onlyAllowedOperator(from) {
                super.transferFrom(from, to, tokenId);
            }
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public override(ERC721, IERC721) onlyAllowedOperator(from) {
                super.safeTransferFrom(from, to, tokenId);
            }
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes memory data
            ) public override(ERC721, IERC721) onlyAllowedOperator(from) {
                super.safeTransferFrom(from, to, tokenId, data);
            }
        }
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        import "operator-filter-registry/src/OperatorFilterer.sol";
        import {CANONICAL_CORI_SUBSCRIPTION} from "operator-filter-registry/src/lib/Constants.sol";
        import "@openzeppelin/contracts/token/common/ERC2981.sol";
        contract ErcForgeNftCore is OperatorFilterer, ERC2981 {
            address public owner;
            mapping(address => bool) public isAdmin;
            bool private _isInitDone = false;
            bool private _isOperatorFilterRegistered = false;
            error InitDone();
            error NotOwner();
            error NotAdmin();
            error ZeroAddress();
            error NotEnoughFunds();
            error NoSupply();
            error AmountShouldNotBeZero();
            constructor() OperatorFilterer(address(0), false) {
                _isInitDone = true;
            }
            function _init(
                address newOwner,
                address royaltyReceiver,
                uint96 royaltyFee
            ) internal {
                if (_isInitDone) {
                    revert InitDone();
                }
                owner = newOwner;
                isAdmin[newOwner] = true;
                _setRoyalty(royaltyReceiver, royaltyFee);
                _isInitDone = true;
            }
            function withdraw() public onlyOwner {
                payable(msg.sender).transfer(address(this).balance);
            }
            function getBalance() public view returns (uint256) {
                return address(this).balance;
            }
            /**
             * @dev Owner
             */
            modifier onlyOwner() {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                _;
            }
            function transferOwnership(address newOwner) public virtual onlyOwner {
                if (newOwner == address(0)) {
                    revert ZeroAddress();
                }
                isAdmin[owner] = false;
                isAdmin[newOwner] = true;
                owner = newOwner;
            }
            /**
             * @dev Admin
             */
            modifier onlyAdmin() {
                if (isAdmin[msg.sender] != true) {
                    revert NotAdmin();
                }
                _;
            }
            function setIsAdmin(address adminAddress, bool admin) public onlyOwner {
                isAdmin[adminAddress] = admin;
            }
            /**
             * @dev Royalty
             */
            function setRoyalty(
                address _royaltyReceiver,
                uint256 _royaltyFee
            ) public onlyAdmin {
                _setRoyalty(_royaltyReceiver, uint96(_royaltyFee));
            }
            function _setRoyalty(address _royaltyReceiver, uint96 _royaltyFee) private {
                if (_royaltyReceiver == address(0)) {
                    _setDefaultRoyalty(owner, 0);
                } else {
                    _setDefaultRoyalty(_royaltyReceiver, _royaltyFee);
                }
                if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
                    if (_royaltyReceiver != address(0)) {
                        if (!_isOperatorFilterRegistered) {
                            OPERATOR_FILTER_REGISTRY.registerAndSubscribe(
                                address(this),
                                CANONICAL_CORI_SUBSCRIPTION
                            );
                            _isOperatorFilterRegistered = true;
                        }
                    } else {
                        if (_isOperatorFilterRegistered) {
                            OPERATOR_FILTER_REGISTRY.unregister(address(this));
                            _isOperatorFilterRegistered = false;
                        }
                    }
                }
            }
        }
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        interface IErcForgeERC721Mintable {
            function mint(address to) external payable;
        }
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        interface IErcForgeInitiable {
            function init(
                address newOwner,
                string memory newName,
                string memory newSymbol,
                string memory newBaseTokenURI,
                string memory newContractUri,
                address royaltyReceiver,
                uint96 royaltyFee
            ) external;
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.13;
        interface IOperatorFilterRegistry {
            /**
             * @notice Returns true if operator is not filtered for a given token, either by address or codeHash. Also returns
             *         true if supplied registrant address is not registered.
             */
            function isOperatorAllowed(address registrant, address operator) external view returns (bool);
            /**
             * @notice Registers an address with the registry. May be called by address itself or by EIP-173 owner.
             */
            function register(address registrant) external;
            /**
             * @notice Registers an address with the registry and "subscribes" to another address's filtered operators and codeHashes.
             */
            function registerAndSubscribe(address registrant, address subscription) external;
            /**
             * @notice Registers an address with the registry and copies the filtered operators and codeHashes from another
             *         address without subscribing.
             */
            function registerAndCopyEntries(address registrant, address registrantToCopy) external;
            /**
             * @notice Unregisters an address with the registry and removes its subscription. May be called by address itself or by EIP-173 owner.
             *         Note that this does not remove any filtered addresses or codeHashes.
             *         Also note that any subscriptions to this registrant will still be active and follow the existing filtered addresses and codehashes.
             */
            function unregister(address addr) external;
            /**
             * @notice Update an operator address for a registered address - when filtered is true, the operator is filtered.
             */
            function updateOperator(address registrant, address operator, bool filtered) external;
            /**
             * @notice Update multiple operators for a registered address - when filtered is true, the operators will be filtered. Reverts on duplicates.
             */
            function updateOperators(address registrant, address[] calldata operators, bool filtered) external;
            /**
             * @notice Update a codeHash for a registered address - when filtered is true, the codeHash is filtered.
             */
            function updateCodeHash(address registrant, bytes32 codehash, bool filtered) external;
            /**
             * @notice Update multiple codeHashes for a registered address - when filtered is true, the codeHashes will be filtered. Reverts on duplicates.
             */
            function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external;
            /**
             * @notice Subscribe an address to another registrant's filtered operators and codeHashes. Will remove previous
             *         subscription if present.
             *         Note that accounts with subscriptions may go on to subscribe to other accounts - in this case,
             *         subscriptions will not be forwarded. Instead the former subscription's existing entries will still be
             *         used.
             */
            function subscribe(address registrant, address registrantToSubscribe) external;
            /**
             * @notice Unsubscribe an address from its current subscribed registrant, and optionally copy its filtered operators and codeHashes.
             */
            function unsubscribe(address registrant, bool copyExistingEntries) external;
            /**
             * @notice Get the subscription address of a given registrant, if any.
             */
            function subscriptionOf(address addr) external returns (address registrant);
            /**
             * @notice Get the set of addresses subscribed to a given registrant.
             *         Note that order is not guaranteed as updates are made.
             */
            function subscribers(address registrant) external returns (address[] memory);
            /**
             * @notice Get the subscriber at a given index in the set of addresses subscribed to a given registrant.
             *         Note that order is not guaranteed as updates are made.
             */
            function subscriberAt(address registrant, uint256 index) external returns (address);
            /**
             * @notice Copy filtered operators and codeHashes from a different registrantToCopy to addr.
             */
            function copyEntriesOf(address registrant, address registrantToCopy) external;
            /**
             * @notice Returns true if operator is filtered by a given address or its subscription.
             */
            function isOperatorFiltered(address registrant, address operator) external returns (bool);
            /**
             * @notice Returns true if the hash of an address's code is filtered by a given address or its subscription.
             */
            function isCodeHashOfFiltered(address registrant, address operatorWithCode) external returns (bool);
            /**
             * @notice Returns true if a codeHash is filtered by a given address or its subscription.
             */
            function isCodeHashFiltered(address registrant, bytes32 codeHash) external returns (bool);
            /**
             * @notice Returns a list of filtered operators for a given address or its subscription.
             */
            function filteredOperators(address addr) external returns (address[] memory);
            /**
             * @notice Returns the set of filtered codeHashes for a given address or its subscription.
             *         Note that order is not guaranteed as updates are made.
             */
            function filteredCodeHashes(address addr) external returns (bytes32[] memory);
            /**
             * @notice Returns the filtered operator at the given index of the set of filtered operators for a given address or
             *         its subscription.
             *         Note that order is not guaranteed as updates are made.
             */
            function filteredOperatorAt(address registrant, uint256 index) external returns (address);
            /**
             * @notice Returns the filtered codeHash at the given index of the list of filtered codeHashes for a given address or
             *         its subscription.
             *         Note that order is not guaranteed as updates are made.
             */
            function filteredCodeHashAt(address registrant, uint256 index) external returns (bytes32);
            /**
             * @notice Returns true if an address has registered
             */
            function isRegistered(address addr) external returns (bool);
            /**
             * @dev Convenience method to compute the code hash of an arbitrary contract
             */
            function codeHashOf(address addr) external returns (bytes32);
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.13;
        address constant CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS = 0x000000000000AAeB6D7670E522A718067333cd4E;
        address constant CANONICAL_CORI_SUBSCRIPTION = 0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6;
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.13;
        import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.sol";
        import {CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS} from "./lib/Constants.sol";
        /**
         * @title  OperatorFilterer
         * @notice Abstract contract whose constructor automatically registers and optionally subscribes to or copies another
         *         registrant's entries in the OperatorFilterRegistry.
         * @dev    This smart contract is meant to be inherited by token contracts so they can use the following:
         *         - `onlyAllowedOperator` modifier for `transferFrom` and `safeTransferFrom` methods.
         *         - `onlyAllowedOperatorApproval` modifier for `approve` and `setApprovalForAll` methods.
         *         Please note that if your token contract does not provide an owner with EIP-173, it must provide
         *         administration methods on the contract itself to interact with the registry otherwise the subscription
         *         will be locked to the options set during construction.
         */
        abstract contract OperatorFilterer {
            /// @dev Emitted when an operator is not allowed.
            error OperatorNotAllowed(address operator);
            IOperatorFilterRegistry public constant OPERATOR_FILTER_REGISTRY =
                IOperatorFilterRegistry(CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS);
            /// @dev The constructor that is called when the contract is being deployed.
            constructor(address subscriptionOrRegistrantToCopy, bool subscribe) {
                // If an inheriting token contract is deployed to a network without the registry deployed, the modifier
                // will not revert, but the contract will need to be registered with the registry once it is deployed in
                // order for the modifier to filter addresses.
                if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
                    if (subscribe) {
                        OPERATOR_FILTER_REGISTRY.registerAndSubscribe(address(this), subscriptionOrRegistrantToCopy);
                    } else {
                        if (subscriptionOrRegistrantToCopy != address(0)) {
                            OPERATOR_FILTER_REGISTRY.registerAndCopyEntries(address(this), subscriptionOrRegistrantToCopy);
                        } else {
                            OPERATOR_FILTER_REGISTRY.register(address(this));
                        }
                    }
                }
            }
            /**
             * @dev A helper function to check if an operator is allowed.
             */
            modifier onlyAllowedOperator(address from) virtual {
                // Allow spending tokens from addresses with balance
                // Note that this still allows listings and marketplaces with escrow to transfer tokens if transferred
                // from an EOA.
                if (from != msg.sender) {
                    _checkFilterOperator(msg.sender);
                }
                _;
            }
            /**
             * @dev A helper function to check if an operator approval is allowed.
             */
            modifier onlyAllowedOperatorApproval(address operator) virtual {
                _checkFilterOperator(operator);
                _;
            }
            /**
             * @dev A helper function to check if an operator is allowed.
             */
            function _checkFilterOperator(address operator) internal view virtual {
                // Check registry code length to facilitate testing in environments without a deployed registry.
                if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
                    // under normal circumstances, this function will revert rather than return false, but inheriting contracts
                    // may specify their own OperatorFilterRegistry implementations, which may behave differently
                    if (!OPERATOR_FILTER_REGISTRY.isOperatorAllowed(address(this), operator)) {
                        revert OperatorNotAllowed(operator);
                    }
                }
            }
        }
        

        File 4 of 4: ErcForge721Template
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.6.0) (interfaces/IERC2981.sol)
        pragma solidity ^0.8.0;
        import "../utils/introspection/IERC165.sol";
        /**
         * @dev Interface for the NFT Royalty Standard.
         *
         * A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal
         * support for royalty payments across all NFT marketplaces and ecosystem participants.
         *
         * _Available since v4.5._
         */
        interface IERC2981 is IERC165 {
            /**
             * @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of
             * exchange. The royalty amount is denominated and should be paid in that same unit of exchange.
             */
            function royaltyInfo(uint256 tokenId, uint256 salePrice)
                external
                view
                returns (address receiver, uint256 royaltyAmount);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
        pragma solidity ^0.8.0;
        import "../utils/Context.sol";
        /**
         * @dev Contract module which allows children to implement an emergency stop
         * mechanism that can be triggered by an authorized account.
         *
         * This module is used through inheritance. It will make available the
         * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
         * the functions of your contract. Note that they will not be pausable by
         * simply including this module, only once the modifiers are put in place.
         */
        abstract contract Pausable is Context {
            /**
             * @dev Emitted when the pause is triggered by `account`.
             */
            event Paused(address account);
            /**
             * @dev Emitted when the pause is lifted by `account`.
             */
            event Unpaused(address account);
            bool private _paused;
            /**
             * @dev Initializes the contract in unpaused state.
             */
            constructor() {
                _paused = false;
            }
            /**
             * @dev Modifier to make a function callable only when the contract is not paused.
             *
             * Requirements:
             *
             * - The contract must not be paused.
             */
            modifier whenNotPaused() {
                _requireNotPaused();
                _;
            }
            /**
             * @dev Modifier to make a function callable only when the contract is paused.
             *
             * Requirements:
             *
             * - The contract must be paused.
             */
            modifier whenPaused() {
                _requirePaused();
                _;
            }
            /**
             * @dev Returns true if the contract is paused, and false otherwise.
             */
            function paused() public view virtual returns (bool) {
                return _paused;
            }
            /**
             * @dev Throws if the contract is paused.
             */
            function _requireNotPaused() internal view virtual {
                require(!paused(), "Pausable: paused");
            }
            /**
             * @dev Throws if the contract is not paused.
             */
            function _requirePaused() internal view virtual {
                require(paused(), "Pausable: not paused");
            }
            /**
             * @dev Triggers stopped state.
             *
             * Requirements:
             *
             * - The contract must not be paused.
             */
            function _pause() internal virtual whenNotPaused {
                _paused = true;
                emit Paused(_msgSender());
            }
            /**
             * @dev Returns to normal state.
             *
             * Requirements:
             *
             * - The contract must be paused.
             */
            function _unpause() internal virtual whenPaused {
                _paused = false;
                emit Unpaused(_msgSender());
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.7.0) (token/common/ERC2981.sol)
        pragma solidity ^0.8.0;
        import "../../interfaces/IERC2981.sol";
        import "../../utils/introspection/ERC165.sol";
        /**
         * @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information.
         *
         * Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for
         * specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first.
         *
         * Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the
         * fee is specified in basis points by default.
         *
         * IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
         * https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to
         * voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
         *
         * _Available since v4.5._
         */
        abstract contract ERC2981 is IERC2981, ERC165 {
            struct RoyaltyInfo {
                address receiver;
                uint96 royaltyFraction;
            }
            RoyaltyInfo private _defaultRoyaltyInfo;
            mapping(uint256 => RoyaltyInfo) private _tokenRoyaltyInfo;
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {
                return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);
            }
            /**
             * @inheritdoc IERC2981
             */
            function royaltyInfo(uint256 _tokenId, uint256 _salePrice) public view virtual override returns (address, uint256) {
                RoyaltyInfo memory royalty = _tokenRoyaltyInfo[_tokenId];
                if (royalty.receiver == address(0)) {
                    royalty = _defaultRoyaltyInfo;
                }
                uint256 royaltyAmount = (_salePrice * royalty.royaltyFraction) / _feeDenominator();
                return (royalty.receiver, royaltyAmount);
            }
            /**
             * @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a
             * fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an
             * override.
             */
            function _feeDenominator() internal pure virtual returns (uint96) {
                return 10000;
            }
            /**
             * @dev Sets the royalty information that all ids in this contract will default to.
             *
             * Requirements:
             *
             * - `receiver` cannot be the zero address.
             * - `feeNumerator` cannot be greater than the fee denominator.
             */
            function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
                require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
                require(receiver != address(0), "ERC2981: invalid receiver");
                _defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
            }
            /**
             * @dev Removes default royalty information.
             */
            function _deleteDefaultRoyalty() internal virtual {
                delete _defaultRoyaltyInfo;
            }
            /**
             * @dev Sets the royalty information for a specific token id, overriding the global default.
             *
             * Requirements:
             *
             * - `receiver` cannot be the zero address.
             * - `feeNumerator` cannot be greater than the fee denominator.
             */
            function _setTokenRoyalty(
                uint256 tokenId,
                address receiver,
                uint96 feeNumerator
            ) internal virtual {
                require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
                require(receiver != address(0), "ERC2981: Invalid parameters");
                _tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);
            }
            /**
             * @dev Resets royalty information for the token id back to the global default.
             */
            function _resetTokenRoyalty(uint256 tokenId) internal virtual {
                delete _tokenRoyaltyInfo[tokenId];
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.2) (token/ERC721/ERC721.sol)
        pragma solidity ^0.8.0;
        import "./IERC721.sol";
        import "./IERC721Receiver.sol";
        import "./extensions/IERC721Metadata.sol";
        import "../../utils/Address.sol";
        import "../../utils/Context.sol";
        import "../../utils/Strings.sol";
        import "../../utils/introspection/ERC165.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 ERC721 is Context, ERC165, IERC721, IERC721Metadata {
            using Address for address;
            using Strings for uint256;
            // Token name
            string private _name;
            // Token symbol
            string private _symbol;
            // Mapping from token ID to owner address
            mapping(uint256 => address) private _owners;
            // Mapping owner address to token count
            mapping(address => uint256) private _balances;
            // Mapping from token ID to approved address
            mapping(uint256 => address) private _tokenApprovals;
            // Mapping from owner to operator approvals
            mapping(address => mapping(address => bool)) private _operatorApprovals;
            /**
             * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
             */
            constructor(string memory name_, string memory symbol_) {
                _name = name_;
                _symbol = symbol_;
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
                return
                    interfaceId == type(IERC721).interfaceId ||
                    interfaceId == type(IERC721Metadata).interfaceId ||
                    super.supportsInterface(interfaceId);
            }
            /**
             * @dev See {IERC721-balanceOf}.
             */
            function balanceOf(address owner) public view virtual override returns (uint256) {
                require(owner != address(0), "ERC721: address zero is not a valid owner");
                return _balances[owner];
            }
            /**
             * @dev See {IERC721-ownerOf}.
             */
            function ownerOf(uint256 tokenId) public view virtual override returns (address) {
                address owner = _ownerOf(tokenId);
                require(owner != address(0), "ERC721: invalid token ID");
                return owner;
            }
            /**
             * @dev See {IERC721Metadata-name}.
             */
            function name() public view virtual override returns (string memory) {
                return _name;
            }
            /**
             * @dev See {IERC721Metadata-symbol}.
             */
            function symbol() public view virtual override returns (string memory) {
                return _symbol;
            }
            /**
             * @dev See {IERC721Metadata-tokenURI}.
             */
            function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                _requireMinted(tokenId);
                string memory baseURI = _baseURI();
                return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
            }
            /**
             * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
             * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
             * by default, can be overridden in child contracts.
             */
            function _baseURI() internal view virtual returns (string memory) {
                return "";
            }
            /**
             * @dev See {IERC721-approve}.
             */
            function approve(address to, uint256 tokenId) public virtual override {
                address owner = ERC721.ownerOf(tokenId);
                require(to != owner, "ERC721: approval to current owner");
                require(
                    _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                    "ERC721: approve caller is not token owner or approved for all"
                );
                _approve(to, tokenId);
            }
            /**
             * @dev See {IERC721-getApproved}.
             */
            function getApproved(uint256 tokenId) public view virtual override returns (address) {
                _requireMinted(tokenId);
                return _tokenApprovals[tokenId];
            }
            /**
             * @dev See {IERC721-setApprovalForAll}.
             */
            function setApprovalForAll(address operator, bool approved) public virtual override {
                _setApprovalForAll(_msgSender(), operator, approved);
            }
            /**
             * @dev See {IERC721-isApprovedForAll}.
             */
            function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
                return _operatorApprovals[owner][operator];
            }
            /**
             * @dev See {IERC721-transferFrom}.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                //solhint-disable-next-line max-line-length
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
                _transfer(from, to, tokenId);
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                safeTransferFrom(from, to, tokenId, "");
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes memory data
            ) public virtual override {
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or 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 the owner of the `tokenId`. Does NOT revert if token doesn't exist
             */
            function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
                return _owners[tokenId];
            }
            /**
             * @dev Returns whether `tokenId` exists.
             *
             * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
             *
             * Tokens start existing when they are minted (`_mint`),
             * and stop existing when they are burned (`_burn`).
             */
            function _exists(uint256 tokenId) internal view virtual returns (bool) {
                return _ownerOf(tokenId) != address(0);
            }
            /**
             * @dev Returns whether `spender` is allowed to manage `tokenId`.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
                address owner = ERC721.ownerOf(tokenId);
                return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
            }
            /**
             * @dev Safely mints `tokenId` and transfers it to `to`.
             *
             * Requirements:
             *
             * - `tokenId` must not exist.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function _safeMint(address to, uint256 tokenId) internal virtual {
                _safeMint(to, tokenId, "");
            }
            /**
             * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
             * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
             */
            function _safeMint(
                address to,
                uint256 tokenId,
                bytes memory data
            ) internal virtual {
                _mint(to, tokenId);
                require(
                    _checkOnERC721Received(address(0), to, tokenId, data),
                    "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, 1);
                // Check that tokenId was not minted by `_beforeTokenTransfer` hook
                require(!_exists(tokenId), "ERC721: token already minted");
                unchecked {
                    // Will not overflow unless all 2**256 token ids are minted to the same owner.
                    // Given that tokens are minted one by one, it is impossible in practice that
                    // this ever happens. Might change if we allow batch minting.
                    // The ERC fails to describe this case.
                    _balances[to] += 1;
                }
                _owners[tokenId] = to;
                emit Transfer(address(0), to, tokenId);
                _afterTokenTransfer(address(0), to, tokenId, 1);
            }
            /**
             * @dev Destroys `tokenId`.
             * The approval is cleared when the token is burned.
             * This is an internal function that does not check if the sender is authorized to operate on the token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             *
             * Emits a {Transfer} event.
             */
            function _burn(uint256 tokenId) internal virtual {
                address owner = ERC721.ownerOf(tokenId);
                _beforeTokenTransfer(owner, address(0), tokenId, 1);
                // Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
                owner = ERC721.ownerOf(tokenId);
                // Clear approvals
                delete _tokenApprovals[tokenId];
                unchecked {
                    // Cannot overflow, as that would require more tokens to be burned/transferred
                    // out than the owner initially received through minting and transferring in.
                    _balances[owner] -= 1;
                }
                delete _owners[tokenId];
                emit Transfer(owner, address(0), tokenId);
                _afterTokenTransfer(owner, address(0), tokenId, 1);
            }
            /**
             * @dev Transfers `tokenId` from `from` to `to`.
             *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
             *
             * Requirements:
             *
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             *
             * Emits a {Transfer} event.
             */
            function _transfer(
                address from,
                address to,
                uint256 tokenId
            ) internal virtual {
                require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
                require(to != address(0), "ERC721: transfer to the zero address");
                _beforeTokenTransfer(from, to, tokenId, 1);
                // Check that tokenId was not transferred by `_beforeTokenTransfer` hook
                require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
                // Clear approvals from the previous owner
                delete _tokenApprovals[tokenId];
                unchecked {
                    // `_balances[from]` cannot overflow for the same reason as described in `_burn`:
                    // `from`'s balance is the number of token held, which is at least one before the current
                    // transfer.
                    // `_balances[to]` could overflow in the conditions described in `_mint`. That would require
                    // all 2**256 token ids to be minted, which in practice is impossible.
                    _balances[from] -= 1;
                    _balances[to] += 1;
                }
                _owners[tokenId] = to;
                emit Transfer(from, to, tokenId);
                _afterTokenTransfer(from, to, tokenId, 1);
            }
            /**
             * @dev Approve `to` to operate on `tokenId`
             *
             * Emits an {Approval} event.
             */
            function _approve(address to, uint256 tokenId) internal virtual {
                _tokenApprovals[tokenId] = to;
                emit Approval(ERC721.ownerOf(tokenId), to, tokenId);
            }
            /**
             * @dev Approve `operator` to operate on all of `owner` tokens
             *
             * Emits an {ApprovalForAll} event.
             */
            function _setApprovalForAll(
                address owner,
                address operator,
                bool approved
            ) internal virtual {
                require(owner != operator, "ERC721: approve to caller");
                _operatorApprovals[owner][operator] = approved;
                emit ApprovalForAll(owner, operator, approved);
            }
            /**
             * @dev Reverts if the `tokenId` has not been minted yet.
             */
            function _requireMinted(uint256 tokenId) internal view virtual {
                require(_exists(tokenId), "ERC721: invalid token ID");
            }
            /**
             * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
             * The call is not executed if the target address is not a contract.
             *
             * @param from address representing the previous owner of the given token ID
             * @param to target address that will receive the tokens
             * @param tokenId uint256 ID of the token to be transferred
             * @param data bytes optional data to send along with the call
             * @return bool whether the call correctly returned the expected magic value
             */
            function _checkOnERC721Received(
                address from,
                address to,
                uint256 tokenId,
                bytes memory data
            ) private returns (bool) {
                if (to.isContract()) {
                    try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
                        return retval == IERC721Receiver.onERC721Received.selector;
                    } catch (bytes memory reason) {
                        if (reason.length == 0) {
                            revert("ERC721: transfer to non ERC721Receiver implementer");
                        } else {
                            /// @solidity memory-safe-assembly
                            assembly {
                                revert(add(32, reason), mload(reason))
                            }
                        }
                    }
                } else {
                    return true;
                }
            }
            /**
             * @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is
             * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
             *
             * Calling conditions:
             *
             * - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
             * - When `from` is zero, the tokens will be minted for `to`.
             * - When `to` is zero, ``from``'s tokens will be burned.
             * - `from` and `to` are never both zero.
             * - `batchSize` is non-zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual {}
            /**
             * @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
             * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
             *
             * Calling conditions:
             *
             * - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
             * - When `from` is zero, the tokens were minted for `to`.
             * - When `to` is zero, ``from``'s tokens were burned.
             * - `from` and `to` are never both zero.
             * - `batchSize` is non-zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _afterTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual {}
            /**
             * @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
             *
             * WARNING: Anyone calling this MUST ensure that the balances remain consistent with the ownership. The invariant
             * being that for any address `a` the value returned by `balanceOf(a)` must be equal to the number of tokens such
             * that `ownerOf(tokenId)` is `a`.
             */
            // solhint-disable-next-line func-name-mixedcase
            function __unsafe_increaseBalance(address account, uint256 amount) internal {
                _balances[account] += amount;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/extensions/ERC721Burnable.sol)
        pragma solidity ^0.8.0;
        import "../ERC721.sol";
        import "../../../utils/Context.sol";
        /**
         * @title ERC721 Burnable Token
         * @dev ERC721 Token that can be burned (destroyed).
         */
        abstract contract ERC721Burnable is Context, ERC721 {
            /**
             * @dev Burns `tokenId`. See {ERC721-_burn}.
             *
             * Requirements:
             *
             * - The caller must own `tokenId` or be an approved operator.
             */
            function burn(uint256 tokenId) public virtual {
                //solhint-disable-next-line max-line-length
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
                _burn(tokenId);
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/extensions/ERC721Enumerable.sol)
        pragma solidity ^0.8.0;
        import "../ERC721.sol";
        import "./IERC721Enumerable.sol";
        /**
         * @dev This implements an optional extension of {ERC721} defined in the EIP that adds
         * enumerability of all the token ids in the contract as well as all token ids owned by each
         * account.
         */
        abstract contract ERC721Enumerable is ERC721, IERC721Enumerable {
            // Mapping from owner to list of owned token IDs
            mapping(address => mapping(uint256 => uint256)) private _ownedTokens;
            // Mapping from token ID to index of the owner tokens list
            mapping(uint256 => uint256) private _ownedTokensIndex;
            // Array with all token ids, used for enumeration
            uint256[] private _allTokens;
            // Mapping from token id to position in the allTokens array
            mapping(uint256 => uint256) private _allTokensIndex;
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC721) returns (bool) {
                return interfaceId == type(IERC721Enumerable).interfaceId || super.supportsInterface(interfaceId);
            }
            /**
             * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}.
             */
            function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual override returns (uint256) {
                require(index < ERC721.balanceOf(owner), "ERC721Enumerable: owner index out of bounds");
                return _ownedTokens[owner][index];
            }
            /**
             * @dev See {IERC721Enumerable-totalSupply}.
             */
            function totalSupply() public view virtual override returns (uint256) {
                return _allTokens.length;
            }
            /**
             * @dev See {IERC721Enumerable-tokenByIndex}.
             */
            function tokenByIndex(uint256 index) public view virtual override returns (uint256) {
                require(index < ERC721Enumerable.totalSupply(), "ERC721Enumerable: global index out of bounds");
                return _allTokens[index];
            }
            /**
             * @dev See {ERC721-_beforeTokenTransfer}.
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual override {
                super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
                if (batchSize > 1) {
                    // Will only trigger during construction. Batch transferring (minting) is not available afterwards.
                    revert("ERC721Enumerable: consecutive transfers not supported");
                }
                uint256 tokenId = firstTokenId;
                if (from == address(0)) {
                    _addTokenToAllTokensEnumeration(tokenId);
                } else if (from != to) {
                    _removeTokenFromOwnerEnumeration(from, tokenId);
                }
                if (to == address(0)) {
                    _removeTokenFromAllTokensEnumeration(tokenId);
                } else if (to != from) {
                    _addTokenToOwnerEnumeration(to, tokenId);
                }
            }
            /**
             * @dev Private function to add a token to this extension's ownership-tracking data structures.
             * @param to address representing the new owner of the given token ID
             * @param tokenId uint256 ID of the token to be added to the tokens list of the given address
             */
            function _addTokenToOwnerEnumeration(address to, uint256 tokenId) private {
                uint256 length = ERC721.balanceOf(to);
                _ownedTokens[to][length] = tokenId;
                _ownedTokensIndex[tokenId] = length;
            }
            /**
             * @dev Private function to add a token to this extension's token tracking data structures.
             * @param tokenId uint256 ID of the token to be added to the tokens list
             */
            function _addTokenToAllTokensEnumeration(uint256 tokenId) private {
                _allTokensIndex[tokenId] = _allTokens.length;
                _allTokens.push(tokenId);
            }
            /**
             * @dev Private function to remove a token from this extension's ownership-tracking data structures. Note that
             * while the token is not assigned a new owner, the `_ownedTokensIndex` mapping is _not_ updated: this allows for
             * gas optimizations e.g. when performing a transfer operation (avoiding double writes).
             * This has O(1) time complexity, but alters the order of the _ownedTokens array.
             * @param from address representing the previous owner of the given token ID
             * @param tokenId uint256 ID of the token to be removed from the tokens list of the given address
             */
            function _removeTokenFromOwnerEnumeration(address from, uint256 tokenId) private {
                // To prevent a gap in from's tokens array, we store the last token in the index of the token to delete, and
                // then delete the last slot (swap and pop).
                uint256 lastTokenIndex = ERC721.balanceOf(from) - 1;
                uint256 tokenIndex = _ownedTokensIndex[tokenId];
                // When the token to delete is the last token, the swap operation is unnecessary
                if (tokenIndex != lastTokenIndex) {
                    uint256 lastTokenId = _ownedTokens[from][lastTokenIndex];
                    _ownedTokens[from][tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
                    _ownedTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index
                }
                // This also deletes the contents at the last position of the array
                delete _ownedTokensIndex[tokenId];
                delete _ownedTokens[from][lastTokenIndex];
            }
            /**
             * @dev Private function to remove a token from this extension's token tracking data structures.
             * This has O(1) time complexity, but alters the order of the _allTokens array.
             * @param tokenId uint256 ID of the token to be removed from the tokens list
             */
            function _removeTokenFromAllTokensEnumeration(uint256 tokenId) private {
                // To prevent a gap in the tokens array, we store the last token in the index of the token to delete, and
                // then delete the last slot (swap and pop).
                uint256 lastTokenIndex = _allTokens.length - 1;
                uint256 tokenIndex = _allTokensIndex[tokenId];
                // When the token to delete is the last token, the swap operation is unnecessary. However, since this occurs so
                // rarely (when the last minted token is burnt) that we still do the swap here to avoid the gas cost of adding
                // an 'if' statement (like in _removeTokenFromOwnerEnumeration)
                uint256 lastTokenId = _allTokens[lastTokenIndex];
                _allTokens[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
                _allTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index
                // This also deletes the contents at the last position of the array
                delete _allTokensIndex[tokenId];
                _allTokens.pop();
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.2) (token/ERC721/extensions/ERC721Pausable.sol)
        pragma solidity ^0.8.0;
        import "../ERC721.sol";
        import "../../../security/Pausable.sol";
        /**
         * @dev ERC721 token with pausable token transfers, minting and burning.
         *
         * Useful for scenarios such as preventing trades until the end of an evaluation
         * period, or having an emergency switch for freezing all token transfers in the
         * event of a large bug.
         *
         * IMPORTANT: This contract does not include public pause and unpause functions. In
         * addition to inheriting this contract, you must define both functions, invoking the
         * {Pausable-_pause} and {Pausable-_unpause} internal functions, with appropriate
         * access control, e.g. using {AccessControl} or {Ownable}. Not doing so will
         * make the contract unpausable.
         */
        abstract contract ERC721Pausable is ERC721, Pausable {
            /**
             * @dev See {ERC721-_beforeTokenTransfer}.
             *
             * Requirements:
             *
             * - the contract must not be paused.
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual override {
                super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
                require(!paused(), "ERC721Pausable: token transfer while paused");
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.5.0) (token/ERC721/extensions/IERC721Enumerable.sol)
        pragma solidity ^0.8.0;
        import "../IERC721.sol";
        /**
         * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
         * @dev See https://eips.ethereum.org/EIPS/eip-721
         */
        interface IERC721Enumerable is IERC721 {
            /**
             * @dev Returns the total amount of tokens stored by the contract.
             */
            function totalSupply() external view returns (uint256);
            /**
             * @dev Returns a token ID owned by `owner` at a given `index` of its token list.
             * Use along with {balanceOf} to enumerate all of ``owner``'s tokens.
             */
            function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);
            /**
             * @dev Returns a token ID at a given `index` of all the tokens stored by the contract.
             * Use along with {totalSupply} to enumerate all tokens.
             */
            function tokenByIndex(uint256 index) external view returns (uint256);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
        pragma solidity ^0.8.0;
        import "../IERC721.sol";
        /**
         * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
         * @dev See https://eips.ethereum.org/EIPS/eip-721
         */
        interface IERC721Metadata is IERC721 {
            /**
             * @dev Returns the token collection name.
             */
            function name() external view returns (string memory);
            /**
             * @dev Returns the token collection symbol.
             */
            function symbol() external view returns (string memory);
            /**
             * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
             */
            function tokenURI(uint256 tokenId) external view returns (string memory);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/IERC721.sol)
        pragma solidity ^0.8.0;
        import "../../utils/introspection/IERC165.sol";
        /**
         * @dev Required interface of an ERC721 compliant contract.
         */
        interface IERC721 is IERC165 {
            /**
             * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
             */
            event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
             */
            event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
             */
            event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
            /**
             * @dev Returns the number of tokens in ``owner``'s account.
             */
            function balanceOf(address owner) external view returns (uint256 balance);
            /**
             * @dev Returns the owner of the `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function ownerOf(uint256 tokenId) external view returns (address owner);
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes calldata data
            ) external;
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
             * are aware of the ERC721 protocol to prevent tokens from being forever locked.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Transfers `tokenId` token from `from` to `to`.
             *
             * WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
             * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
             * understand this adds an external call which potentially creates a reentrancy vulnerability.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Gives permission to `to` to transfer `tokenId` token to another account.
             * The approval is cleared when the token is transferred.
             *
             * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
             *
             * Requirements:
             *
             * - The caller must own the token or be an approved operator.
             * - `tokenId` must exist.
             *
             * Emits an {Approval} event.
             */
            function approve(address to, uint256 tokenId) external;
            /**
             * @dev Approve or remove `operator` as an operator for the caller.
             * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
             *
             * Requirements:
             *
             * - The `operator` cannot be the caller.
             *
             * Emits an {ApprovalForAll} event.
             */
            function setApprovalForAll(address operator, bool _approved) external;
            /**
             * @dev Returns the account approved for `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function getApproved(uint256 tokenId) external view returns (address operator);
            /**
             * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
             *
             * See {setApprovalForAll}
             */
            function isApprovedForAll(address owner, address operator) external view returns (bool);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)
        pragma solidity ^0.8.0;
        /**
         * @title ERC721 token receiver interface
         * @dev Interface for any contract that wants to support safeTransfers
         * from ERC721 asset contracts.
         */
        interface IERC721Receiver {
            /**
             * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
             * by `operator` from `from`, this function is called.
             *
             * It must return its Solidity selector to confirm the token transfer.
             * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
             *
             * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
             */
            function onERC721Received(
                address operator,
                address from,
                uint256 tokenId,
                bytes calldata data
            ) external returns (bytes4);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
        pragma solidity ^0.8.1;
        /**
         * @dev Collection of functions related to the address type
         */
        library Address {
            /**
             * @dev Returns true if `account` is a contract.
             *
             * [IMPORTANT]
             * ====
             * It is unsafe to assume that an address for which this function returns
             * false is an externally-owned account (EOA) and not a contract.
             *
             * Among others, `isContract` will return false for the following
             * types of addresses:
             *
             *  - an externally-owned account
             *  - a contract in construction
             *  - an address where a contract will be created
             *  - an address where a contract lived, but was destroyed
             * ====
             *
             * [IMPORTANT]
             * ====
             * You shouldn't rely on `isContract` to protect against flash loan attacks!
             *
             * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
             * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
             * constructor.
             * ====
             */
            function isContract(address account) internal view returns (bool) {
                // This method relies on extcodesize/address.code.length, which returns 0
                // for contracts in construction, since the code is only stored at the end
                // of the constructor execution.
                return account.code.length > 0;
            }
            /**
             * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
             * `recipient`, forwarding all available gas and reverting on errors.
             *
             * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
             * of certain opcodes, possibly making contracts go over the 2300 gas limit
             * imposed by `transfer`, making them unable to receive funds via
             * `transfer`. {sendValue} removes this limitation.
             *
             * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
             *
             * IMPORTANT: because control is transferred to `recipient`, care must be
             * taken to not create reentrancy vulnerabilities. Consider using
             * {ReentrancyGuard} or the
             * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
             */
            function sendValue(address payable recipient, uint256 amount) internal {
                require(address(this).balance >= amount, "Address: insufficient balance");
                (bool success, ) = recipient.call{value: amount}("");
                require(success, "Address: unable to send value, recipient may have reverted");
            }
            /**
             * @dev Performs a Solidity function call using a low level `call`. A
             * plain `call` is an unsafe replacement for a function call: use this
             * function instead.
             *
             * If `target` reverts with a revert reason, it is bubbled up by this
             * function (like regular Solidity function calls).
             *
             * Returns the raw returned data. To convert to the expected return value,
             * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
             *
             * Requirements:
             *
             * - `target` must be a contract.
             * - calling `target` with `data` must not revert.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, "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");
                (bool success, bytes memory returndata) = target.call{value: value}(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                return functionStaticCall(target, data, "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) {
                (bool success, bytes memory returndata) = target.staticcall(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionDelegateCall(target, data, "Address: low-level delegate call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                (bool success, bytes memory returndata) = target.delegatecall(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
             * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
             *
             * _Available since v4.8._
             */
            function verifyCallResultFromTarget(
                address target,
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal view returns (bytes memory) {
                if (success) {
                    if (returndata.length == 0) {
                        // only check isContract if the call was successful and the return data is empty
                        // otherwise we already know that it was a contract
                        require(isContract(target), "Address: call to non-contract");
                    }
                    return returndata;
                } else {
                    _revert(returndata, errorMessage);
                }
            }
            /**
             * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
             * revert reason or using the provided one.
             *
             * _Available since v4.3._
             */
            function verifyCallResult(
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal pure returns (bytes memory) {
                if (success) {
                    return returndata;
                } else {
                    _revert(returndata, errorMessage);
                }
            }
            function _revert(bytes memory returndata, string memory errorMessage) private pure {
                // Look for revert reason and bubble it up if present
                if (returndata.length > 0) {
                    // The easiest way to bubble the revert reason is using memory via assembly
                    /// @solidity memory-safe-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Provides information about the current execution context, including the
         * sender of the transaction and its data. While these are generally available
         * via msg.sender and msg.data, they should not be accessed in such a direct
         * manner, since when dealing with meta-transactions the account sending and
         * paying for execution may not be the actual sender (as far as an application
         * is concerned).
         *
         * This contract is only required for intermediate, library-like contracts.
         */
        abstract contract Context {
            function _msgSender() internal view virtual returns (address) {
                return msg.sender;
            }
            function _msgData() internal view virtual returns (bytes calldata) {
                return msg.data;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Counters.sol)
        pragma solidity ^0.8.0;
        /**
         * @title Counters
         * @author Matt Condon (@shrugs)
         * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
         * of elements in a mapping, issuing ERC721 ids, or counting request ids.
         *
         * Include with `using Counters for Counters.Counter;`
         */
        library Counters {
            struct Counter {
                // This variable should never be directly accessed by users of the library: interactions must be restricted to
                // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
                // this feature: see https://github.com/ethereum/solidity/issues/4637
                uint256 _value; // default: 0
            }
            function current(Counter storage counter) internal view returns (uint256) {
                return counter._value;
            }
            function increment(Counter storage counter) internal {
                unchecked {
                    counter._value += 1;
                }
            }
            function decrement(Counter storage counter) internal {
                uint256 value = counter._value;
                require(value > 0, "Counter: decrement overflow");
                unchecked {
                    counter._value = value - 1;
                }
            }
            function reset(Counter storage counter) internal {
                counter._value = 0;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
        pragma solidity ^0.8.0;
        import "./IERC165.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 ERC165 is IERC165 {
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                return interfaceId == type(IERC165).interfaceId;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC165 standard, as defined in the
         * https://eips.ethereum.org/EIPS/eip-165[EIP].
         *
         * Implementers can declare support of contract interfaces, which can then be
         * queried by others ({ERC165Checker}).
         *
         * For an implementation, see {ERC165}.
         */
        interface IERC165 {
            /**
             * @dev Returns true if this contract implements the interface defined by
             * `interfaceId`. See the corresponding
             * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
             * to learn more about how these ids are created.
             *
             * This function call must use less than 30 000 gas.
             */
            function supportsInterface(bytes4 interfaceId) external view returns (bool);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Standard math utilities missing in the Solidity language.
         */
        library Math {
            enum Rounding {
                Down, // Toward negative infinity
                Up, // Toward infinity
                Zero // Toward zero
            }
            /**
             * @dev Returns the largest of two numbers.
             */
            function max(uint256 a, uint256 b) internal pure returns (uint256) {
                return a > b ? a : b;
            }
            /**
             * @dev Returns the smallest of two numbers.
             */
            function min(uint256 a, uint256 b) internal pure returns (uint256) {
                return a < b ? a : b;
            }
            /**
             * @dev Returns the average of two numbers. The result is rounded towards
             * zero.
             */
            function average(uint256 a, uint256 b) internal pure returns (uint256) {
                // (a + b) / 2 can overflow.
                return (a & b) + (a ^ b) / 2;
            }
            /**
             * @dev Returns the ceiling of the division of two numbers.
             *
             * This differs from standard division with `/` in that it rounds up instead
             * of rounding down.
             */
            function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
                // (a + b - 1) / b can overflow on addition, so we distribute.
                return a == 0 ? 0 : (a - 1) / b + 1;
            }
            /**
             * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
             * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
             * with further edits by Uniswap Labs also under MIT license.
             */
            function mulDiv(
                uint256 x,
                uint256 y,
                uint256 denominator
            ) internal pure returns (uint256 result) {
                unchecked {
                    // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
                    // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
                    // variables such that product = prod1 * 2^256 + prod0.
                    uint256 prod0; // Least significant 256 bits of the product
                    uint256 prod1; // Most significant 256 bits of the product
                    assembly {
                        let mm := mulmod(x, y, not(0))
                        prod0 := mul(x, y)
                        prod1 := sub(sub(mm, prod0), lt(mm, prod0))
                    }
                    // Handle non-overflow cases, 256 by 256 division.
                    if (prod1 == 0) {
                        return prod0 / denominator;
                    }
                    // Make sure the result is less than 2^256. Also prevents denominator == 0.
                    require(denominator > prod1);
                    ///////////////////////////////////////////////
                    // 512 by 256 division.
                    ///////////////////////////////////////////////
                    // Make division exact by subtracting the remainder from [prod1 prod0].
                    uint256 remainder;
                    assembly {
                        // Compute remainder using mulmod.
                        remainder := mulmod(x, y, denominator)
                        // Subtract 256 bit number from 512 bit number.
                        prod1 := sub(prod1, gt(remainder, prod0))
                        prod0 := sub(prod0, remainder)
                    }
                    // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
                    // See https://cs.stackexchange.com/q/138556/92363.
                    // Does not overflow because the denominator cannot be zero at this stage in the function.
                    uint256 twos = denominator & (~denominator + 1);
                    assembly {
                        // Divide denominator by twos.
                        denominator := div(denominator, twos)
                        // Divide [prod1 prod0] by twos.
                        prod0 := div(prod0, twos)
                        // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                        twos := add(div(sub(0, twos), twos), 1)
                    }
                    // Shift in bits from prod1 into prod0.
                    prod0 |= prod1 * twos;
                    // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
                    // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
                    // four bits. That is, denominator * inv = 1 mod 2^4.
                    uint256 inverse = (3 * denominator) ^ 2;
                    // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
                    // in modular arithmetic, doubling the correct bits in each step.
                    inverse *= 2 - denominator * inverse; // inverse mod 2^8
                    inverse *= 2 - denominator * inverse; // inverse mod 2^16
                    inverse *= 2 - denominator * inverse; // inverse mod 2^32
                    inverse *= 2 - denominator * inverse; // inverse mod 2^64
                    inverse *= 2 - denominator * inverse; // inverse mod 2^128
                    inverse *= 2 - denominator * inverse; // inverse mod 2^256
                    // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
                    // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
                    // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
                    // is no longer required.
                    result = prod0 * inverse;
                    return result;
                }
            }
            /**
             * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
             */
            function mulDiv(
                uint256 x,
                uint256 y,
                uint256 denominator,
                Rounding rounding
            ) internal pure returns (uint256) {
                uint256 result = mulDiv(x, y, denominator);
                if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
                    result += 1;
                }
                return result;
            }
            /**
             * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
             *
             * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
             */
            function sqrt(uint256 a) internal pure returns (uint256) {
                if (a == 0) {
                    return 0;
                }
                // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
                //
                // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
                // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
                //
                // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
                // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
                // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
                //
                // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
                uint256 result = 1 << (log2(a) >> 1);
                // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
                // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
                // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
                // into the expected uint128 result.
                unchecked {
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    result = (result + a / result) >> 1;
                    return min(result, a / result);
                }
            }
            /**
             * @notice Calculates sqrt(a), following the selected rounding direction.
             */
            function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
                unchecked {
                    uint256 result = sqrt(a);
                    return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
                }
            }
            /**
             * @dev Return the log in base 2, rounded down, of a positive value.
             * Returns 0 if given 0.
             */
            function log2(uint256 value) internal pure returns (uint256) {
                uint256 result = 0;
                unchecked {
                    if (value >> 128 > 0) {
                        value >>= 128;
                        result += 128;
                    }
                    if (value >> 64 > 0) {
                        value >>= 64;
                        result += 64;
                    }
                    if (value >> 32 > 0) {
                        value >>= 32;
                        result += 32;
                    }
                    if (value >> 16 > 0) {
                        value >>= 16;
                        result += 16;
                    }
                    if (value >> 8 > 0) {
                        value >>= 8;
                        result += 8;
                    }
                    if (value >> 4 > 0) {
                        value >>= 4;
                        result += 4;
                    }
                    if (value >> 2 > 0) {
                        value >>= 2;
                        result += 2;
                    }
                    if (value >> 1 > 0) {
                        result += 1;
                    }
                }
                return result;
            }
            /**
             * @dev Return the log in base 2, following the selected rounding direction, of a positive value.
             * Returns 0 if given 0.
             */
            function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
                unchecked {
                    uint256 result = log2(value);
                    return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
                }
            }
            /**
             * @dev Return the log in base 10, rounded down, of a positive value.
             * Returns 0 if given 0.
             */
            function log10(uint256 value) internal pure returns (uint256) {
                uint256 result = 0;
                unchecked {
                    if (value >= 10**64) {
                        value /= 10**64;
                        result += 64;
                    }
                    if (value >= 10**32) {
                        value /= 10**32;
                        result += 32;
                    }
                    if (value >= 10**16) {
                        value /= 10**16;
                        result += 16;
                    }
                    if (value >= 10**8) {
                        value /= 10**8;
                        result += 8;
                    }
                    if (value >= 10**4) {
                        value /= 10**4;
                        result += 4;
                    }
                    if (value >= 10**2) {
                        value /= 10**2;
                        result += 2;
                    }
                    if (value >= 10**1) {
                        result += 1;
                    }
                }
                return result;
            }
            /**
             * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
             * Returns 0 if given 0.
             */
            function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
                unchecked {
                    uint256 result = log10(value);
                    return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0);
                }
            }
            /**
             * @dev Return the log in base 256, rounded down, of a positive value.
             * Returns 0 if given 0.
             *
             * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
             */
            function log256(uint256 value) internal pure returns (uint256) {
                uint256 result = 0;
                unchecked {
                    if (value >> 128 > 0) {
                        value >>= 128;
                        result += 16;
                    }
                    if (value >> 64 > 0) {
                        value >>= 64;
                        result += 8;
                    }
                    if (value >> 32 > 0) {
                        value >>= 32;
                        result += 4;
                    }
                    if (value >> 16 > 0) {
                        value >>= 16;
                        result += 2;
                    }
                    if (value >> 8 > 0) {
                        result += 1;
                    }
                }
                return result;
            }
            /**
             * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
             * Returns 0 if given 0.
             */
            function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
                unchecked {
                    uint256 result = log256(value);
                    return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0);
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)
        pragma solidity ^0.8.0;
        import "./math/Math.sol";
        /**
         * @dev String operations.
         */
        library Strings {
            bytes16 private constant _SYMBOLS = "0123456789abcdef";
            uint8 private constant _ADDRESS_LENGTH = 20;
            /**
             * @dev Converts a `uint256` to its ASCII `string` decimal representation.
             */
            function toString(uint256 value) internal pure returns (string memory) {
                unchecked {
                    uint256 length = Math.log10(value) + 1;
                    string memory buffer = new string(length);
                    uint256 ptr;
                    /// @solidity memory-safe-assembly
                    assembly {
                        ptr := add(buffer, add(32, length))
                    }
                    while (true) {
                        ptr--;
                        /// @solidity memory-safe-assembly
                        assembly {
                            mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                        }
                        value /= 10;
                        if (value == 0) break;
                    }
                    return buffer;
                }
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
             */
            function toHexString(uint256 value) internal pure returns (string memory) {
                unchecked {
                    return toHexString(value, Math.log256(value) + 1);
                }
            }
            /**
             * @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] = _SYMBOLS[value & 0xf];
                    value >>= 4;
                }
                require(value == 0, "Strings: hex length insufficient");
                return string(buffer);
            }
            /**
             * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
             */
            function toHexString(address addr) internal pure returns (string memory) {
                return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
            }
        }
        /*
         /$$$$$$$$                     /$$$$$$$$                                          /$$          
        | $$_____/                    | $$_____/                                         |__/          
        | $$        /$$$$$$   /$$$$$$$| $$     /$$$$$$   /$$$$$$   /$$$$$$   /$$$$$$      /$$  /$$$$$$ 
        | $$$$$    /$$__  $$ /$$_____/| $$$$$ /$$__  $$ /$$__  $$ /$$__  $$ /$$__  $$    | $$ /$$__  $$
        | $$__/   | $$  \\__/| $$      | $$__/| $$  \\ $$| $$  \\__/| $$  \\ $$| $$$$$$$$    | $$| $$  \\ $$
        | $$      | $$      | $$      | $$   | $$  | $$| $$      | $$  | $$| $$_____/    | $$| $$  | $$
        | $$$$$$$$| $$      |  $$$$$$$| $$   |  $$$$$$/| $$      |  $$$$$$$|  $$$$$$$ /$$| $$|  $$$$$$/
        |________/|__/       \\_______/|__/    \\______/ |__/       \\____  $$ \\_______/|__/|__/ \\______/ 
                                                                  /$$  \\ $$                            
                                                                 |  $$$$$$/                            
                                                                  \\______/                             
        */
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
        import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Enumerable.sol";
        import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Burnable.sol";
        import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Pausable.sol";
        import "@openzeppelin/contracts/utils/Counters.sol";
        import "./ErcForgeNftCore.sol";
        import "../interface/IErcForgeERC721Mintable.sol";
        import "../interface/IErcForgeInitiable.sol";
        contract ErcForge721Template is
            ERC721Enumerable,
            ERC721Burnable,
            ERC721Pausable,
            ErcForgeNftCore,
            IErcForgeInitiable
        {
            string public _name;
            string public _symbol;
            string public contractURI;
            string private _baseTokenURI;
            using Counters for Counters.Counter;
            Counters.Counter private _tokenIdTracker;
            uint256 public maxSupply;
            uint256 public price;
            constructor() ERC721("", "") {}
            function init(
                address newOwner,
                string memory newName,
                string memory newSymbol,
                string memory newBaseTokenURI,
                string memory newContractURI,
                address royaltyReceiver,
                uint96 royaltyFee
            ) public {
                _init(newOwner, royaltyReceiver, royaltyFee);
                _name = newName;
                _symbol = newSymbol;
                _baseTokenURI = newBaseTokenURI;
                contractURI = newContractURI;
                _tokenIdTracker.increment();
            }
            function _baseURI() internal view virtual override returns (string memory) {
                return _baseTokenURI;
            }
            function name() public view virtual override returns (string memory) {
                return _name;
            }
            function symbol() public view virtual override returns (string memory) {
                return _symbol;
            }
            function setBaseURI(string memory newURI) public onlyAdmin {
                _baseTokenURI = newURI;
            }
            function setContractURI(string memory newURI) public onlyAdmin {
                contractURI = newURI;
            }
            function setTokenPriceAndSupply(
                uint256 _price,
                uint256 _maxSupply
            ) public onlyAdmin {
                price = _price;
                maxSupply = _maxSupply;
            }
            function mint(address to) external payable {
                if (_tokenIdTracker.current() > maxSupply) {
                    revert NoSupply();
                }
                if (msg.value < price) {
                    revert NotEnoughFunds();
                }
                _mint(to, _tokenIdTracker.current());
                _tokenIdTracker.increment();
            }
            function airdrop(address[] calldata to) external onlyAdmin {
                for (uint256 i = 0; i < to.length; i++) {
                    _mint(to[i], _tokenIdTracker.current());
                    _tokenIdTracker.increment();
                }
            }
            /**
             * @dev Pauses all token transfers.
             */
            function pause() public onlyAdmin {
                _pause();
            }
            /**
             * @dev Unpauses all token transfers.
             */
            function unpause() public onlyAdmin {
                _unpause();
            }
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 firstTokenId,
                uint256 batchSize
            ) internal virtual override(ERC721, ERC721Enumerable, ERC721Pausable) {
                super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(
                bytes4 interfaceId
            )
                public
                view
                virtual
                override(ERC721, ERC721Enumerable, ERC2981)
                returns (bool)
            {
                return super.supportsInterface(interfaceId);
            }
            /**
             * @dev OperatorFilter
             */
            function setApprovalForAll(
                address operator,
                bool approved
            ) public override(ERC721, IERC721) onlyAllowedOperatorApproval(operator) {
                super.setApprovalForAll(operator, approved);
            }
            function approve(
                address operator,
                uint256 tokenId
            ) public override(ERC721, IERC721) onlyAllowedOperatorApproval(operator) {
                super.approve(operator, tokenId);
            }
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public override(ERC721, IERC721) onlyAllowedOperator(from) {
                super.transferFrom(from, to, tokenId);
            }
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public override(ERC721, IERC721) onlyAllowedOperator(from) {
                super.safeTransferFrom(from, to, tokenId);
            }
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes memory data
            ) public override(ERC721, IERC721) onlyAllowedOperator(from) {
                super.safeTransferFrom(from, to, tokenId, data);
            }
        }
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        import "operator-filter-registry/src/OperatorFilterer.sol";
        import {CANONICAL_CORI_SUBSCRIPTION} from "operator-filter-registry/src/lib/Constants.sol";
        import "@openzeppelin/contracts/token/common/ERC2981.sol";
        contract ErcForgeNftCore is OperatorFilterer, ERC2981 {
            address public owner;
            mapping(address => bool) public isAdmin;
            bool private _isInitDone = false;
            bool private _isOperatorFilterRegistered = false;
            error InitDone();
            error NotOwner();
            error NotAdmin();
            error ZeroAddress();
            error NotEnoughFunds();
            error NoSupply();
            error AmountShouldNotBeZero();
            constructor() OperatorFilterer(address(0), false) {
                _isInitDone = true;
            }
            function _init(
                address newOwner,
                address royaltyReceiver,
                uint96 royaltyFee
            ) internal {
                if (_isInitDone) {
                    revert InitDone();
                }
                owner = newOwner;
                isAdmin[newOwner] = true;
                _setRoyalty(royaltyReceiver, royaltyFee);
                _isInitDone = true;
            }
            function withdraw() public onlyOwner {
                payable(msg.sender).transfer(address(this).balance);
            }
            function getBalance() public view returns (uint256) {
                return address(this).balance;
            }
            /**
             * @dev Owner
             */
            modifier onlyOwner() {
                if (owner != msg.sender) {
                    revert NotOwner();
                }
                _;
            }
            function transferOwnership(address newOwner) public virtual onlyOwner {
                if (newOwner == address(0)) {
                    revert ZeroAddress();
                }
                isAdmin[owner] = false;
                isAdmin[newOwner] = true;
                owner = newOwner;
            }
            /**
             * @dev Admin
             */
            modifier onlyAdmin() {
                if (isAdmin[msg.sender] != true) {
                    revert NotAdmin();
                }
                _;
            }
            function setIsAdmin(address adminAddress, bool admin) public onlyOwner {
                isAdmin[adminAddress] = admin;
            }
            /**
             * @dev Royalty
             */
            function setRoyalty(
                address _royaltyReceiver,
                uint256 _royaltyFee
            ) public onlyAdmin {
                _setRoyalty(_royaltyReceiver, uint96(_royaltyFee));
            }
            function _setRoyalty(address _royaltyReceiver, uint96 _royaltyFee) private {
                if (_royaltyReceiver == address(0)) {
                    _setDefaultRoyalty(owner, 0);
                } else {
                    _setDefaultRoyalty(_royaltyReceiver, _royaltyFee);
                }
                if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
                    if (_royaltyReceiver != address(0)) {
                        if (!_isOperatorFilterRegistered) {
                            OPERATOR_FILTER_REGISTRY.registerAndSubscribe(
                                address(this),
                                CANONICAL_CORI_SUBSCRIPTION
                            );
                            _isOperatorFilterRegistered = true;
                        }
                    } else {
                        if (_isOperatorFilterRegistered) {
                            OPERATOR_FILTER_REGISTRY.unregister(address(this));
                            _isOperatorFilterRegistered = false;
                        }
                    }
                }
            }
        }
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        interface IErcForgeERC721Mintable {
            function mint(address to) external payable;
        }
        //SPDX-License-Identifier: CC-BY-NC-ND
        pragma solidity ^0.8.0;
        interface IErcForgeInitiable {
            function init(
                address newOwner,
                string memory newName,
                string memory newSymbol,
                string memory newBaseTokenURI,
                string memory newContractUri,
                address royaltyReceiver,
                uint96 royaltyFee
            ) external;
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.13;
        interface IOperatorFilterRegistry {
            /**
             * @notice Returns true if operator is not filtered for a given token, either by address or codeHash. Also returns
             *         true if supplied registrant address is not registered.
             */
            function isOperatorAllowed(address registrant, address operator) external view returns (bool);
            /**
             * @notice Registers an address with the registry. May be called by address itself or by EIP-173 owner.
             */
            function register(address registrant) external;
            /**
             * @notice Registers an address with the registry and "subscribes" to another address's filtered operators and codeHashes.
             */
            function registerAndSubscribe(address registrant, address subscription) external;
            /**
             * @notice Registers an address with the registry and copies the filtered operators and codeHashes from another
             *         address without subscribing.
             */
            function registerAndCopyEntries(address registrant, address registrantToCopy) external;
            /**
             * @notice Unregisters an address with the registry and removes its subscription. May be called by address itself or by EIP-173 owner.
             *         Note that this does not remove any filtered addresses or codeHashes.
             *         Also note that any subscriptions to this registrant will still be active and follow the existing filtered addresses and codehashes.
             */
            function unregister(address addr) external;
            /**
             * @notice Update an operator address for a registered address - when filtered is true, the operator is filtered.
             */
            function updateOperator(address registrant, address operator, bool filtered) external;
            /**
             * @notice Update multiple operators for a registered address - when filtered is true, the operators will be filtered. Reverts on duplicates.
             */
            function updateOperators(address registrant, address[] calldata operators, bool filtered) external;
            /**
             * @notice Update a codeHash for a registered address - when filtered is true, the codeHash is filtered.
             */
            function updateCodeHash(address registrant, bytes32 codehash, bool filtered) external;
            /**
             * @notice Update multiple codeHashes for a registered address - when filtered is true, the codeHashes will be filtered. Reverts on duplicates.
             */
            function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external;
            /**
             * @notice Subscribe an address to another registrant's filtered operators and codeHashes. Will remove previous
             *         subscription if present.
             *         Note that accounts with subscriptions may go on to subscribe to other accounts - in this case,
             *         subscriptions will not be forwarded. Instead the former subscription's existing entries will still be
             *         used.
             */
            function subscribe(address registrant, address registrantToSubscribe) external;
            /**
             * @notice Unsubscribe an address from its current subscribed registrant, and optionally copy its filtered operators and codeHashes.
             */
            function unsubscribe(address registrant, bool copyExistingEntries) external;
            /**
             * @notice Get the subscription address of a given registrant, if any.
             */
            function subscriptionOf(address addr) external returns (address registrant);
            /**
             * @notice Get the set of addresses subscribed to a given registrant.
             *         Note that order is not guaranteed as updates are made.
             */
            function subscribers(address registrant) external returns (address[] memory);
            /**
             * @notice Get the subscriber at a given index in the set of addresses subscribed to a given registrant.
             *         Note that order is not guaranteed as updates are made.
             */
            function subscriberAt(address registrant, uint256 index) external returns (address);
            /**
             * @notice Copy filtered operators and codeHashes from a different registrantToCopy to addr.
             */
            function copyEntriesOf(address registrant, address registrantToCopy) external;
            /**
             * @notice Returns true if operator is filtered by a given address or its subscription.
             */
            function isOperatorFiltered(address registrant, address operator) external returns (bool);
            /**
             * @notice Returns true if the hash of an address's code is filtered by a given address or its subscription.
             */
            function isCodeHashOfFiltered(address registrant, address operatorWithCode) external returns (bool);
            /**
             * @notice Returns true if a codeHash is filtered by a given address or its subscription.
             */
            function isCodeHashFiltered(address registrant, bytes32 codeHash) external returns (bool);
            /**
             * @notice Returns a list of filtered operators for a given address or its subscription.
             */
            function filteredOperators(address addr) external returns (address[] memory);
            /**
             * @notice Returns the set of filtered codeHashes for a given address or its subscription.
             *         Note that order is not guaranteed as updates are made.
             */
            function filteredCodeHashes(address addr) external returns (bytes32[] memory);
            /**
             * @notice Returns the filtered operator at the given index of the set of filtered operators for a given address or
             *         its subscription.
             *         Note that order is not guaranteed as updates are made.
             */
            function filteredOperatorAt(address registrant, uint256 index) external returns (address);
            /**
             * @notice Returns the filtered codeHash at the given index of the list of filtered codeHashes for a given address or
             *         its subscription.
             *         Note that order is not guaranteed as updates are made.
             */
            function filteredCodeHashAt(address registrant, uint256 index) external returns (bytes32);
            /**
             * @notice Returns true if an address has registered
             */
            function isRegistered(address addr) external returns (bool);
            /**
             * @dev Convenience method to compute the code hash of an arbitrary contract
             */
            function codeHashOf(address addr) external returns (bytes32);
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.13;
        address constant CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS = 0x000000000000AAeB6D7670E522A718067333cd4E;
        address constant CANONICAL_CORI_SUBSCRIPTION = 0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6;
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.13;
        import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.sol";
        import {CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS} from "./lib/Constants.sol";
        /**
         * @title  OperatorFilterer
         * @notice Abstract contract whose constructor automatically registers and optionally subscribes to or copies another
         *         registrant's entries in the OperatorFilterRegistry.
         * @dev    This smart contract is meant to be inherited by token contracts so they can use the following:
         *         - `onlyAllowedOperator` modifier for `transferFrom` and `safeTransferFrom` methods.
         *         - `onlyAllowedOperatorApproval` modifier for `approve` and `setApprovalForAll` methods.
         *         Please note that if your token contract does not provide an owner with EIP-173, it must provide
         *         administration methods on the contract itself to interact with the registry otherwise the subscription
         *         will be locked to the options set during construction.
         */
        abstract contract OperatorFilterer {
            /// @dev Emitted when an operator is not allowed.
            error OperatorNotAllowed(address operator);
            IOperatorFilterRegistry public constant OPERATOR_FILTER_REGISTRY =
                IOperatorFilterRegistry(CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS);
            /// @dev The constructor that is called when the contract is being deployed.
            constructor(address subscriptionOrRegistrantToCopy, bool subscribe) {
                // If an inheriting token contract is deployed to a network without the registry deployed, the modifier
                // will not revert, but the contract will need to be registered with the registry once it is deployed in
                // order for the modifier to filter addresses.
                if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
                    if (subscribe) {
                        OPERATOR_FILTER_REGISTRY.registerAndSubscribe(address(this), subscriptionOrRegistrantToCopy);
                    } else {
                        if (subscriptionOrRegistrantToCopy != address(0)) {
                            OPERATOR_FILTER_REGISTRY.registerAndCopyEntries(address(this), subscriptionOrRegistrantToCopy);
                        } else {
                            OPERATOR_FILTER_REGISTRY.register(address(this));
                        }
                    }
                }
            }
            /**
             * @dev A helper function to check if an operator is allowed.
             */
            modifier onlyAllowedOperator(address from) virtual {
                // Allow spending tokens from addresses with balance
                // Note that this still allows listings and marketplaces with escrow to transfer tokens if transferred
                // from an EOA.
                if (from != msg.sender) {
                    _checkFilterOperator(msg.sender);
                }
                _;
            }
            /**
             * @dev A helper function to check if an operator approval is allowed.
             */
            modifier onlyAllowedOperatorApproval(address operator) virtual {
                _checkFilterOperator(operator);
                _;
            }
            /**
             * @dev A helper function to check if an operator is allowed.
             */
            function _checkFilterOperator(address operator) internal view virtual {
                // Check registry code length to facilitate testing in environments without a deployed registry.
                if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
                    // under normal circumstances, this function will revert rather than return false, but inheriting contracts
                    // may specify their own OperatorFilterRegistry implementations, which may behave differently
                    if (!OPERATOR_FILTER_REGISTRY.isOperatorAllowed(address(this), operator)) {
                        revert OperatorNotAllowed(operator);
                    }
                }
            }
        }