Contract Source Code (Solidity Multiple files format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.19;


import "./DefaultOperatorFilterer.sol";

/*                                      
 * @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 functionCall(target, data, "Address: low-level call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
     * `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but also transferring `value` wei to `target`.
     *
     * Requirements:
     *
     * - the calling contract must have an ETH balance of at least `value`.
     * - the called Solidity function must be `payable`.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
    }

    /**
     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
     * with `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value,
        string memory errorMessage
    ) internal returns (bytes memory) {
        require(address(this).balance >= value, "Address: insufficient balance for call");
        require(isContract(target), "Address: call to non-contract");

        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResult(success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
        return functionStaticCall(target, data, "Address: low-level static call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        require(isContract(target), "Address: static call to non-contract");

        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResult(success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionDelegateCall(target, data, "Address: low-level delegate call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        require(isContract(target), "Address: delegate call to non-contract");

        (bool success, bytes memory returndata) = target.delegatecall(data);
        return verifyCallResult(success, returndata, errorMessage);
    }

    /**
     * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason using the provided one.
     *
     * _Available since v4.3._
     */
    function verifyCallResult(
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal pure returns (bytes memory) {
        if (success) {
            return returndata;
        } else {
            // Look for revert reason and bubble it up if present
            if (returndata.length > 0) {
                // The easiest way to bubble the revert reason is using memory via assembly
                /// @solidity memory-safe-assembly
                assembly {
                    let returndata_size := mload(returndata)
                    revert(add(32, returndata), returndata_size)
                }
            } else {
                revert(errorMessage);
            }
        }
    }
}

abstract contract Context {
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

    function _msgData() internal view virtual returns (bytes calldata) {
        return msg.data;
    }
}

interface IERC721A {
    /**
     * The caller must own the token or be an approved operator.
     */
    error ApprovalCallerNotOwnerNorApproved();

    /**
     * The token does not exist.
     */
    error ApprovalQueryForNonexistentToken();

    /**
     * The caller cannot approve to their own address.
     */
    error ApproveToCaller();

    /**
     * Cannot query the balance for the zero address.
     */
    error BalanceQueryForZeroAddress();

    /**
     * Cannot mint to the zero address.
     */
    error MintToZeroAddress();

    /**
     * The quantity of tokens minted must be more than zero.
     */
    error MintZeroQuantity();

    /**
     * The token does not exist.
     */
    error OwnerQueryForNonexistentToken();

    /**
     * The caller must own the token or be an approved operator.
     */
    error TransferCallerNotOwnerNorApproved();

    /**
     * The token must be owned by `from`.
     */
    error TransferFromIncorrectOwner();

    /**
     * Cannot safely transfer to a contract that does not implement the
     * ERC721Receiver interface.
     */
    error TransferToNonERC721ReceiverImplementer();

    /**
     * Cannot transfer to the zero address.
     */
    error TransferToZeroAddress();

    /**
     * The token does not exist.
     */
    error URIQueryForNonexistentToken();

    /**
     * The `quantity` minted with ERC2309 exceeds the safety limit.
     */
    error MintERC2309QuantityExceedsLimit();

    /**
     * The `extraData` cannot be set on an unintialized ownership slot.
     */
    error OwnershipNotInitializedForExtraData();

    // =============================================================
    //                            STRUCTS
    // =============================================================

    struct TokenOwnership {
        // The address of the owner.
        address addr;
        // Stores the start time of ownership with minimal overhead for tokenomics.
        uint64 startTimestamp;
        // Whether the token has been burned.
        bool burned;
        // Arbitrary data similar to `startTimestamp` that can be set via {_extraData}.
        uint24 extraData;
    }

    // =============================================================
    //                         TOKEN COUNTERS
    // =============================================================

    /**
     * @dev Returns the total number of tokens in existence.
     * Burned tokens will reduce the count.
     * To get the total number of tokens minted, please see {_totalMinted}.
     */
    function totalSupply() external view returns (uint256);

    // =============================================================
    //                            IERC165
    // =============================================================

    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);

    // =============================================================
    //                            IERC721
    // =============================================================

    /**
     * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
     */
    event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);

    /**
     * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
     */
    event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);

    /**
     * @dev Emitted when `owner` enables or disables
     * (`approved`) `operator` to manage all of its assets.
     */
    event ApprovalForAll(address indexed owner, address indexed operator, bool approved);

    /**
     * @dev Returns the number of tokens in `owner`'s account.
     */
    function balanceOf(address owner) external view returns (uint256 balance);

    /**
     * @dev Returns the owner of the `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function ownerOf(uint256 tokenId) external view returns (address owner);

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`,
     * checking first that contract recipients are aware of the ERC721 protocol
     * to prevent tokens from being forever locked.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must exist and be owned by `from`.
     * - If the caller is not `from`, it must be have been allowed to move
     * this token by either {approve} or {setApprovalForAll}.
     * - If `to` refers to a smart contract, it must implement
     * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
     *
     * Emits a {Transfer} event.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId,
        bytes calldata data
    ) external;

    /**
     * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId
    ) external;

    /**
     * @dev Transfers `tokenId` from `from` to `to`.
     *
     * WARNING: Usage of this method is discouraged, use {safeTransferFrom}
     * whenever possible.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must be owned by `from`.
     * - If the caller is not `from`, it must be approved to move this token
     * by either {approve} or {setApprovalForAll}.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(
        address from,
        address to,
        uint256 tokenId
    ) external;

    /**
     * @dev Gives permission to `to` to transfer `tokenId` token to another account.
     * The approval is cleared when the token is transferred.
     *
     * Only a single account can be approved at a time, so approving the
     * zero address clears previous approvals.
     *
     * Requirements:
     *
     * - The caller must own the token or be an approved operator.
     * - `tokenId` must exist.
     *
     * Emits an {Approval} event.
     */
    function approve(address to, uint256 tokenId) external;

    /**
     * @dev Approve or remove `operator` as an operator for the caller.
     * Operators can call {transferFrom} or {safeTransferFrom}
     * for any token owned by the caller.
     *
     * Requirements:
     *
     * - The `operator` cannot be the caller.
     *
     * Emits an {ApprovalForAll} event.
     */
    function setApprovalForAll(address operator, bool _approved) external;

    /**
     * @dev Returns the account approved for `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function getApproved(uint256 tokenId) external view returns (address operator);

    /**
     * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
     *
     * See {setApprovalForAll}.
     */
    function isApprovedForAll(address owner, address operator) external view returns (bool);

    // =============================================================
    //                        IERC721Metadata
    // =============================================================

    /**
     * @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);

    // =============================================================
    //                           IERC2309
    // =============================================================

    /**
     * @dev Emitted when tokens in `fromTokenId` to `toTokenId`
     * (inclusive) is transferred from `from` to `to`, as defined in the
     * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard.
     *
     * See {_mintERC2309} for more details.
     */
    event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to);
}

library Strings {
    bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
    uint8 private constant _ADDRESS_LENGTH = 20;

    /**
     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
     */
    function toString(uint256 value) internal pure returns (string memory) {
        // Inspired by OraclizeAPI's implementation - MIT licence
        // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol

        if (value == 0) {
            return "0";
        }
        uint256 temp = value;
        uint256 digits;
        while (temp != 0) {
            digits++;
            temp /= 10;
        }
        bytes memory buffer = new bytes(digits);
        while (value != 0) {
            digits -= 1;
            buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
            value /= 10;
        }
        return string(buffer);
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
     */
    function toHexString(uint256 value) internal pure returns (string memory) {
        if (value == 0) {
            return "0x00";
        }
        uint256 temp = value;
        uint256 length = 0;
        while (temp != 0) {
            length++;
            temp >>= 8;
        }
        return toHexString(value, length);
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
     */
    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
        bytes memory buffer = new bytes(2 * length + 2);
        buffer[0] = "0";
        buffer[1] = "x";
        for (uint256 i = 2 * length + 1; i > 1; --i) {
            buffer[i] = _HEX_SYMBOLS[value & 0xf];
            value >>= 4;
        }
        require(value == 0, "Strings: hex length insufficient");
        return string(buffer);
    }

    /**
     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
     */
    function toHexString(address addr) internal pure returns (string memory) {
        return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
    }
}

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);
    }
}


/**
 * @dev Interface of ERC721 token receiver.
 */
interface ERC721A__IERC721Receiver {
    function onERC721Received(
        address operator,
        address from,
        uint256 tokenId,
        bytes calldata data
    ) external returns (bytes4);
}

/**
 * @title ERC721A
 *
 * @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721)
 * Non-Fungible Token Standard, including the Metadata extension.
 * Optimized for lower gas during batch mints.
 *
 * Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...)
 * starting from `_startTokenId()`.
 *
 * Assumptions:
 *
 * - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply.
 * - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256).
 */
