home | help
LIGHTNING-NOTIFI...EL_STATE_CHANGED(7)	  LIGHTNING-NOTIFI...EL_STATE_CHANGED(7)

NAME
     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",  "ON-
	CHAIN",   "DUALOPEND_OPEN_INIT",   "DUALOPEND_AWAITING_LOCKIN",   "CHAN-
	NELD_AWAITING_SPLICE", "DUALOPEND_OPEN_COMMITTED",  "DUALOPEND_OPEN_COM-
	MIT_READY",  "CLOSED"):  The channel state, in particular "CHANNELD_NOR-
	MAL" and "CHANNELD_AWAITING_SPLICE" mean the channel can  be  used  nor-
	mally.	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_AWAIT-
	ING_LOCKIN",   "CHANNELD_NORMAL",    "CHANNELD_SHUTTING_DOWN",	  "CLOS-
	INGD_SIGEXCHANGE",  "CLOSINGD_COMPLETE",  "AWAITING_UNILATERAL",  "FUND-
	ING_SPEND_SEEN",  "ONCHAIN",  "DUALOPEND_OPEN_INIT",   "DUALOPEND_AWAIT-
	ING_LOCKIN",   "CHANNELD_AWAITING_SPLICE",   "DUALOPEND_OPEN_COMMITTED",
	"DUALOPEND_OPEN_COMMIT_READY"): The channel state, in particular  "CHAN-
	NELD_NORMAL" and "CHANNELD_AWAITING_SPLICE" mean the channel can be used
	normally.  The deprecated value 'unknown' was also present for new chan-
	nels up until v26.04, it was removed in v26.06.
     *	message (string, optional): The state change message.

Core Lightning v26.06.1 		  LIGHTNING-NOTIFI...EL_STATE_CHANGED(7)

home | help