@contextvm/sdk 0.3.2 → 0.4.1

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"}

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

@@ -0,0 +1,133 @@
+import { PMI_BITCOIN_LIGHTNING_BOLT11 } from '../pmis.js';
+import { createLogger } from '../../core/utils/logger.js';
+import { sleep } from '../../core/utils/utils.js';
+/**
+ * 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 class LnBolt11LnbitsPaymentProcessor {
+    constructor(options) {
+        var _a, _b, _c;
+        this.pmi = PMI_BITCOIN_LIGHTNING_BOLT11;
+        this.lnbitsUrl = options.lnbitsUrl.replace(/\/+$/, '');
+        this.lnbitsApiKey = options.lnbitsApiKey;
+        this.lnbitsBasicAuth = options.lnbitsBasicAuth;
+        this.ttlSeconds = (_a = options.ttlSeconds) !== null && _a !== void 0 ? _a : 300;
+        this.invoiceExpirySeconds = (_b = options.invoiceExpirySeconds) !== null && _b !== void 0 ? _b : this.ttlSeconds;
+        this.pollIntervalMs = (_c = options.pollIntervalMs) !== null && _c !== void 0 ? _c : 1500;
+        this.logger = createLogger('payments/lnbits-processor');
+    }
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-Api-Key': this.lnbitsApiKey,
+        };
+        if (this.lnbitsBasicAuth) {
+            const encoded = Buffer.from(this.lnbitsBasicAuth).toString('base64');
+            headers['Authorization'] = `Basic ${encoded}`;
+        }
+        return headers;
+    }
+    async createPaymentRequired(params) {
+        var _a;
+        const body = JSON.stringify({
+            out: false,
+            amount: params.amount,
+            memo: (_a = params.description) !== null && _a !== void 0 ? _a : `CVM payment: ${params.requestEventId.slice(0, 8)}`,
+            expiry: this.invoiceExpirySeconds,
+        });
+        const response = await fetch(`${this.lnbitsUrl}/api/v1/payments`, {
+            method: 'POST',
+            headers: this.buildHeaders(),
+            body,
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`LNbits create invoice failed: ${response.status} ${text}`);
+        }
+        const result = (await response.json());
+        if (!result.payment_request) {
+            throw new Error('LNbits returned no payment_request');
+        }
+        this.logger.debug('Invoice created', {
+            requestEventId: params.requestEventId,
+            paymentHash: result.payment_hash,
+            amount: params.amount,
+        });
+        return {
+            amount: params.amount,
+            pay_req: result.payment_request,
+            description: params.description,
+            pmi: this.pmi,
+            ttl: this.ttlSeconds,
+        };
+    }
+    async verifyPayment(params) {
+        var _a;
+        // We need the payment hash to check status. Derive it from the invoice
+        // by first looking it up via the decoded invoice endpoint, or by checking
+        // all recent payments. The simplest approach: decode the bolt11 to get the hash.
+        const paymentHash = await this.getPaymentHashFromInvoice(params.pay_req);
+        while (true) {
+            if ((_a = params.abortSignal) === null || _a === void 0 ? void 0 : _a.aborted) {
+                throw new Error('verifyPayment aborted');
+            }
+            const response = await fetch(`${this.lnbitsUrl}/api/v1/payments/${paymentHash}`, {
+                method: 'GET',
+                headers: this.buildHeaders(),
+            });
+            if (response.ok) {
+                const result = (await response.json());
+                this.logger.debug('Payment check', {
+                    requestEventId: params.requestEventId,
+                    paymentHash,
+                    paid: result.paid,
+                });
+                if (result.paid) {
+                    return { _meta: { payment_hash: paymentHash } };
+                }
+            }
+            else {
+                this.logger.debug('Payment check request failed', {
+                    status: response.status,
+                    paymentHash,
+                });
+            }
+            await sleep(this.pollIntervalMs);
+        }
+    }
+    /**
+     * 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.
+     */
+    async getPaymentHashFromInvoice(bolt11) {
+        const response = await fetch(`${this.lnbitsUrl}/api/v1/payments/decode`, {
+            method: 'POST',
+            headers: this.buildHeaders(),
+            body: JSON.stringify({ data: bolt11 }),
+        });
+        if (response.ok) {
+            const decoded = (await response.json());
+            if (decoded.payment_hash) {
+                return decoded.payment_hash;
+            }
+        }
+        // Fallback: search recent payments for matching bolt11
+        const paymentsResponse = await fetch(`${this.lnbitsUrl}/api/v1/payments?limit=50`, {
+            method: 'GET',
+            headers: this.buildHeaders(),
+        });
+        if (paymentsResponse.ok) {
+            const payments = (await paymentsResponse.json());
+            const match = payments.find((p) => p.bolt11 === bolt11);
+            if (match) {
+                return match.payment_hash;
+            }
+        }
+        throw new Error('Could not resolve payment hash from invoice');
+    }
+}
+//# sourceMappingURL=ln-bolt11-lnbits-payment-processor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ln-bolt11-lnbits-payment-processor.js","sourceRoot":"","sources":["../../../../src/payments/processors/ln-bolt11-lnbits-payment-processor.ts"],"names":[],"mappings":"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"}