fiberprobe 0.1.0

package/dist/payment/checker.js

@@ -0,0 +1,388 @@
+/**
+ * PaymentChecker — pre-flight payment feasibility analysis for Fiber Network.
+ *
+ * Solves two problems every Fiber application faces:
+ *
+ *  1. canPay()     — Will this payment succeed before I try to send it?
+ *  2. canReceive() — Do I have enough inbound capacity to receive a payment?
+ *
+ * Design note: send_payment's dry_run flag was evaluated as a data source
+ * for canPay() and rejected. Live testnet testing confirmed dry-run payment
+ * sessions are never queryable via get_payment, even immediately after
+ * creation — the RPC returns "Payment session not found" on instant lookup.
+ * This means dry_run cannot supply route or fee detail synchronously or
+ * asynchronously.
+ *
+ * canPay() instead performs static graph reachability analysis:
+ *   1. parseInvoice() resolves the destination pubkey and amount
+ *   2. listChannels() checks for a direct channel to the destination
+ *   3. graphChannels() + BFS finds a multi-hop path if no direct channel exists
+ *   4. Each hop is scored against published outbound_liquidity, exactly as
+ *      a live router would need to evaluate route viability
+ *
+ * canReceive() scans open ChannelReady channels and sums usable inbound
+ * capacity, correctly accounting for in-flight received TLCs.
+ */
+import { FiberError, RouteNotFoundError } from '../client/errors.js';
+import { generateFakePaymentHash } from './probe-crypto.js';
+// ── Internal helpers ──────────────────────────────────────────────────────────
+function parseHexAmount(hex) {
+    if (!hex.startsWith('0x') && !hex.startsWith('0X')) {
+        throw new Error(`Expected hex amount string, got: ${hex}`);
+    }
+    return BigInt(hex);
+}
+/**
+ * Score a single hop against published graph liquidity data.
+ * Same rationale as the original dry-run-based scoring, applied here to
+ * statically discovered graph edges instead of live router hop data.
+ */
+function scoreHop(channel, amountToForward) {
+    const shortId = channel.channel_outpoint.slice(0, 14) + '…';
+    const published = [
+        channel.update_info_of_node1?.outbound_liquidity,
+        channel.update_info_of_node2?.outbound_liquidity,
+    ].filter((l) => l != null);
+    if (published.length === 0) {
+        return { score: 0.70 };
+    }
+    const liquidities = published.map(parseHexAmount);
+    const conservative = liquidities.reduce((a, b) => (a < b ? a : b));
+    if (conservative === 0n) {
+        return { score: 0.05, issue: `Channel ${shortId} reports zero outbound liquidity` };
+    }
+    const ratio = Number(conservative) / Number(amountToForward);
+    if (ratio >= 3.0)
+        return { score: 0.95 };
+    if (ratio >= 1.5)
+        return { score: 0.82 };
+    if (ratio >= 1.0)
+        return { score: 0.65, issue: `Channel ${shortId} has tight liquidity` };
+    return { score: 0.20, issue: `Channel ${shortId} may have insufficient liquidity for this amount` };
+}
+function computeConfidence(hopScores, hopCount) {
+    if (hopScores.length === 0)
+        return 0;
+    const weakestHop = Math.min(...hopScores);
+    const hopPenalty = Math.max(0, (hopCount - 1) * 0.03);
+    return Math.round(Math.max(0, weakestHop - hopPenalty) * 100);
+}
+/**
+ * Breadth-first search over the public channel graph to find a path from
+ * `from` to `to`. Returns the sequence of GraphChannel edges forming the
+ * path, or null if no path exists within maxHops.
+ *
+ * BFS guarantees the shortest hop-count path is found first, which is the
+ * most useful default for a payment router — fewer hops means fewer points
+ * of failure and typically lower cumulative fees.
+ */
+/**
+ * Fetches the entire public channel graph by paginating through graph_channels()
+ * until last_cursor stops changing or the safety cap is reached. Testnet graphs
+ * can exceed the default page size of any single call, so a naive single-page
+ * fetch can silently miss channels — including the caller's own, as discovered
+ * during live testing when a real ChannelReady channel was absent from the
+ * first 500-entry page.
+ *
+ * @param maxPages - Safety cap on number of pages fetched. Defaults to 20
+ *                   (i.e. up to 20 * limit channels).
+ */
+async function fetchAllGraphChannels(client, pageSize = 500, maxPages = 20) {
+    const all = [];
+    let cursor;
+    for (let page = 0; page < maxPages; page++) {
+        const result = await client.graphChannels(pageSize, cursor);
+        all.push(...result.channels);
+        if (result.channels.length < pageSize)
+            break;
+        if (result.last_cursor === cursor)
+            break;
+        cursor = result.last_cursor;
+    }
+    return all;
+}
+function findPath(from, to, channels, maxHops) {
+    // Build adjacency: pubkey -> list of { neighbor, channel }
+    const adjacency = new Map();
+    for (const ch of channels) {
+        if (!adjacency.has(ch.node1))
+            adjacency.set(ch.node1, []);
+        if (!adjacency.has(ch.node2))
+            adjacency.set(ch.node2, []);
+        adjacency.get(ch.node1).push({ neighbor: ch.node2, channel: ch });
+        adjacency.get(ch.node2).push({ neighbor: ch.node1, channel: ch });
+    }
+    if (from === to)
+        return [];
+    const visited = new Set([from]);
+    const queue = [{ node: from, path: [] }];
+    while (queue.length > 0) {
+        const { node, path } = queue.shift();
+        if (path.length >= maxHops)
+            continue;
+        const edges = adjacency.get(node) ?? [];
+        for (const { neighbor, channel } of edges) {
+            if (neighbor === to) {
+                return [...path, channel];
+            }
+            if (!visited.has(neighbor)) {
+                visited.add(neighbor);
+                queue.push({ node: neighbor, path: [...path, channel] });
+            }
+        }
+    }
+    return null;
+}
+// ── PaymentChecker ────────────────────────────────────────────────────────────
+/**
+ * Pre-flight payment feasibility analysis for Fiber Network applications.
+ *
+ * @example
+ * ```ts
+ * const checker = new PaymentChecker(client)
+ *
+ * const result = await checker.canPay({ invoice: 'fibt...' })
+ * if (!result.canPay) {
+ *   console.error(result.error?.message)
+ *   return
+ * }
+ * console.log(`Confidence: ${result.confidence}%  Hops: ${result.hopCount}`)
+ *
+ * const rx = await checker.canReceive({ amount: '0x174876e800' })
+ * if (!rx.canReceive) console.warn('Low inbound capacity:', rx.issues)
+ * ```
+ */
+export class PaymentChecker {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Performs a pre-flight feasibility check for an outgoing Fiber payment.
+     *
+     * Process:
+     *   1. Resolves the destination pubkey and amount from the invoice.
+     *   2. Checks for a direct ChannelReady channel to the destination —
+     *      if found, this is the highest-confidence path.
+     *   3. Otherwise, searches the public network graph via BFS to find
+     *      the shortest multi-hop path to the destination.
+     *   4. Scores each hop against published outbound liquidity data and
+     *      combines scores using weakest-link logic, since a payment fails
+     *      if any single hop lacks capacity.
+     */
+    async canPay(params) {
+        const maxHops = params.maxHops ?? 5;
+        // Step 1: Resolve destination from the invoice
+        let destinationPubkey;
+        let amount;
+        try {
+            const parsed = await this.client.parseInvoice(params.invoice);
+            const payeeAttr = parsed.invoice.data.attrs.find((a) => 'payee_public_key' in a);
+            if (!payeeAttr?.payee_public_key) {
+                return {
+                    canPay: false,
+                    confidence: 0,
+                    issues: ['Invoice does not specify a destination public key'],
+                    error: new RouteNotFoundError('Invoice missing payee_public_key'),
+                };
+            }
+            destinationPubkey = payeeAttr.payee_public_key;
+            amount = parsed.invoice.amount;
+        }
+        catch (err) {
+            const raw = err instanceof Error ? err.message : String(err);
+            return {
+                canPay: false,
+                confidence: 0,
+                issues: [`Failed to parse invoice: ${raw}`],
+                error: FiberError.parse(raw),
+            };
+        }
+        const amountToForward = parseHexAmount(amount);
+        // Step 2: Check for a direct ChannelReady channel to the destination
+        const myChannels = await this.client.listChannels({ include_closed: false });
+        const directChannel = myChannels.find((ch) => ch.pubkey === destinationPubkey && ch.state.state_name === 'ChannelReady');
+        if (directChannel) {
+            const localBalance = parseHexAmount(directChannel.local_balance);
+            const issues = [];
+            let confidence;
+            if (localBalance >= amountToForward * 3n) {
+                confidence = 95;
+            }
+            else if (localBalance >= amountToForward) {
+                confidence = 75;
+                issues.push('Direct channel capacity is limited relative to payment amount');
+            }
+            else {
+                return {
+                    canPay: false,
+                    confidence: 0,
+                    destinationPubkey,
+                    amount,
+                    issues: ['Direct channel exists but local balance is insufficient'],
+                    error: FiberError.parse('insufficient_capacity'),
+                };
+            }
+            return {
+                canPay: true,
+                confidence,
+                destinationPubkey,
+                amount,
+                hopCount: 0,
+                issues,
+            };
+        }
+        // Step 3: No direct channel — search the public graph
+        const allChannels = await fetchAllGraphChannels(this.client);
+        // We need our own node's pubkey to start the search from
+        const myNodeInfo = await this.client.nodeInfo();
+        const path = findPath(myNodeInfo.pubkey, destinationPubkey, allChannels, maxHops);
+        if (!path) {
+            return {
+                canPay: false,
+                confidence: 0,
+                destinationPubkey,
+                amount,
+                issues: [`No route found to destination within ${maxHops} hops`],
+                error: new RouteNotFoundError(`No path to ${destinationPubkey} within ${maxHops} hops`),
+            };
+        }
+        // Step 4: Score each hop
+        const issues = [];
+        const hopScores = [];
+        for (const channel of path) {
+            const { score, issue } = scoreHop(channel, amountToForward);
+            hopScores.push(score);
+            if (issue)
+                issues.push(issue);
+        }
+        const confidence = computeConfidence(hopScores, path.length);
+        return {
+            canPay: true,
+            confidence,
+            destinationPubkey,
+            amount,
+            hopCount: path.length,
+            issues,
+        };
+    }
+    /**
+     * Checks whether this node has sufficient inbound capacity to receive a payment.
+     *
+     * Usable inbound per channel = remote_balance − received_tlc_balance.
+     * Only ChannelReady + enabled channels are included.
+     */
+    async canReceive(params) {
+        const targetAmount = parseHexAmount(params.amount);
+        const channels = await this.client.listChannels({ include_closed: false });
+        const issues = [];
+        const breakdown = [];
+        let total = 0n;
+        for (const ch of channels) {
+            if (ch.state.state_name !== 'ChannelReady')
+                continue;
+            const isUdtChannel = ch.funding_udt_type_script != null;
+            if (params.udtTypeScriptHash !== undefined && !isUdtChannel)
+                continue;
+            if (params.udtTypeScriptHash === undefined && isUdtChannel)
+                continue;
+            const remoteBalance = parseHexAmount(ch.remote_balance);
+            const inflightInbound = parseHexAmount(ch.received_tlc_balance);
+            const usable = remoteBalance > inflightInbound
+                ? remoteBalance - inflightInbound
+                : 0n;
+            const entry = {
+                channelId: ch.channel_id,
+                pubkey: ch.pubkey,
+                usableInbound: usable,
+                isEnabled: ch.enabled,
+            };
+            breakdown.push(entry);
+            if (!ch.enabled) {
+                issues.push(`Channel ${ch.channel_id.slice(0, 14)}… is ChannelReady but disabled for forwarding`);
+                continue;
+            }
+            total += usable;
+        }
+        if (total < targetAmount) {
+            const shortfall = targetAmount - total;
+            issues.push(`Total usable inbound: ${total} shannon. Shortfall: ${shortfall} shannon. ` +
+                `Ask a peer to push liquidity to your side, or open a new channel.`);
+        }
+        return {
+            canReceive: total >= targetAmount,
+            totalInboundCapacity: total,
+            activeChannelCount: breakdown.filter((c) => c.isEnabled).length,
+            channelBreakdown: breakdown,
+            issues,
+        };
+    }
+    /**
+     * Performs a live liquidity probe against a real destination pubkey.
+     *
+     * Sends a real HTLC using a randomly generated, never-revealed preimage.
+     * Funds cannot be lost: since the preimage is never shared, no node along
+     * the route -- including the destination -- can ever claim the payment.
+     *
+     * Terminal outcomes:
+     *   - Destination returns IncorrectOrUnknownPaymentDetails: the entire
+     *     route had enough live liquidity right now to carry this exact
+     *     amount. This is a genuine empirical signal, not a static estimate.
+     *   - Any other failure (e.g. TemporaryChannelFailure): a specific hop
+     *     lacks liquidity or is unreachable. Parsed into a typed FiberError.
+     *
+     * This is slower and costs a brief HTLC lock on every hop versus canPay(),
+     * so use canPay() as the fast default and probePay() when you need
+     * ground-truth confidence immediately before a real payment.
+     */
+    async probePay(params) {
+        const start = Date.now();
+        const { paymentHash } = await generateFakePaymentHash();
+        const timeoutMs = (params.timeoutSeconds ?? 15) * 1000;
+        try {
+            await this.client.sendPayment({
+                target_pubkey: params.targetPubkey,
+                amount: params.amount,
+                payment_hash: paymentHash,
+                keysend: false,
+            });
+        }
+        catch (err) {
+            const raw = err instanceof Error ? err.message : String(err);
+            return { isViable: false, terminalError: raw, error: FiberError.parse(raw), latencyMs: Date.now() - start };
+        }
+        // Poll for the terminal state. The probe self-resolves quickly in
+        // practice (observed ~130ms against live testnet nodes in this project)
+        // because the fake hash is rejected as soon as the HTLC reaches the
+        // destination -- there is no real invoice to wait on.
+        let intervalMs = 200;
+        while (Date.now() - start < timeoutMs) {
+            try {
+                const payment = await this.client.getPayment(paymentHash);
+                if (payment.status === 'Success') {
+                    // Should not happen with a fake hash, but handle it safely.
+                    return { isViable: true, latencyMs: Date.now() - start };
+                }
+                if (payment.status === 'Failed') {
+                    const raw = payment.failed_error ?? '';
+                    if (raw.includes('IncorrectOrUnknownPaymentDetails')) {
+                        return { isViable: true, terminalError: raw, latencyMs: Date.now() - start };
+                    }
+                    return { isViable: false, terminalError: raw, error: FiberError.parse(raw), latencyMs: Date.now() - start };
+                }
+            }
+            catch {
+                // Payment session not yet queryable -- keep polling until timeout.
+            }
+            await new Promise((r) => setTimeout(r, intervalMs));
+            intervalMs = Math.min(intervalMs * 1.5, 1500);
+        }
+        return {
+            isViable: false,
+            terminalError: 'Probe timed out before resolving',
+            error: FiberError.parse('payment_timeout'),
+            latencyMs: Date.now() - start,
+        };
+    }
+}
+//# sourceMappingURL=checker.js.map

