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

package/dist/types/services/createAction.d.ts

@@ -0,0 +1,26 @@
+import type { ActionParamsMap, ActionType, CreateActionResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link createAction}.
+ *
+ * @public
+ */
+export interface CreateActionParams<T extends ActionType = ActionType> {
+    provider: string;
+    address: Address;
+    signerAddress?: Address;
+    action: T;
+    params: ActionParamsMap[T];
+}
+/**
+ * Request the backend to build the unsigned `ActionStep`s for an action. The
+ * returned steps are signed client-side and submitted via
+ * {@link executeAction}.
+ *
+ * @throws {PerpsError} On backend error responses, network, or parsing errors.
+ * @public
+ */
+export declare function createAction<T extends ActionType>(client: PerpsSDKClient, params: CreateActionParams<T>, options?: SDKRequestOptions): Promise<CreateActionResponse>;
+//# sourceMappingURL=createAction.d.ts.map

package/dist/types/services/createAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAction.d.ts","sourceRoot":"","sources":["../../../src/services/createAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,oBAAoB,EACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IACnE,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,CAAC,CAAA;IACT,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,UAAU,EACrD,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CAgB/B"}

package/dist/types/services/executeAction.d.ts

@@ -0,0 +1,26 @@
+import type { ActionType, ExecuteActionResponse, SignedActionStep } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link executeAction}.
+ *
+ * @public
+ */
+export interface ExecuteActionParams {
+    provider: string;
+    address: Address;
+    signerAddress?: Address;
+    action: ActionType;
+    actions: SignedActionStep[];
+}
+/**
+ * Submit client-signed `ActionStep`s to the backend for execution. This is a
+ * money-moving write — the request is never auto-retried (the signed bytes
+ * could already have landed on a transport failure).
+ *
+ * @throws {PerpsError} On backend error responses, network, or parsing errors.
+ * @public
+ */
+export declare function executeAction(client: PerpsSDKClient, params: ExecuteActionParams, options?: SDKRequestOptions): Promise<ExecuteActionResponse>;
+//# sourceMappingURL=executeAction.d.ts.map

package/dist/types/services/executeAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeAction.d.ts","sourceRoot":"","sources":["../../../src/services/executeAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAoBhC"}

package/dist/types/services/getAccount.d.ts

@@ -0,0 +1,35 @@
+import type { AccountResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getAccount}.
+ *
+ * @public
+ */
+export interface GetAccountParams {
+    provider: string;
+    address: Address;
+}
+/**
+ * Get account information (balances, margin, fee tier, typed config).
+ * Delegates to the registered venue plugin (direct-to-venue); requires the
+ * provider plugin to be registered on the client.
+ *
+ * Use {@link getPositions} and {@link getOrders} to fetch positions and orders
+ * separately.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const account = await getAccount(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ * })
+ * console.log(account.balances)
+ * ```
+ * @public
+ */
+export declare function getAccount(client: PerpsSDKClient, params: GetAccountParams, options?: SDKRequestOptions): Promise<AccountResponse>;
+//# sourceMappingURL=getAccount.d.ts.map

package/dist/types/services/getAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAccount.d.ts","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAK1B"}

package/dist/types/services/getActivity.d.ts

@@ -0,0 +1,39 @@
+import type { ActivitiesResponse, ActivityType } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getActivity}.
+ *
+ * @public
+ */
+export interface GetActivityParams {
+    provider: string;
+    address: Address;
+    limit?: number;
+    cursor?: string;
+    /** Filter: activity after this timestamp (ms) */
+    startTime?: number;
+    /** Filter: activity before this timestamp (ms) */
+    endTime?: number;
+    type?: ActivityType[];
+}
+/**
+ * Get account activity (deposits, withdrawals, liquidations, funding payments).
+ * Delegates to the registered venue plugin (direct-to-venue); requires the
+ * provider plugin to be registered on the client.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const { items, pagination } = await getActivity(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ *   limit: 50,
+ * })
+ * ```
+ * @public
+ */
+export declare function getActivity(client: PerpsSDKClient, params: GetActivityParams, options?: SDKRequestOptions): Promise<ActivitiesResponse>;
+//# sourceMappingURL=getActivity.d.ts.map

