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

package/dist/esm/accountConfig.js

@@ -0,0 +1,65 @@
+import { PerpsError } from '@lifi/perps-sdk';
+import { ActionType, PerpsErrorCode } from '@lifi/perps-types';
+function assertNever(value) {
+    throw new Error(`Unreachable: exhaustiveness check failed for value ${JSON.stringify(value)}`);
+}
+/**
+ * Project a single Hyperliquid descriptor against the typed
+ * `HyperliquidAccountConfig` into an `AccountConfigSetting`.
+ *
+ * Mapping table:
+ *
+ * | descriptor.type       | projected values
+ * |-----------------------|----------------------------------------------
+ * | APPROVE_AGENT         | []                  (no parameters)
+ * | APPROVE_BUILDER_FEE   | []                  (no parameters)
+ * | ACCOUNT_MODE          | [{ name: 'mode', value: config.abstractionMode }]
+ *
+ * The switch is exhaustive over `ActionType` so enum additions force a
+ * compile error in the `default` arm. ActionTypes that are not valid on
+ * `Provider.setup` / `Provider.options` for Hyperliquid throw at runtime.
+ */
+function projectHyperliquidDescriptor(descriptor, config) {
+    switch (descriptor.type) {
+        case ActionType.APPROVE_AGENT:
+        case ActionType.APPROVE_BUILDER_FEE:
+            return { type: descriptor.type, values: [] };
+        case ActionType.ACCOUNT_MODE:
+            return {
+                type: descriptor.type,
+                values: [{ name: 'mode', value: config.abstractionMode }],
+            };
+        case ActionType.ACCOUNT_TYPE:
+        case ActionType.SEND_ASSET:
+        case ActionType.WITHDRAWAL:
+        case ActionType.TRANSFER:
+        case ActionType.PLACE_ORDER:
+        case ActionType.PLACE_TRIGGER_ORDER:
+        case ActionType.CANCEL_ORDER:
+        case ActionType.CANCEL_ALL_ORDERS:
+        case ActionType.MODIFY_ORDER:
+        case ActionType.UPDATE_LEVERAGE:
+        case ActionType.UPDATE_POSITION_MARGIN:
+        case ActionType.REGISTER_API_KEY:
+        case ActionType.APPROVE_READ_ONLY_TOKEN:
+        case ActionType.DEPOSIT:
+        case ActionType.META_VOTE:
+        case ActionType.META_ACCEPT_TERMS:
+            throw new PerpsError(PerpsErrorCode.SDKError, `Hyperliquid account-config mapper has no projection for ` +
+                `descriptor type '${descriptor.type}' — this ActionType is not ` +
+                `valid on Provider.setup / Provider.options for Hyperliquid.`);
+        default:
+            return assertNever(descriptor.type);
+    }
+}
+/**
+ * Project the union of Hyperliquid setup + options descriptors against the
+ * typed `HyperliquidAccountConfig`. Produces exactly one
+ * `AccountConfigSetting` per descriptor, in `setup`-then-`options` order.
+ *
+ * @public
+ */
+export function projectHyperliquidConfigSettings(config, setup, options) {
+    return [...setup, ...options].map((descriptor) => projectHyperliquidDescriptor(descriptor, config));
+}
+//# sourceMappingURL=accountConfig.js.map

