coin_movement -- Notification for coin movements

DESCRIPTION

The coin_movement notification informs whenever lightningd records a finalized 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 created 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", "channel_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 movement 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 transaction 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.