@lifi/perps-sdk 0.1.1-alpha.0

package/dist/types/client/PerpsClient.d.ts

@@ -0,0 +1,188 @@
+import type { Address, AuthorizationsResponse, CancelOrderPayloadResponse, CreateAuthorizationResponse, CreateOrderResponse, SubmitOrderResponse } from '@lifi/perps-types';
+import type { SubmitAuthorizationParams } from '../services/submitAuthorization.js';
+import type { SubmitOrderParams } from '../services/submitOrder.js';
+import { type PerpsSDKClient } from './createPerpsClient.js';
+import type { BuildAuthorizationParams, CancelOrdersParams, ExecuteAuthorizationsParams, ExecuteAuthorizationsResult, GetRequiredAuthorizationsParams, PerpsClientOptions, PlaceOrderParams, RequiredAuthorizationsResult, SigningMode } from './types.js';
+/**
+ * Stateful client for managing signing modes and trading operations.
+ *
+ * The PerpsClient provides two signing modes:
+ * - `USER`: User wallet signs each action (wallet popup per action)
+ * - `USER_AGENT`: SDK-generated agent signs actions (no popups after setup)
+ *
+ * In `USER_AGENT` mode, the client:
+ * - Generates an agent keypair stored in localStorage (or custom storage)
+ * - Auto-injects agent address into authorization requests
+ * - Auto-signs trading actions with the agent key
+ *
+ * @example
+ * ```ts
+ * const perps = new PerpsClient({ integrator: 'my-app' })
+ *
+ * // Set up agent signing for a user + DEX pair
+ * await perps.setSigningMode(userAddress, 'hyperliquid', 'USER_AGENT')
+ *
+ * // Build authorization (agent address auto-injected)
+ * const { actions } = await perps.buildAuthorization({
+ *   dex: 'hyperliquid',
+ *   address: userAddress,
+ *   authorizations: [
+ *     { key: 'ApproveAgent' },
+ *     { key: 'ApproveBuilderFee' }
+ *   ]
+ * })
+ *
+ * // ... sign actions with user wallet ...
+ *
+ * // Place orders (agent signs automatically)
+ * const result = await perps.placeOrder({
+ *   address: userAddress,
+ *   dex: 'hyperliquid',
+ *   symbol: 'BTC',
+ *   side: 'BUY',
+ *   type: 'MARKET',
+ *   size: '0.1',
+ *   price: '95000.00'
+ * })
+ * ```
+ */
+export declare class PerpsClient {
+    private sdkClient;
+    private signingModes;
+    constructor(options: PerpsClientOptions);
+    /**
+     * Get the underlying SDK client for use with service functions.
+     */
+    get client(): PerpsSDKClient;
+    /**
+     * Promise that resolves when the API health check passes.
+     * Await this before making requests if you need to handle readiness explicitly.
+     */
+    get ready(): Promise<void>;
+    /**
+     * Get the storage key for a user + DEX pair.
+     */
+    private modeKey;
+    /**
+     * Set the signing mode for a user + DEX pair.
+     *
+     * In `USER_AGENT` mode, generates an agent keypair if one doesn't exist.
+     *
+     * @param address - User wallet address
+     * @param dex - DEX identifier
+     * @param mode - Signing mode to set
+     */
+    setSigningMode(address: Address, dex: string, mode: SigningMode): Promise<void>;
+    /**
+     * Get the current signing mode for a user + DEX pair.
+     * Defaults to `USER` if not set.
+     */
+    getSigningMode(address: Address, dex: string): SigningMode;
+    /**
+     * Get the agent address for a user + DEX pair.
+     *
+     * @throws {PerpsError} If in USER mode or agent not found
+     */
+    getAgentAddress(address: Address, dex: string): Promise<Address>;
+    /**
+     * Check if an agent exists for a user + DEX pair.
+     */
+    hasAgent(address: Address, dex: string): Promise<boolean>;
+    /**
+     * Remove the agent for a user + DEX pair.
+     * Also resets signing mode to USER.
+     */
+    removeAgent(address: Address, dex: string): Promise<void>;
+    /**
+     * Build authorization payloads for signing.
+     *
+     * In `USER` mode, `signerAddress` is omitted (backend defaults to `address`).
+     * In `USER_AGENT` mode, auto-injects the agent address as `signerAddress`
+     * and `agentAddress` param for `ApproveAgent` authorization.
+     *
+     * @param params - Authorization parameters
+     * @returns Authorization actions with typed data for signing
+     */
+    buildAuthorization(params: BuildAuthorizationParams): Promise<CreateAuthorizationResponse>;
+    /**
+     * Submit signed authorizations.
+     *
+     * In `USER` mode, `signerAddress` is omitted (backend defaults to `address`).
+     * In `USER_AGENT` mode, auto-injects the agent address as `signerAddress`.
+     *
+     * @param params - Signed authorization parameters
+     */
+    submitAuthorizations(params: SubmitAuthorizationParams): Promise<AuthorizationsResponse>;
+    /**
+     * Build order payloads for signing.
+     *
+     * In `USER` mode, `signerAddress` is omitted (backend defaults to `address`).
+     * In `USER_AGENT` mode, auto-injects the agent address as `signerAddress`.
+     *
+     * @param params - Order parameters
+     * @returns Order actions with typed data for signing
+     */
+    buildOrder(params: PlaceOrderParams): Promise<CreateOrderResponse>;
+    /**
+     * Build cancel order payloads for signing.
+     *
+     * In `USER` mode, `signerAddress` is omitted (backend defaults to `address`).
+     * In `USER_AGENT` mode, auto-injects the agent address as `signerAddress`.
+     *
+     * @param params - Cancel parameters
+     * @returns Cancel actions with typed data for signing
+     */
+    buildCancelOrder(params: CancelOrdersParams): Promise<CancelOrderPayloadResponse>;
+    /**
+     * Place an order with automatic agent signing.
+     *
+     * **Requires USER_AGENT mode.** For USER mode, use `buildOrder()` + `submitSignedOrder()`.
+     *
+     * @param params - Order parameters
+     * @returns Order submission results
+     * @throws {PerpsError} If not in USER_AGENT mode
+     */
+    placeOrder(params: PlaceOrderParams): Promise<SubmitOrderResponse>;
+    /**
+     * Cancel orders with automatic agent signing.
+     *
+     * **Requires USER_AGENT mode.** For USER mode, use `buildCancelOrder()` + `submitSignedOrder()`.
+     *
+     * @param params - Cancel parameters
+     * @returns Cancel submission results
+     * @throws {PerpsError} If not in USER_AGENT mode
+     */
+    cancelOrders(params: CancelOrdersParams): Promise<SubmitOrderResponse>;
+    /**
+     * Submit pre-signed order actions.
+     *
+     * Use this for USER mode when you've already signed the actions with the user's wallet.
+     * Auto-injects `signerAddress` if not provided (defaults to `address`).
+     *
+     * @param params - Signed order parameters
+     */
+    submitSignedOrder(params: SubmitOrderParams): Promise<SubmitOrderResponse>;
+    /**
+     * Determine which authorizations (if any) the user needs to sign before trading.
+     *
+     * Fetches account state and checks the current signing mode to build
+     * a precise list of required authorizations.
+     *
+     * @param params - Parameters including dex, address, and asset requirements
+     * @returns Which authorizations are needed and whether the user is ready to trade
+     */
+    getRequiredAuthorizations(params: GetRequiredAuthorizationsParams): Promise<RequiredAuthorizationsResult>;
+    /**
+     * Execute authorizations: submit user-signed actions, then auto-sign and submit
+     * any agent authorizations.
+     *
+     * @param params - User-signed actions and the required authorizations result
+     * @returns Combined results from user and agent submissions
+     */
+    executeAuthorizations(params: ExecuteAuthorizationsParams): Promise<ExecuteAuthorizationsResult>;
+    /**
+     * Check if the local agent is registered and valid on the backend.
+     */
+    private validateAgent;
+}
+//# sourceMappingURL=PerpsClient.d.ts.map

