@metamask-previews/perps-controller 13.1.0-preview-8c2a2eeb2 → 13.1.0-preview-4f4c98e

package/dist/utils/accountUtils.cjs

@@ -1,236 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.aggregateAccountStates = exports.addSpotBalanceToAccountState = exports.getSpotHold = exports.getSpotBalance = exports.calculateWeightedReturnOnEquity = exports.getSelectedEvmAccountFromMessenger = exports.getSelectedEvmAccountDetailsFromMessenger = exports.getSelectedEvmAccount = exports.getEvmAccountFromAccountGroup = exports.findEvmAccount = void 0;
-const perpsConfig_js_1 = require("../constants/perpsConfig.cjs");
-const EVM_ACCOUNT_TYPES = new Set(['eip155:eoa', 'eip155:erc4337']);
-function isEvmAccountType(type) {
-    return EVM_ACCOUNT_TYPES.has(type);
-}
-function findEvmAccount(accounts) {
-    const evmAccount = accounts.find((account) => account && isEvmAccountType(account.type));
-    return evmAccount ?? null;
-}
-exports.findEvmAccount = findEvmAccount;
-function getEvmAccountFromAccountGroup(accounts) {
-    const evmAccount = findEvmAccount(accounts);
-    return evmAccount ? { address: evmAccount.address } : undefined;
-}
-exports.getEvmAccountFromAccountGroup = getEvmAccountFromAccountGroup;
-function getSelectedEvmAccount(accounts) {
-    return getEvmAccountFromAccountGroup(accounts);
-}
-exports.getSelectedEvmAccount = getSelectedEvmAccount;
-function isAccountLike(value) {
-    const account = value;
-    return (typeof value === 'object' &&
-        value !== null &&
-        typeof account?.address === 'string' &&
-        typeof account.type === 'string');
-}
-function getSelectedEvmAccountDetailsFromMessenger(messenger) {
-    try {
-        const selectedAccount = messenger.call('AccountsController:getSelectedAccount');
-        if (isAccountLike(selectedAccount)) {
-            const evmAccount = findEvmAccount([selectedAccount]);
-            if (evmAccount) {
-                return evmAccount;
-            }
-        }
-    }
-    catch {
-        // Fall back to the selected account group if the direct lookup is unavailable.
-    }
-    try {
-        const selectedAccountGroup = messenger.call('AccountTreeController:getAccountsFromSelectedAccountGroup');
-        return Array.isArray(selectedAccountGroup)
-            ? (findEvmAccount(selectedAccountGroup.filter(isAccountLike)) ??
-                undefined)
-            : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-exports.getSelectedEvmAccountDetailsFromMessenger = getSelectedEvmAccountDetailsFromMessenger;
-function getSelectedEvmAccountFromMessenger(messenger) {
-    const evmAccount = getSelectedEvmAccountDetailsFromMessenger(messenger);
-    return evmAccount ? { address: evmAccount.address } : undefined;
-}
-exports.getSelectedEvmAccountFromMessenger = getSelectedEvmAccountFromMessenger;
-function calculateWeightedReturnOnEquity(accounts) {
-    if (accounts.length === 0) {
-        return '0';
-    }
-    let totalWeightedROE = 0;
-    let totalMarginUsed = 0;
-    for (const account of accounts) {
-        const unrealizedPnl = typeof account.unrealizedPnl === 'string'
-            ? Number.parseFloat(account.unrealizedPnl)
-            : account.unrealizedPnl;
-        const returnOnEquity = typeof account.returnOnEquity === 'string'
-            ? Number.parseFloat(account.returnOnEquity)
-            : account.returnOnEquity;
-        if (Number.isNaN(unrealizedPnl) || Number.isNaN(returnOnEquity)) {
-            continue;
-        }
-        if (returnOnEquity === 0) {
-            continue;
-        }
-        const marginUsed = (unrealizedPnl / returnOnEquity) * 100;
-        if (Number.isNaN(marginUsed) || marginUsed <= 0) {
-            continue;
-        }
-        const roeDecimal = returnOnEquity / 100;
-        totalWeightedROE += roeDecimal * marginUsed;
-        totalMarginUsed += marginUsed;
-    }
-    if (totalMarginUsed <= 0) {
-        return '0';
-    }
-    const weightedROE = (totalWeightedROE / totalMarginUsed) * 100;
-    return weightedROE.toString();
-}
-exports.calculateWeightedReturnOnEquity = calculateWeightedReturnOnEquity;
-// The release-branch balance bridge is USDC-only. Non-USDC spot assets must
-// not inflate the balances shown or validated by withdraw/payment flows.
-const SPOT_COLLATERAL_COINS = new Set(['USDC']);
-function getSpotBalance(spotState) {
-    if (!spotState?.balances || !Array.isArray(spotState.balances)) {
-        return 0;
-    }
-    return spotState.balances.reduce((sum, balance) => {
-        if (!balance.coin || !SPOT_COLLATERAL_COINS.has(balance.coin)) {
-            return sum;
-        }
-        const value = parseFloat(balance.total ?? '0');
-        return Number.isFinite(value) ? sum + value : sum;
-    }, 0);
-}
-exports.getSpotBalance = getSpotBalance;
-function getSpotHold(spotState) {
-    if (!spotState?.balances || !Array.isArray(spotState.balances)) {
-        return 0;
-    }
-    return spotState.balances.reduce((sum, balance) => {
-        if (!balance.coin || !SPOT_COLLATERAL_COINS.has(balance.coin)) {
-            return sum;
-        }
-        const value = parseFloat(balance.hold ?? '0');
-        return Number.isFinite(value) ? sum + value : sum;
-    }, 0);
-}
-exports.getSpotHold = getSpotHold;
-/**
- * Add spot USDC to the AccountState contract. Caller decides whether the
- * spot balance counts as perps collateral via `options.foldIntoCollateral`
- * — the util stays provider-agnostic.
- *
- * @param accountState - Base AccountState produced by a provider adapter.
- * @param spotState - Raw spot clearinghouse response (HL-shaped); null or missing means no spot balance and the state is returned unchanged.
- * @param options - See {@link AddSpotBalanceOptions}.
- * @returns AccountState with spot folded into `totalBalance` always, and into spendable/withdrawable when `foldIntoCollateral` is true.
- */
-function addSpotBalanceToAccountState(accountState, spotState, options) {
-    // Fail-closed default: align with `hyperLiquidModeFoldsSpot(null) → false`.
-    // A caller that omits `options` should NOT silently fold spot — that would
-    // over-report withdrawable funds for Standard / dexAbstraction users.
-    const foldIntoCollateral = options?.foldIntoCollateral ?? false;
-    const spotBalance = getSpotBalance(spotState);
-    const spotHold = getSpotHold(spotState);
-    const freeSpot = Math.max(0, spotBalance - spotHold);
-    const currentTotal = parseFloat(accountState.totalBalance);
-    const currentSpendable = parseFloat(accountState.spendableBalance);
-    const currentWithdrawable = parseFloat(accountState.withdrawableBalance);
-    // Preserve sentinel totals (e.g. PERPS_CONSTANTS.FallbackDataDisplay '--')
-    // rather than coercing them to NaN.
-    if (!Number.isFinite(currentTotal)) {
-        return accountState;
-    }
-    if (spotBalance === 0) {
-        // No spot wealth means no hold either in the HL payload shape, so the
-        // later totalBalance adjustment would also be a no-op.
-        return accountState;
-    }
-    // Folding is gated strictly on the resolved abstraction mode (see callers'
-    // `foldIntoCollateral` argument). Standard / DEX-abstraction users keep
-    // perps and spot independent, so spot must NOT surface as a perps-
-    // withdrawable balance for them — withdraw3 only draws from the perps
-    // ledger in those modes. Unified / portfolio-margin users get the fold;
-    // live callers fail-CLOSED via `hyperLiquidModeFoldsSpot` when mode is
-    // unresolved.
-    const nextSpendable = resolveFoldedBalance(currentSpendable, accountState.spendableBalance, freeSpot, foldIntoCollateral);
-    const nextWithdrawable = resolveFoldedBalance(currentWithdrawable, accountState.withdrawableBalance, freeSpot, foldIntoCollateral);
-    // Total always reflects combined wealth: subtract spotHold to avoid
-    // double-counting on Unified/PM accounts where marginSummary.accountValue
-    // already includes the margin that HL surfaces via spot.hold. Standard
-    // mode has spotHold = 0 by construction, so the subtraction is a no-op.
-    const nextTotal = currentTotal + spotBalance - spotHold;
-    return {
-        ...accountState,
-        totalBalance: nextTotal.toString(),
-        spendableBalance: nextSpendable,
-        withdrawableBalance: nextWithdrawable,
-    };
-}
-exports.addSpotBalanceToAccountState = addSpotBalanceToAccountState;
-function resolveFoldedBalance(currentNumeric, currentRaw, freeSpot, foldIntoCollateral) {
-    if (!foldIntoCollateral) {
-        return currentRaw;
-    }
-    if (Number.isFinite(currentNumeric)) {
-        return (currentNumeric + freeSpot).toString();
-    }
-    // Non-finite currentNumeric means the adapter passed a sentinel like
-    // `PERPS_CONSTANTS.FallbackDataDisplay` ("--") during loading. Preserve
-    // the sentinel rather than synthesising a numeric fold; the caller's
-    // UI treats "--" as "loading" and would otherwise show a misleading
-    // spot-only figure while the per-DEX perps fetch is still in flight.
-    return currentRaw;
-}
-/**
- * Aggregate multiple per-DEX AccountState objects into one by summing numeric fields.
- * ROE is recalculated as (totalUnrealizedPnl / totalMarginUsed) * 100.
- *
- * @param states - The array of per-DEX account states to aggregate.
- * @returns The combined account state with summed balances and recalculated ROE.
- */
-function aggregateAccountStates(states) {
-    const fallback = {
-        spendableBalance: perpsConfig_js_1.PERPS_CONSTANTS.FallbackDataDisplay,
-        withdrawableBalance: perpsConfig_js_1.PERPS_CONSTANTS.FallbackDataDisplay,
-        totalBalance: perpsConfig_js_1.PERPS_CONSTANTS.FallbackDataDisplay,
-        marginUsed: perpsConfig_js_1.PERPS_CONSTANTS.FallbackDataDisplay,
-        unrealizedPnl: perpsConfig_js_1.PERPS_CONSTANTS.FallbackDataDisplay,
-        returnOnEquity: perpsConfig_js_1.PERPS_CONSTANTS.FallbackDataDisplay,
-    };
-    if (states.length === 0) {
-        return fallback;
-    }
-    const aggregated = states.reduce((acc, state, index) => {
-        if (index === 0) {
-            return { ...state };
-        }
-        return {
-            spendableBalance: (parseFloat(acc.spendableBalance) + parseFloat(state.spendableBalance)).toString(),
-            withdrawableBalance: (parseFloat(acc.withdrawableBalance) +
-                parseFloat(state.withdrawableBalance)).toString(),
-            totalBalance: (parseFloat(acc.totalBalance) + parseFloat(state.totalBalance)).toString(),
-            marginUsed: (parseFloat(acc.marginUsed) + parseFloat(state.marginUsed)).toString(),
-            unrealizedPnl: (parseFloat(acc.unrealizedPnl) + parseFloat(state.unrealizedPnl)).toString(),
-            returnOnEquity: '0',
-        };
-    }, fallback);
-    // Recalculate ROE across all DEXs
-    const totalMarginUsed = parseFloat(aggregated.marginUsed);
-    const totalUnrealizedPnl = parseFloat(aggregated.unrealizedPnl);
-    if (totalMarginUsed > 0) {
-        aggregated.returnOnEquity = ((totalUnrealizedPnl / totalMarginUsed) *
-            100).toString();
-    }
-    else {
-        aggregated.returnOnEquity = '0';
-    }
-    return aggregated;
-}
-exports.aggregateAccountStates = aggregateAccountStates;
-//# sourceMappingURL=accountUtils.cjs.map

package/dist/utils/accountUtils.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"accountUtils.cjs","sourceRoot":"","sources":["../../src/utils/accountUtils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Account utilities for Perps components\n * Handles account selection and EVM account filtering\n */\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport type { SpotClearinghouseStateResponse } from '../types/hyperliquid-types.js';\nimport type { AccountState, PerpsInternalAccount } from '../types/index.js';\n\nconst EVM_ACCOUNT_TYPES = new Set(['eip155:eoa', 'eip155:erc4337']);\n\nfunction isEvmAccountType(type: string): boolean {\n  return EVM_ACCOUNT_TYPES.has(type);\n}\n\nexport function findEvmAccount(\n  accounts: (InternalAccount | PerpsInternalAccount)[],\n): InternalAccount | PerpsInternalAccount | null {\n  const evmAccount = accounts.find(\n    (account) =>\n      account && isEvmAccountType(account.type as InternalAccount['type']),\n  );\n  return evmAccount ?? null;\n}\n\nexport function getEvmAccountFromAccountGroup(\n  accounts: (InternalAccount | PerpsInternalAccount)[],\n): { address: string } | undefined {\n  const evmAccount = findEvmAccount(accounts);\n  return evmAccount ? { address: evmAccount.address } : undefined;\n}\n\nexport function getSelectedEvmAccount(\n  accounts: (InternalAccount | PerpsInternalAccount)[],\n): { address: string } | undefined {\n  return getEvmAccountFromAccountGroup(accounts);\n}\n\ntype SelectedEvmAccountMessenger = {\n  call(\n    actionType:\n      | 'AccountsController:getSelectedAccount'\n      | 'AccountTreeController:getAccountsFromSelectedAccountGroup',\n  ): unknown;\n};\n\nfunction isAccountLike(\n  value: unknown,\n): value is InternalAccount | PerpsInternalAccount {\n  const account = value as { address?: unknown; type?: unknown } | null;\n\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof account?.address === 'string' &&\n    typeof account.type === 'string'\n  );\n}\n\nexport function getSelectedEvmAccountDetailsFromMessenger(\n  messenger: SelectedEvmAccountMessenger,\n): InternalAccount | PerpsInternalAccount | undefined {\n  try {\n    const selectedAccount = messenger.call(\n      'AccountsController:getSelectedAccount',\n    );\n    if (isAccountLike(selectedAccount)) {\n      const evmAccount = findEvmAccount([selectedAccount]);\n      if (evmAccount) {\n        return evmAccount;\n      }\n    }\n  } catch {\n    // Fall back to the selected account group if the direct lookup is unavailable.\n  }\n\n  try {\n    const selectedAccountGroup = messenger.call(\n      'AccountTreeController:getAccountsFromSelectedAccountGroup',\n    );\n    return Array.isArray(selectedAccountGroup)\n      ? (findEvmAccount(selectedAccountGroup.filter(isAccountLike)) ??\n          undefined)\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function getSelectedEvmAccountFromMessenger(\n  messenger: SelectedEvmAccountMessenger,\n): { address: string } | undefined {\n  const evmAccount = getSelectedEvmAccountDetailsFromMessenger(messenger);\n\n  return evmAccount ? { address: evmAccount.address } : undefined;\n}\n\nexport type ReturnOnEquityInput = {\n  unrealizedPnl: string | number;\n  returnOnEquity: string | number;\n};\n\nexport function calculateWeightedReturnOnEquity(\n  accounts: ReturnOnEquityInput[],\n): string {\n  if (accounts.length === 0) {\n    return '0';\n  }\n\n  let totalWeightedROE = 0;\n  let totalMarginUsed = 0;\n\n  for (const account of accounts) {\n    const unrealizedPnl =\n      typeof account.unrealizedPnl === 'string'\n        ? Number.parseFloat(account.unrealizedPnl)\n        : account.unrealizedPnl;\n    const returnOnEquity =\n      typeof account.returnOnEquity === 'string'\n        ? Number.parseFloat(account.returnOnEquity)\n        : account.returnOnEquity;\n\n    if (Number.isNaN(unrealizedPnl) || Number.isNaN(returnOnEquity)) {\n      continue;\n    }\n\n    if (returnOnEquity === 0) {\n      continue;\n    }\n\n    const marginUsed = (unrealizedPnl / returnOnEquity) * 100;\n\n    if (Number.isNaN(marginUsed) || marginUsed <= 0) {\n      continue;\n    }\n\n    const roeDecimal = returnOnEquity / 100;\n\n    totalWeightedROE += roeDecimal * marginUsed;\n    totalMarginUsed += marginUsed;\n  }\n\n  if (totalMarginUsed <= 0) {\n    return '0';\n  }\n\n  const weightedROE = (totalWeightedROE / totalMarginUsed) * 100;\n  return weightedROE.toString();\n}\n\n// The release-branch balance bridge is USDC-only. Non-USDC spot assets must\n// not inflate the balances shown or validated by withdraw/payment flows.\nconst SPOT_COLLATERAL_COINS = new Set<string>(['USDC']);\n\nexport function getSpotBalance(\n  spotState?: SpotClearinghouseStateResponse | null,\n): number {\n  if (!spotState?.balances || !Array.isArray(spotState.balances)) {\n    return 0;\n  }\n\n  return spotState.balances.reduce(\n    (sum: number, balance: { coin?: string; total?: string }) => {\n      if (!balance.coin || !SPOT_COLLATERAL_COINS.has(balance.coin)) {\n        return sum;\n      }\n      const value = parseFloat(balance.total ?? '0');\n      return Number.isFinite(value) ? sum + value : sum;\n    },\n    0,\n  );\n}\n\nexport function getSpotHold(\n  spotState?: SpotClearinghouseStateResponse | null,\n): number {\n  if (!spotState?.balances || !Array.isArray(spotState.balances)) {\n    return 0;\n  }\n\n  return spotState.balances.reduce(\n    (sum: number, balance: { coin?: string; hold?: string }) => {\n      if (!balance.coin || !SPOT_COLLATERAL_COINS.has(balance.coin)) {\n        return sum;\n      }\n      const value = parseFloat(balance.hold ?? '0');\n      return Number.isFinite(value) ? sum + value : sum;\n    },\n    0,\n  );\n}\n\n/**\n * Options controlling how `addSpotBalanceToAccountState` folds spot balance\n * into the three-field AccountState contract.\n */\nexport type AddSpotBalanceOptions = {\n  /**\n   * When `true`, free spot USDC contributes to both `spendableBalance` and\n   * `withdrawableBalance` in addition to `totalBalance` — appropriate for\n   * venues where spot is automatically used as perps collateral (e.g.\n   * HyperLiquid Unified/Portfolio mode, where `withdraw3` draws from the\n   * unified ledger).\n   *\n   * When `false`, free spot contributes to `totalBalance` only; spendable\n   * and withdrawable stay perps-only — appropriate for venues where spot\n   * is a separate ledger the backend cannot auto-draw from (e.g. HL\n   * Standard mode). The caller is responsible for translating\n   * provider-specific state into this flag.\n   *\n   * Defaults to `true` for backward compatibility with call sites that\n   * haven't yet been wired with provider-specific context.\n   */\n  foldIntoCollateral?: boolean;\n};\n\n/**\n * Add spot USDC to the AccountState contract. Caller decides whether the\n * spot balance counts as perps collateral via `options.foldIntoCollateral`\n * — the util stays provider-agnostic.\n *\n * @param accountState - Base AccountState produced by a provider adapter.\n * @param spotState - Raw spot clearinghouse response (HL-shaped); null or missing means no spot balance and the state is returned unchanged.\n * @param options - See {@link AddSpotBalanceOptions}.\n * @returns AccountState with spot folded into `totalBalance` always, and into spendable/withdrawable when `foldIntoCollateral` is true.\n */\nexport function addSpotBalanceToAccountState(\n  accountState: AccountState,\n  spotState?: SpotClearinghouseStateResponse | null,\n  options?: AddSpotBalanceOptions,\n): AccountState {\n  // Fail-closed default: align with `hyperLiquidModeFoldsSpot(null) → false`.\n  // A caller that omits `options` should NOT silently fold spot — that would\n  // over-report withdrawable funds for Standard / dexAbstraction users.\n  const foldIntoCollateral = options?.foldIntoCollateral ?? false;\n\n  const spotBalance = getSpotBalance(spotState);\n  const spotHold = getSpotHold(spotState);\n  const freeSpot = Math.max(0, spotBalance - spotHold);\n\n  const currentTotal = parseFloat(accountState.totalBalance);\n  const currentSpendable = parseFloat(accountState.spendableBalance);\n  const currentWithdrawable = parseFloat(accountState.withdrawableBalance);\n\n  // Preserve sentinel totals (e.g. PERPS_CONSTANTS.FallbackDataDisplay '--')\n  // rather than coercing them to NaN.\n  if (!Number.isFinite(currentTotal)) {\n    return accountState;\n  }\n\n  if (spotBalance === 0) {\n    // No spot wealth means no hold either in the HL payload shape, so the\n    // later totalBalance adjustment would also be a no-op.\n    return accountState;\n  }\n\n  // Folding is gated strictly on the resolved abstraction mode (see callers'\n  // `foldIntoCollateral` argument). Standard / DEX-abstraction users keep\n  // perps and spot independent, so spot must NOT surface as a perps-\n  // withdrawable balance for them — withdraw3 only draws from the perps\n  // ledger in those modes. Unified / portfolio-margin users get the fold;\n  // live callers fail-CLOSED via `hyperLiquidModeFoldsSpot` when mode is\n  // unresolved.\n  const nextSpendable = resolveFoldedBalance(\n    currentSpendable,\n    accountState.spendableBalance,\n    freeSpot,\n    foldIntoCollateral,\n  );\n  const nextWithdrawable = resolveFoldedBalance(\n    currentWithdrawable,\n    accountState.withdrawableBalance,\n    freeSpot,\n    foldIntoCollateral,\n  );\n\n  // Total always reflects combined wealth: subtract spotHold to avoid\n  // double-counting on Unified/PM accounts where marginSummary.accountValue\n  // already includes the margin that HL surfaces via spot.hold. Standard\n  // mode has spotHold = 0 by construction, so the subtraction is a no-op.\n  const nextTotal = currentTotal + spotBalance - spotHold;\n\n  return {\n    ...accountState,\n    totalBalance: nextTotal.toString(),\n    spendableBalance: nextSpendable,\n    withdrawableBalance: nextWithdrawable,\n  };\n}\n\nfunction resolveFoldedBalance(\n  currentNumeric: number,\n  currentRaw: string,\n  freeSpot: number,\n  foldIntoCollateral: boolean,\n): string {\n  if (!foldIntoCollateral) {\n    return currentRaw;\n  }\n  if (Number.isFinite(currentNumeric)) {\n    return (currentNumeric + freeSpot).toString();\n  }\n  // Non-finite currentNumeric means the adapter passed a sentinel like\n  // `PERPS_CONSTANTS.FallbackDataDisplay` (\"--\") during loading. Preserve\n  // the sentinel rather than synthesising a numeric fold; the caller's\n  // UI treats \"--\" as \"loading\" and would otherwise show a misleading\n  // spot-only figure while the per-DEX perps fetch is still in flight.\n  return currentRaw;\n}\n\n/**\n * Aggregate multiple per-DEX AccountState objects into one by summing numeric fields.\n * ROE is recalculated as (totalUnrealizedPnl / totalMarginUsed) * 100.\n *\n * @param states - The array of per-DEX account states to aggregate.\n * @returns The combined account state with summed balances and recalculated ROE.\n */\nexport function aggregateAccountStates(states: AccountState[]): AccountState {\n  const fallback: AccountState = {\n    spendableBalance: PERPS_CONSTANTS.FallbackDataDisplay,\n    withdrawableBalance: PERPS_CONSTANTS.FallbackDataDisplay,\n    totalBalance: PERPS_CONSTANTS.FallbackDataDisplay,\n    marginUsed: PERPS_CONSTANTS.FallbackDataDisplay,\n    unrealizedPnl: PERPS_CONSTANTS.FallbackDataDisplay,\n    returnOnEquity: PERPS_CONSTANTS.FallbackDataDisplay,\n  };\n\n  if (states.length === 0) {\n    return fallback;\n  }\n\n  const aggregated = states.reduce<AccountState>((acc, state, index) => {\n    if (index === 0) {\n      return { ...state };\n    }\n\n    return {\n      spendableBalance: (\n        parseFloat(acc.spendableBalance) + parseFloat(state.spendableBalance)\n      ).toString(),\n      withdrawableBalance: (\n        parseFloat(acc.withdrawableBalance) +\n        parseFloat(state.withdrawableBalance)\n      ).toString(),\n      totalBalance: (\n        parseFloat(acc.totalBalance) + parseFloat(state.totalBalance)\n      ).toString(),\n      marginUsed: (\n        parseFloat(acc.marginUsed) + parseFloat(state.marginUsed)\n      ).toString(),\n      unrealizedPnl: (\n        parseFloat(acc.unrealizedPnl) + parseFloat(state.unrealizedPnl)\n      ).toString(),\n      returnOnEquity: '0',\n    };\n  }, fallback);\n\n  // Recalculate ROE across all DEXs\n  const totalMarginUsed = parseFloat(aggregated.marginUsed);\n  const totalUnrealizedPnl = parseFloat(aggregated.unrealizedPnl);\n  if (totalMarginUsed > 0) {\n    aggregated.returnOnEquity = (\n      (totalUnrealizedPnl / totalMarginUsed) *\n      100\n    ).toString();\n  } else {\n    aggregated.returnOnEquity = '0';\n  }\n\n  return aggregated;\n}\n"]}

package/dist/utils/accountUtils.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"accountUtils.d.cts","sourceRoot":"","sources":["../../src/utils/accountUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AAGtE,OAAO,KAAK,EAAE,8BAA8B,EAAE,uCAAsC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,2BAA0B;AAQ5E,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,CAAC,eAAe,GAAG,oBAAoB,CAAC,EAAE,GACnD,eAAe,GAAG,oBAAoB,GAAG,IAAI,CAM/C;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,CAAC,eAAe,GAAG,oBAAoB,CAAC,EAAE,GACnD;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAGjC;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,CAAC,eAAe,GAAG,oBAAoB,CAAC,EAAE,GACnD;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAEjC;AAED,KAAK,2BAA2B,GAAG;IACjC,IAAI,CACF,UAAU,EACN,uCAAuC,GACvC,2DAA2D,GAC9D,OAAO,CAAC;CACZ,CAAC;AAeF,wBAAgB,yCAAyC,CACvD,SAAS,EAAE,2BAA2B,GACrC,eAAe,GAAG,oBAAoB,GAAG,SAAS,CA0BpD;AAED,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,2BAA2B,GACrC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIjC;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC,CAAC;AAEF,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,MAAM,CA4CR;AAMD,wBAAgB,cAAc,CAC5B,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,GAChD,MAAM,CAeR;AAED,wBAAgB,WAAW,CACzB,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,GAChD,MAAM,CAeR;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,EACjD,OAAO,CAAC,EAAE,qBAAqB,GAC9B,YAAY,CA0Dd;AAsBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAqD3E"}

package/dist/utils/accountUtils.d.mts

@@ -1,72 +0,0 @@
-/**
- * Account utilities for Perps components
- * Handles account selection and EVM account filtering
- */
-import type { InternalAccount } from "@metamask/keyring-internal-api";
-import type { SpotClearinghouseStateResponse } from "../types/hyperliquid-types.mjs";
-import type { AccountState, PerpsInternalAccount } from "../types/index.mjs";
-export declare function findEvmAccount(accounts: (InternalAccount | PerpsInternalAccount)[]): InternalAccount | PerpsInternalAccount | null;
-export declare function getEvmAccountFromAccountGroup(accounts: (InternalAccount | PerpsInternalAccount)[]): {
-    address: string;
-} | undefined;
-export declare function getSelectedEvmAccount(accounts: (InternalAccount | PerpsInternalAccount)[]): {
-    address: string;
-} | undefined;
-type SelectedEvmAccountMessenger = {
-    call(actionType: 'AccountsController:getSelectedAccount' | 'AccountTreeController:getAccountsFromSelectedAccountGroup'): unknown;
-};
-export declare function getSelectedEvmAccountDetailsFromMessenger(messenger: SelectedEvmAccountMessenger): InternalAccount | PerpsInternalAccount | undefined;
-export declare function getSelectedEvmAccountFromMessenger(messenger: SelectedEvmAccountMessenger): {
-    address: string;
-} | undefined;
-export type ReturnOnEquityInput = {
-    unrealizedPnl: string | number;
-    returnOnEquity: string | number;
-};
-export declare function calculateWeightedReturnOnEquity(accounts: ReturnOnEquityInput[]): string;
-export declare function getSpotBalance(spotState?: SpotClearinghouseStateResponse | null): number;
-export declare function getSpotHold(spotState?: SpotClearinghouseStateResponse | null): number;
-/**
- * Options controlling how `addSpotBalanceToAccountState` folds spot balance
- * into the three-field AccountState contract.
- */
-export type AddSpotBalanceOptions = {
-    /**
-     * When `true`, free spot USDC contributes to both `spendableBalance` and
-     * `withdrawableBalance` in addition to `totalBalance` — appropriate for
-     * venues where spot is automatically used as perps collateral (e.g.
-     * HyperLiquid Unified/Portfolio mode, where `withdraw3` draws from the
-     * unified ledger).
-     *
-     * When `false`, free spot contributes to `totalBalance` only; spendable
-     * and withdrawable stay perps-only — appropriate for venues where spot
-     * is a separate ledger the backend cannot auto-draw from (e.g. HL
-     * Standard mode). The caller is responsible for translating
-     * provider-specific state into this flag.
-     *
-     * Defaults to `true` for backward compatibility with call sites that
-     * haven't yet been wired with provider-specific context.
-     */
-    foldIntoCollateral?: boolean;
-};
-/**
- * Add spot USDC to the AccountState contract. Caller decides whether the
- * spot balance counts as perps collateral via `options.foldIntoCollateral`
- * — the util stays provider-agnostic.
- *
- * @param accountState - Base AccountState produced by a provider adapter.
- * @param spotState - Raw spot clearinghouse response (HL-shaped); null or missing means no spot balance and the state is returned unchanged.
- * @param options - See {@link AddSpotBalanceOptions}.
- * @returns AccountState with spot folded into `totalBalance` always, and into spendable/withdrawable when `foldIntoCollateral` is true.
- */
-export declare function addSpotBalanceToAccountState(accountState: AccountState, spotState?: SpotClearinghouseStateResponse | null, options?: AddSpotBalanceOptions): AccountState;
-/**
- * Aggregate multiple per-DEX AccountState objects into one by summing numeric fields.
- * ROE is recalculated as (totalUnrealizedPnl / totalMarginUsed) * 100.
- *
- * @param states - The array of per-DEX account states to aggregate.
- * @returns The combined account state with summed balances and recalculated ROE.
- */
-export declare function aggregateAccountStates(states: AccountState[]): AccountState;
-export {};
-//# sourceMappingURL=accountUtils.d.mts.map

package/dist/utils/accountUtils.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"accountUtils.d.mts","sourceRoot":"","sources":["../../src/utils/accountUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AAGtE,OAAO,KAAK,EAAE,8BAA8B,EAAE,uCAAsC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,2BAA0B;AAQ5E,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,CAAC,eAAe,GAAG,oBAAoB,CAAC,EAAE,GACnD,eAAe,GAAG,oBAAoB,GAAG,IAAI,CAM/C;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,CAAC,eAAe,GAAG,oBAAoB,CAAC,EAAE,GACnD;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAGjC;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,CAAC,eAAe,GAAG,oBAAoB,CAAC,EAAE,GACnD;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAEjC;AAED,KAAK,2BAA2B,GAAG;IACjC,IAAI,CACF,UAAU,EACN,uCAAuC,GACvC,2DAA2D,GAC9D,OAAO,CAAC;CACZ,CAAC;AAeF,wBAAgB,yCAAyC,CACvD,SAAS,EAAE,2BAA2B,GACrC,eAAe,GAAG,oBAAoB,GAAG,SAAS,CA0BpD;AAED,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,2BAA2B,GACrC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIjC;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC,CAAC;AAEF,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,MAAM,CA4CR;AAMD,wBAAgB,cAAc,CAC5B,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,GAChD,MAAM,CAeR;AAED,wBAAgB,WAAW,CACzB,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,GAChD,MAAM,CAeR;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,EACjD,OAAO,CAAC,EAAE,qBAAqB,GAC9B,YAAY,CA0Dd;AAsBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAqD3E"}

package/dist/utils/accountUtils.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"accountUtils.mjs","sourceRoot":"","sources":["../../src/utils/accountUtils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Account utilities for Perps components\n * Handles account selection and EVM account filtering\n */\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport type { SpotClearinghouseStateResponse } from '../types/hyperliquid-types.js';\nimport type { AccountState, PerpsInternalAccount } from '../types/index.js';\n\nconst EVM_ACCOUNT_TYPES = new Set(['eip155:eoa', 'eip155:erc4337']);\n\nfunction isEvmAccountType(type: string): boolean {\n  return EVM_ACCOUNT_TYPES.has(type);\n}\n\nexport function findEvmAccount(\n  accounts: (InternalAccount | PerpsInternalAccount)[],\n): InternalAccount | PerpsInternalAccount | null {\n  const evmAccount = accounts.find(\n    (account) =>\n      account && isEvmAccountType(account.type as InternalAccount['type']),\n  );\n  return evmAccount ?? null;\n}\n\nexport function getEvmAccountFromAccountGroup(\n  accounts: (InternalAccount | PerpsInternalAccount)[],\n): { address: string } | undefined {\n  const evmAccount = findEvmAccount(accounts);\n  return evmAccount ? { address: evmAccount.address } : undefined;\n}\n\nexport function getSelectedEvmAccount(\n  accounts: (InternalAccount | PerpsInternalAccount)[],\n): { address: string } | undefined {\n  return getEvmAccountFromAccountGroup(accounts);\n}\n\ntype SelectedEvmAccountMessenger = {\n  call(\n    actionType:\n      | 'AccountsController:getSelectedAccount'\n      | 'AccountTreeController:getAccountsFromSelectedAccountGroup',\n  ): unknown;\n};\n\nfunction isAccountLike(\n  value: unknown,\n): value is InternalAccount | PerpsInternalAccount {\n  const account = value as { address?: unknown; type?: unknown } | null;\n\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof account?.address === 'string' &&\n    typeof account.type === 'string'\n  );\n}\n\nexport function getSelectedEvmAccountDetailsFromMessenger(\n  messenger: SelectedEvmAccountMessenger,\n): InternalAccount | PerpsInternalAccount | undefined {\n  try {\n    const selectedAccount = messenger.call(\n      'AccountsController:getSelectedAccount',\n    );\n    if (isAccountLike(selectedAccount)) {\n      const evmAccount = findEvmAccount([selectedAccount]);\n      if (evmAccount) {\n        return evmAccount;\n      }\n    }\n  } catch {\n    // Fall back to the selected account group if the direct lookup is unavailable.\n  }\n\n  try {\n    const selectedAccountGroup = messenger.call(\n      'AccountTreeController:getAccountsFromSelectedAccountGroup',\n    );\n    return Array.isArray(selectedAccountGroup)\n      ? (findEvmAccount(selectedAccountGroup.filter(isAccountLike)) ??\n          undefined)\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function getSelectedEvmAccountFromMessenger(\n  messenger: SelectedEvmAccountMessenger,\n): { address: string } | undefined {\n  const evmAccount = getSelectedEvmAccountDetailsFromMessenger(messenger);\n\n  return evmAccount ? { address: evmAccount.address } : undefined;\n}\n\nexport type ReturnOnEquityInput = {\n  unrealizedPnl: string | number;\n  returnOnEquity: string | number;\n};\n\nexport function calculateWeightedReturnOnEquity(\n  accounts: ReturnOnEquityInput[],\n): string {\n  if (accounts.length === 0) {\n    return '0';\n  }\n\n  let totalWeightedROE = 0;\n  let totalMarginUsed = 0;\n\n  for (const account of accounts) {\n    const unrealizedPnl =\n      typeof account.unrealizedPnl === 'string'\n        ? Number.parseFloat(account.unrealizedPnl)\n        : account.unrealizedPnl;\n    const returnOnEquity =\n      typeof account.returnOnEquity === 'string'\n        ? Number.parseFloat(account.returnOnEquity)\n        : account.returnOnEquity;\n\n    if (Number.isNaN(unrealizedPnl) || Number.isNaN(returnOnEquity)) {\n      continue;\n    }\n\n    if (returnOnEquity === 0) {\n      continue;\n    }\n\n    const marginUsed = (unrealizedPnl / returnOnEquity) * 100;\n\n    if (Number.isNaN(marginUsed) || marginUsed <= 0) {\n      continue;\n    }\n\n    const roeDecimal = returnOnEquity / 100;\n\n    totalWeightedROE += roeDecimal * marginUsed;\n    totalMarginUsed += marginUsed;\n  }\n\n  if (totalMarginUsed <= 0) {\n    return '0';\n  }\n\n  const weightedROE = (totalWeightedROE / totalMarginUsed) * 100;\n  return weightedROE.toString();\n}\n\n// The release-branch balance bridge is USDC-only. Non-USDC spot assets must\n// not inflate the balances shown or validated by withdraw/payment flows.\nconst SPOT_COLLATERAL_COINS = new Set<string>(['USDC']);\n\nexport function getSpotBalance(\n  spotState?: SpotClearinghouseStateResponse | null,\n): number {\n  if (!spotState?.balances || !Array.isArray(spotState.balances)) {\n    return 0;\n  }\n\n  return spotState.balances.reduce(\n    (sum: number, balance: { coin?: string; total?: string }) => {\n      if (!balance.coin || !SPOT_COLLATERAL_COINS.has(balance.coin)) {\n        return sum;\n      }\n      const value = parseFloat(balance.total ?? '0');\n      return Number.isFinite(value) ? sum + value : sum;\n    },\n    0,\n  );\n}\n\nexport function getSpotHold(\n  spotState?: SpotClearinghouseStateResponse | null,\n): number {\n  if (!spotState?.balances || !Array.isArray(spotState.balances)) {\n    return 0;\n  }\n\n  return spotState.balances.reduce(\n    (sum: number, balance: { coin?: string; hold?: string }) => {\n      if (!balance.coin || !SPOT_COLLATERAL_COINS.has(balance.coin)) {\n        return sum;\n      }\n      const value = parseFloat(balance.hold ?? '0');\n      return Number.isFinite(value) ? sum + value : sum;\n    },\n    0,\n  );\n}\n\n/**\n * Options controlling how `addSpotBalanceToAccountState` folds spot balance\n * into the three-field AccountState contract.\n */\nexport type AddSpotBalanceOptions = {\n  /**\n   * When `true`, free spot USDC contributes to both `spendableBalance` and\n   * `withdrawableBalance` in addition to `totalBalance` — appropriate for\n   * venues where spot is automatically used as perps collateral (e.g.\n   * HyperLiquid Unified/Portfolio mode, where `withdraw3` draws from the\n   * unified ledger).\n   *\n   * When `false`, free spot contributes to `totalBalance` only; spendable\n   * and withdrawable stay perps-only — appropriate for venues where spot\n   * is a separate ledger the backend cannot auto-draw from (e.g. HL\n   * Standard mode). The caller is responsible for translating\n   * provider-specific state into this flag.\n   *\n   * Defaults to `true` for backward compatibility with call sites that\n   * haven't yet been wired with provider-specific context.\n   */\n  foldIntoCollateral?: boolean;\n};\n\n/**\n * Add spot USDC to the AccountState contract. Caller decides whether the\n * spot balance counts as perps collateral via `options.foldIntoCollateral`\n * — the util stays provider-agnostic.\n *\n * @param accountState - Base AccountState produced by a provider adapter.\n * @param spotState - Raw spot clearinghouse response (HL-shaped); null or missing means no spot balance and the state is returned unchanged.\n * @param options - See {@link AddSpotBalanceOptions}.\n * @returns AccountState with spot folded into `totalBalance` always, and into spendable/withdrawable when `foldIntoCollateral` is true.\n */\nexport function addSpotBalanceToAccountState(\n  accountState: AccountState,\n  spotState?: SpotClearinghouseStateResponse | null,\n  options?: AddSpotBalanceOptions,\n): AccountState {\n  // Fail-closed default: align with `hyperLiquidModeFoldsSpot(null) → false`.\n  // A caller that omits `options` should NOT silently fold spot — that would\n  // over-report withdrawable funds for Standard / dexAbstraction users.\n  const foldIntoCollateral = options?.foldIntoCollateral ?? false;\n\n  const spotBalance = getSpotBalance(spotState);\n  const spotHold = getSpotHold(spotState);\n  const freeSpot = Math.max(0, spotBalance - spotHold);\n\n  const currentTotal = parseFloat(accountState.totalBalance);\n  const currentSpendable = parseFloat(accountState.spendableBalance);\n  const currentWithdrawable = parseFloat(accountState.withdrawableBalance);\n\n  // Preserve sentinel totals (e.g. PERPS_CONSTANTS.FallbackDataDisplay '--')\n  // rather than coercing them to NaN.\n  if (!Number.isFinite(currentTotal)) {\n    return accountState;\n  }\n\n  if (spotBalance === 0) {\n    // No spot wealth means no hold either in the HL payload shape, so the\n    // later totalBalance adjustment would also be a no-op.\n    return accountState;\n  }\n\n  // Folding is gated strictly on the resolved abstraction mode (see callers'\n  // `foldIntoCollateral` argument). Standard / DEX-abstraction users keep\n  // perps and spot independent, so spot must NOT surface as a perps-\n  // withdrawable balance for them — withdraw3 only draws from the perps\n  // ledger in those modes. Unified / portfolio-margin users get the fold;\n  // live callers fail-CLOSED via `hyperLiquidModeFoldsSpot` when mode is\n  // unresolved.\n  const nextSpendable = resolveFoldedBalance(\n    currentSpendable,\n    accountState.spendableBalance,\n    freeSpot,\n    foldIntoCollateral,\n  );\n  const nextWithdrawable = resolveFoldedBalance(\n    currentWithdrawable,\n    accountState.withdrawableBalance,\n    freeSpot,\n    foldIntoCollateral,\n  );\n\n  // Total always reflects combined wealth: subtract spotHold to avoid\n  // double-counting on Unified/PM accounts where marginSummary.accountValue\n  // already includes the margin that HL surfaces via spot.hold. Standard\n  // mode has spotHold = 0 by construction, so the subtraction is a no-op.\n  const nextTotal = currentTotal + spotBalance - spotHold;\n\n  return {\n    ...accountState,\n    totalBalance: nextTotal.toString(),\n    spendableBalance: nextSpendable,\n    withdrawableBalance: nextWithdrawable,\n  };\n}\n\nfunction resolveFoldedBalance(\n  currentNumeric: number,\n  currentRaw: string,\n  freeSpot: number,\n  foldIntoCollateral: boolean,\n): string {\n  if (!foldIntoCollateral) {\n    return currentRaw;\n  }\n  if (Number.isFinite(currentNumeric)) {\n    return (currentNumeric + freeSpot).toString();\n  }\n  // Non-finite currentNumeric means the adapter passed a sentinel like\n  // `PERPS_CONSTANTS.FallbackDataDisplay` (\"--\") during loading. Preserve\n  // the sentinel rather than synthesising a numeric fold; the caller's\n  // UI treats \"--\" as \"loading\" and would otherwise show a misleading\n  // spot-only figure while the per-DEX perps fetch is still in flight.\n  return currentRaw;\n}\n\n/**\n * Aggregate multiple per-DEX AccountState objects into one by summing numeric fields.\n * ROE is recalculated as (totalUnrealizedPnl / totalMarginUsed) * 100.\n *\n * @param states - The array of per-DEX account states to aggregate.\n * @returns The combined account state with summed balances and recalculated ROE.\n */\nexport function aggregateAccountStates(states: AccountState[]): AccountState {\n  const fallback: AccountState = {\n    spendableBalance: PERPS_CONSTANTS.FallbackDataDisplay,\n    withdrawableBalance: PERPS_CONSTANTS.FallbackDataDisplay,\n    totalBalance: PERPS_CONSTANTS.FallbackDataDisplay,\n    marginUsed: PERPS_CONSTANTS.FallbackDataDisplay,\n    unrealizedPnl: PERPS_CONSTANTS.FallbackDataDisplay,\n    returnOnEquity: PERPS_CONSTANTS.FallbackDataDisplay,\n  };\n\n  if (states.length === 0) {\n    return fallback;\n  }\n\n  const aggregated = states.reduce<AccountState>((acc, state, index) => {\n    if (index === 0) {\n      return { ...state };\n    }\n\n    return {\n      spendableBalance: (\n        parseFloat(acc.spendableBalance) + parseFloat(state.spendableBalance)\n      ).toString(),\n      withdrawableBalance: (\n        parseFloat(acc.withdrawableBalance) +\n        parseFloat(state.withdrawableBalance)\n      ).toString(),\n      totalBalance: (\n        parseFloat(acc.totalBalance) + parseFloat(state.totalBalance)\n      ).toString(),\n      marginUsed: (\n        parseFloat(acc.marginUsed) + parseFloat(state.marginUsed)\n      ).toString(),\n      unrealizedPnl: (\n        parseFloat(acc.unrealizedPnl) + parseFloat(state.unrealizedPnl)\n      ).toString(),\n      returnOnEquity: '0',\n    };\n  }, fallback);\n\n  // Recalculate ROE across all DEXs\n  const totalMarginUsed = parseFloat(aggregated.marginUsed);\n  const totalUnrealizedPnl = parseFloat(aggregated.unrealizedPnl);\n  if (totalMarginUsed > 0) {\n    aggregated.returnOnEquity = (\n      (totalUnrealizedPnl / totalMarginUsed) *\n      100\n    ).toString();\n  } else {\n    aggregated.returnOnEquity = '0';\n  }\n\n  return aggregated;\n}\n"]}

