@kaspacom/kcc20-tx-builder 0.1.0

package/dist/cjs/verify-operation.d.ts

@@ -0,0 +1,79 @@
+export interface Kcc20VerifyWalletInfo {
+    walletAddress: string;
+    kcc20Owner: string;
+}
+export interface Kcc20VerifyDeployReceipt {
+    amountSompi?: string | null;
+    stateAmount?: string | null;
+    tokenAmount?: string | null;
+    owner?: string | null;
+    ownerScheme?: number | null;
+    borrowScheme?: number | null;
+    borrowGuard?: string | null;
+    extensionCommitment?: string | null;
+    isMintAuthority?: boolean | null;
+    decimals?: string | number | null;
+    mintPolicy?: number | null;
+    extension?: Record<string, unknown> | null;
+}
+export interface Kcc20VerifyActiveTokenUtxo {
+    txidHex: string;
+    vout: number;
+    address: string;
+    amountSompi?: string | null;
+    action?: string | null;
+    state?: Record<string, unknown> | null;
+}
+export interface Kcc20BuildVerifyOperationInput {
+    covenantId: string;
+    activeTokenUtxo: Kcc20VerifyActiveTokenUtxo;
+    deployReceipt?: Kcc20VerifyDeployReceipt | null;
+    ticker?: string | null;
+    tokenName?: string | null;
+    decimals?: string | number | null;
+    mintPolicy?: Record<string, unknown> | null;
+    tokenIdentity?: Record<string, unknown>;
+}
+export interface Kcc20VerifyOperationOptions {
+    network?: string;
+    createdAt?: string;
+    requestId?: string;
+}
+/**
+ * Builds the complete verify/reveal wallet operation from an indexed source
+ * and the deploy receipt produced by the shared deploy PSKT builder.
+ *
+ * The host remains responsible for checking that the outpoint is live. All
+ * protocol calculations and operation planning stay in this package.
+ */
+export declare function buildKcc20VerifyTokenOperation(walletInfo: Kcc20VerifyWalletInfo, input: Kcc20BuildVerifyOperationInput, options?: Kcc20VerifyOperationOptions): {
+    requestId: string;
+    description: string;
+    payload: {
+        params: Record<string, unknown>;
+        signing: {
+            standard: string;
+            walletAction: string;
+            status: string;
+            builderKey: string;
+            builderStatus: string;
+            submitTransactionSupported: boolean;
+            missingDependencies: string[];
+            missingSources: never[];
+        };
+        sourceRequirements: Record<string, unknown>[];
+        signerRequirements: Record<string, unknown>[];
+        warnings: string[];
+        tokenIdentity?: Record<string, unknown> | undefined;
+        schema: string;
+        status: string;
+        requestId: string;
+        chain: string;
+        network: string;
+        createdAt: string;
+        owner: import("./wallet-operation.js").Kcc20WalletOperationOwner;
+        operation: string;
+        contract: string;
+        action: string;
+    };
+};

