@lifi/perps-sdk-provider-lighter 16.0.0 → 17.0.1

package/dist/types/types/order.d.ts

@@ -1,9 +1,10 @@
 /**
  * Order payload returned by Lighter's REST API. Amounts and prices are decimal
  * strings in market precision. `order_expiry` is an absolute Unix-millisecond
- * expiry; `created_at`, `updated_at`, and `transaction_time` are Unix seconds.
- * Enum-like side, type, time-in-force, status, and trigger fields retain
- * Lighter's wire strings.
+ * expiry; `created_at` and `updated_at` are Unix seconds. `timestamp` and
+ * `transaction_time` carry their unit on the member; `trigger_time` has no
+ * documented unit. Enum-like side, type, time-in-force, status, and trigger
+ * fields retain Lighter's wire strings.
  *
  * @public
  */
@@ -36,9 +37,18 @@ export type LtOrder = {
     to_trigger_order_id_1: string;
     to_cancel_order_id_0: string;
     block_height: number;
+    /**
+     * Unit unproven. Lighter documents no unit, and every endpoint that returns
+     * this row is auth-gated, so no public probe can observe a value.
+     */
     timestamp: number;
     created_at: number;
     updated_at: number;
+    /**
+     * Unix timestamp in microseconds. Lighter documents no unit, and its public
+     * trade rows report this member in microseconds while the sibling
+     * `created_at` and `updated_at` stay in seconds.
+     */
     transaction_time: number;
 };
 /**
@@ -54,8 +64,8 @@ export interface LtOrdersResponse {
 }
 /**
  * Single order-book level returned by Lighter. Amounts and prices are decimal
- * strings in the market's native precision; expiry and transaction time are
- * Unix milliseconds.
+ * strings in the market's native precision; `order_expiry` is an absolute
+ * Unix-millisecond expiry.
  *
  * @public
  */
@@ -67,6 +77,10 @@ export interface LtOrderBookOrder {
     remaining_base_amount: string;
     price: string;
     order_expiry: number;
+    /**
+     * Unit unproven. Lighter documents no unit, and every resting order this
+     * endpoint returns reports the member as zero.
+     */
     transaction_time: number;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../src/types/order.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,qBAAqB,EAAE,MAAM,CAAA;IAC7B,MAAM,EAAE,OAAO,CAAA;IACf,kBAAkB,EAAE,MAAM,CAAA;IAC1B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;IACvB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,gBAAgB,EAAE,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,gBAAgB,EAAE,CAAA;CACzB"}
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../src/types/order.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,qBAAqB,EAAE,MAAM,CAAA;IAC7B,MAAM,EAAE,OAAO,CAAA;IACf,kBAAkB,EAAE,MAAM,CAAA;IAC1B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;IACvB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,gBAAgB,EAAE,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,gBAAgB,EAAE,CAAA;CACzB"}

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

@@ -1 +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,IAkDF,CAAA"}
+{"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;AAS5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AA8DhD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAClB,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,QAAQ,aAAa,KACpB,IA0DF,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-lighter",
-  "version": "16.0.0",
+  "version": "17.0.1",
   "description": "Lighter provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -44,10 +44,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.55.18",
-    "@lifi/perps-types": "^10.0.0"
+    "@lifi/perps-types": "^11.1.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^9.0.0"
+    "@lifi/perps-sdk": "^10.0.1"
   },
   "publishConfig": {
     "access": "public"

package/src/LighterProvider.ts

@@ -21,6 +21,7 @@ import {
   type ProviderGetRunningTwapsParams,
   type ProviderGetWithdrawableBalancesParams,
   type ProviderWithdrawableBalance,
+  paginateActivity,
   resolveQuote,
   resolveRetryPolicy,
   type SDKRequestOptions,
@@ -1400,68 +1401,40 @@ export const createLighterProvider = (
               counterpartyAccountIndex,
               asset: assetSymbol(t.asset_id),
               amount: t.amount,
+              // The venue charges the transfer fee in the deployment's
+              // settlement asset, not in the asset the row moves, so a spot
+              // token transfer still reports a collateral-denominated fee.
+              fees: [{ amount: t.fee, asset: collateral.displaySymbol }],
               explorerLink: explorerTxUrlFromBase(explorerTxBaseUrl, t.tx_hash),
               meta: {
                 transferType: t.type,
                 txHash: t.tx_hash,
                 fromRoute: t.from_route,
                 toRoute: t.to_route,
-                fee: t.fee,
               },
             }
           }),
       ]
 
