@lifi/perps-sdk-provider-hyperliquid 0.0.0-preview-c903f1e

package/dist/cjs/websocket/HyperliquidWsProvider.js

@@ -0,0 +1,359 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyperliquidWsProvider = exports.hyperliquidWsProvider = void 0;
+const perps_sdk_1 = require("@lifi/perps-sdk");
+const perps_types_1 = require("@lifi/perps-types");
+const constants_js_1 = require("../constants.js");
+const index_js_1 = require("../utils/index.js");
+const HL_L2_BOOK_MAX_LEVELS_PER_SIDE = 20;
+const hyperliquidWsProvider = () => ({ provider, wsUrl, markets, client }) => {
+    const subDexes = markets.filter((m) => m !== provider && m !== 'spot');
+    return new HyperliquidWsProvider(wsUrl, provider, subDexes, client);
+};
+exports.hyperliquidWsProvider = hyperliquidWsProvider;
+class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
+    orderUpdatesKey;
+    subDexes;
+    client;
+    registry;
+    midsBySubDex = new Map();
+    constructor(wsUrl, providerKey, subDexes, client) {
+        super(new perps_sdk_1.ReconnectingWebSocket(wsUrl, { pingPayload: '{"method":"ping"}' }), providerKey);
+        this.subDexes = subDexes;
+        this.client = client;
+        this.registry = client && (0, perps_sdk_1.getMarketRegistry)(client, providerKey);
+    }
+    async subscribeQuote(params, onQuote) {
+        const client = this.client;
+        if (client === undefined) {
+            throw new Error('HyperliquidWsProvider: PerpsSDKClient not provided; cannot stream quotes. ' +
+                'Construct via `hyperliquidWsProvider()` and register with PerpsWsClient.');
+        }
+        return (0, perps_sdk_1.resolveSubscribeQuote)(client, this.providerKey, this, params, constants_js_1.HYPERLIQUID_FEE_TIER_FALLBACK, onQuote);
+    }
+    async openChannel(sub) {
+        if (sub.channel === 'orderUpdates') {
+            this.claimOrderUpdatesKey(this.toKey(sub));
+        }
+        await this.registry?.sync();
+        if (sub.channel === 'prices') {
+            const entries = this.getPriceSubEntries();
+            for (const { subKey, payload } of entries) {
+                await this.registerSub(subKey, payload);
+            }
+            await this.rws.ready();
+            return () => {
+                for (const { subKey, payload } of entries) {
+                    this.unregisterSub(subKey);
+                    this.rws.send(JSON.stringify({ method: 'unsubscribe', subscription: payload }));
+                }
+                this.midsBySubDex.clear();
+            };
+        }
+        const key = this.toKey(sub);
+        const payload = this.toHlPayload(sub);
+        await this.registerSub(key, payload);
+        await this.rws.ready();
+        return () => {
+            this.unregisterSub(key);
+            if (this.orderUpdatesKey === key) {
+                this.orderUpdatesKey = undefined;
+            }
+            this.rws.send(JSON.stringify({ method: 'unsubscribe', subscription: payload }));
+        };
+    }
+    claimOrderUpdatesKey(key) {
+        const active = this.orderUpdatesKey;
+        if (active !== undefined &&
+            active !== key &&
+            !this.closeChannelIfIdle(active)) {
+            throw new Error(`Hyperliquid supports one orderUpdates address per provider instance ` +
+                `(frames carry no user field). Unsubscribe ` +
+                `${active.slice('orderUpdates:'.length)} before subscribing ` +
+                `${key.slice('orderUpdates:'.length)}.`);
+        }
+        this.orderUpdatesKey = key;
+    }
+    getPriceSubEntries() {
+        return [
+            {
+                subKey: 'allMids:default',
+                payload: { type: 'allMids' },
+            },
+            ...this.subDexes.map((dex) => ({
+                subKey: `allMids:${dex}`,
+                payload: { type: 'allMids', dex },
+            })),
+        ];
+    }
+    onClose() {
+        this.midsBySubDex.clear();
+        this.orderUpdatesKey = undefined;
+    }
+    sendSubscribe(payload) {
+        this.rws.send(JSON.stringify({ method: 'subscribe', subscription: payload }));
+    }
+    toKey(sub) {
+        switch (sub.channel) {
+            case 'prices':
+                return 'allMids';
+            case 'orderbook':
+                return `l2Book:${sub.marketId}`;
+            case 'candle':
+                return `candle:${sub.marketId}:${sub.interval}`;
+            case 'orderUpdates':
+                return `orderUpdates:${sub.address.toLowerCase()}`;
+            case 'fills':
+                return `userFills:${sub.address.toLowerCase()}`;
+            case 'positions':
+                return `positions:${sub.address.toLowerCase()}`;
+            case 'spotBalances':
+                return `spotState:${sub.address.toLowerCase()}`;
+        }
+    }
+    toHlPayload(sub) {
+        switch (sub.channel) {
+            case 'prices':
+                return { type: 'allMids' };
+            case 'orderbook':
+                return {
+                    type: 'l2Book',
+                    coin: sub.marketId,
+                    ...(sub.priceStep !== undefined
+                        ? (0, index_js_1.priceStepToAggregation)(sub.priceStep, this.mergedMids().get(sub.marketId) ?? Number.NaN)
+                        : {}),
+                };
+            case 'candle':
+                return {
+                    type: 'candle',
+                    coin: sub.marketId,
+                    interval: sub.interval,
+                };
+            case 'orderUpdates':
+                return { type: 'orderUpdates', user: sub.address };
+            case 'fills':
+                return { type: 'userFills', user: sub.address };
+            case 'positions':
+                return { type: 'allDexsClearinghouseState', user: sub.address };
+            case 'spotBalances':
+                return { type: 'spotState', user: sub.address };
+        }
+    }
+    handleMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            perps_sdk_1.wsLog.parseFailure(this.providerKey, raw);
+            return;
+        }
+        if (!msg.channel ||
+            msg.channel === 'pong' ||
+            msg.channel === 'subscriptionResponse') {
+            return;
+        }
+        if (msg.channel === 'error') {
+            perps_sdk_1.wsLog.serverError(this.providerKey, String(msg.data));
+            return;
+        }
+        if (!isValidHlFrame(msg.channel, msg.data)) {
+            perps_sdk_1.wsLog.parseFailure(this.providerKey, raw);
+            return;
+        }
+        try {
+            switch (msg.channel) {
+                case 'allMids':
+                    this.handleAllMids(msg.data);
+                    break;
+                case 'l2Book':
+                    this.handleL2Book(msg.data);
+                    break;
+                case 'candle':
+                    this.handleCandle(msg.data);
+                    break;
+                case 'orderUpdates':
+                    this.handleOrderUpdates(msg.data);
+                    break;
+                case 'userFills':
+                    this.handleUserFills(msg.data);
+                    break;
+                case 'allDexsClearinghouseState':
+                    this.handleAllDexsClearinghouseState(msg.data);
+                    break;
+                case 'spotState':
+                    this.handleSpotState(msg.data);
+                    break;
+            }
+        }
+        catch (error) {
+            perps_sdk_1.wsLog.handlerFailure(this.providerKey, error);
+        }
+    }
+    handleAllMids(data) {
+        const subDexKey = data.dex || 'default';
+        this.midsBySubDex.set(subDexKey, data.mids);
+        const merged = {};
+        for (const mids of this.midsBySubDex.values()) {
+            Object.assign(merged, mids);
+        }
+        this.emit('allMids', { channel: 'prices', data: merged });
+    }
+    mergedMids() {
+        const map = new Map();
+        for (const mids of this.midsBySubDex.values()) {
+            for (const [id, mid] of Object.entries(mids)) {
+                map.set(id, Number(mid));
+            }
+        }
+        return map;
+    }
+    handleL2Book(data) {
+        this.emit(`l2Book:${data.coin}`, {
+            channel: 'orderbook',
+            data: {
+                provider: this.providerKey,
+                marketId: data.coin,
+                bids: data.levels[0]
+                    .slice(0, HL_L2_BOOK_MAX_LEVELS_PER_SIDE)
+                    .map((l) => ({ price: l.px, size: l.sz })),
+                asks: data.levels[1]
+                    .slice(0, HL_L2_BOOK_MAX_LEVELS_PER_SIDE)
+                    .map((l) => ({ price: l.px, size: l.sz })),
+                timestamp: data.time,
+            },
+        });
+    }
+    handleCandle(data) {
+        this.emit(`candle:${data.s}:${data.i}`, {
+            channel: 'candle',
+            data: {
+                t: data.t,
+                o: data.o,
+                h: data.h,
+                l: data.l,
+                c: data.c,
+                v: data.v,
+            },
+        });
+    }
+    handleOrderUpdates(data) {
+        const key = this.orderUpdatesKey;
+        if (key === undefined) {
+            return;
+        }
+        const openOrders = [];
+        const triggerOrders = [];
+        const terminated = [];
+        for (const detail of data) {
+            const o = detail.order;
+            const orderId = String(o.oid);
+            if (!(0, perps_sdk_1.isActiveOrderStatus)((0, index_js_1.mapOrderStatus)(detail.status))) {
+                terminated.push(orderId);
+                continue;
+            }
+            const type = (0, index_js_1.mapOrderType)(o.orderType);
+            const market = this.registry?.get(o.coin);
+            if (!market) {
+                continue;
+            }
+            const createdAt = new Date(o.timestamp).toISOString();
+            if ((0, index_js_1.isTriggerOrder)(o)) {
+                const isLimit = type === perps_types_1.OrderType.TAKE_PROFIT_LIMIT || type === perps_types_1.OrderType.STOP_LIMIT;
+                triggerOrders.push({
+                    orderId,
+                    market,
+                    type,
+                    size: o.sz,
+                    triggerPrice: o.triggerPx ?? '0',
+                    ...(isLimit ? { limitPrice: o.limitPx } : {}),
+                    label: o.triggerCondition,
+                    createdAt,
+                });
+            }
+            else {
+                const filled = parseFloat(o.origSz) - parseFloat(o.sz);
+                openOrders.push({
+                    orderId,
+                    market,
+                    side: o.side === 'B' ? perps_types_1.OrderSide.BUY : perps_types_1.OrderSide.SELL,
+                    type,
+                    size: o.sz,
+                    price: o.limitPx,
+                    filledSize: filled.toString(),
+                    reduceOnly: o.reduceOnly ?? false,
+                    createdAt,
+                });
+            }
+        }
+        this.emit(key, {
+            channel: 'orderUpdates',
+            data: { openOrders, triggerOrders, terminated },
+        });
+    }
+    handleUserFills(data) {
+        const items = data.fills.flatMap((f) => {
+            const market = this.registry?.get(f.coin);
+            return market ? [(0, index_js_1.mapFill)(f, market)] : [];
+        });
+        this.emit(`userFills:${data.user.toLowerCase()}`, {
+            channel: 'fills',
+            data: items,
+        });
+    }
+    handleAllDexsClearinghouseState(data) {
+        const positions = data.clearinghouseStates.flatMap(([, state]) => state.assetPositions.flatMap((ap) => {
+            if (!(0, index_js_1.isOpenAssetPosition)(ap)) {
+                return [];
+            }
+            const market = this.registry?.get(ap.position.coin);
+            return market ? [(0, index_js_1.mapPosition)(ap, market)] : [];
+        }));
+        this.emit(`positions:${data.user.toLowerCase()}`, {
+            channel: 'positions',
+            data: positions,
+        });
+    }
+    handleSpotState(data) {
+        const priceById = (0, index_js_1.spotPriceById)(this.registry?.markets ?? [], this.mergedMids());
+        this.emit(`spotState:${data.user.toLowerCase()}`, {
+            channel: 'spotBalances',
+            data: data.spotState.balances.map((b) => ({
+                ...(0, index_js_1.spotBalance)((0, index_js_1.spotAssetFromToken)(b), b.total, priceById),
+                locked: b.hold,
+            })),
+        });
+    }
+}
+exports.HyperliquidWsProvider = HyperliquidWsProvider;
+const isObject = (v) => typeof v === 'object' && v !== null;
+function isValidHlFrame(channel, data) {
+    if (!isObject(data)) {
+        return false;
+    }
+    switch (channel) {
+        case 'allMids':
+            return isObject(data.mids);
+        case 'l2Book':
+            return (typeof data.coin === 'string' &&
+                Array.isArray(data.levels) &&
+                Array.isArray(data.levels[0]) &&
+                Array.isArray(data.levels[1]) &&
+                typeof data.time === 'number');
+        case 'candle':
+            return typeof data.s === 'string' && typeof data.i === 'string';
+        case 'orderUpdates':
+            return Array.isArray(data);
+        case 'userFills':
+            return typeof data.user === 'string' && Array.isArray(data.fills);
+        case 'allDexsClearinghouseState':
+            return (typeof data.user === 'string' && Array.isArray(data.clearinghouseStates));
+        case 'spotState':
+            return (typeof data.user === 'string' &&
+                isObject(data.spotState) &&
+                Array.isArray(data.spotState.balances));
+        default:
+            return true;
+    }
+}
+//# sourceMappingURL=HyperliquidWsProvider.js.map

