LIGHTNING-NOTIFI...EL_STATE_CHANGED(7)

✨ LIGHTNING-NOTIFI...EL_STATE_CHANGED ✨

ok so bestie, welcome to lightning-notifi...el_state_changed(7) — the notification page for when your channel goes through a whole glow-up (or a whole crisis, no in between 💀). This is section 7 of the lightning manual, and it's literally just about one notification. One. But she's iconic.

---

💖 NAME 💖

channel_state_changed — the notification that's like "hey girl, your channel's state just changed" 💅

---

🦋 DESCRIPTION 🦋

So the channel_state_changed notification slides into your notifications whenever the state of the channel has been updated. That's it, that's the whole job. Lowkey the most reliable friend in the group chat 🫶

---

🌸 NOTIFICATION PAYLOAD 🌸

okay so here's everything that comes in the payload, one by one, no skipping (i would never 🙈):

• peer_id (pubkey) — the peer id of the channel. that's your counterparty, your channel buddy ✨
• channel_id (hash) — the channel id of the channel.
• timestamp (string) — the timestamp of the state change. when did it happen, bestie ⏰
• new_state (string) (one of "OPENINGD", "CHANNELD_AWAITING_LOCKIN", "CHANNELD_NORMAL", "CHANNELD_SHUTTING_DOWN", "CLOSINGD_SIGEXCHANGE", "CLOSINGD_COMPLETE", "AWAITING_UNILATERAL", "FUNDING_SPEND_SEEN", "ONCHAIN", "DUALOPEND_OPEN_INIT", "DUALOPEND_AWAITING_LOCKIN", "CHANNELD_AWAITING_SPLICE", "DUALOPEND_OPEN_COMMITTED", "DUALOPEND_OPEN_COMMIT_READY", "CLOSED") — the channel state. and listen, in particular "CHANNELD_NORMAL" and "CHANNELD_AWAITING_SPLICE" mean the channel can be used normally 👑 that's the good timeline.

⚠️ note: the CLOSED state was only added in v25.12. so if you're on something ancient, she's not there yet 😭

• cause (string) (one of "unknown", "local", "user", "remote", "protocol", "onchain") — the cause of the state change. like, who did this. why. 🔥
• short_channel_id (short_channel_id, optional) — the short channel id of the channel. if the channel is not yet confirmed, this field will be null. so don't panic if it's empty, she's just not that far along yet 🍓
• old_state (string, optional) (one of "OPENINGD", "CHANNELD_AWAITING_LOCKIN", "CHANNELD_NORMAL", "CHANNELD_SHUTTING_DOWN", "CLOSINGD_SIGEXCHANGE", "CLOSINGD_COMPLETE", "AWAITING_UNILATERAL", "FUNDING_SPEND_SEEN", "ONCHAIN", "DUALOPEND_OPEN_INIT", "DUALOPEND_AWAITING_LOCKIN", "CHANNELD_AWAITING_SPLICE", "DUALOPEND_OPEN_COMMITTED", "DUALOPEND_OPEN_COMMIT_READY") — the channel state. same deal: in particular "CHANNELD_NORMAL" and "CHANNELD_AWAITING_SPLICE" mean the channel can be used normally 💜

🫶 history lesson: the deprecated value 'unknown' was also present for new channels up until v26.04, and it was removed in v26.06. she's gone, bestie. RIP. 🕯️

• message (string, optional) — the state change message.

---

🌈 and that's the whole page, no cap. this one came to you straight out of Core Lightning v26.06.9 — thanks for reading the LIGHTNING-NOTIFI...EL_STATE_CHANGED(7) manual with me, mwah 💋 periodt ✨