@pear-protocol/symmio-client 0.3.12 → 0.3.14

package/dist/react/index.mjs

@@ -70,6 +70,9 @@ function toBinanceSymbol(symmSymbol) {
 // src/utils/binance-ws.ts
 var BINANCE_WS_URL = "wss://fstream.binance.com/market/ws";
 var RECONNECT_DELAYS = [1e3, 2e3, 4e3, 8e3, 16e3, 3e4];
+var IDLE_CLOSE_DELAY_MS = 3e4;
+var STALE_CONNECTION_MS = 3e4;
+var STALE_CHECK_INTERVAL_MS = 1e4;
 var STABLE_QUOTES = ["USDT0", "USDT", "USDC", "USDE", "USDH", "USD"];
 function normalizeBaseSymbol(symbol) {
   const normalized = symbol.toUpperCase().trim();
@@ -119,8 +122,11 @@ var BinanceWsManager = class {
   streams = /* @__PURE__ */ new Map();
   reconnectAttempt = 0;
   reconnectTimer = null;
+  idleCloseTimer = null;
+  staleCheckTimer = null;
   intentionalClose = false;
-  pendingSubscribes = [];
+  pendingSubscribes = /* @__PURE__ */ new Set();
+  lastMessageAt = 0;
   idCounter = 0;
   /**
    * Subscribe to a kline stream. Returns an unsubscribe function.
@@ -193,10 +199,10 @@ var BinanceWsManager = class {
    */
   destroy() {
     this.intentionalClose = true;
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-      this.reconnectTimer = null;
-    }
+    this.clearReconnectTimer();
+    this.clearIdleCloseTimer();
+    this.clearStaleCheckTimer();
+    this.pendingSubscribes.clear();
     if (this.ws) {
       this.ws.close();
       this.ws = null;
@@ -216,6 +222,7 @@ var BinanceWsManager = class {
     }
     sub.callbacks.set(id, cb);
     if (isNew) {
+      this.clearIdleCloseTimer();
       this.ensureConnected();
       this.sendSubscribe([streamName]);
     }
@@ -227,18 +234,14 @@ var BinanceWsManager = class {
     if (sub.callbacks.size === 0) {
       this.streams.delete(streamName);
       this.sendUnsubscribe([streamName]);
-      if (this.streams.size === 0 && this.ws) {
-        this.intentionalClose = true;
-        this.ws.close();
-        this.ws = null;
-        this.intentionalClose = false;
-      }
+      this.scheduleIdleClose();
     }
   }
   ensureConnected() {
     if (this.ws && (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING)) {
       return;
     }
+    this.clearReconnectTimer();
     this.connect();
   }
   connect() {
@@ -247,23 +250,27 @@ var BinanceWsManager = class {
     this.ws = new WebSocket(BINANCE_WS_URL);
     this.ws.onopen = () => {
       this.reconnectAttempt = 0;
-      const activeStreams = Array.from(this.streams.keys());
+      this.lastMessageAt = Date.now();
+      this.startStaleCheck();
+      const activeStreams = Array.from(
+        /* @__PURE__ */ new Set([...this.streams.keys(), ...this.pendingSubscribes])
+      );
+      this.pendingSubscribes.clear();
       if (activeStreams.length > 0) {
         this.sendSubscribe(activeStreams);
       }
-      if (this.pendingSubscribes.length > 0) {
-        this.sendSubscribe(this.pendingSubscribes);
-        this.pendingSubscribes = [];
-      }
     };
     this.ws.onmessage = (event) => {
       try {
         const data = JSON.parse(event.data);
+        this.lastMessageAt = Date.now();
         this.handleMessage(data);
       } catch {
       }
     };
     this.ws.onclose = () => {
+      this.ws = null;
+      this.clearStaleCheckTimer();
       if (this.intentionalClose) return;
       this.scheduleReconnect();
     };
@@ -297,25 +304,27 @@ var BinanceWsManager = class {
   }
   sendSubscribe(streams) {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-      this.pendingSubscribes.push(...streams);
+      streams.forEach((stream) => this.pendingSubscribes.add(stream));
       return;
     }
+    const params = Array.from(new Set(streams));
+    if (params.length === 0) return;
     this.ws.send(JSON.stringify({
       method: "SUBSCRIBE",
-      params: streams,
+      params,
       id: Date.now()
     }));
   }
   sendUnsubscribe(streams) {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-      this.pendingSubscribes = this.pendingSubscribes.filter(
-        (s) => !streams.includes(s)
-      );
+      streams.forEach((stream) => this.pendingSubscribes.delete(stream));
       return;
     }
+    const params = Array.from(new Set(streams));
+    if (params.length === 0) return;
     this.ws.send(JSON.stringify({
       method: "UNSUBSCRIBE",
-      params: streams,
+      params,
       id: Date.now()
     }));
   }
@@ -329,6 +338,44 @@ var BinanceWsManager = class {
       this.connect();
     }, delay);
   }
+  scheduleIdleClose() {
+    if (this.streams.size > 0 || this.idleCloseTimer) return;
+    this.clearReconnectTimer();
+    if (!this.ws) return;
+    this.idleCloseTimer = setTimeout(() => {
+      this.idleCloseTimer = null;
+      if (this.streams.size > 0 || !this.ws) return;
+      this.intentionalClose = true;
+      this.ws.close();
+      this.ws = null;
+      this.intentionalClose = false;
+      this.clearStaleCheckTimer();
+    }, IDLE_CLOSE_DELAY_MS);
+  }
+  startStaleCheck() {
+    this.clearStaleCheckTimer();
+    this.staleCheckTimer = setInterval(() => {
+      if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+      if (this.streams.size === 0) return;
+      if (Date.now() - this.lastMessageAt < STALE_CONNECTION_MS) return;
+      this.ws.close();
+    }, STALE_CHECK_INTERVAL_MS);
+  }
+  clearReconnectTimer() {
+    if (!this.reconnectTimer) return;
+    clearTimeout(this.reconnectTimer);
+    this.reconnectTimer = null;
+  }
+  clearIdleCloseTimer() {
+    if (!this.idleCloseTimer) return;
+    clearTimeout(this.idleCloseTimer);
+    this.idleCloseTimer = null;
+  }
+  clearStaleCheckTimer() {
+    if (!this.staleCheckTimer) return;
+    clearInterval(this.staleCheckTimer);
+    this.staleCheckTimer = null;
+  }
 };
 var _instance = null;
 function getBinanceWsManager() {
@@ -359,6 +406,28 @@ function getNextRefCount(binanceSymbol) {
 function getPrevRefCount(binanceSymbol) {
   return Math.max(0, (refCounts.get(binanceSymbol) ?? 0) - 1);
 }
+function addMappedSymbol(binanceSymbol, symmSymbol) {
+  const symbols = streamSymbols.get(binanceSymbol) ?? /* @__PURE__ */ new Map();
+  symbols.set(symmSymbol, (symbols.get(symmSymbol) ?? 0) + 1);
+  streamSymbols.set(binanceSymbol, symbols);
+}
+function removeMappedSymbol(binanceSymbol, symmSymbol) {
+  const symbols = streamSymbols.get(binanceSymbol);
+  if (!symbols) return false;
+  const currentCount = symbols.get(symmSymbol) ?? 0;
+  if (currentCount <= 0) return false;
+  if (currentCount === 1) {
+    symbols.delete(symmSymbol);
+  } else {
+    symbols.set(symmSymbol, currentCount - 1);
+  }
+  if (symbols.size === 0) {
+    streamSymbols.delete(binanceSymbol);
+  } else {
+    streamSymbols.set(binanceSymbol, symbols);
+  }
+  return true;
+}
 var useBinanceMarkPriceStore = create((set) => ({
   markPrices: {},
   fundingRates: {},
@@ -367,9 +436,7 @@ var useBinanceMarkPriceStore = create((set) => ({
     const binanceSymbol = normalizeBinanceSymbol(rawBinanceSymbol);
     const nextRefCount = getNextRefCount(binanceSymbol);
     refCounts.set(binanceSymbol, nextRefCount);
-    const symbols = streamSymbols.get(binanceSymbol) ?? /* @__PURE__ */ new Set();
-    symbols.add(symmSymbol);
-    streamSymbols.set(binanceSymbol, symbols);
+    addMappedSymbol(binanceSymbol, symmSymbol);
     if (allMarkPricesRefCount === 0) {
       const wsManager = getBinanceWsManager();
       allMarkPricesUnsubscribe = wsManager.subscribeAllMarkPrices((entries) => {
@@ -384,7 +451,7 @@ var useBinanceMarkPriceStore = create((set) => ({
             nextMarkPrices ??= { ...state.markPrices };
             nextFundingRates ??= { ...state.fundingRates };
             nextFundingTimes ??= { ...state.nextFundingTimes };
-            mappedSymbols.forEach((mappedSymbol) => {
+            mappedSymbols.forEach((_count, mappedSymbol) => {
               nextMarkPrices[mappedSymbol] = entry.markPrice;
               nextFundingRates[mappedSymbol] = entry.fundingRate;
               nextFundingTimes[mappedSymbol] = entry.nextFundingTime;
@@ -405,14 +472,9 @@ var useBinanceMarkPriceStore = create((set) => ({
   },
   unsubscribeSymbol: (symmSymbol, rawBinanceSymbol) => {
     const binanceSymbol = normalizeBinanceSymbol(rawBinanceSymbol);
-    const symbols = streamSymbols.get(binanceSymbol);
-    if (symbols) {
-      symbols.delete(symmSymbol);
-      if (symbols.size === 0) {
-        streamSymbols.delete(binanceSymbol);
-      } else {
-        streamSymbols.set(binanceSymbol, symbols);
-      }
+    const removedSubscription = removeMappedSymbol(binanceSymbol, symmSymbol);
+    if (!removedSubscription) {
+      return;
     }
     const nextRefCount = getPrevRefCount(binanceSymbol);
     if (nextRefCount === 0) {
@@ -426,6 +488,10 @@ var useBinanceMarkPriceStore = create((set) => ({
       allMarkPricesUnsubscribe = null;
     }
     set((state) => {
+      const hasMappedSymbol = Boolean(streamSymbols.get(binanceSymbol)?.has(symmSymbol));
+      if (hasMappedSymbol) {
+        return state;
+      }
       if (state.markPrices[symmSymbol] == null && state.fundingRates[symmSymbol] == null && state.nextFundingTimes[symmSymbol] == null) {
         return state;
       }
@@ -510,7 +576,7 @@ var symmKeys = {
   signature: (address, chainId) => ["symm", "signature", address, chainId],
   auth: (accountAddress, chainId, signerAddress) => ["symm", "auth", accountAddress, chainId, signerAddress],
   approval: (owner, spender, chainId, token) => ["symm", "approval", owner, spender, chainId, token],
-  balances: (address, chainId) => ["symm", "balances", address, chainId],
+  balances: (address, chainId, multiAccountAddress) => multiAccountAddress === void 0 ? ["symm", "balances", address, chainId] : ["symm", "balances", address, chainId, multiAccountAddress],
   positions: (params) => ["symm", "positions", params],
   openOrders: (params) => ["symm", "openOrders", params],
   tradeHistory: (params) => ["symm", "tradeHistory", params],
@@ -543,8 +609,33 @@ var useSymmWsStore = create((set) => ({
 }));
 
 // src/react/hooks/use-symm-ws.ts
-function asUnsubscribeFn(value) {
-  return typeof value === "function" ? value : null;
+var wsOwnerCounts = /* @__PURE__ */ new WeakMap();
+var wsConnectPromises = /* @__PURE__ */ new WeakMap();
+function addWsOwner(ws) {
+  wsOwnerCounts.set(ws, (wsOwnerCounts.get(ws) ?? 0) + 1);
+}
+function removeWsOwner(ws) {
+  const nextCount = Math.max(0, (wsOwnerCounts.get(ws) ?? 0) - 1);
+  if (nextCount === 0) {
+    wsOwnerCounts.delete(ws);
+  } else {
+    wsOwnerCounts.set(ws, nextCount);
+  }
+  return nextCount;
+}
+function connectShared(ws) {
+  if (ws.isConnected()) {
+    return Promise.resolve();
+  }
+  const existing = wsConnectPromises.get(ws);
+  if (existing) {
+    return existing;
+  }
+  const promise = ws.connect().finally(() => {
+    wsConnectPromises.delete(ws);
+  });
+  wsConnectPromises.set(ws, promise);
+  return promise;
 }
 function useSymmWs(params = {}) {
   const ctx = useContext(SymmContext);
@@ -561,114 +652,76 @@ function useSymmWs(params = {}) {
     }
     const ws = symmCoreClient.ws;
     const addr = accountAddress;
-    const unsubscribers = [];
     let cancelled = false;
-    const removeOnConnect = ws.onConnect(() => {
-      setConnected(true);
+    addWsOwner(ws);
+    const removeOnConnect = ws.onConnect(() => setConnected(true));
+    const removeOnDisconnect = ws.onDisconnect(() => setConnected(false));
+    const subscriptions = [];
+    const addSubscription = (channel, handler) => {
+      ws.subscribe(channel, addr, chainId, handler);
+      subscriptions.push({ channel, handler });
+    };
+    addSubscription("positions", () => {
+      queryClient.invalidateQueries({ queryKey: symmKeys.positionsRoot });
     });
-    const removeOnDisconnect = ws.onDisconnect(() => {
-      setConnected(false);
+    addSubscription("open-orders", () => {
+      queryClient.invalidateQueries({ queryKey: symmKeys.openOrdersRoot });
     });
-    const removeOnError = asUnsubscribeFn(ws.onError?.(() => {
-    }));
-    const removeOnWelcome = asUnsubscribeFn(ws.onWelcome?.(() => {
-    }));
-    unsubscribers.push(removeOnConnect, removeOnDisconnect);
-    if (removeOnError) unsubscribers.push(removeOnError);
-    if (removeOnWelcome) unsubscribers.push(removeOnWelcome);
-    const positionsUnsub = asUnsubscribeFn(
-      ws.subscribeToPositions(addr, chainId, () => {
-        queryClient.invalidateQueries({
-          queryKey: symmKeys.positionsRoot
-        });
-      })
-    );
-    if (positionsUnsub) unsubscribers.push(positionsUnsub);
-    const openOrdersUnsub = asUnsubscribeFn(
-      ws.subscribeToOpenOrders(addr, chainId, () => {
-        queryClient.invalidateQueries({
-          queryKey: symmKeys.openOrdersRoot
-        });
-      })
-    );
-    if (openOrdersUnsub) unsubscribers.push(openOrdersUnsub);
-    const tradesUnsub = asUnsubscribeFn(
-      ws.subscribeToTrades(addr, chainId, () => {
-        queryClient.invalidateQueries({
-          queryKey: symmKeys.tradeHistoryRoot
-        });
-      })
-    );
-    if (tradesUnsub) unsubscribers.push(tradesUnsub);
-    const accountSummaryUnsub = asUnsubscribeFn(
-      ws.subscribeToAccountSummary(addr, chainId, () => {
-        queryClient.invalidateQueries({
-          queryKey: symmKeys.balances(accountAddress, chainId)
-        });
-        queryClient.invalidateQueries({
-          queryKey: symmKeys.accountSummary(accountAddress, chainId)
-        });
-      })
-    );
-    if (accountSummaryUnsub) unsubscribers.push(accountSummaryUnsub);
-    const notificationsUnsub = asUnsubscribeFn(
-      ws.subscribeToNotifications(addr, chainId, () => {
-        queryClient.invalidateQueries({
-          queryKey: symmKeys.notifications({ accountAddress, chainId })
-        });
-        queryClient.invalidateQueries({
-          queryKey: symmKeys.unreadCount({ accountAddress, chainId })
-        });
-      })
-    );
-    if (notificationsUnsub) unsubscribers.push(notificationsUnsub);
-    const tpslUnsub = asUnsubscribeFn(
-      ws.subscribeToTpsl(addr, chainId, () => {
-        queryClient.invalidateQueries({ queryKey: symmKeys.tpslOrdersRoot });
-        queryClient.invalidateQueries({ queryKey: symmKeys.openOrdersRoot });
-      })
-    );
-    if (tpslUnsub) unsubscribers.push(tpslUnsub);
-    const twapUnsub = asUnsubscribeFn(
-      ws.subscribeToTwapOrders(addr, chainId, () => {
-        queryClient.invalidateQueries({ queryKey: symmKeys.twapOrdersRoot });
-        queryClient.invalidateQueries({ queryKey: symmKeys.openOrdersRoot });
-      })
-    );
-    if (twapUnsub) unsubscribers.push(twapUnsub);
-    const triggerOrdersUnsub = asUnsubscribeFn(
-      ws.subscribeToTriggerOrders(addr, chainId, () => {
-        queryClient.invalidateQueries({ queryKey: symmKeys.triggerOrdersRoot });
-        queryClient.invalidateQueries({ queryKey: symmKeys.openOrdersRoot });
-      })
-    );
-    if (triggerOrdersUnsub) unsubscribers.push(triggerOrdersUnsub);
-    const executionsUnsub = asUnsubscribeFn(
-      ws.subscribeToExecutions(addr, chainId, () => {
-        queryClient.invalidateQueries({
-          queryKey: symmKeys.positionsRoot
-        });
-        queryClient.invalidateQueries({
-          queryKey: symmKeys.portfolioRoot
-        });
-      })
-    );
-    if (executionsUnsub) unsubscribers.push(executionsUnsub);
-    void ws.connect().then(() => {
-      if (cancelled) {
-        return;
+    addSubscription("trades", () => {
+      queryClient.invalidateQueries({ queryKey: symmKeys.tradeHistoryRoot });
+    });
+    addSubscription("account-summary", () => {
+      queryClient.invalidateQueries({
+        queryKey: symmKeys.balances(accountAddress, chainId)
+      });
+      queryClient.invalidateQueries({
+        queryKey: symmKeys.accountSummary(accountAddress, chainId)
+      });
+    });
+    addSubscription("notifications", () => {
+      queryClient.invalidateQueries({
+        queryKey: symmKeys.notifications({ accountAddress, chainId })
+      });
+      queryClient.invalidateQueries({
+        queryKey: symmKeys.unreadCount({ accountAddress, chainId })
+      });
+    });
+    addSubscription("tpsl", () => {
+      queryClient.invalidateQueries({ queryKey: symmKeys.tpslOrdersRoot });
+      queryClient.invalidateQueries({ queryKey: symmKeys.openOrdersRoot });
+    });
+    addSubscription("twap-orders", () => {
+      queryClient.invalidateQueries({ queryKey: symmKeys.twapOrdersRoot });
+      queryClient.invalidateQueries({ queryKey: symmKeys.openOrdersRoot });
+    });
+    addSubscription("trigger-orders", () => {
+      queryClient.invalidateQueries({ queryKey: symmKeys.triggerOrdersRoot });
+      queryClient.invalidateQueries({ queryKey: symmKeys.openOrdersRoot });
+    });
+    addSubscription("executions", () => {
+      queryClient.invalidateQueries({ queryKey: symmKeys.positionsRoot });
+      queryClient.invalidateQueries({ queryKey: symmKeys.portfolioRoot });
+    });
+    void connectShared(ws).then(() => {
+      if (cancelled) return;
+      if (ws.isConnected()) {
+        setConnected(true);
       }
     }).catch(() => {
-      if (cancelled) {
-        return;
-      }
+      if (cancelled) return;
       setConnected(false);
     });
     return () => {
       cancelled = true;
-      unsubscribers.forEach((unsubscribe) => unsubscribe());
-      ws.disconnect();
-      setConnected(false);
+      removeOnConnect();
+      removeOnDisconnect();
+      subscriptions.forEach(({ channel, handler }) => {
+        ws.unsubscribe(channel, addr, chainId, handler);
+      });
+      if (removeWsOwner(ws) === 0) {
+        ws.disconnect();
+        setConnected(false);
+      }
     };
   }, [symmCoreClient, accountAddress, chainId, queryClient, setConnected]);
   return { isConnected };
@@ -25587,7 +25640,7 @@ function useSymmBalances(params) {
   const internalEnabled = !!symmCoreClient && !!userAddress;
   return useQuery({
     ...params.query,
-    queryKey: symmKeys.balances(userAddress, chainId),
+    queryKey: symmKeys.balances(userAddress, chainId, multiAccountAddress),
     queryFn: () => symmCoreClient.accounts.getBalanceInfo({
       userAddress,
       chainId,
@@ -25596,6 +25649,242 @@ function useSymmBalances(params) {
     enabled: internalEnabled && (params.query?.enabled ?? true)
   });
 }
+
+// src/utils/account-overview.ts
+var BALANCE_INFO_KEYS = [
+  "allocatedBalance",
+  "allocated_balance",
+  "cva",
+  "lf",
+  "partyAmm",
+  "partyAMM",
+  "party_a_mm",
+  "mm",
+  "lockedPartyAMM",
+  "upnl"
+];
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function hasBalanceInfoShape(value) {
+  return isRecord(value) && BALANCE_INFO_KEYS.some((key) => key in value);
+}
+function readValue(source, keys) {
+  for (const key of keys) {
+    if (key in source) {
+      return source[key];
+    }
+  }
+  return void 0;
+}
+function toNumber(value) {
+  if (value === null || value === void 0 || value === "") {
+    return 0;
+  }
+  if (typeof value === "bigint") {
+    return Number(value);
+  }
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+function toDisplayString(value) {
+  if (Object.is(value, -0) || Math.abs(value) < Number.EPSILON) {
+    return "0";
+  }
+  return String(value);
+}
+function readNumber(source, keys) {
+  return toNumber(readValue(source, keys));
+}
+function readTimestamp(source) {
+  const timestamp = readValue(source, ["timestamp"]);
+  if (timestamp === void 0 || timestamp === null) {
+    return void 0;
+  }
+  const parsed = Number(timestamp);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function getBalanceInfoContainer(response) {
+  if (!isRecord(response)) {
+    return void 0;
+  }
+  if (hasBalanceInfoShape(response)) {
+    return response;
+  }
+  const data = response.data;
+  if (isRecord(data)) {
+    return data;
+  }
+  return response;
+}
+function getSymmAccountBalanceInfo(response, accountAddress) {
+  const container = getBalanceInfoContainer(response);
+  if (!container) {
+    return void 0;
+  }
+  if (hasBalanceInfoShape(container)) {
+    return container;
+  }
+  if (accountAddress) {
+    const normalizedAddress = accountAddress.toLowerCase();
+    const direct = container[accountAddress] ?? container[normalizedAddress];
+    if (isRecord(direct) && hasBalanceInfoShape(direct)) {
+      return direct;
+    }
+    const matchingEntry = Object.entries(container).find(
+      ([key]) => key.toLowerCase() === normalizedAddress
+    );
+    if (isRecord(matchingEntry?.[1]) && hasBalanceInfoShape(matchingEntry[1])) {
+      return matchingEntry[1];
+    }
+  }
+  const values = Object.values(container);
+  if (values.length === 1 && isRecord(values[0]) && hasBalanceInfoShape(values[0])) {
+    return values[0];
+  }
+  return void 0;
+}
+function computeSymmAccountOverview({
+  balanceInfo,
+  upnl: upnlOverride,
+  netDeposited
+}) {
+  const allocatedBalance = readNumber(balanceInfo, [
+    "allocatedBalance",
+    "allocated_balance"
+  ]);
+  const cva = readNumber(balanceInfo, ["cva", "lockedCVA", "locked_cva"]);
+  const lf = readNumber(balanceInfo, ["lf", "lockedLF", "locked_lf"]);
+  const partyAmm = readNumber(balanceInfo, [
+    "partyAmm",
+    "partyAMM",
+    "party_a_mm",
+    "mm",
+    "lockedPartyAMM",
+    "locked_party_a_mm"
+  ]);
+  const pendingCva = readNumber(balanceInfo, [
+    "pendingCva",
+    "pending_cva",
+    "pendingLockedCVA",
+    "pending_locked_cva"
+  ]);
+  const pendingLf = readNumber(balanceInfo, [
+    "pendingLf",
+    "pending_lf",
+    "pendingLockedLF",
+    "pending_locked_lf"
+  ]);
+  const pendingPartyAmm = readNumber(balanceInfo, [
+    "pendingPartyAmm",
+    "pendingPartyAMM",
+    "pending_party_a_mm",
+    "pendingMm",
+    "pending_mm",
+    "pendingLockedPartyAMM",
+    "pending_locked_party_a_mm"
+  ]);
+  const upnl = upnlOverride === void 0 ? readNumber(balanceInfo, ["upnl"]) : toNumber(upnlOverride);
+  const computedTotalLocked = cva + lf + partyAmm;
+  const totalLocked = readValue(
+    balanceInfo,
+    ["totalLocked", "total_locked"]
+  ) === void 0 ? computedTotalLocked : readNumber(balanceInfo, ["totalLocked", "total_locked"]);
+  const totalPendingLocked = readValue(balanceInfo, [
+    "totalPendingLocked",
+    "total_pending_locked"
+  ]) === void 0 ? pendingCva + pendingLf + pendingPartyAmm : readNumber(balanceInfo, ["totalPendingLocked", "total_pending_locked"]);
+  const maintenanceMargin = cva + lf;
+  const equity = allocatedBalance + upnl;
+  const availableForOrder = upnl >= 0 ? allocatedBalance + upnl - totalLocked - totalPendingLocked : allocatedBalance - cva - lf - totalPendingLocked - Math.max(Math.abs(upnl), partyAmm);
+  const availableBalance = readNumber(balanceInfo, [
+    "availableBalance",
+    "available_balance"
+  ]);
+  const notional = readNumber(balanceInfo, ["notional"]);
+  return {
+    allocatedBalance: toDisplayString(allocatedBalance),
+    upnl: toDisplayString(upnl),
+    equity: toDisplayString(equity),
+    totalAccountValue: toDisplayString(equity),
+    maintenanceMargin: toDisplayString(maintenanceMargin),
+    totalLocked: toDisplayString(totalLocked),
+    marginUsed: toDisplayString(computedTotalLocked),
+    totalPendingLocked: toDisplayString(totalPendingLocked),
+    availableForOrder: toDisplayString(availableForOrder),
+    availableMargin: toDisplayString(availableForOrder),
+    availableBalance: toDisplayString(availableBalance),
+    netDeposited: toDisplayString(toNumber(netDeposited)),
+    notional: toDisplayString(notional),
+    timestamp: readTimestamp(balanceInfo)
+  };
+}
+function computeSymmNetDeposited(totals, decimals = 6) {
+  if (!totals) {
+    return "0";
+  }
+  const deposit2 = parseRawCollateralUnits(totals.deposit);
+  const withdraw2 = parseRawCollateralUnits(totals.withdraw);
+  const value = deposit2 - withdraw2;
+  const negative = value < 0n;
+  const absolute = negative ? -value : value;
+  const scale = 10n ** BigInt(decimals);
+  const whole = absolute / scale;
+  const fraction = absolute % scale;
+  const fractionText = fraction.toString().padStart(decimals, "0").replace(/0+$/, "");
+  const amount = fractionText ? `${whole}.${fractionText}` : whole.toString();
+  return negative ? `-${amount}` : amount;
+}
+function parseRawCollateralUnits(value) {
+  if (value === null || value === void 0 || value === "") {
+    return 0n;
+  }
+  if (typeof value === "bigint") {
+    return value;
+  }
+  if (typeof value === "number") {
+    if (!Number.isSafeInteger(value)) {
+      throw new Error("Raw collateral unit numbers must be safe integers");
+    }
+    return BigInt(value);
+  }
+  if (!/^-?\d+$/.test(value)) {
+    throw new Error("Raw collateral unit strings must be base-10 integers");
+  }
+  return BigInt(value);
+}
+
+// src/react/hooks/use-symm-account-overview.ts
+function useSymmAccountOverview(params) {
+  const {
+    userAddress,
+    accountAddress,
+    multiAccountAddress,
+    upnl,
+    netDeposited
+  } = params;
+  const query = useSymmBalances({
+    userAddress,
+    multiAccountAddress,
+    chainId: params.chainId,
+    query: params.query
+  });
+  const data = useMemo(() => {
+    if (query.data === void 0) {
+      return void 0;
+    }
+    const balanceInfo = getSymmAccountBalanceInfo(
+      query.data,
+      accountAddress ?? userAddress
+    );
+    return {
+      response: query.data,
+      balanceInfo,
+      overview: balanceInfo ? computeSymmAccountOverview({ balanceInfo, upnl, netDeposited }) : void 0
+    };
+  }, [accountAddress, netDeposited, query.data, upnl, userAddress]);
+  return { ...query, data };
+}
 function useSymmOpenBasketMutation(options) {
   const { symmCoreClient } = useSymmContext();
   const queryClient = useQueryClient();
@@ -27168,6 +27457,6 @@ function getSymmErrorMessage(error) {
   return "An unexpected error occurred.";
 }
 
-export { SymmProvider, getSymmErrorMessage, symmKeys, useBinanceMarkPriceStore, useSymmAccountData, useSymmAccountSummary, useSymmAccountsApi, useSymmAccountsLength, useSymmAccountsQuery, useSymmAccountsWithPositions, useSymmAllocateCollateralMutation, useSymmApprovalQuery, useSymmApproveMutation, useSymmAuth, useSymmAvailableMargin, useSymmBalances, useSymmCancelClose, useSymmCancelOpenMutation, useSymmCancelTpslMutation, useSymmCancelTwapOrderMutation, useSymmChartCandles, useSymmChartSelection, useSymmClearTriggerConfigMutation, useSymmCloseAllPositionsMutation, useSymmCloseOrder, useSymmClosePositionMutation, useSymmContext, useSymmCoreClient, useSymmCreateAccountMutation, useSymmDeallocateCollateralMutation, useSymmDelegateAccessMutation, useSymmDelegation, useSymmDepositAndAllocateMutation, useSymmDepositMutation, useSymmEditAccountNameMutation, useSymmFunding, useSymmFundingHistory, useSymmFundingPayments, useSymmHedgerMarketById, useSymmHedgerMarketBySymbol, useSymmHedgerMarkets, useSymmInstantTradeEnsureReadyMutation, useSymmInstantTradeExecuteMutation, useSymmInternalTransferCollateralMutation, useSymmLockedParams, useSymmMarkReadNotificationMutation, useSymmMarkets, useSymmNotificationsQuery, useSymmOpenBasketMutation, useSymmOpenOrders, useSymmPendingIds, useSymmPendingInstantOpens, useSymmPerformanceOverlays, useSymmPortfolio, useSymmPositions, useSymmProposeRevokeDelegationMutation, useSymmRevokeDelegationMutation, useSymmSetTpslMutation, useSymmSetTriggerConfigMutation, useSymmSignTermsMutation, useSymmSignatureQuery, useSymmTokenMarkPrice, useSymmTokenSelectionMarkets, useSymmTokenSelectionMetadata, useSymmTpslOrders, useSymmTradeHistory, useSymmTriggerConfigQuery, useSymmTriggerOrders, useSymmTwapOrder, useSymmTwapOrdersQuery, useSymmUnreadCountQuery, useSymmUpdatePositionMutation, useSymmWithdraw, useSymmWsStore };
+export { SymmProvider, computeSymmAccountOverview, computeSymmNetDeposited, getSymmAccountBalanceInfo, getSymmErrorMessage, symmKeys, useBinanceMarkPriceStore, useSymmAccountData, useSymmAccountOverview, useSymmAccountSummary, useSymmAccountsApi, useSymmAccountsLength, useSymmAccountsQuery, useSymmAccountsWithPositions, useSymmAllocateCollateralMutation, useSymmApprovalQuery, useSymmApproveMutation, useSymmAuth, useSymmAvailableMargin, useSymmBalances, useSymmCancelClose, useSymmCancelOpenMutation, useSymmCancelTpslMutation, useSymmCancelTwapOrderMutation, useSymmChartCandles, useSymmChartSelection, useSymmClearTriggerConfigMutation, useSymmCloseAllPositionsMutation, useSymmCloseOrder, useSymmClosePositionMutation, useSymmContext, useSymmCoreClient, useSymmCreateAccountMutation, useSymmDeallocateCollateralMutation, useSymmDelegateAccessMutation, useSymmDelegation, useSymmDepositAndAllocateMutation, useSymmDepositMutation, useSymmEditAccountNameMutation, useSymmFunding, useSymmFundingHistory, useSymmFundingPayments, useSymmHedgerMarketById, useSymmHedgerMarketBySymbol, useSymmHedgerMarkets, useSymmInstantTradeEnsureReadyMutation, useSymmInstantTradeExecuteMutation, useSymmInternalTransferCollateralMutation, useSymmLockedParams, useSymmMarkReadNotificationMutation, useSymmMarkets, useSymmNotificationsQuery, useSymmOpenBasketMutation, useSymmOpenOrders, useSymmPendingIds, useSymmPendingInstantOpens, useSymmPerformanceOverlays, useSymmPortfolio, useSymmPositions, useSymmProposeRevokeDelegationMutation, useSymmRevokeDelegationMutation, useSymmSetTpslMutation, useSymmSetTriggerConfigMutation, useSymmSignTermsMutation, useSymmSignatureQuery, useSymmTokenMarkPrice, useSymmTokenSelectionMarkets, useSymmTokenSelectionMetadata, useSymmTpslOrders, useSymmTradeHistory, useSymmTriggerConfigQuery, useSymmTriggerOrders, useSymmTwapOrder, useSymmTwapOrdersQuery, useSymmUnreadCountQuery, useSymmUpdatePositionMutation, useSymmWithdraw, useSymmWsStore };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map