package/dist/types/services/getActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getActivity.d.ts","sourceRoot":"","sources":["../../../src/services/getActivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAY7B"}

package/dist/types/services/getAssets.d.ts

@@ -0,0 +1,27 @@
+import type { AssetsResponse } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getAssets}.
+ *
+ * @public
+ */
+export interface GetAssetsParams {
+    provider: string;
+}
+/**
+ * Get the token/asset registry for a provider. Thin pass-through to the
+ * LI.FI backend's Valkey-cached `/perps/assets` route, which centralises the
+ * `asset id → symbol → logoURI` join so the SDK never calls a provider's
+ * REST API directly for static registry data.
+ *
+ * @throws {PerpsError} On backend, network, or parsing errors.
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { assets } = await getAssets(client, { provider: 'lighter' })
+ * ```
+ * @public
+ */
+export declare function getAssets(client: PerpsSDKClient, params: GetAssetsParams, options?: SDKRequestOptions): Promise<AssetsResponse>;
+//# sourceMappingURL=getAssets.d.ts.map

package/dist/types/services/getAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAssets.d.ts","sourceRoot":"","sources":["../../../src/services/getAssets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAKzB"}

package/dist/types/services/getFills.d.ts

@@ -0,0 +1,38 @@
+import type { FillsResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getFills}.
+ *
+ * @public
+ */
+export interface GetFillsParams {
+    provider: string;
+    address: Address;
+    limit?: number;
+    cursor?: string;
+    /** Filter: fills after this timestamp (ms) */
+    startTime?: number;
+    /** Filter: fills before this timestamp (ms) */
+    endTime?: number;
+}
+/**
+ * Get order fills for an account. Delegates to the registered venue plugin
+ * (direct-to-venue); requires the provider plugin to be registered on the
+ * client.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const { items, pagination } = await getFills(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ *   limit: 50,
+ * })
+ * ```
+ * @public
+ */
+export declare function getFills(client: PerpsSDKClient, params: GetFillsParams, options?: SDKRequestOptions): Promise<FillsResponse>;
+//# sourceMappingURL=getFills.d.ts.map

package/dist/types/services/getFills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFills.d.ts","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAWxB"}

package/dist/types/services/getMarket.d.ts

@@ -0,0 +1,34 @@
+import type { Market } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getMarket}.
+ *
+ * @public
+ */
+export interface GetMarketParams {
+    provider: string;
+    /**
+     * Opaque provider `Market.id` (e.g. `"BTC"`, `"xyz:PURR"`, `"@142"` on
+     * Hyperliquid; `"0"`, `"1"` on Lighter). Pass a `displaySymbol` here and
+     * lookups will 404 for providers where the two diverge.
+     */
+    marketId: string;
+}
+/**
+ * Get a specific market by its opaque marketId. Requests the single market
+ * from the backend `/markets` route (filtered by `marketIds`) and returns the
+ * first match; the backend responds 404 (thrown as a {@link PerpsError}) when
+ * nothing matches.
+ *
+ * @throws {PerpsError} On backend (e.g. 404), network, or parsing errors.
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const market = await getMarket(client, { provider: 'hyperliquid', marketId: 'BTC' })
+ * console.log(market.baseAsset.displaySymbol)
+ * ```
+ * @public
+ */
+export declare function getMarket(client: PerpsSDKClient, params: GetMarketParams, options?: SDKRequestOptions): Promise<Market>;
+//# sourceMappingURL=getMarket.d.ts.map

