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

package/dist/esm/utils/mapFill.js.map

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

package/dist/esm/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/esm/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/esm/utils/mapOpenPositions.js

@@ -0,0 +1,12 @@
+import { mapPosition } from './mapPosition.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 const mapOpenPositions = (positions, resolveMarket) => positions
+    .filter((p) => Number.parseFloat(p.position) !== 0)
+    .map((p) => mapPosition(p, resolveMarket(p.market_id)));
+//# sourceMappingURL=mapOpenPositions.js.map

package/dist/esm/utils/mapOpenPositions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapOpenPositions.js","sourceRoot":"","sources":["../../../src/utils/mapOpenPositions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,SAA8B,EAC9B,aAAkD,EACtC,EAAE,CACd,SAAS;KACN,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;KAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA"}

package/dist/esm/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/esm/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/esm/utils/mapOrder.js

@@ -0,0 +1,219 @@
+import { isActiveOrderStatus } from '@lifi/perps-sdk';
+import { OrderSide, OrderStatus, OrderType, TimeInForce, } from '@lifi/perps-types';
+// Lighter's `type` enum uses hyphens in the OpenAPI spec but earlier API
+// versions emitted underscores. Tolerate both so we don't silently fall
+// through to LIMIT for stop/take-profit orders.
+const mapOrderType = (ltType) => {
+    const normalized = ltType.replace(/-/g, '_');
+    const map = {
+        limit: OrderType.LIMIT,
+        market: OrderType.MARKET,
+        stop_loss: OrderType.STOP_MARKET,
+        stop_loss_limit: OrderType.STOP_LIMIT,
+        take_profit: OrderType.TAKE_PROFIT_MARKET,
+        take_profit_limit: OrderType.TAKE_PROFIT_LIMIT,
+    };
+    return map[normalized] ?? OrderType.LIMIT;
+};
+const mapTimeInForce = (tif) => {
+    switch (tif.replace(/-/g, '_')) {
+        case 'good_till_time':
+            return TimeInForce.GTT;
+        case 'immediate_or_cancel':
+            return TimeInForce.IOC;
+        case 'post_only':
+            return TimeInForce.POST_ONLY;
+        default:
+            return undefined;
+    }
+};
+const mapOrderStatus = (status) => {
+    if (status === 'open' ||
+        status === 'in-progress' ||
+        status === 'in_progress') {
+        return OrderStatus.OPEN;
+    }
+    if (status === 'pending') {
+        return OrderStatus.PENDING;
+    }
+    if (status === 'filled') {
+        return OrderStatus.FILLED;
+    }
+    if (status.startsWith('canceled')) {
+        return OrderStatus.CANCELLED;
+    }
+    return OrderStatus.OPEN;
+};
+/**
+ * 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 const mapStatusReason = (status) => {
+    switch (status) {
+        case 'canceled':
+            return 'Order cancelled.';
+        case 'canceled-post-only':
+            return 'Order cancelled: post-only order would have crossed the book.';
+        case 'canceled-reduce-only':
+            return 'Order cancelled: would not reduce your position.';
+        case 'canceled-position-not-allowed':
+            return 'Order cancelled: position not allowed.';
+        case 'canceled-margin-not-allowed':
+            return 'Order cancelled: insufficient margin.';
+        case 'canceled-too-much-slippage':
+            return 'Order cancelled: slippage exceeded tolerance.';
+        case 'canceled-not-enough-liquidity':
+            return 'Order cancelled: not enough liquidity to fill.';
+        case 'canceled-self-trade':
+            return 'Order cancelled: would self-trade against your own resting order.';
+        case 'canceled-expired':
+            return 'Order expired.';
+        case 'canceled-oco':
+            return 'Order cancelled: sibling OCO order filled or cancelled first.';
+        case 'canceled-child':
+            return 'Order cancelled: parent order was cancelled.';
+        case 'canceled-liquidation':
+            return 'Order cancelled: account was liquidated.';
+        case 'canceled-invalid-balance':
+            return 'Order cancelled: invalid balance.';
+        default:
+            return 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 const isTriggerType = (type) => type === OrderType.TAKE_PROFIT_MARKET ||
+    type === OrderType.TAKE_PROFIT_LIMIT ||
+    type === OrderType.STOP_MARKET ||
+    type === OrderType.STOP_LIMIT;
+/**
+ * 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 const isTriggerOrder = (raw) => {
+    if (raw.trigger_status === 'ready' ||
+        raw.trigger_status === 'mark-price' ||
+        raw.trigger_status === 'parent-order') {
+        return true;
+    }
+    if (raw.trigger_price !== '' && parseFloat(raw.trigger_price) > 0) {
+        return true;
+    }
+    return isTriggerType(mapOrderType(raw.type));
+};
+/**
+ * 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 const mapTriggerOrder = (order, market) => {
+    const type = mapOrderType(order.type);
+    const isLimit = type === OrderType.TAKE_PROFIT_LIMIT || type === OrderType.STOP_LIMIT;
+    return {
+        // `order_index` is the per-(account, market) numeric id Lighter's L2
+        // mutating txs (cancel, modify) require. The matching-engine string
+        // label `order_id` is internal to the SDK provider and never crosses
+        // this boundary — combined with `market.id` (=market_index), the
+        // numeric `order_index` uniquely pins a Lighter order.
+        orderId: String(order.order_index),
+        market,
+        type,
+        size: order.initial_base_amount,
+        triggerPrice: order.trigger_price,
+        ...(isLimit ? { limitPrice: order.price } : {}),
+        createdAt: new Date(order.created_at * 1000).toISOString(),
+    };
+};
+/**
+ * Map a raw Lighter order to the generic OpenOrder type.
+ * @param market - Backend-resolved market identity for `order.market_index`.
+ * @public
+ */
+export const mapOrder = (order, market) => ({
+    orderId: String(order.order_index),
+    market,
+    side: order.is_ask ? OrderSide.SELL : OrderSide.BUY,
+    type: mapOrderType(order.type),
+    size: order.initial_base_amount,
+    price: order.price,
+    filledSize: order.filled_base_amount,
+    reduceOnly: order.reduce_only,
+    createdAt: new Date(order.created_at * 1000).toISOString(),
+});
+/**
+ * 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 const classifyAndMapOrders = (orders, resolveMarket) => {
+    const openOrders = [];
+    const triggerOrders = [];
+    const terminated = [];
+    for (const raw of orders) {
+        const orderId = String(raw.order_index);
+        if (!isActiveOrderStatus(mapOrderStatus(raw.status))) {
+            terminated.push(orderId);
+            continue;
+        }
+        const market = resolveMarket(raw.market_index);
+        if (market === undefined) {
+            continue;
+        }
+        if (isTriggerOrder(raw)) {
+            triggerOrders.push(mapTriggerOrder(raw, market));
+        }
+        else {
+            openOrders.push(mapOrder(raw, market));
+        }
+    }
+    return { openOrders, triggerOrders, terminated };
+};
+/**
+ * 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 const mapOrderDetail = (order, market) => ({
+    orderId: String(order.order_index),
+    market,
+    side: order.is_ask ? OrderSide.SELL : OrderSide.BUY,
+    type: mapOrderType(order.type),
+    price: order.price,
+    originalSize: order.initial_base_amount,
+    remainingSize: order.remaining_base_amount,
+    filledSize: order.filled_base_amount,
+    timeInForce: mapTimeInForce(order.time_in_force),
+    reduceOnly: order.reduce_only,
+    status: mapOrderStatus(order.status),
+    statusReason: mapStatusReason(order.status),
+    createdAt: new Date(order.created_at * 1000).toISOString(),
+    updatedAt: new Date(order.updated_at * 1000).toISOString(),
+});
+//# sourceMappingURL=mapOrder.js.map

package/dist/esm/utils/mapOrder.js.map

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

package/dist/esm/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/esm/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/esm/utils/mapPosition.js

@@ -0,0 +1,34 @@
+import { MarginMode, PositionSide } from '@lifi/perps-types';
+import { LT_MARGIN_MODE_ISOLATED } 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 const mapPosition = (pos, market) => {
+    const size = parseFloat(pos.position);
+    const isIsolated = pos.margin_mode === LT_MARGIN_MODE_ISOLATED;
+    // `allocated_margin` is only populated for isolated positions (always "0"
+    // on cross accounts). For cross, derive margin as
+    // `position_value × initial_margin_fraction / 100` (IMF is in percent).
+    const positionValue = Math.abs(parseFloat(pos.position_value));
+    const imf = parseFloat(pos.initial_margin_fraction);
+    const marginUsed = isIsolated
+        ? pos.allocated_margin
+        : ((positionValue * imf) / 100).toString();
+    return {
+        market,
+        side: pos.sign >= 0 ? PositionSide.LONG : PositionSide.SHORT,
+        size: Math.abs(size).toString(),
+        entryPrice: pos.avg_entry_price,
+        markPrice: pos.position_value === '0' || size === 0
+            ? '0'
+            : (parseFloat(pos.position_value) / Math.abs(size)).toString(),
+        liquidationPrice: pos.liquidation_price,
+        unrealizedPnl: pos.unrealized_pnl,
+        leverage: imf > 0 ? Math.round(100 / imf) : 1,
+        marginUsed,
+        marginMode: isIsolated ? MarginMode.ISOLATED : MarginMode.CROSS,
+    };
+};
+//# sourceMappingURL=mapPosition.js.map

package/dist/esm/utils/mapPosition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapPosition.js","sourceRoot":"","sources":["../../../src/utils/mapPosition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAE5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,GAAsB,EACtB,MAAqB,EACX,EAAE;IACZ,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACrC,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,KAAK,uBAAuB,CAAA;IAE9D,0EAA0E;IAC1E,kDAAkD;IAClD,wEAAwE;IACxE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAA;IAC9D,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,UAAU;QAC3B,CAAC,CAAC,GAAG,CAAC,gBAAgB;QACtB,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAA;IAE5C,OAAO;QACL,MAAM;QACN,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK;QAC5D,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QAC/B,UAAU,EAAE,GAAG,CAAC,eAAe;QAC/B,SAAS,EACP,GAAG,CAAC,cAAc,KAAK,GAAG,IAAI,IAAI,KAAK,CAAC;YACtC,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;QAClE,gBAAgB,EAAE,GAAG,CAAC,iBAAiB;QACvC,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,QAAQ,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,UAAU;QACV,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK;KAChE,CAAA;AACH,CAAC,CAAA"}

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

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

package/dist/esm/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/esm/utils/ohlcvInterval.js

@@ -0,0 +1,30 @@
+import { PerpsError } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+/**
+ * Map our `OhlcvInterval` literal to Lighter's `resolution` enum.
+ *
+ * Lighter exposes only the timeframes listed below. SDK intervals without a
+ * direct match (3m, 2h, 8h, 3d, 1M) raise a validation error rather than
+ * silently rounding — the caller picks a supported timeframe.
+ */
+const LIGHTER_SUPPORTED_INTERVALS = {
+    '1m': '1m',
+    '5m': '5m',
+    '15m': '15m',
+    '30m': '30m',
+    '1h': '1h',
+    '4h': '4h',
+    '12h': '12h',
+    '1d': '1d',
+    '1w': '1w',
+};
+/** @public */
+export const mapInterval = (interval) => {
+    const resolution = LIGHTER_SUPPORTED_INTERVALS[interval];
+    if (!resolution) {
+        throw new PerpsError(PerpsErrorCode.ValidationError, `Lighter does not support OHLCV interval '${interval}'. ` +
+            `Supported: ${Object.keys(LIGHTER_SUPPORTED_INTERVALS).join(', ')}.`);
+    }
+    return resolution;
+};
+//# sourceMappingURL=ohlcvInterval.js.map