package/dist/types/client/PerpsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerpsClient.d.ts","sourceRoot":"","sources":["../../../src/client/PerpsClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAEP,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EAInB,mBAAmB,EACpB,MAAM,mBAAmB,CAAA;AAS1B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAA;AAEnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAGnE,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC/E,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,EAC/B,kBAAkB,EAClB,gBAAgB,EAChB,4BAA4B,EAC5B,WAAW,EACZ,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,YAAY,CAAsC;gBAE9C,OAAO,EAAE,kBAAkB;IAUvC;;OAEG;IACH,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzB;IAED;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf;;;;;;;;OAQG;IACG,cAAc,CAClB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW;IAI1D;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/D;;;;;;;;;OASG;IACG,kBAAkB,CACtB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,2BAA2B,CAAC;IA8BvC;;;;;;;OAOG;IACG,oBAAoB,CACxB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,sBAAsB,CAAC;IAelC;;;;;;;;OAQG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+BxE;;;;;;;;OAQG;IACG,gBAAgB,CACpB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,0BAA0B,CAAC;IAoBtC;;;;;;;;OAQG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoDxE;;;;;;;;OAQG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAyC5E;;;;;;;OAOG;IACG,iBAAiB,CACrB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAI/B;;;;;;;;OAQG;IACG,yBAAyB,CAC7B,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,4BAA4B,CAAC;IAoGxC;;;;;;OAMG;IACG,qBAAqB,CACzB,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,2BAA2B,CAAC;IA4DvC;;OAEG;YACW,aAAa;CAwB5B"}