package/dist/types/services/getMarket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMarket.d.ts","sourceRoot":"","sources":["../../../src/services/getMarket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,mBAAmB,CAAA;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/types/services/getMarkets.d.ts

@@ -0,0 +1,28 @@
+import type { MarketsResponse } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getMarkets}.
+ *
+ * @public
+ */
+export interface GetMarketsParams {
+    provider: string;
+    /** Optional filter — opaque `Market.id`s (not display symbols). */
+    marketIds?: string[];
+}
+/**
+ * Get all available markets for a provider. Thin pass-through to the LI.FI
+ * backend's Valkey-cached `/perps/markets` route — the canonical source of
+ * public market data for widget consumers.
+ *
+ * @throws {PerpsError} On backend, network, or parsing errors.
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { markets } = await getMarkets(client, { provider: 'hyperliquid' })
+ * ```
+ * @public
+ */
+export declare function getMarkets(client: PerpsSDKClient, params: GetMarketsParams, options?: SDKRequestOptions): Promise<MarketsResponse>;
+//# sourceMappingURL=getMarkets.d.ts.map

package/dist/types/services/getMarkets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMarkets.d.ts","sourceRoot":"","sources":["../../../src/services/getMarkets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAM1B"}

package/dist/types/services/getMeta.d.ts

@@ -0,0 +1,21 @@
+import type { Meta } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Get platform metadata: the API version and any active platform-level notices.
+ *
+ * @param client - The SDK client instance
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Platform version and the list of active notices
+ * @throws {PerpsError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { version, notices } = await getMeta(client)
+ * ```
+ * @public
+ */
+export declare function getMeta(client: PerpsSDKClient, options?: SDKRequestOptions): Promise<Meta>;
+//# sourceMappingURL=getMeta.d.ts.map

package/dist/types/services/getMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMeta.d.ts","sourceRoot":"","sources":["../../../src/services/getMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/types/services/getOhlcv.d.ts

@@ -0,0 +1,36 @@
+import type { OhlcvInterval, OhlcvResponse } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getOhlcv}.
+ *
+ * @public
+ */
+export interface GetOhlcvParams {
+    provider: string;
+    /** Opaque provider `Market.id` (not `displaySymbol`). */
+    marketId: string;
+    interval: OhlcvInterval;
+    /** Unix timestamp in milliseconds */
+    startTime?: number;
+    /** Unix timestamp in milliseconds */
+    endTime?: number;
+    limit?: number;
+}
+/**
+ * Get OHLCV (candlestick) data for a market.
+ *
+ * @throws {PerpsError} On backend, network, or parsing errors.
+ * @example
+ * ```ts
+ * const { candles } = await getOhlcv(client, {
+ *   provider: 'hyperliquid',
+ *   marketId: 'BTC',
+ *   interval: '1h',
+ *   limit: 100,
+ * })
+ * ```
+ * @public
+ */
+export declare function getOhlcv(client: PerpsSDKClient, params: GetOhlcvParams, options?: SDKRequestOptions): Promise<OhlcvResponse>;
+//# sourceMappingURL=getOhlcv.d.ts.map

package/dist/types/services/getOhlcv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOhlcv.d.ts","sourceRoot":"","sources":["../../../src/services/getOhlcv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAErE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,aAAa,CAAA;IACvB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAUxB"}

package/dist/types/services/getOrder.d.ts

@@ -0,0 +1,33 @@
+import type { Order } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getOrder}.
+ *
+ * @public
+ */
+export interface GetOrderParams {
+    provider: string;
+    address: Address;
+    id: string;
+}
+/**
+ * Get a specific order by ID. Delegates to the registered venue plugin
+ * (direct-to-venue); requires the provider plugin to be registered on the
+ * client.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const order = await getOrder(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ *   id: '123456',
+ * })
+ * ```
+ * @public
+ */
+export declare function getOrder(client: PerpsSDKClient, params: GetOrderParams, options?: SDKRequestOptions): Promise<Order>;
+//# sourceMappingURL=getOrder.d.ts.map

package/dist/types/services/getOrder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrder.d.ts","sourceRoot":"","sources":["../../../src/services/getOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,KAAK,CAAC,CAKhB"}

package/dist/types/services/getOrderbook.d.ts

@@ -0,0 +1,24 @@
+import type { OrderbookResponse } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getOrderbook}.
+ *
+ * @public
+ */
+export interface GetOrderbookParams {
+    provider: string;
+    /** Opaque provider `Market.id` (not `displaySymbol`). */
+    marketId: string;
+    /** Number of levels to return (default varies by DEX) */
+    depth?: number;
+}
+/**
+ * Get an orderbook backfill snapshot for a market. Pair with a provider WS
+ * subscription for live updates.
+ *
+ * @throws {PerpsError} On backend error responses, network, or parsing errors.
+ * @public
+ */
+export declare function getOrderbook(client: PerpsSDKClient, params: GetOrderbookParams, options?: SDKRequestOptions): Promise<OrderbookResponse>;
+//# sourceMappingURL=getOrderbook.d.ts.map