package/dist/esm/utils/ohlcvInterval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcvInterval.js","sourceRoot":"","sources":["../../../src/utils/ohlcvInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD;;;;;;GAMG;AACH,MAAM,2BAA2B,GAA2B;IAC1D,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;CACX,CAAA;AAED,cAAc;AACd,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAU,EAAE;IACtD,MAAM,UAAU,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAA;IACxD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,4CAA4C,QAAQ,KAAK;YACvD,cAAc,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACvE,CAAA;IACH,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC,CAAA"}

package/dist/esm/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/esm/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/esm/utils/orderFormatting.js

@@ -0,0 +1,41 @@
+/**
+ * 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 { PerpsError } from '@lifi/perps-sdk';
+import { PerpsErrorCode } from '@lifi/perps-types';
+import Big from 'big.js';
+/**
+ * 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 function formatOrderPrice(market, price) {
+    if (market.priceDecimals === undefined) {
+        throw new PerpsError(PerpsErrorCode.ValidationError, `Market '${market.id}' carries no priceDecimals; Lighter order prices ` +
+            `cannot be formatted without the market's tick grid.`);
+    }
+    const rounded = new Big(price).round(market.priceDecimals, Big.roundHalfUp);
+    return rounded.eq(0) ? '0' : rounded.toFixed();
+}
+/**
+ * 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 function formatOrderSize(market, size) {
+    const truncated = new Big(size).round(market.szDecimals, Big.roundDown);
+    return truncated.eq(0) ? '0' : truncated.toFixed();
+}
+//# sourceMappingURL=orderFormatting.js.map

package/dist/esm/utils/orderFormatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderFormatting.js","sourceRoot":"","sources":["../../../src/utils/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAe,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,GAAG,MAAM,QAAQ,CAAA;AAExB;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAa;IAC5D,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,WAAW,MAAM,CAAC,EAAE,mDAAmD;YACrE,qDAAqD,CACxD,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;IAC3E,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,IAAY;IAC1D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACvE,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;AACpD,CAAC"}

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

package/dist/esm/utils/time.js

@@ -0,0 +1,5 @@
+/** Convert seconds since unix epoch to ISO-8601. */
+export const toIsoFromSeconds = (seconds) => new Date(seconds * 1000).toISOString();
+/** Convert milliseconds since unix epoch to ISO-8601. */
+export const toIsoFromMs = (ms) => new Date(ms).toISOString();
+//# sourceMappingURL=time.js.map

