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

package/dist/esm/registry/referenceDataRegistry.js

@@ -0,0 +1,79 @@
+/** Minimum gap between unknown-id-triggered, HTTP-cache-bypassing refetches. */
+const REFRESH_COOLDOWN_MS = 60_000;
+/**
+ * Per-provider hash index over one of the provider's reference-data lists
+ * (`/markets`, `/assets`), keyed by the list's own primary key.
+ *
+ * NOT a cache: it holds no freshness policy of its own. Every {@link sync}
+ * refetches through the HTTP layer, whose `cache-control` headers decide
+ * whether the response comes from disk or the network. A lookup miss
+ * schedules a cooldown-gated background refetch that bypasses the HTTP
+ * cache — the id may have listed after the cached snapshot.
+ *
+ * @internal
+ */
+export class ReferenceDataRegistry {
+    client;
+    provider;
+    kind;
+    index = new Map();
+    current = [];
+    inflight;
+    warnedIds = new Set();
+    refreshAfter = 0;
+    constructor(client, provider, kind) {
+        this.client = client;
+        this.provider = provider;
+        this.kind = kind;
+    }
+    /**
+     * Fetch the list through the HTTP cache and rebuild the index. Concurrent
+     * callers share one in-flight fetch; a settled fetch is never reused, so
+     * HTTP `cache-control` alone governs freshness.
+     */
+    sync() {
+        if (!this.inflight) {
+            this.inflight = this.load(false).finally(() => {
+                this.inflight = undefined;
+            });
+        }
+        return this.inflight;
+    }
+    /** The most recently synced list. Empty before the first {@link sync}. */
+    get items() {
+        return this.current;
+    }
+    /**
+     * O(1) lookup by primary key. A miss warns once per id and schedules the
+     * cooldown-gated, cache-bypassing background refetch.
+     */
+    get(id) {
+        const item = this.index.get(id);
+        if (item !== undefined) {
+            return item;
+        }
+        if (!this.warnedIds.has(id)) {
+            this.warnedIds.add(id);
+            console.warn(`[${this.provider}] unknown ${this.kind} id '${id}'`);
+        }
+        this.scheduleRefresh();
+        return undefined;
+    }
+    async load(bypassHttpCache) {
+        const items = await this.fetchItems(bypassHttpCache);
+        this.index = new Map(items.map((item) => [this.keyOf(item), item]));
+        this.current = items;
+        this.warnedIds.clear();
+        return items;
+    }
+    scheduleRefresh() {
+        const now = Date.now();
+        if (now < this.refreshAfter) {
+            return;
+        }
+        // Set before any await so concurrent misses cannot trigger a refetch storm.
+        this.refreshAfter = now + REFRESH_COOLDOWN_MS;
+        this.load(true).catch((error) => console.error(`[${this.provider}] ${this.kind} registry refresh failed`, error));
+    }
+}
+//# sourceMappingURL=referenceDataRegistry.js.map

package/dist/esm/registry/referenceDataRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceDataRegistry.js","sourceRoot":"","sources":["../../../src/registry/referenceDataRegistry.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,OAAgB,qBAAqB;IAQpB;IACV;IACQ;IATX,KAAK,GAAG,IAAI,GAAG,EAAa,CAAA;IAC5B,OAAO,GAAiB,EAAE,CAAA;IAC1B,QAAQ,CAAmC;IAC3C,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IAC7B,YAAY,GAAG,CAAC,CAAA;IAExB,YACqB,MAAsB,EAChC,QAAgB,EACR,IAAY;QAFV,WAAM,GAAN,MAAM,CAAgB;QAChC,aAAQ,GAAR,QAAQ,CAAQ;QACR,SAAI,GAAJ,IAAI,CAAQ;IAC5B,CAAC;IAQJ;;;;OAIG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC5C,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;YAC3B,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,0EAA0E;IAC1E,IAAc,KAAK;QACjB,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,EAAU;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACtB,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,aAAa,IAAI,CAAC,IAAI,QAAQ,EAAE,GAAG,CAAC,CAAA;QACpE,CAAC;QACD,IAAI,CAAC,eAAe,EAAE,CAAA;QACtB,OAAO,SAAS,CAAA;IAClB,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,eAAwB;QACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;QACpD,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;QACnE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;QACtB,OAAO,KAAK,CAAA;IACd,CAAC;IAEO,eAAe;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5B,OAAM;QACR,CAAC;QACD,4EAA4E;QAC5E,IAAI,CAAC,YAAY,GAAG,GAAG,GAAG,mBAAmB,CAAA;QAC7C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9B,OAAO,CAAC,KAAK,CACX,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,IAAI,0BAA0B,EACzD,KAAK,CACN,CACF,CAAA;IACH,CAAC;CACF"}

package/dist/esm/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/esm/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/esm/services/createAction.js

