AI-generated analysisPublished automatically and not human-verified. Validated context appears in community notes below.
← Watch feed
Informational 18 Bitcoin

lightningd: add withheld flag to listpeerchannels and listclosedchannels.

Public commit record

What the developer wrote

Authored by Rusty Russell

73/100 · Adequate
lightningd: add withheld flag to listpeerchannels and listclosedchannels.

Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
Changelog-Added: JSON-RPC: `listpeerchannels` `funding` object `withheld` flag, and `listclosedchannels` `funding_withheld` flags, indicating fundchannel_complete was called with the `withheld` parameter true.
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
The short version

What changed, and why it matters

This commit adds new read-only information fields to two JSON-RPC commands that list channel details. It exposes whether a channel's funding transaction was intentionally withheld from broadcast and, in one case, the associated PSBT (partially-signed Bitcoin transaction). There is no code change that alters how funds are handled, how transactions are signed, or how peers communicate; it only reports existing internal state through APIs.

Recommended action

No security action required. Treat as a normal feature addition. Reviewers may want to confirm that the PSBT string, when present, does not contain sensitive key material before it is returned over RPC, but the commit itself does not introduce that data; it only surfaces an already-stored value.

Security signals we found

01

No change to transaction validation, signing, or broadcast logic

02

No change to peer-to-peer protocol handling

03

Only adds optional output fields to existing read-only RPC/GRPC responses

04

Fields reflect existing internal state (fundchannel_complete's withheld parameter and stored PSBT)

Risk score

Why this scored 18/100

Our methodology →
Potential impact 0/30
Exploitability 0/25
Stealth signal 0/15
Affected reach 5/15
Confidence 9/10
Evidence quality 4/5
Human-validated context

Community notes

Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.

No validated notes yet.

The AI analysis stands alone for now. Submit a note if you can add evidence or important context.