@lifi/perps-sdk 0.1.1-alpha.0

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

@@ -0,0 +1,33 @@
+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;
+    /** Optional list of symbols to filter (e.g., ['BTC', 'ETH']) */
+    symbols?: string[];
+}
+/**
+ * Get current prices for markets.
+ *
+ * @param client - The SDK client instance
+ * @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 network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { prices } = await getPrices(client, { dex: 'hyperliquid' })
+ * console.log(prices) // { BTC: '95000.00', ETH: '3400.00', ... }
+ *
+ * // Filter by symbols
+ * const { prices } = await getPrices(client, {
+ *   dex: 'hyperliquid',
+ *   symbols: ['BTC', 'ETH']
+ * })
+ * ```
+ */
+export declare function getPrices(client: PerpsSDKClient, params: GetPricesParams, options?: SDKRequestOptions): Promise<PricesResponse>;
+//# sourceMappingURL=getPrices.d.ts.map

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

@@ -0,0 +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"}

package/dist/esm/services/getPrices.js

@@ -0,0 +1,32 @@
+import { buildUrl, request } from '../utils/request.js';
+/**
+ * Get current prices for markets.
+ *
+ * @param client - The SDK client instance
+ * @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 network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { prices } = await getPrices(client, { dex: 'hyperliquid' })
+ * console.log(prices) // { BTC: '95000.00', ETH: '3400.00', ... }
+ *
+ * // Filter by symbols
+ * const { prices } = await getPrices(client, {
+ *   dex: 'hyperliquid',
+ *   symbols: ['BTC', 'ETH']
+ * })
+ * ```
+ */
+export async function getPrices(client, params, options) {
+    const url = buildUrl(`${client.config.apiUrl}/prices`, {
+        dex: params.dex,
+        symbols: params.symbols?.join(','),
+    });
+    return request(client.config, url, {}, options);
+}
+//# sourceMappingURL=getPrices.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,42 @@
+import type { Address, AuthorizationsResponse, SignedAuthorization } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface SubmitAuthorizationParams {
+    /** DEX to authorize (e.g., 'hyperliquid') */
+    dex: string;
+    /** Wallet address */
+    address: Address;
+    /** Address of the signer (for agent mode, this is the agent address) */
+    signerAddress?: Address;
+    /** Signed authorization actions */
+    actions: SignedAuthorization[];
+}
+/**
+ * Submit signed authorizations to the DEX.
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Results for each authorization action
+ * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { results } = await submitAuthorization(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   actions: signedActions
+ * })
+ *
+ * for (const result of results) {
+ *   if (result.success) {
+ *     console.log(`${result.action} authorized`)
+ *   } else {
+ *     console.error(`${result.action} failed: ${result.error}`)
+ *   }
+ * }
+ * ```
+ */
+export declare function submitAuthorization(client: PerpsSDKClient, params: SubmitAuthorizationParams, options?: SDKRequestOptions): Promise<AuthorizationsResponse>;
+//# sourceMappingURL=submitAuthorization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submitAuthorization.d.ts","sourceRoot":"","sources":["../../../src/services/submitAuthorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,mCAAmC;IACnC,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAejC"}

package/dist/esm/services/submitAuthorization.js

