@exodus/fiat-balances

中文文档
13.8.0发布于 2026/11/09MITTypeScriptES Module近 30 天下载 1.1万

根据密码余额和用户首选的货币的变化,跟踪资产和证券组合余额

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 来玩吧
  4. API 边
  5. UI 侧

@ exodus/ fiat- 平衡

基于应用程序的地由和 用户首选的货币。对于加密计价余额,请核对 @ exodus/ 余额。 。 。 .

安装

pnpm add @exodus/fiat-balances

使用量

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

来玩吧

  1. 打开游乐场 https://exodus-hydra.pages.dev/ 页面存档备份,存于互联网档案馆
  2. 运行 selectors.fiatBalances.byAsset(store.getState()) 在Dev Tools Console中,通过已启用的钱包账户,按资产汇总来获取无益余额.
  3. 试试其他选择者 selectors.fiatBalances。参见示例使用 测试。 。 。 .
  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 ETH balance in the user's preferred currency
selectors.fiatBalances.byAsset(store.getState()).ethereum.toDefaultString({ unit: true }) // 123.45 USD
// change currency
await exodus.locale.setCurrency('EUR')
selectors.fiatBalances.byAsset(store.getState()).ethereum.toDefaultString({ unit: true }) // 6.78 EUR

API 边

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

如果你正在构建一个需要平衡的特性, 加上对 fiatBalancesAtom 现改为:.

const myModuleDefinition = {
  id: 'myModule',
  type: 'module',
  factory: ({ fiatBalancesAtom }) => {
    const doSomethingSpecial = async () => {
      const { balances } = await fiatBalancesAtom.get()
      console.log(
        '>>> total wallet balance',
        balances.totals.balance.toDefaultString({ unit: true })
      )
    }

    return {
      doSomethingSpecial,
    }
  },
  dependencies: ['fiatBalancesAtom'],
}

UI 侧

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

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

const MyComponent = () => {
  const totalWalletBalance = useSelector(
    selectors.fiatBalances.optimisticTotalBalance(store.getState())
  ) // returns a NumberUnit

  // create a function to convert ethereum to the user's preferred currency
  const ethToFiat = useSelector(selectors.fiatBalances.createAssetConversion('ethereum'))
  const ethBalanceInFiat = ethToFiat(ethereum.currency.defaultUnit(1))
}

版本与发布记录

@exodus/fiat-balances 共发布 90 个版本,首次发布于 2022/08/10;过去 12 个月发布了 8 个版本。

版本发布日期距今
13.8.0latest2026/11/094 天前
13.7.52026/10/101 个月前
13.7.42026/05/195 个月前
13.7.32026/03/068 个月前
13.7.22026/02/268 个月前
13.7.12026/02/049 个月前

关于 @exodus/fiat-balances 的常见问题

@exodus/fiat-balances 是什么?

根据密码余额和用户首选的货币的变化,跟踪资产和证券组合余额

如何安装 @exodus/fiat-balances?

在项目目录运行 npm install @exodus/fiat-balances,或使用 pnpm add / yarn add / bun add。

@exodus/fiat-balances 支持 TypeScript 吗?

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

@exodus/fiat-balances 支持 ESM 还是 CommonJS?

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

@exodus/fiat-balances 可以商用吗?

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

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

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

@exodus/fiat-balances 还在维护吗?

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