@exodus/balances 1.1.0 → 1.1.2

package/README.md

@@ -0,0 +1,57 @@
+# @exodus/balances
+
+This module tracks balances across assets and portfolios. It delegates to assets for any asset-specifics.
+
+## WARNING: no asset specifics!
+
+If you introduce any asset specifics like `if (assetName === 'dogicorn') balance = balance.mul(2)`, you will be fired immediately. This is a safety measure to save you from @feri42's wrath. All asset-specifics belong in `asset.api.getBalances` or other APIs inside the asset libraries.
+
+## Install
+
+```sh
+yarn add @exodus/balances
+```
+
+## Usage
+
+```js
+import createBalances from '@exodus/balances'
+
+const balances = createBalances({
+  // see #/assets-module in exodus-browser or tests for the API
+  assetsModule,
+  // pushes data of the form `{ [walletAccount]: WalletAccount }`
+  walletAccountsAtom,
+  // @exodus/blockchain-metadata instance
+  blockchainMetadata,
+  // the types of balances supported may change. For now it's just the total balance
+  balanceFields: ['balance'],
+  // see ../modules/module/src/logger.js for API
+  logger,
+})
+
+balances.on('balances', ({ balances, oldBalances, changes }) => {
+  // `balances`, `oldBalances`
+  // {
+  //   [walletAccount]: {
+  //     [assetName]: {
+  //       [balanceField]: NumberUnit
+  //     }
+  //   }
+  // }
+  //
+  // `changes`
+  // {
+  //   [walletAccount]: {
+  //     [assetName]: {
+  //       [balanceField]: {
+  //         from: NumberUnit,
+  //         to: NumberUnit,
+  //       }
+  //     }
+  //   }
+  // }
+})
+
+balances.sync() // forces 'balances' event emission
+```

package/index.js

@@ -43,12 +43,10 @@ class Balances extends ExodusModule {
     this.#updateAssetSource = shareQueue(this.#updateAssetSource)
     this.#recompute = shareQueue(this.#recompute)
 
-    blockchainMetadata.on('account-state', async (opts) => {
-      return this.#updateAssetSource(opts)
-    })
-
-    blockchainMetadata.on('tx-log', async (opts) => {
-      if (this.#isHistoryBasedBalanceAsset(opts.assetName)) return this.#updateAssetSource(opts)
+    blockchainMetadata.on('loaded', () => {
+      this.#recompute()
+      blockchainMetadata.on('account-state', this.#handleAccountStateUpdate)
+      blockchainMetadata.on('tx-log', this.#handleTxLogUpdate)
     })
 
     walletAccountsAtom.observe((payload) =>
@@ -62,6 +60,26 @@ class Balances extends ExodusModule {
 
   #getAsset = (assetName) => this.#assetsModule.getAsset(assetName)
 
+  #handleAccountStateUpdate = async (opts) => {
+    if (!this.#ready) {
+      this._logger.log(`ignore update from account-state event.`, {
+        isReady: this.#ready,
+      })
+      return
+    }
+    return this.#updateAssetSource(opts)
+  }
+
+  #handleTxLogUpdate = (opts) => {
+    if (!this.#ready) {
+      this._logger.log(`ignore update from tx-log event.`, {
+        isReady: this.#ready,
+      })
+      return
+    }
+    if (this.#isHistoryBasedBalanceAsset(opts.assetName)) return this.#updateAssetSource(opts)
+  }
+
   #pushIntoSharedQueue = makeConcurrent((fn) => fn(), { concurrency: 1 })
 
   #reset = ({ walletAccounts = this.#walletAccounts } = {}) => {
@@ -219,13 +237,14 @@ class Balances extends ExodusModule {
     this._logger.log('balances updated')
 
     const oldBalances = this.#oldBalances
+    const balances = cloneBalances(this.#balances)
     this.emit('balances', {
-      balances: this.#balances,
+      balances,
       oldBalances,
       changes,
     })
 
-    this.#oldBalances = cloneBalances(this.#balances)
+    this.#oldBalances = balances
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/balances",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "balances",
   "author": "Exodus Movement Inc",
   "license": "UNLICENSED",
@@ -31,5 +31,5 @@
     "@exodus/basic-utils": "^1.0.0",
     "@exodus/models": "^8.9.0"
   },
-  "gitHead": "8dc3595d4bd5750bdf649fafef7fd5d9dd345824"
+  "gitHead": "d23a92b5962eedd5874f0362a6983b7c4b8a3ce4"
 }