@@ -0,0 +1,41 @@
+import { request } from '../utils/request.js';
+/**
+ * Submit signed authorizations to the DEX.
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Results for each authorization action
+ * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { results } = await submitAuthorization(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   actions: signedActions
+ * })
+ *
+ * for (const result of results) {
+ *   if (result.success) {
+ *     console.log(`${result.action} authorized`)
+ *   } else {
+ *     console.error(`${result.action} failed: ${result.error}`)
+ *   }
+ * }
+ * ```
+ */
+export async function submitAuthorization(client, params, options) {
+    return request(client.config, `${client.config.apiUrl}/authorization`, {
+        method: 'POST',
+        body: JSON.stringify({
+            dex: params.dex,
+            address: params.address,
+            signerAddress: params.signerAddress,
+            actions: params.actions,
+        }),
+    }, options);
+}
+//# sourceMappingURL=submitAuthorization.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submitAuthorization.js","sourceRoot":"","sources":["../../../src/services/submitAuthorization.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAa7C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAsB,EACtB,MAAiC,EACjC,OAA2B;IAE3B,OAAO,OAAO,CACZ,MAAM,CAAC,MAAM,EACb,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,gBAAgB,EACvC;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;KACH,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { Address, SignedOrderAction, SubmitOrderResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface SubmitOrderParams {
+    /** DEX to submit order to (e.g., 'hyperliquid') */
+    dex: string;
+    /** Wallet address */
+    address: Address;
+    /** Address of the signer (for agent mode, this is the agent address) */
+    signerAddress?: Address;
+    /** Signed order actions */
+    actions: SignedOrderAction[];
+}
+/**
+ * Submit signed order actions to the DEX.
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Results for each order action
+ * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ *
+ * // After creating and signing order actions
+ * const { results } = await submitOrder(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   actions: signedActions
+ * })
+ *
+ * for (const result of results) {
+ *   if (result.success) {
+ *     console.log(`Order placed: ${result.orderId}`)
+ *   } else {
+ *     console.error(`Order failed: ${result.error}`)
+ *   }
+ * }
+ * ```
+ */
+export declare function submitOrder(client: PerpsSDKClient, params: SubmitOrderParams, options?: SDKRequestOptions): Promise<SubmitOrderResponse>;
+//# sourceMappingURL=submitOrder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submitOrder.d.ts","sourceRoot":"","sources":["../../../src/services/submitOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,2BAA2B;IAC3B,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAe9B"}

package/dist/esm/services/submitOrder.js

@@ -0,0 +1,43 @@
+import { request } from '../utils/request.js';
+/**
+ * Submit signed order actions to the DEX.
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Results for each order action
+ * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ *
+ * // After creating and signing order actions
+ * const { results } = await submitOrder(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   actions: signedActions
+ * })
+ *
+ * for (const result of results) {
+ *   if (result.success) {
+ *     console.log(`Order placed: ${result.orderId}`)
+ *   } else {
+ *     console.error(`Order failed: ${result.error}`)
+ *   }
+ * }
+ * ```
+ */
+export async function submitOrder(client, params, options) {
+    return request(client.config, `${client.config.apiUrl}/order`, {
+        method: 'POST',
+        body: JSON.stringify({
+            dex: params.dex,
+            address: params.address,
+            signerAddress: params.signerAddress,
+            actions: params.actions,
+        }),
+    }, options);
+}
+//# sourceMappingURL=submitOrder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submitOrder.js","sourceRoot":"","sources":["../../../src/services/submitOrder.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAa7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAsB,EACtB,MAAyB,EACzB,OAA2B;IAE3B,OAAO,OAAO,CACZ,MAAM,CAAC,MAAM,EACb,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,QAAQ,EAC/B;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;KACH,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/utils/request.d.ts

