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

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

@@ -1,198 +1,280 @@
-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';
-/**
- * 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 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;
     /**
-     * Get the underlying SDK client for use with service functions.
+     * Set or update the wallet signer. Used whenever an action's descriptor
+     * names the user wallet in its `signers` list. Pass undefined to clear.
      */
+    setSigner(signer: PerpsSDKClient['signer']): void;
     get client(): PerpsSDKClient;
-    /**
-     * Get the storage key for a user + DEX pair.
-     */
     private modeKey;
+    private signingModeStorageKey;
+    private getProviderMetadata;
     /**
-     * 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
+     * Action types that require explicit user input (a chosen mode or tier)
+     * and therefore cannot be bulk-staged through `buildPrerequisites` with
+     * empty params. Callers must dispatch these via `execute(...)` once a
+     * value is picked. The post-`APPROVE_AGENT` auto-upgrade path also
+     * dispatches `ACCOUNT_MODE` directly with `mode: 'unifiedAccount'`.
      */
-    setSigningMode(address: Address, dex: string, mode: SigningMode): Promise<void>;
+    private static readonly EXPLICIT_INPUT_PREREQUISITES;
+    private buildPrerequisiteInputs;
+    private resolveSignerForAction;
     /**
-     * Get the current signing mode for a user + DEX pair.
-     * Defaults to `USER` if not set.
+     * True if any descriptor for the provider lists `PerpsSigner.AGENT`.
+     * Providers like Lighter sign with their own keystore and never need an
+     * AgentManager-managed agent.
      */
-    getSigningMode(address: Address, dex: string): SigningMode;
+    private providerUsesAgent;
+    private autoSignAndExecute;
     /**
-     * Get the agent address for a user + DEX pair.
-     *
-     * @throws {PerpsError} If in USER mode or agent not found
+     * Sign a single prerequisite step using whichever signing path matches the
+     * step's shape — EIP-712 typed data, WASM blob (with the hybrid EIP-191 +
+     * WASM flow for REGISTER_API_KEY), or EVM transaction. Lets consumers
+     * collect signed prereqs without embedding per-method signing logic.
      */
-    getAgentAddress(address: Address, dex: string): Promise<Address>;
+    signPrerequisite(provider: string, address: Address, step: ActionStep): Promise<SignedActionStep>;
     /**
-     * Check if an agent exists for a user + DEX pair.
+     * Sign and broadcast a sequence of EVM transactions via the user's wallet
+     * client. Steps are submitted serially so a later step (e.g. deposit) can
+     * rely on an earlier step (e.g. approve) having mined. Each step's
+     * `txParams` carries chainId, target, function name, args, and a
+     * human-readable abi from the backend.
      */
-    hasAgent(address: Address, dex: string): Promise<boolean>;
+    private signEvmTxActions;
     /**
-     * Remove the agent for a user + DEX pair.
-     * Also resets signing mode to USER.
+     * Sign a batch of WASM_BLOB action steps (Lighter). Ensures the user's
+     * Lighter API keypair is registered first — generating one and running the
+     * REGISTER_API_KEY hybrid flow via the L1 signer if not — then feeds each
+     * subsequent step through the WASM signer and returns signed blobs.
+     *
+     * `ACCOUNT_TYPE` (Lighter `/api/v1/changeAccountTier`) is dispatched as a
+     * WASM_BLOB envelope by the backend but is NOT a wasm-signed transaction —
+     * Lighter authenticates the endpoint with an auth token and enforces
+     * anti-replay server-side (24h cooldown, no open positions). The signer
+     * mints a Lighter auth token via the same WASM `CreateAuthToken` the read
+     * endpoints use and parks it in `signedTx.txInfo`; the backend's
+     * `executeChangeAccountTier` consumes that field as the `auth` form
+     * parameter. `txType`/`txHash` are unused for this action — they carry
+     * placeholder values to satisfy the `WasmBlobSignedActionStep` shape.
      */
