LIGHTNING-BKPR-DUMPINCOMECSV(7)

💖 NAME 💖

okay so bestie, welcome to the lightning-bkpr-dumpincomecsv(7) page. The command is bkpr-dumpincomecsv — and it is literally the “Command to emit a CSV of income events.” Slay.

---

✨ SYNOPSIS ✨

bkpr-dumpincomecsv csv_format [csv_file] [consolidate_fees] [start_time] [end_time]

🎀 DESCRIPTION 🎀

okay so the bkpr-dumpincomcsv RPC command writes a CSV file to disk at the csv_file location. This is a formatted output of the listincome RPC command. Here’s the whole vibe:

• csv_format (string) — which CSV format to use. Peep RETURN VALUE for the options.
• csv_file (string, optional) — on-disk destination of the generated CSV file.
• consolidate_fees (boolean, optional) — if true, we emit a single, consolidated event for any onchain-fees for a txid and account. Otherwise, events for every update to the onchain fee calculation for this account and txid will be printed. Note that this means that the events emitted are non-stable, i.e. calling dumpincomecsv twice may result in different onchain fee events being emitted, depending on how much information we've logged for that transaction. The default is True.
• start_time (u64, optional) — UNIX timestamp (in seconds) that filters events after the provided timestamp. The default is zero.
• end_time (u64, optional) — UNIX timestamp (in seconds) that filters events up to and at the provided timestamp. The default is max-int.

🚨 bestie, that non-stable fee-event thing is real: twice does not always mean identical onchain fee events, depending on how much info got logged. No cap.

🌸 RETURN VALUE 🌸

On success, an object is returned, containing:

• csv_file (string) — file that the csv was generated to.
• csv_format (string) (one of "cointracker", "koinly", "harmony", "quickbooks") — format to print csv as.

👑 AUTHOR 👑

Lisa Neigut niftynei@gmail.com is mainly responsible.

🦋 SEE ALSO 🦋

lightning-bkpr-listincome(7), lightning-bkpr-listfunds(7), lightning-bkpr-listaccountevents(7), lightning-bkpr-channelsapy(7), lightning-listpeers(7)

🌈 RESOURCES 🌈

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

🍓 EXAMPLES 🍓

Example 1

Request:

$ lightning-cli bkpr-dumpincomecsv "koinly" "koinly.csv"

{
  "id": "example:bkpr-dumpincomecsv#1",
  "method": "bkpr-dumpincomecsv",
  "params": [
    "koinly",
    "koinly.csv"
  ]
}

Response:

{
  "csv_file": "koinly.csv",
  "csv_format": "koinly"
}

---

Core Lightning v26.06.9 — LIGHTNING-BKPR-DUMPINCOMECSV(7) — that’s the whole page, bestie, mwah 💖