@@ -0,0 +1,26 @@
+import type { PerpsBaseConfig, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface RequestOptions extends RequestInit {
+    /** Number of retries on 5xx errors. Default: 1 */
+    retries?: number;
+}
+/**
+ * Make an HTTP request to the Perps API.
+ *
+ * @param config - SDK configuration
+ * @param url - The full URL to request
+ * @param options - Fetch options plus retries
+ * @param sdkOptions - SDK-specific options (signal, etc.)
+ * @returns Parsed JSON response
+ * @throws {HTTPError} On non-2xx responses
+ * @throws {PerpsError} On network or parsing errors
+ */
+export declare function request<T>(config: PerpsBaseConfig, url: string, options?: RequestOptions, sdkOptions?: SDKRequestOptions): Promise<T>;
+/**
+ * Build a URL with query parameters.
+ *
+ * @param baseUrl - The base URL
+ * @param params - Query parameters (undefined values are filtered out)
+ * @returns Full URL with query string
+ */
+export declare function buildUrl(baseUrl: string, params: Record<string, string | number | boolean | undefined>): string;
+//# sourceMappingURL=request.d.ts.map

package/dist/esm/utils/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/utils/request.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAMvC,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,EAC5B,UAAU,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,CAAC,CAAC,CAgEZ;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC5D,MAAM,CAWR"}

package/dist/esm/utils/request.js

@@ -0,0 +1,82 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { HTTPError } from '../errors/HTTPError.js';
+import { PerpsError } from '../errors/PerpsError.js';
+import { version } from '../version.js';
+import { sleep } from './sleep.js';
+const DEFAULT_RETRIES = 1;
+/**
+ * Make an HTTP request to the Perps API.
+ *
+ * @param config - SDK configuration
+ * @param url - The full URL to request
+ * @param options - Fetch options plus retries
+ * @param sdkOptions - SDK-specific options (signal, etc.)
+ * @returns Parsed JSON response
+ * @throws {HTTPError} On non-2xx responses
+ * @throws {PerpsError} On network or parsing errors
+ */
+export async function request(config, url, options = {}, sdkOptions) {
+    // Wait for API health check to pass before making requests
+    if (config.readyPromise) {
+        await config.readyPromise;
+    }
+    const retries = options.retries ?? DEFAULT_RETRIES;
+    const headers = {
+        'Content-Type': 'application/json',
+        'x-lifi-integrator': config.integrator,
+        'x-lifi-perps-sdk': version,
+        ...options.headers,
+    };
+    if (config.apiKey) {
+        headers['x-lifi-api-key'] = config.apiKey;
+    }
+    // Merge signal from sdkOptions into options
+    let finalOptions = {
+        ...options,
+        headers,
+        signal: sdkOptions?.signal ?? options.signal,
+    };
+    // Apply request interceptor if configured
+    if (config.requestInterceptor) {
+        finalOptions = await config.requestInterceptor(url, finalOptions);
+    }
+    try {
+        const response = await fetch(url, finalOptions);
+        if (!response.ok) {
+            const error = new HTTPError(response, url);
+            await error.buildAdditionalDetails();
+            // Retry on 5xx errors
+            if (retries > 0 && response.status >= 500) {
+                await sleep(500);
+                return request(config, url, { ...options, retries: retries - 1 }, sdkOptions);
+            }
+            throw error;
+        }
+        return (await response.json());
+    }
+    catch (error) {
+        if (error instanceof HTTPError || error instanceof PerpsError) {
+            throw error;
+        }
+        // Network error or other fetch failure
+        throw new PerpsError(PerpsErrorCode.ServerError, error instanceof Error ? error.message : 'Request failed');
+    }
+}
+/**
+ * Build a URL with query parameters.
+ *
+ * @param baseUrl - The base URL
+ * @param params - Query parameters (undefined values are filtered out)
+ * @returns Full URL with query string
+ */
+export function buildUrl(baseUrl, params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            searchParams.set(key, String(value));
+        }
+    }
+    const queryString = searchParams.toString();
+    return queryString ? `${baseUrl}?${queryString}` : baseUrl;
+}
+//# sourceMappingURL=request.js.map

package/dist/esm/utils/request.js.map

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

package/dist/esm/utils/signTypedData.d.ts

@@ -0,0 +1,15 @@
+import type { Hex, PerpsTypedData } from '@lifi/perps-types';
+/**
+ * Sign EIP-712 typed data with a private key.
+ *
+ * @param privateKey - The private key to sign with
+ * @param typedData - The typed data to sign
+ * @returns The signature as a hex string
+ *
+ * @example
+ * ```ts
+ * const signature = await signTypedData(agentPrivateKey, typedData)
+ * ```
+ */
+export declare function signTypedData(privateKey: Hex, typedData: PerpsTypedData): Promise<Hex>;
+//# sourceMappingURL=signTypedData.d.ts.map

package/dist/esm/utils/signTypedData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signTypedData.d.ts","sourceRoot":"","sources":["../../../src/utils/signTypedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAG5D;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,GAAG,CAAC,CAYd"}

package/dist/esm/utils/signTypedData.js

@@ -0,0 +1,25 @@
+import { privateKeyToAccount } from 'viem/accounts';
+/**
+ * Sign EIP-712 typed data with a private key.
+ *
+ * @param privateKey - The private key to sign with
+ * @param typedData - The typed data to sign
+ * @returns The signature as a hex string
+ *
+ * @example
+ * ```ts
+ * const signature = await signTypedData(agentPrivateKey, typedData)
+ * ```
+ */
+export async function signTypedData(privateKey, typedData) {
+    const account = privateKeyToAccount(privateKey);
+    // viem's signTypedData expects the typed data in a specific format
+    const signature = await account.signTypedData({
+        domain: typedData.domain,
+        types: typedData.types,
+        primaryType: typedData.primaryType,
+        message: typedData.message,
+    });
+    return signature;
+}
+//# sourceMappingURL=signTypedData.js.map

package/dist/esm/utils/signTypedData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signTypedData.js","sourceRoot":"","sources":["../../../src/utils/signTypedData.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAe,EACf,SAAyB;IAEzB,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAA;IAE/C,mEAAmE;IACnE,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC;QAC5C,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,OAAO,EAAE,SAAS,CAAC,OAAO;KAC3B,CAAC,CAAA;IAEF,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/esm/utils/sleep.d.ts

