GetBlock Bitcoin 历史查询失败：检查 txindex 与端点认证
链小知 · 进阶 · 核验 · 依官方文档整理
读取已有 getindexinfo 记录，把索引未同步、错误网络和 token 失败分开；不拿索引状态代替单笔交易确认。
开始前准备
- 准备 Bitcoin 网络、当前账户 endpoint 标识、历史查询的原始错误及采样时间；所有 token 已脱敏。
- 准备相近时间同端点的 getindexinfo 响应；没有则将索引状态记为未取得，不自动创建额外调用。
1. 确认 BTC 网络与当前 token 位置
在配置或已有控制台截图核对 endpoint 所选的是 Bitcoin Mainnet/Testnet，不是 Bitcoin SV、Gold 或 Cash。当前认证文档使用 shared.<region>.getblock.io/<ACCESS_TOKEN>/，要求路径 token，明确不能送在 header；旧方法页示例仍用 go.getblock.io，应以账户实际 endpoint 为准。
检查结果：链、网络、区域和端点标识都有记录，未混用其他 Bitcoin 分支或 header token。
2. 检查 getindexinfo 输入
getindexinfo 可不带过滤器，即 params:[]；只查交易索引用 params:["txindex"]。对照已有请求，确认 method 名与参数位置。HTTP 403/Forbidden 或 token 无效先归为认证问题；未知索引名的 -8 与业务查询未找到不是同一个错误。
检查结果：现有请求是正确方法及索引名，认证和 JSON-RPC 错误分别记录。
3. 读取索引同步字段
在成功响应 result 中查看 txindex 对象、synced 和 best_block_height。synced=false 表示该记录中的索引还未同步完；没有返回 txindex 时，只写该响应未列出交易索引，再核对配置和过滤器，不能补写为 synced=true。示例高度不是当前节点高度。
检查结果：保存索引是否返回、synced 原值、best_block_height 和时间，不替缺失字段造数。
4. 限定索引证据能说明的范围
将上述记录与原历史查询失败时间、网络和端点对齐。索引未同步是继续查节点能力的线索；索引同步也不能单独证明某个 txid 一定存在、某笔交易有确认或收款已到账。需要单笔证明时保留 txid 与实际交易记录待查，不从 Bitcoin SV/Gold 方法页复制 BTC 参数来补缺失正文。
检查结果：结论停在索引能力与错误类别，单笔交易与到账状态保持独立待查。
5. 复核 CU、RPS 与 Archive 模式
按当前账户看 Shared 的 CU 余额、RPS 和端点数量。CU 由链、方法和 Archive modifier 计算，Archive-enabled endpoint 的 modifier 作用于发往它的所有请求；不能仅凭方法名估费用。免费日额度与付费月额度周期不同，Limitless 仍受 RPS 档位约束。
检查结果：报告含网络、错误、索引状态和账户模式；缺失的交易证据与费用权重明确列待查。
怎样确认完成
- 输出可追踪的 BTC 网络、端点、认证状态、txindex 同步结果与单笔交易待查项。
- 本教程为官方文档核验，未调用账户端点或验证任一 txid。
常见错误与边界
- synced=true 只对应查询时该节点索引状态，不是某笔交易确认数。
- BTC getrawtransaction 文档路径返回未找到时，应保留缺口，不能拿 BSV 的示例作替代。
- 每日 CU 与每月 CU 不能直接用相同除数估预算。