perp-cli 0.14.3 → 0.15.0

package/dist/venue-health.js

@@ -0,0 +1,75 @@
+/**
+ * Venue connectivity probe — the one implementation behind `perp health`,
+ * `perp portfolio --health` and the MCP `health_check` tool.
+ *
+ * Pacifica / Hyperliquid / Lighter / Aster / QFEX / GRVT: a REST ping (status = HTTP status, 0 = no
+ * response). Every other venue — including read-only (market-data-only) venues such as TxFlow —
+ * is probed with its public market-data read (status null). A venue with no environment on the
+ * selected network (TxFlow has no testnet) is not probed and is listed in `skipped`.
+ *
+ * The ping helpers (shared-api) read the shared API URLs, which follow the network the caller
+ * selected (setSharedApiNetwork); Aster / QFEX / market-data probes take `network` directly.
+ */
+import { extractErrorMessage } from "./errors.js";
+import { getVenue, listVenues, networkConfig } from "./exchanges/venue.js";
+import { pingHyperliquid, pingLighter, pingPacifica } from "./shared-api.js";
+import "./exchanges/venues/index.js";
+async function timed(probe, fn) {
+    const start = Date.now();
+    try {
+        const r = await fn();
+        return { ok: r.ok, latencyMs: Date.now() - start, status: r.status, error: r.ok ? null : `HTTP ${r.status}`, probe };
+    }
+    catch (e) {
+        return { ok: false, latencyMs: Date.now() - start, status: probe === "ping" ? 0 : null, error: extractErrorMessage(e), probe };
+    }
+}
+const restPing = (url) => timed("ping", async () => {
+    const res = await fetch(url);
+    return { ok: res.ok, status: res.status };
+});
+/** shared-api helpers report a transport failure as status 0 with no message. */
+const helperPing = (fn) => async () => {
+    const r = await fn();
+    return { ...r, error: r.ok ? null : r.status === 0 ? "no response" : `HTTP ${r.status}`, probe: "ping" };
+};
+function pingFor(id, network) {
+    switch (id) {
+        case "pacifica": return helperPing(pingPacifica);
+        case "hyperliquid": return helperPing(pingHyperliquid);
+        case "lighter": return helperPing(pingLighter);
+        case "aster": return () => restPing(`${networkConfig(getVenue("aster"), network).restUrl}/fapi/v1/time`);
+        // QFEX: public GET /refdata for one instrument.
+        case "qfex": return () => restPing(`${networkConfig(getVenue("qfex"), network).restUrl}/refdata?ticker=AAPL-USD`);
+        // GRVT: one public instrument read (the market-data probe would fan out over every ticker).
+        case "grvt": return () => timed("ping", async () => {
+            const res = await fetch(`${networkConfig(getVenue("grvt"), network).restUrl}/full/v1/instrument`, {
+                method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ instrument: "BTC_USDT_Perp" }),
+            });
+            return { ok: res.ok, status: res.status };
+        });
+        default: return null;
+    }
+}
+/**
+ * Probe `venueIds` (default: every registered venue) on `network`, in parallel. Never throws for a
+ * venue failure — each failure is a probe with ok:false and its message.
+ */
+export async function probeVenueHealth(network, venueIds) {
+    const defs = venueIds === undefined ? listVenues() : venueIds.map(id => getVenue(id));
+    const skipped = [];
+    const probed = defs.filter(v => {
+        if (v.networks[network] !== null)
+            return true;
+        skipped.push({ venue: v.id, reason: `${v.displayName} has no ${network} environment` });
+        return false;
+    });
+    const results = await Promise.all(probed.map(v => {
+        const ping = pingFor(v.id, network);
+        return ping !== null
+            ? ping()
+            : timed("markets", async () => { await v.publicData.fetchMarkets(network); return { ok: true, status: null }; });
+    }));
+    const probes = probed.map((v, i) => ({ venue: v.id, ...results[i], apiStatus: v.apiStatus.kind }));
+    return { probes, skipped, allHealthy: probes.every(p => p.ok) };
+}

package/dist/withdraw-gate.d.ts

@@ -1,6 +1,6 @@
 /**
  * Withdraw gate for venues whose withdrawals are authorized by an API key alone — no owner
- * signature (settings.withdraw.<venue>; today: qfex). Design §14.12 #8.
+ * signature (settings.withdraw.<venue>; today: qfex)..
  *
  * Before such a withdrawal is sent it must pass, locally:
  *   1. a gate is configured at all (absent → refused);

package/dist/withdraw-gate.js

@@ -1,6 +1,6 @@
 /**
  * Withdraw gate for venues whose withdrawals are authorized by an API key alone — no owner
- * signature (settings.withdraw.<venue>; today: qfex). Design §14.12 #8.
+ * signature (settings.withdraw.<venue>; today: qfex)..
  *
  * Before such a withdrawal is sent it must pass, locally:
  *   1. a gate is configured at all (absent → refused);