Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

• Is this a proxy?
• Similar
• Submit Audit
• Compare

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

import "@limitbreak/creator-token-standards/src/access/OwnableBasic.sol";
import "@limitbreak/creator-token-standards/src/erc721c/ERC721AC.sol";
import "@limitbreak/creator-token-standards/src/programmable-royalties/BasicRoyalties.sol";
import "@openzeppelin/contracts/security/Pausable.sol";
import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
import "@openzeppelin/contracts/utils/cryptography/EIP712.sol";
import "@openzeppelin/contracts/security/ReentrancyGuard.sol";
import "./Supply.sol";
import "./OwnerMint.sol";
import "./UriManager.sol";
import "./interfaces/IPaymentSplitter.sol";

error TransferError();
error UnauthorizedRequest();
error InvalidStage();
error InvalidAccount();
error ExceedsLimit();
error InsufficientFunds();
error TransfersNotEnabled();

contract Kabu is
    OwnableBasic,
    ERC721AC,
    BasicRoyalties,
    Pausable,
    EIP712,
    Supply,
    OwnerMint,
    UriManager,
    ReentrancyGuard
{
    Stage public stage;
    address public signer;
    uint256 public mintPrice;
    bool public transfersEnabled;
    address public paymentSplitter;
    mapping(address => mapping(uint8 => uint8)) public mintLimitsByStage;

    enum Stage {
        Guaranteed,
        FirstComeFirstServe,
        Public
    }

    struct MintRequest {
        address account;
        uint8 stage;
        uint8 mintLimit;
    }

    bytes32 private constant MINT_REQUEST_TYPE_HASH =
        keccak256("MintRequest(address account,uint8 stage,uint8 mintLimit)");

    constructor(
        string memory name_,
        string memory symbol_,
        uint256 maxSupply_,
        string memory prefix_,
        string memory suffix_,
        address royaltyReceiver_,
        uint96 royaltyFeeNumerator_,
        address signer_,
        address paymentSplitter_
    )
        ERC721AC(name_, symbol_)
        BasicRoyalties(royaltyReceiver_, royaltyFeeNumerator_)
        EIP712("KABU-NFT", "0.1.0")
        Supply(maxSupply_)
        UriManager(prefix_, suffix_)
    {
        _pause();
        signer = signer_;
        paymentSplitter = paymentSplitter_;
        stage = Stage.Guaranteed;
        mintPrice = 0.001 ether;
        transfersEnabled = false;
    }

    function mint(
        uint8 amount_,
        MintRequest calldata request_,
        bytes calldata signature_
    )
        external
        payable
        whenAuthorized(request_, signature_)
        whenNotPaused
        nonReentrant
    {
        if (Stage(request_.stage) != stage) {
            revert InvalidStage();
        }

        if (request_.account != msg.sender) {
            revert InvalidAccount();
        }

        if (
            mintLimitsByStage[request_.account][request_.stage] + amount_ >
            request_.mintLimit
        ) {
            revert ExceedsLimit();
        }

        mintLimitsByStage[request_.account][request_.stage] += amount_;
        _handlePayment(amount_ * mintPrice);
        _callMint(msg.sender, amount_);
    }

    function withdraw() public {
        _requireCallerIsContractOwner();
        (bool success, ) = payable(address(paymentSplitter)).call{
            value: address(this).balance
        }("");

        if (!success) {
            revert TransferError();
        }
    }

    function adminWithdraw(address payable account_) public {
        _requireCallerIsContractOwner();
        (bool success, ) = account_.call{value: address(this).balance}("");

        if (!success) {
            revert TransferError();
        }
    }

    function setStage(uint8 stage_) public {
        _requireCallerIsContractOwner();
        stage = Stage(stage_);
    }

    function setSigner(address signer_) public {
        _requireCallerIsContractOwner();
        signer = signer_;
    }

    function setMintPrice(uint256 mintPrice_) public {
        _requireCallerIsContractOwner();
        mintPrice = mintPrice_;
    }

    function setPaymentSplitter(address paymentsSplitter_) public {
        _requireCallerIsContractOwner();
        paymentSplitter = paymentsSplitter_;
    }

    function setTransfersEnabled(bool enabled_) public {
        _requireCallerIsContractOwner();
        transfersEnabled = enabled_;
    }

    function setDefaultRoyalty(address receiver_, uint96 feeNumerator_) public {
        _requireCallerIsContractOwner();
        _setDefaultRoyalty(receiver_, feeNumerator_);
    }

    function setTokenRoyalty(
        uint256 tokenId_,
        address receiver_,
        uint96 feeNumerator_
    ) public {
        _requireCallerIsContractOwner();
        _setTokenRoyalty(tokenId_, receiver_, feeNumerator_);
    }

    function pause() public {
        _requireCallerIsContractOwner();
        _pause();
    }

    function unpause() public {
        _requireCallerIsContractOwner();
        _unpause();
    }

    function tokenURI(
        uint256 tokenId_
    ) public view override returns (string memory) {
        if (!_exists(tokenId_)) {
            revert URIQueryForNonexistentToken();
        }

        return _buildUri(tokenId_);
    }

    function supportsInterface(
        bytes4 interfaceId_
    ) public view virtual override(ERC721AC, ERC2981) returns (bool) {
        return
            ERC721AC.supportsInterface(interfaceId_) ||
            ERC2981.supportsInterface(interfaceId_);
    }

    function setApprovalForAll(
        address operator_,
        bool approved_
    ) public override {
        if (!transfersEnabled) {
            revert TransfersNotEnabled();
        }

        super.setApprovalForAll(operator_, approved_);
    }

    function _ownerMint(address account_, uint256 amount_) internal override {
        _callMint(account_, amount_);
    }

    function _callMint(
        address account_,
        uint256 amount_
    ) internal onlyInSupply(amount_) {
        _safeMint(account_, amount_);
    }

    function _currentSupply() internal view override returns (uint256) {
        return totalSupply();
    }

    function _startTokenId() internal pure override returns (uint256) {
        return 1;
    }

    function _beforeTokenTransfers(
        address from_,
        address to_,
        uint256 startTokenId_,
        uint256 quantity_
    ) internal override {
        if (!transfersEnabled && from_ != address(0)) {
            revert TransfersNotEnabled();
        }

        super._beforeTokenTransfers(from_, to_, startTokenId_, quantity_);
    }

    function _hashTypedData(
        MintRequest calldata request_
    ) internal pure returns (bytes32) {
        return
            keccak256(
                abi.encode(
                    MINT_REQUEST_TYPE_HASH,
                    request_.account,
                    request_.stage,
                    request_.mintLimit
                )
            );
    }

    function _handlePayment(uint256 cost_) internal {
        if (msg.value < cost_) {
            revert InsufficientFunds();
        }

        uint256 difference = msg.value - cost_;
        if (difference > 0) {
            (bool success, ) = payable(msg.sender).call{value: difference}("");
            if (!success) {
                revert TransferError();
            }
        }
    }

    modifier whenAuthorized(
        MintRequest calldata request_,
        bytes calldata signature_
    ) {
        bytes32 structHash = _hashTypedData(request_);
        bytes32 digest = _hashTypedDataV4(structHash);
        address recoveredSigner = ECDSA.recover(digest, signature_);
        if (recoveredSigner != signer) {
            revert UnauthorizedRequest();
        }
        _;
    }
}

//SPDX-License-Identifier: MIT

pragma solidity ^0.8.17;

import "@limitbreak/creator-token-standards/src/access/OwnablePermissions.sol";

abstract contract Supply is OwnablePermissions {
    uint256 internal _maxSupply;

    constructor(uint256 maxSupply_) {
        _maxSupply = maxSupply_;
    }

    function setMaxSupply(uint256 maxSupply_) external {
        _requireCallerIsContractOwner();
        _maxSupply = maxSupply_;
    }

    function maxSupply() external view returns (uint256) {
        return _maxSupply;
    }

    function _currentSupply() internal view virtual returns (uint256);

    modifier onlyInSupply(uint256 amount_) {
        require(_currentSupply() + amount_ <= _maxSupply, "Exceeds supply");
        _;
    }
}

//SPDX-License-Identifier: MIT

pragma solidity ^0.8.17;

import "@limitbreak/creator-token-standards/src/access/OwnablePermissions.sol";
import "@openzeppelin/contracts/utils/Strings.sol";

abstract contract UriManager is OwnablePermissions {
    using Strings for uint256;

    string internal _prefix;
    string internal _suffix;

    constructor(string memory prefix_, string memory suffix_) {
        _prefix = prefix_;
        _suffix = suffix_;
    }

    function prefix() public view returns (string memory) {
        return _prefix;
    }

    function suffix() public view returns (string memory) {
        return _suffix;
    }

    function _buildUri(uint256 tokenId) internal view returns (string memory) {
        return string(abi.encodePacked(_prefix, tokenId.toString(), _suffix));
    }

    function setPrefix(string calldata prefix_) public {
        _requireCallerIsContractOwner();
        _prefix = prefix_;
    }

    function setSuffix(string calldata suffix_) public {
        _requireCallerIsContractOwner();
        _suffix = suffix_;
    }
}

//SPDX-License-Identifier: MIT

pragma solidity ^0.8.17;

import "@limitbreak/creator-token-standards/src/access/OwnablePermissions.sol";

abstract contract OwnerMint is OwnablePermissions {
    function ownerMint(
        address[] calldata accounts_,
        uint256[] calldata amounts_
    ) external {
        _requireCallerIsContractOwner();
        uint256 accountsLength = accounts_.length;
        require(accountsLength == amounts_.length, "Owner mint: bad request");
        for (uint256 i; i < accountsLength; i++) {
            _ownerMint(accounts_[i], amounts_[i]);
        }
    }

    function _ownerMint(address account_, uint256 amount_) internal virtual;
}

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

interface IPaymentSplitter {
    function release(address account) external;
}

// 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/AutomaticValidatorTransferApproval.sol";
import "../utils/CreatorTokenBase.sol";
import "erc721a/contracts/ERC721A.sol";
import {TOKEN_TYPE_ERC721} from "@limitbreak/permit-c/src/Constants.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, AutomaticValidatorTransferApproval {

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

    /**
     * @notice Overrides behavior of isApprovedFor all such that if an operator is not explicitly approved
     *         for all, the contract owner can optionally auto-approve the 721-C transfer validator for transfers.
     */
    function isApprovedForAll(address owner, address operator) public view virtual override returns (bool isApproved) {
        isApproved = super.isApprovedForAll(owner, operator);

        if (!isApproved) {
            if (autoApproveTransfersFromValidator) {
                isApproved = operator == address(getTransferValidator());
            }
        }
    }

    /**
     * @notice Indicates whether the contract implements the specified interface.
     * @dev Overrides supportsInterface in ERC165.
     * @param interfaceId The interface id
     * @return true if the contract implements the specified interface, false otherwise
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return 
        interfaceId == type(ICreatorToken).interfaceId || 
        interfaceId == type(ICreatorTokenLegacy).interfaceId || 
        super.supportsInterface(interfaceId);
    }

    /**
     * @notice Returns the function selector for the transfer validator's validation function to be called 
     * @notice for transaction simulation. 
     */
    function getTransferValidationFunction() external pure returns (bytes4 functionSignature, bool isViewFunction) {
        functionSignature = bytes4(keccak256("validateTransfer(address,address,address,uint256)"));
        isViewFunction = true;
    }

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

    function _tokenType() internal pure override returns(uint16) {
        return uint16(TOKEN_TYPE_ERC721);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/EIP712.sol)

pragma solidity ^0.8.8;

import "./ECDSA.sol";
import "../ShortStrings.sol";
import "../../interfaces/IERC5267.sol";

/**
 * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.
 *
 * The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,
 * thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding
 * they need in their contracts using a combination of `abi.encode` and `keccak256`.
 *
 * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding
 * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA
 * ({_hashTypedDataV4}).
 *
 * The implementation of the domain separator was designed to be as efficient as possible while still properly updating
 * the chain id to protect against replay attacks on an eventual fork of the chain.
 *
 * NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method
 * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].
 *
 * NOTE: In the upgradeable version of this contract, the cached values will correspond to the address, and the domain
 * separator of the implementation contract. This will cause the `_domainSeparatorV4` function to always rebuild the
 * separator from the immutable values, which is cheaper than accessing a cached version in cold storage.
 *
 * _Available since v3.4._
 *
 * @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment
 */
abstract contract EIP712 is IERC5267 {
    using ShortStrings for *;

    bytes32 private constant _TYPE_HASH =
        keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");

    // Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to
    // invalidate the cached domain separator if the chain id changes.
    bytes32 private immutable _cachedDomainSeparator;
    uint256 private immutable _cachedChainId;
    address private immutable _cachedThis;

    bytes32 private immutable _hashedName;
    bytes32 private immutable _hashedVersion;

    ShortString private immutable _name;
    ShortString private immutable _version;
    string private _nameFallback;
    string private _versionFallback;

    /**
     * @dev Initializes the domain separator and parameter caches.
     *
     * The meaning of `name` and `version` is specified in
     * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:
     *
     * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.
     * - `version`: the current major version of the signing domain.
     *
     * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart
     * contract upgrade].
     */
    constructor(string memory name, string memory version) {
        _name = name.toShortStringWithFallback(_nameFallback);
        _version = version.toShortStringWithFallback(_versionFallback);
        _hashedName = keccak256(bytes(name));
        _hashedVersion = keccak256(bytes(version));

        _cachedChainId = block.chainid;
        _cachedDomainSeparator = _buildDomainSeparator();
        _cachedThis = address(this);
    }

    /**
     * @dev Returns the domain separator for the current chain.
     */
    function _domainSeparatorV4() internal view returns (bytes32) {
        if (address(this) == _cachedThis && block.chainid == _cachedChainId) {
            return _cachedDomainSeparator;
        } else {
            return _buildDomainSeparator();
        }
    }

    function _buildDomainSeparator() private view returns (bytes32) {
        return keccak256(abi.encode(_TYPE_HASH, _hashedName, _hashedVersion, block.chainid, address(this)));
    }

    /**
     * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
     * function returns the hash of the fully encoded EIP712 message for this domain.
     *
     * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
     *
     * ```solidity
     * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
     *     keccak256("Mail(address to,string contents)"),
     *     mailTo,
     *     keccak256(bytes(mailContents))
     * )));
     * address signer = ECDSA.recover(digest, signature);
     * ```
     */
    function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {
        return ECDSA.toTypedDataHash(_domainSeparatorV4(), structHash);
    }

    /**
     * @dev See {EIP-5267}.
     *
     * _Available since v4.9._
     */
    function eip712Domain()
        public
        view
        virtual
        override
        returns (
            bytes1 fields,
            string memory name,
            string memory version,
            uint256 chainId,
            address verifyingContract,
            bytes32 salt,
            uint256[] memory extensions
        )
    {
        return (
            hex"0f", // 01111
            _name.toStringWithFallback(_nameFallback),
            _version.toStringWithFallback(_versionFallback),
            block.chainid,
            address(this),
            bytes32(0),
            new uint256[](0)
        );
    }
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.4;

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)

pragma solidity ^0.8.0;

/**
 * @dev Contract module that helps prevent reentrant calls to a function.
 *
 * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
 * available, which can be applied to functions to make sure there are no nested
 * (reentrant) calls to them.
 *
 * Note that because there is a single `nonReentrant` guard, functions marked as
 * `nonReentrant` may not call one another. This can be worked around by making
 * those functions `private`, and then adding `external` `nonReentrant` entry
 * points to them.
 *
 * TIP: If you would like to learn more about reentrancy and alternative ways
 * to protect against it, check out our blog post
 * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
 */