package/dist/esm/accountConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountConfig.js","sourceRoot":"","sources":["../../src/accountConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAM5C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAE9D,SAAS,WAAW,CAAC,KAAY;IAC/B,MAAM,IAAI,KAAK,CACb,sDAAsD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAC9E,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,4BAA4B,CACnC,UAA0B,EAC1B,MAAgC;IAEhC,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,UAAU,CAAC,aAAa,CAAC;QAC9B,KAAK,UAAU,CAAC,mBAAmB;YACjC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;QAE9C,KAAK,UAAU,CAAC,YAAY;YAC1B,OAAO;gBACL,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;aAC1D,CAAA;QAEH,KAAK,UAAU,CAAC,YAAY,CAAC;QAC7B,KAAK,UAAU,CAAC,UAAU,CAAC;QAC3B,KAAK,UAAU,CAAC,UAAU,CAAC;QAC3B,KAAK,UAAU,CAAC,QAAQ,CAAC;QACzB,KAAK,UAAU,CAAC,WAAW,CAAC;QAC5B,KAAK,UAAU,CAAC,mBAAmB,CAAC;QACpC,KAAK,UAAU,CAAC,YAAY,CAAC;QAC7B,KAAK,UAAU,CAAC,iBAAiB,CAAC;QAClC,KAAK,UAAU,CAAC,YAAY,CAAC;QAC7B,KAAK,UAAU,CAAC,eAAe,CAAC;QAChC,KAAK,UAAU,CAAC,sBAAsB,CAAC;QACvC,KAAK,UAAU,CAAC,gBAAgB,CAAC;QACjC,KAAK,UAAU,CAAC,uBAAuB,CAAC;QACxC,KAAK,UAAU,CAAC,OAAO,CAAC;QACxB,KAAK,UAAU,CAAC,SAAS,CAAC;QAC1B,KAAK,UAAU,CAAC,iBAAiB;YAC/B,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,QAAQ,EACvB,0DAA0D;gBACxD,oBAAoB,UAAU,CAAC,IAAI,6BAA6B;gBAChE,6DAA6D,CAChE,CAAA;QAEH;YACE,OAAO,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,MAAgC,EAChC,KAAuB,EACvB,OAAyB;IAEzB,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAC/C,4BAA4B,CAAC,UAAU,EAAE,MAAM,CAAC,CACjD,CAAA;AACH,CAAC"}

package/dist/esm/accountSummary.d.ts

@@ -0,0 +1,10 @@
+import type { AccountResponse, AccountSummary, Position } from '@lifi/perps-types';
+/**
+ * Roll a Hyperliquid {@link AccountResponse} up into an {@link AccountSummary},
+ * branching on the abstraction mode so the gross/free meaning of the collateral
+ * rows is interpreted correctly.
+ *
+ * @public
+ */
+export declare function summarizeHyperliquidAccount(account: AccountResponse, positions: Position[]): AccountSummary;
+//# sourceMappingURL=accountSummary.d.ts.map

package/dist/esm/accountSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountSummary.d.ts","sourceRoot":"","sources":["../../src/accountSummary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,QAAQ,EACT,MAAM,mBAAmB,CAAA;AAc1B;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,QAAQ,EAAE,GACpB,cAAc,CAEhB"}

package/dist/esm/accountSummary.js

@@ -0,0 +1,22 @@
+import { summarizeAccount } from '@lifi/perps-sdk';
+import { HlAbstractionMode } from './types/index.js';
+/**
+ * In `unifiedAccount`/`portfolioMargin` the whole account lives in spot, so the
+ * collateral rows are already gross holdings (locked margin included). In
+ * `disabled`/`dexAbstraction` (and the unset/standard mode) the venue rows hold
+ * `accountValue`, which Hyperliquid reports net of locked margin — i.e. free.
+ */
+const isUnifiedMode = (account) => account.config.provider === 'hyperliquid' &&
+    (account.config.abstractionMode === HlAbstractionMode.UNIFIED_ACCOUNT ||
+        account.config.abstractionMode === HlAbstractionMode.PORTFOLIO_MARGIN);
+/**
+ * Roll a Hyperliquid {@link AccountResponse} up into an {@link AccountSummary},
+ * branching on the abstraction mode so the gross/free meaning of the collateral
+ * rows is interpreted correctly.
+ *
+ * @public
+ */
+export function summarizeHyperliquidAccount(account, positions) {
+    return summarizeAccount(account, positions, isUnifiedMode(account));
+}
+//# sourceMappingURL=accountSummary.js.map

package/dist/esm/accountSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountSummary.js","sourceRoot":"","sources":["../../src/accountSummary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAMlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,aAAa,GAAG,CAAC,OAAwB,EAAW,EAAE,CAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,aAAa;IACzC,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,KAAK,iBAAiB,CAAC,eAAe;QACnE,OAAO,CAAC,MAAM,CAAC,eAAe,KAAK,iBAAiB,CAAC,gBAAgB,CAAC,CAAA;AAE1E;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAwB,EACxB,SAAqB;IAErB,OAAO,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;AACrE,CAAC"}