contract ERC721A is IERC721A {
    // Reference type for token approval.
    struct TokenApprovalRef {
        address value;
    }

    // =============================================================
    //                           CONSTANTS
    // =============================================================

    // Mask of an entry in packed address data.
    uint256 private constant _BITMASK_ADDRESS_DATA_ENTRY = (1 << 64) - 1;

    // The bit position of `numberMinted` in packed address data.
    uint256 private constant _BITPOS_NUMBER_MINTED = 64;

    // The bit position of `numberBurned` in packed address data.
    uint256 private constant _BITPOS_NUMBER_BURNED = 128;

    // The bit position of `aux` in packed address data.
    uint256 private constant _BITPOS_AUX = 192;

    // Mask of all 256 bits in packed address data except the 64 bits for `aux`.
    uint256 private constant _BITMASK_AUX_COMPLEMENT = (1 << 192) - 1;

    // The bit position of `startTimestamp` in packed ownership.
    uint256 private constant _BITPOS_START_TIMESTAMP = 160;

    // The bit mask of the `burned` bit in packed ownership.
    uint256 private constant _BITMASK_BURNED = 1 << 224;

    // The bit position of the `nextInitialized` bit in packed ownership.
    uint256 private constant _BITPOS_NEXT_INITIALIZED = 225;

    // The bit mask of the `nextInitialized` bit in packed ownership.
    uint256 private constant _BITMASK_NEXT_INITIALIZED = 1 << 225;

    // The bit position of `extraData` in packed ownership.
    uint256 private constant _BITPOS_EXTRA_DATA = 232;

    // Mask of all 256 bits in a packed ownership except the 24 bits for `extraData`.
    uint256 private constant _BITMASK_EXTRA_DATA_COMPLEMENT = (1 << 232) - 1;

    // The mask of the lower 160 bits for addresses.
    uint256 private constant _BITMASK_ADDRESS = (1 << 160) - 1;

    // The maximum `quantity` that can be minted with {_mintERC2309}.
    // This limit is to prevent overflows on the address data entries.
    // For a limit of 5000, a total of 3.689e15 calls to {_mintERC2309}
    // is required to cause an overflow, which is unrealistic.
    uint256 private constant _MAX_MINT_ERC2309_QUANTITY_LIMIT = 5000;

    // The `Transfer` event signature is given by:
    // `keccak256(bytes("Transfer(address,address,uint256)"))`.
    bytes32 private constant _TRANSFER_EVENT_SIGNATURE =
        0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef;

    // =============================================================
    //                            STORAGE
    // =============================================================

    // The next token ID to be minted.
    uint256 private _currentIndex;

    // The number of tokens burned.
    uint256 private _burnCounter;

    // Token name
    string private _name;

    // Token symbol
    string private _symbol;

    // Mapping from token ID to ownership details
    // An empty struct value does not necessarily mean the token is unowned.
    // See {_packedOwnershipOf} implementation for details.
    //
    // Bits Layout:
    // - [0..159]   `addr`
    // - [160..223] `startTimestamp`
    // - [224]      `burned`
    // - [225]      `nextInitialized`
    // - [232..255] `extraData`
    mapping(uint256 => uint256) private _packedOwnerships;

    // Mapping owner address to address data.
    //
    // Bits Layout:
    // - [0..63]    `balance`
    // - [64..127]  `numberMinted`
    // - [128..191] `numberBurned`
    // - [192..255] `aux`
    mapping(address => uint256) private _packedAddressData;

    // Mapping from token ID to approved address.
    mapping(uint256 => TokenApprovalRef) private _tokenApprovals;

    // Mapping from owner to operator approvals
    mapping(address => mapping(address => bool)) private _operatorApprovals;

    // =============================================================
    //                          CONSTRUCTOR
    // =============================================================

    constructor(string memory name_, string memory symbol_) {
        _name = name_;
        _symbol = symbol_;
        _currentIndex = _startTokenId();
    }

    // =============================================================
    //                   TOKEN COUNTING OPERATIONS
    // =============================================================

    /**
     * @dev Returns the starting token ID.
     * To change the starting token ID, please override this function.
     */
    function _startTokenId() internal view virtual returns (uint256) {
        return 1;
    }

    /**
     * @dev Returns the next token ID to be minted.
     */
    function _nextTokenId() internal view virtual returns (uint256) {
        return _currentIndex;
    }

    /**
     * @dev Returns the total number of tokens in existence.
     * Burned tokens will reduce the count.
     * To get the total number of tokens minted, please see {_totalMinted}.
     */
    function totalSupply() public view virtual override returns (uint256) {
        // Counter underflow is impossible as _burnCounter cannot be incremented
        // more than `_currentIndex - _startTokenId()` times.
        unchecked {
            return _currentIndex - _burnCounter - _startTokenId();
        }
    }

    /**
     * @dev Returns the total amount of tokens minted in the contract.
     */
    function _totalMinted() internal view virtual returns (uint256) {
        // Counter underflow is impossible as `_currentIndex` does not decrement,
        // and it is initialized to `_startTokenId()`.
        unchecked {
            return _currentIndex - _startTokenId();
        }
    }

    /**
     * @dev Returns the total number of tokens burned.
     */
    function _totalBurned() internal view virtual returns (uint256) {
        return _burnCounter;
    }

    // =============================================================
    //                    ADDRESS DATA OPERATIONS
    // =============================================================

    /**
     * @dev Returns the number of tokens in `owner`'s account.
     */
    function balanceOf(address owner) public view virtual override returns (uint256) {
        if (owner == address(0)) revert BalanceQueryForZeroAddress();
        return _packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY;
    }

    /**
     * Returns the number of tokens minted by `owner`.
     */
    function _numberMinted(address owner) internal view returns (uint256) {
        return (_packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY;
    }

    /**
     * Returns the number of tokens burned by or on behalf of `owner`.
     */
    function _numberBurned(address owner) internal view returns (uint256) {
        return (_packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY;
    }

    /**
     * Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
     */
    function _getAux(address owner) internal view returns (uint64) {
        return uint64(_packedAddressData[owner] >> _BITPOS_AUX);
    }

    /**
     * Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
     * If there are multiple variables, please pack them into a uint64.
     */
    function _setAux(address owner, uint64 aux) internal virtual {
        uint256 packed = _packedAddressData[owner];
        uint256 auxCasted;
        // Cast `aux` with assembly to avoid redundant masking.
        assembly {
            auxCasted := aux
        }
        packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX);
        _packedAddressData[owner] = packed;
    }

    // =============================================================
    //                            IERC165
    // =============================================================

    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30000 gas.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        // The interface IDs are constants representing the first 4 bytes
        // of the XOR of all function selectors in the interface.
        // See: [ERC165](https://eips.ethereum.org/EIPS/eip-165)
        // (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`)
        return
            interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165.
            interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721.
            interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata.
    }

    // =============================================================
    //                        IERC721Metadata
    // =============================================================

    /**
     * @dev Returns the token collection name.
     */
    function name() public view virtual override returns (string memory) {
        return _name;
    }

    /**
     * @dev Returns the token collection symbol.
     */
    function symbol() public view virtual override returns (string memory) {
        return _symbol;
    }

    /**
     * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
     */
    function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
        if (!_exists(tokenId)) revert URIQueryForNonexistentToken();

        string memory baseURI = _baseURI();
        return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : '';
    }

    /**
     * @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, it can be overridden in child contracts.
     */
    function _baseURI() internal view virtual returns (string memory) {
        return '';
    }

    // =============================================================
    //                     OWNERSHIPS OPERATIONS
    // =============================================================

    /**
     * @dev Returns the owner of the `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function ownerOf(uint256 tokenId) public view virtual override returns (address) {
        return address(uint160(_packedOwnershipOf(tokenId)));
    }

    /**
     * @dev Gas spent here starts off proportional to the maximum mint batch size.
     * It gradually moves to O(1) as tokens get transferred around over time.
     */
    function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) {
        return _unpackedOwnership(_packedOwnershipOf(tokenId));
    }

    /**
     * @dev Returns the unpacked `TokenOwnership` struct at `index`.
     */
    function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) {
        return _unpackedOwnership(_packedOwnerships[index]);
    }

    /**
     * @dev Initializes the ownership slot minted at `index` for efficiency purposes.
     */
    function _initializeOwnershipAt(uint256 index) internal virtual {
        if (_packedOwnerships[index] == 0) {
            _packedOwnerships[index] = _packedOwnershipOf(index);
        }
    }

    /**
     * Returns the packed ownership data of `tokenId`.
     */
    function _packedOwnershipOf(uint256 tokenId) private view returns (uint256) {
        uint256 curr = tokenId;

        unchecked {
            if (_startTokenId() <= curr)
                if (curr < _currentIndex) {
                    uint256 packed = _packedOwnerships[curr];
                    // If not burned.
                    if (packed & _BITMASK_BURNED == 0) {
                        // Invariant:
                        // There will always be an initialized ownership slot
                        // (i.e. `ownership.addr != address(0) && ownership.burned == false`)
                        // before an unintialized ownership slot
                        // (i.e. `ownership.addr == address(0) && ownership.burned == false`)
                        // Hence, `curr` will not underflow.
                        //
                        // We can directly compare the packed value.
                        // If the address is zero, packed will be zero.
                        while (packed == 0) {
                            packed = _packedOwnerships[--curr];
                        }
                        return packed;
                    }
                }
        }
        revert OwnerQueryForNonexistentToken();
    }

    /**
     * @dev Returns the unpacked `TokenOwnership` struct from `packed`.
     */
    function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) {
        ownership.addr = address(uint160(packed));
        ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP);
        ownership.burned = packed & _BITMASK_BURNED != 0;
        ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA);
    }

    /**
     * @dev Packs ownership data into a single uint256.
     */
    function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) {
        assembly {
            // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
            owner := and(owner, _BITMASK_ADDRESS)
            // `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`.
            result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags))
        }
    }

    /**
     * @dev Returns the `nextInitialized` flag set if `quantity` equals 1.
     */
    function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) {
        // For branchless setting of the `nextInitialized` flag.
        assembly {
            // `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`.
            result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1))
        }
    }

    // =============================================================
    //                      APPROVAL OPERATIONS
    // =============================================================

    /**
     * @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) public virtual override {
        address owner = ownerOf(tokenId);

        if (_msgSenderERC721A() != owner)
            if (!isApprovedForAll(owner, _msgSenderERC721A())) {
                revert ApprovalCallerNotOwnerNorApproved();
            }

        _tokenApprovals[tokenId].value = to;
        emit Approval(owner, to, tokenId);
    }

    /**
     * @dev Returns the account approved for `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function getApproved(uint256 tokenId) public view virtual override returns (address) {
        if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken();

        return _tokenApprovals[tokenId].value;
    }

    /**
     * @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) public virtual override {
        if (operator == _msgSenderERC721A()) revert ApproveToCaller();

        _operatorApprovals[_msgSenderERC721A()][operator] = approved;
        emit ApprovalForAll(_msgSenderERC721A(), operator, approved);
    }

    /**
     * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
     *
     * See {setApprovalForAll}.
     */
    function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
        return _operatorApprovals[owner][operator];
    }

    /**
     * @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. See {_mint}.
     */
    function _exists(uint256 tokenId) internal view virtual returns (bool) {
        return
            _startTokenId() <= tokenId &&
            tokenId < _currentIndex && // If within bounds,
            _packedOwnerships[tokenId] & _BITMASK_BURNED == 0; // and not burned.
    }

    /**
     * @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`.
     */
    function _isSenderApprovedOrOwner(
        address approvedAddress,
        address owner,
        address msgSender
    ) private pure returns (bool result) {
        assembly {
            // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
            owner := and(owner, _BITMASK_ADDRESS)
            // Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean.
            msgSender := and(msgSender, _BITMASK_ADDRESS)
            // `msgSender == owner || msgSender == approvedAddress`.
            result := or(eq(msgSender, owner), eq(msgSender, approvedAddress))
        }
    }

    /**
     * @dev Returns the storage slot and value for the approved address of `tokenId`.
     */
    function _getApprovedSlotAndAddress(uint256 tokenId)
        private
        view
        returns (uint256 approvedAddressSlot, address approvedAddress)
    {
        TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId];
        // The following is equivalent to `approvedAddress = _tokenApprovals[tokenId]`.
        assembly {
            approvedAddressSlot := tokenApproval.slot
            approvedAddress := sload(approvedAddressSlot)
        }
    }

    // =============================================================
    //                      TRANSFER OPERATIONS
    // =============================================================

    /**
     * @dev Transfers `tokenId` from `from` to `to`.
     *
     * 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
    ) public virtual override {
        uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);

        if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner();

        (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);

        // The nested ifs save around 20+ gas over a compound boolean condition.
        if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
            if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();

        if (to == address(0)) revert TransferToZeroAddress();

        _beforeTokenTransfers(from, to, tokenId, 1);

        // Clear approvals from the previous owner.
        assembly {
            if approvedAddress {
                // This is equivalent to `delete _tokenApprovals[tokenId]`.
                sstore(approvedAddressSlot, 0)
            }
        }

        // Underflow of the sender's balance is impossible because we check for
        // ownership above and the recipient's balance can't realistically overflow.
        // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
        unchecked {
            // We can directly increment and decrement the balances.
            --_packedAddressData[from]; // Updates: `balance -= 1`.
            ++_packedAddressData[to]; // Updates: `balance += 1`.

            // Updates:
            // - `address` to the next owner.
            // - `startTimestamp` to the timestamp of transfering.
            // - `burned` to `false`.
            // - `nextInitialized` to `true`.
            _packedOwnerships[tokenId] = _packOwnershipData(
                to,
                _BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked)
            );

            // If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
            if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
                uint256 nextTokenId = tokenId + 1;
                // If the next slot's address is zero and not burned (i.e. packed value is zero).
                if (_packedOwnerships[nextTokenId] == 0) {
                    // If the next slot is within bounds.
                    if (nextTokenId != _currentIndex) {
                        // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
                        _packedOwnerships[nextTokenId] = prevOwnershipPacked;
                    }
                }
            }
        }

        emit Transfer(from, to, tokenId);
        _afterTokenTransfers(from, to, tokenId, 1);
    }

    /**
     * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId
    ) public virtual override {
        safeTransferFrom(from, to, tokenId, '');
    }

    /**
     * @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 memory _data
    ) public virtual override {
        transferFrom(from, to, tokenId);
        if (to.code.length != 0)
            if (!_checkContractOnERC721Received(from, to, tokenId, _data)) {
                revert TransferToNonERC721ReceiverImplementer();
            }
    }

    /**
     * @dev Hook that is called before a set of serially-ordered token IDs
     * are about to be transferred. This includes minting.
     * And also called before burning one token.
     *
     * `startTokenId` - the first token ID to be transferred.
     * `quantity` - the amount to be transferred.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
     * transferred to `to`.
     * - When `from` is zero, `tokenId` will be minted for `to`.
     * - When `to` is zero, `tokenId` will be burned by `from`.
     * - `from` and `to` are never both zero.
     */
    function _beforeTokenTransfers(
        address from,
        address to,
        uint256 startTokenId,
        uint256 quantity
    ) internal virtual {}

    /**
     * @dev Hook that is called after a set of serially-ordered token IDs
     * have been transferred. This includes minting.
     * And also called after one token has been burned.
     *
     * `startTokenId` - the first token ID to be transferred.
     * `quantity` - the amount to be transferred.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, `from`'s `tokenId` has been
     * transferred to `to`.
     * - When `from` is zero, `tokenId` has been minted for `to`.
     * - When `to` is zero, `tokenId` has been burned by `from`.
     * - `from` and `to` are never both zero.
     */
    function _afterTokenTransfers(
        address from,
        address to,
        uint256 startTokenId,
        uint256 quantity
    ) internal virtual {}

    /**
     * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract.
     *
     * `from` - Previous owner of the given token ID.
     * `to` - Target address that will receive the token.
     * `tokenId` - Token ID to be transferred.
     * `_data` - Optional data to send along with the call.
     *
     * Returns whether the call correctly returned the expected magic value.
     */
    function _checkContractOnERC721Received(
        address from,
        address to,
        uint256 tokenId,
        bytes memory _data
    ) private returns (bool) {
        try ERC721A__IERC721Receiver(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns (
            bytes4 retval
        ) {
            return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector;
        } catch (bytes memory reason) {
            if (reason.length == 0) {
                revert TransferToNonERC721ReceiverImplementer();
            } else {
                assembly {
                    revert(add(32, reason), mload(reason))
                }
            }
        }
    }

    // =============================================================
    //                        MINT OPERATIONS
    // =============================================================

    /**
     * @dev Mints `quantity` tokens and transfers them to `to`.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - `quantity` must be greater than 0.
     *
     * Emits a {Transfer} event for each mint.
     */
    function _mint(address to, uint256 quantity) internal virtual {
        uint256 startTokenId = _currentIndex;
        if (quantity == 0) revert MintZeroQuantity();

        _beforeTokenTransfers(address(0), to, startTokenId, quantity);

        // Overflows are incredibly unrealistic.
        // `balance` and `numberMinted` have a maximum limit of 2**64.
        // `tokenId` has a maximum limit of 2**256.
        unchecked {
            // Updates:
            // - `balance += quantity`.
            // - `numberMinted += quantity`.
            //
            // We can directly add to the `balance` and `numberMinted`.
            _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);

            // Updates:
            // - `address` to the owner.
            // - `startTimestamp` to the timestamp of minting.
            // - `burned` to `false`.
            // - `nextInitialized` to `quantity == 1`.
            _packedOwnerships[startTokenId] = _packOwnershipData(
                to,
                _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
            );

            uint256 toMasked;
            uint256 end = startTokenId + quantity;

            // Use assembly to loop and emit the `Transfer` event for gas savings.
            assembly {
                // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
                toMasked := and(to, _BITMASK_ADDRESS)
                // Emit the `Transfer` event.
                log4(
                    0, // Start of data (0, since no data).
                    0, // End of data (0, since no data).
                    _TRANSFER_EVENT_SIGNATURE, // Signature.
                    0, // `address(0)`.
                    toMasked, // `to`.
                    startTokenId // `tokenId`.
                )

                for {
                    let tokenId := add(startTokenId, 1)
                } iszero(eq(tokenId, end)) {
                    tokenId := add(tokenId, 1)
                } {
                    // Emit the `Transfer` event. Similar to above.
                    log4(0, 0, _TRANSFER_EVENT_SIGNATURE, 0, toMasked, tokenId)
                }
            }
            if (toMasked == 0) revert MintToZeroAddress();

            _currentIndex = end;
        }
        _afterTokenTransfers(address(0), to, startTokenId, quantity);
    }

    /**
     * @dev Mints `quantity` tokens and transfers them to `to`.
     *
     * This function is intended for efficient minting only during contract creation.
     *
     * It emits only one {ConsecutiveTransfer} as defined in
     * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309),
     * instead of a sequence of {Transfer} event(s).
     *
     * Calling this function outside of contract creation WILL make your contract
     * non-compliant with the ERC721 standard.
     * For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309
     * {ConsecutiveTransfer} event is only permissible during contract creation.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - `quantity` must be greater than 0.
     *
     * Emits a {ConsecutiveTransfer} event.
     */
    function _mintERC2309(address to, uint256 quantity) internal virtual {
        uint256 startTokenId = _currentIndex;
        if (to == address(0)) revert MintToZeroAddress();
        if (quantity == 0) revert MintZeroQuantity();
        if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) revert MintERC2309QuantityExceedsLimit();

        _beforeTokenTransfers(address(0), to, startTokenId, quantity);

        // Overflows are unrealistic due to the above check for `quantity` to be below the limit.
        unchecked {
            // Updates:
            // - `balance += quantity`.
            // - `numberMinted += quantity`.
            //
            // We can directly add to the `balance` and `numberMinted`.
            _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);

            // Updates:
            // - `address` to the owner.
            // - `startTimestamp` to the timestamp of minting.
            // - `burned` to `false`.
            // - `nextInitialized` to `quantity == 1`.
            _packedOwnerships[startTokenId] = _packOwnershipData(
                to,
                _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
            );

            emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to);

            _currentIndex = startTokenId + quantity;
        }
        _afterTokenTransfers(address(0), to, startTokenId, quantity);
    }

    /**
     * @dev Safely mints `quantity` tokens and transfers them to `to`.
     *
     * Requirements:
     *
     * - If `to` refers to a smart contract, it must implement
     * {IERC721Receiver-onERC721Received}, which is called for each safe transfer.
     * - `quantity` must be greater than 0.
     *
     * See {_mint}.
     *
     * Emits a {Transfer} event for each mint.
     */
    function _safeMint(
        address to,
        uint256 quantity,
        bytes memory _data
    ) internal virtual {
        _mint(to, quantity);

        unchecked {
            if (to.code.length != 0) {
                uint256 end = _currentIndex;
                uint256 index = end - quantity;
                do {
                    if (!_checkContractOnERC721Received(address(0), to, index++, _data)) {
                        revert TransferToNonERC721ReceiverImplementer();
                    }
                } while (index < end);
                // Reentrancy protection.
                if (_currentIndex != end) revert();
            }
        }
    }

    /**
     * @dev Equivalent to `_safeMint(to, quantity, '')`.
     */
    function _safeMint(address to, uint256 quantity) internal virtual {
        _safeMint(to, quantity, '');
    }

    // =============================================================
    //                        BURN OPERATIONS
    // =============================================================

    /**
     * @dev Equivalent to `_burn(tokenId, false)`.
     */
    function _burn(uint256 tokenId) internal virtual {
        _burn(tokenId, false);
    }

    /**
     * @dev Destroys `tokenId`.
     * The approval is cleared when the token is burned.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     *
     * Emits a {Transfer} event.
     */
    function _burn(uint256 tokenId, bool approvalCheck) internal virtual {
        uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);

        address from = address(uint160(prevOwnershipPacked));

        (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);

        if (approvalCheck) {
            // The nested ifs save around 20+ gas over a compound boolean condition.
            if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
                if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();
        }

        _beforeTokenTransfers(from, address(0), tokenId, 1);

        // Clear approvals from the previous owner.
        assembly {
            if approvedAddress {
                // This is equivalent to `delete _tokenApprovals[tokenId]`.
                sstore(approvedAddressSlot, 0)
            }
        }

        // Underflow of the sender's balance is impossible because we check for
        // ownership above and the recipient's balance can't realistically overflow.
        // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
        unchecked {
            // Updates:
            // - `balance -= 1`.
            // - `numberBurned += 1`.
            //
            // We can directly decrement the balance, and increment the number burned.
            // This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`.
            _packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1;

            // Updates:
            // - `address` to the last owner.
            // - `startTimestamp` to the timestamp of burning.
            // - `burned` to `true`.
            // - `nextInitialized` to `true`.
            _packedOwnerships[tokenId] = _packOwnershipData(
                from,
                (_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked)
            );

            // If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
            if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
                uint256 nextTokenId = tokenId + 1;
                // If the next slot's address is zero and not burned (i.e. packed value is zero).
                if (_packedOwnerships[nextTokenId] == 0) {
                    // If the next slot is within bounds.
                    if (nextTokenId != _currentIndex) {
                        // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
                        _packedOwnerships[nextTokenId] = prevOwnershipPacked;
                    }
                }
            }
        }

        emit Transfer(from, address(0), tokenId);
        _afterTokenTransfers(from, address(0), tokenId, 1);

        // Overflow not possible, as _burnCounter cannot be exceed _currentIndex times.
        unchecked {
            _burnCounter++;
        }
    }

    // =============================================================
    //                     EXTRA DATA OPERATIONS
    // =============================================================

    /**
     * @dev Directly sets the extra data for the ownership data `index`.
     */
    function _setExtraDataAt(uint256 index, uint24 extraData) internal virtual {
        uint256 packed = _packedOwnerships[index];
        if (packed == 0) revert OwnershipNotInitializedForExtraData();
        uint256 extraDataCasted;
        // Cast `extraData` with assembly to avoid redundant masking.
        assembly {
            extraDataCasted := extraData
        }
        packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA);
        _packedOwnerships[index] = packed;
    }

    /**
     * @dev Called during each token transfer to set the 24bit `extraData` field.
     * Intended to be overridden by the cosumer contract.
     *
     * `previousExtraData` - the value of `extraData` before transfer.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
     * transferred to `to`.
     * - When `from` is zero, `tokenId` will be minted for `to`.
     * - When `to` is zero, `tokenId` will be burned by `from`.
     * - `from` and `to` are never both zero.
     */
    function _extraData(
        address from,
        address to,
        uint24 previousExtraData
    ) internal view virtual returns (uint24) {}

    /**
     * @dev Returns the next extra data for the packed ownership data.
     * The returned result is shifted into position.
     */
    function _nextExtraData(
        address from,
        address to,
        uint256 prevOwnershipPacked
    ) private view returns (uint256) {
        uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA);
        return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA;
    }

    // =============================================================
    //                       OTHER OPERATIONS
    // =============================================================

    /**
     * @dev Returns the message sender (defaults to `msg.sender`).
     *
     * If you are writing GSN compatible contracts, you need to override this function.
     */
    function _msgSenderERC721A() internal view virtual returns (address) {
        return msg.sender;
    }

    /**
     * @dev Converts a uint256 to its ASCII string decimal representation.
     */
    function _toString(uint256 value) internal pure virtual returns (string memory ptr) {
        assembly {
            // The maximum value of a uint256 contains 78 digits (1 byte per digit),
            // but we allocate 128 bytes to keep the free memory pointer 32-byte word aliged.
            // We will need 1 32-byte word to store the length,
            // and 3 32-byte words to store a maximum of 78 digits. Total: 32 + 3 * 32 = 128.
            ptr := add(mload(0x40), 128)
            // Update the free memory pointer to allocate.
            mstore(0x40, ptr)

            // Cache the end of the memory to calculate the length later.
            let end := ptr

            // We write the string from the rightmost digit to the leftmost digit.
            // The following is essentially a do-while loop that also handles the zero case.
            // Costs a bit more than early returning for the zero case,
            // but cheaper in terms of deployment and overall runtime costs.
            for {
                // Initialize and perform the first pass without check.
                let temp := value
                // Move the pointer 1 byte leftwards to point to an empty character slot.
                ptr := sub(ptr, 1)
                // Write the character to the pointer.
                // The ASCII index of the '0' character is 48.
                mstore8(ptr, add(48, mod(temp, 10)))
                temp := div(temp, 10)
            } temp {
                // Keep dividing `temp` until zero.
                temp := div(temp, 10)
            } {
                // Body of the for loop.
                ptr := sub(ptr, 1)
                mstore8(ptr, add(48, mod(temp, 10)))
            }

            let length := sub(end, ptr)
            // Move the pointer 32 bytes leftwards to make room for the length.
            ptr := sub(ptr, 32)
            // Store the length.
            mstore(ptr, length)
        }
    }
}

