home | help 
LIGHTNING-TXDISCARD(7)					  LIGHTNING-TXDISCARD(7)

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

     *	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 hap-
     pen 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 rusty@rustcorp.com.au 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 v26.06.1 				  LIGHTNING-TXDISCARD(7)
home | help