402-mcp 4.1.1 → 4.2.0

package/build/wallet/lnurlcash-ops.d.ts

@@ -0,0 +1,80 @@
+import type { LnurlcashNoteStore, StoredNote } from '../store/lnurlcash-notes.js';
+/**
+ * Note operations shared by the wallet provider (which melts a note to pay a
+ * BOLT-11 invoice) and the lnurlcash HTTP rail (which hands a note straight to
+ * a paywall). Both need the same crash-safe split and the same reconciliation,
+ * and two copies of that would drift.
+ */
+/** LUD-03/LUD-25 responses are either a success object or `{status:'ERROR'}`. */
+export interface LnurlError {
+    status: 'ERROR';
+    reason?: string;
+}
+export interface WithdrawRequest {
+    status?: string;
+    tag?: string;
+    callback?: string;
+    k1?: string;
+    minWithdrawable?: number;
+    maxWithdrawable?: number;
+}
+export interface CallbackOk {
+    status?: string;
+    verify?: string;
+    pr?: string;
+    reason?: string;
+}
+export declare function isError(res: unknown): res is LnurlError;
+/**
+ * Mint responses are the only thing safe to surface. Anything thrown by the
+ * HTTP layer may carry a URL, and our URLs carry note secrets in the query
+ * string, so exceptions are never stringified outward.
+ */
+export declare class MintRefused extends Error {
+}
+/**
+ * The mint doesn't recognise a note we thought we held. Expected, not
+ * exceptional: a bearer note can be spent by anyone holding a copy, so every
+ * local balance is a cache and the mint is the only authority. Signals "drop
+ * this one and try the next", never "fail the payment".
+ */
+export declare class NoteGone extends Error {
+}
+export interface NoteOpsOptions {
+    /** Per-request HTTP timeout. */
+    httpTimeoutMs?: number;
+    fetchImpl?: typeof fetch;
+}
+export interface ResolvedNote {
+    amountMsat: number;
+    callback: string;
+}
+/**
+ * `refused` is the mint saying it does not honour this note: unknown, already
+ * spent, or pending another operation. `unreachable` is the mint saying
+ * nothing at all. The difference matters because a note is only safe to drop
+ * on the first: a bearer note is money, and a flaky network must never destroy
+ * it.
+ */
+export type NoteProbe = {
+    ok: true;
+    note: ResolvedNote;
+} | {
+    ok: false;
+    reason: 'refused' | 'unreachable';
+};
+export interface NoteOps {
+    probeNote(mint: string, secret: string): Promise<NoteProbe>;
+    resolveNote(mint: string, secret: string): Promise<ResolvedNote | null>;
+    reconcile(): Promise<void>;
+    split(parent: StoredNote, amountMsat: number): Promise<StoredNote>;
+}
+/** Appends params to a callback URL that may already carry some. */
+export declare function callbackUrl(base: string, params: Record<string, string>): string;
+/**
+ * The note as a LUD-25 withdraw URL: the secret as `k1`, its value alongside.
+ * This is the form a wallet shows and the form a paywall is handed. The
+ * `amount` is only a claim; the mint's `maxWithdrawable` is authoritative.
+ */
+export declare function noteUrl(note: Pick<StoredNote, 'mint' | 'secret' | 'amountMsat'>): string;
+export declare function createNoteOps(store: LnurlcashNoteStore, options?: NoteOpsOptions): NoteOps;

package/build/wallet/lnurlcash-ops.js

