@antseed/node 0.2.114 → 0.2.115

package/dist/payments/rpc-health.js

@@ -0,0 +1,177 @@
+/**
+ * Background chain-RPC reachability monitor.
+ *
+ * Payments must never be disabled for a whole session because the RPC was
+ * unreachable for 1.5 seconds at launch: buyer-side payments only *sign*
+ * off-chain (ReserveAuth / SpendingAuth) and all on-chain reads at request
+ * time are best-effort. This monitor turns "is the chain reachable?" into a
+ * live signal — callers keep payments enabled and consult `reachable` to skip
+ * on-chain reads while the RPC is down, instead of deciding once at startup.
+ *
+ * Probing stops after the first success — there is no steady-state polling.
+ * A later outage is re-detected on demand: call sites report observed on-chain
+ * failures via `reportFailure()`, which restarts the backoff probe loop until
+ * the RPC answers again. `probeNow()` runs a single re-check on demand.
+ */
+const DEFAULT_PROBE_TIMEOUT_MS = 1_500;
+const DEFAULT_RETRY_BASE_MS = 5_000;
+const DEFAULT_RETRY_MAX_MS = 60_000;
+/** POST eth_chainId to one endpoint; true only for a well-formed 0x result. */
+export async function probeRpcEndpoint(rpcUrl, timeoutMs = DEFAULT_PROBE_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(rpcUrl, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'eth_chainId', params: [] }),
+            signal: controller.signal,
+        });
+        if (!response.ok)
+            return false;
+        const payload = await response.json();
+        return typeof payload.result === 'string' && payload.result.startsWith('0x');
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export class RpcHealthMonitor {
+    _rpcUrls;
+    _probeTimeoutMs;
+    _retryBaseMs;
+    _retryMaxMs;
+    _onReady = [];
+    _state = 'unknown';
+    _lastCheckedAt = null;
+    _lastReadyAt = null;
+    _lastError = null;
+    _attempts = 0;
+    _timer = null;
+    _probing = null;
+    _loopActive = false;
+    _stopped = false;
+    constructor(options) {
+        if (options.rpcUrls.length === 0) {
+            throw new Error('RpcHealthMonitor requires at least one RPC URL');
+        }
+        this._rpcUrls = [...options.rpcUrls];
+        this._probeTimeoutMs = options.probeTimeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+        this._retryBaseMs = options.retryBaseMs ?? DEFAULT_RETRY_BASE_MS;
+        this._retryMaxMs = options.retryMaxMs ?? DEFAULT_RETRY_MAX_MS;
+    }
+    /**
+     * False only while the RPC is known-unreachable. 'unknown' counts as
+     * reachable so the first requests are not gated on a probe that has not
+     * finished — call sites tolerate their own on-chain failures.
+     */
+    get reachable() {
+        return this._state !== 'unreachable';
+    }
+    status() {
+        return {
+            state: this._state,
+            lastCheckedAt: this._lastCheckedAt,
+            lastReadyAt: this._lastReadyAt,
+            lastError: this._lastError,
+            attempts: this._attempts,
+        };
+    }
+    /** Fired on every transition into 'ready' (first success after start or after a failed run). */
+    onReady(listener) {
+        this._onReady.push(listener);
+    }
+    /** Begin probing; retries with backoff until the first success, then stops. */
+    start() {
+        this._stopped = false;
+        if (!this._loopActive) {
+            void this._runProbeLoop(0);
+        }
+    }
+    stop() {
+        this._stopped = true;
+        this._loopActive = false;
+        if (this._timer) {
+            clearTimeout(this._timer);
+            this._timer = null;
+        }
+    }
+    /**
+     * Tell the monitor an on-chain read just failed. Restarts background probing
+     * (with backoff) so a mid-session outage is re-detected and `reachable`
+     * flips to false until the RPC answers again. No-op while a probe loop is
+     * already running, so bursts of failures cost at most one probe round.
+     */
+    reportFailure() {
+        if (this._stopped || this._loopActive)
+            return;
+        void this._runProbeLoop(0);
+    }
+    /** One on-demand probe round; updates state and returns the outcome. */
+    probeNow() {
+        if (this._probing)
+            return this._probing;
+        const run = this._probeOnce().finally(() => {
+            this._probing = null;
+        });
+        this._probing = run;
+        return run;
+    }
+    async _probeOnce() {
+        let ok = false;
+        let lastError = null;
+        for (const url of this._rpcUrls) {
+            if (await probeRpcEndpoint(url, this._probeTimeoutMs)) {
+                ok = true;
+                break;
+            }
+            lastError = `no eth_chainId response from ${url} within ${this._probeTimeoutMs}ms`;
+        }
+        this._attempts += 1;
+        this._lastCheckedAt = Date.now();
+        if (ok) {
+            const wasReady = this._state === 'ready';
+            this._state = 'ready';
+            this._lastReadyAt = this._lastCheckedAt;
+            this._lastError = null;
+            if (!wasReady) {
+                for (const listener of this._onReady) {
+                    try {
+                        listener();
+                    }
+                    catch {
+                        // Listener errors must not break the monitor.
+                    }
+                }
+            }
+        }
+        else {
+            this._state = 'unreachable';
+            this._lastError = lastError;
+        }
+        return ok;
+    }
+    async _runProbeLoop(round) {
+        if (this._stopped) {
+            this._loopActive = false;
+            return;
+        }
+        this._loopActive = true;
+        const ok = await this.probeNow();
+        if (ok || this._stopped) {
+            this._loopActive = false;
+            return;
+        }
+        const delay = Math.min(this._retryBaseMs * 2 ** round, this._retryMaxMs);
+        this._timer = setTimeout(() => {
+            this._timer = null;
+            void this._runProbeLoop(round + 1);
+        }, delay);
+        // Do not hold the process open just to re-probe a dead RPC.
+        this._timer.unref?.();
+    }
+}
+//# sourceMappingURL=rpc-health.js.map

package/dist/payments/rpc-health.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antseed/node",
-  "version": "0.2.114",
+  "version": "0.2.115",
   "description": "Antseed Network protocol SDK — P2P inference marketplace",
   "type": "module",
   "files": [
@@ -62,8 +62,8 @@
     "node-datachannel": "^0.7.0",
     "tokenx": "^1.3.0",
     "@antseed/api-adapter": "0.1.45",
-    "@antseed/protocol": "0.1.4",
-    "@antseed/buyer-core": "0.1.6"
+    "@antseed/buyer-core": "0.1.7",
+    "@antseed/protocol": "0.1.4"
   },
   "optionalDependencies": {
     "keytar": "^7.9.0"