@lifi/perps-sdk 0.1.1-alpha.4 → 0.1.1-alpha.40

package/dist/esm/utils/request.js.map

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

package/dist/esm/utils/units.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Token unit conversion utilities.
+ */
+/**
+ * Convert a base-unit amount (bigint string) to a human-readable decimal string.
+ *
+ * @param amount - Amount in base units (e.g. "1000000" for 1 USDC)
+ * @param decimals - Token decimals (e.g. 6 for USDC)
+ * @returns Decimal string (e.g. "1.0")
+ */
+export declare function fromBaseUnits(amount: string, decimals: number): string;
+/**
+ * Convert a base-unit amount to a number.
+ *
+ * @param amount - Amount in base units
+ * @param decimals - Token decimals
+ * @returns Numeric value, or 0 if parsing fails
+ */
+export declare function fromBaseUnitsNumber(amount: string, decimals: number): number;
+//# sourceMappingURL=units.d.ts.map

package/dist/esm/utils/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../../src/utils/units.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5E"}

package/dist/esm/utils/units.js

@@ -0,0 +1,31 @@
+/**
+ * Token unit conversion utilities.
+ */
+import { formatUnits } from 'viem';
+/**
+ * Convert a base-unit amount (bigint string) to a human-readable decimal string.
+ *
+ * @param amount - Amount in base units (e.g. "1000000" for 1 USDC)
+ * @param decimals - Token decimals (e.g. 6 for USDC)
+ * @returns Decimal string (e.g. "1.0")
+ */
+export function fromBaseUnits(amount, decimals) {
+    try {
+        return formatUnits(BigInt(amount), decimals);
+    }
+    catch {
+        return '0';
+    }
+}
+/**
+ * Convert a base-unit amount to a number.
+ *
+ * @param amount - Amount in base units
+ * @param decimals - Token decimals
+ * @returns Numeric value, or 0 if parsing fails
+ */
+export function fromBaseUnitsNumber(amount, decimals) {
+    const value = Number(fromBaseUnits(amount, decimals));
+    return Number.isFinite(value) ? value : 0;
+}
+//# sourceMappingURL=units.js.map

package/dist/esm/utils/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../../src/utils/units.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAElC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,QAAgB;IAC5D,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAA;IACZ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,QAAgB;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IACrD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAC3C,CAAC"}

package/dist/esm/utils/validation.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Order validation utilities.
+ */
+/**
+ * Validate margin input against available balance and exchange minimums.
+ *
+ * @param margin - Margin amount in USD
+ * @param leverage - Position leverage
+ * @param availableBalance - Available balance, or null if unknown
+ * @param feeRate - Fee rate as decimal, or null if unknown
+ * @param minMarginUsd - Minimum margin requirement in USD (exchange-specific)
+ * @returns Error code: 'insufficient' | 'below-minimum' | '' (valid)
+ */
+export declare function validateMargin(margin: number, leverage: number, availableBalance: number | null, feeRate: number | null, minMarginUsd: number): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/esm/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAcR"}

package/dist/esm/utils/validation.js

@@ -0,0 +1,26 @@
+/**
+ * Order validation utilities.
+ */
+/**
+ * Validate margin input against available balance and exchange minimums.
+ *
+ * @param margin - Margin amount in USD
+ * @param leverage - Position leverage
+ * @param availableBalance - Available balance, or null if unknown
+ * @param feeRate - Fee rate as decimal, or null if unknown
+ * @param minMarginUsd - Minimum margin requirement in USD (exchange-specific)
+ * @returns Error code: 'insufficient' | 'below-minimum' | '' (valid)
+ */
+export function validateMargin(margin, leverage, availableBalance, feeRate, minMarginUsd) {
+    if (margin <= 0) {
+        return '';
+    }
+    if (availableBalance !== null && margin > availableBalance) {
+        return 'insufficient';
+    }
+    if (margin < minMarginUsd) {
+        return 'below-minimum';
+    }
+    return '';
+}
+//# sourceMappingURL=validation.js.map

