getwalletinfo怎样判断钱包状态？

getwalletinfo经常被当成“查余额”的接口，但Bitcoin Core 31的真实定位是钱包运行状态快照。自Bitcoin Core 30起，balance、unconfirmed_balance与immature_balance已经从这个响应移除；继续按旧schema取值，会把字段缺失误报成零余额或接口故障。

先把状态接口与余额接口拆开

getwalletinfo返回钱包名称、格式、版本、交易数、密钥池、扫描、加密、签名能力与最近处理区块等状态；余额应调用getbalances。

监控端为两个RPC保存不同schema和采集状态，不能在getwalletinfo缺少余额字段时补零。升级Bitcoin Core前先对测试节点保存完整响应并生成字段diff，确认解析器对新增、删除和条件字段都能容忍。

数据任务	当前接口	关键证据	常见错误
钱包运行状态	getwalletinfo	walletname、scanning、lastprocessedblock	仍读取旧余额字段
余额分项	getbalances	mine、watchonly等分组	与钱包状态混成一次成功
节点链状态	getblockchaininfo	blocks、headers、bestblockhash	用钱包高度代表节点同步
地址能力	getaddressinfo等	ismine、solvable、desc	用unlocked_until代替可签名证据

状态采集成功而余额采集失败时，页面应显示“余额未知”，不能因为钱包可访问就沿用上次金额；反过来，缓存余额存在也不能证明扫描和链位置已经就绪。

scanning必须按联合类型解析

scanning为false或包含duration与progress的对象。false表示当前没有扫描，对象才描述正在进行的扫描任务。

progress只是当前扫描过程的进展视图，不是余额正确率，也不是到账承诺。扫描期间交易数和getbalances结果可能继续变化；依赖完整历史的对账任务可以进入“扫描中”状态，但不应把progress达到某个百分比直接当成资金可用。

abortrescan属于人工批准的处置。告警系统可以提示扫描异常持续时间，却不应自动终止任务；终止前要记录任务来源、数据完整性影响和后续重扫计划。

解锁时间与签名能力不是一回事

unlocked_until只适用于相应的加密钱包；private_keys_enabled、descriptors、external_signer和blank描述的是不同能力组合。

private_keys_enabled为false的钱包可能是观察钱包或依赖外部签名器。external_signer存在也不证明设备在线、策略允许或目标地址可签。系统应展示字段组合，并用实际地址信息与受控签名演练确认能力，不能只做一个“已解锁”绿灯。

密码、助记词和walletpassphrase不能写入采集日志。监控只记录状态与时间，不保留任何能够恢复或解锁钱包的秘密。

密钥池与交易数只适合做趋势

txcount、keypoololdest、keypoolsize与keypoolsize_hd_internal可用于发现交易记录和地址池变化，但不能证明备份可恢复。

密钥池快速下降时，先确认钱包格式、地址生成速率和业务任务，再决定是否补充。恢复能力应由描述符或密钥材料的离线备份、校验和恢复演练证明；“密钥池还有很多地址”不是备份结论。

对于条件不适用而缺失的字段，采集器保留not-applicable；RPC超时或钱包未加载则记为unknown。二者都不能变成数值零。

lastprocessedblock要与节点链状态交叉

lastprocessedblock给出钱包最近处理区块的hash和height，它回答钱包处理位置，不单独证明节点已经同步。

同一节点再取getblockchaininfo的blocks、headers、bestblockhash与initialblockdownload。钱包高度落后时区分扫描、导入、启动恢复和正常处理延迟；高度相同但哈希不同，则保留原始响应并检查重组或读取时差。

重启验收至少检查钱包成功加载、scanning类型正确、lastprocessedblock持续推进、getbalances独立成功、关键地址能力可解释。任何一项unknown都不显示“完全就绪”。

用版本化合同避免再次踩旧字段

生产指标保存节点版本、钱包名、钱包格式、RPC方法、采样时间与原始响应哈希。升级时运行兼容性测试：旧解析器遇到未知字段不能崩溃，新解析器遇到已删除字段不能补零，页面还要标出最后成功时间。

相关站内主题：getbalances对账、listwalletdir与listwallets、listdescriptors审计。本文用于技术教育与防御性运维，不构成资产安全保证。

资料台账与适用边界

Bitcoin Core 31 getwalletinfo：当前钱包状态字段。
Bitcoin Core 31 getbalances：当前余额分组接口。
Bitcoin Core 31 getblockchaininfo：节点链状态对照。
Bitcoin Core 30 getwalletinfo：升级后的接口形态交叉核验。

资料访问时间为2026-08-08。字段集合仍会随版本与钱包格式变化，监控必须按部署版本复核。