@alexbosworth/fiat

中文文档
3.1.0发布于 2026/11/07MIT近 30 天下载 1812

菲亚特费率库

中文使用文档
文档目录4 节
  1. chainRates
  2. getPrices
  3. 脚本
  4. 释放

菲亚特方法

处理无价价格的方法.

chainRates 仅从链式数据中得出价格 医生/医生。直到 装有包件的放行船 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 共发布 8 个版本,首次发布于 2021/11/15;过去 12 个月发布了 2 个版本。

版本发布日期距今
3.1.0latest2026/11/071 天前
3.0.02026/10/2613 天前
2.0.02023/06/263 年前
1.0.42023/01/063 年前
1.0.32022/06/114 年前
1.0.22022/04/034 年前

关于 @alexbosworth/fiat 的常见问题

@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 和提交记录判断。