Bob 文档

使用钱包别名发送 HNS

钱包别名让您可以输入 @pay.example 这样易记的主机名,而非粘贴 Handshake 地址。Bob 会解析地址并验证结果,然后才允许付款。

Bob LearnHNS 2.3.1 提醒:此版本可能将别名查询发送到错误的本地 DNS 端口。请更新至 Bob LearnHNS 2.3.2 以获得永久修复。更新前,可打开设置,将 Alias Resolver 设为 10892,然后返回发送页面。重装 2.3.1 无法修复此问题。

使用别名

  1. 打开 Send(发送)并选择 Send HNS(发送 HNS)。
  2. 输入完整别名,包括开头的 @。
  3. 粘贴别名、按回车键、选择 Resolve alias(解析别名),或在输入后离开该字段,即可开始解析。
  4. 等待 Bob 显示解析出的 HNS 地址和锁定标志。
  5. 继续前请检查主机名和解析出的地址。熟悉的别名不能代替付款核对。

Bob 如何验证

Bob 移除仅用于界面的 @,请求 https://hostname/.well-known/wallets/HNS,并在 _443._tcp.hostname 查询 TLSA 记录。只有 TLS 证书通过 DANE 验证,且地址对当前网络有效时,才接受返回的 HNS 地址。

如果 HIP-2 失败,Bob 会独立查找完全相同主机名上以 hns: 或 hns= 开头的 TXT 记录。只有 DNS 响应通过 Handshake/DNSSEC 身份验证,且地址对当前网络有效时,Bob 才接受此结果。

两种独立的安全方法:HIP-2 托管需要匹配的 TLSA 记录。经过身份验证的 HNS TXT 钱包记录不使用 HTTPS 托管,因此不需要 TLSA 记录。Bob 仍会拒绝未经验证、格式错误、网络不匹配或含义不明确的 TXT 值。

理解错误信息

别名证书与其 TLSA 记录不匹配
别名所有者必须修复 HIP-2。用户收到的证书与发布的 TLSA 记录不匹配。如果另行发布了经过身份验证的 HNS TXT 钱包记录,Bob 仍可使用它;否则,请勿发送。
别名 TXT 后备记录未通过 DNSSEC 身份验证
别名所有者必须修复此问题。Bob 找到了 TXT 后备记录,但无法验证其真实性。DNSSEC 验证成功前,请勿发送。
此别名未发布安全的 HNS 地址
别名所有者必须修复此问题。该主机名既没有可用的 HIP-2 响应,也没有经过身份验证的 hns:/hns= TXT 记录。
别名返回了无效或多个 HNS 地址
别名所有者必须修复此问题。发布的值格式错误、属于其他网络、过大或包含冲突地址。
请输入以 @ 开头的完整别名
您可以修复此问题。请使用完整主机名,例如 @pay.example。如果没有 @,Bob 会将输入内容视为字面 HNS 付款地址。
无法连接别名主机
您或许可以修复此问题。检查拼写和互联网连接后重试。如果只有 Bob LearnHNS 2.3.1 失败,请使用上方解析器端口的临时解决办法。
别名 DNS 查询失败
先检查 Bob。确认 Bob 已同步、DNS 已启用,且设置中的 Alias Resolver 与 Bob 的递归 DNS 端口一致。否则,请稍后重试或联系支持人员。

运营者设置检查清单

  • 通过 HTTPS 从 /.well-known/wallets/HNS 提供一个纯文本 HNS 地址。
  • 在 _443._tcp.your-hostname 发布经过 DNSSEC 身份验证的 TLSA 记录,并使其匹配用户实际收到的证书。
  • 若要提供独立于托管的钱包记录,请发布一个有效 TXT 值,例如 hns:hs1… 或 hns=hs1…,并确保 Handshake/DNSSEC 验证通过。此方法不需要 TLSA。
  • 从托管网络之外进行测试,并检查所有可能服务该主机名的边缘地址或 CDN 区域。
  • 监测证书续期和密钥轮换。CDN 管理的证书可能变化,因此 TLSA 维护可能需要自动化或稳定密钥的证书策略。

检查示例:

dig +dnssec _443._tcp.your-hostname TLSA
dig +dnssec your-hostname TXT
curl https://your-hostname/.well-known/wallets/HNS

隐私与支持

解析别名会对其主机名发出 DNS 和 HTTPS 请求,这可能暴露该主机名曾被查询。Bob 不会向别名主机发送您的助记词、私钥、钱包密码或付款金额。

当前补丁构建会打印注重隐私的终端行,例如 [Bob action] Hip2.fetchAddress failed [ETLSAMISMATCH]。这些行显示操作与结果,不打印别名主机名、解析地址、金额、密码、助记词或交易载荷。终端也会显示 Bob 当前使用的本地 Alias Resolver 端口。

如果别名解析失败,请记录完整的屏幕错误及对应的安全终端操作行,然后通过 Bob 支持渠道求助,不要分享钱包秘密信息。