# @exodus/bitcoin-api 中文文档

规范地址：https://npmcn.com/package/%40exodus/bitcoin-api/

版本：5\.0\.14
npm 元数据更新时间：2026-11-10T22:03:06.560Z
中文译文更新时间：2026-11-14T03:55:06.599Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40exodus/bitcoin-api
原文对照：https://npmcn.com/package/%40exodus/bitcoin-api/?lang=original
项目主页：https://github.com/ExodusMovement/assets/tree/master/bitcoin/bitcoin-api
源码仓库：https://github.com/ExodusMovement/assets

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

- 包体积（解压后）：369 kB，71 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：28 个
- 首次发布：2022-11-22T09:15:28.277Z
- 最新版本发布：2026-11-10T22:03:06.322Z
- 近 30 天下载量：23058（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：207（近 12 个月 55 个）

## 中文简介

比特币交易和收费显示器,带区块链节点的RPC,其他网络代码.

## 安装

```sh
npm install @exodus/bitcoin-api
```

也可以使用：`pnpm add @exodus/bitcoin-api`、`yarn add @exodus/bitcoin-api`、`bun add @exodus/bitcoin-api`

## README

# @ exodus/ 比特币- api

交易显示器,收费显示器,带区块链节点的RPC,以及比特币和比特币类资产(如多克币,立特币,zcash)的其他网络编码. 见 [资产包](https://npmcn.com/package/docs/asset-packages.md) 更详细地介绍这个包的作用.

## 透视读取恢复

Insight JSON读取了重试错误的JSON,常见的瞬态网络故障,以及最多两次的HTTP 500/502/503/504响应. 重复等待一至两秒钟,0-20%正焦急,尊重更长的时间 `Retry-After` 秒或 HTTP 日期。 所有尝试,响应-body读取,并等待共享30秒的最后期限,或更短的呼叫者超时(块高为10秒). 超过最后期限的重试失败, 而不是等待更长的时间, 或在服务器允许之前重试 .

取消和永久的HTTP出错,包括429个出错,不为本政策所重审. 现有交易未发现的行为被保留;变形的JSON从不被作为空余或缺失的交易处理. 地址-历史读取保留其单独的可配置重试政策,而不设嵌入式重试. 广播不使用复读政策.

## Mempool WebSocket 辅助确认检查

只确认扫描再利用 WebSocket 交易状态和块高10秒,每个客户最多有1000个状态. 缺少或过期的提示返回到 `/api/tx/:txid/status` 而不是全部交易/支出。 新建或替换块,断开,停止,后端的更改会使缓存无效;独立确认需要新的提示查询. 完整历史,UTXO,地址-事件,再连接调节保持不变,Insight后置显示器也是如此.

如果一个 WebSocket 更新、 断开或后端更改在搜索过程中到达, 则确认检查会重新检查其输入 。 他们重试一次,然后失败,而不是如果再次作废就退回过时的确认.

## Mempool 重试后

每个HTTP 429开始一个进程本地冷却,在客户端和端点之间共享同一来源. 有效 `Retry-After` 秒或 HTTP 日期优先, 使用服务器的 `Date` 可用时为时钟skew,封顶为5分钟. 缺少或无效的值使用十秒倒计时;失败的恢复以0-20%的正焦点将它翻倍,同样以5分钟为上限。 由原爆出并发的响应不会乘以回放,但保留了较长的服务器最后期限. 冷却或恢复期间发送的429个广播更新了已读冷却,包括缺失或无效的倒计时 `Retry-After`;旧的恢复反应不能释放新的冷却。 广播不会因为失败的恢复而增加倒数.

读取接收到HTTP 429的读取器重新加入队列的尾部,而不是立即失败显示器扫描. 每个读取许可最多两次, 共享其30秒排队的原定期限; 取消、 溢出或过期仍然最终失败 。 已耗尽的重试失败 `429`, (中文(简体) ), `finalError`边框 `retryAt`编号 :`retryAfterMs`提示 `mempoolRateLimited`; 通用重试停止. 排队读取 等待一个恢复读取可以运行, 包含其身体的10秒超时。 成功或普通的404会释放出冷却;其他HTTP,运输,或机体故障会更新. 当队列为空时不生成恢复请求 .

## Mempool 请求排程

最多两个REST请求同时运行,包括体能消耗,启动之间至少200米. 读取队列 FIFO, 以100个条目为限, 并等待30秒, 包括冷却。 中止信号删除已队列的请求; 过期或已取消的条目不会在稍后发送 。 正常请求有30秒的调度时间超时,包括机体,同时尊重较短的呼叫者超时. 历史扫描一次提交两个地址批次,同时保留全部地址覆盖; Insight contention是不变的.

广播在排队前跳出,只有在有请求容量时才能读取. 活动请求和广播等待时间间隔 保留两个请求的空档;当两个空档被占用或保留时,新广播立即失败 `MEMPOOL_REQUEST_BUSY` 财务报告和审定财务报表 `finalError`,不自动重试或以后发送。 已读队列限制不消耗广播容量. 接受的广播保留了FIFO的顺序和200ms的相距,原有的一秒排队期限;过期的广播最终以 `MEMPOOL_REQUEST_QUEUE_TIMEOUT`. 积极要求不中断。 新建和排队的广播绕过本地冷却和恢复等待. 广播从不成为回收探测器,其成功不会释放读取冷却. 接收到429分机的分机广播仍然建立读取冷却并失败而不自动回放.

每次尝试都适用排队和要求最后期限。 发送包装器在10秒后可以重试一次非最终的广播故障,因此两次尝试间距等待和网络超时总共可以约72秒,不包括交易准备和故障后检查. 广播客户端目前不接受一个呼叫者取消信号;消费者应当等待发送结果,而不是假设一个更早的UI超时取消.

恢复使交通恢复了速度,而不是爆发了。 这种客户预算不是供应商配额,不能保证不受费率限制或禁令的限制。 5分钟的上限可能允许比服务器请求的时间更早提出请求;排队和冷却不会被持续或协调跨进程.

## 常见问题

### @exodus/bitcoin-api 是什么？

比特币交易和收费显示器,带区块链节点的RPC,其他网络代码\.

### 如何安装 @exodus/bitcoin-api？

在项目目录运行 npm install @exodus/bitcoin-api，或使用 pnpm add / yarn add / bun add。

### @exodus/bitcoin-api 支持 TypeScript 吗？

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

### @exodus/bitcoin-api 支持 ESM 还是 CommonJS？

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

### @exodus/bitcoin-api 可以商用吗？

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

### @exodus/bitcoin-api 的下载量有多少？

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

### @exodus/bitcoin-api 还在维护吗？

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