@lifi/perps-sdk-provider-lighter 1.9.0 → 2.1.0

package/src/signers/signActions.ts

@@ -310,11 +310,13 @@ async function requireApiKey(
  * remaining legs. Each step's `txParams` carries chainId, target, function
  * name, args, and a human-readable abi from the backend.
  *
- * The wallet MUST already be on the leg's `txParams.chainId`: this signer
- * broadcasts on the wallet's active chain and never switches it (switching is
- * the integrator's responsibility — the widget drives it before signing). A leg
- * whose target chain differs from the wallet's chain throws before broadcasting,
- * so a token approve/deposit can never land on an unintended chain.
+ * Before broadcasting a leg the SDK switches the wallet to the leg's
+ * `txParams.chainId` via `ctx.switchToChain`, re-reading the returned client so
+ * the broadcast lands on the right chain even when legs target different chains.
+ * When no switch capability is supplied (local/private-key signer, or no
+ * `switchChain` hook configured) a leg whose target chain differs from the
+ * wallet's active chain throws before broadcasting, so a token approve/deposit
+ * can never land on an unintended chain.
  * @internal
  */
 export async function signEvmTxActions(
@@ -330,30 +332,36 @@ export async function signEvmTxActions(
     )
   }
 
+  const switchToChain = ctx?.switchToChain
   const signed: EvmTxSignedActionStep[] = []
+  let legSigner = walletSigner
   for (const step of steps) {
     const params = step.txParams
 
-    if (walletSigner.chain?.id !== params.chainId) {
+    if (legSigner.chain?.id !== params.chainId && switchToChain) {
+      legSigner = await switchToChain(params.chainId)
+    }
+    if (legSigner.chain?.id !== params.chainId) {
       throw new PerpsError(
         PerpsErrorCode.SDKError,
         `EVM_TX leg '${step.action}' targets chain ${params.chainId}, but the ` +
-          `connected wallet is on chain ${walletSigner.chain?.id ?? 'unknown'}. ` +
-          `Switch the wallet to chain ${params.chainId} before signing — the ` +
-          "SDK broadcasts on the wallet's active chain and does not switch it."
+          `connected wallet is on chain ${legSigner.chain?.id ?? 'unknown'} and ` +
+          'no chain switch was performed. Configure a switchChain hook via ' +
+          `setSwitchChain, or connect the wallet to chain ${params.chainId} ` +
+          'before signing.'
       )
     }
 
-    const txHash = await walletSigner.writeContract({
+    const txHash = await legSigner.writeContract({
       address: params.to,
       abi: parseAbi(params.abi),
       functionName: params.functionName,
       args: params.args,
-      chain: walletSigner.chain,
-      account: walletSigner.account,
+      chain: legSigner.chain,
+      account: legSigner.account,
     })
 
-    const receipt = await waitForTransactionReceipt(walletSigner, {
+    const receipt = await waitForTransactionReceipt(legSigner, {
       hash: txHash,
     })
     if (receipt.status === 'reverted') {

package/src/types/ws.ts

@@ -149,7 +149,18 @@ export type LtWsAccountAllTradesMessage = LtWsMessage & {
   data?: { trades?: Record<string, unknown[]> | unknown[] }
 }
 
-/** @public */
+/**
+ * `user_stats/{account_index}` frame; decimal strings in USD.
+ * @public
+ */
+export type LtWsUserStatsMessage = LtWsMessage & {
+  stats?: {
+    collateral?: string
+    portfolio_value?: string
+    available_balance?: string
+  }
+}
+
 export type LtWsAccountAllPositionsMessage = LtWsMessage & {
   type: 'subscribed/account_all_positions' | 'update/account_all_positions'
   positions?: Record<string, unknown>

package/src/websocket/LighterWsProvider.ts

@@ -40,6 +40,7 @@ import type {
   LtWsSpotMarketStats,
   LtWsSpotMarketStatsAllMessage,
   LtWsTradeMessage,
+  LtWsUserStatsMessage,
 } from '../types/index.js'
 import { LIGHTER_RETRY_DEFAULTS, LighterApiClient } from '../utils/apiClient.js'
 import {
@@ -310,6 +311,8 @@ export class LighterWsProvider extends WsProviderBase<SubState> {
         return `fills:${sub.address.toLowerCase()}`
       case 'positions':
         return `positions:${sub.address.toLowerCase()}`
+      case 'accountSummary':
+        return `accountSummary:${sub.address.toLowerCase()}`
       // No live wire sub (openChannel returns a no-op), but a stable key is
       // still needed so the base's fan-out registry can track/release it.
       case 'candle':
@@ -369,6 +372,17 @@ export class LighterWsProvider extends WsProviderBase<SubState> {
       }
       return [{ channel: `trade/${id}`, needsAuth: false }]
     }
+    if (sub.channel === 'accountSummary') {
+      const accountIndex = await this.resolveAccountIndex(sub.address)
+      // `user_stats` is publicly readable; no token needed.
+      return [
+        {
+          channel: `user_stats/${accountIndex}`,
+          needsAuth: false,
+          address: sub.address,
+        },
+      ]
+    }
     if (
       sub.channel === 'orderUpdates' ||
       sub.channel === 'fills' ||
@@ -503,6 +517,14 @@ export class LighterWsProvider extends WsProviderBase<SubState> {
       return
     }
 
+    if (
+      msg.type === 'subscribed/user_stats' ||
+      msg.type === 'update/user_stats'
+    ) {
+      this.handleUserStats(msg as LtWsUserStatsMessage)
+      return
+    }
+
     if (
       msg.type === 'subscribed/account_all_positions' ||
       msg.type === 'update/account_all_positions'
@@ -531,6 +553,33 @@ export class LighterWsProvider extends WsProviderBase<SubState> {
     })
   }
 
+  private handleUserStats(msg: LtWsUserStatsMessage): void {
+    const address = this.addressFromChannel(msg.channel, 'user_stats')
+    if (!address) {
+      return
+    }
+    const stats = msg.stats
+    const portfolio = Number.parseFloat(stats?.portfolio_value ?? '')
+    const available = Number.parseFloat(stats?.available_balance ?? '')
+    if (!Number.isFinite(portfolio) || !Number.isFinite(available)) {
+      return
+    }
+    // Identities of the REST 'net' semantics: `available_balance` nets locked
+    // margin out with PnL marked in, and `collateral` is gross, PnL-exclusive.
+    const collateral = Number.parseFloat(stats?.collateral ?? '')
+    this.emit(`accountSummary:${address}`, {
+      channel: 'accountSummary',
+      data: {
+        portfolioValue: portfolio.toString(),
+        availableMargin: available.toString(),
+        marginUsed: Math.max(portfolio - available, 0).toString(),
+        unrealizedPnl: Number.isFinite(collateral)
+          ? (portfolio - collateral).toString()
+          : '0',
+      },
+    })
+  }
+
   private handleAccountTrades(msg: LtWsAccountAllTradesMessage): void {
     const address = this.addressFromChannel(msg.channel, 'account_all_trades')
     if (!address) {