@run402/sdk 4.113.0 → 4.114.1

package/dist/node/vendor/x402-lnbtc/constants.d.ts

@@ -0,0 +1,75 @@
+import type { Network } from "@x402/core/types";
+export declare const SCHEME = "exact";
+export declare const ASSET = "BTC";
+export declare const ASSET_TRANSFER_METHOD = "bolt11";
+export declare const PAYMENT_FLOW = "upfront";
+export declare const CAIP_FAMILY = "lnbtc:*";
+export declare const LNBTC_MAINNET: Network;
+export declare const LNBTC_TESTNET: Network;
+/**
+ * Concrete lnbtc networks mapped to their BOLT11 currency prefix.
+ */
+export declare const LNBTC_NETWORKS: Readonly<Record<string, string>>;
+export declare const DEFAULT_CLOCK_SKEW_SECONDS = 60;
+/** Replay entries are retained at least this long after `invoice_end + skew`. */
+export declare const REPLAY_RETENTION_SECONDS = 3600;
+export declare const BINDING_DOMAIN_PREFIX = "x402:exact:lnbtc:bolt11:";
+export declare const HTTP_PROFILE = "http:1";
+export declare const MCP_PROFILE = "mcp:1";
+export declare const DYNAMIC_EXTRA_FIELDS: string[];
+/** Error reasons returned by the facilitator, verbatim from the specification. */
+export declare const Errors: {
+    readonly unsupportedScheme: "unsupported_scheme";
+    readonly networkMismatch: "network_mismatch";
+    readonly unsupportedNetwork: "unsupported_network";
+    readonly duplicateSettlement: "duplicate_settlement";
+    readonly asset: "invalid_exact_lnbtc_asset";
+    readonly amount: "invalid_exact_lnbtc_amount";
+    readonly amountMismatch: "invalid_exact_lnbtc_amount_mismatch";
+    readonly payToMismatch: "invalid_exact_lnbtc_pay_to_mismatch";
+    readonly payToMalformed: "invalid_exact_lnbtc_pay_to_malformed";
+    readonly maxTimeoutMismatch: "invalid_exact_lnbtc_max_timeout_mismatch";
+    readonly maxTimeout: "invalid_exact_lnbtc_max_timeout";
+    readonly extraMismatch: "invalid_exact_lnbtc_extra_mismatch";
+    readonly requestBinding: "invalid_exact_lnbtc_request_binding";
+    readonly requestMismatch: "invalid_exact_lnbtc_request_mismatch";
+    readonly assetTransferMethod: "invalid_exact_lnbtc_asset_transfer_method";
+    readonly paymentFlow: "invalid_exact_lnbtc_payment_flow";
+    readonly invoiceMissing: "invalid_exact_lnbtc_invoice_missing";
+    readonly invoiceDecodeFailed: "invalid_exact_lnbtc_invoice_decode_failed";
+    readonly invoiceDescription: "invalid_exact_lnbtc_invoice_description";
+    readonly invoiceRequestMismatch: "invalid_exact_lnbtc_invoice_request_mismatch";
+    readonly invoicePayeeMismatch: "invalid_exact_lnbtc_invoice_payee_mismatch";
+    readonly invoiceCurrencyMismatch: "invalid_exact_lnbtc_invoice_currency_mismatch";
+    readonly invoiceAmountMismatch: "invalid_exact_lnbtc_invoice_amount_mismatch";
+    readonly invoiceExpiryMismatch: "invalid_exact_lnbtc_invoice_expiry_mismatch";
+    readonly invoiceCreatedInFuture: "invalid_exact_lnbtc_invoice_created_in_future";
+    readonly invoiceExpired: "invalid_exact_lnbtc_invoice_expired";
+    readonly preimageMissing: "invalid_exact_lnbtc_preimage_missing";
+    readonly preimageMalformed: "invalid_exact_lnbtc_preimage_malformed";
+    readonly preimageLength: "invalid_exact_lnbtc_preimage_length";
+    readonly preimageHashMismatch: "invalid_exact_lnbtc_preimage_hash_mismatch";
+    readonly issuanceDenied: "exact_lnbtc_invoice_issuance_denied";
+    readonly payerInvoiceMismatch: "invalid_exact_lnbtc_payer_invoice_mismatch";
+    readonly payerPaymentHashMismatch: "invalid_exact_lnbtc_payer_payment_hash_mismatch";
+    readonly payerAmountMismatch: "invalid_exact_lnbtc_payer_amount_mismatch";
+    readonly paymentInFlight: "exact_lnbtc_payment_in_flight";
+    readonly paymentNotPaid: "exact_lnbtc_payment_not_paid";
+    readonly payerPreimageRequired: "invalid_exact_lnbtc_payer_preimage_required";
+    readonly payerPreimageMalformed: "invalid_exact_lnbtc_payer_preimage_malformed";
+    readonly payerPreimageHashMismatch: "invalid_exact_lnbtc_payer_preimage_hash_mismatch";
+};
+export type LnbtcErrorReason = (typeof Errors)[keyof typeof Errors];
+/**
+ * Error carrying a stable lnbtc reason string.
+ */
+export declare class LnbtcError extends Error {
+    readonly reason: LnbtcErrorReason;
+    /**
+     * Creates an error whose message is the stable reason.
+     *
+     * @param reason - Stable reason string from {@link Errors}
+     */
+    constructor(reason: LnbtcErrorReason);
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/node/vendor/x402-lnbtc/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/node/vendor/x402-lnbtc/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,eAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,eAAO,MAAM,KAAK,QAAQ,CAAC;AAC3B,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,eAAO,MAAM,aAAa,EAAE,OAAkD,CAAC;AAC/E,eAAO,MAAM,aAAa,EAAE,OAAkD,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG1D,CAAC;AAEH,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAChE,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,oBAAoB,UAAc,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCT,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IAMvB,QAAQ,CAAC,MAAM,EAAE,gBAAgB;IAL7C;;;;OAIG;gBACkB,MAAM,EAAE,gBAAgB;CAI9C"}

package/dist/node/vendor/x402-lnbtc/constants.js

@@ -0,0 +1,81 @@
+export const SCHEME = "exact";
+export const ASSET = "BTC";
+export const ASSET_TRANSFER_METHOD = "bolt11";
+export const PAYMENT_FLOW = "upfront";
+export const CAIP_FAMILY = "lnbtc:*";
+export const LNBTC_MAINNET = "lnbtc:000000000019d6689c085ae165831e93";
+export const LNBTC_TESTNET = "lnbtc:000000000933ea01ad0ee984209779ba";
+/**
+ * Concrete lnbtc networks mapped to their BOLT11 currency prefix.
+ */
+export const LNBTC_NETWORKS = Object.freeze({
+    [LNBTC_MAINNET]: "bc",
+    [LNBTC_TESTNET]: "tb",
+});
+export const DEFAULT_CLOCK_SKEW_SECONDS = 60;
+/** Replay entries are retained at least this long after `invoice_end + skew`. */
+export const REPLAY_RETENTION_SECONDS = 3600;
+export const BINDING_DOMAIN_PREFIX = "x402:exact:lnbtc:bolt11:";
+export const HTTP_PROFILE = "http:1";
+export const MCP_PROFILE = "mcp:1";
+export const DYNAMIC_EXTRA_FIELDS = ["invoice"];
+/** Error reasons returned by the facilitator, verbatim from the specification. */
+export const Errors = {
+    unsupportedScheme: "unsupported_scheme",
+    networkMismatch: "network_mismatch",
+    unsupportedNetwork: "unsupported_network",
+    duplicateSettlement: "duplicate_settlement",
+    asset: "invalid_exact_lnbtc_asset",
+    amount: "invalid_exact_lnbtc_amount",
+    amountMismatch: "invalid_exact_lnbtc_amount_mismatch",
+    payToMismatch: "invalid_exact_lnbtc_pay_to_mismatch",
+    payToMalformed: "invalid_exact_lnbtc_pay_to_malformed",
+    maxTimeoutMismatch: "invalid_exact_lnbtc_max_timeout_mismatch",
+    maxTimeout: "invalid_exact_lnbtc_max_timeout",
+    extraMismatch: "invalid_exact_lnbtc_extra_mismatch",
+    requestBinding: "invalid_exact_lnbtc_request_binding",
+    requestMismatch: "invalid_exact_lnbtc_request_mismatch",
+    assetTransferMethod: "invalid_exact_lnbtc_asset_transfer_method",
+    paymentFlow: "invalid_exact_lnbtc_payment_flow",
+    invoiceMissing: "invalid_exact_lnbtc_invoice_missing",
+    invoiceDecodeFailed: "invalid_exact_lnbtc_invoice_decode_failed",
+    invoiceDescription: "invalid_exact_lnbtc_invoice_description",
+    invoiceRequestMismatch: "invalid_exact_lnbtc_invoice_request_mismatch",
+    invoicePayeeMismatch: "invalid_exact_lnbtc_invoice_payee_mismatch",
+    invoiceCurrencyMismatch: "invalid_exact_lnbtc_invoice_currency_mismatch",
+    invoiceAmountMismatch: "invalid_exact_lnbtc_invoice_amount_mismatch",
+    invoiceExpiryMismatch: "invalid_exact_lnbtc_invoice_expiry_mismatch",
+    invoiceCreatedInFuture: "invalid_exact_lnbtc_invoice_created_in_future",
+    invoiceExpired: "invalid_exact_lnbtc_invoice_expired",
+    preimageMissing: "invalid_exact_lnbtc_preimage_missing",
+    preimageMalformed: "invalid_exact_lnbtc_preimage_malformed",
+    preimageLength: "invalid_exact_lnbtc_preimage_length",
+    preimageHashMismatch: "invalid_exact_lnbtc_preimage_hash_mismatch",
+    // Local client/server reasons (not facilitator responses).
+    issuanceDenied: "exact_lnbtc_invoice_issuance_denied",
+    payerInvoiceMismatch: "invalid_exact_lnbtc_payer_invoice_mismatch",
+    payerPaymentHashMismatch: "invalid_exact_lnbtc_payer_payment_hash_mismatch",
+    payerAmountMismatch: "invalid_exact_lnbtc_payer_amount_mismatch",
+    paymentInFlight: "exact_lnbtc_payment_in_flight",
+    paymentNotPaid: "exact_lnbtc_payment_not_paid",
+    payerPreimageRequired: "invalid_exact_lnbtc_payer_preimage_required",
+    payerPreimageMalformed: "invalid_exact_lnbtc_payer_preimage_malformed",
+    payerPreimageHashMismatch: "invalid_exact_lnbtc_payer_preimage_hash_mismatch",
+};
+/**
+ * Error carrying a stable lnbtc reason string.
+ */
+export class LnbtcError extends Error {
+    reason;
+    /**
+     * Creates an error whose message is the stable reason.
+     *
+     * @param reason - Stable reason string from {@link Errors}
+     */
+    constructor(reason) {
+        super(reason);
+        this.reason = reason;
+        this.name = "LnbtcError";
+    }
+}
+//# sourceMappingURL=constants.js.map

package/dist/node/vendor/x402-lnbtc/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/node/vendor/x402-lnbtc/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC;AAC9B,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC;AAC3B,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAC;AAC9C,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC,MAAM,CAAC,MAAM,aAAa,GAAY,wCAAwC,CAAC;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAY,wCAAwC,CAAC;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC5E,CAAC,aAAa,CAAC,EAAE,IAAI;IACrB,CAAC,aAAa,CAAC,EAAE,IAAI;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,iFAAiF;AACjF,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAS,CAAC,CAAC;AAEhD,kFAAkF;AAClF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,iBAAiB,EAAE,oBAAoB;IACvC,eAAe,EAAE,kBAAkB;IACnC,kBAAkB,EAAE,qBAAqB;IACzC,mBAAmB,EAAE,sBAAsB;IAC3C,KAAK,EAAE,2BAA2B;IAClC,MAAM,EAAE,4BAA4B;IACpC,cAAc,EAAE,qCAAqC;IACrD,aAAa,EAAE,qCAAqC;IACpD,cAAc,EAAE,sCAAsC;IACtD,kBAAkB,EAAE,0CAA0C;IAC9D,UAAU,EAAE,iCAAiC;IAC7C,aAAa,EAAE,oCAAoC;IACnD,cAAc,EAAE,qCAAqC;IACrD,eAAe,EAAE,sCAAsC;IACvD,mBAAmB,EAAE,2CAA2C;IAChE,WAAW,EAAE,kCAAkC;IAC/C,cAAc,EAAE,qCAAqC;IACrD,mBAAmB,EAAE,2CAA2C;IAChE,kBAAkB,EAAE,yCAAyC;IAC7D,sBAAsB,EAAE,8CAA8C;IACtE,oBAAoB,EAAE,4CAA4C;IAClE,uBAAuB,EAAE,+CAA+C;IACxE,qBAAqB,EAAE,6CAA6C;IACpE,qBAAqB,EAAE,6CAA6C;IACpE,sBAAsB,EAAE,+CAA+C;IACvE,cAAc,EAAE,qCAAqC;IACrD,eAAe,EAAE,sCAAsC;IACvD,iBAAiB,EAAE,wCAAwC;IAC3D,cAAc,EAAE,qCAAqC;IACrD,oBAAoB,EAAE,4CAA4C;IAClE,2DAA2D;IAC3D,cAAc,EAAE,qCAAqC;IACrD,oBAAoB,EAAE,4CAA4C;IAClE,wBAAwB,EAAE,iDAAiD;IAC3E,mBAAmB,EAAE,2CAA2C;IAChE,eAAe,EAAE,+BAA+B;IAChD,cAAc,EAAE,8BAA8B;IAC9C,qBAAqB,EAAE,6CAA6C;IACpE,sBAAsB,EAAE,8CAA8C;IACtE,yBAAyB,EAAE,kDAAkD;CACrE,CAAC;AAIX;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAMd;IALrB;;;;OAIG;IACH,YAAqB,MAAwB;QAC3C,KAAK,CAAC,MAAM,CAAC,CAAC;QADK,WAAM,GAAN,MAAM,CAAkB;QAE3C,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/node/vendor/x402-lnbtc/exact/client/scheme.d.ts

@@ -0,0 +1,58 @@
+import type { PaymentPayloadContext, PaymentPayloadResult, PaymentRequirements, SchemeClientHooks, SchemeNetworkClient } from "@x402/core/types";
+import type { Clock, LightningPayer, RequestBindingProvider } from "../../types.js";
+/**
+ * Options for the lnbtc client.
+ */
+export interface ExactLnbtcClientOptions {
+    /** Payer node adapter; must return the preimage for paid invoices. */
+    payer: LightningPayer;
+    /**
+     * Returns the binding of the request being paid for, computed by the
+     * application from the intended request (`httpRequestBinding` or
+     * `mcpToolCallBinding`), never from the payment challenge.
+     */
+    requestBinding: RequestBindingProvider;
+    /** Clock-skew allowance in seconds (default 60). */
+    clockSkewSeconds?: number;
+    /** Clock returning Unix seconds. */
+    clock?: Clock;
+    /** Supported networks mapped to BOLT11 currency (default: mainnet and testnet). */
+    networks?: Readonly<Record<string, string>>;
+}
+/**
+ * Client for `exact` on `lnbtc`: validates the request-bound invoice, pays it,
+ * and returns the verified preimage.
+ */
+export declare class ExactLnbtcScheme implements SchemeNetworkClient {
+    readonly scheme = "exact";
+    readonly schemeHooks: SchemeClientHooks;
+    private readonly options;
+    private readonly skew;
+    private readonly clock;
+    private readonly networks;
+    /**
+     * Creates the client scheme.
+     *
+     * @param options - Payer adapter, request binding provider, clock, and skew
+     */
+    constructor(options: ExactLnbtcClientOptions);
+    /**
+     * Validates the challenge against the intended request, pays the invoice,
+     * and verifies the returned preimage.
+     *
+     * @param x402Version - Protocol version
+     * @param requirements - Selected payment requirements
+     * @param context - Spend cap from the client's spend controls, if any
+     * @returns The payload carrying the preimage
+     */
+    createPaymentPayload(x402Version: number, requirements: PaymentRequirements, context?: PaymentPayloadContext): Promise<PaymentPayloadResult>;
+    /**
+     * For `http:1`, requires `PaymentRequired.resource.url` to equal the
+     * intended request URL before any payment.
+     *
+     * @param ctx - Payment creation context
+     * @returns An abort result on mismatch
+     */
+    private checkResource;
+}
+//# sourceMappingURL=scheme.d.ts.map

package/dist/node/vendor/x402-lnbtc/exact/client/scheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme.d.ts","sourceRoot":"","sources":["../../../../../../src/node/vendor/x402-lnbtc/exact/client/scheme.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAW1B,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAUpF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,KAAK,EAAE,cAAc,CAAC;IACtB;;;;OAIG;IACH,cAAc,EAAE,sBAAsB,CAAC;IACvC,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,mFAAmF;IACnF,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,QAAQ,CAAC,MAAM,WAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAE5D;;;;OAIG;gBACS,OAAO,EAAE,uBAAuB;IAU5C;;;;;;;;OAQG;IACG,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,mBAAmB,EACjC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAkChC;;;;;;OAMG;YACW,aAAa;CAgB5B"}

package/dist/node/vendor/x402-lnbtc/exact/client/scheme.js

@@ -0,0 +1,108 @@
+import { sha256 } from "@noble/hashes/sha2.js";
+import { bytesToHex, hexToBytes } from "@noble/hashes/utils.js";
+import { bindingsEqual } from "../../binding.js";
+import { DEFAULT_CLOCK_SKEW_SECONDS, Errors, HTTP_PROFILE, LNBTC_NETWORKS, LnbtcError, SCHEME, } from "../../constants.js";
+import { checkExpiry, reject, unixNow, validateInvoice, validateRequirements, validateSkew, } from "../../validation.js";
+/**
+ * Client for `exact` on `lnbtc`: validates the request-bound invoice, pays it,
+ * and returns the verified preimage.
+ */
+export class ExactLnbtcScheme {
+    scheme = SCHEME;
+    schemeHooks;
+    options;
+    skew;
+    clock;
+    networks;
+    /**
+     * Creates the client scheme.
+     *
+     * @param options - Payer adapter, request binding provider, clock, and skew
+     */
+    constructor(options) {
+        const skew = options.clockSkewSeconds ?? DEFAULT_CLOCK_SKEW_SECONDS;
+        validateSkew(skew);
+        this.options = options;
+        this.skew = skew;
+        this.clock = options.clock ?? unixNow;
+        this.networks = options.networks ?? LNBTC_NETWORKS;
+        this.schemeHooks = { onBeforePaymentCreation: ctx => this.checkResource(ctx) };
+    }
+    /**
+     * Validates the challenge against the intended request, pays the invoice,
+     * and verifies the returned preimage.
+     *
+     * @param x402Version - Protocol version
+     * @param requirements - Selected payment requirements
+     * @param context - Spend cap from the client's spend controls, if any
+     * @returns The payload carrying the preimage
+     */
+    async createPaymentPayload(x402Version, requirements, context) {
+        const advertised = validateRequirements(requirements, this.networks);
+        assertWithinCap(requirements.amount, context?.maxAmountPerPayment);
+        const intended = await this.options.requestBinding();
+        if (!bindingsEqual(intended, advertised))
+            reject(Errors.requestMismatch);
+        const invoiceText = requirements.extra.invoice;
+        const options = { now: this.clock(), skew: this.skew };
+        const invoice = validateInvoice(invoiceText, requirements, intended.requestHash, this.networks, options);
+        checkExpiry(invoice, options, "unexpired");
+        const payment = await this.options.payer.payInvoice(invoiceText, requirements.network);
+        if (payment.invoice !== invoiceText)
+            reject(Errors.payerInvoiceMismatch);
+        if (payment.paymentHash !== invoice.paymentHash)
+            reject(Errors.payerPaymentHashMismatch);
+        if (payment.amountMsat !== invoice.amountMsat)
+            reject(Errors.payerAmountMismatch);
+        if (payment.status === "in_flight")
+            reject(Errors.paymentInFlight);
+        if (payment.status !== "paid")
+            reject(Errors.paymentNotPaid);
+        const preimage = payment.preimage;
+        if (preimage === undefined || preimage === null)
+            reject(Errors.payerPreimageRequired);
+        if (typeof preimage !== "string" || !/^[0-9a-f]{64}$/.test(preimage)) {
+            reject(Errors.payerPreimageMalformed);
+        }
+        if (bytesToHex(sha256(hexToBytes(preimage))) !== invoice.paymentHash) {
+            reject(Errors.payerPreimageHashMismatch);
+        }
+        return { x402Version, payload: { preimage } };
+    }
+    /**
+     * For `http:1`, requires `PaymentRequired.resource.url` to equal the
+     * intended request URL before any payment.
+     *
+     * @param ctx - Payment creation context
+     * @returns An abort result on mismatch
+     */
+    async checkResource(ctx) {
+        try {
+            const intended = await this.options.requestBinding();
+            if (intended.requestBindingProfile === HTTP_PROFILE &&
+                ctx.paymentRequired.resource?.url !== intended.resourceUrl) {
+                return { abort: true, reason: Errors.requestMismatch };
+            }
+        }
+        catch (error) {
+            if (error instanceof LnbtcError)
+                return { abort: true, reason: error.reason };
+            throw error;
+        }
+    }
+}
+/**
+ * Refuses an amount above the client's atomic spend cap. Core spend controls
+ * already filter requirements; this keeps the scheme safe on its own.
+ *
+ * @param amount - Required millisatoshis (validated positive integer)
+ * @param cap - Atomic cap from spend controls, if any
+ */
+function assertWithinCap(amount, cap) {
+    if (cap === undefined)
+        return;
+    if (!/^[0-9]+$/.test(cap) || BigInt(amount) > BigInt(cap)) {
+        throw new Error(`lnbtc amount ${amount} msat exceeds maxAmountPerPayment ${cap}`);
+    }
+}
+//# sourceMappingURL=scheme.js.map

package/dist/node/vendor/x402-lnbtc/exact/client/scheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme.js","sourceRoot":"","sources":["../../../../../../src/node/vendor/x402-lnbtc/exact/client/scheme.ts"],"names":[],"mappings":"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"}

package/dist/node/vendor/x402-lnbtc/jcs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Serializes a value with the JSON Canonicalization Scheme (RFC 8785).
+ *
+ * Rejects values outside the I-JSON data model: non-finite numbers, lone
+ * surrogates, and non-plain values (undefined, functions, symbols, bigints,
+ * class instances).
+ *
+ * @param value - The value to serialize
+ * @returns The canonical JSON text
+ */
+export declare function canonicalize(value: unknown): string;
+/**
+ * Checks a string for lone UTF-16 surrogates.
+ *
+ * @param value - The string to check
+ * @returns Whether every surrogate is paired
+ */
+export declare function isWellFormed(value: string): boolean;
+//# sourceMappingURL=jcs.d.ts.map

package/dist/node/vendor/x402-lnbtc/jcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jcs.d.ts","sourceRoot":"","sources":["../../../../src/node/vendor/x402-lnbtc/jcs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgBnD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/node/vendor/x402-lnbtc/jcs.js

@@ -0,0 +1,81 @@
+/**
+ * Serializes a value with the JSON Canonicalization Scheme (RFC 8785).
+ *
+ * Rejects values outside the I-JSON data model: non-finite numbers, lone
+ * surrogates, and non-plain values (undefined, functions, symbols, bigints,
+ * class instances).
+ *
+ * @param value - The value to serialize
+ * @returns The canonical JSON text
+ */
+export function canonicalize(value) {
+    if (value === null)
+        return "null";
+    switch (typeof value) {
+        case "boolean":
+            return value ? "true" : "false";
+        case "number":
+            if (!Number.isFinite(value))
+                throw new TypeError("JCS: non-finite number");
+            return JSON.stringify(value);
+        case "string":
+            return serializeString(value);
+        case "object":
+            if (Array.isArray(value))
+                return serializeArray(value);
+            return serializeObject(value);
+        default:
+            throw new TypeError(`JCS: unsupported value of type ${typeof value}`);
+    }
+}
+/**
+ * Checks a string for lone UTF-16 surrogates.
+ *
+ * @param value - The string to check
+ * @returns Whether every surrogate is paired
+ */
+export function isWellFormed(value) {
+    return !/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/.test(value);
+}
+/**
+ * Serializes a string per ECMAScript JSON.stringify, rejecting lone surrogates.
+ *
+ * @param value - The string to serialize
+ * @returns The quoted, escaped string
+ */
+function serializeString(value) {
+    if (!isWellFormed(value))
+        throw new TypeError("JCS: invalid Unicode string");
+    return JSON.stringify(value);
+}
+/**
+ * Serializes an array, rejecting holes (they have no JSON value).
+ *
+ * @param value - The array to serialize
+ * @returns The canonical array text
+ */
+function serializeArray(value) {
+    const items = [];
+    for (let i = 0; i < value.length; i++) {
+        if (!(i in value))
+            throw new TypeError("JCS: sparse array");
+        items.push(canonicalize(value[i]));
+    }
+    return `[${items.join(",")}]`;
+}
+/**
+ * Serializes a plain object with members sorted by UTF-16 code units.
+ *
+ * @param value - The object to serialize
+ * @returns The canonical object text
+ */
+function serializeObject(value) {
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== null) {
+        throw new TypeError("JCS: only plain objects are supported");
+    }
+    const keys = Object.keys(value).sort();
+    const members = keys.map(key => `${serializeString(key)}:${canonicalize(value[key])}`);
+    return `{${members.join(",")}}`;
+}
+//# sourceMappingURL=jcs.js.map