package/dist/types/client/createPerpsClient.d.ts

@@ -0,0 +1,82 @@
+import { AgentManager } from '../agent/AgentManager.js';
+import type { StorageAdapter } from '../agent/types.js';
+/**
+ * Configuration options for creating a Perps SDK client.
+ */
+export interface PerpsConfig {
+    /** Integrator identifier (required) */
+    integrator: string;
+    /** Optional API key for authenticated requests */
+    apiKey?: string;
+    /** Base API URL. Defaults to https://li.quest/v1/perps */
+    apiUrl?: string;
+    /** Disable version update check in development mode */
+    disableVersionCheck?: boolean;
+    /** Custom storage adapter for agent keys. Defaults to localStorage. */
+    storage?: StorageAdapter;
+    /** Optional request interceptor for custom handling */
+    requestInterceptor?: RequestInterceptor;
+    /** Whether to perform a health check on startup before allowing requests. Default: true */
+    healthCheck?: boolean;
+}
+/**
+ * Resolved configuration with required fields.
+ */
+export interface PerpsBaseConfig {
+    /** Integrator identifier (required) */
+    integrator: string;
+    /** Optional API key for authenticated requests */
+    apiKey?: string;
+    /** Resolved API URL (always set) */
+    apiUrl: string;
+    /** Disable version update check in development mode */
+    disableVersionCheck?: boolean;
+    /** Optional request interceptor for custom handling */
+    requestInterceptor?: RequestInterceptor;
+    /** Promise that resolves when the API is ready. Requests wait for this. */
+    readyPromise?: Promise<void>;
+}
+/**
+ * Request interceptor function type.
+ * Called before each request is made, allowing modification of fetch options.
+ */
+export type RequestInterceptor = (url: string, options: RequestInit) => RequestInit | Promise<RequestInit>;
+/**
+ * Options passed to service functions for request control.
+ */
+export interface SDKRequestOptions {
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
+}
+/**
+ * The Perps SDK client instance.
+ * Holds configuration and agent manager for making API requests.
+ */
+export interface PerpsSDKClient {
+    /** SDK configuration */
+    readonly config: PerpsBaseConfig;
+    /** Agent manager for USER_AGENT signing mode */
+    readonly agentManager: AgentManager;
+    /** Promise that resolves when the API health check passes. */
+    readonly ready: Promise<void>;
+}
+/**
+ * Create a new Perps SDK client.
+ *
+ * @param options - Configuration options
+ * @returns A new SDK client instance
+ * @throws {PerpsError} If integrator is not provided
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({
+ *   integrator: 'my-app',
+ *   apiKey: 'optional-api-key',
+ * })
+ *
+ * // Use with service functions
+ * const { dexes } = await getDexes(client)
+ * ```
+ */
+export declare function createPerpsClient(options: PerpsConfig): PerpsSDKClient;
+//# sourceMappingURL=createPerpsClient.d.ts.map

package/dist/types/client/createPerpsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPerpsClient.d.ts","sourceRoot":"","sources":["../../../src/client/createPerpsClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AASvD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,uEAAuE;IACvE,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,2FAA2F;IAC3F,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,KACjB,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAEvC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAqCtE"}

package/dist/types/client/types.d.ts

