fiberprobe 0.1.0

package/dist/payment/events.js

@@ -0,0 +1,256 @@
+/**
+ * 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 { FiberError } from '../client/errors.js';
+const DEFAULT_BACKOFF = {
+    initialMs: 500,
+    multiplier: 1.5,
+    maxMs: 10_000,
+    maxAttempts: 60,
+};
+// ── FiberEventEmitter ─────────────────────────────────────────────────────────
+export class FiberEventEmitter {
+    client;
+    watchers = new Map();
+    watcherCount = 0;
+    constructor(client) {
+        this.client = client;
+    }
+    // ── Payment watcher ─────────────────────────────────────────────────────────
+    /**
+     * 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, options = {}) {
+        const profile = this.resolveProfile(options.backoff);
+        const watchId = `payment:${paymentHash}:${++this.watcherCount}`;
+        let interval = profile.initialMs;
+        let attempts = 0;
+        let lastPayment = null;
+        const poll = async () => {
+            if (!this.watchers.has(watchId))
+                return;
+            attempts++;
+            try {
+                const payment = await this.client.getPayment(paymentHash);
+                lastPayment = payment;
+                if (payment.status === 'Success') {
+                    options.onSettled?.(payment);
+                    this.cleanup(watchId);
+                    return;
+                }
+                if (payment.status === 'Failed') {
+                    const raw = payment.failed_error ?? 'Payment failed with no error detail';
+                    const err = FiberError.parse(raw);
+                    options.onFailed?.(err, payment);
+                    options.onSettled?.(payment);
+                    this.cleanup(watchId);
+                    return;
+                }
+                // Still Inflight or Created
+                options.onProgress?.(payment, attempts);
+            }
+            catch (err) {
+                // RPC errors are non-fatal during polling — the node may be briefly busy
+                // We continue polling until maxAttempts, then surface via onTimeout
+            }
+            if (attempts >= profile.maxAttempts) {
+                options.onTimeout?.(lastPayment);
+                this.cleanup(watchId);
+                return;
+            }
+            // Schedule next poll with backoff
+            interval = Math.min(interval * profile.multiplier, profile.maxMs);
+            const watcher = this.watchers.get(watchId);
+            if (watcher) {
+                watcher.timer = setTimeout(() => { void poll(); }, interval);
+            }
+        };
+        const timer = setTimeout(() => { void poll(); }, interval);
+        const cancel = () => this.cleanup(watchId);
+        this.watchers.set(watchId, { id: watchId, timer, cancel });
+        return cancel;
+    }
+    // ── Invoice watcher ─────────────────────────────────────────────────────────
+    /**
+     * 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, options = {}) {
+        const profile = this.resolveProfile(options.backoff);
+        const watchId = `invoice:${paymentHash}:${++this.watcherCount}`;
+        let interval = profile.initialMs;
+        let attempts = 0;
+        let lastInvoice = null;
+        const poll = async () => {
+            if (!this.watchers.has(watchId))
+                return;
+            attempts++;
+            try {
+                const invoice = await this.client.getInvoice(paymentHash);
+                lastInvoice = invoice;
+                if (invoice.status === 'Paid') {
+                    options.onPaid?.(invoice);
+                    this.cleanup(watchId);
+                    return;
+                }
+                if (invoice.status === 'Expired' || invoice.status === 'Cancelled') {
+                    options.onExpired?.(invoice);
+                    this.cleanup(watchId);
+                    return;
+                }
+                // Still Open or Received
+                options.onProgress?.(invoice, attempts);
+            }
+            catch {
+                // Continue polling on transient RPC errors
+            }
+            if (attempts >= profile.maxAttempts) {
+                options.onTimeout?.(lastInvoice);
+                this.cleanup(watchId);
+                return;
+            }
+            interval = Math.min(interval * profile.multiplier, profile.maxMs);
+            const watcher = this.watchers.get(watchId);
+            if (watcher) {
+                watcher.timer = setTimeout(() => { void poll(); }, interval);
+            }
+        };
+        const timer = setTimeout(() => { void poll(); }, interval);
+        const cancel = () => this.cleanup(watchId);
+        this.watchers.set(watchId, { id: watchId, timer, cancel });
+        return cancel;
+    }
+    // ── Channel watcher ─────────────────────────────────────────────────────────
+    /**
+     * 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, options = {}) {
+        const profile = this.resolveProfile(options.backoff);
+        const watchId = `channel:${channelId}:${++this.watcherCount}`;
+        let interval = profile.initialMs;
+        let attempts = 0;
+        let lastChannel = null;
+        const poll = async () => {
+            if (!this.watchers.has(watchId))
+                return;
+            attempts++;
+            try {
+                const channels = await this.client.listChannels({ include_closed: true });
+                const channel = channels.find((c) => c.channel_id === channelId);
+                if (!channel) {
+                    // Channel not yet visible — keep polling
+                    options.onProgress?.(null, attempts);
+                }
+                else {
+                    lastChannel = channel;
+                    if (channel.state.state_name === 'ChannelReady') {
+                        options.onReady?.(channel);
+                        this.cleanup(watchId);
+                        return;
+                    }
+                    if (channel.state.state_name === 'Closed') {
+                        options.onClosed?.(channel);
+                        this.cleanup(watchId);
+                        return;
+                    }
+                    options.onProgress?.(channel, attempts);
+                }
+            }
+            catch {
+                // Continue on transient errors
+            }
+            if (attempts >= profile.maxAttempts) {
+                options.onTimeout?.(lastChannel);
+                this.cleanup(watchId);
+                return;
+            }
+            interval = Math.min(interval * profile.multiplier, profile.maxMs);
+            const watcher = this.watchers.get(watchId);
+            if (watcher) {
+                watcher.timer = setTimeout(() => { void poll(); }, interval);
+            }
+        };
+        const timer = setTimeout(() => { void poll(); }, interval);
+        const cancel = () => this.cleanup(watchId);
+        this.watchers.set(watchId, { id: watchId, timer, cancel });
+        return cancel;
+    }
+    // ── Lifecycle ────────────────────────────────────────────────────────────────
+    /**
+     * Returns the number of currently active watchers.
+     * Useful for debugging and testing.
+     */
+    get activeWatcherCount() {
+        return this.watchers.size;
+    }
+    /**
+     * Cancels all active watchers and clears all timers.
+     * Call this when tearing down the application or component.
+     */
+    destroy() {
+        for (const watcher of this.watchers.values()) {
+            if (watcher.timer !== null)
+                clearTimeout(watcher.timer);
+        }
+        this.watchers.clear();
+    }
+    // ── Private ──────────────────────────────────────────────────────────────────
+    cleanup(watchId) {
+        const watcher = this.watchers.get(watchId);
+        if (watcher?.timer !== null)
+            clearTimeout(watcher.timer);
+        this.watchers.delete(watchId);
+    }
+    resolveProfile(override) {
+        return { ...DEFAULT_BACKOFF, ...override };
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/payment/events.js.map

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

package/dist/payment/probe-crypto.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Isomorphic Web Crypto helpers for payment probing.
+ * Uses globalThis.crypto so this works unchanged in the browser (Vite/React
+ * demo) and in Node 19+, with no extra dependency.
+ */
+/** Generates a random 32-byte value and its SHA-256 hash, both as 0x-prefixed hex. */
+export declare function generateFakePaymentHash(): Promise<{
+    preimage: string;
+    paymentHash: string;
+}>;
+//# sourceMappingURL=probe-crypto.d.ts.map

package/dist/payment/probe-crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-crypto.d.ts","sourceRoot":"","sources":["../../src/payment/probe-crypto.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,sFAAsF;AACtF,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAQlG"}

package/dist/payment/probe-crypto.js

@@ -0,0 +1,21 @@
+/**
+ * Isomorphic Web Crypto helpers for payment probing.
+ * Uses globalThis.crypto so this works unchanged in the browser (Vite/React
+ * demo) and in Node 19+, with no extra dependency.
+ */
+function toHex(buf) {
+    return Array.from(new Uint8Array(buf))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+/** Generates a random 32-byte value and its SHA-256 hash, both as 0x-prefixed hex. */
+export async function generateFakePaymentHash() {
+    const bytes = new Uint8Array(32);
+    globalThis.crypto.getRandomValues(bytes);
+    const digest = await globalThis.crypto.subtle.digest('SHA-256', bytes);
+    return {
+        preimage: '0x' + toHex(bytes.buffer),
+        paymentHash: '0x' + toHex(digest),
+    };
+}
+//# sourceMappingURL=probe-crypto.js.map

package/dist/payment/probe-crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-crypto.js","sourceRoot":"","sources":["../../src/payment/probe-crypto.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS,KAAK,CAAC,GAAgB;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAChC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IACtE,OAAO;QACL,QAAQ,EAAK,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QACvC,WAAW,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;KAClC,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "fiberprobe",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Fiber Network Node (FNN) — typed RPC client, static route estimation, live HTLC-based liquidity probing, inbound capacity checks, and event-driven payment lifecycle.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "fiber",
+    "ckb",
+    "nervos",
+    "fnn",
+    "payment-channel",
+    "lightning",
+    "htlc",
+    "typescript",
+    "sdk",
+    "probing"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Linnnetteseven/fnn-ts.git"
+  },
+  "homepage": "https://github.com/Linnnetteseven/fnn-ts#readme",
+  "bugs": {
+    "url": "https://github.com/Linnnetteseven/fnn-ts/issues"
+  },
+  "author": "Linnette Mugwanja",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "typescript": "^7.0.2"
+  }
+}