@lifi/perps-sdk-provider-hyperliquid 5.0.0 → 6.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"transferMargin.d.ts","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,QAAQ,EAEb,KAAK,yBAAyB,EAC/B,MAAM,mBAAmB,CAAA;AAyB1B;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,GACjB,yBAAyB,GAAG,SAAS,CAuBvC"}

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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-hyperliquid",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "Hyperliquid provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -48,10 +48,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.48.8",
-    "@lifi/perps-types": "^3.3.2"
+    "@lifi/perps-types": "^4.0.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^5.0.0"
+    "@lifi/perps-sdk": "^6.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/HyperliquidProvider.ts

@@ -11,6 +11,7 @@ import {
   type ProviderGetAccountParams,
   type ProviderGetActivityParams,
   type ProviderGetFillsParams,
+  type ProviderGetMarketSettingsParams,
   type ProviderGetOrderParams,
   type ProviderGetOrdersParams,
   type ProviderGetPositionsParams,
@@ -30,6 +31,7 @@ import {
   type ActivitiesResponse,
   type FillsResponse,
   type Market,
+  type MarketSettings,
   type Order,
   type OrdersResponse,
   PerpsErrorCode,
@@ -56,6 +58,7 @@ import { getAccount } from './services/getAccount.js'
 import { getAccountExists } from './services/getAccountExists.js'
 import { getActivity } from './services/getActivity.js'
 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 { getPositions } from './services/getPositions.js'
@@ -68,6 +71,7 @@ import type { HlExtraAgents } from './types/index.js'
 import { hlInfoOptions, infoRequest } from './utils/infoClient.js'
 import { calculateLiquidationPrice } from './utils/liquidation.js'
 import { formatOrderPrice, formatOrderSize } from './utils/orderFormatting.js'
+import { positionMarginConstraints } from './utils/transferMargin.js'
 
 /**
  * Options for {@link hyperliquidProvider}.
@@ -288,6 +292,16 @@ export function hyperliquidProvider(
         opts
       ),
 
+    getMarketSettings: (
+      params: ProviderGetMarketSettingsParams,
+      opts?: SDKRequestOptions
+    ): Promise<MarketSettings | undefined> =>
+      getMarketSettings(
+        contextRef.require(),
+        { address: params.address, market: params.market },
+        opts
+      ),
+
     getOrders: (
       params: ProviderGetOrdersParams,
       opts?: SDKRequestOptions
@@ -383,6 +397,8 @@ export function hyperliquidProvider(
         market.maxLeverage
       ),
 
+    positionMarginConstraints,
+
     projectConfig: (
       config: AccountConfig,
       setup: ProviderAction[],

package/src/services/getAccount.ts

@@ -4,6 +4,7 @@ import {
   type ProviderGetAccountParams,
   type SDKRequestOptions,
   stringToFloat,
+  toPerpsMarketDisplay,
 } from '@lifi/perps-sdk'
 import type {
   AccountResponse,
@@ -133,8 +134,9 @@ const buildBalances = (
  * the typed `HyperliquidAccountConfig`.
  *
  * Issues `userFees`, `userAbstraction`, `extraAgents`,
- * `spotClearinghouseState` and one `clearinghouseState` per supported perps
- * sub-dex, all concurrently.
+ * `spotClearinghouseState` and one `clearinghouseState` per perps sub-dex that
+ * still has a live market, all concurrently. USDC parked manually on a
+ * sub-dex whose every market is delisted is therefore not reported.
  *
  * `config.builderFeeApproval` is intentionally omitted — that field
  * compares the venue's `maxBuilderFee` against the integrator-specific
@@ -213,7 +215,12 @@ export const getAccount = async (
   const positions: Position[] = stateResults.flatMap((state) =>
     state.assetPositions
       .filter(isOpenAssetPosition)
-      .map((ap) => mapPosition(ap, registry.require(ap.position.coin)))
+      .map((ap) =>
+        mapPosition(
+          ap,
+          toPerpsMarketDisplay(registry.require(ap.position.coin))
+        )
+      )
   )
 
   const stateByDex = new Map<string, HlClearinghouseState>()

package/src/services/getMarketSettings.ts

@@ -0,0 +1,56 @@
+import type { SDKRequestOptions } from '@lifi/perps-sdk'
+import {
+  MarginMode,
+  type MarketRef,
+  type MarketSettings,
+} from '@lifi/perps-types'
+import type { Address } from 'viem'
+import { SPOT_MARKET_ID } from '../constants.js'
+import type { HyperliquidContext } from '../context.js'
+import type { HlActiveAssetData } from '../types/index.js'
+import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
+
+/**
+ * Parameters for {@link getMarketSettings}.
+ *
+ * @public
+ */
+export interface GetMarketSettingsParams {
+  address: Address
+  market: MarketRef
+}
+
+/**
+ * The user's venue-stored margin mode and leverage for one perps market,
+ * read from `activeAssetData` — present whether or not a position is open.
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export const getMarketSettings = async (
+  { client, apiUrl }: HyperliquidContext,
+  params: GetMarketSettingsParams,
+  options?: SDKRequestOptions
+): Promise<MarketSettings | undefined> => {
+  // Spot markets carry no leverage state on the venue.
+  if (params.market.categoryId === SPOT_MARKET_ID) {
+    return undefined
+  }
+  const data = await infoRequest<HlActiveAssetData>(
+    apiUrl,
+    {
+      type: 'activeAssetData',
+      user: params.address,
+      coin: params.market.marketId,
+    },
+    hlInfoOptions(client, options)
+  )
+  const leverage = data.leverage
+  if (!leverage) {
+    return undefined
+  }
+  return {
+    marginMode:
+      leverage.type === 'isolated' ? MarginMode.ISOLATED : MarginMode.CROSS,
+    leverage: leverage.value,
+  }
+}

package/src/services/getPositions.ts

@@ -1,4 +1,8 @@
-import { getMarketRegistry, type SDKRequestOptions } from '@lifi/perps-sdk'
+import {
+  getMarketRegistry,
+  type SDKRequestOptions,
+  toPerpsMarketDisplay,
+} from '@lifi/perps-sdk'
 import type { PositionsResponse } from '@lifi/perps-types'
 import type { Address } from 'viem'
 import { PROVIDER_KEY } from '../constants.js'
@@ -58,7 +62,12 @@ export const getPositions = async (
   let positions = stateResults.flatMap((state) =>
     state.assetPositions
       .filter(isOpenAssetPosition)
-      .map((ap) => mapPosition(ap, registry.require(ap.position.coin)))
+      .map((ap) =>
+        mapPosition(
+          ap,
+          toPerpsMarketDisplay(registry.require(ap.position.coin))
+        )
+      )
   )
 
   if (params.marketId !== undefined) {

package/src/types/account.ts

@@ -67,6 +67,21 @@ export type HlPreTransferCheck = {
   userExists: boolean
 }
 
+/**
+ * `activeAssetData` info response: the user's live per-asset trading state.
+ * `leverage` reflects the venue-stored setting whether or not a position is
+ * open on the asset.
+ * @public
+ */
+export type HlActiveAssetData = {
+  user: string
+  coin: string
+  leverage: { type: 'cross' | 'isolated'; value: number }
+  maxTradeSzs: [string, string]
+  availableToTrade: [string, string]
+  markPx: string
+}
+
 /**
  * Possible values returned by the `userAbstraction` info endpoint.
  * `null` means abstraction has never been set; `'default'`/`'disabled'` are

package/src/types/asset.ts

@@ -6,6 +6,8 @@ export type HlUniverseItem = {
   szDecimals: number
   maxLeverage: number
   onlyIsolated?: boolean
+  /** Current replacement for deprecated `onlyIsolated`. */
+  marginMode?: 'strictIsolated' | 'noCross'
   isDelisted?: boolean
 }
 

package/src/utils/index.ts

@@ -46,3 +46,4 @@ export {
   spotPriceById,
 } from './spotBalance.js'
 export { partitionSpotBalances, type SpotPartition } from './spotCollateral.js'
+export { positionMarginConstraints } from './transferMargin.js'

package/src/utils/mapMarket.ts

@@ -1,4 +1,5 @@
 import type { PerpsMarket } from '@lifi/perps-types'
+import { PositionMarginAdjustment } from '@lifi/perps-types'
 import { PROVIDER_KEY } from '../constants.js'
 import type { HlUniverseItem } from '../types/index.js'
 import { calculateMaintenanceMarginRate } from './liquidation.js'
@@ -31,6 +32,14 @@ export const mapMarket = (
   szDecimals: universe.szDecimals,
   priceDecimals: getMaxPriceDecimals(universe.szDecimals),
   maxLeverage: universe.maxLeverage,
-  onlyIsolated: universe.onlyIsolated === true,
+  onlyIsolated:
+    universe.marginMode !== undefined || universe.onlyIsolated === true,
+  // Deprecated `onlyIsolated` cannot distinguish strict-isolated from
+  // no-cross, so the ambiguous legacy shape fails closed as add-only.
+  positionMarginAdjustment:
+    universe.marginMode === 'noCross' ||
+    (universe.marginMode === undefined && universe.onlyIsolated !== true)
+      ? PositionMarginAdjustment.ADD_AND_REMOVE
+      : PositionMarginAdjustment.ADD_ONLY,
   maintenanceMarginRate: calculateMaintenanceMarginRate(universe.maxLeverage),
 })

