@lifi/perps-sdk-provider-hyperliquid 12.1.0 → 13.0.0

package/dist/types/types/portfolio.d.ts

@@ -0,0 +1,17 @@
+/** `[Unix milliseconds, decimal string]` sample of one portfolio series. @public */
+export type HlPortfolioSample = [number, string];
+/**
+ * One window of the Hyperliquid `portfolio` info response. `vlm` is the
+ * traded volume in the window; `pnlHistory` is cumulative from its start.
+ * @public
+ */
+export type HlPortfolioWindow = {
+    accountValueHistory: HlPortfolioSample[];
+    pnlHistory: HlPortfolioSample[];
+    vlm: string;
+};
+/** Hyperliquid `portfolio` window keys. @public */
+export type HlPortfolioPeriod = 'day' | 'week' | 'month' | 'allTime' | 'perpDay' | 'perpWeek' | 'perpMonth' | 'perpAllTime';
+/** Hyperliquid `portfolio` info response: a list of `[period, window]` pairs. @public */
+export type HlPortfolio = [HlPortfolioPeriod, HlPortfolioWindow][];
+//# sourceMappingURL=portfolio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio.d.ts","sourceRoot":"","sources":["../../../src/types/portfolio.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEhD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,mBAAmB,EAAE,iBAAiB,EAAE,CAAA;IACxC,UAAU,EAAE,iBAAiB,EAAE,CAAA;IAC/B,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,mDAAmD;AACnD,MAAM,MAAM,iBAAiB,GACzB,KAAK,GACL,MAAM,GACN,OAAO,GACP,SAAS,GACT,SAAS,GACT,UAAU,GACV,WAAW,GACX,aAAa,CAAA;AAEjB,yFAAyF;AACzF,MAAM,MAAM,WAAW,GAAG,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,CAAA"}

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

@@ -0,0 +1,8 @@
+import { HlAbstractionMode } from '../types/account.js';
+/**
+ * Whether the mode holds the account's collateral in spot. Unified and
+ * portfolio-margin accounts do; every other mode keeps perps collateral
+ * per-dex, apart from the spot balances.
+ */
+export declare const isUnifiedAbstraction: (abstraction: HlAbstractionMode | null) => boolean;
+//# sourceMappingURL=abstractionMode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abstractionMode.d.ts","sourceRoot":"","sources":["../../../src/utils/abstractionMode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,aAAa,iBAAiB,GAAG,IAAI,KACpC,OAEiD,CAAA"}

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