package/dist/types/services/getOrderbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderbook.d.ts","sourceRoot":"","sources":["../../../src/services/getOrderbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAO5B"}

package/dist/types/services/getOrders.d.ts

@@ -0,0 +1,35 @@
+import type { OrdersResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getOrders}.
+ *
+ * @public
+ */
+export interface GetOrdersParams {
+    provider: string;
+    address: Address;
+    /** Optional filter — opaque `Market.id` (not `displaySymbol`) */
+    marketId?: string;
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * Get open orders and trigger orders for an account. Delegates to the
+ * registered venue plugin (direct-to-venue); requires the provider plugin to be
+ * registered on the client.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const { openOrders, triggerOrders } = await getOrders(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ * })
+ * ```
+ * @public
+ */
+export declare function getOrders(client: PerpsSDKClient, params: GetOrdersParams, options?: SDKRequestOptions): Promise<OrdersResponse>;
+//# sourceMappingURL=getOrders.d.ts.map

package/dist/types/services/getOrders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrders.d.ts","sourceRoot":"","sources":["../../../src/services/getOrders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAUzB"}

package/dist/types/services/getPositions.d.ts

@@ -0,0 +1,35 @@
+import type { PositionsResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getPositions}.
+ *
+ * @public
+ */
+export interface GetPositionsParams {
+    provider: string;
+    address: Address;
+    /** Optional filter — opaque `Market.id` (not `displaySymbol`) */
+    marketId?: string;
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * Get open positions for an account. Delegates to the registered venue plugin
+ * (direct-to-venue); requires the provider plugin to be registered on the
+ * client.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const { positions } = await getPositions(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ * })
+ * ```
+ * @public
+ */
+export declare function getPositions(client: PerpsSDKClient, params: GetPositionsParams, options?: SDKRequestOptions): Promise<PositionsResponse>;
+//# sourceMappingURL=getPositions.d.ts.map

package/dist/types/services/getPositions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPositions.d.ts","sourceRoot":"","sources":["../../../src/services/getPositions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAU5B"}

package/dist/types/services/getPrices.d.ts

@@ -0,0 +1,21 @@
+import type { PricesResponse } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getPrices}.
+ *
+ * @public
+ */
+export interface GetPricesParams {
+    provider: string;
+    /** Optional filter — opaque `Market.id`s (not display symbols). */
+    marketIds?: string[];
+}
+/**
+ * Get current prices for markets, optionally filtered by `Market.id`.
+ *
+ * @throws {PerpsError} On backend error responses, network, or parsing errors.
+ * @public
+ */
+export declare function getPrices(client: PerpsSDKClient, params: GetPricesParams, options?: SDKRequestOptions): Promise<PricesResponse>;
+//# sourceMappingURL=getPrices.d.ts.map

