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

package/dist/esm/services/getActivity.js.map

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

package/dist/esm/services/getFills.d.ts

@@ -0,0 +1,34 @@
+import { type SDKRequestOptions } from '@lifi/perps-sdk';
+import type { FillsResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { HyperliquidContext } from '../context.js';
+/**
+ * Parameters for {@link getFills}.
+ *
+ * @public
+ */
+export interface GetFillsParams {
+    address: Address;
+    limit?: number;
+    /** `tid` of the oldest fill to return (returned items have `tid < cursor`). */
+    cursor?: string;
+    /** Inclusive lower bound in ms-since-epoch — switches to the `userFillsByTime` endpoint. */
+    startTime?: number;
+    /** Inclusive upper bound in ms-since-epoch — switches to the `userFillsByTime` endpoint. */
+    endTime?: number;
+}
+/**
+ * Fetch the user's fills history. When `startTime` or `endTime` is provided,
+ * Hyperliquid's `userFillsByTime` endpoint is used; otherwise the unbounded
+ * `userFills` endpoint returns the full history. The backend's enriched asset
+ * list supplies the display fields; only the fills endpoint is read direct
+ * from HL.
+ *
+ * Pagination is cursor-based on the fill's `tid`: results with
+ * `tid < cursor` are kept and the last-page's tail `id` is returned as the
+ * next cursor.
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export declare const getFills: ({ client, apiUrl }: HyperliquidContext, params: GetFillsParams, options?: SDKRequestOptions) => Promise<FillsResponse>;
+//# sourceMappingURL=getFills.d.ts.map

package/dist/esm/services/getFills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFills.d.ts","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAMnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAKvD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,GACnB,oBAAoB,kBAAkB,EACtC,QAAQ,cAAc,EACtB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,aAAa,CAiDvB,CAAA"}

package/dist/esm/services/getFills.js

@@ -0,0 +1,49 @@
+import { getMarketRegistry } from '@lifi/perps-sdk';
+import { DEFAULT_HISTORY_LIMIT, MAX_HISTORY_LIMIT, PROVIDER_KEY, } from '../constants.js';
+import { mapFill } from '../utils/index.js';
+import { hlInfoOptions, infoRequest } from '../utils/infoClient.js';
+/**
+ * Fetch the user's fills history. When `startTime` or `endTime` is provided,
+ * Hyperliquid's `userFillsByTime` endpoint is used; otherwise the unbounded
+ * `userFills` endpoint returns the full history. The backend's enriched asset
+ * list supplies the display fields; only the fills endpoint is read direct
+ * from HL.
+ *
+ * Pagination is cursor-based on the fill's `tid`: results with
+ * `tid < cursor` are kept and the last-page's tail `id` is returned as the
+ * next cursor.
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export const getFills = async ({ client, apiUrl }, params, options) => {
+    const registry = getMarketRegistry(client, PROVIDER_KEY);
+    await registry.sync();
+    const infoOpts = hlInfoOptions(client, options);
+    const limit = Math.min(params.limit ?? DEFAULT_HISTORY_LIMIT, MAX_HISTORY_LIMIT);
+    const useByTime = params.startTime !== undefined || params.endTime !== undefined;
+    const allFills = useByTime
+        ? await infoRequest(apiUrl, {
+            type: 'userFillsByTime',
+            user: params.address,
+            startTime: params.startTime ?? 0,
+            ...(params.endTime !== undefined ? { endTime: params.endTime } : {}),
+        }, infoOpts)
+        : await infoRequest(apiUrl, { type: 'userFills', user: params.address }, infoOpts);
+    const filtered = params.cursor === undefined
+        ? allFills
+        : allFills.filter((f) => f.tid < Number.parseInt(params.cursor, 10));
+    const hasMore = filtered.length > limit;
+    const items = filtered
+        .slice(0, limit)
+        .map((f) => mapFill(f, registry.require(f.coin)));
+    return {
+        provider: PROVIDER_KEY,
+        items,
+        pagination: {
+            limit,
+            hasMore,
+            cursor: items.length > 0 ? items[items.length - 1].id : undefined,
+        },
+    };
+};
+//# sourceMappingURL=getFills.js.map

package/dist/esm/services/getFills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFills.js","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA0B,MAAM,iBAAiB,CAAA;AAG3E,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAkBnE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,EAAE,MAAM,EAAE,MAAM,EAAsB,EACtC,MAAsB,EACtB,OAA2B,EACH,EAAE;IAC1B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACxD,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IACrB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,MAAM,CAAC,KAAK,IAAI,qBAAqB,EACrC,iBAAiB,CAClB,CAAA;IAED,MAAM,SAAS,GACb,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,CAAA;IAEhE,MAAM,QAAQ,GAAG,SAAS;QACxB,CAAC,CAAC,MAAM,WAAW,CACf,MAAM,EACN;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,MAAM,CAAC,OAAO;YACpB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,CAAC;YAChC,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,EACD,QAAQ,CACT;QACH,CAAC,CAAC,MAAM,WAAW,CACf,MAAM,EACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,EAC3C,QAAQ,CACT,CAAA;IAEL,MAAM,QAAQ,GACZ,MAAM,CAAC,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IAEzE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAA;IACvC,MAAM,KAAK,GAAG,QAAQ;SACnB,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAEnD,OAAO;QACL,QAAQ,EAAE,YAAY;QACtB,KAAK;QACL,UAAU,EAAE;YACV,KAAK;YACL,OAAO;YACP,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;SAClE;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/services/getOrder.d.ts

@@ -0,0 +1,17 @@
+import { type ProviderGetOrderParams, type SDKRequestOptions } from '@lifi/perps-sdk';
+import type { Order } from '@lifi/perps-types';
+import type { HyperliquidContext } from '../context.js';
+/**
+ * Parameters for {@link getOrder}.
+ *
+ * @public
+ */
+export type GetOrderParams = ProviderGetOrderParams;
+/**
+ * Read getOrder direct from the Hyperliquid REST API.
+ *
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export declare const getOrder: ({ client, apiUrl }: HyperliquidContext, params: GetOrderParams, options?: SDKRequestOptions) => Promise<Order>;
+//# sourceMappingURL=getOrder.d.ts.map

package/dist/esm/services/getOrder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrder.d.ts","sourceRoot":"","sources":["../../../src/services/getOrder.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAG9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAKvD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GACnB,oBAAoB,kBAAkB,EACtC,QAAQ,cAAc,EACtB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,KAAK,CA6Bf,CAAA"}

package/dist/esm/services/getOrder.js

@@ -0,0 +1,29 @@
+import { getMarketRegistry, PerpsError, } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PROVIDER_KEY } from '../constants.js';
+import { mapOrder } from '../utils/index.js';
+import { hlInfoOptions, infoRequest } from '../utils/infoClient.js';
+/**
+ * Read getOrder direct from the Hyperliquid REST API.
+ *
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export const getOrder = async ({ client, apiUrl }, params, options) => {
+    const oid = Number.parseInt(params.id, 10);
+    if (Number.isNaN(oid)) {
+        const err = new PerpsError(PerpsErrorCode.ValidationError, `Invalid order ID: ${params.id}. Must be a numeric oid.`);
+        err.tool = PROVIDER_KEY;
+        throw err;
+    }
+    const status = await infoRequest(apiUrl, { type: 'orderStatus', user: params.address, oid }, hlInfoOptions(client, options));
+    if (status.status !== 'order') {
+        const err = new PerpsError(PerpsErrorCode.OrderNotFound, `Order not found: ${params.id}`);
+        err.tool = PROVIDER_KEY;
+        throw err;
+    }
+    const registry = getMarketRegistry(client, PROVIDER_KEY);
+    await registry.sync();
+    return mapOrder(status.order, registry.require(status.order.order.coin));
+};
+//# sourceMappingURL=getOrder.js.map

package/dist/esm/services/getOrder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrder.js","sourceRoot":"","sources":["../../../src/services/getOrder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,UAAU,GAGX,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AASnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,EAAE,MAAM,EAAE,MAAM,EAAsB,EACtC,MAAsB,EACtB,OAA2B,EACX,EAAE;IAClB,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1C,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,UAAU,CACxB,cAAc,CAAC,eAAe,EAC9B,qBAAqB,MAAM,CAAC,EAAE,0BAA0B,CACzD,CAAA;QACD,GAAG,CAAC,IAAI,GAAG,YAAY,CAAA;QACvB,MAAM,GAAG,CAAA;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,MAAM,EACN,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,EAClD,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAC/B,CAAA;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,UAAU,CACxB,cAAc,CAAC,aAAa,EAC5B,oBAAoB,MAAM,CAAC,EAAE,EAAE,CAChC,CAAA;QACD,GAAG,CAAC,IAAI,GAAG,YAAY,CAAA;QACvB,MAAM,GAAG,CAAA;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACxD,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IACrB,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AAC1E,CAAC,CAAA"}

package/dist/esm/services/getOrders.d.ts

@@ -0,0 +1,27 @@
+import { type SDKRequestOptions } from '@lifi/perps-sdk';
+import type { OrdersResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { HyperliquidContext } from '../context.js';
+/**
+ * Parameters for {@link getOrders}.
+ *
+ * @public
+ */
+export interface GetOrdersParams {
+    address: Address;
+    /** Optional filter — opaque `Market.id`. */
+    marketId?: string;
+    limit?: number;
+}
+/**
+ * Fetch open + trigger orders across every supported perps sub-dex for
+ * `address`, normalised into `OrdersResponse`. Trigger orders that appear as
+ * children of a parent limit order (Hyperliquid's `normalTpsl` flow) are
+ * extracted and surfaced alongside top-level trigger orders. The backend's
+ * enriched asset list supplies the sub-dex fan-out and display fields; only
+ * `frontendOpenOrders` is read direct.
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export declare const getOrders: ({ client, apiUrl }: HyperliquidContext, params: GetOrdersParams, options?: SDKRequestOptions) => Promise<OrdersResponse>;
+//# sourceMappingURL=getOrders.d.ts.map

package/dist/esm/services/getOrders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrders.d.ts","sourceRoot":"","sources":["../../../src/services/getOrders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,KAAK,EAAa,cAAc,EAAgB,MAAM,mBAAmB,CAAA;AAChF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAavD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GACpB,oBAAoB,kBAAkB,EACtC,QAAQ,eAAe,EACvB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,cAAc,CAyDxB,CAAA"}

package/dist/esm/services/getOrders.js

@@ -0,0 +1,57 @@
+import { getMarketRegistry } from '@lifi/perps-sdk';
+import { PROVIDER_KEY } from '../constants.js';
+import { isTriggerOrder, mapOpenOrder, mapTriggerOrder, perpsDexNames, } from '../utils/index.js';
+import { hlInfoOptions, infoRequest } from '../utils/infoClient.js';
+/**
+ * Fetch open + trigger orders across every supported perps sub-dex for
+ * `address`, normalised into `OrdersResponse`. Trigger orders that appear as
+ * children of a parent limit order (Hyperliquid's `normalTpsl` flow) are
+ * extracted and surfaced alongside top-level trigger orders. The backend's
+ * enriched asset list supplies the sub-dex fan-out and display fields; only
+ * `frontendOpenOrders` is read direct.
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export const getOrders = async ({ client, apiUrl }, params, options) => {
+    const registry = getMarketRegistry(client, PROVIDER_KEY);
+    const markets = await registry.sync();
+    const infoOpts = hlInfoOptions(client, options);
+    const ordersResults = await Promise.all(perpsDexNames(markets).map((name) => infoRequest(apiUrl, {
+        type: 'frontendOpenOrders',
+        user: params.address,
+        ...(name ? { dex: name } : {}),
+    }, infoOpts)));
+    const raw = ordersResults.flat();
+    const childOids = new Set();
+    for (const o of raw) {
+        for (const child of o.children) {
+            childOids.add(child.oid);
+        }
+    }
+    const nonChild = raw.filter((o) => !childOids.has(o.oid));
+    let openOrders = nonChild
+        .filter((o) => !isTriggerOrder(o))
+        .map((o) => mapOpenOrder(o, registry.require(o.coin)));
+    let triggerOrders = [
+        ...nonChild
+            .filter((o) => isTriggerOrder(o))
+            .map((o) => mapTriggerOrder(o, registry.require(o.coin))),
+        ...raw
+            .filter((o) => childOids.has(o.oid))
+            .map((o) => mapTriggerOrder(o, registry.require(o.coin))),
+    ];
+    if (params.marketId !== undefined) {
+        openOrders = openOrders.filter((o) => o.market.id === params.marketId);
+        triggerOrders = triggerOrders.filter((o) => o.market.id === params.marketId);
+    }
+    return {
+        provider: PROVIDER_KEY,
+        openOrders,
+        triggerOrders,
+        pagination: {
+            limit: params.limit ?? openOrders.length + triggerOrders.length,
+            hasMore: false,
+        },
+    };
+};
+//# sourceMappingURL=getOrders.js.map

package/dist/esm/services/getOrders.js.map

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

package/dist/esm/services/getPositions.d.ts

@@ -0,0 +1,26 @@
+import { type SDKRequestOptions } from '@lifi/perps-sdk';
+import type { PositionsResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { HyperliquidContext } from '../context.js';
+/**
+ * Parameters for {@link getPositions}.
+ *
+ * @public
+ */
+export interface GetPositionsParams {
+    address: Address;
+    /** Filter to a single opaque `Market.id` (e.g. `'BTC'`, `'xyz:PURR'`). */
+    marketId?: string;
+    /** Page size hint surfaced on the response. Hyperliquid returns all open positions in one call, so pagination is never required. */
+    limit?: number;
+}
+/**
+ * Fetch open positions across every supported perps sub-dex for `address`,
+ * normalised into `PositionsResponse`. Zero-size entries are dropped. The
+ * backend's enriched asset list supplies the sub-dex fan-out and display
+ * fields; only `clearinghouseState` is read direct from Hyperliquid.
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export declare const getPositions: ({ client, apiUrl }: HyperliquidContext, params: GetPositionsParams, options?: SDKRequestOptions) => Promise<PositionsResponse>;
+//# sourceMappingURL=getPositions.d.ts.map

package/dist/esm/services/getPositions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPositions.d.ts","sourceRoot":"","sources":["../../../src/services/getPositions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AASvD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oIAAoI;IACpI,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,oBAAoB,kBAAkB,EACtC,QAAQ,kBAAkB,EAC1B,UAAU,iBAAiB,KAC1B,OAAO,CAAC,iBAAiB,CAqC3B,CAAA"}

package/dist/esm/services/getPositions.js

@@ -0,0 +1,37 @@
+import { getMarketRegistry } from '@lifi/perps-sdk';
+import { PROVIDER_KEY } from '../constants.js';
+import { isOpenAssetPosition, mapPosition, perpsDexNames, } from '../utils/index.js';
+import { hlInfoOptions, infoRequest } from '../utils/infoClient.js';
+/**
+ * Fetch open positions across every supported perps sub-dex for `address`,
+ * normalised into `PositionsResponse`. Zero-size entries are dropped. The
+ * backend's enriched asset list supplies the sub-dex fan-out and display
+ * fields; only `clearinghouseState` is read direct from Hyperliquid.
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export const getPositions = async ({ client, apiUrl }, params, options) => {
+    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) => infoRequest(apiUrl, {
+        type: 'clearinghouseState',
+        user: params.address,
+        ...(name ? { dex: name } : {}),
+    }, infoOpts)));
+    let positions = stateResults.flatMap((state) => state.assetPositions
+        .filter(isOpenAssetPosition)
+        .map((ap) => mapPosition(ap, registry.require(ap.position.coin))));
+    if (params.marketId !== undefined) {
+        positions = positions.filter((p) => p.market.id === params.marketId);
+    }
+    return {
+        provider: PROVIDER_KEY,
+        positions,
+        pagination: {
+            limit: params.limit ?? positions.length,
+            hasMore: false,
+        },
+    };
+};
+//# sourceMappingURL=getPositions.js.map

package/dist/esm/services/getPositions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPositions.js","sourceRoot":"","sources":["../../../src/services/getPositions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA0B,MAAM,iBAAiB,CAAA;AAG3E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAenE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,EAAE,MAAM,EAAE,MAAM,EAAsB,EACtC,MAA0B,EAC1B,OAA2B,EACC,EAAE;IAC9B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACxD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE/C,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAClC,WAAW,CACT,MAAM,EACN;QACE,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,MAAM,CAAC,OAAO;QACpB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/B,EACD,QAAQ,CACT,CACF,CACF,CAAA;IAED,IAAI,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7C,KAAK,CAAC,cAAc;SACjB,MAAM,CAAC,mBAAmB,CAAC;SAC3B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CACpE,CAAA;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAA;IACtE,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,YAAY;QACtB,SAAS;QACT,UAAU,EAAE;YACV,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,MAAM;YACvC,OAAO,EAAE,KAAK;SACf;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/signers/HyperliquidAgentStore.d.ts

@@ -0,0 +1,54 @@
+import { type StorageAdapter } from '@lifi/perps-sdk';
+import { type Address, type Hex } from 'viem';
+/**
+ * Hyperliquid agent keypair — an EVM keypair the user approves (via
+ * `APPROVE_AGENT`) to sign trading actions on their behalf, so each order
+ * does not require a wallet prompt.
+ */
+export interface HyperliquidAgent {
+    /** Agent wallet address. */
+    address: Address;
+    /** Agent private key. */
+    privateKey: Hex;
+}
+/**
+ * Owns the Hyperliquid agent keypair lifecycle: generate, persist, look up,
+ * and revoke. Keyed per user L1 address. Persisted via the injected
+ * {@link StorageAdapter} (browser `localStorage` by default).
+ */
+export declare class HyperliquidAgentStore {
+    private storage;
+    private cache;
+    constructor(storage?: StorageAdapter);
+    private storageKey;
+    /**
+     * Get the existing agent for a user address.
+     *
+     * @throws {PerpsError} `AgentNotFound` when no agent exists, or
+     * `AgentStorageCorrupt` when a record is present but malformed (so callers
+     * never act on a structurally-invalid keypair, and `getOrCreate` does not
+     * silently overwrite a poisoned-but-recoverable entry).
+     */
+    get(address: Address): Promise<HyperliquidAgent>;
+    /**
+     * Get the existing agent for a user address, or create and persist one.
+     * Regenerates only on genuine absence; a malformed stored record surfaces
+     * as `AgentStorageCorrupt` rather than being overwritten with a fresh key.
+     */
+    getOrCreate(address: Address): Promise<HyperliquidAgent>;
+    /** Whether an agent exists for the user address. */
+    has(address: Address): Promise<boolean>;
+    /**
+     * Remove the agent for a user address. Call when the user revokes agent
+     * authorization.
+     */
+    remove(address: Address): Promise<void>;
+    /**
+     * Import an existing agent keypair (e.g. restoring from backup or pinning a
+     * specific key) and persist it.
+     */
+    import(address: Address, privateKey: Hex): Promise<HyperliquidAgent>;
+    /** Clear the in-memory cache. Does not remove persisted agents. */
+    clearCache(): void;
+}
+//# sourceMappingURL=HyperliquidAgentStore.d.ts.map

package/dist/esm/signers/HyperliquidAgentStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HyperliquidAgentStore.d.ts","sourceRoot":"","sources":["../../../src/signers/HyperliquidAgentStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,GAAG,EAAoB,MAAM,MAAM,CAAA;AAM/D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,yBAAyB;IACzB,UAAU,EAAE,GAAG,CAAA;CAChB;AA0BD;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAA2C;gBAE5C,OAAO,CAAC,EAAE,cAAc;IAIpC,OAAO,CAAC,UAAU;IAIlB;;;;;;;OAOG;IACG,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0BtD;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0B9D,oDAAoD;IAC9C,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAS7C;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAe1E,mEAAmE;IACnE,UAAU,IAAI,IAAI;CAGnB"}

package/dist/esm/signers/HyperliquidAgentStore.js

@@ -0,0 +1,134 @@
+import { localStorageAdapter, PerpsError, PerpsErrorMessage, parseStoredRecord, } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { isAddress, isHex } from 'viem';
+import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
+import { PROVIDER_KEY } from '../constants.js';
+const STORAGE_PREFIX = 'lifi-perps-agent';
+const isParsablePrivateKey = (value) => {
+    if (!isHex(value)) {
+        return false;
+    }
+    try {
+        privateKeyToAccount(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const isHyperliquidAgent = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const { address, privateKey } = value;
+    return (typeof address === 'string' &&
+        isAddress(address) &&
+        isParsablePrivateKey(privateKey));
+};
+/**
+ * Owns the Hyperliquid agent keypair lifecycle: generate, persist, look up,
+ * and revoke. Keyed per user L1 address. Persisted via the injected
+ * {@link StorageAdapter} (browser `localStorage` by default).
+ */
+export class HyperliquidAgentStore {
+    storage;
+    cache = new Map();
+    constructor(storage) {
+        this.storage = storage ?? localStorageAdapter;
+    }
+    storageKey(address) {
+        return `${STORAGE_PREFIX}:${address.toLowerCase()}:${PROVIDER_KEY}`;
+    }
+    /**
+     * Get the existing agent for a user address.
+     *
+     * @throws {PerpsError} `AgentNotFound` when no agent exists, or
+     * `AgentStorageCorrupt` when a record is present but malformed (so callers
+     * never act on a structurally-invalid keypair, and `getOrCreate` does not
+     * silently overwrite a poisoned-but-recoverable entry).
+     */
+    async get(address) {
+        const key = this.storageKey(address);
+        const cached = this.cache.get(key);
+        if (cached) {
+            return cached;
+        }
+        const stored = await this.storage.get(key);
+        const agent = parseStoredRecord(stored, isHyperliquidAgent);
+        if (agent) {
+            this.cache.set(key, agent);
+            return agent;
+        }
+        const corrupt = stored !== null;
+        const error = new PerpsError(PerpsErrorCode.SDKError, corrupt
+            ? PerpsErrorMessage.AgentStorageCorrupt
+            : PerpsErrorMessage.AgentNotFound);
+        error.tool = '@lifi/perps-sdk-provider-hyperliquid';
+        throw error;
+    }
+    /**
+     * Get the existing agent for a user address, or create and persist one.
+     * Regenerates only on genuine absence; a malformed stored record surfaces
+     * as `AgentStorageCorrupt` rather than being overwritten with a fresh key.
+     */
+    async getOrCreate(address) {
+        try {
+            return await this.get(address);
+        }
+        catch (error) {
+            if (error instanceof PerpsError &&
+                error.message !== PerpsErrorMessage.AgentNotFound) {
+                throw error;
+            }
+            const privateKey = generatePrivateKey();
+            const account = privateKeyToAccount(privateKey);
+            const agent = {
+                address: account.address,
+                privateKey,
+            };
+            const key = this.storageKey(address);
+            await this.storage.set(key, JSON.stringify(agent));
+            this.cache.set(key, agent);
+            return agent;
+        }
+    }
+    /** Whether an agent exists for the user address. */
+    async has(address) {
+        try {
+            await this.get(address);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Remove the agent for a user address. Call when the user revokes agent
+     * authorization.
+     */
+    async remove(address) {
+        const key = this.storageKey(address);
+        this.cache.delete(key);
+        await this.storage.remove(key);
+    }
+    /**
+     * Import an existing agent keypair (e.g. restoring from backup or pinning a
+     * specific key) and persist it.
+     */
+    async import(address, privateKey) {
+        const account = privateKeyToAccount(privateKey);
+        const agent = {
+            address: account.address,
+            privateKey,
+        };
+        const key = this.storageKey(address);
+        await this.storage.set(key, JSON.stringify(agent));
+        this.cache.set(key, agent);
+        return agent;
+    }
+    /** Clear the in-memory cache. Does not remove persisted agents. */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=HyperliquidAgentStore.js.map

package/dist/esm/signers/HyperliquidAgentStore.js.map

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

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

@@ -0,0 +1,4 @@
+export type { HyperliquidAgent } from './HyperliquidAgentStore.js';
+export { HyperliquidAgentStore } from './HyperliquidAgentStore.js';
+export { hyperliquidSignActions } from './signActions.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/signers/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/esm/signers/index.js

@@ -0,0 +1,4 @@
+// biome-ignore-all lint/performance/noBarrelFile: package-internal barrel.
+export { HyperliquidAgentStore } from './HyperliquidAgentStore.js';
+export { hyperliquidSignActions } from './signActions.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/signers/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAG3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/esm/signers/signActions.d.ts

@@ -0,0 +1,15 @@
+import { type SignActionsContext } from '@lifi/perps-sdk';
+import type { ActionStep, SignedActionStep } from '@lifi/perps-types';
+import { SigningMethod } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { HyperliquidAgentStore } from './HyperliquidAgentStore.js';
+/**
+ * Sign a batch of EIP-712 action steps. Hyperliquid owns both EIP712 arms and
+ * picks WHO signs from the descriptor's `signers` (forwarded on the context):
+ *   - `AGENT` → the user's Hyperliquid agent keypair (provisioned + approved
+ *     during setup; a missing agent throws).
+ *   - `USER` → the end-user's wallet, read from `ctx.userWallet`.
+ * Hyperliquid declares no WASM_BLOB / EVM_TX actions, so those schemes reject.
+ */
+export declare function hyperliquidSignActions(agentStore: HyperliquidAgentStore, method: SigningMethod, steps: ActionStep[], address: Address, ctx: SignActionsContext | undefined): Promise<SignedActionStep[]>;
+//# sourceMappingURL=signActions.d.ts.map

package/dist/esm/signers/signActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signActions.d.ts","sourceRoot":"","sources":["../../../src/signers/signActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EACV,UAAU,EAGV,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAA+B,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAO,MAAM,MAAM,CAAA;AACxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAEvE;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,qBAAqB,EACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,kBAAkB,GAAG,SAAS,GAClC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsB7B"}

package/dist/esm/signers/signActions.js

@@ -0,0 +1,38 @@
+import { PerpsError, signTypedData, signTypedDataWithSigner, } from '@lifi/perps-sdk';
+import { PerpsErrorCode, PerpsSigner, SigningMethod } from '@lifi/perps-types';
+/**
+ * Sign a batch of EIP-712 action steps. Hyperliquid owns both EIP712 arms and
+ * picks WHO signs from the descriptor's `signers` (forwarded on the context):
+ *   - `AGENT` → the user's Hyperliquid agent keypair (provisioned + approved
+ *     during setup; a missing agent throws).
+ *   - `USER` → the end-user's wallet, read from `ctx.userWallet`.
+ * Hyperliquid declares no WASM_BLOB / EVM_TX actions, so those schemes reject.
+ */
+export async function hyperliquidSignActions(agentStore, method, steps, address, ctx) {
+    if (method !== SigningMethod.EIP712) {
+        throw new PerpsError(PerpsErrorCode.SDKError, `hyperliquidProvider.signActions: unsupported SigningMethod '${method}'. ` +
+            'Hyperliquid only signs EIP712 actions.');
+    }
+    const sign = ctx?.signers?.includes(PerpsSigner.USER)
+        ? await userWalletSigner(ctx)
+        : await agentSigner(agentStore, address);
+    return Promise.all(steps.map(async (step) => ({
+        action: step.action,
+        typedData: step.typedData,
+        signature: await sign(step),
+    })));
+}
+async function agentSigner(agentStore, address) {
+    const agent = await agentStore.get(address);
+    return (step) => signTypedData(agent.privateKey, step.typedData);
+}
+function userWalletSigner(ctx) {
+    const wallet = ctx.userWallet;
+    if (!wallet) {
+        throw new PerpsError(PerpsErrorCode.SDKError, 'hyperliquidProvider.signActions: a USER-signed action requires the ' +
+            'end-user wallet. Pass `userWallet` to createPerpsClient or call ' +
+            'setUserWallet(walletClient).');
+    }
+    return Promise.resolve((step) => signTypedDataWithSigner(wallet, step.typedData));
+}
+//# sourceMappingURL=signActions.js.map

package/dist/esm/signers/signActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signActions.js","sourceRoot":"","sources":["../../../src/signers/signActions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,aAAa,EACb,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AAOxB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAI9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAiC,EACjC,MAAqB,EACrB,KAAmB,EACnB,OAAgB,EAChB,GAAmC;IAEnC,IAAI,MAAM,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,QAAQ,EACvB,+DAA+D,MAAM,KAAK;YACxE,wCAAwC,CAC3C,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;QACnD,CAAC,CAAC,MAAM,gBAAgB,CAAC,GAAG,CAAC;QAC7B,CAAC,CAAC,MAAM,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAE1C,OAAO,OAAO,CAAC,GAAG,CACf,KAA4B,CAAC,GAAG,CAC/B,KAAK,EAAE,IAAI,EAAmC,EAAE,CAAC,CAAC;QAChD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC;KAC5B,CAAC,CACH,CACF,CAAA;AACH,CAAC;AAID,KAAK,UAAU,WAAW,CACxB,UAAiC,EACjC,OAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC3C,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;AAClE,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAuB;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAA;IAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,QAAQ,EACvB,qEAAqE;YACnE,kEAAkE;YAClE,8BAA8B,CACjC,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9B,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAChD,CAAA;AACH,CAAC"}