@bananapus/nana-sdk-core 2.17.0 → 2.19.0

package/dist/esm/v6/deploymentDiagnostics.js

@@ -0,0 +1,521 @@
+import { isAddress, zeroAddress, zeroHash } from "viem";
+import { jb721TiersHookAbi, jb721TiersHookStoreAbi, jbAddressRegistryAbi, revDeployerAbi, } from "../generated/juicebox.js";
+import { jbDirectoryAbi } from "../generated/abi/jbDirectoryAbi.js";
+import { jbProjectsAbi } from "../generated/abi/jbProjectsAbi.js";
+import { isMissingContractFunctionError } from "../utils/errors.js";
+import { resolveProject721Hook } from "./nft.js";
+import { hasPermissions, JBPermissionIdsV6 } from "./permissions.js";
+import { getCurrentRuleset } from "./rulesets.js";
+import { v6Address } from "./types.js";
+export function describeProjectDataStatus(status) {
+    switch (status) {
+        case "available":
+            return "Indexed project details are available.";
+        case "missing":
+            return "The indexer returned no project record. This does not establish why it is missing.";
+        case "incomplete":
+            return "Some indexed project details are missing. This does not establish indexing progress.";
+        case "unavailable":
+            return "The indexer request did not complete. Indexing progress is unknown.";
+        case "not-checked":
+            return "The indexer was not checked.";
+    }
+}
+const sameAddress = (left, right) => left.toLowerCase() === right.toLowerCase();
+/** Inspect current v6 wiring without a wallet, tier enumeration or indexer.
+ * Reads are pinned to one block. Caller-supplied indexer evidence belongs in a
+ * separate report section: a failed indexer request proves nothing about wiring.
+ * Custom hooks/controllers are unsupported where capabilities cannot be verified,
+ * never invalid merely for differing from canonical deployments. Pricing units
+ * and operator powers are informational unless explicit expectations are supplied.
+ */
+export async function getProjectDeploymentDiagnostics(client, args) {
+    const requestedOperator = args.operator && isAddress(args.operator) ? args.operator : undefined;
+    const report = {
+        version: 6,
+        chainId: args.chainId,
+        projectId: args.projectId.toString(),
+        checkedAt: new Date().toISOString(),
+        checkedBlock: null,
+        kind: "unknown",
+        checks: [],
+        ...(requestedOperator ? { operator: requestedOperator } : {}),
+    };
+    const add = (check) => {
+        if (check.status === "mismatch" && !check.action)
+            check.action =
+                "Compare these values with the original deployment call before choosing a correction; immutable settings may require a new deployment.";
+        report.checks.push(check);
+    };
+    const unavailable = (id, category, label, error) => add({
+        id,
+        category,
+        label,
+        status: isMissingContractFunctionError(error)
+            ? "unsupported"
+            : "unavailable",
+        message: isMissingContractFunctionError(error)
+            ? "The contract read reverted or returned no data, so this check could not be verified."
+            : "The chain read did not complete. No mismatch was established.",
+        action: "Retry the check or inspect this contract with your deployment configuration.",
+    });
+    if (args.projectId <= 0n) {
+        add({
+            id: "project",
+            category: "project",
+            status: "unsupported",
+            label: "Project",
+            message: "A positive project ID is required.",
+        });
+        return report;
+    }
+    let blockNumber;
+    try {
+        const chainId = await client.getChainId();
+        if (chainId !== args.chainId) {
+            add({
+                id: "network",
+                category: "project",
+                status: "unavailable",
+                label: "Network",
+                message: "The connected network does not match this project.",
+                actual: String(chainId),
+                expected: String(args.chainId),
+                action: "Choose the project's network and retry.",
+            });
+            return report;
+        }
+        blockNumber = await client.getBlockNumber();
+        report.checkedBlock = blockNumber.toString();
+    }
+    catch {
+        unavailable("network", "project", "Network");
+        return report;
+    }
+    let directory, projects, controller, revOwner, revDeployer, omni;
+    try {
+        directory = v6Address("JBDirectory", args.chainId);
+        projects = v6Address("JBProjects", args.chainId);
+        controller = v6Address("JBController", args.chainId);
+        revOwner = v6Address("REVOwner", args.chainId);
+        revDeployer = v6Address("REVDeployer", args.chainId);
+        omni = v6Address("JBOmnichainDeployer", args.chainId);
+    }
+    catch {
+        add({
+            id: "network",
+            category: "project",
+            status: "unsupported",
+            label: "Network",
+            message: "This SDK has no supported v6 deployment on this network.",
+        });
+        return report;
+    }
+    // Every nested shared resolver uses this same block; no mutable latest reads.
+    const snapshot = {
+        ...client,
+        readContract: (parameters) => client.readContract({ ...parameters, blockNumber }),
+    };
+    const read = snapshot.readContract;
+    const [ownerRead, controllerRead] = await Promise.allSettled([
+        read({
+            address: projects,
+            abi: jbProjectsAbi,
+            functionName: "ownerOf",
+            args: [args.projectId],
+        }),
+        read({
+            address: directory,
+            abi: jbDirectoryAbi,
+            functionName: "controllerOf",
+            args: [args.projectId],
+        }),
+    ]);
+    if (ownerRead.status === "rejected") {
+        unavailable("project.owner", "project", "Project owner", ownerRead.reason);
+        return report;
+    }
+    const owner = ownerRead.value;
+    const isRevnet = sameAddress(owner, revOwner);
+    report.kind = isRevnet ? "revnet" : "juicebox";
+    add({
+        id: "project.owner",
+        category: "project",
+        status: "passed",
+        label: "Project exists",
+        message: "The v6 project registry returned its current owner.",
+        actual: owner,
+    });
+    if (controllerRead.status === "rejected") {
+        unavailable("project.controller", "project", "Controller", controllerRead.reason);
+        return report;
+    }
+    if (!sameAddress(controllerRead.value, controller)) {
+        report.kind = "custom";
+        add({
+            id: "project.controller",
+            category: "project",
+            status: "unsupported",
+            label: "Controller",
+            message: "This controller requires deployment-specific checks.",
+            actual: controllerRead.value,
+            expected: controller,
+            action: "Compare with the controller chosen in the deployment script.",
+        });
+        return report;
+    }
+    add({
+        id: "project.controller",
+        category: "project",
+        status: "passed",
+        label: "Controller",
+        message: "The project uses the supported v6 controller.",
+        actual: controller,
+    });
+    let canonicalRevnet = false;
+    if (isRevnet) {
+        try {
+            const hash = await read({
+                address: revDeployer,
+                abi: revDeployerAbi,
+                functionName: "hashedEncodedConfigurationOf",
+                args: [args.projectId],
+            });
+            canonicalRevnet = hash !== zeroHash;
+            add({
+                id: "project.provenance",
+                category: "project",
+                status: canonicalRevnet ? "passed" : "unsupported",
+                label: "Revnet configuration",
+                message: canonicalRevnet
+                    ? "The canonical deployer has a configuration for this revnet."
+                    : "No canonical configuration is registered. Ownership alone does not establish canonical deployment.",
+                actual: hash,
+            });
+        }
+        catch (error) {
+            unavailable("project.provenance", "project", "Revnet configuration", error);
+        }
+    }
+    let current;
+    try {
+        current = await getCurrentRuleset(snapshot, args);
+    }
+    catch (error) {
+        unavailable("project.ruleset", "project", "Current ruleset", error);
+        if (!isRevnet)
+            return report;
+    }
+    if (current?.ruleset.id === 0) {
+        add({
+            id: "project.ruleset",
+            category: "project",
+            status: "info",
+            label: "Current ruleset",
+            message: "No active ruleset is available yet. Hook routing cannot be checked.",
+        });
+        if (!isRevnet)
+            return report;
+        current = undefined;
+    }
+    const metadata = current?.metadata;
+    if (metadata) {
+        const expectedHook = canonicalRevnet ? revOwner : undefined;
+        add({
+            id: "hook.routing",
+            category: "hook",
+            status: expectedHook && !sameAddress(metadata.dataHook, expectedHook)
+                ? "mismatch"
+                : "info",
+            label: "Payment hook routing",
+            message: "The current ruleset selects this data hook.",
+            actual: metadata.dataHook,
+            ...(expectedHook ? { expected: expectedHook } : {}),
+        });
+        const canonicalComposite = canonicalRevnet;
+        add({
+            id: "hook.flags",
+            category: "hook",
+            status: canonicalComposite &&
+                (!metadata.useDataHookForPay || !metadata.useDataHookForCashOut)
+                ? "mismatch"
+                : "info",
+            label: "Hook enablement",
+            message: canonicalComposite
+                ? "Canonical composite hooks enable both payment and cash-out routing."
+                : "Hook enablement can be an intentional ruleset choice.",
+            actual: `payments=${metadata.useDataHookForPay}; cashOuts=${metadata.useDataHookForCashOut}`,
+            ...(canonicalComposite
+                ? { expected: "payments=true; cashOuts=true" }
+                : {}),
+        });
+    }
+    let resolved;
+    try {
+        resolved = await resolveProject721Hook(snapshot, {
+            ...args,
+            isRevnet,
+            ruleset: current,
+            includeInactiveHook: true,
+        });
+    }
+    catch (error) {
+        unavailable("hook.shop", "hook", "Shop hook", error);
+        return report;
+    }
+    if (!resolved) {
+        const custom = metadata &&
+            metadata.dataHook !== zeroAddress &&
+            !sameAddress(metadata.dataHook, omni) &&
+            !isRevnet;
+        if (custom)
+            report.kind = "custom";
+        add({
+            id: "hook.shop",
+            category: "hook",
+            status: canonicalRevnet ? "mismatch" : custom ? "unsupported" : "info",
+            label: "Shop hook",
+            message: canonicalRevnet
+                ? "The canonical revnet has no registered shop hook."
+                : custom
+                    ? "The selected custom data hook does not expose a supported 721 shop."
+                    : "No 721 shop is configured. This is valid for a Juicebox project.",
+            ...(canonicalRevnet
+                ? { actual: zeroAddress, expected: "A registered 721 hook" }
+                : {}),
+        });
+        return report;
+    }
+    const hook = resolved.hook;
+    add({
+        id: "hook.shop",
+        category: "hook",
+        status: "passed",
+        label: "Shop hook",
+        message: "The project resolves to a hook reporting a 721 store address.",
+        actual: hook,
+    });
+    const bind = async (id, label, readValue, expected) => {
+        try {
+            const actual = String(await readValue());
+            add({
+                id,
+                category: "hook",
+                label,
+                status: expected
+                    ? actual.toLowerCase() === expected.toLowerCase()
+                        ? "passed"
+                        : "mismatch"
+                    : "info",
+                message: expected
+                    ? "Compared the hook's binding with this project."
+                    : "The hook reported this value; custom ownership can be intentional.",
+                actual,
+                ...(expected ? { expected } : {}),
+            });
+            return actual;
+        }
+        catch (error) {
+            unavailable(id, "hook", label, error);
+            return undefined;
+        }
+    };
+    const [hookProject, , hookOwner, permissionRegistry] = await Promise.all([
+        bind("hook.projectId", "Hook project", () => read({
+            address: hook,
+            abi: jb721TiersHookAbi,
+            functionName: "projectId",
+        }), args.projectId.toString()),
+        bind("hook.directory", "Hook directory", () => read({
+            address: hook,
+            abi: jb721TiersHookAbi,
+            functionName: "DIRECTORY",
+        }), directory),
+        bind("hook.owner", "Shop authority", () => read({ address: hook, abi: jb721TiersHookAbi, functionName: "owner" }), canonicalRevnet ? revOwner : undefined),
+        bind("hook.permissions", "Permission registry", () => read({
+            address: hook,
+            abi: jb721TiersHookAbi,
+            functionName: "PERMISSIONS",
+        })),
+    ]);
+    await Promise.all([
+        (async () => {
+            if (sameAddress(resolved.store, zeroAddress)) {
+                add({
+                    id: "hook.store",
+                    category: "hook",
+                    status: "mismatch",
+                    label: "Shop store",
+                    message: "The hook reports no store address.",
+                    actual: zeroAddress,
+                    expected: "A deployed 721 store",
+                    action: "Compare the hook initialization with the deployment script before using its shop.",
+                });
+                return;
+            }
+            try {
+                const maxTierId = await read({
+                    address: resolved.store,
+                    abi: jb721TiersHookStoreAbi,
+                    functionName: "maxTierIdOf",
+                    args: [hook],
+                });
+                add({
+                    id: "hook.store",
+                    category: "hook",
+                    status: "passed",
+                    label: "Shop store",
+                    message: `The reported store is readable; highest tier ID is ${maxTierId}.`,
+                    actual: resolved.store,
+                });
+            }
+            catch (error) {
+                unavailable("hook.store", "hook", "Shop store", error);
+            }
+        })(),
+        (async () => {
+            try {
+                const factory = await read({
+                    address: v6Address("JBAddressRegistry", args.chainId),
+                    abi: jbAddressRegistryAbi,
+                    functionName: "deployerOf",
+                    args: [hook],
+                });
+                const expected = v6Address("JB721TiersHookDeployer", args.chainId);
+                add({
+                    id: "hook.provenance",
+                    category: "hook",
+                    status: sameAddress(factory, expected) ? "passed" : "unsupported",
+                    label: "Shop factory",
+                    message: sameAddress(factory, expected)
+                        ? "The registry records the canonical 721 factory."
+                        : "The registry does not establish canonical factory provenance. Custom hooks need separate review.",
+                    actual: factory,
+                    expected,
+                });
+            }
+            catch (error) {
+                unavailable("hook.provenance", "hook", "Shop factory", error);
+            }
+        })(),
+        (async () => {
+            try {
+                const [currency, decimals] = await read({
+                    address: hook,
+                    abi: jb721TiersHookAbi,
+                    functionName: "pricingContext",
+                });
+                const expected = args.expectedPricing;
+                add({
+                    id: "shop.pricing",
+                    category: "pricing",
+                    status: expected
+                        ? currency === BigInt(expected.currency) &&
+                            decimals === BigInt(expected.decimals)
+                            ? "passed"
+                            : "mismatch"
+                        : "info",
+                    label: "Shop pricing",
+                    message: "Prices use these units. Precision alone cannot establish whether an item was priced as intended.",
+                    actual: `currency=${currency}; decimals=${decimals}`,
+                    ...(expected
+                        ? {
+                            expected: `currency=${expected.currency}; decimals=${expected.decimals}`,
+                        }
+                        : {}),
+                });
+            }
+            catch (error) {
+                unavailable("shop.pricing", "pricing", "Shop pricing", error);
+            }
+        })(),
+        (async () => {
+            if (args.operator && !requestedOperator) {
+                add({
+                    id: "shop.permissions",
+                    category: "permissions",
+                    status: "unsupported",
+                    label: "Shop permissions",
+                    message: "The supplied operator is not a valid address.",
+                    action: "Supply the operator address from your deployment configuration.",
+                });
+                return;
+            }
+            if (!requestedOperator) {
+                add({
+                    id: "shop.permissions",
+                    category: "permissions",
+                    status: "info",
+                    label: "Shop permissions",
+                    message: "Operator permissions can be intentionally restricted. Supply an operator address to read its current powers.",
+                    ...(hookOwner ? { actual: `Shop authority: ${hookOwner}` } : {}),
+                });
+                return;
+            }
+            if (!hookOwner || !hookProject || !permissionRegistry) {
+                const dependencies = [
+                    "hook.owner",
+                    "hook.projectId",
+                    "hook.permissions",
+                ].map((id) => report.checks.find((item) => item.id === id));
+                add({
+                    id: "shop.permissions",
+                    category: "permissions",
+                    status: dependencies.some((item) => item?.status === "unavailable")
+                        ? "unavailable"
+                        : "unsupported",
+                    label: "Shop permissions",
+                    message: "A required hook authority or binding read could not be verified. Operator powers remain unknown.",
+                    action: "Retry the missing hook reads before checking operator powers.",
+                });
+                return;
+            }
+            const operator = requestedOperator;
+            if (sameAddress(operator, zeroAddress) ||
+                hookProject !== args.projectId.toString() ||
+                !permissionRegistry ||
+                !sameAddress(permissionRegistry, v6Address("JBPermissions", args.chainId))) {
+                add({
+                    id: "shop.permissions",
+                    category: "permissions",
+                    status: "unsupported",
+                    label: "Shop permissions",
+                    message: "Operator powers cannot be established for an unverified project binding, custom permission registry or zero operator.",
+                    action: "Verify the hook's project and permission registry, then supply a nonzero operator address.",
+                });
+                return;
+            }
+            const permissions = [
+                ["Adjust tiers", JBPermissionIdsV6.ADJUST_721_TIERS],
+                ["Update metadata", JBPermissionIdsV6.SET_721_METADATA],
+                ["Mint items", JBPermissionIdsV6.MINT_721],
+                ["Increase discounts", JBPermissionIdsV6.SET_721_DISCOUNT_PERCENT],
+            ];
+            await Promise.all(permissions.map(async ([label, id]) => {
+                try {
+                    const allowed = sameAddress(operator, hookOwner) ||
+                        (await hasPermissions(snapshot, {
+                            ...args,
+                            operator,
+                            account: hookOwner,
+                            permissionIds: [id],
+                        }));
+                    add({
+                        id: `shop.permission.${id}`,
+                        category: "permissions",
+                        status: "info",
+                        label,
+                        message: "This is the supplied operator's current capability, including owner, root and wildcard authority.",
+                        actual: allowed ? "Allowed" : "Not allowed",
+                    });
+                }
+                catch (error) {
+                    unavailable(`shop.permission.${id}`, "permissions", label, error);
+                }
+            }));
+        })(),
+    ]);
+    report.checks.sort((left, right) => left.id.localeCompare(right.id));
+    return report;
+}
+//# sourceMappingURL=deploymentDiagnostics.js.map

