@lifi/perps-sdk 0.1.1-alpha.0

package/dist/esm/errors/ValidationError.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 validation fails (invalid parameters, missing required fields, etc.)
+ */
+export class ValidationError extends PerpsError {
+    name = PerpsErrorName.ValidationError;
+    constructor(message) {
+        super(PerpsErrorCode.ValidationError, message);
+        this.name = PerpsErrorName.ValidationError;
+        // Override message format
+        this.message = `[${PerpsErrorName.ValidationError}] ${message}\nLI.FI Perps SDK version: ${version}`;
+    }
+    /**
+     * Create a ValidationError from a validation failure.
+     *
+     * @param field - The field that failed validation
+     * @param reason - The reason for validation failure
+     */
+    static field(field, reason) {
+        return new ValidationError(`Invalid ${field}: ${reason}`);
+    }
+    /**
+     * Create a ValidationError for a missing required field.
+     *
+     * @param field - The name of the missing field
+     */
+    static required(field) {
+        return new ValidationError(`${field} is required`);
+    }
+}
+//# sourceMappingURL=ValidationError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.js","sourceRoot":"","sources":["../../../src/errors/ValidationError.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,eAAgB,SAAQ,UAAU;IACpC,IAAI,GAAG,cAAc,CAAC,eAAe,CAAA;IAE9C,YAAY,OAAe;QACzB,KAAK,CAAC,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;QAC9C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,eAAe,CAAA;QAE1C,0BAA0B;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,eAAe,KAAK,OAAO,8BAA8B,OAAO,EAAE,CAAA;IACtG,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,MAAc;QACxC,OAAO,IAAI,eAAe,CAAC,WAAW,KAAK,KAAK,MAAM,EAAE,CAAC,CAAA;IAC3D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAa;QAC3B,OAAO,IAAI,eAAe,CAAC,GAAG,KAAK,cAAc,CAAC,CAAA;IACpD,CAAC;CACF"}

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

package/dist/esm/errors/constants.js

@@ -0,0 +1,17 @@
+export var PerpsErrorName;
+(function (PerpsErrorName) {
+    PerpsErrorName["PerpsError"] = "PerpsError";
+    PerpsErrorName["HTTPError"] = "HTTPError";
+    PerpsErrorName["ValidationError"] = "ValidationError";
+    PerpsErrorName["ServerError"] = "ServerError";
+    PerpsErrorName["ConfigError"] = "ConfigError";
+    PerpsErrorName["AgentError"] = "AgentError";
+})(PerpsErrorName || (PerpsErrorName = {}));
+export var PerpsErrorMessage;
+(function (PerpsErrorMessage) {
+    PerpsErrorMessage["UnknownError"] = "Unknown error occurred.";
+    PerpsErrorMessage["ConfigNotInitialized"] = "SDK not configured. Call createPerpsConfig() first.";
+    PerpsErrorMessage["AgentNotFound"] = "Agent not found. Call setSigningMode() first.";
+    PerpsErrorMessage["InvalidSigningMode"] = "Invalid signing mode for this operation.";
+})(PerpsErrorMessage || (PerpsErrorMessage = {}));
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,2CAAyB,CAAA;IACzB,yCAAuB,CAAA;IACvB,qDAAmC,CAAA;IACnC,6CAA2B,CAAA;IAC3B,6CAA2B,CAAA;IAC3B,2CAAyB,CAAA;AAC3B,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB;AAED,MAAM,CAAN,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,6DAAwC,CAAA;IACxC,iGAA4E,CAAA;IAC5E,oFAA+D,CAAA;IAC/D,oFAA+D,CAAA;AACjE,CAAC,EALW,iBAAiB,KAAjB,iBAAiB,QAK5B"}

