@lifi/perps-sdk 0.1.1-alpha.9 → 1.0.0

package/dist/types/errors/constants.d.ts

@@ -1,15 +1,11 @@
-export declare enum PerpsErrorName {
-    PerpsError = "PerpsError",
-    HTTPError = "HTTPError",
-    ValidationError = "ValidationError",
-    ServerError = "ServerError",
-    ConfigError = "ConfigError",
-    AgentError = "AgentError"
-}
+/**
+ * Canonical human-readable messages paired with SDK-originated
+ * {@link PerpsError}s.
+ *
+ * @public
+ */
 export declare enum PerpsErrorMessage {
-    UnknownError = "Unknown error occurred.",
-    ConfigNotInitialized = "SDK not configured. Call createPerpsConfig() first.",
-    AgentNotFound = "Agent not found. Call setSigningMode() first.",
-    InvalidSigningMode = "Invalid signing mode for this operation."
+    AgentNotFound = "Agent not found. Complete provider setup (APPROVE_AGENT) first.",
+    AgentStorageCorrupt = "Stored agent keypair is malformed. Revoke and re-approve the agent (APPROVE_AGENT) to regenerate it."
 }
 //# sourceMappingURL=constants.d.ts.map

package/dist/types/errors/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA,oBAAY,cAAc;IACxB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,UAAU,eAAe;CAC1B;AAED,oBAAY,iBAAiB;IAC3B,YAAY,4BAA4B;IACxC,oBAAoB,wDAAwD;IAC5E,aAAa,kDAAkD;IAC/D,kBAAkB,6CAA6C;CAChE"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,aAAa,oEAAoE;IACjF,mBAAmB,yGAAyG;CAC7H"}

package/dist/types/index.d.ts

@@ -1,54 +1,86 @@
+/**
+ * `@lifi/perps-sdk` — the public entry point. Exports `createPerpsClient` and
+ * `PerpsClient` (the primary API), the realtime `PerpsWsClient`, the pure
+ * calculation/parsing/order helpers, and re-exports the shared `@lifi/perps-types`.
+ *
+ * @packageDocumentation
+ * @public
+ */
 export * from '@lifi/perps-types';
-export { AgentManager } from './agent/AgentManager.js';
-export { createMemoryStorage, localStorageAdapter } from './agent/storage.js';
-export type { Agent, StorageAdapter } from './agent/types.js';
-export type { PerpsBaseConfig, PerpsConfig, PerpsSDKClient, RequestInterceptor, SDKRequestOptions, } from './client/createPerpsClient.js';
 export { createPerpsClient, DEFAULT_API_URL, } from './client/createPerpsClient.js';
 export { PerpsClient } from './client/PerpsClient.js';
-export type { BuildAuthorizationParams, BuildWithdrawalParams, CancelOrdersParams, ExecuteAuthorizationsParams, ExecuteAuthorizationsResult, GetRequiredAuthorizationsParams, PerpsClientOptions, PlaceOrderParams, RequiredAuthorizationsResult, SigningMode, } from './client/types.js';
-export { getDexAuthProvider } from './dex/registry.js';
-export type { DexAuthInputs, DexAuthProvider } from './dex/types.js';
-export { AgentError } from './errors/AgentError.js';
-export { PerpsErrorMessage, PerpsErrorName } from './errors/constants.js';
-export { HTTPError } from './errors/HTTPError.js';
+export { PerpsErrorMessage } from './errors/constants.js';
 export { PerpsError } from './errors/PerpsError.js';
