@lifi/perps-sdk-provider-lighter 0.2.0-alpha.0

package/dist/types/types/submit.d.ts

@@ -0,0 +1,76 @@
+/** @public */
+export interface LtSendTxRequest {
+    tx_type: number;
+    tx_info: string;
+    price_protection?: boolean;
+}
+/** @public */
+export interface LtSendTxResponse {
+    code: number;
+    message: string;
+    tx_hash: string;
+    predicted_execution_time_ms?: number;
+    volume_quota_remaining?: number;
+}
+/** @public */
+export interface LtSendTxBatchRequest {
+    tx_types: string;
+    tx_infos: string;
+}
+/** @public */
+export interface LtSendTxBatchResponse {
+    code: number;
+    message: string;
+    tx_hash: string[];
+    predicted_execution_time_ms?: number;
+    volume_quota_remaining?: number;
+}
+/**
+ * `GET /api/v1/fastwithdraw/info` (Lighter `RespGetFastwithdrawalInfo`).
+ *
+ * Probe response that tells the caller whether the fast-withdraw operator is
+ * accepting transfers from `account_index` and, if so, which operator account
+ * to send the signed L2 transfer to. `withdraw_limit` and
+ * `max_withdrawal_amount` are USDC strings in **L2 6-decimal scale**, matching
+ * the `usdc_amount` units the WASM `SignTransfer` consumes. Lighter signals
+ * "fast path is not available right now" with a non-success `code` AND/OR a
+ * missing `to_account_index` (a `0` is also treated as missing because account
+ * index 0 is reserved by the protocol and never an operator).
+ *
+ * @public
+ */
+export interface LtFastwithdrawInfoResponse {
+    code: number;
+    message?: string;
+    to_account_index: number;
+    withdraw_limit: string;
+    max_withdrawal_amount: string;
+}
+/**
+ * `POST /api/v1/fastwithdraw` (Lighter `ResultCode`).
+ *
+ * Returns only `{code, message}` — no `tx_hash`, unlike `/sendTx`. The Lighter
+ * relayer drains the operator account back to the user's L1 address
+ * out-of-band; success here means the signed L2 transfer was accepted, not
+ * that L1 settlement is complete.
+ *
+ * @public
+ */
+export interface LtFastwithdrawResponse {
+    code: number;
+    message?: string;
+}
+/**
+ * `POST /api/v1/changeAccountTier` (Lighter `RespChangeAccountTier`).
+ *
+ * Code 0 means Lighter accepted the tier change; any other code carries a
+ * Lighter-defined business-rule rejection (open positions, pending orders, 24h
+ * cooldown, etc.) and `message` is the operator-readable reason.
+ *
+ * @public
+ */
+export interface LtChangeAccountTierResponse {
+    code: number;
+    message?: string;
+}
+//# sourceMappingURL=submit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../../src/types/submit.ts"],"names":[],"mappings":"AAEA,cAAc;AACd,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,cAAc;AACd,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B,CAAC,EAAE,MAAM,CAAA;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,cAAc;AACd,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,cAAc;AACd,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,2BAA2B,CAAC,EAAE,MAAM,CAAA;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/dist/types/types/ws.d.ts

