@exodus/bitcoin-api

中文文档
5.0.14发布于 2026/11/11MITES Module近 30 天下载 2.3万

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

中文使用文档
文档目录4 节
  1. 透视读取恢复
  2. Mempool WebSocket 辅助确认检查
  3. Mempool 重试后
  4. Mempool 请求排程

@ exodus/ 比特币- api

交易显示器,收费显示器,带区块链节点的RPC,以及比特币和比特币类资产(如多克币,立特币,zcash)的其他网络编码. 见 资产包 更详细地介绍这个包的作用.

透视读取恢复

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 共发布 207 个版本,首次发布于 2022/11/22;过去 12 个月发布了 55 个版本。

版本发布日期距今
5.0.14latest2026/11/113 天前
5.0.132026/11/0410 天前
5.0.122026/11/0410 天前
5.0.112026/10/2817 天前
5.0.102026/10/2817 天前
5.0.92026/10/2025 天前

其他发布通道:beta → 2.3.8-ordinals.1,alpha → 2.5.0-alpha.0。

关于 @exodus/bitcoin-api 的常见问题

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