abstract contract ReentrancyGuard {
    // Booleans are more expensive than uint256 or any type that takes up a full
    // word because each write operation emits an extra SLOAD to first read the
    // slot's contents, replace the bits taken up by the boolean, and then write
    // back. This is the compiler's defense against contract upgrades and
    // pointer aliasing, and it cannot be disabled.

    // The values being non-zero value makes deployment a bit more expensive,
    // but in exchange the refund on every call to nonReentrant will be lower in
    // amount. Since refunds are capped to a percentage of the total
    // transaction's gas, it is best to keep them low in cases like this one, to
    // increase the likelihood of the full refund coming into effect.
    uint256 private constant _NOT_ENTERED = 1;
    uint256 private constant _ENTERED = 2;

    uint256 private _status;

    constructor() {
        _status = _NOT_ENTERED;
    }

    /**
     * @dev Prevents a contract from calling itself, directly or indirectly.
     * Calling a `nonReentrant` function from another `nonReentrant`
     * function is not supported. It is possible to prevent this from happening
     * by making the `nonReentrant` function external, and making it call a
     * `private` function that does the actual work.
     */
    modifier nonReentrant() {
        _nonReentrantBefore();
        _;
        _nonReentrantAfter();
    }

    function _nonReentrantBefore() private {
        // On the first call to nonReentrant, _status will be _NOT_ENTERED
        require(_status != _ENTERED, "ReentrancyGuard: reentrant call");

        // Any calls to nonReentrant after this point will fail
        _status = _ENTERED;
    }

    function _nonReentrantAfter() private {
        // By storing the original value once again, a refund is triggered (see
        // https://eips.ethereum.org/EIPS/eip-2200)
        _status = _NOT_ENTERED;
    }

    /**
     * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
     * `nonReentrant` function in the call stack.
     */
    function _reentrancyGuardEntered() internal view returns (bool) {
        return _status == _ENTERED;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)

pragma solidity ^0.8.0;

import "../Strings.sol";

/**
 * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
 *
 * These functions can be used to verify that a message was signed by the holder
 * of the private keys of a given address.
 */
library ECDSA {
    enum RecoverError {
        NoError,
        InvalidSignature,
        InvalidSignatureLength,
        InvalidSignatureS,
        InvalidSignatureV // Deprecated in v4.8
    }

    function _throwError(RecoverError error) private pure {
        if (error == RecoverError.NoError) {
            return; // no error: do nothing
        } else if (error == RecoverError.InvalidSignature) {
            revert("ECDSA: invalid signature");
        } else if (error == RecoverError.InvalidSignatureLength) {
            revert("ECDSA: invalid signature length");
        } else if (error == RecoverError.InvalidSignatureS) {
            revert("ECDSA: invalid signature 's' value");
        }
    }

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with
     * `signature` or error string. This address can then be used for verification purposes.
     *
     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
     * this function rejects them by requiring the `s` value to be in the lower
     * half order, and the `v` value to be either 27 or 28.
     *
     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
     * verification to be secure: it is possible to craft signatures that
     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
     * this is by receiving a hash of the original message (which may otherwise
     * be too long), and then calling {toEthSignedMessageHash} on it.
     *
     * Documentation for signature generation:
     * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
     * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
        if (signature.length == 65) {
            bytes32 r;
            bytes32 s;
            uint8 v;
            // ecrecover takes the signature parameters, and the only way to get them
            // currently is to use assembly.
            /// @solidity memory-safe-assembly
            assembly {
                r := mload(add(signature, 0x20))
                s := mload(add(signature, 0x40))
                v := byte(0, mload(add(signature, 0x60)))
            }
            return tryRecover(hash, v, r, s);
        } else {
            return (address(0), RecoverError.InvalidSignatureLength);
        }
    }

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with
     * `signature`. This address can then be used for verification purposes.
     *
     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
     * this function rejects them by requiring the `s` value to be in the lower
     * half order, and the `v` value to be either 27 or 28.
     *
     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
     * verification to be secure: it is possible to craft signatures that
     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
     * this is by receiving a hash of the original message (which may otherwise
     * be too long), and then calling {toEthSignedMessageHash} on it.
     */
    function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, signature);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
     *
     * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {
        bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
        uint8 v = uint8((uint256(vs) >> 255) + 27);
        return tryRecover(hash, v, r, s);
    }

    /**
     * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
     *
     * _Available since v4.2._
     */
    function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, r, vs);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
     * `r` and `s` signature fields separately.
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {
        // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
        // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
        // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
        // signatures from current libraries generate a unique signature with an s-value in the lower half order.
        //
        // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
        // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
        // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
        // these malleable signatures as well.
        if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
            return (address(0), RecoverError.InvalidSignatureS);
        }

        // If the signature is valid (and not malleable), return the signer address
        address signer = ecrecover(hash, v, r, s);
        if (signer == address(0)) {
            return (address(0), RecoverError.InvalidSignature);
        }

        return (signer, RecoverError.NoError);
    }

    /**
     * @dev Overload of {ECDSA-recover} that receives the `v`,
     * `r` and `s` signature fields separately.
     */
    function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Returns an Ethereum Signed Message, created from a `hash`. This
     * produces hash corresponding to the one signed with the
     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
     * JSON-RPC method as part of EIP-191.
     *
     * See {recover}.
     */
    function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {
        // 32 is the length in bytes of hash,
        // enforced by the type signature above
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, "\x19Ethereum Signed Message:\n32")
            mstore(0x1c, hash)
            message := keccak256(0x00, 0x3c)
        }
    }

    /**
     * @dev Returns an Ethereum Signed Message, created from `s`. This
     * produces hash corresponding to the one signed with the
     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
     * JSON-RPC method as part of EIP-191.
     *
     * See {recover}.
     */
    function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
        return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", Strings.toString(s.length), s));
    }

    /**
     * @dev Returns an Ethereum Signed Typed Data, created from a
     * `domainSeparator` and a `structHash`. This produces hash corresponding
     * to the one signed with the
     * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
     * JSON-RPC method as part of EIP-712.
     *
     * See {recover}.
     */
    function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {
        /// @solidity memory-safe-assembly
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, "\x19\x01")
            mstore(add(ptr, 0x02), domainSeparator)
            mstore(add(ptr, 0x22), structHash)
            data := keccak256(ptr, 0x42)
        }
    }

    /**
     * @dev Returns an Ethereum Signed Data with intended validator, created from a
     * `validator` and `data` according to the version 0 of EIP-191.
     *
     * See {recover}.
     */
    function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {
        return keccak256(abi.encodePacked("\x19\x00", validator, data));
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)

pragma solidity ^0.8.0;

import "../utils/Context.sol";

/**
 * @dev Contract module which allows children to implement an emergency stop
 * mechanism that can be triggered by an authorized account.
 *
 * This module is used through inheritance. It will make available the
 * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
 * the functions of your contract. Note that they will not be pausable by
 * simply including this module, only once the modifiers are put in place.
 */
abstract contract Pausable is Context {
    /**
     * @dev Emitted when the pause is triggered by `account`.
     */
    event Paused(address account);

    /**
     * @dev Emitted when the pause is lifted by `account`.
     */
    event Unpaused(address account);

    bool private _paused;

    /**
     * @dev Initializes the contract in unpaused state.
     */
    constructor() {
        _paused = false;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is not paused.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    modifier whenNotPaused() {
        _requireNotPaused();
        _;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is paused.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    modifier whenPaused() {
        _requirePaused();
        _;
    }

    /**
     * @dev Returns true if the contract is paused, and false otherwise.
     */
    function paused() public view virtual returns (bool) {
        return _paused;
    }

    /**
     * @dev Throws if the contract is paused.
     */
    function _requireNotPaused() internal view virtual {
        require(!paused(), "Pausable: paused");
    }

    /**
     * @dev Throws if the contract is not paused.
     */
    function _requirePaused() internal view virtual {
        require(paused(), "Pausable: not paused");
    }

    /**
     * @dev Triggers stopped state.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    function _pause() internal virtual whenNotPaused {
        _paused = true;
        emit Paused(_msgSender());
    }

    /**
     * @dev Returns to normal state.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    function _unpause() internal virtual whenPaused {
        _paused = false;
        emit Unpaused(_msgSender());
    }
}

// SPDX-License-Identifier: MIT
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 v4.9.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/Math.sol";
import "./math/SignedMath.sol";

/**
 * @dev String operations.
 */
library Strings {
    bytes16 private constant _SYMBOLS = "0123456789abcdef";
    uint8 private constant _ADDRESS_LENGTH = 20;

    /**
     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
     */
    function toString(uint256 value) internal pure returns (string memory) {
        unchecked {
            uint256 length = Math.log10(value) + 1;
            string memory buffer = new string(length);
            uint256 ptr;
            /// @solidity memory-safe-assembly
            assembly {
                ptr := add(buffer, add(32, length))
            }
            while (true) {
                ptr--;
                /// @solidity memory-safe-assembly
                assembly {
                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                }
                value /= 10;
                if (value == 0) break;
            }
            return buffer;
        }
    }

    /**
     * @dev Converts a `int256` to its ASCII `string` decimal representation.
     */
    function toString(int256 value) internal pure returns (string memory) {
        return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMath.abs(value))));
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
     */
    function toHexString(uint256 value) internal pure returns (string memory) {
        unchecked {
            return toHexString(value, Math.log256(value) + 1);
        }
    }

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

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

    /**
     * @dev Returns true if the two strings are equal.
     */
    function equal(string memory a, string memory b) internal pure returns (bool) {
        return keccak256(bytes(a)) == keccak256(bytes(b));
    }
}

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

import "../access/OwnablePermissions.sol";

/**
 * @title AutomaticValidatorTransferApproval
 * @author Limit Break, Inc.
 * @notice Base contract mix-in that provides boilerplate code giving the contract owner the
 *         option to automatically approve a 721-C transfer validator implementation for transfers.
 */
abstract contract AutomaticValidatorTransferApproval is OwnablePermissions {

    /// @dev Emitted when the automatic approval flag is modified by the creator.
    event AutomaticApprovalOfTransferValidatorSet(bool autoApproved);

    /// @dev If true, the collection's transfer validator is automatically approved to transfer holder's tokens.
    bool public autoApproveTransfersFromValidator;

    /**
     * @notice Sets if the transfer validator is automatically approved as an operator for all token owners.
     * 
     * @dev    Throws when the caller is not the contract owner.
     * 
     * @param autoApprove If true, the collection's transfer validator will be automatically approved to
     *                    transfer holder's tokens.
     */
    function setAutomaticApprovalOfTransfersFromValidator(bool autoApprove) external {
        _requireCallerIsContractOwner();
        autoApproveTransfersFromValidator = autoApprove;
        emit AutomaticApprovalOfTransferValidatorSet(autoApprove);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC5267.sol)

pragma solidity ^0.8.0;

interface IERC5267 {
    /**
     * @dev MAY be emitted to signal that the domain could have changed.
     */
    event EIP712DomainChanged();

    /**
     * @dev returns the fields and values that describe the domain separator used by this contract for EIP-712
     * signature.
     */
    function eip712Domain()
        external
        view
        returns (
            bytes1 fields,
            string memory name,
            string memory version,
            uint256 chainId,
            address verifyingContract,
            bytes32 salt,
            uint256[] memory extensions
        );
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/ShortStrings.sol)

pragma solidity ^0.8.8;

import "./StorageSlot.sol";

// | string  | 0xAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA   |
// | length  | 0x                                                              BB |
type ShortString is bytes32;

/**
 * @dev This library provides functions to convert short memory strings
 * into a `ShortString` type that can be used as an immutable variable.
 *
 * Strings of arbitrary length can be optimized using this library if
 * they are short enough (up to 31 bytes) by packing them with their
 * length (1 byte) in a single EVM word (32 bytes). Additionally, a
 * fallback mechanism can be used for every other case.
 *
 * Usage example:
 *
 * ```solidity
 * contract Named {
 *     using ShortStrings for *;
 *
 *     ShortString private immutable _name;
 *     string private _nameFallback;
 *
 *     constructor(string memory contractName) {
 *         _name = contractName.toShortStringWithFallback(_nameFallback);
 *     }
 *
 *     function name() external view returns (string memory) {
 *         return _name.toStringWithFallback(_nameFallback);
 *     }
 * }
 * ```
 */
library ShortStrings {
    // Used as an identifier for strings longer than 31 bytes.
    bytes32 private constant _FALLBACK_SENTINEL = 0x00000000000000000000000000000000000000000000000000000000000000FF;

    error StringTooLong(string str);
    error InvalidShortString();

    /**
     * @dev Encode a string of at most 31 chars into a `ShortString`.
     *
     * This will trigger a `StringTooLong` error is the input string is too long.
     */
    function toShortString(string memory str) internal pure returns (ShortString) {
        bytes memory bstr = bytes(str);
        if (bstr.length > 31) {
            revert StringTooLong(str);
        }
        return ShortString.wrap(bytes32(uint256(bytes32(bstr)) | bstr.length));
    }

    /**
     * @dev Decode a `ShortString` back to a "normal" string.
     */
    function toString(ShortString sstr) internal pure returns (string memory) {
        uint256 len = byteLength(sstr);
        // using `new string(len)` would work locally but is not memory safe.
        string memory str = new string(32);
        /// @solidity memory-safe-assembly
        assembly {
            mstore(str, len)
            mstore(add(str, 0x20), sstr)
        }
        return str;
    }

    /**
     * @dev Return the length of a `ShortString`.
     */
    function byteLength(ShortString sstr) internal pure returns (uint256) {
        uint256 result = uint256(ShortString.unwrap(sstr)) & 0xFF;
        if (result > 31) {
            revert InvalidShortString();
        }
        return result;
    }

    /**
     * @dev Encode a string into a `ShortString`, or write it to storage if it is too long.
     */
    function toShortStringWithFallback(string memory value, string storage store) internal returns (ShortString) {
        if (bytes(value).length < 32) {
            return toShortString(value);
        } else {
            StorageSlot.getStringSlot(store).value = value;
            return ShortString.wrap(_FALLBACK_SENTINEL);
        }
    }

    /**
     * @dev Decode a string that was encoded to `ShortString` or written to storage using {setWithFallback}.
     */
    function toStringWithFallback(ShortString value, string storage store) internal pure returns (string memory) {
        if (ShortString.unwrap(value) != _FALLBACK_SENTINEL) {
            return toString(value);
        } else {
            return store;
        }
    }

    /**
     * @dev Return the length of a string that was encoded to `ShortString` or written to storage using {setWithFallback}.
     *
     * WARNING: This will return the "byte length" of the string. This may not reflect the actual length in terms of
     * actual characters as the UTF-8 encoding of a single character can span over multiple bytes.
     */
    function byteLengthWithFallback(ShortString value, string storage store) internal view returns (uint256) {
        if (ShortString.unwrap(value) != _FALLBACK_SENTINEL) {
            return byteLength(value);
        } else {
            return bytes(store).length;
        }
    }
}

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

import "../access/OwnablePermissions.sol";
import "../interfaces/ICreatorToken.sol";
import "../interfaces/ICreatorTokenLegacy.sol";
import "../interfaces/ITransferValidator.sol";
import "./TransferValidation.sol";
import "../interfaces/ITransferValidatorSetTokenType.sol";

/**
 * @title CreatorTokenBase
 * @author Limit Break, Inc.
 * @notice CreatorTokenBaseV3 is an abstract contract that provides basic functionality for managing token 
 * transfer policies through an implementation of ICreatorTokenTransferValidator/ICreatorTokenTransferValidatorV2/ICreatorTokenTransferValidatorV3. 
 * 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>
 *
 * <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 account and codehash blacklists, whitelists, and graylists.</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>
 *
 * <h4>Compatibility:</h4>
 * <ul>Backward and Forward Compatible - V1/V2/V3 Creator Token Base will work with V1/V2/V3 Transfer Validators.</ul>
 */
abstract contract CreatorTokenBase is OwnablePermissions, TransferValidation, ICreatorToken {

    /// @dev Thrown when setting a transfer validator address that has no deployed code.
    error CreatorTokenBase__InvalidTransferValidatorContract();

    /// @dev The default transfer validator that will be used if no transfer validator has been set by the creator.
    address public constant DEFAULT_TRANSFER_VALIDATOR = address(0x721C002B0059009a671D00aD1700c9748146cd1B);

    /// @dev Used to determine if the default transfer validator is applied.
    /// @dev Set to true when the creator sets a transfer validator address.
    bool private isValidatorInitialized;
    /// @dev Address of the transfer validator to apply to transactions.
    address private transferValidator;

    constructor() {
        _emitDefaultTransferValidator();
        _registerTokenType(DEFAULT_TRANSFER_VALIDATOR);
    }

    /**
     * @notice Sets the transfer validator for the token contract.
     *
     * @dev    Throws when provided validator contract is not the zero address and does not have code.
     * @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 = transferValidator_.code.length > 0;

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

        emit TransferValidatorUpdated(address(getTransferValidator()), transferValidator_);

        isValidatorInitialized = true;
        transferValidator = transferValidator_;

        _registerTokenType(transferValidator_);
    }

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

        if (validator == address(0)) {
            if (!isValidatorInitialized) {
                validator = DEFAULT_TRANSFER_VALIDATOR;
            }
        }
    }

    /**
     * @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 Be aware that if the msg.sender is the transfer validator, the transfer is automatically permitted, as the
     *      transfer validator is expected to pre-validate the transfer.
     *
     * @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.
     * @param tokenId The token id being transferred.
     */
    function _preValidateTransfer(
        address caller, 
        address from, 
        address to, 
        uint256 tokenId, 
        uint256 /*value*/) internal virtual override {
        address validator = getTransferValidator();

        if (validator != address(0)) {
            if (msg.sender == validator) {
                return;
            }

            ITransferValidator(validator).validateTransfer(caller, from, to, tokenId);
        }
    }

    /**
     * @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 Be aware that if the msg.sender is the transfer validator, the transfer is automatically permitted, as the
     *      transfer validator is expected to pre-validate the transfer.
     * 
     * @dev Used for ERC20 and ERC1155 token transfers which have an amount value to validate in the transfer validator.
     * @dev The `tokenId` for ERC20 tokens should be set to `0`.
     *
     * @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.
     * @param tokenId The token id being transferred.
     * @param amount  The amount of token being transferred.
     */
    function _preValidateTransfer(
        address caller, 
        address from, 
        address to, 
        uint256 tokenId, 
        uint256 amount,
        uint256 /*value*/) internal virtual override {
        address validator = getTransferValidator();

        if (validator != address(0)) {
            if (msg.sender == validator) {
                return;
            }

            ITransferValidator(validator).validateTransfer(caller, from, to, tokenId, amount);
        }
    }

    function _tokenType() internal virtual pure returns(uint16);

    function _registerTokenType(address validator) internal {
        if (validator != address(0)) {
            uint256 validatorCodeSize;
            assembly {
                validatorCodeSize := extcodesize(validator)
            }
            if(validatorCodeSize > 0) {
                try ITransferValidatorSetTokenType(validator).setTokenTypeOfCollection(address(this), _tokenType()) {
                } catch { }
            }
        }
    }

    /**
     * @dev  Used during contract deployment for constructable and cloneable creator tokens
     * @dev  to emit the `TransferValidatorUpdated` event signaling the validator for the contract
     * @dev  is the default transfer validator.
     */
    function _emitDefaultTransferValidator() internal {
        emit TransferValidatorUpdated(address(0), DEFAULT_TRANSFER_VALIDATOR);
    }
}

// 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
// OpenZeppelin Contracts (last updated v4.9.0) (token/common/ERC2981.sol)

pragma solidity ^0.8.0;

import "../../interfaces/IERC2981.sol";
import "../../utils/introspection/ERC165.sol";

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

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

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

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

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

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

        return (royalty.receiver, royaltyAmount);
    }

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

    /**
     * @dev Sets the royalty information that all ids in this contract will default to.
     *
     * Requirements:
     *
     * - `receiver` cannot be the zero address.
     * - `feeNumerator` cannot be greater than the fee denominator.
     */
    function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
        require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
        require(receiver != address(0), "ERC2981: invalid receiver");

        _defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
    }

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

    /**
     * @dev Sets the royalty information for a specific token id, overriding the global default.
     *
     * Requirements:
     *
     * - `receiver` cannot be the zero address.
     * - `feeNumerator` cannot be greater than the fee denominator.
     */
    function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual {
        require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
        require(receiver != address(0), "ERC2981: Invalid parameters");

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

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

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

/// @dev Constant bytes32 value of 0x000...000
bytes32 constant ZERO_BYTES32 = bytes32(0);

/// @dev Constant value of 0
uint256 constant ZERO = 0;
/// @dev Constant value of 1
uint256 constant ONE = 1;

/// @dev Constant value representing an open order in storage
uint8 constant ORDER_STATE_OPEN = 0;
/// @dev Constant value representing a filled order in storage
uint8 constant ORDER_STATE_FILLED = 1;
/// @dev Constant value representing a cancelled order in storage
uint8 constant ORDER_STATE_CANCELLED = 2;

/// @dev Constant value representing the ERC721 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC721 = 721;
/// @dev Constant value representing the ERC1155 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC1155 = 1155;
/// @dev Constant value representing the ERC20 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC20 = 20;

/// @dev Constant value to mask the upper bits of a signature that uses a packed `vs` value to extract `s`
bytes32 constant UPPER_BIT_MASK = 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff;

/// @dev EIP-712 typehash used for validating signature based stored approvals
bytes32 constant UPDATE_APPROVAL_TYPEHASH =
    keccak256("UpdateApprovalBySignature(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 approvalExpiration,uint256 sigDeadline,uint256 masterNonce)");

/// @dev EIP-712 typehash used for validating a single use permit without additional data
bytes32 constant SINGLE_USE_PERMIT_TYPEHASH =
    keccak256("PermitTransferFrom(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 expiration,uint256 masterNonce)");

/// @dev EIP-712 typehash used for validating a single use permit with additional data
string constant SINGLE_USE_PERMIT_TRANSFER_ADVANCED_TYPEHASH_STUB =
    "PermitTransferFromWithAdditionalData(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 expiration,uint256 masterNonce,";

/// @dev EIP-712 typehash used for validating an order permit that updates storage as it fills
string constant PERMIT_ORDER_ADVANCED_TYPEHASH_STUB =
    "PermitOrderWithAdditionalData(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 salt,address operator,uint256 expiration,uint256 masterNonce,";

/// @dev Pausable flag for stored approval transfers of ERC721 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC721 = 1 << 0;
/// @dev Pausable flag for stored approval transfers of ERC1155 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC1155 = 1 << 1;
/// @dev Pausable flag for stored approval transfers of ERC20 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC20 = 1 << 2;

/// @dev Pausable flag for single use permit transfers of ERC721 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC721 = 1 << 3;
/// @dev Pausable flag for single use permit transfers of ERC1155 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC1155 = 1 << 4;
/// @dev Pausable flag for single use permit transfers of ERC20 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC20 = 1 << 5;

/// @dev Pausable flag for order fill transfers of ERC1155 assets
uint256 constant PAUSABLE_ORDER_TRANSFER_FROM_ERC1155 = 1 << 6;
/// @dev Pausable flag for order fill transfers of ERC20 assets
uint256 constant PAUSABLE_ORDER_TRANSFER_FROM_ERC20 = 1 << 7;

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)

