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