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

package/dist/esm/services/getProviders.js

@@ -1,9 +1,7 @@
-import { request } from '../utils/request.js';
+import { request } from '../transport/request.js';
 /**
  * Get all available providers.
  *
- * @param client - The SDK client instance
- * @param options - Request options (e.g., AbortSignal)
  * @returns List of supported providers with their authorization requirements
  * @throws {PerpsError} On API error responses
  * @throws {PerpsError} On network or parsing errors
@@ -14,6 +12,7 @@ import { request } from '../utils/request.js';
  * const { providers } = await getProviders(client)
  * console.log(providers) // [{ key: 'hyperliquid', name: 'Hyperliquid', ... }]
  * ```
+ * @public
  */
 export async function getProviders(client, options) {
     return request(client.config, `${client.config.apiUrl}/providers`, {}, options);

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

@@ -1 +1 @@
-{"version":3,"file":"getProviders.js","sourceRoot":"","sources":["../../../src/services/getProviders.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,OAA2B;IAE3B,OAAO,OAAO,CACZ,MAAM,CAAC,MAAM,EACb,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,EACnC,EAAE,EACF,OAAO,CACR,CAAA;AACH,CAAC"}
+{"version":3,"file":"getProviders.js","sourceRoot":"","sources":["../../../src/services/getProviders.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAIjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,OAA2B;IAE3B,OAAO,OAAO,CACZ,MAAM,CAAC,MAAM,EACb,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,EACnC,EAAE,EACF,OAAO,CACR,CAAA;AACH,CAAC"}

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

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

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

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

package/dist/esm/services/getQuote.js

@@ -0,0 +1,33 @@
+import { requireProvider } from '../client/requireProvider.js';
+/**
+ * Get a one-shot fill quote for `size` USD notional of `symbol` on a single
+ * venue: VWAP expected fill, price impact (bps), base-tier taker fee, and
+ * funding (perps only). Delegates to the registered venue plugin, which
+ * resolves the symbol against its own markets (scoped by `type`) and walks its
+ * orderbook. Cross-venue comparison is a consumer-side loop over
+ * `client.providers`.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, no market
+ *   matches the symbol+type, or on network / parsing errors.
+ * @example
+ * ```ts
+ * const quote = await getQuote(client, {
+ *   provider: 'hyperliquid',
+ *   symbol: 'BTC',
+ *   side: 'buy',
+ *   size: 10_000,
+ *   type: 'perps',
+ * })
+ * console.log(quote.expectedFillPrice, quote.priceImpactBps)
+ * ```
+ * @public
+ */
+export async function getQuote(client, params, options) {
+    return requireProvider(client, params.provider).getQuote({
+        symbol: params.symbol,
+        side: params.side,
+        size: params.size,
+        type: params.type,
+    }, options);
+}
+//# sourceMappingURL=getQuote.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getQuote.js","sourceRoot":"","sources":["../../../src/services/getQuote.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAmB9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAsB,EACtB,MAAsB,EACtB,OAA2B;IAE3B,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CACtD;QACE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

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

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

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

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

package/dist/esm/services/getTermsAcceptance.js

@@ -0,0 +1,24 @@
+import { buildUrl, request } from '../transport/request.js';
+/**
+ * Get the current Terms of Service (version + full content) and whether the
+ * given address has accepted them. Provider-independent — reads from the
+ * platform `meta` surface, not a venue plugin.
+ *
+ * @param address - Address whose acceptance status to resolve
+ * @throws {PerpsError} On backend error responses, network, or parsing errors.
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const terms = await getTermsAcceptance(client, '0x1234...')
+ * if (!terms.accepted) {
+ *   // prompt the user to accept terms.content (version terms.termsVersion)
+ * }
+ * ```
+ * @public
+ */
+export async function getTermsAcceptance(client, address, options) {
+    const url = buildUrl(`${client.config.apiUrl}/meta/terms`, { address });
+    return request(client.config, url, {}, options);
+}
+//# sourceMappingURL=getTermsAcceptance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getTermsAcceptance.js","sourceRoot":"","sources":["../../../src/services/getTermsAcceptance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAI3D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAsB,EACtB,OAAgB,EAChB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IACvE,OAAO,OAAO,CAAwB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACxE,CAAC"}

package/dist/esm/services/resolveQuote.d.ts

@@ -0,0 +1,36 @@
+import { type FeeTier, type Market, type MarketPrice, type Quote } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient, ProviderGetQuoteParams } from '../types/provider.js';
+/**
+ * Shared provider-side `getQuote` implementation: resolve `params.symbol` to a
+ * market on `provider` (matching `baseAsset.displaySymbol`, scoped by
+ * `params.type`), fetch the orderbook snapshot, and build the {@link Quote}
+ * with the provider's public base `feeTier`. Both venue plugins delegate here
+ * so symbol resolution and the book walk live in one place; each plugin only
+ * supplies its own base tier.
+ *
+ * @throws {PerpsError} `MarketNotFound` when no market matches symbol+type.
+ * @internal
+ */
+export declare function resolveQuote(client: PerpsSDKClient, provider: string, params: ProviderGetQuoteParams, feeTier: FeeTier, options?: SDKRequestOptions): Promise<Quote>;
+/**
+ * Resolve `params.symbol` to a market on `provider` (matching
+ * `baseAsset.displaySymbol`, scoped by `params.type`). Shared by the one-shot
+ * {@link resolveQuote} and the streaming quote subscription so both quote the
+ * same market for a given symbol+type.
+ *
+ * @throws {PerpsError} `MarketNotFound` when no market matches symbol+type.
+ * @internal
+ */
+export declare function resolveQuoteMarket(client: PerpsSDKClient, provider: string, params: Pick<ProviderGetQuoteParams, 'symbol' | 'type'>, options?: SDKRequestOptions): Promise<Market>;
+/**
+ * Fetch the live {@link MarketPrice} for `marketId` on `provider`, the source
+ * of the `markPrice` and `funding` a {@link Quote} carries. Shared by the
+ * one-shot {@link resolveQuote} and the streaming quote subscription.
+ *
+ * @throws {PerpsError} `ServerError` when the provider returns no price for the
+ * market.
+ * @internal
+ */
+export declare function resolveQuotePrice(client: PerpsSDKClient, provider: string, marketId: string, options?: SDKRequestOptions): Promise<MarketPrice>;
+//# sourceMappingURL=resolveQuote.d.ts.map

package/dist/esm/services/resolveQuote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveQuote.d.ts","sourceRoot":"","sources":["../../../src/services/resolveQuote.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,WAAW,EAEhB,KAAK,KAAK,EACX,MAAM,mBAAmB,CAAA;AAE1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACvB,MAAM,sBAAsB,CAAA;AAM7B;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,KAAK,CAAC,CAqBhB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,MAAM,CAAC,EACvD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAcjB;AAOD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC,CActB"}

package/dist/esm/services/resolveQuote.js

@@ -0,0 +1,74 @@
+import { PerpsErrorCode, } from '@lifi/perps-types';
+import { PerpsError } from '../errors/PerpsError.js';
+import { buildQuote } from '../utils/calculations.js';
+import { getMarkets } from './getMarkets.js';
+import { getOrderbook } from './getOrderbook.js';
+import { getPrices } from './getPrices.js';
+/**
+ * Shared provider-side `getQuote` implementation: resolve `params.symbol` to a
+ * market on `provider` (matching `baseAsset.displaySymbol`, scoped by
+ * `params.type`), fetch the orderbook snapshot, and build the {@link Quote}
+ * with the provider's public base `feeTier`. Both venue plugins delegate here
+ * so symbol resolution and the book walk live in one place; each plugin only
+ * supplies its own base tier.
+ *
+ * @throws {PerpsError} `MarketNotFound` when no market matches symbol+type.
+ * @internal
+ */
+export async function resolveQuote(client, provider, params, feeTier, options) {
+    const market = await resolveQuoteMarket(client, provider, params, options);
+    const [{ bids, asks }, price] = await Promise.all([
+        getOrderbook(client, { provider, marketId: market.id }, options),
+        resolveQuotePrice(client, provider, market.id, options),
+    ]);
+    return buildQuote({
+        provider,
+        symbol: params.symbol,
+        type: params.type,
+        side: params.side,
+        sizeUsd: params.size,
+        market,
+        price,
+        bids,
+        asks,
+        feeTier,
+        timestamp: Date.now(),
+    });
+}
+/**
+ * Resolve `params.symbol` to a market on `provider` (matching
+ * `baseAsset.displaySymbol`, scoped by `params.type`). Shared by the one-shot
+ * {@link resolveQuote} and the streaming quote subscription so both quote the
+ * same market for a given symbol+type.
+ *
+ * @throws {PerpsError} `MarketNotFound` when no market matches symbol+type.
+ * @internal
+ */
+export async function resolveQuoteMarket(client, provider, params, options) {
+    const { markets } = await getMarkets(client, { provider }, options);
+    const market = markets.find((m) => m.baseAsset.displaySymbol === params.symbol &&
+        isMarketOfType(m, params.type));
+    if (market === undefined) {
+        throw new PerpsError(PerpsErrorCode.MarketNotFound, `No ${params.type} market found on '${provider}' for symbol '${params.symbol}'.`);
+    }
+    return market;
+}
+const isMarketOfType = (market, type) => ('maxLeverage' in market ? type === 'perps' : type === 'spot');
+/**
+ * Fetch the live {@link MarketPrice} for `marketId` on `provider`, the source
+ * of the `markPrice` and `funding` a {@link Quote} carries. Shared by the
+ * one-shot {@link resolveQuote} and the streaming quote subscription.
+ *
+ * @throws {PerpsError} `ServerError` when the provider returns no price for the
+ * market.
+ * @internal
+ */
+export async function resolveQuotePrice(client, provider, marketId, options) {
+    const { prices } = await getPrices(client, { provider, marketIds: [marketId] }, options);
+    const price = prices.find((p) => p.marketId === marketId);
+    if (price === undefined) {
+        throw new PerpsError(PerpsErrorCode.ServerError, `No price returned by '${provider}' for marketId '${marketId}'.`);
+    }
+    return price;
+}
+//# sourceMappingURL=resolveQuote.js.map

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

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

package/dist/esm/services/resolveSubscribeQuote.d.ts

@@ -0,0 +1,31 @@
+import type { FeeTier } from '@lifi/perps-types';
+import type { PerpsSDKClient, ProviderGetQuoteParams, QuoteListener } from '../types/provider.js';
+import type { WsProvider } from '../websocket/types.js';
+/**
+ * Minimum gap between successive streamed {@link Quote} emissions — the same
+ * 100 ms pacing applied to streamed orderbook rendering, so a quote ticks no
+ * faster than the book it derives from.
+ *
+ * @public
+ */
+export declare const QUOTE_THROTTLE_MS = 100;
+/**
+ * Shared provider-side `subscribeQuote` implementation: resolve
+ * `params.symbol` to a market on `provider` (via {@link resolveQuoteMarket}),
+ * subscribe to that market's orderbook channel on `ws`, and on each book
+ * update rebuild the {@link Quote} with the provider's public base `feeTier` —
+ * the same transform the one-shot `resolveQuote` applies to a REST snapshot.
+ * Emissions are throttled to {@link QUOTE_THROTTLE_MS}: the first book update
+ * emits immediately, then at most one (trailing, latest-book) emission per
+ * interval. Both venue WS plugins delegate here; each only supplies its own
+ * base tier.
+ *
+ * The returned unsubscribe is idempotent — it releases the underlying
+ * orderbook listener once and cancels any pending trailing emission, so the
+ * wire subscription's ref count cannot be double-decremented.
+ *
+ * @throws {PerpsError} `MarketNotFound` when no market matches symbol+type.
+ * @internal
+ */
+export declare function resolveSubscribeQuote(client: PerpsSDKClient, provider: string, ws: Pick<WsProvider, 'subscribe'>, params: ProviderGetQuoteParams, feeTier: FeeTier, onQuote: QuoteListener): Promise<() => void>;
+//# sourceMappingURL=resolveSubscribeQuote.d.ts.map

package/dist/esm/services/resolveSubscribeQuote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSubscribeQuote.d.ts","sourceRoot":"","sources":["../../../src/services/resolveSubscribeQuote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,mBAAmB,CAAA;AACnE,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,aAAa,EACd,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGvD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EACjC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC,CAgErB"}

package/dist/esm/services/resolveSubscribeQuote.js

@@ -0,0 +1,86 @@
+import { buildQuote } from '../utils/calculations.js';
+import { resolveQuoteMarket, resolveQuotePrice } from './resolveQuote.js';
+/**
+ * Minimum gap between successive streamed {@link Quote} emissions — the same
+ * 100 ms pacing applied to streamed orderbook rendering, so a quote ticks no
+ * faster than the book it derives from.
+ *
+ * @public
+ */
+export const QUOTE_THROTTLE_MS = 100;
+/**
+ * Shared provider-side `subscribeQuote` implementation: resolve
+ * `params.symbol` to a market on `provider` (via {@link resolveQuoteMarket}),
+ * subscribe to that market's orderbook channel on `ws`, and on each book
+ * update rebuild the {@link Quote} with the provider's public base `feeTier` —
+ * the same transform the one-shot `resolveQuote` applies to a REST snapshot.
+ * Emissions are throttled to {@link QUOTE_THROTTLE_MS}: the first book update
+ * emits immediately, then at most one (trailing, latest-book) emission per
+ * interval. Both venue WS plugins delegate here; each only supplies its own
+ * base tier.
+ *
+ * The returned unsubscribe is idempotent — it releases the underlying
+ * orderbook listener once and cancels any pending trailing emission, so the
+ * wire subscription's ref count cannot be double-decremented.
+ *
+ * @throws {PerpsError} `MarketNotFound` when no market matches symbol+type.
+ * @internal
+ */
+export async function resolveSubscribeQuote(client, provider, ws, params, feeTier, onQuote) {
+    const market = await resolveQuoteMarket(client, provider, params);
+    const price = await resolveQuotePrice(client, provider, market.id);
+    let latestBook;
+    let lastEmitAt = Number.NEGATIVE_INFINITY;
+    let trailing;
+    const emit = () => {
+        if (latestBook === undefined) {
+            return;
+        }
+        lastEmitAt = Date.now();
+        onQuote(buildQuote({
+            provider,
+            symbol: params.symbol,
+            type: params.type,
+            side: params.side,
+            sizeUsd: params.size,
+            market,
+            price,
+            bids: latestBook.bids,
+            asks: latestBook.asks,
+            feeTier,
+            timestamp: Date.now(),
+        }));
+    };
+    const unsubscribe = await ws.subscribe({ channel: 'orderbook', dex: provider, marketId: market.id }, (event) => {
+        if (event.channel !== 'orderbook') {
+            return;
+        }
+        latestBook = event.data;
+        if (trailing !== undefined) {
+            return;
+        }
+        const wait = QUOTE_THROTTLE_MS - (Date.now() - lastEmitAt);
+        if (wait <= 0) {
+            emit();
+        }
+        else {
+            trailing = setTimeout(() => {
+                trailing = undefined;
+                emit();
+            }, wait);
+        }
+    });
+    let released = false;
+    return () => {
+        if (released) {
+            return;
+        }
+        released = true;
+        if (trailing !== undefined) {
+            clearTimeout(trailing);
+            trailing = undefined;
+        }
+        unsubscribe();
+    };
+}
+//# sourceMappingURL=resolveSubscribeQuote.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSubscribeQuote.js","sourceRoot":"","sources":["../../../src/services/resolveSubscribeQuote.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAsB,EACtB,QAAgB,EAChB,EAAiC,EACjC,MAA8B,EAC9B,OAAgB,EAChB,OAAsB;IAEtB,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IACjE,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;IAElE,IAAI,UAAyC,CAAA;IAC7C,IAAI,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAA;IACzC,IAAI,QAAmD,CAAA;IAEvD,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAM;QACR,CAAC;QACD,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACvB,OAAO,CACL,UAAU,CAAC;YACT,QAAQ;YACR,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,IAAI;YACpB,MAAM;YACN,KAAK;YACL,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CACH,CAAA;IACH,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,SAAS,CACpC,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,EAC5D,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;YAClC,OAAM;QACR,CAAC;QACD,UAAU,GAAG,KAAK,CAAC,IAAI,CAAA;QACvB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,iBAAiB,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAA;QAC1D,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACd,IAAI,EAAE,CAAA;QACR,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;gBACzB,QAAQ,GAAG,SAAS,CAAA;gBACpB,IAAI,EAAE,CAAA;YACR,CAAC,EAAE,IAAI,CAAC,CAAA;QACV,CAAC;IACH,CAAC,CACF,CAAA;IAED,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,OAAO,GAAG,EAAE;QACV,IAAI,QAAQ,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QACD,QAAQ,GAAG,IAAI,CAAA;QACf,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,YAAY,CAAC,QAAQ,CAAC,CAAA;YACtB,QAAQ,GAAG,SAAS,CAAA;QACtB,CAAC;QACD,WAAW,EAAE,CAAA;IACf,CAAC,CAAA;AACH,CAAC"}

package/dist/esm/storage/parseStoredRecord.d.ts

@@ -0,0 +1,29 @@
+import type { StorageAdapter } from './types.js';
+/**
+ * Parse a persisted (browser-writable) JSON record and validate it against a
+ * caller-supplied shape guard. localStorage is user-writable, so a stored value
+ * may be truncated, hand-edited, or written by an older schema; `JSON.parse(...)
+ * as T` would type-check such a record yet carry missing/invalid fields that
+ * fail far from here.
+ *
+ * Returns the parsed value when `isValid` accepts it; returns `null` when the
+ * record is absent, unparseable, or fails validation (i.e. poisoned). A `null`
+ * result is the "malformed-or-absent" signal — callers decide whether that
+ * means "regenerate deliberately" or "surface an error", but they never get a
+ * structurally-invalid `T`.
+ *
+ * @param raw Stored string, or `null` when the key is absent.
+ * @param isValid Shape guard run against the parsed value.
+ */
+export declare function parseStoredRecord<T>(raw: string | null, isValid: (value: unknown) => value is T): T | null;
+/**
+ * Read and validate a persisted record in one step, evicting the key when the
+ * stored value is present but poisoned (unparseable or failing `isValid`) so a
+ * later read does not keep tripping over the same corrupt entry.
+ *
+ * Returns `null` for both the genuine-absence and the evicted-poison cases;
+ * callers that must distinguish them should compare against the pre-read
+ * presence of the key themselves.
+ */
+export declare function readValidatedRecord<T>(storage: StorageAdapter, key: string, isValid: (value: unknown) => value is T): Promise<T | null>;
+//# sourceMappingURL=parseStoredRecord.d.ts.map

package/dist/esm/storage/parseStoredRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseStoredRecord.d.ts","sourceRoot":"","sources":["../../../src/storage/parseStoredRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACtC,CAAC,GAAG,IAAI,CAWV;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACtC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAOnB"}

package/dist/esm/storage/parseStoredRecord.js

@@ -0,0 +1,47 @@
+/**
+ * Parse a persisted (browser-writable) JSON record and validate it against a
+ * caller-supplied shape guard. localStorage is user-writable, so a stored value
+ * may be truncated, hand-edited, or written by an older schema; `JSON.parse(...)
+ * as T` would type-check such a record yet carry missing/invalid fields that
+ * fail far from here.
+ *
+ * Returns the parsed value when `isValid` accepts it; returns `null` when the
+ * record is absent, unparseable, or fails validation (i.e. poisoned). A `null`
+ * result is the "malformed-or-absent" signal — callers decide whether that
+ * means "regenerate deliberately" or "surface an error", but they never get a
+ * structurally-invalid `T`.
+ *
+ * @param raw Stored string, or `null` when the key is absent.
+ * @param isValid Shape guard run against the parsed value.
+ */
+export function parseStoredRecord(raw, isValid) {
+    if (raw === null) {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    return isValid(parsed) ? parsed : null;
+}
+/**
+ * Read and validate a persisted record in one step, evicting the key when the
+ * stored value is present but poisoned (unparseable or failing `isValid`) so a
+ * later read does not keep tripping over the same corrupt entry.
+ *
+ * Returns `null` for both the genuine-absence and the evicted-poison cases;
+ * callers that must distinguish them should compare against the pre-read
+ * presence of the key themselves.
+ */
+export async function readValidatedRecord(storage, key, isValid) {
+    const raw = await storage.get(key);
+    const parsed = parseStoredRecord(raw, isValid);
+    if (parsed === null && raw !== null) {
+        await storage.remove(key);
+    }
+    return parsed;
+}
+//# sourceMappingURL=parseStoredRecord.js.map

package/dist/esm/storage/parseStoredRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseStoredRecord.js","sourceRoot":"","sources":["../../../src/storage/parseStoredRecord.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAkB,EAClB,OAAuC;IAEvC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAuB,EACvB,GAAW,EACX,OAAuC;IAEvC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAC9C,IAAI,MAAM,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/{types/agent → esm/storage}/storage.d.ts

@@ -1,12 +1,15 @@
 import type { StorageAdapter } from './types.js';
 /**
- * localStorage adapter for browser environments.
- * Agent keys are stored as JSON strings with the key pattern:
- * `lifi-perps-agent:{address}:{provider}`
+ * localStorage adapter for browser environments. Falls back to a no-op when
+ * `localStorage` is unavailable (e.g. SSR).
+ *
+ * @public
  */
 export declare const localStorageAdapter: StorageAdapter;
 /**
  * In-memory storage adapter for testing or server-side use.
+ *
+ * @public
  */
 export declare function createMemoryStorage(): StorageAdapter;
 //# sourceMappingURL=storage.d.ts.map

package/dist/esm/storage/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,cA0BjC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAkBpD"}

package/dist/esm/{agent → storage}/storage.js

@@ -1,7 +1,8 @@
 /**
- * localStorage adapter for browser environments.
- * Agent keys are stored as JSON strings with the key pattern:
- * `lifi-perps-agent:{address}:{provider}`
+ * localStorage adapter for browser environments. Falls back to a no-op when
+ * `localStorage` is unavailable (e.g. SSR).
+ *
+ * @public
  */
 export const localStorageAdapter = {
     get: (key) => {
@@ -9,7 +10,6 @@ export const localStorageAdapter = {
             return Promise.resolve(localStorage.getItem(key));
         }
         catch {
-            // localStorage not available (e.g., SSR)
             return Promise.resolve(null);
         }
     },
@@ -34,6 +34,8 @@ export const localStorageAdapter = {
 };
 /**
  * In-memory storage adapter for testing or server-side use.
+ *
+ * @public
  */
 export function createMemoryStorage() {
     const store = new Map();

package/dist/esm/storage/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,GAAG,EAAE,CAAC,GAAW,EAA0B,EAAE;QAC3C,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,GAAG,EAAE,CAAC,GAAW,EAAE,KAAa,EAAiB,EAAE;QACjD,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;IAED,MAAM,EAAE,CAAC,GAAW,EAAiB,EAAE;QACrC,IAAI,CAAC;YACH,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;CACF,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEvC,OAAO;QACL,GAAG,EAAE,CAAC,GAAW,EAA0B,EAAE;YAC3C,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAA;QAChD,CAAC;QAED,GAAG,EAAE,CAAC,GAAW,EAAE,KAAa,EAAiB,EAAE;YACjD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACrB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC;QAED,MAAM,EAAE,CAAC,GAAW,EAAiB,EAAE;YACrC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACjB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/esm/storage/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Storage adapter interface for persisting SDK session credentials (provider
+ * agent keypairs, API keys, read-only tokens). Implement this to use custom
+ * storage (e.g. encrypted storage, a database, async key-value stores).
+ */
+export interface StorageAdapter {
+    /** Get a value by key. */
+    get(key: string): Promise<string | null>;
+    /** Set a value by key. */
+    set(key: string, value: string): Promise<void>;
+    /** Remove a value by key. */
+    remove(key: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACxC,0BAA0B;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,6BAA6B;IAC7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC"}

package/dist/esm/{agent → storage}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/storage/types.ts"],"names":[],"mappings":""}

package/dist/esm/transport/fetchWithRetry.d.ts

@@ -0,0 +1,22 @@
+import type { ResolvedRetryPolicy } from './retryPolicy.js';
+/**
+ * Options for {@link fetchWithRetry}.
+ *
+ * @public
+ */
+export interface FetchWithRetryOptions {
+    policy: ResolvedRetryPolicy;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Wrap `fetch` with policy-driven retry. Honors `Retry-After` (when present
+ * and `respectRetryAfter` is true), otherwise falls back to exponential
+ * backoff with full jitter, capped by `maxDelayMs`. Network errors (thrown
+ * `fetch` rejections) are treated as `retry-network` — same retry budget as
+ * 5xx. An aborted signal short-circuits without further attempts.
+ *
+ * @public
+ */
+export declare function fetchWithRetry(input: RequestInfo | URL, init: RequestInit | undefined, options: FetchWithRetryOptions): Promise<Response>;
+//# sourceMappingURL=fetchWithRetry.d.ts.map

package/dist/esm/transport/fetchWithRetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWithRetry.d.ts","sourceRoot":"","sources":["../../../src/transport/fetchWithRetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAuB,MAAM,kBAAkB,CAAA;AAEhF;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,mBAAmB,CAAA;IAC3B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAyDnB"}