@xapy/orderbook 0.1.3 → 0.1.5

package/dist/exchanges/hyperliquid/index.cjs

@@ -0,0 +1,536 @@
+'use strict';
+
+// src/core/symbol.ts
+function parseSymbol(symbol) {
+  const [pair, settle] = symbol.split(":");
+  const parts = (pair ?? "").split("/");
+  const base = parts[0]?.toUpperCase();
+  const quote = parts[1]?.toUpperCase();
+  if (!base || !quote) {
+    throw new Error(
+      `invalid symbol "${symbol}" \u2014 expected "BASE/QUOTE" or "BASE/QUOTE:SETTLE"`
+    );
+  }
+  if (settle && settle.toUpperCase() !== quote) {
+    throw new Error(
+      `unsupported settlement currency in "${symbol}" \u2014 only linear (settle === quote) is supported`
+    );
+  }
+  return {
+    base,
+    quote,
+    market: settle ? "perpetual" : "spot",
+    pair: `${base}/${quote}`
+  };
+}
+
+// src/transport/http.ts
+async function httpJson(req) {
+  const url = req.transformUrl ? req.transformUrl(req.url) : req.url;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), req.timeoutMs ?? 1e4);
+  try {
+    const res = await fetch(url, {
+      method: req.method ?? "GET",
+      headers: req.headers,
+      body: req.body,
+      signal: controller.signal
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`HTTP ${res.status} ${res.statusText}: ${text.slice(0, 200)}`);
+    }
+    return await res.json();
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// src/exchanges/hyperliquid/symbols.ts
+function toHyperliquidSymbol(symbol) {
+  const [base, quote] = symbol.split("/");
+  if (!base || !quote) {
+    throw new Error(`invalid symbol "${symbol}" \u2014 expected "BASE/QUOTE"`);
+  }
+  if (quote.toUpperCase() !== "USDC") {
+    throw new Error(
+      `hyperliquid only supports USDC-quoted pairs; got "${quote}"`
+    );
+  }
+  return base.toUpperCase();
+}
+function fromHyperliquidSymbol(coin) {
+  return `${coin.toUpperCase()}/USDC`;
+}
+
+// src/exchanges/hyperliquid/rest.ts
+var BASE = "https://api.hyperliquid.xyz";
+async function fetchHyperliquidOrderbook(opts) {
+  if (opts.market !== "perpetual") {
+    throw new Error(
+      "hyperliquid: only perpetual markets are supported (spot uses @N-indexed coins)"
+    );
+  }
+  const coin = toHyperliquidSymbol(opts.symbol);
+  const data = await httpJson({
+    url: `${BASE}/info`,
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ type: "l2Book", coin }),
+    timeoutMs: opts.timeoutMs,
+    transformUrl: opts.transformUrl
+  });
+  return {
+    exchange: "hyperliquid",
+    symbol: fromHyperliquidSymbol(data.coin),
+    market: "perpetual",
+    bids: data.levels[0].map((l) => ({
+      price: Number(l.px),
+      size: Number(l.sz)
+    })),
+    asks: data.levels[1].map((l) => ({
+      price: Number(l.px),
+      size: Number(l.sz)
+    })),
+    timestamp: data.time,
+    sequence: data.time
+  };
+}
+
+// src/core/book-merger.ts
+var BookMerger = class {
+  bids = /* @__PURE__ */ new Map();
+  // price -> size
+  asks = /* @__PURE__ */ new Map();
+  sequence = -1;
+  timestamp = 0;
+  hasSnapshot = false;
+  apply(event) {
+    if (event.kind === "snapshot") {
+      this.bids.clear();
+      this.asks.clear();
+      for (const { price, size } of event.bids) {
+        if (size > 0) this.bids.set(price, size);
+      }
+      for (const { price, size } of event.asks) {
+        if (size > 0) this.asks.set(price, size);
+      }
+      this.sequence = event.sequence;
+      this.timestamp = event.timestamp;
+      this.hasSnapshot = true;
+      return this.emit();
+    }
+    if (!this.hasSnapshot) {
+      return { ok: false, reason: "no-snapshot" };
+    }
+    if (event.sequence <= this.sequence) {
+      return this.emit();
+    }
+    if (event.prevSequence !== void 0) {
+      if (event.prevSequence !== this.sequence) {
+        return {
+          ok: false,
+          reason: "gap",
+          expected: this.sequence,
+          received: event.prevSequence
+        };
+      }
+    } else if (event.sequence !== this.sequence + 1) {
+      return {
+        ok: false,
+        reason: "gap",
+        expected: this.sequence + 1,
+        received: event.sequence
+      };
+    }
+    for (const { price, size } of event.bids) {
+      if (size === 0) this.bids.delete(price);
+      else this.bids.set(price, size);
+    }
+    for (const { price, size } of event.asks) {
+      if (size === 0) this.asks.delete(price);
+      else this.asks.set(price, size);
+    }
+    this.sequence = event.sequence;
+    this.timestamp = event.timestamp;
+    return this.emit();
+  }
+  reset() {
+    this.bids.clear();
+    this.asks.clear();
+    this.sequence = -1;
+    this.timestamp = 0;
+    this.hasSnapshot = false;
+  }
+  /** Returns true once the merger has a usable book. */
+  isReady() {
+    return this.hasSnapshot;
+  }
+  emit() {
+    const bids = [];
+    for (const [price, size] of this.bids) bids.push({ price, size });
+    bids.sort((a, b) => b.price - a.price);
+    const asks = [];
+    for (const [price, size] of this.asks) asks.push({ price, size });
+    asks.sort((a, b) => a.price - b.price);
+    return {
+      ok: true,
+      bids,
+      asks,
+      sequence: this.sequence,
+      timestamp: this.timestamp
+    };
+  }
+};
+
+// src/core/event-emitter.ts
+var TypedEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  on(event, fn) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(event, set);
+    }
+    set.add(fn);
+    return this;
+  }
+  off(event, fn) {
+    this.listeners.get(event)?.delete(fn);
+    return this;
+  }
+  emit(event, ...args) {
+    const set = this.listeners.get(event);
+    if (!set || set.size === 0) return false;
+    for (const fn of set) fn(...args);
+    return true;
+  }
+  removeAllListeners() {
+    this.listeners.clear();
+  }
+};
+
+// src/core/stream.ts
+var OrderbookStream = class extends TypedEmitter {
+  constructor(onClose) {
+    super();
+    this.onClose = onClose;
+  }
+  onClose;
+  closed = false;
+  close() {
+    if (this.closed) return;
+    this.closed = true;
+    this.onClose();
+    this.removeAllListeners();
+  }
+  /** Yields each maintained book as it becomes available. */
+  async *iter() {
+    const queue = [];
+    let resolveNext = null;
+    let pendingError = null;
+    let ended = false;
+    const onUpdate = (b) => {
+      queue.push(b);
+      resolveNext?.();
+    };
+    const onError = (e) => {
+      pendingError = e;
+      resolveNext?.();
+    };
+    const onClose = () => {
+      ended = true;
+      resolveNext?.();
+    };
+    this.on("update", onUpdate);
+    this.on("error", onError);
+    this.on("disconnected", onClose);
+    try {
+      while (true) {
+        if (pendingError) throw pendingError;
+        const next = queue.shift();
+        if (next) {
+          yield next;
+          continue;
+        }
+        if (ended || this.closed) return;
+        await new Promise((r) => {
+          resolveNext = r;
+        });
+        resolveNext = null;
+      }
+    } finally {
+      this.off("update", onUpdate);
+      this.off("error", onError);
+      this.off("disconnected", onClose);
+    }
+  }
+};
+
+// src/core/reconnect.ts
+var Backoff = class _Backoff {
+  attempt = 0;
+  opts;
+  constructor(opts) {
+    this.opts = opts;
+  }
+  static withDefaults(opts = {}) {
+    return new _Backoff({
+      initialMs: opts.initialMs ?? 500,
+      maxMs: opts.maxMs ?? 3e4,
+      factor: opts.factor ?? 2,
+      jitter: opts.jitter ?? 0.3,
+      maxAttempts: opts.maxAttempts ?? 0
+    });
+  }
+  next() {
+    if (this.opts.maxAttempts > 0 && this.attempt >= this.opts.maxAttempts) {
+      return null;
+    }
+    this.attempt += 1;
+    const base = Math.min(
+      this.opts.initialMs * Math.pow(this.opts.factor, this.attempt - 1),
+      this.opts.maxMs
+    );
+    const jitterRange = base * this.opts.jitter;
+    const wait = Math.max(0, base + (Math.random() * 2 - 1) * jitterRange);
+    return { wait, attempt: this.attempt };
+  }
+  reset() {
+    this.attempt = 0;
+  }
+};
+var hasNativeWebSocket = typeof globalThis.WebSocket !== "undefined";
+
+// src/transport/ws.ts
+var cachedCtor = null;
+async function getWebSocketCtor() {
+  if (cachedCtor) return cachedCtor;
+  if (hasNativeWebSocket) {
+    cachedCtor = globalThis.WebSocket;
+    return cachedCtor;
+  }
+  try {
+    const mod = await import('ws');
+    const ctor = mod.default ?? mod.WebSocket;
+    if (!ctor) throw new Error("missing default export");
+    cachedCtor = ctor;
+    return cachedCtor;
+  } catch (err) {
+    throw new Error(
+      "WebSocket unavailable; install peer dep `ws` for Node <22. " + (err instanceof Error ? err.message : String(err))
+    );
+  }
+}
+var WSClient = class extends TypedEmitter {
+  constructor(cfg) {
+    super();
+    this.cfg = cfg;
+    this.backoff = Backoff.withDefaults(cfg.reconnect);
+  }
+  cfg;
+  ws = null;
+  backoff;
+  closed = false;
+  pingTimer = null;
+  async connect() {
+    if (this.closed) return;
+    const WS = await getWebSocketCtor();
+    const url = typeof this.cfg.url === "function" ? await this.cfg.url() : this.cfg.url;
+    const ws = new WS(url);
+    ws.binaryType = "arraybuffer";
+    this.ws = ws;
+    ws.onopen = async () => {
+      this.backoff.reset();
+      this.startPing();
+      this.emit("open");
+      try {
+        await this.cfg.onOpen?.({
+          send: (d) => ws.send(d),
+          close: () => this.close()
+        });
+      } catch (err) {
+        this.emit("error", err);
+      }
+    };
+    ws.onmessage = (e) => {
+      let result;
+      try {
+        result = this.cfg.onMessage(e.data);
+      } catch (err) {
+        this.emit("error", err);
+        return;
+      }
+      if (result && typeof result.catch === "function") {
+        result.catch(
+          (err) => this.emit("error", err)
+        );
+      }
+    };
+    ws.onerror = (e) => {
+      this.emit("error", new Error(e?.message ?? "WebSocket error"));
+    };
+    ws.onclose = (e) => {
+      this.stopPing();
+      const reason = e?.reason ?? "closed";
+      this.emit("close", reason);
+      if (!this.closed) this.scheduleReconnect();
+    };
+  }
+  send(data) {
+    this.ws?.send(data);
+  }
+  close() {
+    this.closed = true;
+    this.stopPing();
+    try {
+      this.ws?.close();
+    } catch {
+    }
+  }
+  startPing() {
+    if (!this.cfg.pingIntervalMs || !this.cfg.pingPayload) return;
+    this.stopPing();
+    this.pingTimer = setInterval(() => {
+      try {
+        this.ws?.send(this.cfg.pingPayload());
+      } catch {
+      }
+    }, this.cfg.pingIntervalMs);
+  }
+  stopPing() {
+    if (this.pingTimer) {
+      clearInterval(this.pingTimer);
+      this.pingTimer = null;
+    }
+  }
+  scheduleReconnect() {
+    const next = this.backoff.next();
+    if (!next) {
+      this.emit("error", new Error("max reconnect attempts exceeded"));
+      return;
+    }
+    this.emit("reconnecting", next.attempt, next.wait);
+    setTimeout(() => {
+      this.connect().catch((e) => this.emit("error", e));
+    }, next.wait);
+  }
+};
+
+// src/exchanges/hyperliquid/ws.ts
+var WS_URL = "wss://api.hyperliquid.xyz/ws";
+function streamHyperliquidOrderbook(opts) {
+  if (opts.market !== "perpetual") {
+    const s = new OrderbookStream(() => void 0);
+    queueMicrotask(
+      () => s.emit(
+        "error",
+        new Error(
+          "hyperliquid: only perpetual markets are supported (spot uses @N-indexed coins)"
+        )
+      )
+    );
+    return s;
+  }
+  const coin = toHyperliquidSymbol(opts.symbol);
+  const merger = new BookMerger();
+  let ws = null;
+  const stream = new OrderbookStream(() => ws?.close());
+  const subscribePayload = JSON.stringify({
+    method: "subscribe",
+    subscription: { type: "l2Book", coin }
+  });
+  const onMessage = (raw) => {
+    if (typeof raw !== "string") return;
+    let msg;
+    try {
+      msg = JSON.parse(raw);
+    } catch {
+      return;
+    }
+    if (msg.channel === "pong" || msg.channel === "subscriptionResponse") {
+      return;
+    }
+    if (msg.channel !== "l2Book" || !msg.data) return;
+    const book = msg.data;
+    if (book.coin !== coin) return;
+    const event = {
+      kind: "snapshot",
+      bids: book.levels[0].map((l) => ({
+        price: Number(l.px),
+        size: Number(l.sz)
+      })),
+      asks: book.levels[1].map((l) => ({
+        price: Number(l.px),
+        size: Number(l.sz)
+      })),
+      sequence: book.time,
+      timestamp: book.time
+    };
+    const r = merger.apply(event);
+    if (!r.ok) return;
+    const out = {
+      exchange: "hyperliquid",
+      symbol: fromHyperliquidSymbol(coin),
+      market: "perpetual",
+      bids: r.bids,
+      asks: r.asks,
+      timestamp: r.timestamp,
+      sequence: r.sequence
+    };
+    stream.emit("update", out);
+  };
+  ws = new WSClient({
+    url: WS_URL,
+    onOpen: (sock) => {
+      merger.reset();
+      sock.send(subscribePayload);
+    },
+    onMessage,
+    pingIntervalMs: 5e4,
+    pingPayload: () => JSON.stringify({ method: "ping" })
+  });
+  ws.on("open", () => stream.emit("connected"));
+  ws.on("close", (r) => stream.emit("disconnected", r));
+  ws.on("reconnecting", (a, w) => stream.emit("reconnecting", a, w));
+  ws.on("error", (e) => stream.emit("error", e));
+  ws.connect().catch((e) => stream.emit("error", e));
+  return stream;
+}
+
+// src/exchanges/hyperliquid/index.ts
+var HyperliquidClient = class {
+  exchange = "hyperliquid";
+  transformUrl;
+  timeoutMs;
+  constructor(opts = {}) {
+    this.transformUrl = opts.transformUrl;
+    this.timeoutMs = opts.timeoutMs;
+  }
+  fetchOrderbook(symbol, opts = {}) {
+    const { pair, market } = parseSymbol(symbol);
+    return fetchHyperliquidOrderbook({
+      symbol: pair,
+      market,
+      depth: opts.depth,
+      timeoutMs: this.timeoutMs,
+      transformUrl: this.transformUrl
+    });
+  }
+  streamOrderbook(symbol, opts = {}) {
+    const { pair, market } = parseSymbol(symbol);
+    return streamHyperliquidOrderbook({
+      symbol: pair,
+      market,
+      depth: opts.depth,
+      transformUrl: this.transformUrl,
+      timeoutMs: this.timeoutMs
+    });
+  }
+};
+
+exports.HyperliquidClient = HyperliquidClient;
+exports.fetchHyperliquidOrderbook = fetchHyperliquidOrderbook;
+exports.streamHyperliquidOrderbook = streamHyperliquidOrderbook;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/exchanges/hyperliquid/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/symbol.ts","../../../src/transport/http.ts","../../../src/exchanges/hyperliquid/symbols.ts","../../../src/exchanges/hyperliquid/rest.ts","../../../src/core/book-merger.ts","../../../src/core/event-emitter.ts","../../../src/core/stream.ts","../../../src/core/reconnect.ts","../../../src/utils/runtime.ts","../../../src/transport/ws.ts","../../../src/exchanges/hyperliquid/ws.ts","../../../src/exchanges/hyperliquid/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Market } from \"./types.js\";\n\nexport interface ParsedSymbol {\n  base: string;\n  quote: string;\n  market: Market;\n  /** \"BASE/QUOTE\" — settlement suffix stripped. Pass this to per-exchange formatters. */\n  pair: string;\n}\n\n/**\n * CCXT-style unified symbol:\n *   \"BTC/USDT\"         → spot\n *   \"BTC/USDT:USDT\"    → linear perpetual (USDT-margined)\n *\n * Inverse/coin-margined contracts (e.g. \"BTC/USD:BTC\") are intentionally\n * unsupported by this lib.\n */\nexport function parseSymbol(symbol: string): ParsedSymbol {\n  const [pair, settle] = symbol.split(\":\");\n  const parts = (pair ?? \"\").split(\"/\");\n  const base = parts[0]?.toUpperCase();\n  const quote = parts[1]?.toUpperCase();\n  if (!base || !quote) {\n    throw new Error(\n      `invalid symbol \"${symbol}\" — expected \"BASE/QUOTE\" or \"BASE/QUOTE:SETTLE\"`\n    );\n  }\n  if (settle && settle.toUpperCase() !== quote) {\n    throw new Error(\n      `unsupported settlement currency in \"${symbol}\" — only linear (settle === quote) is supported`\n    );\n  }\n  return {\n    base,\n    quote,\n    market: settle ? \"perpetual\" : \"spot\",\n    pair: `${base}/${quote}`,\n  };\n}\n","export interface HttpRequest {\n  url: string;\n  method?: \"GET\" | \"POST\";\n  headers?: Record<string, string>;\n  body?: string;\n  timeoutMs?: number;\n  /** Applied to `url` before the request fires. Use for CORS proxying. */\n  transformUrl?: (url: string) => string;\n}\n\nexport async function httpJson<T>(req: HttpRequest): Promise<T> {\n  const url = req.transformUrl ? req.transformUrl(req.url) : req.url;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), req.timeoutMs ?? 10_000);\n  try {\n    const res = await fetch(url, {\n      method: req.method ?? \"GET\",\n      headers: req.headers,\n      body: req.body,\n      signal: controller.signal,\n    });\n    if (!res.ok) {\n      const text = await res.text().catch(() => \"\");\n      throw new Error(`HTTP ${res.status} ${res.statusText}: ${text.slice(0, 200)}`);\n    }\n    return (await res.json()) as T;\n  } finally {\n    clearTimeout(timer);\n  }\n}\n","/**\n * Hyperliquid perps use bare coin names (\"BTC\", \"ETH\", \"SOL\"). All perps are\n * USDC-margined. We accept the unified form \"BTC/USDC:USDC\" and translate to\n * the coin name; non-USDC quotes are rejected.\n *\n * Hyperliquid's spot markets use `@N`-style indexed identifiers (e.g. `@1`\n * for PURR/USDC) which don't fit the unified BASE/QUOTE convention, so spot\n * is intentionally unsupported here.\n */\nexport function toHyperliquidSymbol(symbol: string): string {\n  const [base, quote] = symbol.split(\"/\");\n  if (!base || !quote) {\n    throw new Error(`invalid symbol \"${symbol}\" — expected \"BASE/QUOTE\"`);\n  }\n  if (quote.toUpperCase() !== \"USDC\") {\n    throw new Error(\n      `hyperliquid only supports USDC-quoted pairs; got \"${quote}\"`\n    );\n  }\n  return base.toUpperCase();\n}\n\nexport function fromHyperliquidSymbol(coin: string): string {\n  return `${coin.toUpperCase()}/USDC`;\n}\n","import { httpJson } from \"../../transport/http.js\";\nimport type { Market, Orderbook } from \"../../core/types.js\";\nimport { fromHyperliquidSymbol, toHyperliquidSymbol } from \"./symbols.js\";\nimport type { HyperliquidL2Book } from \"./types.js\";\n\nexport interface FetchHyperliquidOrderbookOptions {\n  symbol: string;\n  market: Market;\n  /** Hyperliquid's `info` endpoint does not honor a depth parameter — present for API parity. */\n  depth?: number;\n  timeoutMs?: number;\n  transformUrl?: (url: string) => string;\n}\n\nconst BASE = \"https://api.hyperliquid.xyz\";\n\n/**\n * POST /info with body `{\"type\":\"l2Book\",\"coin\":\"BTC\"}` returns the same\n * payload the WS `l2Book` channel pushes — full snapshot every call.\n */\nexport async function fetchHyperliquidOrderbook(\n  opts: FetchHyperliquidOrderbookOptions\n): Promise<Orderbook> {\n  if (opts.market !== \"perpetual\") {\n    throw new Error(\n      \"hyperliquid: only perpetual markets are supported (spot uses @N-indexed coins)\"\n    );\n  }\n  const coin = toHyperliquidSymbol(opts.symbol);\n  const data = await httpJson<HyperliquidL2Book>({\n    url: `${BASE}/info`,\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({ type: \"l2Book\", coin }),\n    timeoutMs: opts.timeoutMs,\n    transformUrl: opts.transformUrl,\n  });\n\n  return {\n    exchange: \"hyperliquid\",\n    symbol: fromHyperliquidSymbol(data.coin),\n    market: \"perpetual\",\n    bids: data.levels[0].map((l) => ({\n      price: Number(l.px),\n      size: Number(l.sz),\n    })),\n    asks: data.levels[1].map((l) => ({\n      price: Number(l.px),\n      size: Number(l.sz),\n    })),\n    timestamp: data.time,\n    sequence: data.time,\n  };\n}\n","import type { BookEvent, OrderbookLevel } from \"./types.js\";\n\n/**\n * BookMerger maintains a sorted orderbook from a stream of snapshot and delta\n * events. It is exchange-agnostic — adapters translate raw WS frames into the\n * normalized BookEvent shape and feed them here.\n *\n * Gap detection:\n *   - If the delta carries a `prevSequence`, we check it equals our current sequence.\n *   - Otherwise we expect strictly consecutive sequence numbers.\n *   - On gap, the caller is expected to re-fetch a REST snapshot, call reset(),\n *     then apply the snapshot.\n */\n\nexport type MergeResult =\n  | {\n      ok: true;\n      bids: OrderbookLevel[]; // descending\n      asks: OrderbookLevel[]; // ascending\n      sequence: number;\n      timestamp: number;\n    }\n  | { ok: false; reason: \"gap\"; expected: number; received: number }\n  | { ok: false; reason: \"no-snapshot\" };\n\nexport class BookMerger {\n  private readonly bids = new Map<number, number>(); // price -> size\n  private readonly asks = new Map<number, number>();\n  private sequence = -1;\n  private timestamp = 0;\n  private hasSnapshot = false;\n\n  apply(event: BookEvent): MergeResult {\n    if (event.kind === \"snapshot\") {\n      this.bids.clear();\n      this.asks.clear();\n      for (const { price, size } of event.bids) {\n        if (size > 0) this.bids.set(price, size);\n      }\n      for (const { price, size } of event.asks) {\n        if (size > 0) this.asks.set(price, size);\n      }\n      this.sequence = event.sequence;\n      this.timestamp = event.timestamp;\n      this.hasSnapshot = true;\n      return this.emit();\n    }\n\n    if (!this.hasSnapshot) {\n      return { ok: false, reason: \"no-snapshot\" };\n    }\n\n    // Stale or duplicate delta: silently ignore but emit current state.\n    if (event.sequence <= this.sequence) {\n      return this.emit();\n    }\n\n    // Gap detection\n    if (event.prevSequence !== undefined) {\n      if (event.prevSequence !== this.sequence) {\n        return {\n          ok: false,\n          reason: \"gap\",\n          expected: this.sequence,\n          received: event.prevSequence,\n        };\n      }\n    } else if (event.sequence !== this.sequence + 1) {\n      return {\n        ok: false,\n        reason: \"gap\",\n        expected: this.sequence + 1,\n        received: event.sequence,\n      };\n    }\n\n    for (const { price, size } of event.bids) {\n      if (size === 0) this.bids.delete(price);\n      else this.bids.set(price, size);\n    }\n    for (const { price, size } of event.asks) {\n      if (size === 0) this.asks.delete(price);\n      else this.asks.set(price, size);\n    }\n    this.sequence = event.sequence;\n    this.timestamp = event.timestamp;\n    return this.emit();\n  }\n\n  reset(): void {\n    this.bids.clear();\n    this.asks.clear();\n    this.sequence = -1;\n    this.timestamp = 0;\n    this.hasSnapshot = false;\n  }\n\n  /** Returns true once the merger has a usable book. */\n  isReady(): boolean {\n    return this.hasSnapshot;\n  }\n\n  private emit(): Extract<MergeResult, { ok: true }> {\n    const bids: OrderbookLevel[] = [];\n    for (const [price, size] of this.bids) bids.push({ price, size });\n    bids.sort((a, b) => b.price - a.price);\n\n    const asks: OrderbookLevel[] = [];\n    for (const [price, size] of this.asks) asks.push({ price, size });\n    asks.sort((a, b) => a.price - b.price);\n\n    return {\n      ok: true,\n      bids,\n      asks,\n      sequence: this.sequence,\n      timestamp: this.timestamp,\n    };\n  }\n}\n","/**\n * Tiny typed event emitter — keeps the package dependency-free across runtimes\n * (Node's `events` doesn't work in browser bundles without polyfills).\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype EventMap = Record<string, (...args: any[]) => void>;\n\nexport class TypedEmitter<E extends EventMap> {\n  private readonly listeners = new Map<keyof E, Set<E[keyof E]>>();\n\n  on<K extends keyof E>(event: K, fn: E[K]): this {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set as Set<E[keyof E]>);\n    }\n    (set as Set<E[K]>).add(fn);\n    return this;\n  }\n\n  off<K extends keyof E>(event: K, fn: E[K]): this {\n    (this.listeners.get(event) as Set<E[K]> | undefined)?.delete(fn);\n    return this;\n  }\n\n  emit<K extends keyof E>(event: K, ...args: Parameters<E[K]>): boolean {\n    const set = this.listeners.get(event) as Set<E[K]> | undefined;\n    if (!set || set.size === 0) return false;\n    for (const fn of set) fn(...args);\n    return true;\n  }\n\n  removeAllListeners(): void {\n    this.listeners.clear();\n  }\n}\n","import { TypedEmitter } from \"./event-emitter.js\";\nimport type { Orderbook } from \"./types.js\";\n\nexport type StreamEvents = {\n  update: (book: Orderbook) => void;\n  error: (err: Error) => void;\n  connected: () => void;\n  disconnected: (reason?: string) => void;\n  reconnecting: (attempt: number, waitMs: number) => void;\n};\n\n/**\n * OrderbookStream is the consumer-facing handle for a maintained orderbook.\n * It exposes both an EventEmitter API and an async-iterator (`for await`).\n */\nexport class OrderbookStream extends TypedEmitter<StreamEvents> {\n  private closed = false;\n\n  constructor(private readonly onClose: () => void) {\n    super();\n  }\n\n  close(): void {\n    if (this.closed) return;\n    this.closed = true;\n    this.onClose();\n    this.removeAllListeners();\n  }\n\n  /** Yields each maintained book as it becomes available. */\n  async *iter(): AsyncGenerator<Orderbook, void, undefined> {\n    const queue: Orderbook[] = [];\n    let resolveNext: (() => void) | null = null;\n    let pendingError: Error | null = null;\n    let ended = false;\n\n    const onUpdate = (b: Orderbook) => {\n      queue.push(b);\n      resolveNext?.();\n    };\n    const onError = (e: Error) => {\n      pendingError = e;\n      resolveNext?.();\n    };\n    const onClose = () => {\n      ended = true;\n      resolveNext?.();\n    };\n\n    this.on(\"update\", onUpdate);\n    this.on(\"error\", onError);\n    this.on(\"disconnected\", onClose);\n\n    try {\n      while (true) {\n        if (pendingError) throw pendingError;\n        const next = queue.shift();\n        if (next) {\n          yield next;\n          continue;\n        }\n        if (ended || this.closed) return;\n        await new Promise<void>((r) => {\n          resolveNext = r;\n        });\n        resolveNext = null;\n      }\n    } finally {\n      this.off(\"update\", onUpdate);\n      this.off(\"error\", onError);\n      this.off(\"disconnected\", onClose);\n    }\n  }\n}\n","export interface BackoffOptions {\n  initialMs?: number;\n  maxMs?: number;\n  factor?: number;\n  /** 0..1 — random jitter as a fraction of the delay. */\n  jitter?: number;\n  /** 0 = infinite. */\n  maxAttempts?: number;\n}\n\ninterface ResolvedBackoff {\n  initialMs: number;\n  maxMs: number;\n  factor: number;\n  jitter: number;\n  maxAttempts: number;\n}\n\nexport class Backoff {\n  private attempt = 0;\n  private readonly opts: ResolvedBackoff;\n\n  private constructor(opts: ResolvedBackoff) {\n    this.opts = opts;\n  }\n\n  static withDefaults(opts: BackoffOptions = {}): Backoff {\n    return new Backoff({\n      initialMs: opts.initialMs ?? 500,\n      maxMs: opts.maxMs ?? 30_000,\n      factor: opts.factor ?? 2,\n      jitter: opts.jitter ?? 0.3,\n      maxAttempts: opts.maxAttempts ?? 0,\n    });\n  }\n\n  next(): { wait: number; attempt: number } | null {\n    if (this.opts.maxAttempts > 0 && this.attempt >= this.opts.maxAttempts) {\n      return null;\n    }\n    this.attempt += 1;\n    const base = Math.min(\n      this.opts.initialMs * Math.pow(this.opts.factor, this.attempt - 1),\n      this.opts.maxMs\n    );\n    const jitterRange = base * this.opts.jitter;\n    const wait = Math.max(0, base + (Math.random() * 2 - 1) * jitterRange);\n    return { wait, attempt: this.attempt };\n  }\n\n  reset(): void {\n    this.attempt = 0;\n  }\n}\n","declare const globalThis: typeof global & {\n  window?: unknown;\n  document?: unknown;\n  WebSocket?: unknown;\n};\n\nexport const isBrowser =\n  typeof globalThis.window !== \"undefined\" &&\n  typeof globalThis.document !== \"undefined\";\n\nexport const hasNativeWebSocket = typeof globalThis.WebSocket !== \"undefined\";\n","import { TypedEmitter } from \"../core/event-emitter.js\";\nimport { Backoff, type BackoffOptions } from \"../core/reconnect.js\";\nimport { hasNativeWebSocket } from \"../utils/runtime.js\";\n\nexport interface WSConfig {\n  /**\n   * WebSocket URL, or a function resolved on every (re)connect. The function\n   * form lets adapters that need a fresh handshake token (e.g. KuCoin's bullet\n   * endpoint) hand out a new URL each time without ditching WSClient.\n   */\n  url: string | (() => string | Promise<string>);\n  /** Called every time the socket opens (initial + after each reconnect). */\n  onOpen?: (sock: SocketHandle) => void | Promise<void>;\n  /** Called for every inbound frame. Adapter is responsible for JSON-parsing. */\n  onMessage: (data: string | ArrayBuffer) => void | Promise<void>;\n  /** Periodic ping; omit to disable. */\n  pingIntervalMs?: number;\n  pingPayload?: () => string;\n  reconnect?: BackoffOptions;\n}\n\nexport interface SocketHandle {\n  send(data: string): void;\n  close(): void;\n}\n\ntype WSEvents = {\n  open: () => void;\n  close: (reason: string) => void;\n  reconnecting: (attempt: number, waitMs: number) => void;\n  error: (err: Error) => void;\n};\n\ninterface WebSocketLike {\n  binaryType: string;\n  send(data: string): void;\n  close(): void;\n  onopen: ((ev?: unknown) => void) | null;\n  onclose: ((ev?: { reason?: string; code?: number }) => void) | null;\n  onerror: ((ev?: { message?: string }) => void) | null;\n  onmessage: ((ev: { data: string | ArrayBuffer }) => void) | null;\n}\n\ntype WebSocketCtor = new (url: string) => WebSocketLike;\n\nlet cachedCtor: WebSocketCtor | null = null;\n\nasync function getWebSocketCtor(): Promise<WebSocketCtor> {\n  if (cachedCtor) return cachedCtor;\n  if (hasNativeWebSocket) {\n    cachedCtor = (globalThis as unknown as { WebSocket: WebSocketCtor })\n      .WebSocket;\n    return cachedCtor;\n  }\n  try {\n    const mod = (await import(\"ws\")) as unknown as {\n      default?: WebSocketCtor;\n      WebSocket?: WebSocketCtor;\n    };\n    const ctor = mod.default ?? mod.WebSocket;\n    if (!ctor) throw new Error(\"missing default export\");\n    cachedCtor = ctor;\n    return cachedCtor;\n  } catch (err) {\n    throw new Error(\n      \"WebSocket unavailable; install peer dep `ws` for Node <22. \" +\n        (err instanceof Error ? err.message : String(err))\n    );\n  }\n}\n\nexport class WSClient extends TypedEmitter<WSEvents> {\n  private ws: WebSocketLike | null = null;\n  private readonly backoff: Backoff;\n  private closed = false;\n  private pingTimer: ReturnType<typeof setInterval> | null = null;\n\n  constructor(private readonly cfg: WSConfig) {\n    super();\n    this.backoff = Backoff.withDefaults(cfg.reconnect);\n  }\n\n  async connect(): Promise<void> {\n    if (this.closed) return;\n    const WS = await getWebSocketCtor();\n    const url =\n      typeof this.cfg.url === \"function\" ? await this.cfg.url() : this.cfg.url;\n    const ws = new WS(url);\n    ws.binaryType = \"arraybuffer\";\n    this.ws = ws;\n\n    ws.onopen = async () => {\n      this.backoff.reset();\n      this.startPing();\n      this.emit(\"open\");\n      try {\n        await this.cfg.onOpen?.({\n          send: (d) => ws.send(d),\n          close: () => this.close(),\n        });\n      } catch (err) {\n        this.emit(\"error\", err as Error);\n      }\n    };\n\n    ws.onmessage = (e) => {\n      let result: void | Promise<void>;\n      try {\n        result = this.cfg.onMessage(e.data);\n      } catch (err) {\n        this.emit(\"error\", err as Error);\n        return;\n      }\n      if (result && typeof (result as Promise<void>).catch === \"function\") {\n        (result as Promise<void>).catch((err) =>\n          this.emit(\"error\", err as Error)\n        );\n      }\n    };\n\n    ws.onerror = (e) => {\n      this.emit(\"error\", new Error(e?.message ?? \"WebSocket error\"));\n    };\n\n    ws.onclose = (e) => {\n      this.stopPing();\n      const reason = e?.reason ?? \"closed\";\n      this.emit(\"close\", reason);\n      if (!this.closed) this.scheduleReconnect();\n    };\n  }\n\n  send(data: string): void {\n    this.ws?.send(data);\n  }\n\n  close(): void {\n    this.closed = true;\n    this.stopPing();\n    try {\n      this.ws?.close();\n    } catch {\n      /* ignore */\n    }\n  }\n\n  private startPing(): void {\n    if (!this.cfg.pingIntervalMs || !this.cfg.pingPayload) return;\n    this.stopPing();\n    this.pingTimer = setInterval(() => {\n      try {\n        this.ws?.send(this.cfg.pingPayload!());\n      } catch {\n        /* ignore — close handler will reconnect */\n      }\n    }, this.cfg.pingIntervalMs);\n  }\n\n  private stopPing(): void {\n    if (this.pingTimer) {\n      clearInterval(this.pingTimer);\n      this.pingTimer = null;\n    }\n  }\n\n  private scheduleReconnect(): void {\n    const next = this.backoff.next();\n    if (!next) {\n      this.emit(\"error\", new Error(\"max reconnect attempts exceeded\"));\n      return;\n    }\n    this.emit(\"reconnecting\", next.attempt, next.wait);\n    setTimeout(() => {\n      this.connect().catch((e) => this.emit(\"error\", e as Error));\n    }, next.wait);\n  }\n}\n","import { BookMerger } from \"../../core/book-merger.js\";\nimport { OrderbookStream } from \"../../core/stream.js\";\nimport type { BookEvent, Market, Orderbook } from \"../../core/types.js\";\nimport { WSClient } from \"../../transport/ws.js\";\nimport { fromHyperliquidSymbol, toHyperliquidSymbol } from \"./symbols.js\";\nimport type { HyperliquidL2Book, HyperliquidWSMessage } from \"./types.js\";\n\nexport interface StreamHyperliquidOrderbookOptions {\n  symbol: string;\n  market: Market;\n  /** Present for API parity — hyperliquid doesn't expose a depth parameter on l2Book. */\n  depth?: number;\n  transformUrl?: (url: string) => string;\n  timeoutMs?: number;\n}\n\nconst WS_URL = \"wss://api.hyperliquid.xyz/ws\";\n\n/**\n * Hyperliquid pushes a full L2 snapshot on every change via the `l2Book`\n * subscription. We feed each frame straight to the merger as a snapshot;\n * the merger's \"sequence must increase\" guard rejects out-of-order frames\n * but there is no real gap-detection signal — we trust WS ordering.\n *\n * Heartbeat: client sends `{\"method\":\"ping\"}` every 50s; server replies\n * `{\"channel\":\"pong\"}` which we ignore.\n */\nexport function streamHyperliquidOrderbook(\n  opts: StreamHyperliquidOrderbookOptions\n): OrderbookStream {\n  if (opts.market !== \"perpetual\") {\n    const s = new OrderbookStream(() => undefined);\n    queueMicrotask(() =>\n      s.emit(\n        \"error\",\n        new Error(\n          \"hyperliquid: only perpetual markets are supported (spot uses @N-indexed coins)\"\n        )\n      )\n    );\n    return s;\n  }\n\n  const coin = toHyperliquidSymbol(opts.symbol);\n\n  const merger = new BookMerger();\n  let ws: WSClient | null = null;\n  const stream = new OrderbookStream(() => ws?.close());\n\n  const subscribePayload = JSON.stringify({\n    method: \"subscribe\",\n    subscription: { type: \"l2Book\", coin },\n  });\n\n  const onMessage = (raw: string | ArrayBuffer) => {\n    if (typeof raw !== \"string\") return;\n    let msg: HyperliquidWSMessage;\n    try {\n      msg = JSON.parse(raw) as HyperliquidWSMessage;\n    } catch {\n      return;\n    }\n    if (msg.channel === \"pong\" || msg.channel === \"subscriptionResponse\") {\n      return;\n    }\n    if (msg.channel !== \"l2Book\" || !msg.data) return;\n    const book = msg.data as HyperliquidL2Book;\n    if (book.coin !== coin) return;\n\n    const event: BookEvent = {\n      kind: \"snapshot\",\n      bids: book.levels[0].map((l) => ({\n        price: Number(l.px),\n        size: Number(l.sz),\n      })),\n      asks: book.levels[1].map((l) => ({\n        price: Number(l.px),\n        size: Number(l.sz),\n      })),\n      sequence: book.time,\n      timestamp: book.time,\n    };\n\n    const r = merger.apply(event);\n    if (!r.ok) return;\n    const out: Orderbook = {\n      exchange: \"hyperliquid\",\n      symbol: fromHyperliquidSymbol(coin),\n      market: \"perpetual\",\n      bids: r.bids,\n      asks: r.asks,\n      timestamp: r.timestamp,\n      sequence: r.sequence,\n    };\n    stream.emit(\"update\", out);\n  };\n\n  ws = new WSClient({\n    url: WS_URL,\n    onOpen: (sock) => {\n      merger.reset();\n      sock.send(subscribePayload);\n    },\n    onMessage,\n    pingIntervalMs: 50_000,\n    pingPayload: () => JSON.stringify({ method: \"ping\" }),\n  });\n\n  ws.on(\"open\", () => stream.emit(\"connected\"));\n  ws.on(\"close\", (r) => stream.emit(\"disconnected\", r));\n  ws.on(\"reconnecting\", (a, w) => stream.emit(\"reconnecting\", a, w));\n  ws.on(\"error\", (e) => stream.emit(\"error\", e));\n  ws.connect().catch((e) => stream.emit(\"error\", e as Error));\n\n  return stream;\n}\n","import type {\n  ClientOptions,\n  Orderbook,\n  OrderbookOptions,\n} from \"../../core/types.js\";\nimport { OrderbookStream } from \"../../core/stream.js\";\nimport { parseSymbol } from \"../../core/symbol.js\";\nimport { fetchHyperliquidOrderbook } from \"./rest.js\";\nimport { streamHyperliquidOrderbook } from \"./ws.js\";\n\nexport class HyperliquidClient {\n  readonly exchange = \"hyperliquid\" as const;\n  private readonly transformUrl?: (url: string) => string;\n  private readonly timeoutMs?: number;\n\n  constructor(opts: ClientOptions = {}) {\n    this.transformUrl = opts.transformUrl;\n    this.timeoutMs = opts.timeoutMs;\n  }\n\n  fetchOrderbook(\n    symbol: string,\n    opts: OrderbookOptions = {}\n  ): Promise<Orderbook> {\n    const { pair, market } = parseSymbol(symbol);\n    return fetchHyperliquidOrderbook({\n      symbol: pair,\n      market,\n      depth: opts.depth,\n      timeoutMs: this.timeoutMs,\n      transformUrl: this.transformUrl,\n    });\n  }\n\n  streamOrderbook(\n    symbol: string,\n    opts: OrderbookOptions = {}\n  ): OrderbookStream {\n    const { pair, market } = parseSymbol(symbol);\n    return streamHyperliquidOrderbook({\n      symbol: pair,\n      market,\n      depth: opts.depth,\n      transformUrl: this.transformUrl,\n      timeoutMs: this.timeoutMs,\n    });\n  }\n}\n\nexport { fetchHyperliquidOrderbook } from \"./rest.js\";\nexport { streamHyperliquidOrderbook } from \"./ws.js\";\n"]}

