@lifi/perps-sdk 0.1.1-alpha.8 → 0.2.0-alpha.0

package/dist/esm/services/getOrderbook.js

@@ -6,14 +6,14 @@ import { buildUrl, request } from '../utils/request.js';
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
  * @returns Orderbook with bids and asks
- * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
  * const { bids, asks } = await getOrderbook(client, {
- *   dex: 'hyperliquid',
+ *   provider: 'hyperliquid',
  *   symbol: 'BTC',
  *   depth: 20
  * })
@@ -22,8 +22,8 @@ import { buildUrl, request } from '../utils/request.js';
  * ```
  */
 export async function getOrderbook(client, params, options) {
-    const url = buildUrl(`${client.config.apiUrl}/orderbook/${params.symbol}`, {
-        dex: params.dex,
+    const url = buildUrl(`${client.config.apiUrl}/orderbook/${encodeURIComponent(params.symbol)}`, {
+        provider: params.provider,
         depth: params.depth,
     });
     return request(client.config, url, {}, options);

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

@@ -1 +1 @@
-{"version":3,"file":"getOrderbook.js","sourceRoot":"","sources":["../../../src/services/getOrderbook.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAWvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,MAA0B,EAC1B,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,cAAc,MAAM,CAAC,MAAM,EAAE,EAAE;QACzE,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAA;IACF,OAAO,OAAO,CAAoB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACpE,CAAC"}
+{"version":3,"file":"getOrderbook.js","sourceRoot":"","sources":["../../../src/services/getOrderbook.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAWvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,MAA0B,EAC1B,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAClB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,cAAc,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EACxE;QACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CACF,CAAA;IACD,OAAO,OAAO,CAAoB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACpE,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { Address, OrdersResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface GetOrdersParams {
+    /** Provider (e.g., 'hyperliquid') */
+    provider: string;
+    /** Wallet address */
+    address: Address;
+    /** Optional symbol to filter orders by market */
+    symbol?: string;
+    /** Maximum number of results */
+    limit?: number;
+    /** Pagination cursor */
+    cursor?: string;
+}
+/**
+ * Get open orders and trigger orders for an account.
+ *
+ * @example
+ * ```ts
+ * const { openOrders, triggerOrders } = await getOrders(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ * })
+ * ```
+ */
+export declare function getOrders(client: PerpsSDKClient, params: GetOrdersParams, options?: SDKRequestOptions): Promise<OrdersResponse>;
+//# sourceMappingURL=getOrders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getOrders.d.ts","sourceRoot":"","sources":["../../../src/services/getOrders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CASzB"}

package/dist/esm/services/getOrders.js

@@ -0,0 +1,23 @@
+import { buildUrl, request } from '../utils/request.js';
+/**
+ * Get open orders and trigger orders for an account.
+ *
+ * @example
+ * ```ts
+ * const { openOrders, triggerOrders } = await getOrders(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ * })
+ * ```
+ */
+export async function getOrders(client, params, options) {
+    const url = buildUrl(`${client.config.apiUrl}/orders`, {
+        provider: params.provider,
+        address: params.address,
+        ...(params.symbol ? { symbol: params.symbol } : {}),
+        ...(params.limit ? { limit: String(params.limit) } : {}),
+        ...(params.cursor ? { cursor: params.cursor } : {}),
+    });
+    return request(client.config, url, {}, options);
+}
+//# sourceMappingURL=getOrders.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getOrders.js","sourceRoot":"","sources":["../../../src/services/getOrders.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAevD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,MAAuB,EACvB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,EAAE;QACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC,CAAA;IACF,OAAO,OAAO,CAAiB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACjE,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { Address, PositionsResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface GetPositionsParams {
+    /** Provider (e.g., 'hyperliquid') */
+    provider: string;
+    /** Wallet address */
+    address: Address;
+    /** Optional symbol to filter to a single position */
+    symbol?: string;
+    /** Maximum number of results */
+    limit?: number;
+    /** Pagination cursor */
+    cursor?: string;
+}
+/**
+ * Get open positions for an account.
+ *
+ * @example
+ * ```ts
+ * const { positions } = await getPositions(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ * })
+ * ```
+ */
+export declare function getPositions(client: PerpsSDKClient, params: GetPositionsParams, options?: SDKRequestOptions): Promise<PositionsResponse>;
+//# sourceMappingURL=getPositions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getPositions.d.ts","sourceRoot":"","sources":["../../../src/services/getPositions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAS5B"}

package/dist/esm/services/getPositions.js

@@ -0,0 +1,23 @@
+import { buildUrl, request } from '../utils/request.js';
+/**
+ * Get open positions for an account.
+ *
+ * @example
+ * ```ts
+ * const { positions } = await getPositions(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ * })
+ * ```
+ */
+export async function getPositions(client, params, options) {
+    const url = buildUrl(`${client.config.apiUrl}/positions`, {
+        provider: params.provider,
+        address: params.address,
+        ...(params.symbol ? { symbol: params.symbol } : {}),
+        ...(params.limit ? { limit: String(params.limit) } : {}),
+        ...(params.cursor ? { cursor: params.cursor } : {}),
+    });
+    return request(client.config, url, {}, options);
+}
+//# sourceMappingURL=getPositions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getPositions.js","sourceRoot":"","sources":["../../../src/services/getPositions.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAevD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,MAA0B,EAC1B,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,EAAE;QACxD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC,CAAA;IACF,OAAO,OAAO,CAAoB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACpE,CAAC"}

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

@@ -1,8 +1,8 @@
 import type { PricesResponse } from '@lifi/perps-types';
 import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
 export interface GetPricesParams {
-    /** DEX to get prices from (e.g., 'hyperliquid') */
-    dex: string;
+    /** Provider to get prices from (e.g., 'hyperliquid') */
+    provider: string;
     /** Optional list of symbols to filter (e.g., ['BTC', 'ETH']) */
     symbols?: string[];
 }
@@ -13,18 +13,18 @@ export interface GetPricesParams {
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
  * @returns Map of symbol to price
- * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
- * const { prices } = await getPrices(client, { dex: 'hyperliquid' })
+ * const { prices } = await getPrices(client, { provider: 'hyperliquid' })
  * console.log(prices) // { BTC: '95000.00', ETH: '3400.00', ... }
  *
  * // Filter by symbols
  * const { prices } = await getPrices(client, {
- *   dex: 'hyperliquid',
+ *   provider: 'hyperliquid',
  *   symbols: ['BTC', 'ETH']
  * })
  * ```

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