package/dist/payment/checker.js.map

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

package/dist/payment/events.d.ts

@@ -0,0 +1,135 @@
+/**
+ * FiberEventEmitter — event-driven payment and invoice lifecycle for Fiber Network.
+ *
+ * The Fiber RPC does not expose a push-based subscription interface over the
+ * standard JSON-RPC port. This module bridges that gap with per-item adaptive
+ * polling: each watched payment, invoice, or channel gets its own backoff
+ * schedule so recently-started items are checked frequently while long-running
+ * ones are polled progressively less often.
+ *
+ * This is architecturally cleaner than a single global polling loop because:
+ *  - Items at different lifecycle stages don't share a tick
+ *  - Backoff is independent per item — a stale payment doesn't slow invoice checks
+ *  - Callers receive a cancel function, giving them explicit lifecycle control
+ *
+ * @example
+ * ```ts
+ * const emitter = new FiberEventEmitter(client)
+ *
+ * // Watch a payment until it settles
+ * const cancel = emitter.watchPayment('0xabc...', {
+ *   onSettled: (payment) => console.log('Payment settled:', payment.status),
+ *   onFailed:  (err)     => console.error('Payment failed:', err.suggestion),
+ * })
+ *
+ * // Watch an invoice until it's paid
+ * emitter.watchInvoice('0xdef...', {
+ *   onPaid:    (invoice) => console.log('Paid!', invoice.invoice_address),
+ *   onExpired: (invoice) => console.warn('Invoice expired'),
+ * })
+ *
+ * // Clean up everything at once
+ * emitter.destroy()
+ * ```
+ */
+import type { FiberClient } from '../client/index.js';
+import type { Payment, InvoiceResult, Channel } from '../client/types.js';
+import { FiberError } from '../client/errors.js';
+/**
+ * Backoff profile controlling how poll intervals grow over time.
+ * All durations are in milliseconds.
+ */
+export interface BackoffProfile {
+    /** Initial polling interval. Default: 500ms */
+    initialMs: number;
+    /** Multiplier applied after each poll. Default: 1.5 */
+    multiplier: number;
+    /** Maximum polling interval. Default: 10_000ms (10s) */
+    maxMs: number;
+    /** Maximum number of poll attempts before giving up. Default: 60 */
+    maxAttempts: number;
+}
+export interface WatchPaymentOptions {
+    /** Called when the payment reaches Success or Failed status. */
+    onSettled?: (payment: Payment) => void;
+    /** Called when the payment fails. Receives a structured FiberError. */
+    onFailed?: (error: FiberError, payment: Payment) => void;
+    /** Called on each poll while the payment is still Inflight. */
+    onProgress?: (payment: Payment, attempt: number) => void;
+    /** Called when maxAttempts is reached without a terminal status. */
+    onTimeout?: (lastPayment: Payment | null) => void;
+    backoff?: Partial<BackoffProfile>;
+}
+export interface WatchInvoiceOptions {
+    /** Called when the invoice status becomes Paid. */
+    onPaid?: (invoice: InvoiceResult) => void;
+    /** Called when the invoice status becomes Expired or Cancelled. */
+    onExpired?: (invoice: InvoiceResult) => void;
+    /** Called on each poll while the invoice is still Open. */
+    onProgress?: (invoice: InvoiceResult, attempt: number) => void;
+    /** Called when maxAttempts is reached without a terminal status. */
+    onTimeout?: (lastInvoice: InvoiceResult | null) => void;
+    backoff?: Partial<BackoffProfile>;
+}
+export interface WatchChannelOptions {
+    /** Called when the channel reaches ChannelReady state. */
+    onReady?: (channel: Channel) => void;
+    /** Called when the channel reaches Closed state. */
+    onClosed?: (channel: Channel) => void;
+    /** Called on each poll while the channel is still opening. */
+    onProgress?: (channel: Channel, attempt: number) => void;
+    /** Called when maxAttempts is reached without a terminal state. */
+    onTimeout?: (lastChannel: Channel | null) => void;
+    backoff?: Partial<BackoffProfile>;
+}
+/** Function returned by all watch methods. Call it to cancel the watcher. */
+export type CancelFn = () => void;
+export declare class FiberEventEmitter {
+    private readonly client;
+    private readonly watchers;
+    private watcherCount;
+    constructor(client: FiberClient);
+    /**
+     * Polls get_payment until the payment reaches a terminal status (Success/Failed)
+     * or maxAttempts is exhausted.
+     *
+     * @param paymentHash - The payment hash to watch
+     * @param options     - Callbacks and optional backoff overrides
+     * @returns           A cancel function — call it to stop polling immediately
+     */
+    watchPayment(paymentHash: string, options?: WatchPaymentOptions): CancelFn;
+    /**
+     * Polls get_invoice until the invoice is Paid, Expired, or Cancelled,
+     * or maxAttempts is exhausted.
+     *
+     * @param paymentHash - The payment hash identifying the invoice to watch
+     * @param options     - Callbacks and optional backoff overrides
+     * @returns           A cancel function
+     */
+    watchInvoice(paymentHash: string, options?: WatchInvoiceOptions): CancelFn;
+    /**
+     * Polls list_channels filtered to a specific channel_id until the channel
+     * reaches ChannelReady or Closed, or maxAttempts is exhausted.
+     *
+     * Useful for giving users feedback during the channel-opening flow without
+     * requiring them to poll manually.
+     *
+     * @param channelId - The channel_id to watch
+     * @param options   - Callbacks and optional backoff overrides
+     * @returns         A cancel function
+     */
+    watchChannel(channelId: string, options?: WatchChannelOptions): CancelFn;
+    /**
+     * Returns the number of currently active watchers.
+     * Useful for debugging and testing.
+     */
+    get activeWatcherCount(): number;
+    /**
+     * Cancels all active watchers and clears all timers.
+     * Call this when tearing down the application or component.
+     */
+    destroy(): void;
+    private cleanup;
+    private resolveProfile;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/payment/events.d.ts.map

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