package/dist/node/vendor/x402-lnbtc/jcs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jcs.js","sourceRoot":"","sources":["../../../../src/node/vendor/x402-lnbtc/jcs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAClC,KAAK,QAAQ;YACX,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,QAAQ;YACX,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,KAAK,QAAQ;YACX,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;YACvD,OAAO,eAAe,CAAC,KAAgC,CAAC,CAAC;QAC3D;YACE,MAAM,IAAI,SAAS,CAAC,kCAAkC,OAAO,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,CAAC,wEAAwE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,KAAgB;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAA8B;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjD,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACvF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAClC,CAAC"}

package/dist/node/vendor/x402-lnbtc/types.d.ts

@@ -0,0 +1,81 @@
+import type { Network } from "@x402/core/types";
+import type { RequestBinding } from "./binding.js";
+/**
+ * Scheme-specific payment payload: the 32-byte preimage as lowercase hex.
+ */
+export interface ExactLnbtcPayload {
+    preimage: string;
+}
+/**
+ * Result of asking a payer node to pay an invoice.
+ */
+export interface LightningPayment {
+    /** The invoice that was paid, byte-identical to the one requested. */
+    invoice: string;
+    /** Payment hash, 64 lowercase hex characters. */
+    paymentHash: string;
+    /** Invoice amount in millisatoshis, excluding routing fees. */
+    amountMsat: bigint;
+    status: "paid" | "unpaid" | "in_flight";
+    /** Preimage, 64 lowercase hex characters; required when `status` is `paid`. */
+    preimage?: string;
+}
+/**
+ * Client-side Lightning node adapter. Credentials stay in the application.
+ */
+export interface LightningPayer {
+    /**
+     * Pays a BOLT11 invoice for exactly its amount and returns the result.
+     *
+     * @param invoice - BOLT11 invoice to pay
+     * @param network - Concrete lnbtc network
+     * @returns The payment result; `paid` must carry the preimage
+     */
+    payInvoice(invoice: string, network: Network): Promise<LightningPayment>;
+}
+/**
+ * Parameters for creating a request-bound invoice.
+ */
+export interface CreateInvoiceParams {
+    amountMsat: bigint;
+    /** Request hash to sign as the BOLT11 description hash, lowercase hex. */
+    descriptionHash: string;
+    expirySeconds: number;
+    network: Network;
+}
+/**
+ * Server-side Lightning node adapter. The resource server must have exclusive
+ * invoice-issuance authority for the node key used as `payTo`.
+ */
+export interface LightningReceiver {
+    /**
+     * Creates a fresh invoice with a new preimage and payment hash.
+     *
+     * @param params - Exact amount, description hash, expiry, and network
+     * @returns The BOLT11 invoice
+     */
+    createInvoice(params: CreateInvoiceParams): Promise<string>;
+}
+/**
+ * Restart-durable, atomic store of consumed `network:payment_hash` keys. Every
+ * facilitator instance settling for the same receiver must share one store.
+ */
+export interface ReplayStore {
+    /**
+     * Atomically records a key as consumed.
+     *
+     * @param key - Canonical consumption key `network:payment_hash`
+     * @param retainUntil - Unix seconds the entry must be kept until, at least
+     * @returns `true` if inserted, `false` if the key already existed
+     */
+    consume(key: string, retainUntil: number): Promise<boolean>;
+}
+/**
+ * Returns the binding for the request currently being paid for or served.
+ */
+export type RequestBindingProvider = () => RequestBinding | Promise<RequestBinding>;
+/**
+ * Clock returning Unix seconds.
+ */
+export type Clock = () => number;
+//# sourceMappingURL=types.d.ts.map

