比特币专题

syncwithvalidationinterfacequeue：RPC 之间的账本时差怎么消除

钱包余额落后于块高、索引进度追不上链，多半是验证接口队列还没消费完。本文按 v31.0 源码讲清这条无参数同步命令到底等的是什么队列、它在回归脚本与排障里的正确用法，以及为什么它不能修复卡住的同步。

getrawaddrman 逐格读地址库：new 与 tried 两表的桶位全景

对比只看计数的 getaddrmaninfo，实验性命令 getrawaddrman 把比特币节点地址管理器的 new 与 tried 两表按桶位逐条展开，连介绍人 source 与 asmap 归属都原样给全。本文讲它的输出结构、三类取证用法与实验性标签的实际含义。

listpayments 的索引语义：排他边界、稳定编号与双向游标

LND 付款历史用索引而不是时间游标翻页：index_offset 排他、编号与个体付款绑定不随新记录漂移，first 与 last 两个游标支持双向续读。本文按接口定义讲这套分页语义、include_incomplete 与三本账的对账顺序。

walletbalance 与 channelbalance：闪电资金的两层四组读数

闪电节点的钱分住两层：内置钱包的链上 UTXO 与通道的本地份额，LND 用 walletbalance 和 channelbalance 两个接口分别记账。本文拆完五个链上字段与四档通道字段，给出一条三分钟对账动线和单位纪律。

estimaterawfee 的透视输出：decay、scale 与 pass/fail 费率区间

与 estimatesmartfee 的温和报价不同，estimaterawfee 把估算器内部的桶统计原样摊开：逐块指数衰减 decay、目标分辨率 scale，以及满足 0.95 阈值的 pass 区间与不达标的 fail 区间。本文逐项读这些字段，并说明它更适合诊断而非下单。

mockscheduler 拨快调度器：regtest 里让周期任务当场兑现

比特币核心的调度器排着地址库落盘、巡检、重广播等周期杂务，mockscheduler 把这台钟向前拨 1 到 3600 秒，让任务立即到期——但它被链类型检查锁死在 regtest。本文讲它拨的是哪台钟、和 setmocktime 的分工，以及测试纪律。

一次请求发多条命令：比特币节点 RPC 的批量数组与通知规则

比特币核心的 RPC 服务允许把多条 JSON-RPC 请求装进一个 JSON 数组一次发出，v31.0 源码规定了批量请求的鉴权顺序、错误打包方式和通知不回复语义。本文按源码拆解批量请求的排序规则、白名单联动与超时边界，并给出对账脚本里的正确用法。

getorphantxs：把节点孤儿交易库摆到台面上的实验性命令

比特币核心的 getorphantxs 是一条实验性的隐藏 RPC，能把节点暂存的孤儿交易列出来。本文按 v31.0 源码拆它的三档 verbosity、返回字段、隐藏分类身份，以及排障时它和 mempool 查询、日志线索怎么配合。

sendmsgtopeer：给指定对端手工发一条 P2P 消息的测试后门

比特币核心有一条藏在 hidden 分类里的 sendmsgtopeer，能向指定 peer 发送任意类型的原始 P2P 消息。本文按 v31.0 源码拆解它的三个参数、消息头自动拼装规则、滥用后的断连后果，以及它与集成测试的关系。

getdifficulty 返回的小数是怎么算的：难度倍数的浮点折算与误差

getdifficulty 返回的是一笔浮点数——当前难度相对最低难度的倍数。本文按 v31.0 源码拆解它从 nBits 紧凑编码折算成小数的过程、与 getblockstats 难度字段的分叉点，以及为什么监控脚本不该拿它做精确比较。