@lifi/perps-sdk 0.1.1-alpha.0

package/dist/esm/agent/AgentManager.js

@@ -0,0 +1,110 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
+import { PerpsErrorMessage } from '../errors/constants.js';
+import { PerpsError } from '../errors/PerpsError.js';
+import { localStorageAdapter } from './storage.js';
+const STORAGE_PREFIX = 'lifi-perps-agent';
+/**
+ * Manages agent keypairs for USER_AGENT signing mode.
+ * Agent keys are stored per user address + DEX combination.
+ */
+export class AgentManager {
+    storage;
+    cache = new Map();
+    constructor(storage) {
+        this.storage = storage ?? localStorageAdapter;
+    }
+    /**
+     * Get the storage key for an agent.
+     */
+    storageKey(address, dex) {
+        return `${STORAGE_PREFIX}:${address.toLowerCase()}:${dex.toLowerCase()}`;
+    }
+    /**
+     * Get an existing agent for a user + DEX pair.
+     *
+     * @throws {PerpsError} If agent not found
+     */
+    async getAgent(address, dex) {
+        const key = this.storageKey(address, dex);
+        // Check cache first
+        const cached = this.cache.get(key);
+        if (cached) {
+            return cached;
+        }
+        // Check storage
+        const stored = await this.storage.get(key);
+        if (stored) {
+            const agent = JSON.parse(stored);
+            this.cache.set(key, agent);
+            return agent;
+        }
+        throw new PerpsError(PerpsErrorCode.AgentUnauthorized, PerpsErrorMessage.AgentNotFound);
+    }
+    /**
+     * Get an existing agent or create a new one.
+     */
+    async getOrCreateAgent(address, dex) {
+        try {
+            return await this.getAgent(address, dex);
+        }
+        catch {
+            // Generate new agent
+            const privateKey = generatePrivateKey();
+            const account = privateKeyToAccount(privateKey);
+            const agent = {
+                address: account.address,
+                privateKey,
+            };
+            // Store
+            const key = this.storageKey(address, dex);
+            await this.storage.set(key, JSON.stringify(agent));
+            this.cache.set(key, agent);
+            return agent;
+        }
+    }
+    /**
+     * Check if an agent exists for a user + DEX pair.
+     */
+    async hasAgent(address, dex) {
+        try {
+            await this.getAgent(address, dex);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Remove an agent for a user + DEX pair.
+     * Call this when the user revokes agent authorization.
+     */
+    async removeAgent(address, dex) {
+        const key = this.storageKey(address, dex);
+        this.cache.delete(key);
+        await this.storage.remove(key);
+    }
+    /**
+     * Import an existing agent keypair.
+     * Useful for restoring from backup or using a specific key.
+     */
+    async importAgent(address, dex, privateKey) {
+        const account = privateKeyToAccount(privateKey);
+        const agent = {
+            address: account.address,
+            privateKey,
+        };
+        const key = this.storageKey(address, dex);
+        await this.storage.set(key, JSON.stringify(agent));
+        this.cache.set(key, agent);
+        return agent;
+    }
+    /**
+     * Clear all cached agents.
+     * Does not remove from storage.
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=AgentManager.js.map

package/dist/esm/agent/AgentManager.js.map

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

package/dist/esm/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/esm/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/esm/agent/storage.js

@@ -0,0 +1,54 @@
+/**
+ * localStorage adapter for browser environments.
+ * Agent keys are stored as JSON strings with the key pattern:
+ * `lifi-perps-agent:{address}:{dex}`
+ */
+export const localStorageAdapter = {
+    get: (key) => {
+        try {
+            return Promise.resolve(localStorage.getItem(key));
+        }
+        catch {
+            // localStorage not available (e.g., SSR)
+            return Promise.resolve(null);
+        }
+    },
+    set: (key, value) => {
+        try {
+            localStorage.setItem(key, value);
+        }
+        catch {
+            // localStorage not available
+        }
+        return Promise.resolve();
+    },
+    remove: (key) => {
+        try {
+            localStorage.removeItem(key);
+        }
+        catch {
+            // localStorage not available
+        }
+        return Promise.resolve();
+    },
+};
+/**
+ * In-memory storage adapter for testing or server-side use.
+ */
+export function createMemoryStorage() {
+    const store = new Map();
+    return {
+        get: (key) => {
+            return Promise.resolve(store.get(key) ?? null);
+        },
+        set: (key, value) => {
+            store.set(key, value);
+            return Promise.resolve();
+        },
+        remove: (key) => {
+            store.delete(key);
+            return Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/esm/agent/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/agent/storage.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,GAAG,EAAE,CAAC,GAAW,EAA0B,EAAE;QAC3C,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;YACzC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,GAAG,EAAE,CAAC,GAAW,EAAE,KAAa,EAAiB,EAAE;QACjD,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;IAED,MAAM,EAAE,CAAC,GAAW,EAAiB,EAAE;QACrC,IAAI,CAAC;YACH,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;CACF,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEvC,OAAO;QACL,GAAG,EAAE,CAAC,GAAW,EAA0B,EAAE;YAC3C,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAA;QAChD,CAAC;QAED,GAAG,EAAE,CAAC,GAAW,EAAE,KAAa,EAAiB,EAAE;YACjD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACrB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC;QAED,MAAM,EAAE,CAAC,GAAW,EAAiB,EAAE;YACrC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACjB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC;KACF,CAAA;AACH,CAAC"}

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

package/dist/esm/agent/types.js

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

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

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

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