lncli wallet listsweeps 与 pendingsweeps：两本台账看懂闪电节点的链上清扫

一、谁在替你上链花钱

闪电节点链上的不少动作不是你亲手发起的：对手方广播旧状态被触发的惩罚支出、强制关闭的退款到期、未确认输出被钱包接管——这些输出统一交给一个叫 UtxoSweeper 的中央批处理引擎。它的思路是攒：费率相近的输出合并进同一笔链上交易，一次广播省掉逐笔固定成本。对运营者，看懂这套自动机制的抓手是两本台账：lncli wallet listsweeps 管历史，lncli wallet pendingsweeps 管现在。本文按 LND v0.19.0-beta 的 walletkit 接口注释核对；注释自己也声明部分字段随 sweeper 内部实现演化，属于贴着实现开的高级窗口。

二、listsweeps：广播过的都算数

ListSweeps 返回节点产出并广播过的清扫交易。注释里最要紧的一句：清扫按广播记账，不按确认记账——列表里会有尚未确认的，甚至最终没赢下竞争的。请求字段两个。verbose 为真返回完整交易明细，为假只回 txid 清单，注释同时提醒被 replace-by-fee 顶掉的清扫版本不会出现在输出里，所以历史列表天然缺少那些加了价的阵亡版本。start_height 控制起算点：不填即 0 从最早一笔翻起；填 -1 只返回调用时刻未确认的清扫——想快速看此刻链上还有什么在飘，负一是最短路径。响应结构是 oneof 二选一：verbose 走交易明细形态，否则走 transaction_ids 数组，注释写明这些 txid 是反向十六进制写法，直接粘进某些区块浏览器可能查无此交易，先和 verbose 明细对齐一次再存对照表。

三、pendingsweeps：排队中的现在

PendingSweeps 请求体为空，返回此刻被中央引擎清扫中的输出集合。每条记录描述一枚输出：要花费的前一输出 outpoint、见证类型 witness_type——用来区分超时退款、惩罚支出还是普通钱包输出、金额（聪）、已做的广播尝试次数 broadcast_attempts。一批早期字段已被标记废弃：按字节的费率、下次广播高度、强制清扫开关、请求确认目标，分别由每虚拟字节费率、立即清扫与 deadline 语义取代；读到旧字段为 0 不等于没有费率在起作用。广播次数是这本台账最有用的读数：它在涨，说明节点在持续重播，通常只需要等；它长期不动，才需要下一步人工干预。

四、两本台账配合 bumpfee 排障

典型场景：强制关闭发生了，钱什么时候回来。先 pendingsweeps 找到那枚输出——在队列且广播次数上涨，正常等待；不在队列或次数卡死，用 listsweeps 定位最近一笔清扫交易看确认状态。费率明显偏低时走 wallet bumpfee：它的接口注释交代了机制——同一 outpoint 若已在 sweeper 里登记（例如锚定输出），加费走 RBF；若是新输入（例如未确认钱包 UTXO），则构成 CPFP 式追加。sweeper 内部按 deadline 与 budget 构造费用函数，临近 deadline 自动抬费率并做 RBF；每个新区块过去而清扫仍未确认，也会自动再顶一次价。注释给出的官方建议很实在：动手前先 ListSweeps 看清当前清扫交易的输入构成——多输入交易的 RBF 追加费要求差别很大，不看形状就加费，经常白付。想强行干预这条自动轨道，BumpFee 允许指定自定义费率、预算、期限与是否立即清扫。

五、三个读数陷阱

第一，listsweeps 的 txid 端序问题如上，反向十六进制是接口白纸黑字的说明。第二，start_height 的 0 与负一语义不同，误用 0 会全量翻历史，清扫记录多的节点明显更慢。第三，pendingsweeps 是瞬时快照，两次调用之间批处理引擎可能已经换了组合——做连续监控要固定轮询间隔并按 outpoint 去重，别把两本快照直接相加当流水。

六、这本账不覆盖什么

sweeps 只管 sweeper 经手的链上支出：wallet sendcoins、开通道出资不在其中，发票、通道内余额与路由费用更不进这本账。把它理解为节点自动链上行为的黑匣子最贴近实际——审计强制关闭回收是否到位、判断清扫是否卡费，这两条只读命令是 LND 里信息密度最高的一组。

风险提示：本文仅作机制说明，链上清扫涉及真实资金调度，操作前请核对备份。本文不构成投资建议。