辅助服务的作用
SPV 模式验证区块头和钱包活动，而不存储完整的 Handshake 链状态。辅助服务提供 Bob 无法在本地可靠重建的已索引区块、交易、币、手续费估算和域名状态。
辅助服务从不接收助记词或私钥，不代用户签名，也不广播交易。Bob 在本地签名，并通过自己的 Handshake 对等节点广播。
开放标准 · 版本 1.0
Bob SPV Helper API v1
用于将 Bob 的轻量 SPV 钱包连接到完整验证的 Handshake 节点只读数据的供应商中立契约。
服务提供者要求
- 通过 HTTPS 在稳定的基础 URL 上提供 API。
- 使用完全同步、未裁剪的主网 HSD 全节点。
- 启用交易索引和地址索引。
- 仅提供文档列出的只读 REST 路由和 JSON-RPC 方法。
- 保留标准 HSD 响应含义及以整数 dollary 表示的金额。
- 拒绝钱包、挖矿、管理及更改状态的 RPC 方法。
- 保护私有 HSD API 密钥，并在 HSD 前部署受限网关。
必需的 API 接口
| 方式 | 路径 | 用途 |
|---|---|---|
| GET | /hsd | 节点信息 |
| GET | /hsd/block/:id | 区块查询 |
| GET | /hsd/tx/:hash | 交易查询 |
| GET | /hsd/coin/:hash/:index | 当前币查询 |
| POST | /hsd/tx/address | 地址历史 |
| POST | /hsd | 允许的只读 JSON-RPC |
必需的 JSON-RPC 方法为 estimatesmartfee、getblockbyheight、getblockchaininfo、getnamebyhash、getnameinfo 和 verifymessage。
安全的域名注册
Bob 为 REGISTER 交易配资或签名前，必须通过配置的辅助服务查询 getnameinfo，并核验域名、域名哈希、CLOSED 状态、拍卖高度、获胜输出点、注册状态及最终拍卖金额。
REGISTER 输出必须严格等于 result.info.value。该值为整数 dollary 金额。info.highest、区块浏览器标签、渲染后的 HTML 及十进制显示字符串绝不能替代它。零金额获胜仍然有效。
如果辅助服务响应缺失，或与 Bob 本地钱包状态不一致，Bob 必须在签名或广播前停止。
互操作性与符合性
Bob 必须能与任何符合标准的提供者配合；交易规则不得依赖提供者主机名。允许响应增加未知字段，但更改字段含义或金额单位需要新的主版本。
在 2026 年 8 月 7 日的在线对比中，旧 HandshakeAPI 提供者与 LearnHNS 返回的共识关键域名数据完全一致。LearnHNS 仅增加了可选的 start.locked 字段。
阅读或下载 Markdown 标准文档（英语）。参考网关针对本契约维护自动化提供者审计和兼容性测试。
当前提供者
- LearnHNS：
https://spv.learnhns.com/hsd - 旧服务：
https://api.handshakeapi.com/hsd，预计于 2026 年 8 月 31 日后停止运行。
列出提供者是为了记录兼容性，并不表示托管或背书。在 Bob LearnHNS 中，用户可在 Settings → Network & Connection → SPV Helper API 下配置其他经过审计的 v1 提供者。原版 Bob 2.1.0 没有辅助服务 URL 设置，无法完成此切换。