@@ -1 +1 @@
-{"version":3,"file":"getPrices.d.ts","sourceRoot":"","sources":["../../../src/services/getPrices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAMzB"}
+{"version":3,"file":"getPrices.d.ts","sourceRoot":"","sources":["../../../src/services/getPrices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAMzB"}

package/dist/esm/services/getPrices.js

@@ -6,25 +6,25 @@ import { buildUrl, request } from '../utils/request.js';
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
  * @returns Map of symbol to price
- * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
- * const { prices } = await getPrices(client, { dex: 'hyperliquid' })
+ * const { prices } = await getPrices(client, { provider: 'hyperliquid' })
  * console.log(prices) // { BTC: '95000.00', ETH: '3400.00', ... }
  *
  * // Filter by symbols
  * const { prices } = await getPrices(client, {
- *   dex: 'hyperliquid',
+ *   provider: 'hyperliquid',
  *   symbols: ['BTC', 'ETH']
  * })
  * ```
  */
 export async function getPrices(client, params, options) {
     const url = buildUrl(`${client.config.apiUrl}/prices`, {
-        dex: params.dex,
+        provider: params.provider,
         symbols: params.symbols?.join(','),
     });
     return request(client.config, url, {}, options);

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

@@ -1 +1 @@
-{"version":3,"file":"getPrices.js","sourceRoot":"","sources":["../../../src/services/getPrices.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AASvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,MAAuB,EACvB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,EAAE;QACrD,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC;KACnC,CAAC,CAAA;IACF,OAAO,OAAO,CAAiB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACjE,CAAC"}
+{"version":3,"file":"getPrices.js","sourceRoot":"","sources":["../../../src/services/getPrices.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AASvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,MAAuB,EACvB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,EAAE;QACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC;KACnC,CAAC,CAAA;IACF,OAAO,OAAO,CAAiB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACjE,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { ProvidersResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+/**
+ * Get all available providers.
+ *
+ * @param client - The SDK client instance
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns List of supported providers with their authorization requirements
+ * @throws {PerpsError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { providers } = await getProviders(client)
+ * console.log(providers) // [{ key: 'hyperliquid', name: 'Hyperliquid', ... }]
+ * ```
+ */
+export declare function getProviders(client: PerpsSDKClient, options?: SDKRequestOptions): Promise<ProvidersResponse>;
+//# sourceMappingURL=getProviders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getProviders.d.ts","sourceRoot":"","sources":["../../../src/services/getProviders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAO5B"}

package/dist/esm/services/getProviders.js

@@ -0,0 +1,21 @@
+import { request } from '../utils/request.js';
+/**
+ * Get all available providers.
+ *
+ * @param client - The SDK client instance
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns List of supported providers with their authorization requirements
+ * @throws {PerpsError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { providers } = await getProviders(client)
+ * console.log(providers) // [{ key: 'hyperliquid', name: 'Hyperliquid', ... }]
+ * ```
+ */
+export async function getProviders(client, options) {
+    return request(client.config, `${client.config.apiUrl}/providers`, {}, options);
+}
+//# sourceMappingURL=getProviders.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getProviders.js","sourceRoot":"","sources":["../../../src/services/getProviders.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,OAA2B;IAE3B,OAAO,OAAO,CACZ,MAAM,CAAC,MAAM,EACb,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,EACnC,EAAE,EACF,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/signers/lighter/LighterKeyStore.d.ts

@@ -0,0 +1,29 @@
+import type { Address } from '@lifi/perps-types';
+import type { StorageAdapter } from '../../agent/types.js';
+export declare const LIGHTER_PROVIDER_KEY = "lighter";
+/**
+ * Default API key slot. Reusing one slot is deliberate: Lighter allows 256
+ * slots per account but re-registering a slot overwrites the prior key, so
+ * a fixed slot keeps storage small and recovery simple.
+ */
+export declare const DEFAULT_API_KEY_INDEX = 1;
+export interface LighterApiKey {
+    /** Lighter account index, looked up once via accountsByL1Address. */
+    accountIndex: number;
+    /** API key slot (0-255). Defaults to {@link DEFAULT_API_KEY_INDEX}. */
+    apiKeyIndex: number;
+    /** Lighter-native private key (0x-prefixed hex). */
+    apiKeyPrivateKey: string;
+    /** Corresponding public key, registered via ChangePubKey. */
+    apiKeyPublicKey: string;
+}
+export declare class LighterKeyStore {
+    private readonly storage;
+    private readonly cache;
+    constructor(storage: StorageAdapter);
+    private storageKey;
+    get(address: Address): Promise<LighterApiKey | null>;
+    set(address: Address, value: LighterApiKey): Promise<void>;
+    remove(address: Address): Promise<void>;
+}
+//# sourceMappingURL=LighterKeyStore.d.ts.map

package/dist/esm/signers/lighter/LighterKeyStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LighterKeyStore.d.ts","sourceRoot":"","sources":["../../../../src/signers/lighter/LighterKeyStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAc1D,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;gBAE7C,OAAO,EAAE,cAAc;IAInC,OAAO,CAAC,UAAU;IAIZ,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAepD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9C"}

package/dist/esm/signers/lighter/LighterKeyStore.js

@@ -0,0 +1,53 @@
+// ---------------------------------------------------------------------------
+// LighterKeyStore
+//
+// Persists the Lighter-native API keypair plus account/key indices per L1
+// user address. Unlike AgentManager, the private key here is a Lighter custom
+// keypair — generated via WASM GenerateAPIKey — not an Ethereum private key.
+//
+// We namespace the storage key by provider (`lighter`) so the same user can
+// later hold credentials for other WASM-blob providers without collision.
+// ---------------------------------------------------------------------------
+const STORAGE_PREFIX = 'lifi-perps-lighter-key';
+export const LIGHTER_PROVIDER_KEY = 'lighter';
+/**
+ * Default API key slot. Reusing one slot is deliberate: Lighter allows 256
+ * slots per account but re-registering a slot overwrites the prior key, so
+ * a fixed slot keeps storage small and recovery simple.
+ */
+export const DEFAULT_API_KEY_INDEX = 1;
+export class LighterKeyStore {
+    storage;
+    cache = new Map();
+    constructor(storage) {
+        this.storage = storage;
+    }
+    storageKey(address) {
+        return `${STORAGE_PREFIX}:${address.toLowerCase()}`;
+    }
+    async get(address) {
+        const key = this.storageKey(address);
+        const cached = this.cache.get(key);
+        if (cached) {
+            return cached;
+        }
+        const stored = await this.storage.get(key);
+        if (!stored) {
+            return null;
+        }
+        const parsed = JSON.parse(stored);
+        this.cache.set(key, parsed);
+        return parsed;
+    }
+    async set(address, value) {
+        const key = this.storageKey(address);
+        this.cache.set(key, value);
+        await this.storage.set(key, JSON.stringify(value));
+    }
+    async remove(address) {
+        const key = this.storageKey(address);
+        this.cache.delete(key);
+        await this.storage.remove(key);
+    }
+}
+//# sourceMappingURL=LighterKeyStore.js.map

package/dist/esm/signers/lighter/LighterKeyStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LighterKeyStore.js","sourceRoot":"","sources":["../../../../src/signers/lighter/LighterKeyStore.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,kBAAkB;AAClB,EAAE;AACF,0EAA0E;AAC1E,8EAA8E;AAC9E,6EAA6E;AAC7E,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,8EAA8E;AAE9E,MAAM,cAAc,GAAG,wBAAwB,CAAA;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAatC,MAAM,OAAO,eAAe;IACT,OAAO,CAAgB;IACvB,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAA;IAEzD,YAAY,OAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEO,UAAU,CAAC,OAAgB;QACjC,OAAO,GAAG,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAA;IACrD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAgB;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAA;QACf,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAkB,CAAA;QAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC3B,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAgB,EAAE,KAAoB;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAgB;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAChC,CAAC;CACF"}

package/dist/esm/signers/lighter/LighterReadOnlyTokenManager.d.ts

@@ -0,0 +1,174 @@
+import type { Address, ApproveReadOnlyTokenParams, LighterAccountConfig } from '@lifi/perps-types';
+import type { Account, WalletClient } from 'viem';
+import type { StorageAdapter } from '../../agent/types.js';
+/**
+ * Default Lighter HTTP host the SDK posts the mint request to. Callers
+ * pointing at testnet pass an override via {@link LighterReadOnlyTokenManagerOptions.lighterApiUrl}.
+ */
+export declare const DEFAULT_LIGHTER_API_URL = "https://mainnet.zklighter.elliot.ai";
+/**
+ * Default token name persisted alongside Lighter's `tokens/create` row.
+ * Lighter requires a non-empty `name` form field; the literal here is what
+ * surfaces in Lighter's UI listing under `app.lighter.xyz/read-only-tokens`.
+ */
+export declare const DEFAULT_READ_ONLY_TOKEN_NAME = "LI.FI Perps";
+/**
+ * Persisted shape of a Lighter read-only token. The `token` string is
+ * Lighter's opaque `ro:{accountIndex}:{scope}:{expiry}:{rand}` bearer; the
+ * SDK never parses it — `expiry`/`scope`/`accountIndex` are mint-time inputs
+ * we keep alongside so consumers can render expiry UX without re-fetching.
+ */
+export interface LighterReadOnlyToken {
+    /** Opaque bearer string — never parse client-side. */
+    token: string;
+    /** Unix seconds. The SDK's source of truth for expiry. */
+    expiry: number;
+    /** Lighter's `single | all` scope literal recorded at mint time. */
+    scope: 'single' | 'all';
+    /** Lighter L2 account index the token authorises. */
+    accountIndex: number;
+}
+/**
+ * Lighter `POST /api/v1/tokens/create` response shape (subset). Lighter's
+ * OpenAPI documents additional fields (`token_id`, `name`, `revoked`, etc.)
+ * we don't need client-side.
+ */
+export interface LighterCreateTokenResponse {
+    api_token: string;
+    account_index: number;
+    expiry: number;
+    scopes: string;
+}
+/**
+ * Function injected for the HTTP boundary against Lighter's `tokens/create`
+ * endpoint. Returning a parsed {@link LighterCreateTokenResponse} keeps the
+ * mint code free of fetch/multipart plumbing and lets tests drop a fixture
+ * in without spinning a mock server.
+ */
+export type LighterTokenFetcher = (params: {
+    url: string;
+    authorization: string;
+    name: string;
+    accountIndex: number;
+    expiry: number;
+    subAccountAccess: boolean;
+    scopes: string;
+}) => Promise<LighterCreateTokenResponse>;
+/**
+ * Function injected for the L1 wallet signature. Signature MUST be EIP-191
+ * `personal_sign`. Returning a 0x-prefixed hex string keeps the mint path
+ * agnostic to whichever wallet abstraction the consumer wires up.
+ */
+export type LighterWalletSigner = (params: {
+    address: Address;
+    message: string;
+}) => Promise<string>;
+export interface LighterReadOnlyTokenManagerOptions {
+    storage?: StorageAdapter;
+    /** Lighter API host. Defaults to {@link DEFAULT_LIGHTER_API_URL}. */
+    lighterApiUrl?: string;
+    /** Override the multipart POST. Defaults to a `fetch`-based implementation. */
+    fetcher?: LighterTokenFetcher;
+    /** Clock injection for testing expiry logic. Defaults to `Date.now`. */
+    now?: () => number;
+}
+export interface ApproveReadOnlyTokenInputs extends ApproveReadOnlyTokenParams {
+    /** L1 wallet address that signs the mint message. */
+    address: Address;
+}
+export interface ApproveReadOnlyTokenResult {
+    token: LighterReadOnlyToken;
+    /** Projection of the post-mint Lighter account state. */
+    config: Pick<LighterAccountConfig, 'provider' | 'accountIndex' | 'readOnlyTokenApproved' | 'readOnlyTokenExpiry' | 'readOnlyTokenScope'>;
+}
+/**
+ * Manage the per-account Lighter read-only token alongside the existing
+ * `(L1 address, account index)`-scoped storage adapter pattern. Mirrors
+ * `AgentManager`'s injection surface so the same `StorageAdapter` powers
+ * both. The token is opaque — never parsed client-side; `expiry`/`scope`
+ * recorded at mint time are the source of truth.
+ *
+ * The L1 wallet signer and the HTTP fetcher are both injectable so unit
+ * tests don't need a real wallet or network.
+ */
+export declare class LighterReadOnlyTokenManager {
+    private readonly storage;
+    private readonly lighterApiUrl;
+    private readonly fetcher;
+    private readonly now;
+    private readonly cache;
+    constructor(options?: LighterReadOnlyTokenManagerOptions);
+    private storageKey;
+    private isExpired;
+    /**
+     * Return the stored token for the `(address, accountIndex)` pair, or
+     * `undefined` if absent or past its `expiry`. Never surfaces an expired
+     * token — consumers can rely on the return value being usable as-is.
+     */
+    get(address: Address, accountIndex: number): Promise<LighterReadOnlyToken | undefined>;
+    /**
+     * `true` when a stored token exists AND its `expiry` falls within
+     * `thresholdDays` of now. `false` when no token exists, when the token is
+     * already expired (caller should treat that as "no token"), or when it
+     * has more than `thresholdDays` of life left.
+     */
+    isReadOnlyTokenExpiringSoon(address: Address, accountIndex: number, thresholdDays?: number): Promise<boolean>;
+    /**
+     * Persist `token` for the `(address, accountIndex)` pair. Overwrites any
+     * prior stored token under the same key — used both by the approve flow
+     * and by the renewal flow.
+     */
+    set(address: Address, accountIndex: number, token: LighterReadOnlyToken): Promise<void>;
+    remove(address: Address, accountIndex: number): Promise<void>;
+    /**
+     * Mint and persist a new Lighter read-only token.
+     *
+     * Asks `signer` to produce an EIP-191 `personal_sign` over the
+     * `createToken`-specific L1 message, POSTs the signed payload to Lighter's
+     * `/api/v1/tokens/create` via the injected `fetcher`, and persists the
+     * returned bearer alongside its `expiry`/`scope`/`accountIndex`.
+     *
+     * `expirySeconds` is the absolute unix-seconds expiry Lighter records on
+     * the row. Lighter enforces 1 day ≤ lifetime ≤ 10 years server-side; the
+     * SDK does NOT pre-validate and surfaces Lighter's 400 verbatim.
+     *
+     * `scope` defaults to `'all'` (token authorises read access to every
+     * account owned by the L1 signer). `'single'` is wired through so callers
+     * who need per-account scoping can opt in.
+     *
+     * @param signer EIP-191 wallet signer for the L1 message.
+     * @param inputs Token-mint parameters plus the L1 `address` that signs.
+     */
+    approve(signer: LighterWalletSigner, inputs: ApproveReadOnlyTokenInputs): Promise<ApproveReadOnlyTokenResult>;
+}
+/**
+ * Build the EIP-191 message the user's L1 wallet signs to authorise a
+ * Lighter `tokens/create` request.
+ *
+ * NOTE — Lighter's public docs do not fully specify the message template
+ * for the read-only token mint flow. The shape here is the SDK's best-fit
+ * given (a) Lighter's UI hosts the equivalent flow at
+ * `app.lighter.xyz/read-only-tokens` and (b) Lighter's `tokens/create`
+ * endpoint reads `account_index`, `expiry`, and `scopes` as form fields.
+ * If Lighter publishes a documented template that diverges, update this
+ * builder — the test fixtures will fail loudly.
+ */
+export declare function buildReadOnlyTokenMessage(params: {
+    accountIndex: number;
+    expirySeconds: number;
+    scope: 'single' | 'all';
+}): string;
+/**
+ * Default fetcher: posts a multipart/form-data request to Lighter's
+ * `tokens/create` endpoint and returns the parsed response. Throws a
+ * {@link PerpsError} with the Lighter-side body when the response is
+ * non-2xx.
+ */
+export declare const defaultLighterTokenFetcher: LighterTokenFetcher;
+/**
+ * Adapter producing a {@link LighterWalletSigner} from a viem
+ * `WalletClient`. Pulled out so `PerpsClient.approveReadOnlyToken` can call
+ * into the manager without leaking viem types past the manager's boundary.
+ */
+export declare function walletClientSigner(client: WalletClient<any, any, Account>): LighterWalletSigner;
+//# sourceMappingURL=LighterReadOnlyTokenManager.d.ts.map

package/dist/esm/signers/lighter/LighterReadOnlyTokenManager.d.ts.map

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