package/dist/exchanges/hyperliquid/index.d.cts

@@ -0,0 +1,45 @@
+import { M as Market, a as Orderbook, c as OrderbookStream, C as ClientOptions, b as OrderbookOptions } from '../../stream-C73HPYqT.cjs';
+
+interface FetchHyperliquidOrderbookOptions {
+    symbol: string;
+    market: Market;
+    /** Hyperliquid's `info` endpoint does not honor a depth parameter — present for API parity. */
+    depth?: number;
+    timeoutMs?: number;
+    transformUrl?: (url: string) => string;
+}
+/**
+ * POST /info with body `{"type":"l2Book","coin":"BTC"}` returns the same
+ * payload the WS `l2Book` channel pushes — full snapshot every call.
+ */
+declare function fetchHyperliquidOrderbook(opts: FetchHyperliquidOrderbookOptions): Promise<Orderbook>;
+
+interface StreamHyperliquidOrderbookOptions {
+    symbol: string;
+    market: Market;
+    /** Present for API parity — hyperliquid doesn't expose a depth parameter on l2Book. */
+    depth?: number;
+    transformUrl?: (url: string) => string;
+    timeoutMs?: number;
+}
+/**
+ * Hyperliquid pushes a full L2 snapshot on every change via the `l2Book`
+ * subscription. We feed each frame straight to the merger as a snapshot;
+ * the merger's "sequence must increase" guard rejects out-of-order frames
+ * but there is no real gap-detection signal — we trust WS ordering.
+ *
+ * Heartbeat: client sends `{"method":"ping"}` every 50s; server replies
+ * `{"channel":"pong"}` which we ignore.
+ */
+declare function streamHyperliquidOrderbook(opts: StreamHyperliquidOrderbookOptions): OrderbookStream;
+
+declare class HyperliquidClient {
+    readonly exchange: "hyperliquid";
+    private readonly transformUrl?;
+    private readonly timeoutMs?;
+    constructor(opts?: ClientOptions);
+    fetchOrderbook(symbol: string, opts?: OrderbookOptions): Promise<Orderbook>;
+    streamOrderbook(symbol: string, opts?: OrderbookOptions): OrderbookStream;
+}
+
+export { HyperliquidClient, fetchHyperliquidOrderbook, streamHyperliquidOrderbook };