pragma solidity ^0.8.0;

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

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

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

pragma solidity ^0.8.0;

import "../utils/Context.sol";

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

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

    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    constructor() {
        _transferOwnership(_msgSender());
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        _checkOwner();
        _;
    }

    /**
     * @dev Returns the address of the current owner.
     */
    function owner() public view virtual returns (address) {
        return _owner;
    }

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        require(owner() == _msgSender(), "Ownable: caller is not the owner");
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions. 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 {
        require(newOwner != address(0), "Ownable: new owner is the zero address");
        _transferOwnership(newOwner);
    }

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)

pragma solidity ^0.8.0;

/**
 * @dev Standard signed math utilities missing in the Solidity language.
 */
library SignedMath {
    /**
     * @dev Returns the largest of two signed numbers.
     */
    function max(int256 a, int256 b) internal pure returns (int256) {
        return a > b ? a : b;
    }

    /**
     * @dev Returns the smallest of two signed numbers.
     */
    function min(int256 a, int256 b) internal pure returns (int256) {
        return a < b ? a : b;
    }

    /**
     * @dev Returns the average of two signed numbers without overflow.
     * The result is rounded towards zero.
     */
    function average(int256 a, int256 b) internal pure returns (int256) {
        // Formula from the book "Hacker's Delight"
        int256 x = (a & b) + ((a ^ b) >> 1);
        return x + (int256(uint256(x) >> 255) & (a ^ b));
    }

    /**
     * @dev Returns the absolute unsigned value of a signed value.
     */
    function abs(int256 n) internal pure returns (uint256) {
        unchecked {
            // must be unchecked in order to support `n = type(int256).min`
            return uint256(n >= 0 ? n : -n);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)

pragma solidity ^0.8.0;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    enum Rounding {
        Down, // Toward negative infinity
        Up, // Toward infinity
        Zero // Toward zero
    }

    /**
     * @dev Returns the largest of two numbers.
     */
    function max(uint256 a, uint256 b) internal pure returns (uint256) {
        return a > b ? a : b;
    }

    /**
     * @dev Returns the smallest of two numbers.
     */
    function min(uint256 a, uint256 b) internal pure returns (uint256) {
        return a < b ? a : b;
    }

    /**
     * @dev Returns the average of two numbers. The result is rounded towards
     * zero.
     */
    function average(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b) / 2 can overflow.
        return (a & b) + (a ^ b) / 2;
    }

    /**
     * @dev Returns the ceiling of the division of two numbers.
     *
     * This differs from standard division with `/` in that it rounds up instead
     * of rounding down.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b - 1) / b can overflow on addition, so we distribute.
        return a == 0 ? 0 : (a - 1) / b + 1;
    }

    /**
     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
     * with further edits by Uniswap Labs also under MIT license.
     */
    function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
        unchecked {
            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
            // variables such that product = prod1 * 2^256 + prod0.
            uint256 prod0; // Least significant 256 bits of the product
            uint256 prod1; // Most significant 256 bits of the product
            assembly {
                let mm := mulmod(x, y, not(0))
                prod0 := mul(x, y)
                prod1 := sub(sub(mm, prod0), lt(mm, prod0))
            }

            // Handle non-overflow cases, 256 by 256 division.
            if (prod1 == 0) {
                // Solidity will revert if denominator == 0, unlike the div opcode on its own.
                // The surrounding unchecked block does not change this fact.
                // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            require(denominator > prod1, "Math: mulDiv overflow");

            ///////////////////////////////////////////////
            // 512 by 256 division.
            ///////////////////////////////////////////////

            // Make division exact by subtracting the remainder from [prod1 prod0].
            uint256 remainder;
            assembly {
                // Compute remainder using mulmod.
                remainder := mulmod(x, y, denominator)

                // Subtract 256 bit number from 512 bit number.
                prod1 := sub(prod1, gt(remainder, prod0))
                prod0 := sub(prod0, remainder)
            }

            // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
            // See https://cs.stackexchange.com/q/138556/92363.

            // Does not overflow because the denominator cannot be zero at this stage in the function.
            uint256 twos = denominator & (~denominator + 1);
            assembly {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

                // Divide [prod1 prod0] by twos.
                prod0 := div(prod0, twos)

                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                twos := add(div(sub(0, twos), twos), 1)
            }

            // Shift in bits from prod1 into prod0.
            prod0 |= prod1 * twos;

            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
            // four bits. That is, denominator * inv = 1 mod 2^4.
            uint256 inverse = (3 * denominator) ^ 2;

            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
            // in modular arithmetic, doubling the correct bits in each step.
            inverse *= 2 - denominator * inverse; // inverse mod 2^8
            inverse *= 2 - denominator * inverse; // inverse mod 2^16
            inverse *= 2 - denominator * inverse; // inverse mod 2^32
            inverse *= 2 - denominator * inverse; // inverse mod 2^64
            inverse *= 2 - denominator * inverse; // inverse mod 2^128
            inverse *= 2 - denominator * inverse; // inverse mod 2^256

            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
            // is no longer required.
            result = prod0 * inverse;
            return result;
        }
    }

    /**
     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
     */
    function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
        uint256 result = mulDiv(x, y, denominator);
        if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
            result += 1;
        }
        return result;
    }

    /**
     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
     *
     * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
     */
    function sqrt(uint256 a) internal pure returns (uint256) {
        if (a == 0) {
            return 0;
        }

        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
        //
        // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
        //
        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
        //
        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
        uint256 result = 1 << (log2(a) >> 1);

        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
        // into the expected uint128 result.
        unchecked {
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            return min(result, a / result);
        }
    }

    /**
     * @notice Calculates sqrt(a), following the selected rounding direction.
     */
    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = sqrt(a);
            return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 2, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 128;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 64;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 32;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 16;
            }
            if (value >> 8 > 0) {
                value >>= 8;
                result += 8;
            }
            if (value >> 4 > 0) {
                value >>= 4;
                result += 4;
            }
            if (value >> 2 > 0) {
                value >>= 2;
                result += 2;
            }
            if (value >> 1 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 2, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log2(value);
            return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 10, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >= 10 ** 64) {
                value /= 10 ** 64;
                result += 64;
            }
            if (value >= 10 ** 32) {
                value /= 10 ** 32;
                result += 32;
            }
            if (value >= 10 ** 16) {
                value /= 10 ** 16;
                result += 16;
            }
            if (value >= 10 ** 8) {
                value /= 10 ** 8;
                result += 8;
            }
            if (value >= 10 ** 4) {
                value /= 10 ** 4;
                result += 4;
            }
            if (value >= 10 ** 2) {
                value /= 10 ** 2;
                result += 2;
            }
            if (value >= 10 ** 1) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log10(value);
            return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 256, rounded down, of a positive value.
     * Returns 0 if given 0.
     *
     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
     */
    function log256(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 16;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 8;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 4;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 2;
            }
            if (value >> 8 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 256, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log256(value);
            return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);
        }
    }
}

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

interface ICreatorToken {
    event TransferValidatorUpdated(address oldValidator, address newValidator);
    function getTransferValidator() external view returns (address validator);
    function setTransferValidator(address validator) external;
    function getTransferValidationFunction() external view returns (bytes4 functionSignature, bool isViewFunction);
}

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

interface ITransferValidator {
    function applyCollectionTransferPolicy(address caller, address from, address to) external view;
    function validateTransfer(address caller, address from, address to) external view;
    function validateTransfer(address caller, address from, address to, uint256 tokenId) external view;
    function validateTransfer(address caller, address from, address to, uint256 tokenId, uint256 amount) external;

    function beforeAuthorizedTransfer(address operator, address token, uint256 tokenId) external;
    function afterAuthorizedTransfer(address token, uint256 tokenId) external;
    function beforeAuthorizedTransfer(address operator, address token) external;
    function afterAuthorizedTransfer(address token) external;
    function beforeAuthorizedTransfer(address token, uint256 tokenId) external;
    function beforeAuthorizedTransferWithAmount(address token, uint256 tokenId, uint256 amount) external;
    function afterAuthorizedTransferWithAmount(address token, uint256 tokenId) external;
}

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

interface ITransferValidatorSetTokenType {
    function setTokenTypeOfCollection(address collection, uint16 tokenType) external;
}

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

interface ICreatorTokenLegacy {
    event TransferValidatorUpdated(address oldValidator, address newValidator);
    function getTransferValidator() external view returns (address validator);
    function setTransferValidator(address validator) external;
}

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

pragma solidity ^0.8.0;

import "../utils/introspection/IERC165.sol";

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)
// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.

pragma solidity ^0.8.0;

/**
 * @dev Library for reading and writing primitive types to specific storage slots.
 *
 * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
 * This library helps with reading and writing to such slots without the need for inline assembly.
 *
 * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
 *
 * Example usage to set ERC1967 implementation slot:
 * ```solidity
 * contract ERC1967 {
 *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
 *
 *     function _getImplementation() internal view returns (address) {
 *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
 *     }
 *
 *     function _setImplementation(address newImplementation) internal {
 *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
 *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
 *     }
 * }
 * ```
 *
 * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._
 * _Available since v4.9 for `string`, `bytes`._
 */
library StorageSlot {
    struct AddressSlot {
        address value;
    }

    struct BooleanSlot {
        bool value;
    }

    struct Bytes32Slot {
        bytes32 value;
    }

    struct Uint256Slot {
        uint256 value;
    }

    struct StringSlot {
        string value;
    }

    struct BytesSlot {
        bytes value;
    }

    /**
     * @dev Returns an `AddressSlot` with member `value` located at `slot`.
     */
    function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
     */
    function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
     */
    function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
     */
    function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `StringSlot` with member `value` located at `slot`.
     */
    function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
     */
    function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := store.slot
        }
    }

    /**
     * @dev Returns an `BytesSlot` with member `value` located at `slot`.
     */
    function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
     */
    function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := store.slot
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)

pragma solidity ^0.8.0;

import "./IERC165.sol";

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