@@ -0,0 +1,131 @@
+import type { Address, AuthorizationInput, AuthorizationsResponse, OrderSide, OrderType, SignedAuthorization, TimeInForce, TriggerOrderInput } from '@lifi/perps-types';
+import type { StorageAdapter } from '../agent/types.js';
+export type { PerpsBaseConfig, PerpsConfig, PerpsSDKClient, RequestInterceptor, SDKRequestOptions, } from './createPerpsClient.js';
+/**
+ * Signing mode determines who signs trading actions.
+ *
+ * - `USER`: User wallet signs each action (requires wallet popup per action)
+ * - `USER_AGENT`: SDK-generated agent signs actions (no popups after initial setup)
+ */
+export type SigningMode = 'USER' | 'USER_AGENT';
+/**
+ * Options for PerpsClient constructor.
+ */
+export interface PerpsClientOptions {
+    /** Integrator identifier (required) */
+    integrator: string;
+    /** Optional API key for authenticated requests */
+    apiKey?: string;
+    /** Base API URL. Defaults to https://li.quest/v1/perps */
+    apiUrl?: string;
+    /** Custom storage adapter for agent keys. Defaults to localStorage. */
+    storage?: StorageAdapter;
+    /** Whether to perform a health check on startup before allowing requests. Default: true */
+    healthCheck?: boolean;
+}
+/**
+ * Parameters for building authorization payloads.
+ */
+export interface BuildAuthorizationParams {
+    /** DEX to authorize */
+    dex: string;
+    /** User wallet address */
+    address: Address;
+    /** Address of the signer (auto-set in USER_AGENT mode) */
+    signerAddress?: Address;
+    /** Authorizations to create */
+    authorizations: AuthorizationInput[];
+}
+/**
+ * Parameters for placing an order.
+ */
+export interface PlaceOrderParams {
+    /** DEX to place order on */
+    dex: string;
+    /** User wallet address */
+    address: Address;
+    /** Client-provided order ID */
+    clientOrderId?: string;
+    /** Market symbol */
+    symbol: string;
+    /** Order side */
+    side: OrderSide;
+    /** Order type */
+    type: OrderType;
+    /** Order size */
+    size: string;
+    /** Order price */
+    price: string;
+    /** Leverage */
+    leverage?: number;
+    /** Reduce only flag */
+    reduceOnly?: boolean;
+    /** Time in force */
+    timeInForce?: TimeInForce;
+    /** Expiration time */
+    expiresAt?: string;
+    /** Take profit trigger */
+    takeProfit?: TriggerOrderInput;
+    /** Stop loss trigger */
+    stopLoss?: TriggerOrderInput;
+}
+/**
+ * Parameters for canceling orders.
+ */
+export interface CancelOrdersParams {
+    /** DEX to cancel orders on */
+    dex: string;
+    /** User wallet address */
+    address: Address;
+    /** Order IDs to cancel */
+    ids: string[];
+}
+/**
+ * Parameters for getRequiredAuthorizations().
+ */
+export interface GetRequiredAuthorizationsParams {
+    /** DEX to check authorizations for */
+    dex: string;
+    /** User wallet address */
+    address: Address;
+    /** Whether to require abstraction (for HIP-3 assets). Default: false */
+    requireAbstraction?: boolean;
+}
+/**
+ * Result from getRequiredAuthorizations().
+ */
+export interface RequiredAuthorizationsResult {
+    /** Authorizations requiring user wallet signature (0, 1, or 2 items) */
+    userAuthorizations: AuthorizationInput[];
+    /** Authorizations the SDK auto-signs with the agent after user auths are submitted */
+    agentAuthorizations: AuthorizationInput[];
+    /** Whether the local agent is registered and valid on the backend */
+    agentValid: boolean;
+    /** The raw abstractionStatus from config (null=never set, 'disabled', 'unifiedAccount', 'portfolioMargin') */
+    abstractionStatus: string | null;
+    /** Whether all authorizations are already satisfied (ready to trade) */
+    isReady: boolean;
+}
+/**
+ * Parameters for executeAuthorizations().
+ */
+export interface ExecuteAuthorizationsParams {
+    /** DEX to authorize */
+    dex: string;
+    /** User wallet address */
+    address: Address;
+    /** The result from getRequiredAuthorizations() */
+    required: RequiredAuthorizationsResult;
+    /** User-signed actions corresponding to required.userAuthorizations */
+    userSignedActions: SignedAuthorization[];
+}
+/**
+ * Result from executeAuthorizations().
+ */
+export interface ExecuteAuthorizationsResult {
+    /** Results from user-signed authorization submission */
+    userResults: AuthorizationsResponse;
+    /** Results from agent-signed authorization submission (if any) */
+    agentResults?: AuthorizationsResponse;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/types/errors/AgentError.d.ts

@@ -0,0 +1,25 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsErrorName } from './constants.js';
+import { PerpsError } from './PerpsError.js';
+/**
+ * Error thrown when agent-related operations fail (agent not found, authorization issues, etc.)
+ */
+export declare class AgentError extends PerpsError {
+    name: PerpsErrorName;
+    constructor(message: string, code?: PerpsErrorCode);
+    /**
+     * Create an AgentError for a missing agent.
+     *
+     * @param address - The user address
+     * @param dex - The DEX identifier
+     */
+    static notFound(address: string, dex: string): AgentError;
+    /**
+     * Create an AgentError for an unauthorized agent.
+     *
+     * @param address - The agent address
+     * @param dex - The DEX identifier
+     */
+    static unauthorized(address: string, dex: string): AgentError;
+}
+//# sourceMappingURL=AgentError.d.ts.map

