LIGHTNING-LISTTRANSACTIONS(7)

📦
version 26.06.9 · 2 versions
, in nixpkgs unstable

💜 LIGHTNING-LISTTRANSACTIONS(7) — the manual page, but make it cute

okay so bestie, this is the lightning-listtransactions page from the LIGHTNING-LISTTRANSACTIONS(7) manual, and honestly? it's a whole vibe. it's your wallet's receipts folder. let's get into it ✨

🌸 NAME 🌸

listtransactions — the command that gets you the list of transactions that was stored in the wallet. that's it. that's the whole thing. periodt 💅

🦋 SYNOPSIS 🦋

listtransactions

no flags, no args, no drama. she just is. 😌

🎀 DESCRIPTION 🎀

so the listtransactions command returns transactions tracked in the wallet. like, everything the wallet knows about itself. 🫶

this includes:

  • deposits 💰
  • withdrawals 💸
  • transactions related to channels 🌈

and here's the iconic part — a transaction may have multiple types. for example, a transaction may both be a close and a deposit if it closes the channel and returns funds to the wallet. she contains multitudes. main character energy fr fr 👑

✨ RETURN VALUE ✨

on success, an object containing transactions is returned. it's an array of objects, where each object contains:

  • hash (txid) — the transaction id. her name, her identity 💖
  • rawtx (hex) — the raw transaction. the whole entire thing in hex 🧚
  • blockheight (u32) — the block height of this tx
  • txindex (u32) — the transaction number within the block
  • locktime (u32) — the nLocktime for this tx
  • version (u32) — the nVersion for this tx
  • inputs (array of objects) — each input, in order.:
    • txid (txid) — the transaction id spent
    • index (u32) — the output spent
    • sequence (u32) — the nSequence value
  • outputs (array of objects) — each output, in order.:
    • index (u32) — the 0-based output number
    • amount_msat (msat) — the amount of the output
    • scriptPubKey (hex) — the scriptPubKey

like, gather. the inputs and the outputs both have their own little nested moments. it's giving structurally sound 🏗️💅

💀 ERRORS 💀

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

  • -32602 — error in given parameters. like bestie... the params were not param-ing 😭

👑 AUTHOR 👑

Vincenzo Palazzo vincenzo.palazzo@protonmail.com wrote the initial version of this man page, but many others did the hard work of actually implementing this rpc command. shoutout to the whole group chat, ngl 🫶✨

🌈 SEE ALSO 🌈

go read those too, they're lowkey iconic in their own right 💜

⭐ RESOURCES ⭐

🍓 EXAMPLES 🍓

Example 1:

request:

$ lightning-cli listtransactions

{
  "id": "example:listtransactions#1",
  "method": "listtransactions",
  "params": {}
}

response:

{
  "transactions": [
    {
      "hash": "txid7000170001700017000170001700017000170001700017000170001",
      "rawtx": "02000000000101lstx70001700017000170001700017000170001700017000170001700017000170001700017000170001700017000170001700017000170001700017000170001700017000170001700017000170001700017000170001",
      "blockheight": 0,
      "txindex": 0,
      "locktime": 549000100,
      "version": 2,
      "inputs": [
        {
          "txid": "txid600116001160011600116001160011600116001160011600116001160011",
          "index": 1,
          "sequence": 2158511000
        }
      ],
      "outputs": [
        {
          "index": 1,
          "amount_msat": 201998901100,
          "scriptPubKey": "scriptpubkey01010101010101010101010101010101010101010101010101010101"
        }
      ]
    },
    {
      "hash": "txid7000270002700027000270002700027000270002700027000270002",
      "rawtx": "02000000000101lstx70002700027000270002700027000270002700027000270002700027000270002700027000270002700027000270002700027000270002700027000270002700027000270002700027000270002700027000270002",
      "blockheight": 102,
      "txindex": 1,
      "locktime": 549000200,
      "version": 2,
      "inputs": [
        {
          "txid": "txid600126001260012600126001260012600126001260012600126001260012",
          "index": 1,
          "sequence": 2158512000
        }
      ],
      "outputs": [
        {
          "index": 1,
          "amount_msat": 201998902100,
          "scriptPubKey": "scriptpubkey02010201020102010201020102010201020102010201020102010201"
        },
        {
          "index": 2,
          "amount_msat": 201998902200,
          "scriptPubKey": "scriptpubkey02020202020202020202020202020202020202020202020202020202"
        }
      ]
    }
  ]
}

two transactions, one with a single output and one with a lil pair of outputs — see how the second txindex is 1 and its blockheight is 102? bestie they're ✨different✨. notice that. iykyk 💅

and that's the whole page, bestie!! this was Core Lightning v26.06.9 — the LIGHTNING-LISTTRANSACTIONS(7) manual, dated and delivered with love. mwah. 🫶💖🎀

📦 where this page comes from