@exodus/balances 13.2.2 → 13.3.0

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [13.3.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/balances@13.2.3...@exodus/balances@13.3.0) (2024-08-21)
+
+### Features
+
+- convert balances to valid ESM ([#8590](https://github.com/ExodusMovement/exodus-hydra/issues/8590)) ([e64fc29](https://github.com/ExodusMovement/exodus-hydra/commit/e64fc290dd7b3cea7adb41fe2b41084a83980a6b))
+
+## [13.2.3](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/balances@13.2.2...@exodus/balances@13.2.3) (2024-07-25)
+
+### Bug Fixes
+
+- migrate definitions ([#8030](https://github.com/ExodusMovement/exodus-hydra/issues/8030)) ([d2dfde5](https://github.com/ExodusMovement/exodus-hydra/commit/d2dfde55dfa843eb52842f64b3aac3a6f9a59069))
+
 ## [13.2.2](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/balances@13.2.1...@exodus/balances@13.2.2) (2024-07-18)
 
 **Note:** Version bump only for package @exodus/balances

package/README.md

@@ -1,5 +1,7 @@
 # @exodus/balances
 
+This Exodus SDK feature tracks the crypto-denominated balances for all enabled wallet accounts. For fiat-denominated balances, check out [@exodus/fiat-balances](../fiat-balances).
+
 ## Install
 
 ```sh
@@ -8,80 +10,69 @@ yarn add @exodus/balances
 
 ## Usage
 
-Like all Exodus SDK features, the `balances` feature consists of:
-
-- A feature that plugs into the Exodus SDK in your logical or actual background process. This provides the `balancesAtom` to other features.
-- A redux module that plugs into the Exodus SDK in the UI process. This provides selectors for getting [various balances](https://github.com/ExodusMovement/assets/blob/cd0088d03887934685c1bcbb223b55bb94705a56/docs/balances-model.md).
+This feature is designed to be used together with `@exodus/headless`. See [using the sdk](../../docs/using-the-sdk.md).
 
-### Setup
+### Play with it
 
-In the background process, plug `balances` into the SDK:
+1. Open the playground https://exodus-hydra.pages.dev/
+2. Run `selectors.balances.byAsset(store.getState())` in the Dev Tools Console to get balances by asset aggregated across enabled wallet accounts.
+3. Try out some other selectors from `selectors.balances`. See example usage in [tests](./redux/__tests__/selectors/).
+4. Mock an address with a balance, tick the blockchain monitor and check your balance.
 
 ```js
-import balances from '@exodus/balances'
-
-// sdk is an instance of `@exodus/argo` or `@exodus/headless`
-sdk.use(balances())
-```
-
-In the UI process, plug the `balances` redux module into the SDK:
-
-```js
-import { setupRedux } from '@exodus/redux-dependency-injection'
-import balances from '@exodus/balances/redux'
-
-const { selectors, createHandleEvent, reducers, initialState } = setupRedux({
-  dependencies: [
-    // other redux modules
-    // ...
-    balances,
-  ],
+// mock your ethereum address with one that has a balance
+await exodus.debug.addressProvider.mockAddress({
+  assetName: 'ethereum',
+  walletAccount: 'exodus_0',
+  address: '0x1111111111111111111111111111111111111111',
 })
-
-const handleEvent = createHandleEvent(store) // store is a redux store
+// force tick the ethereum monitor, or wait a while
+await exodus.txLogMonitors.update({ assetName: 'ethereum', refresh: true })
+// check your balance
+selectors.balances
+  .createTotal({ assetName: 'ethereum', walletAccount: 'exodus_0' })(store.getState())
+  .toString()
 ```
 
-Connect the background process to the UI process. In a multi-process app, you will need a transport layer:
+### API Side
 
-```js
-// forward SDK events to the UI process so the relevant redux module can handle them
-sdk.subscribe(({ type, payload }) => handleEvent(type, payload))
-```
-
-### Consuming Balances
+See [using the sdk](../../docs/using-the-sdk.md#setup-the-api-side) for more details on how features plug into the SDK. Note that the balances feature currently doesn't provide a top level API and is meant to be used purely through selectors.
 
-In your feature you can now depend on the `balancesAtom`
+If you're building a feature that requires balances, add a dependency on the `balancesAtom` as below. See also the [available balance fields](./default-config.js).
 
 ```js
-const myModuleFactory = ({ balancesAtom }) => {
-  const doSomethingSpecial = async () => {
-    // {
-    //   [walletAccount]: {
-    //     [assetName]: {
-    //       // e.g. 'total', 'spendable', 'unconfirmedSent', 'unconfirmedReceived'
-    //       [balanceField]: NumberUnit, // see @exodus/currency
-    //     }
-    //   }
-    // }
-    const { balances } = await balancesAtom.get()
-    // ...
-  }
-
-  return {
-    doSomethingSpecial,
-  }
-}
-
 const myModuleDefinition = {
   id: 'myModule',
   type: 'module',
-  factory: myModuleFactory,
+  factory: ({ balancesAtom }) => {
+    const doSomethingSpecial = async () => {
+      // {
+      //   [walletAccount]: {
+      //     [assetName]: {
+      //       // e.g. 'total', 'spendable', 'unconfirmedSent', 'unconfirmedReceived'
+      //       [balanceField]: NumberUnit, // see @exodus/currency
+      //     }
+      //   }
+      // }
+      const { balances } = await balancesAtom.get()
+      // ...
+    }
+
+    return {
+      doSomethingSpecial,
+    }
+  },
   dependencies: ['balancesAtom'],
 }
 ```
 
+### UI Side
+
+See [using the sdk](../../docs/using-the-sdk.md#events) for more details on basic UI-side setup.
+
 ```js
-// in UI
+import { selectors } from '~/ui/flux'
+
 const MyComponent = () => {
   const bitcoinBalance = useSelector(
     selectors.balances.createSpendable({
@@ -92,33 +83,6 @@ const MyComponent = () => {
 }
 ```
 
-## Playground
-
-Try the balances selectors in the [sdk-playground](../../apps/sdk-playground/).
-
-In this repo root, run:
-
-```sh
-yarn --cwd apps/sdk-playground dev
-```
-
-Open `http://localhost:8008` in the browser and run the following in the dev tools console:
-
-```js
-// mock your ethereum address with one that has a balance
-await exodus.debug.addressProvider.mockAddress({
-  assetName: 'ethereum',
-  walletAccount: 'exodus_0',
-  address: '0x1111111111111111111111111111111111111111',
-})
-// force tick the ethereum monitor, or wait a while
-await exodus.txLogMonitors.update({ assetName: 'ethereum', refresh: true })
-// check your balance
-selectors.balances.createTotal({ assetName: 'ethereum', walletAccount: 'exodus_0' })(
-  store.getState()
-)
-```
-
 ## Contributing
 
 ### WARNING: no asset specifics!

package/atoms/has-balance.js

@@ -1,5 +1,7 @@
 import { compute, createStorageAtomFactory } from '@exodus/atoms'
-import { flatMap, map } from 'lodash'
+import lodash from 'lodash'
+
+const { flatMap, map } = lodash
 
 // balancesAtom schema: { balances: { [walletAccount]: { [assetName]: { balance: NumberUnit } } } } }
 

package/atoms/index.js

@@ -1,14 +1,15 @@
-import createAssetNamesWithBalanceAtom from './asset-names-with-balance'
-import createAssetsWithBalanceCountAtom from './assets-with-balance-count'
-import createBalancesAtom from './balances'
-import createFundedWalletAccountsAtom from './funded-wallet-accounts'
-import createHasBalanceAtom from './has-balance'
+import createAssetNamesWithBalanceAtom from './asset-names-with-balance.js'
+import createAssetsWithBalanceCountAtom from './assets-with-balance-count.js'
+import createBalancesAtom from './balances.js'
+import createFundedWalletAccountsAtom from './funded-wallet-accounts.js'
+import createHasBalanceAtom from './has-balance.js'
 
 export const balancesAtomDefinition = {
   id: 'balancesAtom',
   type: 'atom',
   factory: createBalancesAtom,
   dependencies: [],
+  public: true,
 }
 
 export const hasBalanceAtomDefinition = {
@@ -16,6 +17,7 @@ export const hasBalanceAtomDefinition = {
   type: 'atom',
   factory: createHasBalanceAtom,
   dependencies: ['balancesAtom', 'storage'],
+  public: true,
 }
 
 export const fundedWalletAccountsAtomDefinition = {
@@ -23,6 +25,7 @@ export const fundedWalletAccountsAtomDefinition = {
   type: 'atom',
   factory: createFundedWalletAccountsAtom,
   dependencies: ['balancesAtom', 'enabledWalletAccountsAtom'],
+  public: true,
 }
 
 export const assetNamesWithBalanceAtomDefinition = {
@@ -30,6 +33,7 @@ export const assetNamesWithBalanceAtomDefinition = {
   type: 'atom',
   factory: createAssetNamesWithBalanceAtom,
   dependencies: ['balancesAtom'],
+  public: true,
 }
 
 export const assetsWithBalanceCountAtomDefinition = {
@@ -37,4 +41,5 @@ export const assetsWithBalanceCountAtomDefinition = {
   type: 'atom',
   factory: createAssetsWithBalanceCountAtom,
   dependencies: ['assetNamesWithBalanceAtom'],
+  public: true,
 }

package/index.js

@@ -1,15 +1,18 @@
-import balancesDefinition from './module'
+import balancesDefinition from './module/index.js'
 import {
   balancesAtomDefinition,
   hasBalanceAtomDefinition,
   fundedWalletAccountsAtomDefinition,
   assetsWithBalanceCountAtomDefinition,
   assetNamesWithBalanceAtomDefinition,
-} from './atoms'
-import balancesReportDefinition from './report'
-import { balancesLifecyclePluginDefinition, balancesAnalyticsPluginDefinition } from './plugins'
+} from './atoms/index.js'
+import balancesReportDefinition from './report/index.js'
+import {
+  balancesLifecyclePluginDefinition,
+  balancesAnalyticsPluginDefinition,
+} from './plugins/index.js'
 import typeforce from '@exodus/typeforce'
-import defaultConfig from './default-config'
+import defaultConfig from './default-config.js'
 
 const balances = (walletConfig) => {
   const config = {

package/module/index.js

@@ -1,11 +1,13 @@
 import { isNumberUnit } from '@exodus/currency'
 import { TxSet } from '@exodus/models'
 import ExodusModule from '@exodus/module' // eslint-disable-line import/no-deprecated
-import { cloneDeepWith, isEmpty, merge, zipObject } from 'lodash'
+import lodash from 'lodash'
 import { difference, flattenToPaths, pick, set } from '@exodus/basic-utils'
 import makeConcurrent from 'make-concurrent'
-import { processAssetBalances, validateBalances } from './balances-utils'
-import defaultConfig from '../default-config'
+import { processAssetBalances, validateBalances } from './balances-utils.js'
+import defaultConfig from '../default-config.js'
+
+const { cloneDeepWith, isEmpty, merge, zipObject } = lodash
 
 const cloneBalances = (balances) =>
   cloneDeepWith(balances, (val) => {
@@ -387,6 +389,7 @@ const balancesDefinition = {
     'accountStatesAtom',
     'assetsAtom',
   ],
+  public: true,
 }
 
 export default balancesDefinition

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@exodus/balances",
-  "version": "13.2.2",
+  "version": "13.3.0",
   "description": "Tracks crypto balances across enabled wallet accounts.",
   "author": "Exodus Movement, Inc.",
   "license": "UNLICENSED",
   "scripts": {
-    "test": "run -T jest",
+    "test": "run -T exodus-test --jest",
     "lint": "run -T eslint . --ignore-path ../../.gitignore",
-    "lint:fix": "yarn lint --fix"
+    "lint:fix": "yarn lint --fix",
+    "format": "run -T prettier --write \"**/*.{json,md,yaml}\" --log-level warn",
+    "format:check": "run -T prettier --check \"**/*.{json,md,yaml}\" --log-level warn"
   },
+  "type": "module",
   "main": "index.js",
   "files": [
     "module",
@@ -31,13 +34,13 @@
   },
   "dependencies": {
     "@exodus/atoms": "^8.0.0",
-    "@exodus/basic-utils": "^2.5.1",
-    "@exodus/core-selectors": "^1.5.0",
-    "@exodus/currency": "^2.1.2",
-    "@exodus/models": "^10.1.0",
-    "@exodus/module": "^1.1.0",
+    "@exodus/basic-utils": "^3.0.1",
+    "@exodus/core-selectors": "^3.0.0",
+    "@exodus/currency": "^5.0.2",
+    "@exodus/models": "^12.0.1",
+    "@exodus/module": "^1.3.0",
     "@exodus/multi-account-redux": "^2.0.1",
-    "@exodus/redux-dependency-injection": "^3.0.0",
+    "@exodus/redux-dependency-injection": "^4.0.0",
     "@exodus/typeforce": "^1.18.0",
     "lodash": "^4.17.21",
     "make-concurrent": "^4.0.0",
@@ -47,19 +50,19 @@
     "@exodus/blockchain-metadata": "^9.0.1"
   },
   "devDependencies": {
-    "@exodus/assets": "^8.0.94",
-    "@exodus/assets-base": "^8.1.10",
-    "@exodus/assets-feature": "^5.8.1",
-    "@exodus/available-assets": "^8.3.1",
-    "@exodus/bitcoin-meta": "^1.0.1",
-    "@exodus/blockchain-metadata": "^9.0.1",
-    "@exodus/ethereum-meta": "^1.0.30",
-    "@exodus/fee-data-monitors": "^4.2.0",
+    "@exodus/assets": "^11.0.0",
+    "@exodus/assets-base": "^10.0.0",
+    "@exodus/assets-feature": "^5.11.0",
+    "@exodus/available-assets": "^8.4.1",
+    "@exodus/bitcoin-meta": "^2.0.0",
+    "@exodus/blockchain-metadata": "^15.4.0",
+    "@exodus/ethereum-meta": "^2.0.0",
+    "@exodus/fee-data-monitors": "^4.3.0",
     "@exodus/redux-dependency-injection": "workspace:^",
     "@exodus/storage-memory": "*",
-    "@exodus/wallet-accounts": "^16.8.1",
+    "@exodus/wallet-accounts": "^16.10.0",
     "events": "^3.3.0",
     "redux": "^4.2.1"
   },
-  "gitHead": "a76a22c96445bcaa05e18de0e0c323cf9dd04cba"
+  "gitHead": "bd60146adb05b9a3fe6bd4b3e4dc4d13642a8023"
 }

package/plugins/index.js

@@ -1,11 +1,12 @@
-import createBalancesAnalyticsPlugin from './analytics'
-import createBalancesLifecyclePlugin from './lifecycle'
+import createBalancesAnalyticsPlugin from './analytics.js'
+import createBalancesLifecyclePlugin from './lifecycle.js'
 
 export const balancesLifecyclePluginDefinition = {
   id: 'balancesLifecyclePlugin',
   type: 'plugin',
   factory: createBalancesLifecyclePlugin,
   dependencies: ['balancesAtom', 'port', 'balances', 'hasBalanceAtom'],
+  public: true,
 }
 
 export const balancesAnalyticsPluginDefinition = {
@@ -13,4 +14,5 @@ export const balancesAnalyticsPluginDefinition = {
   type: 'plugin',
   factory: createBalancesAnalyticsPlugin,
   dependencies: ['analytics', 'hasBalanceAtom', 'assetsWithBalanceCountAtom'],
+  public: true,
 }

package/redux/index.js

@@ -1,10 +1,12 @@
-import id from './id'
-import initialState from './initial-state'
-import selectorDefinitions from './selectors'
+import id from './id.js'
+import initialState from './initial-state.js'
+import selectorDefinitions from './selectors/index.js'
 import { mapValues } from '@exodus/basic-utils'
-import { merge } from 'lodash'
-import helper from './multi-account-helper'
-import { setAccounts } from '@exodus/multi-account-redux/src/common'
+import lodash from 'lodash'
+import helper from './multi-account-helper.js'
+import { setAccounts } from '@exodus/multi-account-redux/src/common.js'
+
+const { merge } = lodash
 
 const mergeChanges = (balancesState, changesByWalletAccount) => {
   return {

package/redux/initial-state.js

@@ -1,4 +1,4 @@
-import helper from './multi-account-helper'
+import helper from './multi-account-helper.js'
 
 const initialState = {
   hasBalance: false,

package/redux/multi-account-helper.js

@@ -1,5 +1,5 @@
 import { createReduxModuleHelper } from '@exodus/multi-account-redux'
-import id from './id'
+import id from './id.js'
 
 const helper = createReduxModuleHelper({
   slice: id,

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

@@ -1,7 +1,9 @@
-import { memoize } from 'lodash'
+import lodash from 'lodash' // eslint-disable-line @exodus/restricted-imports/prefer-basic-utils -- TODO: fix next time we touch this file
 import { MY_STATE } from '@exodus/redux-dependency-injection'
 import { createSelector } from 'reselect'
 
+const { memoize } = lodash
+
 const createBalanceSelectorFactory = ({ field, id }) => {
   const selectorFactory = (selfSelector) =>
     memoize(

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

@@ -1,7 +1,9 @@
-import { memoize } from 'lodash'
+import lodash from 'lodash' // eslint-disable-line @exodus/restricted-imports/prefer-basic-utils -- TODO: fix next time we touch this file
 import { createSelector } from 'reselect'
 import { isNumberUnit } from '@exodus/currency'
 
+const { memoize } = lodash
+
 const selectorFactory = (getFeeDataSelector, assetsSelector) =>
   memoize((assetName) =>
     createSelector(getFeeDataSelector, assetsSelector, (getFeeData, assets) => {

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

@@ -1,5 +1,5 @@
 import { createSelector } from 'reselect'
-import { memoizeByAssetSource } from '@exodus/core-selectors/utils/memoize'
+import { memoizeByAssetSource } from '@exodus/core-selectors/utils/memoize.js'
 
 /**
  * Checks if a wallet account has "relative" tokens of the supplied asset (excluding itself):

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

@@ -1,6 +1,8 @@
-import { memoize } from 'lodash'
+import lodash from 'lodash' // eslint-disable-line @exodus/restricted-imports/prefer-basic-utils -- TODO: fix next time we touch this file
 import { createSelector } from 'reselect'
-import { getUnconfirmedBalance } from './get-unconfirmed-balance'
+import { getUnconfirmedBalance } from './get-unconfirmed-balance.js'
+
+const { memoize } = lodash
 
 const selectorFactory = (assetsSelector, createAssetSourceSelector) =>
   memoize(

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

@@ -1,5 +1,7 @@
-import { memoize } from 'lodash'
-import defaultConfig from '../../default-config'
+import lodash from 'lodash' // eslint-disable-line @exodus/restricted-imports/prefer-basic-utils -- TODO: fix next time we touch this file
+import defaultConfig from '../../default-config.js'
+
+const { memoize } = lodash
 
 const { balanceFields } = defaultConfig
 

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

@@ -1,4 +1,6 @@
-import { memoize } from 'lodash'
+import lodash from 'lodash'
+
+const { memoize } = lodash // eslint-disable-line @exodus/restricted-imports/prefer-basic-utils -- TODO: fix next time we touch this file
 
 const createResultFunction = (field) => (getBalanceForField) =>
   memoize(

package/redux/selectors/get-balances.js

@@ -1,7 +1,9 @@
-import { memoize } from 'lodash'
+import lodash from 'lodash' // eslint-disable-line @exodus/restricted-imports/prefer-basic-utils -- TODO: fix next time we touch this file
 import { createSelector } from 'reselect'
 import { MY_STATE } from '@exodus/redux-dependency-injection'
 
+const { memoize } = lodash
+
 const selectorFactory = (selfSelector) =>
   createSelector(selfSelector, (balances) =>
     memoize(

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

@@ -1,6 +1,8 @@
-import { memoize } from 'lodash'
+import lodash from 'lodash' // eslint-disable-line @exodus/restricted-imports/prefer-basic-utils -- TODO: fix next time we touch this file
 import { createSelector } from 'reselect'
 
+const { memoize } = lodash
+
 export const getUnconfirmedBalance = ({ asset, txs }) => {
   let result = asset.currency.ZERO
 

package/redux/selectors/index.js

@@ -1,10 +1,10 @@
-import byAssetSelectorDefinition from './by-asset'
-import createUnconfirmedBalanceSelectorDefinition from './create-unconfirmed-balance'
-import getBalanceForFieldSelectorDefinition from './get-balance-for-field'
-import getBalanceSelectors from './get-balance-selectors'
-import getBalancesSelectorDefinition from './get-balances'
-import createBalancesSelectors from './create-balance-selectors'
-import getUnconfirmedBalanceSelectorDefinition from './get-unconfirmed-balance'
+import byAssetSelectorDefinition from './by-asset.js'
+import createUnconfirmedBalanceSelectorDefinition from './create-unconfirmed-balance.js'
+import getBalanceForFieldSelectorDefinition from './get-balance-for-field.js'
+import getBalanceSelectors from './get-balance-selectors.js'
+import getBalancesSelectorDefinition from './get-balances.js'
+import createBalancesSelectors from './create-balance-selectors.js'
+import getUnconfirmedBalanceSelectorDefinition from './get-unconfirmed-balance.js'
 import createFuelThresholdSelectorDefinition from './create-fuel-threshold.js'
 import createRequiresFuelThresholdSelectorDefinition from './create-requires-fuel-threshold.js'
 

package/report/index.js

@@ -40,6 +40,7 @@ const balancesReportDefinition = {
   type: 'report',
   factory: createBalancesReport,
   dependencies: ['enabledWalletAccountsAtom', 'balancesAtom'],
+  public: true,
 }
 
 export default balancesReportDefinition