@@ -11,7 +11,7 @@ import type { Subscription } from '@lifi/perps-types';
  */
 export declare const hyperliquidWsProvider: () => WsProviderFactory;
 /**
- * Hyperliquid realtime {@link WsProvider}: multiplexes markets context,
+ * Hyperliquid WebSocket {@link WsProvider}: multiplexes markets context,
  * positions, orders, fills and spot balances over a single
  * {@link ReconnectingWebSocket}.
  * Construct via {@link hyperliquidWsProvider}.

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

@@ -1 +1 @@
-{"version":3,"file":"HyperliquidWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/HyperliquidWsProvider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HyperliquidWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/HyperliquidWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,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,EAQV,YAAY,EAEb,MAAM,mBAAmB,CAAA;AA4D1B;;;;;;;;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,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,CAMlC;IAGH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgC;IACtE,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;gBAEW,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IASxD,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;IAkHnE;;;;;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;IA4B1C,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,WAAW;IAiDnB,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM;IA8EnC,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,SAAS;IAUjB,oFAAoF;IACpF,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,oBAAoB;IAe5B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,wBAAwB;IAWhC,sEAAsE;IACtE,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,+BAA+B;IA8CvC;0EACsE;IACtE,OAAO,CAAC,MAAM,CAAC,oBAAoB;YAOrB,eAAe;IA8B7B,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,kBAAkB;IAuB1B;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,eAAe;CAsCxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-hyperliquid",
-  "version": "12.1.0",
+  "version": "13.0.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": "^12.2.0"
+    "@lifi/perps-types": "^12.3.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^12.1.0"
+    "@lifi/perps-sdk": "^13.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/HyperliquidProvider.ts

@@ -14,6 +14,7 @@ import {
   type ProviderGetMarketSettingsParams,
   type ProviderGetOrderParams,
   type ProviderGetOrdersParams,
+  type ProviderGetPortfolioHistoryParams,
   type ProviderGetPositionsParams,
   type ProviderGetQuoteParams,
   type ProviderGetRunningTwapsParams,
@@ -38,6 +39,7 @@ import {
   PerpsErrorCode,
   type PerpsMarket,
   PerpsSigner,
+  type PortfolioHistoryResponse,
   type Position,
   type PositionsResponse,
   type ProviderAction,
@@ -63,6 +65,7 @@ import { getFills } from './services/getFills.js'
 import { getMarketSettings } from './services/getMarketSettings.js'
 import { getOrder } from './services/getOrder.js'
 import { getOrders } from './services/getOrders.js'
+import { getPortfolioHistory } from './services/getPortfolioHistory.js'
 import { getPositions } from './services/getPositions.js'
 import { getRunningTwaps } from './services/getRunningTwaps.js'
 import {
@@ -387,6 +390,16 @@ export function hyperliquidProvider(
         opts
       ),
 
+    getPortfolioHistory: (
+      params: ProviderGetPortfolioHistoryParams,
+      opts?: SDKRequestOptions
+    ): Promise<PortfolioHistoryResponse> =>
+      getPortfolioHistory(
+        contextRef.require(),
+        { address: params.address, range: params.range },
+        opts
+      ),
+
     getQuote: (
       params: ProviderGetQuoteParams,
       opts?: SDKRequestOptions

package/src/index.ts

@@ -35,6 +35,8 @@ export type { GetOrderParams } from './services/getOrder.js'
 export { getOrder } from './services/getOrder.js'
 export type { GetOrdersParams } from './services/getOrders.js'
 export { getOrders } from './services/getOrders.js'
+export type { GetPortfolioHistoryParams } from './services/getPortfolioHistory.js'
+export { getPortfolioHistory } from './services/getPortfolioHistory.js'
 export type { GetPositionsParams } from './services/getPositions.js'
 export { getPositions } from './services/getPositions.js'
 export type { GetRunningTwapsParams } from './services/getRunningTwaps.js'

package/src/services/getAccount.ts

@@ -23,6 +23,7 @@ import {
   type HlSpotClearinghouseState,
   type HlUserFees,
 } from '../types/index.js'
+import { isUnifiedAbstraction } from '../utils/abstractionMode.js'
 import { toWireBig } from '../utils/decimal.js'
 import {
   partitionSpotBalances,
@@ -83,10 +84,6 @@ const getMarginUsed = (
   return getTotalMarginUsed(mainState).toString()
 }
 
-const isUnifiedMode = (abstraction: HlAbstractionMode | null): boolean =>
-  abstraction === HlAbstractionMode.UNIFIED_ACCOUNT ||
-  abstraction === HlAbstractionMode.PORTFOLIO_MARGIN
-
 interface BalancePartition {
   balances: Balance[]
   collateralBalances: Balance[]
@@ -112,7 +109,7 @@ const buildBalances = (
   // double-count. Only disabled/dexAbstraction carry separate venue collateral.
   // `accountValue` is the dex's TOTAL equity: locked margin and unrealized
   // PnL are already included, so summaries must not add them on top.
-  if (!isUnifiedMode(abstraction)) {
+  if (!isUnifiedAbstraction(abstraction)) {
     for (const [dex, state] of stateByDex) {
       const categoryId = dex || PROVIDER_KEY
       const value = getAccountValue(state)

package/src/services/getPortfolioHistory.ts

@@ -0,0 +1,118 @@
+import { PerpsError, type SDKRequestOptions } from '@lifi/perps-sdk'
+import {
+  PerpsErrorCode,
+  type PortfolioHistoryPoint,
+  type PortfolioHistoryRange,
+  type PortfolioHistoryResponse,
+} from '@lifi/perps-types'
+import type { Address } from 'viem'
+import type { HyperliquidContext } from '../context.js'
+import type {
+  HlAbstractionMode,
+  HlPortfolio,
+  HlPortfolioPeriod,
+  HlPortfolioWindow,
+} from '../types/index.js'
+import { isUnifiedAbstraction } from '../utils/abstractionMode.js'
+import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
+
+/** Parameters for {@link getPortfolioHistory}. @public */
+export interface GetPortfolioHistoryParams {
+  address: Address
+  range: PortfolioHistoryRange
+}
+
+const COMBINED_PERIOD_BY_RANGE: Record<
+  PortfolioHistoryRange,
+  HlPortfolioPeriod
+> = {
+  '24h': 'day',
+  '7d': 'week',
+  '30d': 'month',
+  all: 'allTime',
+}
+
+const PERP_PERIOD_BY_RANGE: Record<PortfolioHistoryRange, HlPortfolioPeriod> = {
+  '24h': 'perpDay',
+  '7d': 'perpWeek',
+  '30d': 'perpMonth',
+  all: 'perpAllTime',
+}
+
+/**
+ * Join the window's two series on their timestamps. `pnlHistory` is cumulative
+ * from the window's start, so a point with no PnL sample carries the last
+ * sampled value — `'0'` before the first one.
+ */
+const joinWindow = (
+  window: HlPortfolioWindow,
+  period: HlPortfolioPeriod
+): PortfolioHistoryPoint[] => {
+  const pnlByTimestamp = new Map(window.pnlHistory)
+  let matched = 0
+  let cumulative = '0'
+  const points = window.accountValueHistory.map(([timestamp, accountValue]) => {
+    const sample = pnlByTimestamp.get(timestamp)
+    if (sample !== undefined) {
+      matched += 1
+      cumulative = sample
+    }
+    return { timestamp, accountValue, pnl: cumulative }
+  })
+  if (points.length > 0 && window.pnlHistory.length > 0 && matched === 0) {
+    throw new PerpsError(
+      PerpsErrorCode.ThirdPartyError,
+      `Hyperliquid portfolio window '${period}' samples PnL on no ` +
+        'account-value timestamp.'
+    )
+  }
+  return points
+}
+
+/**
+ * Read the account's portfolio value and cumulative PnL for `params.range`
+ * from one `portfolio` info request. An account whose collateral lives
+ * per-dex reads the perps-only window; a unified or portfolio-margin account
+ * holds its collateral in spot, so it reads the combined window.
+ * @public
+ */
+export async function getPortfolioHistory(
+  ctx: HyperliquidContext,
+  params: GetPortfolioHistoryParams,
+  options?: SDKRequestOptions
+): Promise<PortfolioHistoryResponse> {
+  const { client, apiUrl } = ctx
+  const infoOpts = hlInfoOptions(client, options)
+  const [portfolio, abstraction] = await Promise.all([
+    infoRequest<HlPortfolio>(
+      apiUrl,
+      { type: 'portfolio', user: params.address },
+      infoOpts
+    ),
+    // "Never set abstraction" is a successful 200 `null` body, not an error —
+    // so a fetch failure must propagate, never be coerced to `null` (which
+    // would silently read the combined window for a perps-only account).
+    infoRequest<HlAbstractionMode | null>(
+      apiUrl,
+      { type: 'userAbstraction', user: params.address },
+      infoOpts
+    ),
+  ])
+  const period = isUnifiedAbstraction(abstraction)
+    ? COMBINED_PERIOD_BY_RANGE[params.range]
+    : PERP_PERIOD_BY_RANGE[params.range]
+  const window = portfolio.find(([key]) => key === period)?.[1]
+  if (window === undefined) {
+    throw new PerpsError(
+      PerpsErrorCode.ThirdPartyError,
+      `Hyperliquid portfolio response has no '${period}' window.`
+    )
+  }
+
+  return {
+    range: params.range,
+    points: joinWindow(window, period),
+    volume: window.vlm,
+    totalPnl: window.pnlHistory.at(-1)?.[1],
+  }
+}

