deriveaddresses如何安全派生？

deriveaddresses 能从输出描述符批量派生地址，但 range、多路径返回结构、xpub隐私与钱包监控状态容易混淆。本文用验收单串起派生前后的安全检查。

派生地址本身不会修改钱包，这是它适合离线核对的原因；但“能算出地址”也最容易带来虚假的安全感。你还需要知道描述符来自哪里、派生了哪个范围、返回结构如何对应分支，以及这些地址是否真的被钱包监控和备份。

入场券：描述符与范围

deriveaddresses根据输出描述符派生一个或多个地址；ranged descriptor需用单个结束索引或[begin,end]明确派生范围。

固定描述符不需要批量范围；包含通配符的 ranged descriptor 则必须明确结束索引或 [begin,end]。生产脚本应拒绝无上限的隐式扩张，并把 begin、end、网络和描述符 checksum 一起写入任务记录。

多路径结果不是一维列表

单路径描述符返回地址数组，多路径描述符按multipath展开顺序返回嵌套数组，调用方不能把两种结构混为一谈。

单路径 -> ["address-0", "address-1", ...]
多路径 -> [
  ["branch-A-address-0", ...],
  ["branch-B-address-0", ...]
]

如果把嵌套数组扁平化后丢失分支位置，接收地址与找零地址可能被错误标注。验收表应保留“multipath 展开序号 + 派生索引 + 地址”三列，抽取首、中、末三个索引与独立钱包复算。

xpub 是只读能力，也是隐私能力

只读xpub也能批量派生并关联地址，分享描述符会扩大隐私暴露；操作前可用getdescriptorinfo标准化表达式并记录checksum。

xpub 不提供花费私钥，却能让持有人推导并聚合同一分支的大量地址。不要把完整描述符贴到工单、公开日志或在线截图中。对外只给完成任务所需的最小分支与最小范围，并为观察系统设置访问控制。

getdescriptorinfo 放在前面做什么

先用 getdescriptorinfo 规范化表达式、确认是否 ranged、是否包含私钥材料，并保存 checksum。它不能证明描述符属于你的钱包，因此还要从离线备份或已验证设备取得可信对照。任何来源不明的描述符都不得因为语法有效就导入生产钱包。

检查点	通过证据	停止条件
语法	标准化描述符与checksum	解析失败或含意外私钥
范围	明确begin/end	范围越界或索引重叠
分支	多路径序号被保留	接收与找零无法区分
归属	独立设备复算地址	抽样地址不一致
监控	钱包导入状态可读	只有派生结果无监控记录

派生完成后的恢复演练

在隔离环境从同一备份恢复描述符，复算相同索引，并比较脚本类型和网络前缀。随后检查生产钱包是否导入了正确时间范围或扫描起点。派生成功但扫描起点错误，会造成历史收款“看不见”，这不是链上丢失，却会严重干扰运营判断。

仍需按具体钱包确认：描述符能否用于实际签名取决于密钥材料与钱包导入状态；派生出地址不等于钱包已经监控、备份或具备花费能力。

参考资料

1. Bitcoin Core deriveaddresses：用于核对接口字段、返回语义和适用边界；访问于 2026 年 7 月 25 日。
2. Bitcoin Core getdescriptorinfo：用于核对接口字段、返回语义和适用边界；访问于 2026 年 7 月 25 日。

建议配合 钱包描述符基础、BIP380描述符语法、getdescriptorinfo检查 阅读。地址派生涉及备份和隐私，任何真实资金操作都应先小额演练。

deriveaddresses如何安全派生的复核演练

从备份中选一个不含私钥的描述符，在离线环境派生三个不连续索引，再由另一套实现复算。复核者需要保留 multipath 分支、索引、脚本类型与地址前缀。如果地址一致但分支标签丢失，仍判定验收失败，因为后续收款与找零归属已经无法可靠恢复。