txdiscard

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).

  • txid (txid): The transaction id, inputs should be unreseverd 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.

ERRORS

The following error codes may occur:

  • -1: An unknown txid.

AUTHOR

Rusty Russell <[email protected]> is mainly responsible.

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"
}

Core Lightning is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2023 Core Lightning
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.