@@ -0,0 +1,22 @@
+import { request } from '../transport/request.js';
+/**
+ * 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 async function createAction(client, params, options) {
+    return request(client.config, `${client.config.apiUrl}/createAction`, {
+        method: 'POST',
+        body: JSON.stringify({
+            provider: params.provider,
+            address: params.address,
+            signerAddress: params.signerAddress,
+            action: params.action,
+            params: params.params,
+        }),
+    }, options);
+}
+//# sourceMappingURL=createAction.js.map

package/dist/esm/services/createAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAction.js","sourceRoot":"","sources":["../../../src/services/createAction.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAiBjD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,MAA6B,EAC7B,OAA2B;IAE3B,OAAO,OAAO,CACZ,MAAM,CAAC,MAAM,EACb,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,eAAe,EACtC;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;KACH,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/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/esm/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/esm/services/executeAction.js

@@ -0,0 +1,26 @@
+import { request } from '../transport/request.js';
+/**
+ * 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 async function executeAction(client, params, options) {
+    return request(client.config, `${client.config.apiUrl}/executeAction`, {
+        method: 'POST',
+        // Money-moving write: a network/5xx failure is outcome-unknown, so the
+        // request must never be auto-resubmitted (the signed bytes could already
+        // have landed). Retries stay enabled for reads and `createAction`.
+        retry: false,
+        body: JSON.stringify({
+            provider: params.provider,
+            address: params.address,
+            signerAddress: params.signerAddress,
+            action: params.action,
+            actions: params.actions,
+        }),
+    }, options);
+}
+//# sourceMappingURL=executeAction.js.map

package/dist/esm/services/executeAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeAction.js","sourceRoot":"","sources":["../../../src/services/executeAction.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAiBjD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAsB,EACtB,MAA2B,EAC3B,OAA2B;IAE3B,OAAO,OAAO,CACZ,MAAM,CAAC,MAAM,EACb,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,gBAAgB,EACvC;QACE,MAAM,EAAE,MAAM;QACd,uEAAuE;QACvE,yEAAyE;QACzE,mEAAmE;QACnE,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;KACH,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/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/esm/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/esm/services/getAccount.js

@@ -0,0 +1,25 @@
+import { requireProvider } from '../client/requireProvider.js';
+/**
+ * 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 async function getAccount(client, params, options) {
+    return requireProvider(client, params.provider).getAccount({ address: params.address }, options);
+}
+//# sourceMappingURL=getAccount.js.map

package/dist/esm/services/getAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAccount.js","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAc9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAsB,EACtB,MAAwB,EACxB,OAA2B;IAE3B,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,CACxD,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAC3B,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/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/esm/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/esm/services/getActivity.js

@@ -0,0 +1,29 @@
+import { requireProvider } from '../client/requireProvider.js';
+/**
+ * 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 async function getActivity(client, params, options) {
+    return requireProvider(client, params.provider).getActivity({
+        address: params.address,
+        limit: params.limit,
+        cursor: params.cursor,
+        startTime: params.startTime,
+        endTime: params.endTime,
+        type: params.type,
+    }, options);
+}
+//# sourceMappingURL=getActivity.js.map

package/dist/esm/services/getActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getActivity.js","sourceRoot":"","sources":["../../../src/services/getActivity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAqB9D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAsB,EACtB,MAAyB,EACzB,OAA2B;IAE3B,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,CACzD;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/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/esm/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/esm/services/getAssets.js

@@ -0,0 +1,22 @@
+import { buildUrl, request } from '../transport/request.js';
+/**
+ * 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 async function getAssets(client, params, options) {
+    const url = buildUrl(`${client.config.apiUrl}/assets`, {
+        provider: params.provider,
+    });
+    return request(client.config, url, {}, options);
+}
+//# sourceMappingURL=getAssets.js.map

package/dist/esm/services/getAssets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAssets.js","sourceRoot":"","sources":["../../../src/services/getAssets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAa3D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,MAAuB,EACvB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,EAAE;QACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAA;IACF,OAAO,OAAO,CAAiB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACjE,CAAC"}

package/dist/esm/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/esm/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/esm/services/getFills.js

@@ -0,0 +1,28 @@
+import { requireProvider } from '../client/requireProvider.js';
+/**
+ * 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 async function getFills(client, params, options) {
+    return requireProvider(client, params.provider).getFills({
+        address: params.address,
+        limit: params.limit,
+        cursor: params.cursor,
+        startTime: params.startTime,
+        endTime: params.endTime,
+    }, options);
+}
+//# sourceMappingURL=getFills.js.map

package/dist/esm/services/getFills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFills.js","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAoB9D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAsB,EACtB,MAAsB,EACtB,OAA2B;IAE3B,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CACtD;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/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/esm/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/esm/services/getMarket.js

@@ -0,0 +1,25 @@
+import { buildUrl, request } from '../transport/request.js';
+/**
+ * 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 async function getMarket(client, params, options) {
+    const url = buildUrl(`${client.config.apiUrl}/markets`, {
+        provider: params.provider,
+        marketIds: params.marketId,
+    });
+    const { markets } = await request(client.config, url, {}, options);
+    return markets[0];
+}
+//# sourceMappingURL=getMarket.js.map

package/dist/esm/services/getMarket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMarket.js","sourceRoot":"","sources":["../../../src/services/getMarket.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAmB3D;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,MAAuB,EACvB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE;QACtD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,QAAQ;KAC3B,CAAC,CAAA;IACF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAC/B,MAAM,CAAC,MAAM,EACb,GAAG,EACH,EAAE,EACF,OAAO,CACR,CAAA;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC"}

package/dist/esm/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/esm/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/esm/services/getMarkets.js

@@ -0,0 +1,22 @@
+import { buildUrl, request } from '../transport/request.js';
+/**
+ * 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 async function getMarkets(client, params, options) {
+    const url = buildUrl(`${client.config.apiUrl}/markets`, {
+        provider: params.provider,
+        marketIds: params.marketIds?.join(','),
+    });
+    return request(client.config, url, {}, options);
+}
+//# sourceMappingURL=getMarkets.js.map

package/dist/esm/services/getMarkets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMarkets.js","sourceRoot":"","sources":["../../../src/services/getMarkets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAe3D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAsB,EACtB,MAAwB,EACxB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE;QACtD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;KACvC,CAAC,CAAA;IACF,OAAO,OAAO,CAAkB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AAClE,CAAC"}

package/dist/esm/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