perp-cli 0.15.0 → 0.16.0

package/dist/ws/node.js

@@ -29,6 +29,14 @@ var WsError = class extends Error {
       ...opts?.details !== void 0 ? { details: opts.details } : {}
     };
   }
+  /** `structured.code` — the same place as `code` on error events (`e.code`). */
+  get code() {
+    return this.structured.code;
+  }
+  /** `structured.remediation` — the same place as `remediation` on error events; null when none. */
+  get remediation() {
+    return this.structured.remediation === void 0 ? null : this.structured.remediation;
+  }
 };
 function isPerpError(e) {
   if (e === null || typeof e !== "object") return false;
@@ -37,11 +45,89 @@ function isPerpError(e) {
   return typeof s.code === "string" && typeof s.message === "string";
 }
 
+// src/ws/unclassified.ts
+var UNCLASSIFIED_TICKERS = {
+  hyperliquid: /* @__PURE__ */ new Set(["SPX"]),
+  aster: /* @__PURE__ */ new Set(["SPX"]),
+  pacifica: /* @__PURE__ */ new Set(["SPX", "BP", "CHIP"]),
+  lighter: /* @__PURE__ */ new Set(["BB", "BOT", "WEN", "QNT", "SPX"])
+};
+var LIGHTER_RH_CLASS = {
+  // crypto
+  BTC: "crypto",
+  ETH: "crypto",
+  SOL: "crypto",
+  HYPE: "crypto",
+  ZEC: "crypto",
+  LIT: "crypto",
+  VVV: "crypto",
+  SUI: "crypto",
+  NEAR: "crypto",
+  XRP: "crypto",
+  CASHCAT: "crypto",
+  PONS: "crypto",
+  // commodity (canonical via EXPLICIT_CANONICAL: XAU → GOLD, XAG → SILVER)
+  XAU: "commodity",
+  XAG: "commodity",
+  // etf
+  SPY: "etf",
+  QQQ: "etf",
+  SOXL: "etf",
+  SLV: "etf",
+  USO: "etf",
+  SGOV: "etf",
+  // equity
+  AAPL: "equity",
+  AMZN: "equity",
+  GOOGL: "equity",
+  META: "equity",
+  MSFT: "equity",
+  NVDA: "equity",
+  TSLA: "equity",
+  AMD: "equity",
+  INTC: "equity",
+  MU: "equity",
+  TSM: "equity",
+  ORCL: "equity",
+  PLTR: "equity",
+  COIN: "equity",
+  CRCL: "equity",
+  CRWV: "equity",
+  BABA: "equity",
+  SNDK: "equity",
+  SMCI: "equity",
+  SOFI: "equity",
+  AMC: "equity",
+  RGTI: "equity",
+  QBTS: "equity",
+  CLSK: "equity",
+  IREN: "equity",
+  WULF: "equity",
+  LUNR: "equity",
+  ASTS: "equity",
+  BE: "equity",
+  USAR: "equity",
+  SPCX: "equity",
+  SKHY: "equity",
+  // pre-IPO / private (explicit-only canonical → null unless mapped)
+  OPENAI: "preIpo",
+  ANTHROPIC: "preIpo",
+  SHEIN: "preIpo",
+  ANSEM: "preIpo",
+  AI: "preIpo"
+};
+function isUnclassifiedTicker(venue, base) {
+  const up = base.toUpperCase();
+  if (venue === "lighter-rh") return LIGHTER_RH_CLASS[up] === void 0;
+  return UNCLASSIFIED_TICKERS[venue]?.has(up) === true;
+}
+
 // src/ws/canonical.ts
 var USD_LIKE_QUOTES = /* @__PURE__ */ new Set(["USDT", "USD1", "USDC", "USD", "USDG"]);
-var defaultCanonicalize = (_venue, m) => {
+var defaultCanonicalize = (venue, m) => {
   const base = m.base.toUpperCase();
   if (m.dex !== null && m.dex !== "") return `${m.dex}:${base}`;
+  if (isUnclassifiedTicker(venue, base)) return null;
   if (m.quote === null) return null;
   return USD_LIKE_QUOTES.has(m.quote.toUpperCase()) ? base : null;
 };
@@ -114,6 +200,7 @@ var Connection = class {
     this.sendQueue = [];
     this.sendTimer = null;
     this.reconnectTimer = null;
+    this.closing = /* @__PURE__ */ new Set();
     this.staleTimer = null;
     this.pingTimer = null;
     this.awaitingPongSince = null;
@@ -438,15 +525,26 @@ var Connection = class {
         ws.close(code, reason);
       } catch {
       }
+      if (ws.whenClosed !== void 0) {
+        const p = ws.whenClosed;
+        this.closing.add(p);
+        void p.then(() => {
+          this.closing.delete(p);
+        });
+      }
     }
   }
+  /** Settles when every socket this connection closed is fully gone (transports that report it). */
+  drained() {
+    return Promise.all(Array.from(this.closing)).then(() => void 0);
+  }
 };
 function stateDetails(s) {
   const { status: _status, ...rest } = s;
   return rest;
 }
 function closedError(venue) {
-  return new WsError("INVALID_PARAMS", `${venue} stream is closed`, { exchange: venue, remediation: "Create a new stream" });
+  return new WsError("INVALID_PARAMS", `${venue} stream is closed`, { exchange: venue, remediation: "Create a new stream", details: { closeReason: "CLIENT_CLOSE" } });
 }
 
 // src/ws/ids.ts
