LIGHTNING-TXDISCARD(7)

📦
version 26.06.9 · 2 versions
, in nixpkgs unstable

💅 LIGHTNING-TXDISCARD(7) 💅

okay bestie, welcome to lightning-txdiscard — the manual page that's literally about abandoning a transaction you set up with txprepare. yes, we're ghosting it. no cap.

✨ NAME ✨

txdiscard — abandon a transaction from txprepare, release inputs 🫶

🎀 SYNOPSIS 🎀

txdiscard txid

🌸 DESCRIPTION 🌸

The txdiscard RPC command releases inputs which were reserved for use of the txid from lightning-txprepare(7).

so basically: you told txprepare to hold some inputs, you changed your mind, and now you're releasing them back into the wild. iconic cleanup behaviour tbh 💅

  • txid (txid) — the transaction id, inputs should be unreserved from 🦋

⭐ RETURN VALUE ⭐

On success, an object is returned, containing:

  • unsigned_tx (hex) — the unsigned transaction ✨
  • txid (txid) — the transaction id of unsigned_tx 👑
If there is no matching txid, an error is reported. Note that this may happen due to incorrect usage, such as txdiscard or txsend already being called for txid. 😭 like, you can't ghost the same transaction twice, bestie.

💀 ERRORS 💀

The following error codes may occur:

  • -1 — an unknown txid 🙈

👑 AUTHOR 👑

Rusty Russell rusty@rustcorp.com.au is mainly responsible. main character energy fr fr 🌈

🦋 SEE ALSO 🦋

lightning-txprepare(7), lightning-txsend(7)

🔥 RESOURCES 🔥

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

🍓 EXAMPLES 🍓

Example 1:

Request:

$ lightning-cli txdiscard "txidtxprep000100001000010000100001000010000100001000010000100001"
{
  "id": "example:txdiscard#1",
  "method": "txdiscard",
  "params": [
    "txidtxprep000100001000010000100001000010000100001000010000100001"
  ]
}

Response:

{
  "unsigned_tx": "0200000000000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006000600060006",
  "txid": "txidtxprep000100001000010000100001000010000100001000010000100001"
}

Example 2:

Request:

$ lightning-cli txdiscard -k "txid"="txidtxprep000300003000030000300003000030000300003000030000300003"
{
  "id": "example:txdiscard#2",
  "method": "txdiscard",
  "params": {
    "txid": "txidtxprep000300003000030000300003000030000300003000030000300003"
  }
}

Response:

{
  "unsigned_tx": "0200000000000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008000800080008",
  "txid": "txidtxprep000300003000030000300003000030000300003000030000300003"
}

and that's the whole page, bestie — go forth and unreserve those inputs 🧚💜

Core Lightning v26.06.9 wrote this one, and it's filed under LIGHTNING-TXDISCARD(7) — mwah, see u in the next manpage 💖🎀

📦 where this page comes from