// SPDX-License-Identifier: MIT
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 {
    
    /// @dev Thrown when the from and to address are both the zero address.
    error ShouldNotMintToBurnAddress();

    /*************************************************************************/
    /*                      Transfers Without Amounts                        */
    /*************************************************************************/

    /// @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 {}

    /*************************************************************************/
    /*                         Transfers With Amounts                        */
    /*************************************************************************/

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

        if(fromZeroAddress && toZeroAddress) {
            revert ShouldNotMintToBurnAddress();
        } else if(fromZeroAddress) {
            _preValidateMint(_msgSender(), to, tokenId, amount, msg.value);
        } else if(toZeroAddress) {
            _preValidateBurn(_msgSender(), from, tokenId, amount, msg.value);
        } else {
            _preValidateTransfer(_msgSender(), from, to, tokenId, amount, 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, uint256 amount) internal virtual {
        bool fromZeroAddress = from == address(0);
        bool toZeroAddress = to == address(0);

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

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

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

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

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

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

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

// 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 v4.4.1 (utils/introspection/IERC165.sol)

pragma solidity ^0.8.0;

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

{
  "optimizer": {
    "enabled": true,
    "mode": "3"
  },
  "evmVersion": "paris",
  "outputSelection": {
    "*": {
      "*": [
        "abi"
      ]
    }
  },
  "detectMissingLibraries": false,
  "forceEVMLA": false,
  "enableEraVMExtensions": false,
  "libraries": {}
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"},{"internalType":"uint256","name":"maxSupply_","type":"uint256"},{"internalType":"string","name":"prefix_","type":"string"},{"internalType":"string","name":"suffix_","type":"string"},{"internalType":"address","name":"royaltyReceiver_","type":"address"},{"internalType":"uint96","name":"royaltyFeeNumerator_","type":"uint96"},{"internalType":"address","name":"signer_","type":"address"},{"internalType":"address","name":"paymentSplitter_","type":"address"}],"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":"ExceedsLimit","type":"error"},{"inputs":[],"name":"InsufficientFunds","type":"error"},{"inputs":[],"name":"InvalidAccount","type":"error"},{"inputs":[],"name":"InvalidShortString","type":"error"},{"inputs":[],"name":"InvalidStage","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"NotCompatibleWithSpotMints","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":"SpotMintTokenIdTooSmall","type":"error"},{"inputs":[{"internalType":"string","name":"str","type":"string"}],"name":"StringTooLong","type":"error"},{"inputs":[],"name":"TokenAlreadyExists","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferError","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"TransfersNotEnabled","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"UnauthorizedRequest","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":"bool","name":"autoApproved","type":"bool"}],"name":"AutomaticApprovalOfTransferValidatorSet","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":[],"name":"EIP712DomainChanged","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":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","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"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"inputs":[],"name":"DEFAULT_TRANSFER_VALIDATOR","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address payable","name":"account_","type":"address"}],"name":"adminWithdraw","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":[],"name":"autoApproveTransfersFromValidator","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"eip712Domain","outputs":[{"internalType":"bytes1","name":"fields","type":"bytes1"},{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"version","type":"string"},{"internalType":"uint256","name":"chainId","type":"uint256"},{"internalType":"address","name":"verifyingContract","type":"address"},{"internalType":"bytes32","name":"salt","type":"bytes32"},{"internalType":"uint256[]","name":"extensions","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":"getTransferValidationFunction","outputs":[{"internalType":"bytes4","name":"functionSignature","type":"bytes4"},{"internalType":"bool","name":"isViewFunction","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"getTransferValidator","outputs":[{"internalType":"address","name":"validator","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":"isApproved","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint8","name":"amount_","type":"uint8"},{"components":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint8","name":"stage","type":"uint8"},{"internalType":"uint8","name":"mintLimit","type":"uint8"}],"internalType":"struct Kabu.MintRequest","name":"request_","type":"tuple"},{"internalType":"bytes","name":"signature_","type":"bytes"}],"name":"mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"uint8","name":"","type":"uint8"}],"name":"mintLimitsByStage","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"mintPrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts_","type":"address[]"},{"internalType":"uint256[]","name":"amounts_","type":"uint256[]"}],"name":"ownerMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"paymentSplitter","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"prefix","outputs":[{"internalType":"string","name":"","type":"string"}],"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":"bool","name":"autoApprove","type":"bool"}],"name":"setAutomaticApprovalOfTransfersFromValidator","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":"uint256","name":"maxSupply_","type":"uint256"}],"name":"setMaxSupply","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"mintPrice_","type":"uint256"}],"name":"setMintPrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"paymentsSplitter_","type":"address"}],"name":"setPaymentSplitter","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"prefix_","type":"string"}],"name":"setPrefix","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"signer_","type":"address"}],"name":"setSigner","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint8","name":"stage_","type":"uint8"}],"name":"setStage","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"suffix_","type":"string"}],"name":"setSuffix","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":"bool","name":"enabled_","type":"bool"}],"name":"setTransfersEnabled","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"signer","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stage","outputs":[{"internalType":"enum Kabu.Stage","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"suffix","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","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":[],"name":"transfersEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"}]

9c4d535b0000000000000000000000000000000000000000000000000000000000000000010006f17bf461b760b2a762881cef7848dcbd82bf535e3582f178726c7c158300000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000240000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001600000000000000000000000000000000000000000000000000000000000001b5800000000000000000000000000000000000000000000000000000000000001a00000000000000000000000000000000000000000000000000000000000000220000000000000000000000000cf1e9aa31fcad2ada0a5004310a14ff7ea68fe1700000000000000000000000000000000000000000000000000000000000001f4000000000000000000000000f79c76decf71862ace0ed9d5f1824e951da7fe13000000000000000000000000ad200e2a27acbe6d001c55ac824a83268d00d04000000000000000000000000000000000000000000000000000000000000000044b6162750000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044b41425500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004268747470733a2f2f6b6162752d6d696e742d73746167696e672d3533313239643030643630632e6865726f6b756170702e636f6d2f6170692f6d657461646174612f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

0x0002000000000002001200000000000200010000000103550000006003100270000006200030019d00000620033001970000000100200190000004110000c13d0000008004000039000000400040043f000000040030008c000001520000413d000000000201043b000000e002200270000006490020009c0000018f0000c13d000000440030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000402100370000000000202043b000006230020009c000001520000213d0000002304200039000000000034004b000001520000813d0000000404200039000000000441034f000000000404043b000a00000004001d000006230040009c000001520000213d000900240020003d0000000a0200002900000005022002100000000902200029000000000032004b000001520000213d0000002402100370000000000202043b000006230020009c000001520000213d0000002304200039000000000034004b000001520000813d0000000404200039000000000141034f000000000101043b000006230010009c000001520000213d000800240020003d00000005021002100000000802200029000000000032004b000001520000213d0000000902000039000000000202041a00000626022001970000000003000411000000000032004b000007f60000c13d0000000a02000029000000000012004b0000083c0000c13d000000000002004b0000087b0000613d000700800000003d000c00000000001d0000004c0000013d0000000c020000290000000102200039000c00000002001d0000000a0020006c0000087b0000813d0000000c01000029000000050110021000000009021000290000000102200367000000000202043b001100000002001d000006260020009c000001520000213d00000008021000290000000101000039000000000101041a000006e901100167000000000400041a00000000011400190000000102200367000000000202043b001000000002001d000000000021001a000006eb0000413d0000001001100029000000400300043d0000001002000039000000000202041a000000000021004b00000f770000213d000e00000003001d000006af0030009c000005ba0000213d0000000e010000290000002002100039000000400020043f0000000000010435000000100000006b00000ff40000613d000000110000006b000010650000613d000006e9054001670000000001000019000000000051004b000006eb0000213d0000000101100039000000100010006c000000720000413d000b00000005001d001200000004001d000d00000002001d000006b70100004100000000001004430000000001000414000006200010009c0000062001008041000000c0011002100000063b011001c70000800b02000039187a18750000040f00000001002001900000129e0000613d000000000101043b000f00000001001d0000001201000029000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d0000000f02000029000000a0022002100000001003000029000000010030008c0000000003000019000006b803006041000000000223019f0000001103000029000000000232019f000000000101043b000000000021041b000000000030043f0000000501000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b0000001004000029000006b9024000d1000000000301041a0000000002230019000000000021041b000f00120040002d0000000001000019000000c40000013d00000012070000290000000001000414000006200010009c0000062001008041000000c00110021000000630011001c70000800d020000390000000403000039000006ba0400004100000000050000190000001106000029001200000007001d187a18700000040f00000001002001900000000101000039000001520000613d0000000100100190000000b40000613d000000120700002900000001077000390000000f0070006c000000b50000c13d0000000f01000029000000000010041b00000000010000190000000b03000029000000000031004b000006eb0000213d0000000101100039000000100010006c000000ce0000413d00000635010000410000000000100443000000110100002900000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000000001004b000000470000613d000000400700043d000000000200041a000f00000002001d000000100320006a000000640170003900000080020000390000000000210435000006bb0100004100000000001704350000000401700039000000000200041100000000002104350000004401700039001000000003001d0000000000310435000000240170003900000000000104350000000e01000029000000000101043300000084027000390000000000120435000000a402700039000000000001004b0000000d06000029000001040000613d000000000300001900000000042300190000000005630019000000000505043300000000005404350000002003300039000000000013004b000000fd0000413d0000001f03100039000006ea0330019700000000012100190000000000010435000000a401300039000006200010009c00000620010080410000006001100210000006200070009c000006200200004100000000020740190000004002200210000000000121019f0000000002000414000006200020009c0000062002008041000000c002200210000000000112019f0000001102000029001200000007001d187a18700000040f000000120a00002900000060031002700000062003300197000000200030008c00000020040000390000000004034019000000200640019000000000056a0019000001280000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b000001240000c13d0000001f07400190000001350000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000001540000613d0000001f01400039000000600210018f0000000001a20019000000000021004b00000000020000390000000102004039000006230010009c000005ba0000213d0000000100200190000005ba0000c13d000000400010043f000000200030008c000001520000413d00000000020a0433000006bc00200198000001520000c13d000006bd02200197000006bb0020009c0000015a0000c13d000000100300002900000001033000390000000f0030006c0000000007010019000000e70000413d000000000100041a0000000f0010006c000000470000613d00000000010000190000187c00010430000000000003004b0000015e0000c13d00000060020000390000000001020433000000000001004b000001860000c13d000006cb01000041000000000010043f0000069f010000410000187c000104300000001f0230003900000621022001970000003f02200039000006a504200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000006230040009c000005ba0000213d0000000100500190000005ba0000c13d000000400040043f0000001f0430018f00000000063204360000062205300198000700000006001d0000000003560019000001780000613d000000000601034f0000000707000029000000006806043c0000000007870436000000000037004b000001740000c13d000000000004004b000001570000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000001570000013d0000000702000029000006200020009c00000620020080410000004002200210000006200010009c00000620010080410000006001100210000000000121019f0000187c00010430001200000004001d0000064a0020009c000001ae0000213d0000066c0020009c000001d70000a13d0000066d0020009c0000024b0000a13d0000066e0020009c000002c50000a13d0000066f0020009c000003df0000213d000006720020009c000005570000613d000006730020009c000001520000c13d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b001200000001001d000006260010009c000001520000213d187a18430000040f000000120100002900000008011002100000063f011001970000001602000039000008280000013d0000064b0020009c000002020000a13d0000064c0020009c0000026a0000a13d0000064d0020009c000002db0000a13d0000064e0020009c000003ee0000213d000006510020009c0000055c0000613d000006520020009c000001520000c13d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000601043b000006260060009c000001520000213d0000000901000039000000000201041a00000626032001970000000005000411000000000053004b000007f60000c13d000000000006004b0000091e0000c13d0000064401000041000000800010043f0000002001000039000000840010043f0000002601000039000000a40010043f0000068e01000041000000c40010043f0000068f01000041000000e40010043f00000690010000410000187c000104300000067e0020009c0000028b0000213d000006860020009c000002f40000213d0000068a0020009c000005610000613d0000068b0020009c000005680000613d0000068c0020009c000001520000c13d000000440030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000402100370000000000502043b000006260050009c000001520000213d0000002401100370000000000101043b000006270010009c000001520000213d0000000902000039000000000202041a00000626022001970000000003000411000000000032004b000007f60000c13d000027110010008c000003670000813d000000000005004b00000a4f0000c13d0000064401000041000000800010043f0000002001000039000000840010043f0000001901000039000000a40010043f0000064301000041000000c40010043f000006b2010000410000187c000104300000065d0020009c0000029e0000213d000006650020009c0000030a0000213d000006690020009c0000057c0000613d0000066a0020009c0000058b0000613d0000066b0020009c000001520000c13d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000402100370000000000402043b000006230040009c000001520000213d0000002302400039000000000032004b000001520000813d0000000405400039000000000251034f000000000202043b000006230020009c000001520000213d00000024044000390000000006420019000000000036004b000001520000213d0000000903000039000000000303041a00000626033001970000000006000411000000000063004b000007f60000c13d0000001203000039000000000703041a000000010070019000000001067002700000007f0660618f0000001f0060008c00000000080000390000000108002039000000000787013f0000000100700190000006ff0000c13d000000200060008c000002430000413d000000000030043f0000001f072000390000000507700270000006b30770009a000000200020008c0000068d070040410000001f066000390000000506600270000006b30660009a000000000067004b000002430000813d000000000007041b0000000107700039000000000067004b0000023f0000413d0000001f0020008c00000a610000a13d000000000030043f000006ea0620019800000b840000c13d0000068d05000041000000000700001900000b990000013d000006770020009c000003460000213d0000067b0020009c000005a00000613d0000067c0020009c000005c00000613d0000067d0020009c000001520000c13d0000000001000416000000000001004b000001520000c13d0000000901000039000000000101041a00000626021001970000000001000411000000000012004b000007f60000c13d0000000d02000039000000000302041a000000ff003001900000086d0000c13d0000064401000041000000800010043f0000002001000039000000840010043f0000001401000039000000a40010043f000006d701000041000000c40010043f000006b2010000410000187c00010430000006560020009c000003730000213d0000065a0020009c000005e50000613d0000065b0020009c0000060b0000613d0000065c0020009c000001520000c13d000000440030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000402100370000000000202043b000006260020009c000001520000213d0000002401100370000000000101043b001200000001001d000000ff0010008c000001520000213d000000000020043f0000001701000039000000200010043f00000040020000390000000001000019187a185b0000040f0000001202000029187a13d50000040f000000000101041a000000ff0110018f000002d40000013d0000067f0020009c0000039d0000213d000006830020009c000006280000613d000006840020009c0000062f0000613d000006850020009c000001520000c13d0000000001000416000000000001004b000001520000c13d0000000101000039000000000101041a000006e901100167000000000200041a0000000001120019000000800010043f00000691010000410000187b0001042e0000065e0020009c000003b30000213d000006620020009c000006380000613d000006630020009c000006770000613d000006640020009c000001520000c13d0000000001000416000000000001004b000001520000c13d0000000303000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000006ff0000c13d000000800010043f000000000004004b000008570000613d000000000030043f000000000001004b00000000020000190000085c0000613d000006aa030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000002bd0000413d0000085c0000013d000006740020009c000006800000613d000006750020009c000006850000613d000006760020009c000001520000c13d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b187a180f0000040f0000062601100197000000400200043d0000000000120435000006200020009c0000062002008041000000400120021000000692011001c70000187b0001042e000006530020009c0000068c0000613d000006540020009c000006a10000613d000006550020009c000001520000c13d000000440030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000402100370000000000302043b000006260030009c000001520000213d0000002401100370000000000201043b000006260020009c000001520000213d0000000001030019187a17d90000040f000000000001004b0000000001000039000000010100c039000002d40000013d000006870020009c000006a90000613d000006880020009c000006c80000613d000006890020009c000001520000c13d000000440030008c000001520000413d0000000402100370000000000202043b001100000002001d000006260020009c000001520000213d0000002401100370000000000101043b001000000001001d000000000001004b0000087d0000c13d000006de01000041000000000010043f0000069f010000410000187c00010430000006660020009c000006f10000613d000006670020009c000007050000613d000006680020009c000001520000c13d0000000001000416000000000001004b000001520000c13d000006ac01000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000006200010009c0000062001008041000000c001100210000006ad011001c70000800502000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000ff0010008c000008cd0000c13d0000000e02000039000000000102041a000000010310019000000001041002700000007f0440618f001200000004001d0000001f0040008c00000000040000390000000104002039000000000441013f0000000100400190000006ff0000c13d000000400400043d001100000004001d00000012050000290000000004540436001000000004001d000000000003004b00000a090000613d000000000020043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000120000006b00000b280000c13d000000000100001900000b330000013d000006780020009c0000071f0000613d000006790020009c000007990000613d0000067a0020009c000001520000c13d000000640030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000402100370000000000202043b001100000002001d0000002402100370000000000202043b001200000002001d000006260020009c000001520000213d0000004401100370000000000101043b001000000001001d000006270010009c000001520000213d0000000901000039000000000101041a00000626011001970000000002000411000000000021004b000007f60000c13d0000001001000029000027100010008c00000a100000a13d0000064401000041000000800010043f0000002001000039000000840010043f0000002a01000039000000a40010043f0000064701000041000000c40010043f0000064601000041000000e40010043f00000690010000410000187c00010430000006570020009c000007aa0000613d000006580020009c000007b50000613d000006590020009c000001520000c13d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b001100000001001d000000000001004b000009f60000613d000000000100041a000000110010006c000009f60000a13d0000001101000029001200000001001d000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000000101041a000000000001004b000009ed0000c13d0000001201000029000000000001004b000000010110008a000003870000c13d000006eb0000013d000006800020009c000007c30000613d000006810020009c000007cd0000613d000006820020009c000001520000c13d000000240030008c000001520000413d0000000001000416000000000001004b000001520000c13d187a13800000040f001200000001001d187a18430000040f0000001601000039000000000201041a000006eb02200197000000120000006b000000010220c1bf000000000021041b00000000010000190000187b0001042e0000065f0020009c000007d20000613d000006600020009c000007ff0000613d000006610020009c000001520000c13d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b001200000001001d000006260010009c000001520000213d0000000901000039000000000101041a00000626011001970000000002000411000000000021004b000007f60000c13d000006a4010000410000000000100443000000000100041000000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800a02000039187a18750000040f00000001002001900000129e0000613d000000000301043b0000000001000414000006200010009c0000062001008041000000c001100210000000000003004b00000a1c0000c13d000000120200002900000a200000013d000006700020009c000008190000613d000006710020009c000001520000c13d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b001200000001001d187a18430000040f0000001001000039000008380000013d0000064f0020009c0000082e0000613d000006500020009c000001520000c13d0000000001000416000000000001004b000001520000c13d0000001203000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000006ff0000c13d000000800010043f000000000004004b000008570000613d000000000030043f000000000001004b00000000020000190000085c0000613d0000068d030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000004090000413d0000085c0000013d0000016004000039000000400040043f0000000002000416000000000002004b000001520000c13d0000001f0230003900000621022001970000016002200039000000400020043f0000001f0530018f00000622063001980000016002600039000004230000613d000000000701034f000000007807043c0000000004840436000000000024004b0000041f0000c13d000000000005004b000004300000613d000000000161034f0000000304500210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000120435000001200030008c000001520000413d000001600600043d000006230060009c000001520000213d0000001f01600039000000000031004b000000000200001900000624020080410000062401100197000000000001004b00000000040000190000062404004041000006240010009c000000000402c019000000000004004b000001520000c13d00000160016000390000000005010433000006250050009c000005ba0000813d0000001f01500039000006ea011001970000003f01100039000006ea02100197000000400100043d0000000002210019000000000012004b00000000040000390000000104004039000006230020009c000005ba0000213d0000000100400190000005ba0000c13d0000016004300039000000400020043f000000000251043600000180066000390000000007650019000000000047004b000001520000213d000000000005004b000004630000613d000000000700001900000000082700190000000009670019000000000909043300000000009804350000002007700039000000000057004b0000045c0000413d00000000055200190000000000050435000001800600043d000006230060009c000001520000213d0000001f05600039000000000035004b000000000700001900000624070080410000062405500197000000000005004b00000000080000190000062408004041000006240050009c000000000807c019000000000008004b000001520000c13d00000160056000390000000005050433000006230050009c000005ba0000213d0000001f07500039000006ea077001970000003f07700039000006ea07700197000000400800043d0000000007780019001000000008001d000000000087004b00000000080000390000000108004039000006230070009c000005ba0000213d0000000100800190000005ba0000c13d000000400070043f00000010070000290000000007570436000f00000007001d00000180066000390000000007650019000000000047004b000001520000213d000000000005004b0000000f0a000029000004990000613d00000000070000190000000008a700190000000009670019000000000909043300000000009804350000002007700039000000000057004b000004920000413d00000000055a00190000000000050435000001c00600043d000006230060009c000001520000213d0000001f05600039000000000035004b000000000700001900000624070080410000062405500197000000000005004b00000000080000190000062408004041000006240050009c000000000807c019000000000008004b000001520000c13d00000160056000390000000005050433000006230050009c000005ba0000213d0000001f07500039000006ea077001970000003f07700039000006ea07700197000000400800043d0000000007780019000e00000008001d000000000087004b00000000080000390000000108004039000006230070009c000005ba0000213d0000000100800190000005ba0000c13d000001a00800043d000d00000008001d000000400070043f0000000e070000290000000007570436001200000007001d00000180066000390000000007650019000000000047004b000001520000213d000000000005004b000004d00000613d000000000700001900000012087000290000000009670019000000000909043300000000009804350000002007700039000000000057004b000004c90000413d00000012055000290000000000050435000001e00500043d000006230050009c000001520000213d0000001f06500039000000000036004b000000000300001900000624030080410000062406600197000000000006004b00000000070000190000062407004041000006240060009c000000000703c019000000000007004b000001520000c13d00000160035000390000000003030433000006230030009c000005ba0000213d0000001f06300039000006ea066001970000003f06600039000006ea06600197000000400700043d0000000006670019000c00000007001d000000000076004b00000000070000390000000107004039000006230060009c000005ba0000213d0000000100700190000005ba0000c13d000000400060043f0000000c060000290000000006360436001100000006001d00000180055000390000000006530019000000000046004b000001520000213d000000000003004b000005050000613d000000000400001900000011064000290000000007540019000000000707043300000000007604350000002004400039000000000034004b000004fe0000413d00000011033000290000000000030435000002000300043d000b00000003001d000006260030009c000001520000213d000002200300043d000a00000003001d000006270030009c000001520000213d000002400300043d000900000003001d000006260030009c000001520000213d000002600300043d000500000003001d000006260030009c000001520000213d000000400300043d000800000003001d000006280030009c000005ba0000213d00000008040000290000004003400039000000400030043f000000080300003900000000043404360000062903000041000300000004001d0000000000340435000000400300043d000700000003001d000006280030009c000005ba0000213d00000007040000290000004003400039000000400030043f000000050300003900000000043404360000062a03000041000400000004001d00000000003404350000000004010433000006230040009c000005ba0000213d0000000203000039000000000503041a000000010650019000000001055002700000007f0550618f0000001f0050008c00000000070000390000000107002039000000000076004b000006ff0000c13d000000200050008c0000054d0000413d000000000030043f0000001f0640003900000005066002700000062b0660009a000000200040008c0000062c060040410000001f0550003900000005055002700000062b0550009a000000000056004b0000054d0000813d000000000006041b0000000106600039000000000056004b000005490000413d0000001f0040008c0000000105400210000000030640021000000d970000a13d000000000030043f000006ea0840019800000da00000c13d00000020070000390000062c0200004100000dac0000013d0000000001000416000000000001004b000001520000c13d0000001501000039000006a50000013d0000000001000416000000000001004b000001520000c13d0000001601000039000007c70000013d0000000001000416000000000001004b000001520000c13d0000063201000041000000800010043f00000691010000410000187b0001042e000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000201043b000006bc00200198000001520000c13d0000000101000039000006bd02200197000006e20020009c000009110000a13d000006e30020009c0000091a0000613d000006e40020009c0000091a0000613d000006e50020009c0000091a0000613d000009150000013d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b000006260010009c000001520000213d000000000001004b000008d40000c13d000006b401000041000000000010043f0000069f010000410000187c000104300000000001000416000000000001004b000001520000c13d0000000901000039000000000201041a00000626032001970000000005000411000000000053004b000007f60000c13d0000062f02200197000000000021041b0000000001000414000006200010009c0000062001008041000000c00110021000000630011001c70000800d02000039000000030300003900000631040000410000000006000019000008780000013d000000440030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000002402100370000000000202043b001200000002001d0000000401100370000000000101043b000000000010043f0000000c01000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000400200043d001100000002001d000006280020009c000008df0000a13d000006d001000041000000000010043f0000004101000039000000040010043f000006d1010000410000187c000104300000000001000416000000000001004b000001520000c13d0000000901000039000000000101041a00000626011001970000000002000411000000000021004b000007f60000c13d0000001601000039000000000101041a001200000001001d000006a4010000410000000000100443000000000100041000000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800a02000039187a18750000040f00000001002001900000129e0000613d000000120200002900000008022002700000062604200197000000000301043b0000000001000414000006200010009c0000062001008041000000c001100210000000000003004b0000092a0000c13d00000000020400190000092d0000013d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b001200000001001d000006260010009c000001520000213d0000000901000039000000000101041a00000626011001970000000002000411000000000021004b000007f60000c13d00000635010000410000000000100443000000120100002900000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f00000001002001900000129e0000613d000000120000006b000009850000613d000000000101043b000000000001004b000009850000c13d000006a001000041000000000010043f0000069f010000410000187c00010430000000840030008c000001520000413d0000000402100370000000000202043b001200000002001d000006260020009c000001520000213d0000002402100370000000000202043b001100000002001d000006260020009c000001520000213d0000006402100370000000000402043b000006230040009c000001520000213d0000002302400039000000000032004b000001520000813d0000000402400039000000000221034f000000000202043b0000004401100370000000000101043b001000000001001d0000002401400039187a139d0000040f0000000004010019000007a40000013d0000000001000416000000000001004b000001520000c13d187a13e50000040f000000800010043f00000691010000410000187b0001042e0000000001000416000000000001004b000001520000c13d000006da01000041000000800010043f0000000101000039000000a00010043f000006db010000410000187b0001042e000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000402100370000000000402043b000006230040009c000001520000213d0000002302400039000000000032004b000001520000813d0000000405400039000000000251034f000000000202043b000006230020009c000001520000213d00000024044000390000000006420019000000000036004b000001520000213d0000000903000039000000000303041a00000626033001970000000006000411000000000063004b000007f60000c13d0000001103000039000000000703041a000000010070019000000001067002700000007f0660618f0000001f0060008c00000000080000390000000108002039000000000787013f0000000100700190000006ff0000c13d000000200060008c0000066f0000413d000000000030043f0000001f072000390000000507700270000006ab0770009a000000200020008c0000069d070040410000001f066000390000000506600270000006ab0660009a000000000067004b0000066f0000813d000000000007041b0000000107700039000000000067004b0000066b0000413d0000001f0020008c00000a610000a13d000000000030043f000006ea0620019800000b8f0000c13d0000069d05000041000000000700001900000b990000013d0000000001000416000000000001004b000001520000c13d0000000901000039000000000101041a0000062601100197000000800010043f00000691010000410000187b0001042e0000000001000416000000000001004b000001520000c13d0000000d01000039000007ae0000013d0000000001000416000000000001004b000001520000c13d0000000a01000039000000000101041a000006a100100198000007b00000013d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b000000ff0010008c000001520000213d0000000902000039000000000202041a00000626022001970000000003000411000000000032004b000007f60000c13d000000020010008c000007bd0000213d0000001402000039000000000302041a000006eb033001970000082a0000013d0000000001000416000000000001004b000001520000c13d0000001001000039000000000101041a000000800010043f00000691010000410000187b0001042e0000000001000416000000000001004b000001520000c13d0000000203000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000006ff0000c13d000000800010043f000000000004004b000008570000613d000000000030043f000000000001004b00000000020000190000085c0000613d0000062c030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000006c00000413d0000085c0000013d000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b001100000001001d000000000001004b00000a050000613d000000000100041a000000110010006c00000a050000a13d0000001101000029001200000001001d000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000000101041a000000000001004b000009fa0000c13d0000001201000029000000000001004b000000010110008a000006d60000c13d000006d001000041000000000010043f0000001101000039000000040010043f000006d1010000410000187c000104300000000001000416000000000001004b000001520000c13d0000001103000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000008460000613d000006d001000041000000000010043f0000002201000039000000040010043f000006d1010000410000187c000104300000000001000416000000000001004b000001520000c13d0000000901000039000000000101041a00000626021001970000000001000411000000000012004b000007f60000c13d0000000d02000039000000000302041a000000ff00300190000009070000c13d000006eb0330019700000001033001bf000000000032041b000000800010043f0000000001000414000006200010009c0000062001008041000000c001100210000006a8011001c70000800d0200003900000001030000390000063e04000041000008780000013d000000a40030008c0000008005000039000001520000413d0000000402100370000000000202043b001100000002001d000000ff0020008c000001520000213d0000008402100370000000000202043b000006230020009c000001520000213d0000002304200039000000000034004b000001520000813d000f00040020003d0000000f04100360000000000404043b001000000004001d000006230040009c000001520000213d0000001002200029000e00240020003d0000000e0030006b000001520000213d0000002402100370000000000202043b000006260020009c000001520000213d0000004403100370000000000303043b000000ff0030008c000001520000213d0000006401100370000000000101043b000000ff0010008c000001520000213d000006c104000041000000a00040043f000000c00020043f000000e00030043f000001000010043f000000800050043f0000012001000039000000400010043f0000000001000414000006200010009c0000062001008041000000c001100210000006c2011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000d00000001001d000006ac01000041000000000010044300000000010004120000000400100443000000400100003900000024001004430000000001000414000006200010009c0000062001008041000000c001100210000006ad011001c70000800502000039187a18750000040f00000001002001900000129e0000613d000000000101043b00000626011001970000000002000410000000000012004b00000c650000c13d000006ac01000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000006200010009c0000062001008041000000c001100210000006ad011001c70000800502000039187a18750000040f00000001002001900000129e0000613d000000000101043b000c00000001001d0000063a0100004100000000001004430000000001000414000006200010009c0000062001008041000000c0011002100000063b011001c70000800b02000039187a18750000040f00000001002001900000129e0000613d000000000101043b0000000c0010006c00000c650000c13d000006ac0100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000006200010009c0000062001008041000000c001100210000006ad011001c70000800502000039187a18750000040f000000010020019000000cbd0000c13d0000129e0000013d0000000001030019187a136e0000040f001200000001001d001100000002001d001000000003001d000000400100043d000f00000001001d0000002002000039187a138b0000040f0000000f040000290000000000040435000000120100002900000011020000290000001003000029187a15940000040f00000000010000190000187b0001042e0000000001000416000000000001004b000001520000c13d0000001601000039000000000101041a000000ff001001900000000001000039000000010100c039000000800010043f00000691010000410000187b0001042e0000000001000416000000000001004b000001520000c13d0000001401000039000000000101041a000000ff0110018f000000020010008c000007ca0000a13d000006d001000041000000000010043f0000002101000039000000040010043f000006d1010000410000187c000104300000000001000416000000000001004b000001520000c13d0000001401000039000000000101041a00000008011002700000062601100197000000800010043f00000691010000410000187b0001042e0000000001030019187a136e0000040f187a13f00000040f00000000010000190000187b0001042e000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b000000000001004b0000000002000039000000010200c039000000000021004b000001520000c13d0000000902000039000000000202041a00000626022001970000000003000411000000000032004b000007f60000c13d0000000a02000039000000000302041a000006a203300197000000000001004b0000000004000019000006a30400c041000000000343019f000000000032041b000000800010043f0000000001000414000006200010009c0000062001008041000000c001100210000006a8011001c70000800d020000390000000103000039000006a904000041000008780000013d0000064401000041000000800010043f0000002001000039000000840010043f000000a40010043f000006e001000041000000c40010043f000006b2010000410000187c00010430000000440030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000402100370000000000202043b001200000002001d000006260020009c000001520000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039001100000002001d000000000012004b000001520000c13d0000001601000039000000000101041a000000ff001001900000094a0000c13d000006a701000041000000000010043f0000069f010000410000187c00010430000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b001200000001001d000006260010009c000001520000213d187a18430000040f000000120100002900000008011002100000063f011001970000001402000039000000000302041a000006b503300197000000000113019f000000000012041b00000000010000190000187b0001042e000000240030008c000001520000413d0000000002000416000000000002004b000001520000c13d0000000401100370000000000101043b001200000001001d187a18430000040f00000015010000390000001202000029000000000021041b00000000010000190000187b0001042e0000064401000041000000800010043f0000002001000039000000840010043f0000001701000039000000a40010043f000006b601000041000000c40010043f000006b2010000410000187c00010430000000800010043f000000000004004b000008570000613d000000000030043f000000000001004b00000000020000190000085c0000613d0000069d030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b0000084f0000413d0000085c0000013d000006eb02200197000000a00020043f000000000001004b0000002002000039000000000200603900000020022000390000008001000039187a138b0000040f000000400100043d001200000001001d0000008002000039187a13590000040f00000012020000290000000001210049000006200010009c00000620010080410000006001100210000006200020009c00000620020080410000004002200210000000000121019f0000187b0001042e000006eb03300197000000000032041b000000800010043f0000000001000414000006200010009c0000062001008041000000c001100210000006a8011001c70000800d020000390000000103000039000006d604000041187a18700000040f0000000100200190000001520000613d00000000010000190000187b0001042e0000001001000029000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000000101041a000000000001004b000008a50000c13d000000000100041a000000100010006c000003060000a13d001200100000002d0000001201000029000000010110008a001200000001001d000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000000101041a000000000001004b000008920000613d0000069300100198000003060000c13d001206260010019b0000000002000411000000120020006c00000af70000c13d0000001001000029000000000010043f0000000601000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d00000011020000290000062606200197000000000101043b000000000201041a0000062f02200197000000000262019f000000000021041b0000000001000414000006200010009c0000062001008041000000c00110021000000630011001c70000800d020000390000000403000039000006dd0400004100000012050000290000001007000029187a18700000040f0000000100200190000001520000613d0000087b0000013d000000ff0210018f000000200020008c0000097a0000413d000006ae01000041000000000010043f0000069f010000410000187c00010430000000000010043f0000000501000039000000200010043f00000040020000390000000001000019187a185b0000040f000000000101041a0000062301100197000000800010043f00000691010000410000187b0001042e000000000101043b00000011040000290000004002400039000000400020043f000000000101041a0000002003400039000000a002100270000000000023043500000626011001980000000000140435000008f80000c13d000000400100043d001100000001001d000006280010009c000005ba0000213d00000011040000290000004001400039000000400010043f0000000b01000039000000000101041a0000002003400039000000a0021002700000000000230435000006260110019700000000001404350000001201000029187a15860000040f00000011020000290000000002020433000027100110011a000000400300043d0000002004300039000000000014043500000626012001970000000000130435000006200030009c00000620030080410000004001300210000006d9011001c70000187b0001042e0000064401000041000000800010043f0000002001000039000000840010043f0000001001000039000000a40010043f000006b101000041000000c40010043f000006b2010000410000187c00010430000006e60020009c0000091a0000613d000006e70020009c0000091a0000613d000006e60020009c00000000010000390000000101006039000006e80020009c00000001011061bf000000010110018f000000800010043f00000691010000410000187b0001042e0000062f02200197000000000262019f000000000021041b0000000001000414000006200010009c0000062001008041000000c00110021000000630011001c70000800d0200003900000003030000390000063104000041000008780000013d00000630011001c700008009020000390000000005000019187a18700000040f0000006003100270000006200330019800000a490000613d0000001f0430003900000621044001970000003f04400039000006a504400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000006230040009c000005ba0000213d0000000100600190000005ba0000c13d000000400040043f0000001f0430018f00000000063504360000062205300198000000000356001900000a3c0000613d000000000701034f000000007807043c0000000006860436000000000036004b000009450000c13d00000a3c0000013d0000000001000411000000000010043f0000000701000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b0000001202000029000000000020043f000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000000201041a000006eb022001970000001103000029000000000232019f000000000021041b000000400100043d0000000000310435000006200010009c000006200100804100000040011002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f0000062e011001c70000800d020000390000000303000039000006a604000041000000000500041100000a970000013d000000400300043d001100000003001d000006280030009c000005ba0000213d00000011040000290000004003400039000000400030043f00000020034000390000000000130435000000000024043500000b410000013d0000000a01000039000000000101041a00000626011001980000098e0000c13d0000000901000039000000000101041a000006a10010019800000000010000190000063201006041000000400200043d0000002003200039000000120400002900000000004304350000000000120435000006200020009c000006200200804100000040012002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000633011001c70000800d0200003900000001030000390000063404000041187a18700000040f0000000100200190000001520000613d0000000902000039000000000102041a000006a201100197000006a3011001c7000000000012041b0000000a03000039000000000103041a0000062f0110019700000012011001af000000000013041b000000120000006b0000087b0000613d00000635010000410000000000100443000000120100002900000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000000001004b0000087b0000613d00000635010000410000000000100443000000120100002900000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000000001004b000001520000613d000000400300043d0000002401300039000002d102000039000000000021043500000637010000410000000000130435000000040130003900000000020004100000000000210435000006200030009c001100000003001d0000062001000041000000000103401900000040011002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000638011001c70000001202000029187a18700000040f00000001002001900000087b0000613d0000001101000029000006230010009c000005ba0000213d0000001101000029000000400010043f00000000010000190000187b0001042e0000069300100198000009f60000c13d0000001101000029000006940010009c00000a990000413d00000040020000390000001101000029000006940110012a00000aa20000013d0000069e01000041000000000010043f0000069f010000410000187c00010430000006930010019800000a050000c13d0000001101000029000000000010043f0000000601000039000000200010043f00000040020000390000000001000019187a185b0000040f000000000101041a000002d30000013d000006df01000041000000000010043f0000069f010000410000187c00010430000006eb0110019700000010020000290000000000120435000000120000006b0000002001000039000000000100603900000b330000013d000000120000006b00000a6d0000c13d0000064401000041000000800010043f0000002001000039000000840010043f0000001b01000039000000a40010043f000006c001000041000000c40010043f000006b2010000410000187c0001043000000630011001c7000080090200003900000012040000290000000005000019187a18700000040f0000006003100270000006200330019800000a490000613d0000001f0430003900000621044001970000003f04400039000006a504400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000006230040009c000005ba0000213d0000000100600190000005ba0000c13d000000400040043f0000001f0430018f00000000063504360000062205300198000000000356001900000a3c0000613d000000000701034f000000007807043c0000000006860436000000000036004b00000a380000c13d000000000004004b00000a490000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f000000000013043500000001002001900000087b0000c13d000006d801000041000000000010043f0000069f010000410000187c00010430000000c002000039000000400020043f000000800050043f000000a00010043f000000a002100210000000000252019f0000000b03000039000000000023041b000000c00010043f0000000001000414000006200010009c0000062001008041000000c001100210000006e1011001c70000800d0200003900000002030000390000063904000041000008780000013d000000000002004b000000000400001900000a670000613d0000002004500039000000000141034f000000000401043b0000000301200210000006e90110027f000006e901100167000000000414016f000000010120021000000ba60000013d000000c001000039000000400010043f0000001201000029000000800010043f0000001001000029000000a00010043f0000001101000029000000000010043f0000000c01000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000800200043d0000062602200197000000a00300043d000000a003300210000000000223019f000000000101043b000000000021041b000000400100043d00000010020000290000000000210435000006200010009c000006200100804100000040011002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f0000062e011001c70000800d020000390000000303000039000006bf0400004100000011050000290000001206000029000008780000013d0000001101000029000006960010009c000006950110212a00000000020000390000002002002039000006970010009c00000010022081bf0000069801108197000006970110812a000006990010009c00000008022080390000062301108197000006990110812a000027100010008c00000004022080390000062001108197000027100110811a000000640010008c00000002022080390000ffff0110818f000000640110811a000000090010008c0000000102202039000006ea052001970000005f01500039000006ea06100197000000400300043d0000000001360019000000000061004b00000000060000390000000106004039000006230010009c000005ba0000213d0000000100600190000005ba0000c13d000000400010043f000000010120003900000000011304360000002006500039000006ea056001980000001f0460018f00000acb0000613d0000000005510019000000000600003100000001066003670000000007010019000000006806043c0000000007870436000000000057004b00000ac70000c13d000000000004004b000000000223001900000021022000390000001106000029000000090060008c0000000a4660011a0000000304400210000000010220008a00000000050204330000069a055001970000069b0440021f0000069c04400197000000000454019f000000000042043500000acf0000213d0000001106000039000000000506041a000000010750019000000001025002700000007f0220618f0000001f0020008c00000000040000390000000104002039000000000445013f0000000100400190000006ff0000c13d000000400400043d00000000090400190000002004400039000000000007004b00000c200000613d000000000060043f000000000002004b00000c220000613d0000069d0500004100000000060000190000000007460019000000000805041a000000000087043500000001055000390000002006600039000000000026004b00000aef0000413d00000c220000013d0000001201000029000000000010043f0000000701000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b00000000020004110000062602200197000f00000002001d000000000020043f000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000000101041a000000ff00100190000008ab0000c13d0000000a01000039000000000101041a000006a10010019800000b240000613d000006260110019800000b220000c13d0000000901000039000000000101041a000006a100100198000000000100001900000632010060410000000f0010006b000008ab0000613d000006dc01000041000000000010043f0000069f010000410000187c00010430000000000201043b0000000001000019000000100500002900000012060000290000000003510019000000000402041a000000000043043500000001022000390000002001100039000000000061004b00000b2c0000413d0000001002000029000000110220006a00000000011200190000001f01100039000006ea021001970000001101200029000000000021004b00000000020000390000000102004039000006230010009c000005ba0000213d0000000100200190000005ba0000c13d000000400010043f000006ac01000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000006200010009c0000062001008041000000c001100210000006ad011001c70000800502000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000ff0010008c00000b740000c13d0000000f02000039000000000102041a000000010310019000000001041002700000007f0440618f001200000004001d0000001f0040008c00000000040000390000000104002039000000000441013f0000000100400190000006ff0000c13d000000400400043d001000000004001d00000012050000290000000004540436000f00000004001d000000000003004b00000baa0000613d000000000020043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000120000006b00000c590000c13d000000000100001900000bb00000013d000000ff0210018f0000001f0020008c000008d00000213d000000400300043d001000000003001d000006280030009c000005ba0000213d00000010040000290000004003400039000000400030043f000000200340003900000000001304350000000000240435000000400100043d001200000001001d00000bc00000013d0000068d0500004100000000070000190000000008470019000000000881034f000000000808043b000000000085041b00000001055000390000002007700039000000000067004b00000b860000413d00000b990000013d0000069d0500004100000000070000190000000008470019000000000881034f000000000808043b000000000085041b00000001055000390000002007700039000000000067004b00000b910000413d000000000026004b00000ba40000813d0000000306200210000000f80660018f000006e90660027f000006e9066001670000000004470019000000000141034f000000000101043b000000000161016f000000000015041b00000001010000390000000104200210000000000114019f000000000013041b00000000010000190000187b0001042e000006eb011001970000000f020000290000000000120435000000120000006b000000200100003900000000010060390000000f02000029000000100220006a00000000011200190000001f01100039000006ea011001970000001002100029000000000012004b00000000010000390000000101004039001200000002001d000006230020009c000005ba0000213d0000000100100190000005ba0000c13d0000001201000029000000400010043f0000001201000029000006af0010009c000005ba0000213d00000012010000290000002002100039000e00000002001d000000400020043f0000000000010435000000400400043d0000002001400039000000e0020000390000000000210435000006b0010000410000000000140435000000e001400039000000110200002900000000320204340000000000210435001100000004001d0000010001400039000000000002004b00000bde0000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b00000bd70000413d000000000312001900000000000304350000001f02200039000006ea0220019700000000021200190000001103000029000000000132004900000040033000390000000000130435000000100100002900000000160104340000000005620436000000000006004b00000bf40000613d000000000200001900000000035200190000000004210019000000000404043300000000004304350000002002200039000000000062004b00000bed0000413d001000000005001d000f00000006001d000000000156001900000000000104350000063a0100004100000000001004430000000001000414000006200010009c0000062001008041000000c0011002100000063b011001c70000800b02000039187a18750000040f00000001002001900000129e0000613d000000000101043b0000001104000029000000800240003900000000030004100000000000320435000000600240003900000000001204350000000f010000290000001f01100039000006ea0110019700000010011000290000000002410049000000c0034000390000000000230435000000a0024000390000000000020435000000120200002900000000020204330000000001210436000000000002004b00000c570000613d00000000030000190000000e05000029000000005405043400000000014104360000000103300039000000000023004b00000c1a0000413d00000c570000013d000006eb05500197000000000054043500000000024200190000000003030433000000000003004b00000c2e0000613d000000000400001900000000052400190000000006140019000000000606043300000000006504350000002004400039000000000034004b00000c270000413d000000000123001900000000000104350000001204000039000000000304041a000000010530019000000001023002700000007f0220618f0000001f0020008c00000000060000390000000106002039000000000663013f0000000100600190000006ff0000c13d000000000005004b00000c4a0000613d000000000040043f000000000002004b00000c4c0000613d0000068d0300004100000000040000190000000005140019000000000603041a000000000065043500000001033000390000002004400039000000000024004b00000c420000413d00000c4c0000013d000006eb033001970000000000310435001200000009001d00000000019100490000000002120019000000200120008a00000000001904350000000001090019187a138b0000040f000000400100043d001100000001001d0000001202000029187a13590000040f0000001102000029000008640000013d000000000201043b00000000010000190000000f0500002900000012060000290000000003510019000000000402041a000000000043043500000001022000390000002001100039000000000061004b00000c5d0000413d00000bb00000013d000000400100043d000c00000001001d00000020021000390000063c01000041000b00000002001d0000000000120435000006ac01000041000000000010044300000000010004120000000400100443000000600100003900000024001004430000000001000414000006200010009c0000062001008041000000c001100210000006ad011001c70000800502000039187a18750000040f00000001002001900000129e0000613d000000000101043b0000000c0200002900000040022000390000000000120435000006ac01000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000006200010009c0000062001008041000000c001100210000006ad011001c70000800502000039187a18750000040f00000001002001900000129e0000613d000000000101043b0000000c02000029000000600220003900000000001204350000063a0100004100000000001004430000000001000414000006200010009c0000062001008041000000c0011002100000063b011001c70000800b02000039187a18750000040f00000001002001900000129e0000613d000000000101043b0000000c04000029000000a0024000390000000003000410000000000032043500000080024000390000000000120435000000a00100003900000000001404350000063d0040009c000005ba0000213d0000000c02000029000000c001200039000000400010043f0000000b01000029000006200010009c000006200100804100000040011002100000000002020433000006200020009c00000620020080410000006002200210000000000112019f0000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000630011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000400200043d00000022032000390000000d040000290000000000430435000006c303000041000000000032043500000002032000390000000000130435000006200020009c000006200200804100000040012002100000000002000414000006200020009c0000062002008041000000c002200210000000000121019f000006c4011001c70000801002000039187a18750000040f0000000100200190000001520000613d00000010020000290000001f02200039000006ea022001970000003f02200039000006ea03200197000000000101043b000000400200043d0000000003320019000000000023004b00000000040000390000000104004039000006230030009c000005ba0000213d0000000100400190000005ba0000c13d000000400030043f000000100300002900000000043204360000000e03000029000000000030007c000001520000213d0000001006000029000006ea056001980000001f0660018f00000000035400190000000f070000290000002007700039000000010770036700000cf60000613d000000000807034f0000000009040019000000008a08043c0000000009a90436000000000039004b00000cf20000c13d000000000006004b00000d030000613d000000000557034f0000000306600210000000000703043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f000000000053043500000010034000290000000000030435000000400300043d0000000005020433000000410050008c00000d200000c13d00000040052000390000000005050433000006c60050009c00000d260000a13d0000006401300039000006d40200004100000000002104350000004401300039000006d502000041000000000021043500000024013000390000002202000039000000000021043500000644010000410000000000130435000000040130003900000020020000390000000000210435000006200030009c0000062003008041000000400130021000000648011001c70000187c000104300000004401300039000006c502000041000000000021043500000024013000390000001f0200003900000f7c0000013d0000006002200039000000000202043300000000040404330000006006300039000000000056043500000040053000390000000000450435000000f802200270000000200430003900000000002404350000000000130435000000000000043f000006200030009c000006200300804100000040013002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f000006c7011001c70000000102000039187a18750000040f00000060031002700000062003300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000000d4b0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00000d470000c13d000000000005004b00000d580000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000000010020019000000d640000613d000000000100043d000006260210019800000d820000c13d000000400100043d0000004402100039000006d303000041000000000032043500000024021000390000001803000039000013220000013d0000001f0530018f0000062206300198000000400200043d000000000462001900000d6f0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00000d6b0000c13d000000000005004b00000d7c0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000006200020009c00000620020080410000004002200210000000000112019f0000187c000104300000001401000039000000000101041a00000008031002700000062603300197000000000032004b00000dfd0000c13d0000000d02000039000000000202041a000000ff002001900000131c0000c13d0000001302000039000000000202041a000000020020008c00000e010000c13d000000400100043d0000004402100039000006d203000041000000000032043500000024021000390000001f03000039000013220000013d000000000004004b000000000100001900000db60000613d000006e90160027f000006e9011001670000000002020433000000000112016f000000000151019f00000db60000013d0000062c020000410000002007000039000000010980008a00000005099002700000062d0990009a000000000a170019000000000a0a04330000000000a2041b00000020077000390000000102200039000000000092004b00000da50000c13d000000000048004b00000db50000813d000000f80460018f000006e90440027f000006e90440016700000000011700190000000001010433000000000141016f000000000012041b00000001015001bf000000000013041b00000010010000290000000001010433000600000001001d000006230010009c000005ba0000213d0000000301000039000000000101041a000000010010019000000001021002700000007f0220618f000200000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006ff0000c13d0000000201000029000000200010008c00000de70000413d0000000301000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d00000006030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000002010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b00000de70000813d000000000002041b0000000102200039000000000012004b00000de30000413d0000000601000029000000200010008c0002000100100218000100030010021800000e460000413d0000000301000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000200200008a0000000602200180000000000101043b00000e510000c13d000000200300003900000e5d0000013d000006c801000041000000000010043f0000069f010000410000187c0001043000000002020000390000001303000039000000000023041b00000001020003670000004403200370000000000303043b000000ff0030008c000001520000213d000000030030008c000007bd0000813d000000ff0110018f000000020010008c000007bd0000213d000000000013004b00000ee80000c13d0000002401200370000000000101043b000006260010009c000001520000213d0000000002000411000000000021004b00000eec0000c13d0000000001000411000000000010043f0000001701000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d00000044020000390000000102200367000000000202043b000000ff0020008c000001520000213d000000000101043b000000000020043f000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000000101041a000000ff0110018f0000001101100029000000ff0010008c000006eb0000213d00000001020003670000006403200370000000000303043b000000ff0030008c000001520000213d000000000031004b00000ef00000a13d000006cf01000041000000000010043f0000069f010000410000187c00010430000000060000006b000000000100001900000e690000613d000000010200008a0000000101200250000000000121013f0000000f020000290000000002020433000000000112016f00000002011001af00000e690000013d000000010320008a000000050330027000000000043100190000002003000039000000010440003900000010053000290000000005050433000000000051041b00000020033000390000000101100039000000000041004b00000e560000c13d000000060020006c00000e670000813d0000000102000029000000f80220018f000006e90220027f000006e90220016700000010033000290000000003030433000000000223016f000000000021041b000000020100002900000001011001bf0000000303000039000000000013041b0000000101000039000000000010041b000000000100041100000626061001970000000901000039000000000201041a0000062f04200197000000000464019f000000000041041b00000000010004140000062605200197000006200010009c0000062001008041000000c00110021000000630011001c70000800d020000390000063104000041187a18700000040f0000000100200190000001520000613d000000400100043d0000002002100039000006320300004100000000003204350000000000010435000006200010009c000006200100804100000040011002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000633011001c70000800d0200003900000001030000390000063404000041187a18700000040f0000000100200190000001520000613d00000635010000410000000000100443000006320100004100000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000000001004b00000ed00000613d00000635010000410000000000100443000006320100004100000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000000001004b000001520000613d000000400300043d0000002401300039000002d102000039000000000021043500000637010000410000000000130435000000040130003900000000020004100000000000210435000006200030009c001000000003001d0000062001000041000000000103401900000040011002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000638011001c70000063202000041187a18700000040f000000010020019000000ed00000613d0000001001000029000006230010009c000005ba0000213d0000001001000029000000400010043f000000400100043d0000000a020000290000062702200197000027110020008c00000f290000413d00000064021000390000064603000041000000000032043500000044021000390000064703000041000000000032043500000024021000390000002a03000039000000000032043500000644020000410000000000210435000000040210003900000020030000390000000000320435000006200010009c0000062001008041000000400110021000000648011001c70000187c00010430000006c901000041000000000010043f0000069f010000410000187c00010430000006ca01000041000000000010043f0000069f010000410000187c000104300000002401200370000000000101043b000006260010009c000001520000213d000000000010043f0000001701000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d00000044020000390000000102200367000000000202043b000000ff0020008c000001520000213d000000000101043b000000000020043f000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000000201041a000000ff0320018f0000001103300029000000ff0030008c000006eb0000213d000006eb02200197000000000223019f000000000021041b0000001501000039000000000201041a00000011012000b9000000110000006b00000f220000613d00000011031000fa000000000023004b000006eb0000c13d0000000002000416000000000312004b00000f320000813d000006ce01000041000000000010043f0000069f010000410000187c000104300000000b03000029000006260530019800000f870000c13d00000044021000390000064303000041000000000032043500000024021000390000001903000039000013220000013d00000f660000613d0000000001000414000006200010009c0000062001008041000000c00110021000000630011001c7000080090200003900000000040004110000000005000019187a18700000040f0000006003100270000006200330019800000f640000613d0000001f0430003900000621044001970000003f04400039000006a504400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000006230040009c000005ba0000213d0000000100600190000005ba0000c13d000000400040043f0000001f0430018f00000000063504360000062205300198000000000356001900000f570000613d000000000701034f000000007807043c0000000006860436000000000036004b00000f530000c13d000000000004004b00000f640000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000000010020019000000a4b0000613d0000000101000039000000000201041a000000010100008a000000000212013f000000000300041a001000000003001d0000000002230019000000110020002a000006eb0000413d0000001102200029000000400300043d000f00000003001d0000001003000039000000000303041a000000000032004b00000fea0000a13d0000000f030000290000004401300039000006be02000041000000000021043500000024013000390000000e02000039000000000021043500000644010000410000000000130435000000040130003900000020020000390000000000210435000006200030009c0000062003008041000000400130021000000645011001c70000187c00010430000006280010009c000005ba0000213d0000004003100039000000400030043f000000200310003900000000002304350000000000510435000000a001200210000000000151019f0000000b03000039000000000013041b000000400100043d0000000000210435000006200010009c000006200100804100000040011002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f0000062e011001c70000800d0200003900000002030000390000063904000041187a18700000040f0000000100200190000001520000613d0000000d02000039000000000102041a000006eb01100197000000000012041b00000008010000290000000001010433000000200010008c001000000001001d000f00030010021800000ff80000413d0000001001000029000006230010009c000005ba0000213d0000000e01000039000000000101041a000000010010019000000001021002700000007f0220618f000b00000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006ff0000c13d0000000b01000029000000200010008c00000fd90000413d0000000e01000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000201043b0000000b010000290000001f011000390000000501100270000000000112001900000010030000290000001f0330003900000005033002700000000002320019000000000012004b00000fd90000813d000000000002041b0000000102200039000000000012004b00000fd50000413d0000000e01000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000200200008a0000001002200180000000000101043b000010020000c13d00000020030000390000100e0000013d0000000f02000029000006af0020009c000005ba0000213d0000000f020000290000002003200039000c00000003001d000000400030043f0000000000020435000000110000006b000010620000c13d000006cd01000041000000000010043f0000069f010000410000187c000104300000000f010000290000010001100089000006e90110021f000000100000006b000000000100601900000003020000290000000002020433000000000112016f00000010011001af0000101e0000013d000000010320008a000000050330027000000000043100190000002003000039000000010440003900000008053000290000000005050433000000000051041b00000020033000390000000101100039000000000041004b000010070000c13d000000100020006c000010180000813d0000000f02000029000000f80220018f000006e90220027f000006e90220016700000008033000290000000003030433000000000223016f000000000021041b0000001001000029000000010110021000000001011001bf0000000e02000039000000000012041b000000ff01000039000001200010043f00000007010000290000000001010433000000200010008c001000000001001d000f000300100218000010690000413d0000001001000029000006230010009c000005ba0000213d0000000f01000039000000000101041a000000010010019000000001021002700000007f0220618f000b00000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006ff0000c13d0000000b01000029000000200010008c000010510000413d0000000f01000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000201043b0000000b010000290000001f011000390000000501100270000000000112001900000010030000290000001f0330003900000005033002700000000002320019000000000012004b000010510000813d000000000002041b0000000102200039000000000012004b0000104d0000413d0000000f01000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000200200008a0000001002200180000000000101043b000010730000c13d00000020030000390000107f0000013d0000000002000411000000000002004b0000114c0000c13d000006cc01000041000000000010043f0000069f010000410000187c000104300000000f010000290000010001100089000006e90110021f000000100000006b000000000100601900000004020000290000000002020433000000000112016f00000010011001af0000108f0000013d000000010320008a000000050330027000000000043100190000002003000039000000010440003900000007053000290000000005050433000000000051041b00000020033000390000000101100039000000000041004b000010780000c13d000000100020006c000010890000813d0000000f02000029000000f80220018f000006e90220027f000006e90220016700000007033000290000000003030433000000000223016f000000000021041b000000ff010000390000001002000029000000010220021000000001022001bf0000000f03000039000000000023041b000001400010043f0000000301000029000006200010009c0000062001008041000000400110021000000008020000290000000002020433000006200020009c00000620020080410000006002200210000000000112019f0000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000630011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000e00010043f0000000401000029000006200010009c0000062001008041000000400110021000000007020000290000000002020433000006200020009c00000620020080410000006002200210000000000112019f0000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000630011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000001000010043f0000063a0100004100000000001004430000000001000414000006200010009c0000062001008041000000c0011002100000063b011001c70000800b02000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000a00010043f000000400400043d0000006001400039000000e00200043d000001000300043d000000000031043500000040014000390000000000210435001000000004001d00000020024000390000063c01000041000f00000002001d00000000001204350000063a0100004100000000001004430000000001000414000006200010009c0000062001008041000000c0011002100000063b011001c70000800b02000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000100300002900000080023000390000000000120435000000a00130003900000000020004100000000000210435000000a00100003900000000001304350000063d0030009c000005ba0000213d0000001002000029000000c001200039000000400010043f0000000f01000029000006200010009c000006200100804100000040011002100000000002020433000006200020009c00000620020080410000006002200210000000000112019f0000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000630011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b000000800010043f0000000001000410000000c00010043f00000010010000390000000d02000029000000000021041b0000000e010000290000000001010433001000000001001d000006230010009c000005ba0000213d0000001101000039000000000101041a000000010010019000000001021002700000007f0220618f000f00000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006ff0000c13d0000000f01000029000000200010008c000011380000413d0000001101000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d00000010030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b0000000f010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b000011380000813d000000000002041b0000000102200039000000000012004b000011340000413d0000001001000029000000200010008c000011a30000413d0000001101000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000200200008a0000001002200180000000000101043b000011b00000c13d0000002003000039000011bc0000013d000e00100010015300000000010000190000000e0010006c000006eb0000213d0000000101100039000000110010006c0000114e0000413d000006b70100004100000000001004430000000001000414000006200010009c0000062001008041000000c0011002100000063b011001c70000800b02000039187a18750000040f00000001002001900000129e0000613d000000000101043b000d00000001001d0000001001000029000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d0000000d02000029000000a0022002100000001103000029000000010030008c0000000003000019000006b803006041000000000223019f0000000003000411000000000232019f000000000101043b000000000021041b000000000030043f0000000501000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000000101043b0000001104000029000006b9024000d1000000000301041a0000000002230019000000000021041b000d00100040002d00000000010000190000000100100190000011930000613d00000010010000290000000101100039001000000001001d0000000d0010006c000012100000613d0000000001000414000006200010009c0000062001008041000000c00110021000000630011001c70000800d020000390000000403000039000006ba04000041000000000500001900000000060004110000001007000029187a18700000040f000000010020019000000001010000390000118c0000c13d000001520000013d000000100000006b0000000001000019000011ca0000613d00000010030000290000000301300210000006e90110027f000006e90110016700000012020000290000000002020433000000000112016f0000000102300210000000000121019f000011ca0000013d000000010320008a00000005033002700000000004310019000000200300003900000001044000390000000e053000290000000005050433000000000051041b00000020033000390000000101100039000000000041004b000011b50000c13d000000100020006c000011c70000813d00000010020000290000000302200210000000f80220018f000006e90220027f000006e9022001670000000e033000290000000003030433000000000223016f000000000021041b0000001001000029000000010110021000000001011001bf0000001102000039000000000012041b0000000c010000290000000001010433001200000001001d000006230010009c000005ba0000213d0000001201000039000000000101041a000000010010019000000001021002700000007f0220618f001000000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006ff0000c13d0000001001000029000000200010008c000011fc0000413d0000001201000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d00000012030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000010010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b000011fc0000813d000000000002041b0000000102200039000000000012004b000011f80000413d0000001201000029000000200010008c0000129f0000413d0000001201000039000000000010043f0000000001000414000006200010009c0000062001008041000000c0011002100000062e011001c70000801002000039187a18750000040f0000000100200190000001520000613d000000200200008a0000001202200180000000000101043b000012ac0000c13d0000002003000039000012b80000013d0000000d01000029000000000010041b00000000010000190000000e0010006c000006eb0000213d0000000101100039000000110010006c000012130000413d00000635010000410000000000100443000000000100041100000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f00000001002001900000129e0000613d000000000101043b000000000001004b000012990000613d000000400100043d001000000001001d000000000200041a000e00000002001d00110011002000720000001003000029000000640130003900000080020000390000000000210435000006bb010000410000000000130435000000040130003900000000020004110000000000210435000000440130003900000011020000290000000000210435000000240130003900000000000104350000000f01000029000000000101043300000084023000390000000000120435000000a402300039000000000001004b0000124a0000613d000000000300001900000000042300190000000c05300029000000000505043300000000005404350000002003300039000000000013004b000012430000413d0000001f03100039000006ea0330019700000000012100190000000000010435000000a401300039000006200010009c000006200100804100000060011002100000001002000029001000000002001d000006200020009c00000620020080410000004002200210000000000121019f0000000002000414000006200020009c0000062002008041000000c002200210000000000112019f0000000002000411187a18700000040f00000060031002700000062003300197000000200030008c00000020040000390000000004034019000000200640019000000010056000290000126d0000613d000000000701034f0000001008000029000000007907043c0000000008980436000000000058004b000012690000c13d0000001f074001900000127a0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000013180000613d0000001f01400039000000600210018f0000001001200029000000000021004b00000000020000390000000102004039000006230010009c000005ba0000213d0000000100200190000005ba0000c13d000000400010043f000000200030008c000001520000413d00000010020000290000000002020433000006bc00200198000001520000c13d000006bd02200197000006bb0020009c0000015a0000c13d00000011030000290000000103300039001100000003001d0000000e0030006c001000000001001d0000122d0000413d000000000100041a0000000e0010006c000001520000c13d00000001010000390000001302000039000000000012041b00000000010000190000187b0001042e000000000001042f000000120000006b0000000001000019000012c60000613d00000012030000290000000301300210000006e90110027f000006e90110016700000011020000290000000002020433000000000112016f0000000102300210000000000121019f000012c60000013d000000010320008a00000005033002700000000004310019000000200300003900000001044000390000000c053000290000000005050433000000000051041b00000020033000390000000101100039000000000041004b000012b10000c13d000000120020006c000012c30000813d00000012020000290000000302200210000000f80220018f000006e90220027f000006e9022001670000000c033000290000000003030433000000000223016f000000000021041b0000001201000029000000010110021000000001011001bf0000001202000039000000000012041b00000013010000390000000102000039000000000021041b0000000d01000039000000000101041a000000ff001001900000131c0000c13d000006eb0110019700000001011001bf0000000d02000039000000000012041b000000400100043d00000000020004110000000000210435000006200010009c000006200100804100000040011002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f0000062e011001c70000800d0200003900000001030000390000063e04000041187a18700000040f0000000100200190000001520000613d000000090100002900000008011002100000063f011001970000001402000039000000000302041a0000064003300197000000000113019f0000001603000039000000000403041a000000000012041b00000641010000410000001502000039000000000012041b000000050100002900000008011002100000063f011001970000064002400197000000000112019f000000000013041b000000800100043d00000140000004430000016000100443000000a00100043d00000020030000390000018000300443000001a0001004430000004001000039000000c00200043d000001c000100443000001e0002004430000006001000039000000e00200043d000002000010044300000220002004430000008001000039000001000200043d00000240001004430000026000200443000001200100043d000000a0020000390000028000200443000002a000100443000000c001000039000001400200043d000002c000100443000002e00020044300000100003004430000000701000039000001200010044300000642010000410000187b0001042e000000000003004b0000132d0000c13d0000006002000039000013540000013d000000400100043d0000004402100039000006b103000041000000000032043500000024021000390000001003000039000000000032043500000644020000410000000000210435000000040210003900000020030000390000000000320435000006200010009c0000062001008041000000400110021000000645011001c70000187c000104300000001f0230003900000621022001970000003f02200039000006a504200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000006230040009c000005ba0000213d0000000100500190000005ba0000c13d000000400040043f0000001f0430018f00000000063204360000062205300198001200000006001d0000000003560019000013470000613d000000000601034f0000001207000029000000006806043c0000000007870436000000000037004b000013430000c13d000000000004004b000013540000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b0000015a0000613d0000001202000029000001870000013d00000020030000390000000004310436000000003202043400000000002404350000004001100039000000000002004b000013680000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b000013610000413d000000000312001900000000000304350000001f02200039000006ea022001970000000001120019000000000001042d000006ec0010009c0000137e0000213d000000630010008c0000137e0000a13d00000001030003670000000401300370000000000101043b000006260010009c0000137e0000213d0000002402300370000000000202043b000006260020009c0000137e0000213d0000004403300370000000000303043b000000000001042d00000000010000190000187c0001043000000004010000390000000101100367000000000101043b000000000001004b0000000002000039000000010200c039000000000021004b000013890000c13d000000000001042d00000000010000190000187c000104300000001f02200039000006ea022001970000000001120019000000000021004b00000000020000390000000102004039000006230010009c000013970000213d0000000100200190000013970000c13d000000400010043f000000000001042d000006d001000041000000000010043f0000004101000039000000040010043f000006d1010000410000187c00010430000006250020009c000013cd0000813d00000000040100190000001f01200039000006ea011001970000003f01100039000006ea05100197000000400100043d0000000005510019000000000015004b00000000070000390000000107004039000006230050009c000013cd0000213d0000000100700190000013cd0000c13d000000400050043f00000000052104360000000007420019000000000037004b000013d30000213d000006ea062001980000001f0720018f00000001044003670000000003650019000013bd0000613d000000000804034f0000000009050019000000008a08043c0000000009a90436000000000039004b000013b90000c13d000000000007004b000013ca0000613d000000000464034f0000000306700210000000000703043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000043043500000000022500190000000000020435000000000001042d000006d001000041000000000010043f0000004101000039000000040010043f000006d1010000410000187c0001043000000000010000190000187c00010430000000ff0220018f000000000020043f000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000013e30000613d000000000101043b000000000001042d00000000010000190000187c000104300000000a01000039000000000101041a0000062601100198000013ea0000613d000000000001042d0000000901000039000000000101041a000006a10010019800000000010000190000063201006041000000000001042d0008000000000002000400000002001d000600000001001d000700000003001d000000000003004b000015470000613d0000000701000029000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000015450000613d000000000101043b000000000101041a000000000001004b0000141e0000c13d000000000100041a000000070010006c000015470000a13d0000000702000029000000010220008a000800000002001d000000000020043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000015450000613d000000000101043b000000000101041a000000000001004b00000008020000290000140b0000613d0000069300100198000015470000c13d00000006020000290000062602200197000500000001001d0000062601100197000600000002001d000000000021004b0000154c0000c13d0000000701000029000000000010043f0000000601000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000015450000613d000000000301043b000000000403041a000000000600041100000626056001970000000602000029000000000025004b0000146f0000613d000000000045004b0000146f0000613d000100000004001d000200000003001d000000000020043f0000000701000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039000300000005001d187a18750000040f00000003030000290000000100200190000015450000613d000000000101043b000000000030043f000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000003050000290000000100200190000015450000613d000000000101043b000000000101041a000000ff0010019000000006020000290000000203000029000000010400002900000000060004110000146f0000c13d0000000a01000039000000000101041a000006a100100198000015580000613d00000626011001980000146d0000c13d0000000901000039000000000101041a000006a10010019800000000010000190000063201006041000000000015004b000015580000c13d000000000002004b000014750000613d0000001601000039000000000101041a000000ff00100190000015500000613d00000004010000290000062601100197000000000002004b000800000001001d000014bb0000613d000000000001004b000014bd0000613d0000000a01000039000000000101041a00000626071001980000153d0000613d000000000076004b000014bd0000613d000300000005001d000100000004001d000200000003001d00000635010000410000000000100443000400000007001d00000004007004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f00000001002001900000154b0000613d000000000101043b000000000001004b0000000303000029000015450000613d000000400400043d000000640140003900000007020000290000000000210435000000440140003900000008020000290000000000210435000000240140003900000006020000290000000000210435000006da01000041000000000014043500000004014000390000000000310435000006200040009c000300000004001d0000062001000041000000000104401900000040011002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000648011001c70000000402000029187a18750000040f0000000100200190000015600000613d0000000301000029000006250010009c00000002030000290000000104000029000015800000813d000000400010043f0000000602000029000014bd0000013d000000000001004b0000155c0000613d000000000004004b000014c00000613d000000000003041b000000000020043f0000000501000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000015450000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000801000029000000000010043f0000000501000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000015450000613d000000000101043b000000000201041a0000000102200039000000000021041b000006b70100004100000000001004430000000001000414000006200010009c0000062001008041000000c0011002100000063b011001c70000800b02000039187a18750000040f00000001002001900000154b0000613d000000000101043b000400000001001d0000000701000029000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000015450000613d0000000402000029000000a0022002100000000806000029000000000262019f000006b8022001c7000000000101043b000000000021041b0000000501000029000006b8001001980000152d0000c13d00000007010000290000000101100039000400000001001d000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000015450000613d000000000101043b000000000101041a000000000001004b00000008060000290000152d0000c13d000000000100041a000000040010006b0000152d0000613d0000000401000029000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f0000000100200190000015450000613d000000000101043b0000000502000029000000000021041b00000008060000290000000001000414000006200010009c0000062001008041000000c00110021000000630011001c70000800d020000390000000403000039000006ba0400004100000006050000290000000707000029187a18700000040f0000000100200190000015450000613d000000080000006b000015540000613d000000000001042d0000000901000039000000000101041a000006a100100198000014bd0000c13d0000063207000041000000000076004b000014820000c13d000014bd0000013d00000000010000190000187c00010430000006de01000041000000000010043f0000069f010000410000187c00010430000000000001042f000006ed01000041000000000010043f0000069f010000410000187c00010430000006a701000041000000000010043f0000069f010000410000187c00010430000006ef01000041000000000010043f0000069f010000410000187c00010430000006ee01000041000000000010043f0000069f010000410000187c00010430000006cc01000041000000000010043f0000069f010000410000187c0001043000000060061002700000001f0460018f0000062205600198000000400200043d00000000035200190000156c0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000015680000c13d0000062006600197000000000004004b0000157a0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000006001600210000006200020009c00000620020080410000004002200210000000000112019f0000187c00010430000006d001000041000000000010043f0000004101000039000000040010043f000006d1010000410000187c00010430000000000301001900000000011200a9000000000003004b0000158d0000613d00000000033100d9000000000023004b0000158e0000c13d000000000001042d000006d001000041000000000010043f0000001101000039000000040010043f000006d1010000410000187c00010430000b000000000002000400000004001d000700000002001d000900000001001d000a00000003001d000000000003004b0000175f0000613d0000000a01000029000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d000000000101043b000000000101041a000000000001004b000015c30000c13d000000000100041a0000000a0010006c0000175f0000a13d0000000a02000029000000010220008a000b00000002001d000000000020043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d000000000101043b000000000101041a000000000001004b0000000b02000029000015b00000613d00000693001001980000175f0000c13d00000009020000290000062602200197000600000001001d0000062601100197000900000002001d000000000021004b000017640000c13d0000000a01000029000000000010043f0000000601000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d000000000401043b000000000504041a0000000006000411000806260060019b0000000902000029000000080020006b000016120000613d000000080050006b000016120000613d000300000005001d000500000004001d000000000020043f0000000701000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d000000000101043b0000000802000029000000000020043f000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d000000000101043b000000000101041a000000ff001001900000000902000029000000050400002900000003050000290000000006000411000016120000c13d0000000a01000039000000000101041a000006a100100198000017740000613d0000062601100198000016100000c13d0000000901000039000000000101041a000006a10010019800000000010000190000063201006041000000080010006b000017740000c13d000000000002004b000016180000613d0000001601000039000000000101041a000000ff00100190000017680000613d00000007010000290000062601100197000000000002004b000b00000001001d0000165d0000613d000000000001004b0000165f0000613d0000000a01000039000000000101041a0000062603100198000017550000613d000000000036004b0000165f0000613d000300000005001d000500000004001d00000635010000410000000000100443000200000003001d00000004003004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f0000000100200190000017630000613d000000000101043b000000000001004b0000175d0000613d000000400300043d00000064013000390000000a02000029000000000021043500000044013000390000000b020000290000000000210435000000240130003900000009020000290000000000210435000006da010000410000000000130435000000040130003900000008020000290000000000210435000006200030009c000100000003001d0000062001000041000000000103401900000040011002100000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000648011001c70000000202000029187a18750000040f0000000100200190000017b90000613d0000000101000029000006250010009c00000005040000290000000305000029000017aa0000813d000000400010043f00000009020000290000165f0000013d000000000001004b000017780000613d000000000005004b000016620000613d000000000004041b000000000020043f0000000501000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000b01000029000000000010043f0000000501000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d000000000101043b000000000201041a0000000102200039000000000021041b000006b70100004100000000001004430000000001000414000006200010009c0000062001008041000000c0011002100000063b011001c70000800b02000039187a18750000040f0000000100200190000017630000613d000000000101043b000500000001001d0000000a01000029000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d0000000502000029000000a0022002100000000b06000029000000000262019f000006b8022001c7000000000101043b000000000021041b0000000601000029000006b800100198000016cf0000c13d0000000a010000290000000101100039000500000001001d000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d000000000101043b000000000101041a000000000001004b0000000b06000029000016cf0000c13d000000000100041a000000050010006b000016cf0000613d0000000501000029000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000175d0000613d000000000101043b0000000602000029000000000021041b0000000b060000290000000001000414000006200010009c0000062001008041000000c00110021000000630011001c70000800d020000390000000403000039000006ba0400004100000009050000290000000a07000029187a18700000040f00000001002001900000175d0000613d0000000b0000006b0000176c0000613d00000635010000410000000000100443000000070100002900000004001004430000000001000414000006200010009c0000062001008041000000c00110021000000636011001c70000800202000039187a18750000040f0000000100200190000017630000613d000000000101043b000000000001004b000017540000613d000000400700043d00000064017000390000008002000039000700000002001d000000000021043500000044017000390000000a020000290000000000210435000000240170003900000009020000290000000000210435000006bb0100004100000000001704350000000401700039000000080200002900000000002104350000008402700039000000040100002900000000310104340000000000120435000000a402700039000000000001004b0000170d0000613d000000000400001900000000052400190000000006430019000000000606043300000000006504350000002004400039000000000014004b000017060000413d0000001f03100039000006ea0330019700000000012100190000000000010435000000a401300039000006200010009c00000620010080410000006001100210000006200070009c000006200200004100000000020740190000004002200210000000000121019f0000000002000414000006200020009c0000062002008041000000c002200210000000000112019f0000000b02000029000b00000007001d187a18700000040f0000000b0b00002900000060031002700000062003300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b0019000017320000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b0000172e0000c13d000000000006004b0000173f0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000017700000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000006230010009c000017aa0000213d0000000100200190000017aa0000c13d000000400010043f000000200030008c0000175d0000413d00000000010b0433000006bc001001980000175d0000c13d000006bd01100197000006bb0010009c000017a60000c13d000000000001042d0000000901000039000000000101041a000006a1001001980000165f0000c13d0000063203000041000000000036004b000016250000c13d0000165f0000013d00000000010000190000187c00010430000006de01000041000000000010043f0000069f010000410000187c00010430000000000001042f000006ed01000041000000000010043f0000069f010000410000187c00010430000006a701000041000000000010043f0000069f010000410000187c00010430000006ef01000041000000000010043f0000069f010000410000187c00010430000000000003004b0000177c0000c13d0000006002000039000017a30000013d000006ee01000041000000000010043f0000069f010000410000187c00010430000006cc01000041000000000010043f0000069f010000410000187c000104300000001f0230003900000621022001970000003f02200039000006a504200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000006230040009c000017aa0000213d0000000100500190000017aa0000c13d000000400040043f0000001f0430018f00000000063204360000062205300198000700000006001d0000000003560019000017960000613d000000000601034f0000000707000029000000006806043c0000000007870436000000000037004b000017920000c13d000000000004004b000017a30000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b000017b00000c13d000006cb01000041000000000010043f0000069f010000410000187c00010430000006d001000041000000000010043f0000004101000039000000040010043f000006d1010000410000187c000104300000000702000029000006200020009c00000620020080410000004002200210000006200010009c00000620010080410000006001100210000000000121019f0000187c0001043000000060061002700000001f0460018f0000062205600198000000400200043d0000000003520019000017c50000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000017c10000c13d0000062006600197000000000004004b000017d30000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000006001600210000006200020009c00000620020080410000004002200210000000000112019f0000187c000104300001000000000002000100000002001d0000062601100197000000000010043f0000000701000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000180d0000613d000000000101043b00000001020000290000062602200197000100000002001d000000000020043f000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000180d0000613d000000000101043b000000000101041a000000ff01100190000017fc0000613d000000000001042d0000000a01000039000000000101041a000006a1001001980000180b0000613d0000062601100198000018070000c13d0000000901000039000000000101041a000006a10010019800000000010000190000063201006041000000010010006b00000000010000390000000101006039000000000001042d0000000001000019000000000001042d00000000010000190000187c000104300001000000000002000000000001004b0000183f0000613d000100000001001d000000000010043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000183d0000613d000000000101043b000000000101041a000000000001004b0000183a0000c13d000000000100041a0000000102000029000000000021004b0000183f0000a13d000000010220008a000100000002001d000000000020043f0000000401000039000000200010043f0000000001000414000006200010009c0000062001008041000000c00110021000000633011001c70000801002000039187a18750000040f00000001002001900000183d0000613d000000000101043b000000000101041a000000000001004b0000000102000029000018270000613d00000693001001980000183f0000c13d000000000001042d00000000010000190000187c00010430000006de01000041000000000010043f0000069f010000410000187c000104300000000901000039000000000101041a00000626011001970000000002000411000000000021004b0000184a0000c13d000000000001042d000000400100043d0000004402100039000006e00300004100000000003204350000064402000041000000000021043500000024021000390000002003000039000000000032043500000004021000390000000000320435000006200010009c0000062001008041000000400110021000000645011001c70000187c00010430000000000001042f000006200010009c00000620010080410000004001100210000006200020009c00000620020080410000006002200210000000000112019f0000000002000414000006200020009c0000062002008041000000c002200210000000000112019f00000630011001c70000801002000039187a18750000040f00000001002001900000186e0000613d000000000101043b000000000001042d00000000010000190000187c0001043000001873002104210000000102000039000000000001042d0000000002000019000000000001042d00001878002104230000000102000039000000000001042d0000000002000019000000000001042d0000187a000004320000187b0001042e0000187c0001043000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000000000000000000000000000ffffffffffffffff80000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000ffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffbf4b4142552d4e4654000000000000000000000000000000000000000000000000302e312e30000000000000000000000000000000000000000000000000000000bfa87805ed57dc1f0d489ce33be4c4577d74ccde357eeeee058a32c55c44a532405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5acebfa87805ed57dc1f0d489ce33be4c4577d74ccde357eeeee058a32c55c44a5310200000000000000000000000000000000000020000000000000000000000000ffffffffffffffffffffffff000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0000000000000000000000000721c002b0059009a671d00ad1700c9748146cd1b0200000000000000000000000000000000000040000000000000000000000000cc5dc080ff977b3c3a211fa63ab74f90f658f5ba9d3236e92c8f59570f442aac1806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000fb2de5d70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000440000000000000000000000008a8bae378cb731c5c40b632330c6836c2f916f48edb967699c86736f9a6a76ef9a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b02000002000000000000000000000000000000040000000000000000000000008b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f000000000000000000000000000000000000000000000000ffffffffffffff3f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2580000000000000000000000ffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000038d7ea4c680000000000200000000000000000000000000000200000001000000000000000000455243323938313a20696e76616c69642072656365697665720000000000000008c379a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000640000000000000000000000002073616c65507269636500000000000000000000000000000000000000000000455243323938313a20726f79616c7479206665652077696c6c2065786365656400000000000000000000000000000000000000840000000000000000000000000000000000000000000000000000000000000000000000000000000069f7d2f20000000000000000000000000000000000000000000000000000000070a0823000000000000000000000000000000000000000000000000000000000a9fc664d00000000000000000000000000000000000000000000000000000000ce3cd99600000000000000000000000000000000000000000000000000000000ed4a6b0b00000000000000000000000000000000000000000000000000000000f4a0a52700000000000000000000000000000000000000000000000000000000f4a0a52800000000000000000000000000000000000000000000000000000000f7073c3a00000000000000000000000000000000000000000000000000000000ed4a6b0c00000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000ce3cd99700000000000000000000000000000000000000000000000000000000d5abeb0100000000000000000000000000000000000000000000000000000000e985e9c500000000000000000000000000000000000000000000000000000000bef97c8600000000000000000000000000000000000000000000000000000000bef97c8700000000000000000000000000000000000000000000000000000000c040e6b800000000000000000000000000000000000000000000000000000000c87b56dd00000000000000000000000000000000000000000000000000000000a9fc664e00000000000000000000000000000000000000000000000000000000b88d4fde00000000000000000000000000000000000000000000000000000000be6ebd180000000000000000000000000000000000000000000000000000000085cb593a000000000000000000000000000000000000000000000000000000009e05d23f000000000000000000000000000000000000000000000000000000009e05d24000000000000000000000000000000000000000000000000000000000a22cb46500000000000000000000000000000000000000000000000000000000a28835b60000000000000000000000000000000000000000000000000000000085cb593b000000000000000000000000000000000000000000000000000000008da5cb5b0000000000000000000000000000000000000000000000000000000095d89b410000000000000000000000000000000000000000000000000000000075dadb310000000000000000000000000000000000000000000000000000000075dadb32000000000000000000000000000000000000000000000000000000008456cb590000000000000000000000000000000000000000000000000000000084b0196e0000000000000000000000000000000000000000000000000000000070a0823100000000000000000000000000000000000000000000000000000000715018a60000000000000000000000000000000000000000000000000000000075d5ae9f000000000000000000000000000000000000000000000000000000002a552059000000000000000000000000000000000000000000000000000000005c975aba000000000000000000000000000000000000000000000000000000006817c76b000000000000000000000000000000000000000000000000000000006c19e782000000000000000000000000000000000000000000000000000000006c19e783000000000000000000000000000000000000000000000000000000006f8b44b0000000000000000000000000000000000000000000000000000000006817c76c000000000000000000000000000000000000000000000000000000006b29b79f000000000000000000000000000000000000000000000000000000005c975abb000000000000000000000000000000000000000000000000000000006221d13c000000000000000000000000000000000000000000000000000000006352211e0000000000000000000000000000000000000000000000000000000040b122d70000000000000000000000000000000000000000000000000000000040b122d80000000000000000000000000000000000000000000000000000000042842e0e000000000000000000000000000000000000000000000000000000005944c753000000000000000000000000000000000000000000000000000000002a55205a000000000000000000000000000000000000000000000000000000003ccfd60b000000000000000000000000000000000000000000000000000000003f4ba83a00000000000000000000000000000000000000000000000000000000098144d300000000000000000000000000000000000000000000000000000000238ac93200000000000000000000000000000000000000000000000000000000238ac9330000000000000000000000000000000000000000000000000000000023b872dd0000000000000000000000000000000000000000000000000000000026b9ce1300000000000000000000000000000000000000000000000000000000098144d4000000000000000000000000000000000000000000000000000000000d705df60000000000000000000000000000000000000000000000000000000018160ddd0000000000000000000000000000000000000000000000000000000006fdde020000000000000000000000000000000000000000000000000000000006fdde0300000000000000000000000000000000000000000000000000000000081812fc00000000000000000000000000000000000000000000000000000000095ea7b300000000000000000000000000000000000000000000000000000000014635460000000000000000000000000000000000000000000000000000000001ffc9a70000000000000000000000000000000000000000000000000000000004634d8dbb8a6a4669ba250d26cd7a459eca9d215f8307e33aebe50379bc5a3617ec34444f776e61626c653a206e6577206f776e657220697320746865207a65726f2061646472657373000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000840000008000000000000000000000000000000000000000000000000000000020000000800000000000000000000000000000000000000000000000000000002000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000184f03e93ff9f4daa797ed6e38ed64bf6a1f01000000000000000000000000000000000000000000000000000004ee2d6d415b85acef810000000000000000000000000000000000000000000004ee2d6d415b85acef80ffffffff000000000000000000000000000000000000000000000000002386f26fc1000000000000000000000000000000000000ffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000005f5e10000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff30313233343536373839616263646566000000000000000000000000000000007f0000000000000000000000000000000000000000000000000000000000000031ecc21a745e3968a04e9570e4425bc18fa8019c68028196b546d1669c200c68a14c4b5000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000000000032483afb000000000000000000000000000000000000000000000000000000000000000000000000000000ff0000000000000000000000000000000000000000ffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffff00000000000000000000000100000000000000000000000000000000000000009cc7f708afc65944829bd487b90b72536b1951864fbfc14e125fc972a6507f3900000000000000000000000000000000000000000000000000000003ffffffe017307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c317bf21fee0000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000200000008000000000000000006787c7f9a80aa0f5ceddab2c54f1f5169c0b88e75dd5e19d5e858a64144c7dbcc2575a0e9e593c00f959f8c92f12db2869c3395a3b0502d05e2516446f71f85bce133de58ba1c6975fb16a8f1bbda43e7057fe6397fd7e694ab92e9963dff398310ab089e4439a4c15d089f94afb7896ff553aecb10793d0ab882de59d99a32e0200000200000000000000000000000000000044000000000000000000000000b3512b0c00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffdf0f000000000000000000000000000000000000000000000000000000000000005061757361626c653a20706175736564000000000000000000000000000000000000000000000000000000000000000000000064000000800000000000000000447595b99645daf2d93285ba613562dea07cf81cc5141afc8643a5c9e813cbbc8f4eb60400000000000000000000000000000000000000000000000000000000ffffffffffffffffffffff0000000000000000000000000000000000000000ff4f776e6572206d696e743a206261642072657175657374000000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d9553913200000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000001ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef150b7a020000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000000000004578636565647320737570706c790000000000000000000000000000000000007f5b076c952c0ec86e5425963c1326dd0f03a3595c19f81d765e8ff559a6e33c455243323938313a20496e76616c696420706172616d65746572730000000000ebce568499f98b4bd66f6423c0eb7ca5f0077bf909d37138225d9333e81b954d0200000000000000000000000000000000000080000000a000000000000000001901000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000004200000000000000000000000045434453413a20696e76616c6964207369676e6174757265206c656e677468007fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a00000000000000000000000000000000000000080000000000000000000000000865f6cef00000000000000000000000000000000000000000000000000000000e82a5329000000000000000000000000000000000000000000000000000000006d187b2800000000000000000000000000000000000000000000000000000000d1a57ed6000000000000000000000000000000000000000000000000000000005cbd944100000000000000000000000000000000000000000000000000000000b562e8dd00000000000000000000000000000000000000000000000000000000356680b7000000000000000000000000000000000000000000000000000000004f2a1112000000000000000000000000000000000000000000000000000000004e487b710000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000005265656e7472616e637947756172643a207265656e7472616e742063616c6c0045434453413a20696e76616c6964207369676e61747572650000000000000000756500000000000000000000000000000000000000000000000000000000000045434453413a20696e76616c6964207369676e6174757265202773272076616c5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa5061757361626c653a206e6f74207061757365640000000000000000000000004ffddc7c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000caee23ea000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000800000000000000000cfb3b942000000000000000000000000000000000000000000000000000000008c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925df2d9b4200000000000000000000000000000000000000000000000000000000cf4700e4000000000000000000000000000000000000000000000000000000004f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65720200000000000000000000000000000000000020000000c0000000000000000080ac58ccffffffffffffffffffffffffffffffffffffffffffffffffffffffff80ac58cd00000000000000000000000000000000000000000000000000000000a07d229a00000000000000000000000000000000000000000000000000000000ad0d7f6c0000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000005b5e139f000000000000000000000000000000000000000000000000000000002a55205a00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa11481000000000000000000000000000000000000000000000000000000000059c896be00000000000000000000000000000000000000000000000000000000ea553b3400000000000000000000000000000000000000000000000000000000681c3e1c0c184baf30f1f51931c3c8827123462c085f5f90fb4bf894b146f896

000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001600000000000000000000000000000000000000000000000000000000000001b5800000000000000000000000000000000000000000000000000000000000001a00000000000000000000000000000000000000000000000000000000000000220000000000000000000000000cf1e9aa31fcad2ada0a5004310a14ff7ea68fe1700000000000000000000000000000000000000000000000000000000000001f4000000000000000000000000f79c76decf71862ace0ed9d5f1824e951da7fe13000000000000000000000000ad200e2a27acbe6d001c55ac824a83268d00d04000000000000000000000000000000000000000000000000000000000000000044b6162750000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044b41425500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004268747470733a2f2f6b6162752d6d696e742d73746167696e672d3533313239643030643630632e6865726f6b756170702e636f6d2f6170692f6d657461646174612f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

-----Decoded View---------------
Arg [0] : name_ (string): Kabu
Arg [1] : symbol_ (string): KABU
Arg [2] : maxSupply_ (uint256): 7000
Arg [3] : prefix_ (string): https://kabu-mint-staging-53129d00d60c.herokuapp.com/api/metadata/
Arg [4] : suffix_ (string): 
Arg [5] : royaltyReceiver_ (address): 0xcf1e9aA31Fcad2aDA0A5004310a14fF7EA68FE17
Arg [6] : royaltyFeeNumerator_ (uint96): 500
Arg [7] : signer_ (address): 0xf79c76decf71862ACE0ed9d5f1824E951Da7fE13
Arg [8] : paymentSplitter_ (address): 0xAD200E2a27ACbE6D001c55ac824A83268D00D040

-----Encoded View---------------
18 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000120
Arg [1] : 0000000000000000000000000000000000000000000000000000000000000160
Arg [2] : 0000000000000000000000000000000000000000000000000000000000001b58
Arg [3] : 00000000000000000000000000000000000000000000000000000000000001a0
Arg [4] : 0000000000000000000000000000000000000000000000000000000000000220
Arg [5] : 000000000000000000000000cf1e9aa31fcad2ada0a5004310a14ff7ea68fe17
Arg [6] : 00000000000000000000000000000000000000000000000000000000000001f4
Arg [7] : 000000000000000000000000f79c76decf71862ace0ed9d5f1824e951da7fe13
Arg [8] : 000000000000000000000000ad200e2a27acbe6d001c55ac824a83268d00d040
Arg [9] : 0000000000000000000000000000000000000000000000000000000000000004
Arg [10] : 4b61627500000000000000000000000000000000000000000000000000000000
Arg [11] : 0000000000000000000000000000000000000000000000000000000000000004
Arg [12] : 4b41425500000000000000000000000000000000000000000000000000000000
Arg [13] : 0000000000000000000000000000000000000000000000000000000000000042
Arg [14] : 68747470733a2f2f6b6162752d6d696e742d73746167696e672d353331323964
Arg [15] : 3030643630632e6865726f6b756170702e636f6d2f6170692f6d657461646174
Arg [16] : 612f000000000000000000000000000000000000000000000000000000000000
Arg [17] : 0000000000000000000000000000000000000000000000000000000000000000