@lifi/perps-sdk-provider-hyperliquid 6.0.0 → 6.0.2

package/dist/types/types/order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../src/types/order.ts"],"names":[],"mappings":"AAEA,cAAc;AACd,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,cAAc,EAAE,OAAO,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAChC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,EAAE,CAAA;AAExD,cAAc;AACd,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,OAAO,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;QAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,gBAAgB,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KACzB,CAAA;IACD,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,aAAa,CAAA;CACrB,CAAA;AAED,cAAc;AACd,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAA"}
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../src/types/order.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,cAAc,EAAE,OAAO,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAChC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CAAA;AAED,qEAAqE;AACrE,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,EAAE,CAAA;AAExD;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,OAAO,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;QAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,gBAAgB,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KACzB,CAAA;IACD,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,aAAa,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAA"}

package/dist/types/types/ws.d.ts

@@ -18,7 +18,11 @@ export type HlWsPerpAssetCtx = {
     midPx: string | null;
     oraclePx: string;
 };
-/** @public */
+/**
+ * Partial perp context carried by compressed (`pac`) updates. Omitted fields
+ * are unchanged from the prior context and must be merged by the consumer.
+ * @public
+ */
 export type HlWsPerpAssetCtxPayload = Partial<HlWsPerpAssetCtx>;
 /**
  * `allDexsAssetCtxs` carries one `[dex, ctxs]` pair per perp sub-DEX, mirroring
@@ -36,7 +40,7 @@ export type HlWsAllDexsAssetCtxsData = {
  * @public
  */
 export type HlWsPacData = [string, HlWsPerpAssetCtxPayload[]][];