-      const merged = [...(inputCursor?.overflow ?? []), ...items]
-
-      // The type filter also applies to replayed overflow rows: a cursor
-      // minted under one filter must never leak another surface's rows when
-      // the caller pages the two surfaces independently.
-      const requestedTypes =
-        params.type === undefined ? undefined : new Set(params.type)
-
-      const filtered = merged.filter((it) => {
-        if (requestedTypes !== undefined && !requestedTypes.has(it.type)) {
-          return false
-        }
-        const ts = new Date(it.timestamp).getTime()
-        if (params.startTime !== undefined && ts < params.startTime) {
-          return false
-        }
-        if (params.endTime !== undefined && ts > params.endTime) {
-          return false
-        }
-        return true
-      })
-
-      filtered.sort(
-        (a, b) =>
-          new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
+      const page = paginateActivity(
+        items,
+        inputCursor?.overflow ?? [],
+        params,
+        (overflowTail) =>
+          encodeActivityCursor({
+            deposits: history.deposits.cursor,
+            withdraws: history.withdraws.cursor,
+            fundings: history.fundings.next_cursor,
+            liquidations: history.liquidations.next_cursor,
+            transfers: history.transfers.cursor,
+            overflow: overflowTail,
+          })
       )
 
-      const limit = params.limit ?? filtered.length
-      const emitted = filtered.slice(0, limit)
-      const overflow = filtered.slice(limit)
-
-      const nextCursorEnvelope: LighterActivityCursor = {
-        deposits: history.deposits.cursor,
-        withdraws: history.withdraws.cursor,
-        fundings: history.fundings.next_cursor,
-        liquidations: history.liquidations.next_cursor,
-        transfers: history.transfers.cursor,
-        overflow,
-      }
-      const responseCursor = encodeActivityCursor(nextCursorEnvelope)
-      const hasMore = responseCursor !== undefined
-
       return {
         provider: providerKey,
-        items: emitted,
-        pagination: {
-          limit,
-          hasMore,
-          ...(responseCursor === undefined ? {} : { cursor: responseCursor }),
-        },
+        items: page.items,
+        pagination: page.pagination,
       }
     },
 

package/src/accountConfig.ts

