@lifi/perps-sdk-provider-lighter 41.0.1 → 42.0.0

package/dist/wasm/lighter-signer.manifest.json

@@ -0,0 +1,46 @@
+{
+  "protocol": 2,
+  "sourceCommit": "b1edafa9cefc356be10e6b257d7097390a2e2d9f",
+  "sourceTreeSha256": "eec666104c587023f670ffaee6522a5371f5c1f11b0a93017ba243971066a7e1",
+  "goVersion": "go1.26.8",
+  "sha256": "2ebb649ab539784f69b7fbbfa04eebaf8728284aa269f84bfb327d2bed911a83",
+  "exports": [
+    "_lighterTest",
+    "_createClient",
+    "_createClientByPrv",
+    "_signChangePubKey",
+    "_signRevokePubKey",
+    "_signCreateSubAccount",
+    "_signCreatePublicPool",
+    "_signUpdatePublicPool",
+    "_signCreateOrder",
+    "_signCancelOrder",
+    "_signWithdraw",
+    "_signCancelAllOrders",
+    "_signModifyOrder",
+    "_signTransfer",
+    "_signMintShares",
+    "_signBurnShares",
+    "_signUpdateLeverage",
+    "_signUpdateMargin",
+    "_signUpdateAccountConfig",
+    "_signUpdateAccountAssetConfig",
+    "_signCreateGroupedOrders",
+    "_signApproveIntegrator",
+    "_getApproveIntegratorTransaction",
+    "_getChangePubKeyTransaction",
+    "_getRevokePubKeyTransaction",
+    "_getTransferTransaction",
+    "_getAirdropAllocationMessage",
+    "_createAuthToken",
+    "_signStakeAssets",
+    "_signUnstakeAssets",
+    "_signBinaryOptionsOperatorCreateMarket",
+    "_signBinaryOptionsOperatorUpdateMarket",
+    "_signBinaryOptionsOperatorSettleMarket",
+    "_resetClients",
+    "_selectClient"
+  ],
+  "runtimeSha256": "0c949f4996f9a89698e4b5c586de32249c3b69b7baadb64d220073cc04acba14",
+  "htmlSha256": "12efc5f5d57374c95f45ba061d6e1554de4221935bc2f3474c88367afa4677e5"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-lighter",
-  "version": "41.0.1",
+  "version": "42.0.0",
   "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": "^25.0.1"
+    "@lifi/perps-types": "^26.0.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^28.0.0"
+    "@lifi/perps-sdk": "^29.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/depositFlow.ts

@@ -11,31 +11,33 @@ import { ActionType, type LighterProviderKey } from '@lifi/perps-types'
 import { LIGHTER_PROVIDER_KEY, LIGHTER_RH_PROVIDER_KEY } from './constants.js'
 
 interface LighterDepositAssets {
-  /** Collateral token on the venue chain, credited to an account that exists. */
-  venueCollateral: DeclaredDepositAsset
-  /** Collateral the account-opening deposit is made in, on the chain that deposit runs on. */
-  firstDepositCollateral: DeclaredDepositAsset
-  firstDepositGas: DeclaredDepositAsset
+  /**
+   * Collateral token on the venue chain that a LI.FI route credits to an
+   * account that exists. Absent when only the venue deposit credits an account.
+   */
+  venueCollateral?: DeclaredDepositAsset
+  /** Collateral the venue deposit is made in, on the chain that deposit runs on. */
+  venueDepositCollateral: DeclaredDepositAsset
+  venueDepositGas: DeclaredDepositAsset
 }
 
 const DEPOSIT_ASSETS: Record<LighterProviderKey, LighterDepositAssets> = {
   [LIGHTER_PROVIDER_KEY]: {
     venueCollateral: LIGHTER_USDC,
-    firstDepositCollateral: ETHEREUM_USDC,
-    firstDepositGas: ETHEREUM_NATIVE_GAS,
+    venueDepositCollateral: ETHEREUM_USDC,
+    venueDepositGas: ETHEREUM_NATIVE_GAS,
   },
   [LIGHTER_RH_PROVIDER_KEY]: {
-    venueCollateral: ROBINHOOD_USDG,
-    firstDepositCollateral: ROBINHOOD_USDG,
-    firstDepositGas: ROBINHOOD_NATIVE_GAS,
+    venueDepositCollateral: ROBINHOOD_USDG,
+    venueDepositGas: ROBINHOOD_NATIVE_GAS,
   },
 }
 
 /**
  * Resolve one Lighter instance's deposit flow from whether the account already
- * exists: an existing account takes a swap into the instance's venue collateral,
- * while an address with no account runs the account-opening deposit on the chain
- * that instance's collateral is deposited from.
+ * exists: an existing account takes a swap into the instance's venue collateral
+ * when a LI.FI route credits it there. Every other case runs the venue deposit
+ * on the chain that instance's collateral is deposited from.
  *
  * @public
  */
@@ -45,15 +47,15 @@ export function lighterDepositFlow(
 ): DepositFlow {
   const assets = DEPOSIT_ASSETS[providerKey]
 
-  if (accountExists) {
+  if (accountExists && assets.venueCollateral) {
     return { kind: 'lifiSwap', destination: assets.venueCollateral }
   }
 
   return {
-    kind: 'firstDepositPipeline',
-    chainId: assets.firstDepositCollateral.chainId,
-    gasAsset: assets.firstDepositGas,
-    collateral: assets.firstDepositCollateral,
+    kind: 'venueDepositPipeline',
+    chainId: assets.venueDepositCollateral.chainId,
+    gasAsset: assets.venueDepositGas,
+    collateral: assets.venueDepositCollateral,
     bridgeAction: ActionType.DEPOSIT,
   }
 }

package/src/signers/generated/wasmExecRuntime.ts

@@ -585,3 +585,41 @@ export function createGoRuntime(): {
 
   return new globalThis.Go()
 }
+
+export const lighterWasmGlobalNames = [
+  "_lighterTest",
+  "_createClient",
+  "_createClientByPrv",
+  "_signChangePubKey",
+  "_signRevokePubKey",
+  "_signCreateSubAccount",
+  "_signCreatePublicPool",
+  "_signUpdatePublicPool",
+  "_signCreateOrder",
+  "_signCancelOrder",
+  "_signWithdraw",
+  "_signCancelAllOrders",
+  "_signModifyOrder",
+  "_signTransfer",
+  "_signMintShares",
+  "_signBurnShares",
+  "_signUpdateLeverage",
+  "_signUpdateMargin",
+  "_signUpdateAccountConfig",
+  "_signUpdateAccountAssetConfig",
+  "_signCreateGroupedOrders",
+  "_signApproveIntegrator",
+  "_getApproveIntegratorTransaction",
+  "_getChangePubKeyTransaction",
+  "_getRevokePubKeyTransaction",
+  "_getTransferTransaction",
+  "_getAirdropAllocationMessage",
+  "_createAuthToken",
+  "_signStakeAssets",
+  "_signUnstakeAssets",
+  "_signBinaryOptionsOperatorCreateMarket",
+  "_signBinaryOptionsOperatorUpdateMarket",
+  "_signBinaryOptionsOperatorSettleMarket",
+  "_resetClients",
+  "_selectClient"
+] as const

package/src/signers/wasmLoader.ts

@@ -3,7 +3,10 @@
 
 import { PerpsError } from '@lifi/perps-sdk'
 import { PerpsErrorCode } from '@lifi/perps-types'
-import { createGoRuntime } from './generated/wasmExecRuntime.js'
+import {
+  createGoRuntime,
+  lighterWasmGlobalNames,
+} from './generated/wasmExecRuntime.js'
 import {
   lighterWasmBinaryUrl,
   resolveEmittedBinaryUrl,
@@ -257,22 +260,6 @@ const WASM_FUNCTION_NAMES = [
   '_signUpdateAccountAssetConfig',
 ] as const satisfies readonly (keyof LighterWasmExports)[]
 
-// Installed by the binary but never called. They are removed from globalThis
-// with the used exports, because each one signs with the account's API key.
-const UNUSED_WASM_FUNCTION_NAMES = [
-  '_signRevokePubKey',
-  '_getRevokePubKeyTransaction',
-  '_signCreateSubAccount',
-  '_signCreatePublicPool',
-  '_signUpdatePublicPool',
-  '_signMintShares',
-  '_signBurnShares',
-  '_signCreateGroupedOrders',
-  '_getAirdropAllocationMessage',
-  '_signStakeAssets',
-  '_signUnstakeAssets',
-] as const
-
 /**
  * Call one signer export and wait for its result. A `{error}` result becomes a
  * {@link PerpsError} with code `SignatureInvalid`.
@@ -451,9 +438,11 @@ async function loadWasmUncached(): Promise<LighterWasmExports> {
     ;(exports as Record<string, unknown>)[name] = fn
     delete globals[name]
   }
-  for (const name of UNUSED_WASM_FUNCTION_NAMES) {
+  for (const name of lighterWasmGlobalNames) {
     delete globals[name]
   }
+  // The protocol version is metadata, not a manifest export.
+  delete globals._signerVersion
 
   return exports as LighterWasmExports
 }

package/src/utils/mapFill.ts

@@ -10,11 +10,12 @@ import {
   isDecimalStringZero,
   safeAddDecimalString,
   safeDivideDecimalString,
+  safeIsDecimalStringZero,
   safeMultiplyDecimalString,
   warnSkippedVenueRow,
 } from '@lifi/perps-sdk'
-import type { Fill, MarketDisplay } from '@lifi/perps-types'
-import { LiquidityRole, OrderSide, OrderType } from '@lifi/perps-types'
+import type { Fill, FillLiquidation, MarketDisplay } from '@lifi/perps-types'
+import { LiquidationMethod, LiquidityRole, OrderSide } from '@lifi/perps-types'
 import { LIGHTER_FEE_TICK_SCALE, LIGHTER_PROVIDER_KEY } from '../constants.js'
 import type { LtTrade } from '../types/index.js'
 import { leverageFromScaledImf } from './mapPosition.js'
@@ -111,8 +112,28 @@ const deriveRealizedPnl = (
   return isDecimalStringZero(pnl) ? null : pnl
 }
 
+// The liquidation engine trades as the taker for the liquidated account; the
+// maker of a forced trade is its counterparty.
+const mapFillLiquidation = (
+  type: string,
+  isMaker: boolean
+): FillLiquidation | undefined => {
+  if (isMaker) {
+    return undefined
+  }
+  switch (type) {
+    case 'liquidation':
+      return { method: LiquidationMethod.MARKET }
+    case 'deleverage':
+      return { method: LiquidationMethod.DELEVERAGE }
+    default:
+      return undefined
+  }
+}
+
 /**
- * Map a raw Lighter trade to the generic Fill type.
+ * Map a raw Lighter trade to the generic Fill type. Leaves `type` absent: a
+ * trade row does not name the originating order 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
@@ -122,7 +143,13 @@ export const mapFill = (
   accountIndex: number,
   market: MarketDisplay
 ): Fill | undefined => {
-  const { size, price } = trade
+  const { size } = trade
+  // Lighter reports a zero `price` on a `deleverage` row, but `usd_amount`
+  // still carries the execution notional.
+  const price =
+    trade.type === 'deleverage' && safeIsDecimalStringZero(trade.price) === true
+      ? (safeDivideDecimalString(trade.usd_amount, size) ?? trade.price)
+      : trade.price
   const createdAt = rowTimestampToIsoStringOrUndefined(trade.timestamp)
   if (createdAt === undefined) {
     warnSkippedVenueRow(
@@ -159,13 +186,13 @@ export const mapFill = (
     feeTick === undefined
       ? undefined
       : tickToFeeAmount(trade.usd_amount, feeTick, integratorFeeTick)
+  const liquidation = mapFillLiquidation(trade.type, isMaker)
 
   return {
     id: trade.trade_id_str,
     orderId: isBuyer ? trade.bid_id_str : trade.ask_id_str,
     market,
     side: isBuyer ? OrderSide.BUY : OrderSide.SELL,
-    type: OrderType.LIMIT,
     size,
     price,
     liquidity: isMaker ? LiquidityRole.MAKER : LiquidityRole.TAKER,
@@ -192,5 +219,6 @@ export const mapFill = (
     explorerLink: isPlaceholderTxHash(trade.tx_hash)
       ? undefined
       : explorerTxUrl(ExplorerChainId.LIGHTER, trade.tx_hash),
+    ...(liquidation === undefined ? {} : { liquidation }),
   }
 }

package/src/utils/mapOrder.ts

@@ -221,6 +221,7 @@ export const mapOrder = (
         price: order.price,
         timeInForce: mapTimeInForce(order.time_in_force),
         ...(expiresAt === undefined ? {} : { expiresAt }),
+        ...(order.type === 'liquidation' ? { isLiquidation: true } : {}),
       }
   }
 }

package/src/utils/mapPosition.ts

@@ -79,7 +79,9 @@ const warnUnreadableField = (field: string, value: unknown): void => {
  * an invalid size gives `undefined`. An invalid position value or a
  * non-positive initial margin fraction keeps the row, leaves `leverage` and
  * `initialMarginRequirement` absent, sets a cross `marginUsed` to `'0'` and
- * warns once. Prices, PnL, funding and isolated margin pass through raw.
+ * warns once. Prices, PnL, funding and isolated margin pass through raw. A
+ * zero or empty `liquidation_price`, which Lighter sends for a position that
+ * no price liquidates, leaves `liquidationPrice` absent.
  * @param market - Backend-resolved market identity for `pos.market_id`.
  * @public
  */
@@ -107,6 +109,10 @@ export const mapPosition = (
     positionValue === undefined || leverage === undefined
       ? undefined
       : divideDecimalString(multiplyDecimalString(positionValue, imf), '100')
+  const liquidationPrice = pos.liquidation_price
+  const hasLiquidationPrice = isDecimalString(liquidationPrice)
+    ? !isDecimalStringZero(liquidationPrice)
+    : liquidationPrice !== ''
 
   return {
     market,
@@ -121,7 +127,7 @@ export const mapPosition = (
               ? '0'
               : divideDecimalString(positionValue, size),
         }),
-    liquidationPrice: pos.liquidation_price,
+    ...(hasLiquidationPrice ? { liquidationPrice } : {}),
     unrealizedPnl: pos.unrealized_pnl,
     accruedFunding: pos.total_funding_paid_out ?? '0',
     ...(leverage === undefined ? {} : { leverage }),