-export { PerpsSDKError } from './errors/PerpsSDKError.js';
-export { ServerError } from './errors/ServerError.js';
-export { findErrorType, getErrorChain, getRootCause, getRootCauseMessage, hasErrorType, } from './errors/utils/rootCause.js';
-export { ValidationError } from './errors/ValidationError.js';
-export { PerpsWsClient } from './realtime/PerpsWsClient.js';
-export type { EventForSubscription } from './realtime/types.js';
-export type { CancelOrderParams } from './services/cancelOrder.js';
-export { cancelOrder } from './services/cancelOrder.js';
-export type { CreateAuthorizationParams } from './services/createAuthorization.js';
-export { createAuthorization } from './services/createAuthorization.js';
-export type { CreateOrderParams } from './services/createOrder.js';
-export { createOrder } from './services/createOrder.js';
-export type { CreateWithdrawalParams } from './services/createWithdrawal.js';
-export { createWithdrawal } from './services/createWithdrawal.js';
+export { AssetRegistry, getAssetRegistry } from './registry/assetRegistry.js';
+export { getMarketRegistry, MarketRegistry, toMarketDisplay, } from './registry/marketRegistry.js';
+export type { CreateActionParams } from './services/createAction.js';
+export { createAction } from './services/createAction.js';
+export type { ExecuteActionParams } from './services/executeAction.js';
+export { executeAction } from './services/executeAction.js';
 export type { GetAccountParams } from './services/getAccount.js';
 export { getAccount } from './services/getAccount.js';
-export { getDexes } from './services/getDexes.js';
-export type { GetHistoryParams } from './services/getHistory.js';
-export { getHistory } from './services/getHistory.js';
+export type { GetActivityParams } from './services/getActivity.js';
+export { getActivity } from './services/getActivity.js';
+export type { GetAssetsParams } from './services/getAssets.js';
+export { getAssets } from './services/getAssets.js';
+export type { GetFillsParams } from './services/getFills.js';
+export { getFills } from './services/getFills.js';
 export type { GetMarketParams } from './services/getMarket.js';
 export { getMarket } from './services/getMarket.js';
 export type { GetMarketsParams } from './services/getMarkets.js';
 export { getMarkets } from './services/getMarkets.js';
+export { getMeta } from './services/getMeta.js';
 export type { GetOhlcvParams } from './services/getOhlcv.js';
 export { getOhlcv } from './services/getOhlcv.js';
 export type { GetOrderParams } from './services/getOrder.js';
 export { getOrder } from './services/getOrder.js';
 export type { GetOrderbookParams } from './services/getOrderbook.js';
 export { getOrderbook } from './services/getOrderbook.js';
+export type { GetOrdersParams } from './services/getOrders.js';
+export { getOrders } from './services/getOrders.js';
+export type { GetPositionsParams } from './services/getPositions.js';
+export { getPositions } from './services/getPositions.js';
 export type { GetPricesParams } from './services/getPrices.js';
 export { getPrices } from './services/getPrices.js';