package/dist/types/errors/AgentError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentError.d.ts","sourceRoot":"","sources":["../../../src/errors/AgentError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;GAEG;AACH,qBAAa,UAAW,SAAQ,UAAU;IAC/B,IAAI,iBAA4B;gBAE7B,OAAO,EAAE,MAAM,EAAE,IAAI,iBAAmC;IAQpE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU;IAMzD;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU;CAK9D"}

package/dist/types/errors/HTTPError.d.ts

@@ -0,0 +1,11 @@
+import type { PerpsErrorBody } from '@lifi/perps-types';
+import { PerpsError } from './PerpsError.js';
+export declare class HTTPError extends PerpsError {
+    response: Response;
+    status: number;
+    url: string;
+    responseBody?: PerpsErrorBody;
+    constructor(response: Response, url: string);
+    buildAdditionalDetails(): Promise<this>;
+}
+//# sourceMappingURL=HTTPError.d.ts.map

package/dist/types/errors/HTTPError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPError.d.ts","sourceRoot":"","sources":["../../../src/errors/HTTPError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AA6B5C,qBAAa,SAAU,SAAQ,UAAU;IACvC,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,CAAC,EAAE,cAAc,CAAA;gBAEjB,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IAYrC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB9C"}

package/dist/types/errors/PerpsError.d.ts

@@ -0,0 +1,9 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsErrorName } from './constants.js';
+export declare class PerpsError extends Error {
+    code: PerpsErrorCode;
+    name: PerpsErrorName;
+    constructor(code?: PerpsErrorCode, message?: string);
+    static fromError(error: unknown, defaultCode?: PerpsErrorCode): PerpsError;
+}
+//# sourceMappingURL=PerpsError.d.ts.map

package/dist/types/errors/PerpsError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerpsError.d.ts","sourceRoot":"","sources":["../../../src/errors/PerpsError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,qBAAa,UAAW,SAAQ,KAAK;IACnC,IAAI,EAAE,cAAc,CAAA;IACX,IAAI,iBAA4B;gBAGvC,IAAI,GAAE,cAA4C,EAClD,OAAO,SAA2B;IAQpC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,cAAc,GAAG,UAAU;CAe3E"}

package/dist/types/errors/PerpsSDKError.d.ts

@@ -0,0 +1,40 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+/**
+ * Top-level SDK error that wraps all other error types.
+ * This is the public-facing error type for the SDK.
+ *
+ * PerpsSDKError always includes:
+ * - A consistent error message format with SDK version
+ * - Access to the root cause error via the `cause` property
+ * - Stack trace preservation
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await getDexes(client)
+ * } catch (error) {
+ *   if (error instanceof PerpsSDKError) {
+ *     console.log(error.message) // [PerpsSDKError] message\nSDK version: X
+ *     console.log(error.cause)   // Original error
+ *     console.log(error.code)    // Numeric error code
+ *   }
+ * }
+ * ```
+ */
+export declare class PerpsSDKError extends Error {
+    name: string;
+    /** Numeric error code from PerpsErrorCode enum */
+    code: PerpsErrorCode;
+    /** Original cause of the error */
+    cause?: Error;
+    constructor(error: Error, message?: string);
+    /**
+     * Wrap any error in a PerpsSDKError.
+     *
+     * @param error - The error to wrap
+     * @param message - Optional custom message
+     * @returns PerpsSDKError instance
+     */
+    static wrap(error: unknown, message?: string): PerpsSDKError;
+}
+//# sourceMappingURL=PerpsSDKError.d.ts.map