package/dist/esm/errors/utils/rootCause.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Get the root cause of an error by following the cause chain.
+ *
+ * @param error - The error to get the root cause of
+ * @returns The root cause error, or the original error if no cause chain
+ *
+ * @example
+ * ```ts
+ * const wrapper = new PerpsSDKError(new HTTPError(response, url))
+ * const root = getRootCause(wrapper) // Returns the HTTPError
+ * ```
+ */
+export declare function getRootCause(error: Error): Error;
+/**
+ * Get the message from the root cause of an error.
+ *
+ * @param error - The error to get the root cause message from
+ * @returns The root cause message
+ *
+ * @example
+ * ```ts
+ * const wrapper = new PerpsSDKError(new HTTPError(response, url))
+ * const message = getRootCauseMessage(wrapper) // Returns the HTTPError's message
+ * ```
+ */
+export declare function getRootCauseMessage(error: Error): string;
+/**
+ * Get the full error chain as an array.
+ *
+ * @param error - The error to get the chain from
+ * @returns Array of errors from outermost to root cause
+ *
+ * @example
+ * ```ts
+ * const chain = getErrorChain(sdkError)
+ * // [PerpsSDKError, HTTPError, ...]
+ * ```
+ */
+export declare function getErrorChain(error: Error): Error[];
+/**
+ * Check if an error chain contains an error of a specific type.
+ *
+ * @param error - The error to check
+ * @param ErrorClass - The error class to look for
+ * @returns True if the chain contains an error of the specified type
+ *
+ * @example
+ * ```ts
+ * if (hasErrorType(error, HTTPError)) {
+ *   // Handle HTTP error specifically
+ * }
+ * ```
+ */
+export declare function hasErrorType<T extends Error>(error: Error, ErrorClass: new (...args: any[]) => T): boolean;
+/**
+ * Find the first error of a specific type in the error chain.
+ *
+ * @param error - The error to search
+ * @param ErrorClass - The error class to find
+ * @returns The first matching error, or undefined if not found
+ *
+ * @example
+ * ```ts
+ * const httpError = findErrorType(error, HTTPError)
+ * if (httpError) {
+ *   console.log(httpError.status)
+ * }
+ * ```
+ */
+export declare function findErrorType<T extends Error>(error: Error, ErrorClass: new (...args: any[]) => T): T | undefined;
+//# sourceMappingURL=rootCause.d.ts.map

package/dist/esm/errors/utils/rootCause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rootCause.d.ts","sourceRoot":"","sources":["../../../../src/errors/utils/rootCause.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAWhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,CAanD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,KAAK,EAC1C,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACpC,OAAO,CAGT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,KAAK,EAC3C,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACpC,CAAC,GAAG,SAAS,CAGf"}

package/dist/esm/errors/utils/rootCause.js

@@ -0,0 +1,99 @@
+/**
+ * Get the root cause of an error by following the cause chain.
+ *
+ * @param error - The error to get the root cause of
+ * @returns The root cause error, or the original error if no cause chain
+ *
+ * @example
+ * ```ts
+ * const wrapper = new PerpsSDKError(new HTTPError(response, url))
+ * const root = getRootCause(wrapper) // Returns the HTTPError
+ * ```
+ */
+export function getRootCause(error) {
+    let current = error;
+    let iterations = 0;
+    const maxIterations = 100; // Prevent infinite loops
+    while (current.cause instanceof Error && iterations < maxIterations) {
+        current = current.cause;
+        iterations++;
+    }
+    return current;
+}
+/**
+ * Get the message from the root cause of an error.
+ *
+ * @param error - The error to get the root cause message from
+ * @returns The root cause message
+ *
+ * @example
+ * ```ts
+ * const wrapper = new PerpsSDKError(new HTTPError(response, url))
+ * const message = getRootCauseMessage(wrapper) // Returns the HTTPError's message
+ * ```
+ */
+export function getRootCauseMessage(error) {
+    return getRootCause(error).message;
+}
+/**
+ * Get the full error chain as an array.
+ *
+ * @param error - The error to get the chain from
+ * @returns Array of errors from outermost to root cause
+ *
+ * @example
+ * ```ts
+ * const chain = getErrorChain(sdkError)
+ * // [PerpsSDKError, HTTPError, ...]
+ * ```
+ */
+export function getErrorChain(error) {
+    const chain = [error];
+    let current = error;
+    let iterations = 0;
+    const maxIterations = 100;
+    while (current.cause instanceof Error && iterations < maxIterations) {
+        chain.push(current.cause);
+        current = current.cause;
+        iterations++;
+    }
+    return chain;
+}
+/**
+ * Check if an error chain contains an error of a specific type.
+ *
+ * @param error - The error to check
+ * @param ErrorClass - The error class to look for
+ * @returns True if the chain contains an error of the specified type
+ *
+ * @example
+ * ```ts
+ * if (hasErrorType(error, HTTPError)) {
+ *   // Handle HTTP error specifically
+ * }
+ * ```
+ */
+export function hasErrorType(error, ErrorClass) {
+    const chain = getErrorChain(error);
+    return chain.some((e) => e instanceof ErrorClass);
+}
+/**
+ * Find the first error of a specific type in the error chain.
+ *
+ * @param error - The error to search
+ * @param ErrorClass - The error class to find
+ * @returns The first matching error, or undefined if not found
+ *
+ * @example
+ * ```ts
+ * const httpError = findErrorType(error, HTTPError)
+ * if (httpError) {
+ *   console.log(httpError.status)
+ * }
+ * ```
+ */
+export function findErrorType(error, ErrorClass) {
+    const chain = getErrorChain(error);
+    return chain.find((e) => e instanceof ErrorClass);
+}
+//# sourceMappingURL=rootCause.js.map

