@lifi/perps-sdk 0.1.1-alpha.8 → 0.2.0-alpha.0

package/README.md

@@ -9,12 +9,13 @@
 
 <h1 align="center">LI.FI Perps SDK</h1>
 
-[**LI.FI Perps SDK**](https://public-perps-docs.mintlify.app/) provides a TypeScript SDK for the LI.FI Perps API. Trade perpetuals across multiple DEXes with a unified interface.
+[**LI.FI Perps SDK**](https://public-perps-docs.mintlify.app/) is a TypeScript SDK for trading perpetuals across multiple DEXes through a unified interface.
 
-- Unified interface across multiple perpetual DEXes
-- Low-level service functions for explicit signing control
-- High-level `PerpsClient` with automatic agent signing (no wallet popups)
-- Full TypeScript support with all types and enums exported
+- Unified interface across perpetual DEXes (Hyperliquid and more)
+- Agent-based trade signing — the SDK provisions a per-user signing agent so trades execute without wallet popups (one-time wallet signature for setup)
+- Low-level service functions and high-level `PerpsClient`
+- Real-time WebSocket subscriptions for prices, orderbook, and fills
+- Full TypeScript support with all types exported
 
 ## Installation
 
@@ -26,23 +27,45 @@ npm install @lifi/perps-sdk
 
 ## Quick Start
 
+Get an API key from the [LI.FI Partner Portal](https://portal.li.fi/).
+
+### Fetch Market Data
+
 ```typescript
-import { createPerpsClient, getDexes, getMarkets } from '@lifi/perps-sdk'
+import { createPerpsClient, getProviders, getAssets, getPrices } from '@lifi/perps-sdk'
 
-// 1. Create a client (required before any API calls)
-const client = createPerpsClient({
-  integrator: 'my-app',
-  apiKey: 'optional-api-key',
-})
+const client = createPerpsClient({ integrator: 'my-app', apiKey: 'your-api-key' })
+
+const { providers } = await getProviders(client)
+const { assets } = await getAssets(client, { provider: 'hyperliquid' })
+const { prices } = await getPrices(client, { provider: 'hyperliquid', symbols: ['BTC', 'ETH'] })
+```
+
+### Trade with PerpsClient
 
-// 2. Fetch market data (no authentication required)
-const { dexes } = await getDexes(client)
-const { markets } = await getMarkets(client, { dex: 'hyperliquid' })
+```typescript
+import { PerpsClient, OrderSide, OrderType } from '@lifi/perps-sdk'
+
+const perps = new PerpsClient({ integrator: 'my-app', apiKey: 'your-api-key' })
+
+// Enable agent signing mode (one-time setup, requires user wallet signature)
+await perps.setSigningMode(address, 'hyperliquid', 'USER_AGENT')
+
+// Place orders without wallet popups
+const result = await perps.placeOrder({
+  provider: 'hyperliquid',
+  address,
+  asset: { assetId: 'BTC', market: 'hyperliquid' },
+  side: OrderSide.BUY,
+  type: OrderType.MARKET,
+  size: '0.1',
+  price: '95000.00',
+})
 ```
 
 ## Examples
 
-See the [`examples/`](./examples) folder for runnable code covering market data, account data, trading, agent-based trading, error handling, and custom storage.
+See the [`examples/`](./examples) folder for runnable code covering market data, account management, trading, agent-based signing, error handling, and custom storage.
 
 ## Documentation
 

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

@@ -5,11 +5,11 @@ export declare class AgentManager {
     private cache;
     constructor(storage?: StorageAdapter);
     private storageKey;
-    getAgent(address: Address, dex: string): Promise<Agent>;
-    getOrCreateAgent(address: Address, dex: string): Promise<Agent>;
-    hasAgent(address: Address, dex: string): Promise<boolean>;
-    removeAgent(address: Address, dex: string): Promise<void>;
-    importAgent(address: Address, dex: string, privateKey: Hex): Promise<Agent>;
+    getAgent(address: Address, provider: string): Promise<Agent>;
+    getOrCreateAgent(address: Address, provider: string): Promise<Agent>;
+    hasAgent(address: Address, provider: string): Promise<boolean>;
+    removeAgent(address: Address, provider: string): Promise<void>;
+    importAgent(address: Address, provider: string, privateKey: Hex): Promise<Agent>;
     clearCache(): void;
 }
 //# sourceMappingURL=AgentManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AgentManager.d.ts","sourceRoot":"","sources":["../../../src/agent/AgentManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAMrD,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAQvD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAAgC;gBAEjC,OAAO,CAAC,EAAE,cAAc;IAOpC,OAAO,CAAC,UAAU;IASZ,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IA0BvD,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAyB/D,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAazD,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzD,WAAW,CACf,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,KAAK,CAAC;IAmBjB,UAAU,IAAI,IAAI;CAGnB"}
+{"version":3,"file":"AgentManager.d.ts","sourceRoot":"","sources":["../../../src/agent/AgentManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAMrD,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAQvD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAAgC;gBAEjC,OAAO,CAAC,EAAE,cAAc;IAOpC,OAAO,CAAC,UAAU;IASZ,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IA4B5D,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAyBpE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa9D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D,WAAW,CACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,KAAK,CAAC;IAmBjB,UAAU,IAAI,IAAI;CAGnB"}

package/dist/cjs/agent/AgentManager.js

@@ -13,11 +13,11 @@ class AgentManager {
     constructor(storage) {
         this.storage = storage ?? storage_js_1.localStorageAdapter;
     }
-    storageKey(address, dex) {
-        return `${STORAGE_PREFIX}:${address.toLowerCase()}:${dex.toLowerCase()}`;
+    storageKey(address, provider) {
+        return `${STORAGE_PREFIX}:${address.toLowerCase()}:${provider.toLowerCase()}`;
     }
-    async getAgent(address, dex) {
-        const key = this.storageKey(address, dex);
+    async getAgent(address, provider) {
+        const key = this.storageKey(address, provider);
         const cached = this.cache.get(key);
         if (cached) {
             return cached;
@@ -28,11 +28,13 @@ class AgentManager {
             this.cache.set(key, agent);
             return agent;
         }
-        throw new PerpsError_js_1.PerpsError(perps_types_1.PerpsErrorCode.AgentUnauthorized, constants_js_1.PerpsErrorMessage.AgentNotFound);
+        const error = new PerpsError_js_1.PerpsError(perps_types_1.PerpsErrorCode.SDKError, constants_js_1.PerpsErrorMessage.AgentNotFound);
+        error.tool = '@lifi/perps-sdk';
+        throw error;
     }
-    async getOrCreateAgent(address, dex) {
+    async getOrCreateAgent(address, provider) {
         try {
-            return await this.getAgent(address, dex);
+            return await this.getAgent(address, provider);
         }
         catch {
             const privateKey = (0, accounts_1.generatePrivateKey)();
@@ -41,33 +43,33 @@ class AgentManager {
                 address: account.address,
                 privateKey,
             };
-            const key = this.storageKey(address, dex);
+            const key = this.storageKey(address, provider);
             await this.storage.set(key, JSON.stringify(agent));
             this.cache.set(key, agent);
             return agent;
         }
     }
-    async hasAgent(address, dex) {
+    async hasAgent(address, provider) {
         try {
-            await this.getAgent(address, dex);
+            await this.getAgent(address, provider);
             return true;
         }
         catch {
             return false;
         }
     }
-    async removeAgent(address, dex) {
-        const key = this.storageKey(address, dex);
+    async removeAgent(address, provider) {
+        const key = this.storageKey(address, provider);
         this.cache.delete(key);
         await this.storage.remove(key);
     }
-    async importAgent(address, dex, privateKey) {
+    async importAgent(address, provider, privateKey) {
         const account = (0, accounts_1.privateKeyToAccount)(privateKey);
         const agent = {
             address: account.address,
             privateKey,
         };
-        const key = this.storageKey(address, dex);
+        const key = this.storageKey(address, provider);
         await this.storage.set(key, JSON.stringify(agent));
         this.cache.set(key, agent);
         return agent;

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

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

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

@@ -1,30 +1,84 @@
-import type { Address, AuthorizationsResponse, CancelOrderPayloadResponse, CreateAuthorizationResponse, CreateOrderResponse, CreateWithdrawalResponse, SubmitOrderResponse, SubmitWithdrawalResponse } from '@lifi/perps-types';
-import type { SubmitAuthorizationParams } from '../services/submitAuthorization.js';
-import type { SubmitOrderParams } from '../services/submitOrder.js';
-import type { SubmitWithdrawalParams } from '../services/submitWithdrawal.js';
+import type { ActionParamsMap, ActionStep, Address, ApproveReadOnlyTokenParams, AssetIdentity, CreateActionResponse, ExecuteActionResponse, SignedActionStep } from '@lifi/perps-types';
+import { ActionType } from '@lifi/perps-types';
+import { type ApproveReadOnlyTokenResult } from '../signers/lighter/index.js';
 import { type PerpsSDKClient } from './createPerpsClient.js';
-import type { BuildAuthorizationParams, BuildWithdrawalParams, CancelOrdersParams, ExecuteAuthorizationsParams, ExecuteAuthorizationsResult, GetRequiredAuthorizationsParams, PerpsClientOptions, PlaceOrderParams, RequiredAuthorizationsResult, SigningMode } from './types.js';
+import { type CancelOrdersParams, type CheckPrerequisitesParams, type GetAccountResult, type GetSetupParams, type ModifyOrdersParams, type PerpsClientOptions, type PlaceOrderParams, type PlaceTriggerOrderParams, type SatisfySetupParams, type SatisfySetupResult, type SetupResult, SigningMode, type WithdrawParams } from './types.js';
 export declare class PerpsClient {
     private sdkClient;
+    private storage;
     private signingModes;
+    private providerMetadataCache;
+    private _signer;
+    private readonly lighterConfig;
+    private readonly lighterReadOnlyTokenOptions;
+    private _lighterSigner;
+    private _lighterKeyStore;
+    private _lighterReadOnlyTokenManager;
     constructor(options: PerpsClientOptions);
+    private getLighterSigner;
+    private getLighterKeyStore;
+    private getLighterReadOnlyTokenManager;
+    setSigner(signer: PerpsSDKClient['signer']): void;
     get client(): PerpsSDKClient;
     private modeKey;
-    setSigningMode(address: Address, dex: string, mode: SigningMode): Promise<void>;
-    getSigningMode(address: Address, dex: string): SigningMode;
-    getAgentAddress(address: Address, dex: string): Promise<Address>;
-    hasAgent(address: Address, dex: string): Promise<boolean>;
-    removeAgent(address: Address, dex: string): Promise<void>;
-    buildAuthorization(params: BuildAuthorizationParams): Promise<CreateAuthorizationResponse>;
-    submitAuthorizations(params: SubmitAuthorizationParams): Promise<AuthorizationsResponse>;
-    buildOrder(params: PlaceOrderParams): Promise<CreateOrderResponse>;
-    buildCancelOrder(params: CancelOrdersParams): Promise<CancelOrderPayloadResponse>;
-    placeOrder(params: PlaceOrderParams): Promise<SubmitOrderResponse>;
-    cancelOrders(params: CancelOrdersParams): Promise<SubmitOrderResponse>;
-    submitSignedOrder(params: SubmitOrderParams): Promise<SubmitOrderResponse>;
-    buildWithdrawal(params: BuildWithdrawalParams): Promise<CreateWithdrawalResponse>;
-    submitWithdrawal(params: SubmitWithdrawalParams): Promise<SubmitWithdrawalResponse>;
-    getRequiredAuthorizations(params: GetRequiredAuthorizationsParams): Promise<RequiredAuthorizationsResult>;
-    executeAuthorizations(params: ExecuteAuthorizationsParams): Promise<ExecuteAuthorizationsResult>;
+    private signingModeStorageKey;
+    private getProviderMetadata;
+    private static readonly EXPLICIT_INPUT_PREREQUISITES;
+    private buildPrerequisiteInputs;
+    private resolveSignerForAction;
+    private providerUsesAgent;
+    private autoSignAndExecute;
+    signPrerequisite(provider: string, address: Address, step: ActionStep): Promise<SignedActionStep>;
+    private signEvmTxActions;
+    private signWasmBlobActions;
+    private signStandardWasmAction;
+    private signRegisterApiKey;
+    private signAccountTierChange;
+    createLighterAuthToken(address: Address, deadlineSeconds?: number, accountIndex?: number): Promise<string | undefined>;
+    approveReadOnlyToken(address: Address, params: ApproveReadOnlyTokenParams): Promise<ApproveReadOnlyTokenResult>;
+    isLighterReadOnlyTokenExpiringSoon(address: Address, accountIndex: number, thresholdDays?: number): Promise<boolean>;
+    buildAction<T extends ActionType>(action: T, params: {
+        provider: string;
+        address: Address;
+        params: ActionParamsMap[T];
+    }): Promise<CreateActionResponse>;
+    setSigningMode(address: Address, provider: string, mode: SigningMode): Promise<void>;
+    getSigningMode(address: Address, provider: string): SigningMode;
+    loadSigningMode(address: Address, provider: string): Promise<SigningMode>;
+    loadAgentMode(address: Address, provider: string): Promise<boolean>;
+    setAgentMode(address: Address, provider: string, useAgent: boolean): Promise<void>;
+    getAgentAddress(address: Address, provider: string): Promise<Address>;
+    hasAgent(address: Address, provider: string): Promise<boolean>;
+    removeAgent(address: Address, provider: string): Promise<void>;
+    getAccount(params: {
+        provider: string;
+        address: Address;
+    }): Promise<GetAccountResult>;
+    accountExists(provider: string, address: Address): Promise<boolean>;
+    checkSetup(params: GetSetupParams): Promise<SetupResult>;
+    buildPrerequisites(params: CheckPrerequisitesParams): Promise<CreateActionResponse>;
+    private static readonly DEFAULT_ACCOUNT_MODE;
+    private prepareAccountModeChange;
+    private static hasWritableAccountMode;
+    satisfySetup(params: SatisfySetupParams): Promise<SatisfySetupResult>;
+    placeOrder(params: PlaceOrderParams): Promise<ExecuteActionResponse>;
+    placeTriggerOrder(params: PlaceTriggerOrderParams): Promise<ExecuteActionResponse>;
+    cancelOrders(params: CancelOrdersParams): Promise<ExecuteActionResponse>;
+    modifyOrders(params: ModifyOrdersParams): Promise<ExecuteActionResponse>;
+    updatePositionMargin(params: {
+        provider: string;
+        address: Address;
+        asset: AssetIdentity;
+        action: 'add' | 'remove';
+        amount: string;
+    }): Promise<ExecuteActionResponse>;
+    withdraw(params: WithdrawParams): Promise<ExecuteActionResponse>;
+    execute<T extends ActionType>(params: {
+        provider: string;
+        address: Address;
+        signerAddress?: Address;
+        action: T;
+        params: ActionParamsMap[T];
+    }): Promise<ExecuteActionResponse>;
 }
 //# sourceMappingURL=PerpsClient.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PerpsClient.d.ts","sourceRoot":"","sources":["../../../src/client/PerpsClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EAIxB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,mBAAmB,CAAA;AAS1B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAA;AAEnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAEnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AAG7E,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC/E,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,EAC/B,kBAAkB,EAClB,gBAAgB,EAChB,4BAA4B,EAC5B,WAAW,EACZ,MAAM,YAAY,CAAA;AA4CnB,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,YAAY,CAAsC;gBAE9C,OAAO,EAAE,kBAAkB;IAYvC,IAAI,MAAM,IAAI,cAAc,CAE3B;IAKD,OAAO,CAAC,OAAO;IAaT,cAAc,CAClB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC;IAchB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW;IASpD,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQhE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQzD,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD,kBAAkB,CACtB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,2BAA2B,CAAC;IA0BjC,oBAAoB,CACxB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,sBAAsB,CAAC;IAwB5B,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwClE,gBAAgB,CACpB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,0BAA0B,CAAC;IA6BhC,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA6DlE,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiDtE,iBAAiB,CACrB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAazB,eAAe,CACnB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,wBAAwB,CAAC;IAgB9B,gBAAgB,CACpB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IAc9B,yBAAyB,CAC7B,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,4BAA4B,CAAC;IAwDlC,qBAAqB,CACzB,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,2BAA2B,CAAC;CAkDxC"}
+{"version":3,"file":"PerpsClient.d.ts","sourceRoot":"","sources":["../../../src/client/PerpsClient.ts"],"names":[],"mappings":"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"}