package/dist/esm/v6/deploymentDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploymentDiagnostics.js","sourceRoot":"","sources":["../../../src/v6/deploymentDiagnostics.ts"],"names":[],"mappings":"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"}

package/dist/esm/v6/distributions.d.ts

@@ -0,0 +1,90 @@
+import { type Address } from "viem";
+/** A reviewed split, as the ruleset held it when the distribution was reviewed. */
+export type ExpectedDistributionSplit = {
+    percent: number | bigint | string;
+    projectId: number | bigint | string;
+    beneficiary: Address;
+    preferAddToBalance: boolean;
+    lockedUntil: number | bigint | string;
+    hook: Address;
+    /**
+     * Payouts only: true when the terminal pays this split without its fee, so
+     * its net must equal its gross. Leave it unset when unknown.
+     */
+    feeless?: boolean;
+};
+/** What a reviewed `sendPayoutsOf` must have done. Numbers may be any uint256 form. */
+export type ExpectedPayoutReceipt = {
+    terminal: Address;
+    projectId: number | bigint | string;
+    rulesetId: number | bigint | string;
+    cycleNumber: number | bigint | string;
+    token: Address;
+    /** The project owner, who receives what the splits leave. */
+    owner: Address;
+    /** The account that sent the distribution. */
+    caller: Address;
+    /** The amount `sendPayoutsOf` was called with, in its currency. */
+    amount: number | bigint | string;
+    /** The least `amountPaidOut` the review allowed, in the token. */
+    minimum: number | bigint | string;
+    splits: readonly ExpectedDistributionSplit[];
+};
+/** What a reviewed `sendReservedTokensToSplitsOf` must have done. */
+export type ExpectedReservedReceipt = {
+    controller: Address;
+    /** JBTokens, which logs the controller's burns. */
+    tokens: Address;
+    projectId: number | bigint | string;
+    rulesetId: number | bigint | string;
+    cycleNumber: number | bigint | string;
+    /** The project owner, who receives what the splits leave. */
+    owner: Address;
+    caller: Address;
+    /** The pending reserved tokens the review saw. */
+    tokenCount: number | bigint | string;
+    splits: readonly ExpectedDistributionSplit[];
+};
+type Receipt = {
+    status?: unknown;
+    logs: readonly unknown[];
+};
+/**
+ * Prove that a `sendPayoutsOf` receipt paid every reviewed split in full.
+ *
+ * The terminal must log, for the project, no `PayoutReverted` or
+ * `PayoutTransferReverted`; exactly one `SendPayouts` from the reviewed
+ * caller, in the reviewed ruleset and cycle, to the reviewed owner, for the
+ * reviewed amount, paying out at least the reviewed minimum with a fee within
+ * 2.5%; and one `SendPayoutToSplit` per reviewed split, in order, naming that
+ * exact split. Each split's gross is the terminal's successive remainder
+ * (`remaining × percent / remaining percent`). Its net must be the gross, or
+ * the gross less its 2.5% fee, and the gross alone for a split marked
+ * feeless: anything else is a hook that took only part of its share. The
+ * owner's net leftover follows the same rule.
+ *
+ * Throws, naming the first event that differs. A refusal means the receipt
+ * cannot show the payouts completed: keep the transaction, and do not send
+ * the same payouts again.
+ */
+export declare function verifyPayoutReceipt(receipt: Receipt, expected: ExpectedPayoutReceipt): void;
+/**
+ * Prove that a `sendReservedTokensToSplitsOf` receipt sent every reviewed
+ * split its reserved tokens.
+ *
+ * The controller must log, for the project, no `ReservedDistributionReverted`
+ * or `SplitHookReverted`; exactly one `SendReservedTokensToSplits` from the
+ * reviewed caller, in the reviewed ruleset and cycle, to the reviewed owner,
+ * for the reviewed token count, leaving what the splits do not take; and one
+ * `SendReservedTokensToSplit` per reviewed split, in order, naming that exact
+ * split with `tokenCount × percent / 100%`. JBTokens must log burns from the
+ * controller of exactly the shares sent to 0x…dEaD: any other burn is tokens a
+ * hook did not take.
+ *
+ * Throws, naming the first event that differs. A refusal means the receipt
+ * cannot show the distribution completed: keep the transaction, and do not
+ * distribute the same reserved tokens again.
+ */
+export declare function verifyReservedDistributionReceipt(receipt: Receipt, expected: ExpectedReservedReceipt): void;
+export {};
+//# sourceMappingURL=distributions.d.ts.map

package/dist/esm/v6/distributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributions.d.ts","sourceRoot":"","sources":["../../../src/v6/distributions.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,OAAO,EACb,MAAM,MAAM,CAAC;AAad,mFAAmF;AACnF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,IAAI,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,6DAA6D;IAC7D,KAAK,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,kEAAkE;IAClE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC9C,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,6DAA6D;IAC7D,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC9C,CAAC;AAEF,KAAK,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,CAAC;AAyI9D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CA0HN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CAyHN"}