package/dist/esm/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/utils/time.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAU,EAAE,CAC1D,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;AAExC,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA"}

package/dist/esm/utils/wireEncoding.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Lighter wire encoding for the WASM signer: scaled-integer decimal values,
+ * basis-point margin fractions, and order-type/TIF/expiry resolution
+ * mirroring the lighter-go signer's rules.
+ */
+/**
+ * Lighter uses basis-points (1/10000) for margin fractions.
+ * Convert to a decimal multiplier: 1000 → 0.1 (10x leverage).
+ * @public
+ */
+export declare const marginFractionToMaxLeverage: (fraction: number) => number;
+/**
+ * Convert leverage to margin fraction in basis points for WASM signer.
+ * @public
+ */
+export declare const leverageToFraction: (leverage: number) => number;
+/**
+ * Off-grid resolution for {@link scaleToInteger}:
+ * - `truncate` — toward zero, for sizes and collateral amounts. The wire
+ *   value never exceeds the caller's intent.
+ * - `round` — half away from zero, for prices, which snap to the nearest
+ *   tick.
+ * @public
+ */
+export type ScaleToIntegerPolicy = 'truncate' | 'round';
+/**
+ * Scale a human-readable decimal string to a scaled integer for the WASM
+ * signer, in exact decimal arithmetic — an on-grid input maps to its exact
+ * scaled integer with no binary float artifacts (`'0.29'` at 2 decimals is
+ * 29, never 28). Off-grid input resolves per `policy`; there is no silent
+ * default.
+ *
+ * @throws {PerpsError} `ValidationError` when `value` is not a decimal
+ *   numeric string, `decimals` is not a non-negative integer, or the scaled
+ *   result's magnitude exceeds `Number.MAX_SAFE_INTEGER`.
+ * @public
+ */
+export declare const scaleToInteger: (value: string, decimals: number, policy: ScaleToIntegerPolicy) => number;
+/**
+ * Map our OrderType enum to Lighter's integer order type.
+ * @public
+ */
+export declare const mapOrderTypeToInt: (type?: string) => number;
+/**
+ * Lighter pairs each `order_type` with a permitted set of `time_in_force`
+ * values: market-style orders (MARKET, STOP_MARKET, TAKE_PROFIT_MARKET) are
+ * IOC by definition; limit-style orders may carry any TIF. The Go WASM
+ * signer rejects mismatches with `OrderTimeInForce is not valid`. Resolve
+ * the caller's optional `timeInForce` against the order type so unspecified
+ * values land on the correct default and explicit values are validated up
+ * front.
+ * @public
+ */
+export declare const resolveTimeInForce: (orderTypeInt: number, tif?: string) => number;
+/**
+ * Map our TimeInForce enum to Lighter's integer time-in-force.
+ * @public
+ */
+export declare const mapTimeInForceToInt: (tif?: string) => number;
+/**
+ * Pick the `order_expiry` value Lighter expects for a given TIF on a
+ * regular limit order. `lighter-go/types/txtypes/create_order.go:121-128`
+ * enforces:
+ *   - IOC limit orders → `OrderExpiry == NilOrderExpiry (0)`
+ *   - non-IOC limit orders → `OrderExpiry != NilOrderExpiry`
+ * For non-IOC we pass the `-1` sentinel, which the WASM signer rewrites
+ * to `now + 28d` (absolute ms). Trigger orders take a different rule —
+ * see {@link LT_DEFAULT_ORDER_EXPIRY} call sites.
+ * @public
+ */
+export declare const orderExpiryForTif: (tifInt: number) => number;
+//# sourceMappingURL=wireEncoding.d.ts.map

package/dist/esm/utils/wireEncoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireEncoding.d.ts","sourceRoot":"","sources":["../../../src/utils/wireEncoding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,KAAG,MAK9D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,MAQrD,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,OAAO,CAAA;AAEvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,UAAU,MAAM,EAChB,QAAQ,oBAAoB,KAC3B,MA0BF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,MAUjD,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,cAAc,MAAM,EACpB,MAAM,MAAM,KACX,MAgBF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,MAOlD,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,MAKlD,CAAA"}