@@ -0,0 +1,137 @@
+import { generatePreimage, computePaymentHash, fetchJson } from 'farrier-kit';
+export function isError(res) {
+    return typeof res === 'object' && res !== null && res.status === 'ERROR';
+}
+/**
+ * Mint responses are the only thing safe to surface. Anything thrown by the
+ * HTTP layer may carry a URL, and our URLs carry note secrets in the query
+ * string, so exceptions are never stringified outward.
+ */
+export class MintRefused extends Error {
+}
+/**
+ * The mint doesn't recognise a note we thought we held. Expected, not
+ * exceptional: a bearer note can be spent by anyone holding a copy, so every
+ * local balance is a cache and the mint is the only authority. Signals "drop
+ * this one and try the next", never "fail the payment".
+ */
+export class NoteGone extends Error {
+}
+const DEFAULT_HTTP_TIMEOUT_MS = 8_000;
+/** Appends params to a callback URL that may already carry some. */
+export function callbackUrl(base, params) {
+    const url = new URL(base);
+    for (const [k, v] of Object.entries(params))
+        url.searchParams.set(k, v);
+    return url.toString();
+}
+/**
+ * The note as a LUD-25 withdraw URL: the secret as `k1`, its value alongside.
+ * This is the form a wallet shows and the form a paywall is handed. The
+ * `amount` is only a claim; the mint's `maxWithdrawable` is authoritative.
+ */
+export function noteUrl(note) {
+    const url = new URL('/w', note.mint);
+    url.searchParams.set('k1', note.secret);
+    url.searchParams.set('amount', String(note.amountMsat));
+    return url.toString();
+}
+export function createNoteOps(store, options = {}) {
+    const httpTimeoutMs = options.httpTimeoutMs ?? DEFAULT_HTTP_TIMEOUT_MS;
+    const get = async (url) => fetchJson(url, { timeoutMs: httpTimeoutMs, fetchImpl: options.fetchImpl });
+    /** Reads a note's current value from the mint, keeping why it failed. */
+    async function probeNote(mint, secret) {
+        let res;
+        try {
+            res = await get(callbackUrl(new URL('/w', mint).toString(), { k1: secret }));
+        }
+        catch {
+            return { ok: false, reason: 'unreachable' };
+        }
+        if (isError(res) || typeof res.maxWithdrawable !== 'number' || typeof res.callback !== 'string') {
+            return { ok: false, reason: 'refused' };
+        }
+        return { ok: true, note: { amountMsat: res.maxWithdrawable, callback: res.callback } };
+    }
+    /**
+     * Reads a note's current value from the mint. `null` means the mint doesn't
+     * recognise it: unknown, already spent, or pending another operation.
+     */
+    async function resolveNote(mint, secret) {
+        const probe = await probeNote(mint, secret);
+        return probe.ok ? probe.note : null;
+    }
+    /**
+     * Settles notes left in an indeterminate state by an earlier crash, a melt
+     * whose outcome never came back, or a note handed to a paywall that may or
+     * may not have rotated it. A provisional note the mint knows about means its
+     * split landed; one it doesn't means the split never happened. A melting note
+     * the mint still honours means the spend failed and the mint restored it.
+     */
+    async function reconcile() {
+        for (const note of [...store.byState('provisional'), ...store.byState('melting')]) {
+            const resolved = await resolveNote(note.mint, note.secret);
+            if (resolved) {
+                store.confirm(note.secret, resolved.amountMsat);
+                // A landed split burned its parent, whatever our local copy says.
+                if (note.parent)
+                    store.remove(note.parent);
+            }
+            else {
+                store.remove(note.secret);
+            }
+        }
+    }
+    /**
+     * Splits `parent` into a note worth exactly `amountMsat` plus change, and
+     * returns the exact-value note. A melt invoice must match the note value
+     * exactly and a paywall must not be overpaid, so this is how an arbitrary
+     * amount gets covered.
+     */
+    async function split(parent, amountMsat) {
+        const resolved = await resolveNote(parent.mint, parent.secret);
+        if (!resolved) {
+            store.remove(parent.secret);
+            throw new NoteGone('note not recognised by the mint');
+        }
+        const paySecret = generatePreimage();
+        const changeSecret = generatePreimage();
+        const addedAt = new Date().toISOString();
+        // Persisted BEFORE the request, deliberately. The mint keys the new notes
+        // to hashes of these secrets and never learns the secrets themselves, so a
+        // crash between its swap and our write would destroy the value outright.
+        store.addMany([
+            { secret: paySecret, mint: parent.mint, amountMsat, state: 'provisional', parent: parent.secret, addedAt },
+            { secret: changeSecret, mint: parent.mint, amountMsat: 0, state: 'provisional', parent: parent.secret, addedAt },
+        ]);
+        let res;
+        try {
+            res = await get(callbackUrl(resolved.callback, {
+                k1: parent.secret,
+                amount: String(amountMsat),
+                h: computePaymentHash(paySecret),
+                h2: computePaymentHash(changeSecret),
+            }));
+        }
+        catch {
+            // Outcome unknown. Leave both children provisional; reconcile() decides
+            // on the next call, once the mint can be asked again.
+            throw new MintRefused('Split outcome unknown; it will be reconciled on the next attempt');
+        }
+        if (isError(res)) {
+            // A refusal is synchronous and burns nothing, so the children are dead.
+            store.removeMany([paySecret, changeSecret]);
+            throw new MintRefused(res.reason ?? 'Mint refused the split');
+        }
+        store.remove(parent.secret);
+        store.confirm(paySecret, amountMsat);
+        const change = await resolveNote(parent.mint, changeSecret);
+        if (change)
+            store.confirm(changeSecret, change.amountMsat);
+        else
+            store.remove(changeSecret);
+        return store.find(paySecret);
+    }
+    return { probeNote, resolveNote, reconcile, split };
+}
+//# sourceMappingURL=lnurlcash-ops.js.map