-    removeAgent(address: Address, dex: string): Promise<void>;
+    private signWasmBlobActions;
+    private signStandardWasmAction;
     /**
-     * Build authorization payloads for signing.
+     * REGISTER_API_KEY flow:
+     *   1. Look up the user's Lighter accountIndex from getAccount()
+     *   2. Generate a fresh Lighter API keypair via the WASM signer
+     *   3. Call SignChangePubKey to produce the WASM blob + EIP-191 message
+     *   4. Have the user's L1 Ethereum wallet sign the message
+     *   5. Inject the L1 signature into the ChangePubKey txInfo JSON
+     *   6. Persist the keypair and return the signed blob
      *
-     * 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
+     * Requires a USER wallet signer to be set via `setSigner` or passed at
+     * construction — the L1 signature is the user's consent to rotate keys.
      */
-    buildAuthorization(params: BuildAuthorizationParams): Promise<CreateAuthorizationResponse>;
+    private signRegisterApiKey;
     /**
-     * Submit signed authorizations.
+     * Sign an `ACCOUNT_TYPE` step (Lighter `changeAccountTier`).
      *
-     * In `USER` mode, `signerAddress` is omitted (backend defaults to `address`).
-     * In `USER_AGENT` mode, auto-injects the agent address as `signerAddress`.
+     * Lighter's `/api/v1/changeAccountTier` is an HTTP-only mutation —
+     * Lighter does NOT consume a wasm-signed transaction here; it
+     * authenticates the request with the same auth token its read endpoints
+     * use, and enforces anti-replay business rules server-side. The backend
+     * therefore declares the step as a `WasmBlobActionStep` with
+     * `wasmSignParams.kind = 'changeAccountTier'` and expects the SDK to
+     * mint an auth token in lieu of a transaction signature. That contract
+     * is documented in `lifi-perps-backend/src/providers/lighter/actions/
+     * lighter.actions.accountType.ts` and consumed by `executeChangeAccountTier`.
      *
-     * @param params - Signed authorization parameters
+     * The auth-token deadline mirrors {@link createLighterAuthToken}'s 1h
+     * default — Lighter caps tokens at 8h hard, and the backend's executor
+     * runs `verifyPendingAction` then a single `/changeAccountTier` POST,
+     * which completes well inside an hour.
      */
-    submitAuthorizations(params: SubmitAuthorizationParams): Promise<AuthorizationsResponse>;
+    private signAccountTierChange;
     /**
-     * Build order payloads for signing.
+     * Return a bearer token that authenticates Lighter's read endpoints
+     * (getOrders, getOrder, getActivity, getFills).
+     *
+     * Resolution order:
+     *   1. The long-lived read-only token persisted by `approveReadOnlyToken`,
+     *      when one is stored for this `(address, accountIndex)` AND has not
+     *      passed its recorded `expiry`. The SDK never returns an expired
+     *      stored token.
+     *   2. A freshly minted 8h Lighter auth token, signed off the user's
+     *      Lighter API key. Requires `REGISTER_API_KEY` to have completed.
+     *   3. `undefined` — caller falls back to public reads.
      *
-     * In `USER` mode, `signerAddress` is omitted (backend defaults to `address`).
-     * In `USER_AGENT` mode, auto-injects the agent address as `signerAddress`.
+     * `accountIndex` lets callers in pure read-only mode (no API key
+     * registered) target the RO token. When omitted, the SDK derives it from
+     * the user's registered API key.
      *
-     * @param params - Order parameters
-     * @returns Order actions with typed data for signing
+     * `deadlineSeconds` only affects the standard-token fallback (Lighter caps
+     * those tokens at 8h). Read-only tokens carry their own mint-time expiry
+     * recorded by {@link approveReadOnlyToken}.
      */
-    buildOrder(params: PlaceOrderParams): Promise<CreateOrderResponse>;
+    createLighterAuthToken(address: Address, deadlineSeconds?: number, accountIndex?: number): Promise<string | undefined>;
     /**
-     * Build cancel order payloads for signing.
+     * Mint a long-lived Lighter read-only token via Lighter's
+     * `tokens/create` endpoint and persist it through the configured
+     * `StorageAdapter`, keyed by `(L1 address, accountIndex)`.
+     *
+     * The user's connected wallet signs an EIP-191 message describing the
+     * mint request; the resulting `Authorization` header authenticates the
+     * Lighter HTTP call. The bearer string Lighter returns is persisted
+     * alongside its `expiry` and `scope`; subsequent calls to
+     * {@link createLighterAuthToken} prefer it over the 8h standard token.
      *
-     * In `USER` mode, `signerAddress` is omitted (backend defaults to `address`).
-     * In `USER_AGENT` mode, auto-injects the agent address as `signerAddress`.
+     * `expirySeconds` is the absolute unix-seconds expiry recorded on
+     * Lighter's row. Lighter enforces 1 day ≤ lifetime ≤ 10 years
+     * server-side; the SDK does NOT pre-validate and surfaces Lighter's 400
+     * verbatim. `scope` defaults to `'all'`; the `'single'` variant is wired
+     * through but only useful when the caller has a specific reason to scope
+     * the token to one account.
      *
-     * @param params - Cancel parameters
-     * @returns Cancel actions with typed data for signing
+     * Requires a USER wallet signer to be set via {@link setSigner} or
+     * passed at construction — the L1 signature is the user's consent.
      */
