@lifi/perps-sdk-provider-hyperliquid 19.0.0 → 20.1.0

package/dist/types/services/historyPagination.d.ts

@@ -0,0 +1,22 @@
+type HistoryKey = string | number;
+export declare const getHistoryLimit: (limit?: number) => number;
+export declare function historyPage<T>(params: {
+    startTime?: number;
+    endTime?: number;
+    cursor?: string;
+}, limit: number, fetchWindow: (startTime: number, endTime: number, snapshotEnd: number) => Promise<{
+    items: T[];
+    saturated: boolean;
+}>, identify: (item: T) => {
+    time: number;
+    key: HistoryKey;
+}, signal?: AbortSignal): Promise<{
+    items: T[];
+    pagination: {
+        limit: number;
+        hasMore: boolean;
+        cursor?: string;
+    };
+}>;
+export {};
+//# sourceMappingURL=historyPagination.d.ts.map

package/dist/types/services/historyPagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyPagination.d.ts","sourceRoot":"","sources":["../../../src/services/historyPagination.ts"],"names":[],"mappings":"AAIA,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAiBjC,eAAO,MAAM,eAAe,GAAI,cAA6B,KAAG,MAQ/D,CAAA;AAmCD,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACjE,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,EAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,EACxD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IACT,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACjE,CAAC,CA2FD"}

package/dist/types/types/ledger.d.ts

@@ -113,12 +113,41 @@ export type HlLiquidationDelta = {
     leverageType: string;
     liquidatedPositions?: HlLiquidatedPosition[];
 };
+/**
+ * Hyperliquid `cStakingTransfer` ledger delta. Moves `token` between the
+ * account's spot balance and its staking balance; `isDeposit` is `true` for a
+ * move into staking. `amount` is unsigned. A completed unstake row carries the
+ * zero hash.
+ * @public
+ */
+export type HlCStakingTransferDelta = {
+    type: 'cStakingTransfer';
+    token: string;
+    amount: string;
+    isDeposit: boolean;
+};
+/** Borrow-lend market action named by a `borrowLend` ledger delta. @public */
+export type HlBorrowLendOperation = 'supply' | 'withdraw' | 'borrow' | 'repay';
+/**
+ * Hyperliquid `borrowLend` ledger delta. Moves `token` between the account's
+ * spot balance and the borrow-lend market; `operation` gives the direction and
+ * `amount` is unsigned. `interestAmount` is the accrued interest that
+ * `amount` includes on a `withdraw` or `repay`, and `"0.0"` otherwise.
+ * @public
+ */
+export type HlBorrowLendDelta = {
+    type: 'borrowLend';
+    token: string;
+    operation: HlBorrowLendOperation;
+    amount: string;
+    interestAmount: string;
+};
 /**
  * Union of known Hyperliquid non-funding ledger deltas plus an open fallback
  * for endpoint variants the provider does not map.
  * @public
  */