package/dist/esm/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,QAAgB,EAChB,gBAA+B,EAC/B,OAAsB,EACtB,YAAoB;IAEpB,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,gBAAgB,KAAK,IAAI,IAAI,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC3D,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,IAAI,MAAM,GAAG,YAAY,EAAE,CAAC;QAC1B,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,OAAO,EAAE,CAAA;AACX,CAAC"}

package/dist/esm/version.d.ts

@@ -1,3 +1,3 @@
 export declare const name = "@lifi/perps-sdk";
-export declare const version = "0.1.1-alpha.4";
+export declare const version = "0.1.1-alpha.40";
 //# sourceMappingURL=version.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,oBAAoB,CAAA;AACrC,eAAO,MAAM,OAAO,kBAAkB,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,oBAAoB,CAAA;AACrC,eAAO,MAAM,OAAO,mBAAmB,CAAA"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 export const name = '@lifi/perps-sdk';
-export const version = '0.1.1-alpha.4';
+export const version = '0.1.1-alpha.40';
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,iBAAiB,CAAA;AACrC,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAA"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,iBAAiB,CAAA;AACrC,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAA"}

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

@@ -2,7 +2,7 @@ import type { Address, Hex } from '@lifi/perps-types';
 import type { Agent, StorageAdapter } from './types.js';
 /**
  * Manages agent keypairs for USER_AGENT signing mode.
- * Agent keys are stored per user address + DEX combination.
+ * Agent keys are stored per user address + provider combination.
  */
 export declare class AgentManager {
     private storage;
@@ -13,29 +13,29 @@ export declare class AgentManager {
      */
     private storageKey;
     /**
-     * Get an existing agent for a user + DEX pair.
+     * Get an existing agent for a user + provider pair.
      *
      * @throws {PerpsError} If agent not found
      */
-    getAgent(address: Address, dex: string): Promise<Agent>;
+    getAgent(address: Address, provider: string): Promise<Agent>;
     /**
      * Get an existing agent or create a new one.
      */
-    getOrCreateAgent(address: Address, dex: string): Promise<Agent>;
+    getOrCreateAgent(address: Address, provider: string): Promise<Agent>;
     /**
-     * Check if an agent exists for a user + DEX pair.
+     * Check if an agent exists for a user + provider pair.
      */
-    hasAgent(address: Address, dex: string): Promise<boolean>;
+    hasAgent(address: Address, provider: string): Promise<boolean>;
     /**
-     * Remove an agent for a user + DEX pair.
+     * Remove an agent for a user + provider pair.
      * Call this when the user revokes agent authorization.
      */
-    removeAgent(address: Address, dex: string): Promise<void>;
+    removeAgent(address: Address, provider: string): Promise<void>;
     /**
      * Import an existing agent keypair.
      * Useful for restoring from backup or using a specific key.
      */
-    importAgent(address: Address, dex: string, privateKey: Hex): Promise<Agent>;
+    importAgent(address: Address, provider: string, privateKey: Hex): Promise<Agent>;
     /**
      * Clear all cached agents.
      * Does not remove from storage.

package/dist/types/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;AAIvD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAAgC;gBAEjC,OAAO,CAAC,EAAE,cAAc;IAIpC;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAuB7D;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAsBrE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/D;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D;;;OAGG;IACG,WAAW,CACf,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,KAAK,CAAC;IAejB;;;OAGG;IACH,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;AAIvD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAAgC;gBAEjC,OAAO,CAAC,EAAE,cAAc;IAIpC;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAyBlE;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAsB1E;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASpE;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE;;;OAGG;IACG,WAAW,CACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,KAAK,CAAC;IAejB;;;OAGG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/types/agent/storage.d.ts

@@ -2,7 +2,7 @@ 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}`
+ * `lifi-perps-agent:{address}:{provider}`
  */
 export declare const localStorageAdapter: StorageAdapter;
 /**

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

@@ -1,198 +1,79 @@
-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, Address, AssetIdentity, CreateActionResponse, ExecuteActionResponse, SignedActionStep } from '@lifi/perps-types';
+import { ActionType } from '@lifi/perps-types';
 import { type PerpsSDKClient } from './createPerpsClient.js';
-import type { BuildAuthorizationParams, BuildWithdrawalParams, 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
- *
- * @remarks
- * The example below uses Hyperliquid. Authorization keys and parameters are DEX-specific.
- *
- * @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')
- *
- * // Check and execute required authorizations
- * const required = await perps.getRequiredAuthorizations({
- *   dex: 'hyperliquid',
- *   address: userAddress,
- * })
- *
- * // ... 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'
- * })
- * ```
- */
+import { type BuildWithdrawalParams, type CancelOrdersParams, type CheckPrerequisitesParams, type ExecutePrerequisitesParams, type ExecutePrerequisitesResult, type GetPrerequisitesParams, type ModifyOrdersParams, type PerpsClientOptions, type PlaceOrderParams, type PlaceTriggerOrderParams, type PrerequisitesResult, SigningMode } from './types.js';
 export declare class PerpsClient {
     private sdkClient;
+    private storage;
     private signingModes;
+    private providerMetadataCache;
     constructor(options: PerpsClientOptions);
-    /**
-     * Get the underlying SDK client for use with service functions.
-     */
     get client(): PerpsSDKClient;
-    /**
-     * 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`.
-     *
-     * @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>;
-    /**
-     * Build a withdrawal payload for the user to sign.
-     *
-     * Withdrawals are user-signed only — agents cannot initiate withdrawals.
-     * No agent injection is performed regardless of signing mode.
-     *
-     * @param params - Withdrawal parameters
-     * @returns Withdrawal action with typed data for signing
-     */
-    buildWithdrawal(params: BuildWithdrawalParams): Promise<CreateWithdrawalResponse>;
-    /**
-     * Submit a signed withdrawal.
-     *
-     * Withdrawals are user-signed only — agents cannot initiate withdrawals.
-     *
-     * @param params - Signed withdrawal parameters
-     * @returns Withdrawal result
-     */
-    submitWithdrawal(params: SubmitWithdrawalParams): Promise<SubmitWithdrawalResponse>;
-    /**
-     * Determine which authorizations (if any) the user needs to sign before trading.
-     *
-     * Uses the dex auth provider to determine what authorizations to request,
-     * then calls buildAuthorization — the backend filters already-valid auths
-     * and returns only what's needed.
-     *
-     * @param params - Parameters including dex, address, and dex-specific config
-     * @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>;
+    private signingModeStorageKey;
+    private getProviderMetadata;
+    private buildPrerequisiteInputs;
+    private resolveSignerForAction;
+    private requireAgentMode;
+    private autoSignAndExecute;
+    buildAction<T extends ActionType>(action: T, params: {
+        provider: string;
+        address: Address;
+        params: ActionParamsMap[T];
+    }): Promise<CreateActionResponse>;
+    submitSignedAction(action: ActionType, params: {
+        provider: string;
+        address: Address;
+        actions: SignedActionStep[];
+    }): Promise<ExecuteActionResponse>;
+    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>;
+    checkPrerequisites(params: GetPrerequisitesParams): Promise<PrerequisitesResult>;
+    buildPrerequisites(params: CheckPrerequisitesParams): Promise<CreateActionResponse>;
+    executePrerequisites(params: ExecutePrerequisitesParams): Promise<ExecutePrerequisitesResult>;
+    buildOrder(params: PlaceOrderParams): Promise<CreateActionResponse>;
+    buildTriggerOrder(params: PlaceTriggerOrderParams): Promise<CreateActionResponse>;
+    buildCancelOrder(params: CancelOrdersParams): Promise<CreateActionResponse>;
+    buildModifyOrder(params: ModifyOrdersParams): Promise<CreateActionResponse>;
+    buildPositionMargin(params: {
+        provider: string;
+        address: Address;
+        asset: AssetIdentity;
+        action: 'add' | 'remove';
+        amount: string;
+    }): Promise<CreateActionResponse>;
+    buildWithdrawal(params: BuildWithdrawalParams): Promise<CreateActionResponse>;
+    submitSignedOrder(params: {
+        provider: string;
+        address: Address;
+        actions: SignedActionStep[];
+    }): Promise<ExecuteActionResponse>;
+    submitSignedPosition(params: {
+        provider: string;
+        address: Address;
+        actions: SignedActionStep[];
+    }): Promise<ExecuteActionResponse>;
+    submitWithdrawal(params: {
+        provider: string;
+        address: Address;
+        action: SignedActionStep;
+    }): Promise<ExecuteActionResponse>;
+    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>;
 }
 //# sourceMappingURL=PerpsClient.d.ts.map

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

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

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

@@ -1,14 +1,33 @@
 import { AgentManager } from '../agent/AgentManager.js';
 import type { StorageAdapter } from '../agent/types.js';
+export declare const DEFAULT_API_URL = "https://develop.li.quest/v1/perps";
+/**
+ * Per-provider configuration.
+ */
+export interface ProviderConfig {
+    /** Markets to include. Filters visible assets and various API calls. */
+    markets?: string[];
+}
+/**
+ * Provider-specific configuration for Hyperliquid.
+ * @deprecated Use ProviderConfig instead — this alias exists for backwards compatibility.
+ */
+export type HyperliquidConfig = ProviderConfig;
+/**
+ * Provider-specific configurations keyed by provider name.
+ */
+export interface ProviderConfigs {
+    [provider: string]: ProviderConfig | undefined;
+}
 /**
  * Configuration options for creating a Perps SDK client.
  */
 export interface PerpsConfig {
     /** Integrator identifier (required) */
     integrator: string;
-    /** Optional API key for authenticated requests */
-    apiKey?: string;
-    /** Base API URL. Defaults to https://li.quest/v1/perps */
+    /** API key for authenticated requests (get one at https://portal.li.fi/) */
+    apiKey: string;
+    /** Base API URL. Defaults to DEFAULT_API_URL */
     apiUrl?: string;
     /** Disable version update check in development mode */
     disableVersionCheck?: boolean;
@@ -16,6 +35,8 @@ export interface PerpsConfig {
     storage?: StorageAdapter;
     /** Optional request interceptor for custom handling */
     requestInterceptor?: RequestInterceptor;
+    /** Provider-specific configuration */
+    providers?: ProviderConfigs;
 }
 /**
  * Resolved configuration with required fields.
@@ -23,14 +44,16 @@ export interface PerpsConfig {
 export interface PerpsBaseConfig {
     /** Integrator identifier (required) */
     integrator: string;
-    /** Optional API key for authenticated requests */
-    apiKey?: string;
+    /** API key for authenticated requests */
+    apiKey: string;
     /** Resolved API URL (always set) */
     apiUrl: string;
     /** Disable version update check in development mode */
     disableVersionCheck?: boolean;
     /** Optional request interceptor for custom handling */
     requestInterceptor?: RequestInterceptor;
+    /** Provider-specific configuration */
+    providers?: ProviderConfigs;
 }
 /**
  * Request interceptor function type.
@@ -65,11 +88,11 @@ export interface PerpsSDKClient {
  * ```ts
  * const client = createPerpsClient({
  *   integrator: 'my-app',
- *   apiKey: 'optional-api-key',
+ *   apiKey: 'your-api-key',
  * })
  *
  * // Use with service functions
- * const { dexes } = await getDexes(client)
+ * const { providers } = await getProviders(client)
  * ```
  */
 export declare function createPerpsClient(options: PerpsConfig): PerpsSDKClient;

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

@@ -1 +1 @@
-{"version":3,"file":"createPerpsClient.d.ts","sourceRoot":"","sources":["../../../src/client/createPerpsClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAMvD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,uEAAuE;IACvE,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;CACxC;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,KACjB,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAEvC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CA8BtE"}
+{"version":3,"file":"createPerpsClient.d.ts","sourceRoot":"","sources":["../../../src/client/createPerpsClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGvD,eAAO,MAAM,eAAe,sCAAsC,CAAA;AAElE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,uEAAuE;IACvE,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,sCAAsC;IACtC,SAAS,CAAC,EAAE,eAAe,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,sCAAsC;IACtC,SAAS,CAAC,EAAE,eAAe,CAAA;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,KACjB,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAEvC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CA+BtE"}