-    buildCancelOrder(params: CancelOrdersParams): Promise<CancelOrderPayloadResponse>;
+    approveReadOnlyToken(address: Address, params: ApproveReadOnlyTokenParams): Promise<ApproveReadOnlyTokenResult>;
     /**
-     * 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
+     * Whether the stored Lighter read-only token for `(address, accountIndex)`
+     * falls within `thresholdDays` of its `expiry`. Returns `false` when no
+     * token is stored, when the stored token has already expired, or when
+     * more than `thresholdDays` of life remain. Intended for widget renewal
+     * banners (default threshold: 30 days).
      */
-    placeOrder(params: PlaceOrderParams): Promise<SubmitOrderResponse>;
+    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>;
     /**
-     * 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
+     * Fetch the user's account state from the backend and attach the
+     * SDK-projected `settings` array — one `AccountConfigSetting` per
+     * descriptor on `Provider.setup` + `Provider.options`. Callers read
+     * `result.settings` directly without re-deriving values from the typed
+     * `AccountConfig`.
      */
-    cancelOrders(params: CancelOrdersParams): Promise<SubmitOrderResponse>;
+    getAccount(params: {
+        provider: string;
+        address: Address;
+    }): Promise<GetAccountResult>;
     /**
-     * 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
+     * Thin existence check for a provider account at `address`. Returns
+     * `true` when `getAccount` resolves, `false` when the backend reports
+     * `PerpsErrorCode.AccountNotFound`, and re-throws on any other error
+     * (transport failures, validation errors, server errors).
      */
-    submitSignedOrder(params: SubmitOrderParams): Promise<SubmitOrderResponse>;
+    accountExists(provider: string, address: Address): Promise<boolean>;
     /**
-     * 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.
+     * Return the unsatisfied entries on `Provider.setup` for this account,
+     * split by signer role. Trading is gated on `isReady === true`.
      *
-     * @param params - Withdrawal parameters
-     * @returns Withdrawal action with typed data for signing
+     * `Provider.options` descriptors are NEVER returned here — options are
+     * post-setup tunables and never gate trading. Option state is surfaced
+     * separately via `getAccount().settings`.
      */
-    buildWithdrawal(params: BuildWithdrawalParams): Promise<CreateWithdrawalResponse>;
+    checkSetup(params: GetSetupParams): Promise<SetupResult>;
+    buildPrerequisites(params: CheckPrerequisitesParams): Promise<CreateActionResponse>;
     /**
-     * Submit a signed withdrawal.
-     *
-     * Withdrawals are user-signed only — agents cannot initiate withdrawals.
-     *
-     * @param params - Signed withdrawal parameters
-     * @returns Withdrawal result
+     * Default mode the SDK auto-applies after `APPROVE_AGENT` on a provider
+     * whose `options` array exposes a writable `ACCOUNT_MODE` (today
+     * Hyperliquid). Callers can override this through a subsequent
+     * `ACCOUNT_MODE` dispatch.
      */
