Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: MIT

import {OwnableBasic} from "./OwnableBasic.sol";
import {AccessControl} from "@openzeppelin/contracts/access/AccessControl.sol";
import {MerkleProof} from "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
import  "@limitbreak/creator-token-contracts/contracts/erc721c/ERC721AC.sol";
import "https://github.com/limitbreakinc/creator-token-contracts/blob/main/contracts/programmable-royalties/BasicRoyalties.sol";

pragma solidity 0.8.20;

contract CAYCRarity is ERC721AC, OwnableBasic, BasicRoyalties {

    error SoldOut();
    error InvalidAmount();
    error InsufficientEther();

    uint256 public constant MAX_SUPPLY = 500;
    uint256 public cost = 3 ether;
    
    string public baseURI = "ipfs://QmQvUqpQgwR3rn8EX9AGN9oLuhixYJuk3DP1LjK4RWrgQp/";
    bool mintStatus = true;
    event BatchMetadataUpdate(uint256 _fromTokenId, uint256 _toTokenId);

    constructor(
        address royaltyReceiver_,
        uint96 royaltyFeeNumerator_) 
        ERC721AC("Cyber Ape Yacht Club - Rarity Mint", "CAYCRM") 
        BasicRoyalties(royaltyReceiver_, royaltyFeeNumerator_)
        {}

    /**
     * @notice Mint fuction for Public
     * @dev Public Mint.
     */
    function mint(uint256 _amount) public payable {
        require(mintStatus, "Mint has been turned off.");
        if(totalSupply() + _amount > MAX_SUPPLY){
            revert SoldOut();
        }
        if(_amount <= 0){
            revert InvalidAmount();
        }
        if(msg.value < _amount * cost){
            revert InsufficientEther();
        }
        _safeMint(msg.sender, _amount);
    }

  

    function treasuryMint(uint256 _amount) external onlyOwner {
        if(totalSupply() + _amount > MAX_SUPPLY){
            revert SoldOut();
        }
        _safeMint(msg.sender, _amount);
    }


   
    /**
     * @dev Airdrop tokens to users by the owner, it is upto the owner to not pass the max supply
     */
     function aidropMultiple(address[] memory recipients, uint256[] memory _amounts ) external onlyOwner {
        for(uint i=0; i<recipients.length; i++){
            _safeMint(recipients[i], _amounts[i]);
        }
    }

    /**
     * @dev Returns the starting token ID for sequential mints.
     *
     * Override this function to change the starting token ID for sequential mints.
     *
     * Note: The value returned must never change after any tokens have been minted.
     */
    function _startTokenId() internal view virtual override returns (uint256) {
        return 1;
    }

    /**
     * @dev Returns the token URL for a tokenId.
     */
    function tokenURI(uint256 tokenId)
        public
        view
        override
        returns (string memory)
    {
        require(
            _exists(tokenId),
            "Err: ERC721AMetadata - URI query for nonexistent token"
        );

        return
            bytes(baseURI).length > 0
                ? string(abi.encodePacked(baseURI, _toString(tokenId), ".json"))
                : "";
    }

    /**
     * @dev Withdraw function for the owner of the smart contract.
     *
     * Note: Only Native currency of the chain can be withdrawn.
     */
    function withdraw() public payable onlyOwner {
        // =============================================================================
        (bool os, ) = payable(owner()).call{value: address(this).balance}("");
        require(os);
        // =============================================================================
    }

    function _baseURI() internal view override returns (string memory) {
        return baseURI;
    }

    function setBaseURI(string memory _newBaseURI) public onlyOwner {
        baseURI = _newBaseURI;
        emit BatchMetadataUpdate(0, totalSupply());
    }

    function setCost(uint256 _newCost) public onlyOwner{
        cost = _newCost;
    }

    function setMintStatus(bool _mintStatus) public onlyOwner{
        mintStatus = _mintStatus;
    }

    function burn(uint256 tokenId) external onlyOwner {
        _burn(tokenId);
    }

    function setDefaultRoyalty(address receiver, uint96 feeNumerator) external {
        _requireCallerIsContractOwner();
        _setDefaultRoyalty(receiver, feeNumerator);
    }

    function setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) external {
        _requireCallerIsContractOwner();
        _setTokenRoyalty(tokenId, receiver, feeNumerator);
    }

    function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721AC, ERC2981) returns (bool) {
          return interfaceId == bytes4(0x49064906) || super.supportsInterface(interfaceId) || ERC2981.supportsInterface(interfaceId);
    }

     function _requireCallerIsContractOwner() internal view override(OwnableBasic, OwnablePermissions) {
        require(msg.sender == owner());
     }
}

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

import "@openzeppelin/contracts/token/common/ERC2981.sol";

/**
 * @title BasicRoyaltiesBase
 * @author Limit Break, Inc.
 * @dev Base functionality of an NFT mix-in contract implementing the most basic form of programmable royalties.
 */
abstract contract BasicRoyaltiesBase is ERC2981 {

    event DefaultRoyaltySet(address indexed receiver, uint96 feeNumerator);
    event TokenRoyaltySet(uint256 indexed tokenId, address indexed receiver, uint96 feeNumerator);

    function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual override {
        super._setDefaultRoyalty(receiver, feeNumerator);
        emit DefaultRoyaltySet(receiver, feeNumerator);
    }

    function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual override {
        super._setTokenRoyalty(tokenId, receiver, feeNumerator);
        emit TokenRoyaltySet(tokenId, receiver, feeNumerator);
    }
}

/**
 * @title BasicRoyalties
 * @author Limit Break, Inc.
 * @notice Constructable BasicRoyalties Contract implementation.
 */
abstract contract BasicRoyalties is BasicRoyaltiesBase {
    constructor(address receiver, uint96 feeNumerator) {
        _setDefaultRoyalty(receiver, feeNumerator);
    }
}

/**
 * @title BasicRoyaltiesInitializable
 * @author Limit Break, Inc.
 * @notice Initializable BasicRoyalties Contract implementation to allow for EIP-1167 clones. 
 */
abstract contract BasicRoyaltiesInitializable is BasicRoyaltiesBase {}

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

import "../utils/CreatorTokenBase.sol";
import "erc721a/contracts/ERC721A.sol";

/**
 * @title ERC721AC
 * @author Limit Break, Inc.
 * @notice Extends Azuki's ERC721-A implementation with Creator Token functionality, which
 *         allows the contract owner to update the transfer validation logic by managing a security policy in
 *         an external transfer validation security policy registry.  See {CreatorTokenTransferValidator}.
 */
abstract contract ERC721AC is ERC721A, CreatorTokenBase {

    constructor(string memory name_, string memory symbol_) CreatorTokenBase() ERC721A(name_, symbol_) {}

    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(ICreatorToken).interfaceId || super.supportsInterface(interfaceId);
    }

    /// @dev Ties the erc721a _beforeTokenTransfers hook to more granular transfer validation logic
    function _beforeTokenTransfers(
        address from,
        address to,
        uint256 startTokenId,
        uint256 quantity
    ) internal virtual override {
        for (uint256 i = 0; i < quantity;) {
            _validateBeforeTransfer(from, to, startTokenId + i);
            unchecked {
                ++i;
            }
        }
    }

    /// @dev Ties the erc721a _afterTokenTransfer hook to more granular transfer validation logic
    function _afterTokenTransfers(
        address from,
        address to,
        uint256 startTokenId,
        uint256 quantity
    ) internal virtual override {
        for (uint256 i = 0; i < quantity;) {
            _validateAfterTransfer(from, to, startTokenId + i);
            unchecked {
                ++i;
            }
        }
    }

    function _msgSenderERC721A() internal view virtual override returns (address) {
        return _msgSender();
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/cryptography/MerkleProof.sol)

pragma solidity ^0.8.20;

/**
 * @dev These functions deal with verification of Merkle Tree proofs.
 *
 * The tree and the proofs can be generated using our
 * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
 * You will find a quickstart guide in the readme.
 *
 * WARNING: You should avoid using leaf values that are 64 bytes long prior to
 * hashing, or use a hash function other than keccak256 for hashing leaves.
 * This is because the concatenation of a sorted pair of internal nodes in
 * the Merkle tree could be reinterpreted as a leaf value.
 * OpenZeppelin's JavaScript library generates Merkle trees that are safe
 * against this attack out of the box.
 */
library MerkleProof {
    /**
     *@dev The multiproof provided is not valid.
     */
    error MerkleProofInvalidMultiproof();

    /**
     * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
     * defined by `root`. For this, a `proof` must be provided, containing
     * sibling hashes on the branch from the leaf to the root of the tree. Each
     * pair of leaves and each pair of pre-images are assumed to be sorted.
     */
    function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
        return processProof(proof, leaf) == root;
    }

    /**
     * @dev Calldata version of {verify}
     */
    function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
        return processProofCalldata(proof, leaf) == root;
    }

    /**
     * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
     * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
     * hash matches the root of the tree. When processing the proof, the pairs
     * of leafs & pre-images are assumed to be sorted.
     */
    function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {
        bytes32 computedHash = leaf;
        for (uint256 i = 0; i < proof.length; i++) {
            computedHash = _hashPair(computedHash, proof[i]);
        }
        return computedHash;
    }

    /**
     * @dev Calldata version of {processProof}
     */
    function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {
        bytes32 computedHash = leaf;
        for (uint256 i = 0; i < proof.length; i++) {
            computedHash = _hashPair(computedHash, proof[i]);
        }
        return computedHash;
    }

    /**
     * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
     * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
     *
     * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
     */
    function multiProofVerify(
        bytes32[] memory proof,
        bool[] memory proofFlags,
        bytes32 root,
        bytes32[] memory leaves
    ) internal pure returns (bool) {
        return processMultiProof(proof, proofFlags, leaves) == root;
    }

    /**
     * @dev Calldata version of {multiProofVerify}
     *
     * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
     */
    function multiProofVerifyCalldata(
        bytes32[] calldata proof,
        bool[] calldata proofFlags,
        bytes32 root,
        bytes32[] memory leaves
    ) internal pure returns (bool) {
        return processMultiProofCalldata(proof, proofFlags, leaves) == root;
    }

    /**
     * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
     * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
     * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
     * respectively.
     *
     * CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
     * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
     * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
     */
    function processMultiProof(
        bytes32[] memory proof,
        bool[] memory proofFlags,
        bytes32[] memory leaves
    ) internal pure returns (bytes32 merkleRoot) {
        // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
        // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
        // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
        // the Merkle tree.
        uint256 leavesLen = leaves.length;
        uint256 proofLen = proof.length;
        uint256 totalHashes = proofFlags.length;

        // Check proof validity.
        if (leavesLen + proofLen != totalHashes + 1) {
            revert MerkleProofInvalidMultiproof();
        }

        // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
        // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
        bytes32[] memory hashes = new bytes32[](totalHashes);
        uint256 leafPos = 0;
        uint256 hashPos = 0;
        uint256 proofPos = 0;
        // At each step, we compute the next hash using two values:
        // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
        //   get the next hash.
        // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
        //   `proof` array.
        for (uint256 i = 0; i < totalHashes; i++) {
            bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
            bytes32 b = proofFlags[i]
                ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                : proof[proofPos++];
            hashes[i] = _hashPair(a, b);
        }

        if (totalHashes > 0) {
            if (proofPos != proofLen) {
                revert MerkleProofInvalidMultiproof();
            }
            unchecked {
                return hashes[totalHashes - 1];
            }
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

    /**
     * @dev Calldata version of {processMultiProof}.
     *
     * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
     */
    function processMultiProofCalldata(
        bytes32[] calldata proof,
        bool[] calldata proofFlags,
        bytes32[] memory leaves
    ) internal pure returns (bytes32 merkleRoot) {
        // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
        // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
        // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
        // the Merkle tree.
        uint256 leavesLen = leaves.length;
        uint256 proofLen = proof.length;
        uint256 totalHashes = proofFlags.length;

        // Check proof validity.
        if (leavesLen + proofLen != totalHashes + 1) {
            revert MerkleProofInvalidMultiproof();
        }

        // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
        // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
        bytes32[] memory hashes = new bytes32[](totalHashes);
        uint256 leafPos = 0;
        uint256 hashPos = 0;
        uint256 proofPos = 0;
        // At each step, we compute the next hash using two values:
        // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
        //   get the next hash.
        // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
        //   `proof` array.
        for (uint256 i = 0; i < totalHashes; i++) {
            bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
            bytes32 b = proofFlags[i]
                ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                : proof[proofPos++];
            hashes[i] = _hashPair(a, b);
        }

        if (totalHashes > 0) {
            if (proofPos != proofLen) {
                revert MerkleProofInvalidMultiproof();
            }
            unchecked {
                return hashes[totalHashes - 1];
            }
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

    /**
     * @dev Sorts the pair (a, b) and hashes the result.
     */
    function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {
        return a < b ? _efficientHash(a, b) : _efficientHash(b, a);
    }

    /**
     * @dev Implementation of keccak256(abi.encode(a, b)) that doesn't allocate or expand memory.
     */
    function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, a)
            mstore(0x20, b)
            value := keccak256(0x00, 0x40)
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/AccessControl.sol)

pragma solidity ^0.8.20;

import {IAccessControl} from "./IAccessControl.sol";
import {Context} from "../utils/Context.sol";
import {ERC165} from "../utils/introspection/ERC165.sol";

/**
 * @dev Contract module that allows children to implement role-based access
 * control mechanisms. This is a lightweight version that doesn't allow enumerating role
 * members except through off-chain means by accessing the contract event logs. Some
 * applications may benefit from on-chain enumerability, for those cases see
 * {AccessControlEnumerable}.
 *
 * Roles are referred to by their `bytes32` identifier. These should be exposed
 * in the external API and be unique. The best way to achieve this is by
 * using `public constant` hash digests:
 *
 * ```solidity
 * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
 * ```
 *
 * Roles can be used to represent a set of permissions. To restrict access to a
 * function call, use {hasRole}:
 *
 * ```solidity
 * function foo() public {
 *     require(hasRole(MY_ROLE, msg.sender));
 *     ...
 * }
 * ```
 *
 * Roles can be granted and revoked dynamically via the {grantRole} and
 * {revokeRole} functions. Each role has an associated admin role, and only
 * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
 *
 * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
 * that only accounts with this role will be able to grant or revoke other
 * roles. More complex role relationships can be created by using
 * {_setRoleAdmin}.
 *
 * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
 * grant and revoke this role. Extra precautions should be taken to secure
 * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}
 * to enforce additional security measures for this role.
 */
abstract contract AccessControl is Context, IAccessControl, ERC165 {
    struct RoleData {
        mapping(address account => bool) hasRole;
        bytes32 adminRole;
    }

    mapping(bytes32 role => RoleData) private _roles;

    bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;

    /**
     * @dev Modifier that checks that an account has a specific role. Reverts
     * with an {AccessControlUnauthorizedAccount} error including the required role.
     */
    modifier onlyRole(bytes32 role) {
        _checkRole(role);
        _;
    }

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
    }

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) public view virtual returns (bool) {
        return _roles[role].hasRole[account];
    }

    /**
     * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `_msgSender()`
     * is missing `role`. Overriding this function changes the behavior of the {onlyRole} modifier.
     */
    function _checkRole(bytes32 role) internal view virtual {
        _checkRole(role, _msgSender());
    }

    /**
     * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `account`
     * is missing `role`.
     */
    function _checkRole(bytes32 role, address account) internal view virtual {
        if (!hasRole(role, account)) {
            revert AccessControlUnauthorizedAccount(account, role);
        }
    }

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) public view virtual returns (bytes32) {
        return _roles[role].adminRole;
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleGranted} event.
     */
    function grantRole(bytes32 role, address account) public virtual onlyRole(getRoleAdmin(role)) {
        _grantRole(role, account);
    }

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleRevoked} event.
     */
    function revokeRole(bytes32 role, address account) public virtual onlyRole(getRoleAdmin(role)) {
        _revokeRole(role, account);
    }

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been revoked `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `callerConfirmation`.
     *
     * May emit a {RoleRevoked} event.
     */
    function renounceRole(bytes32 role, address callerConfirmation) public virtual {
        if (callerConfirmation != _msgSender()) {
            revert AccessControlBadConfirmation();
        }

        _revokeRole(role, callerConfirmation);
    }

    /**
     * @dev Sets `adminRole` as ``role``'s admin role.
     *
     * Emits a {RoleAdminChanged} event.
     */
    function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
        bytes32 previousAdminRole = getRoleAdmin(role);
        _roles[role].adminRole = adminRole;
        emit RoleAdminChanged(role, previousAdminRole, adminRole);
    }

    /**
     * @dev Attempts to grant `role` to `account` and returns a boolean indicating if `role` was granted.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleGranted} event.
     */
    function _grantRole(bytes32 role, address account) internal virtual returns (bool) {
        if (!hasRole(role, account)) {
            _roles[role].hasRole[account] = true;
            emit RoleGranted(role, account, _msgSender());
            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Attempts to revoke `role` to `account` and returns a boolean indicating if `role` was revoked.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleRevoked} event.
     */
    function _revokeRole(bytes32 role, address account) internal virtual returns (bool) {
        if (hasRole(role, account)) {
            _roles[role].hasRole[account] = false;
            emit RoleRevoked(role, account, _msgSender());
            return true;
        } else {
            return false;
        }
    }
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.20;

import "./OwnablePermissions.sol";
import "@openzeppelin/contracts/access/Ownable.sol";

abstract contract OwnableBasic is OwnablePermissions, Ownable(msg.sender) {
    function _requireCallerIsContractOwner() internal view virtual override {
        _checkOwner();
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/common/ERC2981.sol)

pragma solidity ^0.8.20;

import {IERC2981} from "../../interfaces/IERC2981.sol";
import {IERC165, ERC165} from "../../utils/introspection/ERC165.sol";

/**
 * @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information.
 *
 * Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for
 * specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first.
 *
 * Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the
 * fee is specified in basis points by default.
 *
 * IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
 * https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to
 * voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
 */
abstract contract ERC2981 is IERC2981, ERC165 {
    struct RoyaltyInfo {
        address receiver;
        uint96 royaltyFraction;
    }

    RoyaltyInfo private _defaultRoyaltyInfo;
    mapping(uint256 tokenId => RoyaltyInfo) private _tokenRoyaltyInfo;

    /**
     * @dev The default royalty set is invalid (eg. (numerator / denominator) >= 1).
     */
    error ERC2981InvalidDefaultRoyalty(uint256 numerator, uint256 denominator);

    /**
     * @dev The default royalty receiver is invalid.
     */
    error ERC2981InvalidDefaultRoyaltyReceiver(address receiver);

    /**
     * @dev The royalty set for an specific `tokenId` is invalid (eg. (numerator / denominator) >= 1).
     */
    error ERC2981InvalidTokenRoyalty(uint256 tokenId, uint256 numerator, uint256 denominator);

    /**
     * @dev The royalty receiver for `tokenId` is invalid.
     */
    error ERC2981InvalidTokenRoyaltyReceiver(uint256 tokenId, address receiver);

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {
        return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);
    }

    /**
     * @inheritdoc IERC2981
     */
    function royaltyInfo(uint256 tokenId, uint256 salePrice) public view virtual returns (address, uint256) {
        RoyaltyInfo memory royalty = _tokenRoyaltyInfo[tokenId];

        if (royalty.receiver == address(0)) {
            royalty = _defaultRoyaltyInfo;
        }

        uint256 royaltyAmount = (salePrice * royalty.royaltyFraction) / _feeDenominator();

        return (royalty.receiver, royaltyAmount);
    }

    /**
     * @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a
     * fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an
     * override.
     */
    function _feeDenominator() internal pure virtual returns (uint96) {
        return 10000;
    }

    /**
     * @dev Sets the royalty information that all ids in this contract will default to.
     *
     * Requirements:
     *
     * - `receiver` cannot be the zero address.
     * - `feeNumerator` cannot be greater than the fee denominator.
     */
    function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
        uint256 denominator = _feeDenominator();
        if (feeNumerator > denominator) {
            // Royalty fee will exceed the sale price
            revert ERC2981InvalidDefaultRoyalty(feeNumerator, denominator);
        }
        if (receiver == address(0)) {
            revert ERC2981InvalidDefaultRoyaltyReceiver(address(0));
        }

        _defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
    }

    /**
     * @dev Removes default royalty information.
     */
    function _deleteDefaultRoyalty() internal virtual {
        delete _defaultRoyaltyInfo;
    }

    /**
     * @dev Sets the royalty information for a specific token id, overriding the global default.
     *
     * Requirements:
     *
     * - `receiver` cannot be the zero address.
     * - `feeNumerator` cannot be greater than the fee denominator.
     */
    function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual {
        uint256 denominator = _feeDenominator();
        if (feeNumerator > denominator) {
            // Royalty fee will exceed the sale price
            revert ERC2981InvalidTokenRoyalty(tokenId, feeNumerator, denominator);
        }
        if (receiver == address(0)) {
            revert ERC2981InvalidTokenRoyaltyReceiver(tokenId, address(0));
        }

        _tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);
    }

    /**
     * @dev Resets royalty information for the token id back to the global default.
     */
    function _resetTokenRoyalty(uint256 tokenId) internal virtual {
        delete _tokenRoyaltyInfo[tokenId];
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)

pragma solidity ^0.8.20;

import {Context} from "../utils/Context.sol";

/**
 * @dev Contract module which provides a basic access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * The initial owner is set to the address provided by the deployer. This can
 * later be changed with {transferOwnership}.
 *
 * This module is used through inheritance. It will make available the modifier
 * `onlyOwner`, which can be applied to your functions to restrict their use to
 * the owner.
 */
abstract contract Ownable is Context {
    address private _owner;

    /**
     * @dev The caller account is not authorized to perform an operation.
     */
    error OwnableUnauthorizedAccount(address account);

    /**
     * @dev The owner is not a valid owner account. (eg. `address(0)`)
     */
    error OwnableInvalidOwner(address owner);

    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Initializes the contract setting the address provided by the deployer as the initial owner.
     */
    constructor(address initialOwner) {
        if (initialOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(initialOwner);
    }

    /**
     * @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 {
        if (owner() != _msgSender()) {
            revert OwnableUnauthorizedAccount(_msgSender());
        }
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby disabling any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        if (newOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual {
        address oldOwner = _owner;
        _owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}

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

import "@openzeppelin/contracts/utils/Context.sol";

abstract contract OwnablePermissions is Context {
    function _requireCallerIsContractOwner() internal view virtual;
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/ERC165.sol)

pragma solidity ^0.8.20;

import {IERC165} from "./IERC165.sol";

/**
 * @dev Implementation of the {IERC165} interface.
 *
 * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
 * for the additional interface id that will be supported. For example:
 *
 * ```solidity
 * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
 *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
 * }
 * ```
 */
abstract contract ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)

pragma solidity ^0.8.20;

/**
 * @dev Provides information about the current execution context, including the
 * sender of the transaction and its data. While these are generally available
 * via msg.sender and msg.data, they should not be accessed in such a direct
 * manner, since when dealing with meta-transactions the account sending and
 * paying for execution may not be the actual sender (as far as an application
 * is concerned).
 *
 * This contract is only required for intermediate, library-like contracts.
 */
abstract contract Context {
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

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

    function _contextSuffixLength() internal view virtual returns (uint256) {
        return 0;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/IAccessControl.sol)

pragma solidity ^0.8.20;

/**
 * @dev External interface of AccessControl declared to support ERC165 detection.
 */
interface IAccessControl {
    /**
     * @dev The `account` is missing a role.
     */
    error AccessControlUnauthorizedAccount(address account, bytes32 neededRole);

    /**
     * @dev The caller of a function is not the expected one.
     *
     * NOTE: Don't confuse with {AccessControlUnauthorizedAccount}.
     */
    error AccessControlBadConfirmation();

    /**
     * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
     *
     * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
     * {RoleAdminChanged} not being emitted signaling this.
     */
    event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);

    /**
     * @dev Emitted when `account` is granted `role`.
     *
     * `sender` is the account that originated the contract call, an admin role
     * bearer except when using {AccessControl-_setupRole}.
     */
    event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Emitted when `account` is revoked `role`.
     *
     * `sender` is the account that originated the contract call:
     *   - if using `revokeRole`, it is the admin role bearer
     *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
     */
    event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) external view returns (bool);

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {AccessControl-_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) external view returns (bytes32);

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function grantRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function revokeRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been granted `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `callerConfirmation`.
     */
    function renounceRole(bytes32 role, address callerConfirmation) external;
}

// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.3.0
// Creator: Chiru Labs

pragma solidity ^0.8.4;

import './IERC721A.sol';

/**
 * @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()`.
 *
 * The `_sequentialUpTo()` function can be overriden to enable spot mints
 * (i.e. non-consecutive mints) for `tokenId`s greater than `_sequentialUpTo()`.
 *
 * 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 {
    // Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364).
    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;

    // The amount of tokens minted above `_sequentialUpTo()`.
    // We call these spot mints (i.e. non-sequential mints).
    uint256 private _spotMinted;

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

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

        if (_sequentialUpTo() < _startTokenId()) _revert(SequentialUpToTooSmall.selector);
    }

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

    /**
     * @dev Returns the starting token ID for sequential mints.
     *
     * Override this function to change the starting token ID for sequential mints.
     *
     * Note: The value returned must never change after any tokens have been minted.
     */
    function _startTokenId() internal view virtual returns (uint256) {
        return 0;
    }

    /**
     * @dev Returns the maximum token ID (inclusive) for sequential mints.
     *
     * Override this function to return a value less than 2**256 - 1,
     * but greater than `_startTokenId()`, to enable spot (non-sequential) mints.
     *
     * Note: The value returned must never change after any tokens have been minted.
     */
    function _sequentialUpTo() internal view virtual returns (uint256) {
        return type(uint256).max;
    }

    /**
     * @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 result) {
        // Counter underflow is impossible as `_burnCounter` cannot be incremented
        // more than `_currentIndex + _spotMinted - _startTokenId()` times.
        unchecked {
            // With spot minting, the intermediate `result` can be temporarily negative,
            // and the computation must be unchecked.
            result = _currentIndex - _burnCounter - _startTokenId();
            if (_sequentialUpTo() != type(uint256).max) result += _spotMinted;
        }
    }

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

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

    /**
     * @dev Returns the total number of tokens that are spot-minted.
     */
    function _totalSpotMinted() internal view virtual returns (uint256) {
        return _spotMinted;
    }

    // =============================================================
    //                    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.selector);
        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.selector);

        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 Returns whether the ownership slot at `index` is initialized.
     * An uninitialized slot does not necessarily mean that the slot has no owner.
     */
    function _ownershipIsInitialized(uint256 index) internal view virtual returns (bool) {
        return _packedOwnerships[index] != 0;
    }

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

    /**
     * @dev Returns the packed ownership data of `tokenId`.
     */
    function _packedOwnershipOf(uint256 tokenId) private view returns (uint256 packed) {
        if (_startTokenId() <= tokenId) {
            packed = _packedOwnerships[tokenId];

            if (tokenId > _sequentialUpTo()) {
                if (_packedOwnershipExists(packed)) return packed;
                _revert(OwnerQueryForNonexistentToken.selector);
            }

            // If the data at the starting slot does not exist, start the scan.
            if (packed == 0) {
                if (tokenId >= _currentIndex) _revert(OwnerQueryForNonexistentToken.selector);
                // 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, `tokenId` will not underflow.
                //
                // We can directly compare the packed value.
                // If the address is zero, packed will be zero.
                for (;;) {
                    unchecked {
                        packed = _packedOwnerships[--tokenId];
                    }
                    if (packed == 0) continue;
                    if (packed & _BITMASK_BURNED == 0) return packed;
                    // Otherwise, the token is burned, and we must revert.
                    // This handles the case of batch burned tokens, where only the burned bit
                    // of the starting slot is set, and remaining slots are left uninitialized.
                    _revert(OwnerQueryForNonexistentToken.selector);
                }
            }
            // Otherwise, the data exists and we can skip the scan.
            // This is possible because we have already achieved the target condition.
            // This saves 2143 gas on transfers of initialized tokens.
            // If the token is not burned, return `packed`. Otherwise, revert.
            if (packed & _BITMASK_BURNED == 0) return packed;
        }
        _revert(OwnerQueryForNonexistentToken.selector);
    }

    /**
     * @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. See {ERC721A-_approve}.
     *
     * Requirements:
     *
     * - The caller must own the token or be an approved operator.
     */
    function approve(address to, uint256 tokenId) public payable virtual override {
        _approve(to, tokenId, true);
    }

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

        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 {
        _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 result) {
        if (_startTokenId() <= tokenId) {
            if (tokenId > _sequentialUpTo()) return _packedOwnershipExists(_packedOwnerships[tokenId]);

            if (tokenId < _currentIndex) {
                uint256 packed;
                while ((packed = _packedOwnerships[tokenId]) == 0) --tokenId;
                result = packed & _BITMASK_BURNED == 0;
            }
        }
    }

    /**
     * @dev Returns whether `packed` represents a token that exists.
     */
    function _packedOwnershipExists(uint256 packed) private pure returns (bool result) {
        assembly {
            // The following is equivalent to `owner != address(0) && burned == false`.
            // Symbolically tested.
            result := gt(and(packed, _BITMASK_ADDRESS), and(packed, _BITMASK_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].value`.
        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 payable virtual override {
        uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);

        // Mask `from` to the lower 160 bits, in case the upper bits somehow aren't clean.
        from = address(uint160(uint256(uint160(from)) & _BITMASK_ADDRESS));

        if (address(uint160(prevOwnershipPacked)) != from) _revert(TransferFromIncorrectOwner.selector);

        (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.selector);

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

        // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
        uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS;
        assembly {
            // 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.
                from, // `from`.
                toMasked, // `to`.
                tokenId // `tokenId`.
            )
        }
        if (toMasked == 0) _revert(TransferToZeroAddress.selector);

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

    /**
     * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId
    ) public payable 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 payable virtual override {
        transferFrom(from, to, tokenId);
        if (to.code.length != 0)
            if (!_checkContractOnERC721Received(from, to, tokenId, _data)) {
                _revert(TransferToNonERC721ReceiverImplementer.selector);
            }
    }

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

        _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:
            // - `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)
            );

            // Updates:
            // - `balance += quantity`.
            // - `numberMinted += quantity`.
            //
            // We can directly add to the `balance` and `numberMinted`.
            _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);

            // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
            uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS;

            if (toMasked == 0) _revert(MintToZeroAddress.selector);

            uint256 end = startTokenId + quantity;
            uint256 tokenId = startTokenId;

            if (end - 1 > _sequentialUpTo()) _revert(SequentialMintExceedsLimit.selector);

            do {
                assembly {
                    // 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`.
                        tokenId // `tokenId`.
                    )
                }
                // The `!=` check ensures that large values of `quantity`
                // that overflows uint256 will make the loop run out of gas.
            } while (++tokenId != end);

            _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.selector);
        if (quantity == 0) _revert(MintZeroQuantity.selector);
        if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) _revert(MintERC2309QuantityExceedsLimit.selector);

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

            if (startTokenId + quantity - 1 > _sequentialUpTo()) _revert(SequentialMintExceedsLimit.selector);

            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.selector);
                    }
                } while (index < end);
                // This prevents reentrancy to `_safeMint`.
                // It does not prevent reentrancy to `_safeMintSpot`.
                if (_currentIndex != end) revert();
            }
        }
    }

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

    /**
     * @dev Mints a single token at `tokenId`.
     *
     * Note: A spot-minted `tokenId` that has been burned can be re-minted again.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - `tokenId` must be greater than `_sequentialUpTo()`.
     * - `tokenId` must not exist.
     *
     * Emits a {Transfer} event for each mint.
     */
    function _mintSpot(address to, uint256 tokenId) internal virtual {
        if (tokenId <= _sequentialUpTo()) _revert(SpotMintTokenIdTooSmall.selector);
        uint256 prevOwnershipPacked = _packedOwnerships[tokenId];
        if (_packedOwnershipExists(prevOwnershipPacked)) _revert(TokenAlreadyExists.selector);

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

        // Overflows are incredibly unrealistic.
        // The `numberMinted` for `to` is incremented by 1, and has a max limit of 2**64 - 1.
        // `_spotMinted` is incremented by 1, and has a max limit of 2**256 - 1.
        unchecked {
            // Updates:
            // - `address` to the owner.
            // - `startTimestamp` to the timestamp of minting.
            // - `burned` to `false`.
            // - `nextInitialized` to `true` (as `quantity == 1`).
            _packedOwnerships[tokenId] = _packOwnershipData(
                to,
                _nextInitializedFlag(1) | _nextExtraData(address(0), to, prevOwnershipPacked)
            );

            // Updates:
            // - `balance += 1`.
            // - `numberMinted += 1`.
            //
            // We can directly add to the `balance` and `numberMinted`.
            _packedAddressData[to] += (1 << _BITPOS_NUMBER_MINTED) | 1;

            // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
            uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS;

            if (toMasked == 0) _revert(MintToZeroAddress.selector);

            assembly {
                // 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`.
                    tokenId // `tokenId`.
                )
            }

            ++_spotMinted;
        }

        _afterTokenTransfers(address(0), to, tokenId, 1);
    }

    /**
     * @dev Safely mints a single token at `tokenId`.
     *
     * Note: A spot-minted `tokenId` that has been burned can be re-minted again.
     *
     * Requirements:
     *
     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}.
     * - `tokenId` must be greater than `_sequentialUpTo()`.
     * - `tokenId` must not exist.
     *
     * See {_mintSpot}.
     *
     * Emits a {Transfer} event.
     */
    function _safeMintSpot(
        address to,
        uint256 tokenId,
        bytes memory _data
    ) internal virtual {
        _mintSpot(to, tokenId);

        unchecked {
            if (to.code.length != 0) {
                uint256 currentSpotMinted = _spotMinted;
                if (!_checkContractOnERC721Received(address(0), to, tokenId, _data)) {
                    _revert(TransferToNonERC721ReceiverImplementer.selector);
                }
                // This prevents reentrancy to `_safeMintSpot`.
                // It does not prevent reentrancy to `_safeMint`.
                if (_spotMinted != currentSpotMinted) revert();
            }
        }
    }

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

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

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

    /**
     * @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:
     *
     * - `tokenId` must exist.
     *
     * Emits an {Approval} event.
     */
    function _approve(
        address to,
        uint256 tokenId,
        bool approvalCheck
    ) internal virtual {
        address owner = ownerOf(tokenId);

        if (approvalCheck && _msgSenderERC721A() != owner)
            if (!isApprovedForAll(owner, _msgSenderERC721A())) {
                _revert(ApprovalCallerNotOwnerNorApproved.selector);
            }

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

    // =============================================================
    //                        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.selector);
        }

        _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 + _spotMinted` 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.selector);
        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 str) {
        assembly {
            // The maximum value of a uint256 contains 78 digits (1 byte per digit), but
            // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned.
            // We will need 1 word for the trailing zeros padding, 1 word for the length,
            // and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0.
            let m := add(mload(0x40), 0xa0)
            // Update the free memory pointer to allocate.
            mstore(0x40, m)
            // Assign the `str` to the end.
            str := sub(m, 0x20)
            // Zeroize the slot after the string.
            mstore(str, 0)

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

            // We write the string from rightmost digit to leftmost digit.
            // The following is essentially a do-while loop that also handles the zero case.
            // prettier-ignore
            for { let temp := value } 1 {} {
                str := sub(str, 1)
                // Write the character to the pointer.
                // The ASCII index of the '0' character is 48.
                mstore8(str, add(48, mod(temp, 10)))
                // Keep dividing `temp` until zero.
                temp := div(temp, 10)
                // prettier-ignore
                if iszero(temp) { break }
            }

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

    /**
     * @dev For more efficient reverts.
     */
    function _revert(bytes4 errorSelector) internal pure {
        assembly {
            mstore(0x00, errorSelector)
            revert(0x00, 0x04)
        }
    }
}

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

import "../access/OwnablePermissions.sol";
import "../interfaces/ICreatorToken.sol";
import "../interfaces/ICreatorTokenTransferValidator.sol";
import "../utils/TransferValidation.sol";
import "@openzeppelin/contracts/interfaces/IERC165.sol";

/**
 * @title CreatorTokenBase
 * @author Limit Break, Inc.
 * @notice CreatorTokenBase is an abstract contract that provides basic functionality for managing token 
 * transfer policies through an implementation of ICreatorTokenTransferValidator. This contract is intended to be used
 * as a base for creator-specific token contracts, enabling customizable transfer restrictions and security policies.
 *
 * <h4>Features:</h4>
 * <ul>Ownable: This contract can have an owner who can set and update the transfer validator.</ul>
 * <ul>TransferValidation: Implements the basic token transfer validation interface.</ul>
 * <ul>ICreatorToken: Implements the interface for creator tokens, providing view functions for token security policies.</ul>
 *
 * <h4>Benefits:</h4>
 * <ul>Provides a flexible and modular way to implement custom token transfer restrictions and security policies.</ul>
 * <ul>Allows creators to enforce policies such as whitelisted operators and permitted contract receivers.</ul>
 * <ul>Can be easily integrated into other token contracts as a base contract.</ul>
 *
 * <h4>Intended Usage:</h4>
 * <ul>Use as a base contract for creator token implementations that require advanced transfer restrictions and 
 *   security policies.</ul>
 * <ul>Set and update the ICreatorTokenTransferValidator implementation contract to enforce desired policies for the 
 *   creator token.</ul>
 */
abstract contract CreatorTokenBase is OwnablePermissions, TransferValidation, ICreatorToken {
    
    error CreatorTokenBase__InvalidTransferValidatorContract();
    error CreatorTokenBase__SetTransferValidatorFirst();

    address public constant DEFAULT_TRANSFER_VALIDATOR = address(0x0000721C310194CcfC01E523fc93C9cCcFa2A0Ac);
    TransferSecurityLevels public constant DEFAULT_TRANSFER_SECURITY_LEVEL = TransferSecurityLevels.One;
    uint120 public constant DEFAULT_OPERATOR_WHITELIST_ID = uint120(1);

    ICreatorTokenTransferValidator private transferValidator;

    /**
     * @notice Allows the contract owner to set the transfer validator to the official validator contract
     *         and set the security policy to the recommended default settings.
     * @dev    May be overridden to change the default behavior of an individual collection.
     */
    function setToDefaultSecurityPolicy() public virtual {
        _requireCallerIsContractOwner();
        setTransferValidator(DEFAULT_TRANSFER_VALIDATOR);
        ICreatorTokenTransferValidator(DEFAULT_TRANSFER_VALIDATOR).setTransferSecurityLevelOfCollection(address(this), DEFAULT_TRANSFER_SECURITY_LEVEL);
        ICreatorTokenTransferValidator(DEFAULT_TRANSFER_VALIDATOR).setOperatorWhitelistOfCollection(address(this), DEFAULT_OPERATOR_WHITELIST_ID);
    }

    /**
     * @notice Allows the contract owner to set the transfer validator to a custom validator contract
     *         and set the security policy to their own custom settings.
     */
    function setToCustomValidatorAndSecurityPolicy(
        address validator, 
        TransferSecurityLevels level, 
        uint120 operatorWhitelistId, 
        uint120 permittedContractReceiversAllowlistId) public {
        _requireCallerIsContractOwner();

        setTransferValidator(validator);

        ICreatorTokenTransferValidator(validator).
            setTransferSecurityLevelOfCollection(address(this), level);

        ICreatorTokenTransferValidator(validator).
            setOperatorWhitelistOfCollection(address(this), operatorWhitelistId);

        ICreatorTokenTransferValidator(validator).
            setPermittedContractReceiverAllowlistOfCollection(address(this), permittedContractReceiversAllowlistId);
    }

    /**
     * @notice Allows the contract owner to set the security policy to their own custom settings.
     * @dev    Reverts if the transfer validator has not been set.
     */
    function setToCustomSecurityPolicy(
        TransferSecurityLevels level, 
        uint120 operatorWhitelistId, 
        uint120 permittedContractReceiversAllowlistId) public {
        _requireCallerIsContractOwner();

        ICreatorTokenTransferValidator validator = getTransferValidator();
        if (address(validator) == address(0)) {
            revert CreatorTokenBase__SetTransferValidatorFirst();
        }

        validator.setTransferSecurityLevelOfCollection(address(this), level);
        validator.setOperatorWhitelistOfCollection(address(this), operatorWhitelistId);
        validator.setPermittedContractReceiverAllowlistOfCollection(address(this), permittedContractReceiversAllowlistId);
    }

    /**
     * @notice Sets the transfer validator for the token contract.
     *
     * @dev    Throws when provided validator contract is not the zero address and doesn't support 
     *         the ICreatorTokenTransferValidator interface. 
     * @dev    Throws when the caller is not the contract owner.
     *
     * @dev    <h4>Postconditions:</h4>
     *         1. The transferValidator address is updated.
     *         2. The `TransferValidatorUpdated` event is emitted.
     *
     * @param transferValidator_ The address of the transfer validator contract.
     */
    function setTransferValidator(address transferValidator_) public {
        _requireCallerIsContractOwner();

        bool isValidTransferValidator = false;

        if(transferValidator_.code.length > 0) {
            try IERC165(transferValidator_).supportsInterface(type(ICreatorTokenTransferValidator).interfaceId) 
                returns (bool supportsInterface) {
                isValidTransferValidator = supportsInterface;
            } catch {}
        }

        if(transferValidator_ != address(0) && !isValidTransferValidator) {
            revert CreatorTokenBase__InvalidTransferValidatorContract();
        }

        emit TransferValidatorUpdated(address(transferValidator), transferValidator_);

        transferValidator = ICreatorTokenTransferValidator(transferValidator_);
    }

    /**
     * @notice Returns the transfer validator contract address for this token contract.
     */
    function getTransferValidator() public view override returns (ICreatorTokenTransferValidator) {
        return transferValidator;
    }

    /**
     * @notice Returns the security policy for this token contract, which includes:
     *         Transfer security level, operator whitelist id, permitted contract receiver allowlist id.
     */
    function getSecurityPolicy() public view override returns (CollectionSecurityPolicy memory) {
        if (address(transferValidator) != address(0)) {
            return transferValidator.getCollectionSecurityPolicy(address(this));
        }

        return CollectionSecurityPolicy({
            transferSecurityLevel: TransferSecurityLevels.Zero,
            operatorWhitelistId: 0,
            permittedContractReceiversId: 0
        });
    }

    /**
     * @notice Returns the list of all whitelisted operators for this token contract.
     * @dev    This can be an expensive call and should only be used in view-only functions.
     */
    function getWhitelistedOperators() public view override returns (address[] memory) {
        if (address(transferValidator) != address(0)) {
            return transferValidator.getWhitelistedOperators(
                transferValidator.getCollectionSecurityPolicy(address(this)).operatorWhitelistId);
        }

        return new address[](0);
    }

    /**
     * @notice Returns the list of permitted contract receivers for this token contract.
     * @dev    This can be an expensive call and should only be used in view-only functions.
     */
    function getPermittedContractReceivers() public view override returns (address[] memory) {
        if (address(transferValidator) != address(0)) {
            return transferValidator.getPermittedContractReceivers(
                transferValidator.getCollectionSecurityPolicy(address(this)).permittedContractReceiversId);
        }

        return new address[](0);
    }

    /**
     * @notice Checks if an operator is whitelisted for this token contract.
     * @param operator The address of the operator to check.
     */
    function isOperatorWhitelisted(address operator) public view override returns (bool) {
        if (address(transferValidator) != address(0)) {
            return transferValidator.isOperatorWhitelisted(
                transferValidator.getCollectionSecurityPolicy(address(this)).operatorWhitelistId, operator);
        }

        return false;
    }

    /**
     * @notice Checks if a contract receiver is permitted for this token contract.
     * @param receiver The address of the receiver to check.
     */
    function isContractReceiverPermitted(address receiver) public view override returns (bool) {
        if (address(transferValidator) != address(0)) {
            return transferValidator.isContractReceiverPermitted(
                transferValidator.getCollectionSecurityPolicy(address(this)).permittedContractReceiversId, receiver);
        }

        return false;
    }

    /**
     * @notice Determines if a transfer is allowed based on the token contract's security policy.  Use this function
     *         to simulate whether or not a transfer made by the specified `caller` from the `from` address to the `to`
     *         address would be allowed by this token's security policy.
     *
     * @notice This function only checks the security policy restrictions and does not check whether token ownership
     *         or approvals are in place. 
     *
     * @param caller The address of the simulated caller.
     * @param from   The address of the sender.
     * @param to     The address of the receiver.
     * @return       True if the transfer is allowed, false otherwise.
     */
    function isTransferAllowed(address caller, address from, address to) public view override returns (bool) {
        if (address(transferValidator) != address(0)) {
            try transferValidator.applyCollectionTransferPolicy(caller, from, to) {
                return true;
            } catch {
                return false;
            }
        }
        return true;
    }

    /**
     * @dev Pre-validates a token transfer, reverting if the transfer is not allowed by this token's security policy.
     *      Inheriting contracts are responsible for overriding the _beforeTokenTransfer function, or its equivalent
     *      and calling _validateBeforeTransfer so that checks can be properly applied during token transfers.
     *
     * @dev Throws when the transfer doesn't comply with the collection's transfer policy, if the transferValidator is
     *      set to a non-zero address.
     *
     * @param caller  The address of the caller.
     * @param from    The address of the sender.
     * @param to      The address of the receiver.
     */
    function _preValidateTransfer(
        address caller, 
        address from, 
        address to, 
        uint256 /*tokenId*/, 
        uint256 /*value*/) internal virtual override {
        if (address(transferValidator) != address(0)) {
            transferValidator.applyCollectionTransferPolicy(caller, from, to);
        }
    }
}

// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.3.0
// Creator: Chiru Labs

pragma solidity ^0.8.4;

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

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

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

    /**
     * `_sequentialUpTo()` must be greater than `_startTokenId()`.
     */
    error SequentialUpToTooSmall();

    /**
     * The `tokenId` of a sequential mint exceeds `_sequentialUpTo()`.
     */
    error SequentialMintExceedsLimit();

    /**
     * Spot minting requires a `tokenId` greater than `_sequentialUpTo()`.
     */
    error SpotMintTokenIdTooSmall();

    /**
     * Cannot mint over a token that already exists.
     */
    error TokenAlreadyExists();

    /**
     * The feature is not compatible with spot mints.
     */
    error NotCompatibleWithSpotMints();

    // =============================================================
    //                            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 payable;

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol)

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC165 standard, as defined in the
 * https://eips.ethereum.org/EIPS/eip-165[EIP].
 *
 * Implementers can declare support of contract interfaces, which can then be
 * queried by others ({ERC165Checker}).
 *
 * For an implementation, see {ERC165}.
 */
interface IERC165 {
    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30 000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC2981.sol)

pragma solidity ^0.8.20;

import {IERC165} from "../utils/introspection/IERC165.sol";

/**
 * @dev Interface for the NFT Royalty Standard.
 *
 * A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal
 * support for royalty payments across all NFT marketplaces and ecosystem participants.
 */
interface IERC2981 is IERC165 {
    /**
     * @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of
     * exchange. The royalty amount is denominated and should be paid in that same unit of exchange.
     */
    function royaltyInfo(
        uint256 tokenId,
        uint256 salePrice
    ) external view returns (address receiver, uint256 royaltyAmount);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC165.sol)

pragma solidity ^0.8.20;

import {IERC165} from "../utils/introspection/IERC165.sol";

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

import "@openzeppelin/contracts/utils/Context.sol";

/**
 * @title TransferValidation
 * @author Limit Break, Inc.
 * @notice A mix-in that can be combined with ERC-721 contracts to provide more granular hooks.
 * Openzeppelin's ERC721 contract only provides hooks for before and after transfer.  This allows
 * developers to validate or customize transfers within the context of a mint, a burn, or a transfer.
 */
abstract contract TransferValidation is Context {
    
    error ShouldNotMintToBurnAddress();

    /// @dev Inheriting contracts should call this function in the _beforeTokenTransfer function to get more granular hooks.
    function _validateBeforeTransfer(address from, address to, uint256 tokenId) internal virtual {
        bool fromZeroAddress = from == address(0);
        bool toZeroAddress = to == address(0);

        if(fromZeroAddress && toZeroAddress) {
            revert ShouldNotMintToBurnAddress();
        } else if(fromZeroAddress) {
            _preValidateMint(_msgSender(), to, tokenId, msg.value);
        } else if(toZeroAddress) {
            _preValidateBurn(_msgSender(), from, tokenId, msg.value);
        } else {
            _preValidateTransfer(_msgSender(), from, to, tokenId, msg.value);
        }
    }

    /// @dev Inheriting contracts should call this function in the _afterTokenTransfer function to get more granular hooks.
    function _validateAfterTransfer(address from, address to, uint256 tokenId) internal virtual {
        bool fromZeroAddress = from == address(0);
        bool toZeroAddress = to == address(0);

        if(fromZeroAddress && toZeroAddress) {
            revert ShouldNotMintToBurnAddress();
        } else if(fromZeroAddress) {
            _postValidateMint(_msgSender(), to, tokenId, msg.value);
        } else if(toZeroAddress) {
            _postValidateBurn(_msgSender(), from, tokenId, msg.value);
        } else {
            _postValidateTransfer(_msgSender(), from, to, tokenId, msg.value);
        }
    }

    /// @dev Optional validation hook that fires before a mint
    function _preValidateMint(address caller, address to, uint256 tokenId, uint256 value) internal virtual {}

    /// @dev Optional validation hook that fires after a mint
    function _postValidateMint(address caller, address to, uint256 tokenId, uint256 value) internal virtual {}

    /// @dev Optional validation hook that fires before a burn
    function _preValidateBurn(address caller, address from, uint256 tokenId, uint256 value) internal virtual {}

    /// @dev Optional validation hook that fires after a burn
    function _postValidateBurn(address caller, address from, uint256 tokenId, uint256 value) internal virtual {}

    /// @dev Optional validation hook that fires before a transfer
    function _preValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 value) internal virtual {}

    /// @dev Optional validation hook that fires after a transfer
    function _postValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 value) internal virtual {}
}

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

import "./IEOARegistry.sol";
import "./ITransferSecurityRegistry.sol";
import "./ITransferValidator.sol";

interface ICreatorTokenTransferValidator is ITransferSecurityRegistry, ITransferValidator, IEOARegistry {}

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

import "../interfaces/ICreatorTokenTransferValidator.sol";

interface ICreatorToken {
    event TransferValidatorUpdated(address oldValidator, address newValidator);

    function getTransferValidator() external view returns (ICreatorTokenTransferValidator);
    function getSecurityPolicy() external view returns (CollectionSecurityPolicy memory);
    function getWhitelistedOperators() external view returns (address[] memory);
    function getPermittedContractReceivers() external view returns (address[] memory);
    function isOperatorWhitelisted(address operator) external view returns (bool);
    function isContractReceiverPermitted(address receiver) external view returns (bool);
    function isTransferAllowed(address caller, address from, address to) external view returns (bool);
}

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

import "@openzeppelin/contracts/utils/Context.sol";

abstract contract OwnablePermissions is Context {
    function _requireCallerIsContractOwner() internal view virtual;
}

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

import "../utils/TransferPolicy.sol";

interface ITransferValidator {
    function applyCollectionTransferPolicy(address caller, address from, address to) external view;
}

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

import "../utils/TransferPolicy.sol";

interface ITransferSecurityRegistry {
    event AddedToAllowlist(AllowlistTypes indexed kind, uint256 indexed id, address indexed account);
    event CreatedAllowlist(AllowlistTypes indexed kind, uint256 indexed id, string indexed name);
    event ReassignedAllowlistOwnership(AllowlistTypes indexed kind, uint256 indexed id, address indexed newOwner);
    event RemovedFromAllowlist(AllowlistTypes indexed kind, uint256 indexed id, address indexed account);
    event SetAllowlist(AllowlistTypes indexed kind, address indexed collection, uint120 indexed id);
    event SetTransferSecurityLevel(address indexed collection, TransferSecurityLevels level);

    function createOperatorWhitelist(string calldata name) external returns (uint120);
    function createPermittedContractReceiverAllowlist(string calldata name) external returns (uint120);
    function reassignOwnershipOfOperatorWhitelist(uint120 id, address newOwner) external;
    function reassignOwnershipOfPermittedContractReceiverAllowlist(uint120 id, address newOwner) external;
    function renounceOwnershipOfOperatorWhitelist(uint120 id) external;
    function renounceOwnershipOfPermittedContractReceiverAllowlist(uint120 id) external;
    function setTransferSecurityLevelOfCollection(address collection, TransferSecurityLevels level) external;
    function setOperatorWhitelistOfCollection(address collection, uint120 id) external;
    function setPermittedContractReceiverAllowlistOfCollection(address collection, uint120 id) external;
    function addOperatorToWhitelist(uint120 id, address operator) external;
    function addPermittedContractReceiverToAllowlist(uint120 id, address receiver) external;
    function removeOperatorFromWhitelist(uint120 id, address operator) external;
    function removePermittedContractReceiverFromAllowlist(uint120 id, address receiver) external;
    function getCollectionSecurityPolicy(address collection) external view returns (CollectionSecurityPolicy memory);
    function getWhitelistedOperators(uint120 id) external view returns (address[] memory);
    function getPermittedContractReceivers(uint120 id) external view returns (address[] memory);
    function isOperatorWhitelisted(uint120 id, address operator) external view returns (bool);
    function isContractReceiverPermitted(uint120 id, address receiver) external view returns (bool);
}

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

import "@openzeppelin/contracts/utils/introspection/IERC165.sol";

interface IEOARegistry is IERC165 {
    function isVerifiedEOA(address account) external view returns (bool);
}

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

enum AllowlistTypes {
    Operators,
    PermittedContractReceivers
}

enum ReceiverConstraints {
    None,
    NoCode,
    EOA
}

enum CallerConstraints {
    None,
    OperatorWhitelistEnableOTC,
    OperatorWhitelistDisableOTC
}

enum StakerConstraints {
    None,
    CallerIsTxOrigin,
    EOA
}

enum TransferSecurityLevels {
    Zero,
    One,
    Two,
    Three,
    Four,
    Five,
    Six
}

struct TransferSecurityPolicy {
    CallerConstraints callerConstraints;
    ReceiverConstraints receiverConstraints;
}

struct CollectionSecurityPolicy {
    TransferSecurityLevels transferSecurityLevel;
    uint120 operatorWhitelistId;
    uint120 permittedContractReceiversId;
}

{
  "optimizer": {
    "enabled": true,
    "runs": 200
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "abi"
      ]
    }
  },
  "remappings": []
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"royaltyReceiver_","type":"address"},{"internalType":"uint96","name":"royaltyFeeNumerator_","type":"uint96"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"CreatorTokenBase__InvalidTransferValidatorContract","type":"error"},{"inputs":[],"name":"CreatorTokenBase__SetTransferValidatorFirst","type":"error"},{"inputs":[{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidDefaultRoyalty","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidDefaultRoyaltyReceiver","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidTokenRoyalty","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidTokenRoyaltyReceiver","type":"error"},{"inputs":[],"name":"InsufficientEther","type":"error"},{"inputs":[],"name":"InvalidAmount","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"NotCompatibleWithSpotMints","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"SequentialMintExceedsLimit","type":"error"},{"inputs":[],"name":"SequentialUpToTooSmall","type":"error"},{"inputs":[],"name":"ShouldNotMintToBurnAddress","type":"error"},{"inputs":[],"name":"SoldOut","type":"error"},{"inputs":[],"name":"SpotMintTokenIdTooSmall","type":"error"},{"inputs":[],"name":"TokenAlreadyExists","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":false,"internalType":"uint256","name":"_fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_toTokenId","type":"uint256"}],"name":"BatchMetadataUpdate","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":"receiver","type":"address"},{"indexed":false,"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"DefaultRoyaltySet","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":"uint256","name":"tokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"TokenRoyaltySet","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"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldValidator","type":"address"},{"indexed":false,"internalType":"address","name":"newValidator","type":"address"}],"name":"TransferValidatorUpdated","type":"event"},{"inputs":[],"name":"DEFAULT_OPERATOR_WHITELIST_ID","outputs":[{"internalType":"uint120","name":"","type":"uint120"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_TRANSFER_SECURITY_LEVEL","outputs":[{"internalType":"enum TransferSecurityLevels","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_TRANSFER_VALIDATOR","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_SUPPLY","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"recipients","type":"address[]"},{"internalType":"uint256[]","name":"_amounts","type":"uint256[]"}],"name":"aidropMultiple","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","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":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"cost","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getPermittedContractReceivers","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getSecurityPolicy","outputs":[{"components":[{"internalType":"enum TransferSecurityLevels","name":"transferSecurityLevel","type":"uint8"},{"internalType":"uint120","name":"operatorWhitelistId","type":"uint120"},{"internalType":"uint120","name":"permittedContractReceiversId","type":"uint120"}],"internalType":"struct CollectionSecurityPolicy","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getTransferValidator","outputs":[{"internalType":"contract ICreatorTokenTransferValidator","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getWhitelistedOperators","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"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":[{"internalType":"address","name":"receiver","type":"address"}],"name":"isContractReceiverPermitted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"isOperatorWhitelisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"caller","type":"address"},{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"}],"name":"isTransferAllowed","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"payable","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":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"","type":"address"},{"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":"safeTransferFrom","outputs":[],"stateMutability":"payable","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":"payable","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":"_newBaseURI","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_newCost","type":"uint256"}],"name":"setCost","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_mintStatus","type":"bool"}],"name":"setMintStatus","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"enum TransferSecurityLevels","name":"level","type":"uint8"},{"internalType":"uint120","name":"operatorWhitelistId","type":"uint120"},{"internalType":"uint120","name":"permittedContractReceiversAllowlistId","type":"uint120"}],"name":"setToCustomSecurityPolicy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"},{"internalType":"enum TransferSecurityLevels","name":"level","type":"uint8"},{"internalType":"uint120","name":"operatorWhitelistId","type":"uint120"},{"internalType":"uint120","name":"permittedContractReceiversAllowlistId","type":"uint120"}],"name":"setToCustomValidatorAndSecurityPolicy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"setToDefaultSecurityPolicy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setTokenRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"transferValidator_","type":"address"}],"name":"setTransferValidator","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":"result","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":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"treasuryMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"payable","type":"function"}]

6729a2241af62c0000600d5560e06040526036608081815290620032ed60a039600e906200002e90826200030c565b50600f805460ff1916600117905534801562000048575f80fd5b5060405162003323380380620033238339810160408190526200006b91620003d4565b818133604051806060016040528060228152602001620032cb6022913960408051808201909152600681526543415943524d60d01b602082015281816002620000b583826200030c565b506003620000c482826200030c565b505060015f555050506001600160a01b038116620000fc57604051631e4fbdf760e01b81525f60048201526024015b60405180910390fd5b62000107816200011e565b506200011482826200016f565b5050505062000425565b600a80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b6200017b8282620001c6565b6040516001600160601b03821681526001600160a01b038316907f8a8bae378cb731c5c40b632330c6836c2f916f48edb967699c86736f9a6a76ef9060200160405180910390a25050565b6127106001600160601b0382168110156200020757604051636f483d0960e01b81526001600160601b038316600482015260248101829052604401620000f3565b6001600160a01b0383166200023257604051635b6cc80560e11b81525f6004820152602401620000f3565b50604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600b55565b634e487b7160e01b5f52604160045260245ffd5b600181811c908216806200029557607f821691505b602082108103620002b457634e487b7160e01b5f52602260045260245ffd5b50919050565b601f82111562000307575f81815260208120601f850160051c81016020861015620002e25750805b601f850160051c820191505b818110156200030357828155600101620002ee565b5050505b505050565b81516001600160401b038111156200032857620003286200026c565b620003408162000339845462000280565b84620002ba565b602080601f83116001811462000376575f84156200035e5750858301515b5f19600386901b1c1916600185901b17855562000303565b5f85815260208120601f198616915b82811015620003a65788860151825594840194600190910190840162000385565b5085821015620003c457878501515f19600388901b60f8161c191681555b5050505050600190811b01905550565b5f8060408385031215620003e6575f80fd5b82516001600160a01b0381168114620003fd575f80fd5b60208401519092506001600160601b03811681146200041a575f80fd5b809150509250929050565b612e9880620004335f395ff3fe60806040526004361061026a575f3560e01c80635944c7531161014a578063a0712d68116100be578063c87b56dd11610078578063c87b56dd14610703578063d007af5c14610722578063e985e9c514610736578063efdc77881461077d578063f2fde38b1461079c578063fd762d92146107bb575f80fd5b8063a0712d681461065f578063a22cb46514610672578063a9fc664e14610691578063ae521624146106b0578063b88d4fde146106cf578063be537f43146106e2575f80fd5b80636c3b86991161010f5780636c3b8699146105c857806370a08231146105dc578063715018a6146105fb5780638da5cb5b1461060f57806395d89b411461062c5780639d645a4414610640575f80fd5b80635944c7531461052b5780635d4c1d461461054a57806361347162146105765780636352211e146105955780636c0360eb146105b4575f80fd5b80631f85e3ca116101e15780633ccfd60b116101a65780633ccfd60b1461049257806342842e0e1461049a57806342966c68146104ad57806344a0d68a146104cc578063495c8bf9146104eb57806355f804b31461050c575f80fd5b80631f85e3ca146103ee57806323b872dd1461040d5780632a55205a146104205780632e8da8291461045e57806332cb6b0c1461047d575f80fd5b8063095ea7b311610232578063095ea7b314610340578063098144d41461035357806313faede61461037057806318160ddd146103935780631b25b077146103ae5780631c33b328146103cd575f80fd5b8063014635461461026e57806301ffc9a7146102b057806304634d8d146102df57806306fdde0314610300578063081812fc14610321575b5f80fd5b348015610279575f80fd5b5061029371721c310194ccfc01e523fc93c9cccfa2a0ac81565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156102bb575f80fd5b506102cf6102ca36600461238f565b6107da565b60405190151581526020016102a7565b3480156102ea575f80fd5b506102fe6102f93660046123d4565b610813565b005b34801561030b575f80fd5b50610314610829565b6040516102a79190612454565b34801561032c575f80fd5b5061029361033b366004612466565b6108b9565b6102fe61034e36600461247d565b6108f2565b34801561035e575f80fd5b506009546001600160a01b0316610293565b34801561037b575f80fd5b50610385600d5481565b6040519081526020016102a7565b34801561039e575f80fd5b506103856001545f54035f190190565b3480156103b9575f80fd5b506102cf6103c83660046124a7565b6108fe565b3480156103d8575f80fd5b506103e1600181565b6040516102a7919061250f565b3480156103f9575f80fd5b506102fe61040836600461252a565b610993565b6102fe61041b366004612545565b6109ae565b34801561042b575f80fd5b5061043f61043a366004612583565b610b2c565b604080516001600160a01b0390931683526020830191909152016102a7565b348015610469575f80fd5b506102cf6104783660046125a3565b610bd6565b348015610488575f80fd5b506103856101f481565b6102fe610cdc565b6102fe6104a8366004612545565b610d53565b3480156104b8575f80fd5b506102fe6104c7366004612466565b610d72565b3480156104d7575f80fd5b506102fe6104e6366004612466565b610d83565b3480156104f6575f80fd5b506104ff610d90565b6040516102a791906125be565b348015610517575f80fd5b506102fe6105263660046126a4565b610e9a565b348015610536575f80fd5b506102fe6105453660046126e9565b610efb565b348015610555575f80fd5b5061055e600181565b6040516001600160781b0390911681526020016102a7565b348015610581575f80fd5b506102fe610590366004612744565b610f0e565b3480156105a0575f80fd5b506102936105af366004612466565b611069565b3480156105bf575f80fd5b50610314611073565b3480156105d3575f80fd5b506102fe6110ff565b3480156105e7575f80fd5b506103856105f63660046125a3565b6111ee565b348015610606575f80fd5b506102fe611232565b34801561061a575f80fd5b50600a546001600160a01b0316610293565b348015610637575f80fd5b50610314611245565b34801561064b575f80fd5b506102cf61065a3660046125a3565b611254565b6102fe61066d366004612466565b611319565b34801561067d575f80fd5b506102fe61068c366004612781565b611403565b34801561069c575f80fd5b506102fe6106ab3660046125a3565b61147b565b3480156106bb575f80fd5b506102fe6106ca366004612843565b61159a565b6102fe6106dd3660046128ff565b6115fb565b3480156106ed575f80fd5b506106f6611636565b6040516102a7919061297a565b34801561070e575f80fd5b5061031461071d366004612466565b6116ed565b34801561072d575f80fd5b506104ff6117bd565b348015610741575f80fd5b506102cf6107503660046129b5565b6001600160a01b039182165f90815260076020908152604080832093909416825291909152205460ff1690565b348015610788575f80fd5b506102fe610797366004612466565b611874565b3480156107a7575f80fd5b506102fe6107b63660046125a3565b6118b8565b3480156107c6575f80fd5b506102fe6107d53660046129e1565b6118f2565b5f6001600160e01b03198216632483248360e11b14806107fe57506107fe826119e7565b8061080d575061080d826119e7565b92915050565b61081b611a1b565b6108258282611a31565b5050565b60606002805461083890612a3a565b80601f016020809104026020016040519081016040528092919081815260200182805461086490612a3a565b80156108af5780601f10610886576101008083540402835291602001916108af565b820191905f5260205f20905b81548152906001019060200180831161089257829003601f168201915b5050505050905090565b5f6108c382611a86565b6108d7576108d76333d1c03960e21b611ad0565b505f908152600660205260409020546001600160a01b031690565b61082582826001611ad8565b6009545f906001600160a01b0316156109885760095460405163050bf71960e31b81526001600160a01b038681166004830152858116602483015284811660448301529091169063285fb8c8906064015f6040518083038186803b158015610964575f80fd5b505afa925050508015610975575060015b61098057505f61098c565b50600161098c565b5060015b9392505050565b61099b611b79565b600f805460ff1916911515919091179055565b5f6109b882611ba6565b6001600160a01b0394851694909150811684146109de576109de62a1148160e81b611ad0565b5f8281526006602052604090208054610a098187335b6001600160a01b039081169116811491141790565b610a2b57610a178633610750565b610a2b57610a2b632ce44b5f60e11b611ad0565b610a388686866001611c3f565b8015610a42575f82555b6001600160a01b038681165f9081526005602052604080822080545f19019055918716808252919020805460010190554260a01b17600160e11b175f85815260046020526040812091909155600160e11b84169003610ace57600184015f818152600460205260408120549003610acc575f548114610acc575f8181526004602052604090208490555b505b6001600160a01b0385168481887fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef5f80a4805f03610b1657610b16633a954ecd60e21b611ad0565b610b238787876001611c6c565b50505050505050565b5f828152600c602090815260408083208151808301909252546001600160a01b038116808352600160a01b9091046001600160601b0316928201929092528291610ba0575060408051808201909152600b546001600160a01b0381168252600160a01b90046001600160601b031660208201525b60208101515f9061271090610bbe906001600160601b031687612a86565b610bc89190612a9d565b915196919550909350505050565b6009545f906001600160a01b031615610cd557600954604051635caaa2a960e11b81523060048201526001600160a01b039091169063d72dde5e90829063b955455290602401606060405180830381865afa158015610c37573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610c5b9190612abc565b602001516040516001600160e01b031960e084901b1681526001600160781b0390911660048201526001600160a01b03851660248201526044015b602060405180830381865afa158015610cb1573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061080d9190612b2c565b505f919050565b610ce4611b79565b5f610cf7600a546001600160a01b031690565b6001600160a01b0316476040515f6040518083038185875af1925050503d805f8114610d3e576040519150601f19603f3d011682016040523d82523d5f602084013e610d43565b606091505b5050905080610d50575f80fd5b50565b610d6d83838360405180602001604052805f8152506115fb565b505050565b610d7a611b79565b610d5081611c92565b610d8b611b79565b600d55565b6009546060906001600160a01b031615610e8857600954604051635caaa2a960e11b81523060048201526001600160a01b0390911690633fe5df9990829063b955455290602401606060405180830381865afa158015610df2573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610e169190612abc565b602001516040516001600160e01b031960e084901b1681526001600160781b0390911660048201526024015b5f60405180830381865afa158015610e5c573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052610e839190810190612b47565b905090565b50604080515f81526020810190915290565b610ea2611b79565b600e610eae8282612c29565b507f6bd5c950a8d8df17f772f5af37cb3655737899cbf903264b9795592da439661c5f610ee06001545f54035f190190565b6040805192835260208301919091520160405180910390a150565b610f03611a1b565b610d6d838383611c9c565b610f16611a1b565b5f610f296009546001600160a01b031690565b90506001600160a01b038116610f5257604051631cffe3dd60e11b815260040160405180910390fd5b604051630368065360e61b81526001600160a01b0382169063da0194c090610f809030908890600401612ce5565b5f604051808303815f87803b158015610f97575f80fd5b505af1158015610fa9573d5f803e3d5ffd5b5050604051631182550160e11b81526001600160a01b0384169250632304aa029150610fdb9030908790600401612d02565b5f604051808303815f87803b158015610ff2575f80fd5b505af1158015611004573d5f803e3d5ffd5b505060405163235d10c560e21b81526001600160a01b0384169250638d74431491506110369030908690600401612d02565b5f604051808303815f87803b15801561104d575f80fd5b505af115801561105f573d5f803e3d5ffd5b5050505050505050565b5f61080d82611ba6565b600e805461108090612a3a565b80601f01602080910402602001604051908101604052809291908181526020018280546110ac90612a3a565b80156110f75780601f106110ce576101008083540402835291602001916110f7565b820191905f5260205f20905b8154815290600101906020018083116110da57829003601f168201915b505050505081565b611107611a1b565b61112271721c310194ccfc01e523fc93c9cccfa2a0ac61147b565b604051630368065360e61b815271721c310194ccfc01e523fc93c9cccfa2a0ac9063da0194c09061115a903090600190600401612ce5565b5f604051808303815f87803b158015611171575f80fd5b505af1158015611183573d5f803e3d5ffd5b5050604051631182550160e11b815271721c310194ccfc01e523fc93c9cccfa2a0ac9250632304aa0291506111bf903090600190600401612d02565b5f604051808303815f87803b1580156111d6575f80fd5b505af11580156111e8573d5f803e3d5ffd5b50505050565b5f6001600160a01b03821661120d5761120d6323d3ad8160e21b611ad0565b506001600160a01b03165f9081526005602052604090205467ffffffffffffffff1690565b61123a611b79565b6112435f611cf5565b565b60606003805461083890612a3a565b6009545f906001600160a01b031615610cd557600954604051635caaa2a960e11b81523060048201526001600160a01b0390911690639445f53090829063b955455290602401606060405180830381865afa1580156112b5573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906112d99190612abc565b60409081015190516001600160e01b031960e084901b1681526001600160781b0390911660048201526001600160a01b0385166024820152604401610c96565b600f5460ff166113705760405162461bcd60e51b815260206004820152601960248201527f4d696e7420686173206265656e207475726e6564206f66662e0000000000000060448201526064015b60405180910390fd5b6101f4816113836001545f54035f190190565b61138d9190612d24565b11156113ac576040516352df9fe560e01b815260040160405180910390fd5b5f81116113cc5760405163162908e360e11b815260040160405180910390fd5b600d546113d99082612a86565b3410156113f957604051631c0b171360e31b815260040160405180910390fd5b610d503382611d46565b335f8181526007602090815260408083206001600160a01b0387168085529252909120805460ff1916841515179055906001600160a01b03167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c318360405161146f911515815260200190565b60405180910390a35050565b611483611a1b565b5f6001600160a01b0382163b156114fc576040516301ffc9a760e01b81525f60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa9250505080156114f4575060408051601f3d908101601f191682019092526114f191810190612b2c565b60015b156114fc5790505b6001600160a01b03821615801590611512575080155b15611530576040516332483afb60e01b815260040160405180910390fd5b600954604080516001600160a01b03928316815291841660208301527fcc5dc080ff977b3c3a211fa63ab74f90f658f5ba9d3236e92c8f59570f442aac910160405180910390a150600980546001600160a01b0319166001600160a01b0392909216919091179055565b6115a2611b79565b5f5b8251811015610d6d576115e98382815181106115c2576115c2612d37565b60200260200101518383815181106115dc576115dc612d37565b6020026020010151611d46565b806115f381612d4b565b9150506115a4565b6116068484846109ae565b6001600160a01b0383163b156111e85761162284848484611d5f565b6111e8576111e86368d2bf6b60e11b611ad0565b604080516060810182525f80825260208201819052918101919091526009546001600160a01b0316156116cd57600954604051635caaa2a960e11b81523060048201526001600160a01b039091169063b955455290602401606060405180830381865afa1580156116a9573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610e839190612abc565b50604080516060810182525f808252602082018190529181019190915290565b60606116f882611a86565b6117635760405162461bcd60e51b815260206004820152603660248201527f4572723a20455243373231414d65746164617461202d20555249207175657279604482015275103337b9103737b732bc34b9ba32b73a103a37b5b2b760511b6064820152608401611367565b5f600e805461177190612a3a565b90501161178c5760405180602001604052805f81525061080d565b600e61179783611e3e565b6040516020016117a8929190612d63565b60405160208183030381529060405292915050565b6009546060906001600160a01b031615610e8857600954604051635caaa2a960e11b81523060048201526001600160a01b03909116906317e94a6c90829063b955455290602401606060405180830381865afa15801561181f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118439190612abc565b60409081015190516001600160e01b031960e084901b1681526001600160781b039091166004820152602401610e42565b61187c611b79565b6101f48161188f6001545f54035f190190565b6118999190612d24565b11156113f9576040516352df9fe560e01b815260040160405180910390fd5b6118c0611b79565b6001600160a01b0381166118e957604051631e4fbdf760e01b81525f6004820152602401611367565b610d5081611cf5565b6118fa611a1b565b6119038461147b565b604051630368065360e61b81526001600160a01b0385169063da0194c0906119319030908790600401612ce5565b5f604051808303815f87803b158015611948575f80fd5b505af115801561195a573d5f803e3d5ffd5b5050604051631182550160e11b81526001600160a01b0387169250632304aa02915061198c9030908690600401612d02565b5f604051808303815f87803b1580156119a3575f80fd5b505af11580156119b5573d5f803e3d5ffd5b505060405163235d10c560e21b81526001600160a01b0387169250638d74431491506110369030908590600401612d02565b5f6001600160e01b0319821663152a902d60e11b148061080d57506301ffc9a760e01b6001600160e01b031983161461080d565b600a546001600160a01b03163314611243575f80fd5b611a3b8282611e81565b6040516001600160601b03821681526001600160a01b038316907f8a8bae378cb731c5c40b632330c6836c2f916f48edb967699c86736f9a6a76ef9060200160405180910390a25050565b5f81600111611acb575f54821015611acb575f5b505f8281526004602052604081205490819003611ac157611aba83612df6565b9250611a9a565b600160e01b161590505b919050565b805f5260045ffd5b5f611ae283611069565b9050818015611afa5750336001600160a01b03821614155b15611b1d57611b098133610750565b611b1d57611b1d6367d9dca160e11b611ad0565b5f8381526006602052604080822080546001600160a01b0319166001600160a01b0388811691821790925591518693918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a450505050565b600a546001600160a01b031633146112435760405163118cdaa760e01b8152336004820152602401611367565b5f81600111611c2f57505f81815260046020526040902054805f03611c1d575f548210611bdd57611bdd636f96cda160e11b611ad0565b5b505f19015f818152600460205260409020548015611bde57600160e01b81165f03611c0857919050565b611c18636f96cda160e11b611ad0565b611bde565b600160e01b81165f03611c2f57919050565b611acb636f96cda160e11b611ad0565b5f5b81811015611c6557611c5d8585611c588487612d24565b611f23565b600101611c41565b5050505050565b5f5b81811015611c6557611c8a8585611c858487612d24565b611f79565b600101611c6e565b610d50815f611fc0565b611ca7838383612111565b6040516001600160601b03821681526001600160a01b0383169084907f7f5b076c952c0ec86e5425963c1326dd0f03a3595c19f81d765e8ff559a6e33c9060200160405180910390a3505050565b600a80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b610825828260405180602001604052805f8152506121d1565b604051630a85bd0160e11b81525f906001600160a01b0385169063150b7a0290611d93903390899088908890600401612e0b565b6020604051808303815f875af1925050508015611dcd575060408051601f3d908101601f19168201909252611dca91810190612e47565b60015b611e20573d808015611dfa576040519150601f19603f3d011682016040523d82523d5f602084013e611dff565b606091505b5080515f03611e1857611e186368d2bf6b60e11b611ad0565b805181602001fd5b6001600160e01b031916630a85bd0160e11b1490505b949350505050565b606060a06040510180604052602081039150505f815280825b600183039250600a81066030018353600a900480611e575750819003601f19909101908152919050565b6127106001600160601b038216811015611ec057604051636f483d0960e01b81526001600160601b038316600482015260248101829052604401611367565b6001600160a01b038316611ee957604051635b6cc80560e11b81525f6004820152602401611367565b50604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600b55565b6001600160a01b038381161590831615818015611f3d5750805b15611f5b57604051635cbd944160e01b815260040160405180910390fd5b8115611f67575b611c65565b80611f6257611c65338686863461222a565b6001600160a01b038381161590831615818015611f935750805b15611fb157604051635cbd944160e01b815260040160405180910390fd5b81611f625780611f6257611c65565b5f611fca83611ba6565b9050805f80611fe6865f90815260066020526040902080549091565b91509150841561201d57611ffb8184336109f4565b61201d576120098333610750565b61201d5761201d632ce44b5f60e11b611ad0565b61202a835f886001611c3f565b8015612034575f82555b6001600160a01b0383165f81815260056020526040902080546fffffffffffffffffffffffffffffffff0190554260a01b17600360e01b175f87815260046020526040812091909155600160e11b851690036120bd57600186015f8181526004602052604081205490036120bb575f5481146120bb575f8181526004602052604090208590555b505b60405186905f906001600160a01b038616907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908390a4612101835f886001611c6c565b5050600180548101905550505050565b6127106001600160601b0382168110156121575760405163dfd1fc1b60e01b8152600481018590526001600160601b038316602482015260448101829052606401611367565b6001600160a01b03831661218757604051634b4f842960e11b8152600481018590525f6024820152604401611367565b506040805180820182526001600160a01b0393841681526001600160601b0392831660208083019182525f968752600c90529190942093519051909116600160a01b029116179055565b6121db83836122ab565b6001600160a01b0383163b15610d6d575f548281035b6122035f868380600101945086611d5f565b612217576122176368d2bf6b60e11b611ad0565b8181106121f157815f5414611c65575f80fd5b6009546001600160a01b031615611c655760095460405163050bf71960e31b81526001600160a01b038781166004830152868116602483015285811660448301529091169063285fb8c8906064015f6040518083038186803b15801561228e575f80fd5b505afa1580156122a0573d5f803e3d5ffd5b505050505050505050565b5f8054908290036122c6576122c663b562e8dd60e01b611ad0565b6122d25f848385611c3f565b5f8181526004602090815260408083206001600160a01b0387164260a01b6001881460e11b1781179091558084526005909252822080546801000000000000000186020190559081900361232f5761232f622e076360e81b611ad0565b818301825b80835f7fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef5f80a481816001019150810361233457505f908155610d6d9150848385611c6c565b6001600160e01b031981168114610d50575f80fd5b5f6020828403121561239f575f80fd5b813561098c8161237a565b6001600160a01b0381168114610d50575f80fd5b80356001600160601b0381168114611acb575f80fd5b5f80604083850312156123e5575f80fd5b82356123f0816123aa565b91506123fe602084016123be565b90509250929050565b5f5b83811015612421578181015183820152602001612409565b50505f910152565b5f8151808452612440816020860160208601612407565b601f01601f19169290920160200192915050565b602081525f61098c6020830184612429565b5f60208284031215612476575f80fd5b5035919050565b5f806040838503121561248e575f80fd5b8235612499816123aa565b946020939093013593505050565b5f805f606084860312156124b9575f80fd5b83356124c4816123aa565b925060208401356124d4816123aa565b915060408401356124e4816123aa565b809150509250925092565b6007811061250b57634e487b7160e01b5f52602160045260245ffd5b9052565b6020810161080d82846124ef565b8015158114610d50575f80fd5b5f6020828403121561253a575f80fd5b813561098c8161251d565b5f805f60608486031215612557575f80fd5b8335612562816123aa565b92506020840135612572816123aa565b929592945050506040919091013590565b5f8060408385031215612594575f80fd5b50508035926020909101359150565b5f602082840312156125b3575f80fd5b813561098c816123aa565b602080825282518282018190525f9190848201906040850190845b818110156125fe5783516001600160a01b0316835292840192918401916001016125d9565b50909695505050505050565b634e487b7160e01b5f52604160045260245ffd5b604051601f8201601f1916810167ffffffffffffffff811182821017156126475761264761260a565b604052919050565b5f67ffffffffffffffff8311156126685761266861260a565b61267b601f8401601f191660200161261e565b905082815283838301111561268e575f80fd5b828260208301375f602084830101529392505050565b5f602082840312156126b4575f80fd5b813567ffffffffffffffff8111156126ca575f80fd5b8201601f810184136126da575f80fd5b611e368482356020840161264f565b5f805f606084860312156126fb575f80fd5b83359250602084013561270d816123aa565b915061271b604085016123be565b90509250925092565b60078110610d50575f80fd5b6001600160781b0381168114610d50575f80fd5b5f805f60608486031215612756575f80fd5b833561276181612724565b9250602084013561277181612730565b915060408401356124e481612730565b5f8060408385031215612792575f80fd5b823561279d816123aa565b915060208301356127ad8161251d565b809150509250929050565b5f67ffffffffffffffff8211156127d1576127d161260a565b5060051b60200190565b5f82601f8301126127ea575f80fd5b813560206127ff6127fa836127b8565b61261e565b82815260059290921b8401810191818101908684111561281d575f80fd5b8286015b848110156128385780358352918301918301612821565b509695505050505050565b5f8060408385031215612854575f80fd5b823567ffffffffffffffff8082111561286b575f80fd5b818501915085601f83011261287e575f80fd5b8135602061288e6127fa836127b8565b82815260059290921b840181019181810190898411156128ac575f80fd5b948201945b838610156128d35785356128c4816123aa565b825294820194908201906128b1565b965050860135925050808211156128e8575f80fd5b506128f5858286016127db565b9150509250929050565b5f805f8060808587031215612912575f80fd5b843561291d816123aa565b9350602085013561292d816123aa565b925060408501359150606085013567ffffffffffffffff81111561294f575f80fd5b8501601f8101871361295f575f80fd5b61296e8782356020840161264f565b91505092959194509250565b5f60608201905061298c8284516124ef565b60208301516001600160781b038082166020850152806040860151166040850152505092915050565b5f80604083850312156129c6575f80fd5b82356129d1816123aa565b915060208301356127ad816123aa565b5f805f80608085870312156129f4575f80fd5b84356129ff816123aa565b93506020850135612a0f81612724565b92506040850135612a1f81612730565b91506060850135612a2f81612730565b939692955090935050565b600181811c90821680612a4e57607f821691505b602082108103612a6c57634e487b7160e01b5f52602260045260245ffd5b50919050565b634e487b7160e01b5f52601160045260245ffd5b808202811582820484141761080d5761080d612a72565b5f82612ab757634e487b7160e01b5f52601260045260245ffd5b500490565b5f60608284031215612acc575f80fd5b6040516060810181811067ffffffffffffffff82111715612aef57612aef61260a565b6040528251612afd81612724565b81526020830151612b0d81612730565b60208201526040830151612b2081612730565b60408201529392505050565b5f60208284031215612b3c575f80fd5b815161098c8161251d565b5f6020808385031215612b58575f80fd5b825167ffffffffffffffff811115612b6e575f80fd5b8301601f81018513612b7e575f80fd5b8051612b8c6127fa826127b8565b81815260059190911b82018301908381019087831115612baa575f80fd5b928401925b82841015612bd1578351612bc2816123aa565b82529284019290840190612baf565b979650505050505050565b601f821115610d6d575f81815260208120601f850160051c81016020861015612c025750805b601f850160051c820191505b81811015612c2157828155600101612c0e565b505050505050565b815167ffffffffffffffff811115612c4357612c4361260a565b612c5781612c518454612a3a565b84612bdc565b602080601f831160018114612c8a575f8415612c735750858301515b5f19600386901b1c1916600185901b178555612c21565b5f85815260208120601f198616915b82811015612cb857888601518255948401946001909101908401612c99565b5085821015612cd557878501515f19600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b03831681526040810161098c60208301846124ef565b6001600160a01b039290921682526001600160781b0316602082015260400190565b8082018082111561080d5761080d612a72565b634e487b7160e01b5f52603260045260245ffd5b5f60018201612d5c57612d5c612a72565b5060010190565b5f808454612d7081612a3a565b60018281168015612d885760018114612d9d57612dc9565b60ff1984168752821515830287019450612dc9565b885f526020805f205f5b85811015612dc05781548a820152908401908201612da7565b50505082870194505b505050508351612ddd818360208801612407565b64173539b7b760d91b9101908152600501949350505050565b5f81612e0457612e04612a72565b505f190190565b6001600160a01b03858116825284166020820152604081018390526080606082018190525f90612e3d90830184612429565b9695505050505050565b5f60208284031215612e57575f80fd5b815161098c8161237a56fea26469706673582212205788961b5c7bd9993534a717c480de668976dea4a6a605050eb1cfbf65de2ebb64736f6c6343000814003343796265722041706520596163687420436c7562202d20526172697479204d696e74697066733a2f2f516d51765571705167775233726e3845583941474e396f4c75686978594a756b334450314c6a4b345257726751702f0000000000000000000000004c2b3f96659eb882a0c1b2beda911684faf13f9d00000000000000000000000000000000000000000000000000000000000003e8

0x60806040526004361061026a575f3560e01c80635944c7531161014a578063a0712d68116100be578063c87b56dd11610078578063c87b56dd14610703578063d007af5c14610722578063e985e9c514610736578063efdc77881461077d578063f2fde38b1461079c578063fd762d92146107bb575f80fd5b8063a0712d681461065f578063a22cb46514610672578063a9fc664e14610691578063ae521624146106b0578063b88d4fde146106cf578063be537f43146106e2575f80fd5b80636c3b86991161010f5780636c3b8699146105c857806370a08231146105dc578063715018a6146105fb5780638da5cb5b1461060f57806395d89b411461062c5780639d645a4414610640575f80fd5b80635944c7531461052b5780635d4c1d461461054a57806361347162146105765780636352211e146105955780636c0360eb146105b4575f80fd5b80631f85e3ca116101e15780633ccfd60b116101a65780633ccfd60b1461049257806342842e0e1461049a57806342966c68146104ad57806344a0d68a146104cc578063495c8bf9146104eb57806355f804b31461050c575f80fd5b80631f85e3ca146103ee57806323b872dd1461040d5780632a55205a146104205780632e8da8291461045e57806332cb6b0c1461047d575f80fd5b8063095ea7b311610232578063095ea7b314610340578063098144d41461035357806313faede61461037057806318160ddd146103935780631b25b077146103ae5780631c33b328146103cd575f80fd5b8063014635461461026e57806301ffc9a7146102b057806304634d8d146102df57806306fdde0314610300578063081812fc14610321575b5f80fd5b348015610279575f80fd5b5061029371721c310194ccfc01e523fc93c9cccfa2a0ac81565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156102bb575f80fd5b506102cf6102ca36600461238f565b6107da565b60405190151581526020016102a7565b3480156102ea575f80fd5b506102fe6102f93660046123d4565b610813565b005b34801561030b575f80fd5b50610314610829565b6040516102a79190612454565b34801561032c575f80fd5b5061029361033b366004612466565b6108b9565b6102fe61034e36600461247d565b6108f2565b34801561035e575f80fd5b506009546001600160a01b0316610293565b34801561037b575f80fd5b50610385600d5481565b6040519081526020016102a7565b34801561039e575f80fd5b506103856001545f54035f190190565b3480156103b9575f80fd5b506102cf6103c83660046124a7565b6108fe565b3480156103d8575f80fd5b506103e1600181565b6040516102a7919061250f565b3480156103f9575f80fd5b506102fe61040836600461252a565b610993565b6102fe61041b366004612545565b6109ae565b34801561042b575f80fd5b5061043f61043a366004612583565b610b2c565b604080516001600160a01b0390931683526020830191909152016102a7565b348015610469575f80fd5b506102cf6104783660046125a3565b610bd6565b348015610488575f80fd5b506103856101f481565b6102fe610cdc565b6102fe6104a8366004612545565b610d53565b3480156104b8575f80fd5b506102fe6104c7366004612466565b610d72565b3480156104d7575f80fd5b506102fe6104e6366004612466565b610d83565b3480156104f6575f80fd5b506104ff610d90565b6040516102a791906125be565b348015610517575f80fd5b506102fe6105263660046126a4565b610e9a565b348015610536575f80fd5b506102fe6105453660046126e9565b610efb565b348015610555575f80fd5b5061055e600181565b6040516001600160781b0390911681526020016102a7565b348015610581575f80fd5b506102fe610590366004612744565b610f0e565b3480156105a0575f80fd5b506102936105af366004612466565b611069565b3480156105bf575f80fd5b50610314611073565b3480156105d3575f80fd5b506102fe6110ff565b3480156105e7575f80fd5b506103856105f63660046125a3565b6111ee565b348015610606575f80fd5b506102fe611232565b34801561061a575f80fd5b50600a546001600160a01b0316610293565b348015610637575f80fd5b50610314611245565b34801561064b575f80fd5b506102cf61065a3660046125a3565b611254565b6102fe61066d366004612466565b611319565b34801561067d575f80fd5b506102fe61068c366004612781565b611403565b34801561069c575f80fd5b506102fe6106ab3660046125a3565b61147b565b3480156106bb575f80fd5b506102fe6106ca366004612843565b61159a565b6102fe6106dd3660046128ff565b6115fb565b3480156106ed575f80fd5b506106f6611636565b6040516102a7919061297a565b34801561070e575f80fd5b5061031461071d366004612466565b6116ed565b34801561072d575f80fd5b506104ff6117bd565b348015610741575f80fd5b506102cf6107503660046129b5565b6001600160a01b039182165f90815260076020908152604080832093909416825291909152205460ff1690565b348015610788575f80fd5b506102fe610797366004612466565b611874565b3480156107a7575f80fd5b506102fe6107b63660046125a3565b6118b8565b3480156107c6575f80fd5b506102fe6107d53660046129e1565b6118f2565b5f6001600160e01b03198216632483248360e11b14806107fe57506107fe826119e7565b8061080d575061080d826119e7565b92915050565b61081b611a1b565b6108258282611a31565b5050565b60606002805461083890612a3a565b80601f016020809104026020016040519081016040528092919081815260200182805461086490612a3a565b80156108af5780601f10610886576101008083540402835291602001916108af565b820191905f5260205f20905b81548152906001019060200180831161089257829003601f168201915b5050505050905090565b5f6108c382611a86565b6108d7576108d76333d1c03960e21b611ad0565b505f908152600660205260409020546001600160a01b031690565b61082582826001611ad8565b6009545f906001600160a01b0316156109885760095460405163050bf71960e31b81526001600160a01b038681166004830152858116602483015284811660448301529091169063285fb8c8906064015f6040518083038186803b158015610964575f80fd5b505afa925050508015610975575060015b61098057505f61098c565b50600161098c565b5060015b9392505050565b61099b611b79565b600f805460ff1916911515919091179055565b5f6109b882611ba6565b6001600160a01b0394851694909150811684146109de576109de62a1148160e81b611ad0565b5f8281526006602052604090208054610a098187335b6001600160a01b039081169116811491141790565b610a2b57610a178633610750565b610a2b57610a2b632ce44b5f60e11b611ad0565b610a388686866001611c3f565b8015610a42575f82555b6001600160a01b038681165f9081526005602052604080822080545f19019055918716808252919020805460010190554260a01b17600160e11b175f85815260046020526040812091909155600160e11b84169003610ace57600184015f818152600460205260408120549003610acc575f548114610acc575f8181526004602052604090208490555b505b6001600160a01b0385168481887fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef5f80a4805f03610b1657610b16633a954ecd60e21b611ad0565b610b238787876001611c6c565b50505050505050565b5f828152600c602090815260408083208151808301909252546001600160a01b038116808352600160a01b9091046001600160601b0316928201929092528291610ba0575060408051808201909152600b546001600160a01b0381168252600160a01b90046001600160601b031660208201525b60208101515f9061271090610bbe906001600160601b031687612a86565b610bc89190612a9d565b915196919550909350505050565b6009545f906001600160a01b031615610cd557600954604051635caaa2a960e11b81523060048201526001600160a01b039091169063d72dde5e90829063b955455290602401606060405180830381865afa158015610c37573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610c5b9190612abc565b602001516040516001600160e01b031960e084901b1681526001600160781b0390911660048201526001600160a01b03851660248201526044015b602060405180830381865afa158015610cb1573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061080d9190612b2c565b505f919050565b610ce4611b79565b5f610cf7600a546001600160a01b031690565b6001600160a01b0316476040515f6040518083038185875af1925050503d805f8114610d3e576040519150601f19603f3d011682016040523d82523d5f602084013e610d43565b606091505b5050905080610d50575f80fd5b50565b610d6d83838360405180602001604052805f8152506115fb565b505050565b610d7a611b79565b610d5081611c92565b610d8b611b79565b600d55565b6009546060906001600160a01b031615610e8857600954604051635caaa2a960e11b81523060048201526001600160a01b0390911690633fe5df9990829063b955455290602401606060405180830381865afa158015610df2573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610e169190612abc565b602001516040516001600160e01b031960e084901b1681526001600160781b0390911660048201526024015b5f60405180830381865afa158015610e5c573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052610e839190810190612b47565b905090565b50604080515f81526020810190915290565b610ea2611b79565b600e610eae8282612c29565b507f6bd5c950a8d8df17f772f5af37cb3655737899cbf903264b9795592da439661c5f610ee06001545f54035f190190565b6040805192835260208301919091520160405180910390a150565b610f03611a1b565b610d6d838383611c9c565b610f16611a1b565b5f610f296009546001600160a01b031690565b90506001600160a01b038116610f5257604051631cffe3dd60e11b815260040160405180910390fd5b604051630368065360e61b81526001600160a01b0382169063da0194c090610f809030908890600401612ce5565b5f604051808303815f87803b158015610f97575f80fd5b505af1158015610fa9573d5f803e3d5ffd5b5050604051631182550160e11b81526001600160a01b0384169250632304aa029150610fdb9030908790600401612d02565b5f604051808303815f87803b158015610ff2575f80fd5b505af1158015611004573d5f803e3d5ffd5b505060405163235d10c560e21b81526001600160a01b0384169250638d74431491506110369030908690600401612d02565b5f604051808303815f87803b15801561104d575f80fd5b505af115801561105f573d5f803e3d5ffd5b5050505050505050565b5f61080d82611ba6565b600e805461108090612a3a565b80601f01602080910402602001604051908101604052809291908181526020018280546110ac90612a3a565b80156110f75780601f106110ce576101008083540402835291602001916110f7565b820191905f5260205f20905b8154815290600101906020018083116110da57829003601f168201915b505050505081565b611107611a1b565b61112271721c310194ccfc01e523fc93c9cccfa2a0ac61147b565b604051630368065360e61b815271721c310194ccfc01e523fc93c9cccfa2a0ac9063da0194c09061115a903090600190600401612ce5565b5f604051808303815f87803b158015611171575f80fd5b505af1158015611183573d5f803e3d5ffd5b5050604051631182550160e11b815271721c310194ccfc01e523fc93c9cccfa2a0ac9250632304aa0291506111bf903090600190600401612d02565b5f604051808303815f87803b1580156111d6575f80fd5b505af11580156111e8573d5f803e3d5ffd5b50505050565b5f6001600160a01b03821661120d5761120d6323d3ad8160e21b611ad0565b506001600160a01b03165f9081526005602052604090205467ffffffffffffffff1690565b61123a611b79565b6112435f611cf5565b565b60606003805461083890612a3a565b6009545f906001600160a01b031615610cd557600954604051635caaa2a960e11b81523060048201526001600160a01b0390911690639445f53090829063b955455290602401606060405180830381865afa1580156112b5573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906112d99190612abc565b60409081015190516001600160e01b031960e084901b1681526001600160781b0390911660048201526001600160a01b0385166024820152604401610c96565b600f5460ff166113705760405162461bcd60e51b815260206004820152601960248201527f4d696e7420686173206265656e207475726e6564206f66662e0000000000000060448201526064015b60405180910390fd5b6101f4816113836001545f54035f190190565b61138d9190612d24565b11156113ac576040516352df9fe560e01b815260040160405180910390fd5b5f81116113cc5760405163162908e360e11b815260040160405180910390fd5b600d546113d99082612a86565b3410156113f957604051631c0b171360e31b815260040160405180910390fd5b610d503382611d46565b335f8181526007602090815260408083206001600160a01b0387168085529252909120805460ff1916841515179055906001600160a01b03167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c318360405161146f911515815260200190565b60405180910390a35050565b611483611a1b565b5f6001600160a01b0382163b156114fc576040516301ffc9a760e01b81525f60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa9250505080156114f4575060408051601f3d908101601f191682019092526114f191810190612b2c565b60015b156114fc5790505b6001600160a01b03821615801590611512575080155b15611530576040516332483afb60e01b815260040160405180910390fd5b600954604080516001600160a01b03928316815291841660208301527fcc5dc080ff977b3c3a211fa63ab74f90f658f5ba9d3236e92c8f59570f442aac910160405180910390a150600980546001600160a01b0319166001600160a01b0392909216919091179055565b6115a2611b79565b5f5b8251811015610d6d576115e98382815181106115c2576115c2612d37565b60200260200101518383815181106115dc576115dc612d37565b6020026020010151611d46565b806115f381612d4b565b9150506115a4565b6116068484846109ae565b6001600160a01b0383163b156111e85761162284848484611d5f565b6111e8576111e86368d2bf6b60e11b611ad0565b604080516060810182525f80825260208201819052918101919091526009546001600160a01b0316156116cd57600954604051635caaa2a960e11b81523060048201526001600160a01b039091169063b955455290602401606060405180830381865afa1580156116a9573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610e839190612abc565b50604080516060810182525f808252602082018190529181019190915290565b60606116f882611a86565b6117635760405162461bcd60e51b815260206004820152603660248201527f4572723a20455243373231414d65746164617461202d20555249207175657279604482015275103337b9103737b732bc34b9ba32b73a103a37b5b2b760511b6064820152608401611367565b5f600e805461177190612a3a565b90501161178c5760405180602001604052805f81525061080d565b600e61179783611e3e565b6040516020016117a8929190612d63565b60405160208183030381529060405292915050565b6009546060906001600160a01b031615610e8857600954604051635caaa2a960e11b81523060048201526001600160a01b03909116906317e94a6c90829063b955455290602401606060405180830381865afa15801561181f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118439190612abc565b60409081015190516001600160e01b031960e084901b1681526001600160781b039091166004820152602401610e42565b61187c611b79565b6101f48161188f6001545f54035f190190565b6118999190612d24565b11156113f9576040516352df9fe560e01b815260040160405180910390fd5b6118c0611b79565b6001600160a01b0381166118e957604051631e4fbdf760e01b81525f6004820152602401611367565b610d5081611cf5565b6118fa611a1b565b6119038461147b565b604051630368065360e61b81526001600160a01b0385169063da0194c0906119319030908790600401612ce5565b5f604051808303815f87803b158015611948575f80fd5b505af115801561195a573d5f803e3d5ffd5b5050604051631182550160e11b81526001600160a01b0387169250632304aa02915061198c9030908690600401612d02565b5f604051808303815f87803b1580156119a3575f80fd5b505af11580156119b5573d5f803e3d5ffd5b505060405163235d10c560e21b81526001600160a01b0387169250638d74431491506110369030908590600401612d02565b5f6001600160e01b0319821663152a902d60e11b148061080d57506301ffc9a760e01b6001600160e01b031983161461080d565b600a546001600160a01b03163314611243575f80fd5b611a3b8282611e81565b6040516001600160601b03821681526001600160a01b038316907f8a8bae378cb731c5c40b632330c6836c2f916f48edb967699c86736f9a6a76ef9060200160405180910390a25050565b5f81600111611acb575f54821015611acb575f5b505f8281526004602052604081205490819003611ac157611aba83612df6565b9250611a9a565b600160e01b161590505b919050565b805f5260045ffd5b5f611ae283611069565b9050818015611afa5750336001600160a01b03821614155b15611b1d57611b098133610750565b611b1d57611b1d6367d9dca160e11b611ad0565b5f8381526006602052604080822080546001600160a01b0319166001600160a01b0388811691821790925591518693918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a450505050565b600a546001600160a01b031633146112435760405163118cdaa760e01b8152336004820152602401611367565b5f81600111611c2f57505f81815260046020526040902054805f03611c1d575f548210611bdd57611bdd636f96cda160e11b611ad0565b5b505f19015f818152600460205260409020548015611bde57600160e01b81165f03611c0857919050565b611c18636f96cda160e11b611ad0565b611bde565b600160e01b81165f03611c2f57919050565b611acb636f96cda160e11b611ad0565b5f5b81811015611c6557611c5d8585611c588487612d24565b611f23565b600101611c41565b5050505050565b5f5b81811015611c6557611c8a8585611c858487612d24565b611f79565b600101611c6e565b610d50815f611fc0565b611ca7838383612111565b6040516001600160601b03821681526001600160a01b0383169084907f7f5b076c952c0ec86e5425963c1326dd0f03a3595c19f81d765e8ff559a6e33c9060200160405180910390a3505050565b600a80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b610825828260405180602001604052805f8152506121d1565b604051630a85bd0160e11b81525f906001600160a01b0385169063150b7a0290611d93903390899088908890600401612e0b565b6020604051808303815f875af1925050508015611dcd575060408051601f3d908101601f19168201909252611dca91810190612e47565b60015b611e20573d808015611dfa576040519150601f19603f3d011682016040523d82523d5f602084013e611dff565b606091505b5080515f03611e1857611e186368d2bf6b60e11b611ad0565b805181602001fd5b6001600160e01b031916630a85bd0160e11b1490505b949350505050565b606060a06040510180604052602081039150505f815280825b600183039250600a81066030018353600a900480611e575750819003601f19909101908152919050565b6127106001600160601b038216811015611ec057604051636f483d0960e01b81526001600160601b038316600482015260248101829052604401611367565b6001600160a01b038316611ee957604051635b6cc80560e11b81525f6004820152602401611367565b50604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600b55565b6001600160a01b038381161590831615818015611f3d5750805b15611f5b57604051635cbd944160e01b815260040160405180910390fd5b8115611f67575b611c65565b80611f6257611c65338686863461222a565b6001600160a01b038381161590831615818015611f935750805b15611fb157604051635cbd944160e01b815260040160405180910390fd5b81611f625780611f6257611c65565b5f611fca83611ba6565b9050805f80611fe6865f90815260066020526040902080549091565b91509150841561201d57611ffb8184336109f4565b61201d576120098333610750565b61201d5761201d632ce44b5f60e11b611ad0565b61202a835f886001611c3f565b8015612034575f82555b6001600160a01b0383165f81815260056020526040902080546fffffffffffffffffffffffffffffffff0190554260a01b17600360e01b175f87815260046020526040812091909155600160e11b851690036120bd57600186015f8181526004602052604081205490036120bb575f5481146120bb575f8181526004602052604090208590555b505b60405186905f906001600160a01b038616907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908390a4612101835f886001611c6c565b5050600180548101905550505050565b6127106001600160601b0382168110156121575760405163dfd1fc1b60e01b8152600481018590526001600160601b038316602482015260448101829052606401611367565b6001600160a01b03831661218757604051634b4f842960e11b8152600481018590525f6024820152604401611367565b506040805180820182526001600160a01b0393841681526001600160601b0392831660208083019182525f968752600c90529190942093519051909116600160a01b029116179055565b6121db83836122ab565b6001600160a01b0383163b15610d6d575f548281035b6122035f868380600101945086611d5f565b612217576122176368d2bf6b60e11b611ad0565b8181106121f157815f5414611c65575f80fd5b6009546001600160a01b031615611c655760095460405163050bf71960e31b81526001600160a01b038781166004830152868116602483015285811660448301529091169063285fb8c8906064015f6040518083038186803b15801561228e575f80fd5b505afa1580156122a0573d5f803e3d5ffd5b505050505050505050565b5f8054908290036122c6576122c663b562e8dd60e01b611ad0565b6122d25f848385611c3f565b5f8181526004602090815260408083206001600160a01b0387164260a01b6001881460e11b1781179091558084526005909252822080546801000000000000000186020190559081900361232f5761232f622e076360e81b611ad0565b818301825b80835f7fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef5f80a481816001019150810361233457505f908155610d6d9150848385611c6c565b6001600160e01b031981168114610d50575f80fd5b5f6020828403121561239f575f80fd5b813561098c8161237a565b6001600160a01b0381168114610d50575f80fd5b80356001600160601b0381168114611acb575f80fd5b5f80604083850312156123e5575f80fd5b82356123f0816123aa565b91506123fe602084016123be565b90509250929050565b5f5b83811015612421578181015183820152602001612409565b50505f910152565b5f8151808452612440816020860160208601612407565b601f01601f19169290920160200192915050565b602081525f61098c6020830184612429565b5f60208284031215612476575f80fd5b5035919050565b5f806040838503121561248e575f80fd5b8235612499816123aa565b946020939093013593505050565b5f805f606084860312156124b9575f80fd5b83356124c4816123aa565b925060208401356124d4816123aa565b915060408401356124e4816123aa565b809150509250925092565b6007811061250b57634e487b7160e01b5f52602160045260245ffd5b9052565b6020810161080d82846124ef565b8015158114610d50575f80fd5b5f6020828403121561253a575f80fd5b813561098c8161251d565b5f805f60608486031215612557575f80fd5b8335612562816123aa565b92506020840135612572816123aa565b929592945050506040919091013590565b5f8060408385031215612594575f80fd5b50508035926020909101359150565b5f602082840312156125b3575f80fd5b813561098c816123aa565b602080825282518282018190525f9190848201906040850190845b818110156125fe5783516001600160a01b0316835292840192918401916001016125d9565b50909695505050505050565b634e487b7160e01b5f52604160045260245ffd5b604051601f8201601f1916810167ffffffffffffffff811182821017156126475761264761260a565b604052919050565b5f67ffffffffffffffff8311156126685761266861260a565b61267b601f8401601f191660200161261e565b905082815283838301111561268e575f80fd5b828260208301375f602084830101529392505050565b5f602082840312156126b4575f80fd5b813567ffffffffffffffff8111156126ca575f80fd5b8201601f810184136126da575f80fd5b611e368482356020840161264f565b5f805f606084860312156126fb575f80fd5b83359250602084013561270d816123aa565b915061271b604085016123be565b90509250925092565b60078110610d50575f80fd5b6001600160781b0381168114610d50575f80fd5b5f805f60608486031215612756575f80fd5b833561276181612724565b9250602084013561277181612730565b915060408401356124e481612730565b5f8060408385031215612792575f80fd5b823561279d816123aa565b915060208301356127ad8161251d565b809150509250929050565b5f67ffffffffffffffff8211156127d1576127d161260a565b5060051b60200190565b5f82601f8301126127ea575f80fd5b813560206127ff6127fa836127b8565b61261e565b82815260059290921b8401810191818101908684111561281d575f80fd5b8286015b848110156128385780358352918301918301612821565b509695505050505050565b5f8060408385031215612854575f80fd5b823567ffffffffffffffff8082111561286b575f80fd5b818501915085601f83011261287e575f80fd5b8135602061288e6127fa836127b8565b82815260059290921b840181019181810190898411156128ac575f80fd5b948201945b838610156128d35785356128c4816123aa565b825294820194908201906128b1565b965050860135925050808211156128e8575f80fd5b506128f5858286016127db565b9150509250929050565b5f805f8060808587031215612912575f80fd5b843561291d816123aa565b9350602085013561292d816123aa565b925060408501359150606085013567ffffffffffffffff81111561294f575f80fd5b8501601f8101871361295f575f80fd5b61296e8782356020840161264f565b91505092959194509250565b5f60608201905061298c8284516124ef565b60208301516001600160781b038082166020850152806040860151166040850152505092915050565b5f80604083850312156129c6575f80fd5b82356129d1816123aa565b915060208301356127ad816123aa565b5f805f80608085870312156129f4575f80fd5b84356129ff816123aa565b93506020850135612a0f81612724565b92506040850135612a1f81612730565b91506060850135612a2f81612730565b939692955090935050565b600181811c90821680612a4e57607f821691505b602082108103612a6c57634e487b7160e01b5f52602260045260245ffd5b50919050565b634e487b7160e01b5f52601160045260245ffd5b808202811582820484141761080d5761080d612a72565b5f82612ab757634e487b7160e01b5f52601260045260245ffd5b500490565b5f60608284031215612acc575f80fd5b6040516060810181811067ffffffffffffffff82111715612aef57612aef61260a565b6040528251612afd81612724565b81526020830151612b0d81612730565b60208201526040830151612b2081612730565b60408201529392505050565b5f60208284031215612b3c575f80fd5b815161098c8161251d565b5f6020808385031215612b58575f80fd5b825167ffffffffffffffff811115612b6e575f80fd5b8301601f81018513612b7e575f80fd5b8051612b8c6127fa826127b8565b81815260059190911b82018301908381019087831115612baa575f80fd5b928401925b82841015612bd1578351612bc2816123aa565b82529284019290840190612baf565b979650505050505050565b601f821115610d6d575f81815260208120601f850160051c81016020861015612c025750805b601f850160051c820191505b81811015612c2157828155600101612c0e565b505050505050565b815167ffffffffffffffff811115612c4357612c4361260a565b612c5781612c518454612a3a565b84612bdc565b602080601f831160018114612c8a575f8415612c735750858301515b5f19600386901b1c1916600185901b178555612c21565b5f85815260208120601f198616915b82811015612cb857888601518255948401946001909101908401612c99565b5085821015612cd557878501515f19600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b03831681526040810161098c60208301846124ef565b6001600160a01b039290921682526001600160781b0316602082015260400190565b8082018082111561080d5761080d612a72565b634e487b7160e01b5f52603260045260245ffd5b5f60018201612d5c57612d5c612a72565b5060010190565b5f808454612d7081612a3a565b60018281168015612d885760018114612d9d57612dc9565b60ff1984168752821515830287019450612dc9565b885f526020805f205f5b85811015612dc05781548a820152908401908201612da7565b50505082870194505b505050508351612ddd818360208801612407565b64173539b7b760d91b9101908152600501949350505050565b5f81612e0457612e04612a72565b505f190190565b6001600160a01b03858116825284166020820152604081018390526080606082018190525f90612e3d90830184612429565b9695505050505050565b5f60208284031215612e57575f80fd5b815161098c8161237a56fea26469706673582212205788961b5c7bd9993534a717c480de668976dea4a6a605050eb1cfbf65de2ebb64736f6c63430008140033

0000000000000000000000004c2b3f96659eb882a0c1b2beda911684faf13f9d00000000000000000000000000000000000000000000000000000000000003e8

-----Decoded View---------------
Arg [0] : royaltyReceiver_ (address): 0x4c2B3f96659Eb882A0C1B2BEdA911684FAf13f9d
Arg [1] : royaltyFeeNumerator_ (uint96): 1000

-----Encoded View---------------
2 Constructor Arguments found :
Arg [0] : 0000000000000000000000004c2b3f96659eb882a0c1b2beda911684faf13f9d
Arg [1] : 00000000000000000000000000000000000000000000000000000000000003e8

493:4500:20:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;1930:104:7;;;;;;;;;;;;1991:42;1930:104;;;;;-1:-1:-1;;;;;178:32:26;;;160:51;;148:2;133:18;1930:104:7;;;;;;;;4580:253:20;;;;;;;;;;-1:-1:-1;4580:253:20;;;;;:::i;:::-;;:::i;:::-;;;773:14:26;;766:22;748:41;;736:2;721:18;4580:253:20;608:187:26;4186:178:20;;;;;;;;;;-1:-1:-1;4186:178:20;;;;;:::i;:::-;;:::i;:::-;;11573:98:23;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;18636:223::-;;;;;;;;;;-1:-1:-1;18636:223:23;;;;;:::i;:::-;;:::i;18364:122::-;;;;;;:::i;:::-;;:::i;6358:135:7:-;;;;;;;;;;-1:-1:-1;6469:17:7;;-1:-1:-1;;;;;6469:17:7;6358:135;;695:29:20;;;;;;;;;;;;;;;;;;;3097:25:26;;;3085:2;3070:18;695:29:20;2951:177:26;6890:564:23;;;;;;;;;;;;2603:1:20;7328:12:23;6951:14;7312:13;:28;-1:-1:-1;;7312:46:23;;6890:564;10057:378:7;;;;;;;;;;-1:-1:-1;10057:378:7;;;;;:::i;:::-;;:::i;2040:99::-;;;;;;;;;;;;2113:26;2040:99;;;;;;;;;:::i;3987:100:20:-;;;;;;;;;;-1:-1:-1;3987:100:20;;;;;:::i;:::-;;:::i;22796:3447:23:-;;;;;;:::i;:::-;;:::i;2379:419:15:-;;;;;;;;;;-1:-1:-1;2379:419:15;;;;;:::i;:::-;;:::i;:::-;;;;-1:-1:-1;;;;;5567:32:26;;;5549:51;;5631:2;5616:18;;5609:34;;;;5522:18;2379:419:15;5375:274:26;8437:350:7;;;;;;;;;;-1:-1:-1;8437:350:7;;;;;:::i;:::-;;:::i;648:40:20:-;;;;;;;;;;;;685:3;648:40;;3278:335;;;:::i;26334:187:23:-;;;;;;:::i;:::-;;:::i;4095:83:20:-;;;;;;;;;;-1:-1:-1;4095:83:20;;;;;:::i;:::-;;:::i;3894:85::-;;;;;;;;;;-1:-1:-1;3894:85:20;;;;;:::i;:::-;;:::i;7350:351:7:-;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;3729:157:20:-;;;;;;;;;;-1:-1:-1;3729:157:20;;;;;:::i;:::-;;:::i;4372:200::-;;;;;;;;;;-1:-1:-1;4372:200:20;;;;;:::i;:::-;;:::i;2145:66:7:-;;;;;;;;;;;;2209:1;2145:66;;;;;-1:-1:-1;;;;;8405:45:26;;;8387:64;;8375:2;8360:18;2145:66:7;8241:216:26;4151:713:7;;;;;;;;;;-1:-1:-1;4151:713:7;;;;;:::i;:::-;;:::i;12934:150:23:-;;;;;;;;;;-1:-1:-1;12934:150:23;;;;;:::i;:::-;;:::i;737:80:20:-;;;;;;;;;;;;;:::i;2576:459:7:-;;;;;;;;;;;;;:::i;8570:239:23:-;;;;;;;;;;-1:-1:-1;8570:239:23;;;;;:::i;:::-;;:::i;2293:101:12:-;;;;;;;;;;;;;:::i;1638:85::-;;;;;;;;;;-1:-1:-1;1710:6:12;;-1:-1:-1;;;;;1710:6:12;1638:85;;11742:102:23;;;;;;;;;;;;;:::i;8953:371:7:-;;;;;;;;;;-1:-1:-1;8953:371:7;;;;;:::i;:::-;;:::i;1250:415:20:-;;;;;;:::i;:::-;;:::i;19186:231:23:-;;;;;;;;;;-1:-1:-1;19186:231:23;;;;;:::i;:::-;;:::i;5449:799:7:-;;;;;;;;;;-1:-1:-1;5449:799:7;;;;;:::i;:::-;;:::i;2012:221:20:-;;;;;;;;;;-1:-1:-1;2012:221:20;;;;;:::i;:::-;;:::i;27102:405:23:-;;;;;;:::i;:::-;;:::i;6704:445:7:-;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;2688:422:20:-;;;;;;;;;;-1:-1:-1;2688:422:20;;;;;:::i;:::-;;:::i;7905:372:7:-;;;;;;;;;;;;;:::i;19567:162:23:-;;;;;;;;;;-1:-1:-1;19567:162:23;;;;;:::i;:::-;-1:-1:-1;;;;;19687:25:23;;;19664:4;19687:25;;;:18;:25;;;;;;;;:35;;;;;;;;;;;;;;;19567:162;1679:200:20;;;;;;;;;;-1:-1:-1;1679:200:20;;;;;:::i;:::-;;:::i;2543:215:12:-;;;;;;;;;;-1:-1:-1;2543:215:12;;;;;:::i;:::-;;:::i;3232:732:7:-;;;;;;;;;;-1:-1:-1;3232:732:7;;;;;:::i;:::-;;:::i;4580:253:20:-;4684:4;-1:-1:-1;;;;;;4710:33:20;;-1:-1:-1;;;4710:33:20;;:73;;;4747:36;4771:11;4747:23;:36::i;:::-;4710:115;;;;4787:38;4813:11;4787:25;:38::i;:::-;4703:122;4580:253;-1:-1:-1;;4580:253:20:o;4186:178::-;4272:31;:29;:31::i;:::-;4314:42;4333:8;4343:12;4314:18;:42::i;:::-;4186:178;;:::o;11573:98:23:-;11627:13;11659:5;11652:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;11573:98;:::o;18636:223::-;18712:7;18736:16;18744:7;18736;:16::i;:::-;18731:73;;18754:50;-1:-1:-1;;;18754:7:23;:50::i;:::-;-1:-1:-1;18822:24:23;;;;:15;:24;;;;;:30;-1:-1:-1;;;;;18822:30:23;;18636:223::o;18364:122::-;18452:27;18461:2;18465:7;18474:4;18452:8;:27::i;10057:378:7:-;10184:17;;10156:4;;-1:-1:-1;;;;;10184:17:7;10176:40;10172:236;;10236:17;;:65;;-1:-1:-1;;;10236:65:7;;-1:-1:-1;;;;;14876:15:26;;;10236:65:7;;;14858:34:26;14928:15;;;14908:18;;;14901:43;14980:15;;;14960:18;;;14953:43;10236:17:7;;;;:47;;14793:18:26;;10236:65:7;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;10232:166;;-1:-1:-1;10378:5:7;10371:12;;10232:166;-1:-1:-1;10327:4:7;10320:11;;10232:166;-1:-1:-1;10424:4:7;10057:378;;;;;;:::o;3987:100:20:-;1531:13:12;:11;:13::i;:::-;4055:10:20::1;:24:::0;;-1:-1:-1;;4055:24:20::1;::::0;::::1;;::::0;;;::::1;::::0;;3987:100::o;22796:3447:23:-;22933:27;22963;22982:7;22963:18;:27::i;:::-;-1:-1:-1;;;;;23115:22:23;;;;22933:57;;-1:-1:-1;23173:45:23;;;;23169:95;;23220:44;-1:-1:-1;;;23220:7:23;:44::i;:::-;23276:27;21929:24;;;:15;:24;;;;;22153:26;;23464:68;22153:26;23506:4;735:10:16;23512:19:23;-1:-1:-1;;;;;21417:32:23;;;21263:28;;21544:20;;21566:30;;21541:56;;20967:646;23464:68;23459:188;;23551:43;23568:4;735:10:16;23574:19:23;7350:351:7;23551:43:23;23546:101;;23596:51;-1:-1:-1;;;23596:7:23;:51::i;:::-;23658:43;23680:4;23686:2;23690:7;23699:1;23658:21;:43::i;:::-;23790:15;23787:157;;;23928:1;23907:19;23900:30;23787:157;-1:-1:-1;;;;;24316:24:23;;;;;;;:18;:24;;;;;;24314:26;;-1:-1:-1;;24314:26:23;;;24384:22;;;;;;;;;24382:24;;-1:-1:-1;24382:24:23;;;17492:11;17467:23;17463:41;17450:63;-1:-1:-1;;;17450:63:23;24670:26;;;;:17;:26;;;;;:172;;;;-1:-1:-1;;;24959:47:23;;:52;;24955:617;;25063:1;25053:11;;25031:19;25184:30;;;:17;:30;;;;;;:35;;25180:378;;25320:13;;25305:11;:28;25301:239;;25465:30;;;;:17;:30;;;;;:52;;;25301:239;25013:559;24955:617;-1:-1:-1;;;;;25700:20:23;;26071:7;25700:20;26003:4;25946:25;25681:16;;25814:292;26129:8;26141:1;26129:13;26125:58;;26144:39;-1:-1:-1;;;26144:7:23;:39::i;:::-;26194:42;26215:4;26221:2;26225:7;26234:1;26194:20;:42::i;:::-;22923:3320;;;;22796:3447;;;:::o;2379:419:15:-;2465:7;2522:26;;;:17;:26;;;;;;;;2493:55;;;;;;;;;-1:-1:-1;;;;;2493:55:15;;;;;-1:-1:-1;;;2493:55:15;;;-1:-1:-1;;;;;2493:55:15;;;;;;;;2465:7;;2559:90;;-1:-1:-1;2609:29:15;;;;;;;;;2619:19;2609:29;-1:-1:-1;;;;;2609:29:15;;;;-1:-1:-1;;;2609:29:15;;-1:-1:-1;;;;;2609:29:15;;;;;2559:90;2696:23;;;;2659:21;;3156:5;;2684:35;;-1:-1:-1;;;;;2684:35:15;:9;:35;:::i;:::-;2683:57;;;;:::i;:::-;2759:16;;;;;-1:-1:-1;2379:419:15;;-1:-1:-1;;;;2379:419:15:o;8437:350:7:-;8544:17;;8516:4;;-1:-1:-1;;;;;8544:17:7;8536:40;8532:226;;8599:17;;8656:60;;-1:-1:-1;;;8656:60:7;;8710:4;8656:60;;;160:51:26;-1:-1:-1;;;;;8599:17:7;;;;:39;;:17;;8656:45;;133:18:26;;8656:60:7;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;:80;;;8599:148;;-1:-1:-1;;;;;;8599:148:7;;;;;;;-1:-1:-1;;;;;16540:45:26;;;8599:148:7;;;16522:64:26;-1:-1:-1;;;;;16622:32:26;;16602:18;;;16595:60;16495:18;;8599:148:7;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;8532:226::-;-1:-1:-1;8775:5:7;;8437:350;-1:-1:-1;8437:350:7:o;3278:335:20:-;1531:13:12;:11;:13::i;:::-;3425:7:20::1;3446;1710:6:12::0;;-1:-1:-1;;;;;1710:6:12;;1638:85;3446:7:20::1;-1:-1:-1::0;;;;;3438:21:20::1;3467;3438:55;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;3424:69;;;3512:2;3504:11;;;::::0;::::1;;3323:290;3278:335::o:0;26334:187:23:-;26475:39;26492:4;26498:2;26502:7;26475:39;;;;;;;;;;;;:16;:39::i;:::-;26334:187;;;:::o;4095:83:20:-;1531:13:12;:11;:13::i;:::-;4156:14:20::1;4162:7;4156:5;:14::i;3894:85::-:0;1531:13:12;:11;:13::i;:::-;3956:4:20::1;:15:::0;3894:85::o;7350:351:7:-;7455:17;;7415:16;;-1:-1:-1;;;;;7455:17:7;7447:40;7443:218;;7510:17;;7569:60;;-1:-1:-1;;;7569:60:7;;7623:4;7569:60;;;160:51:26;-1:-1:-1;;;;;7510:17:7;;;;:41;;:17;;7569:45;;133:18:26;;7569:60:7;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;:80;;;7510:140;;-1:-1:-1;;;;;;7510:140:7;;;;;;;-1:-1:-1;;;;;8405:45:26;;;7510:140:7;;;8387:64:26;8360:18;;7510:140:7;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;7510:140:7;;;;;;;;;;;;:::i;:::-;7503:147;;7350:351;:::o;7443:218::-;-1:-1:-1;7678:16:7;;;7692:1;7678:16;;;;;;;;;7350:351::o;3729:157:20:-;1531:13:12;:11;:13::i;:::-;3804:7:20::1;:21;3814:11:::0;3804:7;:21:::1;:::i;:::-;;3841:37;3861:1;3864:13;2603:1:::0;7328:12:23;6951:14;7312:13;:28;-1:-1:-1;;7312:46:23;;6890:564;3864:13:20::1;3841:37;::::0;;20473:25:26;;;20529:2;20514:18;;20507:34;;;;20446:18;3841:37:20::1;;;;;;;3729:157:::0;:::o;4372:200::-;4473:31;:29;:31::i;:::-;4515:49;4532:7;4541:8;4551:12;4515:16;:49::i;4151:713:7:-;4336:31;:29;:31::i;:::-;4378:40;4421:22;6469:17;;-1:-1:-1;;;;;6469:17:7;;6358:135;4421:22;4378:65;-1:-1:-1;;;;;;4457:32:7;;4453:115;;4512:45;;-1:-1:-1;;;4512:45:7;;;;;;;;;;;4453:115;4578:68;;-1:-1:-1;;;4578:68:7;;-1:-1:-1;;;;;4578:46:7;;;;;:68;;4633:4;;4640:5;;4578:68;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;4656:78:7;;-1:-1:-1;;;4656:78:7;;-1:-1:-1;;;;;4656:42:7;;;-1:-1:-1;4656:42:7;;-1:-1:-1;4656:78:7;;4707:4;;4714:19;;4656:78;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;4744:113:7;;-1:-1:-1;;;4744:113:7;;-1:-1:-1;;;;;4744:59:7;;;-1:-1:-1;4744:59:7;;-1:-1:-1;4744:113:7;;4812:4;;4819:37;;4744:113;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4326:538;4151:713;;;:::o;12934:150:23:-;13006:7;13048:27;13067:7;13048:18;:27::i;737:80:20:-;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::o;2576:459:7:-;2639:31;:29;:31::i;:::-;2680:48;1991:42;2680:20;:48::i;:::-;2738:143;;-1:-1:-1;;;2738:143:7;;1991:42;;2738:95;;:143;;2842:4;;2113:26;;2738:143;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;2891:137:7;;-1:-1:-1;;;2891:137:7;;1991:42;;-1:-1:-1;2891:91:7;;-1:-1:-1;2891:137:7;;2991:4;;2209:1;;2891:137;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2576:459::o;8570:239:23:-;8642:7;-1:-1:-1;;;;;8665:19:23;;8661:69;;8686:44;-1:-1:-1;;;8686:7:23;:44::i;:::-;-1:-1:-1;;;;;;8747:25:23;;;;;:18;:25;;;;;;1518:13;8747:55;;8570:239::o;2293:101:12:-;1531:13;:11;:13::i;:::-;2357:30:::1;2384:1;2357:18;:30::i;:::-;2293:101::o:0;11742:102:23:-;11798:13;11830:7;11823:14;;;;;:::i;8953:371:7:-;9066:17;;9038:4;;-1:-1:-1;;;;;9066:17:7;9058:40;9054:241;;9121:17;;9184:60;;-1:-1:-1;;;9184:60:7;;9238:4;9184:60;;;160:51:26;-1:-1:-1;;;;;9121:17:7;;;;:45;;:17;;9184:45;;133:18:26;;9184:60:7;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;:89;;;;;9121:163;;-1:-1:-1;;;;;;9121:163:7;;;;;;;-1:-1:-1;;;;;16540:45:26;;;9121:163:7;;;16522:64:26;-1:-1:-1;;;;;16622:32:26;;16602:18;;;16595:60;16495:18;;9121:163:7;16348:313:26;1250:415:20;1315:10;;;;1307:48;;;;-1:-1:-1;;;1307:48:20;;21407:2:26;1307:48:20;;;21389:21:26;21446:2;21426:18;;;21419:30;21485:27;21465:18;;;21458:55;21530:18;;1307:48:20;;;;;;;;;685:3;1385:7;1369:13;2603:1;7328:12:23;6951:14;7312:13;:28;-1:-1:-1;;7312:46:23;;6890:564;1369:13:20;:23;;;;:::i;:::-;:36;1366:83;;;1428:9;;-1:-1:-1;;;1428:9:20;;;;;;;;;;;1366:83;1473:1;1462:7;:12;1459:65;;1497:15;;-1:-1:-1;;;1497:15:20;;;;;;;;;;;1459:65;1559:4;;1549:14;;:7;:14;:::i;:::-;1537:9;:26;1534:83;;;1586:19;;-1:-1:-1;;;1586:19:20;;;;;;;;;;;1534:83;1627:30;1637:10;1649:7;1627:9;:30::i;19186:231:23:-;735:10:16;19280:39:23;;;;:18;:39;;;;;;;;-1:-1:-1;;;;;19280:49:23;;;;;;;;;;:60;;-1:-1:-1;;19280:60:23;;;;;;;:49;-1:-1:-1;;;;;19355:55:23;;19401:8;19355:55;;;;773:14:26;766:22;748:41;;736:2;721:18;;608:187;19355:55:23;;;;;;;;19186:231;;:::o;5449:799:7:-;5524:31;:29;:31::i;:::-;5566:29;-1:-1:-1;;;;;5617:30:7;;;:34;5614:299;;5671:95;;-1:-1:-1;;;5671:95:7;;5717:48;5671:95;;;21833:52:26;-1:-1:-1;;;;;5671:45:7;;;;;21806:18:26;;5671:95:7;;;;;;;;;;;;;;;;;;-1:-1:-1;5671:95:7;;;;;;;;-1:-1:-1;;5671:95:7;;;;;;;;;;;;:::i;:::-;;;5667:236;;;5862:17;-1:-1:-1;5667:236:7;-1:-1:-1;;;;;5926:32:7;;;;;;:61;;;5963:24;5962:25;5926:61;5923:150;;;6010:52;;-1:-1:-1;;;6010:52:7;;;;;;;;;;;5923:150;6121:17;;6088:72;;;-1:-1:-1;;;;;6121:17:7;;;22108:34:26;;22178:15;;;22173:2;22158:18;;22151:43;6088:72:7;;22043:18:26;6088:72:7;;;;;;;-1:-1:-1;6171:17:7;:70;;-1:-1:-1;;;;;;6171:70:7;-1:-1:-1;;;;;6171:70:7;;;;;;;;;;5449:799::o;2012:221:20:-;1531:13:12;:11;:13::i;:::-;2127:6:20::1;2123:103;2139:10;:17;2137:1;:19;2123:103;;;2177:37;2187:10;2198:1;2187:13;;;;;;;;:::i;:::-;;;;;;;2202:8;2211:1;2202:11;;;;;;;;:::i;:::-;;;;;;;2177:9;:37::i;:::-;2158:3:::0;::::1;::::0;::::1;:::i;:::-;;;;2123:103;;27102:405:23::0;27271:31;27284:4;27290:2;27294:7;27271:12;:31::i;:::-;-1:-1:-1;;;;;27316:14:23;;;:19;27312:189;;27354:56;27385:4;27391:2;27395:7;27404:5;27354:30;:56::i;:::-;27349:152;;27430:56;-1:-1:-1;;;27430:7:23;:56::i;6704:445:7:-;-1:-1:-1;;;;;;;;;;;;;;;;;;;;;;;;;6818:17:7;;-1:-1:-1;;;;;6818:17:7;6810:40;6806:138;;6873:17;;:60;;-1:-1:-1;;;6873:60:7;;6927:4;6873:60;;;160:51:26;-1:-1:-1;;;;;6873:17:7;;;;:45;;133:18:26;;6873:60:7;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;6806:138::-;-1:-1:-1;6961:181:7;;;;;;;;-1:-1:-1;6961:181:7;;;;;;;;;;;;;;;;;6704:445::o;2688:422:20:-;2789:13;2842:16;2850:7;2842;:16::i;:::-;2820:120;;;;-1:-1:-1;;;2820:120:20;;22679:2:26;2820:120:20;;;22661:21:26;22718:2;22698:18;;;22691:30;22757:34;22737:18;;;22730:62;-1:-1:-1;;;22808:18:26;;;22801:52;22870:19;;2820:120:20;22477:418:26;2820:120:20;2997:1;2979:7;2973:21;;;;;:::i;:::-;;;:25;:129;;;;;;;;;;;;;;;;;3042:7;3051:18;3061:7;3051:9;:18::i;:::-;3025:54;;;;;;;;;:::i;:::-;;;;;;;;;;;;;2953:149;2688:422;-1:-1:-1;;2688:422:20:o;7905:372:7:-;8016:17;;7976:16;;-1:-1:-1;;;;;8016:17:7;8008:40;8004:233;;8071:17;;8136:60;;-1:-1:-1;;;8136:60:7;;8190:4;8136:60;;;160:51:26;-1:-1:-1;;;;;8071:17:7;;;;:47;;:17;;8136:45;;133:18:26;;8136:60:7;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;:89;;;;;8071:155;;-1:-1:-1;;;;;;8071:155:7;;;;;;;-1:-1:-1;;;;;8405:45:26;;;8071:155:7;;;8387:64:26;8360:18;;8071:155:7;8241:216:26;1679:200:20;1531:13:12;:11;:13::i;:::-;685:3:20::1;1767:7;1751:13;2603:1:::0;7328:12:23;6951:14;7312:13;:28;-1:-1:-1;;7312:46:23;;6890:564;1751:13:20::1;:23;;;;:::i;:::-;:36;1748:83;;;1810:9;;-1:-1:-1::0;;;1810:9:20::1;;;;;;;;;;;2543:215:12::0;1531:13;:11;:13::i;:::-;-1:-1:-1;;;;;2627:22:12;::::1;2623:91;;2672:31;::::0;-1:-1:-1;;;2672:31:12;;2700:1:::1;2672:31;::::0;::::1;160:51:26::0;133:18;;2672:31:12::1;14:203:26::0;2623:91:12::1;2723:28;2742:8;2723:18;:28::i;3232:732:7:-:0;3457:31;:29;:31::i;:::-;3499;3520:9;3499:20;:31::i;:::-;3541:113;;-1:-1:-1;;;3541:113:7;;-1:-1:-1;;;;;3541:91:7;;;;;:113;;3641:4;;3648:5;;3541:113;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;3665:123:7;;-1:-1:-1;;;3665:123:7;;-1:-1:-1;;;;;3665:87:7;;;-1:-1:-1;3665:87:7;;-1:-1:-1;3665:123:7;;3761:4;;3768:19;;3665:123;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;3799:158:7;;-1:-1:-1;;;3799:158:7;;-1:-1:-1;;;;;3799:104:7;;;-1:-1:-1;3799:104:7;;-1:-1:-1;3799:158:7;;3912:4;;3919:37;;3799:158;;;:::i;2116:213:15:-;2218:4;-1:-1:-1;;;;;;2241:41:15;;-1:-1:-1;;;2241:41:15;;:81;;-1:-1:-1;;;;;;;;;;861:40:18;;;2286:36:15;762:146:18;4842:148:20;1710:6:12;;-1:-1:-1;;;;;1710:6:12;4959:10:20;:21;4951:30;;;;;527:214:25;630:48;655:8;665:12;630:24;:48::i;:::-;693:41;;-1:-1:-1;;;;;24254:39:26;;24236:58;;-1:-1:-1;;;;;693:41:25;;;;;24224:2:26;24209:18;693:41:25;;;;;;;527:214;;:::o;19978:465:23:-;20043:11;20089:7;2603:1:20;20070:26:23;20066:371;;20231:13;;20221:7;:23;20217:210;;;20264:14;20296:60;-1:-1:-1;20313:26:23;;;;:17;:26;;;;;;;20303:42;;;20296:60;;20347:9;;;:::i;:::-;;;20296:60;;;-1:-1:-1;;;20383:24:23;:29;;-1:-1:-1;20217:210:23;19978:465;;;:::o;49703:160::-;49802:13;49796:4;49789:27;49842:4;49836;49829:18;41333:460;41457:13;41473:16;41481:7;41473;:16::i;:::-;41457:32;;41504:13;:45;;;;-1:-1:-1;735:10:16;-1:-1:-1;;;;;41521:28:23;;;;41504:45;41500:198;;;41568:44;41585:5;735:10:16;41592:19:23;7350:351:7;41568:44:23;41563:135;;41632:51;-1:-1:-1;;;41632:7:23;:51::i;:::-;41708:24;;;;:15;:24;;;;;;:35;;-1:-1:-1;;;;;;41708:35:23;-1:-1:-1;;;;;41708:35:23;;;;;;;;;41758:28;;41708:24;;41758:28;;;;;;;41447:346;41333:460;;;:::o;1796:162:12:-;1710:6;;-1:-1:-1;;;;;1710:6:12;735:10:16;1855:23:12;1851:101;;1901:40;;-1:-1:-1;;;1901:40:12;;735:10:16;1901:40:12;;;160:51:26;133:18;;1901:40:12;14:203:26;14380:2173:23;14447:14;14496:7;2603:1:20;14477:26:23;14473:2017;;-1:-1:-1;14528:26:23;;;;:17;:26;;;;;;14847:6;14857:1;14847:11;14843:1270;;14893:13;;14882:7;:24;14878:77;;14908:47;-1:-1:-1;;;14908:7:23;:47::i;:::-;15502:597;-1:-1:-1;;;15596:9:23;15578:28;;;;:17;:28;;;;;;15650:25;;15502:597;15650:25;-1:-1:-1;;;15701:6:23;:24;15729:1;15701:29;15697:48;;14380:2173;;;:::o;15697:48::-;16033:47;-1:-1:-1;;;16033:7:23;:47::i;:::-;15502:597;;14843:1270;-1:-1:-1;;;16435:6:23;:24;16463:1;16435:29;16431:48;;14380:2173;;;:::o;16431:48::-;16499:47;-1:-1:-1;;;16499:7:23;:47::i;979:347:1:-;1155:9;1150:170;1174:8;1170:1;:12;1150:170;;;1199:51;1223:4;1229:2;1233:16;1248:1;1233:12;:16;:::i;:::-;1199:23;:51::i;:::-;1292:3;;1150:170;;;;979:347;;;;:::o;1430:345::-;1605:9;1600:169;1624:8;1620:1;:12;1600:169;;;1649:50;1672:4;1678:2;1682:16;1697:1;1682:12;:16;:::i;:::-;1649:22;:50::i;:::-;1741:3;;1600:169;;42051:87:23;42110:21;42116:7;42125:5;42110;:21::i;747:243:25:-;865:55;888:7;897:8;907:12;865:22;:55::i;:::-;935:48;;-1:-1:-1;;;;;24254:39:26;;24236:58;;-1:-1:-1;;;;;935:48:25;;;951:7;;935:48;;24224:2:26;24209:18;935:48:25;;;;;;;747:243;;;:::o;2912:187:12:-;3004:6;;;-1:-1:-1;;;;;3020:17:12;;;-1:-1:-1;;;;;;3020:17:12;;;;;;;3052:40;;3004:6;;;3020:17;3004:6;;3052:40;;2985:16;;3052:40;2975:124;2912:187;:::o;36661:110:23:-;36737:27;36747:2;36751:8;36737:27;;;;;;;;;;;;:9;:27::i;29533:673::-;29711:88;;-1:-1:-1;;;29711:88:23;;29691:4;;-1:-1:-1;;;;;29711:45:23;;;;;:88;;735:10:16;;29778:4:23;;29784:7;;29793:5;;29711:88;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;-1:-1:-1;29711:88:23;;;;;;;;-1:-1:-1;;29711:88:23;;;;;;;;;;;;:::i;:::-;;;29707:493;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;29989:6;:13;30006:1;29989:18;29985:113;;30027:56;-1:-1:-1;;;30027:7:23;:56::i;:::-;30168:6;30162:13;30153:6;30149:2;30145:15;30138:38;29707:493;-1:-1:-1;;;;;;29867:64:23;-1:-1:-1;;;29867:64:23;;-1:-1:-1;29707:493:23;29533:673;;;;;;:::o;47933:1708::-;47998:17;48426:4;48419;48413:11;48409:22;48516:1;48510:4;48503:15;48589:4;48586:1;48582:12;48575:19;;;48669:1;48664:3;48657:14;48770:3;49004:5;48986:419;49051:1;49046:3;49042:11;49035:18;;49219:2;49213:4;49209:13;49205:2;49201:22;49196:3;49188:36;49311:2;49301:13;;49366:25;48986:419;49366:25;-1:-1:-1;49433:13:23;;;-1:-1:-1;;49546:14:23;;;49606:19;;;49546:14;47933:1708;-1:-1:-1;47933:1708:23:o;3429:507:15:-;3156:5;-1:-1:-1;;;;;3576:26:15;;;-1:-1:-1;3572:173:15;;;3679:55;;-1:-1:-1;;;3679:55:15;;-1:-1:-1;;;;;25385:39:26;;3679:55:15;;;25367:58:26;25441:18;;;25434:34;;;25340:18;;3679:55:15;25194:280:26;3572:173:15;-1:-1:-1;;;;;3758:22:15;;3754:108;;3803:48;;-1:-1:-1;;;3803:48:15;;3848:1;3803:48;;;160:51:26;133:18;;3803:48:15;14:203:26;3754:108:15;-1:-1:-1;3894:35:15;;;;;;;;;-1:-1:-1;;;;;3894:35:15;;;;;;-1:-1:-1;;;;;3894:35:15;;;;;;;;;;-1:-1:-1;;;3872:57:15;;;;:19;:57;3429:507::o;697:610:9:-;-1:-1:-1;;;;;823:18:9;;;;;872:16;;;823:18;902:32;;;;;921:13;902:32;899:402;;;957:28;;-1:-1:-1;;;957:28:9;;;;;;;;;;;899:402;1005:15;1002:299;;;1036:54;1002:299;;;1110:13;1139:56;1107:194;1226:64;735:10:16;1261:4:9;1267:2;1271:7;1280:9;1226:20;:64::i;1437:612::-;-1:-1:-1;;;;;1562:18:9;;;;;1611:16;;;1562:18;1641:32;;;;;1660:13;1641:32;1638:405;;;1696:28;;-1:-1:-1;;;1696:28:9;;;;;;;;;;;1638:405;1744:15;1775:55;1741:302;1850:13;1879:57;1847:196;1967:65;3278:335:20:o;42355:3042:23:-;42434:27;42464;42483:7;42464:18;:27::i;:::-;42434:57;-1:-1:-1;42434:57:23;42502:12;;42622:35;42649:7;21820:27;21929:24;;;:15;:24;;;;;22153:26;;21929:24;;21721:474;42622:35;42565:92;;;;42672:13;42668:321;;;42791:68;42816:15;42833:4;735:10:16;42839:19:23;7350:351:7;42791:68:23;42786:192;;42882:43;42899:4;735:10:16;42905:19:23;7350:351:7;42882:43:23;42877:101;;42927:51;-1:-1:-1;;;42927:7:23;:51::i;:::-;42999;43021:4;43035:1;43039:7;43048:1;42999:21;:51::i;:::-;43139:15;43136:157;;;43277:1;43256:19;43249:30;43136:157;-1:-1:-1;;;;;43882:24:23;;;;;;:18;:24;;;;;:60;;43910:32;43882:60;;;17492:11;17467:23;17463:41;17450:63;-1:-1:-1;;;17450:63:23;44173:26;;;;:17;:26;;;;;:202;;;;-1:-1:-1;;;44492:47:23;;:52;;44488:617;;44596:1;44586:11;;44564:19;44717:30;;;:17;:30;;;;;;:35;;44713:378;;44853:13;;44838:11;:28;44834:239;;44998:30;;;;:17;:30;;;;;:52;;;44834:239;44546:559;44488:617;45130:35;;45157:7;;45153:1;;-1:-1:-1;;;;;45130:35:23;;;;;45153:1;;45130:35;45175:50;45196:4;45210:1;45214:7;45223:1;45175:20;:50::i;:::-;-1:-1:-1;;45366:12:23;:14;;;;;;-1:-1:-1;;;;42355:3042:23:o;4370:543:15:-;3156:5;-1:-1:-1;;;;;4532:26:15;;;-1:-1:-1;4528:180:15;;;4635:62;;-1:-1:-1;;;4635:62:15;;;;;25680:25:26;;;-1:-1:-1;;;;;25741:39:26;;25721:18;;;25714:67;25797:18;;;25790:34;;;25653:18;;4635:62:15;25479:351:26;4528:180:15;-1:-1:-1;;;;;4721:22:15;;4717:115;;4766:55;;-1:-1:-1;;;4766:55:15;;;;;26009:25:26;;;4818:1:15;26050:18:26;;;26043:60;25982:18;;4766:55:15;25835:274:26;4717:115:15;-1:-1:-1;4871:35:15;;;;;;;;-1:-1:-1;;;;;4871:35:15;;;;;-1:-1:-1;;;;;4871:35:15;;;;;;;;;;-1:-1:-1;4842:26:15;;;:17;:26;;;;;;:64;;;;;;;-1:-1:-1;;;4842:64:15;;;;;;4370:543::o;35816:766:23:-;35942:19;35948:2;35952:8;35942:5;:19::i;:::-;-1:-1:-1;;;;;36000:14:23;;;:19;35996:570;;36039:11;36053:13;36100:14;;;36132:238;36162:62;36201:1;36205:2;36209:7;;;;;;36218:5;36162:30;:62::i;:::-;36157:174;;36252:56;-1:-1:-1;;;36252:7:23;:56::i;:::-;36365:3;36357:5;:11;36132:238;;36538:3;36521:13;;:20;36517:34;;36543:8;;;11124:335:7;11329:17;;-1:-1:-1;;;;;11329:17:7;11321:40;11317:136;;11377:17;;:65;;-1:-1:-1;;;11377:65:7;;-1:-1:-1;;;;;14876:15:26;;;11377:65:7;;;14858:34:26;14928:15;;;14908:18;;;14901:43;14980:15;;;14960:18;;;14953:43;11377:17:7;;;;:47;;14793:18:26;;11377:65:7;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;11124:335;;;;;:::o;30652:2343:23:-;30724:20;30747:13;;;30774;;;30770:53;;30789:34;-1:-1:-1;;;30789:7:23;:34::i;:::-;30834:61;30864:1;30868:2;30872:12;30886:8;30834:21;:61::i;:::-;31323:31;;;;:17;:31;;;;;;;;-1:-1:-1;;;;;17320:28:23;;17492:11;17467:23;17463:41;17925:1;17912:15;;17886:24;17882:46;17460:52;17450:63;;31323:170;;;31704:22;;;:18;:22;;;;;:71;;31742:32;31730:45;;31704:71;;;17320:28;31960:13;;;31956:54;;31975:35;-1:-1:-1;;;31975:7:23;:35::i;:::-;32039:23;;;;32213:662;32623:7;32580:8;32536:1;32471:25;32409:1;32345;32315:351;32870:3;32857:9;;;;;;:16;32213:662;;-1:-1:-1;32889:13:23;:19;;;32928:60;;-1:-1:-1;32961:2:23;32965:12;32979:8;32928:20;:60::i;222:131:26:-;-1:-1:-1;;;;;;296:32:26;;286:43;;276:71;;343:1;340;333:12;358:245;416:6;469:2;457:9;448:7;444:23;440:32;437:52;;;485:1;482;475:12;437:52;524:9;511:23;543:30;567:5;543:30;:::i;800:131::-;-1:-1:-1;;;;;875:31:26;;865:42;;855:70;;921:1;918;911:12;936:179;1003:20;;-1:-1:-1;;;;;1052:38:26;;1042:49;;1032:77;;1105:1;1102;1095:12;1120:319;1187:6;1195;1248:2;1236:9;1227:7;1223:23;1219:32;1216:52;;;1264:1;1261;1254:12;1216:52;1303:9;1290:23;1322:31;1347:5;1322:31;:::i;:::-;1372:5;-1:-1:-1;1396:37:26;1429:2;1414:18;;1396:37;:::i;:::-;1386:47;;1120:319;;;;;:::o;1444:250::-;1529:1;1539:113;1553:6;1550:1;1547:13;1539:113;;;1629:11;;;1623:18;1610:11;;;1603:39;1575:2;1568:10;1539:113;;;-1:-1:-1;;1686:1:26;1668:16;;1661:27;1444:250::o;1699:271::-;1741:3;1779:5;1773:12;1806:6;1801:3;1794:19;1822:76;1891:6;1884:4;1879:3;1875:14;1868:4;1861:5;1857:16;1822:76;:::i;:::-;1952:2;1931:15;-1:-1:-1;;1927:29:26;1918:39;;;;1959:4;1914:50;;1699:271;-1:-1:-1;;1699:271:26:o;1975:220::-;2124:2;2113:9;2106:21;2087:4;2144:45;2185:2;2174:9;2170:18;2162:6;2144:45;:::i;2200:180::-;2259:6;2312:2;2300:9;2291:7;2287:23;2283:32;2280:52;;;2328:1;2325;2318:12;2280:52;-1:-1:-1;2351:23:26;;2200:180;-1:-1:-1;2200:180:26:o;2385:315::-;2453:6;2461;2514:2;2502:9;2493:7;2489:23;2485:32;2482:52;;;2530:1;2527;2520:12;2482:52;2569:9;2556:23;2588:31;2613:5;2588:31;:::i;:::-;2638:5;2690:2;2675:18;;;;2662:32;;-1:-1:-1;;;2385:315:26:o;3133:529::-;3210:6;3218;3226;3279:2;3267:9;3258:7;3254:23;3250:32;3247:52;;;3295:1;3292;3285:12;3247:52;3334:9;3321:23;3353:31;3378:5;3353:31;:::i;:::-;3403:5;-1:-1:-1;3460:2:26;3445:18;;3432:32;3473:33;3432:32;3473:33;:::i;:::-;3525:7;-1:-1:-1;3584:2:26;3569:18;;3556:32;3597:33;3556:32;3597:33;:::i;:::-;3649:7;3639:17;;;3133:529;;;;;:::o;3799:250::-;3893:1;3886:5;3883:12;3873:143;;3938:10;3933:3;3929:20;3926:1;3919:31;3973:4;3970:1;3963:15;4001:4;3998:1;3991:15;3873:143;4025:18;;3799:250::o;4054:233::-;4212:2;4197:18;;4224:57;4201:9;4263:6;4224:57;:::i;4292:118::-;4378:5;4371:13;4364:21;4357:5;4354:32;4344:60;;4400:1;4397;4390:12;4415:241;4471:6;4524:2;4512:9;4503:7;4499:23;4495:32;4492:52;;;4540:1;4537;4530:12;4492:52;4579:9;4566:23;4598:28;4620:5;4598:28;:::i;4661:456::-;4738:6;4746;4754;4807:2;4795:9;4786:7;4782:23;4778:32;4775:52;;;4823:1;4820;4813:12;4775:52;4862:9;4849:23;4881:31;4906:5;4881:31;:::i;:::-;4931:5;-1:-1:-1;4988:2:26;4973:18;;4960:32;5001:33;4960:32;5001:33;:::i;:::-;4661:456;;5053:7;;-1:-1:-1;;;5107:2:26;5092:18;;;;5079:32;;4661:456::o;5122:248::-;5190:6;5198;5251:2;5239:9;5230:7;5226:23;5222:32;5219:52;;;5267:1;5264;5257:12;5219:52;-1:-1:-1;;5290:23:26;;;5360:2;5345:18;;;5332:32;;-1:-1:-1;5122:248:26:o;5654:247::-;5713:6;5766:2;5754:9;5745:7;5741:23;5737:32;5734:52;;;5782:1;5779;5772:12;5734:52;5821:9;5808:23;5840:31;5865:5;5840:31;:::i;5906:658::-;6077:2;6129:21;;;6199:13;;6102:18;;;6221:22;;;6048:4;;6077:2;6300:15;;;;6274:2;6259:18;;;6048:4;6343:195;6357:6;6354:1;6351:13;6343:195;;;6422:13;;-1:-1:-1;;;;;6418:39:26;6406:52;;6513:15;;;;6478:12;;;;6454:1;6372:9;6343:195;;;-1:-1:-1;6555:3:26;;5906:658;-1:-1:-1;;;;;;5906:658:26:o;6569:127::-;6630:10;6625:3;6621:20;6618:1;6611:31;6661:4;6658:1;6651:15;6685:4;6682:1;6675:15;6701:275;6772:2;6766:9;6837:2;6818:13;;-1:-1:-1;;6814:27:26;6802:40;;6872:18;6857:34;;6893:22;;;6854:62;6851:88;;;6919:18;;:::i;:::-;6955:2;6948:22;6701:275;;-1:-1:-1;6701:275:26:o;6981:407::-;7046:5;7080:18;7072:6;7069:30;7066:56;;;7102:18;;:::i;:::-;7140:57;7185:2;7164:15;;-1:-1:-1;;7160:29:26;7191:4;7156:40;7140:57;:::i;:::-;7131:66;;7220:6;7213:5;7206:21;7260:3;7251:6;7246:3;7242:16;7239:25;7236:45;;;7277:1;7274;7267:12;7236:45;7326:6;7321:3;7314:4;7307:5;7303:16;7290:43;7380:1;7373:4;7364:6;7357:5;7353:18;7349:29;7342:40;6981:407;;;;;:::o;7393:451::-;7462:6;7515:2;7503:9;7494:7;7490:23;7486:32;7483:52;;;7531:1;7528;7521:12;7483:52;7571:9;7558:23;7604:18;7596:6;7593:30;7590:50;;;7636:1;7633;7626:12;7590:50;7659:22;;7712:4;7704:13;;7700:27;-1:-1:-1;7690:55:26;;7741:1;7738;7731:12;7690:55;7764:74;7830:7;7825:2;7812:16;7807:2;7803;7799:11;7764:74;:::i;7849:387::-;7925:6;7933;7941;7994:2;7982:9;7973:7;7969:23;7965:32;7962:52;;;8010:1;8007;8000:12;7962:52;8046:9;8033:23;8023:33;;8106:2;8095:9;8091:18;8078:32;8119:31;8144:5;8119:31;:::i;:::-;8169:5;-1:-1:-1;8193:37:26;8226:2;8211:18;;8193:37;:::i;:::-;8183:47;;7849:387;;;;;:::o;8462:121::-;8557:1;8550:5;8547:12;8537:40;;8573:1;8570;8563:12;8588:144;-1:-1:-1;;;;;8667:5:26;8663:44;8656:5;8653:55;8643:83;;8722:1;8719;8712:12;8737:575;8840:6;8848;8856;8909:2;8897:9;8888:7;8884:23;8880:32;8877:52;;;8925:1;8922;8915:12;8877:52;8964:9;8951:23;8983:51;9028:5;8983:51;:::i;:::-;9053:5;-1:-1:-1;9110:2:26;9095:18;;9082:32;9123:33;9082:32;9123:33;:::i;:::-;9175:7;-1:-1:-1;9234:2:26;9219:18;;9206:32;9247:33;9206:32;9247:33;:::i;9317:382::-;9382:6;9390;9443:2;9431:9;9422:7;9418:23;9414:32;9411:52;;;9459:1;9456;9449:12;9411:52;9498:9;9485:23;9517:31;9542:5;9517:31;:::i;:::-;9567:5;-1:-1:-1;9624:2:26;9609:18;;9596:32;9637:30;9596:32;9637:30;:::i;:::-;9686:7;9676:17;;;9317:382;;;;;:::o;9704:183::-;9764:4;9797:18;9789:6;9786:30;9783:56;;;9819:18;;:::i;:::-;-1:-1:-1;9864:1:26;9860:14;9876:4;9856:25;;9704:183::o;9892:662::-;9946:5;9999:3;9992:4;9984:6;9980:17;9976:27;9966:55;;10017:1;10014;10007:12;9966:55;10053:6;10040:20;10079:4;10103:60;10119:43;10159:2;10119:43;:::i;:::-;10103:60;:::i;:::-;10197:15;;;10283:1;10279:10;;;;10267:23;;10263:32;;;10228:12;;;;10307:15;;;10304:35;;;10335:1;10332;10325:12;10304:35;10371:2;10363:6;10359:15;10383:142;10399:6;10394:3;10391:15;10383:142;;;10465:17;;10453:30;;10503:12;;;;10416;;10383:142;;;-1:-1:-1;10543:5:26;9892:662;-1:-1:-1;;;;;;9892:662:26:o;10559:1215::-;10677:6;10685;10738:2;10726:9;10717:7;10713:23;10709:32;10706:52;;;10754:1;10751;10744:12;10706:52;10794:9;10781:23;10823:18;10864:2;10856:6;10853:14;10850:34;;;10880:1;10877;10870:12;10850:34;10918:6;10907:9;10903:22;10893:32;;10963:7;10956:4;10952:2;10948:13;10944:27;10934:55;;10985:1;10982;10975:12;10934:55;11021:2;11008:16;11043:4;11067:60;11083:43;11123:2;11083:43;:::i;11067:60::-;11161:15;;;11243:1;11239:10;;;;11231:19;;11227:28;;;11192:12;;;;11267:19;;;11264:39;;;11299:1;11296;11289:12;11264:39;11323:11;;;;11343:217;11359:6;11354:3;11351:15;11343:217;;;11439:3;11426:17;11456:31;11481:5;11456:31;:::i;:::-;11500:18;;11376:12;;;;11538;;;;11343:217;;;11579:5;-1:-1:-1;;11622:18:26;;11609:32;;-1:-1:-1;;11653:16:26;;;11650:36;;;11682:1;11679;11672:12;11650:36;;11705:63;11760:7;11749:8;11738:9;11734:24;11705:63;:::i;:::-;11695:73;;;10559:1215;;;;;:::o;11779:795::-;11874:6;11882;11890;11898;11951:3;11939:9;11930:7;11926:23;11922:33;11919:53;;;11968:1;11965;11958:12;11919:53;12007:9;11994:23;12026:31;12051:5;12026:31;:::i;:::-;12076:5;-1:-1:-1;12133:2:26;12118:18;;12105:32;12146:33;12105:32;12146:33;:::i;:::-;12198:7;-1:-1:-1;12252:2:26;12237:18;;12224:32;;-1:-1:-1;12307:2:26;12292:18;;12279:32;12334:18;12323:30;;12320:50;;;12366:1;12363;12356:12;12320:50;12389:22;;12442:4;12434:13;;12430:27;-1:-1:-1;12420:55:26;;12471:1;12468;12461:12;12420:55;12494:74;12560:7;12555:2;12542:16;12537:2;12533;12529:11;12494:74;:::i;:::-;12484:84;;;11779:795;;;;;;;:::o;12579:534::-;12753:4;12795:2;12784:9;12780:18;12772:26;;12807:64;12861:9;12852:6;12846:13;12807:64;:::i;:::-;12918:4;12910:6;12906:17;12900:24;-1:-1:-1;;;;;13031:2:26;13017:12;13013:21;13006:4;12995:9;12991:20;12984:51;13103:2;13095:4;13087:6;13083:17;13077:24;13073:33;13066:4;13055:9;13051:20;13044:63;;;12579:534;;;;:::o;13118:388::-;13186:6;13194;13247:2;13235:9;13226:7;13222:23;13218:32;13215:52;;;13263:1;13260;13253:12;13215:52;13302:9;13289:23;13321:31;13346:5;13321:31;:::i;:::-;13371:5;-1:-1:-1;13428:2:26;13413:18;;13400:32;13441:33;13400:32;13441:33;:::i;13511:717::-;13623:6;13631;13639;13647;13700:3;13688:9;13679:7;13675:23;13671:33;13668:53;;;13717:1;13714;13707:12;13668:53;13756:9;13743:23;13775:31;13800:5;13775:31;:::i;:::-;13825:5;-1:-1:-1;13882:2:26;13867:18;;13854:32;13895:53;13854:32;13895:53;:::i;:::-;13967:7;-1:-1:-1;14026:2:26;14011:18;;13998:32;14039:33;13998:32;14039:33;:::i;:::-;14091:7;-1:-1:-1;14150:2:26;14135:18;;14122:32;14163:33;14122:32;14163:33;:::i;:::-;13511:717;;;;-1:-1:-1;13511:717:26;;-1:-1:-1;;13511:717:26:o;14233:380::-;14312:1;14308:12;;;;14355;;;14376:61;;14430:4;14422:6;14418:17;14408:27;;14376:61;14483:2;14475:6;14472:14;14452:18;14449:38;14446:161;;14529:10;14524:3;14520:20;14517:1;14510:31;14564:4;14561:1;14554:15;14592:4;14589:1;14582:15;14446:161;;14233:380;;;:::o;15007:127::-;15068:10;15063:3;15059:20;15056:1;15049:31;15099:4;15096:1;15089:15;15123:4;15120:1;15113:15;15139:168;15212:9;;;15243;;15260:15;;;15254:22;;15240:37;15230:71;;15281:18;;:::i;15312:217::-;15352:1;15378;15368:132;;15422:10;15417:3;15413:20;15410:1;15403:31;15457:4;15454:1;15447:15;15485:4;15482:1;15475:15;15368:132;-1:-1:-1;15514:9:26;;15312:217::o;15534:809::-;15645:6;15698:2;15686:9;15677:7;15673:23;15669:32;15666:52;;;15714:1;15711;15704:12;15666:52;15747:2;15741:9;15789:2;15781:6;15777:15;15858:6;15846:10;15843:22;15822:18;15810:10;15807:34;15804:62;15801:88;;;15869:18;;:::i;:::-;15905:2;15898:22;15942:16;;15967:51;15942:16;15967:51;:::i;:::-;16027:21;;16093:2;16078:18;;16072:25;16106:33;16072:25;16106:33;:::i;:::-;16167:2;16155:15;;16148:32;16225:2;16210:18;;16204:25;16238:33;16204:25;16238:33;:::i;:::-;16299:2;16287:15;;16280:32;16291:6;15534:809;-1:-1:-1;;;15534:809:26:o;16666:245::-;16733:6;16786:2;16774:9;16765:7;16761:23;16757:32;16754:52;;;16802:1;16799;16792:12;16754:52;16834:9;16828:16;16853:28;16875:5;16853:28;:::i;17126:956::-;17221:6;17252:2;17295;17283:9;17274:7;17270:23;17266:32;17263:52;;;17311:1;17308;17301:12;17263:52;17344:9;17338:16;17377:18;17369:6;17366:30;17363:50;;;17409:1;17406;17399:12;17363:50;17432:22;;17485:4;17477:13;;17473:27;-1:-1:-1;17463:55:26;;17514:1;17511;17504:12;17463:55;17543:2;17537:9;17566:60;17582:43;17622:2;17582:43;:::i;17566:60::-;17660:15;;;17742:1;17738:10;;;;17730:19;;17726:28;;;17691:12;;;;17766:19;;;17763:39;;;17798:1;17795;17788:12;17763:39;17822:11;;;;17842:210;17858:6;17853:3;17850:15;17842:210;;;17931:3;17925:10;17948:31;17973:5;17948:31;:::i;:::-;17992:18;;17875:12;;;;18030;;;;17842:210;;;18071:5;17126:956;-1:-1:-1;;;;;;;17126:956:26:o;18213:545::-;18315:2;18310:3;18307:11;18304:448;;;18351:1;18376:5;18372:2;18365:17;18421:4;18417:2;18407:19;18491:2;18479:10;18475:19;18472:1;18468:27;18462:4;18458:38;18527:4;18515:10;18512:20;18509:47;;;-1:-1:-1;18550:4:26;18509:47;18605:2;18600:3;18596:12;18593:1;18589:20;18583:4;18579:31;18569:41;;18660:82;18678:2;18671:5;18668:13;18660:82;;;18723:17;;;18704:1;18693:13;18660:82;;;18664:3;;;18213:545;;;:::o;18934:1352::-;19060:3;19054:10;19087:18;19079:6;19076:30;19073:56;;;19109:18;;:::i;:::-;19138:97;19228:6;19188:38;19220:4;19214:11;19188:38;:::i;:::-;19182:4;19138:97;:::i;:::-;19290:4;;19354:2;19343:14;;19371:1;19366:663;;;;20073:1;20090:6;20087:89;;;-1:-1:-1;20142:19:26;;;20136:26;20087:89;-1:-1:-1;;18891:1:26;18887:11;;;18883:24;18879:29;18869:40;18915:1;18911:11;;;18866:57;20189:81;;19336:944;;19366:663;18160:1;18153:14;;;18197:4;18184:18;;-1:-1:-1;;19402:20:26;;;19520:236;19534:7;19531:1;19528:14;19520:236;;;19623:19;;;19617:26;19602:42;;19715:27;;;;19683:1;19671:14;;;;19550:19;;19520:236;;;19524:3;19784:6;19775:7;19772:19;19769:201;;;19845:19;;;19839:26;-1:-1:-1;;19928:1:26;19924:14;;;19940:3;19920:24;19916:37;19912:42;19897:58;19882:74;;19769:201;-1:-1:-1;;;;;20016:1:26;20000:14;;;19996:22;19983:36;;-1:-1:-1;18934:1352:26:o;20552:330::-;-1:-1:-1;;;;;20768:32:26;;20750:51;;20738:2;20723:18;;20810:66;20872:2;20857:18;;20849:6;20810:66;:::i;20887:313::-;-1:-1:-1;;;;;21079:32:26;;;;21061:51;;-1:-1:-1;;;;;21148:45:26;21143:2;21128:18;;21121:73;21049:2;21034:18;;20887:313::o;21559:125::-;21624:9;;;21645:10;;;21642:36;;;21658:18;;:::i;22205:127::-;22266:10;22261:3;22257:20;22254:1;22247:31;22297:4;22294:1;22287:15;22321:4;22318:1;22311:15;22337:135;22376:3;22397:17;;;22394:43;;22417:18;;:::i;:::-;-1:-1:-1;22464:1:26;22453:13;;22337:135::o;22900:1187::-;23177:3;23206:1;23239:6;23233:13;23269:36;23295:9;23269:36;:::i;:::-;23324:1;23341:18;;;23368:133;;;;23515:1;23510:356;;;;23334:532;;23368:133;-1:-1:-1;;23401:24:26;;23389:37;;23474:14;;23467:22;23455:35;;23446:45;;;-1:-1:-1;23368:133:26;;23510:356;23541:6;23538:1;23531:17;23571:4;23616:2;23613:1;23603:16;23641:1;23655:165;23669:6;23666:1;23663:13;23655:165;;;23747:14;;23734:11;;;23727:35;23790:16;;;;23684:10;;23655:165;;;23659:3;;;23849:6;23844:3;23840:16;23833:23;;23334:532;;;;;23897:6;23891:13;23913:68;23972:8;23967:3;23960:4;23952:6;23948:17;23913:68;:::i;:::-;-1:-1:-1;;;24003:18:26;;24030:22;;;24079:1;24068:13;;22900:1187;-1:-1:-1;;;;22900:1187:26:o;24305:136::-;24344:3;24372:5;24362:39;;24381:18;;:::i;:::-;-1:-1:-1;;;24417:18:26;;24305:136::o;24446:489::-;-1:-1:-1;;;;;24715:15:26;;;24697:34;;24767:15;;24762:2;24747:18;;24740:43;24814:2;24799:18;;24792:34;;;24862:3;24857:2;24842:18;;24835:31;;;24640:4;;24883:46;;24909:19;;24901:6;24883:46;:::i;:::-;24875:54;24446:489;-1:-1:-1;;;;;;24446:489:26:o;24940:249::-;25009:6;25062:2;25050:9;25041:7;25037:23;25033:32;25030:52;;;25078:1;25075;25068:12;25030:52;25110:9;25104:16;25129:30;25153:5;25129:30;:::i

ipfs://5788961b5c7bd9993534a717c480de668976dea4a6a605050eb1cfbf65de2ebb