@lifi/perps-sdk 0.1.1-alpha.0

package/dist/esm/client/PerpsClient.js

@@ -0,0 +1,512 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsErrorMessage } from '../errors/constants.js';
+import { PerpsError } from '../errors/PerpsError.js';
+import { cancelOrder } from '../services/cancelOrder.js';
+import { createAuthorization } from '../services/createAuthorization.js';
+import { createOrder } from '../services/createOrder.js';
+import { getAccount } from '../services/getAccount.js';
+import { getDexes } from '../services/getDexes.js';
+import { submitAuthorization } from '../services/submitAuthorization.js';
+import { submitOrder } from '../services/submitOrder.js';
+import { signTypedData } from '../utils/signTypedData.js';
+import { createPerpsClient } from './createPerpsClient.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 class PerpsClient {
+    sdkClient;
+    signingModes = new Map();
+    constructor(options) {
+        this.sdkClient = createPerpsClient({
+            integrator: options.integrator,
+            apiKey: options.apiKey,
+            apiUrl: options.apiUrl,
+            storage: options.storage,
+            healthCheck: options.healthCheck,
+        });
+    }
+    /**
+     * Get the underlying SDK client for use with service functions.
+     */
+    get client() {
+        return this.sdkClient;
+    }
+    /**
+     * Promise that resolves when the API health check passes.
+     * Await this before making requests if you need to handle readiness explicitly.
+     */
+    get ready() {
+        return this.sdkClient.ready;
+    }
+    /**
+     * Get the storage key for a user + DEX pair.
+     */
+    modeKey(address, dex) {
+        return `${address.toLowerCase()}:${dex.toLowerCase()}`;
+    }
+    /**
+     * 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
+     */
+    async setSigningMode(address, dex, mode) {
+        const key = this.modeKey(address, dex);
+        this.signingModes.set(key, mode);
+        if (mode === 'USER_AGENT') {
+            // Generate agent keypair if not exists
+            await this.sdkClient.agentManager.getOrCreateAgent(address, dex);
+        }
+    }
+    /**
+     * Get the current signing mode for a user + DEX pair.
+     * Defaults to `USER` if not set.
+     */
+    getSigningMode(address, dex) {
+        return this.signingModes.get(this.modeKey(address, dex)) ?? 'USER';
+    }
+    /**
+     * Get the agent address for a user + DEX pair.
+     *
+     * @throws {PerpsError} If in USER mode or agent not found
+     */
+    async getAgentAddress(address, dex) {
+        const agent = await this.sdkClient.agentManager.getAgent(address, dex);
+        return agent.address;
+    }
+    /**
+     * Check if an agent exists for a user + DEX pair.
+     */
+    async hasAgent(address, dex) {
+        return this.sdkClient.agentManager.hasAgent(address, dex);
+    }
+    /**
+     * Remove the agent for a user + DEX pair.
+     * Also resets signing mode to USER.
+     */
+    async removeAgent(address, dex) {
+        await this.sdkClient.agentManager.removeAgent(address, dex);
+        this.signingModes.delete(this.modeKey(address, dex));
+    }
+    /**
+     * 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
+     */
+    async buildAuthorization(params) {
+        const mode = this.getSigningMode(params.address, params.dex);
+        let { signerAddress, authorizations } = params;
+        if (mode === 'USER_AGENT') {
+            const agent = await this.sdkClient.agentManager.getAgent(params.address, params.dex);
+            signerAddress = signerAddress ?? agent.address;
+            // Auto-inject agentAddress for ApproveAgent authorization
+            authorizations = authorizations.map((auth) => {
+                if (auth.key === 'ApproveAgent' && !auth.params?.agentAddress) {
+                    return {
+                        ...auth,
+                        params: { ...auth.params, agentAddress: agent.address },
+                    };
+                }
+                return auth;
+            });
+        }
+        return createAuthorization(this.sdkClient, {
+            ...params,
+            signerAddress,
+            authorizations,
+        });
+    }
+    /**
+     * 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
+     */
+    async submitAuthorizations(params) {
+        const mode = this.getSigningMode(params.address, params.dex);
+        let { signerAddress } = params;
+        if (mode === 'USER_AGENT') {
+            const agent = await this.sdkClient.agentManager.getAgent(params.address, params.dex);
+            signerAddress = signerAddress ?? agent.address;
+        }
+        return submitAuthorization(this.sdkClient, { ...params, signerAddress });
+    }
+    /**
+     * 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
+     */
+    async buildOrder(params) {
+        const mode = this.getSigningMode(params.address, params.dex);
+        let signerAddress;
+        if (mode === 'USER_AGENT') {
+            const agent = await this.sdkClient.agentManager.getAgent(params.address, params.dex);
+            signerAddress = agent.address;
+        }
+        return createOrder(this.sdkClient, {
+            dex: params.dex,
+            address: params.address,
+            signerAddress,
+            clientOrderId: params.clientOrderId,
+            symbol: params.symbol,
+            side: params.side,
+            type: params.type,
+            size: params.size,
+            price: params.price,
+            leverage: params.leverage,
+            reduceOnly: params.reduceOnly,
+            timeInForce: params.timeInForce,
+            expiresAt: params.expiresAt,
+            takeProfit: params.takeProfit,
+            stopLoss: params.stopLoss,
+        });
+    }
+    /**
+     * 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
+     */
+    async buildCancelOrder(params) {
+        const mode = this.getSigningMode(params.address, params.dex);
+        let signerAddress;
+        if (mode === 'USER_AGENT') {
+            const agent = await this.sdkClient.agentManager.getAgent(params.address, params.dex);
+            signerAddress = agent.address;
+        }
+        return cancelOrder(this.sdkClient, {
+            dex: params.dex,
+            address: params.address,
+            signerAddress,
+            ids: params.ids,
+        });
+    }
+    /**
+     * 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
+     */
+    async placeOrder(params) {
+        const mode = this.getSigningMode(params.address, params.dex);
+        if (mode !== 'USER_AGENT') {
+            throw new PerpsError(PerpsErrorCode.ValidationError, `${PerpsErrorMessage.InvalidSigningMode} placeOrder() requires USER_AGENT mode. Use createOrder() + submitOrder() for USER mode.`);
+        }
+        const agent = await this.sdkClient.agentManager.getAgent(params.address, params.dex);
+        // 1. Create order payloads
+        const { actions } = await createOrder(this.sdkClient, {
+            dex: params.dex,
+            address: params.address,
+            signerAddress: agent.address,
+            clientOrderId: params.clientOrderId,
+            symbol: params.symbol,
+            side: params.side,
+            type: params.type,
+            size: params.size,
+            price: params.price,
+            leverage: params.leverage,
+            reduceOnly: params.reduceOnly,
+            timeInForce: params.timeInForce,
+            expiresAt: params.expiresAt,
+            takeProfit: params.takeProfit,
+            stopLoss: params.stopLoss,
+        });
+        // 2. Sign each action with agent key
+        const signedActions = await Promise.all(actions.map(async (a) => ({
+            action: a.action,
+            typedData: a.typedData,
+            signature: await signTypedData(agent.privateKey, a.typedData),
+        })));
+        // 3. Submit
+        return submitOrder(this.sdkClient, {
+            dex: params.dex,
+            address: params.address,
+            signerAddress: agent.address,
+            actions: signedActions,
+        });
+    }
+    /**
+     * 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
+     */
+    async cancelOrders(params) {
+        const mode = this.getSigningMode(params.address, params.dex);
+        if (mode !== 'USER_AGENT') {
+            throw new PerpsError(PerpsErrorCode.ValidationError, `${PerpsErrorMessage.InvalidSigningMode} cancelOrders() requires USER_AGENT mode. Use cancelOrder() + submitOrder() for USER mode.`);
+        }
+        const agent = await this.sdkClient.agentManager.getAgent(params.address, params.dex);
+        // 1. Create cancel payloads
+        const { actions } = await cancelOrder(this.sdkClient, {
+            dex: params.dex,
+            address: params.address,
+            signerAddress: agent.address,
+            ids: params.ids,
+        });
+        // 2. Sign each action with agent key
+        const signedActions = await Promise.all(actions.map(async (a) => ({
+            action: a.action,
+            typedData: a.typedData,
+            signature: await signTypedData(agent.privateKey, a.typedData),
+        })));
+        // 3. Submit
+        return submitOrder(this.sdkClient, {
+            dex: params.dex,
+            address: params.address,
+            signerAddress: agent.address,
+            actions: signedActions,
+        });
+    }
+    /**
+     * 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
+     */
+    async submitSignedOrder(params) {
+        return submitOrder(this.sdkClient, params);
+    }
+    /**
+     * 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
+     */
+    async getRequiredAuthorizations(params) {
+        const { dex, address, requireAbstraction = false } = params;
+        const mode = this.getSigningMode(address, dex);
+        // Fetch account state and dex config in parallel
+        const [account, dexesResponse] = await Promise.all([
+            getAccount(this.sdkClient, { dex, address }),
+            getDexes(this.sdkClient),
+        ]);
+        const dexConfig = dexesResponse.dexes.find((d) => d.key === dex);
+        const hasBuilderFee = dexConfig?.authorizations.some((a) => a.key === 'ApproveBuilderFee') ??
+            false;
+        const rawAbstraction = account.config.abstractionStatus;
+        const abstractionStatus = rawAbstraction ?? null;
+        const agents = account.config.agents;
+        const userAuthorizations = [];
+        const agentAuthorizations = [];
+        if (mode === 'USER') {
+            // USER mode: no agent-related authorizations
+            if (requireAbstraction && !isAbstractionEnabled(abstractionStatus)) {
+                userAuthorizations.push({
+                    key: 'UserSetAbstraction',
+                    params: { abstraction: 'unifiedAccount' },
+                });
+            }
+            return {
+                userAuthorizations,
+                agentAuthorizations,
+                agentValid: false,
+                abstractionStatus,
+                isReady: userAuthorizations.length === 0,
+            };
+        }
+        // USER_AGENT mode: check agent validity
+        const agentValid = await this.validateAgent(address, dex, agents);
+        if (!agentValid) {
+            // Need to approve agent (+ builder fee if configured)
+            userAuthorizations.push({ key: 'ApproveAgent' });
+            if (hasBuilderFee) {
+                userAuthorizations.push({ key: 'ApproveBuilderFee' });
+            }
+            // Abstraction handling when agent is not yet valid
+            if (requireAbstraction && !isAbstractionEnabled(abstractionStatus)) {
+                if (abstractionStatus === null) {
+                    // null → agent can't auto-enable yet (not approved), user must set it
+                    userAuthorizations.push({
+                        key: 'UserSetAbstraction',
+                        params: { abstraction: 'unifiedAccount' },
+                    });
+                }
+                else {
+                    // 'disabled' → user must re-enable
+                    userAuthorizations.push({
+                        key: 'UserSetAbstraction',
+                        params: { abstraction: 'unifiedAccount' },
+                    });
+                }
+            }
+        }
+        else {
+            // Agent is valid - check abstraction only
+            if (requireAbstraction && !isAbstractionEnabled(abstractionStatus)) {
+                if (abstractionStatus === null) {
+                    // null → agent can auto-enable (no user signature needed)
+                    agentAuthorizations.push({
+                        key: 'AgentSetAbstraction',
+                        params: { abstraction: 'unifiedAccount' },
+                    });
+                }
+                else {
+                    // 'disabled' → user must re-enable
+                    userAuthorizations.push({
+                        key: 'UserSetAbstraction',
+                        params: { abstraction: 'unifiedAccount' },
+                    });
+                }
+            }
+        }
+        const isReady = userAuthorizations.length === 0 && agentAuthorizations.length === 0;
+        return {
+            userAuthorizations,
+            agentAuthorizations,
+            agentValid,
+            abstractionStatus,
+            isReady,
+        };
+    }
+    /**
+     * 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
+     */
+    async executeAuthorizations(params) {
+        const { dex, address, required, userSignedActions } = params;
+        const mode = this.getSigningMode(address, dex);
+        // 1. Submit user-signed actions (if any)
+        let userResults = { results: [] };
+        if (userSignedActions.length > 0) {
+            const signerAddress = mode === 'USER_AGENT'
+                ? (await this.sdkClient.agentManager.getAgent(address, dex)).address
+                : address;
+            userResults = await submitAuthorization(this.sdkClient, {
+                dex,
+                address,
+                signerAddress,
+                actions: userSignedActions,
+            });
+            // Check for failures - return early if any user auth failed
+            const failed = userResults.results.find((r) => !r.success);
+            if (failed) {
+                return { userResults };
+            }
+        }
+        // 2. Auto-sign and submit agent authorizations (if any)
+        if (required.agentAuthorizations.length > 0 && mode === 'USER_AGENT') {
+            const agent = await this.sdkClient.agentManager.getAgent(address, dex);
+            // Build typed data for agent authorizations
+            const { actions } = await createAuthorization(this.sdkClient, {
+                dex,
+                address,
+                signerAddress: agent.address,
+                authorizations: required.agentAuthorizations,
+            });
+            // Sign with agent key
+            const signedAgentActions = await Promise.all(actions.map(async (action) => ({
+                action: action.action,
+                typedData: action.typedData,
+                signature: await signTypedData(agent.privateKey, action.typedData),
+            })));
+            // Submit agent-signed actions
+            const agentResults = await submitAuthorization(this.sdkClient, {
+                dex,
+                address,
+                signerAddress: agent.address,
+                actions: signedAgentActions,
+            });
+            return { userResults, agentResults };
+        }
+        return { userResults };
+    }
+    /**
+     * Check if the local agent is registered and valid on the backend.
+     */
+    async validateAgent(address, dex, backendAgents) {
+        const hasLocal = await this.sdkClient.agentManager.hasAgent(address, dex);
+        if (!hasLocal) {
+            return false;
+        }
+        const agent = await this.sdkClient.agentManager.getAgent(address, dex);
+        if (!backendAgents) {
+            return false;
+        }
+        const match = backendAgents.find((a) => a.address.toLowerCase() === agent.address.toLowerCase());
+        if (!match) {
+            return false;
+        }
+        return match.validUntil > Date.now();
+    }
+}
+/**
+ * Check if abstraction is enabled based on the status string.
+ * Enabled statuses: 'unifiedAccount', 'portfolioMargin'
+ * Not enabled: null (never set), 'disabled'
+ */
+function isAbstractionEnabled(status) {
+    return status !== null && status !== 'disabled';
+}
+//# sourceMappingURL=PerpsClient.js.map

