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

package/dist/types/types/provider.d.ts

@@ -0,0 +1,330 @@
+import type { AccountConfig, AccountConfigSetting, AccountResponse, AccountSummary, ActionStep, ActionType, ActivitiesResponse, ActivityType, FillsResponse, Market, Order, OrdersResponse, PerpsMarket, PerpsSigner, Position, PositionsResponse, ProviderAction, Quote, QuoteSide, SignedActionStep, SigningMethod, TradeType } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { PerpsBaseConfig, PerpsClientSigner, SDKRequestOptions } from './config.js';
+/**
+ * Low-level SDK client: resolved config, the optional end-user wallet, and the
+ * registered provider plugins. Returned by {@link createPerpsClient} and
+ * consumed by every service function.
+ *
+ * @public
+ */
+export interface PerpsSDKClient {
+    readonly config: PerpsBaseConfig;
+    /** The end-user's wallet — accepts any viem WalletClient (browser, private key, mnemonic). */
+    readonly userWallet?: PerpsClientSigner;
+    /** Registered providers, bound to this client, in construction order. */
+    readonly providers: PerpsProvider[];
+    /** Look up a registered bound {@link PerpsProvider} by its `type` key. */
+    getProvider(key: string): PerpsProvider | undefined;
+}
+/**
+ * Per-call context passed by `PerpsClient` to a provider's {@link
+ * PerpsProvider.signActions} method. Carries the end-user's wallet (when
+ * configured); providers that own a session credential (e.g. the Hyperliquid
+ * agent keypair, Lighter's API key) resolve it internally.
+ *
+ * @public
+ */
+export interface SignActionsContext {
+    userWallet?: PerpsClientSigner;
+    /**
+     * The signing batch's declared signers, from the action's `ProviderAction`
+     * descriptor. The plugin branches on this to pick WHO signs (e.g.
+     * Hyperliquid: `USER` → end-user wallet, `AGENT` → session keypair). Core
+     * forwards the descriptor's `signers` as data; it does not branch on them.
+     */
+    signers?: PerpsSigner[];
+}
+/**
+ * Signer-bearing wire fields a provider plugin contributes to an action's
+ * `createAction` / `executeAction` requests — resolved by the plugin because
+ * signer identity (WHO signs) is provider-owned. Returned by
+ * {@link PerpsProviderPlugin.resolveActionRequest}.
+ *
+ * @public
+ */
+export interface ActionSignerContribution {
+    /**
+     * The on-wire `signerAddress` for an action a provider signs on the user's
+     * behalf — the address of the provider-owned session keypair (Hyperliquid's
+     * approved agent wallet). Sent on both `createAction` (so the backend builds
+     * the right typed data) and `executeAction`. Omitted when the provider signs
+     * as the user or with a non-EVM session credential (Lighter's API key).
+     */
+    signerAddress?: Address;
+    /**
+     * Extra action params the plugin injects from its own signer state — e.g.
+     * Hyperliquid's `agentAddress` for `APPROVE_AGENT`. Merged over the caller's
+     * params.
+     */
+    params?: Record<string, unknown>;
+}
+/**
+ * Inputs for {@link PerpsProviderPlugin.estimateLiquidationPrice}:
+ * `leverage` is the user-selected leverage for the new position, `isLong`
+ * carries direction.
+ *
+ * @public
+ */
+export interface LiquidationEstimateParams {
+    entryPrice: number;
+    leverage: number;
+    isLong: boolean;
+}
+/**
+ * Read-side params for {@link PerpsProvider.getAccount}. The `provider`
+ * field is implicit in the provider instance and so is not duplicated here.
+ *
+ * @public
+ */
+export interface ProviderGetAccountParams {
+    address: Address;
+}
+/**
+ * Read params for {@link PerpsProvider.getPositions}.
+ *
+ * @public
+ */
+export interface ProviderGetPositionsParams {
+    address: Address;
+    /** Optional filter — opaque `Market.id` (not `displaySymbol`). */
+    marketId?: string;
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * Read params for {@link PerpsProvider.getOrders}.
+ *
+ * @public
+ */
+export interface ProviderGetOrdersParams {
+    address: Address;
+    /** Optional filter — opaque `Market.id` (not `displaySymbol`). */
+    marketId?: string;
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * Read params for {@link PerpsProvider.getOrder}.
+ *
+ * @public
+ */
+export interface ProviderGetOrderParams {
+    address: Address;
+    id: string;
+}
+/**
+ * Read params for {@link PerpsProvider.getFills}.
+ *
+ * @public
+ */
+export interface ProviderGetFillsParams {
+    address: Address;
+    limit?: number;
+    cursor?: string;
+    startTime?: number;
+    endTime?: number;
+}
+/**
+ * Read params for {@link PerpsProvider.getActivity}.
+ *
+ * @public
+ */
+export interface ProviderGetActivityParams {
+    address: Address;
+    limit?: number;
+    cursor?: string;
+    startTime?: number;
+    endTime?: number;
+    type?: ActivityType[];
+}
+/**
+ * Read params for {@link PerpsProviderPlugin.getQuote}. `provider` is implicit
+ * in the provider instance and so is not duplicated here.
+ *
+ * @public
+ */
+export interface ProviderGetQuoteParams {
+    /** Human `displaySymbol`, e.g. `"BTC"`. Resolved against the provider's own markets, scoped by `type`. */
+    symbol: string;
+    side: QuoteSide;
+    /** USD notional to fill. */
+    size: number;
+    type: TradeType;
+}
+/**
+ * Listener invoked with each freshly computed {@link Quote} on a streaming
+ * quote subscription.
+ *
+ * @public
+ */
+export type QuoteListener = (quote: Quote) => void;
+/**
+ * Unbound provider plugin passed to {@link createPerpsClient}, modelled on
+ * `@lifi/sdk`'s `SDKProvider`. Each provider is identified by `type` (the wire
+ * key — `'hyperliquid'`, `'lighter'`, …) and implements the read-side surface
+ * area for one DEX. Read methods are clientless — `(params, options?)`; the
+ * runtime context they need is injected once via {@link bind} when
+ * {@link createPerpsClient} calls {@link bindProvider}, and captured in the
+ * factory's closure.
+ *
+ * Concrete implementations live in dedicated packages
+ * (`@lifi/perps-sdk-provider-hyperliquid`, `@lifi/perps-sdk-provider-lighter`).
+ * Consumers register providers up-front:
+ *
+ * ```ts
+ * const client = createPerpsClient({
+ *   integrator: 'my-app',
+ *   apiKey: 'key',
+ *   providers: [hyperliquidProvider(), lighterProvider()],
+ * })
+ * const account = await client.getProvider('hyperliquid')!.getAccount({ address })
+ * ```
+ *
+ * Write-side actions (`createAction`, `executeAction`) remain on the core
+ * client because they go through the LI.FI backend's generic action
+ * pipeline — they are not per-provider plugin surface.
+ *
+ * @public
+ */
+export interface PerpsProviderPlugin {
+    /**
+     * Provider key, matching `Provider.key` from the backend's
+     * `/providers` response (e.g. `'hyperliquid'`, `'lighter'`). Used to
+     * look the provider up via {@link PerpsSDKClient.getProvider}.
+     */
+    readonly type: string;
+    /**
+     * Inject the runtime {@link PerpsSDKClient} into the plugin once, during
+     * {@link createPerpsClient}. The plugin captures it (config, fetch, retry,
+     * provider registry) in its factory closure so the clientless read methods
+     * can resolve their runtime deps at call time. Called exactly once per
+     * registered plugin by {@link bindProvider}.
+     */
+    bind(client: PerpsSDKClient): void;
+    getAccount(params: ProviderGetAccountParams, options?: SDKRequestOptions): Promise<AccountResponse>;
+    getPositions(params: ProviderGetPositionsParams, options?: SDKRequestOptions): Promise<PositionsResponse>;
+    getOrders(params: ProviderGetOrdersParams, options?: SDKRequestOptions): Promise<OrdersResponse>;
+    getOrder(params: ProviderGetOrderParams, options?: SDKRequestOptions): Promise<Order>;
+    getFills(params: ProviderGetFillsParams, options?: SDKRequestOptions): Promise<FillsResponse>;
+    getActivity(params: ProviderGetActivityParams, options?: SDKRequestOptions): Promise<ActivitiesResponse>;
+    /**
+     * Produce a one-shot fill {@link Quote} for `params.symbol` at `params.size`
+     * USD notional on this venue. The provider resolves the symbol against its
+     * own markets (matching `baseAsset.displaySymbol`, scoped by `params.type`),
+     * walks its orderbook for the VWAP fill, and applies its public base fee
+     * tier. Throws when no market matches the symbol+type.
+     */
+    getQuote(params: ProviderGetQuoteParams, options?: SDKRequestOptions): Promise<Quote>;
+    /**
+     * Roll an already-fetched {@link AccountResponse} (plus its positions) up
+     * into an {@link AccountSummary}. Owned by the provider because the
+     * gross/free meaning of collateral and the margin handling are
+     * venue-specific: Hyperliquid branches on its abstraction mode (in
+     * `disabled`/`dexAbstraction` the venue equity is already free margin; in
+     * `unifiedAccount`/`portfolioMargin` spot holds the whole account), whereas
+     * Lighter has a single flat collateral model. Pure — does no I/O.
+     */
+    getAccountSummary(account: AccountResponse, positions: Position[]): AccountSummary;
+    /**
+     * Format an order price onto the venue's tick grid for `market`. This is
+     * the canonical, provider-correct formatting surface — venue tick rules
+     * differ per provider, so provider-agnostic consumers must route every
+     * order price through the market's own provider instead of applying one
+     * venue's rules to another's markets. Pure — does no I/O.
+     *
+     * @returns The price as a wire-ready decimal string, trailing zeros
+     *   stripped.
+     * @throws {PerpsError} `ValidationError` when `market` lacks the tick
+     *   metadata the venue's rules need (e.g. `Market.priceDecimals` absent).
+     */
+    formatOrderPrice(market: Market, price: number): string;
+    /**
+     * Format an order size onto the venue's lot grid for `market`. Truncates
+     * (never rounds up) so the formatted size cannot exceed the user's intended
+     * size or available balance. Pure — does no I/O.
+     *
+     * @param size - Size in base-asset units as a non-negative magnitude.
+     * @returns The size as a wire-ready decimal string, trailing zeros
+     *   stripped.
+     */
+    formatOrderSize(market: Market, size: number): string;
+    /**
+     * Estimate the liquidation price of a new isolated position on `market`
+     * using the venue's margin model. A preview helper — for existing
+     * positions, prefer `Position.liquidationPrice` from the venue. Pure —
+     * does no I/O.
+     *
+     * @returns The estimated liquidation price, or `undefined` when the venue's
+     *   model cannot be evaluated client-side (degenerate inputs, or `market`
+     *   lacks the margin metadata the model needs).
+     */
+    estimateLiquidationPrice(market: PerpsMarket, params: LiquidationEstimateParams): number | undefined;
+    /**
+     * Project a typed {@link AccountConfig} against the provider's `setup`
+     * + `options` descriptors into `AccountConfigSetting[]`. Used by
+     * `PerpsClient.getAccount` to attach a `settings` array to the response —
+     * one entry per descriptor, in `setup`-then-`options` order.
+     *
+     * Implementations receive the union-typed `AccountConfig` and narrow on
+     * `config.provider` themselves; the dispatcher in `PerpsClient` does not
+     * narrow before calling.
+     */
+    projectConfig(config: AccountConfig, setup: ProviderAction[], options: ProviderAction[]): AccountConfigSetting[];
+    /**
+     * Per-setup-action params the SDK should inject into `createAction` calls
+     * when staging the provider setup. Used for plugin-side state the backend
+     * needs to make a correct idempotency decision (e.g. Lighter's known local
+     * API public key). Returns an empty object when the plugin has no params
+     * to contribute for the action. Optional — providers without local state
+     * can omit it entirely.
+     */
+    resolveSetupParams?(action: ActionType, address: Address): Promise<Record<string, unknown>>;
+    /**
+     * Contribute the signer-bearing wire fields for an action — the plugin owns
+     * signer identity (WHO signs), so core asks the plugin rather than resolving
+     * a `signerAddress` itself. The descriptor's `signers` are forwarded so the
+     * plugin can branch on signer role: a provider that signs on the user's
+     * behalf with a session keypair (Hyperliquid's agent) resolves — provisioning
+     * one if needed — and returns the agent address as `signerAddress`; for
+     * `APPROVE_AGENT` (user-signed) it returns the agent address only as the
+     * `agentAddress` param. The agent address must be known pre-build so the
+     * backend builds the right typed data, so core calls this before
+     * `createAction` and threads the same result into `executeAction`.
+     *
+     * Optional: providers that sign as the user or with a non-EVM session
+     * credential (Lighter's API key) omit it — core then sends no `signerAddress`
+     * and no injected params.
+     */
+    resolveActionRequest?(action: ActionType, address: Address, signers: PerpsSigner[]): Promise<ActionSignerContribution>;
+    /**
+     * Sign a batch of unsigned {@link ActionStep}s belonging to one
+     * `SigningMethod` arm. Returns the matching {@link SignedActionStep}s in
+     * the same order — the core `PerpsClient.execute` then forwards them to
+     * `/executeAction`.
+     *
+     * Optional: providers that do not implement write actions (read-only
+     * plugins) may omit it. `PerpsClient.execute` throws `PerpsErrorCode.SDKError`
+     * when an action requires a delegated signing method but the resolved
+     * provider has no `signActions`.
+     *
+     * `method` mirrors the descriptor's `signingMethod`. The plugin owns every
+     * arm, branching on the descriptor's `signers` internally: the EIP712 arm
+     * signs with the user's wallet (read from `ctx.userWallet`) or the provider's
+     * session keypair (Hyperliquid's agent), and `WASM_BLOB` / `EVM_TX` sign with
+     * the provider's local credential (Lighter).
+     */
+    signActions?(method: SigningMethod, steps: ActionStep[], address: Address, ctx?: SignActionsContext): Promise<SignedActionStep[]>;
+}
+/**
+ * Runtime provider returned by {@link PerpsSDKClient.getProvider} and
+ * {@link requireProvider}: a {@link PerpsProviderPlugin} that has been bound to
+ * its client via {@link bindProvider}. The read methods are already clientless
+ * on the plugin (`getX(params, options?)`); binding only drops the one-shot
+ * {@link PerpsProviderPlugin.bind} hook so consumers cannot re-bind a live
+ * provider.
+ *
+ * @public
+ */
+export type PerpsProvider = Omit<PerpsProviderPlugin, 'bind'>;
+//# sourceMappingURL=provider.d.ts.map

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

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

package/dist/types/utils/accountSummary.d.ts

@@ -1,13 +1,13 @@
-import type { AccountResponse, Asset, Position } from '@lifi/perps-types';
-export interface AccountSummary {
-    /** Total portfolio value in USD */
-    portfolioValue: number;
-    /** Collateral available for new positions */
-    availableMargin: number;
-    /** Margin locked in open positions */
-    marginUsed: number;
-    /** Unrealized PnL across all positions */
-    unrealizedPnl: number;
-}
-export declare function calculateAccountSummary(account: AccountResponse, positions: Position[], prices: Record<string, string>, assets?: Asset[], collateralCurrencies?: ReadonlySet<string>): AccountSummary;
+import type { AccountResponse, AccountSummary, Position } from '@lifi/perps-types';
+/**
+ * Roll an {@link AccountResponse} and its open positions up into an
+ * {@link AccountSummary}.
+ *
+ * @param collateralIsGross - `true` when the collateral rows already include
+ * margin locked in positions, so free margin is collateral minus
+ * `marginUsed`. `false` when the collateral rows hold free margin only and
+ * the locked portion is carried by the positions' `marginUsed`.
+ * @public
+ */
+export declare function summarizeAccount(account: AccountResponse, positions: Position[], collateralIsGross: boolean): AccountSummary;
 //# sourceMappingURL=accountSummary.d.ts.map

package/dist/types/utils/accountSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accountSummary.d.ts","sourceRoot":"","sources":["../../../src/utils/accountSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAIzE,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAA;IACvB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAA;CACtB;AAwDD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,CAAC,EAAE,KAAK,EAAE,EAChB,oBAAoB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACzC,cAAc,CAsDhB"}
+{"version":3,"file":"accountSummary.d.ts","sourceRoot":"","sources":["../../../src/utils/accountSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,QAAQ,EACT,MAAM,mBAAmB,CAAA;AAM1B;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,QAAQ,EAAE,EACrB,iBAAiB,EAAE,OAAO,GACzB,cAAc,CAqBhB"}

package/dist/types/utils/assertNever.d.ts

@@ -14,6 +14,7 @@
  *     case 'lighter': return projectLighter(config)
  *     default: return assertNever(config)
  *   }
+ * @internal
  */
 export declare function assertNever(value: never): never;
 //# sourceMappingURL=assertNever.d.ts.map

package/dist/types/utils/assertNever.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assertNever.d.ts","sourceRoot":"","sources":["../../../src/utils/assertNever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAI/C"}
+{"version":3,"file":"assertNever.d.ts","sourceRoot":"","sources":["../../../src/utils/assertNever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAI/C"}

package/dist/types/utils/calculations.d.ts

@@ -5,6 +5,7 @@
  * of the perps SDK would need. All parameters are required — no default
  * values for critical financial parameters.
  */
+import type { FeeTier, Market, MarketPrice, OrderbookLevel, Quote, QuoteSide, TradeType } from '@lifi/perps-types';
 /**
  * Calculate position size in asset units from margin.
  *
@@ -12,6 +13,11 @@
  * @param leverage - Position leverage
  * @param price - Current asset price
  * @returns Position size in asset units
+ * @example
+ * ```ts
+ * calculatePositionSize(100, 10, 2000) // 0.5 (ETH at $2000)
+ * ```
+ * @public
  */
 export declare function calculatePositionSize(marginUsd: number, leverage: number, price: number): number;
 /**
@@ -20,6 +26,7 @@ export declare function calculatePositionSize(marginUsd: number, leverage: numbe
  * @param size - Position size in asset units
  * @param price - Current asset price
  * @returns Notional value in USD
+ * @public
  */
 export declare function calculateNotionalValue(size: number, price: number): number;
 /**
@@ -29,6 +36,7 @@ export declare function calculateNotionalValue(size: number, price: number): num
  * @param currentPrice - Current market price
  * @param size - Position size (positive for long, negative for short)
  * @returns Unrealized PnL in USD
+ * @public
  */
 export declare function calculateUnrealizedPnl(entryPrice: number, currentPrice: number, size: number): number;
 /**
@@ -37,6 +45,7 @@ export declare function calculateUnrealizedPnl(entryPrice: number, currentPrice:
  * @param pnl - Profit/loss in USD
  * @param margin - Initial margin in USD
  * @returns ROE as percentage (e.g., 10 for 10%)
+ * @public
  */
 export declare function calculateRoe(pnl: number, margin: number): number;
 /**
@@ -45,6 +54,7 @@ export declare function calculateRoe(pnl: number, margin: number): number;
  * @param notionalValue - Position notional value in USD
  * @param leverage - Position leverage
  * @returns Required margin in USD
+ * @public
  */
 export declare function calculateRequiredMargin(notionalValue: number, leverage: number): number;
 /**
@@ -53,6 +63,7 @@ export declare function calculateRequiredMargin(notionalValue: number, leverage:
  * @param sizeUsd - Position size in USD (notional value)
  * @param feeRate - Fee rate as decimal (e.g., 0.00035 for 0.035%)
  * @returns Estimated fee in USD
+ * @public
  */
 export declare function estimateFees(sizeUsd: number, feeRate: number): number;
 /**
@@ -62,8 +73,61 @@ export declare function estimateFees(sizeUsd: number, feeRate: number): number;
  * @param slippagePercent - Slippage tolerance as percentage (e.g., 0.5 for 0.5%)
  * @param isBuy - True if buying (price goes up), false if selling (price goes down)
  * @returns Price adjusted for slippage
+ * @public
  */
 export declare function applySlippage(price: number, slippagePercent: number, isBuy: boolean): number;
+/**
+ * Distance from the current price to the liquidation price, as a percentage of
+ * the current price.
+ *
+ * @param liquidationPrice - The position's liquidation price
+ * @param currentPrice - Current market price
+ * @returns Absolute distance as a percentage, or 0 when current price is zero
+ * @public
+ */
+export declare function liquidationDistancePercent(params: {
+    liquidationPrice: number;
+    currentPrice: number;
+}): number;
+/**
+ * Effective leverage of an open position.
+ *
+ * leverage = positionValueUsd / marginUsd
+ *
+ * @param positionValueUsd - Position notional value in USD
+ * @param marginUsd - Margin backing the position in USD
+ * @returns Effective leverage, or 0 when margin is zero
+ * @public
+ */
+export declare function effectiveLeverage(params: {
+    positionValueUsd: number;
+    marginUsd: number;
+}): number;
+/**
+ * Margin that can be removed from a position while keeping its leverage at or
+ * below the asset's maximum.
+ *
+ * The minimum margin to stay within `maxLeverage` is the required margin for
+ * the position's notional (see {@link calculateRequiredMargin}); anything above
+ * that is removable.
+ *
+ * @param marginUsed - Margin currently backing the position in USD
+ * @param positionValueUsd - Position notional value in USD
+ * @param maxLeverage - Maximum leverage allowed for the asset
+ * @returns Removable margin in USD (never negative); falls back to the full
+ *   `marginUsed` when `maxLeverage` is zero (no constraint available)
+ * @public
+ */
+export declare function removableMargin(params: {
+    marginUsed: number;
+    positionValueUsd: number;
+    maxLeverage: number;
+}): number;
+/**
+ * Signed expected PnL for a trigger price — see {@link calculateExpectedPnl}.
+ *
+ * @public
+ */
 export interface ExpectedPnl {
     amount: number;
     percent: number;
@@ -77,6 +141,7 @@ export interface ExpectedPnl {
  * @param leverage - Position leverage multiplier
  * @param isLong - True for long positions, false for short
  * @param margin - Margin amount in USD
+ * @public
  */
 export declare function calculateExpectedPnl(triggerPrice: number, entryPrice: number, leverage: number, isLong: boolean, margin: number): ExpectedPnl | null;
 /**
@@ -86,6 +151,7 @@ export declare function calculateExpectedPnl(triggerPrice: number, entryPrice: n
  * @param entryPrice - Position entry price
  * @param leverage - Position leverage multiplier
  * @param isLong - True for long positions, false for short
+ * @public
  */
 export declare function priceFromPercent(percent: number, entryPrice: number, leverage: number, isLong: boolean): number;
 /**
@@ -95,6 +161,7 @@ export declare function priceFromPercent(percent: number, entryPrice: number, le
  * @param entryPrice - Position entry price
  * @param leverage - Position leverage multiplier
  * @param isLong - True for long positions, false for short
+ * @public
  */
 export declare function percentFromPrice(price: number, entryPrice: number, leverage: number, isLong: boolean): number;
 /**
@@ -104,6 +171,55 @@ export declare function percentFromPrice(price: number, entryPrice: number, leve
  * @param size - Position size in asset units at close
  * @param price - Price at close
  * @returns PnL as a percentage of position value
+ * @public
  */
 export declare function calculateRealizedPnlPercent(realizedPnl: number, size: number, price: number): number;
+/** Result of {@link walkOrderbook} — the fill obtained for a USD-notional walk. */
+interface BookWalk {
+    /** Base amount filled. */
+    baseSize: number;
+    /** Notional actually filled in USD (equals the requested size unless the book ran dry). */
+    filledNotional: number;
+    /** Volume-weighted average fill price, or 0 when the book is empty. */
+    vwap: number;
+    /** True when the levels could not absorb the requested notional. */
+    insufficientLiquidity: boolean;
+}
+/**
+ * Walk one side of an orderbook to fill `sizeUsd` notional, accumulating base
+ * size and notional level-by-level to derive the VWAP fill. Levels are consumed
+ * in array order — the caller passes asks for a buy and bids for a sell, each
+ * already ordered best-price-first. When the book cannot absorb the full
+ * notional, the walk stops at the last level and flags `insufficientLiquidity`,
+ * returning the best obtainable fill.
+ *
+ * @public
+ */
+export declare function walkOrderbook(levels: OrderbookLevel[], sizeUsd: number): BookWalk;
+/** Inputs to {@link buildQuote} — the resolved market, its live price, its book, and the trade ask. */
+interface BuildQuoteInput {
+    provider: string;
+    symbol: string;
+    type: TradeType;
+    side: QuoteSide;
+    sizeUsd: number;
+    market: Market;
+    price: MarketPrice;
+    bids: OrderbookLevel[];
+    asks: OrderbookLevel[];
+    /** Public base-tier fees for the venue; `isDefaultFeeTier` is always set true. */
+    feeTier: FeeTier;
+    timestamp: number;
+}
+/**
+ * Build a {@link Quote} from a resolved market, its live {@link MarketPrice},
+ * and its orderbook snapshot. Pure: walks the relevant side (buy → asks,
+ * sell → bids) for the VWAP fill, derives the price impact in basis points
+ * versus mark, applies the base taker fee on the filled notional, and carries
+ * the market's `funding` (`null` for spot, which has none).
+ *
+ * @public
+ */
+export declare function buildQuote(input: BuildQuoteInput): Quote;
+export {};
 //# sourceMappingURL=calculations.d.ts.map

package/dist/types/utils/calculations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculations.d.ts","sourceRoot":"","sources":["../../../src/utils/calculations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,OAAO,GACb,MAAM,CAGR;AAMD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb,WAAW,GAAG,IAAI,CAUpB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,MAAM,CAMR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,MAAM,CAMR;AAMD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR"}
+{"version":3,"file":"calculations.d.ts","sourceRoot":"","sources":["../../../src/utils/calculations.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/depositChain.d.ts

@@ -0,0 +1,25 @@
+import type { AccountConfig } from '@lifi/perps-types';
+import { ChainId } from '@lifi/types';
+/**
+ * Perps provider keys that have a declared LI.FI deposit-target chain.
+ *
+ * @public
+ */
+export type DepositProviderKey = AccountConfig['provider'];
+/**
+ * Declared single source of truth: perps provider key → the LI.FI chain a
+ * client opens the swap widget against to fund that provider. Values come from
+ * the `@lifi/types` `ChainId` enum; never hardcode the numeric ids.
+ *
+ * @public
+ */
+export declare const LIFI_DEPOSIT_CHAIN_BY_PROVIDER: Record<DepositProviderKey, ChainId>;
+/**
+ * Resolve the LI.FI deposit-target chain for a perps provider key.
+ *
+ * @returns The `@lifi/types` `ChainId`, or `undefined` for a provider key with
+ *   no declared deposit chain (the `/providers` wire key is an open `string`).
+ * @public
+ */
+export declare function lifiDepositChainForProvider(providerKey: string): ChainId | undefined;
+//# sourceMappingURL=depositChain.d.ts.map

package/dist/types/utils/depositChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depositChain.d.ts","sourceRoot":"","sources":["../../../src/utils/depositChain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CACjD,kBAAkB,EAClB,OAAO,CAIR,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,GAAG,SAAS,CAErB"}

package/dist/types/utils/explorer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Block-explorer URL resolution.
+ *
+ * Provider plugins resolve a tx hash to a fully-qualified explorer URL during
+ * wire→domain mapping. The explorer target is a function of the settling chain,
+ * so the map is keyed by chain id rather than by provider.
+ */
+/**
+ * Settling chains a perps tx can be observed on.
+ *
+ * @public
+ */
+export declare const ExplorerChainId: {
+    readonly ETHEREUM: 1;
+    readonly ARBITRUM_ONE: 42161;
+    readonly LIGHTER: 304;
+    readonly HYPERLIQUID: 999;
+};
+/**
+ * Union of {@link ExplorerChainId} values.
+ *
+ * @public
+ */
+export type ExplorerChainId = (typeof ExplorerChainId)[keyof typeof ExplorerChainId];
+/**
+ * Build a fully-resolved block-explorer URL for a tx on a known chain.
+ *
+ * @returns The explorer URL, or `undefined` when the hash is empty (no on-chain
+ *   tx to link).
+ * @public
+ */
+export declare function explorerTxUrl(chainId: ExplorerChainId, txHash: string | undefined): string | undefined;
+//# sourceMappingURL=explorer.d.ts.map

package/dist/types/utils/explorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.d.ts","sourceRoot":"","sources":["../../../src/utils/explorer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA;AAEV;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AASxD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAKpB"}