@lifi/perps-sdk-provider-lighter 24.0.2 → 26.0.0

package/src/LighterProvider.ts

@@ -1,5 +1,7 @@
 import {
+  ACTIVE_ORDER_STATUSES,
   type DepositFlow,
+  explorerTxUrl,
   explorerTxUrlFromBase,
   getAssetRegistry,
   getMarketRegistry,
@@ -20,7 +22,6 @@ import {
   type ProviderGetPortfolioHistoryParams,
   type ProviderGetPositionsParams,
   type ProviderGetQuoteParams,
-  type ProviderGetRunningTwapsParams,
   type ProviderGetWithdrawableBalancesParams,
   type ProviderWithdrawableBalance,
   paginateActivity,
@@ -55,7 +56,6 @@ import type {
   Quote,
   SignedActionStep,
   SigningMethod,
-  TwapOrder,
 } from '@lifi/perps-types'
 import {
   ActionType,
@@ -97,7 +97,6 @@ import type {
   LtAccountPnL,
   LtDepositHistoryItem,
   LtDepositHistoryResponse,
-  LtDetailedAccountPosition,
   LtLiquidation,
   LtLiquidationsResponse,
   LtOrder,
@@ -128,7 +127,6 @@ import {
 } from './utils/apiClient.js'
 import { isAssetMarginEnabled } from './utils/assetCollateral.js'
 import {
-  classifyAndMapOrders,
   estimateLiquidationPrice,
   fetchDetailedAccount,
   formatOrderPrice,
@@ -138,7 +136,7 @@ import {
   lighterWithdrawableBalances,
   mapFill,
   mapOpenPositions,
-  mapOrderDetail,
+  mapOrder,
   mapPortfolioHistory,
   positionMarginConstraints,
   toBigOrNull,
@@ -146,11 +144,11 @@ import {
   toIsoFromSeconds,
   toRequiredBig,
 } from './utils/index.js'
-import { mapRunningTwap } from './utils/mapTwap.js'
 import {
   fetchRegisteredApiKey,
   normalizeLighterPublicKey,
 } from './utils/registeredApiKey.js'
+import { isPlaceholderTxHash } from './utils/txHash.js'
 import { wireList } from './utils/wireList.js'
 
 const ZERO_FEE_TIER = { maker: '0', taker: '0' }
@@ -165,11 +163,6 @@ const projectFeeTier = (
   taker: tickToFeeString(limits.current_taker_fee_tick),
 })
 
-const orderCountFor = (p: LtDetailedAccountPosition): number =>
-  (p.open_order_count ?? 0) +
-  (p.pending_order_count ?? 0) +
-  (p.position_tied_order_count ?? 0)
-
 /**
  * Lighter `sendTx` returns a bare lowercase-hex tx hash (40 bytes → 80 hex
  * chars). `Order.order_id` is a different identifier the matching engine
@@ -349,6 +342,7 @@ export const createLighterProvider = (
   const providerKey = deployment.providerKey
   const restUrl = options.restUrl ?? deployment.restUrl
   const explorerTxBaseUrl = deployment.explorerTxBaseUrl
+  const bridgeChainId = deployment.bridgeChainId
   const collateral = deployment.collateral
   const authTokenSource: (() => string | Promise<string>) | undefined =
     typeof options.authToken === 'function'
@@ -647,11 +641,6 @@ export const createLighterProvider = (
     return wireList(response.orders)
   }
 
-  const deriveOrderBearingMarketIds = (account: LtAccount): number[] =>
-    account.positions
-      .filter((p) => orderCountFor(p) > 0)
-      .map((p) => p.market_id)
-
   const fetchAllHistory = async (
     client: LighterApiClient,
     token: string,
@@ -897,23 +886,26 @@ export const createLighterProvider = (
                 ),
               units: availableMargin.toString(),
               valueUsd: availableMargin.toString(),
+              price: '1',
             },
           ]
         : []
       // Spot token holdings — non-collateral. The instance's settlement asset
       // is valued 1:1; other tokens have no price source at this boundary, so
-      // their USD value is unknown.
+      // their price and USD value are unknown.
       const balances: Balance[] = account.assets
         .filter((asset) => toRequiredBig(asset.balance, 'balance').gt(0))
         .map((a) => {
           const assetId = String(a.asset_id)
+          const settlement = a.asset_id === collateral.assetIndex
           return {
             categoryId: spotCategoryId,
             asset:
               assetRegistry.get(assetId) ??
               lighterAsset(assetId, a.symbol, providerKey),
             units: a.balance,
-            valueUsd: a.asset_id === collateral.assetIndex ? a.balance : '0',
+            valueUsd: settlement ? a.balance : '0',
+            ...(settlement ? { price: '1' } : {}),
           }
         })
 
@@ -1063,24 +1055,22 @@ export const createLighterProvider = (
       }
     },
 
-    /**
-     * Lighter's `accountActiveOrders` endpoint takes no limit/cursor and
-     * returns every active order for the account, so the response is always
-     * the complete set: `params.limit` is not honoured and `pagination` is
-     * reported as `{ limit: <count returned>, hasMore: false }` with no cursor.
-     */
     async getOrders(
       params: ProviderGetOrdersParams,
       opts?: SDKRequestOptions
     ): Promise<OrdersResponse> {
+      const statuses = new Set(params.statuses ?? ACTIVE_ORDER_STATUSES)
+      const empty: OrdersResponse = {
+        provider: providerKey,
+        orders: [],
+        pagination: { limit: params.limit ?? 0, hasMore: false },
+      }
+      if (statuses.size === 0) {
+        return empty
+      }
       const token = await resolveAuthToken(opts, params.address)
       if (token === undefined) {
-        return {
-          provider: providerKey,
-          openOrders: [],
-          triggerOrders: [],
-          pagination: { limit: params.limit ?? 0, hasMore: false },
-        }
+        return empty
       }
 
       const client = apiClient(opts)
@@ -1089,69 +1079,73 @@ export const createLighterProvider = (
         fetchDetailedAccount(client, params.address),
         registry.sync(),
       ])
-
       const marketId =
         params.marketId === undefined
           ? LIGHTER_ALL_MARKETS_WILDCARD
           : Number(registry.require(params.marketId).id)
-
-      const response = await retryOnRevoked(opts, params.address, token, (t) =>
-        fetchActiveOrders(client, t, account.index, marketId)
-      )
-
-      const { openOrders, triggerOrders } = classifyAndMapOrders(
-        response.orders,
-        (marketIndex) => registry.require(String(marketIndex))
-      )
-
-      const total = openOrders.length + triggerOrders.length
-      return {
-        provider: providerKey,
-        openOrders,
-        triggerOrders,
-        pagination: { limit: total, hasMore: false },
-      }
-    },
-
-    async getRunningTwaps(
-      params: ProviderGetRunningTwapsParams,
-      opts?: SDKRequestOptions
-    ): Promise<TwapOrder[]> {
-      const token = await resolveAuthToken(opts, params.address)
-      if (token === undefined) {
-        return []
+      let active = false
+      let terminal = false
+      for (const status of statuses) {
+        if (isActiveOrderStatus(status)) {
+          active = true
+        } else {
+          terminal = true
+        }
       }
-
-      const client = apiClient(opts)
-      const registry = getMarketRegistry(requireClient(), providerKey)
-      const [account] = await Promise.all([
-        fetchDetailedAccount(client, params.address),
-        registry.sync(),
-      ])
-      const marketIds =
-        params.marketId === undefined
-          ? deriveOrderBearingMarketIds(account)
-          : [Number(registry.require(params.marketId).id)]
-      const responses = await retryOnRevoked(opts, params.address, token, (t) =>
-        Promise.all(
-          marketIds.map((id) => fetchActiveOrders(client, t, account.index, id))
-        )
+      const [activeResponse, inactiveResponse] = await retryOnRevoked(
+        opts,
+        params.address,
+        token,
+        (t) =>
+          Promise.all([
+            active && params.cursor === undefined
+              ? fetchActiveOrders(client, t, account.index, marketId)
+              : undefined,
+            terminal
+              ? client.getAuthed<LtOrdersResponse>(
+                  '/api/v1/accountInactiveOrders',
+                  t,
+                  {
+                    account_index: account.index,
+                    market_id: marketId,
+                    limit: params.limit ?? LIGHTER_HISTORY_PAGE_SIZE,
+                    ...(params.cursor === undefined
+                      ? {}
+                      : { cursor: params.cursor }),
+                  }
+                )
+              : undefined,
+          ])
       )
-
-      const twaps: TwapOrder[] = []
-      for (const response of responses) {
-        for (const order of response.orders) {
-          if (order.type === 'twap') {
-            twaps.push(
-              mapRunningTwap(
-                order,
-                registry.require(String(order.market_index))
-              )
-            )
+      const orders: Order[] = []
+      for (const response of [activeResponse, inactiveResponse]) {
+        for (const raw of wireList(response?.orders)) {
+          // `get`, not `require`: a market id the backend list no longer
+          // carries drops only its own row instead of rejecting the whole
+          // page. The registry warns once per unresolved id. A delisted
+          // market still resolves, so its rows stay.
+          const market = registry.get(String(raw.market_index))
+          if (market === undefined) {
+            continue
+          }
+          const order = mapOrder(raw, market)
+          if (statuses.has(order.status)) {
+            orders.push(order)
           }
         }
       }
-      return twaps
+      const cursor = inactiveResponse?.next_cursor || undefined
+      return {
+        provider: providerKey,
+        orders,
+        pagination: {
+          limit: terminal
+            ? (params.limit ?? LIGHTER_HISTORY_PAGE_SIZE)
+            : orders.length,
+          hasMore: cursor !== undefined,
+          ...(cursor === undefined ? {} : { cursor }),
+        },
+      }
     },
 
     /**
@@ -1189,7 +1183,7 @@ export const createLighterProvider = (
           `Lighter order ${params.id} not found for ${params.address}`
         )
       const detail = (order: LtOrder): Order =>
-        mapOrderDetail(order, registry.require(String(order.market_index)))
+        mapOrder(order, registry.require(String(order.market_index)))
 
       // A tx-hash route would require mapping the caller's executeAction tx
       // hash → wasm nonce → matching order, which the LI.FI backend did via
@@ -1433,9 +1427,6 @@ export const createLighterProvider = (
           : Promise.resolve(),
       ])
 
-      const assetSymbol = (assetId: number): string =>
-        assetRegistry.get(String(assetId))?.displaySymbol ?? String(assetId)
-
       const items: ActivityItem[] = [
         ...history.deposits.deposits.map(
           (d): ActivityItem => ({
@@ -1443,11 +1434,9 @@ export const createLighterProvider = (
             provider: providerKey,
             timestamp: toIsoFromMs(d.timestamp),
             type: ActivityType.DEPOSIT,
-            asset: assetSymbol(d.asset_id),
+            asset: assetRegistry.require(String(d.asset_id)),
             amount: d.amount,
-            explorerLink: d.l1_tx_hash
-              ? `https://scan.li.fi/tx/${d.l1_tx_hash}`
-              : undefined,
+            explorerLink: explorerTxUrl(bridgeChainId, d.l1_tx_hash),
           })
         ),
         // `/withdraw/history` carries no fee field, so `fee` stays absent
@@ -1458,11 +1447,9 @@ export const createLighterProvider = (
             provider: providerKey,
             timestamp: toIsoFromMs(w.timestamp),
             type: ActivityType.WITHDRAWAL,
-            asset: assetSymbol(w.asset_id),
+            asset: assetRegistry.require(String(w.asset_id)),
             amount: w.amount,
-            explorerLink: w.l1_tx_hash
-              ? `https://scan.li.fi/tx/${w.l1_tx_hash}`
-              : undefined,
+            explorerLink: explorerTxUrl(bridgeChainId, w.l1_tx_hash),
           })
         ),
         // `get`, not `require`: a market id the backend list no longer carries
@@ -1555,13 +1542,15 @@ export const createLighterProvider = (
               type: ActivityType.TRANSFER,
               direction,
               counterpartyAccountIndex,
-              asset: assetSymbol(t.asset_id),
+              asset: assetRegistry.require(String(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),
+              explorerLink: isPlaceholderTxHash(t.tx_hash)
+                ? undefined
+                : explorerTxUrlFromBase(explorerTxBaseUrl, t.tx_hash),
               meta: {
                 transferType: t.type,
                 txHash: t.tx_hash,

package/src/accountConfig.ts

@@ -16,21 +16,6 @@ function assertNever(value: never): never {
   )
 }
 
-const LIGHTER_ACCOUNT_TYPE_STANDARD = 0
-const LIGHTER_ACCOUNT_TYPE_PREMIUM = 1
-
-/**
- * Tier decode for the unauthenticated read, where `/accountLimits` — and with
- * it the tier string — is out of reach. Neither official Lighter client
- * documents an integer for any tier, so `0` (the `account_type` every sampled
- * public account reports) reads as the default tier `standard`, and `1` as
- * `premium`. No integer is known for `plus`: that account projects `null` here.
- */
-const ACCOUNT_TYPE_INT_TO_WIRE: Readonly<Record<number, string>> = {
-  [LIGHTER_ACCOUNT_TYPE_STANDARD]: 'standard',
-  [LIGHTER_ACCOUNT_TYPE_PREMIUM]: 'premium',
-}
-
 // Wire strings match the backend descriptor's ParamOption values. An unmapped
 // int projects to null.
 const ACCOUNT_MODE_INT_TO_WIRE: Readonly<Record<number, string>> = {
@@ -43,8 +28,10 @@ const ACCOUNT_MODE_INT_TO_WIRE: Readonly<Record<number, string>> = {
  * `userTierName` decides it, but only when the descriptor enumerates the
  * string: Lighter owns that vocabulary, so an unrecognised value projects
  * `null` instead of a mis-reported tier. A descriptor whose parameter carries
- * no `values` array enumerates nothing, so it also projects `null`. With no
- * tier string in hand the integer map decides.
+ * no `values` array enumerates nothing, so it also projects `null`. The
+ * unauthenticated read reaches no `/accountLimits` and so carries no tier
+ * string, which projects `null` as well: `config.accountType` is Lighter's
+ * `SubAccountType`, not a tier, so nothing else in the config decides it.
  */
 function resolveAccountTier(
   descriptor: ProviderAction,
@@ -52,7 +39,7 @@ function resolveAccountTier(
 ): string | null {
   const { userTierName } = config
   if (userTierName === undefined) {
-    return ACCOUNT_TYPE_INT_TO_WIRE[config.accountType] ?? null
+    return null
   }
   const enumerated = descriptor.params?.[0]?.values ?? []
   return enumerated.some((option) => option.value === userTierName)

package/src/constants.ts

@@ -1,3 +1,4 @@
+import { ExplorerChainId } from '@lifi/perps-sdk'
 import type { FeeTier, LighterProviderKey } from '@lifi/perps-types'
 import { LT_ASSET_ID_USDC } from './types/action.js'
 
@@ -114,6 +115,11 @@ export interface LighterDeployment {
    * When omitted, transfer links are not emitted for this deployment.
    */
   explorerTxBaseUrl?: string
+  /**
+   * L1 the deployment's bridge settles on. Deposit and withdrawal rows report
+   * an `l1_tx_hash` on this chain, not on the zkLighter L2.
+   */
+  bridgeChainId: ExplorerChainId
 }
 
 /**
@@ -128,6 +134,7 @@ export const LIGHTER_MAINNET_DEPLOYMENT: LighterDeployment = Object.freeze({
   signerChainId: LIGHTER_MAINNET_SIGNER_CHAIN_ID,
   collateral: LIGHTER_COLLATERAL_ASSETS[LIGHTER_PROVIDER_KEY],
   explorerTxBaseUrl: DEFAULT_LIGHTER_EXPLORER_TX_BASE_URL,
+  bridgeChainId: ExplorerChainId.ETHEREUM,
 })
 
 /**
@@ -155,9 +162,9 @@ export const LIGHTER_RH_WS_URL = 'wss://api.rh.lighter.xyz/stream'
 export const LIGHTER_RH_SIGNER_CHAIN_ID = 466324
 
 /**
- * Lighter on Robinhood chain, as served by `lighterRhProvider()`. No explorer
- * base URL: the RH zkLighter explorer is unpublished, so transfer links are
- * left unset rather than pointed at the mainnet explorer.
+ * Lighter on Robinhood chain, as served by `lighterRhProvider()`. No L2
+ * explorer base URL: the RH zkLighter explorer is unpublished, so transfer
+ * links are left unset rather than pointed at the mainnet explorer.
  *
  * @public
  */
@@ -168,6 +175,7 @@ export const LIGHTER_RH_DEPLOYMENT: LighterDeployment = Object.freeze({
   signerChainId: LIGHTER_RH_SIGNER_CHAIN_ID,
   collateral: LIGHTER_COLLATERAL_ASSETS[LIGHTER_RH_PROVIDER_KEY],
   explorerTxBaseUrl: undefined,
+  bridgeChainId: ExplorerChainId.ROBINHOOD,
 })
 
 /** @internal */

package/src/signers/LighterSigner.ts

@@ -109,6 +109,7 @@ const NIL_INTEGRATOR_MAKER_FEE = 0
 const SELF_TRADE_BEHAVIOR_EXPIRE_MAKER = 0
 const SELF_TRADE_EQUALITY_ACCOUNT_INDEX = 0
 const SKIP_NONCE_DISABLED = 0
+const NIL_ORDER_VERSION = 0
 // CancelAll across every market (lighter-go `NilMarketIndex`); a real index
 // scopes the cancel to a single market.
 const NIL_MARKET_INDEX = 255
@@ -552,6 +553,7 @@ export class LighterSigner {
           SELF_TRADE_EQUALITY_ACCOUNT_INDEX,
           SKIP_NONCE_DISABLED,
           nonce,
+          NIL_ORDER_VERSION,
           ctx.apiKeyIndex,
           ctx.accountIndex
         )

package/src/types/submit.ts

@@ -1,9 +1,14 @@
 // Lighter submit/execute-path wire shapes (sendTx, fastwithdraw, changeAccountTier).
 
 /**
- * Request body for Lighter's `/api/v1/sendTx` endpoint. `tx_type` and
- * `tx_info` are the signed WASM transaction envelope; `price_protection` is an
- * optional venue-side execution guard.
+ * Request body for Lighter's `/api/v1/sendTx` endpoint (spec schema
+ * `ReqSendTx`). `tx_type` and `tx_info` are the signed WASM transaction
+ * envelope. `price_protection` is a venue-side execution guard the spec
+ * defaults to `true`, so an absent member leaves the guard on.
+ *
+ * The generated client carries the same members as `SendTxRequest` in
+ * `zklighter-perps/apis/TransactionApi` — the call signature of
+ * `TransactionApi.sendTx`, not a `models/` wire model.
  *
  * @public
  */
@@ -28,9 +33,14 @@ export interface LtSendTxResponse {
 }
 
 /**
- * Batch request body for Lighter's transaction submission endpoint.
- * `tx_types` is a JSON-encoded number array and `tx_infos` a JSON-encoded
- * string array; corresponding entries are submitted in array order.
+ * Batch request body for Lighter's `/api/v1/sendTxBatch` endpoint (spec schema
+ * `ReqSendTxBatch`). `tx_types` is a JSON-encoded number array and `tx_infos` a
+ * JSON-encoded string array; corresponding entries are submitted in array
+ * order.
+ *
+ * The generated client carries the same members as `SendTxBatchRequest` in
+ * `zklighter-perps/apis/TransactionApi` — the call signature of
+ * `TransactionApi.sendTxBatch`, not a `models/` wire model.
  *
  * @public
  */

package/src/types/ws.ts

@@ -65,7 +65,7 @@ export type LtWsMarketStatsAllMessage = LtWsMessage & {
 
 /**
  * Spot market stats carry no funding/open-interest fields and address
- * markets by their spot `market_id` (2048+).
+ * markets by their `market_id`.
  * @public
  */
 export type LtWsSpotMarketStats = {

package/src/utils/activityCursor.ts

@@ -1,18 +1,13 @@
 import { PerpsError } from '@lifi/perps-sdk'
-import { type ActivityItem, PerpsErrorCode } from '@lifi/perps-types'
+import {
+  type ActivityItem,
+  ActivityType,
+  PerpsErrorCode,
+} 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.
+ * Endpoint-keyed activity cursor; absent endpoints are exhausted or excluded.
+ * Nonempty overflow requires a version-2 base64url JSON envelope.
  * @public
  */
 export interface LighterActivityCursor {
@@ -66,7 +61,7 @@ export const encodeActivityCursor = (
   if (Object.keys(compact).length === 0) {
     return undefined
   }
-  return toBase64Url(JSON.stringify(compact))
+  return toBase64Url(JSON.stringify({ version: 2, ...compact }))
 }
 
 /**
@@ -120,20 +115,57 @@ export const decodeActivityCursor = (
         'Invalid Lighter activity cursor: overflow must be an array'
       )
     }
-    env.overflow = overflow as ActivityItem[]
+    if (overflow.length > 0 && cursorRecord.version !== 2) {
+      throw new PerpsError(
+        PerpsErrorCode.ValidationError,
+        'Invalid Lighter activity cursor: legacy overflow format; restart pagination'
+      )
+    }
+    env.overflow = overflow.map(toOverflowItem)
   }
   return env
 }
 
+const ACTIVITY_TYPES: readonly string[] = Object.values(ActivityType)
+
+/**
+ * A cursor travels through consumer storage, so an overflow row may arrive
+ * corrupted or from an incompatible build. Reject it here rather than let a
+ * malformed row reach a consumer as a typed activity.
+ */
+const toOverflowItem = (row: unknown, index: number): ActivityItem => {
+  const invalid = (detail: string): PerpsError =>
+    new PerpsError(
+      PerpsErrorCode.ValidationError,
+      `Invalid Lighter activity cursor: overflow[${index}] ${detail}`
+    )
+  if (row === null || typeof row !== 'object' || Array.isArray(row)) {
+    throw invalid('must be an object')
+  }
+  const item = row as Record<string, unknown>
+  for (const field of ['id', 'provider', 'timestamp'] as const) {
+    if (typeof item[field] !== 'string') {
+      throw invalid(`${field} must be a string`)
+    }
+  }
+  if (typeof item.type !== 'string' || !ACTIVITY_TYPES.includes(item.type)) {
+    throw invalid('carries an unknown activity type')
+  }
+  return row as ActivityItem
+}
+
 const toBase64Url = (s: string): string => {
-  const utf8 = unescape(encodeURIComponent(s))
-  return btoa(utf8).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')
+  let binary = ''
+  for (const byte of new TextEncoder().encode(s)) {
+    binary += String.fromCharCode(byte)
+  }
+  return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')
 }
 
 const fromBase64Url = (s: string): string => {
   const padded = s.replace(/-/g, '+').replace(/_/g, '/') + padFor(s)
-  const decoded = atob(padded)
-  return decodeURIComponent(escape(decoded))
+  const bytes = Uint8Array.from(atob(padded), (char) => char.charCodeAt(0))
+  return new TextDecoder().decode(bytes)
 }
 
 const padFor = (s: string): string => {

package/src/utils/index.ts

@@ -16,15 +16,7 @@ export { estimateLiquidationPrice } from './liquidation.js'
 export { mapFill } from './mapFill.js'
 export { mapMarketContext } from './mapMarketContext.js'
 export { mapOpenPositions } from './mapOpenPositions.js'
-export {
-  classifyAndMapOrders,
-  isTriggerOrder,
-  isTriggerType,
-  mapOrder,
-  mapOrderDetail,
-  mapStatusReason,
-  mapTriggerOrder,
-} from './mapOrder.js'
+export { mapOrder, mapOrderUpdates } from './mapOrder.js'
 export { mapPortfolioHistory } from './mapPortfolioHistory.js'
 export { leverageFromImf, mapPosition } from './mapPosition.js'
 export { mapMarketOrderLimits } from './marketLimits.js'

package/src/utils/mapFill.ts

@@ -4,12 +4,7 @@ import {
   explorerTxUrl,
 } from '@lifi/perps-sdk'
 import type { Fill, MarketDisplay } from '@lifi/perps-types'
-import {
-  FillStatus,
-  LiquidityRole,
-  OrderSide,
-  OrderType,
-} from '@lifi/perps-types'
+import { LiquidityRole, OrderSide, OrderType } from '@lifi/perps-types'
 import Big from 'big.js'
 import {
   LIGHTER_FEE_TICK_SCALE,
@@ -17,6 +12,7 @@ import {
 } from '../constants.js'
 import type { LtTrade } from '../types/index.js'
 import { leverageFromImf } from './mapPosition.js'
+import { isPlaceholderTxHash } from './txHash.js'
 
 /**
  * Fee charged on a fill, in the market's quote asset. Lighter publishes the
@@ -131,7 +127,6 @@ export const mapFill = (
     type: OrderType.LIMIT,
     size: trade.size,
     price: trade.price,
-    status: FillStatus.FILLED,
     liquidity: isMaker ? LiquidityRole.MAKER : LiquidityRole.TAKER,
     // Lighter charges the fill fee in the market's quote asset.
     fee:
@@ -162,6 +157,8 @@ export const mapFill = (
       trade.size
     ),
     createdAt: new Date(trade.timestamp).toISOString(),
-    explorerLink: explorerTxUrl(ExplorerChainId.LIGHTER, trade.tx_hash),
+    explorerLink: isPlaceholderTxHash(trade.tx_hash)
+      ? undefined
+      : explorerTxUrl(ExplorerChainId.LIGHTER, trade.tx_hash),
   }
 }