@lifi/perps-sdk-provider-hyperliquid 1.5.3 → 1.5.5

package/dist/types/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/types/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/types/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/types/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/types/utils/mapOrder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapOrder.d.ts","sourceRoot":"","sources":["../../../src/utils/mapOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,KAAK,EACL,YAAY,EACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAEL,WAAW,EACX,SAAS,EAEV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,SAehD,CAAA;AAED,cAAc;AACd,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,KAAG,OAIjB,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,GACzB,GAAG,mBAAmB,GAAG,aAAa,CAAC,OAAO,CAAC,KAC9C,OAkBF,CAAA;AAED,cAAc;AACd,eAAO,MAAM,YAAY,GACvB,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,SAaD,CAAA;AAEF,cAAc;AACd,eAAO,MAAM,eAAe,GAC1B,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,YAcF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,WAwB/C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAyBzD,CAAA;AAeD,cAAc;AACd,eAAO,MAAM,QAAQ,GACnB,QAAQ,aAAa,EACrB,QAAQ,aAAa,KACpB,KAsBF,CAAA"}
+{"version":3,"file":"mapOrder.d.ts","sourceRoot":"","sources":["../../../src/utils/mapOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,KAAK,EACL,YAAY,EACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAEL,WAAW,EACX,SAAS,EAEV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,SAehD,CAAA;AAED,cAAc;AACd,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,KAAG,OAIjB,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,GACzB,GAAG,mBAAmB,GAAG,aAAa,CAAC,OAAO,CAAC,KAC9C,OAkBF,CAAA;AAED,cAAc;AACd,eAAO,MAAM,YAAY,GACvB,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,SAaD,CAAA;AAEF,cAAc;AACd,eAAO,MAAM,eAAe,GAC1B,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,YAcF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,WAwB/C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAmDzD,CAAA;AAeD,cAAc;AACd,eAAO,MAAM,QAAQ,GACnB,QAAQ,aAAa,EACrB,QAAQ,aAAa,KACpB,KAsBF,CAAA"}

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

@@ -30,6 +30,7 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
     private readonly registry;
     private perpCtxBySubDex;
     private spotCtxByMarketId;
+    private marketsContextByMarketId;
     private orderbookKeysByMarketId;
     private latestOrderbookByMarketId;
     private fastCtxByMarketId;
@@ -65,6 +66,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;
@@ -76,10 +78,19 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
      */
     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/types/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;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,wBAAwB,CAAoC;IACpE,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;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;IAYjB,oFAAoF;IACpF,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,oBAAoB;IAe5B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;;;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;IAoBhB,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-hyperliquid",
-  "version": "1.5.3",
+  "version": "1.5.5",
   "description": "Hyperliquid provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -51,7 +51,7 @@
     "@lifi/perps-types": "^1.6.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^1.5.3"
+    "@lifi/perps-sdk": "^1.5.6"
   },
   "publishConfig": {
     "access": "public"

package/src/services/getFills.ts

@@ -7,7 +7,11 @@ import {
   PROVIDER_KEY,
 } from '../constants.js'
 import type { HyperliquidContext } from '../context.js'
-import type { HlUserFills, HlUserFillsByTime } from '../types/index.js'
+import type {
+  HlUserFill,
+  HlUserFills,
+  HlUserFillsByTime,
+} from '../types/index.js'
 import { mapFill } from '../utils/index.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
 
@@ -19,7 +23,7 @@ import { hlInfoOptions, infoRequest } from '../utils/infoClient.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
@@ -27,6 +31,24 @@ export interface GetFillsParams {
   endTime?: number
 }
 
+interface FillCursor {
+  time: number
+  tid: number
+}
+
+// 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: FillCursor, b: FillCursor): number =>
+  b.time - a.time || b.tid - a.tid
+
+const encodeCursor = (fill: FillCursor): string => `${fill.time}:${fill.tid}`
+
+const decodeCursor = (cursor: string): FillCursor => {
+  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
@@ -34,9 +56,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
  */
@@ -74,15 +96,19 @@ export const getFills = async (
         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: HlUserFill | undefined = page[page.length - 1]
 
   return {
     provider: PROVIDER_KEY,
@@ -90,7 +116,7 @@ export const getFills = async (
     pagination: {
       limit,
       hasMore,
-      cursor: items.length > 0 ? items[items.length - 1].id : undefined,
+      cursor: lastPageFill ? encodeCursor(lastPageFill) : undefined,
     },
   }
 }

package/src/services/getOrders.ts

@@ -64,7 +64,7 @@ export const getOrders = async (
 
   const childOids = new Set<number>()
   for (const o of raw) {
-    for (const child of o.children) {
+    for (const child of o.children ?? []) {
       childOids.add(child.oid)
     }
   }

package/src/signers/HyperliquidAgentStore.ts

@@ -115,7 +115,7 @@ export class HyperliquidAgentStore {
       return await this.get(address)
     } catch (error) {
       if (
-        error instanceof PerpsError &&
+        !(error instanceof PerpsError) ||
         error.message !== PerpsErrorMessage.AgentNotFound
       ) {
         throw error

package/src/types/order.ts

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

package/src/utils/mapOrder.ts

@@ -188,6 +188,32 @@ export const mapStatusReason = (status: string): string | undefined => {
       return 'Order rejected: notional value below the minimum trade size.'
     case 'delistedCanceled':
       return 'Order cancelled: market has been delisted.'
+    case 'perpMarginRejected':
+      return 'Order rejected: insufficient margin.'
+    case 'reduceOnlyRejected':
+      return 'Order rejected: would not reduce your position.'
+    case 'badAloPxRejected':
+      return 'Order rejected: post-only order would have matched immediately.'
+    case 'badTriggerPxRejected':
+      return 'Order rejected: invalid take-profit/stop-loss trigger price.'
+    case 'marketOrderNoLiquidityRejected':
+      return 'Order rejected: not enough liquidity for the market order.'
+    case 'oracleRejected':
+      return 'Order rejected: price too far from the oracle price.'
+    case 'vaultWithdrawalCanceled':
+      return 'Order cancelled: a vault withdrawal occurred.'
+    case 'openInterestCapCanceled':
+      return 'Order cancelled: too aggressive while open interest was at its cap.'
+    case 'positionIncreaseAtOpenInterestCapRejected':
+    case 'positionFlipAtOpenInterestCapRejected':
+    case 'openInterestIncreaseRejected':
+      return 'Order rejected: open interest is at its cap.'
+    case 'tooAggressiveAtOpenInterestCapRejected':
+      return 'Order rejected: price too aggressive while open interest was at its cap.'
+    case 'insufficientSpotBalanceRejected':
+      return 'Order rejected: insufficient spot balance.'
+    case 'perpMaxPositionRejected':
+      return 'Order rejected: exceeds the maximum position size for the current leverage tier.'
     default:
       return undefined
   }

package/src/websocket/HyperliquidWsProvider.ts

@@ -99,6 +99,7 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
   private readonly registry: MarketRegistry | undefined
   private perpCtxBySubDex = new Map<string, Record<string, HlWsPerpAssetCtx>>()
   private spotCtxByMarketId: Record<string, HlWsSpotAssetCtx> = {}
+  private marketsContextByMarketId: Record<string, MarketContext> = {}
   private orderbookKeysByMarketId = new Map<string, Set<string>>()
   private latestOrderbookByMarketId = new Map<string, OrderbookResponse>()
   // Latest mid/mark per `Market.id` from the high-frequency `fastAssetCtxs`
@@ -173,6 +174,7 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
         this.perpCtxBySubDex.clear()
         this.spotCtxByMarketId = {}
         this.fastCtxByMarketId = {}
+        this.marketsContextByMarketId = {}
       }
     }
 
@@ -292,6 +294,7 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
     this.perpCtxBySubDex.clear()
     this.spotCtxByMarketId = {}
     this.fastCtxByMarketId = {}
+    this.marketsContextByMarketId = {}
     this.orderbookKeysByMarketId.clear()
     this.latestOrderbookByMarketId.clear()
     this.fastDecodeChain = Promise.resolve()
@@ -483,41 +486,47 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
   }
 
   private handleAllDexsAssetCtxs(data: HlWsAllDexsAssetCtxsData) {
-    this.mergePerpAssetCtxEntries(allDexsAssetCtxEntries(data))
-    this.emitMarketsContext()
+    this.emitMarketsContext(
+      this.mergePerpAssetCtxEntries(allDexsAssetCtxEntries(data))
+    )
   }
 
   private handlePac(base64: string) {
     this.pacDecodeChain = this.pacDecodeChain
       .then(async () => {
-        this.mergePerpAssetCtxEntries(
-          await decodeCompressedJson<HlWsPacData>(base64)
+        this.emitMarketsContext(
+          this.mergePerpAssetCtxEntries(
+            await decodeCompressedJson<HlWsPacData>(base64)
+          )
         )
-        this.emitMarketsContext()
       })
       .catch((error) => wsLog.handlerFailure(this.providerKey, error))
   }
 
+  /** Merge perp asset contexts in place; returns the marketIds this frame touched. */
   private mergePerpAssetCtxEntries(
     entries: [string, HlWsPerpAssetCtxPayload[]][]
-  ) {
+  ): Set<string> {
+    const touched = new Set<string>()
     for (const [dex, ctxs] of entries) {
-      const previous = this.perpCtxBySubDex.get(dex || 'default')
-      const byMarketId: Record<string, HlWsPerpAssetCtx> = {
-        ...(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
   }
 
   private handleSac(base64: string) {
@@ -525,6 +534,7 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
       .then(async () => {
         const spotMarketIdBySacKey = this.spotMarketIdBySacKey()
         const ctxs = await decodeCompressedJson<HlWsSacData>(base64)
+        const touched = new Set<string>()
         for (const [sacKey, ctx] of Object.entries(ctxs)) {
           const marketId = spotMarketIdBySacKey.get(sacKey)
           if (marketId === undefined) {
@@ -534,8 +544,9 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
             ...this.spotCtxByMarketId[marketId],
             ...ctx,
           }
+          touched.add(marketId)
         }
-        this.emitMarketsContext()
+        this.emitMarketsContext(touched)
       })
       .catch((error) => wsLog.handlerFailure(this.providerKey, error))
   }
@@ -572,52 +583,66 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
             midPx: 'midPx' in ctx ? ctx.midPx : prev?.midPx,
           }
         }
-        this.emitMarketsContext()
+        this.emitMarketsContext(Object.keys(ctxs))
       })
       .catch((error) => wsLog.handlerFailure(this.providerKey, error))
   }
 
   /**
-   * 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() {
-    const data: Record<string, MarketContext> = {}
-    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,
-        }
-      }
+  private emitMarketsContext(touchedMarketIds: Iterable<string>) {
+    const data: Record<string, MarketContext> = {
+      ...this.marketsContextByMarketId,
     }
-    for (const [marketId, ctx] of Object.entries(this.spotCtxByMarketId)) {
-      const context = mapSpotMarketContext(
-        marketId,
-        ctx,
-        this.fastCtxByMarketId[marketId]
-      )
+    for (const marketId of touchedMarketIds) {
+      const context = this.computeMarketContext(marketId)
       if (context === undefined) {
-        continue
+        delete data[marketId]
+      } else {
+        data[marketId] = context
       }
-      data[marketId] = context
     }
-    for (const [marketId, fast] of Object.entries(this.fastCtxByMarketId)) {
-      if (data[marketId] !== undefined) {
-        continue
+    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.
+   */
+  private computeMarketContext(marketId: string): MarketContext | undefined {
+    const fast = this.fastCtxByMarketId[marketId]
+    const spotCtx = this.spotCtxByMarketId[marketId]
+    if (spotCtx !== undefined) {
+      const context = mapSpotMarketContext(marketId, spotCtx, fast)
+      if (context !== undefined) {
+        return context
       }
-      // 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 }
+    }
+    let perpCtx: HlWsPerpAssetCtx | undefined
+    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,
       }
     }
-    this.emit('marketsContext', { channel: 'marketsContext', data })
+    const midPrice = fast?.midPx ?? fast?.markPx
+    const markPrice = fast?.markPx ?? fast?.midPx
+    if (midPrice != null && markPrice != null) {
+      return { marketId, midPrice, markPrice }
+    }
+    return undefined
   }
 
   private handleActiveAssetCtx(data: HlWsActiveAssetCtxData, raw: string) {
@@ -725,6 +750,14 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
       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: OrderbookResponse = {
       provider: this.providerKey,
       marketId: delta.c,
@@ -806,8 +839,7 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
         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