@lifi/perps-sdk-provider-hyperliquid 1.5.4 → 1.5.6

package/dist/esm/services/getFills.d.ts

@@ -10,7 +10,7 @@ import type { HyperliquidContext } from '../context.js';
 export interface GetFillsParams {
     address: Address;
     limit?: number;
-    /** `tid` of the oldest fill to return (returned items have `tid < cursor`). */
+    /** Opaque pagination cursor from a previous page's `pagination.cursor`. */
     cursor?: string;
     /** Inclusive lower bound in ms-since-epoch — switches to the `userFillsByTime` endpoint. */
     startTime?: number;
@@ -24,9 +24,9 @@ export interface GetFillsParams {
  * list supplies the display fields; only the fills endpoint is read direct
  * from HL.
  *
- * Pagination is cursor-based on the fill's `tid`: results with
- * `tid < cursor` are kept and the last-page's tail `id` is returned as the
- * next cursor.
+ * The response is sorted (time desc, `tid` as tiebreaker) before pagination —
+ * see {@link compareFillsDesc}. The cursor encodes the last returned fill's
+ * `(time, tid)`; the next page keeps fills that sort strictly after it.
  * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
  * @public
  */

package/dist/esm/services/getFills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFills.d.ts","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAMnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAKvD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,GACnB,oBAAoB,kBAAkB,EACtC,QAAQ,cAAc,EACtB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,aAAa,CAiDvB,CAAA"}
+{"version":3,"file":"getFills.d.ts","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAMnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AASvD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAoBD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,GACnB,oBAAoB,kBAAkB,EACtC,QAAQ,cAAc,EACtB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,aAAa,CAqDvB,CAAA"}

package/dist/esm/services/getFills.js

@@ -2,6 +2,15 @@ import { getMarketRegistry } from '@lifi/perps-sdk';
 import { DEFAULT_HISTORY_LIMIT, MAX_HISTORY_LIMIT, PROVIDER_KEY, } from '../constants.js';
 import { mapFill } from '../utils/index.js';
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js';
+// HL's docs specify neither newest-first ordering nor monotonic `tid` for
+// `userFills`/`userFillsByTime`, so pagination can't rely on upstream order —
+// it must impose its own (time desc, tid desc as tiebreaker for same-time fills).
+const compareFillsDesc = (a, b) => b.time - a.time || b.tid - a.tid;
+const encodeCursor = (fill) => `${fill.time}:${fill.tid}`;
+const decodeCursor = (cursor) => {
+    const [time, tid] = cursor.split(':').map(Number);
+    return { time, tid };
+};
 /**
  * Fetch the user's fills history. When `startTime` or `endTime` is provided,
  * Hyperliquid's `userFillsByTime` endpoint is used; otherwise the unbounded
@@ -9,9 +18,9 @@ import { hlInfoOptions, infoRequest } from '../utils/infoClient.js';
  * list supplies the display fields; only the fills endpoint is read direct
  * from HL.
  *
- * Pagination is cursor-based on the fill's `tid`: results with
- * `tid < cursor` are kept and the last-page's tail `id` is returned as the
- * next cursor.
+ * The response is sorted (time desc, `tid` as tiebreaker) before pagination —
+ * see {@link compareFillsDesc}. The cursor encodes the last returned fill's
+ * `(time, tid)`; the next page keeps fills that sort strictly after it.
  * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
  * @public
  */
@@ -29,20 +38,21 @@ export const getFills = async ({ client, apiUrl }, params, options) => {
             ...(params.endTime !== undefined ? { endTime: params.endTime } : {}),
         }, infoOpts)
         : await infoRequest(apiUrl, { type: 'userFills', user: params.address }, infoOpts);
+    const sorted = [...allFills].sort(compareFillsDesc);
     const filtered = params.cursor === undefined
-        ? allFills
-        : allFills.filter((f) => f.tid < Number.parseInt(params.cursor, 10));
+        ? sorted
+        : sorted.filter((f) => compareFillsDesc(f, decodeCursor(params.cursor)) > 0);
     const hasMore = filtered.length > limit;
-    const items = filtered
-        .slice(0, limit)
-        .map((f) => mapFill(f, registry.require(f.coin)));
+    const page = filtered.slice(0, limit);
+    const items = page.map((f) => mapFill(f, registry.require(f.coin)));
+    const lastPageFill = page[page.length - 1];
     return {
         provider: PROVIDER_KEY,
         items,
         pagination: {
             limit,
             hasMore,
-            cursor: items.length > 0 ? items[items.length - 1].id : undefined,
+            cursor: lastPageFill ? encodeCursor(lastPageFill) : undefined,
         },
     };
 };