package/dist/cjs/websocket/HyperliquidWsProvider.js.map

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

package/dist/cjs/websocket/index.d.ts

@@ -0,0 +1,2 @@
+export { HyperliquidWsProvider } from './HyperliquidWsProvider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/websocket/index.d.ts.map

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

package/dist/cjs/websocket/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyperliquidWsProvider = void 0;
+var HyperliquidWsProvider_js_1 = require("./HyperliquidWsProvider.js");
+Object.defineProperty(exports, "HyperliquidWsProvider", { enumerable: true, get: function () { return HyperliquidWsProvider_js_1.HyperliquidWsProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/websocket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/websocket/index.ts"],"names":[],"mappings":";;;AAEA,uEAAkE;AAAzD,iIAAA,qBAAqB,OAAA"}

package/dist/esm/HyperliquidProvider.d.ts

@@ -0,0 +1,64 @@
+import { type PerpsProviderPlugin, type StorageAdapter } from '@lifi/perps-sdk';
+import { type Address, type Hex } from 'viem';
+import { type HyperliquidAgent } from './signers/HyperliquidAgentStore.js';
+/**
+ * Options for {@link hyperliquidProvider}.
+ *
+ * @public
+ */
+export interface HyperliquidProviderOptions {
+    /**
+     * Base URL for the Hyperliquid REST surface. Defaults to
+     * `https://api.hyperliquid.xyz`. Override to point at a custom or
+     * third-party endpoint — e.g. a reverse proxy, a self-hosted mirror, or a
+     * rate-limit-managed gateway in front of Hyperliquid.
+     */
+    apiUrl?: string;
+    /**
+     * Storage adapter for the user's per-address Hyperliquid agent keypair.
+     * Defaults to browser `localStorage`. Pass a custom adapter for SSR /
+     * non-browser hosts or encrypted storage.
+     */
+    storage?: StorageAdapter;
+}
+/**
+ * Hyperliquid provider plugin extended with agent-keypair lifecycle methods.
+ * Hyperliquid signs trading actions with a per-user agent wallet the user
+ * approves via `APPROVE_AGENT`; the plugin owns that keypair's generation,
+ * persistence, and revocation. The base {@link PerpsProviderPlugin} contract
+ * stays provider-agnostic — this extension is opt-in for callers that
+ * explicitly type against it (e.g. to surface a "revoke agent" affordance).
+ */
+export interface HyperliquidPerpsProvider extends PerpsProviderPlugin {
+    /** Resolve the agent wallet address, throwing if none has been created. */
+    getAgentAddress(address: Address): Promise<Address>;
+    /** Whether an agent keypair exists for the user address. */
+    hasAgent(address: Address): Promise<boolean>;
+    /** Remove the user's agent keypair (revoke local authorization). */
+    removeAgent(address: Address): Promise<void>;
+    /** Import an existing agent keypair for the user address. */
+    importAgent(address: Address, privateKey: Hex): Promise<HyperliquidAgent>;
+}
+/**
+ * Factory for the Hyperliquid {@link PerpsProviderPlugin}.
+ *
+ * Account-specific state is read direct from `${apiUrl}/info`; enriched asset
+ * metadata and public/shared data come from the LI.FI backend (Valkey-cached).
+ * Pass to `createPerpsClient({ providers: [hyperliquidProvider()] })` and look
+ * up via `client.getProvider('hyperliquid')`.
+ *
+ * Write actions are EIP-712 typed data signed by the user's Hyperliquid agent
+ * keypair; the plugin owns that keypair (generation, storage, revocation) and
+ * dispatches the agent-signed arm via `signActions`.
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({
+ *   integrator: 'my-app',
+ *   providers: [hyperliquidProvider()],
+ * })
+ * ```
+ * @public
+ */
+export declare function hyperliquidProvider(options?: HyperliquidProviderOptions): HyperliquidPerpsProvider;
+//# sourceMappingURL=HyperliquidProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HyperliquidProvider.d.ts","sourceRoot":"","sources":["../../src/HyperliquidProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,mBAAmB,EAYxB,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAA;AAuBxB,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,GAAG,EAAa,MAAM,MAAM,CAAA;AAgBxD,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,oCAAoC,CAAA;AAO3C;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,2EAA2E;IAC3E,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACnD,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5C,oEAAoE;IACpE,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,6DAA6D;IAC7D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAC1E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,wBAAwB,CA0P1B"}

package/dist/esm/HyperliquidProvider.js

@@ -0,0 +1,162 @@
+import { PerpsError, PerpsErrorMessage, resolveQuote, } from '@lifi/perps-sdk';
+import { ActionType, PerpsErrorCode, PerpsSigner, } from '@lifi/perps-types';
+import { isAddress } from 'viem';
+import { projectHyperliquidConfigSettings } from './accountConfig.js';
+import { getAccountSummary } from './accountSummary.js';
+import { DEFAULT_HYPERLIQUID_API_URL, HYPERLIQUID_FEE_TIER_FALLBACK, PROVIDER_KEY, SPOT_MARKET_ID, } from './constants.js';
+import { HyperliquidContextRef } from './context.js';
+import { getAccount } from './services/getAccount.js';
+import { getActivity } from './services/getActivity.js';
+import { getFills } from './services/getFills.js';
+import { getOrder } from './services/getOrder.js';
+import { getOrders } from './services/getOrders.js';
+import { getPositions } from './services/getPositions.js';
+import { HyperliquidAgentStore, } from './signers/HyperliquidAgentStore.js';
+import { hyperliquidSignActions } from './signers/signActions.js';
+import { hlInfoOptions, infoRequest } from './utils/infoClient.js';
+import { calculateLiquidationPrice } from './utils/liquidation.js';
+import { formatOrderPrice, formatOrderSize } from './utils/orderFormatting.js';
+/**
+ * Factory for the Hyperliquid {@link PerpsProviderPlugin}.
+ *
+ * Account-specific state is read direct from `${apiUrl}/info`; enriched asset
+ * metadata and public/shared data come from the LI.FI backend (Valkey-cached).
+ * Pass to `createPerpsClient({ providers: [hyperliquidProvider()] })` and look
+ * up via `client.getProvider('hyperliquid')`.
+ *
+ * Write actions are EIP-712 typed data signed by the user's Hyperliquid agent
+ * keypair; the plugin owns that keypair (generation, storage, revocation) and
+ * dispatches the agent-signed arm via `signActions`.
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({
+ *   integrator: 'my-app',
+ *   providers: [hyperliquidProvider()],
+ * })
+ * ```
+ * @public
+ */
+export function hyperliquidProvider(options = {}) {
+    const apiUrl = options.apiUrl ?? DEFAULT_HYPERLIQUID_API_URL;
+    const agentStore = new HyperliquidAgentStore(options.storage);
+    const contextRef = new HyperliquidContextRef(apiUrl);
+    const toLowerAddress = (value) => typeof value === 'string' && isAddress(value) ? value.toLowerCase() : null;
+    const toValidUntilMs = (value) => {
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value);
+            return Number.isFinite(parsed) ? parsed : null;
+        }
+        return null;
+    };
+    const isKnownExpiredRemoteAgent = async (address, localAgentAddress) => {
+        let context = null;
+        try {
+            context = contextRef.require();
+        }
+        catch {
+            // Unbound provider (e.g. direct unit tests) cannot query /info.
+            return false;
+        }
+        const agents = await infoRequest(apiUrl, { type: 'extraAgents', user: address }, hlInfoOptions(context.client));
+        const local = localAgentAddress.toLowerCase();
+        const match = agents.find((agent) => toLowerAddress(agent.address) === local);
+        if (!match) {
+            return false;
+        }
+        const validUntilMs = toValidUntilMs(match.validUntil);
+        return validUntilMs !== null && validUntilMs <= Date.now();
+    };
+    const resolveApproveAgentAddress = async (address) => {
+        try {
+            const localAgent = await agentStore.get(address);
+            try {
+                if (await isKnownExpiredRemoteAgent(address, localAgent.address)) {
+                    await agentStore.remove(address);
+                    return (await agentStore.getOrCreate(address)).address;
+                }
+            }
+            catch {
+                // If the upstream extra-agent probe fails, keep the existing local key.
+            }
+            return localAgent.address;
+        }
+        catch (error) {
+            if (error instanceof PerpsError &&
+                error.message === PerpsErrorMessage.AgentNotFound) {
+                return (await agentStore.getOrCreate(address)).address;
+            }
+            throw error;
+        }
+    };
+    return {
+        type: PROVIDER_KEY,
+        bind: (client) => contextRef.bind(client),
+        getAgentAddress: async (address) => (await agentStore.get(address)).address,
+        hasAgent: (address) => agentStore.has(address),
+        removeAgent: (address) => agentStore.remove(address),
+        importAgent: (address, privateKey) => agentStore.import(address, privateKey),
+        resolveActionRequest: async (action, address, signers) => {
+            // APPROVE_AGENT is user-signed: the user authorises the agent, so the
+            // agent address rides as a param (not signerAddress). The agent is
+            // provisioned on first use so its address is known before the backend
+            // builds the typed data.
+            if (action === ActionType.APPROVE_AGENT) {
+                const agentAddress = await resolveApproveAgentAddress(address);
+                return { params: { agentAddress } };
+            }
+            // Agent-signed actions (trades, account-mode) carry the agent as the
+            // on-wire signerAddress. User-signed actions (builder-fee, withdrawal)
+            // contribute nothing — core submits under the user's own address.
+            if (signers.includes(PerpsSigner.AGENT)) {
+                const agent = await agentStore.get(address);
+                return { signerAddress: agent.address };
+            }
+            return {};
+        },
+        signActions: (method, steps, address, ctx) => hyperliquidSignActions(agentStore, method, steps, address, ctx),
+        getAccount: (params, opts) => getAccount(contextRef.require(), { address: params.address }, opts),
+        getPositions: (params, opts) => getPositions(contextRef.require(), {
+            address: params.address,
+            marketId: params.marketId,
+            limit: params.limit,
+        }, opts),
+        getOrders: (params, opts) => getOrders(contextRef.require(), {
+            address: params.address,
+            marketId: params.marketId,
+            limit: params.limit,
+        }, opts),
+        getOrder: (params, opts) => getOrder(contextRef.require(), { address: params.address, id: params.id }, opts),
+        getFills: (params, opts) => getFills(contextRef.require(), {
+            address: params.address,
+            limit: params.limit,
+            cursor: params.cursor,
+            startTime: params.startTime,
+            endTime: params.endTime,
+        }, opts),
+        getActivity: (params, opts) => getActivity(contextRef.require(), {
+            address: params.address,
+            limit: params.limit,
+            cursor: params.cursor,
+            startTime: params.startTime,
+            endTime: params.endTime,
+            type: params.type,
+        }, opts),
+        getQuote: (params, opts) => resolveQuote(contextRef.require().client, PROVIDER_KEY, params, HYPERLIQUID_FEE_TIER_FALLBACK, opts),
+        getAccountSummary: (account, positions) => getAccountSummary(account, positions),
+        formatOrderPrice: (market, price) => formatOrderPrice(price, market.szDecimals, market.categoryId === SPOT_MARKET_ID ? 'spot' : undefined),
+        formatOrderSize: (market, size) => formatOrderSize(size, market.szDecimals),
+        estimateLiquidationPrice: (market, params) => calculateLiquidationPrice(params.entryPrice, params.leverage, params.isLong, market.maxLeverage),
+        projectConfig: (config, setup, options) => {
+            if (config.provider !== PROVIDER_KEY) {
+                throw new PerpsError(PerpsErrorCode.SDKError, `hyperliquidProvider.projectConfig received config for provider ` +
+                    `'${config.provider}'.`);
+            }
+            return projectHyperliquidConfigSettings(config, setup, options);
+        },
+    };
+}
+//# sourceMappingURL=HyperliquidProvider.js.map

package/dist/esm/HyperliquidProvider.js.map

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

package/dist/esm/accountConfig.d.ts

@@ -0,0 +1,10 @@
+import type { AccountConfigSetting, HyperliquidAccountConfig, ProviderAction } from '@lifi/perps-types';
+/**
+ * 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 declare function projectHyperliquidConfigSettings(config: HyperliquidAccountConfig, setup: ProviderAction[], options: ProviderAction[]): AccountConfigSetting[];
+//# sourceMappingURL=accountConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accountConfig.d.ts","sourceRoot":"","sources":["../../src/accountConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACf,MAAM,mBAAmB,CAAA;AAoE1B;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,wBAAwB,EAChC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,cAAc,EAAE,GACxB,oBAAoB,EAAE,CAIxB"}