package/dist/esm/errors/utils/rootCause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rootCause.js","sourceRoot":"","sources":["../../../../src/errors/utils/rootCause.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,IAAI,OAAO,GAAU,KAAK,CAAA;IAC1B,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,MAAM,aAAa,GAAG,GAAG,CAAA,CAAC,yBAAyB;IAEnD,OAAO,OAAO,CAAC,KAAK,YAAY,KAAK,IAAI,UAAU,GAAG,aAAa,EAAE,CAAC;QACpE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAA;QACvB,UAAU,EAAE,CAAA;IACd,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAY;IAC9C,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY;IACxC,MAAM,KAAK,GAAY,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,MAAM,aAAa,GAAG,GAAG,CAAA;IAEzB,OAAO,OAAO,CAAC,KAAK,YAAY,KAAK,IAAI,UAAU,GAAG,aAAa,EAAE,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACzB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAA;QACvB,UAAU,EAAE,CAAA;IACd,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAY,EACZ,UAAqC;IAErC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,UAAU,CAAC,CAAA;AACnD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAY,EACZ,UAAqC;IAErC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAU,EAAE,CAAC,CAAC,YAAY,UAAU,CAAC,CAAA;AAC3D,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,46 @@
+export * from '@lifi/perps-types';
+export { AgentManager } from './agent/AgentManager.js';
+export { createMemoryStorage, localStorageAdapter } from './agent/storage.js';
+export type { Agent, StorageAdapter } from './agent/types.js';
+export type { PerpsBaseConfig, PerpsConfig, PerpsSDKClient, RequestInterceptor, SDKRequestOptions, } from './client/createPerpsClient.js';
+export { createPerpsClient } from './client/createPerpsClient.js';
+export { PerpsClient } from './client/PerpsClient.js';
+export type { BuildAuthorizationParams, CancelOrdersParams, ExecuteAuthorizationsParams, ExecuteAuthorizationsResult, GetRequiredAuthorizationsParams, PerpsClientOptions, PlaceOrderParams, RequiredAuthorizationsResult, SigningMode, } from './client/types.js';
+export { AgentError } from './errors/AgentError.js';
+export { PerpsErrorMessage, PerpsErrorName } from './errors/constants.js';
+export { HTTPError } from './errors/HTTPError.js';
+export { PerpsError } from './errors/PerpsError.js';
+export { PerpsSDKError } from './errors/PerpsSDKError.js';
+export { ServerError } from './errors/ServerError.js';
+export { findErrorType, getErrorChain, getRootCause, getRootCauseMessage, hasErrorType, } from './errors/utils/rootCause.js';
+export { ValidationError } from './errors/ValidationError.js';
+export type { CancelOrderParams } from './services/cancelOrder.js';
+export { cancelOrder } from './services/cancelOrder.js';
+export type { CreateAuthorizationParams } from './services/createAuthorization.js';
+export { createAuthorization } from './services/createAuthorization.js';
+export type { CreateOrderParams } from './services/createOrder.js';
+export { createOrder } from './services/createOrder.js';
+export type { GetAccountParams } from './services/getAccount.js';
+export { getAccount } from './services/getAccount.js';
+export { getDexes } from './services/getDexes.js';
+export type { GetHistoryParams } from './services/getHistory.js';
+export { getHistory } from './services/getHistory.js';
+export type { GetMarketParams } from './services/getMarket.js';
+export { getMarket } from './services/getMarket.js';
+export type { GetMarketsParams } from './services/getMarkets.js';
+export { getMarkets } from './services/getMarkets.js';
+export type { GetOhlcvParams } from './services/getOhlcv.js';
+export { getOhlcv } from './services/getOhlcv.js';
+export type { GetOrderParams } from './services/getOrder.js';
+export { getOrder } from './services/getOrder.js';
+export type { GetOrderbookParams } from './services/getOrderbook.js';
+export { getOrderbook } from './services/getOrderbook.js';
+export type { GetPricesParams } from './services/getPrices.js';
+export { getPrices } from './services/getPrices.js';
+export type { SubmitAuthorizationParams } from './services/submitAuthorization.js';
+export { submitAuthorization } from './services/submitAuthorization.js';
+export type { SubmitOrderParams } from './services/submitOrder.js';
+export { submitOrder } from './services/submitOrder.js';
+export { signTypedData } from './utils/signTypedData.js';
+export { name, version } from './version.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/esm/index.js

