channel_state_changed -- Notification for channel state change

DESCRIPTION

The channel_state_changed notification informs whenever the state of the channel has been updated.

NOTIFICATION PAYLOAD

• peer_id (pubkey): The peer id of the channel.
• channel_id (hash): The channel id of the channel.
• timestamp (string): The timestamp of the state change.
• 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, in particular "CHANNELD_NORMAL" and "CHANNELD_AWAITING_SPLICE" mean the channel can be used normally.
  Note: CLOSED state was only added in v25.12.
• cause (string) (one of "unknown", "local", "user", "remote", "protocol", "onchain"): The cause of the state change.
• 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.
• 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, in particular "CHANNELD_NORMAL" and "CHANNELD_AWAITING_SPLICE" mean the channel can be used normally.
  The deprecated value 'unknown' was also present for new channels up until v26.04, it was removed in v26.06.
• message (string, optional): The state change message.