-    submitWithdrawal(params: SubmitWithdrawalParams): Promise<SubmitWithdrawalResponse>;
+    private static readonly DEFAULT_ACCOUNT_MODE;
     /**
-     * Determine which authorizations (if any) the user needs to sign before trading.
+     * Prepare an `ACCOUNT_MODE` change by proactively reading the account's
+     * current `config.abstractionMode` and routing to the correct signer:
      *
-     * 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.
+     * - `abstractionMode == null` (never set, e.g. a fresh HL account):
+     *   the change MAY be performed by the agent signer. Build, sign with
+     *   the agent key, and dispatch. Returns `{ results }`.
+     * - `abstractionMode === mode`: idempotent no-op. Returns an empty
+     *   results envelope without contacting `/createAction` or `/executeAction`.
+     * - `abstractionMode` set to any other value: HL requires a user-wallet
+     *   signature to change the abstraction once it has been set. Build the
+     *   action unsigned and return it as `{ fallback }` so the caller can
+     *   surface a wallet prompt via `fallbackUserPrerequisites`.
      *
-     * @param params - Parameters including dex, address, and dex-specific config
-     * @returns Which authorizations are needed and whether the user is ready to trade
+     * Network errors from `/account` propagate — we never guess the signer.
+     * `account.config.provider !== 'hyperliquid'` also throws: this helper
+     * is HL-specific and the dispatcher should never reach it for another
+     * provider (gated by `hasWritableAccountMode`).
+     */
+    private prepareAccountModeChange;
+    /**
+     * True when the provider exposes an `ACCOUNT_MODE` descriptor (in `setup`
+     * or `options`) whose `mode` Param has a writable enumeration of values.
+     * Providers that omit `ACCOUNT_MODE` or expose it as read-only / free-form
+     * input return false.
      */
-    getRequiredAuthorizations(params: GetRequiredAuthorizationsParams): Promise<RequiredAuthorizationsResult>;
+    private static hasWritableAccountMode;
     /**
-     * Execute authorizations: submit user-signed actions, then auto-sign and submit
-     * any agent authorizations.
+     * Submit the signed setup steps returned by `checkSetup` (and seeded
+     * with user-wallet signatures by the caller). Internally splits into:
      *
-     * @param params - User-signed actions and the required authorizations result
-     * @returns Combined results from user and agent submissions
+     *   1. Submit user-signed setup actions.
+     *   2. After a successful `APPROVE_AGENT`, auto-upgrade `ACCOUNT_MODE`
+     *      to the SDK's default when the provider exposes a writable
+     *      `ACCOUNT_MODE` Param (Hyperliquid today). The SDK reads
+     *      `account.config.abstractionMode` to choose the signer: `null` →
+     *      agent dispatch; non-null → wallet fallback returned in
+     *      `fallbackUserPrerequisites`.
+     *   3. Sign and submit any pre-staged agent-side setup actions the
+     *      backend returned alongside the user-signed ones.
+     */
+    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 any action through the SDK's signing pipeline. Signing is routed
+     * by the action's descriptor in provider metadata — the agent keypair, the
+     * configured WalletClient signer, the Lighter API key, or an EVM tx — as
+     * the descriptor's `signers` and `signingMethod` dictate.
      */
-    executeAuthorizations(params: ExecuteAuthorizationsParams): Promise<ExecuteAuthorizationsResult>;
+    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/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,77 +1,56 @@
+import type { Account, WalletClient } from 'viem';
 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";
-/**
- * Configuration options for creating a Perps SDK client.
- */
+export interface ProviderConfig {
+    markets?: string[];
+}
+/** @deprecated Use ProviderConfig */
+export type HyperliquidConfig = ProviderConfig;
+export interface ProviderConfigs {
+    [provider: string]: ProviderConfig | undefined;
+}
 export interface PerpsConfig {
-    /** Integrator identifier (required) */
     integrator: string;
-    /** Optional API key for authenticated requests */
-    apiKey?: string;
-    /** Base API URL. Defaults to DEFAULT_API_URL */
+    apiKey: string;
     apiUrl?: string;
-    /** Disable version update check in development mode */
     disableVersionCheck?: boolean;
-    /** Custom storage adapter for agent keys. Defaults to localStorage. */
     storage?: StorageAdapter;
-    /** Optional request interceptor for custom handling */
     requestInterceptor?: RequestInterceptor;
+    providers?: ProviderConfigs;
+    /**
+     * Wallet signer used whenever an action's descriptor names the user wallet
+     * in its `signers` list. Accepts any viem-compatible WalletClient:
+     *   - Browser wallet: wagmi's useWalletClient() result
+     *   - Private key:    createWalletClient({ account: privateKeyToAccount('0x...'), transport: http() })
+     *   - Mnemonic:       createWalletClient({ account: mnemonicToAccount('word1 ...'), transport: http() })
+     */
+    signer?: WalletClient<any, any, Account>;
 }