@@ -0,0 +1,37 @@
+// Client
+// Types
+export * from '@lifi/perps-types';
+// Agent
+export { AgentManager } from './agent/AgentManager.js';
+export { createMemoryStorage, localStorageAdapter } from './agent/storage.js';
+export { createPerpsClient } from './client/createPerpsClient.js';
+export { PerpsClient } from './client/PerpsClient.js';
+export { AgentError } from './errors/AgentError.js';
+export { PerpsErrorMessage, PerpsErrorName } from './errors/constants.js';
+// Errors
+export { HTTPError } from './errors/HTTPError.js';
+export { PerpsError } from './errors/PerpsError.js';
+export { PerpsSDKError } from './errors/PerpsSDKError.js';
+export { ServerError } from './errors/ServerError.js';
+export { findErrorType, getErrorChain, getRootCause, getRootCauseMessage, hasErrorType, } from './errors/utils/rootCause.js';
+export { ValidationError } from './errors/ValidationError.js';
+// Services
+export { cancelOrder } from './services/cancelOrder.js';
+export { createAuthorization } from './services/createAuthorization.js';
+export { createOrder } from './services/createOrder.js';
+export { getAccount } from './services/getAccount.js';
+export { getDexes } from './services/getDexes.js';
+export { getHistory } from './services/getHistory.js';
+export { getMarket } from './services/getMarket.js';
+export { getMarkets } from './services/getMarkets.js';
+export { getOhlcv } from './services/getOhlcv.js';
+export { getOrder } from './services/getOrder.js';
+export { getOrderbook } from './services/getOrderbook.js';
+export { getPrices } from './services/getPrices.js';
+export { submitAuthorization } from './services/submitAuthorization.js';
+export { submitOrder } from './services/submitOrder.js';
+// Utils
+export { signTypedData } from './utils/signTypedData.js';
+// Version
+export { name, version } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AAET,QAAQ;AACR,cAAc,mBAAmB,CAAA;AACjC,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAS7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAYrD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACzE,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,GACb,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE7D,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,UAAU;AACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type": "module","sideEffects":false}

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