package/build/wallet/lnurlcash-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lnurlcash-ops.js","sourceRoot":"","sources":["../../src/wallet/lnurlcash-ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAsB7E,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAK,GAAkB,CAAC,MAAM,KAAK,OAAO,CAAA;AAC1F,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;CAAG;AAEzC;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;CAAG;AA+BtC,MAAM,uBAAuB,GAAG,KAAK,CAAA;AAErC,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAA8B;IACtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAA;IACzB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACvE,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAwD;IAC9E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IACpC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IACvC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAA;IACvD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAyB,EAAE,UAA0B,EAAE;IACnF,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAA;IAEtE,MAAM,GAAG,GAAG,KAAK,EAAK,GAAW,EAAc,EAAE,CAC/C,SAAS,CAAI,GAAG,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAE/E,yEAAyE;IACzE,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,MAAc;QACnD,IAAI,GAAiC,CAAA;QACrC,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,GAAG,CAA+B,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;QAC5G,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAA;QAC7C,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChG,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QACzC,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,eAAe,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAA;IACxF,CAAC;IAED;;;OAGG;IACH,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc;QACrD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC3C,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IACrC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,UAAU,SAAS;QACtB,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YAClF,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YAC1D,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAA;gBAC/C,kEAAkE;gBAClE,IAAI,IAAI,CAAC,MAAM;oBAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC5C,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,UAAU,KAAK,CAAC,MAAkB,EAAE,UAAkB;QACzD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YAC3B,MAAM,IAAI,QAAQ,CAAC,iCAAiC,CAAC,CAAA;QACvD,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAA;QACpC,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAA;QACvC,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAExC,0EAA0E;QAC1E,2EAA2E;QAC3E,yEAAyE;QACzE,KAAK,CAAC,OAAO,CAAC;YACZ,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE;YAC1G,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE;SACjH,CAAC,CAAA;QAEF,IAAI,GAA4B,CAAA;QAChC,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,GAAG,CAA0B,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE;gBACtE,EAAE,EAAE,MAAM,CAAC,MAAM;gBACjB,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;gBAC1B,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC;gBAChC,EAAE,EAAE,kBAAkB,CAAC,YAAY,CAAC;aACrC,CAAC,CAAC,CAAA;QACL,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;YACxE,sDAAsD;YACtD,MAAM,IAAI,WAAW,CAAC,kEAAkE,CAAC,CAAA;QAC3F,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,wEAAwE;YACxE,KAAK,CAAC,UAAU,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAA;YAC3C,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,IAAI,wBAAwB,CAAC,CAAA;QAC/D,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC3B,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAEpC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;QAC3D,IAAI,MAAM;YAAE,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;;YACrD,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QAE/B,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAE,CAAA;IAC/B,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;AACrD,CAAC"}

package/build/wallet/lnurlcash.js

@@ -1,40 +1,17 @@
-import { tryDecodeBolt11, bolt11AmountMsats, generatePreimage, computePaymentHash, verifyLud21, fetchJson, } from 'farrier-kit';
+import { tryDecodeBolt11, bolt11AmountMsats, verifyLud21, fetchJson, } from 'farrier-kit';
+import { createNoteOps, callbackUrl, isError, MintRefused, NoteGone, } from './lnurlcash-ops.js';
 const METHOD = 'lnurlcash';
 const DEFAULTS = {
     meltTimeoutMs: 60_000,
     meltPollMs: 1_000,
     httpTimeoutMs: 8_000,
 };