-/**
- * Resolved configuration with required fields.
- */
 export interface PerpsBaseConfig {
-    /** Integrator identifier (required) */
     integrator: string;
-    /** Optional API key for authenticated requests */
-    apiKey?: string;
-    /** Resolved API URL (always set) */
+    apiKey: string;
     apiUrl: string;
-    /** Disable version update check in development mode */
     disableVersionCheck?: boolean;
-    /** Optional request interceptor for custom handling */
     requestInterceptor?: RequestInterceptor;
+    providers?: ProviderConfigs;
 }
-/**
- * Request interceptor function type.
- * Called before each request is made, allowing modification of fetch options.
- */
 export type RequestInterceptor = (url: string, options: RequestInit) => RequestInit | Promise<RequestInit>;
-/**
- * Options passed to service functions for request control.
- */
 export interface SDKRequestOptions {
-    /** AbortSignal to cancel the request */
     signal?: AbortSignal;
+    /**
+     * Lighter auth token for authenticated read endpoints (getOrders, getOrder,
+     * getActivity). Mint via `lighterSigner.createAuthToken(deadline, context)`.
+     * Forwarded as `Authorization: Bearer <token>` and never persisted by the
+     * backend — read-only by design (8h max TTL, cannot authorize writes).
+     */
+    lighterAuthToken?: string;
 }
-/**
- * The Perps SDK client instance.
- * Holds configuration and agent manager for making API requests.
- */
 export interface PerpsSDKClient {
-    /** SDK configuration */
     readonly config: PerpsBaseConfig;
-    /** Agent manager for USER_AGENT signing mode */
     readonly agentManager: AgentManager;
+    /** Wallet signer for setup actions — accepts any viem WalletClient (browser, private key, mnemonic). */
+    readonly signer?: WalletClient<any, any, Account>;
 }
-/**
- * Create a new Perps SDK client.
- *
- * @param options - Configuration options
- * @returns A new SDK client instance
- * @throws {PerpsError} If integrator is not provided
- *
- * @example
- * ```ts
- * const client = createPerpsClient({
- *   integrator: 'my-app',
- *   apiKey: 'optional-api-key',
- * })
- *
- * // Use with service functions
- * const { dexes } = await getDexes(client)
- * ```
- */
 export declare function createPerpsClient(options: PerpsConfig): PerpsSDKClient;
 //# sourceMappingURL=createPerpsClient.d.ts.map

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;AAIvD,eAAO,MAAM,eAAe,sCAAsC,CAAA;AAElE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,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;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,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGvD,eAAO,MAAM,eAAe,sCAAsC,CAAA;AAElE,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,qCAAqC;AACrC,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,MAAM,WAAW,eAAe;IAC9B,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;CAC/C;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,SAAS,CAAC,EAAE,eAAe,CAAA;CAC5B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,KACjB,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAEvC,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,wGAAwG;IACxG,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;CAClD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAkCtE"}

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

@@ -0,0 +1,18 @@
+import type { AccountConfig, AccountConfigSetting, ProviderOption, ProviderSetup } from '@lifi/perps-types';
+/**
+ * Project a typed `AccountConfig` against the provider's `setup` + `options`
+ * descriptors into `AccountConfigSetting[]`.
+ *
+ * Switches on `config.provider` to pick the per-provider mapper. The
+ * `assertNever` exhaustiveness check in the `default` arm forces a compile
+ * error whenever a new variant is added to `AccountConfig`.
+ *
+ * Produces exactly one `AccountConfigSetting` per descriptor in
+ * `setup`-then-`options` order.
+ *
+ * @param config Typed account-state union (discriminated on `provider`).
+ * @param setup  `Provider.setup` from the matching provider metadata.
+ * @param options `Provider.options` from the matching provider metadata.
+ */
+export declare function projectAccountConfigSettings(config: AccountConfig, setup: ProviderSetup[], options: ProviderOption[]): AccountConfigSetting[];
+//# sourceMappingURL=projectAccountConfigSettings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectAccountConfigSettings.d.ts","sourceRoot":"","sources":["../../../src/client/projectAccountConfigSettings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,aAAa,EACd,MAAM,mBAAmB,CAAA;AAK1B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,EAAE,cAAc,EAAE,GACxB,oBAAoB,EAAE,CASxB"}