contract CheckMates is Ownable, ERC721A, DefaultOperatorFilterer {

    using Strings for uint;

    enum Step {
        Before,
        PublicSale
    }

    string public baseURI;

    Step public sellingStep;

    uint private constant MAX_PUBLIC = 5000;

    uint public publicSalePrice = 0.005120 ether;

    mapping(address => uint) public mintedFree;
    mapping(address => uint) public mintedTotal;

    uint public maxFree = 2; 
    uint public maxPublic = 10; 

    constructor( string memory _baseURI) ERC721A("CheckMates", "ChecksMates"){
        baseURI = _baseURI;
    }

    function mintForOpensea(uint quantity) external onlyOwner{
        _mint(msg.sender, quantity);
    }

    function freeMint(uint _quantity) external {
        if(sellingStep != Step.PublicSale) revert("Public Mint not live.");
        if(totalSupply() + _quantity > 2000) revert("Max supply exceeded for free mints");
        if(mintedFree[msg.sender] + _quantity > maxFree) revert("Max exceeded");
        if(mintedTotal[msg.sender] + _quantity > maxPublic) revert("Max exceeded");
        mintedFree[msg.sender] += _quantity;
        mintedTotal[msg.sender] += _quantity;
        _mint(msg.sender, _quantity);
    }

    function publicSaleMint(uint _quantity) external payable {
        if(sellingStep != Step.PublicSale) revert("Public Mint not live.");
        if(totalSupply() + _quantity > MAX_PUBLIC) revert("Max supply exceeded for public exceeded");
        if(msg.value < publicSalePrice * _quantity) revert("Not enough funds");
        if(mintedTotal[msg.sender] + _quantity > maxPublic) revert("Max exceeded");
        mintedTotal[msg.sender] += _quantity;
        _mint(msg.sender, _quantity);
    }

    function transferFrom(address from, address to, uint256 tokenId) public override(ERC721A) onlyAllowedOperator {
        super.transferFrom(from, to, tokenId);
    }

    function safeTransferFrom(address from, address to, uint256 tokenId) public override(ERC721A) onlyAllowedOperator {
        super.safeTransferFrom(from, to, tokenId);
    }

    function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data)
        public
        override(ERC721A)
        onlyAllowedOperator
    {
        super.safeTransferFrom(from, to, tokenId, data);
    }

    function changePublicSalePrice(uint256 new_price) external onlyOwner{
        publicSalePrice = new_price;
    }

    function setBaseUri(string memory _baseURI) external onlyOwner {
        baseURI = _baseURI;
    }

    function setStep(uint _step) external onlyOwner {
        sellingStep = Step(_step);
    }

    function setMaxFree(uint amount) external onlyOwner{
        maxFree = amount;
    }

    function setMaxMintPerPublic(uint amount) external onlyOwner{
        maxPublic = amount;
    }

    function getNumberMinted(address account) external view returns (uint256) {
        return _numberMinted(account);
    }

    function tokenURI(uint _tokenId) public view virtual override returns (string memory) {
        require(_exists(_tokenId), "URI query for nonexistent token");
        return string(abi.encodePacked(baseURI, _toString(_tokenId), ".json"));
    }

    function withdraw() external onlyOwner {
        require(payable(msg.sender).send(address(this).balance));
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.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 {OperatorFilterer} from "./OperatorFilterer.sol";

contract DefaultOperatorFilterer is OperatorFilterer {
    address constant DEFAULT_SUBSCRIPTION = address(0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6);

    constructor() OperatorFilterer(DEFAULT_SUBSCRIPTION, true) {}
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.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.
 *
 * ```solidity
 * 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 "./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";

contract OperatorFilterer {
    error OperatorNotAllowed(address operator);

    IOperatorFilterRegistry constant operatorFilterRegistry =
        IOperatorFilterRegistry(0x000000000000AAeB6D7670E522A718067333cd4E);

    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(operatorFilterRegistry).code.length > 0) {
            if (subscribe) {
                operatorFilterRegistry.registerAndSubscribe(address(this), subscriptionOrRegistrantToCopy);
            } else {
                if (subscriptionOrRegistrantToCopy != address(0)) {
                    operatorFilterRegistry.registerAndCopyEntries(address(this), subscriptionOrRegistrantToCopy);
                } else {
                    operatorFilterRegistry.register(address(this));
                }
            }
        }
    }

    modifier onlyAllowedOperator() virtual {
        // Check registry code length to facilitate testing in environments without a deployed registry.
        if (address(operatorFilterRegistry).code.length > 0) {
            if (!operatorFilterRegistry.isOperatorAllowed(address(this), msg.sender)) {
                revert OperatorNotAllowed(msg.sender);
            }
        }
        _;
    }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"string","name":"_baseURI","type":"string"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"ApproveToCaller","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"OperatorNotAllowed","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"toTokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"ConsecutiveTransfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"new_price","type":"uint256"}],"name":"changePublicSalePrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_quantity","type":"uint256"}],"name":"freeMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"getNumberMinted","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxFree","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxPublic","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"mintForOpensea","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"mintedFree","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"mintedTotal","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_quantity","type":"uint256"}],"name":"publicSaleMint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"publicSalePrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"sellingStep","outputs":[{"internalType":"enum CheckMates.Step","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"_baseURI","type":"string"}],"name":"setBaseUri","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"setMaxFree","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"setMaxMintPerPublic","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_step","type":"uint256"}],"name":"setStep","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"}]

60806040526612309ce5400000600b556002600e55600a600f553480156200002657600080fd5b50604051620021bb380380620021bb8339810160408190526200004991620002ad565b733cc6cdda760b79bafa08df41ecfa224f810dceb660016040518060400160405280600a815260200169436865636b4d6174657360b01b8152506040518060400160405280600b81526020016a436865636b734d6174657360a81b815250620000c1620000bb6200024360201b60201c565b62000247565b6003620000cf838262000411565b506004620000de828262000411565b506001805550506daaeb6d7670e522a718067333cd4e3b156200022a5780156200017857604051633e9f1edf60e11b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e90637d3e3dbe906044015b600060405180830381600087803b1580156200015957600080fd5b505af11580156200016e573d6000803e3d6000fd5b505050506200022a565b6001600160a01b03821615620001c95760405163a0af290360e01b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e9063a0af2903906044016200013e565b604051632210724360e11b81523060048201526daaeb6d7670e522a718067333cd4e90634420e48690602401600060405180830381600087803b1580156200021057600080fd5b505af115801562000225573d6000803e3d6000fd5b505050505b50600990506200023b828262000411565b5050620004dd565b3390565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b634e487b7160e01b600052604160045260246000fd5b60006020808385031215620002c157600080fd5b82516001600160401b0380821115620002d957600080fd5b818501915085601f830112620002ee57600080fd5b81518181111562000303576200030362000297565b604051601f8201601f19908116603f011681019083821181831017156200032e576200032e62000297565b8160405282815288868487010111156200034757600080fd5b600093505b828410156200036b57848401860151818501870152928501926200034c565b600086848301015280965050505050505092915050565b600181811c908216806200039757607f821691505b602082108103620003b857634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156200040c57600081815260208120601f850160051c81016020861015620003e75750805b601f850160051c820191505b818110156200040857828155600101620003f3565b5050505b505050565b81516001600160401b038111156200042d576200042d62000297565b62000445816200043e845462000382565b84620003be565b602080601f8311600181146200047d5760008415620004645750858301515b600019600386901b1c1916600185901b17855562000408565b600085815260208120601f198616915b82811015620004ae578886015182559484019460019091019084016200048d565b5085821015620004cd5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b611cce80620004ed6000396000f3fe6080604052600436106101f95760003560e01c8063715018a61161010d578063a22cb465116100a0578063cbccefb21161006f578063cbccefb21461059b578063d755bf99146105c2578063e985e9c5146105e2578063f2fde38b14610602578063f8dcbddb1461062257600080fd5b8063a22cb46514610528578063b3ab66b014610548578063b88d4fde1461055b578063c87b56dd1461057b57600080fd5b80638da5cb5b116100dc5780638da5cb5b146104bf57806395d89b41146104dd5780639b6860c8146104f2578063a0bcfc7f1461050857600080fd5b8063715018a6146104545780637c928fe9146104695780637dc42975146104895780638a59a7fd1461049f57600080fd5b806323b872dd1161019057806349e949e71161015f57806349e949e7146103bf5780634fda7285146103df5780636352211e146103ff5780636c0360eb1461041f57806370a082311461043457600080fd5b806323b872dd146103545780633ccfd60b1461037457806342842e0e14610389578063485a68a3146103a957600080fd5b8063145f798f116101cc578063145f798f146102af57806318160ddd146102ea5780631872d83c14610307578063209848011461032757600080fd5b806301ffc9a7146101fe57806306fdde0314610233578063081812fc14610255578063095ea7b31461028d575b600080fd5b34801561020a57600080fd5b5061021e6102193660046116a7565b610642565b60405190151581526020015b60405180910390f35b34801561023f57600080fd5b50610248610694565b60405161022a9190611714565b34801561026157600080fd5b50610275610270366004611727565b610726565b6040516001600160a01b03909116815260200161022a565b34801561029957600080fd5b506102ad6102a836600461175c565b61076a565b005b3480156102bb57600080fd5b506102dc6102ca366004611786565b600d6020526000908152604090205481565b60405190815260200161022a565b3480156102f657600080fd5b5060025460015403600019016102dc565b34801561031357600080fd5b506102ad610322366004611727565b61080a565b34801561033357600080fd5b506102dc610342366004611786565b600c6020526000908152604090205481565b34801561036057600080fd5b506102ad61036f3660046117a1565b61081f565b34801561038057600080fd5b506102ad6108dd565b34801561039557600080fd5b506102ad6103a43660046117a1565b61090b565b3480156103b557600080fd5b506102dc600e5481565b3480156103cb57600080fd5b506102ad6103da366004611727565b6109bf565b3480156103eb57600080fd5b506102ad6103fa366004611727565b6109cc565b34801561040b57600080fd5b5061027561041a366004611727565b6109d9565b34801561042b57600080fd5b506102486109e4565b34801561044057600080fd5b506102dc61044f366004611786565b610a72565b34801561046057600080fd5b506102ad610ac1565b34801561047557600080fd5b506102ad610484366004611727565b610ad3565b34801561049557600080fd5b506102dc600f5481565b3480156104ab57600080fd5b506102dc6104ba366004611786565b610c70565b3480156104cb57600080fd5b506000546001600160a01b0316610275565b3480156104e957600080fd5b50610248610c9b565b3480156104fe57600080fd5b506102dc600b5481565b34801561051457600080fd5b506102ad610523366004611869565b610caa565b34801561053457600080fd5b506102ad6105433660046118c0565b610cc2565b6102ad610556366004611727565b610d57565b34801561056757600080fd5b506102ad6105763660046118f7565b610ed9565b34801561058757600080fd5b50610248610596366004611727565b610f94565b3480156105a757600080fd5b50600a546105b59060ff1681565b60405161022a9190611989565b3480156105ce57600080fd5b506102ad6105dd366004611727565b61101d565b3480156105ee57600080fd5b5061021e6105fd3660046119b1565b61102a565b34801561060e57600080fd5b506102ad61061d366004611786565b611058565b34801561062e57600080fd5b506102ad61063d366004611727565b6110ce565b60006301ffc9a760e01b6001600160e01b03198316148061067357506380ac58cd60e01b6001600160e01b03198316145b8061068e5750635b5e139f60e01b6001600160e01b03198316145b92915050565b6060600380546106a3906119e4565b80601f01602080910402602001604051908101604052809291908181526020018280546106cf906119e4565b801561071c5780601f106106f15761010080835404028352916020019161071c565b820191906000526020600020905b8154815290600101906020018083116106ff57829003601f168201915b5050505050905090565b60006107318261110b565b61074e576040516333d1c03960e21b815260040160405180910390fd5b506000908152600760205260409020546001600160a01b031690565b6000610775826109d9565b9050336001600160a01b038216146107ae57610791813361102a565b6107ae576040516367d9dca160e11b815260040160405180910390fd5b60008281526007602052604080822080546001600160a01b0319166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b610812611140565b61081c338261119a565b50565b6daaeb6d7670e522a718067333cd4e3b156108cd57604051633185c44d60e21b81523060048201523360248201526daaeb6d7670e522a718067333cd4e9063c6171134906044016020604051808303816000875af1158015610885573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906108a99190611a1e565b6108cd57604051633b79c77360e21b81523360048201526024015b60405180910390fd5b6108d8838383611298565b505050565b6108e5611140565b60405133904780156108fc02916000818181858888f1935050505061090957600080fd5b565b6daaeb6d7670e522a718067333cd4e3b156109b457604051633185c44d60e21b81523060048201523360248201526daaeb6d7670e522a718067333cd4e9063c6171134906044016020604051808303816000875af1158015610971573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109959190611a1e565b6109b457604051633b79c77360e21b81523360048201526024016108c4565b6108d8838383611431565b6109c7611140565b600f55565b6109d4611140565b600b55565b600061068e8261144c565b600980546109f1906119e4565b80601f0160208091040260200160405190810160405280929190818152602001828054610a1d906119e4565b8015610a6a5780601f10610a3f57610100808354040283529160200191610a6a565b820191906000526020600020905b815481529060010190602001808311610a4d57829003601f168201915b505050505081565b60006001600160a01b038216610a9b576040516323d3ad8160e21b815260040160405180910390fd5b506001600160a01b031660009081526006602052604090205467ffffffffffffffff1690565b610ac9611140565b61090960006114c2565b6001600a5460ff166001811115610aec57610aec611973565b14610b315760405162461bcd60e51b8152602060048201526015602482015274283ab13634b19026b4b73a103737ba103634bb329760591b60448201526064016108c4565b6002546001546107d09183910360001901610b4c9190611a51565b1115610ba55760405162461bcd60e51b815260206004820152602260248201527f4d617820737570706c7920657863656564656420666f722066726565206d696e604482015261747360f01b60648201526084016108c4565b600e54336000908152600c6020526040902054610bc3908390611a51565b1115610be15760405162461bcd60e51b81526004016108c490611a64565b600f54336000908152600d6020526040902054610bff908390611a51565b1115610c1d5760405162461bcd60e51b81526004016108c490611a64565b336000908152600c602052604081208054839290610c3c908490611a51565b9091555050336000908152600d602052604081208054839290610c60908490611a51565b9091555061081c9050338261119a565b6001600160a01b0381166000908152600660205260408082205467ffffffffffffffff911c1661068e565b6060600480546106a3906119e4565b610cb2611140565b6009610cbe8282611ad0565b5050565b336001600160a01b03831603610ceb5760405163b06307db60e01b815260040160405180910390fd5b3360008181526008602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b6001600a5460ff166001811115610d7057610d70611973565b14610db55760405162461bcd60e51b8152602060048201526015602482015274283ab13634b19026b4b73a103737ba103634bb329760591b60448201526064016108c4565b6002546001546113889183910360001901610dd09190611a51565b1115610e2e5760405162461bcd60e51b815260206004820152602760248201527f4d617820737570706c7920657863656564656420666f72207075626c696320656044820152661e18d95959195960ca1b60648201526084016108c4565b80600b54610e3c9190611b90565b341015610e7e5760405162461bcd60e51b815260206004820152601060248201526f4e6f7420656e6f7567682066756e647360801b60448201526064016108c4565b600f54336000908152600d6020526040902054610e9c908390611a51565b1115610eba5760405162461bcd60e51b81526004016108c490611a64565b336000908152600d602052604081208054839290610c60908490611a51565b6daaeb6d7670e522a718067333cd4e3b15610f8257604051633185c44d60e21b81523060048201523360248201526daaeb6d7670e522a718067333cd4e9063c6171134906044016020604051808303816000875af1158015610f3f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f639190611a1e565b610f8257604051633b79c77360e21b81523360048201526024016108c4565b610f8e84848484611512565b50505050565b6060610f9f8261110b565b610feb5760405162461bcd60e51b815260206004820152601f60248201527f55524920717565727920666f72206e6f6e6578697374656e7420746f6b656e0060448201526064016108c4565b6009610ff683611556565b604051602001611007929190611ba7565b6040516020818303038152906040529050919050565b611025611140565b600e55565b6001600160a01b03918216600090815260086020908152604080832093909416825291909152205460ff1690565b611060611140565b6001600160a01b0381166110c55760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016108c4565b61081c816114c2565b6110d6611140565b8060018111156110e8576110e8611973565b600a805460ff19166001838181111561110357611103611973565b021790555050565b60008160011115801561111f575060015482105b801561068e575050600090815260056020526040902054600160e01b161590565b6000546001600160a01b031633146109095760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016108c4565b60015460008290036111bf5760405163b562e8dd60e01b815260040160405180910390fd5b6001600160a01b03831660008181526006602090815260408083208054680100000000000000018802019055848352600590915281206001851460e11b4260a01b178317905582840190839083907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a4600183015b81811461126e57808360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600080a4600101611236565b508160000361128f57604051622e076360e81b815260040160405180910390fd5b60015550505050565b60006112a38261144c565b9050836001600160a01b0316816001600160a01b0316146112d65760405162a1148160e81b815260040160405180910390fd5b60008281526007602052604090208054338082146001600160a01b0388169091141761132357611306863361102a565b61132357604051632ce44b5f60e11b815260040160405180910390fd5b6001600160a01b03851661134a57604051633a954ecd60e21b815260040160405180910390fd5b801561135557600082555b6001600160a01b038681166000908152600660205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260056020526040812091909155600160e11b841690036113e7576001840160008181526005602052604081205490036113e55760015481146113e55760008181526005602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a45b505050505050565b6108d883838360405180602001604052806000815250610ed9565b600081806001116114a9576001548110156114a95760008181526005602052604081205490600160e01b821690036114a7575b806000036114a057506000190160008181526005602052604090205461147f565b9392505050565b505b604051636f96cda160e11b815260040160405180910390fd5b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b61151d84848461081f565b6001600160a01b0383163b15610f8e57611539848484846115a5565b610f8e576040516368d2bf6b60e11b815260040160405180910390fd5b604080516080810191829052607f0190826030600a8206018353600a90045b801561159357600183039250600a81066030018353600a9004611575565b50819003601f19909101908152919050565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a02906115da903390899088908890600401611c3e565b6020604051808303816000875af1925050508015611615575060408051601f3d908101601f1916820190925261161291810190611c7b565b60015b611673573d808015611643576040519150601f19603f3d011682016040523d82523d6000602084013e611648565b606091505b50805160000361166b576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b1490505b949350505050565b6001600160e01b03198116811461081c57600080fd5b6000602082840312156116b957600080fd5b81356114a081611691565b60005b838110156116df5781810151838201526020016116c7565b50506000910152565b600081518084526117008160208601602086016116c4565b601f01601f19169290920160200192915050565b6020815260006114a060208301846116e8565b60006020828403121561173957600080fd5b5035919050565b80356001600160a01b038116811461175757600080fd5b919050565b6000806040838503121561176f57600080fd5b61177883611740565b946020939093013593505050565b60006020828403121561179857600080fd5b6114a082611740565b6000806000606084860312156117b657600080fd5b6117bf84611740565b92506117cd60208501611740565b9150604084013590509250925092565b634e487b7160e01b600052604160045260246000fd5b600067ffffffffffffffff8084111561180e5761180e6117dd565b604051601f8501601f19908116603f01168101908282118183101715611836576118366117dd565b8160405280935085815286868601111561184f57600080fd5b858560208301376000602087830101525050509392505050565b60006020828403121561187b57600080fd5b813567ffffffffffffffff81111561189257600080fd5b8201601f810184136118a357600080fd5b611689848235602084016117f3565b801515811461081c57600080fd5b600080604083850312156118d357600080fd5b6118dc83611740565b915060208301356118ec816118b2565b809150509250929050565b6000806000806080858703121561190d57600080fd5b61191685611740565b935061192460208601611740565b925060408501359150606085013567ffffffffffffffff81111561194757600080fd5b8501601f8101871361195857600080fd5b611967878235602084016117f3565b91505092959194509250565b634e487b7160e01b600052602160045260246000fd5b60208101600283106119ab57634e487b7160e01b600052602160045260246000fd5b91905290565b600080604083850312156119c457600080fd5b6119cd83611740565b91506119db60208401611740565b90509250929050565b600181811c908216806119f857607f821691505b602082108103611a1857634e487b7160e01b600052602260045260246000fd5b50919050565b600060208284031215611a3057600080fd5b81516114a0816118b2565b634e487b7160e01b600052601160045260246000fd5b8082018082111561068e5761068e611a3b565b6020808252600c908201526b13585e08195e18d95959195960a21b604082015260600190565b601f8211156108d857600081815260208120601f850160051c81016020861015611ab15750805b601f850160051c820191505b8181101561142957828155600101611abd565b815167ffffffffffffffff811115611aea57611aea6117dd565b611afe81611af884546119e4565b84611a8a565b602080601f831160018114611b335760008415611b1b5750858301515b600019600386901b1c1916600185901b178555611429565b600085815260208120601f198616915b82811015611b6257888601518255948401946001909101908401611b43565b5085821015611b805787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b808202811582820484141761068e5761068e611a3b565b6000808454611bb5816119e4565b60018281168015611bcd5760018114611be257611c11565b60ff1984168752821515830287019450611c11565b8860005260208060002060005b85811015611c085781548a820152908401908201611bef565b50505082870194505b505050508351611c258183602088016116c4565b64173539b7b760d91b9101908152600501949350505050565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090611c71908301846116e8565b9695505050505050565b600060208284031215611c8d57600080fd5b81516114a08161169156fea26469706673582212207d61bef3ebaec5054bac6732564a395337218d321749eddb476106720c79f37564736f6c6343000813003300000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000007697066733a2f2f00000000000000000000000000000000000000000000000000

0x6080604052600436106101f95760003560e01c8063715018a61161010d578063a22cb465116100a0578063cbccefb21161006f578063cbccefb21461059b578063d755bf99146105c2578063e985e9c5146105e2578063f2fde38b14610602578063f8dcbddb1461062257600080fd5b8063a22cb46514610528578063b3ab66b014610548578063b88d4fde1461055b578063c87b56dd1461057b57600080fd5b80638da5cb5b116100dc5780638da5cb5b146104bf57806395d89b41146104dd5780639b6860c8146104f2578063a0bcfc7f1461050857600080fd5b8063715018a6146104545780637c928fe9146104695780637dc42975146104895780638a59a7fd1461049f57600080fd5b806323b872dd1161019057806349e949e71161015f57806349e949e7146103bf5780634fda7285146103df5780636352211e146103ff5780636c0360eb1461041f57806370a082311461043457600080fd5b806323b872dd146103545780633ccfd60b1461037457806342842e0e14610389578063485a68a3146103a957600080fd5b8063145f798f116101cc578063145f798f146102af57806318160ddd146102ea5780631872d83c14610307578063209848011461032757600080fd5b806301ffc9a7146101fe57806306fdde0314610233578063081812fc14610255578063095ea7b31461028d575b600080fd5b34801561020a57600080fd5b5061021e6102193660046116a7565b610642565b60405190151581526020015b60405180910390f35b34801561023f57600080fd5b50610248610694565b60405161022a9190611714565b34801561026157600080fd5b50610275610270366004611727565b610726565b6040516001600160a01b03909116815260200161022a565b34801561029957600080fd5b506102ad6102a836600461175c565b61076a565b005b3480156102bb57600080fd5b506102dc6102ca366004611786565b600d6020526000908152604090205481565b60405190815260200161022a565b3480156102f657600080fd5b5060025460015403600019016102dc565b34801561031357600080fd5b506102ad610322366004611727565b61080a565b34801561033357600080fd5b506102dc610342366004611786565b600c6020526000908152604090205481565b34801561036057600080fd5b506102ad61036f3660046117a1565b61081f565b34801561038057600080fd5b506102ad6108dd565b34801561039557600080fd5b506102ad6103a43660046117a1565b61090b565b3480156103b557600080fd5b506102dc600e5481565b3480156103cb57600080fd5b506102ad6103da366004611727565b6109bf565b3480156103eb57600080fd5b506102ad6103fa366004611727565b6109cc565b34801561040b57600080fd5b5061027561041a366004611727565b6109d9565b34801561042b57600080fd5b506102486109e4565b34801561044057600080fd5b506102dc61044f366004611786565b610a72565b34801561046057600080fd5b506102ad610ac1565b34801561047557600080fd5b506102ad610484366004611727565b610ad3565b34801561049557600080fd5b506102dc600f5481565b3480156104ab57600080fd5b506102dc6104ba366004611786565b610c70565b3480156104cb57600080fd5b506000546001600160a01b0316610275565b3480156104e957600080fd5b50610248610c9b565b3480156104fe57600080fd5b506102dc600b5481565b34801561051457600080fd5b506102ad610523366004611869565b610caa565b34801561053457600080fd5b506102ad6105433660046118c0565b610cc2565b6102ad610556366004611727565b610d57565b34801561056757600080fd5b506102ad6105763660046118f7565b610ed9565b34801561058757600080fd5b50610248610596366004611727565b610f94565b3480156105a757600080fd5b50600a546105b59060ff1681565b60405161022a9190611989565b3480156105ce57600080fd5b506102ad6105dd366004611727565b61101d565b3480156105ee57600080fd5b5061021e6105fd3660046119b1565b61102a565b34801561060e57600080fd5b506102ad61061d366004611786565b611058565b34801561062e57600080fd5b506102ad61063d366004611727565b6110ce565b60006301ffc9a760e01b6001600160e01b03198316148061067357506380ac58cd60e01b6001600160e01b03198316145b8061068e5750635b5e139f60e01b6001600160e01b03198316145b92915050565b6060600380546106a3906119e4565b80601f01602080910402602001604051908101604052809291908181526020018280546106cf906119e4565b801561071c5780601f106106f15761010080835404028352916020019161071c565b820191906000526020600020905b8154815290600101906020018083116106ff57829003601f168201915b5050505050905090565b60006107318261110b565b61074e576040516333d1c03960e21b815260040160405180910390fd5b506000908152600760205260409020546001600160a01b031690565b6000610775826109d9565b9050336001600160a01b038216146107ae57610791813361102a565b6107ae576040516367d9dca160e11b815260040160405180910390fd5b60008281526007602052604080822080546001600160a01b0319166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b610812611140565b61081c338261119a565b50565b6daaeb6d7670e522a718067333cd4e3b156108cd57604051633185c44d60e21b81523060048201523360248201526daaeb6d7670e522a718067333cd4e9063c6171134906044016020604051808303816000875af1158015610885573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906108a99190611a1e565b6108cd57604051633b79c77360e21b81523360048201526024015b60405180910390fd5b6108d8838383611298565b505050565b6108e5611140565b60405133904780156108fc02916000818181858888f1935050505061090957600080fd5b565b6daaeb6d7670e522a718067333cd4e3b156109b457604051633185c44d60e21b81523060048201523360248201526daaeb6d7670e522a718067333cd4e9063c6171134906044016020604051808303816000875af1158015610971573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109959190611a1e565b6109b457604051633b79c77360e21b81523360048201526024016108c4565b6108d8838383611431565b6109c7611140565b600f55565b6109d4611140565b600b55565b600061068e8261144c565b600980546109f1906119e4565b80601f0160208091040260200160405190810160405280929190818152602001828054610a1d906119e4565b8015610a6a5780601f10610a3f57610100808354040283529160200191610a6a565b820191906000526020600020905b815481529060010190602001808311610a4d57829003601f168201915b505050505081565b60006001600160a01b038216610a9b576040516323d3ad8160e21b815260040160405180910390fd5b506001600160a01b031660009081526006602052604090205467ffffffffffffffff1690565b610ac9611140565b61090960006114c2565b6001600a5460ff166001811115610aec57610aec611973565b14610b315760405162461bcd60e51b8152602060048201526015602482015274283ab13634b19026b4b73a103737ba103634bb329760591b60448201526064016108c4565b6002546001546107d09183910360001901610b4c9190611a51565b1115610ba55760405162461bcd60e51b815260206004820152602260248201527f4d617820737570706c7920657863656564656420666f722066726565206d696e604482015261747360f01b60648201526084016108c4565b600e54336000908152600c6020526040902054610bc3908390611a51565b1115610be15760405162461bcd60e51b81526004016108c490611a64565b600f54336000908152600d6020526040902054610bff908390611a51565b1115610c1d5760405162461bcd60e51b81526004016108c490611a64565b336000908152600c602052604081208054839290610c3c908490611a51565b9091555050336000908152600d602052604081208054839290610c60908490611a51565b9091555061081c9050338261119a565b6001600160a01b0381166000908152600660205260408082205467ffffffffffffffff911c1661068e565b6060600480546106a3906119e4565b610cb2611140565b6009610cbe8282611ad0565b5050565b336001600160a01b03831603610ceb5760405163b06307db60e01b815260040160405180910390fd5b3360008181526008602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b6001600a5460ff166001811115610d7057610d70611973565b14610db55760405162461bcd60e51b8152602060048201526015602482015274283ab13634b19026b4b73a103737ba103634bb329760591b60448201526064016108c4565b6002546001546113889183910360001901610dd09190611a51565b1115610e2e5760405162461bcd60e51b815260206004820152602760248201527f4d617820737570706c7920657863656564656420666f72207075626c696320656044820152661e18d95959195960ca1b60648201526084016108c4565b80600b54610e3c9190611b90565b341015610e7e5760405162461bcd60e51b815260206004820152601060248201526f4e6f7420656e6f7567682066756e647360801b60448201526064016108c4565b600f54336000908152600d6020526040902054610e9c908390611a51565b1115610eba5760405162461bcd60e51b81526004016108c490611a64565b336000908152600d602052604081208054839290610c60908490611a51565b6daaeb6d7670e522a718067333cd4e3b15610f8257604051633185c44d60e21b81523060048201523360248201526daaeb6d7670e522a718067333cd4e9063c6171134906044016020604051808303816000875af1158015610f3f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f639190611a1e565b610f8257604051633b79c77360e21b81523360048201526024016108c4565b610f8e84848484611512565b50505050565b6060610f9f8261110b565b610feb5760405162461bcd60e51b815260206004820152601f60248201527f55524920717565727920666f72206e6f6e6578697374656e7420746f6b656e0060448201526064016108c4565b6009610ff683611556565b604051602001611007929190611ba7565b6040516020818303038152906040529050919050565b611025611140565b600e55565b6001600160a01b03918216600090815260086020908152604080832093909416825291909152205460ff1690565b611060611140565b6001600160a01b0381166110c55760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016108c4565b61081c816114c2565b6110d6611140565b8060018111156110e8576110e8611973565b600a805460ff19166001838181111561110357611103611973565b021790555050565b60008160011115801561111f575060015482105b801561068e575050600090815260056020526040902054600160e01b161590565b6000546001600160a01b031633146109095760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016108c4565b60015460008290036111bf5760405163b562e8dd60e01b815260040160405180910390fd5b6001600160a01b03831660008181526006602090815260408083208054680100000000000000018802019055848352600590915281206001851460e11b4260a01b178317905582840190839083907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a4600183015b81811461126e57808360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600080a4600101611236565b508160000361128f57604051622e076360e81b815260040160405180910390fd5b60015550505050565b60006112a38261144c565b9050836001600160a01b0316816001600160a01b0316146112d65760405162a1148160e81b815260040160405180910390fd5b60008281526007602052604090208054338082146001600160a01b0388169091141761132357611306863361102a565b61132357604051632ce44b5f60e11b815260040160405180910390fd5b6001600160a01b03851661134a57604051633a954ecd60e21b815260040160405180910390fd5b801561135557600082555b6001600160a01b038681166000908152600660205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260056020526040812091909155600160e11b841690036113e7576001840160008181526005602052604081205490036113e55760015481146113e55760008181526005602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a45b505050505050565b6108d883838360405180602001604052806000815250610ed9565b600081806001116114a9576001548110156114a95760008181526005602052604081205490600160e01b821690036114a7575b806000036114a057506000190160008181526005602052604090205461147f565b9392505050565b505b604051636f96cda160e11b815260040160405180910390fd5b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b61151d84848461081f565b6001600160a01b0383163b15610f8e57611539848484846115a5565b610f8e576040516368d2bf6b60e11b815260040160405180910390fd5b604080516080810191829052607f0190826030600a8206018353600a90045b801561159357600183039250600a81066030018353600a9004611575565b50819003601f19909101908152919050565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a02906115da903390899088908890600401611c3e565b6020604051808303816000875af1925050508015611615575060408051601f3d908101601f1916820190925261161291810190611c7b565b60015b611673573d808015611643576040519150601f19603f3d011682016040523d82523d6000602084013e611648565b606091505b50805160000361166b576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b1490505b949350505050565b6001600160e01b03198116811461081c57600080fd5b6000602082840312156116b957600080fd5b81356114a081611691565b60005b838110156116df5781810151838201526020016116c7565b50506000910152565b600081518084526117008160208601602086016116c4565b601f01601f19169290920160200192915050565b6020815260006114a060208301846116e8565b60006020828403121561173957600080fd5b5035919050565b80356001600160a01b038116811461175757600080fd5b919050565b6000806040838503121561176f57600080fd5b61177883611740565b946020939093013593505050565b60006020828403121561179857600080fd5b6114a082611740565b6000806000606084860312156117b657600080fd5b6117bf84611740565b92506117cd60208501611740565b9150604084013590509250925092565b634e487b7160e01b600052604160045260246000fd5b600067ffffffffffffffff8084111561180e5761180e6117dd565b604051601f8501601f19908116603f01168101908282118183101715611836576118366117dd565b8160405280935085815286868601111561184f57600080fd5b858560208301376000602087830101525050509392505050565b60006020828403121561187b57600080fd5b813567ffffffffffffffff81111561189257600080fd5b8201601f810184136118a357600080fd5b611689848235602084016117f3565b801515811461081c57600080fd5b600080604083850312156118d357600080fd5b6118dc83611740565b915060208301356118ec816118b2565b809150509250929050565b6000806000806080858703121561190d57600080fd5b61191685611740565b935061192460208601611740565b925060408501359150606085013567ffffffffffffffff81111561194757600080fd5b8501601f8101871361195857600080fd5b611967878235602084016117f3565b91505092959194509250565b634e487b7160e01b600052602160045260246000fd5b60208101600283106119ab57634e487b7160e01b600052602160045260246000fd5b91905290565b600080604083850312156119c457600080fd5b6119cd83611740565b91506119db60208401611740565b90509250929050565b600181811c908216806119f857607f821691505b602082108103611a1857634e487b7160e01b600052602260045260246000fd5b50919050565b600060208284031215611a3057600080fd5b81516114a0816118b2565b634e487b7160e01b600052601160045260246000fd5b8082018082111561068e5761068e611a3b565b6020808252600c908201526b13585e08195e18d95959195960a21b604082015260600190565b601f8211156108d857600081815260208120601f850160051c81016020861015611ab15750805b601f850160051c820191505b8181101561142957828155600101611abd565b815167ffffffffffffffff811115611aea57611aea6117dd565b611afe81611af884546119e4565b84611a8a565b602080601f831160018114611b335760008415611b1b5750858301515b600019600386901b1c1916600185901b178555611429565b600085815260208120601f198616915b82811015611b6257888601518255948401946001909101908401611b43565b5085821015611b805787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b808202811582820484141761068e5761068e611a3b565b6000808454611bb5816119e4565b60018281168015611bcd5760018114611be257611c11565b60ff1984168752821515830287019450611c11565b8860005260208060002060005b85811015611c085781548a820152908401908201611bef565b50505082870194505b505050508351611c258183602088016116c4565b64173539b7b760d91b9101908152600501949350505050565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090611c71908301846116e8565b9695505050505050565b600060208284031215611c8d57600080fd5b81516114a08161169156fea26469706673582212207d61bef3ebaec5054bac6732564a395337218d321749eddb476106720c79f37564736f6c63430008130033

00000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000007697066733a2f2f00000000000000000000000000000000000000000000000000

-----Decoded View---------------
Arg [0] : _baseURI (string): ipfs://

-----Encoded View---------------
3 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000020
Arg [1] : 0000000000000000000000000000000000000000000000000000000000000007
Arg [2] : 697066733a2f2f00000000000000000000000000000000000000000000000000

64082:3386:1:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;31270:639;;;;;;;;;;-1:-1:-1;31270:639:1;;;;;:::i;:::-;;:::i;:::-;;;565:14:6;;558:22;540:41;;528:2;513:18;31270:639:1;;;;;;;;32172:100;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;38655:218::-;;;;;;;;;;-1:-1:-1;38655:218:1;;;;;:::i;:::-;;:::i;:::-;;;-1:-1:-1;;;;;1697:32:6;;;1679:51;;1667:2;1652:18;38655:218:1;1533:203:6;38096:400:1;;;;;;;;;;-1:-1:-1;38096:400:1;;;;;:::i;:::-;;:::i;:::-;;64462:43;;;;;;;;;;-1:-1:-1;64462:43:1;;;;;:::i;:::-;;;;;;;;;;;;;;;;;2515:25:6;;;2503:2;2488:18;64462:43:1;2369:177:6;27923:323:1;;;;;;;;;;-1:-1:-1;28197:12:1;;27522:1;28181:13;:28;-1:-1:-1;;28181:46:1;27923:323;;64699:103;;;;;;;;;;-1:-1:-1;64699:103:1;;;;;:::i;:::-;;:::i;64413:42::-;;;;;;;;;;-1:-1:-1;64413:42:1;;;;;:::i;:::-;;;;;;;;;;;;;;65842:166;;;;;;;;;;-1:-1:-1;65842:166:1;;;;;:::i;:::-;;:::i;67351:114::-;;;;;;;;;;;;;:::i;66016:174::-;;;;;;;;;;-1:-1:-1;66016:174:1;;;;;:::i;:::-;;:::i;64514:23::-;;;;;;;;;;;;;;;;66861:97;;;;;;;;;;-1:-1:-1;66861:97:1;;;;;:::i;:::-;;:::i;66437:114::-;;;;;;;;;;-1:-1:-1;66437:114:1;;;;;:::i;:::-;;:::i;33565:152::-;;;;;;;;;;-1:-1:-1;33565:152:1;;;;;:::i;:::-;;:::i;64250:21::-;;;;;;;;;;;;;:::i;29107:233::-;;;;;;;;;;-1:-1:-1;29107:233:1;;;;;:::i;:::-;;:::i;21227:103::-;;;;;;;;;;;;;:::i;64810:519::-;;;;;;;;;;-1:-1:-1;64810:519:1;;;;;:::i;:::-;;:::i;64545:26::-;;;;;;;;;;;;;;;;66966:122;;;;;;;;;;-1:-1:-1;66966:122:1;;;;;:::i;:::-;;:::i;20579:87::-;;;;;;;;;;-1:-1:-1;20625:7:1;20652:6;-1:-1:-1;;;;;20652:6:1;20579:87;;32348:104;;;;;;;;;;;;;:::i;64360:44::-;;;;;;;;;;;;;;;;66559:100;;;;;;;;;;-1:-1:-1;66559:100:1;;;;;:::i;:::-;;:::i;39213:308::-;;;;;;;;;;-1:-1:-1;39213:308:1;;;;;:::i;:::-;;:::i;65337:497::-;;;;;;:::i;:::-;;:::i;66198:231::-;;;;;;;;;;-1:-1:-1;66198:231:1;;;;;:::i;:::-;;:::i;67096:247::-;;;;;;;;;;-1:-1:-1;67096:247:1;;;;;:::i;:::-;;:::i;64280:23::-;;;;;;;;;;-1:-1:-1;64280:23:1;;;;;;;;;;;;;;;:::i;66767:86::-;;;;;;;;;;-1:-1:-1;66767:86:1;;;;;:::i;:::-;;:::i;39678:164::-;;;;;;;;;;-1:-1:-1;39678:164:1;;;;;:::i;:::-;;:::i;21485:201::-;;;;;;;;;;-1:-1:-1;21485:201:1;;;;;:::i;:::-;;:::i;66667:92::-;;;;;;;;;;-1:-1:-1;66667:92:1;;;;;:::i;:::-;;:::i;31270:639::-;31355:4;-1:-1:-1;;;;;;;;;31679:25:1;;;;:102;;-1:-1:-1;;;;;;;;;;31756:25:1;;;31679:102;:179;;;-1:-1:-1;;;;;;;;;;31833:25:1;;;31679:179;31659:199;31270:639;-1:-1:-1;;31270:639:1:o;32172:100::-;32226:13;32259:5;32252:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;32172:100;:::o;38655:218::-;38731:7;38756:16;38764:7;38756;:16::i;:::-;38751:64;;38781:34;;-1:-1:-1;;;38781:34:1;;;;;;;;;;;38751:64;-1:-1:-1;38835:24:1;;;;:15;:24;;;;;:30;-1:-1:-1;;;;;38835:30:1;;38655:218::o;38096:400::-;38177:13;38193:16;38201:7;38193;:16::i;:::-;38177:32;-1:-1:-1;61953:10:1;-1:-1:-1;;;;;38226:28:1;;;38222:175;;38274:44;38291:5;61953:10;39678:164;:::i;38274:44::-;38269:128;;38346:35;;-1:-1:-1;;;38346:35:1;;;;;;;;;;;38269:128;38409:24;;;;:15;:24;;;;;;:35;;-1:-1:-1;;;;;;38409:35:1;-1:-1:-1;;;;;38409:35:1;;;;;;;;;38460:28;;38409:24;;38460:28;;;;;;;38166:330;38096:400;;:::o;64699:103::-;20465:13;:11;:13::i;:::-;64767:27:::1;64773:10;64785:8;64767:5;:27::i;:::-;64699:103:::0;:::o;65842:166::-;310:42:5;1438:43;:47;1434:225;;1507:67;;-1:-1:-1;;;1507:67:5;;1556:4;1507:67;;;6560:34:6;1563:10:5;6610:18:6;;;6603:43;310:42:5;;1507:40;;6495:18:6;;1507:67:5;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;1502:146;;1602:30;;-1:-1:-1;;;1602:30:5;;1621:10;1602:30;;;1679:51:6;1652:18;;1602:30:5;;;;;;;;1502:146;65963:37:1::1;65982:4;65988:2;65992:7;65963:18;:37::i;:::-;65842:166:::0;;;:::o;67351:114::-;20465:13;:11;:13::i;:::-;67409:47:::1;::::0;67417:10:::1;::::0;67434:21:::1;67409:47:::0;::::1;;;::::0;::::1;::::0;;;67434:21;67417:10;67409:47;::::1;;;;;;67401:56;;;::::0;::::1;;67351:114::o:0;66016:174::-;310:42:5;1438:43;:47;1434:225;;1507:67;;-1:-1:-1;;;1507:67:5;;1556:4;1507:67;;;6560:34:6;1563:10:5;6610:18:6;;;6603:43;310:42:5;;1507:40;;6495:18:6;;1507:67:5;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;1502:146;;1602:30;;-1:-1:-1;;;1602:30:5;;1621:10;1602:30;;;1679:51:6;1652:18;;1602:30:5;1533:203:6;1502:146:5;66141:41:1::1;66164:4;66170:2;66174:7;66141:22;:41::i;66861:97::-:0;20465:13;:11;:13::i;:::-;66932:9:::1;:18:::0;66861:97::o;66437:114::-;20465:13;:11;:13::i;:::-;66516:15:::1;:27:::0;66437:114::o;33565:152::-;33637:7;33680:27;33699:7;33680:18;:27::i;64250:21::-;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::o;29107:233::-;29179:7;-1:-1:-1;;;;;29203:19:1;;29199:60;;29231:28;;-1:-1:-1;;;29231:28:1;;;;;;;;;;;29199:60;-1:-1:-1;;;;;;29277:25:1;;;;;:18;:25;;;;;;23266:13;29277:55;;29107:233::o;21227:103::-;20465:13;:11;:13::i;:::-;21292:30:::1;21319:1;21292:18;:30::i;64810:519::-:0;64882:15;64867:11;;;;;:30;;;;;;;:::i;:::-;;64864:66;;64899:31;;-1:-1:-1;;;64899:31:1;;7109:2:6;64899:31:1;;;7091:21:6;7148:2;7128:18;;;7121:30;-1:-1:-1;;;7167:18:6;;;7160:51;7228:18;;64899:31:1;6907:345:6;64864:66:1;28197:12;;27522:1;28181:13;64972:4;;64960:9;;28181:28;-1:-1:-1;;28181:46:1;64944:25;;;;:::i;:::-;:32;64941:81;;;64978:44;;-1:-1:-1;;;64978:44:1;;7721:2:6;64978:44:1;;;7703:21:6;7760:2;7740:18;;;7733:30;7799:34;7779:18;;;7772:62;-1:-1:-1;;;7850:18:6;;;7843:32;7892:19;;64978:44:1;7519:398:6;64941:81:1;65073:7;;65047:10;65036:22;;;;:10;:22;;;;;;:34;;65061:9;;65036:34;:::i;:::-;:44;65033:71;;;65082:22;;-1:-1:-1;;;65082:22:1;;;;;;;:::i;65033:71::-;65156:9;;65130:10;65118:23;;;;:11;:23;;;;;;:35;;65144:9;;65118:35;:::i;:::-;:47;65115:74;;;65167:22;;-1:-1:-1;;;65167:22:1;;;;;;;:::i;65115:74::-;65211:10;65200:22;;;;:10;:22;;;;;:35;;65226:9;;65200:22;:35;;65226:9;;65200:35;:::i;:::-;;;;-1:-1:-1;;65258:10:1;65246:23;;;;:11;:23;;;;;:36;;65273:9;;65246:23;:36;;65273:9;;65246:36;:::i;:::-;;;;-1:-1:-1;65293:28:1;;-1:-1:-1;65299:10:1;65311:9;65293:5;:28::i;66966:122::-;-1:-1:-1;;;;;29511:25:1;;67031:7;29511:25;;;:18;:25;;23404:2;29511:25;;;;23266:13;29511:50;;29510:82;67058:22;29422:178;32348:104;32404:13;32437:7;32430:14;;;;;:::i;66559:100::-;20465:13;:11;:13::i;:::-;66633:7:::1;:18;66643:8:::0;66633:7;:18:::1;:::i;:::-;;66559:100:::0;:::o;39213:308::-;61953:10;-1:-1:-1;;;;;39312:31:1;;;39308:61;;39352:17;;-1:-1:-1;;;39352:17:1;;;;;;;;;;;39308:61;61953:10;39382:39;;;;:18;:39;;;;;;;;-1:-1:-1;;;;;39382:49:1;;;;;;;;;;;;:60;;-1:-1:-1;;39382:60:1;;;;;;;;;;39458:55;;540:41:6;;;39382:49:1;;61953:10;39458:55;;513:18:6;39458:55:1;;;;;;;39213:308;;:::o;65337:497::-;65423:15;65408:11;;;;;:30;;;;;;;:::i;:::-;;65405:66;;65440:31;;-1:-1:-1;;;65440:31:1;;7109:2:6;65440:31:1;;;7091:21:6;7148:2;7128:18;;;7121:30;-1:-1:-1;;;7167:18:6;;;7160:51;7228:18;;65440:31:1;6907:345:6;65405:66:1;28197:12;;27522:1;28181:13;64347:4;;65501:9;;28181:28;-1:-1:-1;;28181:46:1;65485:25;;;;:::i;:::-;:38;65482:92;;;65525:49;;-1:-1:-1;;;65525:49:1;;10669:2:6;65525:49:1;;;10651:21:6;10708:2;10688:18;;;10681:30;10747:34;10727:18;;;10720:62;-1:-1:-1;;;10798:18:6;;;10791:37;10845:19;;65525:49:1;10467:403:6;65482:92:1;65618:9;65600:15;;:27;;;;:::i;:::-;65588:9;:39;65585:70;;;65629:26;;-1:-1:-1;;;65629:26:1;;11250:2:6;65629:26:1;;;11232:21:6;11289:2;11269:18;;;11262:30;-1:-1:-1;;;11308:18:6;;;11301:46;11364:18;;65629:26:1;11048:340:6;65585:70:1;65707:9;;65681:10;65669:23;;;;:11;:23;;;;;;:35;;65695:9;;65669:35;:::i;:::-;:47;65666:74;;;65718:22;;-1:-1:-1;;;65718:22:1;;;;;;;:::i;65666:74::-;65763:10;65751:23;;;;:11;:23;;;;;:36;;65778:9;;65751:23;:36;;65778:9;;65751:36;:::i;66198:231::-;310:42:5;1438:43;:47;1434:225;;1507:67;;-1:-1:-1;;;1507:67:5;;1556:4;1507:67;;;6560:34:6;1563:10:5;6610:18:6;;;6603:43;310:42:5;;1507:40;;6495:18:6;;1507:67:5;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;1502:146;;1602:30;;-1:-1:-1;;;1602:30:5;;1621:10;1602:30;;;1679:51:6;1652:18;;1602:30:5;1533:203:6;1502:146:5;66374:47:1::1;66397:4;66403:2;66407:7;66416:4;66374:22;:47::i;:::-;66198:231:::0;;;;:::o;67096:247::-;67167:13;67201:17;67209:8;67201:7;:17::i;:::-;67193:61;;;;-1:-1:-1;;;67193:61:1;;11595:2:6;67193:61:1;;;11577:21:6;11634:2;11614:18;;;11607:30;11673:33;11653:18;;;11646:61;11724:18;;67193:61:1;11393:355:6;67193:61:1;67296:7;67305:19;67315:8;67305:9;:19::i;:::-;67279:55;;;;;;;;;:::i;:::-;;;;;;;;;;;;;67265:70;;67096:247;;;:::o;66767:86::-;20465:13;:11;:13::i;:::-;66829:7:::1;:16:::0;66767:86::o;39678:164::-;-1:-1:-1;;;;;39799:25:1;;;39775:4;39799:25;;;:18;:25;;;;;;;;:35;;;;;;;;;;;;;;;39678:164::o;21485:201::-;20465:13;:11;:13::i;:::-;-1:-1:-1;;;;;21574:22:1;::::1;21566:73;;;::::0;-1:-1:-1;;;21566:73:1;;13147:2:6;21566:73:1::1;::::0;::::1;13129:21:6::0;13186:2;13166:18;;;13159:30;13225:34;13205:18;;;13198:62;-1:-1:-1;;;13276:18:6;;;13269:36;13322:19;;21566:73:1::1;12945:402:6::0;21566:73:1::1;21650:28;21669:8;21650:18;:28::i;66667:92::-:0;20465:13;:11;:13::i;:::-;66745:5:::1;66740:11;;;;;;;;:::i;:::-;66726;:25:::0;;-1:-1:-1;;66726:25:1::1;::::0;;;;::::1;;;;;;:::i;:::-;;;;;;66667:92:::0;:::o;40100:282::-;40165:4;40221:7;27522:1;40202:26;;:66;;;;;40255:13;;40245:7;:23;40202:66;:153;;;;-1:-1:-1;;40306:26:1;;;;:17;:26;;;;;;-1:-1:-1;;;40306:44:1;:49;;40100:282::o;20744:132::-;20625:7;20652:6;-1:-1:-1;;;;;20652:6:1;61953:10;20808:23;20800:68;;;;-1:-1:-1;;;20800:68:1;;13554:2:6;20800:68:1;;;13536:21:6;;;13573:18;;;13566:30;13632:34;13612:18;;;13605:62;13684:18;;20800:68:1;13352:356:6;49719:2454:1;49815:13;;49792:20;49843:13;;;49839:44;;49865:18;;-1:-1:-1;;;49865:18:1;;;;;;;;;;;49839:44;-1:-1:-1;;;;;50371:22:1;;;;;;:18;:22;;;;23404:2;50371:22;;;:71;;50409:32;50397:45;;50371:71;;;50685:31;;;:17;:31;;;;;-1:-1:-1;37385:15:1;;37359:24;37355:46;36954:11;36929:23;36925:41;36922:52;36912:63;;50685:173;;50920:23;;;;50685:31;;50371:22;;51419:25;50371:22;;51272:335;51687:1;51673:12;51669:20;51627:346;51728:3;51719:7;51716:16;51627:346;;51946:7;51936:8;51933:1;51906:25;51903:1;51900;51895:59;51781:1;51768:15;51627:346;;;51631:77;52006:8;52018:1;52006:13;52002:45;;52028:19;;-1:-1:-1;;;52028:19:1;;;;;;;;;;;52002:45;52064:13;:19;-1:-1:-1;65842:166:1;;;:::o;42362:2817::-;42496:27;42526;42545:7;42526:18;:27::i;:::-;42496:57;;42611:4;-1:-1:-1;;;;;42570:45:1;42586:19;-1:-1:-1;;;;;42570:45:1;;42566:86;;42624:28;;-1:-1:-1;;;42624:28:1;;;;;;;;;;;42566:86;42666:27;41476:24;;;:15;:24;;;;;41698:26;;61953:10;41101:30;;;-1:-1:-1;;;;;40794:28:1;;41079:20;;;41076:56;42852:180;;42945:43;42962:4;61953:10;39678:164;:::i;42945:43::-;42940:92;;42997:35;;-1:-1:-1;;;42997:35:1;;;;;;;;;;;42940:92;-1:-1:-1;;;;;43049:16:1;;43045:52;;43074:23;;-1:-1:-1;;;43074:23:1;;;;;;;;;;;43045:52;43246:15;43243:160;;;43386:1;43365:19;43358:30;43243:160;-1:-1:-1;;;;;43783:24:1;;;;;;;:18;:24;;;;;;43781:26;;-1:-1:-1;;43781:26:1;;;43852:22;;;;;;;;;43850:24;;-1:-1:-1;43850:24:1;;;36954:11;36929:23;36925:41;36912:63;-1:-1:-1;;;36912:63:1;44145:26;;;;:17;:26;;;;;:175;;;;-1:-1:-1;;;44440:47:1;;:52;;44436:627;;44545:1;44535:11;;44513:19;44668:30;;;:17;:30;;;;;;:35;;44664:384;;44806:13;;44791:11;:28;44787:242;;44953:30;;;;:17;:30;;;;;:52;;;44787:242;44494:569;44436:627;45110:7;45106:2;-1:-1:-1;;;;;45091:27:1;45100:4;-1:-1:-1;;;;;45091:27:1;;;;;;;;;;;45129:42;42485:2694;;;42362:2817;;;:::o;45275:185::-;45413:39;45430:4;45436:2;45440:7;45413:39;;;;;;;;;;;;:16;:39::i;34720:1275::-;34787:7;34822;;27522:1;34871:23;34867:1061;;34924:13;;34917:4;:20;34913:1015;;;34962:14;34979:23;;;:17;:23;;;;;;;-1:-1:-1;;;35068:24:1;;:29;;35064:845;;35733:113;35740:6;35750:1;35740:11;35733:113;;-1:-1:-1;;;35811:6:1;35793:25;;;;:17;:25;;;;;;35733:113;;;35879:6;34720:1275;-1:-1:-1;;;34720:1275:1:o;35064:845::-;34939:989;34913:1015;35956:31;;-1:-1:-1;;;35956:31:1;;;;;;;;;;;21846:191;21920:16;21939:6;;-1:-1:-1;;;;;21956:17:1;;;-1:-1:-1;;;;;;21956:17:1;;;;;;21989:40;;21939:6;;;;;;;21989:40;;21920:16;21989:40;21909:128;21846:191;:::o;46058:399::-;46225:31;46238:4;46244:2;46248:7;46225:12;:31::i;:::-;-1:-1:-1;;;;;46271:14:1;;;:19;46267:183;;46310:56;46341:4;46347:2;46351:7;46360:5;46310:30;:56::i;:::-;46305:145;;46394:40;;-1:-1:-1;;;46394:40:1;;;;;;;;;;;62073:2002;62550:4;62544:11;;62557:3;62540:21;;62635:17;;;;63331:11;;;63210:5;63497:2;63511;63501:13;;63493:22;63331:11;63480:36;63552:2;63542:13;;63102:731;63571:4;63102:731;;;63762:1;63757:3;63753:11;63746:18;;63813:2;63807:4;63803:13;63799:2;63795:22;63790:3;63782:36;63666:2;63656:13;;63102:731;;;-1:-1:-1;63863:13:1;;;-1:-1:-1;;63978:12:1;;;64038:19;;;63978:12;62073:2002;-1:-1:-1;62073:2002:1:o;48541:716::-;48725:88;;-1:-1:-1;;;48725:88:1;;48704:4;;-1:-1:-1;;;;;48725:45:1;;;;;:88;;61953:10;;48792:4;;48798:7;;48807:5;;48725:88;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;-1:-1:-1;48725:88:1;;;;;;;;-1:-1:-1;;48725:88:1;;;;;;;;;;;;:::i;:::-;;;48721:529;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;49008:6;:13;49025:1;49008:18;49004:235;;49054:40;;-1:-1:-1;;;49054:40:1;;;;;;;;;;;49004:235;49197:6;49191:13;49182:6;49178:2;49174:15;49167:38;48721:529;-1:-1:-1;;;;;;48884:64:1;-1:-1:-1;;;48884:64:1;;-1:-1:-1;48721:529:1;48541:716;;;;;;:::o;14:131:6:-;-1:-1:-1;;;;;;88:32:6;;78:43;;68:71;;135:1;132;125:12;150:245;208:6;261:2;249:9;240:7;236:23;232:32;229:52;;;277:1;274;267:12;229:52;316:9;303:23;335:30;359:5;335:30;:::i;592:250::-;677:1;687:113;701:6;698:1;695:13;687:113;;;777:11;;;771:18;758:11;;;751:39;723:2;716:10;687:113;;;-1:-1:-1;;834:1:6;816:16;;809:27;592:250::o;847:271::-;889:3;927:5;921:12;954:6;949:3;942:19;970:76;1039:6;1032:4;1027:3;1023:14;1016:4;1009:5;1005:16;970:76;:::i;:::-;1100:2;1079:15;-1:-1:-1;;1075:29:6;1066:39;;;;1107:4;1062:50;;847:271;-1:-1:-1;;847:271:6:o;1123:220::-;1272:2;1261:9;1254:21;1235:4;1292:45;1333:2;1322:9;1318:18;1310:6;1292:45;:::i;1348:180::-;1407:6;1460:2;1448:9;1439:7;1435:23;1431:32;1428:52;;;1476:1;1473;1466:12;1428:52;-1:-1:-1;1499:23:6;;1348:180;-1:-1:-1;1348:180:6:o;1741:173::-;1809:20;;-1:-1:-1;;;;;1858:31:6;;1848:42;;1838:70;;1904:1;1901;1894:12;1838:70;1741:173;;;:::o;1919:254::-;1987:6;1995;2048:2;2036:9;2027:7;2023:23;2019:32;2016:52;;;2064:1;2061;2054:12;2016:52;2087:29;2106:9;2087:29;:::i;:::-;2077:39;2163:2;2148:18;;;;2135:32;;-1:-1:-1;;;1919:254:6:o;2178:186::-;2237:6;2290:2;2278:9;2269:7;2265:23;2261:32;2258:52;;;2306:1;2303;2296:12;2258:52;2329:29;2348:9;2329:29;:::i;2551:328::-;2628:6;2636;2644;2697:2;2685:9;2676:7;2672:23;2668:32;2665:52;;;2713:1;2710;2703:12;2665:52;2736:29;2755:9;2736:29;:::i;:::-;2726:39;;2784:38;2818:2;2807:9;2803:18;2784:38;:::i;:::-;2774:48;;2869:2;2858:9;2854:18;2841:32;2831:42;;2551:328;;;;;:::o;2884:127::-;2945:10;2940:3;2936:20;2933:1;2926:31;2976:4;2973:1;2966:15;3000:4;2997:1;2990:15;3016:632;3081:5;3111:18;3152:2;3144:6;3141:14;3138:40;;;3158:18;;:::i;:::-;3233:2;3227:9;3201:2;3287:15;;-1:-1:-1;;3283:24:6;;;3309:2;3279:33;3275:42;3263:55;;;3333:18;;;3353:22;;;3330:46;3327:72;;;3379:18;;:::i;:::-;3419:10;3415:2;3408:22;3448:6;3439:15;;3478:6;3470;3463:22;3518:3;3509:6;3504:3;3500:16;3497:25;3494:45;;;3535:1;3532;3525:12;3494:45;3585:6;3580:3;3573:4;3565:6;3561:17;3548:44;3640:1;3633:4;3624:6;3616;3612:19;3608:30;3601:41;;;;3016:632;;;;;:::o;3653:451::-;3722:6;3775:2;3763:9;3754:7;3750:23;3746:32;3743:52;;;3791:1;3788;3781:12;3743:52;3831:9;3818:23;3864:18;3856:6;3853:30;3850:50;;;3896:1;3893;3886:12;3850:50;3919:22;;3972:4;3964:13;;3960:27;-1:-1:-1;3950:55:6;;4001:1;3998;3991:12;3950:55;4024:74;4090:7;4085:2;4072:16;4067:2;4063;4059:11;4024:74;:::i;4109:118::-;4195:5;4188:13;4181:21;4174:5;4171:32;4161:60;;4217:1;4214;4207:12;4232:315;4297:6;4305;4358:2;4346:9;4337:7;4333:23;4329:32;4326:52;;;4374:1;4371;4364:12;4326:52;4397:29;4416:9;4397:29;:::i;:::-;4387:39;;4476:2;4465:9;4461:18;4448:32;4489:28;4511:5;4489:28;:::i;:::-;4536:5;4526:15;;;4232:315;;;;;:::o;4552:667::-;4647:6;4655;4663;4671;4724:3;4712:9;4703:7;4699:23;4695:33;4692:53;;;4741:1;4738;4731:12;4692:53;4764:29;4783:9;4764:29;:::i;:::-;4754:39;;4812:38;4846:2;4835:9;4831:18;4812:38;:::i;:::-;4802:48;;4897:2;4886:9;4882:18;4869:32;4859:42;;4952:2;4941:9;4937:18;4924:32;4979:18;4971:6;4968:30;4965:50;;;5011:1;5008;5001:12;4965:50;5034:22;;5087:4;5079:13;;5075:27;-1:-1:-1;5065:55:6;;5116:1;5113;5106:12;5065:55;5139:74;5205:7;5200:2;5187:16;5182:2;5178;5174:11;5139:74;:::i;:::-;5129:84;;;4552:667;;;;;;;:::o;5224:127::-;5285:10;5280:3;5276:20;5273:1;5266:31;5316:4;5313:1;5306:15;5340:4;5337:1;5330:15;5356:337;5497:2;5482:18;;5530:1;5519:13;;5509:144;;5575:10;5570:3;5566:20;5563:1;5556:31;5610:4;5607:1;5600:15;5638:4;5635:1;5628:15;5509:144;5662:25;;;5356:337;:::o;5698:260::-;5766:6;5774;5827:2;5815:9;5806:7;5802:23;5798:32;5795:52;;;5843:1;5840;5833:12;5795:52;5866:29;5885:9;5866:29;:::i;:::-;5856:39;;5914:38;5948:2;5937:9;5933:18;5914:38;:::i;:::-;5904:48;;5698:260;;;;;:::o;5963:380::-;6042:1;6038:12;;;;6085;;;6106:61;;6160:4;6152:6;6148:17;6138:27;;6106:61;6213:2;6205:6;6202:14;6182:18;6179:38;6176:161;;6259:10;6254:3;6250:20;6247:1;6240:31;6294:4;6291:1;6284:15;6322:4;6319:1;6312:15;6176:161;;5963:380;;;:::o;6657:245::-;6724:6;6777:2;6765:9;6756:7;6752:23;6748:32;6745:52;;;6793:1;6790;6783:12;6745:52;6825:9;6819:16;6844:28;6866:5;6844:28;:::i;7257:127::-;7318:10;7313:3;7309:20;7306:1;7299:31;7349:4;7346:1;7339:15;7373:4;7370:1;7363:15;7389:125;7454:9;;;7475:10;;;7472:36;;;7488:18;;:::i;7922:336::-;8124:2;8106:21;;;8163:2;8143:18;;;8136:30;-1:-1:-1;;;8197:2:6;8182:18;;8175:42;8249:2;8234:18;;7922:336::o;8389:545::-;8491:2;8486:3;8483:11;8480:448;;;8527:1;8552:5;8548:2;8541:17;8597:4;8593:2;8583:19;8667:2;8655:10;8651:19;8648:1;8644:27;8638:4;8634:38;8703:4;8691:10;8688:20;8685:47;;;-1:-1:-1;8726:4:6;8685:47;8781:2;8776:3;8772:12;8769:1;8765:20;8759:4;8755:31;8745:41;;8836:82;8854:2;8847:5;8844:13;8836:82;;;8899:17;;;8880:1;8869:13;8836:82;;9110:1352;9236:3;9230:10;9263:18;9255:6;9252:30;9249:56;;;9285:18;;:::i;:::-;9314:97;9404:6;9364:38;9396:4;9390:11;9364:38;:::i;:::-;9358:4;9314:97;:::i;:::-;9466:4;;9530:2;9519:14;;9547:1;9542:663;;;;10249:1;10266:6;10263:89;;;-1:-1:-1;10318:19:6;;;10312:26;10263:89;-1:-1:-1;;9067:1:6;9063:11;;;9059:24;9055:29;9045:40;9091:1;9087:11;;;9042:57;10365:81;;9512:944;;9542:663;8336:1;8329:14;;;8373:4;8360:18;;-1:-1:-1;;9578:20:6;;;9696:236;9710:7;9707:1;9704:14;9696:236;;;9799:19;;;9793:26;9778:42;;9891:27;;;;9859:1;9847:14;;;;9726:19;;9696:236;;;9700:3;9960:6;9951:7;9948:19;9945:201;;;10021:19;;;10015:26;-1:-1:-1;;10104:1:6;10100:14;;;10116:3;10096:24;10092:37;10088:42;10073:58;10058:74;;9945:201;-1:-1:-1;;;;;10192:1:6;10176:14;;;10172:22;10159:36;;-1:-1:-1;9110:1352:6:o;10875:168::-;10948:9;;;10979;;10996:15;;;10990:22;;10976:37;10966:71;;11017:18;;:::i;11753:1187::-;12030:3;12059:1;12092:6;12086:13;12122:36;12148:9;12122:36;:::i;:::-;12177:1;12194:18;;;12221:133;;;;12368:1;12363:356;;;;12187:532;;12221:133;-1:-1:-1;;12254:24:6;;12242:37;;12327:14;;12320:22;12308:35;;12299:45;;;-1:-1:-1;12221:133:6;;12363:356;12394:6;12391:1;12384:17;12424:4;12469:2;12466:1;12456:16;12494:1;12508:165;12522:6;12519:1;12516:13;12508:165;;;12600:14;;12587:11;;;12580:35;12643:16;;;;12537:10;;12508:165;;;12512:3;;;12702:6;12697:3;12693:16;12686:23;;12187:532;;;;;12750:6;12744:13;12766:68;12825:8;12820:3;12813:4;12805:6;12801:17;12766:68;:::i;:::-;-1:-1:-1;;;12856:18:6;;12883:22;;;12932:1;12921:13;;11753:1187;-1:-1:-1;;;;11753:1187:6:o;13713:489::-;-1:-1:-1;;;;;13982:15:6;;;13964:34;;14034:15;;14029:2;14014:18;;14007:43;14081:2;14066:18;;14059:34;;;14129:3;14124:2;14109:18;;14102:31;;;13907:4;;14150:46;;14176:19;;14168:6;14150:46;:::i;:::-;14142:54;13713:489;-1:-1:-1;;;;;;13713:489:6:o;14207:249::-;14276:6;14329:2;14317:9;14308:7;14304:23;14300:32;14297:52;;;14345:1;14342;14335:12;14297:52;14377:9;14371:16;14396:30;14420:5;14396:30;:::i

ipfs://7d61bef3ebaec5054bac6732564a395337218d321749eddb476106720c79f375