@lifi/perps-sdk 0.0.0-preview-64fca0d

package/dist/esm/client/PerpsClient.js

@@ -0,0 +1,498 @@
+import { ActionType, PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsError } from '../errors/PerpsError.js';
+import { createAction } from '../services/createAction.js';
+import { executeAction } from '../services/executeAction.js';
+import { getAccount as fetchAccount } from '../services/getAccount.js';
+import { getProviders } from '../services/getProviders.js';
+import { createPerpsClient } from './createPerpsClient.js';
+import { requireProvider as resolveProvider } from './requireProvider.js';
+/**
+ * Look up an action's descriptor in the provider's metadata. Throws if the
+ * action isn't declared — defensive: better to fail loudly than to mis-sign.
+ */
+function findActionDescriptor(metadata, action) {
+    const descriptor = [
+        ...metadata.setup,
+        ...metadata.options,
+        ...metadata.actions,
+    ].find((d) => d.type === action);
+    if (!descriptor) {
+        throw new PerpsError(PerpsErrorCode.SDKError, `Provider '${metadata.key}' does not declare action '${action}'.`);
+    }
+    return descriptor;
+}
+/**
+ * The primary high-level perps API: wraps a {@link PerpsSDKClient} and owns the
+ * end-to-end signing pipeline for provider setup, orders, and account-level
+ * actions. Construct via `new PerpsClient(options)` or the SDK's higher-level
+ * wiring.
+ *
+ * @public
+ */
+export class PerpsClient {
+    sdkClient;
+    providerMetadataCache = new Map();
+    _userWallet;
+    constructor(options) {
+        this.sdkClient = createPerpsClient({
+            integrator: options.integrator,
+            apiKey: options.apiKey,
+            apiUrl: options.apiUrl,
+            providers: options.providers,
+        });
+    }
+    /**
+     * Set or update the end-user's wallet. Used whenever an action's descriptor
+     * names the user wallet in its `signers` list. Pass undefined to clear.
+     *
+     * @public
+     */
+    setUserWallet(userWallet) {
+        this._userWallet = userWallet;
+        Object.defineProperty(this.sdkClient, 'userWallet', {
+            get: () => this._userWallet,
+            configurable: true,
+        });
+    }
+    /**
+     * The underlying low-level {@link PerpsSDKClient} (config, user wallet,
+     * provider registry) backing this instance.
+     *
+     * @public
+     */
+    get client() {
+        return this.sdkClient;
+    }
+    async getProviderMetadata(provider) {
+        const cached = this.providerMetadataCache.get(provider);
+        if (cached) {
+            return cached;
+        }
+        const { providers } = await getProviders(this.sdkClient);
+        for (const d of providers) {
+            this.providerMetadataCache.set(d.key, d);
+        }
+        const metadata = this.providerMetadataCache.get(provider);
+        if (!metadata) {
+            const error = new PerpsError(PerpsErrorCode.SDKError, `Unsupported provider: ${provider}`);
+            error.tool = '@lifi/perps-sdk';
+            throw error;
+        }
+        return metadata;
+    }
+    /**
+     * Resolve the registered provider plugin for `provider`, throwing a
+     * `PerpsError` when the caller has not registered one via the SDK's
+     * `providers` option. The plugin owns signer identity and write-side signing.
+     */
+    requireProvider(provider) {
+        return resolveProvider(this.sdkClient, provider);
+    }
+    /**
+     * Ask the provider plugin for the signer-bearing wire fields of `action` —
+     * the on-wire `signerAddress` and any signer-derived params (e.g.
+     * Hyperliquid's `agentAddress` for `APPROVE_AGENT`). Forwards the descriptor's
+     * `signers` so the plugin can branch on signer role. Returns empty when the
+     * plugin signs as the user or with a non-EVM credential. Core constructs no
+     * `signerAddress` itself; signer identity is plugin-owned.
+     */
+    async resolveActionRequest(provider, descriptor, address) {
+        const plugin = this.requireProvider(provider);
+        if (typeof plugin.resolveActionRequest !== 'function') {
+            return {};
+        }
+        return plugin.resolveActionRequest(descriptor.type, address, descriptor.signers);
+    }
+    /**
+     * Delegate signing of `actions` to the provider plugin. The plugin owns
+     * every signing arm and branches on the descriptor's `signers` internally,
+     * reading the end-user's wallet from the {@link SignActionsContext} when an
+     * arm signs as the user.
+     */
+    async delegateSignActions(provider, address, descriptor, actions) {
+        const plugin = this.requireProvider(provider);
+        if (typeof plugin.signActions !== 'function') {
+            throw new PerpsError(PerpsErrorCode.SDKError, `Provider '${provider}' does not implement signActions for ` +
+                `signingMethod '${descriptor.signingMethod}'.`);
+        }
+        return plugin.signActions(descriptor.signingMethod, actions, address, this.buildSignActionsContext(descriptor));
+    }
+    /**
+     * Assemble the per-call context the provider plugin needs in order to sign:
+     * the end-user's wallet and the descriptor's declared `signers`. Core
+     * forwards `signers` as data so the plugin can pick WHO signs; it does not
+     * branch on them. Provider-owned session credentials (the Hyperliquid agent
+     * keypair, Lighter's API key) are resolved inside the provider's
+     * `signActions`, not threaded through here.
+     */
+    buildSignActionsContext(descriptor) {
+        const ctx = { signers: descriptor.signers };
+        if (this.sdkClient.userWallet !== undefined) {
+            ctx.userWallet = this.sdkClient.userWallet;
+        }
+        return ctx;
+    }
+    /**
+     * Sign a single provider setup action step by delegating to the provider
+     * plugin, which branches on the step's signing scheme internally. Lets
+     * consumers collect signed setup actions without embedding per-method
+     * signing logic.
+     *
+     * @throws {PerpsError} When the step's action is not declared by the provider.
+     * @public
+     */
+    async signProviderSetupAction(provider, address, step) {
+        const metadata = await this.getProviderMetadata(provider);
+        const descriptor = findActionDescriptor(metadata, step.action);
+        const [signed] = await this.delegateSignActions(provider, address, descriptor, [step]);
+        return signed;
+    }
+    /**
+     * Build (but do not sign or submit) the unsigned action steps for `action`,
+     * letting the provider plugin contribute any signer-bearing request fields.
+     *
+     * @public
+     */
+    async buildAction(action, params) {
+        const metadata = await this.getProviderMetadata(params.provider);
+        const descriptor = findActionDescriptor(metadata, action);
+        const { signerAddress, params: signerParams } = await this.resolveActionRequest(params.provider, descriptor, params.address);
+        return createAction(this.sdkClient, {
+            provider: params.provider,
+            address: params.address,
+            signerAddress,
+            action,
+            params: {
+                ...params.params,
+                ...signerParams,
+            },
+        });
+    }
+    /**
+     * 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`.
+     *
+     * @throws {PerpsError} When the provider plugin is not registered, or the
+     *   backend account fetch fails.
+     * @public
+     */
+    async getAccount(params) {
+        const plugin = this.requireProvider(params.provider);
+        const [response, metadata] = await Promise.all([
+            fetchAccount(this.sdkClient, params),
+            this.getProviderMetadata(params.provider),
+        ]);
+        const settings = plugin.projectConfig(response.config, metadata.setup, metadata.options);
+        return { ...response, settings };
+    }
+    /**
+     * Roll an already-fetched {@link AccountResponse} (plus its positions) up
+     * into an {@link AccountSummary}, delegating to the owning provider so the
+     * venue-specific collateral and margin semantics are applied correctly.
+     */
+    getPortfolioSummary(account, positions) {
+        return this.requireProvider(account.provider).getPortfolioSummary(account, positions);
+    }
+    /**
+     * 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).
+     *
+     * @throws {PerpsError} On any backend error other than
+     *   `PerpsErrorCode.AccountNotFound`.
+     * @public
+     */
+    async accountExists(provider, address) {
+        try {
+            await fetchAccount(this.sdkClient, { provider, address });
+            return true;
+        }
+        catch (err) {
+            if (err instanceof PerpsError &&
+                err.code === PerpsErrorCode.AccountNotFound) {
+                return false;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Return the unsatisfied entries on `Provider.setup` for this account as a
+     * flat, self-describing list. Trading is gated on `isReady === true`.
+     *
+     * `Provider.options` descriptors are NEVER returned here — options are
+     * post-setup tunables and never gate trading. Option state is surfaced
+     * separately via `getAccount().settings`.
+     *
+     * @public
+     */
+    async checkSetup(params) {
+        const { provider, address } = params;
+        // The backend filters already-satisfied setup actions and returns typed
+        // data for those still outstanding; each plugin contributes its own
+        // signer-bearing request fields.
+        const { actions } = await this.buildProviderSetup({ provider, address });
+        return {
+            setup: actions,
+            isReady: actions.length === 0,
+        };
+    }
+    /**
+     * Build the unsigned setup `ActionStep`s still outstanding for an account,
+     * ordered by descriptor `sequence`. The backend filters already-satisfied
+     * setup; each plugin contributes its own signer-bearing request fields and
+     * any local-state params (e.g. Lighter's known pubkey).
+     *
+     * @public
+     */
+    async buildProviderSetup(params) {
+        const { provider, address } = params;
+        const metadata = await this.getProviderMetadata(provider);
+        const orderedSetup = [...metadata.setup].sort((a, b) => (a.sequence ?? Number.MAX_SAFE_INTEGER) -
+            (b.sequence ?? Number.MAX_SAFE_INTEGER));
+        const plugin = this.sdkClient.getProvider(provider);
+        const allActions = [];
+        for (const descriptor of orderedSetup) {
+            const action = descriptor.type;
+            const { signerAddress, params: signerParams } = await this.resolveActionRequest(provider, descriptor, address);
+            const localParams = plugin?.resolveSetupParams
+                ? await plugin.resolveSetupParams(action, address)
+                : {};
+            const { actions } = await createAction(this.sdkClient, {
+                provider,
+                address,
+                signerAddress,
+                action,
+                params: {
+                    ...signerParams,
+                    ...localParams,
+                },
+            });
+            allActions.push(...actions);
+        }
+        return { actions: allActions };
+    }
+    /**
+     * Submit the signed setup steps returned by `checkSetup` (and signed by the
+     * caller / `signProviderSetupAction`). Routes the batch on the first step's
+     * action and lets the plugin contribute that action's `signerAddress`.
+     * Throws on any per-step venue rejection.
+     *
+     * @public
+     */
+    async executeProviderSetup(params) {
+        const { provider, address, setup, signedActions } = params;
+        if (signedActions.length === 0) {
+            return { results: { results: [] } };
+        }
+        const action = setup[0]?.action ?? signedActions[0].action;
+        const metadata = await this.getProviderMetadata(provider);
+        const descriptor = findActionDescriptor(metadata, action);
+        const { signerAddress } = await this.resolveActionRequest(provider, descriptor, address);
+        const results = await executeAction(this.sdkClient, {
+            provider,
+            address,
+            // The submitting account: the plugin-resolved signer (Hyperliquid's
+            // agent) when present, else the end-user's address.
+            signerAddress: signerAddress ?? address,
+            action,
+            actions: signedActions,
+        });
+        const failure = results.results.find((r) => !r.success);
+        if (failure) {
+            throw new PerpsError(PerpsErrorCode.ExchangeRejected, failure.error);
+        }
+        return { results };
+    }
+    /**
+     * Sign and submit one pre-staged setup `ActionStep` end-to-end.
+     *
+     * The caller is expected to have already obtained the step from a prior
+     * {@link checkSetup} call (typically cached by the widget's react-query) —
+     * we do NOT refetch. This avoids the double `createAction` round-trip and
+     * keeps the nonce that was allocated at staging time committed all the way
+     * through submit. If the cached step has gone stale (Lighter's `/nextNonce`
+     * advanced underneath us), `executeProviderSetup` will surface a nonce
+     * conflict that the caller invalidates on, refetches `checkSetup`, and
+     * retries with a fresh step.
+     *
+     * @throws {PerpsError} When the step's action is not in the provider's
+     *   `setup` descriptors.
+     * @public
+     */
+    async executeProviderSetupAction(params) {
+        const { provider, address, step } = params;
+        const metadata = await this.getProviderMetadata(provider);
+        const descriptor = metadata.setup.find((d) => d.type === step.action);
+        if (!descriptor) {
+            throw new PerpsError(PerpsErrorCode.SDKError, `Action '${step.action}' is not in '${provider}'.setup`);
+        }
+        const signed = await this.signProviderSetupAction(provider, address, step);
+        await this.executeProviderSetup({
+            provider,
+            address,
+            setup: [step],
+            signedActions: [signed],
+        });
+    }
+    /**
+     * Sign and submit a single provider-option change (a `Provider.options`
+     * tunable such as Lighter `ACCOUNT_TYPE` or Hyperliquid `ACCOUNT_MODE`)
+     * end-to-end, throwing on a venue rejection.
+     *
+     * Options are dispatched through the same {@link execute} pipeline as
+     * trades, but unlike a trade an option change is a single mandatory action:
+     * a per-action `success: false` (returned as a 200 OK) means the user's
+     * selection was rejected and must surface, not be silently dropped. This
+     * wrapper inspects the result and throws a {@link PerpsError} carrying the
+     * venue `error`, giving options the same throw contract that setup has via
+     * {@link executeProviderSetupAction}. The only structural difference is that
+     * an option carries `params` (the selected value) rather than a pre-staged
+     * step.
+     *
+     * `execute` itself is unchanged — it still returns results without throwing,
+     * which the trade hooks rely on for partial-fill handling.
+     *
+     * @throws {PerpsError} `PerpsErrorCode.ExchangeRejected` carrying the venue
+     *   error when any returned result has `success: false`; also the errors
+     *   `execute` itself can throw (unregistered provider, no signer, signing
+     *   failure).
+     * @public
+     */
+    async executeProviderOption(params) {
+        const { results } = await this.execute(params);
+        const failure = results.find((r) => !r.success);
+        if (failure) {
+            throw new PerpsError(PerpsErrorCode.ExchangeRejected, failure.error);
+        }
+    }
+    /**
+     * Place a market or limit order. Convenience wrapper over {@link execute}
+     * with `ActionType.PLACE_ORDER`.
+     *
+     * @throws {PerpsError} When the provider is unregistered or the action
+     *   cannot be signed/submitted.
+     * @example
+     * ```ts
+     * await client.placeOrder({
+     *   provider: 'hyperliquid',
+     *   address: '0xUser',
+     *   market: { symbol: 'ETH' },
+     *   side: 'buy',
+     *   size: '0.1',
+     * })
+     * ```
+     * @public
+     */
+    async placeOrder(params) {
+        return this.execute({ ...params, action: ActionType.PLACE_ORDER, params });
+    }
+    /**
+     * Place a trigger (take-profit / stop-loss) order. Convenience wrapper over
+     * {@link execute} with `ActionType.PLACE_TRIGGER_ORDER`.
+     *
+     * @throws {PerpsError} When the provider is unregistered or the action
+     *   cannot be signed/submitted.
+     * @public
+     */
+    async placeTriggerOrder(params) {
+        return this.execute({
+            ...params,
+            action: ActionType.PLACE_TRIGGER_ORDER,
+            params,
+        });
+    }
+    /**
+     * Cancel one or more open orders. Convenience wrapper over {@link execute}
+     * with `ActionType.CANCEL_ORDER`.
+     *
+     * @throws {PerpsError} When the provider is unregistered or the action
+     *   cannot be signed/submitted.
+     * @public
+     */
+    async cancelOrders(params) {
+        return this.execute({ ...params, action: ActionType.CANCEL_ORDER, params });
+    }
+    /**
+     * Modify one or more open orders. Convenience wrapper over {@link execute}
+     * with `ActionType.MODIFY_ORDER`.
+     *
+     * @throws {PerpsError} When the provider is unregistered or the action
+     *   cannot be signed/submitted.
+     * @public
+     */
+    async modifyOrders(params) {
+        return this.execute({ ...params, action: ActionType.MODIFY_ORDER, params });
+    }
+    /**
+     * Add or remove isolated-position margin. Convenience wrapper over
+     * {@link execute} with `ActionType.UPDATE_POSITION_MARGIN`.
+     *
+     * @throws {PerpsError} When the provider is unregistered or the action
+     *   cannot be signed/submitted.
+     * @public
+     */
+    async updatePositionMargin(params) {
+        return this.execute({
+            ...params,
+            action: ActionType.UPDATE_POSITION_MARGIN,
+            params,
+        });
+    }
+    /**
+     * Withdraw funds from the provider account. Convenience wrapper over
+     * {@link execute} with `ActionType.WITHDRAWAL`.
+     *
+     * @throws {PerpsError} When the provider is unregistered or the action
+     *   cannot be signed/submitted.
+     * @public
+     */
+    async withdraw(params) {
+        return this.execute({
+            provider: params.provider,
+            address: params.address,
+            action: ActionType.WITHDRAWAL,
+            params: params.withdrawal,
+        });
+    }
+    /**
+     * Execute any action through the SDK's signing pipeline: fetch the unsigned
+     * steps, delegate signing to the provider plugin (which branches on the
+     * descriptor's scheme and signer internally), and submit. Core stays
+     * signer-agnostic — the plugin owns WHO signs and HOW.
+     *
+     * @throws {PerpsError} When the action is not declared by the provider,
+     *   the plugin cannot sign it, or submission fails.
+     * @public
+     */
+    async execute(params) {
+        const { provider, address, action } = params;
+        const metadata = await this.getProviderMetadata(provider);
+        const descriptor = findActionDescriptor(metadata, action);
+        const { signerAddress, params: signerParams } = await this.resolveActionRequest(provider, descriptor, address);
+        const { actions } = await createAction(this.sdkClient, {
+            provider,
+            address,
+            signerAddress,
+            action,
+            params: {
+                ...params.params,
+                ...signerParams,
+            },
+        });
+        const signedActions = await this.delegateSignActions(provider, address, descriptor, actions);
+        return executeAction(this.sdkClient, {
+            provider,
+            address,
+            // The submitting account: the plugin-resolved signer (Hyperliquid's
+            // agent) when present, else the end-user's address.
+            signerAddress: signerAddress ?? address,
+            action,
+            actions: signedActions,
+        });
+    }
+}
+//# 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":"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"}

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

@@ -0,0 +1,13 @@
+import type { PerpsProvider, PerpsProviderPlugin, PerpsSDKClient } from '../types/provider.js';
+/**
+ * Inject `client` into a {@link PerpsProviderPlugin} once via its
+ * {@link PerpsProviderPlugin.bind} hook, returning the runtime
+ * {@link PerpsProvider} — the plugin with its one-shot `bind` member dropped so
+ * consumers cannot re-bind a live provider. The read methods are already
+ * clientless (`getX(params, options?)`); they resolve their runtime deps from
+ * the context the plugin captured during `bind`.
+ *
+ * @internal
+ */
+export declare function bindProvider(plugin: PerpsProviderPlugin, client: PerpsSDKClient): PerpsProvider;
+//# sourceMappingURL=bindProvider.d.ts.map

package/dist/esm/client/bindProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindProvider.d.ts","sourceRoot":"","sources":["../../../src/client/bindProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,cAAc,EACf,MAAM,sBAAsB,CAAA;AAE7B;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,cAAc,GACrB,aAAa,CAIf"}

package/dist/esm/client/bindProvider.js

@@ -0,0 +1,16 @@
+/**
+ * Inject `client` into a {@link PerpsProviderPlugin} once via its
+ * {@link PerpsProviderPlugin.bind} hook, returning the runtime
+ * {@link PerpsProvider} — the plugin with its one-shot `bind` member dropped so
+ * consumers cannot re-bind a live provider. The read methods are already
+ * clientless (`getX(params, options?)`); they resolve their runtime deps from
+ * the context the plugin captured during `bind`.
+ *
+ * @internal
+ */
+export function bindProvider(plugin, client) {
+    plugin.bind(client);
+    const { bind: _bind, ...provider } = plugin;
+    return provider;
+}
+//# sourceMappingURL=bindProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bindProvider.js","sourceRoot":"","sources":["../../../src/client/bindProvider.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,MAA2B,EAC3B,MAAsB;IAEtB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACnB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAA;IAC3C,OAAO,QAAQ,CAAA;AACjB,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { PerpsConfig } from '../types/api.js';
+import type { ProviderConfigs } from '../types/config.js';
+import type { PerpsProviderPlugin, PerpsSDKClient } from '../types/provider.js';
+/**
+ * Default LI.FI perps API base URL used when `PerpsConfig.apiUrl` is omitted.
+ *
+ * @public
+ */
+export declare const DEFAULT_API_URL = "https://develop.li.quest/v1/perps";
+/**
+ * Construct the low-level {@link PerpsSDKClient} — config, the optional
+ * end-user wallet, and provider registry — shared by the service functions and
+ * the higher-level {@link PerpsClient}.
+ *
+ * @throws {PerpsError} When `options.integrator` is missing.
+ * @example
+ * ```ts
+ * const client = createPerpsClient({
+ *   integrator: 'my-app',
+ *   apiKey: 'key',
+ *   providers: [hyperliquidProvider()],
+ * })
+ * ```
+ * @public
+ */
+export declare function createPerpsClient(options: PerpsConfig): PerpsSDKClient;
+/**
+ * Split the overloaded `providers` option into its two shapes — the
+ * plugin array used by {@link PerpsSDKClient.getProvider}, and the
+ * keyed `ProviderConfigs` consumed internally by `PerpsWsClient` for
+ * markets filtering.
+ */
+export declare function splitProviders(input: PerpsProviderPlugin[] | ProviderConfigs | undefined): {
+    providerPlugins: PerpsProviderPlugin[];
+    providerConfigs?: ProviderConfigs;
+};
+//# 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":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAEV,mBAAmB,EACnB,cAAc,EACf,MAAM,sBAAsB,CAAA;AAG7B;;;;GAIG;AACH,eAAO,MAAM,eAAe,sCAAsC,CAAA;AAElE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CA4CtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,EAAE,GAAG,eAAe,GAAG,SAAS,GACzD;IACD,eAAe,EAAE,mBAAmB,EAAE,CAAA;IACtC,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,CAQA"}

package/dist/esm/client/createPerpsClient.js

@@ -0,0 +1,76 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsError } from '../errors/PerpsError.js';
+import { bindProvider } from './bindProvider.js';
+/**
+ * Default LI.FI perps API base URL used when `PerpsConfig.apiUrl` is omitted.
+ *
+ * @public
+ */
+export const DEFAULT_API_URL = 'https://develop.li.quest/v1/perps';
+/**
+ * Construct the low-level {@link PerpsSDKClient} — config, the optional
+ * end-user wallet, and provider registry — shared by the service functions and
+ * the higher-level {@link PerpsClient}.
+ *
+ * @throws {PerpsError} When `options.integrator` is missing.
+ * @example
+ * ```ts
+ * const client = createPerpsClient({
+ *   integrator: 'my-app',
+ *   apiKey: 'key',
+ *   providers: [hyperliquidProvider()],
+ * })
+ * ```
+ * @public
+ */
+export function createPerpsClient(options) {
+    if (!options.integrator) {
+        const error = new PerpsError(PerpsErrorCode.SDKError, 'Integrator is required. Please see documentation at https://docs.li.fi');
+        error.tool = '@lifi/perps-sdk';
+        throw error;
+    }
+    const apiUrl = options.apiUrl ?? DEFAULT_API_URL;
+    const { providerPlugins, providerConfigs } = splitProviders(options.providers);
+    const config = {
+        integrator: options.integrator,
+        apiKey: options.apiKey,
+        apiUrl,
+        disableVersionCheck: options.disableVersionCheck,
+        requestInterceptor: options.requestInterceptor,
+        providers: providerConfigs,
+        retry: options.retry,
+        fetch: options.fetch,
+    };
+    const client = {
+        get config() {
+            return config;
+        },
+        get userWallet() {
+            return options.userWallet;
+        },
+        get providers() {
+            return boundProviders;
+        },
+        getProvider(key) {
+            return boundProviders.find((p) => p.type === key);
+        },
+    };
+    const boundProviders = providerPlugins.map((plugin) => bindProvider(plugin, client));
+    return client;
+}
+/**
+ * Split the overloaded `providers` option into its two shapes — the
+ * plugin array used by {@link PerpsSDKClient.getProvider}, and the
+ * keyed `ProviderConfigs` consumed internally by `PerpsWsClient` for
+ * markets filtering.
+ */
+export function splitProviders(input) {
+    if (input === undefined) {
+        return { providerPlugins: [] };
+    }
+    if (Array.isArray(input)) {
+        return { providerPlugins: input };
+    }
+    return { providerPlugins: [], providerConfigs: input };
+}
+//# sourceMappingURL=createPerpsClient.js.map