package/dist/esm/constants.d.ts

@@ -0,0 +1,40 @@
+import type { FeeTier } from '@lifi/perps-types';
+/**
+ * Hyperliquid provider key (exported from the package index as
+ * `HYPERLIQUID_PROVIDER_KEY`).
+ *
+ * @public
+ */
+export declare const PROVIDER_KEY = "hyperliquid";
+/**
+ * Default Hyperliquid REST base URL.
+ *
+ * @public
+ */
+export declare const DEFAULT_HYPERLIQUID_API_URL = "https://api.hyperliquid.xyz";
+/**
+ * Approximate published baseline maker/taker fee tier for Hyperliquid, used to
+ * seed fee math before the live account `feeTier` resolves. Rates are fractions
+ * (not basis points): `0.00015` = 0.015% maker, `0.00045` = 0.045% taker.
+ *
+ * @public
+ */
+export declare const HYPERLIQUID_FEE_TIER_FALLBACK: FeeTier;
+/** @internal */
+export declare const DEFAULT_HISTORY_LIMIT = 50;
+/** @internal */
+export declare const MAX_HISTORY_LIMIT = 200;
+/** @internal */
+export declare const NINETY_DAYS_MS: number;
+/**
+ * Main perps DEX uses an empty sub-dex name on the wire; surfaced as
+ * 'hyperliquid' in normalised market IDs.
+ *
+ * @internal
+ */
+export declare const MAIN_DEX_NAME = "";
+/** @internal */
+export declare const MAIN_MARKET_ID = "hyperliquid";
+/** @internal */
+export declare const SPOT_MARKET_ID = "spot";
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,gBAAgB,CAAA;AAEzC;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,gCAAgC,CAAA;AAExE;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,EAAE,OAG3C,CAAA;AAED,gBAAgB;AAChB,eAAO,MAAM,qBAAqB,KAAK,CAAA;AACvC,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,MAAM,CAAA;AACpC,gBAAgB;AAChB,eAAO,MAAM,cAAc,QAA2B,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,KAAK,CAAA;AAC/B,gBAAgB;AAChB,eAAO,MAAM,cAAc,gBAAgB,CAAA;AAC3C,gBAAgB;AAChB,eAAO,MAAM,cAAc,SAAS,CAAA"}

package/dist/esm/constants.js

@@ -0,0 +1,42 @@
+/**
+ * Hyperliquid provider key (exported from the package index as
+ * `HYPERLIQUID_PROVIDER_KEY`).
+ *
+ * @public
+ */
+export const PROVIDER_KEY = 'hyperliquid';
+/**
+ * Default Hyperliquid REST base URL.
+ *
+ * @public
+ */
+export const DEFAULT_HYPERLIQUID_API_URL = 'https://api.hyperliquid.xyz';
+/**
+ * Approximate published baseline maker/taker fee tier for Hyperliquid, used to
+ * seed fee math before the live account `feeTier` resolves. Rates are fractions
+ * (not basis points): `0.00015` = 0.015% maker, `0.00045` = 0.045% taker.
+ *
+ * @public
+ */
+export const HYPERLIQUID_FEE_TIER_FALLBACK = {
+    maker: '0.00015',
+    taker: '0.00045',
+};
+/** @internal */
+export const DEFAULT_HISTORY_LIMIT = 50;
+/** @internal */
+export const MAX_HISTORY_LIMIT = 200;
+/** @internal */
+export const NINETY_DAYS_MS = 90 * 24 * 60 * 60 * 1000;
+/**
+ * Main perps DEX uses an empty sub-dex name on the wire; surfaced as
+ * 'hyperliquid' in normalised market IDs.
+ *
+ * @internal
+ */
+export const MAIN_DEX_NAME = '';
+/** @internal */
+export const MAIN_MARKET_ID = 'hyperliquid';
+/** @internal */
+export const SPOT_MARKET_ID = 'spot';
+//# sourceMappingURL=constants.js.map