@@ -976,6 +1074,7 @@ function checkCodec(codec) {
     throw new WsError("INVALID_PARAMS", `createVenueStream: first argument must be a venue codec (${problem})`, { remediation: CODEC_REMEDIATION });
   }
 }
+var CLOSE_DRAIN_MS = 2e3;
 function suggestCanonicals(missing, entries) {
   const m = missing.toUpperCase();
   const out = entries.filter((e) => e.canonical !== null && (e.canonical.toUpperCase() === m || e.base.toUpperCase() === m || e.canonical.toUpperCase().endsWith(`:${m}`))).map((e) => e.canonical);
@@ -983,7 +1082,7 @@ function suggestCanonicals(missing, entries) {
 }
 function suggestSymbols(missing, entries) {
   const m = missing.toUpperCase();
-  const out = entries.filter((e) => e.symbol.toUpperCase() === m || e.canonical !== null && e.canonical.toUpperCase() === m || e.base.toUpperCase() === m).map((e) => e.symbol);
+  const out = entries.filter((e) => e.symbol.toUpperCase() === m || e.canonical !== null && (e.canonical.toUpperCase() === m || e.base.toUpperCase() === m)).map((e) => e.symbol);
   return Array.from(new Set(out)).slice(0, 5);
 }
 var EVENT_CHANNEL = { account: "account", positions: "positions", orders: "orders", fill: "fills", fills: "fills" };
@@ -1742,7 +1841,7 @@ function createVenueStream(codec, opts = {}) {
     }
     if (target.kind === "market") {
       const channels = target.channels;
-      const valid = `Use channels ${MARKET_CHANNELS.map((c) => `"${c}"`).join(" / ")} (book and trades arrive in 0.15.1)`;
+      const valid = `Use channels ${MARKET_CHANNELS.map((c) => `"${c}"`).join(" / ")} (book and trades: planned, not yet available)`;
       if (!Array.isArray(channels) || channels.length === 0) {
         throw wsError("INVALID_PARAMS", 'kind "market" needs at least one channel', valid);
       }
@@ -1753,7 +1852,7 @@ function createVenueStream(codec, opts = {}) {
         throw wsError(
           "CAPABILITY_UNSUPPORTED",
           `${venue} channel(s) ${later.join(", ")} are not available in this release`,
-          'Use channels "market" / "bbo" (book and trades arrive in 0.15.1)'
+          'Use channels "market" / "bbo" (book and trades: planned, not yet available)'
         );
       }
       if (target.channels.includes("bbo") && !codec.capabilities.channels.bbo) {
@@ -2067,6 +2166,14 @@ function createVenueStream(codec, opts = {}) {
         sub.end();
       }
       stateListeners.clear();
+      let bound = null;
+      await Promise.race([
+        Promise.all(shards.map((sh) => sh.conn.drained())),
+        new Promise((resolve) => {
+          bound = setTimeout(resolve, CLOSE_DRAIN_MS);
+        })
+      ]);
+      if (bound !== null) clearTimeout(bound);
     }
   };
   return stream;
@@ -2428,6 +2535,23 @@ function mulDecimalInt(s, n, shift) {
   const abs2 = (neg ? -product : product).toString();
   return shiftDecimal(`${neg ? "-" : ""}${abs2}`, shift - frac.length);
 }
+function sumDecimals(values) {
+  let scale = 0;
+  const parts = [];
+  for (const v of values) {
+    const m = DECIMAL_RE.exec(v);
+    if (m === null || m[4] !== void 0 || m[2] === "" && (m[3] === void 0 || m[3] === "")) return void 0;
+    const frac = m[3] === void 0 ? "" : m[3];
+    const digits = `${m[2]}${frac}`.replace(/^0+(?=\d)/, "");
+    parts.push({ int: BigInt(digits === "" ? "0" : digits) * (m[1] === "-" ? -1n : 1n), scale: frac.length });
+    if (frac.length > scale) scale = frac.length;
+  }
+  let total = 0n;
+  for (const p of parts) total += p.int * 10n ** BigInt(scale - p.scale);
+  const neg = total < 0n;
+  const abs2 = (neg ? -total : total).toString();
+  return shiftDecimal(`${neg ? "-" : ""}${abs2}`, -scale);
+}
 
 // src/ws/codecs/common.ts
 function isObj(v) {
@@ -2508,9 +2632,9 @@ function capabilities(p) {
     channels: { allMarkets: true, market: true, bbo: true, book: false, trades: false, user: p.user },
     fields: p.fields,
     notes: {
-      book: "Not in this release (0.15.1)",
-      trades: "Not in this release (0.15.1)",
-      ...p.user ? {} : { user: "Not in this release (0.15.1)" },
+      book: "Planned, not yet available",
+      trades: "Planned, not yet available",
+      ...p.user ? {} : { user: "Planned, not yet available" },
       ...p.notes
     }
   };
@@ -2750,6 +2874,16 @@ var SIDE = { B: "buy", A: "sell" };
 function abs(d) {
   return d === null ? null : d.replace(/^-/, "");
 }
+function accountUnrealized(rows, bad) {
+  if (bad.includes("assetPositions") || bad.includes("assetPositions[]")) return null;
+  const values = [];
+  for (const r of rows) {
+    if (r.unrealizedPnl === null) return null;
+    values.push(r.unrealizedPnl);
+  }
+  const sum = sumDecimals(values);
+  return sum === void 0 ? null : sum;
+}
 function decodeClearinghouse(d) {
   if (!isObj(d) || typeof d.dex !== "string" || !isObj(d.clearinghouseState)) return [protocolError("hyperliquid clearinghouseState frame without dex/clearinghouseState")];
   const wire = `clearinghouseState:${d.dex}`;
@@ -2792,8 +2926,10 @@ function decodeClearinghouse(d) {
       equity: ms === null ? null : dec(ms, "accountValue", bad),
       available: dec(cs, "withdrawable", bad),
       marginUsed: ms === null ? null : dec(ms, "totalMarginUsed", bad),
-      unrealizedPnl: null
-      // not in clearinghouseState (per-position only)
+      // clearinghouseState has no account-level unrealizedPnl, but the frame carries every
+      // position of this dex with its own `unrealizedPnl`: the account value is their exact sum
+      // ("0" with no position). null when any position's value is missing (unknown, never guessed).
+      unrealizedPnl: accountUnrealized(rows, bad)
     },
     { kind: "positions", snapshot: true, scope: d.dex, rows, remove: [] }
   ];
@@ -3288,6 +3424,11 @@ function decodeBbo2(d) {
   return out;
 }
 
+// src/ws/lighter-market.ts
+function isLighterMarketLive(row) {
+  return row.status === "active" && row.is_frozen !== true;
+}
+
 // src/ws/codecs/lighter.ts
 var ALL2 = "market_stats/all";
 var ORDERS_TOKEN_TTL_SEC = 3600;
@@ -3296,6 +3437,10 @@ var ZERO = /^-?0*(\.0*)?$/;
 function bookSide(o, key, bad) {
   return o[key] === "" ? null : readDec(o, key, bad);
 }
+function lastTrade(o, bad) {
+  const v = readDec(o, "last_trade_price", bad);
+  return v !== void 0 && v !== null && ZERO.test(v) ? null : v;
+}
 function percentToFraction(o, key, bad) {
   const v = readDec(o, key, bad);
   if (v === void 0 || v === null) return v;
@@ -3328,7 +3473,7 @@ function makeLighter(venue, quote) {
       notes: {
         rate: "WS funding is PERCENT per 1 h on the wire; emitted as a fraction per 1 h",
         nextFundingTime: "Hourly settlement rule (venue-definition)",
-        openInterest: "USD notional (Phase 0), sides not stated by the venue",
+        openInterest: "USD notional, one side \u2014 inferred, not documented by the venue (= REST orderBookDetails open_interest, base, \xD7 mark; the venue's exchangeMetrics kind=open_interest, a daily snapshot, read \u2248 2\xD7 when compared with the current value)",
         user: "By accountIndex. user_stats / account_all_positions / account_all_trades need no auth; account_all_orders needs CredentialProvider.authToken (re-called at 80 % TTL). account_all_trades does not replay \u2192 gap refetch-required for fills after a reconnect",
         clientId: "orders: client_order_id; fills: ask_/bid_client_id_str of our side; 0 = no client id \u2192 null",
         liquidationPrice: 'liquidation_price; "0" (no liquidation price, e.g. well-covered cross margin) \u2192 null, as in the CLI REST path',
@@ -3345,7 +3490,7 @@ function makeLighter(venue, quote) {
     limits: S5.limits,
     closesOnBadSubscribe: false,
     staleAfterMs: S5.staleAfterMs,
-    openInterest: { unit: "usd", sides: null },
+    openInterest: { unit: "usd", sides: "one" },
     refresh: null,
     async loadDirectory(ctx) {
       const raw = await fetchJson(ctx.fetch, venue, `${ctx.restUrl}/api/v1/orderBooks`);
@@ -3363,6 +3508,10 @@ function makeLighter(venue, quote) {
           continue;
         }
         idToSymbol.set(id, m.symbol);
+        if (!isLighterMarketLive(m)) {
+          nonPerp.add(id);
+          continue;
+        }
         entries.push({
           venue,
           dex: null,
@@ -3498,7 +3647,7 @@ function decodeStats(venue, f, d, recvTs) {
       index: readDec(r, "index_price", bad),
       bestBid: bookSide(r, "best_bid_price", bad),
       bestAsk: bookSide(r, "best_ask_price", bad),
-      last: readDec(r, "last_trade_price", bad),
+      last: lastTrade(r, bad),
       rate: percentToFraction(r, "funding_rate", bad),
       predictedRate: percentToFraction(r, "current_funding_rate", bad),
       openInterest: readDec(r, "open_interest", bad),
@@ -3714,6 +3863,14 @@ function decodeTicker(venue, wire, f, d) {
   return out;
 }
 
+// src/ws/aster-market.ts
+function isAsterListedPerpetual(row) {
+  return row.contractType === "PERPETUAL" && row.status === "TRADING";
+}
+function asterMatchable(row) {
+  return row.quoteAsset === "USDT";
+}
+
 // src/ws/codecs/aster.ts
 var S3 = VENUE_STATIC.aster;
 var MARK = "!markPrice@arr@1s";
@@ -3761,7 +3918,7 @@ var aster = {
       openInterest: "Not on WS (REST only)",
       fundingInterval: `Labelled REST source ${FUNDING_INFO}, refreshed hourly; missing \u2192 null`,
       volume24hNotional: "!ticker@arr q (quote-asset volume)",
-      user: 'KNOWN GAP in 0.15.0: no Aster user channels (signed USER_STREAM listenKey) \u2014 kind:"user" rejects CAPABILITY_UNSUPPORTED; arrives in 0.15.1',
+      user: 'KNOWN GAP: no Aster user channels (signed USER_STREAM listenKey) \u2014 kind:"user" rejects CAPABILITY_UNSUPPORTED; planned, not yet available',
       bbo: "<symbol>@bookTicker; `u` orders frames (non-contiguous)"
     }
   }),
@@ -3801,6 +3958,7 @@ var aster = {
       if (!isObj(s) || typeof s.symbol !== "string" || typeof s.baseAsset !== "string") {
         throw badShape("aster", "exchangeInfo symbol without symbol/baseAsset");
       }
+      if (!isAsterListedPerpetual(s)) continue;
       const quote = typeof s.quoteAsset === "string" && s.quoteAsset !== "" ? s.quoteAsset : null;
       listed.add(s.symbol);
       const hours = intervals.get(s.symbol);
@@ -3811,7 +3969,8 @@ var aster = {
         venueSymbol: s.symbol,
         base: s.baseAsset,
         quote,
-        canonical: ctx.canonicalize("aster", { venueSymbol: s.symbol, dex: null, base: s.baseAsset, quote }),
+        // Only the USDT listing is matchable (asterMatchable — the CLI rule): BTCUSD1 is never a second BTC leg.
+        canonical: asterMatchable(s) ? ctx.canonicalize("aster", { venueSymbol: s.symbol, dex: null, base: s.baseAsset, quote }) : null,
         rateIntervalHours: hours === void 0 ? null : hours,
         settlementIntervalHours: hours === void 0 ? null : hours,
         source: "rest:/fapi/v3/exchangeInfo"
@@ -3934,6 +4093,11 @@ function decodeArr(wire, data2, d, fn) {
   return out;
 }
 
+// src/ws/arcus-market.ts
+function isArcusOnlineMarket(row) {
+  return row.status === "ONLINE";
+}
+
 // src/ws/codecs/arcus.ts
 var S4 = VENUE_STATIC.arcus;
 var MARKETS = "markets";
@@ -3984,6 +4148,7 @@ var arcus = {
       if (!isObj(m) || typeof m.marketDisplayName !== "string" || typeof m.marketId !== "number" || typeof m.baseAsset !== "string") {
         throw badShape("arcus", "market without marketDisplayName/marketId/baseAsset");
       }
+      if (!isArcusOnlineMarket(m)) continue;
       const quote = typeof m.quoteAsset === "string" ? m.quoteAsset : null;
       idToSymbol.set(String(m.marketId), m.marketDisplayName);
       entries.push({
@@ -4322,6 +4487,7 @@ function loadWs() {
   return wsModule;
 }
 var DEFAULT_MAX_PAYLOAD = 16 * 1024 * 1024;
+var CLOSE_FLUSH_MS = 250;
 function createNodeTransport(opts = {}) {
   const maxPayload = opts.maxPayload ?? DEFAULT_MAX_PAYLOAD;
   if (!Number.isSafeInteger(maxPayload) || maxPayload <= 0) {
@@ -4331,12 +4497,34 @@ function createNodeTransport(opts = {}) {
   return (url) => {
     const ws = new WebSocket(url, { maxPayload });
     ws.on("error", () => void 0);
+    let terminateTimer = null;
+    const whenClosed = new Promise((resolve) => {
+      ws.once("close", () => {
+        if (terminateTimer !== null) {
+          clearTimeout(terminateTimer);
+          terminateTimer = null;
+        }
+        resolve();
+      });
+    });
     const like = {
+      whenClosed,
       get readyState() {
         return ws.readyState;
       },
       send: (data2) => ws.send(data2),
-      close: (code, reason) => ws.close(code, reason),
+      // The close frame is sent, then the socket is destroyed at once: `ws` would otherwise keep a
+      // 30 s close-handshake timer (and the TCP socket) alive until the server answers, so the
+      // process was not idle after stream.close() (conformance ws:all:close-timers).
+      close: (code, reason) => {
+        ws.close(code, reason);
+        if (terminateTimer === null && ws.readyState !== ws.CLOSED) {
+          terminateTimer = setTimeout(() => {
+            terminateTimer = null;
+            ws.terminate();
+          }, CLOSE_FLUSH_MS);
+        }
+      },
       onopen: null,
       onmessage: null,
       onclose: null,

package/dist/ws/unclassified.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tickers that name DIFFERENT instruments on different venues — listed everywhere, never matched
+ * across venues (canonical null): the one table for the CLI (assetClass "unclassified"), the
+ * public directory / MCP / arb and the WS directory (defaultCanonicalize). src/ws keeps it so the
+ * WS bundle needs no CLI module.
+ *  - SPX: the SPX6900 token on Hyperliquid / Aster / Lighter / Pacifica; its ticker equals the
+ *    canonical key of the S&P 500 index.
+ *  - Pacifica BP / CHIP: tickers that collide with a listed equity / ETF.
+ *  - Lighter BB / BOT / WEN / QNT: grouped with US equities there, each also a live crypto ticker.
+ *  - Lighter RH: every listed perp is classified (LIGHTER_RH_CLASS); an unlisted one is not.
+ */
+export declare const UNCLASSIFIED_TICKERS: Readonly<Record<string, ReadonlySet<string>>>;
+/** Lighter RH listing classification (live listings 2026-09-30). */
+export declare const LIGHTER_RH_CLASS: Readonly<Record<string, "crypto" | "commodity" | "etf" | "equity" | "preIpo">>;
+/** true = `base` on `venue` is never matched across venues (native markets only — not HIP-3 dexes). */
+export declare function isUnclassifiedTicker(venue: string, base: string): boolean;

package/dist/ws/unclassified.js

@@ -0,0 +1,43 @@
+/**
+ * Tickers that name DIFFERENT instruments on different venues — listed everywhere, never matched
+ * across venues (canonical null): the one table for the CLI (assetClass "unclassified"), the
+ * public directory / MCP / arb and the WS directory (defaultCanonicalize). src/ws keeps it so the
+ * WS bundle needs no CLI module.
+ *  - SPX: the SPX6900 token on Hyperliquid / Aster / Lighter / Pacifica; its ticker equals the
+ *    canonical key of the S&P 500 index.
+ *  - Pacifica BP / CHIP: tickers that collide with a listed equity / ETF.
+ *  - Lighter BB / BOT / WEN / QNT: grouped with US equities there, each also a live crypto ticker.
+ *  - Lighter RH: every listed perp is classified (LIGHTER_RH_CLASS); an unlisted one is not.
+ */
+export const UNCLASSIFIED_TICKERS = {
+    hyperliquid: new Set(["SPX"]),
+    aster: new Set(["SPX"]),
+    pacifica: new Set(["SPX", "BP", "CHIP"]),
+    lighter: new Set(["BB", "BOT", "WEN", "QNT", "SPX"]),
+};
+/** Lighter RH listing classification (live listings 2026-09-30). */
+export const LIGHTER_RH_CLASS = {
+    // crypto
+    BTC: "crypto", ETH: "crypto", SOL: "crypto", HYPE: "crypto", ZEC: "crypto", LIT: "crypto",
+    VVV: "crypto", SUI: "crypto", NEAR: "crypto", XRP: "crypto", CASHCAT: "crypto", PONS: "crypto",
+    // commodity (canonical via EXPLICIT_CANONICAL: XAU → GOLD, XAG → SILVER)
+    XAU: "commodity", XAG: "commodity",
+    // etf
+    SPY: "etf", QQQ: "etf", SOXL: "etf", SLV: "etf", USO: "etf", SGOV: "etf",
+    // equity
+    AAPL: "equity", AMZN: "equity", GOOGL: "equity", META: "equity", MSFT: "equity", NVDA: "equity",
+    TSLA: "equity", AMD: "equity", INTC: "equity", MU: "equity", TSM: "equity", ORCL: "equity",
+    PLTR: "equity", COIN: "equity", CRCL: "equity", CRWV: "equity", BABA: "equity", SNDK: "equity",
+    SMCI: "equity", SOFI: "equity", AMC: "equity", RGTI: "equity", QBTS: "equity", CLSK: "equity",
+    IREN: "equity", WULF: "equity", LUNR: "equity", ASTS: "equity", BE: "equity", USAR: "equity",
+    SPCX: "equity", SKHY: "equity",
+    // pre-IPO / private (explicit-only canonical → null unless mapped)
+    OPENAI: "preIpo", ANTHROPIC: "preIpo", SHEIN: "preIpo", ANSEM: "preIpo", AI: "preIpo",
+};
+/** true = `base` on `venue` is never matched across venues (native markets only — not HIP-3 dexes). */
+export function isUnclassifiedTicker(venue, base) {
+    const up = base.toUpperCase();
+    if (venue === "lighter-rh")
+        return LIGHTER_RH_CLASS[up] === undefined;
+    return UNCLASSIFIED_TICKERS[venue]?.has(up) === true;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "perp-cli",
-  "version": "0.15.0",
-  "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter, Aster, Lighter RH, Ondo Perps, Arcus, QFEX, RISEx (read-only), TxFlow (market data, unofficial API)",
+  "version": "0.16.0",
+  "description": "Multi-DEX perpetual futures CLI + MCP server for traders and AI agents — trade on Hyperliquid (incl. HIP-3), Pacifica, Lighter, Aster, Ondo, Arcus, QFEX and more; funding-rate arb, portfolio, bots, bridge. 31 MCP tools, agent skill, JSON output.",
   "bin": {
     "perp": "dist/index.js",
     "perp-mcp": "dist/mcp-server.js",
@@ -47,6 +47,10 @@
     "test": "vitest run --exclude '**/integration/**'",
     "test:integration": "vitest run -c vitest.integration.config.ts",
     "test:all": "vitest run",
+    "test:conformance": "vitest run src/__tests__/conformance",
+    "test:conformance:live": "PERP_LIVE=1 vitest run -c vitest.conformance.live.config.ts",
+    "conformance:record": "tsx scripts/conformance/record.ts",
+    "release-qa": "node scripts/release-qa/run.mjs",
     "e2e": "tsx scripts/e2e/run.ts",
     "e2e:typecheck": "tsc -p scripts/e2e/tsconfig.json",
     "typecheck:test": "tsc -p tsconfig.test.json",
@@ -85,6 +89,15 @@
     "ethereum"
   ],
   "license": "MIT",
+  "author": "HypurrQuant",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hypurrquant/perp-cli.git"
+  },
+  "homepage": "https://github.com/hypurrquant/perp-cli#readme",
+  "bugs": {
+    "url": "https://github.com/hypurrquant/perp-cli/issues"
+  },
   "engines": {
     "node": "^20.0.0 || ^22.0.0 || ^24.0.0"
   },