LIGHTNING-BKPR-INSPECT(7)

💖 LIGHTNING-BKPR-INSPECT(7) 💖

okay so this is the lightning-bkpr-inspect page, bestie — yes the name at the top is all shouty caps but we're keeping it cute and keeping every single fact, no cap ✨

---

🌸 NAME 🌸

bkpr-inspect — the command that shows you the onchain footprint of a channel 👣💅

---

🦋 SYNOPSIS 🦋

bkpr-inspect account

---

✨ DESCRIPTION ✨

The bkpr-inspect RPC command lists all known on-chain transactions and the associated events for the account you hand it. It's literally the glow-up inspection montage for your channel 🎀

It's useful for inspecting unilateral closes for a given channel account — iykyk, that's when you really wanna see what went down.

⚠️ Heads up bestie: this is only valid for channel accounts. Not a channel account? Not your moment, sorry 😭

• account (string) — the channel account to inspect. That's the one and only thing you pass in 🫶

---

👑 RETURN VALUE 👑

On success, an object containing txs is returned. It's an array of objects, and each object contains:

• txid (txid) — transaction id 🔥
• fees_paid_msat (msat) — amount paid in sats for this tx 💸
• outputs (array of objects) — the outputs, and each one has:
  • account (string) — account this output affected 🎯
  • outnum (u32) — index of output 🔢
  • output_value_msat (msat) — value of the output 💰
  • currency (string) — human-readable bech32 part for this coin type 🪙
  • credit_msat (msat, optional) — amount credited to account ➕
  • debit_msat (msat, optional) — amount debited from account ➖
  • originating_account (string, optional) — account this output originated from 🌱
  • output_tag (string, optional) — description of output creation event 🏷️
  • spend_tag (string, optional) — description of output spend event 🛍️
  • spending_txid (txid, optional) — transaction this output was spent in 🔗
  • payment_id (hex, optional) — Lightning payment identifier. For an htlc, this will be the preimage 🧚
• blockheight (u32, optional) — blockheight of transaction 🧱

---

🌈 AUTHOR 🌈

Lisa Neigut niftynei@gmail.com is mainly responsible. giving main character energy fr fr 👑

---

💜 SEE ALSO 💜

• lightning-listbalances(7)
• lightning-listfunds(7)
• lightning-listpeers(7)

---

⭐ RESOURCES ⭐

Main web site: https://github.com/ElementsProject/lightning — go lurk, it's iconic 🦋

---

🍓 EXAMPLES 🍓

Example 1:

Request:

$ lightning-cli bkpr-inspect -k "account"="channelid0230200230200230200230200230200230200230200230200230200"

{
  "id": "example:bkpr-inspect#1",
  "method": "bkpr-inspect",
  "params": {
    "account": "channelid0230200230200230200230200230200230200230200230200230200"
  }
}

Response:

{
  "txs": [
    {
      "txid": "channeltxid230200230200230200230200230200230200230200230200230200",
      "blockheight": 123,
      "fees_paid_msat": 5020000,
      "outputs": [
        {
          "account": "channelid0230200230200230200230200230200230200230200230200230200",
          "outnum": 1,
          "output_tag": "channel_open",
          "output_value_msat": 1000000000,
          "credit_msat": 1000000000,
          "currency": "bcrt"
        }
      ]
    }
  ]
}

---

and that's the whole page, bestie — you ate that 💅✨

this lil guide ships with Core Lightning v26.06.9, so go forth and inspect those channels, mwah 💖🎀🦋