-export type HlLedgerDelta = HlSpotTransferDelta | HlSendAssetDelta | HlCollateralTransferDelta | HlVaultTransferDelta | HlDepositDelta | HlWithdrawDelta | HlLiquidationDelta | {
+export type HlLedgerDelta = HlSpotTransferDelta | HlSendAssetDelta | HlCollateralTransferDelta | HlVaultTransferDelta | HlDepositDelta | HlWithdrawDelta | HlLiquidationDelta | HlCStakingTransferDelta | HlBorrowLendDelta | {
     type: string;
     usdc?: string;
     [key: string]: unknown;
@@ -157,6 +186,18 @@ export declare const isWithdrawDelta: (delta: HlLedgerDelta) => delta is HlWithd
  * @public
  */
 export declare const isLiquidationDelta: (delta: HlLedgerDelta) => delta is HlLiquidationDelta;
+/**
+ * Type guard for `HlCStakingTransferDelta`. `isDeposit` is part of the guard:
+ * a row without a boolean `isDeposit` names no direction for the movement.
+ * @public
+ */
+export declare const isCStakingTransferDelta: (delta: HlLedgerDelta) => delta is HlCStakingTransferDelta;
+/**
+ * Type guard for `HlBorrowLendDelta`. The operation is part of the guard: an
+ * unknown operation names no direction for the movement.
+ * @public
+ */
+export declare const isBorrowLendDelta: (delta: HlLedgerDelta) => delta is HlBorrowLendDelta;
 /**
  * One timestamped non-funding ledger update. `time` is milliseconds since
  * epoch and `hash` is the upstream transaction identifier.

package/dist/types/types/ledger.d.ts.map

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

package/dist/types/utils/mapActivity.d.ts

@@ -3,6 +3,7 @@ import type { ActivityItem, FundingActivity, LiquidationActivity, MarketDisplay
 import type { HlFundingUpdate, HlLedgerUpdate, HlUserFill } from '../types/index.js';
 /**
  * Map supported ledger entries; exclude same-account moves and unsupported types.
+ * Staking and borrow-lend moves map with the queried account as counterparty.
  * Missing assets throw; unresolved liquidation markets omit only those positions.
  * @public
  */

package/dist/types/utils/mapActivity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapActivity.d.ts","sourceRoot":"","sources":["../../../src/utils/mapActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EACV,YAAY,EAIZ,eAAe,EACf,mBAAmB,EACnB,aAAa,EAGd,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACX,MAAM,mBAAmB,CAAA;AA8C1B;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,cAAc,EACrB,aAAa,MAAM,EACnB,gBAAgB,MAAM,EACtB,eAAe,aAAa,EAC5B,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,KACzD,YAAY,GAAG,IA+JjB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,eAAe,EACtB,aAAa,MAAM,EACnB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,KACzD,eAAe,GAAG,IAgBpB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,UAAU,EAAE,EACnB,aAAa,MAAM,EACnB,gBAAgB,MAAM,EACtB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,EAC1D,cAAc,WAAW,CAAC,MAAM,CAAC,KAChC,mBAAmB,EA4CrB,CAAA"}
+{"version":3,"file":"mapActivity.d.ts","sourceRoot":"","sources":["../../../src/utils/mapActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EACV,YAAY,EAIZ,eAAe,EACf,mBAAmB,EACnB,aAAa,EAGd,MAAM,mBAAmB,CAAA;AAI1B,OAAO,KAAK,EAEV,eAAe,EACf,cAAc,EACd,UAAU,EACX,MAAM,mBAAmB,CAAA;AA2D1B;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,cAAc,EACrB,aAAa,MAAM,EACnB,gBAAgB,MAAM,EACtB,eAAe,aAAa,EAC5B,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,KACzD,YAAY,GAAG,IAuMjB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,eAAe,EACtB,aAAa,MAAM,EACnB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,KACzD,eAAe,GAAG,IAgBpB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,UAAU,EAAE,EACnB,aAAa,MAAM,EACnB,gBAAgB,MAAM,EACtB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,EAC1D,cAAc,WAAW,CAAC,MAAM,CAAC,KAChC,mBAAmB,EA4CrB,CAAA"}

package/dist/types/utils/withdrawableBalances.d.ts

@@ -9,7 +9,8 @@ import type { HlAbstractionMode, HlClearinghouseState, HlSpotClearinghouseState
  *
  * @param quoteAssetId - `Asset.id` the perps-route row is keyed by.
  * @param withdrawalFee - Flat venue fee in quote-asset units, set on every
- *   quote-asset row. Absent leaves every row without a fee.
+ *   quote-asset row. Hyperliquid deducts it from the requested amount. Absent
+ *   leaves every row without a fee.
  * @public
  */
 export declare const hyperliquidWithdrawableBalances: (abstraction: HlAbstractionMode | null, state: HlClearinghouseState, spotState: HlSpotClearinghouseState, quoteAssetId: string, withdrawalFee?: string) => ProviderWithdrawableBalance[];

package/dist/types/utils/withdrawableBalances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withdrawableBalances.d.ts","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,mBAAmB,CAAA;AAK1B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,+BAA+B,GAC1C,aAAa,iBAAiB,GAAG,IAAI,EACrC,OAAO,oBAAoB,EAC3B,WAAW,wBAAwB,EACnC,cAAc,MAAM,EACpB,gBAAgB,MAAM,KACrB,2BAA2B,EAwC7B,CAAA"}
+{"version":3,"file":"withdrawableBalances.d.ts","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,mBAAmB,CAAA;AAK1B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,+BAA+B,GAC1C,aAAa,iBAAiB,GAAG,IAAI,EACrC,OAAO,oBAAoB,EAC3B,WAAW,wBAAwB,EACnC,cAAc,MAAM,EACpB,gBAAgB,MAAM,KACrB,2BAA2B,EA4C7B,CAAA"}

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

@@ -32,7 +32,12 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
     private readonly client;
     private readonly registry;
     private readonly abstractionByUser;
+    private readonly summaryUsers;
+    private readonly abstractionReadsByUser;
     private readonly spotRefs;
+    private spotWireEpoch;
+    private readonly latestSpotByUser;
+    private readonly revalueSpotBalances;
     private readonly unifiedSummaryByUser;
     private readonly latestPerpsByUser;
     private readonly heldSummaryByUser;
@@ -136,6 +141,7 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
     private fetchAbstractionMode;
     private handleActiveAssetData;
     private handleSpotState;
+    private emitSpotBalances;
     /** Read the venue buying power over REST when the spot frame omits it. */
     private fetchAvailableAfterMaintenance;
 }

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,EAOL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAGlB,KAAK,oBAAoB,EAGzB,cAAc,EACd,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAOV,YAAY,EACb,MAAM,mBAAmB,CAAA;AAyE1B;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,QAAO,iBAKtC,CAAA;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC/D,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAUrD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG/B;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAIrD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAQlC;IAGH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG/B;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAQ/B;IACH,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;IACD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAGhC;gBAEW,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IAYxD,SAAS,CACtB,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,IAAI,CAAC;IAuBhB,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+HnE;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,iBAAiB;IAmBzB;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAWnC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,gBAAgB;cAcL,OAAO,IAAI,IAAI;IAgBlC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9C,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;IA8B1C,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,WAAW;IAuDnB,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM;IAiFnC,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,SAAS;IAUjB,oFAAoF;IACpF,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,oBAAoB;IAe5B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,wBAAwB;IAchC,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;IAiBpB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,kBAAkB;IAyE1B,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,+BAA+B;IA6CvC;0EACsE;IACtE,OAAO,CAAC,MAAM,CAAC,oBAAoB;YAOrB,eAAe;IA8B7B,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,kBAAkB;IA+B1B;2EACuE;IACvE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAEnD;;+BAE2B;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAM;IAEjD,OAAO,CAAC,uBAAuB;IAyC/B,OAAO,CAAC,oBAAoB;IA4C5B,OAAO,CAAC,qBAAqB;IAqB7B,OAAO,CAAC,eAAe;IA+CvB,0EAA0E;IAC1E,OAAO,CAAC,8BAA8B;CAsCvC"}
+{"version":3,"file":"HyperliquidWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/HyperliquidWsProvider.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-hyperliquid",
-  "version": "19.0.0",
+  "version": "20.1.0",
   "description": "Hyperliquid provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -49,10 +49,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.55.18",
-    "@lifi/perps-types": "^17.0.0"
+    "@lifi/perps-types": "^18.0.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^19.0.0"
+    "@lifi/perps-sdk": "^20.1.0"
   },
   "publishConfig": {
     "access": "public"

package/src/HyperliquidProvider.ts

@@ -363,7 +363,7 @@ export function hyperliquidProvider(
     getMarketSettings: (
       params: ProviderGetMarketSettingsParams,
       opts?: SDKRequestOptions
-    ): Promise<MarketSettings | undefined> =>
+    ): Promise<MarketSettings> =>
       getMarketSettings(
         contextRef.require(),
         { address: params.address, market: params.market },

package/src/services/getAccount.ts

@@ -1,6 +1,8 @@
 import {
   getMarketRegistry,
   getMarketsContext,
+  maxOf,
+  minOf,
   type ProviderGetAccountParams,
   type SDKRequestOptions,
   stringToFloat,
@@ -14,7 +16,7 @@ import type {
   HyperliquidDexAccountState,
   Position,
 } from '@lifi/perps-types'
-import type Big from 'big.js'
+import Big from 'big.js'
 import { PROVIDER_KEY } from '../constants.js'
 import type { HyperliquidContext } from '../context.js'
 import type {
@@ -66,13 +68,6 @@ interface BalancePartition {
   collateralBalances: Balance[]
 }
 
-const transferableWithin = (venueFigure: Big, units: Big): string => {
-  if (venueFigure.lt(0)) {
-    return '0'
-  }
-  return (venueFigure.gt(units) ? units : venueFigure).toFixed()
-}
-
 const buildBalances = (
   abstraction: HlAbstractionMode | null,
   spotState: HlSpotClearinghouseState,
@@ -84,7 +79,19 @@ const buildBalances = (
   const { balances, collateralBalances } = partitionSpotBalances(
     spotState.balances
       .filter((b) => !assetIsOutcome(b.coin))
-      .map((b) => spotBalance(spotAssetFromToken(b), b.total, priceById)),
+      .map((b) => {
+        const total = toWireBig(b.total, 'spotClearinghouseState.total')
+        return {
+          ...spotBalance(spotAssetFromToken(b), b.total, priceById),
+          transferable: minOf(
+            maxOf(
+              total.minus(toWireBig(b.hold, 'spotClearinghouseState.hold')),
+              new Big(0)
+            ),
+            total
+          ).toFixed(),
+        }
+      }),
     quoteAssetIds
   )
 
@@ -107,10 +114,13 @@ const buildBalances = (
         units: value.toFixed(),
         valueUsd: value.toFixed(),
         price: '1',
-        transferable: transferableWithin(
-          toWireBig(state.withdrawable, 'clearinghouseState.withdrawable'),
+        transferable: minOf(
+          maxOf(
+            toWireBig(state.withdrawable, 'clearinghouseState.withdrawable'),
+            new Big(0)
+          ),
           value
-        ),
+        ).toFixed(),
       })
     }
   }

package/src/services/getActivity.ts

@@ -2,6 +2,7 @@ import {
   type AssetRegistry,
   getAssetRegistry,
   getMarketRegistry,
+  PerpsError,
   type SDKRequestOptions,
 } from '@lifi/perps-sdk'
 import type {
@@ -10,13 +11,9 @@ import type {
   FundingActivity,
   MarketDisplay,
 } from '@lifi/perps-types'
-import { ActivityType } from '@lifi/perps-types'
+import { ActivityType, PerpsErrorCode } from '@lifi/perps-types'
 import type { Address } from 'viem'
-import {
-  DEFAULT_HISTORY_LIMIT,
-  MAX_HISTORY_LIMIT,
-  PROVIDER_KEY,
-} from '../constants.js'
+import { PROVIDER_KEY } from '../constants.js'
 import type { HyperliquidContext } from '../context.js'
 import type {
   HlUserFills,
@@ -24,7 +21,9 @@ import type {
   HlUserNonFundingLedgerUpdates,
 } from '../types/index.js'
 import {
+  isBorrowLendDelta,
   isCollateralTransferDelta,
+  isCStakingTransferDelta,
   isDepositDelta,
   isLiquidationDelta,
   isSendAssetDelta,
@@ -42,6 +41,7 @@ import {
   type InfoRequestOptions,
   infoRequest,
 } from '../utils/infoClient.js'
+import { getHistoryLimit, historyPage } from './historyPagination.js'
 
 /**
  * Parameters for {@link getActivity}.
@@ -50,9 +50,9 @@ import {
  */
 export interface GetActivityParams {
   address: Address
-  /** Maximum items returned; defaults to 50 and is capped at 200. */
+  /** Positive safe integer; defaults to 50 and is capped at 200. */
   limit?: number
-  /** Millisecond timestamp cursor; rows strictly older than it are returned. */
+  /** Opaque cursor returned in the previous page's `pagination.cursor`. */
   cursor?: string
   /** Inclusive lower bound in milliseconds since epoch. */
   startTime?: number
@@ -76,23 +76,100 @@ const ASSET_BEARING_TYPES: ReadonlySet<ActivityType> = new Set([
 const needsMarkets = (typeFilter: ActivityType[] | undefined): boolean =>
   !typeFilter || typeFilter.some((t) => MARKET_BEARING_TYPES.has(t))
 
+const fetchLiquidationHistory = async (
+  apiUrl: string,
+  user: Address,
+  startTime: number,
+  endTime: number,
+  resolveMarket: (coin: string) => MarketDisplay | undefined,
+  options?: InfoRequestOptions
+): Promise<ActivityItem[]> => {
+  const retained = new Map<number, HlUserFills[number]>()
+  while (startTime <= endTime) {
+    options?.signal?.throwIfAborted()
+    const fills = await infoRequest<HlUserFills>(
+      apiUrl,
+      { type: 'userFillsByTime', user, startTime, endTime },
+      options
+    )
+    options?.signal?.throwIfAborted()
+    let latest = startTime
+    for (const fill of fills) {
+      retained.set(fill.tid, fill)
+      latest = Math.max(latest, fill.time)
+    }
+    if (fills.length < 2000 || retained.size >= 10000) {
+      break
+    }
+    if (latest === startTime) {
+      throw new PerpsError(
+        PerpsErrorCode.ThirdPartyError,
+        'Hyperliquid fills saturate a single millisecond; liquidation history cannot be paginated safely'
+      )
+    }
+    // Inclusive overlap retains all same-time fills at the venue page boundary.
+    startTime = latest
+  }
+  const queried = user.toLowerCase()
+  const fills = [...retained.values()].filter(
+    (fill) => fill.liquidation?.liquidatedUser.toLowerCase() === queried
+  )
+  if (fills.length === 0) {
+    return []
+  }
+  const hashes = new Set<string>()
+  let firstTime = Infinity
+  let lastTime = 0
+  for (const fill of fills) {
+    if (fill.hash !== undefined) {
+      hashes.add(fill.hash)
+    }
+    firstTime = Math.min(firstTime, fill.time)
+    lastTime = Math.max(lastTime, fill.time)
+  }
+  // Exclusions must cover the entire order, not the current SDK page's ledger window.
+  const ledger = await historyPage(
+    { startTime: firstTime, endTime: lastTime },
+    Number.MAX_SAFE_INTEGER,
+    async (startTime, endTime) => {
+      const updates = await infoRequest<HlUserNonFundingLedgerUpdates>(
+        apiUrl,
+        { type: 'userNonFundingLedgerUpdates', user, startTime, endTime },
+        options
+      )
+      return {
+        items: updates.filter(
+          (entry) => isLiquidationDelta(entry.delta) && hashes.has(entry.hash)
+        ),
+        saturated: updates.length >= 500,
+      }
+    },
+    (entry) => ({ time: entry.time, key: entry.hash }),
+    options?.signal
+  )
+  return mapLiquidationFills(
+    fills,
+    PROVIDER_KEY,
+    user,
+    resolveMarket,
+    new Set(ledger.items.map((entry) => entry.hash))
+  )
+}
+
 const fetchActivityData = async (
   apiUrl: string,
   typeFilter: ActivityType[] | undefined,
-  timeParams: { user: Address; startTime?: number; endTime?: number },
+  timeParams: { user: Address; startTime: number; endTime: number },
   assetRegistry: AssetRegistry,
   resolveMarket: (coin: string) => MarketDisplay | undefined,
+  liquidationHistory: Promise<ActivityItem[]> | undefined,
   options?: InfoRequestOptions
-): Promise<ActivityItem[]> => {
+): Promise<{ items: ActivityItem[]; saturated: boolean }> => {
   const needLedger =
     !typeFilter || typeFilter.some((t) => t !== ActivityType.FUNDING)
   const needFunding = !typeFilter || typeFilter.includes(ActivityType.FUNDING)
-  // A liquidation executed as a market order reaches the account as fills
-  // with a `liquidation` field and never as a ledger `liquidation` delta.
-  const needLiquidationFills =
-    !typeFilter || typeFilter.includes(ActivityType.LIQUIDATION)
 
-  const [ledgerUpdates, fundingUpdates, fills] = await Promise.all([
+  const [ledgerUpdates, fundingUpdates, liquidations] = await Promise.all([
     needLedger
       ? infoRequest<HlUserNonFundingLedgerUpdates>(
           apiUrl,
@@ -107,16 +184,11 @@ const fetchActivityData = async (
           options
         )
       : Promise.resolve([] as HlUserFunding),
-    needLiquidationFills
-      ? infoRequest<HlUserFills>(
-          apiUrl,
-          timeParams.startTime === undefined
-            ? { type: 'userFills', user: timeParams.user }
-            : { type: 'userFillsByTime', ...timeParams },
-          options
-        )
-      : Promise.resolve([] as HlUserFills),
+    liquidationHistory,
   ])
+  if (ledgerUpdates.length >= 500 || fundingUpdates.length >= 500) {
+    return { items: [], saturated: true }
+  }
 
   const ledgerItems: ActivityItem[] = ledgerUpdates.flatMap(
     (entry): ActivityItem[] => {
@@ -130,7 +202,9 @@ const fetchActivityData = async (
             (isSpotTransferDelta(entry.delta) ||
               isSendAssetDelta(entry.delta) ||
               isCollateralTransferDelta(entry.delta) ||
-              isVaultTransferDelta(entry.delta))))
+              isVaultTransferDelta(entry.delta) ||
+              isCStakingTransferDelta(entry.delta) ||
+              isBorrowLendDelta(entry.delta))))
       ) {
         return []
       }
@@ -152,46 +226,20 @@ const fetchActivityData = async (
     }
   )
 
-  const ledgerLiquidationHashes = new Set(
-    ledgerUpdates
-      .filter((entry) => isLiquidationDelta(entry.delta))
-      .map((entry) => entry.hash)
-  )
-  const liquidationItems = mapLiquidationFills(
-    fills,
-    PROVIDER_KEY,
-    timeParams.user,
-    resolveMarket,
-    ledgerLiquidationHashes
-  )
-
-  const merged = [...ledgerItems, ...fundingItems, ...liquidationItems].sort(
-    (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
-  )
-
-  if (!typeFilter) {
-    return merged
-  }
-  const typeSet = new Set(typeFilter)
-  return merged.filter((item) => typeSet.has(item.type))
+  const merged = [...ledgerItems, ...fundingItems, ...(liquidations ?? [])]
+  const items = typeFilter
+    ? merged.filter((item) => typeFilter.includes(item.type))
+    : merged
+  return { items, saturated: false }
 }
 
-/**
- * Fetch a chronological activity feed (deposits, withdrawals, transfers,
- * liquidations, funding) for `address`. Combines results from Hyperliquid's
- * `userNonFundingLedgerUpdates`, `userFunding`, and `userFills` endpoints,
- * sorted newest-first.
- *
- * Cursor-based pagination uses the ms-since-epoch timestamp of the last item
- * on the current page.
- * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
- * @public
- */
+/** Fetch retained activity newest-first with opaque cursors across inclusive time ranges. */
 export const getActivity = async (
   { client, apiUrl }: HyperliquidContext,
   params: GetActivityParams,
   options?: SDKRequestOptions
 ): Promise<ActivitiesResponse> => {
+  const limit = getHistoryLimit(params.limit)
   const registry = getMarketRegistry(client, PROVIDER_KEY)
   // Only funding and liquidation rows carry a market, so a Ledger-only
   // request must not pull the market list.
@@ -207,53 +255,38 @@ export const getActivity = async (
   }
   const infoOpts = hlInfoOptions(client, options)
 
-  const limit = Math.min(
-    params.limit ?? DEFAULT_HISTORY_LIMIT,
-    MAX_HISTORY_LIMIT
-  )
-  const timeParams = {
-    user: params.address,
-    ...(params.startTime !== undefined || params.endTime !== undefined
-      ? { startTime: params.startTime ?? 0 }
-      : {}),
-    ...(params.endTime === undefined ? {} : { endTime: params.endTime }),
-  }
-
-  // `get`, not `require`: a coin the backend market list does not hold drops
-  // only its own row instead of rejecting the whole feed. The registry warns
-  // once per unresolved id. A delisted market still resolves, so its rows stay.
-  const merged = await fetchActivityData(
-    apiUrl,
-    params.type,
-    timeParams,
-    assetRegistry,
-    (coin) => registry.get(coin),
-    infoOpts
-  )
-
-  // Drop boundary items so the next page does not return the cursor row twice.
-  const filtered =
-    params.cursor === undefined
-      ? merged
-      : merged.filter(
-          (item) =>
-            new Date(item.timestamp).getTime() <
-            Number.parseInt(params.cursor!, 10)
+  const needLiquidationFills =
+    !params.type || params.type.includes(ActivityType.LIQUIDATION)
+  let liquidationHistory: Promise<ActivityItem[]> | undefined
+  const page = await historyPage(
+    params,
+    limit,
+    (startTime, endTime, snapshotEnd) => {
+      if (needLiquidationFills && liquidationHistory === undefined) {
+        liquidationHistory = fetchLiquidationHistory(
+          apiUrl,
+          params.address,
+          params.startTime ?? 0,
+          snapshotEnd,
+          (coin) => registry.get(coin),
+          infoOpts
         )
-
-  const hasMore = filtered.length > limit
-  const items = filtered.slice(0, limit)
-
-  return {
-    provider: PROVIDER_KEY,
-    items,
-    pagination: {
-      limit,
-      hasMore,
-      cursor:
-        items.length > 0
-          ? String(new Date(items[items.length - 1].timestamp).getTime())
-          : undefined,
+      }
+      return fetchActivityData(
+        apiUrl,
+        params.type,
+        { user: params.address, startTime, endTime },
+        assetRegistry,
+        (coin) => registry.get(coin),
+        liquidationHistory,
+        infoOpts
+      )
     },
-  }
+    (item) => ({
+      time: new Date(item.timestamp).getTime(),
+      key: `${item.type}:${item.id}`,
+    }),
+    options?.signal
+  )
+  return { provider: PROVIDER_KEY, ...page }
 }