@exodus/balances

中文文档
13.17.3发布于 2026/11/14MITTypeScriptES Module近 30 天下载 1.4万

通过已启用的钱包账户跟踪加密余额 .

中文使用文档
文档目录7 节
  1. 安装
  2. 使用量
  3. 来玩吧
  4. API 边
  5. UI 侧
  6. 捐款
  7. 警告:没有资产细节!

@ exodus/ 余额

此 Exodus SDK 特性跟踪所有启用的钱包账户的加密计价余额 。 以菲亚特计价的余额,请核对 @ exodus/ fiat- 平衡。 。 。 .

安装

pnpm add @exodus/balances

使用量

此特性设计为与 @exodus/headless。见 使用 sdk。 。 。 .

来玩吧

  1. 打开游乐场 https://exodus-hydra.pages.dev/ 页面存档备份,存于互联网档案馆
  2. 运行 selectors.balances.byAsset(store.getState()) 在Dev Tools Console中,以在已启用的钱包账户中通过资产汇总来获取余额.
  3. 试试其他选择者 selectors.balances。参见示例使用 测试。 。 。 .
  4. 用平衡键锁定地址,勾选区块链显示器并检查您的平衡.
// 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())
  .toString()

API 边

见 使用 sdk 更多关于特性插入SDK的细节。 注意,余额特性目前不提供顶级API,意在纯粹通过选择器使用.

如果你正在构建一个需要平衡的特性, 加上对 balancesAtom 现改为: 另见 可用余额字段。 。 。 .

const myModuleDefinition = {
  id: 'myModule',
  type: 'module',
  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 侧

见 使用 sdk 关于基本UI侧设置的更多细节.

import { selectors } from '~/ui/flux'

const MyComponent = () => {
  const bitcoinBalance = useSelector(
    selectors.balances.createSpendable({
      assetName: 'bitcoin',
      walletAccount: 'exodus_0',
    })
  ) // returns a NumberUnit
}

捐款

警告:没有资产细节!

不引入任何资产细节, 如 if (assetName === 'dogicorn') balance = balance.mul(2)所有特定资产都属于 asset.api.getBalances 或资产库内的其他 API.

版本与发布记录

@exodus/balances 共发布 91 个版本,首次发布于 2022/08/02;过去 12 个月发布了 13 个版本。

版本发布日期距今
13.17.3latest2026/11/14今天
13.17.22026/11/14今天
13.17.12026/11/13今天
13.17.02026/11/13今天
13.16.12026/10/101 个月前
13.16.02026/05/195 个月前

其他发布通道:alpha → 13.0.0-alpha.2。

关于 @exodus/balances 的常见问题

@exodus/balances 是什么?

通过已启用的钱包账户跟踪加密余额 .

如何安装 @exodus/balances?

在项目目录运行 npm install @exodus/balances,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@exodus/blockchain-metadata(^17.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@exodus/balances 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@exodus/balances 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@exodus/balances 可以商用吗?

@exodus/balances 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@exodus/balances 的下载量有多少?

根据 npm 官方下载统计,@exodus/balances 在 2026/10/14 – 2026/11/12 这 30 天内被下载 13,764 次,日均约 459 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@exodus/balances 还在维护吗?

最新版本 13.17.3 发布于 2026/11/14(今天);至今共发布 91 个版本,其中过去 12 个月发布了 13 个;首次发布于 2022/08/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。