@@ -0,0 +1,124 @@
+/** @public */
+export type LtWsMessage = {
+    channel?: string;
+    type: string;
+};
+/** @public */
+export type LtWsPingMessage = LtWsMessage & {
+    type: 'ping';
+};
+/** @public */
+export type LtWsMarketStats = {
+    market_id: number;
+    index_price: string;
+    mark_price: string;
+    open_interest: string;
+    last_trade_price: string;
+    current_funding_rate: string;
+    funding_rate: string;
+    funding_timestamp: number;
+    daily_base_token_volume: string;
+    daily_quote_token_volume: string;
+    daily_price_change: string;
+};
+/**
+ * `market_stats/all` pushes one record per known market each tick. We
+ * aggregate them into a Record<assetId, price> before emitting `prices`.
+ * @public
+ */
+export type LtWsMarketStatsAllMessage = LtWsMessage & {
+    type: 'subscribed/market_stats' | 'update/market_stats';
+    market_stats?: Record<string, LtWsMarketStats>;
+};
+/**
+ * Spot market stats carry no funding/open-interest fields and address
+ * markets by their spot `market_id` (2048+).
+ * @public
+ */
+export type LtWsSpotMarketStats = {
+    market_id: number;
+    symbol: string;
+    index_price: string;
+    mid_price: string;
+    best_ask_price: string;
+    best_bid_price: string;
+    last_trade_price: string;
+    daily_base_token_volume: number;
+    daily_quote_token_volume: number;
+    daily_price_low: number;
+    daily_price_high: number;
+    daily_price_change: number;
+};
+/**
+ * `spot_market_stats/all` is the spot-market counterpart to
+ * `market_stats/all`; both feed the same aggregated `prices` emit.
+ * @public
+ */
+export type LtWsSpotMarketStatsAllMessage = LtWsMessage & {
+    type: 'subscribed/spot_market_stats' | 'update/spot_market_stats';
+    spot_market_stats?: Record<string, LtWsSpotMarketStats>;
+};
+/** @public */
+export type LtWsOrderBookLevel = {
+    price: string;
+    size: string;
+};
+/** @public */
+export type LtWsOrderBook = {
+    asks: LtWsOrderBookLevel[];
+    bids: LtWsOrderBookLevel[];
+    offset?: number;
+};
+/** @public */
+export type LtWsOrderBookMessage = LtWsMessage & {
+    type: 'subscribed/order_book' | 'update/order_book';
+    order_book: LtWsOrderBook;
+};
+/**
+ * Auth-channel payloads.
+ *
+ * The response `channel` field uses `:` as separator (e.g.
+ * `account_all_orders:42`) while the subscribe payload uses `/`.
+ *
+ * Per the Lighter WS spec:
+ *   - orders/trades: object indexed by market index, each value an array
+ *     (`{ "0": [Order], "1": [Order] }`)
+ *   - positions: object indexed by market index, each value a single object
+ *     (`{ "0": Position }`)
+ *   - initial `account_all_trades` snapshot may send an empty flat array
+ *
+ * The provider uses `collectAuthChannelItems` to normalise all three shapes
+ * into a flat T[].
+ * @public
+ */
+export type LtWsAccountAllOrdersMessage = LtWsMessage & {
+    type: 'subscribed/account_all_orders' | 'update/account_all_orders';
+    orders?: Record<string, unknown[]> | unknown[];
+    data?: {
+        orders?: Record<string, unknown[]> | unknown[];
+    };
+};
+/** @public */
+export type LtWsAccountAllTradesMessage = LtWsMessage & {
+    type: 'subscribed/account_all_trades' | 'update/account_all_trades';
+    trades?: Record<string, unknown[]> | unknown[];
+    total_volume?: number;
+    monthly_volume?: number;
+    weekly_volume?: number;
+    daily_volume?: number;
+    data?: {
+        trades?: Record<string, unknown[]> | unknown[];
+    };
+};
+/** @public */
+export type LtWsAccountAllPositionsMessage = LtWsMessage & {
+    type: 'subscribed/account_all_positions' | 'update/account_all_positions';
+    positions?: Record<string, unknown>;
+    shares?: unknown[];
+    last_funding_round?: Record<string, string>;
+    last_funding_discount?: Record<string, string>;
+    data?: {
+        positions?: Record<string, unknown>;
+    };
+};
+//# sourceMappingURL=ws.d.ts.map

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

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

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

