@contextvm/sdk 0.3.1 → 0.4.0

package/dist/esm/payments/handlers/ln-bolt11-lnbits-payment-handler.js

@@ -0,0 +1,44 @@
+import { PMI_BITCOIN_LIGHTNING_BOLT11 } from '../pmis.js';
+/**
+ * CEP-8 client payment handler for PMI `bitcoin-lightning-bolt11` backed by LNbits REST API.
+ *
+ * Pays BOLT11 invoices by calling the LNbits `/api/v1/payments` endpoint.
+ */
+export class LnBolt11LnbitsPaymentHandler {
+    constructor(options) {
+        this.pmi = PMI_BITCOIN_LIGHTNING_BOLT11;
+        this.lnbitsUrl = options.lnbitsUrl.replace(/\/+$/, '');
+        this.lnbitsAdminKey = options.lnbitsAdminKey;
+        this.lnbitsBasicAuth = options.lnbitsBasicAuth;
+    }
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-Api-Key': this.lnbitsAdminKey,
+        };
+        if (this.lnbitsBasicAuth) {
+            const encoded = Buffer.from(this.lnbitsBasicAuth).toString('base64');
+            headers['Authorization'] = `Basic ${encoded}`;
+        }
+        return headers;
+    }
+    async handle(req) {
+        const response = await fetch(`${this.lnbitsUrl}/api/v1/payments`, {
+            method: 'POST',
+            headers: this.buildHeaders(),
+            body: JSON.stringify({
+                out: true,
+                bolt11: req.pay_req,
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`LNbits pay_invoice failed: ${response.status} ${text}`);
+        }
+        const result = (await response.json());
+        if (!result.payment_hash) {
+            throw new Error('LNbits payment returned no payment_hash');
+        }
+    }
+}
+//# sourceMappingURL=ln-bolt11-lnbits-payment-handler.js.map

package/dist/esm/payments/handlers/ln-bolt11-lnbits-payment-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ln-bolt11-lnbits-payment-handler.js","sourceRoot":"","sources":["../../../../src/payments/handlers/ln-bolt11-lnbits-payment-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAW1D;;;;GAIG;AACH,MAAM,OAAO,4BAA4B;IAOvC,YAAmB,OAA4C;QAN/C,QAAG,GAAG,4BAA4B,CAAC;QAOjD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IACjD,CAAC;IAEO,YAAY;QAClB,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,WAAW,EAAE,IAAI,CAAC,cAAc;SACjC,CAAC;QACF,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,OAAO,EAAE,CAAC;QAChD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,GAA0B;QAC5C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,kBAAkB,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE;YAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,GAAG,EAAE,IAAI;gBACT,MAAM,EAAE,GAAG,CAAC,OAAO;aACpB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAEpC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;CACF"}

package/dist/esm/payments/handlers/ln-bolt11-nwc-payment-handler.d.ts

@@ -0,0 +1,20 @@
+import type { RelayHandler } from '../../core/interfaces.js';
+import type { PaymentHandler, PaymentHandlerRequest } from '../types.js';
+export interface LnBolt11NwcPaymentHandlerOptions {
+    /** NIP-47 `nostr+walletconnect://...` connection string. */
+    nwcConnectionString: string;
+    /** Optional relay handler to reuse; defaults to an ApplesauceRelayPool built from the connection relays. */
+    relayHandler?: RelayHandler;
+    /** Per-payment response timeout. @default 60_000 */
+    responseTimeoutMs?: number;
+}
+/**
+ * CEP-8 client payment handler for PMI `bitcoin-lightning-bolt11` backed by NIP-47 (NWC).
+ */
+export declare class LnBolt11NwcPaymentHandler implements PaymentHandler {
+    readonly pmi: "bitcoin-lightning-bolt11";
+    private readonly nwc;
+    constructor(options: LnBolt11NwcPaymentHandlerOptions);
+    handle(req: PaymentHandlerRequest): Promise<void>;
+}
+//# sourceMappingURL=ln-bolt11-nwc-payment-handler.d.ts.map

package/dist/esm/payments/handlers/ln-bolt11-nwc-payment-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ln-bolt11-nwc-payment-handler.d.ts","sourceRoot":"","sources":["../../../../src/payments/handlers/ln-bolt11-nwc-payment-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAMzE,MAAM,WAAW,gCAAgC;IAC/C,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4GAA4G;IAC5G,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,yBAA0B,YAAW,cAAc;IAC9D,SAAgB,GAAG,6BAAgC;IAEnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;gBAEb,OAAO,EAAE,gCAAgC;IAY/C,MAAM,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAkB/D"}

package/dist/esm/payments/handlers/ln-bolt11-nwc-payment-handler.js

@@ -0,0 +1,36 @@
+import { PMI_BITCOIN_LIGHTNING_BOLT11 } from '../pmis.js';
+import { parseNwcConnectionString } from '../nip47/connection.js';
+import { NwcClient } from '../nip47/nwc-client.js';
+import { ApplesauceRelayPool } from '../../relay/applesauce-relay-pool.js';
+/**
+ * CEP-8 client payment handler for PMI `bitcoin-lightning-bolt11` backed by NIP-47 (NWC).
+ */
+export class LnBolt11NwcPaymentHandler {
+    constructor(options) {
+        var _a;
+        this.pmi = PMI_BITCOIN_LIGHTNING_BOLT11;
+        const connection = parseNwcConnectionString(options.nwcConnectionString);
+        const relayHandler = (_a = options.relayHandler) !== null && _a !== void 0 ? _a : new ApplesauceRelayPool([...connection.relays]);
+        this.nwc = new NwcClient({
+            relayHandler,
+            connection,
+            responseTimeoutMs: options.responseTimeoutMs,
+        });
+    }
+    async handle(req) {
+        const response = await this.nwc.request({
+            method: 'pay_invoice',
+            resultType: 'pay_invoice',
+            request: {
+                method: 'pay_invoice',
+                params: {
+                    invoice: req.pay_req,
+                },
+            },
+        });
+        if (response.error) {
+            throw new Error(`NWC pay_invoice failed: ${response.error.code} (${response.error.message})`);
+        }
+    }
+}
+//# sourceMappingURL=ln-bolt11-nwc-payment-handler.js.map

package/dist/esm/payments/handlers/ln-bolt11-nwc-payment-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ln-bolt11-nwc-payment-handler.js","sourceRoot":"","sources":["../../../../src/payments/handlers/ln-bolt11-nwc-payment-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAW3E;;GAEG;AACH,MAAM,OAAO,yBAAyB;IAKpC,YAAmB,OAAyC;;QAJ5C,QAAG,GAAG,4BAA4B,CAAC;QAKjD,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACzE,MAAM,YAAY,GAChB,MAAA,OAAO,CAAC,YAAY,mCAAI,IAAI,mBAAmB,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAE1E,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,CAAC;YACvB,YAAY;YACZ,UAAU;YACV,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,GAA0B;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YACtC,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,aAAa;YACzB,OAAO,EAAE;gBACP,MAAM,EAAE,aAAa;gBACrB,MAAM,EAAE;oBACN,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB;aACF;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,2BAA2B,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/payments/index.d.ts

@@ -0,0 +1,17 @@
+export * from './types.js';
+export * from './fake-payment-handler.js';
+export * from './fake-payment-processor.js';
+export * from './client-payments.js';
+export * from './server-payments.js';
+export * from './server-transport-payments.js';
+export * from './pmi-tags.js';
+export * from './cap-tags.js';
+export * from './pmis.js';
+export * from './nip47/connection.js';
+export * from './nip47/nwc-client.js';
+export * from './nip47/types.js';
+export * from './handlers/ln-bolt11-nwc-payment-handler.js';
+export * from './handlers/ln-bolt11-lnbits-payment-handler.js';
+export * from './processors/ln-bolt11-nwc-payment-processor.js';
+export * from './processors/ln-bolt11-lnbits-payment-processor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/payments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/payments/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,iDAAiD,CAAC;AAChE,cAAc,oDAAoD,CAAC"}

package/dist/esm/payments/index.js

@@ -0,0 +1,17 @@
+export * from './types.js';
+export * from './fake-payment-handler.js';
+export * from './fake-payment-processor.js';
+export * from './client-payments.js';
+export * from './server-payments.js';
+export * from './server-transport-payments.js';
+export * from './pmi-tags.js';
+export * from './cap-tags.js';
+export * from './pmis.js';
+export * from './nip47/connection.js';
+export * from './nip47/nwc-client.js';
+export * from './nip47/types.js';
+export * from './handlers/ln-bolt11-nwc-payment-handler.js';
+export * from './handlers/ln-bolt11-lnbits-payment-handler.js';
+export * from './processors/ln-bolt11-nwc-payment-processor.js';
+export * from './processors/ln-bolt11-lnbits-payment-processor.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/payments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/payments/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,iDAAiD,CAAC;AAChE,cAAc,oDAAoD,CAAC"}

package/dist/esm/payments/nip47/connection.d.ts

@@ -0,0 +1,9 @@
+import type { NwcConnection } from './types.js';
+/**
+ * Parses a Nostr Wallet Connect connection string.
+ *
+ * Example:
+ * `nostr+walletconnect://<wallet_pubkey>?relay=wss://...&relay=wss://...&secret=<hex>`
+ */
+export declare function parseNwcConnectionString(connectionString: string): NwcConnection;
+//# sourceMappingURL=connection.d.ts.map

package/dist/esm/payments/nip47/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/payments/nip47/connection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUhD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,GACvB,aAAa,CAuBf"}

package/dist/esm/payments/nip47/connection.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+const Hex32 = z.string().regex(/^[0-9a-f]{64}$/i);
+const PubkeyHex = z.string().regex(/^[0-9a-f]{64}$/i);
+function normalizeRelayUrl(relay) {
+    // Minimal normalization (we can tighten later).
+    return relay.trim();
+}
+/**
+ * Parses a Nostr Wallet Connect connection string.
+ *
+ * Example:
+ * `nostr+walletconnect://<wallet_pubkey>?relay=wss://...&relay=wss://...&secret=<hex>`
+ */
+export function parseNwcConnectionString(connectionString) {
+    var _a, _b;
+    const url = new URL(connectionString);
+    // NIP-47 uses protocol `nostr+walletconnect://` and places the wallet pubkey
+    // in either host or pathname (implementations differ).
+    const walletPubkeyRaw = (((_a = url.pathname) === null || _a === void 0 ? void 0 : _a.replace(/^\//, '')) || url.host).trim();
+    const secret = (_b = url.searchParams.get('secret')) === null || _b === void 0 ? void 0 : _b.trim();
+    const relayParams = url.searchParams.getAll('relay');
+    const relays = relayParams.map(normalizeRelayUrl).filter(Boolean);
+    if (!walletPubkeyRaw || !secret || relays.length === 0) {
+        throw new Error('Invalid NWC connection string');
+    }
+    const walletPubkey = PubkeyHex.parse(walletPubkeyRaw);
+    const clientSecretKeyHex = Hex32.parse(secret);
+    return {
+        walletPubkey,
+        relays,
+        clientSecretKeyHex,
+    };
+}
+//# sourceMappingURL=connection.js.map

package/dist/esm/payments/nip47/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../../src/payments/nip47/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAEtD,SAAS,iBAAiB,CAAC,KAAa;IACtC,gDAAgD;IAChD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,gBAAwB;;IAExB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEtC,6EAA6E;IAC7E,uDAAuD;IACvD,MAAM,eAAe,GAAG,CAAC,CAAA,MAAA,GAAG,CAAC,QAAQ,0CAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAA,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,0CAAE,IAAI,EAAE,CAAC;IAEtD,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElE,IAAI,CAAC,eAAe,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,kBAAkB,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/C,OAAO;QACL,YAAY;QACZ,MAAM;QACN,kBAAkB;KACnB,CAAC;AACJ,CAAC"}

package/dist/esm/payments/nip47/nwc-client.d.ts

@@ -0,0 +1,38 @@
+import type { RelayHandler } from '../../core/interfaces.js';
+import type { NwcConnection, NwcRequest, NwcResponse } from './types.js';
+export declare const NWC_INFO_KIND = 13194;
+export declare const NWC_REQUEST_KIND = 23194;
+export declare const NWC_RESPONSE_KIND = 23195;
+export interface NwcClientOptions {
+    relayHandler: RelayHandler;
+    connection: NwcConnection;
+    /** How long to wait for a single NIP-47 response. @default 60_000 */
+    responseTimeoutMs?: number;
+}
+/**
+ * Minimal NIP-47 client for request/response over relays.
+ *
+ * Policy: use `nip04` for encryption/decryption.
+ *
+ * Rationale: many real-world NWC wallets still use NIP-04; keep this client minimal and
+ * consistent with the working reference implementation.
+ */
+export declare class NwcClient {
+    private readonly relayHandler;
+    private readonly connection;
+    private readonly responseTimeoutMs;
+    private readonly logger;
+    private connected;
+    private requestQueue;
+    constructor(options: NwcClientOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    request<M extends string, P, R>(params: {
+        method: M;
+        request: NwcRequest<M, P>;
+        resultType: M;
+        responseResultGuard?: (result: unknown) => result is R;
+        expirationSeconds?: number;
+    }): Promise<NwcResponse<M, R>>;
+}
+//# sourceMappingURL=nwc-client.d.ts.map

package/dist/esm/payments/nip47/nwc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nwc-client.d.ts","sourceRoot":"","sources":["../../../../src/payments/nip47/nwc-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzE,eAAO,MAAM,aAAa,QAAsB,CAAC;AACjD,eAAO,MAAM,gBAAgB,QAAyB,CAAC;AACvD,eAAO,MAAM,iBAAiB,QAA0B,CAAC;AAUzD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,aAAa,CAAC;IAE1B,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,SAAS,CAAS;IAI1B,OAAO,CAAC,YAAY,CAAoC;gBAErC,OAAO,EAAE,gBAAgB;IAO/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE;QACnD,MAAM,EAAE,CAAC,CAAC;QACV,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1B,UAAU,EAAE,CAAC,CAAC;QACd,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC;QACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CA6H/B"}

package/dist/esm/payments/nip47/nwc-client.js

@@ -0,0 +1,144 @@
+import { kinds, nip04 } from 'nostr-tools';
+import { finalizeEvent } from 'nostr-tools/pure';
+import { hexToBytes } from 'nostr-tools/utils';
+import { createLogger } from '../../core/utils/logger.js';
+import { withTimeout } from '../../core/utils/utils.js';
+export const NWC_INFO_KIND = kinds.NWCWalletInfo;
+export const NWC_REQUEST_KIND = kinds.NWCWalletRequest;
+export const NWC_RESPONSE_KIND = kinds.NWCWalletResponse;
+function nowSeconds() {
+    return Math.floor(Date.now() / 1000);
+}
+function getTagValue(tags, name) {
+    var _a;
+    return (_a = tags.find((t) => t[0] === name)) === null || _a === void 0 ? void 0 : _a[1];
+}
+/**
+ * Minimal NIP-47 client for request/response over relays.
+ *
+ * Policy: use `nip04` for encryption/decryption.
+ *
+ * Rationale: many real-world NWC wallets still use NIP-04; keep this client minimal and
+ * consistent with the working reference implementation.
+ */
+export class NwcClient {
+    constructor(options) {
+        var _a;
+        this.connected = false;
+        // RelayHandler only exposes a global `unsubscribe()`. To avoid cross-request
+        // interference, we serialize NWC requests per client instance.
+        this.requestQueue = Promise.resolve();
+        this.relayHandler = options.relayHandler;
+        this.connection = options.connection;
+        this.responseTimeoutMs = (_a = options.responseTimeoutMs) !== null && _a !== void 0 ? _a : 60000;
+        this.logger = createLogger('payments/nwc');
+    }
+    async connect() {
+        if (this.connected)
+            return;
+        await this.relayHandler.connect();
+        this.connected = true;
+    }
+    async disconnect() {
+        this.relayHandler.unsubscribe();
+        if (!this.connected)
+            return;
+        await this.relayHandler.disconnect();
+        this.connected = false;
+    }
+    async request(params) {
+        const now = nowSeconds();
+        const run = async () => {
+            await this.connect();
+            const clientSecretKey = hexToBytes(this.connection.clientSecretKeyHex);
+            const plaintext = JSON.stringify(params.request);
+            const encryptedContent = await nip04.encrypt(this.connection.clientSecretKeyHex, this.connection.walletPubkey, plaintext);
+            const eventTemplate = {
+                kind: NWC_REQUEST_KIND,
+                created_at: now,
+                content: encryptedContent,
+                tags: [
+                    ['p', this.connection.walletPubkey],
+                    // NOTE: Historically, NWC has used NIP-04 and many implementations do not require this tag.
+                    // Keeping it to aid wallet-side debugging.
+                    ['encryption', 'nip04'],
+                    ...(params.expirationSeconds
+                        ? [['expiration', String(params.expirationSeconds)]]
+                        : []),
+                ],
+            };
+            const signedRequest = finalizeEvent(eventTemplate, clientSecretKey);
+            const responsePromise = new Promise((resolve, reject) => {
+                const filters = [
+                    {
+                        kinds: [NWC_RESPONSE_KIND],
+                        '#e': [signedRequest.id],
+                        authors: [this.connection.walletPubkey],
+                        since: now - 5,
+                    },
+                ];
+                this.logger.debug('subscribe for response', {
+                    method: params.method,
+                    requestId: signedRequest.id,
+                    filters,
+                });
+                void this.relayHandler
+                    .subscribe(filters, (event) => {
+                    this.logger.debug('received response event', {
+                        method: params.method,
+                        requestId: signedRequest.id,
+                        eventId: event.id,
+                        pubkey: event.pubkey,
+                    });
+                    resolve(event);
+                })
+                    .catch(reject);
+            });
+            this.logger.debug('publish request', {
+                method: params.method,
+                requestId: signedRequest.id,
+                encryption: 'nip04',
+            });
+            await this.relayHandler.publish(signedRequest);
+            try {
+                const responseEvent = await withTimeout(responsePromise, this.responseTimeoutMs, `NWC response timed out for ${params.method}`);
+                // Validate correlation.
+                const eTag = getTagValue(responseEvent.tags, 'e');
+                if (eTag !== signedRequest.id) {
+                    throw new Error('NWC response did not correlate to request');
+                }
+                const decrypted = await nip04.decrypt(this.connection.clientSecretKeyHex, responseEvent.pubkey, responseEvent.content);
+                const parsed = JSON.parse(decrypted);
+                if (parsed.result_type !== params.resultType) {
+                    throw new Error(`Unexpected NWC result_type: ${String(parsed.result_type)} (expected ${params.resultType})`);
+                }
+                if (parsed.error) {
+                    return parsed;
+                }
+                if (params.responseResultGuard && parsed.result !== null) {
+                    if (!params.responseResultGuard(parsed.result)) {
+                        throw new Error('Unexpected NWC result shape');
+                    }
+                }
+                return parsed;
+            }
+            finally {
+                // Best-effort cleanup (RelayHandler has global unsubscribe).
+                this.relayHandler.unsubscribe();
+            }
+        };
+        const prev = this.requestQueue;
+        let release;
+        this.requestQueue = new Promise((r) => {
+            release = r;
+        });
+        await prev;
+        try {
+            return await run();
+        }
+        finally {
+            release === null || release === void 0 ? void 0 : release();
+        }
+    }
+}
+//# sourceMappingURL=nwc-client.js.map

package/dist/esm/payments/nip47/nwc-client.js.map

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

package/dist/esm/payments/nip47/types.d.ts

@@ -0,0 +1,54 @@
+export type NwcEncryptionMode = 'nip44_v2';
+export interface NwcConnection {
+    /** Wallet service pubkey (hex). */
+    walletPubkey: string;
+    /** Relay URLs for reaching the wallet service. */
+    relays: readonly string[];
+    /** Client secret key (hex, 32 bytes) used for signing and encryption. */
+    clientSecretKeyHex: string;
+}
+export type NwcRequest<M extends string = string, P = unknown> = {
+    method: M;
+    params: P;
+};
+export type NwcError = {
+    code: string;
+    message: string;
+};
+export type NwcResponse<T extends string = string, R = unknown> = {
+    result_type: T;
+    error: NwcError | null;
+    result: R | null;
+};
+export type NwcMakeInvoiceParams = {
+    /** Invoice amount in msats. */
+    amount: number;
+    description?: string;
+    expiry?: number;
+};
+export type NwcInvoiceState = 'pending' | 'settled' | 'accepted' | 'expired' | 'failed';
+export type NwcInvoiceResult = {
+    type?: 'incoming' | 'outgoing';
+    state?: NwcInvoiceState;
+    invoice?: string;
+    payment_hash?: string;
+    preimage?: string;
+    created_at?: number;
+    expires_at?: number;
+    settled_at?: number;
+    amount?: number;
+};
+export type NwcLookupInvoiceParams = {
+    payment_hash?: string;
+    invoice?: string;
+};
+export type NwcPayInvoiceParams = {
+    invoice: string;
+    /** Optional amount override in msats (usually omitted for fixed-amount invoices). */
+    amount?: number;
+};
+export type NwcPayInvoiceResult = {
+    preimage?: string;
+    fees_paid?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/payments/nip47/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/payments/nip47/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO,IAAI;IAC/D,MAAM,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO,IAAI;IAChE,WAAW,EAAE,CAAC,CAAC;IACf,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IAC/B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/esm/payments/nip47/types.js

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

package/dist/esm/payments/nip47/types.js.map

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

package/dist/esm/payments/nip47/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Converts sats to msats.
+ * @param sats - The number of sats to convert
+ * @returns The number of msats
+ */
+export declare function satsToMsats(sats: number): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/payments/nip47/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/payments/nip47/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/esm/payments/nip47/utils.js

@@ -0,0 +1,9 @@
+/**
+ * Converts sats to msats.
+ * @param sats - The number of sats to convert
+ * @returns The number of msats
+ */
+export function satsToMsats(sats) {
+    return sats * 1000;
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/payments/nip47/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/payments/nip47/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,GAAG,IAAI,CAAC;AACrB,CAAC"}

package/dist/esm/payments/pmi-tags.d.ts

@@ -0,0 +1,8 @@
+import type { PaymentProcessor, PmiTag } from './types.js';
+/**
+ * Builds Nostr `pmi` tags for a set of server-side processors.
+ *
+ * Tag order is preserved and expresses server preference.
+ */
+export declare function createPmiTagsFromProcessors(processors: readonly PaymentProcessor[]): PmiTag[];
+//# sourceMappingURL=pmi-tags.d.ts.map

package/dist/esm/payments/pmi-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmi-tags.d.ts","sourceRoot":"","sources":["../../../src/payments/pmi-tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,SAAS,gBAAgB,EAAE,GACtC,MAAM,EAAE,CAEV"}

package/dist/esm/payments/pmi-tags.js

@@ -0,0 +1,9 @@
+/**
+ * Builds Nostr `pmi` tags for a set of server-side processors.
+ *
+ * Tag order is preserved and expresses server preference.
+ */
+export function createPmiTagsFromProcessors(processors) {
+    return processors.map((p) => ['pmi', p.pmi]);
+}
+//# sourceMappingURL=pmi-tags.js.map

package/dist/esm/payments/pmi-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmi-tags.js","sourceRoot":"","sources":["../../../src/payments/pmi-tags.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAuC;IAEvC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/esm/payments/pmis.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Payment Method Identifiers (PMIs).
+ *
+ * These are used in CEP-8 `pmi` tags and in `notifications/payment_required`.
+ */
+export declare const PMI_BITCOIN_LIGHTNING_BOLT11: "bitcoin-lightning-bolt11";
+//# sourceMappingURL=pmis.d.ts.map

package/dist/esm/payments/pmis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmis.d.ts","sourceRoot":"","sources":["../../../src/payments/pmis.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAG,0BAAmC,CAAC"}

package/dist/esm/payments/pmis.js

@@ -0,0 +1,7 @@
+/**
+ * Payment Method Identifiers (PMIs).
+ *
+ * These are used in CEP-8 `pmi` tags and in `notifications/payment_required`.
+ */
+export const PMI_BITCOIN_LIGHTNING_BOLT11 = 'bitcoin-lightning-bolt11';
+//# sourceMappingURL=pmis.js.map

package/dist/esm/payments/pmis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmis.js","sourceRoot":"","sources":["../../../src/payments/pmis.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAAmC,CAAC"}

package/dist/esm/payments/processors/ln-bolt11-lnbits-payment-processor.d.ts

@@ -0,0 +1,50 @@
+import type { PaymentProcessor, PaymentProcessorCreateParams, PaymentProcessorVerifyParams } from '../types.js';
+export interface LnBolt11LnbitsPaymentProcessorOptions {
+    /** LNbits instance base URL (e.g. `https://lnbits.example.com`). */
+    lnbitsUrl: string;
+    /** LNbits wallet invoice/read key. */
+    lnbitsApiKey: string;
+    /** Optional HTTP Basic Auth credentials (`user:password`) for proxied instances. */
+    lnbitsBasicAuth?: string;
+    /** Fallback TTL in seconds for the payment request. @default 300 */
+    ttlSeconds?: number;
+    /** Invoice expiry in seconds passed to LNbits. @default ttlSeconds */
+    invoiceExpirySeconds?: number;
+    /** Poll interval for payment verification. @default 1500 */
+    pollIntervalMs?: number;
+}
+/**
+ * CEP-8 server payment processor for PMI `bitcoin-lightning-bolt11` backed by LNbits REST API.
+ *
+ * Creates BOLT11 invoices via the LNbits `/api/v1/payments` endpoint and polls
+ * for settlement using the same API.
+ */
+export declare class LnBolt11LnbitsPaymentProcessor implements PaymentProcessor {
+    readonly pmi: "bitcoin-lightning-bolt11";
+    private readonly lnbitsUrl;
+    private readonly lnbitsApiKey;
+    private readonly lnbitsBasicAuth?;
+    private readonly ttlSeconds;
+    private readonly invoiceExpirySeconds;
+    private readonly pollIntervalMs;
+    private readonly logger;
+    constructor(options: LnBolt11LnbitsPaymentProcessorOptions);
+    private buildHeaders;
+    createPaymentRequired(params: PaymentProcessorCreateParams): Promise<{
+        amount: number;
+        pay_req: string;
+        description?: string;
+        pmi: string;
+        ttl?: number;
+    }>;
+    verifyPayment(params: PaymentProcessorVerifyParams): Promise<{
+        _meta?: Record<string, unknown>;
+    }>;
+    /**
+     * Extract payment hash from a BOLT11 invoice by checking it against LNbits.
+     * LNbits returns the payment_hash when creating an invoice, but verifyPayment
+     * only receives pay_req. We decode it via LNbits decode endpoint.
+     */
+    private getPaymentHashFromInvoice;
+}
+//# sourceMappingURL=ln-bolt11-lnbits-payment-processor.d.ts.map

package/dist/esm/payments/processors/ln-bolt11-lnbits-payment-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ln-bolt11-lnbits-payment-processor.d.ts","sourceRoot":"","sources":["../../../../src/payments/processors/ln-bolt11-lnbits-payment-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,qCAAqC;IACpD,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,8BAA+B,YAAW,gBAAgB;IACrE,SAAgB,GAAG,6BAAgC;IAEnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEb,OAAO,EAAE,qCAAqC;IAUjE,OAAO,CAAC,YAAY;IAYP,qBAAqB,CAChC,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IA+CW,aAAa,CACxB,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IA0C/C;;;;OAIG;YACW,yBAAyB;CAoCxC"}