package/dist/esm/services/getFills.js.map

@@ -1 +1 @@
-{"version":3,"file":"getFills.js","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA0B,MAAM,iBAAiB,CAAA;AAG3E,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAkBnE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,EAAE,MAAM,EAAE,MAAM,EAAsB,EACtC,MAAsB,EACtB,OAA2B,EACH,EAAE;IAC1B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACxD,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IACrB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,MAAM,CAAC,KAAK,IAAI,qBAAqB,EACrC,iBAAiB,CAClB,CAAA;IAED,MAAM,SAAS,GACb,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,CAAA;IAEhE,MAAM,QAAQ,GAAG,SAAS;QACxB,CAAC,CAAC,MAAM,WAAW,CACf,MAAM,EACN;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,MAAM,CAAC,OAAO;YACpB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,CAAC;YAChC,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,EACD,QAAQ,CACT;QACH,CAAC,CAAC,MAAM,WAAW,CACf,MAAM,EACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,EAC3C,QAAQ,CACT,CAAA;IAEL,MAAM,QAAQ,GACZ,MAAM,CAAC,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IAEzE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAA;IACvC,MAAM,KAAK,GAAG,QAAQ;SACnB,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAEnD,OAAO;QACL,QAAQ,EAAE,YAAY;QACtB,KAAK;QACL,UAAU,EAAE;YACV,KAAK;YACL,OAAO;YACP,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;SAClE;KACF,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"getFills.js","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"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"}

package/dist/esm/services/getOrders.js