package/dist/utils/capabilitySymbols.cjs

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidCapabilitySymbol = void 0;
-/**
- * Check whether a capability symbol has the provider-independent shape the
- * caller allows.
- *
- * @param symbol - Market symbol supplied by a consumer.
- * @param options - Provider route syntax supported by the caller.
- * @param options.allowProviderRoute - Whether one non-empty `dex:market`
- * route prefix is allowed.
- * @returns Whether the symbol is non-empty, contains no whitespace, and uses
- * the allowed route shape.
- */
-function isValidCapabilitySymbol(symbol, options) {
-    if (symbol.length === 0 || /\s/u.test(symbol)) {
-        return false;
-    }
-    const routeParts = symbol.split(':');
-    return options.allowProviderRoute
-        ? routeParts.length <= 2 && routeParts.every((part) => part.length > 0)
-        : routeParts.length === 1;
-}
-exports.isValidCapabilitySymbol = isValidCapabilitySymbol;
-//# sourceMappingURL=capabilitySymbols.cjs.map

package/dist/utils/capabilitySymbols.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"capabilitySymbols.cjs","sourceRoot":"","sources":["../../src/utils/capabilitySymbols.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,SAAgB,uBAAuB,CACrC,MAAc,EACd,OAAwC;IAExC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,kBAAkB;QAC/B,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACvE,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;AAC9B,CAAC;AAZD,0DAYC","sourcesContent":["/**\n * Check whether a capability symbol has the provider-independent shape the\n * caller allows.\n *\n * @param symbol - Market symbol supplied by a consumer.\n * @param options - Provider route syntax supported by the caller.\n * @param options.allowProviderRoute - Whether one non-empty `dex:market`\n * route prefix is allowed.\n * @returns Whether the symbol is non-empty, contains no whitespace, and uses\n * the allowed route shape.\n */\nexport function isValidCapabilitySymbol(\n  symbol: string,\n  options: { allowProviderRoute: boolean },\n): boolean {\n  if (symbol.length === 0 || /\\s/u.test(symbol)) {\n    return false;\n  }\n\n  const routeParts = symbol.split(':');\n  return options.allowProviderRoute\n    ? routeParts.length <= 2 && routeParts.every((part) => part.length > 0)\n    : routeParts.length === 1;\n}\n"]}