package/dist/node/vendor/x402-lnbtc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/node/vendor/x402-lnbtc/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IACxC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC"}

package/dist/node/vendor/x402-lnbtc/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/node/vendor/x402-lnbtc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/node/vendor/x402-lnbtc/types.ts"],"names":[],"mappings":""}

package/dist/node/vendor/x402-lnbtc/validation.d.ts

@@ -0,0 +1,94 @@
+import type { PaymentRequirements } from "@x402/core/types";
+import { type RequestBindingExtra } from "./binding.js";
+import { type DecodedInvoice } from "./bolt11.js";
+import { type LnbtcErrorReason } from "./constants.js";
+/**
+ * Throws an {@link LnbtcError} with the given reason.
+ *
+ * @param reason - Stable reason
+ * @returns Never returns
+ */
+export declare function reject(reason: LnbtcErrorReason): never;
+/**
+ * Validates the core requirement terms (step 2 of facilitator validation).
+ *
+ * @param req - Payment requirements
+ * @param networks - Supported networks mapped to BOLT11 currency
+ */
+export declare function validateCoreTerms(req: PaymentRequirements, networks: Readonly<Record<string, string>>): void;
+/**
+ * Validates the transfer method and payment flow of an `extra` object.
+ *
+ * @param extra - Requirements `extra`
+ */
+export declare function validateMethodAndFlow(extra: Record<string, unknown> | undefined): void;
+/**
+ * Validates every requirement field a client or server checks before paying or
+ * issuing: core terms, method, flow, and binding fields.
+ *
+ * @param req - Payment requirements
+ * @param networks - Supported networks mapped to BOLT11 currency
+ * @returns The validated binding fields
+ */
+export declare function validateRequirements(req: PaymentRequirements, networks: Readonly<Record<string, string>>): RequestBindingExtra;
+/**
+ * Options for invoice validation.
+ */
+export interface InvoiceCheckOptions {
+    /** Validation time, Unix seconds. */
+    now: number;
+    /** Non-negative clock-skew allowance, seconds. */
+    skew: number;
+}
+/**
+ * Strictly decodes an invoice and checks it against the requirements: the
+ * facilitator's step 5, and the client and server pre-payment checks except
+ * expiry (see {@link checkExpiry}).
+ *
+ * @param invoice - BOLT11 invoice text
+ * @param req - Requirements whose terms the invoice must match
+ * @param expectedRequestHash - The expected request hash, lowercase hex
+ * @param networks - Supported networks mapped to BOLT11 currency
+ * @param options - Time and expiry policy
+ * @returns The decoded invoice
+ */
+export declare function validateInvoice(invoice: unknown, req: PaymentRequirements, expectedRequestHash: string, networks: Readonly<Record<string, string>>, options: InvoiceCheckOptions): DecodedInvoice;
+/**
+ * Applies an expiry policy to a decoded invoice.
+ *
+ * @param invoice - Decoded invoice
+ * @param options - Validation time and skew
+ * @param policy - `unexpired`: the invoice must not have expired at `now`
+ *   (client, server). `settlement`: the paid-but-expired window, valid through
+ *   `invoice_end + skew` inclusive (facilitator).
+ */
+export declare function checkExpiry(invoice: DecodedInvoice, options: InvoiceCheckOptions, policy: "unexpired" | "settlement"): void;
+/**
+ * Checks that a network is one of the configured networks (own keys only, so
+ * names such as `constructor` never match).
+ *
+ * @param network - Candidate network
+ * @param networks - Supported networks mapped to BOLT11 currency
+ * @returns Whether the network is supported
+ */
+export declare function isSupportedNetwork(network: unknown, networks: Readonly<Record<string, string>>): network is string;
+/**
+ * Validates a clock-skew allowance.
+ *
+ * @param skew - Seconds
+ */
+export declare function validateSkew(skew: number): void;
+/**
+ * Checks for a lowercase compressed secp256k1 public key on the curve.
+ *
+ * @param value - Candidate
+ * @returns Whether it is valid
+ */
+export declare function isCompressedPubkey(value: unknown): value is string;
+/**
+ * Current Unix time in whole seconds.
+ *
+ * @returns Seconds since the epoch
+ */
+export declare function unixNow(): number;
+//# sourceMappingURL=validation.d.ts.map

package/dist/node/vendor/x402-lnbtc/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/node/vendor/x402-lnbtc/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAKL,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAC;AAKxB;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,IAAI,CASN;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAMtF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,mBAAmB,CAIrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,mBAAmB,EACxB,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC1C,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAmBhB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,WAAW,GAAG,YAAY,GACjC,IAAI,CAIN;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,OAAO,IAAI,MAAM,CAEnB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQlE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAEhC"}