@lifi/perps-sdk 0.1.1-alpha.0

package/dist/esm/client/createPerpsClient.js

@@ -0,0 +1,80 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { AgentManager } from '../agent/AgentManager.js';
+import { PerpsErrorName } from '../errors/constants.js';
+import { PerpsError } from '../errors/PerpsError.js';
+import { sleep } from '../utils/sleep.js';
+const DEFAULT_API_URL = 'https://li.quest/v1/perps';
+const HEALTH_POLL_INTERVAL_MS = 500;
+const HEALTH_MAX_ATTEMPTS = 50;
+/**
+ * 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 function createPerpsClient(options) {
+    if (!options.integrator) {
+        const error = new PerpsError(PerpsErrorCode.ValidationError, 'Integrator is required. Please see documentation at https://docs.li.fi');
+        error.name = PerpsErrorName.ValidationError;
+        throw error;
+    }
+    const apiUrl = options.apiUrl ?? DEFAULT_API_URL;
+    const readyPromise = options.healthCheck !== false ? pollHealth(apiUrl) : Promise.resolve();
+    const config = {
+        integrator: options.integrator,
+        apiKey: options.apiKey,
+        apiUrl,
+        disableVersionCheck: options.disableVersionCheck,
+        requestInterceptor: options.requestInterceptor,
+        readyPromise,
+    };
+    const agentManager = new AgentManager(options.storage);
+    return {
+        get config() {
+            return config;
+        },
+        get agentManager() {
+            return agentManager;
+        },
+        get ready() {
+            return readyPromise;
+        },
+    };
+}
+/**
+ * Poll the API health endpoint until it returns a successful response.
+ *
+ * Derives the health URL from the apiUrl origin (e.g. https://li.quest/health/live).
+ * Retries up to {@link HEALTH_MAX_ATTEMPTS} times with {@link HEALTH_POLL_INTERVAL_MS} delays.
+ *
+ * @throws {PerpsError} If the health endpoint does not respond after all attempts
+ */
+async function pollHealth(apiUrl) {
+    const healthUrl = `${new URL(apiUrl).origin}/health/live`;
+    for (let i = 0; i < HEALTH_MAX_ATTEMPTS; i++) {
+        try {
+            const response = await fetch(healthUrl);
+            if (response.ok) {
+                return;
+            }
+        }
+        catch {
+            // Server not reachable yet, retry
+        }
+        await sleep(HEALTH_POLL_INTERVAL_MS);
+    }
+    throw new PerpsError(PerpsErrorCode.ServerError, 'API health check failed: server did not become ready');
+}
+//# sourceMappingURL=createPerpsClient.js.map

package/dist/esm/client/createPerpsClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPerpsClient.js","sourceRoot":"","sources":["../../../src/client/createPerpsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAEzC,MAAM,eAAe,GAAG,2BAA2B,CAAA;AACnD,MAAM,uBAAuB,GAAG,GAAG,CAAA;AACnC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AAsE9B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAoB;IACpD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,UAAU,CAC1B,cAAc,CAAC,eAAe,EAC9B,wEAAwE,CACzE,CAAA;QACD,KAAK,CAAC,IAAI,GAAG,cAAc,CAAC,eAAe,CAAA;QAC3C,MAAM,KAAK,CAAA;IACb,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe,CAAA;IAEhD,MAAM,YAAY,GAChB,OAAO,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;IAExE,MAAM,MAAM,GAAoB;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM;QACN,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,YAAY;KACb,CAAA;IAED,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAEtD,OAAO;QACL,IAAI,MAAM;YACR,OAAO,MAAM,CAAA;QACf,CAAC;QACD,IAAI,YAAY;YACd,OAAO,YAAY,CAAA;QACrB,CAAC;QACD,IAAI,KAAK;YACP,OAAO,YAAY,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,UAAU,CAAC,MAAc;IACtC,MAAM,SAAS,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,cAAc,CAAA;IAEzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,mBAAmB,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAA;YACvC,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAM;YACR,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QACD,MAAM,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACtC,CAAC;IAED,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,WAAW,EAC1B,sDAAsD,CACvD,CAAA;AACH,CAAC"}