@@ -24,7 +24,7 @@ export const getOrders = async ({ client, apiUrl }, params, options) => {
     const raw = ordersResults.flat();
     const childOids = new Set();
     for (const o of raw) {
-        for (const child of o.children) {
+        for (const child of o.children ?? []) {
             childOids.add(child.oid);
         }
     }

package/dist/esm/services/getOrders.js.map

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

package/dist/esm/types/order.d.ts

@@ -13,7 +13,7 @@ export type HlFrontendOpenOrder = {
     isPositionTpsl: boolean;
     triggerCondition: string;
     triggerPx: string;
-    children: HlFrontendOpenOrder[];
+    children?: HlFrontendOpenOrder[];
     tif: string | null;
     cloid: string | null;
 };

package/dist/esm/types/order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../src/types/order.ts"],"names":[],"mappings":"AAEA,cAAc;AACd,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,cAAc,EAAE,OAAO,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,mBAAmB,EAAE,CAAA;IAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,EAAE,CAAA;AAExD,cAAc;AACd,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,OAAO,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;QAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,gBAAgB,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KACzB,CAAA;IACD,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,aAAa,CAAA;CACrB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAA"}
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../src/types/order.ts"],"names":[],"mappings":"AAEA,cAAc;AACd,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,cAAc,EAAE,OAAO,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAChC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,EAAE,CAAA;AAExD,cAAc;AACd,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,OAAO,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;QAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,gBAAgB,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KACzB,CAAA;IACD,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,aAAa,CAAA;CACrB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAA"}

package/dist/esm/utils/decodeFastAssetCtxs.d.ts

@@ -1,4 +1,5 @@
 import type { HlWsFastAssetCtx } from '../types/index.js';
+/** Decode a base64 + raw-DEFLATE (RFC 1951) payload into parsed JSON. */
 export declare function decodeCompressedJson<T>(base64: string): Promise<T>;
 /**
  * Decode a Hyperliquid `fastAssetCtxs` frame. HL sends the payload as a

package/dist/esm/utils/decodeFastAssetCtxs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decodeFastAssetCtxs.d.ts","sourceRoot":"","sources":["../../../src/utils/decodeFastAssetCtxs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAOxE;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAE3C"}
+{"version":3,"file":"decodeFastAssetCtxs.d.ts","sourceRoot":"","sources":["../../../src/utils/decodeFastAssetCtxs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,yEAAyE;AACzE,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAcxE;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAE3C"}

package/dist/esm/utils/decodeFastAssetCtxs.js

@@ -1,10 +1,18 @@
+/** Decode a base64 + raw-DEFLATE (RFC 1951) payload into parsed JSON. */
 export async function decodeCompressedJson(base64) {
-    const bytes = Uint8Array.from(atob(base64), (c) => c.charCodeAt(0));
-    const stream = new Blob([bytes])
-        .stream()
-        .pipeThrough(new DecompressionStream('deflate-raw'));
-    const text = await new Response(stream).text();
-    return JSON.parse(text);
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    const stream = new DecompressionStream('deflate-raw');
+    const text = new Response(stream.readable).text();
+    const writer = stream.writable.getWriter();
+    // Write-side failures (bad DEFLATE) also error the readable and reject
+    // `text`; detach these rejections to avoid unhandled duplicates.
+    writer.write(bytes).catch(() => undefined);
+    writer.close().catch(() => undefined);
+    return JSON.parse(await text);
 }
 /**
  * Decode a Hyperliquid `fastAssetCtxs` frame. HL sends the payload as a

package/dist/esm/utils/decodeFastAssetCtxs.js.map

@@ -1 +1 @@
-{"version":3,"file":"decodeFastAssetCtxs.js","sourceRoot":"","sources":["../../../src/utils/decodeFastAssetCtxs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAI,MAAc;IAC1D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IACnE,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;SAC7B,MAAM,EAAE;SACR,WAAW,CAAC,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAA;IACtD,MAAM,IAAI,GAAG,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAA;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc;IAEd,OAAO,oBAAoB,CAAmC,MAAM,CAAC,CAAA;AACvE,CAAC"}
+{"version":3,"file":"decodeFastAssetCtxs.js","sourceRoot":"","sources":["../../../src/utils/decodeFastAssetCtxs.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAI,MAAc;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IACjC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAA;IACrD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAA;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAA;IAC1C,uEAAuE;IACvE,iEAAiE;IACjE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC1C,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAM,CAAA;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc;IAEd,OAAO,oBAAoB,CAAmC,MAAM,CAAC,CAAA;AACvE,CAAC"}

package/dist/esm/websocket/HyperliquidWsProvider.d.ts

@@ -30,13 +30,15 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
     private readonly registry;
     private perpCtxBySubDex;
     private spotCtxByMarketId;
+    private marketsContextByMarketId;
     private orderbookKeysByMarketId;
     private latestOrderbookByMarketId;
     private fastCtxByMarketId;
-    private fastDecodeChain;
-    private pacDecodeChain;
-    private sacDecodeChain;
-    private orderbookDecodeChain;
+    private readonly reportDecodeFailure;
+    private readonly fastDecodeChain;
+    private readonly pacDecodeChain;
+    private readonly sacDecodeChain;
+    private readonly orderbookDecodeChain;
     constructor(wsUrl: string, providerKey: string, client?: PerpsSDKClient);
     subscribeQuote(params: ProviderGetQuoteParams, onQuote: QuoteListener): Promise<() => void>;
     protected openChannel(sub: Subscription): Promise<() => void>;
@@ -65,6 +67,7 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
     protected handleMessage(raw: string): void;
     private handleAllDexsAssetCtxs;
     private handlePac;
+    /** Merge perp asset contexts in place; returns the marketIds this frame touched. */
     private mergePerpAssetCtxEntries;
     private handleSac;
     private spotMarketIdBySacKey;
@@ -72,14 +75,24 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
      * Decode a `fastAssetCtxs` frame (base64 + raw-DEFLATE) and merge its changed
      * coins into the per-market fast-context store. Frames are incremental, so a
      * field absent from this frame keeps its prior value. Decodes are chained to
-     * preserve arrival order across the async boundary.
+     * preserve arrival order across the async boundary; a backlog coalesces to
+     * its newest frame (see the chain's mode).
      */
     private handleFastAssetCtxs;
     /**
-     * Build the all-markets context map from perp + spot asset contexts, with mid
-     * + mark overlaid from `fastAssetCtxs`.
+     * Emit the all-markets context map, re-mapping only the markets the incoming
+     * frame touched. Each emission is a fresh snapshot object that carries
+     * untouched entries over by reference, so a listener holding an earlier
+     * snapshot never observes later-frame mutation.
      */
     private emitMarketsContext;
+    /**
+     * Context for one market from the cached feeds: spot asset context when it
+     * maps, else perp asset context with mid + mark overlaid from
+     * `fastAssetCtxs`, else the fast feed alone — each price standing in for the
+     * other where it carries only one of mid/mark.
+     */
+    private computeMarketContext;
     private handleActiveAssetCtx;
     private handleActiveSpotAssetCtx;
     /** Latest mid per `Market.id` across asset-context and fast feeds. */

package/dist/esm/websocket/HyperliquidWsProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HyperliquidWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/HyperliquidWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAGlB,cAAc,EACd,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAOL,KAAK,YAAY,EAElB,MAAM,mBAAmB,CAAA;AA6C1B;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,QAC5B,iBAEgD,CAAA;AAEtD;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC/D,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,eAAe,CAAsD;IAC7E,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,uBAAuB,CAAiC;IAChE,OAAO,CAAC,yBAAyB,CAAuC;IAKxE,OAAO,CAAC,iBAAiB,CAAuC;IAGhE,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,oBAAoB,CAAmC;gBAEnD,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IASjE,cAAc,CAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;cAkBN,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;IA+DnE;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,iBAAiB;IAmBzB;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAWnC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,gBAAgB;cAcL,OAAO,IAAI,IAAI;IAalC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9C,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;IA0B1C,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,WAAW;IA6CnB,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM;IA8EnC,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,oBAAoB;IAe5B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAuC1B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,wBAAwB;IAWhC,sEAAsE;IACtE,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,kBAAkB;IA0D1B,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,+BAA+B;IAkBvC,OAAO,CAAC,eAAe;CAaxB"}
+{"version":3,"file":"HyperliquidWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/HyperliquidWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAGlB,cAAc,EACd,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAOL,KAAK,YAAY,EAElB,MAAM,mBAAmB,CAAA;AA8C1B;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,QAC5B,iBAEgD,CAAA;AAEtD;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC/D,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,eAAe,CAAsD;IAC7E,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,wBAAwB,CAAoC;IACpE,OAAO,CAAC,uBAAuB,CAAiC;IAChE,OAAO,CAAC,yBAAyB,CAAuC;IAKxE,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CACW;IAM/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG/B;IACD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG9B;IACD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG9B;IACD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAGpC;gBAEW,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IASjE,cAAc,CAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;cAkBN,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;IAgEnE;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,iBAAiB;IAmBzB;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAWnC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,gBAAgB;cAcL,OAAO,IAAI,IAAI;IAclC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9C,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;IA0B1C,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,WAAW;IA6CnB,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM;IA8EnC,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,SAAS;IAUjB,oFAAoF;IACpF,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,oBAAoB;IAe5B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA6B5B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,wBAAwB;IAWhC,sEAAsE;IACtE,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,kBAAkB;IAyD1B,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,+BAA+B;IAkBvC,OAAO,CAAC,eAAe;CAaxB"}

package/dist/esm/websocket/HyperliquidWsProvider.js

@@ -3,6 +3,7 @@ import { OrderSide, OrderType, } from '@lifi/perps-types';
 import Big from 'big.js';
 import { HYPERLIQUID_FEE_TIER_FALLBACK, SPOT_MARKET_ID } from '../constants.js';
 import { decodeCompressedJson, decodeFastAssetCtxs, isOpenAssetPosition, isTriggerOrder, mapFill, mapMarketContext, mapOrderStatus, mapOrderType, mapPosition, priceStepToAggregation, spotAssetFromToken, spotBalance, spotPriceById, } from '../utils/index.js';
+import { DecodeChain } from './decodeChain.js';
 /** HL's compact `l2` snapshot carries 20 levels per side. */
 const HL_L2_BOOK_MAX_LEVELS_PER_SIDE = 20;
 /**
@@ -35,6 +36,7 @@ export class HyperliquidWsProvider extends WsProviderBase {
     registry;
     perpCtxBySubDex = new Map();
     spotCtxByMarketId = {};
+    marketsContextByMarketId = {};
     orderbookKeysByMarketId = new Map();
     latestOrderbookByMarketId = new Map();
     // Latest mid/mark per `Market.id` from the high-frequency `fastAssetCtxs`
@@ -42,12 +44,16 @@ export class HyperliquidWsProvider extends WsProviderBase {
     // frames carry only changed coins — and overlaid onto asset contexts that
     // carry oracle/funding/OI/metadata.
     fastCtxByMarketId = {};
-    // `fastAssetCtxs` payloads are base64 + raw-DEFLATE; decode is async, so
-    // chain decodes to apply incremental frames in arrival order.
-    fastDecodeChain = Promise.resolve();
-    pacDecodeChain = Promise.resolve();
-    sacDecodeChain = Promise.resolve();
-    orderbookDecodeChain = Promise.resolve();
+    reportDecodeFailure = (error) => wsLog.handlerFailure(this.providerKey, error);
+    // Compressed payloads (base64 + raw-DEFLATE) decode async, so each channel
+    // chains decodes to apply frames in arrival order. Only the fast feed
+    // coalesces a stall backlog to its newest frame: a coin's dropped tick is
+    // refreshed by its next one. pac/sac field-merges and l2 deltas depend on
+    // every frame, so they must not coalesce.
+    fastDecodeChain = new DecodeChain('latest', this.reportDecodeFailure);
+    pacDecodeChain = new DecodeChain('every', this.reportDecodeFailure);
+    sacDecodeChain = new DecodeChain('every', this.reportDecodeFailure);
+    orderbookDecodeChain = new DecodeChain('every', this.reportDecodeFailure);
     constructor(wsUrl, providerKey, client) {
         super(new ReconnectingWebSocket(wsUrl, { pingPayload: '{"method":"ping"}' }), providerKey);
         this.client = client;
@@ -84,6 +90,7 @@ export class HyperliquidWsProvider extends WsProviderBase {
                 this.perpCtxBySubDex.clear();
                 this.spotCtxByMarketId = {};
                 this.fastCtxByMarketId = {};
+                this.marketsContextByMarketId = {};
             };
         }
         // All other channels: single WS subscription per key
@@ -179,12 +186,13 @@ export class HyperliquidWsProvider extends WsProviderBase {
         this.perpCtxBySubDex.clear();
         this.spotCtxByMarketId = {};
         this.fastCtxByMarketId = {};
+        this.marketsContextByMarketId = {};
         this.orderbookKeysByMarketId.clear();
         this.latestOrderbookByMarketId.clear();
-        this.fastDecodeChain = Promise.resolve();
-        this.pacDecodeChain = Promise.resolve();
-        this.sacDecodeChain = Promise.resolve();
-        this.orderbookDecodeChain = Promise.resolve();
+        this.fastDecodeChain.reset();
+        this.pacDecodeChain.reset();
+        this.sacDecodeChain.reset();
+        this.orderbookDecodeChain.reset();
         this.orderUpdatesKey = undefined;
     }
     sendSubscribe(payload) {
@@ -341,41 +349,41 @@ export class HyperliquidWsProvider extends WsProviderBase {
         }
     }
     handleAllDexsAssetCtxs(data) {
-        this.mergePerpAssetCtxEntries(allDexsAssetCtxEntries(data));
-        this.emitMarketsContext();
+        this.emitMarketsContext(this.mergePerpAssetCtxEntries(allDexsAssetCtxEntries(data)));
     }
     handlePac(base64) {
-        this.pacDecodeChain = this.pacDecodeChain
-            .then(async () => {
-            this.mergePerpAssetCtxEntries(await decodeCompressedJson(base64));
-            this.emitMarketsContext();
-        })
-            .catch((error) => wsLog.handlerFailure(this.providerKey, error));
+        this.pacDecodeChain.push(async () => {
+            this.emitMarketsContext(this.mergePerpAssetCtxEntries(await decodeCompressedJson(base64)));
+        });
     }
+    /** Merge perp asset contexts in place; returns the marketIds this frame touched. */
     mergePerpAssetCtxEntries(entries) {
+        const touched = new Set();
         for (const [dex, ctxs] of entries) {
-            const previous = this.perpCtxBySubDex.get(dex || 'default');
-            const byMarketId = {
-                ...(previous ?? {}),
-            };
+            let byMarketId = this.perpCtxBySubDex.get(dex || 'default');
+            if (byMarketId === undefined) {
+                byMarketId = {};
+                this.perpCtxBySubDex.set(dex || 'default', byMarketId);
+            }
             for (const ctx of ctxs) {
                 const marketId = ctx.coin;
                 if (marketId === undefined) {
                     continue;
                 }
-                const merged = mergePerpAssetCtx(previous?.[marketId], marketId, ctx);
+                const merged = mergePerpAssetCtx(byMarketId[marketId], marketId, ctx);
                 if (merged !== undefined) {
                     byMarketId[marketId] = merged;
+                    touched.add(marketId);
                 }
             }
-            this.perpCtxBySubDex.set(dex || 'default', byMarketId);
         }
+        return touched;
     }
     handleSac(base64) {
-        this.sacDecodeChain = this.sacDecodeChain
-            .then(async () => {
+        this.sacDecodeChain.push(async () => {
             const spotMarketIdBySacKey = this.spotMarketIdBySacKey();
             const ctxs = await decodeCompressedJson(base64);
+            const touched = new Set();
             for (const [sacKey, ctx] of Object.entries(ctxs)) {
                 const marketId = spotMarketIdBySacKey.get(sacKey);
                 if (marketId === undefined) {
@@ -385,10 +393,10 @@ export class HyperliquidWsProvider extends WsProviderBase {
                     ...this.spotCtxByMarketId[marketId],
                     ...ctx,
                 };
+                touched.add(marketId);
             }
-            this.emitMarketsContext();
-        })
-            .catch((error) => wsLog.handlerFailure(this.providerKey, error));
+            this.emitMarketsContext(touched);
+        });
     }
     spotMarketIdBySacKey() {
         const map = new Map();
@@ -405,11 +413,11 @@ export class HyperliquidWsProvider extends WsProviderBase {
      * Decode a `fastAssetCtxs` frame (base64 + raw-DEFLATE) and merge its changed
      * coins into the per-market fast-context store. Frames are incremental, so a
      * field absent from this frame keeps its prior value. Decodes are chained to
-     * preserve arrival order across the async boundary.
+     * preserve arrival order across the async boundary; a backlog coalesces to
+     * its newest frame (see the chain's mode).
      */
     handleFastAssetCtxs(base64) {
-        this.fastDecodeChain = this.fastDecodeChain
-            .then(async () => {
+        this.fastDecodeChain.push(async () => {
             const ctxs = await decodeFastAssetCtxs(base64);
             for (const [marketId, ctx] of Object.entries(ctxs)) {
                 const prev = this.fastCtxByMarketId[marketId];
@@ -418,48 +426,65 @@ export class HyperliquidWsProvider extends WsProviderBase {
                     midPx: 'midPx' in ctx ? ctx.midPx : prev?.midPx,
                 };
             }
-            this.emitMarketsContext();
-        })
-            .catch((error) => wsLog.handlerFailure(this.providerKey, error));
+            this.emitMarketsContext(Object.keys(ctxs));
+        });
     }
     /**
-     * Build the all-markets context map from perp + spot asset contexts, with mid
-     * + mark overlaid from `fastAssetCtxs`.
+     * Emit the all-markets context map, re-mapping only the markets the incoming
+     * frame touched. Each emission is a fresh snapshot object that carries
+     * untouched entries over by reference, so a listener holding an earlier
+     * snapshot never observes later-frame mutation.
      */
-    emitMarketsContext() {
-        const data = {};
-        for (const byMarketId of this.perpCtxBySubDex.values()) {
-            for (const [marketId, ctx] of Object.entries(byMarketId)) {
-                const base = mapMarketContext(marketId, ctx);
-                const fast = this.fastCtxByMarketId[marketId];
-                data[marketId] = {
-                    ...base,
-                    midPrice: fast?.midPx != null ? fast.midPx : base.midPrice,
-                    markPrice: fast?.markPx != null ? fast.markPx : base.markPrice,
-                };
-            }
-        }
-        for (const [marketId, ctx] of Object.entries(this.spotCtxByMarketId)) {
-            const context = mapSpotMarketContext(marketId, ctx, this.fastCtxByMarketId[marketId]);
+    emitMarketsContext(touchedMarketIds) {
+        const data = {
+            ...this.marketsContextByMarketId,
+        };
+        for (const marketId of touchedMarketIds) {
+            const context = this.computeMarketContext(marketId);
             if (context === undefined) {
-                continue;
-            }
-            data[marketId] = context;
-        }
-        for (const [marketId, fast] of Object.entries(this.fastCtxByMarketId)) {
-            if (data[marketId] !== undefined) {
-                continue;
+                delete data[marketId];
             }
-            // No asset-context frame for this market yet — each price stands in for
-            // the other where the fast feed carries only one of mid/mark.
-            const midPrice = fast.midPx ?? fast.markPx;
-            const markPrice = fast.markPx ?? fast.midPx;
-            if (midPrice != null && markPrice != null) {
-                data[marketId] = { marketId, midPrice, markPrice };
+            else {
+                data[marketId] = context;
             }
         }
+        this.marketsContextByMarketId = data;
         this.emit('marketsContext', { channel: 'marketsContext', data });
     }
+    /**
+     * Context for one market from the cached feeds: spot asset context when it
+     * maps, else perp asset context with mid + mark overlaid from
+     * `fastAssetCtxs`, else the fast feed alone — each price standing in for the
+     * other where it carries only one of mid/mark.
+     */
+    computeMarketContext(marketId) {
+        const fast = this.fastCtxByMarketId[marketId];
+        const spotCtx = this.spotCtxByMarketId[marketId];
+        if (spotCtx !== undefined) {
+            const context = mapSpotMarketContext(marketId, spotCtx, fast);
+            if (context !== undefined) {
+                return context;
+            }
+        }
+        let perpCtx;
+        for (const byMarketId of this.perpCtxBySubDex.values()) {
+            perpCtx = byMarketId[marketId] ?? perpCtx;
+        }
+        if (perpCtx !== undefined) {
+            const base = mapMarketContext(marketId, perpCtx);
+            return {
+                ...base,
+                midPrice: fast?.midPx != null ? fast.midPx : base.midPrice,
+                markPrice: fast?.markPx != null ? fast.markPx : base.markPrice,
+            };
+        }
+        const midPrice = fast?.midPx ?? fast?.markPx;
+        const markPrice = fast?.markPx ?? fast?.midPx;
+        if (midPrice != null && markPrice != null) {
+            return { marketId, midPrice, markPrice };
+        }
+        return undefined;
+    }
     handleActiveAssetCtx(data, raw) {
         const ctx = activePerpAssetCtx(data.coin, data.ctx);
         if (ctx === undefined) {
@@ -543,17 +568,22 @@ export class HyperliquidWsProvider extends WsProviderBase {
             return;
         }
         const compressed = data.c;
-        this.orderbookDecodeChain = this.orderbookDecodeChain
-            .then(async () => {
+        this.orderbookDecodeChain.push(async () => {
             this.handleCompactL2Delta(await decodeCompressedJson(compressed));
-        })
-            .catch((error) => wsLog.handlerFailure(this.providerKey, error));
+        });
     }
     handleCompactL2Delta(delta) {
         const previous = this.latestOrderbookByMarketId.get(delta.c);
         if (previous === undefined) {
             return;
         }
+        // Compact deltas decode asynchronously via `orderbookDecodeChain`, so one
+        // can resolve after a newer frame (sync snapshot/update, or a later delta)
+        // has already been applied. A delta no newer than the maintained book is
+        // stale; applying it would overwrite fresher state with older levels.
+        if (delta.t <= previous.timestamp) {
+            return;
+        }
         const book = {
             provider: this.providerKey,
             marketId: delta.c,
@@ -621,8 +651,7 @@ export class HyperliquidWsProvider extends WsProviderBase {
                 continue;
             }
             const type = mapOrderType(o.orderType);
-            // A miss warns once and schedules a cooldown-gated registry refetch
-            // (the id may have listed after the snapshot); skip just this item.
+            // Unknown market id (absent from the synced snapshot); skip just this item.
             const market = this.registry?.get(o.coin);
             if (!market) {
                 continue;