@@ -149,6 +149,7 @@ function projectLighterDescriptor(
     case ActionType.UPDATE_ASSET_COLLATERAL:
     case ActionType.DEPOSIT:
     case ActionType.META_ACCEPT_TERMS:
+    case ActionType.SYNC_FEE_ATTRIBUTION:
       throw new PerpsError(
         PerpsErrorCode.SDKError,
         `Lighter account-config mapper has no projection for ` +

package/src/types/account.ts

@@ -116,6 +116,11 @@ export interface LtDetailedAccount {
   available_balance: string
   status: number
   collateral: string
+  /**
+   * Unix timestamp in microseconds. Lighter documents no unit, and its
+   * account rows report 16-digit values. A dormant account reports `0`, so
+   * treat `0` as "no transaction" and not as the Unix epoch.
+   */
   transaction_time: number
   account_trading_mode: number
   account_index: number
@@ -183,6 +188,12 @@ export interface LtSubAccount {
   available_balance: string
   status: number
   collateral: string
+  /**
+   * Unix timestamp in microseconds, the same wire member as
+   * `LtDetailedAccount.transaction_time`. Lighter leaves it at `0` on the
+   * `accountsByL1Address` rows, so read the value from the account endpoint
+   * instead.
+   */
   transaction_time: number
   account_trading_mode: number
 }

package/src/types/activity.ts

@@ -113,7 +113,11 @@ export interface LtLiqTrade {
   size: string
   taker_fee: string
   maker_fee: string
-  /** Unix timestamp in milliseconds. */
+  /**
+   * Unix timestamp in microseconds. The enclosing row's `executed_at` is
+   * milliseconds. Lighter documents no unit, and its public trade rows report
+   * this member in microseconds.
+   */
   transaction_time: number
 }
 
@@ -177,9 +181,10 @@ export interface LtLiquidationsResponse {
 }
 
 /**
- * Asset transfer-history row returned by Lighter. Amounts and fees are decimal
- * strings in the asset's precision; route literals identify the source and
- * destination account ledger (`spot` or `perps`).
+ * Asset transfer-history row returned by Lighter. `amount` is a decimal string
+ * in the precision of the asset the row moves; `fee` is a decimal string in the
+ * precision of the deployment's settlement asset. Route literals identify the
+ * source and destination account ledger (`spot` or `perps`).
  *
  * @public
  */

package/src/types/fill.ts

@@ -3,8 +3,13 @@
 /**
  * Public trade/fill row returned by Lighter's `/api/v1/trades` endpoint.
  * Size, price, and notional fields are decimal strings in market precision;
- * `timestamp` and `transaction_time` are Unix millisecond timestamps. The
- * optional fee fields are integer fee ticks and may be absent on older rows.
+ * `timestamp` is a Unix millisecond timestamp; `transaction_time` is a Unix
+ * microsecond timestamp. The optional fee fields are the side's fee *rate* as
+ * an integer tick on `LIGHTER_FEE_TICK_SCALE` (1e6), not the amount charged,
+ * and may be absent on older rows. A row can also carry
+ * `integrator_maker_fee` or `integrator_taker_fee`: a second optional rate for
+ * the same side, on the same 1e6 tick scale. The mapper adds that second rate
+ * to the side's own rate.
  *
  * @public
  */
@@ -28,6 +33,10 @@ export type LtTrade = {
   // on older trades) — keep optional and let the mapper emit `undefined`.
   taker_fee?: number
   maker_fee?: number
+  // A second fee tick that a row can carry for the same side, on the same 1e6
+  // tick scale as `taker_fee` / `maker_fee`.
+  integrator_taker_fee?: number
+  integrator_maker_fee?: number
   transaction_time: number
   // Per-counterparty position snapshot BEFORE the trade is applied. Signed
   // strings: positive = long, negative = short, "0" / "0.00000" = flat.

package/src/types/order.ts

@@ -3,9 +3,10 @@
 /**
  * Order payload returned by Lighter's REST API. Amounts and prices are decimal
  * strings in market precision. `order_expiry` is an absolute Unix-millisecond
- * expiry; `created_at`, `updated_at`, and `transaction_time` are Unix seconds.
- * Enum-like side, type, time-in-force, status, and trigger fields retain
- * Lighter's wire strings.
+ * expiry; `created_at` and `updated_at` are Unix seconds. `timestamp` and
+ * `transaction_time` carry their unit on the member; `trigger_time` has no
+ * documented unit. Enum-like side, type, time-in-force, status, and trigger
+ * fields retain Lighter's wire strings.
  *
  * @public
  */
@@ -38,9 +39,18 @@ export type LtOrder = {
   to_trigger_order_id_1: string
   to_cancel_order_id_0: string
   block_height: number
+  /**
+   * Unit unproven. Lighter documents no unit, and every endpoint that returns
+   * this row is auth-gated, so no public probe can observe a value.
+   */
   timestamp: number
   created_at: number
   updated_at: number
+  /**
+   * Unix timestamp in microseconds. Lighter documents no unit, and its public
+   * trade rows report this member in microseconds while the sibling
+   * `created_at` and `updated_at` stay in seconds.
+   */
   transaction_time: number
 }
 
@@ -58,8 +68,8 @@ export interface LtOrdersResponse {
 
 /**
  * Single order-book level returned by Lighter. Amounts and prices are decimal
- * strings in the market's native precision; expiry and transaction time are
- * Unix milliseconds.
+ * strings in the market's native precision; `order_expiry` is an absolute
+ * Unix-millisecond expiry.
  *
  * @public
  */
@@ -71,6 +81,10 @@ export interface LtOrderBookOrder {
   remaining_base_amount: string
   price: string
   order_expiry: number
+  /**
+   * Unit unproven. Lighter documents no unit, and every resting order this
+   * endpoint returns reports the member as zero.
+   */
   transaction_time: number
 }
 

package/src/utils/mapFill.ts

@@ -11,8 +11,30 @@ import {
   OrderType,
 } from '@lifi/perps-types'
 import Big from 'big.js'
+import { LIGHTER_FEE_TICK_SCALE } from '../constants.js'
 import type { LtTrade } from '../types/index.js'
 
+/**
+ * Fee charged on a fill, in the market's quote asset. Lighter publishes the
+ * side's fee *rate* as an integer tick on `LIGHTER_FEE_TICK_SCALE` rather than
+ * the amount it charged. A row can carry more than one tick for the same side,
+ * so `amount = notional * sum(side ticks) / LIGHTER_FEE_TICK_SCALE`.
+ *
+ * The product keeps the sign of both inputs. A rebate tick therefore maps to a
+ * negative amount, which `Fee.amount` permits and the Ondo mapper already emits
+ * when a rebate exceeds the fee, so this helper never clamps the sign. A zero
+ * notional charges a zero fee at every tick.
+ */
+const tickToFeeAmount = (
+  notional: string,
+  ownTick: number,
+  integratorTick: number | undefined
+): string =>
+  new Big(notional)
+    .times(new Big(ownTick).plus(integratorTick ?? 0))
+    .div(LIGHTER_FEE_TICK_SCALE)
+    .toFixed()
+
 /**
  * Realized PnL on a position-reducing fill, derived from the pre-trade entry
  * basis. Returns `undefined` for opens/increases (nothing closes) or when the
@@ -75,9 +97,10 @@ export const mapFill = (
   const entryQuoteBefore = isMaker
     ? trade.maker_entry_quote_before
     : trade.taker_entry_quote_before
-  const feeAmount = isMaker
-    ? trade.maker_fee?.toString()
-    : trade.taker_fee?.toString()
+  const feeTick = isMaker ? trade.maker_fee : trade.taker_fee
+  const integratorFeeTick = isMaker
+    ? trade.integrator_maker_fee
+    : trade.integrator_taker_fee
 
   return {
     id: trade.trade_id.toString(),
@@ -91,9 +114,16 @@ export const mapFill = (
     liquidity: isMaker ? LiquidityRole.MAKER : LiquidityRole.TAKER,
     // Lighter charges the fill fee in the market's quote asset.
     fee:
-      feeAmount === undefined
+      feeTick === undefined
         ? undefined
-        : { amount: feeAmount, asset: market.quoteAsset.displaySymbol },
+        : {
+            amount: tickToFeeAmount(
+              trade.usd_amount,
+              feeTick,
+              integratorFeeTick
+            ),
+            asset: market.quoteAsset.displaySymbol,
+          },
     realizedPnl: deriveRealizedPnl(
       startPosition,
       entryQuoteBefore,