{"sources":{"Saturnelle.sol":{"content":"// SPDX-License-Identifier: MIT\npragma solidity 0.8.24;\n\n// File: @openzeppelin/contracts/utils/introspection/IERC165.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol)\n\n\n/**\n * @dev Interface of the ERC165 standard, as defined in the\n * https://eips.ethereum.org/EIPS/eip-165[EIP].\n *\n * Implementers can declare support of contract interfaces, which can then be\n * queried by others ({ERC165Checker}).\n *\n * For an implementation, see {ERC165}.\n */\ninterface IERC165 {\n    /**\n     * @dev Returns true if this contract implements the interface defined by\n     * `interfaceId`. See the corresponding\n     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]\n     * to learn more about how these ids are created.\n     *\n     * This function call must use less than 30 000 gas.\n     */\n    function supportsInterface(bytes4 interfaceId) external view returns (bool);\n}\n\n// File: @openzeppelin/contracts/token/ERC721/IERC721.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/IERC721.sol)\n\n\n\n/**\n * @dev Required interface of an ERC721 compliant contract.\n */\ninterface IERC721 is IERC165 {\n    /**\n     * @dev Emitted when `tokenId` token is transferred from `from` to `to`.\n     */\n    event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);\n\n    /**\n     * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.\n     */\n    event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);\n\n    /**\n     * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.\n     */\n    event ApprovalForAll(address indexed owner, address indexed operator, bool approved);\n\n    /**\n     * @dev Returns the number of tokens in ``owner``'s account.\n     */\n    function balanceOf(address owner) external view returns (uint256 balance);\n\n    /**\n     * @dev Returns the owner of the `tokenId` token.\n     *\n     * Requirements:\n     *\n     * - `tokenId` must exist.\n     */\n    function ownerOf(uint256 tokenId) external view returns (address owner);\n\n    /**\n     * @dev Safely transfers `tokenId` token from `from` to `to`.\n     *\n     * Requirements:\n     *\n     * - `from` cannot be the zero address.\n     * - `to` cannot be the zero address.\n     * - `tokenId` token must exist and be owned by `from`.\n     * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.\n     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon\n     *   a safe transfer.\n     *\n     * Emits a {Transfer} event.\n     */\n    function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;\n\n    /**\n     * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients\n     * are aware of the ERC721 protocol to prevent tokens from being forever locked.\n     *\n     * Requirements:\n     *\n     * - `from` cannot be the zero address.\n     * - `to` cannot be the zero address.\n     * - `tokenId` token must exist and be owned by `from`.\n     * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or\n     *   {setApprovalForAll}.\n     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon\n     *   a safe transfer.\n     *\n     * Emits a {Transfer} event.\n     */\n    function safeTransferFrom(address from, address to, uint256 tokenId) external;\n\n    /**\n     * @dev Transfers `tokenId` token from `from` to `to`.\n     *\n     * WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721\n     * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must\n     * understand this adds an external call which potentially creates a reentrancy vulnerability.\n     *\n     * Requirements:\n     *\n     * - `from` cannot be the zero address.\n     * - `to` cannot be the zero address.\n     * - `tokenId` token must be owned by `from`.\n     * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.\n     *\n     * Emits a {Transfer} event.\n     */\n    function transferFrom(address from, address to, uint256 tokenId) external;\n\n    /**\n     * @dev Gives permission to `to` to transfer `tokenId` token to another account.\n     * The approval is cleared when the token is transferred.\n     *\n     * Only a single account can be approved at a time, so approving the zero address clears previous approvals.\n     *\n     * Requirements:\n     *\n     * - The caller must own the token or be an approved operator.\n     * - `tokenId` must exist.\n     *\n     * Emits an {Approval} event.\n     */\n    function approve(address to, uint256 tokenId) external;\n\n    /**\n     * @dev Approve or remove `operator` as an operator for the caller.\n     * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.\n     *\n     * Requirements:\n     *\n     * - The `operator` cannot be the address zero.\n     *\n     * Emits an {ApprovalForAll} event.\n     */\n    function setApprovalForAll(address operator, bool approved) external;\n\n    /**\n     * @dev Returns the account approved for `tokenId` token.\n     *\n     * Requirements:\n     *\n     * - `tokenId` must exist.\n     */\n    function getApproved(uint256 tokenId) external view returns (address operator);\n\n    /**\n     * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.\n     *\n     * See {setApprovalForAll}\n     */\n    function isApprovedForAll(address owner, address operator) external view returns (bool);\n}\n\n// File: @openzeppelin/contracts/token/ERC721/IERC721Receiver.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/IERC721Receiver.sol)\n\n\n/**\n * @title ERC721 token receiver interface\n * @dev Interface for any contract that wants to support safeTransfers\n * from ERC721 asset contracts.\n */\ninterface IERC721Receiver {\n    /**\n     * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}\n     * by `operator` from `from`, this function is called.\n     *\n     * It must return its Solidity selector to confirm the token transfer.\n     * If any other value is returned or the interface is not implemented by the recipient, the transfer will be\n     * reverted.\n     *\n     * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.\n     */\n    function onERC721Received(\n        address operator,\n        address from,\n        uint256 tokenId,\n        bytes calldata data\n    ) external returns (bytes4);\n}\n\n// File: @openzeppelin/contracts/token/ERC721/extensions/IERC721Metadata.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/extensions/IERC721Metadata.sol)\n\n\n\n/**\n * @title ERC-721 Non-Fungible Token Standard, optional metadata extension\n * @dev See https://eips.ethereum.org/EIPS/eip-721\n */\ninterface IERC721Metadata is IERC721 {\n    /**\n     * @dev Returns the token collection name.\n     */\n    function name() external view returns (string memory);\n\n    /**\n     * @dev Returns the token collection symbol.\n     */\n    function symbol() external view returns (string memory);\n\n    /**\n     * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.\n     */\n    function tokenURI(uint256 tokenId) external view returns (string memory);\n}\n\n// File: @openzeppelin/contracts/utils/Context.sol\n// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)\n\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract Context {\n    function _msgSender() internal view virtual returns (address) {\n        return msg.sender;\n    }\n\n    function _msgData() internal view virtual returns (bytes calldata) {\n        return msg.data;\n    }\n\n    function _contextSuffixLength() internal view virtual returns (uint256) {\n        return 0;\n    }\n}\n\n// File: @openzeppelin/contracts/utils/math/Math.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (utils/math/Math.sol)\n\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary Math {\n    /**\n     * @dev Muldiv operation overflow.\n     */\n    error MathOverflowedMulDiv();\n\n    enum Rounding {\n        Floor, // Toward negative infinity\n        Ceil, // Toward positive infinity\n        Trunc, // Toward zero\n        Expand // Away from zero\n    }\n\n    /**\n     * @dev Returns the addition of two unsigned integers, with an overflow flag.\n     */\n    function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        unchecked {\n            uint256 c = a + b;\n            if (c < a) return (false, 0);\n            return (true, c);\n        }\n    }\n\n    /**\n     * @dev Returns the subtraction of two unsigned integers, with an overflow flag.\n     */\n    function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        unchecked {\n            if (b > a) return (false, 0);\n            return (true, a - b);\n        }\n    }\n\n    /**\n     * @dev Returns the multiplication of two unsigned integers, with an overflow flag.\n     */\n    function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        unchecked {\n            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\n            // benefit is lost if 'b' is also tested.\n            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\n            if (a == 0) return (true, 0);\n            uint256 c = a * b;\n            if (c / a != b) return (false, 0);\n            return (true, c);\n        }\n    }\n\n    /**\n     * @dev Returns the division of two unsigned integers, with a division by zero flag.\n     */\n    function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        unchecked {\n            if (b == 0) return (false, 0);\n            return (true, a / b);\n        }\n    }\n\n    /**\n     * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.\n     */\n    function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n        unchecked {\n            if (b == 0) return (false, 0);\n            return (true, a % b);\n        }\n    }\n\n    /**\n     * @dev Returns the largest of two numbers.\n     */\n    function max(uint256 a, uint256 b) internal pure returns (uint256) {\n        return a > b ? a : b;\n    }\n\n    /**\n     * @dev Returns the smallest of two numbers.\n     */\n    function min(uint256 a, uint256 b) internal pure returns (uint256) {\n        return a < b ? a : b;\n    }\n\n    /**\n     * @dev Returns the average of two numbers. The result is rounded towards\n     * zero.\n     */\n    function average(uint256 a, uint256 b) internal pure returns (uint256) {\n        // (a + b) / 2 can overflow.\n        return (a & b) + (a ^ b) / 2;\n    }\n\n    /**\n     * @dev Returns the ceiling of the division of two numbers.\n     *\n     * This differs from standard division with `/` in that it rounds towards infinity instead\n     * of rounding towards zero.\n     */\n    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n        if (b == 0) {\n            // Guarantee the same behavior as in a regular Solidity division.\n            return a / b;\n        }\n\n        // (a + b - 1) / b can overflow on addition, so we distribute.\n        return a == 0 ? 0 : (a - 1) / b + 1;\n    }\n\n    /**\n     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or\n     * denominator == 0.\n     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by\n     * Uniswap Labs also under MIT license.\n     */\n    function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n        unchecked {\n            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n            // variables such that product = prod1 * 2^256 + prod0.\n            uint256 prod0 = x * y; // Least significant 256 bits of the product\n            uint256 prod1; // Most significant 256 bits of the product\n            assembly {\n                let mm := mulmod(x, y, not(0))\n                prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n            }\n\n            // Handle non-overflow cases, 256 by 256 division.\n            if (prod1 == 0) {\n                // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n                // The surrounding unchecked block does not change this fact.\n                // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n                return prod0 / denominator;\n            }\n\n            // Make sure the result is less than 2^256. Also prevents denominator == 0.\n            if (denominator <= prod1) {\n                revert MathOverflowedMulDiv();\n            }\n\n            ///////////////////////////////////////////////\n            // 512 by 256 division.\n            ///////////////////////////////////////////////\n\n            // Make division exact by subtracting the remainder from [prod1 prod0].\n            uint256 remainder;\n            assembly {\n                // Compute remainder using mulmod.\n                remainder := mulmod(x, y, denominator)\n\n                // Subtract 256 bit number from 512 bit number.\n                prod1 := sub(prod1, gt(remainder, prod0))\n                prod0 := sub(prod0, remainder)\n            }\n\n            // Factor powers of two out of denominator and compute largest power of two divisor of denominator.\n            // Always >= 1. See https://cs.stackexchange.com/q/138556/92363.\n\n            uint256 twos = denominator & (0 - denominator);\n            assembly {\n                // Divide denominator by twos.\n                denominator := div(denominator, twos)\n\n                // Divide [prod1 prod0] by twos.\n                prod0 := div(prod0, twos)\n\n                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n                twos := add(div(sub(0, twos), twos), 1)\n            }\n\n            // Shift in bits from prod1 into prod0.\n            prod0 |= prod1 * twos;\n\n            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n            // four bits. That is, denominator * inv = 1 mod 2^4.\n            uint256 inverse = (3 * denominator) ^ 2;\n\n            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also\n            // works in modular arithmetic, doubling the correct bits in each step.\n            inverse *= 2 - denominator * inverse; // inverse mod 2^8\n            inverse *= 2 - denominator * inverse; // inverse mod 2^16\n            inverse *= 2 - denominator * inverse; // inverse mod 2^32\n            inverse *= 2 - denominator * inverse; // inverse mod 2^64\n            inverse *= 2 - denominator * inverse; // inverse mod 2^128\n            inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n            // is no longer required.\n            result = prod0 * inverse;\n            return result;\n        }\n    }\n\n    /**\n     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n     */\n    function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n        uint256 result = mulDiv(x, y, denominator);\n        if (unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0) {\n            result += 1;\n        }\n        return result;\n    }\n\n    /**\n     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded\n     * towards zero.\n     *\n     * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n     */\n    function sqrt(uint256 a) internal pure returns (uint256) {\n        if (a == 0) {\n            return 0;\n        }\n\n        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n        //\n        // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n        //\n        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n        //\n        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n        uint256 result = 1 << (log2(a) >> 1);\n\n        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n        // into the expected uint128 result.\n        unchecked {\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            return min(result, a / result);\n        }\n    }\n\n    /**\n     * @notice Calculates sqrt(a), following the selected rounding direction.\n     */\n    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = sqrt(a);\n            return result + (unsignedRoundsUp(rounding) && result * result < a ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 2 of a positive value rounded towards zero.\n     * Returns 0 if given 0.\n     */\n    function log2(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >> 128 > 0) {\n                value >>= 128;\n                result += 128;\n            }\n            if (value >> 64 > 0) {\n                value >>= 64;\n                result += 64;\n            }\n            if (value >> 32 > 0) {\n                value >>= 32;\n                result += 32;\n            }\n            if (value >> 16 > 0) {\n                value >>= 16;\n                result += 16;\n            }\n            if (value >> 8 > 0) {\n                value >>= 8;\n                result += 8;\n            }\n            if (value >> 4 > 0) {\n                value >>= 4;\n                result += 4;\n            }\n            if (value >> 2 > 0) {\n                value >>= 2;\n                result += 2;\n            }\n            if (value >> 1 > 0) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log2(value);\n            return result + (unsignedRoundsUp(rounding) && 1 << result < value ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 10 of a positive value rounded towards zero.\n     * Returns 0 if given 0.\n     */\n    function log10(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >= 10 ** 64) {\n                value /= 10 ** 64;\n                result += 64;\n            }\n            if (value >= 10 ** 32) {\n                value /= 10 ** 32;\n                result += 32;\n            }\n            if (value >= 10 ** 16) {\n                value /= 10 ** 16;\n                result += 16;\n            }\n            if (value >= 10 ** 8) {\n                value /= 10 ** 8;\n                result += 8;\n            }\n            if (value >= 10 ** 4) {\n                value /= 10 ** 4;\n                result += 4;\n            }\n            if (value >= 10 ** 2) {\n                value /= 10 ** 2;\n                result += 2;\n            }\n            if (value >= 10 ** 1) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log10(value);\n            return result + (unsignedRoundsUp(rounding) && 10 ** result < value ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 256 of a positive value rounded towards zero.\n     * Returns 0 if given 0.\n     *\n     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n     */\n    function log256(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >> 128 > 0) {\n                value >>= 128;\n                result += 16;\n            }\n            if (value >> 64 > 0) {\n                value >>= 64;\n                result += 8;\n            }\n            if (value >> 32 > 0) {\n                value >>= 32;\n                result += 4;\n            }\n            if (value >> 16 > 0) {\n                value >>= 16;\n                result += 2;\n            }\n            if (value >> 8 > 0) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log256(value);\n            return result + (unsignedRoundsUp(rounding) && 1 << (result << 3) < value ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.\n     */\n    function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {\n        return uint8(rounding) % 2 == 1;\n    }\n}\n\n// File: @openzeppelin/contracts/utils/math/SignedMath.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (utils/math/SignedMath.sol)\n\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMath {\n    /**\n     * @dev Returns the largest of two signed numbers.\n     */\n    function max(int256 a, int256 b) internal pure returns (int256) {\n        return a > b ? a : b;\n    }\n\n    /**\n     * @dev Returns the smallest of two signed numbers.\n     */\n    function min(int256 a, int256 b) internal pure returns (int256) {\n        return a < b ? a : b;\n    }\n\n    /**\n     * @dev Returns the average of two signed numbers without overflow.\n     * The result is rounded towards zero.\n     */\n    function average(int256 a, int256 b) internal pure returns (int256) {\n        // Formula from the book \"Hacker's Delight\"\n        int256 x = (a & b) + ((a ^ b) >> 1);\n        return x + (int256(uint256(x) >> 255) & (a ^ b));\n    }\n\n    /**\n     * @dev Returns the absolute unsigned value of a signed value.\n     */\n    function abs(int256 n) internal pure returns (uint256) {\n        unchecked {\n            // must be unchecked in order to support `n = type(int256).min`\n            return uint256(n >= 0 ? n : -n);\n        }\n    }\n}\n\n// File: @openzeppelin/contracts/utils/Strings.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (utils/Strings.sol)\n\n\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n    bytes16 private constant HEX_DIGITS = \"0123456789abcdef\";\n    uint8 private constant ADDRESS_LENGTH = 20;\n\n    /**\n     * @dev The `value` string doesn't fit in the specified `length`.\n     */\n    error StringsInsufficientHexLength(uint256 value, uint256 length);\n\n    /**\n     * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n     */\n    function toString(uint256 value) internal pure returns (string memory) {\n        unchecked {\n            uint256 length = Math.log10(value) + 1;\n            string memory buffer = new string(length);\n            uint256 ptr;\n            /// @solidity memory-safe-assembly\n            assembly {\n                ptr := add(buffer, add(32, length))\n            }\n            while (true) {\n                ptr--;\n                /// @solidity memory-safe-assembly\n                assembly {\n                    mstore8(ptr, byte(mod(value, 10), HEX_DIGITS))\n                }\n                value /= 10;\n                if (value == 0) break;\n            }\n            return buffer;\n        }\n    }\n\n    /**\n     * @dev Converts a `int256` to its ASCII `string` decimal representation.\n     */\n    function toStringSigned(int256 value) internal pure returns (string memory) {\n        return string.concat(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value)));\n    }\n\n    /**\n     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n     */\n    function toHexString(uint256 value) internal pure returns (string memory) {\n        unchecked {\n            return toHexString(value, Math.log256(value) + 1);\n        }\n    }\n\n    /**\n     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n     */\n    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n        uint256 localValue = value;\n        bytes memory buffer = new bytes(2 * length + 2);\n        buffer[0] = \"0\";\n        buffer[1] = \"x\";\n        for (uint256 i = 2 * length + 1; i > 1; --i) {\n            buffer[i] = HEX_DIGITS[localValue & 0xf];\n            localValue >>= 4;\n        }\n        if (localValue != 0) {\n            revert StringsInsufficientHexLength(value, length);\n        }\n        return string(buffer);\n    }\n\n    /**\n     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal\n     * representation.\n     */\n    function toHexString(address addr) internal pure returns (string memory) {\n        return toHexString(uint256(uint160(addr)), ADDRESS_LENGTH);\n    }\n\n    /**\n     * @dev Returns true if the two strings are equal.\n     */\n    function equal(string memory a, string memory b) internal pure returns (bool) {\n        return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b));\n    }\n}\n\n// File: @openzeppelin/contracts/utils/introspection/ERC165.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/ERC165.sol)\n\n\n\n/**\n * @dev Implementation of the {IERC165} interface.\n *\n * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check\n * for the additional interface id that will be supported. For example:\n *\n * ```solidity\n * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);\n * }\n * ```\n */\nabstract contract ERC165 is IERC165 {\n    /**\n     * @dev See {IERC165-supportsInterface}.\n     */\n    function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {\n        return interfaceId == type(IERC165).interfaceId;\n    }\n}\n\n// File: @openzeppelin/contracts/interfaces/draft-IERC6093.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol)\n\n/**\n * @dev Standard ERC20 Errors\n * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens.\n */\ninterface IERC20Errors {\n    /**\n     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.\n     * @param sender Address whose tokens are being transferred.\n     * @param balance Current balance for the interacting account.\n     * @param needed Minimum amount required to perform a transfer.\n     */\n    error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);\n\n    /**\n     * @dev Indicates a failure with the token `sender`. Used in transfers.\n     * @param sender Address whose tokens are being transferred.\n     */\n    error ERC20InvalidSender(address sender);\n\n    /**\n     * @dev Indicates a failure with the token `receiver`. Used in transfers.\n     * @param receiver Address to which tokens are being transferred.\n     */\n    error ERC20InvalidReceiver(address receiver);\n\n    /**\n     * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.\n     * @param spender Address that may be allowed to operate on tokens without being their owner.\n     * @param allowance Amount of tokens a `spender` is allowed to operate with.\n     * @param needed Minimum amount required to perform a transfer.\n     */\n    error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);\n\n    /**\n     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.\n     * @param approver Address initiating an approval operation.\n     */\n    error ERC20InvalidApprover(address approver);\n\n    /**\n     * @dev Indicates a failure with the `spender` to be approved. Used in approvals.\n     * @param spender Address that may be allowed to operate on tokens without being their owner.\n     */\n    error ERC20InvalidSpender(address spender);\n}\n\n/**\n * @dev Standard ERC721 Errors\n * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens.\n */\ninterface IERC721Errors {\n    /**\n     * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20.\n     * Used in balance queries.\n     * @param owner Address of the current owner of a token.\n     */\n    error ERC721InvalidOwner(address owner);\n\n    /**\n     * @dev Indicates a `tokenId` whose `owner` is the zero address.\n     * @param tokenId Identifier number of a token.\n     */\n    error ERC721NonexistentToken(uint256 tokenId);\n\n    /**\n     * @dev Indicates an error related to the ownership over a particular token. Used in transfers.\n     * @param sender Address whose tokens are being transferred.\n     * @param tokenId Identifier number of a token.\n     * @param owner Address of the current owner of a token.\n     */\n    error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);\n\n    /**\n     * @dev Indicates a failure with the token `sender`. Used in transfers.\n     * @param sender Address whose tokens are being transferred.\n     */\n    error ERC721InvalidSender(address sender);\n\n    /**\n     * @dev Indicates a failure with the token `receiver`. Used in transfers.\n     * @param receiver Address to which tokens are being transferred.\n     */\n    error ERC721InvalidReceiver(address receiver);\n\n    /**\n     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.\n     * @param operator Address that may be allowed to operate on tokens without being their owner.\n     * @param tokenId Identifier number of a token.\n     */\n    error ERC721InsufficientApproval(address operator, uint256 tokenId);\n\n    /**\n     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.\n     * @param approver Address initiating an approval operation.\n     */\n    error ERC721InvalidApprover(address approver);\n\n    /**\n     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.\n     * @param operator Address that may be allowed to operate on tokens without being their owner.\n     */\n    error ERC721InvalidOperator(address operator);\n}\n\n/**\n * @dev Standard ERC1155 Errors\n * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens.\n */\ninterface IERC1155Errors {\n    /**\n     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.\n     * @param sender Address whose tokens are being transferred.\n     * @param balance Current balance for the interacting account.\n     * @param needed Minimum amount required to perform a transfer.\n     * @param tokenId Identifier number of a token.\n     */\n    error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);\n\n    /**\n     * @dev Indicates a failure with the token `sender`. Used in transfers.\n     * @param sender Address whose tokens are being transferred.\n     */\n    error ERC1155InvalidSender(address sender);\n\n    /**\n     * @dev Indicates a failure with the token `receiver`. Used in transfers.\n     * @param receiver Address to which tokens are being transferred.\n     */\n    error ERC1155InvalidReceiver(address receiver);\n\n    /**\n     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.\n     * @param operator Address that may be allowed to operate on tokens without being their owner.\n     * @param owner Address of the current owner of a token.\n     */\n    error ERC1155MissingApprovalForAll(address operator, address owner);\n\n    /**\n     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.\n     * @param approver Address initiating an approval operation.\n     */\n    error ERC1155InvalidApprover(address approver);\n\n    /**\n     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.\n     * @param operator Address that may be allowed to operate on tokens without being their owner.\n     */\n    error ERC1155InvalidOperator(address operator);\n\n    /**\n     * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.\n     * Used in batch transfers.\n     * @param idsLength Length of the array of token identifiers\n     * @param valuesLength Length of the array of token amounts\n     */\n    error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);\n}\n\n// File: @openzeppelin/contracts/token/ERC721/ERC721.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/ERC721.sol)\n\n\n\n/**\n * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including\n * the Metadata extension, but not including the Enumerable extension, which is available separately as\n * {ERC721Enumerable}.\n */\nabstract contract ERC721 is Context, ERC165, IERC721, IERC721Metadata, IERC721Errors {\n    using Strings for uint256;\n\n    // Token name\n    string private _name;\n\n    // Token symbol\n    string private _symbol;\n\n    mapping(uint256 tokenId => address) private _owners;\n\n    mapping(address owner => uint256) private _balances;\n\n    mapping(uint256 tokenId => address) private _tokenApprovals;\n\n    mapping(address owner => mapping(address operator => bool)) private _operatorApprovals;\n\n    /**\n     * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.\n     */\n    constructor(string memory name_, string memory symbol_) {\n        _name = name_;\n        _symbol = symbol_;\n    }\n\n    /**\n     * @dev See {IERC165-supportsInterface}.\n     */\n    function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {\n        return\n            interfaceId == type(IERC721).interfaceId ||\n            interfaceId == type(IERC721Metadata).interfaceId ||\n            super.supportsInterface(interfaceId);\n    }\n\n    /**\n     * @dev See {IERC721-balanceOf}.\n     */\n    function balanceOf(address owner) public view virtual returns (uint256) {\n        if (owner == address(0)) {\n            revert ERC721InvalidOwner(address(0));\n        }\n        return _balances[owner];\n    }\n\n    /**\n     * @dev See {IERC721-ownerOf}.\n     */\n    function ownerOf(uint256 tokenId) public view virtual returns (address) {\n        return _requireOwned(tokenId);\n    }\n\n    /**\n     * @dev See {IERC721Metadata-name}.\n     */\n    function name() public view virtual returns (string memory) {\n        return _name;\n    }\n\n    /**\n     * @dev See {IERC721Metadata-symbol}.\n     */\n    function symbol() public view virtual returns (string memory) {\n        return _symbol;\n    }\n\n    /**\n     * @dev See {IERC721Metadata-tokenURI}.\n     */\n    function tokenURI(uint256 tokenId) public view virtual returns (string memory) {\n        _requireOwned(tokenId);\n\n        string memory baseURI = _baseURI();\n        return bytes(baseURI).length > 0 ? string.concat(baseURI, tokenId.toString()) : \"\";\n    }\n\n    /**\n     * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each\n     * token will be the concatenation of the `baseURI` and the `tokenId`. Empty\n     * by default, can be overridden in child contracts.\n     */\n    function _baseURI() internal view virtual returns (string memory) {\n        return \"\";\n    }\n\n    /**\n     * @dev See {IERC721-approve}.\n     */\n    function approve(address to, uint256 tokenId) public virtual {\n        _approve(to, tokenId, _msgSender());\n    }\n\n    /**\n     * @dev See {IERC721-getApproved}.\n     */\n    function getApproved(uint256 tokenId) public view virtual returns (address) {\n        _requireOwned(tokenId);\n\n        return _getApproved(tokenId);\n    }\n\n    /**\n     * @dev See {IERC721-setApprovalForAll}.\n     */\n    function setApprovalForAll(address operator, bool approved) public virtual {\n        _setApprovalForAll(_msgSender(), operator, approved);\n    }\n\n    /**\n     * @dev See {IERC721-isApprovedForAll}.\n     */\n    function isApprovedForAll(address owner, address operator) public view virtual returns (bool) {\n        return _operatorApprovals[owner][operator];\n    }\n\n    /**\n     * @dev See {IERC721-transferFrom}.\n     */\n    function transferFrom(address from, address to, uint256 tokenId) public virtual {\n        if (to == address(0)) {\n            revert ERC721InvalidReceiver(address(0));\n        }\n        // Setting an \"auth\" arguments enables the `_isAuthorized` check which verifies that the token exists\n        // (from != 0). Therefore, it is not needed to verify that the return value is not 0 here.\n        address previousOwner = _update(to, tokenId, _msgSender());\n        if (previousOwner != from) {\n            revert ERC721IncorrectOwner(from, tokenId, previousOwner);\n        }\n    }\n\n    /**\n     * @dev See {IERC721-safeTransferFrom}.\n     */\n    function safeTransferFrom(address from, address to, uint256 tokenId) public {\n        safeTransferFrom(from, to, tokenId, \"\");\n    }\n\n    /**\n     * @dev See {IERC721-safeTransferFrom}.\n     */\n    function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public virtual {\n        transferFrom(from, to, tokenId);\n        _checkOnERC721Received(from, to, tokenId, data);\n    }\n\n    /**\n     * @dev Returns the owner of the `tokenId`. Does NOT revert if token doesn't exist\n     *\n     * IMPORTANT: Any overrides to this function that add ownership of tokens not tracked by the\n     * core ERC721 logic MUST be matched with the use of {_increaseBalance} to keep balances\n     * consistent with ownership. The invariant to preserve is that for any address `a` the value returned by\n     * `balanceOf(a)` must be equal to the number of tokens such that `_ownerOf(tokenId)` is `a`.\n     */\n    function _ownerOf(uint256 tokenId) internal view virtual returns (address) {\n        return _owners[tokenId];\n    }\n\n    /**\n     * @dev Returns the approved address for `tokenId`. Returns 0 if `tokenId` is not minted.\n     */\n    function _getApproved(uint256 tokenId) internal view virtual returns (address) {\n        return _tokenApprovals[tokenId];\n    }\n\n    /**\n     * @dev Returns whether `spender` is allowed to manage `owner`'s tokens, or `tokenId` in\n     * particular (ignoring whether it is owned by `owner`).\n     *\n     * WARNING: This function assumes that `owner` is the actual owner of `tokenId` and does not verify this\n     * assumption.\n     */\n    function _isAuthorized(address owner, address spender, uint256 tokenId) internal view virtual returns (bool) {\n        return\n            spender != address(0) &&\n            (owner == spender || isApprovedForAll(owner, spender) || _getApproved(tokenId) == spender);\n    }\n\n    /**\n     * @dev Checks if `spender` can operate on `tokenId`, assuming the provided `owner` is the actual owner.\n     * Reverts if `spender` does not have approval from the provided `owner` for the given token or for all its assets\n     * the `spender` for the specific `tokenId`.\n     *\n     * WARNING: This function assumes that `owner` is the actual owner of `tokenId` and does not verify this\n     * assumption.\n     */\n    function _checkAuthorized(address owner, address spender, uint256 tokenId) internal view virtual {\n        if (!_isAuthorized(owner, spender, tokenId)) {\n            if (owner == address(0)) {\n                revert ERC721NonexistentToken(tokenId);\n            } else {\n                revert ERC721InsufficientApproval(spender, tokenId);\n            }\n        }\n    }\n\n    /**\n     * @dev Unsafe write access to the balances, used by extensions that \"mint\" tokens using an {ownerOf} override.\n     *\n     * NOTE: the value is limited to type(uint128).max. This protect against _balance overflow. It is unrealistic that\n     * a uint256 would ever overflow from increments when these increments are bounded to uint128 values.\n     *\n     * WARNING: Increasing an account's balance using this function tends to be paired with an override of the\n     * {_ownerOf} function to resolve the ownership of the corresponding tokens so that balances and ownership\n     * remain consistent with one another.\n     */\n    function _increaseBalance(address account, uint128 value) internal virtual {\n        unchecked {\n            _balances[account] += value;\n        }\n    }\n\n    /**\n     * @dev Transfers `tokenId` from its current owner to `to`, or alternatively mints (or burns) if the current owner\n     * (or `to`) is the zero address. Returns the owner of the `tokenId` before the update.\n     *\n     * The `auth` argument is optional. If the value passed is non 0, then this function will check that\n     * `auth` is either the owner of the token, or approved to operate on the token (by the owner).\n     *\n     * Emits a {Transfer} event.\n     *\n     * NOTE: If overriding this function in a way that tracks balances, see also {_increaseBalance}.\n     */\n    function _update(address to, uint256 tokenId, address auth) internal virtual returns (address) {\n        address from = _ownerOf(tokenId);\n\n        // Perform (optional) operator check\n        if (auth != address(0)) {\n            _checkAuthorized(from, auth, tokenId);\n        }\n\n        // Execute the update\n        if (from != address(0)) {\n            // Clear approval. No need to re-authorize or emit the Approval event\n            _approve(address(0), tokenId, address(0), false);\n\n            unchecked {\n                _balances[from] -= 1;\n            }\n        }\n\n        if (to != address(0)) {\n            unchecked {\n                _balances[to] += 1;\n            }\n        }\n\n        _owners[tokenId] = to;\n\n        emit Transfer(from, to, tokenId);\n\n        return from;\n    }\n\n    /**\n     * @dev Mints `tokenId` and transfers it to `to`.\n     *\n     * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible\n     *\n     * Requirements:\n     *\n     * - `tokenId` must not exist.\n     * - `to` cannot be the zero address.\n     *\n     * Emits a {Transfer} event.\n     */\n    function _mint(address to, uint256 tokenId) internal {\n        if (to == address(0)) {\n            revert ERC721InvalidReceiver(address(0));\n        }\n        address previousOwner = _update(to, tokenId, address(0));\n        if (previousOwner != address(0)) {\n            revert ERC721InvalidSender(address(0));\n        }\n    }\n\n    /**\n     * @dev Mints `tokenId`, transfers it to `to` and checks for `to` acceptance.\n     *\n     * Requirements:\n     *\n     * - `tokenId` must not exist.\n     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.\n     *\n     * Emits a {Transfer} event.\n     */\n    function _safeMint(address to, uint256 tokenId) internal {\n        _safeMint(to, tokenId, \"\");\n    }\n\n    /**\n     * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is\n     * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.\n     */\n    function _safeMint(address to, uint256 tokenId, bytes memory data) internal virtual {\n        _mint(to, tokenId);\n        _checkOnERC721Received(address(0), to, tokenId, data);\n    }\n\n    /**\n     * @dev Destroys `tokenId`.\n     * The approval is cleared when the token is burned.\n     * This is an internal function that does not check if the sender is authorized to operate on the token.\n     *\n     * Requirements:\n     *\n     * - `tokenId` must exist.\n     *\n     * Emits a {Transfer} event.\n     */\n    function _burn(uint256 tokenId) internal {\n        address previousOwner = _update(address(0), tokenId, address(0));\n        if (previousOwner == address(0)) {\n            revert ERC721NonexistentToken(tokenId);\n        }\n    }\n\n    /**\n     * @dev Transfers `tokenId` from `from` to `to`.\n     *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.\n     *\n     * Requirements:\n     *\n     * - `to` cannot be the zero address.\n     * - `tokenId` token must be owned by `from`.\n     *\n     * Emits a {Transfer} event.\n     */\n    function _transfer(address from, address to, uint256 tokenId) internal {\n        if (to == address(0)) {\n            revert ERC721InvalidReceiver(address(0));\n        }\n        address previousOwner = _update(to, tokenId, address(0));\n        if (previousOwner == address(0)) {\n            revert ERC721NonexistentToken(tokenId);\n        } else if (previousOwner != from) {\n            revert ERC721IncorrectOwner(from, tokenId, previousOwner);\n        }\n    }\n\n    /**\n     * @dev Safely transfers `tokenId` token from `from` to `to`, checking that contract recipients\n     * are aware of the ERC721 standard to prevent tokens from being forever locked.\n     *\n     * `data` is additional data, it has no specified format and it is sent in call to `to`.\n     *\n     * This internal function is like {safeTransferFrom} in the sense that it invokes\n     * {IERC721Receiver-onERC721Received} on the receiver, and can be used to e.g.\n     * implement alternative mechanisms to perform token transfer, such as signature-based.\n     *\n     * Requirements:\n     *\n     * - `tokenId` token must exist and be owned by `from`.\n     * - `to` cannot be the zero address.\n     * - `from` cannot be the zero address.\n     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.\n     *\n     * Emits a {Transfer} event.\n     */\n    function _safeTransfer(address from, address to, uint256 tokenId) internal {\n        _safeTransfer(from, to, tokenId, \"\");\n    }\n\n    /**\n     * @dev Same as {xref-ERC721-_safeTransfer-address-address-uint256-}[`_safeTransfer`], with an additional `data` parameter which is\n     * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.\n     */\n    function _safeTransfer(address from, address to, uint256 tokenId, bytes memory data) internal virtual {\n        _transfer(from, to, tokenId);\n        _checkOnERC721Received(from, to, tokenId, data);\n    }\n\n    /**\n     * @dev Approve `to` to operate on `tokenId`\n     *\n     * The `auth` argument is optional. If the value passed is non 0, then this function will check that `auth` is\n     * either the owner of the token, or approved to operate on all tokens held by this owner.\n     *\n     * Emits an {Approval} event.\n     *\n     * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.\n     */\n    function _approve(address to, uint256 tokenId, address auth) internal {\n        _approve(to, tokenId, auth, true);\n    }\n\n    /**\n     * @dev Variant of `_approve` with an optional flag to enable or disable the {Approval} event. The event is not\n     * emitted in the context of transfers.\n     */\n    function _approve(address to, uint256 tokenId, address auth, bool emitEvent) internal virtual {\n        // Avoid reading the owner unless necessary\n        if (emitEvent || auth != address(0)) {\n            address owner = _requireOwned(tokenId);\n\n            // We do not use _isAuthorized because single-token approvals should not be able to call approve\n            if (auth != address(0) && owner != auth && !isApprovedForAll(owner, auth)) {\n                revert ERC721InvalidApprover(auth);\n            }\n\n            if (emitEvent) {\n                emit Approval(owner, to, tokenId);\n            }\n        }\n\n        _tokenApprovals[tokenId] = to;\n    }\n\n    /**\n     * @dev Approve `operator` to operate on all of `owner` tokens\n     *\n     * Requirements:\n     * - operator can't be the address zero.\n     *\n     * Emits an {ApprovalForAll} event.\n     */\n    function _setApprovalForAll(address owner, address operator, bool approved) internal virtual {\n        if (operator == address(0)) {\n            revert ERC721InvalidOperator(operator);\n        }\n        _operatorApprovals[owner][operator] = approved;\n        emit ApprovalForAll(owner, operator, approved);\n    }\n\n    /**\n     * @dev Reverts if the `tokenId` doesn't have a current owner (it hasn't been minted, or it has been burned).\n     * Returns the owner.\n     *\n     * Overrides to ownership logic should be done to {_ownerOf}.\n     */\n    function _requireOwned(uint256 tokenId) internal view returns (address) {\n        address owner = _ownerOf(tokenId);\n        if (owner == address(0)) {\n            revert ERC721NonexistentToken(tokenId);\n        }\n        return owner;\n    }\n\n    /**\n     * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target address. This will revert if the\n     * recipient doesn't accept the token transfer. The call is not executed if the target address is not a contract.\n     *\n     * @param from address representing the previous owner of the given token ID\n     * @param to target address that will receive the tokens\n     * @param tokenId uint256 ID of the token to be transferred\n     * @param data bytes optional data to send along with the call\n     */\n    function _checkOnERC721Received(address from, address to, uint256 tokenId, bytes memory data) private {\n        if (to.code.length > 0) {\n            try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {\n                if (retval != IERC721Receiver.onERC721Received.selector) {\n                    revert ERC721InvalidReceiver(to);\n                }\n            } catch (bytes memory reason) {\n                if (reason.length == 0) {\n                    revert ERC721InvalidReceiver(to);\n                } else {\n                    /// @solidity memory-safe-assembly\n                    assembly {\n                        revert(add(32, reason), mload(reason))\n                    }\n                }\n            }\n        }\n    }\n}\n\n// File: @openzeppelin/contracts/interfaces/IERC2981.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC2981.sol)\n\n\n\n/**\n * @dev Interface for the NFT Royalty Standard.\n *\n * A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal\n * support for royalty payments across all NFT marketplaces and ecosystem participants.\n */\ninterface IERC2981 is IERC165 {\n    /**\n     * @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of\n     * exchange. The royalty amount is denominated and should be paid in that same unit of exchange.\n     */\n    function royaltyInfo(\n        uint256 tokenId,\n        uint256 salePrice\n    ) external view returns (address receiver, uint256 royaltyAmount);\n}\n\n// File: @openzeppelin/contracts/token/common/ERC2981.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (token/common/ERC2981.sol)\n\n\n\n/**\n * @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information.\n *\n * Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for\n * specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first.\n *\n * Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the\n * fee is specified in basis points by default.\n *\n * IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See\n * https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to\n * voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.\n */\nabstract contract ERC2981 is IERC2981, ERC165 {\n    struct RoyaltyInfo {\n        address receiver;\n        uint96 royaltyFraction;\n    }\n\n    RoyaltyInfo private _defaultRoyaltyInfo;\n    mapping(uint256 tokenId => RoyaltyInfo) private _tokenRoyaltyInfo;\n\n    /**\n     * @dev The default royalty set is invalid (eg. (numerator / denominator) >= 1).\n     */\n    error ERC2981InvalidDefaultRoyalty(uint256 numerator, uint256 denominator);\n\n    /**\n     * @dev The default royalty receiver is invalid.\n     */\n    error ERC2981InvalidDefaultRoyaltyReceiver(address receiver);\n\n    /**\n     * @dev The royalty set for an specific `tokenId` is invalid (eg. (numerator / denominator) >= 1).\n     */\n    error ERC2981InvalidTokenRoyalty(uint256 tokenId, uint256 numerator, uint256 denominator);\n\n    /**\n     * @dev The royalty receiver for `tokenId` is invalid.\n     */\n    error ERC2981InvalidTokenRoyaltyReceiver(uint256 tokenId, address receiver);\n\n    /**\n     * @dev See {IERC165-supportsInterface}.\n     */\n    function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {\n        return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);\n    }\n\n    /**\n     * @inheritdoc IERC2981\n     */\n    function royaltyInfo(uint256 tokenId, uint256 salePrice) public view virtual returns (address, uint256) {\n        RoyaltyInfo memory royalty = _tokenRoyaltyInfo[tokenId];\n\n        if (royalty.receiver == address(0)) {\n            royalty = _defaultRoyaltyInfo;\n        }\n\n        uint256 royaltyAmount = (salePrice * royalty.royaltyFraction) / _feeDenominator();\n\n        return (royalty.receiver, royaltyAmount);\n    }\n\n    /**\n     * @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a\n     * fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an\n     * override.\n     */\n    function _feeDenominator() internal pure virtual returns (uint96) {\n        return 10000;\n    }\n\n    /**\n     * @dev Sets the royalty information that all ids in this contract will default to.\n     *\n     * Requirements:\n     *\n     * - `receiver` cannot be the zero address.\n     * - `feeNumerator` cannot be greater than the fee denominator.\n     */\n    function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {\n        uint256 denominator = _feeDenominator();\n        if (feeNumerator > denominator) {\n            // Royalty fee will exceed the sale price\n            revert ERC2981InvalidDefaultRoyalty(feeNumerator, denominator);\n        }\n        if (receiver == address(0)) {\n            revert ERC2981InvalidDefaultRoyaltyReceiver(address(0));\n        }\n\n        _defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);\n    }\n\n    /**\n     * @dev Removes default royalty information.\n     */\n    function _deleteDefaultRoyalty() internal virtual {\n        delete _defaultRoyaltyInfo;\n    }\n\n    /**\n     * @dev Sets the royalty information for a specific token id, overriding the global default.\n     *\n     * Requirements:\n     *\n     * - `receiver` cannot be the zero address.\n     * - `feeNumerator` cannot be greater than the fee denominator.\n     */\n    function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual {\n        uint256 denominator = _feeDenominator();\n        if (feeNumerator > denominator) {\n            // Royalty fee will exceed the sale price\n            revert ERC2981InvalidTokenRoyalty(tokenId, feeNumerator, denominator);\n        }\n        if (receiver == address(0)) {\n            revert ERC2981InvalidTokenRoyaltyReceiver(tokenId, address(0));\n        }\n\n        _tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);\n    }\n\n    /**\n     * @dev Resets royalty information for the token id back to the global default.\n     */\n    function _resetTokenRoyalty(uint256 tokenId) internal virtual {\n        delete _tokenRoyaltyInfo[tokenId];\n    }\n}\n\n// File: @openzeppelin/contracts/access/Ownable.sol\n// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)\n\n\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * The initial owner is set to the address provided by the deployer. This can\n * later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract Ownable is Context {\n    address private _owner;\n\n    /**\n     * @dev The caller account is not authorized to perform an operation.\n     */\n    error OwnableUnauthorizedAccount(address account);\n\n    /**\n     * @dev The owner is not a valid owner account. (eg. `address(0)`)\n     */\n    error OwnableInvalidOwner(address owner);\n\n    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n    /**\n     * @dev Initializes the contract setting the address provided by the deployer as the initial owner.\n     */\n    constructor(address initialOwner) {\n        if (initialOwner == address(0)) {\n            revert OwnableInvalidOwner(address(0));\n        }\n        _transferOwnership(initialOwner);\n    }\n\n    /**\n     * @dev Throws if called by any account other than the owner.\n     */\n    modifier onlyOwner() {\n        _checkOwner();\n        _;\n    }\n\n    /**\n     * @dev Returns the address of the current owner.\n     */\n    function owner() public view virtual returns (address) {\n        return _owner;\n    }\n\n    /**\n     * @dev Throws if the sender is not the owner.\n     */\n    function _checkOwner() internal view virtual {\n        if (owner() != _msgSender()) {\n            revert OwnableUnauthorizedAccount(_msgSender());\n        }\n    }\n\n    /**\n     * @dev Leaves the contract without owner. It will not be possible to call\n     * `onlyOwner` functions. Can only be called by the current owner.\n     *\n     * NOTE: Renouncing ownership will leave the contract without an owner,\n     * thereby disabling any functionality that is only available to the owner.\n     */\n    function renounceOwnership() public virtual onlyOwner {\n        _transferOwnership(address(0));\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`).\n     * Can only be called by the current owner.\n     */\n    function transferOwnership(address newOwner) public virtual onlyOwner {\n        if (newOwner == address(0)) {\n            revert OwnableInvalidOwner(address(0));\n        }\n        _transferOwnership(newOwner);\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`).\n     * Internal function without access restriction.\n     */\n    function _transferOwnership(address newOwner) internal virtual {\n        address oldOwner = _owner;\n        _owner = newOwner;\n        emit OwnershipTransferred(oldOwner, newOwner);\n    }\n}\n\n// File: @openzeppelin/contracts/utils/Base64.sol\n// OpenZeppelin Contracts (last updated v5.0.2) (utils/Base64.sol)\n\n\n/**\n * @dev Provides a set of functions to operate with Base64 strings.\n */\nlibrary Base64 {\n    /**\n     * @dev Base64 Encoding/Decoding Table\n     */\n    string internal constant _TABLE = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/\";\n\n    /**\n     * @dev Converts a `bytes` to its Bytes64 `string` representation.\n     */\n    function encode(bytes memory data) internal pure returns (string memory) {\n        /**\n         * Inspired by Brecht Devos (Brechtpd) implementation - MIT licence\n         * https://github.com/Brechtpd/base64/blob/e78d9fd951e7b0977ddca77d92dc85183770daf4/base64.sol\n         */\n        if (data.length == 0) return \"\";\n\n        // Loads the table into memory\n        string memory table = _TABLE;\n\n        // Encoding takes 3 bytes chunks of binary data from `bytes` data parameter\n        // and split into 4 numbers of 6 bits.\n        // The final Base64 length should be `bytes` data length multiplied by 4/3 rounded up\n        // - `data.length + 2`  -> Round up\n        // - `/ 3`              -> Number of 3-bytes chunks\n        // - `4 *`              -> 4 characters for each chunk\n        string memory result = new string(4 * ((data.length + 2) / 3));\n\n        /// @solidity memory-safe-assembly\n        assembly {\n            // Prepare the lookup table (skip the first \"length\" byte)\n            let tablePtr := add(table, 1)\n\n            // Prepare result pointer, jump over length\n            let resultPtr := add(result, 0x20)\n            let dataPtr := data\n            let endPtr := add(data, mload(data))\n\n            // In some cases, the last iteration will read bytes after the end of the data. We cache the value, and\n            // set it to zero to make sure no dirty bytes are read in that section.\n            let afterPtr := add(endPtr, 0x20)\n            let afterCache := mload(afterPtr)\n            mstore(afterPtr, 0x00)\n\n            // Run over the input, 3 bytes at a time\n            for {\n\n            } lt(dataPtr, endPtr) {\n\n            } {\n                // Advance 3 bytes\n                dataPtr := add(dataPtr, 3)\n                let input := mload(dataPtr)\n\n                // To write each character, shift the 3 byte (24 bits) chunk\n                // 4 times in blocks of 6 bits for each character (18, 12, 6, 0)\n                // and apply logical AND with 0x3F to bitmask the least significant 6 bits.\n                // Use this as an index into the lookup table, mload an entire word\n                // so the desired character is in the least significant byte, and\n                // mstore8 this least significant byte into the result and continue.\n\n                mstore8(resultPtr, mload(add(tablePtr, and(shr(18, input), 0x3F))))\n                resultPtr := add(resultPtr, 1) // Advance\n\n                mstore8(resultPtr, mload(add(tablePtr, and(shr(12, input), 0x3F))))\n                resultPtr := add(resultPtr, 1) // Advance\n\n                mstore8(resultPtr, mload(add(tablePtr, and(shr(6, input), 0x3F))))\n                resultPtr := add(resultPtr, 1) // Advance\n\n                mstore8(resultPtr, mload(add(tablePtr, and(input, 0x3F))))\n                resultPtr := add(resultPtr, 1) // Advance\n            }\n\n            // Reset the value that was cached\n            mstore(afterPtr, afterCache)\n\n            // When data `bytes` is not exactly 3 bytes long\n            // it is padded with `=` characters at the end\n            switch mod(mload(data), 3)\n            case 1 {\n                mstore8(sub(resultPtr, 1), 0x3d)\n                mstore8(sub(resultPtr, 2), 0x3d)\n            }\n            case 2 {\n                mstore8(sub(resultPtr, 1), 0x3d)\n            }\n        }\n\n        return result;\n    }\n}\n\n// File: Saturnelle.sol\ninterface IAgentIdRegistry {\n    function handleOf(address wallet) external view returns (string memory);\n}\n\n/// @title Saturnelle - 929 Lilac alien girl explorer with stardust freckles and a ringed planet hair clip before giant Saturn for .ai Agent ID holders on BNB Chain\n/// @notice Each wallet gets its first mint free while the 304 free pool lasts (gas only).\n/// Every other mint costs 0.00005 BNB. Max 50 per wallet, 929 total. Collectible only, not an investment.\n/// @dev Art and metadata are generated fully on-chain from each token id. No IPFS, no reveal, nothing to set after deploy.\ncontract Saturnelle is ERC721, ERC2981, Ownable {\n    using Strings for uint256;\n\n    IAgentIdRegistry public constant AGENT_ID = IAgentIdRegistry(0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F);\n    uint256 public constant MAX_SUPPLY = 929;\n    uint256 public constant FREE_SUPPLY = 304;\n    uint256 public constant FREE_PER_WALLET = 1;\n    uint256 public constant MAX_PER_WALLET = 50;\n    uint256 public constant PRICE = 0.00005 ether;\n\n    uint256 public totalSupply;\n    uint256 public freeClaimed;\n    bool public mintOpen = true;\n    mapping(address => uint256) public mintedBy;\n    mapping(address => uint256) public freeUsed;\n\n    error NoAgentId();\n    error OnlyWallets();\n    error MintClosed();\n    error BadQuantity();\n    error SoldOut();\n    error WalletLimit();\n    error WrongPayment();\n    error WithdrawFailed();\n\n    event Launched(address indexed to, uint256 indexed tokenId, string agent);\n\n    /// @notice Contract whose runtime code holds the artwork bytes (WebP), after a leading 0x00 STOP byte.\n    address public immutable IMAGE;\n\n    /// @dev The WebP artwork is embedded in this source and written, in this same deploy transaction,\n    /// into a small storage contract (runtime = 0x00 STOP byte + image bytes) owned by nobody.\n    constructor(address initialOwner) ERC721(\"Saturnelle\", \"SATURNELLE\") Ownable(initialOwner) {\n        bytes memory image_ = hex\"524946465e2d00005745425056503820522d00001028019d012a900190013ec158a44da7a527ac26f4bcd9801809636da5c8ae00db74442406da6e7d41186bff5e62a771ea2372373aabe17e37bd42b47ffbffd9ef3fde5f0df8877bb1e62b4549dffc29c909b3ea4f8bac034e8fb45c513adafdcf3774e3591861d748b0f154726d768cc277ab447a47467f9023af1343ecded221d7dcd0e95c60f9c0c5706baa78fdd2fec8fc1c7556f52b510907b4e129c288d728020ac69a0447b8433189e8c26c8e20add9fdbcfb36fb0735f27a1bde1ccd3e0486188cc07e60bb4565a2d7327032cb09b08beabfc6f135e26b918300dc8097de0353dc4fbfd7b6cfcba89896c17849d4363d2b76eab58ce4056e6695ca6b6b1472ae6c85045fec0f61f0e505018684867e046fe8ad9ed8085a8b54f96eb8b602082e478d196c7c5d89b516bffec056ed62dcea167a9aedac5e774cac484fb92e55f01f501d9ce2e02ab5279f14bc226a1ae5cb48751d87d8967fcd7ac00c3288e64e449a9f8581465891bb1d7c8f79895f9ead6772473199bf4e7f2d60664b5307e85dd62f59a14e13a2778d9824b01ec8eac786dcd22172362727dd5a02ea8602cdf53b5a4339060b00c2a2d45318bb43e5285e7f77fe9876ca43b29d10f2fac13757ebb5ebe7f351e94aaa09add6ce1b46793cafb82a71c30cc984e43726f2a4d6c5eabfcbf964e1b128b20720d7845c2e964d13187348ee36215eb71b9f69e3d7ac2c83918c50bfe9aac55714d41f01b5412f5ea1445b7fa513b5c164b8c1f3e31e6dbac5cfedb4a5afa0a3d0a7ad94ff50099e2281170ab7167331a2d1665a495c321b2aa9290020332be95a10727c8165d08a025396b6532f9dc5e95a4a2b317c23f3c5b40fd04c87ee6d12a67284e95658b2dbcf0538df5238c6b983421a4fe309f05d40d7eafc48d535fc79e39829f5f0562bad8129bfbb9a2110b688d043b25ad64868dedc1ee41ac93011ef8b89f3aecf63d6638802fe78a6e1dd52aadb8c83eaba134c9e9de715346a3e21f920d4bf0d1e80196fc02b4ba333d33678eb3923515b3a4cb43b18c73cd187b4b446c13b0dd5941e2c534614f4f5c8a103611a2b8a9bebd82d382bbbe06960a6c73d18941179d44eeaf9360e9297e75fdeebacd91537b18da1f29e2a696c720b238ff84bfd80bdebae14ccee926257780e31bdc44b2ea670d44a09e7629b4c6d2343bec32f5a6096de08c742a5c167ff62f445b3aa368f9308325583858533709d0e08ae1e528b701c06a1670a65a95ddd14c419362c316fd70cf66a355cf40d5e9e49bf8235844b6a64aed8c42664f8c7cfd0b6996489b15e250e684f2ce24d51bc58461107bc631e43ae74cf31ffa24644ef8b9b8e902e4dbdcda57e6706c30b33293abfc327a90d8f884b3591515f50a47896698b8d376d85aeea79704aecc3c958d3362c663633489a1650b2c36dd9a459952f3e841ea42eb0d02f2a6bfb74e6e81e7a43f41cdacc6708d29e713ac35bb4626658059887e2f840ba54b109c60c798ba126449326c1e63be2542491e270a8a44e7853951d7fc6bb85db20103ee80bda6de3584d7188b277d8a332576598ccd577c766632da16c6e3ba0ca2615f6ad982606905b643952cd1198b7ede66ccc7572399d56fe466280f0cc0e7350950583bce3aee98ad18fb4b9ff875fb146176883750d873c3df67d74e6e00e723fc04c403d3874a4d3f7bcebbc4f9c96360f0a6b296de557dfe4f06746a0501b1e55d27829434f5b670be99581777a5d62fc52edb59b9bbcf3d6047235b201968e012b29c3b0fe83f06ff8ef0d9fa0da2b28df5ee164cd4e5f507d67d65edabe167b4d347ce3bba703bcbae857ec0eae2e6658ee5e03d85bc1852bc30de12824c20e62ed8a0c42f5f6e53fa87e6cef7f608263dc494e7dd47eace78be5c6a13989c31d5602a591ae7f689377bf061863d71be788c16071a66dcaaf7d08dec39b597efdbf80f003a8069a31b1b49c8140875bf038c3345866f5ebc0cbd81b7e7e5d6157095d52a0238d56663c3e3bac1940940212672c6efadec013a6e4401b2da94243579bd94e1b2602c89d41c2a332acda84257eb426a44c617fd6ccbb73443aecc9d1eb2d733fa79e0573e0d69d9ef4be79e49d17a8646cac803d925917f66ed7113d635241a774e7fb1e230d48c8ba1058ac1e024f9e04e962727d51934a3a240dfb6892bf5eb548cfd467f135fc75cdb343f7fd2f6b09d88ffca3b74117c63ecef9fd465ba1091449334724dd32cd3ebd05d2763c7973de47bda27ece962ce647eb38bbb5cabfcfdea6608f40384d356f4ca97a06add7a284ef2c833afe746ec394dd38da56c290bfc4e0a10c44dc7ed3ee74b9c9b87a139917f00bf23b8f65a6581cbb0adaa2fca1a34279bb1b2d2bde2622deec714277b253aa1f82936113146c4b883ff911858f1ea919bbc92df4a1b9a82b5efe4762badf1a5555e824f2f363c68d113299a5a456fa6d3c0970fc74f7e762fbc365c91d97f1748f6852ab001b62220fd6cdd836a1dd38986d8e3d8dfa0c09e98bcbc95ae04540d1e8041eaf33ac49cdce8d682db7c6c6921392a0123bc7b848cc8a1c20297b97a10137345ed100149a3e8e5e5f2af4c4cb3bcb5ca505036956c722ff6f74ef9b514692751a788a0164ac61c32b2b3fe6d2adc6785012ffdf39dd42f9c48fcec9c4f02a457feb1f460cdfe5b8e6491406ffe646951c4b2fb2023c49e6aac27ffe694e75f444ee445a71ef3b55f19fdb4dbe123974ff99385df8d1346135b35d77f3827a3392fde462fc98c780d9e89a3d1ea7457d4d9e7fa57d0a56a45344451bb7d5ee7d9d324031faccc4d8588413d03081c6b88c0a49863021e692f27fe5faf7238896f0945a67bd4c845701c86f3c7bf900731417dca18342c403b3df2a336dbff49ff2924456620c4ddc4f69d8a520f1b69bd3a0e13e4231fdf5ad2e411c272b9a96665e9dc1eaeb710813e31fbf9bef033df70aadef8308764aa366c1239e354e4e7a77d3f33fefa186ea70b37e4560328a85afe46b7f06ab55b685cb6a30fdf6cb3d15e55152b2f8b7ebce94e046bfd812f1cce2bd15925a5bc79c900ff3462f37bde8affff2c8816523d077a47839aa55e60337a45f5bfbc07fec48f5fa455543a41271f1abf557513691bca18b89fe414ca73677c2969423fea930cc3d0fb60d26d4d46a93889930fb790eabdfd0821e9a7444733375580c107e938db800ae11e9299cb273aa3c33a2213a224229defd18b82441395b312b693fd53098871d2fd41e65205806f1d89be606f0c05024902c2bb77a1edde76bb2120d17bb6d364805dabc2f18771237086ca650e3a069118b98000000fcda9ba4e7d55103dcf6624406fa65078233eefe179a0ced6a55aee0d3757aee11cb3468f38e9f85056d0f92e30b111b1da6f8ac89e2c68fa5c9d6c2265ba0cdcd7c917b83e9139e9c1da717b59c7ece778a68ae57dcb7543c1318c41e48f4f0723cb352ea8b57dff7a48dd7ee380de3e3dd70e728af2e6b7383302a0dbd6c16a4c9879c303d06e8c1052c0a825207d48f8a0759431a80df0af854db581d680408bbf2fa86ff171c55e18ca28b08ce045f55f76acf40f73f91931efda6fac3e9df9546a42612c4ad8124684a5646c7b856ae84be356ae15c4c038632596bccee2faaad4f3e498dbbdc5898e15030f1bbd074a265083fffe08249252fe683de23def5e77568b9a3394b54eb7bcc4c2bed4223a6362b3362a3997101d8cdc13c28767073b2c4767cd17e2bb3675cf707c24cb738304de9331c7b9bd0018e0dbfef25b481d98c8c446c3c81d384639b256182d32c7280bb98907b795af624ba84178c7d858afabbb5da5a335296e029e3f6a0815b76623244538f85a3fe87bd070c0d07d947169b48a99e44e895daf725c6617c3e1374c1d3d53ba147de3db38cea14242dde0defe1e5edf6ca198613ec00a9e4e160620fbaf3cbdd0390d79e304df1a1cafa06a580e4a2657383150a2cf9b61ef88f06cb89eae7f9fac37c1346e36d82e8cadbbaddc41e55d04980ebcb9b7ca34f70cc5c8ec640e0db1889ec71772457f084a3c6b887fed177234ff0a77667724cdb209121a166951412bf157440881432c31f5464ee7a35d1956c0b6a93028e822320cba10f679e55f427b75a2a2687bb43960650184b0ec5eabd688451e0921c6c66feb0eac642d4ade0bb93264e93d2a17766499cbecc5d68fb5fa0cdcca73eabc33411c461394f90555fab6b222a5be4c42c2e8f0181c851a7b083d2a96990ae2911311a1248c0bb79838bdc54ed4db4d289876a055f82dd7a291da1f5c20d3ff8fa6924df1b9e8c981962e7471ab496ba93fea62d3c3bf93f56f1292b1ca3efe9ef3227137053557ce95843dcc85ad79e1cab0b42f9a5a57127d5d6707c50e5c6ac23d5c7a7a9eb79ad23c9215a94f559e81b158d2e6d6d2e4a9ce3638fc1b7c956156a17b38759f112656a97d3f61a0d02a044735a7ddf29d9589bd5a409fd6ca8dc7d0e9703690f0624101b64a16f7ff2f8c0a7652e5ef88ecc1d5e4421b5998969e4d51232f73eade88a17a058ddc2d79c5a23f2578f6b28daec9231801bf3d3c8e6d5071583316235137cc683849488fd3f5636d6e75a4a6949c3e6c4fe6ad3e70e25ffc3dbdd66d4c856b74f3f79ce9c4a7c5a6c4a068751dc692b7bc31aef94322fed25e28f4d85f899a22f0abb258207ee4b3d436680fa329157c161ac2942ae782f5f355d86e1d8961bc305649d67935f17061d601ca3e9101d77c2dbfc498f497032009dccd531a900f22fba011f5f28b655cefad63fdffb11e9ffa2755c056e7728b36fabba45cdcca6f5cee57926679e24710050da2f51c04633d1829169394750c1cc7192ec0dce82393615cb19686d6ba8fc8b9233896ddd17089abca4e3395ba7325ec4aa5b494aa172e1756588a465b897c29486c3b1bd19f90be2d2e8a8339df626751363218512bfc5f9032f68261414c0757ba46c016dbf37dcd6d46a473ce045f5d3e3263aced5fe634041c1b3c17adef2aeffdb352df88acfbf3a277c4546b59370b48ca1e0707d88d1c964cd2b5ea09fc804c4ade16154ca097a5b246f67c6ba13209e509c0a637f507da5a86d9301876f0c82e8044f3ea9ea6dcaf63acdc6011a27a34bda16aa42421893087db5d47d84570c38a11e993fb7754a89eee59bacfd1b33b08251bfd98fbd5d3d5a4946a7a05d6f8a3597af719c7e4de1f0f8fd4b8d06744b734a8bf598c3a8d0c17d22987f133e5d2d5db0cedf01e517515e3c7617ab2e0ef9349ba7b2d98e4ecea97b532838ce70fd6bd43a75371a23404c39a41c4eed409d08df27a2e3999239d98b8ce6fc048a6de5d22c10b736370fe4cd68d776a6d6cc7c3e8f3d9944c5d5f3e2f6e271bcadd8c0ede6b6478871e53c8fa4c2b7d486dcc6eb59d896bf5d92e65ec5ab0d280af54bdc93883d40bd5b232c46c070ea3d19f906c616115979c42eee5c783cabfff99b86ab6949dcdf986d83b18d0e308a921140389a19e2f30e0670604f1f63b6cee686548c48f3dacd3b1eac9cc56610a717f705b652bf72338554a3b555bd50ddbc41e3fc330d4c5c43fc9424139c44e51a2b846e2d758040568a009974469bc5848768408f144a1ebf38c657e4291ddad14af3af29ec0314cedf15f84fc08613650bca58f0e94cbf0bd22dc1d16eb14788a35b9190143b4e370a134083bf88d391c19a12ed500fb93dee4ea77e7e38895e7013f52ff94c47a275cab42e17e1623954ec6b514f3cc79ee0c1fe0ce2cb6195f7fc10e94567882a9fc43634bacec7072ea4557fd8a13fa6878f4c10a7b34aae3c6964819a379f4000a2c8dc9b8871e7b60413a5bc5c0c757347dd4f8b02b750f32340ef4163baec648a26d99a720fa06668590ef25ee718529951bc81bd1c4a9e4db856a56dad3f00d7d80b1659d0401679366663a61819c5912106762f1d9ca08f00da2c219c4bc7339705e0b5e9956b0a5459ebdb4bab5dc2595e6d425d0ebcb13ba74c38247c8921e522b7f6a4b9aa0c3fe6d4b61203d044b36fc3efa892746018d889f4c939a5fb4f49b6f1d2321c568557e938b5c7c9e53684348e46c428fa52a00ecc3b37301050ef98f4d6016e5b0d5838a2e2bf27463c48f59bb0be4b43e8f9047e4c9f2209821088b21252e9b8bd42a0ab055276626d17fff78311a19757ba77c85573981f58e93c4555499298a61c554e494622e24ca35d34687dbae81dbc378dbc022eb87e022e6e3652904c7276f4dd132b50d46f8bb4d8708dcf97227d2494e4d0dc204aacc4e4c4fe45c05872b2daec0be84f7f0d7750f807b0b4d779b09ceb8889b73471823f569b8c8cc40ac1e14b1d80bfeabf4316c87d5d3ea3ae050bacd8fe63928d0d85e7abf16a1d442c835421024a572260441114fc8d79ed9f76f8c83b636b7c4bb10605e3555153c23435c405a6a1fa2816d70241735a447db22f08dcb9c5024518bbbfba4262073fd591aaa4ae91e153038da3767facc3019838e117c53da4dae0da76f17b4bf13ef084f0857946094503d3075cb97d869ddb18396a3e45f918dfe7fcb3ed6bb4b99894eeafd9af8abb8d7b625d2bd3f9367fb928da7e1063c7b66c1f54bc36f09cc8416978d99055a48c33f037d77caa0e3915b59f4bacd36e75054839522c99d5c5d8ae942b7fdb87242887e4a8c41bf07155af0c5787a9b813402826b1677943748537448fc69f0af8662dce2d8d560a9bd2d8ccaf9db4a8c54d826cb8a5167a85c93497e468b908e118668becfe26c796b37071d0e344e50b3b9b08bb237c43a4fa78d57604e59c16ea8402dcce025e6ccaf797bd6320140018b8d0f6a12552488cb8b2b2a896aea28b81c37d5b7f201bc7f6763b6cf9075080c8d5404a469edb441162ab036262a0cc8a6fabf2e4fadac9ff43349aab016185018196fdd61e7f78cb590d9c64d6cfc893d2d72e080c172b46790c7f337be6bbefff6148836fa4e7dae9a640a3f9f28cb85d7bb0909cfab786a67c1d4dea54f42a55749a48e6f3310c79944e3b9ce396b720878fefdd524e0c79d4c9651d13be771f8aa779071ae7a759e66f35754b0d61cca97388d8d3a5f2a7acf89fd856171d9fcb0ba2ea3cb6ae2349c3d981695a438a153a5e5e0509881a73826b8cf72acecc8dc508a0ed66d0d48f32be38065ad6bfa361705f1ab72b8c82acf063316dbdc6fc34a8c5068f85c0454fc3755cb1de0a049e9075ae5bbc7b78179fe27d64d26b3691e580b5f9872cde30543715fa0dac18787efbe89575d50a456597b9dfac52d046db2d8a57936521787222e8d5ab092f10c17e4c99cab00a8e19c6020c188e846b8cfab0884165e3c67314d02fd86aef8c338e5b106a0b8a3288c96c3270c4056854315778bead4081688c4fcaddbfc0219e91e660ca91beda82a2175899dbcbd6ac18d490735b54b29d821a53dc9d91dd75ae984668b587d7c55726e7b969fea13d1da57788c9320047f789724809c613c5e107518a1847a25c5e9a6430df448e1b5ff9e4dae6516b8f558981ec061ff4ede801dfca183303addbaab9a215df48fd45abb3e3f5c19aaf68524682c59a942772cee482db3250209fc0036125d9d8e071c6a4acece011389c0c0be4164d45a9befecc5d690647f5fc53e52b77b476efee78686cc5960367e8f3b2da35387c2f141d4642ddf6bc6f238f5038dadc94bc9379bf5e00830adce9a4c7fa8cecff87bc1c9ff754e6d0f27ba4a0afda904af709890b362b6a2674e62a5717477d092bd853b9a75e26ea8766baef82bca08a341a8611293cc15c90986c287b9a320fa319d2e5c24abdf6fa9b7296f1f3a0ed334b59673d5f4e2913a0b4976d145781cb776db0f9398265e849c2469a3c8545d232b1ef9c088e4e233af4fd78ead05265952fffd3d3f0b8bab6d845e68f78d97935d61c15929a22a9e26bd11364ee0b8b34bedd245152e535355ba810570e8c52cd40a98d37fb0e3e6b43ee0fffcc5dd2835dccbb036fd0bac028cf5e94426ea6f7d388f1fdee5a72a8d2f64549832d168050293f3708bbbaca55d0dcb20b27c74abfee59b0d0df04c9e9af98097861a972f111b309bebfcd6eaf94a6c74c4eb8374502a12a5f19ebaeaf7136b79a0a5f4dc787a204dd86f6d791c8ede0e204f6b7542749fa80b76d50188fcd12ba2f6f7cc1518d172a75f3864e4f1d0cabc7ba76be1238f8ecfc58de0f3b08468413e1c702dc01a71d8cf21c7342d795b92a1abbd664c2dd2da7322f7e8ba909004f8e9df879be6111cd29c1aaf95f294d6c683f2ebb19c8b9b9d2212bf1d5a42d26bb1eb2de1d475dec926be216ae5a6d9b862c47d8ec9807c40078c74b058bfb5feb22998dc3368115dc3ea13ea66d2bf9b93df69cd8afb75236fa68396480d3e0962fa9f5a37098501b21293046b3f93c5ed577b8bdbc9e8ab9d8b4dff5a64d793f32f3df89998d904f866217c0f6fb6c8acfd8b318e41e24d4c54d12af6814b84646ed56188e9bdcae73d72cada70d2e5172a1e66b290f57119f97890c3eadc272f02388b4a699d2e5822c3faad2c0b7770c94ee355f36f04e80eec022220ae94de7ac83b1766215c56ce4f1314e874015098ac1745acef38aa85f234c8a7448131d69506fc3060cb891051533132f5f5aea5d58336e51486033c62dc5eaa12335d1ae251e300a60e6d5d25ff7a21d395a1814a14ce8afcc886e2ed7f17231f7ec20f71b338a0b0fae4a9992f87b1085e4a93fbb719a64538df14bf9034ac39f41268585009df466179ec2efbd8304b5185ec7783c4f072bcff0bd0636f598ed07c7c9765c8507a24641645bb6dc49d48202d62d1e18ee96feb29eea62712189fb2ad51f4348a778b336896ffa509b06e8a9c929e008d1ae4862cb03fa36f19bfc7a50b5eac50b931f2ecc974c019526439180e1cf2183e40d10ce4f38309f25f2ff438e1e68f4e020a62b1d9a543ef5278feff2bd3de156b0de186db220286fd1eb587d92c29613714a276fc969cde774160e1497681ffac2446090dc66a59e903176211af1b79ca7ea07e71e8cea90c3aaf2411de477d39f9726475cab784df7c4f277cee0d02074b48440f286a30cf442273fcb787d0f1d313059978fefc3005d712574180e36852724c7f9a8a7fa2544ba700f1829a3d10d6652c5bc64cfda115ef0becde0fea01403283d1e585ec439cb31b6fb8c70955b3b6e13af1dd079d7d8a6dc0eab39f7a1ddd5dd2694ce09f4364faf06271e0df1ba5b14e7433c027f826f3be119661f163b073853ea9f11c5ba47fd67c0452e451628620fc96bd8839bc789687c7ffb4f62520092b655e4dee2b053b0dc9d064cb1ef7c884e19980afbc1c4377d2f70035ee4234e826f0cb4cb1dfab589e2644f75f4754dfe4b0a05c2ff83318d8e89487c4066c5446e7069a64a4997b0f64cf3b7b9613cedc5a6fe3db08fa6ef773eaf25e2f04d908a133a811f5a34f9461f855843c98ffd12422ad2ee6706f7866ff0fddda24f539adadc35b279e5091dea262e73c9b3b06a51c03719394c363cf86193e0ebeb71ee7ced5da180b530ca8c8931bed327d8944c05f3a363a597f4c11092c87fa545611692dfcb6317e9b1feb483d019a4f111fa38bbce950616a05b0142d73fef1775ca84b93c588571f984676466a740929d2fcd1eeaefc2767652e4071ad0038550d973af4223ae19fd1f3c90884b0334f273dbd3894ad5cf86ccaa62eee9d08843848e64eb72a22cd37414e8284770057bd14a1d8661e08b924dfdb4c892b575ad84740c93b8be0e726dccc25dc81273fa2ab5e0f1e12ca66d8b1792ebe55945be4c832b10c8976668ae5d4a84aee3281da72b2734d113a3f9519cd10b7e52ae8ec87ac936c32560e8420052d0f8c2fba199d9b1f29078f5e16560c8713db54b83c24084f9b7a6d321c7704e30ee5c870c636f90b0b62b72fc2859527ea53fe3f27804a6b4e99031b8701b142ca0007fd377761ca3cd3862552c2911650b4c10b8a58b727d3577a0785ef970e5a3814aee5b4d779fa093b2cb12ef5845874954f700090ab6e2615f29e11121a387a66321e2e00591ac350c33c62a3fa76741bc0cd63e0e43dd2d4a17889e728438f2f31395d499e6122d55371e5ffbfe8f63120f4b461c96be900db148862dfee1df8ce84271286bc56f00acaa266e4171156ac62157c6ca2d8cfb7e039113e77caa2eb5e2a6a1724e11d53b150257fe19e14524e8cabbb87fbe7c7b1dbba5db390642ff070f2652a2458de33868272c859fbfdf6988bf89f7da2fe4b7f232da3ff8511da9148dc1e1aaa662deb3e97daac8ec21688b5a5eeef62bccdffab45400c5143e072e3ca099b813f5bfc4b4811ea3a09145d63f2e6ee2af2c15f82cc86a152b4170898ef5abb8c7857eb032fe0bceded727c897f811d27c6e0bb705e07651d0385c4291688ddd1a543b058a3285a3105bac7859634c414c082220f86b7f415807426ce28299500fe1ec3fe923f77673829c287ae39c84a7371420cf147ad245c98f5c2ef33ab1d9b163115a0dd24ebddece5cd644489094547721415f969de3eb4170fa3e6c401f80b99819e8613ed0cdfdfffe31d9fbd5008847be6f3aee16e236264deacf35c2d29b53a9f30de0082b638b043fceea40f35d9e534b75fdf6ef3b9f7e60b4cd2a100e01783932c8a9b71c6b39250126ccbdb26194c1cb63c9c216eaebca86126c93a274a602ddd1378f47c118eab108db827a5da306efa77c262ac45be5b1a92a821ece9c2bfc5479c8fa0ee8ac0b63225f8c678a0f3419bba2894ba08dfb984a2172d84c12e050e7057369451e3c83eeb30cd0f1cf19718b32d4c251385d6b896c0a55bff3126d8a2304623563b8ad9fe72e8eff36e04a59c544d815017033931081377115d2e85bb5845466c60ef5e327fc76b3ed1de7d000c78b844ebac35d2c27c20b6cd5595c05dbc906704a6cb8047607117802b78b454b95d0fdbcbc62f0d8ca05f06e998399aabf4b7994eb488b3738297884927b631983b8707d1cc0bb61bcb7dba962d53f635c26d5af6cdd1a6f56bc29e9a74768e96ae58eaa5c11dea0cf12192eebafcd8e138e12d61091341fde749073df7109ab61741cc37b509dab0bb3b74cf64ca9c1bdbdb04c8c56241c979573ce7a3ca6ec3fddabb5943ff6e68b320e3f1d9a2fe00a047b0d5e7153c073437608c014b31876ceb1fde70fe1d16cd1b336407b8f94775fb9dde87aafff45d0d132ac0a7aef64b228853b24da4bff1f37aecef347edd212e67343ebc63857b8af3ea1022da9cfd2779cfdda77ed2094a8b527f3d9e915f0beed96662095e2b47f27043b042fbf9bf91d66ac333a355725aa26e0d9b24e5fe3b2ac66a07c68023f40b31b844e3c1874df1e35f430987679b3c43af1166537447eae074fcbfcc3c14a2d4bf58ba36fbb7aa62bcad30eb434c700386d5f841a7a13ed4dc6d823252e9adee1946ffbcfaab15544f6b5d9354c7ba19aa3a6106639de2681e2ef2e4aa619fc3bc4582fec86ab0b3731e4ec21f889b00346e6a4f3d15b06d345ec4fc7fc33c77f817fa64cab117d1984927727e42082883f391eb2dab6e73d59b487572f9482f91b13cfab31881d5bbd782efbcf9dcadda642e107d2c00efd6ae0cb8723963bb0423cf77e83bf295ce52e6cbfe0181b4a5fb46ae50323007c95061d183164776bcc84b738ef050577eeaaa79dcc7955c077583a41ae74fd15abef1b91001da2beffa24465b05689709407624364176c91e5dcf516ce1adf31c4840804bfb4a66f2d29367fe4ee706e441865a92ea5967d99a47a16d787767d406f5be0bc4c61cd3254b452f9ee8aa85496d6d22770493c0342ffc262bcf2b3b187d672b576d9492a2652d67348ba1163b6fb013afb64ff2fd6068a299b09441694d91707ab37d6f4200d3fa3148cf34b82d38f9ba7c4943e8427ff6fb083c69f617041591531f7b013fa1867851cfdc577d1fed2b9a0d7257a367a5a05cdd0377c01ae7a35da8f887c8db203dd5e2569288a85d44898b04ae70f8fc5f0019fd5920454daf80af938130b1f373ab2251b7ac3f70b2fd84dec4e5a7449acb99aac6751eb545837ef8372b9b871946766892872f2db5c0de39357e43c4d8e9732c8ae27433cd27ccfbaf934b51163c662289dd7df0c564ff9ca4778ec201071e97b83a985a2c8665997f8bf2db7ef58eaca60c28eb38325f3b779eb866a3a022dd6d5a124414e9f76dd00b9200c0b3d47991b5250c0c9479a5b9718a707cf1dd6fbc4d271450f415b605e2b6eedb27a77e99bf8d870f8712b956ecc6444adc0daf44d597b2027e8b4b7149c47ebe20e04a2072e1e2fe0d39b516caf0eab6acebffe5e4a4dc2d7a0be209443f7d21c83e4c964b312b63f419fb8b237789b99e8bb3d2b854ebf03caaf89c5015cf62cfbf08465456867dd6c9d2f0d3e8f37cb214f865a87a597aca5aa3036ee781ed1833e4835dd5783cac622aa0e6601828a68c96aaca34b35044364daee3168f3fca21fa9e88240eecae00d0308c9ebf69746f89c7c8a8b8d224ccda8c835036c6bb585490b3d8fb183432cf9d46b0a101e6b25e33bb4d9ed9f940756786587de21fb7bd6bc2fa95ebc750466bf4c6f195e731660e005f693b113b1ab2a94c0823289e445ed79573ccf491210f732801f3f7173040dd8426c6a709aef0529ae484e2f87c606f4ce4f1a309458bbdd8d228b0e4ed823956b599ecb66cd03ed7b689f7d5f796022ac73e9baabe2f0a692d9c238ee064c8363eb3bcbfb049f0c42d7d0c4debe5430386a00fc76dc72b4c7f004bb06299f0bca2d8ec4ccbabe97ec096a44c20796e1602bc52ca49c569f20d6e1e1c30069b726512351762e657ada021cb48776d3eb9ffa5b5e33ee74d7571d5822bc80aa04184d0527991d30c386795d5165e04be36f080c175e6c6870af53d1057cd2b38baad8406250904c48e0596609f64ea97156bdc79cb69206658dd18576fbdd6915214caff29b1f32d015fbbd3f8d096537ca3070d834517dc7eb5ee1e2676803d4ce9c13a306511059e1535f4b6579db82107eabbab8c57d57e6e3d7890013bf372576a9e79ee6d6de1cb12085322e55fab7805e2ab60c75760aff971fa376366bc7ab3ceabfaef357e8beddb2246803c4a6d1208d89ebfe2bf6d749a61d6529d588c62aff20c75e2dee4e0bc4929435ed338ff32e50523cac447c3ca658f0b57f0b8dcb7a4e6494ece23fd4c2018aa2567d9b0b41c48193642d3d5beade673c2a53b7189272f394e1dec5c6354e524360124b33fcf2b43a708b504a23b28bafb734d2bf0786781ed43cf9394aaec33ade1981a11d25fb7c7379266e174a296c0f8be7d9d57a00031bfd7506addd2aa67192bd76a8f30ccc5423e1b917577d990a3b74973e94bfc15008de0cc9b2330834beb7bd666281c13485c57dd4a5d92153f69705c819b77dffaa70a7cfb196f12c6efd9e445c20ff62340aca5749444c828c4a593feacfa43900995d745c9261c59c9fcc9693f8dcdb23e0913119a748b05fbde9d7837ef49bea01c07d3b828c1aaf3b34bd34ddcfec08c2d244299c6223dacf5085bb1fffcb3b29e141ef918531a6e9ddeacb3346849aebbddd2100a72b7abdc11cee33a55305bd5e929d72e3e3e59f1a104ce13a1f95982f24530472a5049d959297de3b6a141674c50146f1a7d77d071d540fe2e544a152a409833bc17cff6d14aa38c376f129dac5a29c732bf5ccc6a89b13c86969eeeb877c92dd1608deafc97ddefb9585e463d7ed0df941a0b9affc86a6cbeaebf4038278c971d1115e427273c67b14294fac30e79ab5609b5bb6172f34e4bdf509e9e912f07010702f9177dbb8d7c723359641f4e6aac425827106f275825ab820eaf37c3b47ce295125162430bc4952d2f2695f13792462f8f887ad2de1caf554b5a2b841f7cea7527f6437c486b11f22fd74aed21296e6634a1fca00699555fbfd78975bdec1473956d478ff62bad22a140fed6a11cc5812f0760a8c9b1f81c29f4b71d8863d88cfa56a4430b71f53846b8ff51035ede22eea92bbcf7326febc7cf3372af66f8bc6a101655cb7e522158f8874b6a2a121e1ed4e79b85de91bc181a5347eaf59674cde3a6b8fe44e31dc7e292380fb0e0d5b6fd052b307b972620c5f39467a8e01bef14f56fc7552783456d8778de1c2d31856e206674719c354ab7d8c2d33eb75184f7add7645627622547c1a855c4565ac89dbc3d3d64ea169612c0d623ab8754851e6805f6feda49fbd2066a8e6c0993af58259ea3e4c6c60f4fafad9d4a6ce8f5ee9ebc52231cf854499f820304356c4858e897b06f304216f7a4bc3673dcefaace5a3a536fd2bfaffdbc116ddc7fc00d15b9c0edfce1d895bcb9bbcd08288489a8f428f7c68178d396ce60841e1d7503b22712bc85adca48259fb77396db773672fd18e8adf2793287b5d021bff47e66b3f699a51d990fed95b1591e4f2ffa8f66d05a843e62e0eb0b618896be40255533418d7f045b8a1a6a363fb514efbc9d9171e8d1c44ac35ca53fd967fddb348e16374824924040558482a39d620ee778135f5efee391eacb9db628442fcf044312f21be1bd3415002ddcc028ba5aef590590cff62f5b0d971f517809e5e463cf118e0fde7691b0a335a59802cb209936701dae04292379076f780a321a09700c8047dd9af2624680880fc09dfad8c849fc7ee51279bec2bc32dc1c5d3102d372537031d273ab69d604ab037e8a32202c54d6905fcbbf79ddaec8c5ae1a87a96912587dd4de012339025d89f93bb5b1d4f89f9f5a7452623e2b40ad57bfcf4f63aa35b4fc9631a7b330ced0bfc6d905d0fc227ad703dc151b58ce9149f9fca6140c3b69a7ef041a489e5a9ae30c731cfc60f0d96cf74c97331a5a7e304333614065def6e70a80fccac64631fced66b69a03ff07a03c890a0eef88b8d3f6d4456f3bb04b33674c9e24686504475e228aee12f23bd1d686edd121d7c11dfe84108b41fa97921374266ad44f4d0dd5bb759c4496edf700e739b310eb4d96a125854e0be22264a27c894552530c2964c2937dacc838b7ecb0b5ab92a687bd0d0580fca3aecb1b01cd3b92f875beb79cf2a5c849ad87e0629f5f2eda2b96298ae463f27b932d1c4e451ca05a81dbe8db532e801ac8ecfce705e70571f89dad0ca558cd8f9147903929e2f5a7a3dd3987950e6f174b665d64bde085c6a6e48203b2c9b741f16ef9ef731f5cd02b3ed405993c55aeee95cfc26b035af9820533762484acb9fb8138bb333dd9d2c5fff19bbb988808be5c614fc299bb391dd63e91ad66940cce10731f38467ae74a32b8523908f471a0df81eebcf22b0b7d4abce9e32c386f0263b39cf7a0748b8c7a1f6c1a74f225410c930b9573c6645fed10987146dae0cdbeb8a334bd53481fe02958ae97128dd35fb739cf2b97c09235952f9a314ba10616d63e3143e3040220ce37bf7731e10ceedb73efa1354aa6fe8e2efdbd013ce31cea80fdc9f39cfd0925a6e1e9d2b3f2b2adacdb2f75bce0c9407b4cd564a7cca06b46869edc315010d4a14f3f0b92f73b2fb2fee122656b4d2fa55cb8bdbe42b617c500d09ba8b4c18cced38591168c54384725d7cb8a0f1f5f8f53f65fc575f04e87b67dca72fd2df033df3e0ec7686f9f9af9b3fbe49607620cd44aac6d58f1b1deb5e256e802ce8d1b0ffea610c889b7d1714aa94bda6580ffacd76358a7872b5ac5a0b2aeb15156269ff7465710d38f38b5379b90a8b8a4ad10f62ebdc8129c97600e20c23117672c1293622c592fe96cb0058dd54583df71a8b36741513f1a09cac677091e2c82b66779c4ee6cc872d8343aea8819fc9928ba6906765a49c9ba531532893993f95baf53dd2e9050ab4da1898d2476794c800e4060338a42cb848e0a98b2e9c07a49ea57c302d1002c5e9fa41c02858a06d03c624da00190ca8f5456395f82330bf6b500b2b01ef3ab824bba012008c96104cff368bfa67730717d1c6aa99df8b9ebb3ef0c4a2890281ada6ab0cb0f9540c018076761b06c157b1a5c0dea7ce8a026d08a4a9258fdfa761980b002a85a68c2e312cae908ccaa0e039d62c29a1c74768b7a6eb15a9fd5d9f843e7e91eee1f29170a303061faf90ae160f5b752c796034cb1b8987cb6251a285774ef7ed2ed05f1e7fad0cddfad196a03f6fd5759dd60bfa8719e61f1f94fdd30c0410838e4c00390a920207366f0012fdf3d158581223c1299b43fd50d8c50ee5a7621d39d693bfab0c44d15fb757c8afd820f71898577467cbec4804fb96ffc9c4b428a058f1b2481c6971c2ad21790c2063f912ad646c7790e80000\";\n        uint256 len = image_.length + 1;\n        require(len <= 24576, \"image too big\");\n        bytes memory code = abi.encodePacked(hex\"61\", uint16(len), hex\"80600c6000396000f300\", image_);\n        address a;\n        assembly {\n            a := create(0, add(code, 32), mload(code))\n        }\n        require(a != address(0), \"image store failed\");\n        IMAGE = a;\n        _setDefaultRoyalty(initialOwner, 500); // 5%\n    }\n\n    /// @notice How many of `qty` mints would be free for this wallet right now.\n    function freeFor(address wallet, uint256 qty) public view returns (uint256 n) {\n        uint256 w = FREE_PER_WALLET - freeUsed[wallet];\n        uint256 p = FREE_SUPPLY - freeClaimed;\n        n = w < p ? w : p;\n        if (qty < n) n = qty;\n    }\n\n    /// @notice Free mints this wallet still has (limited by the remaining free pool).\n    function freeLeft(address wallet) external view returns (uint256) {\n        return freeFor(wallet, FREE_PER_WALLET);\n    }\n\n    /// @notice Exact BNB (wei) a wallet must send to mint qty.\n    function quote(address wallet, uint256 qty) public view returns (uint256) {\n        return (qty - freeFor(wallet, qty)) * PRICE;\n    }\n\n    function mint(uint256 qty) external payable {\n        if (msg.sender != tx.origin) revert OnlyWallets();\n        if (!mintOpen) revert MintClosed();\n        if (qty == 0) revert BadQuantity();\n        if (totalSupply + qty > MAX_SUPPLY) revert SoldOut();\n        if (mintedBy[msg.sender] + qty > MAX_PER_WALLET) revert WalletLimit();\n        string memory handle;\n        try AGENT_ID.handleOf(msg.sender) returns (string memory h) {\n            handle = h;\n        } catch {\n            revert NoAgentId();\n        }\n        if (bytes(handle).length == 0) revert NoAgentId();\n        uint256 free = freeFor(msg.sender, qty);\n        if (msg.value != (qty - free) * PRICE) revert WrongPayment();\n\n        if (free > 0) {\n            freeUsed[msg.sender] += free;\n            freeClaimed += free;\n        }\n        mintedBy[msg.sender] += qty;\n        for (uint256 i; i < qty; ++i) {\n            uint256 id = ++totalSupply;\n            _mint(msg.sender, id);\n            emit Launched(msg.sender, id, handle);\n        }\n    }\n\n    // ---------------- on-chain art ----------------\n\n    function _seed(uint256 id) internal pure returns (uint256) {\n        return uint256(keccak256(abi.encodePacked(\"Saturnelle\", id)));\n    }\n\n    function _r(uint256 s, uint256 i) internal pure returns (uint256) {\n        return uint256(keccak256(abi.encodePacked(s, i)));\n    }\n\n    /// @dev HSL (h 0-359, s and l 0-100) to an rgb() string, which every SVG renderer reads.\n    function _hsl(uint256 h, uint256 s, uint256 l) internal pure returns (string memory) {\n        h %= 360;\n        int256 c = (100 - _abs(int256(2 * l) - 100)) * int256(s) * 255 / 10000;\n        int256 x = c * (60 - _abs(int256(h % 120) - 60)) / 60;\n        int256 m = int256(l) * 255 / 100 - c / 2;\n        int256 r; int256 g; int256 b;\n        if (h < 60) (r, g, b) = (c, x, 0);\n        else if (h < 120) (r, g, b) = (x, c, 0);\n        else if (h < 180) (r, g, b) = (0, c, x);\n        else if (h < 240) (r, g, b) = (0, x, c);\n        else if (h < 300) (r, g, b) = (x, 0, c);\n        else (r, g, b) = (c, 0, x);\n        return string.concat(\"rgb(\", _u(r + m), \",\", _u(g + m), \",\", _u(b + m), \")\");\n    }\n\n    function _abs(int256 v) internal pure returns (int256) {\n        return v < 0 ? -v : v;\n    }\n\n    function _u(int256 v) internal pure returns (string memory) {\n        if (v < 0) v = 0;\n        if (v > 255) v = 255;\n        return uint256(v).toString();\n    }\n\n    function _pick(string[4] memory names, uint256 r) internal pure returns (string memory) {\n        return names[r % 4];\n    }\n\n    function _T1() internal pure returns (string[4] memory) {\n        return [\"Saturn alien girl\", \"Saturn alien girl\", \"Saturn alien girl\", \"Saturn alien girl\"];\n    }\n    function _T2() internal pure returns (string[4] memory) {\n        return [\"Cream space suit\", \"Cream space suit\", \"Cream space suit\", \"Cream space suit\"];\n    }\n    function _T3() internal pure returns (string[4] memory) {\n        return [\"Gold violet rim light\", \"Gold violet rim light\", \"Gold violet rim light\", \"Gold violet rim light\"];\n    }\n    function _T4() internal pure returns (string[4] memory) {\n        return [\"Saturn and nebula\", \"Saturn and nebula\", \"Saturn and nebula\", \"Saturn and nebula\"];\n    }\n\n\n    /// @notice Raw artwork bytes read from the IMAGE data contract.\n    function _img() internal view returns (bytes memory b) {\n        address a = IMAGE;\n        uint256 n = a.code.length - 1;\n        b = new bytes(n);\n        assembly {\n            extcodecopy(a, add(b, 32), 1, n)\n        }\n    }\n\n    function _svg(uint256) internal view returns (string memory) {\n        return string.concat('<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 400 400\"><image width=\"400\" height=\"400\" href=\"data:image/webp;base64,', Base64.encode(_img()), '\"/></svg>');\n    }\n\n    function _attributes(uint256 s) internal pure returns (string memory) {\n        return string.concat(\n            '[{\"trait_type\":\"Character\",\"value\":\"', _pick(_T1(), s), '\"},',\n            '{\"trait_type\":\"Outfit\",\"value\":\"', _pick(_T2(), s >> 8), '\"},',\n            '{\"trait_type\":\"Light\",\"value\":\"', _pick(_T3(), s >> 16), '\"},',\n            '{\"trait_type\":\"Background\",\"value\":\"', _pick(_T4(), s >> 80), '\"}]'\n        );\n    }\n\n    /// @notice The token's SVG image.\n    function image(uint256 id) public view returns (string memory) {\n        _requireOwned(id);\n        return _svg(_seed(id));\n    }\n\n    function tokenURI(uint256 id) public view override returns (string memory) {\n        _requireOwned(id);\n        uint256 s = _seed(id);\n        string memory json = string.concat(\n            '{\"name\":\"Saturnelle #', id.toString(),\n            '\",\"description\":\"Saturnelle is 929 Lilac alien girl explorer with stardust freckles and a ringed planet hair clip before giant Saturn. Art generated fully on-chain on BNB Chain. Minted by .ai Agent ID holders.\",',\n            '\"image\":\"data:image/svg+xml;base64,', Base64.encode(bytes(_svg(s))),\n            '\",\"attributes\":', _attributes(s), '}'\n        );\n        return string.concat(\"data:application/json;base64,\", Base64.encode(bytes(json)));\n    }\n\n    /// @notice Collection-level metadata for marketplaces.\n    function contractURI() external pure returns (string memory) {\n        string memory json = string.concat(\n            '{\"name\":\"Saturnelle\",\"description\":\"Saturnelle is 929 Lilac alien girl explorer with stardust freckles and a ringed planet hair clip before giant Saturn. Art generated fully on-chain on BNB Chain. Mint is gated to .ai Agent ID holders.\",',\n            '\"seller_fee_basis_points\":500}'\n        );\n        return string.concat(\"data:application/json;base64,\", Base64.encode(bytes(json)));\n    }\n\n    // ---------------- owner ----------------\n\n    function setMintOpen(bool open) external onlyOwner {\n        mintOpen = open;\n    }\n\n    function setRoyalty(address receiver, uint96 feeBps) external onlyOwner {\n        _setDefaultRoyalty(receiver, feeBps);\n    }\n\n    function withdraw() external onlyOwner {\n        (bool ok,) = owner().call{value: address(this).balance}(\"\");\n        if (!ok) revert WithdrawFailed();\n    }\n\n    function supportsInterface(bytes4 interfaceId) public view override(ERC721, ERC2981) returns (bool) {\n        return super.supportsInterface(interfaceId);\n    }\n}"}},"abi":[{"type":"constructor","inputs":[{"name":"initialOwner","type":"address","internalType":"address"}],"stateMutability":"nonpayable"},{"name":"BadQuantity","type":"error","inputs":[]},{"name":"ERC2981InvalidDefaultRoyalty","type":"error","inputs":[{"name":"numerator","type":"uint256","internalType":"uint256"},{"name":"denominator","type":"uint256","internalType":"uint256"}]},{"name":"ERC2981InvalidDefaultRoyaltyReceiver","type":"error","inputs":[{"name":"receiver","type":"address","internalType":"address"}]},{"name":"ERC2981InvalidTokenRoyalty","type":"error","inputs":[{"name":"tokenId","type":"uint256","internalType":"uint256"},{"name":"numerator","type":"uint256","internalType":"uint256"},{"name":"denominator","type":"uint256","internalType":"uint256"}]},{"name":"ERC2981InvalidTokenRoyaltyReceiver","type":"error","inputs":[{"name":"tokenId","type":"uint256","internalType":"uint256"},{"name":"receiver","type":"address","internalType":"address"}]},{"name":"ERC721IncorrectOwner","type":"error","inputs":[{"name":"sender","type":"address","internalType":"address"},{"name":"tokenId","type":"uint256","internalType":"uint256"},{"name":"owner","type":"address","internalType":"address"}]},{"name":"ERC721InsufficientApproval","type":"error","inputs":[{"name":"operator","type":"address","internalType":"address"},{"name":"tokenId","type":"uint256","internalType":"uint256"}]},{"name":"ERC721InvalidApprover","type":"error","inputs":[{"name":"approver","type":"address","internalType":"address"}]},{"name":"ERC721InvalidOperator","type":"error","inputs":[{"name":"operator","type":"address","internalType":"address"}]},{"name":"ERC721InvalidOwner","type":"error","inputs":[{"name":"owner","type":"address","internalType":"address"}]},{"name":"ERC721InvalidReceiver","type":"error","inputs":[{"name":"receiver","type":"address","internalType":"address"}]},{"name":"ERC721InvalidSender","type":"error","inputs":[{"name":"sender","type":"address","internalType":"address"}]},{"name":"ERC721NonexistentToken","type":"error","inputs":[{"name":"tokenId","type":"uint256","internalType":"uint256"}]},{"name":"MintClosed","type":"error","inputs":[]},{"name":"NoAgentId","type":"error","inputs":[]},{"name":"OnlyWallets","type":"error","inputs":[]},{"name":"OwnableInvalidOwner","type":"error","inputs":[{"name":"owner","type":"address","internalType":"address"}]},{"name":"OwnableUnauthorizedAccount","type":"error","inputs":[{"name":"account","type":"address","internalType":"address"}]},{"name":"SoldOut","type":"error","inputs":[]},{"name":"WalletLimit","type":"error","inputs":[]},{"name":"WithdrawFailed","type":"error","inputs":[]},{"name":"WrongPayment","type":"error","inputs":[]},{"name":"Approval","type":"event","inputs":[{"name":"owner","type":"address","indexed":true,"internalType":"address"},{"name":"approved","type":"address","indexed":true,"internalType":"address"},{"name":"tokenId","type":"uint256","indexed":true,"internalType":"uint256"}],"anonymous":false},{"name":"ApprovalForAll","type":"event","inputs":[{"name":"owner","type":"address","indexed":true,"internalType":"address"},{"name":"operator","type":"address","indexed":true,"internalType":"address"},{"name":"approved","type":"bool","indexed":false,"internalType":"bool"}],"anonymous":false},{"name":"Launched","type":"event","inputs":[{"name":"to","type":"address","indexed":true,"internalType":"address"},{"name":"tokenId","type":"uint256","indexed":true,"internalType":"uint256"},{"name":"agent","type":"string","indexed":false,"internalType":"string"}],"anonymous":false},{"name":"OwnershipTransferred","type":"event","inputs":[{"name":"previousOwner","type":"address","indexed":true,"internalType":"address"},{"name":"newOwner","type":"address","indexed":true,"internalType":"address"}],"anonymous":false},{"name":"Transfer","type":"event","inputs":[{"name":"from","type":"address","indexed":true,"internalType":"address"},{"name":"to","type":"address","indexed":true,"internalType":"address"},{"name":"tokenId","type":"uint256","indexed":true,"internalType":"uint256"}],"anonymous":false},{"name":"AGENT_ID","type":"function","inputs":[],"outputs":[{"name":"","type":"address","internalType":"contract IAgentIdRegistry"}],"stateMutability":"view"},{"name":"FREE_PER_WALLET","type":"function","inputs":[],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"FREE_SUPPLY","type":"function","inputs":[],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"IMAGE","type":"function","inputs":[],"outputs":[{"name":"","type":"address","internalType":"address"}],"stateMutability":"view"},{"name":"MAX_PER_WALLET","type":"function","inputs":[],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"MAX_SUPPLY","type":"function","inputs":[],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"PRICE","type":"function","inputs":[],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"approve","type":"function","inputs":[{"name":"to","type":"address","internalType":"address"},{"name":"tokenId","type":"uint256","internalType":"uint256"}],"outputs":[],"stateMutability":"nonpayable"},{"name":"balanceOf","type":"function","inputs":[{"name":"owner","type":"address","internalType":"address"}],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"contractURI","type":"function","inputs":[],"outputs":[{"name":"","type":"string","internalType":"string"}],"stateMutability":"pure"},{"name":"freeClaimed","type":"function","inputs":[],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"freeFor","type":"function","inputs":[{"name":"wallet","type":"address","internalType":"address"},{"name":"qty","type":"uint256","internalType":"uint256"}],"outputs":[{"name":"n","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"freeLeft","type":"function","inputs":[{"name":"wallet","type":"address","internalType":"address"}],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"freeUsed","type":"function","inputs":[{"name":"","type":"address","internalType":"address"}],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"getApproved","type":"function","inputs":[{"name":"tokenId","type":"uint256","internalType":"uint256"}],"outputs":[{"name":"","type":"address","internalType":"address"}],"stateMutability":"view"},{"name":"image","type":"function","inputs":[{"name":"id","type":"uint256","internalType":"uint256"}],"outputs":[{"name":"","type":"string","internalType":"string"}],"stateMutability":"view"},{"name":"isApprovedForAll","type":"function","inputs":[{"name":"owner","type":"address","internalType":"address"},{"name":"operator","type":"address","internalType":"address"}],"outputs":[{"name":"","type":"bool","internalType":"bool"}],"stateMutability":"view"},{"name":"mint","type":"function","inputs":[{"name":"qty","type":"uint256","internalType":"uint256"}],"outputs":[],"stateMutability":"payable"},{"name":"mintOpen","type":"function","inputs":[],"outputs":[{"name":"","type":"bool","internalType":"bool"}],"stateMutability":"view"},{"name":"mintedBy","type":"function","inputs":[{"name":"","type":"address","internalType":"address"}],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"name","type":"function","inputs":[],"outputs":[{"name":"","type":"string","internalType":"string"}],"stateMutability":"view"},{"name":"owner","type":"function","inputs":[],"outputs":[{"name":"","type":"address","internalType":"address"}],"stateMutability":"view"},{"name":"ownerOf","type":"function","inputs":[{"name":"tokenId","type":"uint256","internalType":"uint256"}],"outputs":[{"name":"","type":"address","internalType":"address"}],"stateMutability":"view"},{"name":"quote","type":"function","inputs":[{"name":"wallet","type":"address","internalType":"address"},{"name":"qty","type":"uint256","internalType":"uint256"}],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"renounceOwnership","type":"function","inputs":[],"outputs":[],"stateMutability":"nonpayable"},{"name":"royaltyInfo","type":"function","inputs":[{"name":"tokenId","type":"uint256","internalType":"uint256"},{"name":"salePrice","type":"uint256","internalType":"uint256"}],"outputs":[{"name":"","type":"address","internalType":"address"},{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"safeTransferFrom","type":"function","inputs":[{"name":"from","type":"address","internalType":"address"},{"name":"to","type":"address","internalType":"address"},{"name":"tokenId","type":"uint256","internalType":"uint256"}],"outputs":[],"stateMutability":"nonpayable"},{"name":"safeTransferFrom","type":"function","inputs":[{"name":"from","type":"address","internalType":"address"},{"name":"to","type":"address","internalType":"address"},{"name":"tokenId","type":"uint256","internalType":"uint256"},{"name":"data","type":"bytes","internalType":"bytes"}],"outputs":[],"stateMutability":"nonpayable"},{"name":"setApprovalForAll","type":"function","inputs":[{"name":"operator","type":"address","internalType":"address"},{"name":"approved","type":"bool","internalType":"bool"}],"outputs":[],"stateMutability":"nonpayable"},{"name":"setMintOpen","type":"function","inputs":[{"name":"open","type":"bool","internalType":"bool"}],"outputs":[],"stateMutability":"nonpayable"},{"name":"setRoyalty","type":"function","inputs":[{"name":"receiver","type":"address","internalType":"address"},{"name":"feeBps","type":"uint96","internalType":"uint96"}],"outputs":[],"stateMutability":"nonpayable"},{"name":"supportsInterface","type":"function","inputs":[{"name":"interfaceId","type":"bytes4","internalType":"bytes4"}],"outputs":[{"name":"","type":"bool","internalType":"bool"}],"stateMutability":"view"},{"name":"symbol","type":"function","inputs":[],"outputs":[{"name":"","type":"string","internalType":"string"}],"stateMutability":"view"},{"name":"tokenURI","type":"function","inputs":[{"name":"id","type":"uint256","internalType":"uint256"}],"outputs":[{"name":"","type":"string","internalType":"string"}],"stateMutability":"view"},{"name":"totalSupply","type":"function","inputs":[],"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"stateMutability":"view"},{"name":"transferFrom","type":"function","inputs":[{"name":"from","type":"address","internalType":"address"},{"name":"to","type":"address","internalType":"address"},{"name":"tokenId","type":"uint256","internalType":"uint256"}],"outputs":[],"stateMutability":"nonpayable"},{"name":"transferOwnership","type":"function","inputs":[{"name":"newOwner","type":"address","internalType":"address"}],"outputs":[],"stateMutability":"nonpayable"},{"name":"withdraw","type":"function","inputs":[],"outputs":[],"stateMutability":"nonpayable"}],"matchId":"58027551","creationMatch":"exact_match","runtimeMatch":"exact_match","verifiedAt":"2026-11-02T01:54:25Z","match":"exact_match","chainId":"56","address":"0x79B0f57b631F3dF1781433a95bC8C2219792AF74"}