package/src/types/index.ts

@@ -8,4 +8,5 @@ export * from './asset.js'
 export * from './fill.js'
 export * from './ledger.js'
 export * from './order.js'
+export * from './portfolio.js'
 export * from './ws.js'

package/src/types/portfolio.ts

@@ -0,0 +1,29 @@
+// `portfolio` info response shapes.
+
+/** `[Unix milliseconds, decimal string]` sample of one portfolio series. @public */
+export type HlPortfolioSample = [number, string]
+
+/**
+ * One window of the Hyperliquid `portfolio` info response. `vlm` is the
+ * traded volume in the window; `pnlHistory` is cumulative from its start.
+ * @public
+ */
+export type HlPortfolioWindow = {
+  accountValueHistory: HlPortfolioSample[]
+  pnlHistory: HlPortfolioSample[]
+  vlm: string
+}
+
+/** Hyperliquid `portfolio` window keys. @public */
+export type HlPortfolioPeriod =
+  | 'day'
+  | 'week'
+  | 'month'
+  | 'allTime'
+  | 'perpDay'
+  | 'perpWeek'
+  | 'perpMonth'
+  | 'perpAllTime'
+
+/** Hyperliquid `portfolio` info response: a list of `[period, window]` pairs. @public */
+export type HlPortfolio = [HlPortfolioPeriod, HlPortfolioWindow][]

package/src/utils/abstractionMode.ts

@@ -0,0 +1,12 @@
+import { HlAbstractionMode } from '../types/account.js'
+
+/**
+ * Whether the mode holds the account's collateral in spot. Unified and
+ * portfolio-margin accounts do; every other mode keeps perps collateral
+ * per-dex, apart from the spot balances.
+ */
+export const isUnifiedAbstraction = (
+  abstraction: HlAbstractionMode | null
+): boolean =>
+  abstraction === HlAbstractionMode.UNIFIED_ACCOUNT ||
+  abstraction === HlAbstractionMode.PORTFOLIO_MARGIN

package/src/websocket/HyperliquidWsProvider.ts

@@ -13,6 +13,7 @@ import {
   toPerpsMarketDisplay,
   WsProviderBase,
   type WsProviderFactory,
+  type WsProviderFactoryParams,
   type WsStatusListener,
   wsLog,
 } from '@lifi/perps-sdk'
@@ -95,13 +96,15 @@ const normalizeHlAddress = (address: string): string =>
  *
  * @public
  */
-export const hyperliquidWsProvider =
-  (): WsProviderFactory =>
-  ({ provider, wsUrl, client }) =>
-    new HyperliquidWsProvider(wsUrl, provider, client)
+export const hyperliquidWsProvider = (): WsProviderFactory =>
+  Object.assign(
+    ({ provider, wsUrl, client }: WsProviderFactoryParams) =>
+      new HyperliquidWsProvider(wsUrl, provider, client),
+    { streamsCandles: true }
+  )
 
 /**
- * Hyperliquid realtime {@link WsProvider}: multiplexes markets context,
+ * Hyperliquid WebSocket {@link WsProvider}: multiplexes markets context,
  * positions, orders, fills and spot balances over a single
  * {@link ReconnectingWebSocket}.
  * Construct via {@link hyperliquidWsProvider}.