package/dist/utils/capabilitySymbols.d.cts

@@ -1,15 +0,0 @@
-/**
- * Check whether a capability symbol has the provider-independent shape the
- * caller allows.
- *
- * @param symbol - Market symbol supplied by a consumer.
- * @param options - Provider route syntax supported by the caller.
- * @param options.allowProviderRoute - Whether one non-empty `dex:market`
- * route prefix is allowed.
- * @returns Whether the symbol is non-empty, contains no whitespace, and uses
- * the allowed route shape.
- */
-export declare function isValidCapabilitySymbol(symbol: string, options: {
-    allowProviderRoute: boolean;
-}): boolean;
-//# sourceMappingURL=capabilitySymbols.d.cts.map

package/dist/utils/capabilitySymbols.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"capabilitySymbols.d.cts","sourceRoot":"","sources":["../../src/utils/capabilitySymbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,kBAAkB,EAAE,OAAO,CAAA;CAAE,GACvC,OAAO,CAST"}

package/dist/utils/capabilitySymbols.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"capabilitySymbols.d.mts","sourceRoot":"","sources":["../../src/utils/capabilitySymbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,kBAAkB,EAAE,OAAO,CAAA;CAAE,GACvC,OAAO,CAST"}

package/dist/utils/capabilitySymbols.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"capabilitySymbols.mjs","sourceRoot":"","sources":["../../src/utils/capabilitySymbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAc,EACd,OAAwC;IAExC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,kBAAkB;QAC/B,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACvE,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["/**\n * Check whether a capability symbol has the provider-independent shape the\n * caller allows.\n *\n * @param symbol - Market symbol supplied by a consumer.\n * @param options - Provider route syntax supported by the caller.\n * @param options.allowProviderRoute - Whether one non-empty `dex:market`\n * route prefix is allowed.\n * @returns Whether the symbol is non-empty, contains no whitespace, and uses\n * the allowed route shape.\n */\nexport function isValidCapabilitySymbol(\n  symbol: string,\n  options: { allowProviderRoute: boolean },\n): boolean {\n  if (symbol.length === 0 || /\\s/u.test(symbol)) {\n    return false;\n  }\n\n  const routeParts = symbol.split(':');\n  return options.allowProviderRoute\n    ? routeParts.length <= 2 && routeParts.every((part) => part.length > 0)\n    : routeParts.length === 1;\n}\n"]}

package/dist/utils/coalescePerpsRestRequest.cjs

@@ -1,71 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetPerpsRestCacheForTests = exports.coalescePerpsRestRequest = void 0;
-const perpsConfig_js_1 = require("../constants/perpsConfig.cjs");
-const inflight = new Map();
-const cache = new Map();
-/**
- * Coalesce an idempotent perps REST call.
- *
- * - If a fresh cached value exists for `key`, it is returned immediately.
- * - If an in-flight promise exists for `key`, it is shared with the caller.
- * - Otherwise, `fetcher` runs once; the result populates the cache for `ttlMs`.
- *
- * `forceRefresh` skips both cache and in-flight dedup.
- *
- * @param key - Stable cache key identifying this logical REST call.
- * @param fetcher - Thunk that performs the REST call when no cache/inflight hit.
- * @param options - Optional overrides for TTL and forceRefresh behavior.
- * @returns The fetched (or cached) value.
- */
-function coalescePerpsRestRequest(key, fetcher, options = {}) {
-    const ttlMs = options.ttlMs ?? perpsConfig_js_1.PERFORMANCE_CONFIG.PerpsRestCoalesceTtlMs;
-    const forceRefresh = options.forceRefresh ?? false;
-    if (forceRefresh) {
-        cache.delete(key);
-    }
-    else {
-        const now = Date.now();
-        const cached = cache.get(key);
-        if (cached) {
-            if (cached.expiresAt > now) {
-                return Promise.resolve(cached.value);
-            }
-            // Evict expired entry so callers with per-call-unique keys (e.g.
-            // CandleStreamChannel historical paging with per-page endTime) do
-            // not accumulate dead blobs for the life of the process.
-            cache.delete(key);
-        }
-        const existing = inflight.get(key);
-        if (existing !== undefined) {
-            return existing;
-        }
-    }
-    const run = fetcher().then((value) => {
-        // Only the currently-tracked in-flight promise writes to cache. A stale
-        // in-flight (e.g. one that was racing a later forceRefresh=true caller)
-        // must not clobber the fresh value once it finally resolves.
-        if (inflight.get(key) === run) {
-            cache.set(key, { value, expiresAt: Date.now() + ttlMs });
-            inflight.delete(key);
-        }
-        return value;
-    }, (error) => {
-        if (inflight.get(key) === run) {
-            inflight.delete(key);
-        }
-        throw error;
-    });
-    inflight.set(key, run);
-    return run;
-}
-exports.coalescePerpsRestRequest = coalescePerpsRestRequest;
-/**
- * Test-only: wipe all cached entries and in-flight promises.
- */
-function resetPerpsRestCacheForTests() {
-    cache.clear();
-    inflight.clear();
-}
-exports.resetPerpsRestCacheForTests = resetPerpsRestCacheForTests;
-//# sourceMappingURL=coalescePerpsRestRequest.cjs.map

package/dist/utils/coalescePerpsRestRequest.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"coalescePerpsRestRequest.cjs","sourceRoot":"","sources":["../../src/utils/coalescePerpsRestRequest.ts"],"names":[],"mappings":";;;AAAA,iEAAiE;AAkBjE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;AACrD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;AAerD;;;;;;;;;;;;;GAaG;AACH,SAAgB,wBAAwB,CACtC,GAAW,EACX,OAA8B,EAC9B,UAA2B,EAAE;IAE7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,mCAAkB,CAAC,sBAAsB,CAAC;IACzE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IAEnD,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAmC,CAAC;QAChE,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvC,CAAC;YACD,iEAAiE;YACjE,kEAAkE;YAClE,yDAAyD;YACzD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAgC,CAAC;QAClE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC,IAAI,CACxB,CAAC,KAAK,EAAE,EAAE;QACR,wEAAwE;QACxE,wEAAwE;QACxE,6DAA6D;QAC7D,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9B,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YACzD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9B,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;IAEF,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvB,OAAO,GAAG,CAAC;AACb,CAAC;AAjDD,4DAiDC;AAED;;GAEG;AACH,SAAgB,2BAA2B;IACzC,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAHD,kEAGC","sourcesContent":["import { PERFORMANCE_CONFIG } from '../constants/perpsConfig.js';\n\n// Rapid perps market switching (candle bridge + activity tab burst) drives\n// duplicate REST calls against api.hyperliquid.xyz and occasionally trips 429.\n// This helper collapses concurrent identical calls into one in-flight promise\n// and serves a short TTL cache to absorb the burst. Explicit refresh bypasses\n// the cache so user-initiated refetch still re-runs.\n//\n// Lives at the service layer (MarketDataService) rather than per-hook so every\n// current and future caller — hooks, controller, aggregated provider — is\n// deduped automatically. Centralized at MarketDataService because it is\n// already a single choke point.\n\ntype CacheEntry<TValue> = {\n  value: TValue;\n  expiresAt: number;\n};\n\nconst inflight = new Map<string, Promise<unknown>>();\nconst cache = new Map<string, CacheEntry<unknown>>();\n\nexport type CoalesceOptions = {\n  /**\n   * Cache TTL in milliseconds. Defaults to\n   * {@link PERFORMANCE_CONFIG.PerpsRestCoalesceTtlMs}.\n   */\n  ttlMs?: number;\n  /**\n   * Bypass the cache and any in-flight promise. The fresh result will be\n   * written back to the cache under the same key.\n   */\n  forceRefresh?: boolean;\n};\n\n/**\n * Coalesce an idempotent perps REST call.\n *\n * - If a fresh cached value exists for `key`, it is returned immediately.\n * - If an in-flight promise exists for `key`, it is shared with the caller.\n * - Otherwise, `fetcher` runs once; the result populates the cache for `ttlMs`.\n *\n * `forceRefresh` skips both cache and in-flight dedup.\n *\n * @param key - Stable cache key identifying this logical REST call.\n * @param fetcher - Thunk that performs the REST call when no cache/inflight hit.\n * @param options - Optional overrides for TTL and forceRefresh behavior.\n * @returns The fetched (or cached) value.\n */\nexport function coalescePerpsRestRequest<TValue>(\n  key: string,\n  fetcher: () => Promise<TValue>,\n  options: CoalesceOptions = {},\n): Promise<TValue> {\n  const ttlMs = options.ttlMs ?? PERFORMANCE_CONFIG.PerpsRestCoalesceTtlMs;\n  const forceRefresh = options.forceRefresh ?? false;\n\n  if (forceRefresh) {\n    cache.delete(key);\n  } else {\n    const now = Date.now();\n    const cached = cache.get(key) as CacheEntry<TValue> | undefined;\n    if (cached) {\n      if (cached.expiresAt > now) {\n        return Promise.resolve(cached.value);\n      }\n      // Evict expired entry so callers with per-call-unique keys (e.g.\n      // CandleStreamChannel historical paging with per-page endTime) do\n      // not accumulate dead blobs for the life of the process.\n      cache.delete(key);\n    }\n    const existing = inflight.get(key) as Promise<TValue> | undefined;\n    if (existing !== undefined) {\n      return existing;\n    }\n  }\n\n  const run = fetcher().then(\n    (value) => {\n      // Only the currently-tracked in-flight promise writes to cache. A stale\n      // in-flight (e.g. one that was racing a later forceRefresh=true caller)\n      // must not clobber the fresh value once it finally resolves.\n      if (inflight.get(key) === run) {\n        cache.set(key, { value, expiresAt: Date.now() + ttlMs });\n        inflight.delete(key);\n      }\n      return value;\n    },\n    (error) => {\n      if (inflight.get(key) === run) {\n        inflight.delete(key);\n      }\n      throw error;\n    },\n  );\n\n  inflight.set(key, run);\n  return run;\n}\n\n/**\n * Test-only: wipe all cached entries and in-flight promises.\n */\nexport function resetPerpsRestCacheForTests(): void {\n  cache.clear();\n  inflight.clear();\n}\n"]}

