listchannelmoves

listchannelmoves -- Command to get the audit list of all channel coin movements.

SYNOPSIS

listchannelmoves [index [start] [limit]]

DESCRIPTION

Command added in v25.09.

The listchannelmoves command returns the confirmed balance changes within lightning channels over time.

  • index (string, optional) (always "created"): How to interpret start and limit
  • start (u64, optional): If index is specified, start may be specified to start from that value, which is generally returned from lightning-wait(7).
  • limit (u32, optional): If index is specified, limit can be used to specify the maximum number of entries to return.

RETURN VALUE

On success, an object containing channelmoves is returned. It is an array of objects, where each object contains:

  • created_index (u64): 1-based index indicating order this move was created in.
  • account_id (string): The channel_id corresponding to the channel involved.
  • credit_msat (msat): Amount credited (one of this or debit_msat is zero)
  • debit_msat (msat): Amount debited (one of this or credit_msat is zero)
  • timestamp (u64): Time of this event in seconds since January 1 1970 UTC
  • primary_tag (string) (one of "invoice", "routed", "pushed", "lease_fee", "channel_proposed", "penalty_adj", "journal_entry"): A set of one or more tags defining the nature of the change
  • fees_msat (msat): The fees paid for this payment
  • payment_hash (hash, optional): The hash associated with this payment (not present for leases or push funding)
  • part_id (u64, optional): The part_id for the payment (the payment_hash, group_id, part_id tuple will be unique)
  • group_id (u64, optional): The group_id for the payment (the payment_hash, group_id, part_id tuple will be unique)

ERRORS

On failure, one of the following error codes may be returned:

  • -32602: Error in given parameters.

RESOURCES

Main web site: https://github.com/ElementsProject/lightning

Core Lightning is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2023 Core Lightning
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.