@@ -0,0 +1,51 @@
+import { type ActivityItem } from '@lifi/perps-types';
+/**
+ * Per-endpoint cursor envelope for Lighter activity pagination.
+ *
+ * Each key holds the upstream `cursor` / `next_cursor` returned by that
+ * endpoint on the previous call. When a key is **present** with a non-empty
+ * string the corresponding endpoint will be re-fetched at that cursor on the
+ * next call; when a key is **absent** the endpoint is treated as exhausted
+ * (or never paged because the type filter excluded it) and skipped.
+ *
+ * The envelope is round-tripped through `cursor` as base64url JSON so callers
+ * don't need to know the per-endpoint shape. The encoding mirrors the LI.FI
+ * backend's wire format so cursors created by the backend remain usable.
+ * @public
+ */
+export interface LighterActivityCursor {
+    deposits?: string;
+    withdraws?: string;
+    fundings?: string;
+    liquidations?: string;
+    transfers?: string;
+    /**
+     * Already-fetched, merged-and-sorted rows that did not fit under the page
+     * `limit`. The upstream cursors above have advanced past these rows, so they
+     * are replayed (prepended) on the next page before any fresh fetch — without
+     * them the tail would be lost forever.
+     */
+    overflow?: ActivityItem[];
+}
+/**
+ * Encode a `LighterActivityCursor` as the base64url-of-JSON cursor string
+ * Lighter widgets persist between activity pages. Returns `undefined` when
+ * every per-endpoint key is empty and no `overflow` rows remain — the caller
+ * should report `hasMore: false` and omit `cursor` from `Pagination` then.
+ *
+ * Browser-direct: `Buffer` is Node-only. We use `btoa` over a Latin-1
+ * encoding of the UTF-8 bytes and then rewrite `+/=` to base64url. This is
+ * the same byte sequence Node's `Buffer.from(json, 'utf8').toString('base64url')`
+ * produces, so cursors round-trip across environments.
+ * @public
+ */
+export declare const encodeActivityCursor: (env: LighterActivityCursor) => string | undefined;
+/**
+ * Decode a previously-encoded activity cursor. Returns `undefined` for an
+ * absent cursor (first page) and throws {@link PerpsError} with
+ * `ValidationError` if the string is malformed — we'd rather fail loudly than
+ * silently re-page from page 1 and re-deliver already-paginated rows.
+ * @public
+ */
+export declare const decodeActivityCursor: (cursor: string | undefined) => LighterActivityCursor | undefined;
+//# sourceMappingURL=activityCursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activityCursor.d.ts","sourceRoot":"","sources":["../../../src/utils/activityCursor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,mBAAmB,CAAA;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;CAC1B;AAaD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAC/B,KAAK,qBAAqB,KACzB,MAAM,GAAG,SAcX,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,GAAG,SAAS,KACzB,qBAAqB,GAAG,SA6C1B,CAAA"}

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

