@exodus/balances 13.13.0 → 13.14.0

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [13.14.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/balances@13.13.1...@exodus/balances@13.14.0) (2025-11-27)
+
+### Features
+
+- feat: bump atoms for importers of observer factory (#14057)
+
+- feat: introduce blockChainMetadataAtom (#14470)
+
+- feat: update all consumers to use safe strings for error namespaces (#14429)
+
+## [13.13.1](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/balances@13.13.0...@exodus/balances@13.13.1) (2025-08-22)
+
+**Note:** Version bump only for package @exodus/balances
+
 ## [13.13.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/balances@13.12.0...@exodus/balances@13.13.0) (2025-07-16)
 
 ### Features

package/atoms/has-balance.js

@@ -1,4 +1,5 @@
 import { compute, createStorageAtomFactory } from '@exodus/atoms'
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 
 const { flatMap, map } = lodash

package/index.js

@@ -15,6 +15,7 @@ import {
 import typeforce from '@exodus/typeforce'
 import defaultConfig from './default-config.js'
 import mockableBalancesDefinition from './module/mockable-balances.js'
+import { safeString } from '@exodus/safe-string'
 
 const balances = (walletConfig) => {
   const config = {
@@ -34,7 +35,7 @@ const balances = (walletConfig) => {
   )
 
   return {
-    id: 'balances',
+    id: safeString`balances`,
     definitions: [
       {
         definition: walletConfig?.importReport ? mockableBalancesDefinition : balancesDefinition,

package/module/index.js

@@ -1,9 +1,10 @@
 import { safeString } from '@exodus/safe-string'
 import { isNumberUnit } from '@exodus/currency'
 import { TxSet } from '@exodus/models'
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 import { difference as getChanges } from '@exodus/atoms'
-import { difference, flattenToPaths, pick, set } from '@exodus/basic-utils'
+import { difference, pick, set, mapValues } from '@exodus/basic-utils'
 import makeConcurrent from 'make-concurrent'
 import { processAssetBalances, validateBalances } from './balances-utils.js'
 import defaultConfig from '../default-config.js'
@@ -41,8 +42,7 @@ class Balances {
 
   #balances = Object.create(null)
   #balancesAtom
-  #accountStatesAtom
-  #txLogsAtom
+  #blockchainMetadataAtom
   #feeDataAtom
   #enabledWalletAccountsAtom
   #loaded = false
@@ -55,8 +55,7 @@ class Balances {
     config,
     logger,
     balancesAtom,
-    txLogsAtom,
-    accountStatesAtom,
+    blockchainMetadataAtom,
     feeDataAtom,
     errorTracking,
   }) {
@@ -66,8 +65,7 @@ class Balances {
     this.#balanceFieldsConfig = config?.balanceFieldsConfig || defaultConfig.balanceFieldsConfig
     this.#balanceFields = config?.balanceFields || defaultConfig.balanceFields
     this.#balancesAtom = balancesAtom
-    this.#accountStatesAtom = accountStatesAtom
-    this.#txLogsAtom = txLogsAtom
+    this.#blockchainMetadataAtom = blockchainMetadataAtom
     this.#feeDataAtom = feeDataAtom
     this.#enabledWalletAccountsAtom = enabledWalletAccountsAtom
     this.#errorTracking = errorTracking
@@ -92,7 +90,7 @@ class Balances {
 
     // these share a queue
     this.#updateAssetSource = shareQueue(this.#updateAssetSource)
-    this.#handleTxLogUpdate = shareQueue(this.#handleTxLogUpdate)
+    this.#handleBlockchainMetadataUpdate = shareQueue(this.#handleBlockchainMetadataUpdate)
     this.#handleFeeDataUpdate = shareQueue(this.#handleFeeDataUpdate)
     this.#recompute = shareQueue(this.#recompute)
     this.#onAssetsChanged = shareQueue(this.#onAssetsChanged)
@@ -111,23 +109,25 @@ class Balances {
       this.#enabledWalletAccountsAtom.observe((payload) => {
         this.#setWalletAccounts(Object.keys(payload))
       }),
-      this.#accountStatesAtom.observe(({ changes }) =>
-        flattenToPaths(changes).forEach(([walletAccount, assetName, accountState]) =>
-          this.#handleAccountStateUpdate({ walletAccount, assetName, accountState })
-        )
-      ),
-      this.#txLogsAtom.observe(({ changes }) =>
-        flattenToPaths(changes).forEach(([walletAccount, assetName, txLog]) =>
-          this.#handleTxLogUpdate({ walletAccount, assetName, txLog })
+      this.#blockchainMetadataAtom.observe(({ accountStateChanges, txLogChanges }) => {
+        this.#flattenToBlockchainMetadataObjects({ accountStateChanges, txLogChanges }).forEach(
+          ({ walletAccount, assetName, accountState, txLogsByAssetName }) =>
+            this.#handleBlockchainMetadataUpdate({
+              walletAccount,
+              assetName,
+              accountState,
+              txLogsByAssetName,
+            })
         )
-      ),
+      }),
       this.#feeDataAtom.observe((changes) => {
         Object.entries(changes).forEach(([assetName, feeData]) => {
           const asset = this.#getAsset(assetName).baseAsset
-          if (asset.api?.features?.balancesRequireFeeData)
+          if (asset.api?.features?.balancesRequireFeeData) {
             this.#walletAccounts.forEach((walletAccount) => {
               return this.#handleFeeDataUpdate({ walletAccount, assetName, feeData })
             })
+          }
         })
       }),
 
@@ -145,18 +145,34 @@ class Balances {
 
   #getAssets = () => this.#assetsModule.getAssets()
 
-  #handleAccountStateUpdate = async (opts) => {
-    if (!this.#ready) {
-      this.#logger.log('ignore update from account-state event.', { isReady: this.#ready })
-      return
-    }
+  #flattenToBlockchainMetadataObjects = ({
+    accountStateChanges = Object.create(null),
+    txLogChanges = Object.create(null),
+  }) => {
+    const byBaseAssetName = mapValues(accountStateChanges, (accountStates) =>
+      mapValues(accountStates, (accountState) => ({ accountState }))
+    )
 
-    return this.#updateAssetSource(opts)
+    Object.entries(txLogChanges).forEach(([walletAccount, txLogs]) => {
+      Object.entries(txLogs).map(([assetName, txLog]) => {
+        const { baseAsset } = this.#getAsset(assetName)
+        set(byBaseAssetName, [walletAccount, baseAsset.name, 'txLogsByAssetName', assetName], txLog)
+      })
+    })
+
+    return Object.entries(byBaseAssetName).flatMap(([walletAccount, baseAssets]) =>
+      Object.entries(baseAssets).map(([baseAssetName, { accountState, txLogsByAssetName }]) => ({
+        walletAccount,
+        assetName: baseAssetName,
+        ...(accountState && { accountState }),
+        ...(txLogsByAssetName && { txLogsByAssetName }),
+      }))
+    )
   }
 
