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

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": "20.1.0",
+  "version": "22.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": "^18.0.0"
+    "@lifi/perps-types": "^19.0.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^20.1.0"
+    "@lifi/perps-sdk": "^21.1.0"
   },
   "publishConfig": {
     "access": "public"

package/src/HyperliquidProvider.ts

@@ -35,6 +35,7 @@ import {
   ActionType,
   type ActivitiesResponse,
   type AvailableToTrade,
+  type DecimalString,
   type FillsResponse,
   type Market,
   type MarketSettings,
@@ -80,7 +81,7 @@ import { hyperliquidSignActions } from './signers/signActions.js'
 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 { snapOrderPrice, snapOrderSize } from './utils/orderFormatting.js'
 import { positionRemovableMargin } from './utils/transferMargin.js'
 
 /**
@@ -465,15 +466,15 @@ export function hyperliquidProvider(
       positions: Position[]
     ): AccountSummary => getAccountSummary(account, positions),
 
-    formatOrderPrice: (market: Market, price: number): string =>
-      formatOrderPrice(
+    snapOrderPrice: (market: Market, price: DecimalString): DecimalString =>
+      snapOrderPrice(
         price,
         market.szDecimals,
         market.categoryId === SPOT_MARKET_ID ? 'spot' : undefined
       ),
 
-    formatOrderSize: (market: Market, size: number): string =>
-      formatOrderSize(size, market.szDecimals),
+    snapOrderSize: (market: Market, size: DecimalString): DecimalString =>
+      snapOrderSize(size, market.szDecimals),
 
     estimateLiquidationPrice: (
       market: PerpsMarket,

package/src/services/getAccount.ts

@@ -1,11 +1,10 @@
 import {
+  calculateTransferable,
   getMarketRegistry,
   getMarketsContext,
-  maxOf,
-  minOf,
   type ProviderGetAccountParams,
+  parseDecimal,
   type SDKRequestOptions,
-  stringToFloat,
   toPerpsMarketDisplay,
 } from '@lifi/perps-sdk'
 import type {
@@ -16,7 +15,7 @@ import type {
   HyperliquidDexAccountState,
   Position,
 } from '@lifi/perps-types'
-import Big from 'big.js'
+import type Big from 'big.js'
 import { PROVIDER_KEY } from '../constants.js'
 import type { HyperliquidContext } from '../context.js'
 import type {
@@ -40,6 +39,7 @@ import {
 } from '../utils/index.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
 import { isOpenAssetPosition, mapPosition } from '../utils/mapPosition.js'
+import { requireAccountExists } from './getAccountExists.js'
 
 /**
  * Parameters for {@link getAccount}.
@@ -83,13 +83,12 @@ const buildBalances = (
         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)
-            ),
+          transferable: calculateTransferable(
             total
-          ).toFixed(),
+              .minus(toWireBig(b.hold, 'spotClearinghouseState.hold'))
+              .toFixed(),
+            total.toFixed()
+          ),
         }
       }),
     quoteAssetIds
@@ -114,13 +113,13 @@ const buildBalances = (
         units: value.toFixed(),
         valueUsd: value.toFixed(),
         price: '1',
-        transferable: minOf(
-          maxOf(
-            toWireBig(state.withdrawable, 'clearinghouseState.withdrawable'),
-            new Big(0)
-          ),
-          value
-        ).toFixed(),
+        transferable: calculateTransferable(
+          toWireBig(
+            state.withdrawable,
+            'clearinghouseState.withdrawable'
+          ).toFixed(),
+          value.toFixed()
+        ),
       })
     }
   }
@@ -151,6 +150,8 @@ export const getAccount = async (
   params: GetAccountParams,
   options?: SDKRequestOptions
 ): Promise<AccountResponse> => {
+  const infoOpts = hlInfoOptions(client, options)
+  await requireAccountExists(apiUrl, params.address, infoOpts)
   const registry = getMarketRegistry(client, PROVIDER_KEY)
   const markets = await registry.sync()
   const dexNames = perpsDexNames(markets)
@@ -158,7 +159,6 @@ export const getAccount = async (
   const quoteAssetByCategory = new Map(
     markets.map((m) => [m.categoryId, m.quoteAsset])
   )
-  const infoOpts = hlInfoOptions(client, options)
 
   const [
     feesResult,
@@ -209,7 +209,9 @@ export const getAccount = async (
 
   const priceById = spotPriceById(
     markets,
-    new Map(prices.map((p) => [p.marketId, stringToFloat(p.markPrice)]))
+    new Map(
+      prices.map((p) => [p.marketId, parseDecimal(p.markPrice) ?? Number.NaN])
+    )
   )
 
   const positions: Position[] = stateResults.flatMap((state) =>

package/src/services/getAccountExists.ts

@@ -1,8 +1,13 @@
-import type { SDKRequestOptions } from '@lifi/perps-sdk'
+import { PerpsError, type SDKRequestOptions } from '@lifi/perps-sdk'
+import { PerpsErrorCode } from '@lifi/perps-types'
 import { type Address, zeroAddress } from 'viem'
+import { PROVIDER_KEY } from '../constants.js'
 import type { HyperliquidContext } from '../context.js'
-import type { HlPreTransferCheck } from '../types/index.js'
-import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
+import {
+  hlInfoOptions,
+  type InfoRequestOptions,
+  infoRequest,
+} from '../utils/infoClient.js'
 
 /**
  * Parameters for {@link getAccountExists}.
@@ -13,6 +18,36 @@ export interface GetAccountExistsParams {
   address: Address
 }
 
+async function readAccountExists(
+  apiUrl: string,
+  address: Address,
+  options?: InfoRequestOptions
+): Promise<boolean> {
+  const response = await infoRequest<unknown>(
+    apiUrl,
+    {
+      type: 'preTransferCheck',
+      user: address,
+      source: zeroAddress,
+    },
+    options
+  )
+  if (
+    typeof response === 'object' &&
+    response !== null &&
+    'userExists' in response &&
+    typeof response.userExists === 'boolean'
+  ) {
+    return response.userExists
+  }
+  const error = new PerpsError(
+    PerpsErrorCode.ThirdPartyError,
+    'Hyperliquid preTransferCheck response has no boolean userExists field'
+  )
+  error.tool = PROVIDER_KEY
+  throw error
+}
+
 /**
  * Resolve whether a Hyperliquid Core account exists for `address` via a
  * `preTransferCheck` info query. An account exists only after its first
@@ -22,19 +57,25 @@ export interface GetAccountExistsParams {
  * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
  * @public
  */
-export const getAccountExists = async (
+export const getAccountExists = (
   { client, apiUrl }: HyperliquidContext,
   params: GetAccountExistsParams,
   options?: SDKRequestOptions
-): Promise<boolean> => {
-  const { userExists } = await infoRequest<HlPreTransferCheck>(
-    apiUrl,
-    {
-      type: 'preTransferCheck',
-      user: params.address,
-      source: zeroAddress,
-    },
-    hlInfoOptions(client, options)
+): Promise<boolean> =>
+  readAccountExists(apiUrl, params.address, hlInfoOptions(client, options))
+
+export async function requireAccountExists(
+  apiUrl: string,
+  address: Address,
+  options?: InfoRequestOptions
+): Promise<void> {
+  if (await readAccountExists(apiUrl, address, options)) {
+    return
+  }
+  const error = new PerpsError(
+    PerpsErrorCode.AccountNotFound,
+    `No Hyperliquid account found for address: ${address}`
   )
-  return userExists
+  error.tool = PROVIDER_KEY
+  throw error
 }

package/src/services/getActivity.ts

@@ -41,6 +41,7 @@ import {
   type InfoRequestOptions,
   infoRequest,
 } from '../utils/infoClient.js'
+import { requireAccountExists } from './getAccountExists.js'
 import { getHistoryLimit, historyPage } from './historyPagination.js'
 
 /**
@@ -240,6 +241,8 @@ export const getActivity = async (
   options?: SDKRequestOptions
 ): Promise<ActivitiesResponse> => {
   const limit = getHistoryLimit(params.limit)
+  const infoOpts = hlInfoOptions(client, options)
+  await requireAccountExists(apiUrl, params.address, infoOpts)
   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.
@@ -253,7 +256,6 @@ export const getActivity = async (
   ) {
     await assetRegistry.sync()
   }
-  const infoOpts = hlInfoOptions(client, options)
 
   const needLiquidationFills =
     !params.type || params.type.includes(ActivityType.LIQUIDATION)

package/src/services/getAvailableToTrade.ts

@@ -9,7 +9,9 @@ import { PerpsErrorCode } from '@lifi/perps-types'
 import type { Address } from 'viem'
 import { PROVIDER_KEY, SPOT_MARKET_ID } from '../constants.js'
 import type { HyperliquidContext } from '../context.js'
+import { hlInfoOptions } from '../utils/infoClient.js'
 import { fetchActiveAssetData } from './activeAssetData.js'
+import { requireAccountExists } from './getAccountExists.js'
 
 /**
  * Parameters for {@link getAvailableToTrade}.
@@ -43,6 +45,11 @@ export const getAvailableToTrade = async (
   if (market.categoryId === SPOT_MARKET_ID) {
     return undefined
   }
+  await requireAccountExists(
+    context.apiUrl,
+    params.address,
+    hlInfoOptions(context.client, options)
+  )
   const data = await fetchActiveAssetData(
     context,
     params.address,

package/src/services/getFills.ts

@@ -6,6 +6,7 @@ import type { HyperliquidContext } from '../context.js'
 import type { HlUserFills } from '../types/index.js'
 import { assetIsOutcome, mapFill } from '../utils/index.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
+import { requireAccountExists } from './getAccountExists.js'
 import { getHistoryLimit, historyPage } from './historyPagination.js'
 
 /**
@@ -32,9 +33,10 @@ export const getFills = async (
   options?: SDKRequestOptions
 ): Promise<FillsResponse> => {
   const limit = getHistoryLimit(params.limit)
+  const infoOpts = hlInfoOptions(client, options)
+  await requireAccountExists(apiUrl, params.address, infoOpts)
   const registry = getMarketRegistry(client, PROVIDER_KEY)
   await registry.sync()
-  const infoOpts = hlInfoOptions(client, options)
 
   let useRecent =
     params.cursor === undefined &&

package/src/services/getMarketSettings.ts

@@ -8,7 +8,9 @@ import {
 import type { Address } from 'viem'
 import { PROVIDER_KEY, SPOT_MARKET_ID } from '../constants.js'
 import type { HyperliquidContext } from '../context.js'
+import { hlInfoOptions } from '../utils/infoClient.js'
 import { fetchActiveAssetData } from './activeAssetData.js'
+import { requireAccountExists } from './getAccountExists.js'
 
 /**
  * Parameters for {@link getMarketSettings}.
@@ -41,6 +43,11 @@ export const getMarketSettings = async (
     error.tool = PROVIDER_KEY
     throw error
   }
+  await requireAccountExists(
+    context.apiUrl,
+    params.address,
+    hlInfoOptions(context.client, options)
+  )
   const data = await fetchActiveAssetData(
     context,
     params.address,

package/src/services/getOrder.ts

@@ -15,6 +15,7 @@ import type {
 import { withExplorerLinks } from '../utils/explorer.js'
 import { assetIsOutcome, mapOrder } from '../utils/index.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
+import { requireAccountExists } from './getAccountExists.js'
 
 /**
  * Parameters for {@link getOrder}.
@@ -49,6 +50,7 @@ export const getOrder = async (
   }
 
   const infoOpts = hlInfoOptions(client, options)
+  await requireAccountExists(apiUrl, params.address, infoOpts)
   const status = await infoRequest<HlOrderStatusResponse>(
     apiUrl,
     { type: 'orderStatus', user: params.address, oid },

package/src/services/getOrders.ts

@@ -19,6 +19,7 @@ import type {
 import { withExplorerLinks } from '../utils/explorer.js'
 import { assetIsOutcome, mapOrder, perpsDexNames } from '../utils/index.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
+import { requireAccountExists } from './getAccountExists.js'
 
 /** Parameters for a lifecycle-filtered Hyperliquid order read. */
 export type GetOrdersParams = ProviderGetOrdersParams
@@ -65,6 +66,8 @@ export const getOrders = async (
   options?: SDKRequestOptions
 ): Promise<OrdersResponse> => {
   const statuses = params.statuses ?? [...ACTIVE_ORDER_STATUSES]
+  const infoOpts = hlInfoOptions(client, options)
+  await requireAccountExists(apiUrl, params.address, infoOpts)
   if (statuses.length === 0) {
     return {
       provider: PROVIDER_KEY,
@@ -74,7 +77,6 @@ export const getOrders = async (
   }
   const registry = getMarketRegistry(client, PROVIDER_KEY)
   const markets = await registry.sync()
-  const infoOpts = hlInfoOptions(client, options)
   const active = statuses.some(isActiveOrderStatus)
   const terminal = statuses.some((status) => !isActiveOrderStatus(status))
   const [open, historical, twaps] = await Promise.all([

package/src/services/getPortfolioHistory.ts

@@ -15,6 +15,7 @@ import type {
 } from '../types/index.js'
 import { isUnifiedAbstraction } from '../utils/abstractionMode.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
+import { requireAccountExists } from './getAccountExists.js'
 
 /** Parameters for {@link getPortfolioHistory}. @public */
 export interface GetPortfolioHistoryParams {
@@ -83,6 +84,7 @@ export async function getPortfolioHistory(
 ): Promise<PortfolioHistoryResponse> {
   const { client, apiUrl } = ctx
   const infoOpts = hlInfoOptions(client, options)
+  await requireAccountExists(apiUrl, params.address, infoOpts)
   const [portfolio, abstraction] = await Promise.all([
     infoRequest<HlPortfolio>(
       apiUrl,

package/src/services/getPositions.ts

@@ -15,6 +15,7 @@ import {
   perpsDexNames,
 } from '../utils/index.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
+import { requireAccountExists } from './getAccountExists.js'
 
 /**
  * Parameters for {@link getPositions}.
@@ -42,9 +43,10 @@ export const getPositions = async (
   params: GetPositionsParams,
   options?: SDKRequestOptions
 ): Promise<PositionsResponse> => {
+  const infoOpts = hlInfoOptions(client, options)
+  await requireAccountExists(apiUrl, params.address, infoOpts)
   const registry = getMarketRegistry(client, PROVIDER_KEY)
   const markets = await registry.sync()
-  const infoOpts = hlInfoOptions(client, options)
 
   const stateResults = await Promise.all(
     perpsDexNames(markets).map((name) =>

package/src/services/getWithdrawableBalances.ts

@@ -16,6 +16,7 @@ import type {
 } from '../types/index.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
 import { hyperliquidWithdrawableBalances } from '../utils/withdrawableBalances.js'
+import { requireAccountExists } from './getAccountExists.js'
 
 /**
  * Parameters for {@link getWithdrawableBalances}.
@@ -46,6 +47,7 @@ export const getWithdrawableBalances = async (
 ): Promise<ProviderWithdrawableBalance[]> => {
   const registry = getMarketRegistry(client, PROVIDER_KEY)
   const infoOpts = hlInfoOptions(client, options)
+  await requireAccountExists(apiUrl, params.address, infoOpts)
 
   const [{ providers }, markets, abstraction, state, spotState] =
     await Promise.all([
@@ -89,6 +91,6 @@ export const getWithdrawableBalances = async (
     state,
     spotState,
     quoteAsset.id,
-    feeUsd === undefined ? undefined : String(feeUsd)
+    feeUsd
   )
 }

package/src/utils/index.ts

@@ -45,9 +45,9 @@ export {
 export { isOpenAssetPosition, mapPosition } from './mapPosition.js'
 export { coinAsset, perpsDexNames } from './marketDisplay.js'
 export {
-  formatOrderPrice,
-  formatOrderSize,
   getMaxPriceDecimals,
+  snapOrderPrice,
+  snapOrderSize,
 } from './orderFormatting.js'
 export { priceStepToAggregation } from './priceStepToAggregation.js'
 export {

package/src/utils/liquidation.ts

@@ -12,7 +12,7 @@
  * - margin_available = isolated_margin - maintenance_margin_required
  */
 
-import { estimateIsolatedLiquidationPrice } from '@lifi/perps-sdk'
+import { estimateLiquidationPrice } from '@lifi/perps-sdk'
 
 /**
  * Calculate the maintenance margin fraction for a Hyperliquid asset.
@@ -65,7 +65,7 @@ export function calculateLiquidationPrice(
   if (mmr === undefined) {
     return undefined
   }
-  return estimateIsolatedLiquidationPrice({
+  return estimateLiquidationPrice({
     entryPrice,
     leverage,
     isLong,

package/src/utils/orderFormatting.ts

@@ -1,12 +1,13 @@
 /**
- * Hyperliquid order size and price formatting for exchange submission.
+ * Hyperliquid order size and price snapping for exchange submission.
  *
- * These encode Hyperliquid-specific order submission rules. Getting size/price
- * formatting wrong causes rejected orders.
+ * These encode Hyperliquid-specific order submission rules. Snapping a size or
+ * a price onto the wrong grid causes rejected orders.
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size
  */
 
+import type { DecimalString } from '@lifi/perps-types'
 import Big from 'big.js'
 
 /**
@@ -36,28 +37,30 @@ export function getMaxPriceDecimals(
 }
 
 /**
- * Format a size value for order submission.
+ * Snap a size onto the asset's lot grid for order submission.
  *
  * Per Hyperliquid docs (tick-and-lot-size):
  * - Size must be rounded to the asset's szDecimals
  * - Trailing zeroes must be removed for signing
  *
- * @param size - The size value to format
+ * @param size - The size to snap, as a decimal string
  * @param szDecimals - Number of decimal places allowed for this asset (from meta)
- * @returns Size as a string with correct precision, no trailing zeros
+ * @returns Size as a decimal string with correct precision, no trailing zeros
  * @public
  */
-export function formatOrderSize(size: number, szDecimals: number): string {
+export function snapOrderSize(
+  size: DecimalString,
+  szDecimals: number
+): DecimalString {
   // Big.roundDown truncates toward zero — never round a size up, it could
-  // exceed available balance. Exact decimal arithmetic: flooring the float
-  // product dropped a lot step (0.29 * 100 === 28.999999999999996).
+  // exceed available balance.
   const truncated = new Big(size).round(szDecimals, Big.roundDown)
   // toFixed() with no dp always emits plain notation; eq(0) guards '-0'
   return truncated.eq(0) ? '0' : truncated.toFixed()
 }
 
 /**
- * Format a price value for order submission.
+ * Snap a price onto the asset's tick grid for order submission.
  *
  * Per Hyperliquid docs (tick-and-lot-size):
  * - Maximum 5 significant figures
@@ -66,19 +69,20 @@ export function formatOrderSize(size: number, szDecimals: number): string {
  * - Trailing zeroes must be removed for signing
  *
  * Rounding is half-up (away from zero at exact halfway) on the true decimal
- * value, not on the binary float — (1.005).toFixed(2) would give '1.00'.
+ * value, which is why the price arrives as a string: `(1.005).toFixed(2)`
+ * would give `'1.00'`.
  *
- * @param price - The price value to format
+ * @param price - The price to snap, as a decimal string
  * @param szDecimals - The asset's szDecimals (affects max price decimals)
  * @param market - Optional market type (e.g. 'spot'). Defaults to perps rules.
- * @returns Price as a string with correct precision, no trailing zeros
+ * @returns Price as a decimal string with correct precision, no trailing zeros
  * @public
  */
-export function formatOrderPrice(
-  price: number,
+export function snapOrderPrice(
+  price: DecimalString,
   szDecimals: number,
   market?: string
-): string {
+): DecimalString {
   const maxPriceDecimals = getMaxPriceDecimals(szDecimals, market)
 
   let rounded = new Big(price).round(maxPriceDecimals, Big.roundHalfUp)

package/src/utils/spotBalance.ts

@@ -1,4 +1,4 @@
-import { stringToFloat } from '@lifi/perps-sdk'
+import { numberToDecimalString, parseDecimal } from '@lifi/perps-sdk'
 import type { Asset, Balance, Market } from '@lifi/perps-types'
 import { SPOT_MARKET_ID } from '../constants.js'
 import type { HlSpotBalance } from '../types/index.js'
@@ -52,8 +52,10 @@ export const spotBalance = (
     categoryId: SPOT_MARKET_ID,
     asset,
     units: total,
-    valueUsd: (stringToFloat(total) * price).toString(),
+    valueUsd: numberToDecimalString(
+      (parseDecimal(total) ?? Number.NaN) * price
+    ),
     // A zero entry means the map holds no mark for the asset, not a free asset.
-    ...(price > 0 ? { price: price.toString() } : {}),
+    ...(price > 0 ? { price: numberToDecimalString(price) } : {}),
   }
 }

package/src/utils/withdrawableBalances.ts

@@ -1,4 +1,7 @@
-import type { ProviderWithdrawableBalance } from '@lifi/perps-sdk'
+import {
+  calculateWithdrawMax,
+  type ProviderWithdrawableBalance,
+} from '@lifi/perps-sdk'
 import type {
   HlAbstractionMode,
   HlClearinghouseState,
@@ -50,24 +53,26 @@ export const hyperliquidWithdrawableBalances = (
       )
       if (spot.gt(0)) {
         const assetId = String(balance.token)
-        rows.push({
+        const row = {
           assetId,
-          route: 'spot',
+          route: 'spot' as const,
           available: spot.toFixed(),
           ...feeFor(assetId),
-        })
+        }
+        rows.push({ ...row, max: calculateWithdrawMax(row) })
       }
     }
   }
 
   const perps = toWireBig(state.withdrawable, 'clearinghouseState.withdrawable')
   if (perps.gt(0)) {
-    rows.push({
+    const row = {
       assetId: quoteAssetId,
-      route: 'perps',
+      route: 'perps' as const,
       available: perps.toFixed(),
       ...feeFor(quoteAssetId),
-    })
+    }
+    rows.push({ ...row, max: calculateWithdrawMax(row) })
   }
 
   return rows