-function isError(res) {
-    return typeof res === 'object' && res !== null && res.status === 'ERROR';
-}
-/**
- * Mint responses are the only thing safe to surface. Anything thrown by the
- * HTTP layer may carry a URL, and our URLs carry note secrets in the query
- * string, so exceptions are never stringified outward.
- */
-class MintRefused extends Error {
-}
-/**
- * The mint doesn't recognise a note we thought we held. Expected, not
- * exceptional: a bearer note can be spent by anyone holding a copy, so every
- * local balance is a cache and the mint is the only authority. Signals "drop
- * this one and try the next", never "fail the payment".
- */
-class NoteGone extends Error {
-}
 function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
-/** Appends params to a callback URL that may already carry some. */
-function callbackUrl(base, params) {
-    const url = new URL(base);
-    for (const [k, v] of Object.entries(params))
-        url.searchParams.set(k, v);
-    return url.toString();
-}
 export function createLnurlcashWallet(store, options = {}, lock) {
     const cfg = { ...DEFAULTS, ...options };
+    const ops = createNoteOps(store, { httpTimeoutMs: cfg.httpTimeoutMs, fetchImpl: cfg.fetchImpl });
     let internalLock = Promise.resolve();
     const defaultLock = (fn) => {
         const result = internalLock.catch(() => { }).then(() => fn());
@@ -46,95 +23,9 @@ export function createLnurlcashWallet(store, options = {}, lock) {
         timeoutMs: cfg.httpTimeoutMs,
         fetchImpl: cfg.fetchImpl,
     });
-    /**
-     * Reads a note's current value from the mint. `null` means the mint doesn't
-     * recognise it: unknown, already spent, or pending another operation.
-     */
-    async function resolveNote(mint, secret) {
-        let res;
-        try {
-            res = await get(callbackUrl(new URL('/w', mint).toString(), { k1: secret }));
-        }
-        catch {
-            return null;
-        }
-        if (isError(res) || typeof res.maxWithdrawable !== 'number' || typeof res.callback !== 'string')
-            return null;
-        return { amountMsat: res.maxWithdrawable, callback: res.callback };
-    }
-    /**
-     * Settles notes left in an indeterminate state by an earlier crash or a melt
-     * whose outcome never came back. A provisional note the mint knows about
-     * means its split landed; one it doesn't means the split never happened. A
-     * melting note the mint still honours means the payment failed and the mint
-     * restored it.
-     */
-    async function reconcile() {
-        for (const note of [...store.byState('provisional'), ...store.byState('melting')]) {
-            const resolved = await resolveNote(note.mint, note.secret);
-            if (resolved) {
-                store.confirm(note.secret, resolved.amountMsat);
-                // A landed split burned its parent, whatever our local copy says.
-                if (note.parent)
-                    store.remove(note.parent);
-            }
-            else {
-                store.remove(note.secret);
-            }
-        }
-    }
-    /**
-     * Splits `parent` into a note worth exactly `amountMsat` plus change, and
-     * returns the exact-value note. The mint requires a melt invoice to match
-     * the note value exactly, so this is how an arbitrary invoice gets paid.
-     */
-    async function split(parent, amountMsat) {
-        const resolved = await resolveNote(parent.mint, parent.secret);
-        if (!resolved) {
-            store.remove(parent.secret);
-            throw new NoteGone('note not recognised by the mint');
-        }
-        const paySecret = generatePreimage();
-        const changeSecret = generatePreimage();
-        const addedAt = new Date().toISOString();
-        // Persisted BEFORE the request, deliberately. The mint keys the new notes
-        // to hashes of these secrets and never learns the secrets themselves, so a
-        // crash between its swap and our write would destroy the value outright.
-        store.addMany([
-            { secret: paySecret, mint: parent.mint, amountMsat, state: 'provisional', parent: parent.secret, addedAt },
-            { secret: changeSecret, mint: parent.mint, amountMsat: 0, state: 'provisional', parent: parent.secret, addedAt },
-        ]);
-        let res;
-        try {
-            res = await get(callbackUrl(resolved.callback, {
-                k1: parent.secret,
-                amount: String(amountMsat),
-                h: computePaymentHash(paySecret),
-                h2: computePaymentHash(changeSecret),
-            }));
-        }
-        catch {
-            // Outcome unknown. Leave both children provisional; reconcile() decides
-            // on the next call, once the mint can be asked again.
-            throw new MintRefused('Split outcome unknown; it will be reconciled on the next attempt');
-        }
-        if (isError(res)) {
-            // A refusal is synchronous and burns nothing, so the children are dead.
-            store.removeMany([paySecret, changeSecret]);
-            throw new MintRefused(res.reason ?? 'Mint refused the split');
-        }
-        store.remove(parent.secret);
-        store.confirm(paySecret, amountMsat);
-        const change = await resolveNote(parent.mint, changeSecret);
-        if (change)
-            store.confirm(changeSecret, change.amountMsat);
-        else
-            store.remove(changeSecret);
-        return store.find(paySecret);
-    }
     /** Melts `note` against `invoice` and waits for cryptographic settlement proof. */
     async function melt(note, invoice, paymentHashHex) {
-        const resolved = await resolveNote(note.mint, note.secret);
+        const resolved = await ops.resolveNote(note.mint, note.secret);
         if (!resolved) {
             store.remove(note.secret);
             throw new NoteGone('note not recognised by the mint');
@@ -221,7 +112,7 @@ export function createLnurlcashWallet(store, options = {}, lock) {
             return { paid: false, method: METHOD, reason: 'Amountless BOLT-11 invoices require an explicit amount and are refused' };
         }
         try {
-            await reconcile();
+            await ops.reconcile();
         }
         catch { /* best effort; selection below simply sees fewer notes */ }
         const live = store.live();
@@ -239,7 +130,7 @@ export function createLnurlcashWallet(store, options = {}, lock) {
             try {
                 const exact = candidate.amountMsat === needMsat
                     ? candidate
-                    : await split(candidate, needMsat);
+                    : await ops.split(candidate, needMsat);
                 return await melt(exact, invoice, decoded.paymentHashHex);
             }
             catch (error) {

package/build/wallet/lnurlcash.js.map

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

package/build/xlnurlcash/parse.d.ts

@@ -0,0 +1,27 @@
+export interface LnurlcashChallenge {
+    /** Price in sats. */
+    amount: number;
+    unit: 'sat';
+    /** Mints whose notes the server will accept, as hosts or URLs. */
+    mints: string[];
+}
+/** Detects whether a 402 response carries an lnurlcash challenge. */
+export declare function isLnurlcashChallenge(headers: Headers): boolean;
+/**
+ * Parses an lnurlcash payment request from the X-LNURLcash header value:
+ * `lnurlcashreq1` followed by unpadded base64url of the request's RFC 8785
+ * canonical JSON.
+ *
+ * The request is `{ v, id, amount, currency, methodDetails: { mints } }`,
+ * with the amount a decimal STRING of whole sats. That is the shape the
+ * conformance vectors pin and `lnurlcash-kit` encodes.
+ *
+ * A shorter object, `{ a: number, u, m }`, briefly went out under the same
+ * prefix before the format settled. It is still read here, because a decoder
+ * that returns nothing on a string it can plainly understand helps no one,
+ * and because the kit's own decoder accepts it too. Nothing emits it.
+ *
+ * Only `sat` exists today; anything else returns null rather than guessing at
+ * a denomination.
+ */
+export declare function parseLnurlcashChallenge(header: string): LnurlcashChallenge | null;

package/build/xlnurlcash/parse.js

@@ -0,0 +1,71 @@
+/**
+ * Payment requests are prefixed like a bech32 human-readable part so a bare
+ * string is self-describing, the way NUT-18 uses `creqA`.
+ */
+const PREFIX = 'lnurlcashreq1';
+/** Detects whether a 402 response carries an lnurlcash challenge. */
+export function isLnurlcashChallenge(headers) {
+    const value = headers.get('x-lnurlcash');
+    return !!value && value.startsWith(PREFIX);
+}
+/** A whole number of sats that survives the conversion to msat everything downstream works in. */
+function satsFrom(value) {
+    const n = typeof value === 'number'
+        ? value
+        : typeof value === 'string' && /^[0-9]+$/.test(value)
+            ? Number(value)
+            : NaN;
+    if (!Number.isSafeInteger(n) || n <= 0)
+        return null;
+    return Number.isSafeInteger(n * 1000) ? n : null;
+}
+function stringsFrom(value) {
+    if (!Array.isArray(value))
+        return null;
+    const out = value.filter((m) => typeof m === 'string' && m.length > 0);
+    return out.length > 0 ? out : null;
+}
+/**
+ * Parses an lnurlcash payment request from the X-LNURLcash header value:
+ * `lnurlcashreq1` followed by unpadded base64url of the request's RFC 8785
+ * canonical JSON.
+ *
+ * The request is `{ v, id, amount, currency, methodDetails: { mints } }`,
+ * with the amount a decimal STRING of whole sats. That is the shape the
+ * conformance vectors pin and `lnurlcash-kit` encodes.
+ *
+ * A shorter object, `{ a: number, u, m }`, briefly went out under the same
+ * prefix before the format settled. It is still read here, because a decoder
+ * that returns nothing on a string it can plainly understand helps no one,
+ * and because the kit's own decoder accepts it too. Nothing emits it.
+ *
+ * Only `sat` exists today; anything else returns null rather than guessing at
+ * a denomination.
+ */
+export function parseLnurlcashChallenge(header) {
+    if (!header.startsWith(PREFIX))
+        return null;
+    try {
+        const b64 = header.slice(PREFIX.length);
+        const json = Buffer.from(b64, 'base64url').toString('utf-8');
+        const data = JSON.parse(json);
+        if (typeof data !== 'object' || data === null)
+            return null;
+        const details = data.methodDetails;
+        const longForm = data.amount !== undefined || data.v !== undefined;
+        const amount = satsFrom(longForm ? data.amount : data.a);
+        const currency = longForm ? data.currency : data.u;
+        const mints = stringsFrom(longForm
+            ? typeof details === 'object' && details !== null
+                ? details.mints
+                : undefined
+            : data.m);
+        if (amount === null || currency !== 'sat' || !mints)
+            return null;
+        return { amount, unit: 'sat', mints };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=parse.js.map

package/build/xlnurlcash/parse.js.map

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

package/build/xlnurlcash/payment.d.ts

@@ -0,0 +1,37 @@
+import type { LnurlcashNoteStore } from '../store/lnurlcash-notes.js';
+import { type NoteOps, type NoteOpsOptions } from '../wallet/lnurlcash-ops.js';
+import type { LnurlcashChallenge } from './parse.js';
+export interface LnurlcashPaymentResult {
+    /** The bearer note URL to send in the X-LNURLcash header. */
+    header: string;
+    /** Amount in sats the note covers. */
+    amountSats: number;
+    /**
+     * Records what the paywall did with the note. `true` means it granted
+     * access, so it rotated the note and our secret is dead. `false` leaves the
+     * note held pending: only the mint can say whether it was rotated, and the
+     * next lnurlcash operation asks.
+     */
+    settle: (accepted: boolean) => void;
+}
+/**
+ * Mints arrive as bare hosts (`mint.example.com`), origins, or full discovery
+ * URLs. Compared on host so all three forms match a stored note's origin.
+ */
+export declare function mintHost(value: string): string | null;
+/**
+ * Builds a bearer-note payment for an lnurlcash challenge: an exact-value note
+ * from an accepted mint, or one split at the mint to the exact price so the
+ * paywall is never overpaid and the change stays in the store. Returns null
+ * when no note can cover it, so the caller falls through to another rail.
+ *
+ * The chosen note is held pending before it is returned. Handing a bearer note
+ * to a server puts it beyond our control: the server settles by rotating it,
+ * and only the mint knows whether that happened.
+ */
+export declare function attemptLnurlcashPayment(opts: {
+    challenge: LnurlcashChallenge;
+    noteStore: LnurlcashNoteStore;
+    ops?: NoteOps;
+    options?: NoteOpsOptions;
+}): Promise<LnurlcashPaymentResult | null>;