@lifi/perps-sdk-provider-hyperliquid 1.0.0 → 1.1.0

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

@@ -1,15 +1,44 @@
 import type { HlClearinghouseState, HlSpotBalance } from './account.js';
-import type { HlAllMids, HlCandle, HlL2Book } from './asset.js';
+import type { HlCandle, HlL2Book } from './asset.js';
 import type { HlUserFill } from './fill.js';
+/**
+ * Perp asset context as carried on the `allDexsAssetCtxs` WS feed. Extends the
+ * REST `/info` `HlAssetCtx` shape with the wire-only `coin` tag, the order-book
+ * `midPx` (null when the book is empty), and `oraclePx`.
+ * @public
+ */
+export type HlWsPerpAssetCtx = {
+    coin: string;
+    funding: string;
+    openInterest: string;
+    dayNtlVlm: string;
+    prevDayPx: string;
+    markPx: string;
+    midPx: string | null;
+    oraclePx: string;
+};
+/**
+ * `allDexsAssetCtxs` carries one `[dex, ctxs]` pair per perp sub-DEX, mirroring
+ * `allDexsClearinghouseState`. Spot contexts arrive separately.
+ * @public
+ */
+export type HlWsAllDexsAssetCtxsData = {
+    assetCtxs: [string, HlWsPerpAssetCtx[]][];
+};
 /** @public */
 export type HlWsMessage = {
     channel: string;
     data: unknown;
 };