-export type { SubmitAuthorizationParams } from './services/submitAuthorization.js';
-export { submitAuthorization } from './services/submitAuthorization.js';
-export type { SubmitOrderParams } from './services/submitOrder.js';
-export { submitOrder } from './services/submitOrder.js';
-export type { SubmitWithdrawalParams } from './services/submitWithdrawal.js';
-export { submitWithdrawal } from './services/submitWithdrawal.js';
-export { signTypedData } from './utils/signTypedData.js';
+export { getProviders } from './services/getProviders.js';
+export type { GetQuoteParams } from './services/getQuote.js';
+export { getQuote } from './services/getQuote.js';
+export { getTermsAcceptance } from './services/getTermsAcceptance.js';
+export { resolveQuote, resolveQuoteMarket } from './services/resolveQuote.js';
+export { QUOTE_THROTTLE_MS, resolveSubscribeQuote, } from './services/resolveSubscribeQuote.js';
+export { parseStoredRecord, readValidatedRecord, } from './storage/parseStoredRecord.js';
+export { createMemoryStorage, localStorageAdapter } from './storage/storage.js';
+export type { StorageAdapter } from './storage/types.js';
+export type { FetchWithRetryOptions } from './transport/fetchWithRetry.js';
+export { fetchWithRetry } from './transport/fetchWithRetry.js';
+export type { ProviderRetryConfig, ResolvedRetryPolicy, RetryAttemptContext, RetryClassification, RetryClassifyContext, RetryConfig, RetryPolicy, } from './transport/retryPolicy.js';
+export { DISABLED_RETRY, LIFI_REQUEST_KEY, LIFI_RETRY_DEFAULTS, resolveRetryPolicy, } from './transport/retryPolicy.js';
+export type { BuildProviderSetupParams, CancelOrdersParams, ExecuteProviderSetupParams, ExecuteProviderSetupResult, GetAccountResult, GetSetupParams, ModifyOrdersParams, PerpsClientOptions, PerpsConfig, PlaceOrderParams as ClientPlaceOrderParams, PlaceTriggerOrderParams as ClientPlaceTriggerOrderParams, ProviderSetup, } from './types/api.js';
+export type { HyperliquidConfig, PerpsBaseConfig, PerpsClientSigner, ProviderConfig, ProviderConfigs, RequestInterceptor, SDKRequestOptions, } from './types/config.js';
+export type { ActionSignerContribution, LiquidationEstimateParams, PerpsProvider, PerpsProviderPlugin, PerpsSDKClient, ProviderGetAccountParams, ProviderGetActivityParams, ProviderGetFillsParams, ProviderGetOrderParams, ProviderGetOrdersParams, ProviderGetPositionsParams, ProviderGetQuoteParams, QuoteListener, SignActionsContext, } from './types/provider.js';
+export { summarizeAccount } from './utils/accountSummary.js';
+export type { ExpectedPnl } from './utils/calculations.js';
+export { applySlippage, buildQuote, calculateExpectedPnl, calculateNotionalValue, calculatePositionSize, calculateRealizedPnlPercent, calculateRequiredMargin, calculateRoe, calculateUnrealizedPnl, effectiveLeverage, estimateFees, liquidationDistancePercent, percentFromPrice, priceFromPercent, removableMargin, walkOrderbook, } from './utils/calculations.js';
+export type { DepositProviderKey } from './utils/depositChain.js';
+export { LIFI_DEPOSIT_CHAIN_BY_PROVIDER, lifiDepositChainForProvider, } from './utils/depositChain.js';
+export { ExplorerChainId, explorerTxUrl } from './utils/explorer.js';
+export { classifyFillFromPosition } from './utils/fillClassification.js';
+export type { FormatOptions } from './utils/format.js';
+export { formatCompactUsd, formatPrice, formatSignedPercent, formatSignedUsd, formatUsd, } from './utils/format.js';
+export { ACTIVE_ORDER_STATUSES, classifyFill, FillClassification, isActiveOrderStatus, isStopLossOrder, isTakeProfitOrder, isTpSlOrder, } from './utils/orderClassification.js';
+export { expectedRealizedPnlForOpenOrder, expectedRealizedPnlForTriggerOrder, findMatchingPosition, resolveCloseSize, } from './utils/orderMath.js';
+export { stringToFloat } from './utils/parse.js';
+export { directionSign, estimateIsolatedLiquidationPrice, predictAverageEntryPrice, predictNewLeverage, predictUnrealizedPnl, realizedPnlOnClose, } from './utils/positionMath.js';
+export { signTypedData, signTypedDataWithSigner, } from './utils/signTypedData.js';
+export { fromBaseUnits, fromBaseUnitsNumber } from './utils/units.js';
+export { validateMargin } from './utils/validation.js';
 export { name, version } from './version.js';
+export { cachePromise } from './websocket/cachePromise.js';
+export type { PerpsWsClientOptions, WsProviderFactory, } from './websocket/PerpsWsClient.js';
+export { PerpsWsClient } from './websocket/PerpsWsClient.js';
+export type { ReconnectingWebSocketOptions } from './websocket/ReconnectingWebSocket.js';
+export { ReconnectingWebSocket } from './websocket/ReconnectingWebSocket.js';
+export type { EventForSubscription, SubscriptionListener, WsConnectionStatus, WsProvider, WsStatusListener, } from './websocket/types.js';
+export { WS_CHANNEL_TEARDOWN_LINGER_MS, WsProviderBase, } from './websocket/WsProviderBase.js';
+export { wsLog } from './websocket/wsLog.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/registry/assetRegistry.d.ts