@@ -0,0 +1,65 @@
+import { PerpsError, type ResolvedRetryPolicy } from '@lifi/perps-sdk';
+/** @internal */
+export type ApiParams = Record<string, string | number | boolean>;
+/**
+ * Auth-gated read whose token Lighter rejected. Distinct from a generic
+ * {@link PerpsError} so callers can evict the stored read-only token and retry
+ * with a freshly-created one. Lighter signals this on either channel: an HTTP
+ * 401/403, or an HTTP 200 carrying an error `code` in the body.
+ * @internal
+ */
+export declare class LighterAuthRejectedError extends PerpsError {
+}
+/** @internal */
+export declare const LIGHTER_RETRY_DEFAULTS: ResolvedRetryPolicy;
+/** @internal */
+export interface LighterApiClientOptions {
+    signal?: AbortSignal;
+    policy?: ResolvedRetryPolicy;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * HTTP boundary against Lighter's REST API.
+ *
+ * Browser-direct by design: no LI.FI backend hop, no caching shim — caller
+ * supplies the REST base URL, the path, and any query params, and we return
+ * the parsed JSON body. Lighter advertises CORS headers on every public
+ * endpoint so a vanilla `fetch` from the widget works.
+ *
+ * Auth-gated endpoints (accountLimits, accountActiveOrders, deposit/history,
+ * withdraw/history, positionFunding, liquidations, transfer/history) take the
+ * Lighter read-only token as the `auth` query parameter — NOT as an
+ * `Authorization` header. This matches Lighter's OpenAPI spec and lets the
+ * same call work browser-direct and from server-side proxies.
+ *
+ * Lighter signals rate limiting via 429 OR 405 (documented behaviour) with a
+ * documented 60s firewall cooldown. The default {@link ResolvedRetryPolicy}
+ * waits long enough to avoid hammering through the cooldown.
+ * @public
+ */
+export declare class LighterApiClient {
+    private readonly baseUrl;
+    private readonly signal;
+    private readonly policy;
+    private readonly fetchImpl;
+    constructor(baseUrl: string, options?: LighterApiClientOptions);
+    private buildUrl;
+    get<T>(path: string, params?: ApiParams): Promise<T>;
+    /**
+     * Auth-gated GET. The token is appended as the `auth` query parameter (per
+     * Lighter's OpenAPI spec); the `Authorization` header is intentionally NOT
+     * used — Lighter rejects it.
+     */
+    getAuthed<T>(path: string, authToken: string, params?: ApiParams): Promise<T>;
+    /**
+     * GET that surfaces the raw `{status, body}` pair without throwing on
+     * non-2xx — used for endpoints (account lookup by L1 address) where the
+     * caller distinguishes specific Lighter error codes from generic failures.
+     */
+    getWithStatus<T>(path: string, params?: ApiParams): Promise<{
+        status: number;
+        data: T;
+    }>;
+    private getChecked;
+}
+//# sourceMappingURL=apiClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../../src/utils/apiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAA;AAOxB,gBAAgB;AAChB,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAejE;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;CAAG;AAO3D,gBAAgB;AAChB,eAAO,MAAM,sBAAsB,EAAE,mBAmBpC,CAAA;AAED,gBAAgB;AAChB,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAO9D,OAAO,CAAC,QAAQ;IAaV,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D;;;;OAIG;IACG,SAAS,CAAC,CAAC,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,SAAc,GACrB,OAAO,CAAC,CAAC,CAAC;IAoBb;;;;OAIG;IACG,aAAa,CAAC,CAAC,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;YAWzB,UAAU;CAiBzB"}

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

@@ -0,0 +1,11 @@
+import type { Address } from 'viem';
+import type { LtDetailedAccount } from '../types/index.js';
+import type { LighterApiClient } from './apiClient.js';
+/**
+ * Look up the Lighter account for an L1 address via `/api/v1/account`,
+ * discriminating Lighter's account-not-found body code from generic failures.
+ *
+ * @public
+ */
+export declare const fetchDetailedAccount: (client: LighterApiClient, address: Address) => Promise<LtDetailedAccount>;
+//# sourceMappingURL=fetchDetailedAccount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetchDetailedAccount.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchDetailedAccount.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,gBAAgB,EACxB,SAAS,OAAO,KACf,OAAO,CAAC,iBAAiB,CA6B3B,CAAA"}

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

@@ -0,0 +1,16 @@
+export type { LighterActivityCursor } from './activityCursor.js';
+export { decodeActivityCursor, encodeActivityCursor, } from './activityCursor.js';
+export { LighterApiClient } from './apiClient.js';
+export { fetchDetailedAccount } from './fetchDetailedAccount.js';
+export { lighterAsset } from './lighterAsset.js';
+export { estimateLiquidationPrice } from './liquidation.js';
+export { mapFill } from './mapFill.js';
+export { mapOpenPositions } from './mapOpenPositions.js';
+export { classifyAndMapOrders, isTriggerOrder, isTriggerType, mapOrder, mapOrderDetail, mapStatusReason, mapTriggerOrder, } from './mapOrder.js';
+export { mapPosition } from './mapPosition.js';
+export { mapInterval } from './ohlcvInterval.js';
+export { formatOrderPrice, formatOrderSize } from './orderFormatting.js';
+export { toIsoFromMs, toIsoFromSeconds } from './time.js';
+export type { ScaleToIntegerPolicy } from './wireEncoding.js';
+export { leverageToFraction, mapOrderTypeToInt, mapTimeInForceToInt, marginFractionToMaxLeverage, orderExpiryForTif, resolveTimeInForce, scaleToInteger, } from './wireEncoding.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,mBAAmB,CAAA"}

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

@@ -0,0 +1,4 @@
+import type { Asset } from '@lifi/perps-types';
+/** @public */
+export declare const lighterAsset: (id: string, displaySymbol: string) => Asset;
+//# sourceMappingURL=lighterAsset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lighterAsset.d.ts","sourceRoot":"","sources":["../../../src/utils/lighterAsset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAG9C,cAAc;AACd,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,EAAE,eAAe,MAAM,KAAG,KAK/D,CAAA"}

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

@@ -0,0 +1,22 @@
+/**
+ * Lighter liquidation price estimation.
+ *
+ * Lighter publishes a flat per-market `maintenance_margin_fraction` on its
+ * order books, surfaced on the generic {@link PerpsMarket} as
+ * `maintenanceMarginRate`. The estimate is the standard isolated-margin
+ * model parameterised by that rate.
+ */
+import { type LiquidationEstimateParams } from '@lifi/perps-sdk';
+import type { PerpsMarket } from '@lifi/perps-types';
+/**
+ * Estimate the liquidation price of a new isolated position on a Lighter
+ * market.
+ *
+ * @returns The estimated liquidation price, or `undefined` when
+ *   `market.maintenanceMarginRate` is absent (the model cannot be evaluated
+ *   without the venue's maintenance margin rate) or the inputs are
+ *   degenerate.
+ * @public
+ */
+export declare function estimateLiquidationPrice(market: PerpsMarket, params: LiquidationEstimateParams): number | undefined;
+//# sourceMappingURL=liquidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liquidation.d.ts","sourceRoot":"","sources":["../../../src/utils/liquidation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,yBAAyB,GAChC,MAAM,GAAG,SAAS,CAUpB"}

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

@@ -0,0 +1,10 @@
+import type { Fill, MarketDisplay } from '@lifi/perps-types';
+import type { LtTrade } from '../types/index.js';
+/**
+ * Map a raw Lighter trade to the generic Fill type.
+ * @param accountIndex - The viewer's Lighter account index (selects buy/sell side and maker/taker role).
+ * @param market - Backend-resolved market identity for `trade.market_id`.
+ * @public
+ */
+export declare const mapFill: (trade: LtTrade, accountIndex: number, market: MarketDisplay) => Fill;
+//# sourceMappingURL=mapFill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapFill.d.ts","sourceRoot":"","sources":["../../../src/utils/mapFill.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAQ5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAyChD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAClB,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,QAAQ,aAAa,KACpB,IA2CF,CAAA"}

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

@@ -0,0 +1,11 @@
+import type { MarketDisplay, Position } from '@lifi/perps-types';
+import type { LtAccountPosition } from '../types/index.js';
+/**
+ * Map raw Lighter account positions to open {@link Position}s, dropping
+ * zero-size rows. Only valid for payloads carrying the full position set —
+ * dropping zeros from a partial frame would make closes unobservable.
+ *
+ * @public
+ */
+export declare const mapOpenPositions: (positions: LtAccountPosition[], resolveMarket: (marketId: number) => MarketDisplay) => Position[];
+//# sourceMappingURL=mapOpenPositions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapOpenPositions.d.ts","sourceRoot":"","sources":["../../../src/utils/mapOpenPositions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAG1D;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,WAAW,iBAAiB,EAAE,EAC9B,eAAe,CAAC,QAAQ,EAAE,MAAM,KAAK,aAAa,KACjD,QAAQ,EAGgD,CAAA"}

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

@@ -0,0 +1,72 @@
+import type { MarketDisplay, OpenOrder, Order, TriggerOrder } from '@lifi/perps-types';
+import { OrderType } from '@lifi/perps-types';
+import type { LtOrder } from '../types/index.js';
+/**
+ * Map a raw Lighter order status to a short English sentence describing
+ * *why* the order ended in a terminal non-FILLED state. Non-terminal
+ * statuses, plain `filled`, and unknown values return `undefined`.
+ * @public
+ */
+export declare const mapStatusReason: (status: string) => string | undefined;
+/**
+ * True for order types Lighter exposes as TP/SL legs. Mirrors the
+ * Hyperliquid helper of the same name so the backend can split a raw
+ * Lighter order list into the same `openOrders` / `triggerOrders`
+ * buckets the SDK declares on `OrdersResponse`.
+ * @public
+ */
+export declare const isTriggerType: (type: OrderType) => boolean;
+/**
+ * Decide whether a raw Lighter order belongs in the cross-provider
+ * `triggerOrders` bucket. Single source of truth for both the REST
+ * `getOrders` path and the `account_all_orders` WS handler.
+ *
+ * Authoritative signals, in order:
+ *   1. `trigger_status` — Lighter's own enum. `'ready' | 'mark-price' |
+ *      'parent-order'` all mean "this order has trigger semantics" (TP/SL
+ *      waiting on price, or a TP/SL leg of a parent placeOrder). `'twap'`
+ *      is intentionally excluded — TWAP child orders are scheduled resting
+ *      limits, not TP/SL triggers. `'na'` is "regular order".
+ *   2. `trigger_price > 0` — catches cases where `trigger_status`
+ *      momentarily lags during state transitions (e.g. right after an OCO
+ *      sibling cancels).
+ *   3. `type` — final fallback via the mapped `OrderType`.
+ * @public
+ */
+export declare const isTriggerOrder: (raw: LtOrder) => boolean;
+/**
+ * Map a raw Lighter trigger order (stop/take-profit, market or limit) to
+ * the generic `TriggerOrder` shape. For market variants the `limitPrice`
+ * field is omitted; for limit variants `order.price` is the limit and
+ * `order.trigger_price` is the activation level.
+ * @public
+ */
+export declare const mapTriggerOrder: (order: LtOrder, market: MarketDisplay) => TriggerOrder;
+/**
+ * Map a raw Lighter order to the generic OpenOrder type.
+ * @param market - Backend-resolved market identity for `order.market_index`.
+ * @public
+ */
+export declare const mapOrder: (order: LtOrder, market: MarketDisplay) => OpenOrder;
+/**
+ * Walk a flat list of raw Lighter orders and bucket each into the
+ * `OpenOrder` / `TriggerOrder` arrays the cross-provider `OrdersResponse`
+ * declares, plus a `terminated` list of orderIds whose status has reached
+ * a terminal state (filled / cancelled / rejected / expired) — consumers
+ * applying WS deltas evict those from the cached buckets. REST callers
+ * see `terminated: []` because `accountActiveOrders` returns active only.
+ * An order whose market the resolver does not know is skipped.
+ * @public
+ */
+export declare const classifyAndMapOrders: (orders: LtOrder[], resolveMarket: (marketIndex: number) => MarketDisplay | undefined) => {
+    openOrders: OpenOrder[];
+    triggerOrders: TriggerOrder[];
+    terminated: string[];
+};
+/**
+ * Map a raw Lighter order to the rich Order type — adds status, time-in-force
+ * and remaining/filled sizes on top of the OpenOrder fields.
+ * @public
+ */
+export declare const mapOrderDetail: (order: LtOrder, market: MarketDisplay) => Order;
+//# sourceMappingURL=mapOrder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapOrder.d.ts","sourceRoot":"","sources":["../../../src/utils/mapOrder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,KAAK,EACL,YAAY,EACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAGL,SAAS,EAEV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAmDhD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SA+BzD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,KAAG,OAIjB,CAAA;AAE/B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,OAAO,KAAG,OAY7C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,OAAO,EACd,QAAQ,aAAa,KACpB,YAkBF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,EAAE,QAAQ,aAAa,KAAG,SAU/D,CAAA;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,OAAO,EAAE,EACjB,eAAe,CAAC,WAAW,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,KAChE;IACD,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAA;CAsBrB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,OAAO,EACd,QAAQ,aAAa,KACpB,KAeD,CAAA"}

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

@@ -0,0 +1,9 @@
+import type { MarketDisplay, Position } from '@lifi/perps-types';
+import type { LtAccountPosition } from '../types/index.js';
+/**
+ * Map a raw Lighter account position to the generic Position type.
+ * @param market - Backend-resolved market identity for `pos.market_id`.
+ * @public
+ */
+export declare const mapPosition: (pos: LtAccountPosition, market: MarketDisplay) => Position;
+//# sourceMappingURL=mapPosition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapPosition.d.ts","sourceRoot":"","sources":["../../../src/utils/mapPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAG1D;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,KAAK,iBAAiB,EACtB,QAAQ,aAAa,KACpB,QA4BF,CAAA"}

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

@@ -0,0 +1,3 @@
+/** @public */
+export declare const mapInterval: (interval: string) => string;
+//# sourceMappingURL=ohlcvInterval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcvInterval.d.ts","sourceRoot":"","sources":["../../../src/utils/ohlcvInterval.ts"],"names":[],"mappings":"AAsBA,cAAc;AACd,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,KAAG,MAU9C,CAAA"}

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

@@ -0,0 +1,29 @@
+/**
+ * Lighter order size and price formatting for exchange submission.
+ *
+ * Lighter publishes a flat per-market decimal budget on its order books
+ * (`supported_price_decimals` / `supported_size_decimals`), surfaced on the
+ * generic {@link Market} as `priceDecimals` / `szDecimals`. Prices round to
+ * the tick grid; sizes truncate to the lot grid.
+ */
+import { type Market } from '@lifi/perps-types';
+/**
+ * Format a price onto a Lighter market's tick grid: rounded to the market's
+ * `priceDecimals` (Lighter's `supported_price_decimals`), trailing zeros
+ * stripped.
+ *
+ * @throws {PerpsError} `ValidationError` when `market.priceDecimals` is
+ *   absent — without the venue's tick grid no correct price can be produced.
+ * @public
+ */
+export declare function formatOrderPrice(market: Market, price: number): string;
+/**
+ * Format a size onto a Lighter market's lot grid: truncated (never rounded
+ * up, so the size cannot exceed the user's balance) to the market's
+ * `szDecimals` (Lighter's `supported_size_decimals`), trailing zeros stripped.
+ *
+ * @param size - Size in base-asset units as a non-negative magnitude.
+ * @public
+ */
+export declare function formatOrderSize(market: Market, size: number): string;
+//# sourceMappingURL=orderFormatting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orderFormatting.d.ts","sourceRoot":"","sources":["../../../src/utils/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,mBAAmB,CAAA;AAG/D;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpE"}

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

@@ -0,0 +1,5 @@
+/** Convert seconds since unix epoch to ISO-8601. */
+export declare const toIsoFromSeconds: (seconds: number) => string;
+/** Convert milliseconds since unix epoch to ISO-8601. */
+export declare const toIsoFromMs: (ms: number) => string;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/utils/time.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG,MACX,CAAA;AAExC,yDAAyD;AACzD,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,MAAoC,CAAA"}