package/src/utils/mapPosition.ts

@@ -1,5 +1,6 @@
-import type { MarketDisplay, Position } from '@lifi/perps-types'
+import type { PerpsMarketDisplay, Position } from '@lifi/perps-types'
 import { MarginMode, PositionSide } from '@lifi/perps-types'
+import Big from 'big.js'
 import type { HlAssetPosition } from '../types/index.js'
 
 /**
@@ -14,27 +15,30 @@ export const isOpenAssetPosition = (ap: HlAssetPosition): boolean =>
 /** @public */
 export const mapPosition = (
   ap: HlAssetPosition,
-  market: MarketDisplay
+  market: PerpsMarketDisplay
 ): Position => {
   const pos = ap.position
-  const szi = parseFloat(pos.szi)
+  const szi = new Big(pos.szi)
+  const positionValue = new Big(pos.positionValue).abs()
+  const leverage = new Big(pos.leverage.value)
+  const marginMode =
+    pos.leverage.type === 'cross' ? MarginMode.CROSS : MarginMode.ISOLATED
+  const marginUsed =
+    marginMode === MarginMode.ISOLATED
+      ? new Big(pos.marginUsed).minus(pos.unrealizedPnl).toFixed()
+      : pos.marginUsed
 
   return {
     market,
-    side: szi >= 0 ? PositionSide.LONG : PositionSide.SHORT,
-    size: Math.abs(szi).toString(),
+    side: szi.gte(0) ? PositionSide.LONG : PositionSide.SHORT,
+    size: szi.abs().toFixed(),
     entryPrice: pos.entryPx ?? '0',
-    markPrice:
-      pos.positionValue && szi !== 0
-        ? (parseFloat(pos.positionValue) / Math.abs(szi)).toString()
-        : '0',
+    markPrice: szi.eq(0) ? '0' : positionValue.div(szi.abs()).toFixed(),
     liquidationPrice: pos.liquidationPx ?? '0',
     unrealizedPnl: pos.unrealizedPnl,
     leverage: ap.position.leverage.value,
-    marginUsed: pos.marginUsed,
-    marginMode:
-      ap.position.leverage.type === 'cross'
-        ? MarginMode.CROSS
-        : MarginMode.ISOLATED,
+    marginUsed,
+    initialMarginRequirement: positionValue.div(leverage).toFixed(),
+    marginMode,
   }
 }