@@ -0,0 +1,25 @@
+import type { Asset } from '@lifi/perps-types';
+import type { PerpsSDKClient } from '../types/provider.js';
+import { ReferenceDataRegistry } from './referenceDataRegistry.js';
+/**
+ * Per-provider index over the backend's `/assets` token registry, keyed by
+ * `Asset.id` — the provider-native asset id (Lighter: the stringified
+ * `asset_id`, Hyperliquid spot: the venue token index). Obtain via
+ * {@link getAssetRegistry}.
+ *
+ * @public
+ */
+export declare class AssetRegistry extends ReferenceDataRegistry<Asset> {
+    constructor(client: PerpsSDKClient, provider: string);
+    /** The most recently synced asset list. Empty before the first {@link sync}. */
+    get assets(): readonly Asset[];
+    protected fetchItems(bypassHttpCache: boolean): Promise<Asset[]>;
+    protected keyOf(asset: Asset): string;
+}
+/**
+ * The stable {@link AssetRegistry} for `(client, provider)`.
+ *
+ * @public
+ */
+export declare function getAssetRegistry(client: PerpsSDKClient, provider: string): AssetRegistry;
+//# sourceMappingURL=assetRegistry.d.ts.map

package/dist/types/registry/assetRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetRegistry.d.ts","sourceRoot":"","sources":["../../../src/registry/assetRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,mBAAmB,CAAA;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,qBAAqB,CAAC,KAAK,CAAC;gBACjD,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM;IAIpD,gFAAgF;IAChF,IAAI,MAAM,IAAI,SAAS,KAAK,EAAE,CAE7B;IAED,SAAS,CAAC,UAAU,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAWhE,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;CAGtC;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GACf,aAAa,CAYf"}

package/dist/types/registry/marketRegistry.d.ts

@@ -0,0 +1,42 @@
+import type { Market, MarketDisplay } from '@lifi/perps-types';
+import type { PerpsSDKClient } from '../types/provider.js';
+import { ReferenceDataRegistry } from './referenceDataRegistry.js';
+/**
+ * Per-provider index over the backend's enriched `/markets` list, keyed by
+ * `Market.id` — the venue wire key (Hyperliquid: the coin string, Lighter:
+ * the stringified `market_index`). Obtain via {@link getMarketRegistry};
+ * shared by the provider packages' REST services and WS providers.
+ *
+ * @public
+ */
+export declare class MarketRegistry extends ReferenceDataRegistry<Market> {
+    constructor(client: PerpsSDKClient, provider: string);
+    /** The most recently synced market list. Empty before the first {@link sync}. */
+    get markets(): readonly Market[];
+    /**
+     * Lookup by `Market.id`, throwing when the backend list does not know the
+     * id. The list is the source of truth for every tradable market, so an id
+     * the venue references but the backend does not know is a hard error —
+     * never a silent fallback to an unenriched stand-in.
+     *
+     * @throws {PerpsError} `MarketNotFound`.
+     */
+    require(marketId: string): Market;
+    protected fetchItems(bypassHttpCache: boolean): Promise<Market[]>;
+    protected keyOf(market: Market): string;
+}
+/**
+ * The stable {@link MarketRegistry} for `(client, provider)`.
+ *
+ * @public
+ */
+export declare function getMarketRegistry(client: PerpsSDKClient, provider: string): MarketRegistry;
+/**
+ * Project a {@link Market} to the {@link MarketDisplay} identity embedded on
+ * mapped positions/orders/fills, preserving the backend's `baseAsset` and
+ * `quoteAsset` verbatim (logos, display names).
+ *
+ * @public
+ */
+export declare const toMarketDisplay: (market: Market) => MarketDisplay;
+//# sourceMappingURL=marketRegistry.d.ts.map

package/dist/types/registry/marketRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketRegistry.d.ts","sourceRoot":"","sources":["../../../src/registry/marketRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAmB,MAAM,mBAAmB,CAAA;AAI/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,qBAAqB,CAAC,MAAM,CAAC;gBACnD,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM;IAIpD,iFAAiF;IACjF,IAAI,OAAO,IAAI,SAAS,MAAM,EAAE,CAE/B;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAajC,SAAS,CAAC,UAAU,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWjE,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGxC;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GACf,cAAc,CAYhB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,aAM/C,CAAA"}