-/** @public */
-export type HlWsAllMidsData = {
-    mids: HlAllMids;
-    dex?: string;
+/**
+ * Per-coin entry from the compressed `fastAssetCtxs` feed (mark + mid only,
+ * keyed by coin across all dexes). `midPx` is null when the book is empty;
+ * fields are omitted from incremental frames when unchanged.
+ * @public
+ */
+export type HlWsFastAssetCtx = {
+    markPx?: string;
+    midPx?: string | null;
 };
 /** @public */
 export type HlWsL2BookData = HlL2Book & {

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

@@ -1 +1 @@
-{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../../src/types/ws.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,cAAc;AACd,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAED,cAAc;AACd,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,cAAc;AACd,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAExD,cAAc;AACd,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IACtC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAED,cAAc;AACd,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,mBAAmB,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAA;CAC9E,CAAA;AAED,cAAc;AACd,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAA;CACzC,CAAA"}
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../../src/types/ws.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAA;CAC1C,CAAA;AAED,cAAc;AACd,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAExD,cAAc;AACd,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IACtC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAED,cAAc;AACd,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,mBAAmB,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAA;CAC9E,CAAA;AAED,cAAc;AACd,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAA;CACzC,CAAA"}

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

@@ -0,0 +1,11 @@
+import type { HlWsFastAssetCtx } from '../types/index.js';
+/**
+ * Decode a Hyperliquid `fastAssetCtxs` frame. HL sends the payload as a
+ * base64-encoded, raw-DEFLATE-compressed (RFC 1951 — no zlib/gzip wrapper) JSON
+ * object keyed by coin. Decoded via the web-standard `DecompressionStream`
+ * (Node 18+, modern browsers), so no dependency is needed.
+ *
+ * @throws If the input is not valid base64 / raw-DEFLATE / JSON.
+ */
+export declare function decodeFastAssetCtxs(base64: string): Promise<Record<string, HlWsFastAssetCtx>>;
+//# sourceMappingURL=decodeFastAssetCtxs.d.ts.map

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

@@ -0,0 +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;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAO3C"}

package/dist/esm/utils/decodeFastAssetCtxs.js

@@ -0,0 +1,17 @@
+/**
+ * Decode a Hyperliquid `fastAssetCtxs` frame. HL sends the payload as a
+ * base64-encoded, raw-DEFLATE-compressed (RFC 1951 — no zlib/gzip wrapper) JSON
+ * object keyed by coin. Decoded via the web-standard `DecompressionStream`
+ * (Node 18+, modern browsers), so no dependency is needed.
+ *
+ * @throws If the input is not valid base64 / raw-DEFLATE / JSON.
+ */
+export async function decodeFastAssetCtxs(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);
+}
+//# sourceMappingURL=decodeFastAssetCtxs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decodeFastAssetCtxs.js","sourceRoot":"","sources":["../../../src/utils/decodeFastAssetCtxs.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc;IAEd,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,CAAC,CAAA;AACzB,CAAC"}

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

@@ -1,11 +1,12 @@
 export { assetIsSpot, calculateAssetId, getProviderIndex } from './assetId.js';
+export { decodeFastAssetCtxs } from './decodeFastAssetCtxs.js';
 export type { InfoRequestOptions } from './infoClient.js';
 export { hlInfoOptions, infoRequest } from './infoClient.js';
 export { calculateLiquidationPrice, calculateMaintenanceMarginRate, } from './liquidation.js';
 export { mapFundingActivity, mapLedgerEntry } from './mapActivity.js';
 export { classifyFillFromPosition, mapFill } from './mapFill.js';
 export { mapMarket } from './mapMarket.js';
-export { mapMarketPrice } from './mapMarketPrice.js';
+export { mapMarketContext } from './mapMarketContext.js';
 export { isTriggerOrder, isTriggerType, mapOpenOrder, mapOrder, mapOrderStatus, mapOrderType, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
 export { isOpenAssetPosition, mapPosition } from './mapPosition.js';
 export { coinAsset, perpsDexNames } from './marketDisplay.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC9E,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAA"}

package/dist/esm/utils/index.js

@@ -2,12 +2,13 @@
 // for the package's utility surface. Internal modules import per-file paths
 // (e.g. `./assetId.js`, `./mapFill.js`) directly.
 export { assetIsSpot, calculateAssetId, getProviderIndex } from './assetId.js';
+export { decodeFastAssetCtxs } from './decodeFastAssetCtxs.js';
 export { hlInfoOptions, infoRequest } from './infoClient.js';
 export { calculateLiquidationPrice, calculateMaintenanceMarginRate, } from './liquidation.js';
 export { mapFundingActivity, mapLedgerEntry } from './mapActivity.js';
 export { classifyFillFromPosition, mapFill } from './mapFill.js';
 export { mapMarket } from './mapMarket.js';
-export { mapMarketPrice } from './mapMarketPrice.js';
+export { mapMarketContext } from './mapMarketContext.js';
 export { isTriggerOrder, isTriggerType, mapOpenOrder, mapOrder, mapOrderStatus, mapOrderType, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
 export { isOpenAssetPosition, mapPosition } from './mapPosition.js';
 export { coinAsset, perpsDexNames } from './marketDisplay.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,kDAAkD;AAElD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE9E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,kDAAkD;AAElD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAA"}

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

@@ -2,8 +2,8 @@ import type { PerpsMarket } from '@lifi/perps-types';
 import type { HlUniverseItem } from '../types/index.js';
 /**
  * Map a Hyperliquid universe entry to a {@link PerpsMarket}'s static instrument
- * metadata. Live mark/stats fields live on the `/prices` item — see
- * {@link mapMarketPrice}. `categoryId` is the `Provider.categories[].id` of the
+ * metadata. Live mark/stats fields live on the {@link MarketContext} — see
+ * {@link mapMarketContext}. `categoryId` is the `Provider.categories[].id` of the
  * dex the entry was fetched from — known to the caller at fetch time, never
  * re-derived from the coin string.
  * @public

package/dist/esm/utils/mapMarket.js

@@ -6,8 +6,8 @@ import { getMaxPriceDecimals } from './orderFormatting.js';
 const QUOTE_SYMBOL = 'USDC';
 /**
  * Map a Hyperliquid universe entry to a {@link PerpsMarket}'s static instrument
- * metadata. Live mark/stats fields live on the `/prices` item — see
- * {@link mapMarketPrice}. `categoryId` is the `Provider.categories[].id` of the
+ * metadata. Live mark/stats fields live on the {@link MarketContext} — see
+ * {@link mapMarketContext}. `categoryId` is the `Provider.categories[].id` of the
  * dex the entry was fetched from — known to the caller at fetch time, never
  * re-derived from the coin string.
  * @public

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

@@ -0,0 +1,10 @@
+import type { MarketContext } from '@lifi/perps-types';
+import type { HlWsPerpAssetCtx } from '../types/index.js';
+/**
+ * Map a Hyperliquid perp asset context from the `allDexsAssetCtxs` feed to a
+ * {@link MarketContext}. `midPx` is null when the book is empty; mid then falls
+ * back to the mark so the context always carries a usable mid.
+ * @public
+ */
+export declare const mapMarketContext: (marketId: string, ctx: HlWsPerpAssetCtx) => MarketContext;
+//# sourceMappingURL=mapMarketContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapMarketContext.d.ts","sourceRoot":"","sources":["../../../src/utils/mapMarketContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAIzD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,KAAK,gBAAgB,KACpB,aAkBF,CAAA"}

package/dist/esm/utils/mapMarketContext.js

@@ -0,0 +1,25 @@
+const NEXT_FUNDING_INTERVAL_MS = 60 * 60 * 1000; // 1 hour
+/**
+ * Map a Hyperliquid perp asset context from the `allDexsAssetCtxs` feed to a
+ * {@link MarketContext}. `midPx` is null when the book is empty; mid then falls
+ * back to the mark so the context always carries a usable mid.
+ * @public
+ */
+export const mapMarketContext = (marketId, ctx) => {
+    const now = Date.now();
+    const nextFundingTime = Math.ceil(now / NEXT_FUNDING_INTERVAL_MS) * NEXT_FUNDING_INTERVAL_MS;
+    return {
+        marketId,
+        midPrice: ctx.midPx ?? ctx.markPx,
+        markPrice: ctx.markPx,
+        oraclePrice: ctx.oraclePx,
+        prevDayPrice: ctx.prevDayPx,
+        volume24h: ctx.dayNtlVlm,
+        openInterest: ctx.openInterest,
+        funding: {
+            rate: ctx.funding,
+            nextFundingTime,
+        },
+    };
+};
+//# sourceMappingURL=mapMarketContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapMarketContext.js","sourceRoot":"","sources":["../../../src/utils/mapMarketContext.ts"],"names":[],"mappings":"AAGA,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,SAAS;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,QAAgB,EAChB,GAAqB,EACN,EAAE;IACjB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,MAAM,eAAe,GACnB,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,wBAAwB,CAAC,GAAG,wBAAwB,CAAA;IAEtE,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM;QACjC,SAAS,EAAE,GAAG,CAAC,MAAM;QACrB,WAAW,EAAE,GAAG,CAAC,QAAQ;QACzB,YAAY,EAAE,GAAG,CAAC,SAAS;QAC3B,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,OAAO,EAAE;YACP,IAAI,EAAE,GAAG,CAAC,OAAO;YACjB,eAAe;SAChB;KACF,CAAA;AACH,CAAC,CAAA"}

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

@@ -4,17 +4,16 @@ import { type Subscription } from '@lifi/perps-types';
  * `WsProviderFactory` constructor for Hyperliquid — pass to
  * `new PerpsWsClient(client, { wsProviders: { hyperliquid: hyperliquidWsProvider() } })`.
  *
- * Derives the active sub-DEX set from the `markets` list `PerpsWsClient`
- * passes in (the provider's own key and `'spot'` are excluded — they
- * aren't sub-DEX subscriptions on the HL wire). Higher-order shape mirrors
- * `lighterWsProvider(options)` so the two factories register identically.
+ * Higher-order shape mirrors `lighterWsProvider(options)` so the two factories
+ * register identically.
  *
  * @public
  */
 export declare const hyperliquidWsProvider: () => WsProviderFactory;
 /**
- * Hyperliquid realtime {@link WsProvider}: multiplexes prices, positions,
- * orders, fills and spot balances over a single {@link ReconnectingWebSocket}.
+ * Hyperliquid realtime {@link WsProvider}: multiplexes markets context,
+ * positions, orders, fills and spot balances over a single
+ * {@link ReconnectingWebSocket}.
  * Construct via {@link hyperliquidWsProvider}.
  *
  * `orderUpdates` supports a single address per provider instance: HL delivers
@@ -27,11 +26,12 @@ export declare const hyperliquidWsProvider: () => WsProviderFactory;
  */
 export declare class HyperliquidWsProvider extends WsProviderBase<object> {
     private orderUpdatesKey;
-    private readonly subDexes;
     private readonly client;
     private readonly registry;
-    private midsBySubDex;
-    constructor(wsUrl: string, providerKey: string, subDexes: string[], client?: PerpsSDKClient);
+    private perpCtxBySubDex;
+    private fastCtxByMarketId;
+    private fastDecodeChain;
+    constructor(wsUrl: string, providerKey: string, client?: PerpsSDKClient);
     subscribeQuote(params: ProviderGetQuoteParams, onQuote: QuoteListener): Promise<() => void>;
     protected openChannel(sub: Subscription): Promise<() => void>;
     /**
@@ -41,15 +41,34 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
      * so a wallet switch needn't wait out the teardown linger; a live one throws.
      */
     private claimOrderUpdatesKey;
-    /** Build sub-key + payload pairs for each sub-dex allMids subscription. */
-    private getPriceSubEntries;
+    /**
+     * Sub-key + payload pairs for the markets-context aggregation: the all-dexs
+     * perp asset-context feed (oracle/funding/OI/metadata) plus the compressed
+     * `fastAssetCtxs` feed (high-frequency mid + mark across every dex).
+     */
+    private getMarketsContextSubEntries;
     protected onClose(): void;
     protected sendSubscribe(payload: object): void;
     protected toKey(sub: Subscription): string;
     private toHlPayload;
     protected handleMessage(raw: string): void;
-    private handleAllMids;
-    /** Latest mid per `Market.id`, merged across sub-dex allMids frames. */
+    private handleAllDexsAssetCtxs;
+    /**
+     * 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.
+     */
+    private handleFastAssetCtxs;
+    /**
+     * Build the all-markets context map: every perp asset context across sub-dexs
+     * (oracle/funding/OI/metadata), with mid + mark overlaid from the
+     * high-frequency `fastAssetCtxs` feed. A market present in `fastAssetCtxs` but
+     * without an asset-context frame yet (the aggregate feed is slow/idle) still
+     * gets a mid+mark entry, so price ticks without waiting on the aggregate.
+     */
+    private emitMarketsContext;
+    /** Latest mid per `Market.id` across the perp ctx feed and `fastAssetCtxs`. */
     private mergedMids;
     private handleL2Book;
     private handleCandle;

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,EAIL,KAAK,YAAY,EAElB,MAAM,mBAAmB,CAAA;AA8B1B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,QAC5B,iBAIH,CAAA;AAEH;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC/D,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,YAAY,CAA4C;gBAG9D,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,CAAC,EAAE,cAAc;IAWnB,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;IAgDnE;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAiB5B,2EAA2E;IAC3E,OAAO,CAAC,kBAAkB;cAaP,OAAO,IAAI,IAAI;IAKlC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9C,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;IAmB1C,OAAO,CAAC,WAAW;IAqCnB,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM;IAyDnC,OAAO,CAAC,aAAa;IAYrB,wEAAwE;IACxE,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,kBAAkB;IA0D1B,OAAO,CAAC,eAAe;IAWvB,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,EAKL,KAAK,YAAY,EAElB,MAAM,mBAAmB,CAAA;AAkC1B;;;;;;;;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;IAK7E,OAAO,CAAC,iBAAiB,CAAuC;IAGhE,OAAO,CAAC,eAAe,CAAmC;gBAE9C,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;IAmDnE;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;cAUhB,OAAO,IAAI,IAAI;IAMlC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9C,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;IAmB1C,OAAO,CAAC,WAAW;IAqCnB,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM;IA4DnC,OAAO,CAAC,sBAAsB;IAW9B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IA4B1B,+EAA+E;IAC/E,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,kBAAkB;IA0D1B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,+BAA+B;IAkBvC,OAAO,CAAC,eAAe;CAaxB"}

package/dist/esm/websocket/HyperliquidWsProvider.js

@@ -1,27 +1,23 @@
 import { getMarketRegistry, isActiveOrderStatus, ReconnectingWebSocket, resolveSubscribeQuote, WsProviderBase, wsLog, } from '@lifi/perps-sdk';
 import { OrderSide, OrderType, } from '@lifi/perps-types';
 import { HYPERLIQUID_FEE_TIER_FALLBACK } from '../constants.js';
-import { isOpenAssetPosition, isTriggerOrder, mapFill, mapOrderStatus, mapOrderType, mapPosition, priceStepToAggregation, spotAssetFromToken, spotBalance, spotPriceById, } from '../utils/index.js';
+import { decodeFastAssetCtxs, isOpenAssetPosition, isTriggerOrder, mapFill, mapMarketContext, mapOrderStatus, mapOrderType, mapPosition, priceStepToAggregation, spotAssetFromToken, spotBalance, spotPriceById, } from '../utils/index.js';
 /** HL's `l2Book` returns at most this many levels per side (slow/default mode). */
 const HL_L2_BOOK_MAX_LEVELS_PER_SIDE = 20;
 /**
  * `WsProviderFactory` constructor for Hyperliquid — pass to
  * `new PerpsWsClient(client, { wsProviders: { hyperliquid: hyperliquidWsProvider() } })`.
  *
- * Derives the active sub-DEX set from the `markets` list `PerpsWsClient`
- * passes in (the provider's own key and `'spot'` are excluded — they
- * aren't sub-DEX subscriptions on the HL wire). Higher-order shape mirrors
- * `lighterWsProvider(options)` so the two factories register identically.
+ * Higher-order shape mirrors `lighterWsProvider(options)` so the two factories
+ * register identically.
  *
  * @public
  */
-export const hyperliquidWsProvider = () => ({ provider, wsUrl, markets, client }) => {
-    const subDexes = markets.filter((m) => m !== provider && m !== 'spot');
-    return new HyperliquidWsProvider(wsUrl, provider, subDexes, client);
-};
+export const hyperliquidWsProvider = () => ({ provider, wsUrl, client }) => new HyperliquidWsProvider(wsUrl, provider, client);
 /**
- * Hyperliquid realtime {@link WsProvider}: multiplexes prices, positions,
- * orders, fills and spot balances over a single {@link ReconnectingWebSocket}.
+ * Hyperliquid realtime {@link WsProvider}: multiplexes markets context,
+ * positions, orders, fills and spot balances over a single
+ * {@link ReconnectingWebSocket}.
  * Construct via {@link hyperliquidWsProvider}.
  *
  * `orderUpdates` supports a single address per provider instance: HL delivers
@@ -34,13 +30,19 @@ export const hyperliquidWsProvider = () => ({ provider, wsUrl, markets, client }
  */
 export class HyperliquidWsProvider extends WsProviderBase {
     orderUpdatesKey;
-    subDexes;
     client;
     registry;
-    midsBySubDex = new Map();
-    constructor(wsUrl, providerKey, subDexes, client) {
+    perpCtxBySubDex = new Map();
+    // Latest mid/mark per `Market.id` from the high-frequency `fastAssetCtxs`
+    // feed (all dexes, incl. builder/sub-dex coins). Merged incrementally —
+    // frames carry only changed coins — and overlaid onto the slower
+    // `allDexsAssetCtxs` context (which supplies 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();
+    constructor(wsUrl, providerKey, client) {
         super(new ReconnectingWebSocket(wsUrl, { pingPayload: '{"method":"ping"}' }), providerKey);
-        this.subDexes = subDexes;
         this.client = client;
         this.registry = client && getMarketRegistry(client, providerKey);
     }
@@ -59,9 +61,11 @@ export class HyperliquidWsProvider extends WsProviderBase {
             this.claimOrderUpdatesKey(this.toKey(sub));
         }
         await this.registry?.sync();
-        // Prices require multi-sub-dex allMids subscriptions under one logical key.
-        if (sub.channel === 'prices') {
-            const entries = this.getPriceSubEntries();
+        // Markets context aggregates the all-dexs perp asset-context feed
+        // (oracle, funding, OI, metadata) with the high-frequency `fastAssetCtxs`
+        // feed, which supplies fast mid + mark for every market across all dexes.
+        if (sub.channel === 'marketsContext') {
+            const entries = this.getMarketsContextSubEntries();
             for (const { subKey, payload } of entries) {
                 await this.registerSub(subKey, payload);
             }
@@ -71,7 +75,8 @@ export class HyperliquidWsProvider extends WsProviderBase {
                     this.unregisterSub(subKey);
                     this.rws.send(JSON.stringify({ method: 'unsubscribe', subscription: payload }));
                 }
-                this.midsBySubDex.clear();
+                this.perpCtxBySubDex.clear();
+                this.fastCtxByMarketId = {};
             };
         }
         // All other channels: single WS subscription per key
@@ -105,21 +110,20 @@ export class HyperliquidWsProvider extends WsProviderBase {
         }
         this.orderUpdatesKey = key;
     }
-    /** Build sub-key + payload pairs for each sub-dex allMids subscription. */
-    getPriceSubEntries() {
+    /**
+     * Sub-key + payload pairs for the markets-context aggregation: the all-dexs
+     * perp asset-context feed (oracle/funding/OI/metadata) plus the compressed
+     * `fastAssetCtxs` feed (high-frequency mid + mark across every dex).
+     */
+    getMarketsContextSubEntries() {
         return [
-            {
-                subKey: 'allMids:default',
-                payload: { type: 'allMids' },
-            },
-            ...this.subDexes.map((dex) => ({
-                subKey: `allMids:${dex}`,
-                payload: { type: 'allMids', dex },
-            })),
+            { subKey: 'allDexsAssetCtxs', payload: { type: 'allDexsAssetCtxs' } },
+            { subKey: 'fastAssetCtxs', payload: { type: 'fastAssetCtxs' } },
         ];
     }
     onClose() {
-        this.midsBySubDex.clear();
+        this.perpCtxBySubDex.clear();
+        this.fastCtxByMarketId = {};
         this.orderUpdatesKey = undefined;
     }
     sendSubscribe(payload) {
@@ -127,8 +131,8 @@ export class HyperliquidWsProvider extends WsProviderBase {
     }
     toKey(sub) {
         switch (sub.channel) {
-            case 'prices':
-                return 'allMids';
+            case 'marketsContext':
+                return 'marketsContext';
             case 'orderbook':
                 return `l2Book:${sub.marketId}`;
             case 'candle':
@@ -145,10 +149,10 @@ export class HyperliquidWsProvider extends WsProviderBase {
     }
     toHlPayload(sub) {
         switch (sub.channel) {
-            case 'prices':
-                // Prices are handled via getPriceSubEntries in subscribe()
-                // and never reach toHlPayload, but TS requires exhaustive cases.
-                return { type: 'allMids' };
+            case 'marketsContext':
+                // Handled via getMarketsContextSubEntries in openChannel; never reaches
+                // toHlPayload, but TS requires an exhaustive switch.
+                return { type: 'allDexsAssetCtxs' };
             case 'orderbook':
                 return {
                     type: 'l2Book',
@@ -200,8 +204,11 @@ export class HyperliquidWsProvider extends WsProviderBase {
         }
         try {
             switch (msg.channel) {
-                case 'allMids':
-                    this.handleAllMids(msg.data);
+                case 'allDexsAssetCtxs':
+                    this.handleAllDexsAssetCtxs(msg.data);
+                    break;
+                case 'fastAssetCtxs':
+                    this.handleFastAssetCtxs(msg.data);
                     break;
                 case 'l2Book':
                     this.handleL2Book(msg.data);
@@ -227,20 +234,83 @@ export class HyperliquidWsProvider extends WsProviderBase {
             wsLog.handlerFailure(this.providerKey, error);
         }
     }
-    handleAllMids(data) {
-        const subDexKey = data.dex || 'default';
-        this.midsBySubDex.set(subDexKey, data.mids);
-        const merged = {};
-        for (const mids of this.midsBySubDex.values()) {
-            Object.assign(merged, mids);
+    handleAllDexsAssetCtxs(data) {
+        for (const [dex, ctxs] of data.assetCtxs) {
+            const byMarketId = {};
+            for (const ctx of ctxs) {
+                byMarketId[ctx.coin] = ctx;
+            }
+            this.perpCtxBySubDex.set(dex || 'default', byMarketId);
         }
-        this.emit('allMids', { channel: 'prices', data: merged });
+        this.emitMarketsContext();
     }
-    /** Latest mid per `Market.id`, merged across sub-dex allMids frames. */
+    /**
+     * 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.
+     */
+    handleFastAssetCtxs(base64) {
+        this.fastDecodeChain = this.fastDecodeChain
+            .then(async () => {
+            const ctxs = await decodeFastAssetCtxs(base64);
+            for (const [marketId, ctx] of Object.entries(ctxs)) {
+                const prev = this.fastCtxByMarketId[marketId];
+                this.fastCtxByMarketId[marketId] = {
+                    markPx: 'markPx' in ctx ? ctx.markPx : prev?.markPx,
+                    midPx: 'midPx' in ctx ? ctx.midPx : prev?.midPx,
+                };
+            }
+            this.emitMarketsContext();
+        })
+            .catch((error) => wsLog.handlerFailure(this.providerKey, error));
+    }
+    /**
+     * Build the all-markets context map: every perp asset context across sub-dexs
+     * (oracle/funding/OI/metadata), with mid + mark overlaid from the
+     * high-frequency `fastAssetCtxs` feed. A market present in `fastAssetCtxs` but
+     * without an asset-context frame yet (the aggregate feed is slow/idle) still
+     * gets a mid+mark entry, so price ticks without waiting on the aggregate.
+     */
+    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, fast] of Object.entries(this.fastCtxByMarketId)) {
+            if (data[marketId] !== undefined) {
+                continue;
+            }
+            // 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 };
+            }
+        }
+        this.emit('marketsContext', { channel: 'marketsContext', data });
+    }
+    /** Latest mid per `Market.id` across the perp ctx feed and `fastAssetCtxs`. */
     mergedMids() {
         const map = new Map();
-        for (const mids of this.midsBySubDex.values()) {
-            for (const [id, mid] of Object.entries(mids)) {
+        for (const byMarketId of this.perpCtxBySubDex.values()) {
+            for (const [id, ctx] of Object.entries(byMarketId)) {
+                const mid = ctx.midPx ?? ctx.markPx;
+                map.set(id, Number(mid));
+            }
+        }
+        for (const [id, fast] of Object.entries(this.fastCtxByMarketId)) {
+            const mid = fast.midPx ?? fast.markPx;
+            if (mid != null) {
                 map.set(id, Number(mid));
             }
         }
@@ -375,12 +445,16 @@ const isObject = (v) => typeof v === 'object' && v !== null;
  * to the dispatch switch, which silently ignores them.
  */
 function isValidHlFrame(channel, data) {
+    // `fastAssetCtxs` carries a base64 string payload, not an object.
+    if (channel === 'fastAssetCtxs') {
+        return typeof data === 'string';
+    }
     if (!isObject(data)) {
         return false;
     }
     switch (channel) {
-        case 'allMids':
-            return isObject(data.mids);
+        case 'allDexsAssetCtxs':
+            return Array.isArray(data.assetCtxs);
         case 'l2Book':
             return (typeof data.coin === 'string' &&
                 Array.isArray(data.levels) &&