package/src/utils/marketDisplay.ts

@@ -28,16 +28,25 @@ export const coinAsset = (coin: string): Asset =>
 /**
  * Distinct wire `dex` names to fan `clearinghouseState` / `frontendOpenOrders`
  * reads across, derived from the backend market list. Spot is excluded (it has
- * no clearinghouseState); the main perp dex maps to the empty string.
+ * no clearinghouseState); the main perp dex maps to the empty string. A dex
+ * whose every market is delisted is excluded too — delisting force-settles
+ * positions and cancels orders, so the only state it can still hold is USDC a
+ * user parked there manually, which no read then surfaces.
  * @public
  */
 export const perpsDexNames = (markets: readonly Market[]): string[] => {
-  const names = new Set<string>()
+  const hasLiveMarket = new Map<string, boolean>()
   for (const m of markets) {
     if (m.categoryId === SPOT_MARKET_ID) {
       continue
     }
-    names.add(m.categoryId === MAIN_MARKET_ID ? MAIN_DEX_NAME : m.categoryId)
+    const name = m.categoryId === MAIN_MARKET_ID ? MAIN_DEX_NAME : m.categoryId
+    hasLiveMarket.set(
+      name,
+      (hasLiveMarket.get(name) ?? false) || m.isDelisted !== true
+    )
   }
-  return [...names]
+  return [...hasLiveMarket]
+    .filter(([, hasLive]) => hasLive)
+    .map(([name]) => name)
 }

