# @alexbosworth/fiat 中文文档

规范地址：https://npmcn.com/package/%40alexbosworth/fiat/

版本：3\.1\.0
npm 元数据更新时间：2026-11-07T00:12:04.596Z
中文译文更新时间：2026-11-08T09:57:06.966Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40alexbosworth/fiat
原文对照：https://npmcn.com/package/%40alexbosworth/fiat/?lang=original
项目主页：https://github.com/alexbosworth/fiat#readme
源码仓库：https://github.com/alexbosworth/fiat

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：373 kB，113 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2021-11-15T00:26:18.986Z
- 最新版本发布：2026-11-07T00:12:04.472Z
- 近 30 天下载量：1812（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 2 个）

## 中文简介

菲亚特费率库

## 安装

```sh
npm install @alexbosworth/fiat
```

也可以使用：`pnpm add @alexbosworth/fiat`、`yarn add @alexbosworth/fiat`、`bun add @alexbosworth/fiat`

## README

# 菲亚特方法

处理无价价格的方法.

`chainRates` 仅从链式数据中得出价格 [医生/医生](https://npmcn.com/package/%40alexbosworth/fiat/docs/METHODOLOGY.md)。直到 装有包件的放行船 `chain/known/known_prices.json`。 。 。 .

## `chainRates`

从链条数据中获取BTC历史美元价格的方法

当给出 `blocks_path`最后三天的付款产出 块被保存在文件中,以便以后查看,包括那些 后行,只取出新块. 块保存到原样 接通了,所以跑道被阻止了 穿过它的地方 离开。 用另一种方法保存的块会再次取出 无法读取或写入文件会被登录,仅意味着再次取回. 文件必须独立于价格文件,可以被删除.

```
{
  [blocks_path]: <Kept Blocks File Path String>
  fs: {
    getFile: <Read File Contents Function> (path, cbk) => {}
    makeDirectory: <Make Directory Function> (path, cbk) => {}
    renameFile: <Rename File Function> (from, to, cbk) => {}
    writeFile: <Write File Contents Function> (path, contents, cbk) => {}
  }
  lnd: <Authenticated LND API Object>
  [logger]: <Winston Logger Object>
  path: <Prices File Path String>
}

@throws
<Error>

@returns
{
  getChainRate: <Get Chain Rate Method> ({
    currency: <Currency To Price String> // BTC
    date: <Date To Price ISO 8601 Date String> // priced on its day in UTC
    fiat: <Fiat Currency To Price In String> // USD
  }, cbk) => (err, {
    cents: <US Cents Per BTC on the Day of the Date Number>
  })
}
```

## `getPrices`

从汇率提供者获取汇率

```
{
  [date]: <Rates At the Hour of ISO 8601 Date String>
  from: <From Rate Provider String>
  request: <Request Function> {url}, (err, {statusCode}, body) => {}
  symbols: [<Fiat Symbol String>] // empty defaults to USD
}

@returns via cbk or Promise
{
  tickers: [{
    date: <Rate Updated At or Hour Priced At ISO 8601 Date String>
    rate: <Exchange Rate in Cents Number>
    ticker: <Ticker Symbol String>
  }]
}
```

## 脚本

-   `npm test` 运行快速测试并报告其覆盖范围
-   `npm run test-all` 并运行在 `test/slow`,从 模拟链的价格,并报告所有测试的覆盖面
-   `npm run check-prices` 将连锁价格同每日小时价格进行比较 ,在《京都议定书》 方法。 没有天数,它检查最近3个完整的天数,或者 数量 `--days`
-   `npm run update-known-prices` 使运出的价格达到最新水平,因为 下描述
-   `npm publish` 第一次运行 `scripts/check_known_prices.js`,从而停止 当运出的价格还没有准备好发布时公布

例如,比较两天没有相邻价格的定价 引导 :

```
npm run check-prices -- 2024-08-05 2024-08-08 --unguided
```

读取链条的脚本到达比特币核心 `http://127.0.0.1:8332` 在默认数据目录中使用 cookie, 或由 `BITCOIN_RPC_URL`, (中文(简体) ), `BITCOIN_RPC_COOKIE`,或 `BITCOIN_RPC_USER` 财务报告和审定财务报表 `BITCOIN_RPC_PASSWORD`。 。 。 .

## 释放

释放物通常会按最高时日的价格运出,这样一来,人们就会发现 这些日子不必从铁链中得出:

1.  用比特币 核心同步, 运行 `npm run update-known-prices`. 它会产生 运出日的最后一周的价格,必须公布 同样的,然后增加价格 每一天他们之后。 每个 新的价格必须在Coinbase交易日的范围之内 以每小时价格的中位数5%以内,每天 检查失败时会停止运行而不更改表格
2.  看看跑道末期的总结,它显示了新跑道有多远 价格取自当日小时价格的中位数. 高点 中位数或95分之一,或偏差,表示价格与 交易不如以前好,尽管每天都通过检查
3.  运行 `npm run test-all`,包括: `npm test` 离开
4.  提交 `chain/known/known_prices.json` 与释放
5.  运行 `npm publish`,以检查所发运的价格是否为当前价格 该方法的版本, 从最早支持的一天开始, 有价格 日复一日,到达现在的一周之内 他们不

当方法改变版本时,每天都会再次产生,这需要 简表还显示价格从2002年到2002年的变动幅度 最后一张桌子.

要发布没有新价格 `npm publish --ignore-scripts`, (中文(简体) ), 它跳过支票。 该表仍必须是目前版本的 因为没有使用其他版本的价格,所以首先运行 `node scripts/check_known_prices.js` 并看到价格的年代是 只有问题 它报告。 查查最后运出价格的后几天 从铁链中取出.

## 常见问题

### @alexbosworth/fiat 是什么？

菲亚特费率库

### 如何安装 @alexbosworth/fiat？

在项目目录运行 npm install @alexbosworth/fiat，或使用 pnpm add / yarn add / bun add。

### @alexbosworth/fiat 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/alexbosworth\_\_fiat 是否存在。

### @alexbosworth/fiat 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @alexbosworth/fiat 可以商用吗？

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

### @alexbosworth/fiat 的下载量有多少？

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

### @alexbosworth/fiat 还在维护吗？

最新版本 3\.1\.0 发布于 2026/11/07（1 天前）；至今共发布 8 个版本，其中过去 12 个月发布了 2 个；首次发布于 2021/11/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。