package/dist/types/services/getPrices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPrices.d.ts","sourceRoot":"","sources":["../../../src/services/getPrices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAMzB"}

package/dist/types/services/getProviders.d.ts

@@ -0,0 +1,22 @@
+import type { ProvidersResponse } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Get all available providers.
+ *
+ * @param client - The SDK client instance
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns List of supported providers with their authorization requirements
+ * @throws {PerpsError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { providers } = await getProviders(client)
+ * console.log(providers) // [{ key: 'hyperliquid', name: 'Hyperliquid', ... }]
+ * ```
+ * @public
+ */
+export declare function getProviders(client: PerpsSDKClient, options?: SDKRequestOptions): Promise<ProvidersResponse>;
+//# sourceMappingURL=getProviders.d.ts.map

package/dist/types/services/getProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProviders.d.ts","sourceRoot":"","sources":["../../../src/services/getProviders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAO5B"}

package/dist/types/services/getQuote.d.ts

@@ -0,0 +1,42 @@
+import type { Quote, QuoteSide, TradeType } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getQuote}.
+ *
+ * @public
+ */
+export interface GetQuoteParams {
+    provider: string;
+    /** Human `displaySymbol`, e.g. `"BTC"`. */
+    symbol: string;
+    side: QuoteSide;
+    /** USD notional to fill. */
+    size: number;
+    type: TradeType;
+}
+/**
+ * Get a one-shot fill quote for `size` USD notional of `symbol` on a single
+ * venue: VWAP expected fill, price impact (bps), base-tier taker fee, and
+ * funding (perps only). Delegates to the registered venue plugin, which
+ * resolves the symbol against its own markets (scoped by `type`) and walks its
+ * orderbook. Cross-venue comparison is a consumer-side loop over
+ * `client.providers`.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, no market
+ *   matches the symbol+type, or on network / parsing errors.
+ * @example
+ * ```ts
+ * const quote = await getQuote(client, {
+ *   provider: 'hyperliquid',
+ *   symbol: 'BTC',
+ *   side: 'buy',
+ *   size: 10_000,
+ *   type: 'perps',
+ * })
+ * console.log(quote.expectedFillPrice, quote.priceImpactBps)
+ * ```
+ * @public
+ */
+export declare function getQuote(client: PerpsSDKClient, params: GetQuoteParams, options?: SDKRequestOptions): Promise<Quote>;
+//# sourceMappingURL=getQuote.d.ts.map

package/dist/types/services/getQuote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQuote.d.ts","sourceRoot":"","sources":["../../../src/services/getQuote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAEpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,SAAS,CAAA;IACf,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,SAAS,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,KAAK,CAAC,CAUhB"}

package/dist/types/services/getTermsAcceptance.d.ts

@@ -0,0 +1,26 @@
+import type { TermsAcceptanceStatus } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Get the current Terms of Service (version + full content) and whether the
+ * given address has accepted them. Provider-independent — reads from the
+ * platform `meta` surface, not a venue plugin.
+ *
+ * @param client - The SDK client instance
+ * @param address - Address whose acceptance status to resolve
+ * @param options - Request options (e.g., AbortSignal)
+ * @throws {PerpsError} On backend error responses, network, or parsing errors.
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const terms = await getTermsAcceptance(client, '0x1234...')
+ * if (!terms.accepted) {
+ *   // prompt the user to accept terms.content (version terms.termsVersion)
+ * }
+ * ```
+ * @public
+ */
+export declare function getTermsAcceptance(client: PerpsSDKClient, address: Address, options?: SDKRequestOptions): Promise<TermsAcceptanceStatus>;
+//# sourceMappingURL=getTermsAcceptance.d.ts.map

package/dist/types/services/getTermsAcceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTermsAcceptance.d.ts","sourceRoot":"","sources":["../../../src/services/getTermsAcceptance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAGhC"}