@lifi/perps-sdk-provider-hyperliquid 0.2.0-alpha.0

package/dist/esm/utils/index.d.ts

@@ -0,0 +1,15 @@
+export { assetIsSpot, calculateAssetId, getProviderIndex } from './assetId.js';
+export type { InfoRequestOptions } from './infoClient.js';
+export { hlInfoOptions, infoRequest } from './infoClient.js';
+export { calculateLiquidationPrice, calculateMaintenanceMarginRate, } from './liquidation.js';
+export { mapFundingActivity, mapLedgerEntry } from './mapActivity.js';
+export { classifyFillFromPosition, mapFill } from './mapFill.js';
+export { mapMarket } from './mapMarket.js';
+export { mapMarketPrice } from './mapMarketPrice.js';
+export { isTriggerOrder, isTriggerType, mapOpenOrder, mapOrder, mapOrderStatus, mapOrderType, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
+export { isOpenAssetPosition, mapPosition } from './mapPosition.js';
+export { coinAsset, perpsDexNames } from './marketDisplay.js';
+export { formatOrderPrice, formatOrderSize, getMaxPriceDecimals, } from './orderFormatting.js';
+export { priceStepToAggregation } from './priceStepToAggregation.js';
+export { spotAssetFromToken, spotBalance, spotPriceById, } from './spotBalance.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC9E,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAA"}

package/dist/esm/utils/index.js

@@ -0,0 +1,17 @@
+// biome-ignore-all lint/performance/noBarrelFile: single re-export entry point
+// for the package's utility surface. Internal modules import per-file paths
+// (e.g. `./assetId.js`, `./mapFill.js`) directly.
+export { assetIsSpot, calculateAssetId, getProviderIndex } from './assetId.js';
+export { hlInfoOptions, infoRequest } from './infoClient.js';
+export { calculateLiquidationPrice, calculateMaintenanceMarginRate, } from './liquidation.js';
+export { mapFundingActivity, mapLedgerEntry } from './mapActivity.js';
+export { classifyFillFromPosition, mapFill } from './mapFill.js';
+export { mapMarket } from './mapMarket.js';
+export { mapMarketPrice } from './mapMarketPrice.js';
+export { isTriggerOrder, isTriggerType, mapOpenOrder, mapOrder, mapOrderStatus, mapOrderType, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
+export { isOpenAssetPosition, mapPosition } from './mapPosition.js';
+export { coinAsset, perpsDexNames } from './marketDisplay.js';
+export { formatOrderPrice, formatOrderSize, getMaxPriceDecimals, } from './orderFormatting.js';
+export { priceStepToAggregation } from './priceStepToAggregation.js';
+export { spotAssetFromToken, spotBalance, spotPriceById, } from './spotBalance.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,kDAAkD;AAElD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE9E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAA"}

package/dist/esm/utils/infoClient.d.ts

@@ -0,0 +1,28 @@
+import { type PerpsSDKClient, type ResolvedRetryPolicy, type SDKRequestOptions } from '@lifi/perps-sdk';
+/** @internal */
+export declare const HYPERLIQUID_RETRY_DEFAULTS: ResolvedRetryPolicy;
+/** @public */
+export interface InfoRequestOptions {
+    signal?: AbortSignal;
+    policy?: ResolvedRetryPolicy;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Resolve the client's retry/fetch config into options for {@link infoRequest}.
+ *
+ * @public
+ */
+export declare const hlInfoOptions: (client: PerpsSDKClient, options?: SDKRequestOptions) => InfoRequestOptions;
+/**
+ * POST to the Hyperliquid `/info` endpoint and return the parsed JSON body.
+ *
+ * Direct-to-venue: no proxy, no AJV validation, no cache. The caller's type
+ * parameter is trusted; consumers should treat the response shape as
+ * upstream-controlled and normalise into `@lifi/perps-types` shapes before
+ * surfacing.
+ *
+ * Non-2xx responses raise a {@link PerpsError} with the Hyperliquid provider key.
+ * @public
+ */
+export declare function infoRequest<T>(apiUrl: string, body: Record<string, unknown>, options?: InfoRequestOptions): Promise<T>;
+//# sourceMappingURL=infoClient.d.ts.map

package/dist/esm/utils/infoClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infoClient.d.ts","sourceRoot":"","sources":["../../../src/utils/infoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AAIxB,gBAAgB;AAChB,eAAO,MAAM,0BAA0B,EAAE,mBAmBxC,CAAA;AAED,cAAc;AACd,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,cAAc,EACtB,UAAU,iBAAiB,KAC1B,kBAQD,CAAA;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAqCZ"}

package/dist/esm/utils/infoClient.js

@@ -0,0 +1,70 @@
+import { fetchWithRetry, PerpsError, resolveRetryPolicy, } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PROVIDER_KEY } from '../constants.js';
+/** @internal */
+export const HYPERLIQUID_RETRY_DEFAULTS = {
+    enabled: true,
+    maxAttempts: 3,
+    baseDelayMs: 2_000,
+    maxDelayMs: 15_000,
+    respectRetryAfter: true,
+    classify: ({ response }) => {
+        if (response.status === 429) {
+            return 'retry-rate-limit';
+        }
+        if (response.status === 502 ||
+            response.status === 503 ||
+            response.status === 504) {
+            return 'retry-server';
+        }
+        return 'fail';
+    },
+};
+/**
+ * Resolve the client's retry/fetch config into options for {@link infoRequest}.
+ *
+ * @public
+ */
+export const hlInfoOptions = (client, options) => ({
+    signal: options?.signal,
+    policy: resolveRetryPolicy(HYPERLIQUID_RETRY_DEFAULTS, client.config.retry, PROVIDER_KEY),
+    fetchImpl: client.config.fetch,
+});
+/**
+ * POST to the Hyperliquid `/info` endpoint and return the parsed JSON body.
+ *
+ * Direct-to-venue: no proxy, no AJV validation, no cache. The caller's type
+ * parameter is trusted; consumers should treat the response shape as
+ * upstream-controlled and normalise into `@lifi/perps-types` shapes before
+ * surfacing.
+ *
+ * Non-2xx responses raise a {@link PerpsError} with the Hyperliquid provider key.
+ * @public
+ */
+export async function infoRequest(apiUrl, body, options) {
+    const policy = options?.policy ?? HYPERLIQUID_RETRY_DEFAULTS;
+    let response;
+    try {
+        response = await fetchWithRetry(`${apiUrl}/info`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        }, {
+            policy,
+            fetchImpl: options?.fetchImpl,
+            signal: options?.signal,
+        });
+    }
+    catch (error) {
+        const err = new PerpsError(PerpsErrorCode.ServerError, error instanceof Error ? error.message : 'Hyperliquid info request failed');
+        err.tool = PROVIDER_KEY;
+        throw err;
+    }
+    if (!response.ok) {
+        const err = new PerpsError(PerpsErrorCode.ThirdPartyError, `Hyperliquid info request failed: ${response.status}`);
+        err.tool = PROVIDER_KEY;
+        throw err;
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=infoClient.js.map

package/dist/esm/utils/infoClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infoClient.js","sourceRoot":"","sources":["../../../src/utils/infoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,UAAU,EAGV,kBAAkB,GAEnB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,gBAAgB;AAChB,MAAM,CAAC,MAAM,0BAA0B,GAAwB;IAC7D,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,MAAM;IAClB,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QACzB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,kBAAkB,CAAA;QAC3B,CAAC;QACD,IACE,QAAQ,CAAC,MAAM,KAAK,GAAG;YACvB,QAAQ,CAAC,MAAM,KAAK,GAAG;YACvB,QAAQ,CAAC,MAAM,KAAK,GAAG,EACvB,CAAC;YACD,OAAO,cAAc,CAAA;QACvB,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA;AASD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAsB,EACtB,OAA2B,EACP,EAAE,CAAC,CAAC;IACxB,MAAM,EAAE,OAAO,EAAE,MAAM;IACvB,MAAM,EAAE,kBAAkB,CACxB,0BAA0B,EAC1B,MAAM,CAAC,MAAM,CAAC,KAAK,EACnB,YAAY,CACb;IACD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;CAC/B,CAAC,CAAA;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,IAA6B,EAC7B,OAA4B;IAE5B,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,0BAA0B,CAAA;IAE5D,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,cAAc,CAC7B,GAAG,MAAM,OAAO,EAChB;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,EACD;YACE,MAAM;YACN,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CACF,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,IAAI,UAAU,CACxB,cAAc,CAAC,WAAW,EAC1B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,CAC3E,CAAA;QACD,GAAG,CAAC,IAAI,GAAG,YAAY,CAAA;QACvB,MAAM,GAAG,CAAA;IACX,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,IAAI,UAAU,CACxB,cAAc,CAAC,eAAe,EAC9B,oCAAoC,QAAQ,CAAC,MAAM,EAAE,CACtD,CAAA;QACD,GAAG,CAAC,IAAI,GAAG,YAAY,CAAA;QACvB,MAAM,GAAG,CAAA;IACX,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAA;AACrC,CAAC"}

package/dist/esm/utils/liquidation.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Hyperliquid-specific liquidation price calculation.
+ *
+ * Uses the exact formula from Hyperliquid docs:
+ * https://hyperliquid.gitbook.io/hyperliquid-docs/trading/liquidations
+ *
+ * liq_price = price - side * margin_available / position_size / (1 - l * side)
+ *
+ * Where:
+ * - l = 1 / (2 * maxLeverage) (maintenance margin fraction)
+ * - side = 1 (long) or -1 (short)
+ * - margin_available = isolated_margin - maintenance_margin_required
+ */
+/**
+ * Calculate the maintenance margin fraction for a Hyperliquid asset.
+ *
+ * Maintenance margin is half of the initial margin at max leverage.
+ *
+ * @param maxLeverage - Maximum leverage for the asset (e.g., 50 for BTC)
+ * @returns Maintenance margin fraction (e.g., 0.01 for 50x max leverage),
+ *   or undefined if maxLeverage is zero
+ * @public
+ */
+export declare function calculateMaintenanceMarginRate(maxLeverage: number): number | undefined;
+/**
+ * Calculate liquidation price using the exact Hyperliquid formula.
+ *
+ * For isolated margin, new position prediction. For existing positions,
+ * prefer Position.liquidationPrice from the API.
+ *
+ * Formula derivation (isolated margin, single position):
+ *   margin_per_unit        = entryPrice / leverage
+ *   maintenance_per_unit   = entryPrice * mmr
+ *   margin_available       = margin_per_unit - maintenance_per_unit
+ *   liq_price              = entryPrice - side * margin_available / (1 - mmr * side)
+ *
+ * Where mmr = 1 / (2 * maxLeverage).
+ *
+ * @param entryPrice - Position entry price
+ * @param leverage - User-selected leverage (e.g., 10)
+ * @param isLong - True if long position, false if short
+ * @param maxLeverage - Asset's maximum leverage (e.g., 50 for BTC). Determines
+ *   the maintenance margin rate: mmr = 1 / (2 * maxLeverage)
+ * @returns Estimated liquidation price, or undefined if inputs are invalid
+ * @public
+ */
+export declare function calculateLiquidationPrice(entryPrice: number, leverage: number, isLong: boolean, maxLeverage: number): number | undefined;
+//# sourceMappingURL=liquidation.d.ts.map

package/dist/esm/utils/liquidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidation.d.ts","sourceRoot":"","sources":["../../../src/utils/liquidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAWpB"}

package/dist/esm/utils/liquidation.js

@@ -0,0 +1,65 @@
+/**
+ * Hyperliquid-specific liquidation price calculation.
+ *
+ * Uses the exact formula from Hyperliquid docs:
+ * https://hyperliquid.gitbook.io/hyperliquid-docs/trading/liquidations
+ *
+ * liq_price = price - side * margin_available / position_size / (1 - l * side)
+ *
+ * Where:
+ * - l = 1 / (2 * maxLeverage) (maintenance margin fraction)
+ * - side = 1 (long) or -1 (short)
+ * - margin_available = isolated_margin - maintenance_margin_required
+ */
+import { estimateIsolatedLiquidationPrice } from '@lifi/perps-sdk';
+/**
+ * Calculate the maintenance margin fraction for a Hyperliquid asset.
+ *
+ * Maintenance margin is half of the initial margin at max leverage.
+ *
+ * @param maxLeverage - Maximum leverage for the asset (e.g., 50 for BTC)
+ * @returns Maintenance margin fraction (e.g., 0.01 for 50x max leverage),
+ *   or undefined if maxLeverage is zero
+ * @public
+ */
+export function calculateMaintenanceMarginRate(maxLeverage) {
+    if (maxLeverage === 0) {
+        return undefined;
+    }
+    return 1 / (2 * maxLeverage);
+}
+/**
+ * Calculate liquidation price using the exact Hyperliquid formula.
+ *
+ * For isolated margin, new position prediction. For existing positions,
+ * prefer Position.liquidationPrice from the API.
+ *
+ * Formula derivation (isolated margin, single position):
+ *   margin_per_unit        = entryPrice / leverage
+ *   maintenance_per_unit   = entryPrice * mmr
+ *   margin_available       = margin_per_unit - maintenance_per_unit
+ *   liq_price              = entryPrice - side * margin_available / (1 - mmr * side)
+ *
+ * Where mmr = 1 / (2 * maxLeverage).
+ *
+ * @param entryPrice - Position entry price
+ * @param leverage - User-selected leverage (e.g., 10)
+ * @param isLong - True if long position, false if short
+ * @param maxLeverage - Asset's maximum leverage (e.g., 50 for BTC). Determines
+ *   the maintenance margin rate: mmr = 1 / (2 * maxLeverage)
+ * @returns Estimated liquidation price, or undefined if inputs are invalid
+ * @public
+ */
+export function calculateLiquidationPrice(entryPrice, leverage, isLong, maxLeverage) {
+    const mmr = calculateMaintenanceMarginRate(maxLeverage);
+    if (mmr === undefined) {
+        return undefined;
+    }
+    return estimateIsolatedLiquidationPrice({
+        entryPrice,
+        leverage,
+        isLong,
+        maintenanceMarginRate: mmr,
+    });
+}
+//# sourceMappingURL=liquidation.js.map

package/dist/esm/utils/liquidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidation.js","sourceRoot":"","sources":["../../../src/utils/liquidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAA;AAElE;;;;;;;;;GASG;AACH,MAAM,UAAU,8BAA8B,CAC5C,WAAmB;IAEnB,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,CAAA;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAkB,EAClB,QAAgB,EAChB,MAAe,EACf,WAAmB;IAEnB,MAAM,GAAG,GAAG,8BAA8B,CAAC,WAAW,CAAC,CAAA;IACvD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,gCAAgC,CAAC;QACtC,UAAU;QACV,QAAQ;QACR,MAAM;QACN,qBAAqB,EAAE,GAAG;KAC3B,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { ActivityItem, FundingActivity, MarketDisplay } from '@lifi/perps-types';
+import type { HlFundingUpdate, HlLedgerUpdate } from '../types/index.js';
+/**
+ * Map a Hyperliquid non-funding ledger entry to an ActivityItem.
+ *
+ * Direction for `spotTransfer` and `sendAsset` is derived from
+ * `queriedAddress` matching the delta's `user` (OUT) or `destination` (IN).
+ * Returns null for unsupported delta types and for same-user `sendAsset`
+ * dex moves (where `user === destination === queriedAddress`).
+ * @public
+ */
+export declare const mapLedgerEntry: (entry: HlLedgerUpdate, providerKey: string, queriedAddress: string, resolveMarket: (coin: string) => MarketDisplay) => ActivityItem | null;
+/** @public */
+export declare const mapFundingActivity: (entry: HlFundingUpdate, providerKey: string, resolveMarket: (coin: string) => MarketDisplay) => FundingActivity;
+//# sourceMappingURL=mapActivity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapActivity.d.ts","sourceRoot":"","sources":["../../../src/utils/mapActivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEZ,eAAe,EAEf,aAAa,EAGd,MAAM,mBAAmB,CAAA;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGxE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,cAAc,EACrB,aAAa,MAAM,EACnB,gBAAgB,MAAM,EACtB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,KAC7C,YAAY,GAAG,IA0IjB,CAAA;AAED,cAAc;AACd,eAAO,MAAM,kBAAkB,GAC7B,OAAO,eAAe,EACtB,aAAa,MAAM,EACnB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,KAC7C,eASD,CAAA"}

package/dist/esm/utils/mapActivity.js

@@ -0,0 +1,148 @@
+import { ActivityType } from '@lifi/perps-types';
+import { isSendAssetDelta, isSpotTransferDelta } from '../types/index.js';
+/**
+ * Map a Hyperliquid non-funding ledger entry to an ActivityItem.
+ *
+ * Direction for `spotTransfer` and `sendAsset` is derived from
+ * `queriedAddress` matching the delta's `user` (OUT) or `destination` (IN).
+ * Returns null for unsupported delta types and for same-user `sendAsset`
+ * dex moves (where `user === destination === queriedAddress`).
+ * @public
+ */
+export const mapLedgerEntry = (entry, providerKey, queriedAddress, resolveMarket) => {
+    const { delta } = entry;
+    const base = {
+        id: entry.hash,
+        provider: providerKey,
+        timestamp: new Date(entry.time).toISOString(),
+    };
+    // Handled before the switch: the catch-all arm of `HlLedgerDelta` is a
+    // structural supertype of the concrete delta, so a `switch (delta.type)`
+    // cannot narrow off the discriminant. The user-defined type guard does.
+    if (isSpotTransferDelta(delta)) {
+        const queried = queriedAddress.toLowerCase();
+        const sender = delta.user.toLowerCase();
+        const recipient = delta.destination.toLowerCase();
+        const direction = queried === sender ? 'OUT' : 'IN';
+        const counterpartyAddress = direction === 'OUT' ? recipient : sender;
+        const meta = {
+            transferType: 'spotTransfer',
+        };
+        if (delta.usdcValue !== undefined) {
+            meta.usdcValue = delta.usdcValue;
+        }
+        if (delta.fee !== undefined) {
+            meta.fee = delta.fee;
+        }
+        if (delta.nativeTokenFee !== undefined) {
+            meta.nativeTokenFee = delta.nativeTokenFee;
+        }
+        if (delta.nonce !== undefined) {
+            meta.nonce = delta.nonce;
+        }
+        return {
+            ...base,
+            type: ActivityType.TRANSFER,
+            direction,
+            counterpartyAddress,
+            asset: delta.token,
+            amount: delta.amount,
+            meta,
+            explorerLink: entry.hash
+                ? `https://app.hyperliquid.xyz/explorer/tx/${entry.hash}`
+                : undefined,
+        };
+    }
+    // `sendAsset` (wire `type === 'send'`) covers cross-user transfers
+    // (modelled as TRANSFER) and same-user dex moves (returned as null —
+    // overloading TRANSFER for those would lie about direction). Pre-switch
+    // narrowing for the same reason as spotTransfer.
+    if (isSendAssetDelta(delta)) {
+        const queried = queriedAddress.toLowerCase();
+        const sender = delta.user.toLowerCase();
+        const recipient = delta.destination.toLowerCase();
+        if (sender === recipient && sender === queried) {
+            return null;
+        }
+        const direction = queried === sender ? 'OUT' : 'IN';
+        const counterpartyAddress = direction === 'OUT' ? recipient : sender;
+        const meta = {
+            transferType: 'sendAsset',
+            sourceDex: delta.sourceDex,
+            destinationDex: delta.destinationDex,
+            usdcValue: delta.usdcValue,
+            fee: delta.fee,
+            nativeTokenFee: delta.nativeTokenFee,
+            feeToken: delta.feeToken,
+            nonce: delta.nonce,
+        };
+        return {
+            ...base,
+            type: ActivityType.TRANSFER,
+            direction,
+            counterpartyAddress,
+            asset: delta.token,
+            amount: delta.amount,
+            meta,
+            explorerLink: entry.hash
+                ? `https://app.hyperliquid.xyz/explorer/tx/${entry.hash}`
+                : undefined,
+        };
+    }
+    switch (delta.type) {
+        case 'deposit':
+            return {
+                ...base,
+                type: ActivityType.DEPOSIT,
+                amount: delta.usdc ?? '0',
+                explorerLink: entry.hash
+                    ? `https://scan.li.fi/tx/${entry.hash}`
+                    : undefined,
+            };
+        case 'withdraw':
+            return {
+                ...base,
+                type: ActivityType.WITHDRAWAL,
+                amount: delta.usdc ?? '0',
+                fee: delta.fee ?? '0',
+                explorerLink: entry.hash
+                    ? `https://scan.li.fi/tx/${entry.hash}`
+                    : undefined,
+            };
+        case 'liquidation': {
+            const d = delta;
+            const liquidatedPositions = (d.liquidatedPositions ?? []).map((p) => ({
+                market: resolveMarket(p.coin),
+                size: p.szi,
+            }));
+            // Liquidation rows must point to at least one market. Drop entries with
+            // missing/empty positions so downstream consumers can rely on that
+            // invariant and avoid rendering a market-less liquidation card.
+            if (liquidatedPositions.length === 0) {
+                return null;
+            }
+            return {
+                ...base,
+                type: ActivityType.LIQUIDATION,
+                liquidatedNotionalPosition: d.liquidatedNtlPos,
+                accountValue: d.accountValue,
+                leverageType: d.leverageType,
+                liquidatedPositions,
+            };
+        }
+        default:
+            return null;
+    }
+};
+/** @public */
+export const mapFundingActivity = (entry, providerKey, resolveMarket) => ({
+    id: entry.hash,
+    provider: providerKey,
+    timestamp: new Date(entry.time).toISOString(),
+    type: ActivityType.FUNDING,
+    market: resolveMarket(entry.delta.coin),
+    amount: entry.delta.usdc,
+    positionSize: entry.delta.szi,
+    fundingRate: entry.delta.fundingRate,
+});
+//# sourceMappingURL=mapActivity.js.map

package/dist/esm/utils/mapActivity.js.map

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

package/dist/esm/utils/mapFill.d.ts

@@ -0,0 +1,11 @@
+import { classifyFillFromPosition } from '@lifi/perps-sdk';
+import type { Fill, MarketDisplay } from '@lifi/perps-types';
+import type { HlUserFill } from '../types/index.js';
+export { classifyFillFromPosition };
+/**
+ * Spot-ness comes from the resolved market's category, not the coin string —
+ * HL's canonical spot pair 0 is addressed as `PURR/USDC`, not `@0`.
+ * @public
+ */
+export declare const mapFill: (fill: HlUserFill, market: MarketDisplay) => Fill;
+//# sourceMappingURL=mapFill.d.ts.map

package/dist/esm/utils/mapFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapFill.d.ts","sourceRoot":"","sources":["../../../src/utils/mapFill.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAGzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAS5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,EAAE,wBAAwB,EAAE,CAAA;AAEnC;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,UAAU,EAAE,QAAQ,aAAa,KAAG,IAwBhE,CAAA"}

package/dist/esm/utils/mapFill.js

@@ -0,0 +1,34 @@
+import { classifyFillFromPosition, ExplorerChainId, explorerTxUrl, } from '@lifi/perps-sdk';
+import { FillClassification, FillStatus, LiquidityRole, OrderSide, OrderType, } from '@lifi/perps-types';
+import { SPOT_MARKET_ID } from '../constants.js';
+export { classifyFillFromPosition };
+/**
+ * Spot-ness comes from the resolved market's category, not the coin string —
+ * HL's canonical spot pair 0 is addressed as `PURR/USDC`, not `@0`.
+ * @public
+ */
+export const mapFill = (fill, market) => ({
+    ...(market.categoryId === SPOT_MARKET_ID
+        ? { realizedPnl: fill.closedPnl }
+        : { realizedPnl: fill.closedPnl === '0' ? null : fill.closedPnl }),
+    id: String(fill.tid),
+    orderId: String(fill.oid),
+    market,
+    side: fill.side === 'B' ? OrderSide.BUY : OrderSide.SELL,
+    type: fill.dir?.includes('Limit') ? OrderType.LIMIT : OrderType.MARKET,
+    size: fill.sz,
+    price: fill.px,
+    status: FillStatus.FILLED,
+    liquidity: fill.crossed ? LiquidityRole.TAKER : LiquidityRole.MAKER,
+    filledSize: fill.sz,
+    fee: fill.fee,
+    startPosition: fill.startPosition,
+    explorerLink: explorerTxUrl(ExplorerChainId.HYPERLIQUID, fill.hash),
+    classification: market.categoryId === SPOT_MARKET_ID
+        ? fill.side === 'B'
+            ? FillClassification.SPOT_BUY
+            : FillClassification.SPOT_SELL
+        : classifyFillFromPosition(fill.startPosition, fill.side, fill.sz),
+    createdAt: new Date(fill.time).toISOString(),
+});
+//# sourceMappingURL=mapFill.js.map

package/dist/esm/utils/mapFill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapFill.js","sourceRoot":"","sources":["../../../src/utils/mapFill.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,SAAS,EACT,SAAS,GACV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,EAAE,wBAAwB,EAAE,CAAA;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAgB,EAAE,MAAqB,EAAQ,EAAE,CAAC,CAAC;IACzE,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,cAAc;QACtC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE;QACjC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACpE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACzB,MAAM;IACN,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI;IACxD,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM;IACtE,IAAI,EAAE,IAAI,CAAC,EAAE;IACb,KAAK,EAAE,IAAI,CAAC,EAAE;IACd,MAAM,EAAE,UAAU,CAAC,MAAM;IACzB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK;IACnE,UAAU,EAAE,IAAI,CAAC,EAAE;IACnB,GAAG,EAAE,IAAI,CAAC,GAAG;IACb,aAAa,EAAE,IAAI,CAAC,aAAa;IACjC,YAAY,EAAE,aAAa,CAAC,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC;IACnE,cAAc,EACZ,MAAM,CAAC,UAAU,KAAK,cAAc;QAClC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG;YACjB,CAAC,CAAC,kBAAkB,CAAC,QAAQ;YAC7B,CAAC,CAAC,kBAAkB,CAAC,SAAS;QAChC,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;IACtE,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;CAC7C,CAAC,CAAA"}

package/dist/esm/utils/mapMarket.d.ts

@@ -0,0 +1,12 @@
+import type { PerpsMarket } from '@lifi/perps-types';
+import type { HlUniverseItem } from '../types/index.js';
+/**
+ * Map a Hyperliquid universe entry to a {@link PerpsMarket}'s static instrument
+ * metadata. Live mark/stats fields live on the `/prices` item — see
+ * {@link mapMarketPrice}. `categoryId` is the `Provider.categories[].id` of the
+ * dex the entry was fetched from — known to the caller at fetch time, never
+ * re-derived from the coin string.
+ * @public
+ */
+export declare const mapMarket: (universe: HlUniverseItem, categoryId: string) => PerpsMarket;
+//# sourceMappingURL=mapMarket.d.ts.map

package/dist/esm/utils/mapMarket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapMarket.d.ts","sourceRoot":"","sources":["../../../src/utils/mapMarket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAQvD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,cAAc,EACxB,YAAY,MAAM,KACjB,WAWD,CAAA"}

package/dist/esm/utils/mapMarket.js

@@ -0,0 +1,27 @@
+import { PROVIDER_KEY } from '../constants.js';
+import { calculateMaintenanceMarginRate } from './liquidation.js';
+import { coinAsset } from './marketDisplay.js';
+import { getMaxPriceDecimals } from './orderFormatting.js';
+/** Hyperliquid quotes every perp market in USDC. */
+const QUOTE_SYMBOL = 'USDC';
+/**
+ * Map a Hyperliquid universe entry to a {@link PerpsMarket}'s static instrument
+ * metadata. Live mark/stats fields live on the `/prices` item — see
+ * {@link mapMarketPrice}. `categoryId` is the `Provider.categories[].id` of the
+ * dex the entry was fetched from — known to the caller at fetch time, never
+ * re-derived from the coin string.
+ * @public
+ */
+export const mapMarket = (universe, categoryId) => ({
+    providerId: PROVIDER_KEY,
+    id: universe.name,
+    categoryId,
+    baseAsset: coinAsset(universe.name),
+    quoteAsset: coinAsset(QUOTE_SYMBOL),
+    szDecimals: universe.szDecimals,
+    priceDecimals: getMaxPriceDecimals(universe.szDecimals),
+    maxLeverage: universe.maxLeverage,
+    onlyIsolated: universe.onlyIsolated === true,
+    maintenanceMarginRate: calculateMaintenanceMarginRate(universe.maxLeverage),
+});
+//# sourceMappingURL=mapMarket.js.map

package/dist/esm/utils/mapMarket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapMarket.js","sourceRoot":"","sources":["../../../src/utils/mapMarket.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE1D,oDAAoD;AACpD,MAAM,YAAY,GAAG,MAAM,CAAA;AAE3B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,QAAwB,EACxB,UAAkB,EACL,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,YAAY;IACxB,EAAE,EAAE,QAAQ,CAAC,IAAI;IACjB,UAAU;IACV,SAAS,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;IACnC,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC;IACnC,UAAU,EAAE,QAAQ,CAAC,UAAU;IAC/B,aAAa,EAAE,mBAAmB,CAAC,QAAQ,CAAC,UAAU,CAAC;IACvD,WAAW,EAAE,QAAQ,CAAC,WAAW;IACjC,YAAY,EAAE,QAAQ,CAAC,YAAY,KAAK,IAAI;IAC5C,qBAAqB,EAAE,8BAA8B,CAAC,QAAQ,CAAC,WAAW,CAAC;CAC5E,CAAC,CAAA"}

package/dist/esm/utils/mapMarketPrice.d.ts

@@ -0,0 +1,10 @@
+import type { MarketPrice } from '@lifi/perps-types';
+import type { HlAssetCtx } from '../types/index.js';
+/**
+ * Map a Hyperliquid asset context plus its mid to a {@link MarketPrice} — the
+ * live mark/stats data for the `/prices` item. `mid` is the market mid from
+ * `allMids`, known to the caller; `HlAssetCtx` carries no mid of its own.
+ * @public
+ */
+export declare const mapMarketPrice: (marketId: string, assetCtx: HlAssetCtx, mid: string) => MarketPrice;
+//# sourceMappingURL=mapMarketPrice.d.ts.map

package/dist/esm/utils/mapMarketPrice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapMarketPrice.d.ts","sourceRoot":"","sources":["../../../src/utils/mapMarketPrice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAInD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,UAAU,UAAU,EACpB,KAAK,MAAM,KACV,WAiBF,CAAA"}

package/dist/esm/utils/mapMarketPrice.js

@@ -0,0 +1,24 @@
+const NEXT_FUNDING_INTERVAL_MS = 60 * 60 * 1000; // 1 hour
+/**
+ * Map a Hyperliquid asset context plus its mid to a {@link MarketPrice} — the
+ * live mark/stats data for the `/prices` item. `mid` is the market mid from
+ * `allMids`, known to the caller; `HlAssetCtx` carries no mid of its own.
+ * @public
+ */
+export const mapMarketPrice = (marketId, assetCtx, mid) => {
+    const now = Date.now();
+    const nextFundingTime = Math.ceil(now / NEXT_FUNDING_INTERVAL_MS) * NEXT_FUNDING_INTERVAL_MS;
+    return {
+        marketId,
+        price: mid,
+        markPrice: assetCtx.markPx,
+        prevDayPrice: assetCtx.prevDayPx,
+        volume24h: assetCtx.dayNtlVlm,
+        openInterest: assetCtx.openInterest,
+        funding: {
+            rate: assetCtx.funding,
+            nextFundingTime,
+        },
+    };
+};
+//# sourceMappingURL=mapMarketPrice.js.map

package/dist/esm/utils/mapMarketPrice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapMarketPrice.js","sourceRoot":"","sources":["../../../src/utils/mapMarketPrice.ts"],"names":[],"mappings":"AAGA,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,SAAS;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAAgB,EAChB,QAAoB,EACpB,GAAW,EACE,EAAE;IACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,MAAM,eAAe,GACnB,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,wBAAwB,CAAC,GAAG,wBAAwB,CAAA;IAEtE,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,GAAG;QACV,SAAS,EAAE,QAAQ,CAAC,MAAM;QAC1B,YAAY,EAAE,QAAQ,CAAC,SAAS;QAChC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ,CAAC,OAAO;YACtB,eAAe;SAChB;KACF,CAAA;AACH,CAAC,CAAA"}