home | help
LIGHTNING-NOTIFICATION-COIN_MOVEMENT(7)  LIGHTNING-NOTIFICATION-COIN_MOVEMENT(7)

NAME
     coin_movement -- Notification for coin movements

DESCRIPTION
     The coin_movement notification informs whenever lightningd records a final-
     ized ledger movement.

NOTIFICATION PAYLOAD
     *	version (u32): The coin movement schema version.
     *	coin_type (string): The BIP173 coin type name.
     *	node_id (pubkey): The node id that emitted the notification.
     *	type  (string)	(one  of  "channel_mvt", "chain_mvt"): Whether this is a
	channel or chain movement.
     *	created_index (u64): 1-based index indicating order this move  was  cre-
	ated in. (added v25.09)
     *	account_id (string): The account identifier for the movement.
     *	credit_msat (msat): Amount credited to the account.
     *	debit_msat (msat): Amount debited from the account.
     *	timestamp (u64): The UNIX timestamp when the movement was recorded.
     *	primary_tag  (string) (one of "deposit", "withdrawal", "penalty", "chan-
	nel_open", "channel_close", "delayed_to_us", "htlc_tx",  "htlc_timeout",
	"htlc_fulfill", "to_wallet", "anchor", "to_them", "penalized", "stolen",
	"ignored",   "to_miner",  "invoice",  "routed",  "pushed",  "lease_fee",
	"channel_proposed", "penalty_adj", "journal_entry"): The  primary  move-
	ment tag. (added v25.09)
     *	tags (array of strings, optional): Deprecated legacy combined tag array,
	emitted  only for deprecated output compatibility. deprecated in v25.09,
	removed after v26.09:
	*  (string, optional): A legacy movement tag.
     *	extra_tags (array  of  strings,  optional):  Additional  movement  tags.
	(added v25.09):
	*  (string, optional): An additional movement tag.
     *	payment_hash  (hash,  optional):  The  payment	hash associated with the
	movement, if any.
     *	part_id (u64, optional): The part id for a multi-part channel payment.
     *	group_id (u64, optional): The group id for a multi-part channel payment.
     *	fees_msat (msat, optional): The fees associated with a channel movement.
     *	utxo (outpoint, optional): The outpoint for  a	chain  movement.  (added
	v25.09)
     *	peer_id  (pubkey,  optional): The peer associated with a chain movement,
	if any.
     *	originating_account (string, optional): The originating account  for  an
	external chain movement, if any.
     *	txid (txid, optional): Deprecated legacy field for the spending transac-
	tion id. deprecated in v25.09, removed after v26.09
     *	spending_txid  (txid, optional): The spending transaction id for a chain
	movement, if any. (added v25.09)
     *	utxo_txid (txid, optional): Deprecated legacy  field  for  the	outpoint
	transaction id. deprecated in v25.09, removed after v26.09
     *	vout  (u32,  optional):  Deprecated legacy field for the outpoint output
	index. deprecated in v25.09, removed after v26.09
     *	output_msat (msat, optional): The output amount for a chain movement.
     *	output_count (u32, optional): The number  of  outputs  in  the	spending
	transaction, if known.
     *	blockheight (u32, optional): The blockheight for a chain movement.

Core Lightning v26.06.1 		 LIGHTNING-NOTIFICATION-COIN_MOVEMENT(7)

home | help