-/** @public */
+/** Generic Hyperliquid WS envelope; `channel` identifies the subscription and `data` is channel-specific. @public */
 export type HlWsMessage = {
     channel: string;
     data: unknown;
@@ -51,7 +55,12 @@ export type HlWsFastAssetCtx = {
     markPx?: string;
     midPx?: string | null;
 };
-/** @public */
+/**
+ * Incremental spot asset context. Hyperliquid may encode numeric fields as
+ * strings or numbers and omits unchanged fields; `midPx: null` means no book
+ * midpoint is available.
+ * @public
+ */
 export type HlWsSpotAssetCtx = {
     dayNtlVlm?: HlWsNumberString;
     prevDayPx?: HlWsNumberString;
@@ -60,12 +69,12 @@ export type HlWsSpotAssetCtx = {
     dayBaseVlm?: HlWsNumberString;
     circulatingSupply?: HlWsNumberString;
 };
-/** @public */
+/** Active perp context event keyed by its Hyperliquid wire coin. @public */
 export type HlWsActiveAssetCtxData = {
     coin: string;
     ctx: Partial<Record<keyof HlWsPerpAssetCtx, HlWsNumberString | null>>;
 };
-/** @public */
+/** Active spot context event keyed by its Hyperliquid wire coin. @public */
 export type HlWsActiveSpotAssetCtxData = {
     coin: string;
     ctx: HlWsSpotAssetCtx;
@@ -76,11 +85,15 @@ export type HlWsActiveSpotAssetCtxData = {
  * @public
  */
 export type HlWsSacData = Record<string, HlWsSpotAssetCtx>;
-/** @public */
+/** L2 snapshot envelope with the wire coin attached to {@link HlL2Book}. @public */
 export type HlWsL2BookData = HlL2Book & {
     coin: string;
 };
-/** @public */
+/**
+ * L2 channel payload. `s` is a full snapshot, while `u` is a compressed delta;
+ * `c` carries the checksum/control value when present.
+ * @public
+ */
 export type HlWsL2Data = {
     s?: HlL2Book & {
         coin: string;
@@ -88,12 +101,16 @@ export type HlWsL2Data = {
     c?: string;
     u?: HlWsCompressedL2Data;
 };
-/** @public */
+/** One level in a compressed L2 update: `p` is price and `s` is size. @public */
 export type HlWsCompressedL2Level = {
     p: string;
     s: string;
 };
-/** @public */
+/**
+ * Compressed L2 delta. `t` is the update timestamp in milliseconds, `l` holds
+ * bid/ask levels, and optional `r` describes removals.
+ * @public
+ */
 export type HlWsCompressedL2Data = {
     c: string;
     t: number;
@@ -107,14 +124,22 @@ export type HlWsCompressedL2Data = {
         }>
     ];
 };
-/** @public */
+/**
+ * Candle event payload. Inherited `t` is candle-open time; `T` is close time,
+ * `s` is the symbol, `i` is interval, and `n` is the trade count.
+ * @public
+ */
 export type HlWsCandleData = HlCandle & {
     T: number;
     s: string;
     i: string;
     n: number;
 };
-/** @public */
+/**
+ * Public trade event. Prices and size are decimal strings; `time` is
+ * milliseconds since epoch, with optional trade ID and transaction hash.
+ * @public
+ */
 export type HlWsTrade = {
     coin: string;
     side: string;
@@ -124,13 +149,17 @@ export type HlWsTrade = {
     tid?: number;
     hash?: string;
 };
-/** @public */
+/** User fills event; `isSnapshot` distinguishes the initial snapshot from updates. @public */
 export type HlWsUserFillsData = {
     isSnapshot: boolean;
     user: string;
     fills: HlUserFill[];
 };
-/** @public */
+/**
+ * Per-dex clearinghouse event for one user. Each tuple contains a wire DEX name
+ * and the perp positions/equity fields supplied by that DEX.
+ * @public
+ */
 export type HlWsAllDexsClearinghouseStateData = {
     user: string;
     clearinghouseStates: [
@@ -138,7 +167,7 @@ export type HlWsAllDexsClearinghouseStateData = {
         Pick<HlClearinghouseState, 'assetPositions' | 'marginSummary'>
     ][];
 };
-/** @public */
+/** User spot clearinghouse event containing the current spot balances. @public */
 export type HlWsSpotStateData = {
     user: string;
     spotState: {

package/dist/types/types/ws.d.ts.map

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

package/dist/types/utils/assetId.d.ts

@@ -1,19 +1,19 @@
 /**
- * Spot asset IDs use the @pairIndex format (e.g. "@230").
- *
+ * Return whether a Hyperliquid asset ID identifies spot (`@<pairIndex>`).
+ * @param assetId - Raw Hyperliquid asset ID.
  * @public
  */
 export declare const assetIsSpot: (assetId: string) => boolean;
 /**
- * Calculate the asset ID for a given provider index and asset index.
- *
- * Main provider (provider = ''): assetId = indexInProvider
- * HIP-3 providers (provider = 'xyz'): assetId = 100_000 + perpDexIndex * 10_000 + indexInProvider
+ * Calculate Hyperliquid's numeric asset ID from a perp DEX index and the
+ * asset's zero-based index within that DEX. The main DEX uses the index
+ * directly; HIP-3 DEXes use `100000 + dexIndex * 10000 + assetIndex`.
  * @public
  */
 export declare const calculateAssetId: (providerIndex: number, indexInProvider: number) => number;
 /**
- * Get the provider index from the given list of provider names.
+ * Find a sub-DEX's zero-based index in the names returned by Hyperliquid.
+ * @throws If `provider` is absent from `providerNames`.
  * @public
  */
 export declare const getProviderIndex: (provider: string, providerNames: string[]) => number;

package/dist/types/utils/assetId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assetId.d.ts","sourceRoot":"","sources":["../../../src/utils/assetId.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,OAAkC,CAAA;AAEhF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,eAAe,MAAM,EACrB,iBAAiB,MAAM,KACtB,MAKF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,eAAe,MAAM,EAAE,KACtB,MAMF,CAAA"}
+{"version":3,"file":"assetId.d.ts","sourceRoot":"","sources":["../../../src/utils/assetId.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,OAAkC,CAAA;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,eAAe,MAAM,EACrB,iBAAiB,MAAM,KACtB,MAKF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,eAAe,MAAM,EAAE,KACtB,MAMF,CAAA"}

package/dist/types/utils/assetLogo.d.ts

@@ -1,20 +1,22 @@
 import type { Asset } from '@lifi/perps-types';
-/** Token `name`s of the Unit-bridged HL spot assets. */
+/**
+ * Names of Unit-bridged Hyperliquid spot tokens recognized by the logo
+ * resolver. The set is read-only and is intended for callers that need to
+ * distinguish Unit balances before resolving their icons.
+ * @public
+ */
 export declare const UNIT_TOKEN_NAMES: ReadonlySet<string>;
-/** Return `asset` with its `logoURI` replaced when a display-symbol override exists. */
+/**
+ * Apply the provider's known symbol-specific logo corrections to an asset.
+ * Returns the original object when no override exists.
+ * @public
+ */
 export declare const applyLogoOverride: (asset: Asset) => Asset;
 /**
- * Override-aware logo URI for a Hyperliquid spot token. Base rule is
- * `coins/${name}_spot.svg`; a Unit-bridged token (`fullName` starts with
- * "Unit") resolves to its underlying's icon instead; the override table wins
- * over both.
- *
- * When `fullName` is absent — spot *balances* (`HlSpotBalance`) carry no
- * `fullName` and this issue deliberately does not fetch `spotMeta` on the
- * account path — the derivation degrades to the symbol-keyed override + base
- * `_spot` rule, so a Unit-bridged balance uses the base rule rather than its
- * underlying's icon. The registry path (which has `fullName`) keeps full Unit
- * resolution.
+ * Resolve the logo URI for a Hyperliquid spot token. Unit-bridged tokens use
+ * the underlying symbol's icon when `fullName` starts with `'Unit'`; otherwise
+ * the base URI is `coins/${name}_spot.svg`. Known symbol overrides win.
+ * @public
  */
 export declare const spotLogoURI: (name: string, fullName?: string | null) => string;
 //# sourceMappingURL=assetLogo.d.ts.map

package/dist/types/utils/assetLogo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assetLogo.d.ts","sourceRoot":"","sources":["../../../src/utils/assetLogo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAiD9C,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAEhD,CAAA;AAQD,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,GAAI,OAAO,KAAK,KAAG,KAGhD,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,GAAG,IAAI,KAAG,MAKpE,CAAA"}
+{"version":3,"file":"assetLogo.d.ts","sourceRoot":"","sources":["../../../src/utils/assetLogo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAiD9C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAEhD,CAAA;AAQD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,KAAK,KAAG,KAGhD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,GAAG,IAAI,KAAG,MAKpE,CAAA"}

package/dist/types/utils/decodeFastAssetCtxs.d.ts

@@ -1,5 +1,10 @@
 import type { HlWsFastAssetCtx } from '../types/index.js';
-/** Decode a base64 + raw-DEFLATE (RFC 1951) payload into parsed JSON. */
+/**
+ * Decode a base64-encoded raw-DEFLATE payload and parse its UTF-8 JSON body.
+ * @typeParam T - Expected shape of the decoded JSON value.
+ * @throws If decompression or JSON parsing fails.
+ * @public
+ */
 export declare function decodeCompressedJson<T>(base64: string): Promise<T>;
 /**
  * Decode a Hyperliquid `fastAssetCtxs` frame. HL sends the payload as a
@@ -8,6 +13,7 @@ export declare function decodeCompressedJson<T>(base64: string): Promise<T>;
  * (Node 18+, modern browsers), so no dependency is needed.
  *
  * @throws If the input is not valid base64 / raw-DEFLATE / JSON.
+ * @public
  */
 export declare function decodeFastAssetCtxs(base64: string): Promise<Record<string, HlWsFastAssetCtx>>;
 //# sourceMappingURL=decodeFastAssetCtxs.d.ts.map

package/dist/types/utils/decodeFastAssetCtxs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decodeFastAssetCtxs.d.ts","sourceRoot":"","sources":["../../../src/utils/decodeFastAssetCtxs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,yEAAyE;AACzE,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAcxE;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAE3C"}
+{"version":3,"file":"decodeFastAssetCtxs.d.ts","sourceRoot":"","sources":["../../../src/utils/decodeFastAssetCtxs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAcxE;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAE3C"}

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

@@ -1,7 +1,12 @@
 import { type PerpsSDKClient, type ResolvedRetryPolicy, type SDKRequestOptions } from '@lifi/perps-sdk';
 /** @internal */
 export declare const HYPERLIQUID_RETRY_DEFAULTS: ResolvedRetryPolicy;
-/** @public */
+/**
+ * Transport options for a direct Hyperliquid `/info` request. `policy`
+ * controls retries, `signal` cancels the request, and `fetchImpl` overrides
+ * the runtime's global `fetch` implementation.
+ * @public
+ */
 export interface InfoRequestOptions {
     signal?: AbortSignal;
     policy?: ResolvedRetryPolicy;

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

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

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

@@ -10,6 +10,15 @@ import type { HlFundingUpdate, HlLedgerUpdate } from '../types/index.js';
  * @public
  */
 export declare const mapLedgerEntry: (entry: HlLedgerUpdate, providerKey: string, queriedAddress: string, resolveMarket: (coin: string) => MarketDisplay) => ActivityItem | null;
-/** @public */
+/**
+ * Map a Hyperliquid funding ledger update to a normalized funding activity.
+ * `amount`, `positionSize`, and `fundingRate` retain the upstream decimal
+ * strings; `resolveMarket` supplies the provider-agnostic market metadata.
+ *
+ * `userFunding` entries all carry the zero hash, so a deterministic
+ * `funding:<coin>:<ISO time>` id is synthesized — funding accrues at most
+ * once per coin per hourly settlement, so the pair is unique per account.
+ * @public
+ */
 export declare const mapFundingActivity: (entry: HlFundingUpdate, providerKey: string, resolveMarket: (coin: string) => MarketDisplay) => FundingActivity;
 //# sourceMappingURL=mapActivity.d.ts.map

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

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

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

@@ -1,6 +1,7 @@
 import { classifyFillFromPosition } from '@lifi/perps-sdk';
 import type { Fill, MarketDisplay } from '@lifi/perps-types';
 import type { HlUserFill } from '../types/index.js';
+/** Re-export the shared fill-position classifier used by Hyperliquid mappings. @public */
 export { classifyFillFromPosition };
 /**
  * Spot-ness comes from the resolved market's category, not the coin string —

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

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

package/dist/types/utils/mapOrder.d.ts

@@ -7,7 +7,7 @@ import type { HlFrontendOpenOrder, HlOrderDetail } from '../types/index.js';
  * @public
  */
 export declare const mapOrderType: (orderType: string) => OrderType;
-/** @public */
+/** Return whether an SDK order type represents a take-profit or stop trigger. @public */
 export declare const isTriggerType: (type: OrderType) => boolean;
 /**
  * Decide whether a raw Hyperliquid order belongs in the cross-provider
@@ -30,9 +30,16 @@ export declare const isTriggerType: (type: OrderType) => boolean;
  * @public
  */
 export declare const isTriggerOrder: (o: HlFrontendOpenOrder | HlOrderDetail["order"]) => boolean;
-/** @public */
+/**
+ * Map an open Hyperliquid order to the SDK's normalized open-order shape.
+ * Numeric IDs become strings and wire millisecond timestamps become ISO dates.
+ * @public
+ */
 export declare const mapOpenOrder: (o: HlFrontendOpenOrder, market: MarketDisplay) => OpenOrder;
-/** @public */
+/**
+ * Map a Hyperliquid trigger/TP-SL order to the SDK's trigger-order shape.
+ * @public
+ */
 export declare const mapTriggerOrder: (o: HlFrontendOpenOrder, market: MarketDisplay) => TriggerOrder;
 /**
  * Map a raw Hyperliquid order status string to the SDK's OrderStatus enum.
@@ -54,6 +61,10 @@ export declare const mapOrderStatus: (status: string) => OrderStatus;
  * @public
  */
 export declare const mapStatusReason: (status: string) => string | undefined;
-/** @public */
+/**
+ * Map an `orderStatus` detail to the SDK's normalized order shape, preserving
+ * decimal size/price strings and translating status, side, and time-in-force.
+ * @public
+ */
 export declare const mapOrder: (detail: HlOrderDetail, market: MarketDisplay) => Order;
 //# sourceMappingURL=mapOrder.d.ts.map

package/dist/types/utils/mapOrder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapOrder.d.ts","sourceRoot":"","sources":["../../../src/utils/mapOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,KAAK,EACL,YAAY,EACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAEL,WAAW,EACX,SAAS,EAEV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,SAehD,CAAA;AAED,cAAc;AACd,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,KAAG,OAIjB,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,GACzB,GAAG,mBAAmB,GAAG,aAAa,CAAC,OAAO,CAAC,KAC9C,OAkBF,CAAA;AAED,cAAc;AACd,eAAO,MAAM,YAAY,GACvB,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,SAaD,CAAA;AAEF,cAAc;AACd,eAAO,MAAM,eAAe,GAC1B,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,YAcF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,WAwB/C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAmDzD,CAAA;AAeD,cAAc;AACd,eAAO,MAAM,QAAQ,GACnB,QAAQ,aAAa,EACrB,QAAQ,aAAa,KACpB,KAsBF,CAAA"}
+{"version":3,"file":"mapOrder.d.ts","sourceRoot":"","sources":["../../../src/utils/mapOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,KAAK,EACL,YAAY,EACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAEL,WAAW,EACX,SAAS,EAEV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,SAehD,CAAA;AAED,yFAAyF;AACzF,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,KAAG,OAIjB,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,GACzB,GAAG,mBAAmB,GAAG,aAAa,CAAC,OAAO,CAAC,KAC9C,OAkBF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,SAaD,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,YAcF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,WAwB/C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAmDzD,CAAA;AAeD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GACnB,QAAQ,aAAa,EACrB,QAAQ,aAAa,KACpB,KAsBF,CAAA"}

package/dist/types/utils/mapPosition.d.ts

@@ -7,6 +7,11 @@ import type { HlAssetPosition } from '../types/index.js';
  * @public
  */
 export declare const isOpenAssetPosition: (ap: HlAssetPosition) => boolean;
-/** @public */
+/**
+ * Map a non-zero Hyperliquid position payload to the SDK's normalized
+ * position. Signed wire size determines side; decimal strings remain strings
+ * in the normalized response.
+ * @public
+ */
 export declare const mapPosition: (ap: HlAssetPosition, market: PerpsMarketDisplay) => Position;
 //# sourceMappingURL=mapPosition.d.ts.map

package/dist/types/utils/mapPosition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapPosition.d.ts","sourceRoot":"","sources":["../../../src/utils/mapPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAGrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,IAAI,eAAe,KAAG,OAChB,CAAA;AAE1C,cAAc;AACd,eAAO,MAAM,WAAW,GACtB,IAAI,eAAe,EACnB,QAAQ,kBAAkB,KACzB,QAyBF,CAAA"}
+{"version":3,"file":"mapPosition.d.ts","sourceRoot":"","sources":["../../../src/utils/mapPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAGrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,IAAI,eAAe,KAAG,OAChB,CAAA;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,IAAI,eAAe,EACnB,QAAQ,kBAAkB,KACzB,QAyBF,CAAA"}

package/dist/types/utils/spotBalance.d.ts

@@ -1,20 +1,19 @@
 import type { Asset, Balance, Market } from '@lifi/perps-types';
 import type { HlSpotBalance } from '../types/index.js';
 /**
- * USD price keyed by spot token index: each spot market's live USD price
- * (from `priceByMarketId`, keyed by `Market.id`) under its base-asset id, and
- * every market's quote-asset id at $1. A spot market absent from
- * `priceByMarketId` values its token at 0.
+ * Build USD prices keyed by spot token asset ID. Base tokens use the supplied
+ * market mark price; quote tokens default to exactly `$1`; missing base prices
+ * default to `0`.
+ * @public
  */
 export declare const spotPriceById: (markets: readonly Market[], priceByMarketId: ReadonlyMap<string, number>) => Map<string, number>;
 /**
- * The held spot {@link Asset} for an HL balance: the venue token index
- * (`b.token`) as `Asset.id` — equal to that token's spot `Market.baseAsset.id`
- * — with display fields derived from the coin and the override-aware spot logo.
- * `HlSpotBalance` carries no `fullName`, so Unit-bridged balances take the base
- * `_spot` rule (see {@link spotLogoURI}).
+ * Convert a Hyperliquid spot balance's numeric token index into an SDK asset.
+ * The balance payload has no `fullName`, so logo resolution uses the base
+ * `_spot` URI rule rather than Unit-underlying lookup.
+ * @public
  */
 export declare const spotAssetFromToken: (b: HlSpotBalance) => Asset;
-/** Assemble a typed spot {@link Balance} from its resolved asset and raw size. */
+/** Assemble a typed spot {@link Balance}; `total` is native token units and its USD value uses `priceById`. @public */
 export declare const spotBalance: (asset: Asset, total: string, priceById: Map<string, number>) => Balance;
 //# sourceMappingURL=spotBalance.d.ts.map

package/dist/types/utils/spotBalance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spotBalance.d.ts","sourceRoot":"","sources":["../../../src/utils/spotBalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,SAAS,MAAM,EAAE,EAC1B,iBAAiB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3C,GAAG,CAAC,MAAM,EAAE,MAAM,CAapB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,aAAa,KAAG,KAIpD,CAAA;AAEF,kFAAkF;AAClF,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,OAAO,MAAM,EACb,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,OAKD,CAAA"}
+{"version":3,"file":"spotBalance.d.ts","sourceRoot":"","sources":["../../../src/utils/spotBalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,SAAS,MAAM,EAAE,EAC1B,iBAAiB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3C,GAAG,CAAC,MAAM,EAAE,MAAM,CAapB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,aAAa,KAAG,KAIpD,CAAA;AAEF,uHAAuH;AACvH,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,OAAO,MAAM,EACb,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,OAKD,CAAA"}

package/dist/types/utils/spotCollateral.d.ts

@@ -1,14 +1,18 @@
 import type { Balance } from '@lifi/perps-types';
-/** @internal */
+/**
+ * Result of {@link partitionSpotBalances}: balances that count toward
+ * collateral and balances treated as ordinary holdings.
+ * @public
+ */
 export interface SpotPartition {
     collateralBalances: Balance[];
     balances: Balance[];
 }
 /**
- * Split spot balances into margin collateral and flat holdings. A balance is
- * collateral when its token is a category quote asset (full value) or, under
- * portfolio margin, an LTV-weighted asset (HYPE/BTC); everything else is a
- * flat holding.
+ * Partition spot balances into collateral and ordinary holdings. Quote assets
+ * are full-value collateral; portfolio-margin-supported assets retain their
+ * LTV as `collateralWeight`.
+ * @public
  */
 export declare const partitionSpotBalances: (spotBalances: readonly Balance[], quoteAssetIds: ReadonlySet<string>, portfolioMargin: boolean) => SpotPartition;
 //# sourceMappingURL=spotCollateral.d.ts.map

package/dist/types/utils/spotCollateral.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spotCollateral.d.ts","sourceRoot":"","sources":["../../../src/utils/spotCollateral.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAehD,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,OAAO,EAAE,CAAA;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,SAAS,OAAO,EAAE,EAChC,eAAe,WAAW,CAAC,MAAM,CAAC,EAClC,iBAAiB,OAAO,KACvB,aAkBF,CAAA"}
+{"version":3,"file":"spotCollateral.d.ts","sourceRoot":"","sources":["../../../src/utils/spotCollateral.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAehD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,OAAO,EAAE,CAAA;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,SAAS,OAAO,EAAE,EAChC,eAAe,WAAW,CAAC,MAAM,CAAC,EAClC,iBAAiB,OAAO,KACvB,aAkBF,CAAA"}

package/dist/types/utils/transferMargin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transferMargin.d.ts","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,QAAQ,EAEb,KAAK,yBAAyB,EAC/B,MAAM,mBAAmB,CAAA;AAyB1B;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,GACjB,yBAAyB,GAAG,SAAS,CAuBvC"}
+{"version":3,"file":"transferMargin.d.ts","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,yBAAyB,EAE/B,MAAM,mBAAmB,CAAA;AAyB1B;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,GACjB,yBAAyB,GAAG,SAAS,CAoBvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-hyperliquid",
-  "version": "6.0.0",
+  "version": "6.0.2",
   "description": "Hyperliquid provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -48,10 +48,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.48.8",
-    "@lifi/perps-types": "^4.0.0"
+    "@lifi/perps-types": "^5.0.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^6.0.0"
+    "@lifi/perps-sdk": "^6.2.1"
   },
   "publishConfig": {
     "access": "public"

package/src/HyperliquidProvider.ts

@@ -101,15 +101,25 @@ export interface HyperliquidProviderOptions {
  * 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).
+ * @public
  */
 export interface HyperliquidPerpsProvider extends PerpsProviderPlugin {
-  /** Resolve the agent wallet address, throwing if none has been created. */
+  /**
+   * Resolve the stored agent wallet address for a user.
+   * @throws {PerpsError} With `AgentNotFound` when no agent has been created.
+   */
   getAgentAddress(address: Address): Promise<Address>
-  /** Whether an agent keypair exists for the user address. */
+  /** Return whether a persisted agent keypair exists for the user address. */
   hasAgent(address: Address): Promise<boolean>
-  /** Remove the user's agent keypair (revoke local authorization). */
+  /**
+   * Remove the user's persisted agent keypair and local authorization.
+   * This does not submit an on-chain `APPROVE_AGENT` revocation.
+   */
   removeAgent(address: Address): Promise<void>
-  /** Import an existing agent keypair for the user address. */
+  /**
+   * Validate, persist, and return an existing agent private key for a user.
+   * The returned private key is stored by the configured {@link StorageAdapter}.
+   */
   importAgent(address: Address, privateKey: Hex): Promise<HyperliquidAgent>
 }
 

package/src/services/getActivity.ts

@@ -31,11 +31,15 @@ import {
  */
 export interface GetActivityParams {
   address: Address
+  /** Maximum items returned; defaults to 50 and is capped at 200. */
   limit?: number
-  /** `cursor` is a ms-since-epoch upper bound — items with `timestamp < cursor` are returned. */
+  /** Millisecond timestamp cursor; rows strictly older than it are returned. */
   cursor?: string
+  /** Inclusive lower bound in milliseconds since epoch; defaults to 90 days ago. */
   startTime?: number
+  /** Inclusive upper bound in milliseconds since epoch. */
   endTime?: number
+  /** Optional normalized activity-type filter applied after mapping. */
   type?: ActivityType[]
 }
 

package/src/services/getFills.ts

@@ -22,12 +22,13 @@ import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
  */
 export interface GetFillsParams {
   address: Address
+  /** Maximum items returned; defaults to 50 and is capped at 200. */
   limit?: number
-  /** Opaque pagination cursor from a previous page's `pagination.cursor`. */
+  /** Opaque cursor returned in the previous page's `pagination.cursor`. */
   cursor?: string
-  /** Inclusive lower bound in ms-since-epoch — switches to the `userFillsByTime` endpoint. */
+  /** Inclusive lower bound in milliseconds; selects `userFillsByTime`. */
   startTime?: number
-  /** Inclusive upper bound in ms-since-epoch — switches to the `userFillsByTime` endpoint. */
+  /** Inclusive upper bound in milliseconds; selects `userFillsByTime`. */
   endTime?: number
 }
 

package/src/services/getOrders.ts

@@ -22,8 +22,9 @@ import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
  */
 export interface GetOrdersParams {
   address: Address
-  /** Optional filter — opaque `Market.id`. */
+  /** Optional filter using the normalized opaque `Market.id`. */
   marketId?: string
+  /** Page-size hint; Hyperliquid returns all open orders in one response. */
   limit?: number
 }
 

package/src/services/getPositions.ts

@@ -22,9 +22,9 @@ import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
  */
 export interface GetPositionsParams {
   address: Address
-  /** Filter to a single opaque `Market.id` (e.g. `'BTC'`, `'xyz:PURR'`). */
+  /** Optional filter using the normalized opaque `Market.id`. */
   marketId?: string
-  /** Page size hint surfaced on the response. Hyperliquid returns all open positions in one call, so pagination is never required. */
+  /** Page-size hint; Hyperliquid returns all open positions in one response. */
   limit?: number
 }
 

package/src/signers/HyperliquidAgentStore.ts

@@ -15,12 +15,11 @@ const STORAGE_PREFIX = 'lifi-perps-agent'
 /**
  * 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.
+ * does not require a wallet prompt. `privateKey` is a 32-byte EVM hex key.
+ * @public
  */
 export interface HyperliquidAgent {
-  /** Agent wallet address. */
   address: Address
-  /** Agent private key. */
   privateKey: Hex
 }
 
@@ -60,6 +59,7 @@ const isHyperliquidAgent = (value: unknown): value is HyperliquidAgent => {
  * fully compromised page — a same-origin script can still drive this store to
  * decrypt. Blast radius is limited to agent trading: fund withdrawal still
  * requires L1 `APPROVE_AGENT` consent that the agent key alone cannot grant.
+ * @public
  */
 export class HyperliquidAgentStore {
   private storage: StorageAdapter