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

package/dist/types/realtime/lighter/LighterWsProvider.d.ts

@@ -0,0 +1,68 @@
+import type { Address, Subscription } from '@lifi/perps-types';
+import type { SubscriptionListener, WsProvider } from '../types.js';
+/**
+ * Mints a fresh Lighter auth token for the given L1 address, or returns
+ * `undefined` if no API key is registered. Called both on initial subscribe
+ * and on every reconnect, so it must always return a token valid for at
+ * least the next few minutes.
+ */
+export type LighterAuthProvider = (address: Address) => Promise<string | undefined>;
+export interface LighterWsProviderOptions {
+    /** REST base URL for fetching `orderBookDetails`. Defaults to mainnet. */
+    restUrl?: string;
+    /** Pre-populated symbol→market_id map to skip the REST call. */
+    symbolMap?: Record<string, number>;
+    /**
+     * Async function returning a Lighter auth token for an address. Required
+     * for authenticated channels (orderUpdates, positions). Without it those
+     * subscriptions will throw at subscribe time.
+     */
+    authProvider?: LighterAuthProvider;
+}
+export declare class LighterWsProvider implements WsProvider {
+    private readonly rws;
+    private readonly restUrl;
+    private readonly providerKey;
+    private readonly authProvider;
+    private readonly subs;
+    private readonly listeners;
+    private readonly orderbooks;
+    private lastPricesByAssetId;
+    private symbolToMarketId;
+    private marketIdToSymbol;
+    private marketMetadataPromise;
+    private readonly accountIndexCache;
+    private readonly accountIndexPromises;
+    private keepaliveTimer;
+    constructor(wsUrl?: string, providerKey?: string, options?: LighterWsProviderOptions);
+    subscribe(sub: Subscription, listener: SubscriptionListener): Promise<() => void>;
+    close(): void;
+    private onOpen;
+    private sendSubscribe;
+    private startKeepalive;
+    private stopKeepalive;
+    private toKey;
+    private resolveChannel;
+    private resolveAccountIndex;
+    private fetchAccountIndex;
+    private ensureMarketMetadata;
+    private fetchMarketMetadata;
+    private registerMarket;
+    private handleMessage;
+    private handleAccountOrders;
+    private handleAccountTrades;
+    private handleAccountPositions;
+    /**
+     * Reverse-lookup the L1 address from an auth-channel message. The subscribe
+     * payload uses `/` (e.g. `account_all_orders/42`) but the server sends
+     * responses with `:` (e.g. `account_all_orders:42`) — both forms are
+     * accepted here so reconnect resubscriptions and live updates both route
+     * correctly.
+     */
+    private addressFromChannel;
+    private handleMarketStats;
+    private handleOrderBook;
+    private marketIdFromChannel;
+    private emit;
+}
+//# sourceMappingURL=LighterWsProvider.d.ts.map

package/dist/types/realtime/lighter/LighterWsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LighterWsProvider.d.ts","sourceRoot":"","sources":["../../../../src/realtime/lighter/LighterWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAIP,YAAY,EAEb,MAAM,mBAAmB,CAAA;AAY1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAoDnE;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;AAmBhC,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC;AAED,qBAAa,iBAAkB,YAAW,UAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAE9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IACzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,mBAAmB,CAA6B;IAExD,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,qBAAqB,CAA2B;IAExD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqC;IAE1E,OAAO,CAAC,cAAc,CAA4C;gBAGhE,KAAK,GAAE,MAAuB,EAC9B,WAAW,SAAY,EACvB,OAAO,GAAE,wBAA6B;IAkBlC,SAAS,CACb,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,IAAI,CAAC;IAmDtB,KAAK,IAAI,IAAI;YASC,MAAM;YAON,aAAa;IA0B3B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,KAAK;YAkBC,cAAc;YAyCd,mBAAmB;YAkBnB,iBAAiB;YAgBjB,oBAAoB;YAUpB,mBAAmB;IAajC,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAyDrB,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,sBAAsB;IAyB9B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,IAAI;CASb"}

package/dist/types/realtime/lighter/types.d.ts