package/dist/esm/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/esm/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/esm/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/esm/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/esm/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/esm/errors/AgentError.js

@@ -0,0 +1,35 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { version } from '../version.js';
+import { PerpsErrorName } from './constants.js';
+import { PerpsError } from './PerpsError.js';
+/**
+ * Error thrown when agent-related operations fail (agent not found, authorization issues, etc.)
+ */
+export class AgentError extends PerpsError {
+    name = PerpsErrorName.AgentError;
+    constructor(message, code = PerpsErrorCode.AgentUnauthorized) {
+        super(code, message);
+        this.name = PerpsErrorName.AgentError;
+        // Override message format
+        this.message = `[${PerpsErrorName.AgentError}] ${message}\nLI.FI Perps SDK version: ${version}`;
+    }
+    /**
+     * Create an AgentError for a missing agent.
+     *
+     * @param address - The user address
+     * @param dex - The DEX identifier
+     */
+    static notFound(address, dex) {
+        return new AgentError(`Agent not found for ${address} on ${dex}. Call setSigningMode() first.`);
+    }
+    /**
+     * Create an AgentError for an unauthorized agent.
+     *
+     * @param address - The agent address
+     * @param dex - The DEX identifier
+     */
+    static unauthorized(address, dex) {
+        return new AgentError(`Agent ${address} is not authorized on ${dex}. Submit authorization first.`);
+    }
+}
+//# sourceMappingURL=AgentError.js.map

package/dist/esm/errors/AgentError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentError.js","sourceRoot":"","sources":["../../../src/errors/AgentError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IAC/B,IAAI,GAAG,cAAc,CAAC,UAAU,CAAA;IAEzC,YAAY,OAAe,EAAE,IAAI,GAAG,cAAc,CAAC,iBAAiB;QAClE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,UAAU,CAAA;QAErC,0BAA0B;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,UAAU,KAAK,OAAO,8BAA8B,OAAO,EAAE,CAAA;IACjG,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAe,EAAE,GAAW;QAC1C,OAAO,IAAI,UAAU,CACnB,uBAAuB,OAAO,OAAO,GAAG,gCAAgC,CACzE,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAe,EAAE,GAAW;QAC9C,OAAO,IAAI,UAAU,CACnB,SAAS,OAAO,yBAAyB,GAAG,+BAA+B,CAC5E,CAAA;IACH,CAAC;CACF"}

package/dist/esm/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/esm/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/esm/errors/HTTPError.js