package/dist/types/errors/PerpsSDKError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerpsSDKError.d.ts","sourceRoot":"","sources":["../../../src/errors/PerpsSDKError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAMlD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAC7B,IAAI,SAAuB;IAEpC,kDAAkD;IAClD,IAAI,EAAE,cAAc,CAAA;IAEpB,kCAAkC;IACzB,KAAK,CAAC,EAAE,KAAK,CAAA;gBAEV,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM;IAqB1C;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa;CAa7D"}

package/dist/types/errors/ServerError.d.ts

@@ -0,0 +1,23 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsErrorName } from './constants.js';
+import { PerpsError } from './PerpsError.js';
+/**
+ * Error thrown when server-side operations fail (network errors, timeouts, etc.)
+ */
+export declare class ServerError extends PerpsError {
+    name: PerpsErrorName;
+    constructor(message: string, code?: PerpsErrorCode);
+    /**
+     * Create a ServerError for a network failure.
+     *
+     * @param cause - The original error
+     */
+    static networkError(cause?: Error): ServerError;
+    /**
+     * Create a ServerError for a timeout.
+     *
+     * @param operation - The operation that timed out
+     */
+    static timeout(operation: string): ServerError;
+}
+//# sourceMappingURL=ServerError.d.ts.map

package/dist/types/errors/ServerError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerError.d.ts","sourceRoot":"","sources":["../../../src/errors/ServerError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IAChC,IAAI,iBAA6B;gBAE9B,OAAO,EAAE,MAAM,EAAE,IAAI,iBAA6B;IAQ9D;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,WAAW;IAK/C;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;CAM/C"}

package/dist/types/errors/ValidationError.d.ts

@@ -0,0 +1,23 @@
+import { PerpsErrorName } from './constants.js';
+import { PerpsError } from './PerpsError.js';
+/**
+ * Error thrown when validation fails (invalid parameters, missing required fields, etc.)
+ */
+export declare class ValidationError extends PerpsError {
+    name: PerpsErrorName;
+    constructor(message: string);
+    /**
+     * Create a ValidationError from a validation failure.
+     *
+     * @param field - The field that failed validation
+     * @param reason - The reason for validation failure
+     */
+    static field(field: string, reason: string): ValidationError;
+    /**
+     * Create a ValidationError for a missing required field.
+     *
+     * @param field - The name of the missing field
+     */
+    static required(field: string): ValidationError;
+}
+//# sourceMappingURL=ValidationError.d.ts.map

package/dist/types/errors/ValidationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.d.ts","sourceRoot":"","sources":["../../../src/errors/ValidationError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IACpC,IAAI,iBAAiC;gBAElC,OAAO,EAAE,MAAM;IAQ3B;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe;IAI5D;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;CAGhD"}

package/dist/types/errors/constants.d.ts

@@ -0,0 +1,15 @@
+export declare enum PerpsErrorName {
+    PerpsError = "PerpsError",
+    HTTPError = "HTTPError",
+    ValidationError = "ValidationError",
+    ServerError = "ServerError",
+    ConfigError = "ConfigError",
+    AgentError = "AgentError"
+}
+export declare enum PerpsErrorMessage {
+    UnknownError = "Unknown error occurred.",
+    ConfigNotInitialized = "SDK not configured. Call createPerpsConfig() first.",
+    AgentNotFound = "Agent not found. Call setSigningMode() first.",
+    InvalidSigningMode = "Invalid signing mode for this operation."
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/errors/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA,oBAAY,cAAc;IACxB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,UAAU,eAAe;CAC1B;AAED,oBAAY,iBAAiB;IAC3B,YAAY,4BAA4B;IACxC,oBAAoB,wDAAwD;IAC5E,aAAa,kDAAkD;IAC/D,kBAAkB,6CAA6C;CAChE"}