package/dist/utils/coalescePerpsRestRequest.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"coalescePerpsRestRequest.d.cts","sourceRoot":"","sources":["../../src/utils/coalescePerpsRestRequest.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAC7C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAC9B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/dist/utils/coalescePerpsRestRequest.d.mts

@@ -1,32 +0,0 @@
-export type CoalesceOptions = {
-    /**
-     * Cache TTL in milliseconds. Defaults to
-     * {@link PERFORMANCE_CONFIG.PerpsRestCoalesceTtlMs}.
-     */
-    ttlMs?: number;
-    /**
-     * Bypass the cache and any in-flight promise. The fresh result will be
-     * written back to the cache under the same key.
-     */
-    forceRefresh?: boolean;
-};
-/**
- * Coalesce an idempotent perps REST call.
- *
- * - If a fresh cached value exists for `key`, it is returned immediately.
- * - If an in-flight promise exists for `key`, it is shared with the caller.
- * - Otherwise, `fetcher` runs once; the result populates the cache for `ttlMs`.
- *
- * `forceRefresh` skips both cache and in-flight dedup.
- *
- * @param key - Stable cache key identifying this logical REST call.
- * @param fetcher - Thunk that performs the REST call when no cache/inflight hit.
- * @param options - Optional overrides for TTL and forceRefresh behavior.
- * @returns The fetched (or cached) value.
- */
-export declare function coalescePerpsRestRequest<TValue>(key: string, fetcher: () => Promise<TValue>, options?: CoalesceOptions): Promise<TValue>;
-/**
- * Test-only: wipe all cached entries and in-flight promises.
- */
-export declare function resetPerpsRestCacheForTests(): void;
-//# sourceMappingURL=coalescePerpsRestRequest.d.mts.map

package/dist/utils/coalescePerpsRestRequest.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"coalescePerpsRestRequest.d.mts","sourceRoot":"","sources":["../../src/utils/coalescePerpsRestRequest.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAC7C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAC9B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/dist/utils/coalescePerpsRestRequest.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"coalescePerpsRestRequest.mjs","sourceRoot":"","sources":["../../src/utils/coalescePerpsRestRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,qCAAoC;AAkBjE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;AACrD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;AAerD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAW,EACX,OAA8B,EAC9B,UAA2B,EAAE;IAE7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAAC,sBAAsB,CAAC;IACzE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IAEnD,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAmC,CAAC;QAChE,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvC,CAAC;YACD,iEAAiE;YACjE,kEAAkE;YAClE,yDAAyD;YACzD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAgC,CAAC;QAClE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC,IAAI,CACxB,CAAC,KAAK,EAAE,EAAE;QACR,wEAAwE;QACxE,wEAAwE;QACxE,6DAA6D;QAC7D,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9B,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YACzD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9B,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;IAEF,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC","sourcesContent":["import { PERFORMANCE_CONFIG } from '../constants/perpsConfig.js';\n\n// Rapid perps market switching (candle bridge + activity tab burst) drives\n// duplicate REST calls against api.hyperliquid.xyz and occasionally trips 429.\n// This helper collapses concurrent identical calls into one in-flight promise\n// and serves a short TTL cache to absorb the burst. Explicit refresh bypasses\n// the cache so user-initiated refetch still re-runs.\n//\n// Lives at the service layer (MarketDataService) rather than per-hook so every\n// current and future caller — hooks, controller, aggregated provider — is\n// deduped automatically. Centralized at MarketDataService because it is\n// already a single choke point.\n\ntype CacheEntry<TValue> = {\n  value: TValue;\n  expiresAt: number;\n};\n\nconst inflight = new Map<string, Promise<unknown>>();\nconst cache = new Map<string, CacheEntry<unknown>>();\n\nexport type CoalesceOptions = {\n  /**\n   * Cache TTL in milliseconds. Defaults to\n   * {@link PERFORMANCE_CONFIG.PerpsRestCoalesceTtlMs}.\n   */\n  ttlMs?: number;\n  /**\n   * Bypass the cache and any in-flight promise. The fresh result will be\n   * written back to the cache under the same key.\n   */\n  forceRefresh?: boolean;\n};\n\n/**\n * Coalesce an idempotent perps REST call.\n *\n * - If a fresh cached value exists for `key`, it is returned immediately.\n * - If an in-flight promise exists for `key`, it is shared with the caller.\n * - Otherwise, `fetcher` runs once; the result populates the cache for `ttlMs`.\n *\n * `forceRefresh` skips both cache and in-flight dedup.\n *\n * @param key - Stable cache key identifying this logical REST call.\n * @param fetcher - Thunk that performs the REST call when no cache/inflight hit.\n * @param options - Optional overrides for TTL and forceRefresh behavior.\n * @returns The fetched (or cached) value.\n */\nexport function coalescePerpsRestRequest<TValue>(\n  key: string,\n  fetcher: () => Promise<TValue>,\n  options: CoalesceOptions = {},\n): Promise<TValue> {\n  const ttlMs = options.ttlMs ?? PERFORMANCE_CONFIG.PerpsRestCoalesceTtlMs;\n  const forceRefresh = options.forceRefresh ?? false;\n\n  if (forceRefresh) {\n    cache.delete(key);\n  } else {\n    const now = Date.now();\n    const cached = cache.get(key) as CacheEntry<TValue> | undefined;\n    if (cached) {\n      if (cached.expiresAt > now) {\n        return Promise.resolve(cached.value);\n      }\n      // Evict expired entry so callers with per-call-unique keys (e.g.\n      // CandleStreamChannel historical paging with per-page endTime) do\n      // not accumulate dead blobs for the life of the process.\n      cache.delete(key);\n    }\n    const existing = inflight.get(key) as Promise<TValue> | undefined;\n    if (existing !== undefined) {\n      return existing;\n    }\n  }\n\n  const run = fetcher().then(\n    (value) => {\n      // Only the currently-tracked in-flight promise writes to cache. A stale\n      // in-flight (e.g. one that was racing a later forceRefresh=true caller)\n      // must not clobber the fresh value once it finally resolves.\n      if (inflight.get(key) === run) {\n        cache.set(key, { value, expiresAt: Date.now() + ttlMs });\n        inflight.delete(key);\n      }\n      return value;\n    },\n    (error) => {\n      if (inflight.get(key) === run) {\n        inflight.delete(key);\n      }\n      throw error;\n    },\n  );\n\n  inflight.set(key, run);\n  return run;\n}\n\n/**\n * Test-only: wipe all cached entries and in-flight promises.\n */\nexport function resetPerpsRestCacheForTests(): void {\n  cache.clear();\n  inflight.clear();\n}\n"]}