@@ -0,0 +1,108 @@
+export type LtWsMessage = {
+    channel?: string;
+    type: string;
+};
+export type LtWsPingMessage = LtWsMessage & {
+    type: 'ping';
+};
+export type LtWsMarketStats = {
+    market_id: number;
+    index_price: string;
+    mark_price: string;
+    open_interest: string;
+    last_trade_price: string;
+    current_funding_rate: string;
+    funding_rate: string;
+    funding_timestamp: number;
+    daily_base_token_volume: string;
+    daily_quote_token_volume: string;
+    daily_price_change: string;
+};
+/**
+ * `market_stats/all` pushes one record per known market each tick. We
+ * aggregate them into a Record<assetId, price> before emitting `prices`.
+ */
+export type LtWsMarketStatsAllMessage = LtWsMessage & {
+    type: 'subscribed/market_stats' | 'update/market_stats';
+    market_stats?: Record<string, LtWsMarketStats>;
+};
+export type LtWsOrderBookLevel = {
+    price: string;
+    size: string;
+};
+export type LtWsOrderBook = {
+    asks: LtWsOrderBookLevel[];
+    bids: LtWsOrderBookLevel[];
+    offset?: number;
+};
+export type LtWsOrderBookMessage = LtWsMessage & {
+    type: 'subscribed/order_book' | 'update/order_book';
+    order_book: LtWsOrderBook;
+};
+export type LtOrderBookDetail = {
+    symbol: string;
+    market_id: number;
+    market_type: string;
+    supported_price_decimals: number;
+    supported_size_decimals: number;
+};
+export type LtOrderBookDetailsResponse = {
+    code: number;
+    order_book_details: LtOrderBookDetail[];
+};
+/**
+ * `/api/v1/account?by=l1_address` response. The provider only consumes the
+ * `index` field — everything else is intentionally typed as unknown.
+ */
+export type LtWsAccountByL1Response = {
+    code: number;
+    accounts?: Array<{
+        index: number;
+        [k: string]: unknown;
+    }>;
+};
+/**
+ * Auth-channel payloads.
+ *
+ * The response `channel` field uses `:` as separator (e.g.
+ * `account_all_orders:42`) while the subscribe payload uses `/`.
+ *
+ * Per the Lighter WS spec:
+ *   - orders/trades: object indexed by market index, each value an array
+ *     (`{ "0": [Order], "1": [Order] }`)
+ *   - positions: object indexed by market index, each value a single object
+ *     (`{ "0": Position }`)
+ *   - initial `account_all_trades` snapshot may send an empty flat array
+ *
+ * The provider uses `collectAuthChannelItems` to normalise all three shapes
+ * into a flat T[].
+ */
+export type LtWsAccountAllOrdersMessage = LtWsMessage & {
+    type: 'subscribed/account_all_orders' | 'update/account_all_orders';
+    orders?: Record<string, unknown[]> | unknown[];
+    data?: {
+        orders?: Record<string, unknown[]> | unknown[];
+    };
+};
+export type LtWsAccountAllTradesMessage = LtWsMessage & {
+    type: 'subscribed/account_all_trades' | 'update/account_all_trades';
+    trades?: Record<string, unknown[]> | unknown[];
+    total_volume?: number;
+    monthly_volume?: number;
+    weekly_volume?: number;
+    daily_volume?: number;
+    data?: {
+        trades?: Record<string, unknown[]> | unknown[];
+    };
+};
+export type LtWsAccountAllPositionsMessage = LtWsMessage & {
+    type: 'subscribed/account_all_positions' | 'update/account_all_positions';
+    positions?: Record<string, unknown>;
+    shares?: unknown[];
+    last_funding_round?: Record<string, string>;
+    last_funding_discount?: Record<string, string>;
+    data?: {
+        positions?: Record<string, unknown>;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/realtime/lighter/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/realtime/lighter/types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+import type { ActionParamsMap, ActionType, Address, CreateActionResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface CreateActionParams<T extends ActionType = ActionType> {
+    provider: string;
+    address: Address;
+    signerAddress?: Address;
+    action: T;
+    params: ActionParamsMap[T];
+}
+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,OAAO,EACP,oBAAoB,EACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,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,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,11 @@
+import type { ActionType, Address, ExecuteActionResponse, SignedActionStep } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface ExecuteActionParams {
+    provider: string;
+    address: Address;
+    signerAddress?: Address;
+    action: ActionType;
+    actions: SignedActionStep[];
+}
+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,OAAO,EACP,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,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,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAgBhC"}

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

@@ -1,31 +1,31 @@
 import type { AccountResponse, Address } from '@lifi/perps-types';
 import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
 export interface GetAccountParams {
-    /** DEX to get account from (e.g., 'hyperliquid') */
-    dex: string;
+    /** Provider to get account from (e.g., 'hyperliquid') */
+    provider: string;
     /** Wallet address */
     address: Address;
 }
 /**
- * Get account information including balances, positions, and open orders.
+ * Get account information including balances and margin details.
+ *
+ * Use {@link getPositions} and {@link getOrders} to fetch positions and orders separately.
  *
  * @param client - The SDK client instance
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
  * @returns Account details
- * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
  * const account = await getAccount(client, {
- *   dex: 'hyperliquid',
+ *   provider: 'hyperliquid',
  *   address: '0x1234...'
  * })
  * console.log(account.balances) // [{ currency: 'USDC', amount: '10000.00' }]
- * console.log(account.positions) // [{ symbol: 'BTC', side: 'LONG', ... }]
- * console.log(account.openOrders) // [{ id: '123', symbol: 'BTC', ... }]
  * ```
  */
 export declare function getAccount(client: PerpsSDKClient, params: GetAccountParams, options?: SDKRequestOptions): Promise<AccountResponse>;

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

@@ -1 +1 @@
-{"version":3,"file":"getAccount.d.ts","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAM1B"}
+{"version":3,"file":"getAccount.d.ts","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;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/getActivity.d.ts

@@ -0,0 +1,49 @@
+import type { ActivitiesResponse, ActivityType, Address } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface GetActivityParams {
+    /** Provider to get activity from (e.g., 'hyperliquid') */
+    provider: string;
+    /** Wallet address */
+    address: Address;
+    /** Maximum number of items to return */
+    limit?: number;
+    /** Cursor for pagination */
+    cursor?: string;
+    /** Filter: activity after this timestamp (ms) */
+    startTime?: number;
+    /** Filter: activity before this timestamp (ms) */
+    endTime?: number;
+    /** Filter by activity type(s) */
+    type?: ActivityType[];
+}
+/**
+ * Get account activity (deposits, withdrawals, liquidations, funding payments).
+ *
+ * @param client - The SDK client instance
+ * @param params - Request parameters
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns Activity items with pagination
+ * @throws {PerpsError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { items, pagination } = await getActivity(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ *   limit: 50
+ * })
+ *
+ * // Fetch next page
+ * if (pagination.hasMore) {
+ *   const nextPage = await getActivity(client, {
+ *     provider: 'hyperliquid',
+ *     address: '0x1234...',
+ *     cursor: pagination.cursor
+ *   })
+ * }
+ * ```
+ */
+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,EACV,kBAAkB,EAClB,YAAY,EACZ,OAAO,EACR,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAe7B"}

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

@@ -0,0 +1,20 @@
+import type { Asset } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface GetAssetParams {
+    /** Provider to get asset from (e.g., 'hyperliquid') */
+    provider: string;
+    /** Asset symbol (e.g., 'BTC') */
+    symbol: string;
+}
+/**
+ * Get a specific asset by symbol.
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const asset = await getAsset(client, { provider: 'hyperliquid', symbol: 'BTC' })
+ * console.log(asset) // { symbol: 'BTC', markPrice: '95000.00', ... }
+ * ```
+ */
+export declare function getAsset(client: PerpsSDKClient, params: GetAssetParams, options?: SDKRequestOptions): Promise<Asset>;
+//# sourceMappingURL=getAsset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAsset.d.ts","sourceRoot":"","sources":["../../../src/services/getAsset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,KAAK,CAAC,CAQhB"}

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

@@ -0,0 +1,18 @@
+import type { AssetsResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface GetAssetsParams {
+    /** Provider to get assets from (e.g., 'hyperliquid') */
+    provider: string;
+}
+/**
+ * Get all available assets for a DEX, grouped by providerMarketId.
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { assets } = await getAssets(client, { provider: 'hyperliquid' })
+ * console.log(assets) // { hyperliquid: [...], xyz: [...], spot: [...] }
+ * ```
+ */
+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;AACvD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;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/getHistory.d.ts → types/services/getFills.d.ts}

@@ -1,30 +1,34 @@
-import type { Address, HistoryResponse } from '@lifi/perps-types';
+import type { Address, FillsResponse } from '@lifi/perps-types';
 import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
-export interface GetHistoryParams {
-    /** DEX to get history from (e.g., 'hyperliquid') */
-    dex: string;
+export interface GetFillsParams {
+    /** Provider to get fills from (e.g., 'hyperliquid') */
+    provider: string;
     /** Wallet address */
     address: Address;
     /** Maximum number of items to return */
     limit?: number;
     /** Cursor for pagination */
     cursor?: string;
+    /** Filter: orders after this timestamp (ms) */
+    startTime?: number;
+    /** Filter: orders before this timestamp (ms) */
+    endTime?: number;
 }
 /**
- * Get order history for an account.
+ * Get order fills for an account.
  *
  * @param client - The SDK client instance
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
- * @returns Order history with pagination
- * @throws {HTTPError} On API error responses
+ * @returns Order fills with pagination
+ * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
- * const { items, pagination } = await getHistory(client, {
- *   dex: 'hyperliquid',
+ * const { items, pagination } = await getFills(client, {
+ *   provider: 'hyperliquid',
  *   address: '0x1234...',
  *   limit: 50
  * })
@@ -33,13 +37,13 @@ export interface GetHistoryParams {
  *
  * // Fetch next page
  * if (pagination.hasMore) {
- *   const nextPage = await getHistory(client, {
- *     dex: 'hyperliquid',
+ *   const nextPage = await getFills(client, {
+ *     provider: 'hyperliquid',
  *     address: '0x1234...',
  *     cursor: pagination.cursor
  *   })
  * }
  * ```
  */
-export declare function getHistory(client: PerpsSDKClient, params: GetHistoryParams, options?: SDKRequestOptions): Promise<HistoryResponse>;
-//# sourceMappingURL=getHistory.d.ts.map
+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,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;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/getOhlcv.d.ts

@@ -1,8 +1,8 @@
 import type { OhlcvInterval, OhlcvResponse } from '@lifi/perps-types';
 import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
 export interface GetOhlcvParams {
-    /** DEX to get OHLCV from (e.g., 'hyperliquid') */
-    dex: string;
+    /** Provider to get OHLCV from (e.g., 'hyperliquid') */
+    provider: string;
     /** Market symbol (e.g., 'BTC') */
     symbol: string;
     /** Candle interval */
@@ -21,14 +21,14 @@ export interface GetOhlcvParams {
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
  * @returns OHLCV candle data
- * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
  * const { candles } = await getOhlcv(client, {
- *   dex: 'hyperliquid',
+ *   provider: 'hyperliquid',
  *   symbol: 'BTC',
  *   interval: '1h',
  *   limit: 100

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

@@ -1 +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;AACrE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,sBAAsB;IACtB,QAAQ,EAAE,aAAa,CAAA;IACvB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,CAAC,CASxB"}
+{"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;AACrE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,sBAAsB;IACtB,QAAQ,EAAE,aAAa,CAAA;IACvB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAYxB"}

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

@@ -1,8 +1,8 @@
 import type { Address, Order } from '@lifi/perps-types';
 import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
 export interface GetOrderParams {
-    /** DEX to get order from (e.g., 'hyperliquid') */
-    dex: string;
+    /** Provider to get order from (e.g., 'hyperliquid') */
+    provider: string;
     /** Wallet address */
     address: Address;
     /** Order ID */
@@ -15,14 +15,14 @@ export interface GetOrderParams {
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
  * @returns Order details
- * @throws {HTTPError} On API error responses (e.g., 404 if order not found)
+ * @throws {PerpsError} On API error responses (e.g., 404 if order not found)
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
  * const order = await getOrder(client, {
- *   dex: 'hyperliquid',
+ *   provider: 'hyperliquid',
  *   address: '0x1234...',
  *   id: '123456'
  * })

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

@@ -1 +1 @@
-{"version":3,"file":"getOrder.d.ts","sourceRoot":"","sources":["../../../src/services/getOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe;IACf,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,KAAK,CAAC,CAMhB"}
+{"version":3,"file":"getOrder.d.ts","sourceRoot":"","sources":["../../../src/services/getOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe;IACf,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,KAAK,CAAC,CAShB"}

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

@@ -1,8 +1,8 @@
 import type { OrderbookResponse } from '@lifi/perps-types';
 import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
 export interface GetOrderbookParams {
-    /** DEX to get orderbook from (e.g., 'hyperliquid') */
-    dex: string;
+    /** Provider to get orderbook from (e.g., 'hyperliquid') */
+    provider: string;
     /** Market symbol (e.g., 'BTC') */
     symbol: string;
     /** Number of levels to return (default varies by DEX) */
@@ -15,14 +15,14 @@ export interface GetOrderbookParams {
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
  * @returns Orderbook with bids and asks
- * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
  * const { bids, asks } = await getOrderbook(client, {
- *   dex: 'hyperliquid',
+ *   provider: 'hyperliquid',
  *   symbol: 'BTC',
  *   depth: 20
  * })

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

@@ -1 +1 @@
-{"version":3,"file":"getOrderbook.d.ts","sourceRoot":"","sources":["../../../src/services/getOrderbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAM5B"}
+{"version":3,"file":"getOrderbook.d.ts","sourceRoot":"","sources":["../../../src/services/getOrderbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAS5B"}

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

@@ -0,0 +1,27 @@
+import type { Address, OrdersResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface GetOrdersParams {
+    /** Provider (e.g., 'hyperliquid') */
+    provider: string;
+    /** Wallet address */
+    address: Address;
+    /** Optional symbol to filter orders by market */
+    symbol?: string;
+    /** Maximum number of results */
+    limit?: number;
+    /** Pagination cursor */
+    cursor?: string;
+}
+/**
+ * Get open orders and trigger orders for an account.
+ *
+ * @example
+ * ```ts
+ * const { openOrders, triggerOrders } = await getOrders(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ * })
+ * ```
+ */
+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,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CASzB"}

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

@@ -0,0 +1,27 @@
+import type { Address, PositionsResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+export interface GetPositionsParams {
+    /** Provider (e.g., 'hyperliquid') */
+    provider: string;
+    /** Wallet address */
+    address: Address;
+    /** Optional symbol to filter to a single position */
+    symbol?: string;
+    /** Maximum number of results */
+    limit?: number;
+    /** Pagination cursor */
+    cursor?: string;
+}
+/**
+ * Get open positions for an account.
+ *
+ * @example
+ * ```ts
+ * const { positions } = await getPositions(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ * })
+ * ```
+ */
+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,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAS5B"}

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

@@ -1,8 +1,8 @@
 import type { PricesResponse } from '@lifi/perps-types';
 import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
 export interface GetPricesParams {
-    /** DEX to get prices from (e.g., 'hyperliquid') */
-    dex: string;
+    /** Provider to get prices from (e.g., 'hyperliquid') */
+    provider: string;
     /** Optional list of symbols to filter (e.g., ['BTC', 'ETH']) */
     symbols?: string[];
 }
@@ -13,18 +13,18 @@ export interface GetPricesParams {
  * @param params - Request parameters
  * @param options - Request options (e.g., AbortSignal)
  * @returns Map of symbol to price
- * @throws {HTTPError} On API error responses
+ * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
  *
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
- * const { prices } = await getPrices(client, { dex: 'hyperliquid' })
+ * const { prices } = await getPrices(client, { provider: 'hyperliquid' })
  * console.log(prices) // { BTC: '95000.00', ETH: '3400.00', ... }
  *
  * // Filter by symbols
  * const { prices } = await getPrices(client, {
- *   dex: 'hyperliquid',
+ *   provider: 'hyperliquid',
  *   symbols: ['BTC', 'ETH']
  * })
  * ```