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

lightningd: deprecate `null` short_channel_id and `unknown` old_state in channel_state_changed notification

Public commit record

What the developer wrote

Authored by Rusty Russell

73/100 · Adequate
lightningd: deprecate `null` short_channel_id and `unknown` old_state in channel_state_changed notification

We always prefer to omit fields rather than use 'null' (or unknown!).

Note that before this, the schema was broken, so we have to put a special
exemption in for that case.

Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
The short version

What changed, and why it matters

This commit is a cleanup of how Core Lightning reports channel-state change notifications. Previously, when a channel did not yet have a short channel ID, the notification would include a literal null value; for brand-new channels it could also report an 'unknown' old state. The change makes these fields optional so they are simply left out instead of being sent as null/unknown. It is a deprecation/API-consistency patch, not a fix for an exploitable vulnerability.

Recommended action

No immediate security action required. Developers consuming the `channel_state_changed` notification should update their clients to tolerate the absence of `short_channel_id` and `old_state`, and migrate away from expecting the deprecated `null`/`unknown` values before they are removed in a future release.

Security signals we found

01

API schema cleanup, not a security bug fix

02

Deprecation of sentinel values in a notification payload

03

No change to authentication, authorization, cryptography, or network parsing

04

No vendor disclosure of security relevance

Risk score

Why this scored 19/100

Our methodology →
Potential impact 2/30
Exploitability 1/25
Stealth signal 1/15
Affected reach 3/15
Confidence 8/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.