@@ -0,0 +1,2 @@
+export declare const sleep: (ms: number) => Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/esm/utils/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACI,CAAA"}

package/dist/esm/utils/sleep.js

@@ -0,0 +1,2 @@
+export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+//# sourceMappingURL=sleep.js.map

package/dist/esm/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA"}

package/dist/esm/version.d.ts

@@ -0,0 +1,3 @@
+export declare const name = "@lifi/perps-sdk";
+export declare const version = "0.1.1-alpha.0";
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,oBAAoB,CAAA;AACrC,eAAO,MAAM,OAAO,kBAAkB,CAAA"}

package/dist/esm/version.js

@@ -0,0 +1,3 @@
+export const name = '@lifi/perps-sdk';
+export const version = '0.1.1-alpha.0';
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,iBAAiB,CAAA;AACrC,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAA"}

package/dist/types/agent/AgentManager.d.ts

@@ -0,0 +1,45 @@
+import type { Address, Hex } from '@lifi/perps-types';
+import type { Agent, StorageAdapter } from './types.js';
+/**
+ * Manages agent keypairs for USER_AGENT signing mode.
+ * Agent keys are stored per user address + DEX combination.
+ */
+export declare class AgentManager {
+    private storage;
+    private cache;
+    constructor(storage?: StorageAdapter);
+    /**
+     * Get the storage key for an agent.
+     */
+    private storageKey;
+    /**
+     * Get an existing agent for a user + DEX pair.
+     *
+     * @throws {PerpsError} If agent not found
+     */
+    getAgent(address: Address, dex: string): Promise<Agent>;
+    /**
+     * Get an existing agent or create a new one.
+     */
+    getOrCreateAgent(address: Address, dex: string): Promise<Agent>;
+    /**
+     * Check if an agent exists for a user + DEX pair.
+     */
+    hasAgent(address: Address, dex: string): Promise<boolean>;
+    /**
+     * Remove an agent for a user + DEX pair.
+     * Call this when the user revokes agent authorization.
+     */
+    removeAgent(address: Address, dex: string): Promise<void>;
+    /**
+     * Import an existing agent keypair.
+     * Useful for restoring from backup or using a specific key.
+     */
+    importAgent(address: Address, dex: string, privateKey: Hex): Promise<Agent>;
+    /**
+     * Clear all cached agents.
+     * Does not remove from storage.
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=AgentManager.d.ts.map

package/dist/types/agent/AgentManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentManager.d.ts","sourceRoot":"","sources":["../../../src/agent/AgentManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAMrD,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAIvD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAAgC;gBAEjC,OAAO,CAAC,EAAE,cAAc;IAIpC;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAuB7D;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAsBrE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/D;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D;;;OAGG;IACG,WAAW,CACf,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,KAAK,CAAC;IAejB;;;OAGG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/types/agent/storage.d.ts

@@ -0,0 +1,12 @@
+import type { StorageAdapter } from './types.js';
+/**
+ * localStorage adapter for browser environments.
+ * Agent keys are stored as JSON strings with the key pattern:
+ * `lifi-perps-agent:{address}:{dex}`
+ */
+export declare const localStorageAdapter: StorageAdapter;
+/**
+ * In-memory storage adapter for testing or server-side use.
+ */
+export declare function createMemoryStorage(): StorageAdapter;
+//# sourceMappingURL=storage.d.ts.map

package/dist/types/agent/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/agent/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,cA2BjC,CAAA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAkBpD"}

package/dist/types/agent/types.d.ts

@@ -0,0 +1,23 @@
+import type { Address, Hex } from '@lifi/perps-types';
+/**
+ * Agent keypair for signing trading actions.
+ */
+export interface Agent {
+    /** Agent wallet address */
+    address: Address;
+    /** Agent private key */
+    privateKey: Hex;
+}
+/**
+ * Storage adapter interface for persisting agent keys.
+ * Implement this interface to use custom storage (e.g., encrypted storage, database).
+ */
+export interface StorageAdapter {
+    /** Get a value by key */
+    get(key: string): Promise<string | null>;
+    /** Set a value by key */
+    set(key: string, value: string): Promise<void>;
+    /** Remove a value by key */
+    remove(key: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,wBAAwB;IACxB,UAAU,EAAE,GAAG,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACxC,yBAAyB;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,4BAA4B;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC"}