@@ -0,0 +1,51 @@
+import type { Address, CancelOrderPayloadResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface CancelOrderParams {
+    /** DEX to cancel orders on (e.g., 'hyperliquid') */
+    dex: string;
+    /** Wallet address */
+    address: Address;
+    /** Address of the signer (for agent mode, this is the agent address) */
+    signerAddress?: Address;
+    /** Order IDs to cancel */
+    ids: string[];
+}
+/**
+ * Create cancel order payloads for signing.
+ * Returns typed data that must be signed by the user or agent.
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Cancel actions with typed data for signing
+ * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { actions } = await cancelOrder(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   ids: ['order1', 'order2']
+ * })
+ *
+ * // Sign with agent key or user wallet
+ * const signedActions = await Promise.all(
+ *   actions.map(async (a) => ({
+ *     action: a.action,
+ *     typedData: a.typedData,
+ *     signature: await signTypedData(agentPrivateKey, a.typedData)
+ *   }))
+ * )
+ *
+ * // Submit the signed cancellation
+ * await submitOrder(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   actions: signedActions
+ * })
+ * ```
+ */
+export declare function cancelOrder(client: PerpsSDKClient, params: CancelOrderParams, options?: SDKRequestOptions): Promise<CancelOrderPayloadResponse>;
+//# sourceMappingURL=cancelOrder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancelOrder.d.ts","sourceRoot":"","sources":["../../../src/services/cancelOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,0BAA0B;IAC1B,GAAG,EAAE,MAAM,EAAE,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,0BAA0B,CAAC,CAerC"}

package/dist/esm/services/cancelOrder.js

@@ -0,0 +1,50 @@
+import { request } from '../utils/request.js';
+/**
+ * Create cancel order payloads for signing.
+ * Returns typed data that must be signed by the user or agent.
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Cancel actions with typed data for signing
+ * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { actions } = await cancelOrder(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   ids: ['order1', 'order2']
+ * })
+ *
+ * // Sign with agent key or user wallet
+ * const signedActions = await Promise.all(
+ *   actions.map(async (a) => ({
+ *     action: a.action,
+ *     typedData: a.typedData,
+ *     signature: await signTypedData(agentPrivateKey, a.typedData)
+ *   }))
+ * )
+ *
+ * // Submit the signed cancellation
+ * await submitOrder(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   actions: signedActions
+ * })
+ * ```
+ */
+export async function cancelOrder(client, params, options) {
+    return request(client.config, `${client.config.apiUrl}/cancelOrder`, {
+        method: 'POST',
+        body: JSON.stringify({
+            dex: params.dex,
+            address: params.address,
+            signerAddress: params.signerAddress,
+            ids: params.ids,
+        }),
+    }, options);
+}
+//# sourceMappingURL=cancelOrder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancelOrder.js","sourceRoot":"","sources":["../../../src/services/cancelOrder.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAa7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;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,cAAc,EACrC;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,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC;KACH,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,47 @@
+import type { Address, AuthorizationInput, CreateAuthorizationResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface CreateAuthorizationParams {
+    /** 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;
+    /** List of authorizations to create */
+    authorizations: AuthorizationInput[];
+}
+/**
+ * Create authorization payloads for signing.
+ * Returns typed data that must be signed by the user or agent.
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Authorization actions with typed data for signing
+ * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { actions } = await createAuthorization(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   authorizations: [
+ *     { key: 'ApproveAgent', params: { agentAddress: '0xabcd...' } },
+ *     { key: 'ApproveBuilderFee' }
+ *   ]
+ * })
+ *
+ * // Sign each action's typedData with the user's wallet
+ * const signedActions = await Promise.all(
+ *   actions.map(async (a) => ({
+ *     action: a.action,
+ *     typedData: a.typedData,
+ *     signature: await walletClient.signTypedData(a.typedData)
+ *   }))
+ * )
+ * ```
+ */
+export declare function createAuthorization(client: PerpsSDKClient, params: CreateAuthorizationParams, options?: SDKRequestOptions): Promise<CreateAuthorizationResponse>;
+//# sourceMappingURL=createAuthorization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createAuthorization.d.ts","sourceRoot":"","sources":["../../../src/services/createAuthorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,2BAA2B,EAC5B,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,uCAAuC;IACvC,cAAc,EAAE,kBAAkB,EAAE,CAAA;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,2BAA2B,CAAC,CAetC"}

package/dist/esm/services/createAuthorization.js

@@ -0,0 +1,46 @@
+import { request } from '../utils/request.js';
+/**
+ * Create authorization payloads for signing.
+ * Returns typed data that must be signed by the user or agent.
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Authorization actions with typed data for signing
+ * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { actions } = await createAuthorization(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   authorizations: [
+ *     { key: 'ApproveAgent', params: { agentAddress: '0xabcd...' } },
+ *     { key: 'ApproveBuilderFee' }
+ *   ]
+ * })
+ *
+ * // Sign each action's typedData with the user's wallet
+ * const signedActions = await Promise.all(
+ *   actions.map(async (a) => ({
+ *     action: a.action,
+ *     typedData: a.typedData,
+ *     signature: await walletClient.signTypedData(a.typedData)
+ *   }))
+ * )
+ * ```
+ */
+export async function createAuthorization(client, params, options) {
+    return request(client.config, `${client.config.apiUrl}/createAuthorization`, {
+        method: 'POST',
+        body: JSON.stringify({
+            dex: params.dex,
+            address: params.address,
+            signerAddress: params.signerAddress,
+            authorizations: params.authorizations,
+        }),
+    }, options);
+}
+//# sourceMappingURL=createAuthorization.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createAuthorization.js","sourceRoot":"","sources":["../../../src/services/createAuthorization.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAa7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;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,sBAAsB,EAC7C;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,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAC;KACH,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,71 @@
+import type { Address, CreateOrderResponse, OrderSide, OrderType, TimeInForce, TriggerOrderInput } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface CreateOrderParams {
+    /** DEX to place order on (e.g., 'hyperliquid') */
+    dex: string;
+    /** Wallet address */
+    address: Address;
+    /** Address of the signer (for agent mode, this is the agent address) */
+    signerAddress?: Address;
+    /** Client-provided order ID for tracking */
+    clientOrderId?: string;
+    /** Market symbol (e.g., 'BTC') */
+    symbol: string;
+    /** Order side */
+    side: OrderSide;
+    /** Order type */
+    type: OrderType;
+    /** Order size (in base asset) */
+    size: string;
+    /** Order price (required for limit orders) */
+    price: string;
+    /** Leverage for the position */
+    leverage?: number;
+    /** Whether this order only reduces position */
+    reduceOnly?: boolean;
+    /** Time in force */
+    timeInForce?: TimeInForce;
+    /** Expiration time (ISO 8601) */
+    expiresAt?: string;
+    /** Take profit trigger order */
+    takeProfit?: TriggerOrderInput;
+    /** Stop loss trigger order */
+    stopLoss?: TriggerOrderInput;
+}
+/**
+ * Create order payloads for signing.
+ * Returns typed data that must be signed by the user or agent.
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Order actions with typed data for signing
+ * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { actions } = await createOrder(client, {
+ *   dex: 'hyperliquid',
+ *   address: '0x1234...',
+ *   symbol: 'BTC',
+ *   side: OrderSide.BUY,
+ *   type: OrderType.LIMIT,
+ *   size: '0.1',
+ *   price: '94000.00',
+ *   leverage: 10
+ * })
+ *
+ * // Sign each action with the user's wallet or agent key
+ * const signedActions = await Promise.all(
+ *   actions.map(async (a) => ({
+ *     action: a.action,
+ *     typedData: a.typedData,
+ *     signature: await walletClient.signTypedData(a.typedData)
+ *   }))
+ * )
+ * ```
+ */
+export declare function createOrder(client: PerpsSDKClient, params: CreateOrderParams, options?: SDKRequestOptions): Promise<CreateOrderResponse>;
+//# sourceMappingURL=createOrder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createOrder.d.ts","sourceRoot":"","sources":["../../../src/services/createOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,WAAW,EACX,iBAAiB,EAClB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAA;IACf,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAA;IACf,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,oBAAoB;IACpB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA0B9B"}