package/dist/esm/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAA;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,6BAA6B,CAAA;AAExE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAY;IACpD,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;CACjB,CAAA;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AACvC,gBAAgB;AAChB,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AACpC,gBAAgB;AAChB,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAA;AAC/B,gBAAgB;AAChB,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAA;AAC3C,gBAAgB;AAChB,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAA"}

package/dist/esm/context.d.ts

@@ -0,0 +1,26 @@
+import { type PerpsSDKClient } from '@lifi/perps-sdk';
+/**
+ * Runtime context the Hyperliquid read services resolve their deps from: the
+ * bound {@link PerpsSDKClient} (config / fetch / retry / market lookups) and
+ * the resolved REST base URL. Captured once in the provider factory's closure
+ * via {@link HyperliquidContextRef.bind}; the read methods read it at call
+ * time. This is the late-bind the SDK's `bindProvider` sets up — the factory
+ * is constructed before the client exists.
+ */
+export interface HyperliquidContext {
+    client: PerpsSDKClient;
+    apiUrl: string;
+}
+/**
+ * Mutable, single-assignment holder for the {@link HyperliquidContext}. The
+ * provider factory creates one per instance and exposes `bind`; the read
+ * services call {@link HyperliquidContextRef.require} at call time.
+ */
+export declare class HyperliquidContextRef {
+    private readonly apiUrl;
+    private context;
+    constructor(apiUrl: string);
+    bind(client: PerpsSDKClient): void;
+    require(): HyperliquidContext;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/esm/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGjE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,OAAO,CAAgC;gBAElB,MAAM,EAAE,MAAM;IAE3C,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIlC,OAAO,IAAI,kBAAkB;CAU9B"}

package/dist/esm/context.js

@@ -0,0 +1,25 @@
+import { PerpsError } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+/**
+ * Mutable, single-assignment holder for the {@link HyperliquidContext}. The
+ * provider factory creates one per instance and exposes `bind`; the read
+ * services call {@link HyperliquidContextRef.require} at call time.
+ */
+export class HyperliquidContextRef {
+    apiUrl;
+    context;
+    constructor(apiUrl) {
+        this.apiUrl = apiUrl;
+    }
+    bind(client) {
+        this.context = { client, apiUrl: this.apiUrl };
+    }
+    require() {
+        if (this.context === undefined) {
+            throw new PerpsError(PerpsErrorCode.SDKError, 'hyperliquidProvider used before binding. Register it via ' +
+                'createPerpsClient({ providers: [hyperliquidProvider()] }).');
+        }
+        return this.context;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/esm/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAelD;;;;GAIG;AACH,MAAM,OAAO,qBAAqB;IAGH;IAFrB,OAAO,CAAgC;IAE/C,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,IAAI,CAAC,MAAsB;QACzB,IAAI,CAAC,OAAO,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IAChD,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,QAAQ,EACvB,2DAA2D;gBACzD,4DAA4D,CAC/D,CAAA;QACH,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;CACF"}

package/dist/esm/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Hyperliquid provider plugin for `@lifi/perps-sdk`. Reads account-specific
+ * state directly from `${apiUrl}/info`; enriched asset metadata and
+ * public/shared data come from the LI.FI backend. Register the
+ * `hyperliquidProvider()` factory with `createPerpsClient`.
+ *
+ * @packageDocumentation
+ * @public
+ */
+export { projectHyperliquidConfigSettings } from './accountConfig.js';
+export { summarizeHyperliquidAccount } from './accountSummary.js';
+export { DEFAULT_HYPERLIQUID_API_URL, HYPERLIQUID_FEE_TIER_FALLBACK, PROVIDER_KEY as HYPERLIQUID_PROVIDER_KEY, } from './constants.js';
+export { type HyperliquidPerpsProvider, type HyperliquidProviderOptions, hyperliquidProvider, } from './HyperliquidProvider.js';
+export type { GetAccountParams } from './services/getAccount.js';
+export { getAccount } from './services/getAccount.js';
+export type { GetActivityParams } from './services/getActivity.js';
+export { getActivity } from './services/getActivity.js';
+export type { GetFillsParams } from './services/getFills.js';
+export { getFills } from './services/getFills.js';
+export type { GetOrderParams } from './services/getOrder.js';
+export { getOrder } from './services/getOrder.js';
+export type { GetOrdersParams } from './services/getOrders.js';
+export { getOrders } from './services/getOrders.js';
+export type { GetPositionsParams } from './services/getPositions.js';
+export { getPositions } from './services/getPositions.js';
+export type { HyperliquidAgent } from './signers/HyperliquidAgentStore.js';
+export { HyperliquidAgentStore } from './signers/HyperliquidAgentStore.js';
+export * from './types/index.js';
+export * from './utils/index.js';
+export { HyperliquidWsProvider, hyperliquidWsProvider, } from './websocket/HyperliquidWsProvider.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,YAAY,IAAI,wBAAwB,GACzC,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sCAAsC,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,26 @@
+// biome-ignore-all lint/performance/noBarrelFile: package public entry point.
+// biome-ignore-all lint/performance/noReExportAll: package public entry point.
+/**
+ * Hyperliquid provider plugin for `@lifi/perps-sdk`. Reads account-specific
+ * state directly from `${apiUrl}/info`; enriched asset metadata and
+ * public/shared data come from the LI.FI backend. Register the
+ * `hyperliquidProvider()` factory with `createPerpsClient`.
+ *
+ * @packageDocumentation
+ * @public
+ */
+export { projectHyperliquidConfigSettings } from './accountConfig.js';
+export { summarizeHyperliquidAccount } from './accountSummary.js';
+export { DEFAULT_HYPERLIQUID_API_URL, HYPERLIQUID_FEE_TIER_FALLBACK, PROVIDER_KEY as HYPERLIQUID_PROVIDER_KEY, } from './constants.js';
+export { hyperliquidProvider, } from './HyperliquidProvider.js';
+export { getAccount } from './services/getAccount.js';
+export { getActivity } from './services/getActivity.js';
+export { getFills } from './services/getFills.js';
+export { getOrder } from './services/getOrder.js';
+export { getOrders } from './services/getOrders.js';
+export { getPositions } from './services/getPositions.js';
+export { HyperliquidAgentStore } from './signers/HyperliquidAgentStore.js';
+export * from './types/index.js';
+export * from './utils/index.js';
+export { HyperliquidWsProvider, hyperliquidWsProvider, } from './websocket/HyperliquidWsProvider.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAE/E;;;;;;;;GAQG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,YAAY,IAAI,wBAAwB,GACzC,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAGL,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sCAAsC,CAAA"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type": "module","sideEffects":false}

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

@@ -0,0 +1,28 @@
+import { type ProviderGetAccountParams, type SDKRequestOptions } from '@lifi/perps-sdk';
+import type { AccountResponse } from '@lifi/perps-types';
+import type { HyperliquidContext } from '../context.js';
+/**
+ * Parameters for {@link getAccount}.
+ *
+ * @public
+ */
+export type GetAccountParams = ProviderGetAccountParams;
+/**
+ * Fetch the Hyperliquid account snapshot for `address`: balances per
+ * sub-dex (and spot), aggregate margin used, unrealised PnL, fee tier, and
+ * the typed `HyperliquidAccountConfig`.
+ *
+ * Issues `userFees`, `userAbstraction`, `extraAgents`,
+ * `spotClearinghouseState` and one `clearinghouseState` per supported perps
+ * sub-dex, all concurrently.
+ *
+ * `config.builderFeeApproval` is intentionally omitted — that field
+ * compares the venue's `maxBuilderFee` against the integrator-specific
+ * builder address LI.FI publishes, which is not data the venue itself
+ * owns. Surfacing it belongs at a higher layer (the LI.FI backend or a
+ * thin client-side helper that has the integrator's builder config).
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export declare const getAccount: ({ client, apiUrl }: HyperliquidContext, params: GetAccountParams, options?: SDKRequestOptions) => Promise<AccountResponse>;
+//# sourceMappingURL=getAccount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAccount.d.ts","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAiBvD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,CAAA;AAkGvD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,UAAU,GACrB,oBAAoB,kBAAkB,EACtC,QAAQ,gBAAgB,EACxB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,eAAe,CA0GzB,CAAA"}

package/dist/esm/services/getAccount.js

@@ -0,0 +1,134 @@
+import { getMarketRegistry, getPrices, stringToFloat, } from '@lifi/perps-sdk';
+import { PROVIDER_KEY } from '../constants.js';
+import { HlAbstractionMode, } from '../types/index.js';
+import { perpsDexNames, spotAssetFromToken, spotBalance, spotPriceById, } from '../utils/index.js';
+import { hlInfoOptions, infoRequest } from '../utils/infoClient.js';
+import { mapPosition } from '../utils/mapPosition.js';
+const getAccountValue = (state) => Number.parseFloat(state.crossMarginSummary.accountValue || state.marginSummary.accountValue);
+const getTotalMarginUsed = (state) => Number.parseFloat(state.crossMarginSummary.totalMarginUsed ||
+    state.marginSummary.totalMarginUsed);
+const getMarginUsed = (abstraction, positions, stateByDex) => {
+    if (abstraction === HlAbstractionMode.UNIFIED_ACCOUNT ||
+        abstraction === HlAbstractionMode.PORTFOLIO_MARGIN) {
+        // Per HL docs, individual per-dex states are not meaningful for these
+        // modes; derive total margin from the already-mapped positions.
+        const total = positions.reduce((sum, p) => sum + Number.parseFloat(p.marginUsed), 0);
+        return total.toString();
+    }
+    if (abstraction === HlAbstractionMode.DEX_ABSTRACTION) {
+        let total = 0;
+        for (const [, state] of stateByDex) {
+            total += getTotalMarginUsed(state);
+        }
+        return total.toString();
+    }
+    const mainState = stateByDex.get('');
+    if (!mainState) {
+        return '0';
+    }
+    return getTotalMarginUsed(mainState).toString();
+};
+const isUnifiedMode = (abstraction) => abstraction === HlAbstractionMode.UNIFIED_ACCOUNT ||
+    abstraction === HlAbstractionMode.PORTFOLIO_MARGIN;
+const buildBalances = (abstraction, spotState, stateByDex, quoteAssetIds, priceById, quoteAssetByCategory) => {
+    const balances = [];
+    const collateralBalances = [];
+    // Spot balances: collateral iff the token is a category quote asset.
+    for (const b of spotState.balances) {
+        const balance = spotBalance(spotAssetFromToken(b), b.total, priceById);
+        if (quoteAssetIds.has(balance.asset.id)) {
+            collateralBalances.push(balance);
+        }
+        else {
+            balances.push(balance);
+        }
+    }
+    // Unified/portfolio modes hold everything in spot — per-dex equity would
+    // double-count. Only disabled/dexAbstraction carry separate venue collateral.
+    // `accountValue` is reported net of locked margin, i.e. the free collateral;
+    // the locked portion is carried by the positions' `marginUsed`.
+    if (!isUnifiedMode(abstraction)) {
+        for (const [dex, state] of stateByDex) {
+            const categoryId = dex || PROVIDER_KEY;
+            const value = getAccountValue(state);
+            collateralBalances.push({
+                categoryId,
+                // Always present: every dex in `stateByDex` derives from `markets`,
+                // which is what populates `quoteAssetByCategory`.
+                asset: quoteAssetByCategory.get(categoryId),
+                units: value.toString(),
+                valueUsd: value.toString(),
+            });
+        }
+    }
+    return { balances, collateralBalances };
+};
+/**
+ * Fetch the Hyperliquid account snapshot for `address`: balances per
+ * sub-dex (and spot), aggregate margin used, unrealised PnL, fee tier, and
+ * the typed `HyperliquidAccountConfig`.
+ *
+ * Issues `userFees`, `userAbstraction`, `extraAgents`,
+ * `spotClearinghouseState` and one `clearinghouseState` per supported perps
+ * sub-dex, all concurrently.
+ *
+ * `config.builderFeeApproval` is intentionally omitted — that field
+ * compares the venue's `maxBuilderFee` against the integrator-specific
+ * builder address LI.FI publishes, which is not data the venue itself
+ * owns. Surfacing it belongs at a higher layer (the LI.FI backend or a
+ * thin client-side helper that has the integrator's builder config).
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export const getAccount = async ({ client, apiUrl }, params, options) => {
+    const registry = getMarketRegistry(client, PROVIDER_KEY);
+    const markets = await registry.sync();
+    const dexNames = perpsDexNames(markets);
+    const quoteAssetIds = new Set(markets.map((m) => m.quoteAsset.id));
+    const quoteAssetByCategory = new Map(markets.map((m) => [m.categoryId, m.quoteAsset]));
+    const infoOpts = hlInfoOptions(client, options);
+    const [feesResult, abstractionResult, agentsResult, spotState, stateResults, { prices },] = await Promise.all([
+        infoRequest(apiUrl, { type: 'userFees', user: params.address }, infoOpts),
+        // "Never set abstraction" is a successful 200 `null` body, not an error —
+        // so a fetch failure must propagate, never be coerced to `null` (which
+        // would silently route margin/balance down the wrong, non-unified branch).
+        infoRequest(apiUrl, { type: 'userAbstraction', user: params.address }, infoOpts),
+        infoRequest(apiUrl, { type: 'extraAgents', user: params.address }, infoOpts),
+        infoRequest(apiUrl, { type: 'spotClearinghouseState', user: params.address }, infoOpts),
+        Promise.all(dexNames.map((name) => infoRequest(apiUrl, {
+            type: 'clearinghouseState',
+            user: params.address,
+            ...(name ? { dex: name } : {}),
+        }, infoOpts))),
+        getPrices(client, { provider: PROVIDER_KEY }, options),
+    ]);
+    const priceById = spotPriceById(markets, new Map(prices.map((p) => [p.marketId, stringToFloat(p.markPrice)])));
+    const positions = stateResults.flatMap((state) => state.assetPositions
+        .filter((ap) => Number.parseFloat(ap.position.szi) !== 0)
+        .map((ap) => mapPosition(ap, registry.require(ap.position.coin))));
+    const stateByDex = new Map();
+    stateResults.forEach((state, i) => {
+        stateByDex.set(dexNames[i], state);
+    });
+    const totalUnrealizedPnl = positions.reduce((sum, p) => sum + Number.parseFloat(p.unrealizedPnl), 0);
+    const config = {
+        provider: PROVIDER_KEY,
+        abstractionMode: abstractionResult,
+        agents: agentsResult,
+    };
+    const { balances, collateralBalances } = buildBalances(abstractionResult, spotState, stateByDex, quoteAssetIds, priceById, quoteAssetByCategory);
+    return {
+        provider: PROVIDER_KEY,
+        address: params.address,
+        balances,
+        collateralBalances,
+        marginUsed: getMarginUsed(abstractionResult, positions, stateByDex),
+        unrealizedPnl: totalUnrealizedPnl.toString(),
+        feeTier: {
+            maker: feesResult.userAddRate ?? '0',
+            taker: feesResult.userCrossRate ?? '0',
+        },
+        config,
+    };
+};
+//# sourceMappingURL=getAccount.js.map

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

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

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

@@ -0,0 +1,33 @@
+import { type SDKRequestOptions } from '@lifi/perps-sdk';
+import type { ActivitiesResponse } from '@lifi/perps-types';
+import { ActivityType } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { HyperliquidContext } from '../context.js';
+/**
+ * Parameters for {@link getActivity}.
+ *
+ * @public
+ */
+export interface GetActivityParams {
+    address: Address;
+    limit?: number;
+    /** `cursor` is a ms-since-epoch upper bound — items with `timestamp < cursor` are returned. */
+    cursor?: string;
+    startTime?: number;
+    endTime?: number;
+    type?: ActivityType[];
+}
+/**
+ * Fetch a chronological activity feed (deposits, withdrawals, transfers,
+ * liquidations, funding) for `address`. Combines results from Hyperliquid's
+ * `userNonFundingLedgerUpdates` and `userFunding` endpoints, sorted
+ * newest-first.
+ *
+ * Cursor-based pagination uses the ms-since-epoch timestamp of the last
+ * item on the current page. `startTime` defaults to 90 days ago to keep
+ * unbounded queries cheap.
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export declare const getActivity: ({ client, apiUrl }: HyperliquidContext, params: GetActivityParams, options?: SDKRequestOptions) => Promise<ActivitiesResponse>;
+//# sourceMappingURL=getActivity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getActivity.d.ts","sourceRoot":"","sources":["../../../src/services/getActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAOnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAYvD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;CACtB;AAmDD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GACtB,oBAAoB,kBAAkB,EACtC,QAAQ,iBAAiB,EACzB,UAAU,iBAAiB,KAC1B,OAAO,CAAC,kBAAkB,CAuD5B,CAAA"}

package/dist/esm/services/getActivity.js

@@ -0,0 +1,75 @@
+import { getMarketRegistry } from '@lifi/perps-sdk';
+import { ActivityType } from '@lifi/perps-types';
+import { DEFAULT_HISTORY_LIMIT, MAX_HISTORY_LIMIT, NINETY_DAYS_MS, PROVIDER_KEY, } from '../constants.js';
+import { mapFundingActivity, mapLedgerEntry } from '../utils/index.js';
+import { hlInfoOptions, infoRequest, } from '../utils/infoClient.js';
+const fetchActivityData = async (apiUrl, typeFilter, timeParams, resolveMarket, options) => {
+    const needLedger = !typeFilter || typeFilter.some((t) => t !== ActivityType.FUNDING);
+    const needFunding = !typeFilter || typeFilter.includes(ActivityType.FUNDING);
+    const [ledgerUpdates, fundingUpdates] = await Promise.all([
+        needLedger
+            ? infoRequest(apiUrl, { type: 'userNonFundingLedgerUpdates', ...timeParams }, options)
+            : Promise.resolve([]),
+        needFunding
+            ? infoRequest(apiUrl, { type: 'userFunding', ...timeParams }, options)
+            : Promise.resolve([]),
+    ]);
+    const ledgerItems = ledgerUpdates
+        .map((entry) => mapLedgerEntry(entry, PROVIDER_KEY, timeParams.user, resolveMarket))
+        .filter((item) => item !== null);
+    const fundingItems = fundingUpdates.map((entry) => mapFundingActivity(entry, PROVIDER_KEY, resolveMarket));
+    const merged = [...ledgerItems, ...fundingItems].sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    if (!typeFilter) {
+        return merged;
+    }
+    const typeSet = new Set(typeFilter);
+    return merged.filter((item) => typeSet.has(item.type));
+};
+/**
+ * Fetch a chronological activity feed (deposits, withdrawals, transfers,
+ * liquidations, funding) for `address`. Combines results from Hyperliquid's
+ * `userNonFundingLedgerUpdates` and `userFunding` endpoints, sorted
+ * newest-first.
+ *
+ * Cursor-based pagination uses the ms-since-epoch timestamp of the last
+ * item on the current page. `startTime` defaults to 90 days ago to keep
+ * unbounded queries cheap.
+ * @throws {PerpsError} On Hyperliquid REST error, network, or parsing failures.
+ * @public
+ */
+export const getActivity = 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 startTime = params.startTime ?? Date.now() - NINETY_DAYS_MS;
+    const endTime = params.cursor === undefined
+        ? params.endTime
+        : Number.parseInt(params.cursor, 10);
+    const timeParams = {
+        user: params.address,
+        startTime,
+        ...(endTime === undefined ? {} : { endTime }),
+    };
+    const merged = await fetchActivityData(apiUrl, params.type, timeParams, (coin) => registry.require(coin), infoOpts);
+    // Hyperliquid's endTime is inclusive — drop boundary items so we don't
+    // return the cursor row twice on the next page.
+    const filtered = params.cursor === undefined
+        ? merged
+        : merged.filter((item) => new Date(item.timestamp).getTime() <
+            Number.parseInt(params.cursor, 10));
+    const hasMore = filtered.length > limit;
+    const items = filtered.slice(0, limit);
+    return {
+        provider: PROVIDER_KEY,
+        items,
+        pagination: {
+            limit,
+            hasMore,
+            cursor: items.length > 0
+                ? String(new Date(items[items.length - 1].timestamp).getTime())
+                : undefined,
+        },
+    };
+};
+//# sourceMappingURL=getActivity.js.map