package/dist/cjs/verify-operation.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildKcc20VerifyTokenOperation = buildKcc20VerifyTokenOperation;
+const paid_mint_amount_js_1 = require("./paid-mint-amount.js");
+const wallet_operation_js_1 = require("./wallet-operation.js");
+const HEX_64_RE = /^[a-f0-9]{64}$/;
+/**
+ * Builds the complete verify/reveal wallet operation from an indexed source
+ * and the deploy receipt produced by the shared deploy PSKT builder.
+ *
+ * The host remains responsible for checking that the outpoint is live. All
+ * protocol calculations and operation planning stay in this package.
+ */
+function buildKcc20VerifyTokenOperation(walletInfo, input, options = {}) {
+    const covenantId = requireHex64(input.covenantId, "covenantId");
+    const owner = requireHex64(walletInfo.kcc20Owner, "kcc20Owner");
+    const source = normalizeVerifySource(input.activeTokenUtxo);
+    const receipt = input.deployReceipt ?? undefined;
+    const indexedState = input.activeTokenUtxo.state ?? {};
+    const stateOwner = requireHex64(firstDefined(indexedState["owner"], indexedState["ownerIdentifier"], receipt?.owner), "active token owner");
+    const stateAmount = requireUnsignedInteger(firstDefined(indexedState["amount"], indexedState["stateAmount"], indexedState["tokenAmount"], receipt?.stateAmount, receipt?.tokenAmount), "active token amount");
+    const extensionCommitment = requireHex64(firstDefined(indexedState["extensionCommitment"], receipt?.extensionCommitment), "extensionCommitment");
+    const extension = recordValue(indexedState["extension"]) ?? receipt?.extension ?? undefined;
+    const isMintAuthority = booleanValue(indexedState["isMintAuthority"]) ??
+        booleanValue(indexedState["isMinter"]) ??
+        booleanValue(receipt?.isMintAuthority) ??
+        stateAmount === "0";
+    const revealMode = isMintAuthority ? "mint" : "self-transfer";
+    const decimals = resolveDecimals(firstDefined(input.decimals, receipt?.decimals, indexedState["decimals"]), firstDefined(indexedState["tokenDisplayScale"], indexedState["priceScale"], indexedState["displayScale"], extension?.["displayScale"]));
+    const tokenDisplayScale = (10n ** BigInt(decimals)).toString();
+    const mintPolicyValue = integerValue(firstDefined(receipt?.mintPolicy, indexedState["mintPolicy"], extension?.["mintPolicy"], input.mintPolicy?.["policyValue"]));
+    const mintPriceSompi = requireUnsignedInteger(firstDefined(extension?.["mintPriceSompi"], indexedState["mintPriceSompi"], indexedState["mintPricePerTokenSompi"], input.mintPolicy?.["mintPricePerTokenSompi"], "0"), "mint price");
+    const protocolFeeBps = optionalBps(firstDefined(extension?.["protocolFeeBps"], indexedState["protocolFeeBps"], indexedState["feeBps"], input.mintPolicy?.["protocolFeeBps"]));
+    const remainingSupply = optionalUnsignedInteger(firstDefined(extension?.["remainingSupply"], indexedState["remainingSupply"], input.mintPolicy?.["remainingSupply"]), "remaining supply");
+    const tokenAmount = isMintAuthority
+        ? revealMintAmount({
+            mintPriceSompi,
+            priceScale: tokenDisplayScale,
+            protocolFeeBps,
+            remainingSupply,
+        })
+        : undefined;
+    const activeTokenUtxo = {
+        ...source,
+        state: {
+            ...indexedState,
+            owner: stateOwner,
+            ownerIdentifier: stateOwner,
+            ownerScheme: integerValue(firstDefined(indexedState["ownerScheme"], receipt?.ownerScheme)) ?? 0,
+            stateOwnerType: integerValue(firstDefined(indexedState["stateOwnerType"], receipt?.ownerScheme)) ?? 0,
+            borrowScheme: integerValue(firstDefined(indexedState["borrowScheme"], receipt?.borrowScheme)) ?? 0,
+            borrowGuard: optionalHex64(firstDefined(indexedState["borrowGuard"], receipt?.borrowGuard)) ?? "0".repeat(64),
+            extensionCommitment,
+            stateAmount,
+            tokenAmount: stateAmount,
+            amount: stateAmount,
+            balance: stateAmount,
+            isMintAuthority,
+            isMinter: isMintAuthority,
+            ...(extension ? { extension } : {}),
+        },
+    };
+    const mintPolicy = input.mintPolicy ??
+        (extension || mintPolicyValue !== undefined
+            ? {
+                policy: mintPolicyValue === 2
+                    ? "public"
+                    : mintPolicyValue === 1
+                        ? "controlled"
+                        : "fixed",
+                policyValue: mintPolicyValue,
+                remainingSupply,
+                mintPricePerTokenSompi: mintPriceSompi,
+                protocolFeeBps,
+                publicMintActive: firstDefined(extension?.["publicMintActive"], indexedState["publicMintActive"]),
+                ...(extension ? { extension } : {}),
+            }
+            : null);
+    return (0, wallet_operation_js_1.buildKcc20WalletOperationFromPlan)(walletInfo, {
+        builderKey: "kcc20.reveal-token",
+        operation: "verify-token",
+        contract: "KCC20",
+        action: "reveal",
+        description: "Build a KCC20 verify/reveal transaction request.",
+        params: {
+            covenantId,
+            revealMode,
+            tokenAmount,
+            recipientOwner: owner,
+            recipientOwnerScheme: 0,
+            mintPath: isMintAuthority ? "owner" : undefined,
+            ...(isMintAuthority
+                ? {
+                    priceScale: tokenDisplayScale,
+                    tokenDisplayScale,
+                }
+                : {}),
+            ticker: input.ticker?.trim() || null,
+            tokenName: input.tokenName?.trim() || null,
+            mintPolicy,
+            activeTokenUtxo,
+        },
+        sourceRequirements: [
+            {
+                type: "active-kcc20-claimed-token-utxo",
+                covenantId,
+                outpoint: `${source.txidHex}:${source.vout}`,
+                revealMode,
+                purpose: isMintAuthority
+                    ? "spend the claimed mint-authority output so TN10 can verify the KCC20 artifact and state"
+                    : "spend the claimed holder output through a full self-transfer so TN10 can verify the KCC20 artifact and state",
+            },
+            {
+                type: "kaspa-funding-utxo",
+                ownerAddress: walletInfo.walletAddress,
+                purpose: "fund output dust and network fee",
+            },
+        ],
+        warnings: [
+            isMintAuthority
+                ? "Reveal mints the default zero-price verification amount locally."
+                : "Fixed-supply reveal recreates the full holder balance to the same owner.",
+            "The canonical KCC20 covenantId remains the token identity; wrapper market creation is a separate step after verification.",
+        ],
+        tokenIdentity: input.tokenIdentity ?? {
+            canonicalCovenantId: covenantId,
+            deployCandidateId: covenantId,
+        },
+    }, options);
+}
+function normalizeVerifySource(source) {
+    const txidHex = requireHex64(source.txidHex, "active token txid");
+    if (!Number.isInteger(source.vout) || source.vout < 0) {
+        throw new Error("active token vout must be a non-negative integer");
+    }
+    if (!source.address?.trim()) {
+        throw new Error("active token address is required");
+    }
+    return {
+        txidHex,
+        vout: source.vout,
+        outpoint: `${txidHex}:${source.vout}`,
+        address: source.address.trim(),
+        amountSompi: optionalUnsignedInteger(source.amountSompi, "amountSompi"),
+        action: source.action ?? "deploy",
+    };
+}
+function revealMintAmount(input) {
+    const unitPriceSompi = BigInt(input.mintPriceSompi);
+    const priceScale = BigInt(input.priceScale);
+    const minimum = unitPriceSompi > 0n
+        ? (0, paid_mint_amount_js_1.kcc20MinimumPaidMintAmount)({
+            unitPriceSompi,
+            priceScale,
+            minGrossSompi: paid_mint_amount_js_1.KCC20_VERIFY_PAID_MINT_MIN_GROSS_SOMPI,
+            protocolFeeBps: input.protocolFeeBps,
+        })
+        : priceScale;
+    const amount = minimum > priceScale ? minimum : priceScale;
+    if (input.remainingSupply && amount > BigInt(input.remainingSupply)) {
+        throw new Error("claimed KCC20 token remaining supply is too small to satisfy the verify mint minimum");
+    }
+    return amount.toString();
+}
+function resolveDecimals(value, scale) {
+    const parsed = integerValue(value);
+    if (parsed !== undefined && parsed >= 0 && parsed <= 18)
+        return parsed;
+    const normalizedScale = optionalUnsignedInteger(scale, "display scale");
+    if (normalizedScale) {
+        let current = BigInt(normalizedScale);
+        let decimals = 0;
+        while (current > 1n && current % 10n === 0n) {
+            current /= 10n;
+            decimals += 1;
+        }
+        if (current === 1n && decimals <= 18)
+            return decimals;
+    }
+    return 8;
+}
+function requireHex64(value, field) {
+    const normalized = optionalHex64(value);
+    if (!normalized)
+        throw new Error(`${field} must be 64 hex characters`);
+    return normalized;
+}
+function optionalHex64(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.trim().toLowerCase().replace(/^0x/, "");
+    return HEX_64_RE.test(normalized) ? normalized : undefined;
+}
+function requireUnsignedInteger(value, field) {
+    const normalized = optionalUnsignedInteger(value, field);
+    if (normalized === undefined) {
+        throw new Error(`${field} must be an unsigned integer`);
+    }
+    return normalized;
+}
+function optionalUnsignedInteger(value, field) {
+    if (value === null || value === undefined || value === "")
+        return undefined;
+    const normalized = typeof value === "bigint"
+        ? value.toString()
+        : typeof value === "number" && Number.isSafeInteger(value)
+            ? String(value)
+            : typeof value === "string"
+                ? value.trim()
+                : "";
+    if (!/^\d+$/.test(normalized)) {
+        throw new Error(`${field} must be an unsigned integer`);
+    }
+    return normalized;
+}
+function integerValue(value) {
+    const parsed = typeof value === "number"
+        ? value
+        : typeof value === "bigint"
+            ? Number(value)
+            : typeof value === "string" && /^\d+$/.test(value.trim())
+                ? Number(value)
+                : Number.NaN;
+    return Number.isSafeInteger(parsed) ? parsed : undefined;
+}
+function optionalBps(value) {
+    const parsed = integerValue(value);
+    if (parsed === undefined)
+        return undefined;
+    if (parsed < 0 || parsed > 10_000) {
+        throw new Error("protocolFeeBps must be 0..10000");
+    }
+    return parsed;
+}
+function booleanValue(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+function recordValue(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function firstDefined(...values) {
+    return values.find((value) => value !== undefined && value !== null);
+}
+//# sourceMappingURL=verify-operation.js.map

package/dist/cjs/verify-operation.js.map

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

package/dist/cjs/wallet-operation.d.ts

@@ -0,0 +1,52 @@
+export interface Kcc20WalletOperationOwner {
+    walletAddress: string;
+    kcc20Owner: string;
+}
+export interface Kcc20WalletOperationPlan {
+    builderKey: string;
+    operation: string;
+    contract: string;
+    action: string;
+    description: string;
+    params: Record<string, unknown>;
+    sourceRequirements?: Record<string, unknown>[];
+    signerRequirements?: Record<string, unknown>[];
+    warnings?: string[];
+    tokenIdentity?: Record<string, unknown>;
+}
+export interface Kcc20WalletOperationBuildOptions {
+    network?: string;
+    createdAt?: string;
+    requestId?: string;
+}
+export declare function buildKcc20WalletOperationFromPlan(owner: Kcc20WalletOperationOwner, plan: Kcc20WalletOperationPlan, options?: Kcc20WalletOperationBuildOptions): {
+    requestId: string;
+    description: string;
+    payload: {
+        params: Record<string, unknown>;
+        signing: {
+            standard: string;
+            walletAction: string;
+            status: string;
+            builderKey: string;
+            builderStatus: string;
+            submitTransactionSupported: boolean;
+            missingDependencies: string[];
+            missingSources: never[];
+        };
+        sourceRequirements: Record<string, unknown>[];
+        signerRequirements: Record<string, unknown>[];
+        warnings: string[];
+        tokenIdentity?: Record<string, unknown> | undefined;
+        schema: string;
+        status: string;
+        requestId: string;
+        chain: string;
+        network: string;
+        createdAt: string;
+        owner: Kcc20WalletOperationOwner;
+        operation: string;
+        contract: string;
+        action: string;
+    };
+};

package/dist/cjs/wallet-operation.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildKcc20WalletOperationFromPlan = buildKcc20WalletOperationFromPlan;
+const KCC20_WALLET_OPERATION_SCHEMA = "kcc20-wallet-operation-request/v1";
+function buildKcc20WalletOperationFromPlan(owner, plan, options = {}) {
+    const requestId = options.requestId ?? `kcc20-${plan.operation}-${randomOperationId()}`;
+    return {
+        requestId,
+        description: plan.description,
+        payload: {
+            schema: KCC20_WALLET_OPERATION_SCHEMA,
+            status: "wallet-operation-ready",
+            requestId,
+            chain: "kaspa",
+            network: options.network ?? "testnet-10",
+            createdAt: options.createdAt ?? new Date().toISOString(),
+            owner,
+            operation: plan.operation,
+            contract: plan.contract,
+            action: plan.action,
+            ...(plan.tokenIdentity ? { tokenIdentity: plan.tokenIdentity } : {}),
+            params: plan.params,
+            signing: {
+                standard: "pskt",
+                walletAction: "sign-pskt-transaction",
+                status: "missing-funded-pskt",
+                builderKey: plan.builderKey,
+                builderStatus: "ready-to-build",
+                submitTransactionSupported: false,
+                missingDependencies: [`backend-funded-pskt-builder:${plan.builderKey}`],
+                missingSources: [],
+            },
+            sourceRequirements: plan.sourceRequirements ?? [],
+            signerRequirements: plan.signerRequirements ?? [
+                {
+                    type: "wallet-owner",
+                    owner: owner.kcc20Owner,
+                    address: owner.walletAddress,
+                },
+            ],
+            warnings: plan.warnings ?? [],
+        },
+    };
+}
+function randomOperationId() {
+    return globalThis.crypto?.randomUUID?.() ?? fallbackRandomId();
+}
+function fallbackRandomId() {
+    const bytes = new Uint8Array(16);
+    globalThis.crypto?.getRandomValues?.(bytes);
+    if (bytes.some((byte) => byte !== 0)) {
+        return [...bytes]
+            .map((byte) => byte.toString(16).padStart(2, "0"))
+            .join("");
+    }
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+//# sourceMappingURL=wallet-operation.js.map

package/dist/cjs/wallet-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-operation.js","sourceRoot":"","sources":["../../src/wallet-operation.ts"],"names":[],"mappings":";;AA0BA,8EA4CC;AAtED,MAAM,6BAA6B,GAAG,mCAAmC,CAAC;AA0B1E,SAAgB,iCAAiC,CAC/C,KAAgC,EAChC,IAA8B,EAC9B,UAA4C,EAAE;IAE9C,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC,SAAS,IAAI,iBAAiB,EAAE,EAAE,CAAC;IACxE,OAAO;QACL,SAAS;QACT,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE;YACP,MAAM,EAAE,6BAA6B;YACrC,MAAM,EAAE,wBAAwB;YAChC,SAAS;YACT,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,YAAY;YACxC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACxD,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE;gBACP,QAAQ,EAAE,MAAM;gBAChB,YAAY,EAAE,uBAAuB;gBACrC,MAAM,EAAE,qBAAqB;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,aAAa,EAAE,gBAAgB;gBAC/B,0BAA0B,EAAE,KAAK;gBACjC,mBAAmB,EAAE,CAAC,+BAA+B,IAAI,CAAC,UAAU,EAAE,CAAC;gBACvE,cAAc,EAAE,EAAE;aACnB;YACD,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,EAAE;YACjD,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI;gBAC7C;oBACE,IAAI,EAAE,cAAc;oBACpB,KAAK,EAAE,KAAK,CAAC,UAAU;oBACvB,OAAO,EAAE,KAAK,CAAC,aAAa;iBAC7B;aACF;YACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;SAC9B;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,gBAAgB,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,KAAK,CAAC;aACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aACjD,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC"}

package/dist/cjs/wasm-provider.d.ts

@@ -0,0 +1,15 @@
+import type { KaspaWasmProvider, KaspaWasmRuntime } from "./runtime.js";
+export interface WasmModuleLoader<TModule> {
+    load(): Promise<TModule>;
+}
+export interface WasmModuleInitializer<TModule> {
+    initialize(module: TModule): Promise<KaspaWasmRuntime> | KaspaWasmRuntime;
+}
+/**
+ * Creates a cached provider for either the browser or Node WASM module.
+ *
+ * The loader and initializer are deliberately supplied by the host. This
+ * keeps URL resolution, initSync, initWASM32Bindings, and binary loading
+ * outside the shared package.
+ */
+export declare function createKaspaWasmProvider<TModule>(loader: WasmModuleLoader<TModule>, initializer: WasmModuleInitializer<TModule>): KaspaWasmProvider;

package/dist/cjs/wasm-provider.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKaspaWasmProvider = createKaspaWasmProvider;
+/**
+ * Creates a cached provider for either the browser or Node WASM module.
+ *
+ * The loader and initializer are deliberately supplied by the host. This
+ * keeps URL resolution, initSync, initWASM32Bindings, and binary loading
+ * outside the shared package.
+ */
+function createKaspaWasmProvider(loader, initializer) {
+    let runtimePromise;
+    return {
+        getRuntime() {
+            runtimePromise ??= Promise.resolve(loader.load()).then((module) => initializer.initialize(module));
+            return runtimePromise;
+        },
+    };
+}
+//# sourceMappingURL=wasm-provider.js.map

package/dist/cjs/wasm-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-provider.js","sourceRoot":"","sources":["../../src/wasm-provider.ts"],"names":[],"mappings":";;AAiBA,0DAcC;AArBD;;;;;;GAMG;AACH,SAAgB,uBAAuB,CACrC,MAAiC,EACjC,WAA2C;IAE3C,IAAI,cAAqD,CAAC;IAE1D,OAAO;QACL,UAAU;YACR,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAChE,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAC/B,CAAC;YACF,OAAO,cAAc,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}