@lifi/perps-sdk 0.2.0-alpha.0 → 1.0.0

package/dist/esm/index.js

@@ -1,30 +1,30 @@
-// Client
-// Types
+// biome-ignore-all lint/performance/noBarrelFile: package public entry point.
+// biome-ignore-all lint/performance/noReExportAll: package public entry point.
+/**
+ * `@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';
-// Utils
-// biome-ignore lint/correctness/useImportExtensions: package subpath export
-export { HlAbstractionMode } from '@lifi/perps-types/providers/hyperliquid';
-// Agent
-export { AgentManager } from './agent/AgentManager.js';
-export { createMemoryStorage, localStorageAdapter } from './agent/storage.js';
 export { createPerpsClient, DEFAULT_API_URL, } from './client/createPerpsClient.js';
 export { PerpsClient } from './client/PerpsClient.js';
-export { projectAccountConfigSettings } from './client/projectAccountConfigSettings.js';
-export { SigningMode } from './client/types.js';
-// Errors
 export { PerpsErrorMessage } from './errors/constants.js';
 export { PerpsError } from './errors/PerpsError.js';
-export { projectHyperliquidConfigSettings } from './providers/hyperliquid/accountConfig.js';
-export { projectLighterConfigSettings } from './providers/lighter/accountConfig.js';
-// Realtime
-export { PerpsWsClient } from './realtime/PerpsWsClient.js';
+// Registries
+export { AssetRegistry, getAssetRegistry } from './registry/assetRegistry.js';
+export { getMarketRegistry, MarketRegistry, toMarketDisplay, } from './registry/marketRegistry.js';
 export { createAction } from './services/createAction.js';
 export { executeAction } from './services/executeAction.js';
 export { getAccount } from './services/getAccount.js';
 export { getActivity } from './services/getActivity.js';
-export { getAsset } from './services/getAsset.js';
 export { getAssets } from './services/getAssets.js';
 export { getFills } from './services/getFills.js';
+export { getMarket } from './services/getMarket.js';
+export { getMarkets } from './services/getMarkets.js';
+export { getMeta } from './services/getMeta.js';
 export { getOhlcv } from './services/getOhlcv.js';
 export { getOrder } from './services/getOrder.js';
 export { getOrderbook } from './services/getOrderbook.js';
@@ -32,17 +32,32 @@ export { getOrders } from './services/getOrders.js';
 export { getPositions } from './services/getPositions.js';
 export { getPrices } from './services/getPrices.js';
 export { getProviders } from './services/getProviders.js';
-export { buildReadOnlyTokenMessage, DEFAULT_API_KEY_INDEX, DEFAULT_LIGHTER_API_URL, DEFAULT_READ_ONLY_TOKEN_NAME, defaultLighterTokenFetcher, LIGHTER_PROVIDER_KEY, LighterKeyStore, LighterReadOnlyTokenManager, LighterSigner, loadLighterWasm, resetLighterWasmCache, walletClientSigner, } from './signers/lighter/index.js';
-export { calculateAccountSummary } from './utils/accountSummary.js';
-export { applySlippage, calculateExpectedPnl, calculateNotionalValue, calculatePositionSize, calculateRealizedPnlPercent, calculateRequiredMargin, calculateRoe, calculateUnrealizedPnl, estimateFees, percentFromPrice, priceFromPercent, } from './utils/calculations.js';
-export { calculateLiquidationPrice, calculateMaintenanceMarginRate, formatOrderPrice, formatOrderSize, getMaxPriceDecimals, } from './utils/hyperliquid/index.js';
-export { classifyFill, FillClassification, isStopLossOrder, isTakeProfitOrder, isTpSlOrder, } from './utils/orderClassification.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 { fetchWithRetry } from './transport/fetchWithRetry.js';
+export { DISABLED_RETRY, LIFI_REQUEST_KEY, LIFI_RETRY_DEFAULTS, resolveRetryPolicy, } from './transport/retryPolicy.js';
+export { summarizeAccount } from './utils/accountSummary.js';
+export { applySlippage, buildQuote, calculateExpectedPnl, calculateNotionalValue, calculatePositionSize, calculateRealizedPnlPercent, calculateRequiredMargin, calculateRoe, calculateUnrealizedPnl, effectiveLeverage, estimateFees, liquidationDistancePercent, percentFromPrice, priceFromPercent, removableMargin, walkOrderbook, } from './utils/calculations.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 { 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, predictAverageEntryPrice, predictNewLeverage, predictUnrealizedPnl, realizedPnlOnClose, } from './utils/positionMath.js';
-export { signTypedData } from './utils/signTypedData.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';
 // Version
 export { name, version } from './version.js';
+export { cachePromise } from './websocket/cachePromise.js';
+export { PerpsWsClient } from './websocket/PerpsWsClient.js';
+export { ReconnectingWebSocket } from './websocket/ReconnectingWebSocket.js';
+export { WS_CHANNEL_TEARDOWN_LINGER_MS, WsProviderBase, } from './websocket/WsProviderBase.js';
+export { wsLog } from './websocket/wsLog.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAE/E;;;;;;;GAOG;AAEH,cAAc,mBAAmB,CAAA;AACjC,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAC7E,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC7E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAU9D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,4BAA4B,CAAA;AAwCnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAE5D,OAAO,EACL,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,0BAA0B,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAExE,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,SAAS,GACV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,WAAW,GACZ,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,+BAA+B,EAC/B,kCAAkC,EAClC,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EACL,aAAa,EACb,gCAAgC,EAChC,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,aAAa,EACb,uBAAuB,GACxB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,UAAU;AACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAK1D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAQ5E,OAAO,EACL,6BAA6B,EAC7B,cAAc,GACf,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/esm/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/esm/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/esm/registry/assetRegistry.js

@@ -0,0 +1,48 @@
+import { buildUrl, request } from '../transport/request.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 class AssetRegistry extends ReferenceDataRegistry {
+    constructor(client, provider) {
+        super(client, provider, 'asset');
+    }
+    /** The most recently synced asset list. Empty before the first {@link sync}. */
+    get assets() {
+        return this.items;
+    }
+    fetchItems(bypassHttpCache) {
+        const url = buildUrl(`${this.client.config.apiUrl}/assets`, {
+            provider: this.provider,
+        });
+        return request(this.client.config, url, bypassHttpCache ? { cache: 'no-cache' } : {}).then((response) => response.assets);
+    }
+    keyOf(asset) {
+        return asset.id;
+    }
+}
+const registries = new WeakMap();
+/**
+ * The stable {@link AssetRegistry} for `(client, provider)`.
+ *
+ * @public
+ */
+export function getAssetRegistry(client, provider) {
+    let byProvider = registries.get(client);
+    if (byProvider === undefined) {
+        byProvider = new Map();
+        registries.set(client, byProvider);
+    }
+    let registry = byProvider.get(provider);
+    if (registry === undefined) {
+        registry = new AssetRegistry(client, provider);
+        byProvider.set(provider, registry);
+    }
+    return registry;
+}
+//# sourceMappingURL=assetRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assetRegistry.js","sourceRoot":"","sources":["../../../src/registry/assetRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE;;;;;;;GAOG;AACH,MAAM,OAAO,aAAc,SAAQ,qBAA4B;IAC7D,YAAY,MAAsB,EAAE,QAAgB;QAClD,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,gFAAgF;IAChF,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAES,UAAU,CAAC,eAAwB;QAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,EAAE;YAC1D,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAA;QACF,OAAO,OAAO,CACZ,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,GAAG,EACH,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAC7C,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;IAES,KAAK,CAAC,KAAY;QAC1B,OAAO,KAAK,CAAC,EAAE,CAAA;IACjB,CAAC;CACF;AAED,MAAM,UAAU,GAAG,IAAI,OAAO,EAA8C,CAAA;AAE5E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAsB,EACtB,QAAgB;IAEhB,IAAI,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;QACtB,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACpC,CAAC;IACD,IAAI,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC9C,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACpC,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/esm/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/esm/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/esm/registry/marketRegistry.js