@@ -0,0 +1,61 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsErrorName } from './constants.js';
+import { PerpsError } from './PerpsError.js';
+const statusCodeToErrorCode = new Map([
+    [400, PerpsErrorCode.ValidationError],
+    [401, PerpsErrorCode.SignatureInvalid],
+    [403, PerpsErrorCode.AgentUnauthorized],
+    [404, PerpsErrorCode.MarketNotFound],
+    [422, PerpsErrorCode.ValidationError],
+    [424, PerpsErrorCode.ThirdPartyError],
+    [429, PerpsErrorCode.ServerError],
+    [500, PerpsErrorCode.ServerError],
+    [502, PerpsErrorCode.ServerError],
+    [503, PerpsErrorCode.ServerError],
+    [504, PerpsErrorCode.TimeoutError],
+]);
+function getErrorCodeFromStatus(status) {
+    return statusCodeToErrorCode.get(status) ?? PerpsErrorCode.ServerError;
+}
+function createInitialMessage(response) {
+    const statusCode = response.status || response.status === 0 ? response.status : '';
+    const title = response.statusText || '';
+    const status = `${statusCode} ${title}`.trim();
+    const reason = status ? `status code ${status}` : 'an unknown error';
+    return `Request failed with ${reason}`;
+}
+export class HTTPError extends PerpsError {
+    response;
+    status;
+    url;
+    responseBody;
+    constructor(response, url) {
+        const code = getErrorCodeFromStatus(response.status);
+        const message = createInitialMessage(response);
+        super(code, message);
+        this.name = PerpsErrorName.HTTPError;
+        this.response = response;
+        this.status = response.status;
+        this.url = url;
+    }
+    async buildAdditionalDetails() {
+        try {
+            this.responseBody = (await this.response.json());
+            if (this.responseBody) {
+                // Update code from response body if available
+                if (this.responseBody.code) {
+                    this.code = this.responseBody.code;
+                }
+                // Append server message
+                if (this.responseBody.message) {
+                    this.message = `${this.message}. ${this.responseBody.message}`;
+                }
+            }
+        }
+        catch {
+            // Response body parsing failed - use defaults
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=HTTPError.js.map

package/dist/esm/errors/HTTPError.js.map

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

package/dist/esm/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/esm/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/esm/errors/PerpsError.js

@@ -0,0 +1,23 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { version } from '../version.js';
+import { PerpsErrorName } from './constants.js';
+export class PerpsError extends Error {
+    code;
+    name = PerpsErrorName.PerpsError;
+    constructor(code = PerpsErrorCode.DefaultError, message = 'Unknown error occurred') {
+        const errorMessage = `[${PerpsErrorName.PerpsError}] ${message}\nLI.FI Perps SDK version: ${version}`;
+        super(errorMessage);
+        this.code = code;
+        this.name = PerpsErrorName.PerpsError;
+    }
+    static fromError(error, defaultCode) {
+        if (error instanceof PerpsError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new PerpsError(defaultCode ?? PerpsErrorCode.DefaultError, error.message);
+        }
+        return new PerpsError(defaultCode ?? PerpsErrorCode.DefaultError, String(error));
+    }
+}
+//# sourceMappingURL=PerpsError.js.map

package/dist/esm/errors/PerpsError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerpsError.js","sourceRoot":"","sources":["../../../src/errors/PerpsError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,IAAI,CAAgB;IACX,IAAI,GAAG,cAAc,CAAC,UAAU,CAAA;IAEzC,YACE,OAAuB,cAAc,CAAC,YAAY,EAClD,OAAO,GAAG,wBAAwB;QAElC,MAAM,YAAY,GAAG,IAAI,cAAc,CAAC,UAAU,KAAK,OAAO,8BAA8B,OAAO,EAAE,CAAA;QACrG,KAAK,CAAC,YAAY,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,UAAU,CAAA;IACvC,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAAc,EAAE,WAA4B;QAC3D,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAChC,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,UAAU,CACnB,WAAW,IAAI,cAAc,CAAC,YAAY,EAC1C,KAAK,CAAC,OAAO,CACd,CAAA;QACH,CAAC;QACD,OAAO,IAAI,UAAU,CACnB,WAAW,IAAI,cAAc,CAAC,YAAY,EAC1C,MAAM,CAAC,KAAK,CAAC,CACd,CAAA;IACH,CAAC;CACF"}

package/dist/esm/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/esm/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/esm/errors/PerpsSDKError.js

@@ -0,0 +1,67 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { version } from '../version.js';
+import { PerpsError } from './PerpsError.js';
+const PERPS_SDK_ERROR_NAME = 'PerpsSDKError';
+/**
+ * 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 class PerpsSDKError extends Error {
+    name = PERPS_SDK_ERROR_NAME;
+    /** Numeric error code from PerpsErrorCode enum */
+    code;
+    /** Original cause of the error */
+    cause;
+    constructor(error, message) {
+        // Determine the code
+        const code = error instanceof PerpsError ? error.code : PerpsErrorCode.DefaultError;
+        // Build the message
+        const errorMessage = message ?? error.message;
+        const formattedMessage = `[${PERPS_SDK_ERROR_NAME}] ${errorMessage}\nLI.FI Perps SDK version: ${version}`;
+        super(formattedMessage);
+        this.name = PERPS_SDK_ERROR_NAME;
+        this.code = code;
+        this.cause = error;
+        // Preserve the original stack trace if available
+        if (error.stack) {
+            this.stack = `${this.stack}\nCaused by: ${error.stack}`;
+        }
+    }
+    /**
+     * Wrap any error in a PerpsSDKError.
+     *
+     * @param error - The error to wrap
+     * @param message - Optional custom message
+     * @returns PerpsSDKError instance
+     */
+    static wrap(error, message) {
+        if (error instanceof PerpsSDKError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new PerpsSDKError(error, message);
+        }
+        // Convert non-Error to Error
+        const wrappedError = new Error(String(error));
+        return new PerpsSDKError(wrappedError, message);
+    }
+}
+//# sourceMappingURL=PerpsSDKError.js.map

package/dist/esm/errors/PerpsSDKError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerpsSDKError.js","sourceRoot":"","sources":["../../../src/errors/PerpsSDKError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,MAAM,oBAAoB,GAAG,eAAe,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,GAAG,oBAAoB,CAAA;IAEpC,kDAAkD;IAClD,IAAI,CAAgB;IAEpB,kCAAkC;IACzB,KAAK,CAAQ;IAEtB,YAAY,KAAY,EAAE,OAAgB;QACxC,qBAAqB;QACrB,MAAM,IAAI,GACR,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,YAAY,CAAA;QAExE,oBAAoB;QACpB,MAAM,YAAY,GAAG,OAAO,IAAI,KAAK,CAAC,OAAO,CAAA;QAC7C,MAAM,gBAAgB,GAAG,IAAI,oBAAoB,KAAK,YAAY,8BAA8B,OAAO,EAAE,CAAA;QAEzG,KAAK,CAAC,gBAAgB,CAAC,CAAA;QAEvB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAElB,iDAAiD;QACjD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAA;QACzD,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,KAAc,EAAE,OAAgB;QAC1C,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,OAAO,KAAK,CAAA;QACd,CAAC;QAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC1C,CAAC;QAED,6BAA6B;QAC7B,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAC7C,OAAO,IAAI,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;CACF"}

package/dist/esm/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/esm/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/esm/errors/ServerError.js

@@ -0,0 +1,34 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { version } from '../version.js';
+import { PerpsErrorName } from './constants.js';
+import { PerpsError } from './PerpsError.js';
+/**
+ * Error thrown when server-side operations fail (network errors, timeouts, etc.)
+ */
+export class ServerError extends PerpsError {
+    name = PerpsErrorName.ServerError;
+    constructor(message, code = PerpsErrorCode.ServerError) {
+        super(code, message);
+        this.name = PerpsErrorName.ServerError;
+        // Override message format
+        this.message = `[${PerpsErrorName.ServerError}] ${message}\nLI.FI Perps SDK version: ${version}`;
+    }
+    /**
+     * Create a ServerError for a network failure.
+     *
+     * @param cause - The original error
+     */
+    static networkError(cause) {
+        const message = cause?.message ?? 'Network request failed';
+        return new ServerError(message);
+    }
+    /**
+     * Create a ServerError for a timeout.
+     *
+     * @param operation - The operation that timed out
+     */
+    static timeout(operation) {
+        return new ServerError(`${operation} timed out`, PerpsErrorCode.TimeoutError);
+    }
+}
+//# sourceMappingURL=ServerError.js.map

package/dist/esm/errors/ServerError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerError.js","sourceRoot":"","sources":["../../../src/errors/ServerError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,UAAU;IAChC,IAAI,GAAG,cAAc,CAAC,WAAW,CAAA;IAE1C,YAAY,OAAe,EAAE,IAAI,GAAG,cAAc,CAAC,WAAW;QAC5D,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,WAAW,CAAA;QAEtC,0BAA0B;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,WAAW,KAAK,OAAO,8BAA8B,OAAO,EAAE,CAAA;IAClG,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,KAAa;QAC/B,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,wBAAwB,CAAA;QAC1D,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,SAAiB;QAC9B,OAAO,IAAI,WAAW,CACpB,GAAG,SAAS,YAAY,EACxB,cAAc,CAAC,YAAY,CAC5B,CAAA;IACH,CAAC;CACF"}

package/dist/esm/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/esm/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"}