比特币专题

listinvoices 翻发票台账：四格状态机与两套索引的增量对账

LND v0.19.0-beta 的 listinvoices 把节点签发的收款请求按索引摊开。本文按接口定义核对 OPEN、ACCEPTED、SETTLED、CANCELED 四态语义、签发序与结算序两套索引的成因，以及翻页过滤参数的组合陷阱。

describegraph 导出公开通道图：点边结构、双向报价与看不见的私有边

LND v0.19.0-beta 的 describegraph 一次性导出公开通道图。本文按接口定义核对节点与边的编号规则、每条边两份 policy 的字段含义、include unannounced 的隐私边界和全量拉取的替代姿势。

TrackPayment 盯一笔在途的闪电付款：五种状态、乱序陷阱与重启找回

LND v0.19.0-beta 的 router 服务用 TrackPaymentV2 按付款哈希流式推送状态。本文按接口定义核对五种状态、只看终态开关的代价、订阅时机导致的乱序问题与崩溃后找回在途单子的办法。

mempool推荐费率API怎么读？

mempool.space recommended fees 返回多个确认速度档位。本文解释 fastest、halfHour、hour 和 economy 的口径与局限。

RPC 的 cookie 谁能读、批量怎么回：比特币核心的 Basic 认证与 HTTP 行为

Bitcoin Core v31.0 的 RPC 服务端只实现 Basic 认证，凭据默认来自每次启动重新生成的随机 cookie 文件。本文按 httprpc.cpp 与 request.cpp 核对 cookie 校验、rpccookieperms 三档权限、cookie 与 rpcauth 共存关系，以及 JSON-RPC 批量数组在 HTTP 层的 200/204 规则。

通道容量大不等于放得下你的付款：htlc_maximum_msat 的窗口语义

闪电 channel_update 的 htlc_maximum_msat 是转发方的单边意愿上限，独立于通道容量。本文按 BOLT #7 拆解上下沿窗口、大于容量即拉黑的异常判定、两周未更新的剪枝建议，以及运营侧改参数的正确姿势。

日志前缀的四个开关：logtimestamps、logtimemicros、logthreadnames 与 logsourcelocations

Bitcoin Core v31.0 的 debug.log 前缀由四个启动参数控制：时间戳默认开，微秒、线程名、源码位置默认关。本文按 logging 源码与发布说明核对默认值、拼装顺序、v31 把源码位置收敛为函数名的改动，以及 logging RPC 热开关的真实边界。

别再问错在哪：incorrect_or_unknown_payment_details 堵上的探测漏洞

BOLT #4 把旧版区分金额错误与哈希未知的最终节点失败码合并为编号 15 的永久码，动机是堵住用错误码差分定位收款节点的探测攻击。本文核对合并语义、htlc_msat 冗余字段、height 字段用途与失败码分层。

洋葱回包的 32 KiB 预算：失败载荷、截断兼容与归属数据

BOLT #4 规定洋葱错误回包总长不超过 32768 字节，中间节点遇超长回包截取前 32 KiB 而非拒收；失败载荷加填充至少 256 字节；预算另一头是让位给记录各跳 100 毫秒粒度滞留时长的归属数据。本文按规范原文拆开这套体积规则。

位号 0/1 的默认前提：option_data_loss_protect 防的是失忆不是攻击

BOLT #9 把 option_data_loss_protect 列为 ASSUMED：init 里可不协商，语义默认为存在。它的本体是 channel_reestablish 的序号与撤销密钥对账，记忆落后会被强制断链。本文拆解保护机制、与备份和 watchtower 的分工及不防的场景。