@@ -0,0 +1,81 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsError } from '../errors/PerpsError.js';
+import { buildUrl, request } from '../transport/request.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 class MarketRegistry extends ReferenceDataRegistry {
+    constructor(client, provider) {
+        super(client, provider, 'market');
+    }
+    /** The most recently synced market list. Empty before the first {@link sync}. */
+    get markets() {
+        return this.items;
+    }
+    /**
+     * 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) {
+        const market = this.get(marketId);
+        if (market === undefined) {
+            const error = new PerpsError(PerpsErrorCode.MarketNotFound, `No ${this.provider} market found for marketId '${marketId}'`);
+            error.tool = this.provider;
+            throw error;
+        }
+        return market;
+    }
+    fetchItems(bypassHttpCache) {
+        const url = buildUrl(`${this.client.config.apiUrl}/markets`, {
+            provider: this.provider,
+        });
+        return request(this.client.config, url, bypassHttpCache ? { cache: 'no-cache' } : {}).then((response) => response.markets);
+    }
+    keyOf(market) {
+        return market.id;
+    }
+}
+const registries = new WeakMap();
+/**
+ * The stable {@link MarketRegistry} for `(client, provider)`.
+ *
+ * @public
+ */
+export function getMarketRegistry(client, provider) {
+    let byProvider = registries.get(client);
+    if (byProvider === undefined) {
+        byProvider = new Map();
+        registries.set(client, byProvider);
+    }
+    let registry = byProvider.get(provider);
+    if (registry === undefined) {
+        registry = new MarketRegistry(client, provider);
+        byProvider.set(provider, registry);
+    }
+    return registry;
+}
+/**
+ * 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 const toMarketDisplay = (market) => ({
+    providerId: market.providerId,
+    id: market.id,
+    categoryId: market.categoryId,
+    baseAsset: market.baseAsset,
+    quoteAsset: market.quoteAsset,
+});
+//# sourceMappingURL=marketRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marketRegistry.js","sourceRoot":"","sources":["../../../src/registry/marketRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE;;;;;;;GAOG;AACH,MAAM,OAAO,cAAe,SAAQ,qBAA6B;IAC/D,YAAY,MAAsB,EAAE,QAAgB;QAClD,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACnC,CAAC;IAED,iFAAiF;IACjF,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,QAAgB;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,UAAU,CAC1B,cAAc,CAAC,cAAc,EAC7B,MAAM,IAAI,CAAC,QAAQ,+BAA+B,QAAQ,GAAG,CAC9D,CAAA;YACD,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAA;YAC1B,MAAM,KAAK,CAAA;QACb,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAES,UAAU,CAAC,eAAwB;QAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE;YAC3D,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAA;QACF,OAAO,OAAO,CACZ,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,GAAG,EACH,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAC7C,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACxC,CAAC;IAES,KAAK,CAAC,MAAc;QAC5B,OAAO,MAAM,CAAC,EAAE,CAAA;IAClB,CAAC;CACF;AAED,MAAM,UAAU,GAAG,IAAI,OAAO,EAA+C,CAAA;AAE7E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAsB,EACtB,QAAgB;IAEhB,IAAI,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;QACtB,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACpC,CAAC;IACD,IAAI,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC/C,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACpC,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAiB,EAAE,CAAC,CAAC;IACjE,UAAU,EAAE,MAAM,CAAC,UAAU;IAC7B,EAAE,EAAE,MAAM,CAAC,EAAE;IACb,UAAU,EAAE,MAAM,CAAC,UAAU;IAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;CAC9B,CAAC,CAAA"}

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

@@ -1,5 +1,12 @@
-import type { ActionParamsMap, ActionType, Address, CreateActionResponse } from '@lifi/perps-types';
-import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+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;
@@ -7,5 +14,13 @@ export interface CreateActionParams<T extends ActionType = ActionType> {
     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

@@ -1 +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"}
+{"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

@@ -1,4 +1,12 @@
-import { request } from '../utils/request.js';
+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',

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

@@ -1 +1 @@
-{"version":3,"file":"createAction.js","sourceRoot":"","sources":["../../../src/services/createAction.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAU7C,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"}
+{"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

@@ -1,5 +1,12 @@
-import type { ActionType, Address, ExecuteActionResponse, SignedActionStep } from '@lifi/perps-types';
-import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+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;
@@ -7,5 +14,13 @@ export interface ExecuteActionParams {
     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

@@ -1 +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"}
+{"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

@@ -1,7 +1,19 @@
-import { request } from '../utils/request.js';
+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,

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

@@ -1 +1 @@
-{"version":3,"file":"executeAction.js","sourceRoot":"","sources":["../../../src/services/executeAction.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAU7C,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,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"}
+{"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"}