- pays: CLN 24.11+: payments that were started (but not yet finished) earlier than the first payment shown by summars would not show up once paid
- invoices: invoices created before the first invoice shown by summars would not show up once paid
- forwards: offered and not yet settled forwards that were created before the first forward shown by summars would not show up once settled
- pays: CLN 24.11+ will use newly added indexing in
listpays
to speed up building the pays table on subsequent summars calls
- pays: summars can't guarantee that it can find/calculate
sats_requested
,msats_requested
and therefore also can't guaranteefee_sats
andfee_msats
. If this is the case these will be shown asN/A
and not included in the totals summary at the end and in json mode the fields will be omitted - pays: summars can't guarantee that it can find the
destination
. If this is the case it will be shown asN/A
and in json mode this field will be omitted - pays: description field now included in json output mode if a description was found
- no longer panic on missing payment
destination
oramount_msat
- Total values summary for forwards, pays and invoices table at the bottom in normal view and as
totals
object in json mode - Show timeframe and limits you are currently using for each table of forwards, pays and invoices
- New options to limit output of forwards, pays and invoices tables:
summars-forwards-limit
,summars-pays-limit
andsummars-invoices-limit
. Defaults to 0 (off) and limits the outputs to the last x entries, useful if you are setting high time values forsummars-forwards
,summars-pays
orsummars-invoices
- New
summars-forwards-columns
column:eff_fee_ppm
showing the effective fee ppm
- nix flake (thanks to @RCasatta)
- New column for the main channels table:
PERC_US
: the percentage of funds in the channel that belong to us. - New column
TOTAL_SATS
: the total size of the channel in sats - New column
MIN_HTLC
: the minimum size of an outgoing htlc for that channel in sats - New column
IN_BASE
: the base fee in msats set by the channel's peer - New column
IN_PPM
: the ppm fee set by the channel's peer
- Can only sort by enabled columns, since we don't collect data on some disabled columns for performance reasons
- updated dependencies
- Improved performance if invoices or forwards tables don't have anything to show in the requested time window
summars-exclude-states
: addedONLINE,OFFLINE
states to filter by connection statussummars-forwards-columns
: addedfee_sats
,in_msats
,out_msats
as non-default columnssummars-pays-columns
: addedfee_sats
as a new default column andmsats_requested
,msats_sent
as non-default columnssummars-invoices-columns
: addedmsats_received
as non-default column
- sats values are rounded to the closest integer instead of rounded down
- column names and states are now case insensitive
summars-pays-columns
Comma-separated list of enabled columns in the pays table. Also dictates order of columns. Valid columns:completed_at
,payment_hash
,sats_requested
,sats_sent
,fee_msats
,destination
,description
,preimage
. Default columns are:completed_at
,payment_hash
,sats_sent
,destination
⚠️ If you enable thedescription
field in most cases an extra RPC call is necessary for each displayed payment. This could slow down the response time ofsummars
if you have alot of payments in your configured time window.summars-max-description-length
How long descriptions are allowed to be before they get cut off. If you use a negative value (e.g.-30
) it will use wrapping at that length instead. Default is30
summars-invoices-columns
Comma-separated list of enabled columns in the invoices table. Also dictates order of columns. Valid columns:paid_at
,label
,description
,sats_received
,payment_hash
,preimage
. Default columns are:paid_at
,label
,sats_received
,payment_hash
summars-max-label-length
How long invoice labels are allowed to be before they get cut off. If you use a negative value (e.g.-30
) it will use wrapping at that length instead. Default is30
summars-forwards-columns
Comma-separated list of enabled columns in the forwards table. Also dictates order of columns. Valid columns:received_time
,resolved_time
,in_channel
,out_channel
,in_sats
,out_sats
,fee_msats
. Default columns:resolved_time
,in_channel
,out_channel
,in_sats
,out_sats
,fee_msats
- Options code refactored. All options are now natively dynamic and there is no longer any manual reading of config files. Read the updated README section on how to set options for more information
summars-max-alias-length
supports wrapping by using negative values (just like the newsummars-max-description-length
andsummars-max-label-length
), see READMEsummars-columns
and the new-columns
options now also dictate the order of the columnssummars-forwards
now sorted byresolved_time
instead ofreceived_time
summars-json
: in forwards objectsreceived
is now calledreceived_time
- Documentation error that stated you can sort by
GRAPH_SATS
(you never could and it will error now if you try) - Filter message spelling and formatting
summars-sort-by
: now supports reverse sorting by using a-
prefix, e.g.-ALIAS
summars-json
: new boolean option to output data in json format
- if you had the plugin with config file options start with CLN and then changed an option and only reloaded the plugin, CLN would pass stale option values to the plugin so the load priority changed to:
- config file options
plugin start
options
- no longer ignore general config file if a network config file exists