package/dist/esm/client/PerpsClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerpsClient.js","sourceRoot":"","sources":["../../../src/client/PerpsClient.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAuB,MAAM,wBAAwB,CAAA;AAa/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,OAAO,WAAW;IACd,SAAS,CAAgB;IACzB,YAAY,GAA6B,IAAI,GAAG,EAAE,CAAA;IAE1D,YAAY,OAA2B;QACrC,IAAI,CAAC,SAAS,GAAG,iBAAiB,CAAC;YACjC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAA;IAC7B,CAAC;IAED;;OAEG;IACK,OAAO,CAAC,OAAgB,EAAE,GAAW;QAC3C,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAA;IACxD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,CAClB,OAAgB,EAChB,GAAW,EACX,IAAiB;QAEjB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACtC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAEhC,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,uCAAuC;YACvC,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,OAAgB,EAAE,GAAW;QAC1C,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,MAAM,CAAA;IACpE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,OAAgB,EAAE,GAAW;QACjD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACtE,OAAO,KAAK,CAAC,OAAO,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAgB,EAAE,GAAW;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC3D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,OAAgB,EAAE,GAAW;QAC7C,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAC3D,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;IACtD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,kBAAkB,CACtB,MAAgC;QAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAC5D,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,MAAM,CAAA;QAE9C,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CACtD,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,GAAG,CACX,CAAA;YACD,aAAa,GAAG,aAAa,IAAI,KAAK,CAAC,OAAO,CAAA;YAE9C,0DAA0D;YAC1D,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC3C,IAAI,IAAI,CAAC,GAAG,KAAK,cAAc,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;oBAC9D,OAAO;wBACL,GAAG,IAAI;wBACP,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE;qBACxD,CAAA;gBACH,CAAC;gBACD,OAAO,IAAI,CAAA;YACb,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE;YACzC,GAAG,MAAM;YACT,aAAa;YACb,cAAc;SACf,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,oBAAoB,CACxB,MAAiC;QAEjC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAC5D,IAAI,EAAE,aAAa,EAAE,GAAG,MAAM,CAAA;QAE9B,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CACtD,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,GAAG,CACX,CAAA;YACD,aAAa,GAAG,aAAa,IAAI,KAAK,CAAC,OAAO,CAAA;QAChD,CAAC;QAED,OAAO,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;IAC1E,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CAAC,MAAwB;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAC5D,IAAI,aAAkC,CAAA;QAEtC,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CACtD,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,GAAG,CACX,CAAA;YACD,aAAa,GAAG,KAAK,CAAC,OAAO,CAAA;QAC/B,CAAC;QAED,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa;YACb,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,gBAAgB,CACpB,MAA0B;QAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAC5D,IAAI,aAAkC,CAAA;QAEtC,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CACtD,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,GAAG,CACX,CAAA;YACD,aAAa,GAAG,KAAK,CAAC,OAAO,CAAA;QAC/B,CAAC;QAED,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa;YACb,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CAAC,MAAwB;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAE5D,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,GAAG,iBAAiB,CAAC,kBAAkB,0FAA0F,CAClI,CAAA;QACH,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CACtD,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,GAAG,CACX,CAAA;QAED,2BAA2B;QAC3B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACpD,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,KAAK,CAAC,OAAO;YAC5B,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAA;QAEF,qCAAqC;QACrC,MAAM,aAAa,GAAwB,MAAM,OAAO,CAAC,GAAG,CAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,SAAS,EAAE,MAAM,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC;SAC9D,CAAC,CAAC,CACJ,CAAA;QAED,YAAY;QACZ,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,KAAK,CAAC,OAAO;YAC5B,OAAO,EAAE,aAAa;SACvB,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAE5D,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,GAAG,iBAAiB,CAAC,kBAAkB,4FAA4F,CACpI,CAAA;QACH,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CACtD,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,GAAG,CACX,CAAA;QAED,4BAA4B;QAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACpD,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,KAAK,CAAC,OAAO;YAC5B,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC,CAAA;QAEF,qCAAqC;QACrC,MAAM,aAAa,GAAwB,MAAM,OAAO,CAAC,GAAG,CAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,MAAM,EAAE,CAAC,CAAC,MAAyB;YACnC,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,SAAS,EAAE,MAAM,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC;SAC9D,CAAC,CAAC,CACJ,CAAA;QAED,YAAY;QACZ,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,KAAK,CAAC,OAAO;YAC5B,OAAO,EAAE,aAAa;SACvB,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,iBAAiB,CACrB,MAAyB;QAEzB,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,yBAAyB,CAC7B,MAAuC;QAEvC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,kBAAkB,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAE9C,iDAAiD;QACjD,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjD,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;SACzB,CAAC,CAAA;QACF,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;QAChE,MAAM,aAAa,GACjB,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,mBAAmB,CAAC;YACpE,KAAK,CAAA;QACP,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,iBAGzB,CAAA;QACb,MAAM,iBAAiB,GAAG,cAAc,IAAI,IAAI,CAAA;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAEjB,CAAA;QAEb,MAAM,kBAAkB,GAAyB,EAAE,CAAA;QACnD,MAAM,mBAAmB,GAAyB,EAAE,CAAA;QAEpD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,6CAA6C;YAC7C,IAAI,kBAAkB,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACnE,kBAAkB,CAAC,IAAI,CAAC;oBACtB,GAAG,EAAE,oBAAoB;oBACzB,MAAM,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE;iBAC1C,CAAC,CAAA;YACJ,CAAC;YAED,OAAO;gBACL,kBAAkB;gBAClB,mBAAmB;gBACnB,UAAU,EAAE,KAAK;gBACjB,iBAAiB;gBACjB,OAAO,EAAE,kBAAkB,CAAC,MAAM,KAAK,CAAC;aACzC,CAAA;QACH,CAAC;QAED,wCAAwC;QACxC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;QAEjE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,sDAAsD;YACtD,kBAAkB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAA;YAChD,IAAI,aAAa,EAAE,CAAC;gBAClB,kBAAkB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,CAAA;YACvD,CAAC;YAED,mDAAmD;YACnD,IAAI,kBAAkB,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACnE,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;oBAC/B,sEAAsE;oBACtE,kBAAkB,CAAC,IAAI,CAAC;wBACtB,GAAG,EAAE,oBAAoB;wBACzB,MAAM,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE;qBAC1C,CAAC,CAAA;gBACJ,CAAC;qBAAM,CAAC;oBACN,mCAAmC;oBACnC,kBAAkB,CAAC,IAAI,CAAC;wBACtB,GAAG,EAAE,oBAAoB;wBACzB,MAAM,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE;qBAC1C,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,0CAA0C;YAC1C,IAAI,kBAAkB,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACnE,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;oBAC/B,0DAA0D;oBAC1D,mBAAmB,CAAC,IAAI,CAAC;wBACvB,GAAG,EAAE,qBAAqB;wBAC1B,MAAM,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE;qBAC1C,CAAC,CAAA;gBACJ,CAAC;qBAAM,CAAC;oBACN,mCAAmC;oBACnC,kBAAkB,CAAC,IAAI,CAAC;wBACtB,GAAG,EAAE,oBAAoB;wBACzB,MAAM,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE;qBAC1C,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GACX,kBAAkB,CAAC,MAAM,KAAK,CAAC,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,CAAA;QAErE,OAAO;YACL,kBAAkB;YAClB,mBAAmB;YACnB,UAAU;YACV,iBAAiB;YACjB,OAAO;SACR,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB,CACzB,MAAmC;QAEnC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAA;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAE9C,yCAAyC;QACzC,IAAI,WAAW,GAA2B,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;QACzD,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,aAAa,GACjB,IAAI,KAAK,YAAY;gBACnB,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO;gBACpE,CAAC,CAAC,OAAO,CAAA;YACb,WAAW,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE;gBACtD,GAAG;gBACH,OAAO;gBACP,aAAa;gBACb,OAAO,EAAE,iBAAiB;aAC3B,CAAC,CAAA;YAEF,4DAA4D;YAC5D,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;YAC1D,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,EAAE,WAAW,EAAE,CAAA;YACxB,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,IAAI,QAAQ,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YACrE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YAEtE,4CAA4C;YAC5C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE;gBAC5D,GAAG;gBACH,OAAO;gBACP,aAAa,EAAE,KAAK,CAAC,OAAO;gBAC5B,cAAc,EAAE,QAAQ,CAAC,mBAAmB;aAC7C,CAAC,CAAA;YAEF,sBAAsB;YACtB,MAAM,kBAAkB,GAA0B,MAAM,OAAO,CAAC,GAAG,CACjE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC;aACnE,CAAC,CAAC,CACJ,CAAA;YAED,8BAA8B;YAC9B,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE;gBAC7D,GAAG;gBACH,OAAO;gBACP,aAAa,EAAE,KAAK,CAAC,OAAO;gBAC5B,OAAO,EAAE,kBAAkB;aAC5B,CAAC,CAAA;YAEF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAA;QACtC,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,CAAA;IACxB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CACzB,OAAgB,EAChB,GAAW,EACX,aAA8D;QAE9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACzE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACtE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAC/D,CAAA;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtC,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,MAAqB;IACjD,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,UAAU,CAAA;AACjD,CAAC"}

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

@@ -0,0 +1,82 @@
+import { AgentManager } from '../agent/AgentManager.js';
+import type { StorageAdapter } from '../agent/types.js';
+/**
+ * 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 */
+    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;
+    /** Whether to perform a health check on startup before allowing requests. Default: true */
+    healthCheck?: boolean;
+}
+/**
+ * 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) */
+    apiUrl: string;
+    /** Disable version update check in development mode */
+    disableVersionCheck?: boolean;
+    /** Optional request interceptor for custom handling */
+    requestInterceptor?: RequestInterceptor;
+    /** Promise that resolves when the API is ready. Requests wait for this. */
+    readyPromise?: Promise<void>;
+}
+/**
+ * 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;
+}
+/**
+ * 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;
+    /** Promise that resolves when the API health check passes. */
+    readonly ready: Promise<void>;
+}
+/**
+ * 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/esm/client/createPerpsClient.d.ts.map

@@ -0,0 +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;AASvD;;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;IACvC,2FAA2F;IAC3F,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;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;IACvC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;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;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAqCtE"}