package/src/utils/transferMargin.ts

@@ -0,0 +1,69 @@
+import { PerpsError } from '@lifi/perps-sdk'
+import {
+  MarginMode,
+  PerpsErrorCode,
+  type Position,
+  PositionMarginAdjustment,
+  type PositionMarginConstraints,
+} from '@lifi/perps-types'
+import Big from 'big.js'
+
+const NOTIONAL_FLOOR_RATIO = '0.1'
+const AMOUNT_INCREMENT = '0.000001'
+
+function positivePositionAmount(value: string, field: string): Big {
+  let amount: Big
+  try {
+    amount = new Big(value)
+  } catch {
+    throw new PerpsError(
+      PerpsErrorCode.ValidationError,
+      `Invalid decimal string on Position.${field}: '${value}'`
+    )
+  }
+  if (amount.lte(0)) {
+    throw new PerpsError(
+      PerpsErrorCode.ValidationError,
+      `Position.${field} must be greater than zero.`
+    )
+  }
+  return amount
+}
+
+/**
+ * Hyperliquid's exact documented transfer-margin requirement:
+ * `max(initial_margin_required, 0.1 * total_position_value)`.
+ *
+ * Strict-isolated markets still return constraints because margin can be
+ * added; their market capability prevents removal. Cross positions and
+ * markets without individual margin adjustment return `undefined`.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margining
+ * @public
+ */
+export function positionMarginConstraints(
+  position: Position
+): PositionMarginConstraints | undefined {
+  if (
+    position.marginMode !== MarginMode.ISOLATED ||
+    position.market.positionMarginAdjustment === PositionMarginAdjustment.NONE
+  ) {
+    return undefined
+  }
+  const initialMargin = positivePositionAmount(
+    position.initialMarginRequirement,
+    'initialMarginRequirement'
+  )
+  const notional = positivePositionAmount(position.size, 'size').times(
+    positivePositionAmount(position.markPrice, 'markPrice')
+  )
+  const notionalFloor = notional.times(NOTIONAL_FLOOR_RATIO)
+  const minimumMargin = initialMargin.gt(notionalFloor)
+    ? initialMargin
+    : notionalFloor
+
+  return {
+    minimumMarginRequirement: minimumMargin.toFixed(),
+    amountIncrement: AMOUNT_INCREMENT,
+  }
+}

package/src/websocket/HyperliquidWsProvider.ts

@@ -10,6 +10,7 @@ import {
   resolveSubscribeQuote,
   type SubscriptionListener,
   summarizeAccount,
+  toPerpsMarketDisplay,
   WsProviderBase,
   type WsProviderFactory,
   type WsStatusListener,
@@ -1060,7 +1061,9 @@ export class HyperliquidWsProvider extends WsProviderBase<object> {
           return []
         }
         const market = this.registry?.get(ap.position.coin)
-        return market ? [mapPosition(ap as HlAssetPosition, market)] : []
+        return market
+          ? [mapPosition(ap as HlAssetPosition, toPerpsMarketDisplay(market))]
+          : []
       })
     )
     this.emit(`positions:${data.user.toLowerCase()}`, {