package/dist/types/registry/referenceDataRegistry.d.ts

@@ -0,0 +1,44 @@
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * 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 declare abstract class ReferenceDataRegistry<T> {
+    protected readonly client: PerpsSDKClient;
+    readonly provider: string;
+    private readonly kind;
+    private index;
+    private current;
+    private inflight;
+    private warnedIds;
+    private refreshAfter;
+    protected constructor(client: PerpsSDKClient, provider: string, kind: string);
+    /** Fetch the provider's full list, bypassing the HTTP cache when asked. */
+    protected abstract fetchItems(bypassHttpCache: boolean): Promise<T[]>;
+    /** The item's primary key — what {@link get} is keyed by. */
+    protected abstract keyOf(item: T): string;
+    /**
+     * 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(): Promise<readonly T[]>;
+    /** The most recently synced list. Empty before the first {@link sync}. */
+    protected get items(): readonly T[];
+    /**
+     * O(1) lookup by primary key. A miss warns once per id and schedules the
+     * cooldown-gated, cache-bypassing background refetch.
+     */
+    get(id: string): T | undefined;
+    private load;
+    private scheduleRefresh;
+}
+//# sourceMappingURL=referenceDataRegistry.d.ts.map

package/dist/types/registry/referenceDataRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceDataRegistry.d.ts","sourceRoot":"","sources":["../../../src/registry/referenceDataRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAK1D;;;;;;;;;;;GAWG;AACH,8BAAsB,qBAAqB,CAAC,CAAC;IAQzC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IATvB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,YAAY,CAAI;IAExB,SAAS,aACY,MAAM,EAAE,cAAc,EAChC,QAAQ,EAAE,MAAM,EACR,IAAI,EAAE,MAAM;IAG/B,2EAA2E;IAC3E,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAErE,6DAA6D;IAC7D,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM;IAEzC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAS7B,0EAA0E;IAC1E,SAAS,KAAK,KAAK,IAAI,SAAS,CAAC,EAAE,CAElC;IAED;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;YAahB,IAAI;IAQlB,OAAO,CAAC,eAAe;CAcxB"}

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

@@ -1,32 +1,35 @@
-import type { AccountResponse, Address } from '@lifi/perps-types';
-import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+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 {
-    /** DEX to get account from (e.g., 'hyperliquid') */
-    dex: string;
-    /** Wallet address */
+    provider: string;
     address: Address;
 }
 /**
- * Get account information including balances, positions, and open orders.
+ * 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.
  *
- * @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 network or parsing errors
+ * 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 client = createPerpsClient({ integrator: 'my-app' })
  * const account = await getAccount(client, {
- *   dex: 'hyperliquid',
- *   address: '0x1234...'
+ *   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', ... }]
+ * 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

@@ -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,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

@@ -1,27 +1,34 @@
 import type { Market } from '@lifi/perps-types';
-import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getMarket}.
+ *
+ * @public
+ */
 export interface GetMarketParams {
-    /** DEX to get market from (e.g., 'hyperliquid') */
-    dex: string;
-    /** Market symbol (e.g., 'BTC') */
-    symbol: string;
+    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 symbol.
- *
- * @param client - The SDK client instance
- * @param params - Request parameters
- * @param options - Request options (e.g., AbortSignal)
- * @returns Market details
- * @throws {HTTPError} On API error responses (e.g., 404 if market not found)
- * @throws {PerpsError} On network or parsing errors
+ * 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, { dex: 'hyperliquid', symbol: 'BTC' })
- * console.log(market) // { symbol: 'BTC', markPrice: '95000.00', ... }
+ * 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

@@ -1 +1 @@
-{"version":3,"file":"getMarket.d.ts","sourceRoot":"","sources":["../../../src/services/getMarket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAKjB"}
+{"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"}