-  #handleTxLogUpdate = (opts) => {
+  #handleBlockchainMetadataUpdate = (opts) => {
     if (!this.#ready) {
-      this.#logger.log('ignore update from tx-log event.', { isReady: this.#ready })
+      this.#logger.log('ignore update from blockchain-metadata event.', { isReady: this.#ready })
       return
     }
 
@@ -297,15 +313,15 @@ class Balances {
     accountState: providedAccountState = null,
     txLogsByAssetName: providedTxLogsByAssetName = {},
   }) => {
-    const { value: txLogsByAssetSource } = await this.#txLogsAtom.get()
+    const {
+      value: { txs: txLogsByAssetSource, accountStates },
+    } = await this.#blockchainMetadataAtom.get()
     let accountState = providedAccountState
 
     const baseAsset = this.#getAsset(assetName).baseAsset
 
     if (!accountState) {
-      const assetNameToUse = baseAsset.name
-      const { value } = await this.#accountStatesAtom.get()
-      const cached = value[walletAccount]?.[assetNameToUse]
+      const cached = accountStates[walletAccount]?.[baseAsset.name]
       if (cached) {
         accountState = cached
       } else {
@@ -342,7 +358,7 @@ class Balances {
     assetName,
     walletAccount,
     accountState: providedAccountState,
-    txLog: providedTxLog,
+    txLogsByAssetName: providedTxLogsByAssetName,
     feeData: providedFeeData,
   }) => {
     if (!this.#isSupportedAsset(assetName)) return
@@ -358,9 +374,7 @@ class Balances {
         walletAccount,
         feeData: providedFeeData,
         accountState: providedAccountState,
-        txLogsByAssetName: {
-          [assetName]: providedTxLog,
-        },
+        txLogsByAssetName: providedTxLogsByAssetName,
       })
 
     const accountBalances = this.#balances[walletAccount]
@@ -429,8 +443,7 @@ const balancesDefinition = {
     'config',
     'logger',
     'balancesAtom',
-    'txLogsAtom',
-    'accountStatesAtom',
+    'blockchainMetadataAtom',
     'feeDataAtom',
     'errorTracking',
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/balances",
-  "version": "13.13.0",
+  "version": "13.14.0",
   "description": "Tracks crypto balances across enabled wallet accounts.",
   "author": "Exodus Movement, Inc.",
   "license": "MIT",
@@ -33,9 +33,9 @@
     "url": "https://github.com/ExodusMovement/exodus-hydra/issues?q=is%3Aissue+is%3Aopen+label%3Abalances"
   },
   "dependencies": {
-    "@exodus/atoms": "^9.0.0",
+    "@exodus/atoms": "^10.0.0",
     "@exodus/basic-utils": "^3.0.1",
-    "@exodus/core-selectors": "^3.0.0",
+    "@exodus/core-selectors": "^4.0.0",
     "@exodus/currency": "^5.0.2",
     "@exodus/errors": "^3.0.0",
     "@exodus/models": "^12.0.1",
@@ -49,24 +49,25 @@
     "reselect": "^3.0.1"
   },
   "peerDependencies": {
-    "@exodus/blockchain-metadata": "^15.4.0"
+    "@exodus/blockchain-metadata": "^17.0.0"
   },
   "devDependencies": {
     "@exodus/assets": "^11.0.0",
     "@exodus/assets-base": "^10.0.0",
-    "@exodus/assets-feature": "^8.1.3",
-    "@exodus/available-assets": "^8.7.0",
+    "@exodus/assets-feature": "^8.7.1",
+    "@exodus/available-assets": "^8.8.0",
     "@exodus/bitcoin-meta": "^2.0.0",
-    "@exodus/blockchain-metadata": "^15.12.0",
+    "@exodus/blockchain-metadata": "^17.1.0",
     "@exodus/ethereum-meta": "^2.0.0",
     "@exodus/fee-data-monitors": "^5.0.4",
-    "@exodus/storage-memory": "^2.2.2",
-    "@exodus/wallet-accounts": "^17.6.1",
+    "@exodus/storage-memory": "^2.3.0",
+    "@exodus/wallet-accounts": "^20.2.1",
     "events": "^3.3.0",
     "redux": "^4.2.1"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": false
   },
-  "gitHead": "f2359d974180d0af6e116f209da34dbee4ef8cff"
+  "gitHead": "1535d3792c06b4c96e94e0787f75d40fbb5cca1f"
 }

package/redux/index.js

@@ -2,6 +2,7 @@ import id from './id.js'
 import initialState from './initial-state.js'
 import selectorDefinitions from './selectors/index.js'
 import { mapValues } from '@exodus/basic-utils'
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 import helper from './multi-account-helper.js'
 import { setAccounts } from '@exodus/multi-account-redux/src/common.js'

package/redux/selectors/create-balance-selectors.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 import { MY_STATE } from '@exodus/redux-dependency-injection'
 import { createSelector } from 'reselect'

package/redux/selectors/create-balances.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 import { createSelector } from 'reselect'
 import { MY_STATE } from '@exodus/redux-dependency-injection'

package/redux/selectors/create-fuel-threshold.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 import { createSelector } from 'reselect'
 import { isNumberUnit } from '@exodus/currency'

package/redux/selectors/create-unconfirmed-balance.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 import { createSelector } from 'reselect'
 import { getUnconfirmedBalance } from './get-unconfirmed-balance.js'

package/redux/selectors/get-balance-for-field.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 import defaultConfig from '../../default-config.js'
 

package/redux/selectors/get-balance-selectors.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 
 const { memoize } = lodash // eslint-disable-line @exodus/basic-utils/prefer-basic-utils

package/redux/selectors/get-balances.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 import { createSelector } from 'reselect'
 import { MY_STATE } from '@exodus/redux-dependency-injection'

package/redux/selectors/get-unconfirmed-balance.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-restricted-imports -- TODO: Fix this the next time the file is edited.
 import lodash from 'lodash'
 import { createSelector } from 'reselect'