比特币专题

钱包标志七件套：flags 数组里哪一项能改、哪六项落子无悔

getwalletinfo 的 flags 对应 v31.0 源码中固定的字符串映射表，可变的只有 avoid_reuse 一项。本文逐项解读 disable_private_keys、blank、external_signer 等标志的含义、设置时机与不可逆边界。

validateaddress 查不了归属：地址校验与钱包归属的命令边界

validateaddress 与 getaddressinfo 在 0.18 版后分工明确：前者只判结构合法并给出 error_locations 纠错位置，后者才回答地址归不归本钱包。本文按 v31.0 RPC 文档梳理两者的字段边界与实操顺序。

区块时间只能领先两小时：time-too-new 拒绝与 timeoffset 排障

v31.0 源码把区块未来时间上限写死为两小时，配合前序区块时间中位数构成时间戳的窄带约束。本文拆解 MAX_FUTURE_BLOCK_TIME 的两端逻辑，给出 timeoffset 异常与本机时钟漂移的定位顺序。

密钥池不是地址上限：keypoolrefill、range 导入与恢复扫描的三条线

描述符钱包的 keypool 是每条描述符一千个条目的预生成窗口而非地址总数。本文以 v31.0 文档为准，讲清补池触发时机、Keypool ran out 报错处置、恢复时靠 range 导入找回扫描盲区的方法。

RPC 返回 -28 不是故障：预热状态文本从哪来、脚本该怎么等

比特币核心的 RPC 端口先于子系统就绪开放，预热期所有命令统一返回负 28 号错误并附带实时初始化进度文本。本文按 v31.0 源码拆解 warmup 接线方式与监控脚本的正确等待姿势。

help 里查不到的造块命令：generateblock 的四步组装与取证用法

generateblock 与 generatetoaddress 在 v31.0 的注册表里被标为 hidden，却完整暴露了一个区块从 coinbase 到 nonce 的组装流程。本文按源码拆解指定交易入块、跳过内存池、process_new_block 导块三个能力的边界。

bitcoin.conf 的三重空间：合法小节、NETWORK_ONLY 参数与 settings.json

比特币核心配置有顶层、网络小节与持久化设置三层：只有五个小节名合法，网络专属参数放错层直接拒绝启动。本文依据 v31.0 源码梳理小节规则、includeconf 限制与最终生效值的核对方法。

avoidpartialspends 开关：按地址归组选币的隐私收益与手续费账单

部分花费会暴露同一地址其余进账的存在感。本文以 v31.0 参数帮助文本与源码为准，拆解按地址归组选币的隐私逻辑、费用代价、与 avoid_reuse 的强制绑定关系，给出启用路径与预期校准。

服务位不能空承诺：peerblockfilters 与 blockfilterindex 的配对规则

比特币核心要求开启区块过滤器服务位必须同时启用过滤器索引。本文依据 v22 至 v31 源码梳理两个参数的依赖逻辑、默认值版本事实、磁盘代价与服务位点亮条件。

花不花未确认的找零：spendzeroconfchange 开关与它的三类故障

比特币核心钱包默认允许用未确认的内部找零继续拼交易。本文依据 v31 源码拆解该开关的选币语义、链条断裂与自我双花的成因，以及关闭后的代价与配置建议。