Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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

NAME
       lightning-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  be-
       ing 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 v25.02					LIGHTNING-TXDISCARD(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lightning-txdiscard&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>

home | help