@exodus/balances 13.9.1 → 13.11.0

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [13.11.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/balances@13.10.0...@exodus/balances@13.11.0) (2025-07-09)
+
+### Features
+
+- feat: getBalance, createBalance selectors to default 0 NU (#13164)
+
+## [13.10.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/balances@13.9.1...@exodus/balances@13.10.0) (2025-07-04)
+
+### Features
+
+- feat: provide feeData to asset.api.getBalances (#13104)
+
+### Bug Fixes
+
+- fix: provide feeData as undefined to getBalances when disabled (#13113)
+
 ## [13.9.1](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/balances@13.9.0...@exodus/balances@13.9.1) (2025-06-11)
 
 ### Performance

package/module/index.js

@@ -42,6 +42,7 @@ class Balances {
   #balancesAtom
   #accountStatesAtom
   #txLogsAtom
+  #feeDataAtom
   #enabledWalletAccountsAtom
   #loaded = false
   #subscriptions = []
@@ -55,6 +56,7 @@ class Balances {
     balancesAtom,
     txLogsAtom,
     accountStatesAtom,
+    feeDataAtom,
   }) {
     this.#logger = logger
     this.#assetsModule = assetsModule
@@ -64,6 +66,7 @@ class Balances {
     this.#balancesAtom = balancesAtom
     this.#accountStatesAtom = accountStatesAtom
     this.#txLogsAtom = txLogsAtom
+    this.#feeDataAtom = feeDataAtom
     this.#enabledWalletAccountsAtom = enabledWalletAccountsAtom
 
     const shareQueue =
@@ -87,6 +90,7 @@ class Balances {
     // these share a queue
     this.#updateAssetSource = shareQueue(this.#updateAssetSource)
     this.#handleTxLogUpdate = shareQueue(this.#handleTxLogUpdate)
+    this.#handleFeeDataUpdate = shareQueue(this.#handleFeeDataUpdate)
     this.#recompute = shareQueue(this.#recompute)
     this.#onAssetsChanged = shareQueue(this.#onAssetsChanged)
     this.#getBalancesForAssetSource = swallowErrors(this.#getBalancesForAssetSource)
@@ -111,6 +115,16 @@ class Balances {
           this.#handleTxLogUpdate({ walletAccount, assetName, txLog })
         )
       ),
+      this.#feeDataAtom.observe((changes) => {
+        Object.entries(changes).forEach(([assetName, feeData]) => {
+          const asset = this.#getAsset(assetName).baseAsset
+          if (asset.api?.features?.balancesRequireFeeData)
+            this.#walletAccounts.forEach((walletAccount) => {
+              return this.#handleFeeDataUpdate({ walletAccount, assetName, feeData })
+            })
+        })
+      }),
+
       getChanges(this.#availableAssetNamesAtom).observe(({ previous = [], current }) => {
         this.#availableAssetNames = current
         const added = difference(current, previous)
@@ -143,6 +157,15 @@ class Balances {
     return this.#updateAssetSource(opts)
   }
 
+  #handleFeeDataUpdate = (opts) => {
+    if (!this.#ready) {
+      this.#logger.log('ignore update from fee-data event.', { isReady: this.#ready })
+      return
+    }
+
+    return this.#updateAssetSource(opts)
+  }
+
   #pushIntoSharedQueue = makeConcurrent((fn) => fn(), { concurrency: 1 })
 
   #reset = ({ walletAccounts = this.#walletAccounts } = {}) => {
@@ -162,7 +185,12 @@ class Balances {
   // It adds both old and new balances to the response.
   // Ideally, selectors should start using the new ones (total, spendable, etc)
 
-  #getBalancesFromBlockchainMetadata = ({ assetNames, accountState, txLogsByAssetName }) => {
+  #getBalancesFromBlockchainMetadata = ({
+    assetNames,
+    accountState,
+    feeData,
+    txLogsByAssetName,
+  }) => {
     // in the future accountState may have all the balances and we won't need to rely on txLog
     // for now, accountState-based balance has both the baseAsset and token balances while txLog is per asset/token
     const getAssetBalances = (assetName) => {
@@ -171,7 +199,7 @@ class Balances {
 
       const zero = asset.currency.ZERO
 
-      const apiBalances = asset.api.getBalances({ asset, accountState, txLog })
+      const apiBalances = asset.api.getBalances({ asset, accountState, txLog, feeData })
       const balances = processAssetBalances({
         balanceFieldsConfig: this.#balanceFieldsConfig,
         balances: apiBalances || Object.create(null),
@@ -259,24 +287,33 @@ class Balances {
   #loadBlockchainMetadataForBalance = async ({
     assetName,
     walletAccount,
+    feeData: providedFeeData, // it's optional, undefined when balancesRequireFeeData is disabled
     accountState: providedAccountState = null,
     txLogsByAssetName: providedTxLogsByAssetName = {},
   }) => {
     const { value: txLogsByAssetSource } = await this.#txLogsAtom.get()
     let accountState = providedAccountState
+
+    const baseAsset = this.#getAsset(assetName).baseAsset
+
     if (!accountState) {
-      const asset = this.#getAsset(assetName).baseAsset
-      const assetNameToUse = asset.name
+      const assetNameToUse = baseAsset.name
       const { value } = await this.#accountStatesAtom.get()
       const cached = value[walletAccount]?.[assetNameToUse]
       if (cached) {
         accountState = cached
       } else {
-        const AccountState = asset.api?.createAccountState?.()
+        const AccountState = baseAsset.api?.createAccountState?.()
         accountState = AccountState?.create()
       }
     }
 
+    let feeData = providedFeeData
+    if (!feeData && baseAsset.api?.features?.balancesRequireFeeData) {
+      const fees = await this.#feeDataAtom.get()
+      feeData = fees[baseAsset.name]
+    }
+
     const assetNames = this.#getRelatedAssetNames(assetName)
     const txLogsByAssetName = zipObject(
       assetNames,
@@ -289,6 +326,7 @@ class Balances {
     )
 
     return {
+      feeData,
       accountState,
       txLogsByAssetName,
     }
@@ -299,6 +337,7 @@ class Balances {
     walletAccount,
     accountState: providedAccountState,
     txLog: providedTxLog,
+    feeData: providedFeeData,
   }) => {
     if (!this.#isSupportedAsset(assetName)) return
 
@@ -307,20 +346,23 @@ class Balances {
       return
     }
 
-    const { accountState, txLogsByAssetName } = await this.#loadBlockchainMetadataForBalance({
-      assetName,
-      walletAccount,
-      accountState: providedAccountState,
-      txLogsByAssetName: {
-        [assetName]: providedTxLog,
-      },
-    })
+    const { accountState, txLogsByAssetName, feeData } =
+      await this.#loadBlockchainMetadataForBalance({
+        assetName,
+        walletAccount,
+        feeData: providedFeeData,
+        accountState: providedAccountState,
+        txLogsByAssetName: {
+          [assetName]: providedTxLog,
+        },
+      })
 
     const accountBalances = this.#balances[walletAccount]
     const newBalances = this.#getBalancesFromBlockchainMetadata({
       assetNames: this.#getRelatedAssetNames(assetName),
       accountState,
       txLogsByAssetName,
+      feeData,
     })
 
     const changes = Object.create(null)
@@ -383,6 +425,7 @@ const balancesDefinition = {
     'balancesAtom',
     'txLogsAtom',
     'accountStatesAtom',
+    'feeDataAtom',
   ],
   public: true,
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/balances",
-  "version": "13.9.1",
+  "version": "13.11.0",
   "description": "Tracks crypto balances across enabled wallet accounts.",
   "author": "Exodus Movement, Inc.",
   "license": "MIT",
@@ -53,10 +53,10 @@
   "devDependencies": {
     "@exodus/assets": "^11.0.0",
     "@exodus/assets-base": "^10.0.0",
-    "@exodus/assets-feature": "^8.1.2",
+    "@exodus/assets-feature": "^8.1.3",
     "@exodus/available-assets": "^8.7.0",
     "@exodus/bitcoin-meta": "^2.0.0",
-    "@exodus/blockchain-metadata": "^15.11.1",
+    "@exodus/blockchain-metadata": "^15.12.0",
     "@exodus/ethereum-meta": "^2.0.0",
     "@exodus/fee-data-monitors": "^5.0.4",
     "@exodus/storage-memory": "^2.2.2",
@@ -67,5 +67,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "7db677f161ff564c5ee65cf8f52f213c24b9624a"
+  "gitHead": "db4613f1399e3fa3c65135835bb0e84ba5feb520"
 }

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

@@ -5,12 +5,14 @@ import { createSelector } from 'reselect'
 const { memoize } = lodash // eslint-disable-line @exodus/basic-utils/prefer-basic-utils
 
 const createBalanceSelectorFactory = ({ field, id }) => {
-  const selectorFactory = (selfSelector) =>
+  const selectorFactory = (assetsSelector, selfSelector) =>
     memoize(
       ({ assetName, walletAccount }) =>
         createSelector(
+          assetsSelector,
           selfSelector,
-          (balances) => balances[walletAccount]?.data[assetName]?.[field]
+          (assets, balances) =>
+            balances[walletAccount]?.data[assetName]?.[field] ?? assets[assetName]?.currency.ZERO
         ),
       ({ assetName, walletAccount, field }) => [assetName, walletAccount, field].join('-')
     )
@@ -18,7 +20,7 @@ const createBalanceSelectorFactory = ({ field, id }) => {
   return {
     id,
     selectorFactory,
-    dependencies: [{ selector: MY_STATE }],
+    dependencies: [{ module: 'assets', selector: 'all' }, { selector: MY_STATE }],
   }
 }
 

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

@@ -5,7 +5,7 @@ const { memoize } = lodash // eslint-disable-line @exodus/basic-utils/prefer-bas
 
 const { balanceFields } = defaultConfig
 
-const resultFunction = (getBalances) =>
+const resultFunction = (assets, getBalances) =>
   memoize(
     ({ assetName, walletAccount, field }) => {
       if (!balanceFields.includes(field)) {
@@ -14,7 +14,7 @@ const resultFunction = (getBalances) =>
         )
       }
 
-      return getBalances({ assetName, walletAccount })?.[field]
+      return getBalances({ assetName, walletAccount })?.[field] ?? assets[assetName]?.currency.ZERO
     },
     ({ assetName, walletAccount, field }) => [assetName, walletAccount, field].join('-')
   )
@@ -22,7 +22,10 @@ const resultFunction = (getBalances) =>
 const getBalanceForFieldSelectorDefinition = {
   id: 'getBalanceForField',
   resultFunction,
-  dependencies: [{ module: 'balances', selector: 'getBalances' }],
+  dependencies: [
+    { module: 'assets', selector: 'all' },
+    { module: 'balances', selector: 'getBalances' },
+  ],
 }
 
 export default getBalanceForFieldSelectorDefinition