98 lines
3.6 KiB
Markdown
98 lines
3.6 KiB
Markdown
lightning-listtransactions -- Command to get the list of transactions that was stored in the wallet.
|
|
============================================================
|
|
|
|
SYNOPSIS
|
|
--------
|
|
|
|
**listtransactions**
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
The **listtransactions** command returns transactions tracked in the wallet. This includes deposits, withdrawals and transactions related to channels. A transaction may have multiple types, e.g., a transaction may both be a close and a deposit if it closes the channel and returns funds to the wallet.
|
|
|
|
EXAMPLE JSON REQUEST
|
|
------------
|
|
```json
|
|
{
|
|
"id": 82,
|
|
"method": "listtransactions",
|
|
"params": {}
|
|
}
|
|
```
|
|
|
|
RETURN VALUE
|
|
------------
|
|
|
|
On success, the command will return a list of transactions, each object represents a transaction, with the following details:
|
|
|
|
- *hash*: A string that represents the hash of transaction, which the caller can use to find it on the blockchain.
|
|
- *rawtx*: A string that represents the hexadecimal dump of the transaction.
|
|
- *blockheight*: An integer that represents the block height that contains the transaction on the blockchain.
|
|
- *txindex*: An integer that represents the transaction index inside the block.
|
|
- *locktime*: An integer that represents the nLocktime field.
|
|
- *version*: An integer that represents the nVersion field.
|
|
- *inputs*: A list of spent transaction outputs, each spent transaction output is represented with an object with the following properties:
|
|
- *txid*: A string that represents the hash of transaction. This is the output index of the transaction output being spent.
|
|
- *index*: An integer that represents the index of transaction.
|
|
- *sequence*: An integer that represents the nSequence field.
|
|
- *outputs*: A list of transactions, each transaction is represented with an object with the following proprieties:
|
|
- *index*: An integer that represents the index of transaction.
|
|
- *satoshis*: A string that represents the amount in millisatoshi.
|
|
- *scriptPubKey*: A string that contains the lock script in hexadecimal dump form.
|
|
|
|
On failure, one of the following error codes may be returned:
|
|
- -32602: Error in given parameters.
|
|
|
|
EXAMPLE JSON RESPONSE
|
|
-----
|
|
```json
|
|
{
|
|
"transactions": [
|
|
{
|
|
"hash": "05985072bbe20747325e69a159fe08176cc1bbc96d25e8848edad2dddc1165d0",
|
|
"rawtx": "02000000027032912651fc25a3e0893acd5f9640598707e2dfef92143bb5a4020e335442800100000017160014a5f48b9aa3cb8ca6cc1040c11e386745bb4dc932ffffffffd229a4b4f78638ebcac10a68b0561585a5d6e4d3b769ad0a909e9b9afaeae24e00000000171600145c83da9b685f9142016c6f5eb5f98a45cfa6f686ffffffff01915a01000000000017a9143a4dfd59e781f9c3018e7d0a9b7a26d58f8d22bf8700000000",
|
|
"blockheight": 0,
|
|
"txindex": 0,
|
|
"locktime": 0,
|
|
"version": 2,
|
|
"inputs": [
|
|
{
|
|
"txid": "804254330e02a4b53b1492efdfe207875940965fcd3a89e0a325fc5126913270",
|
|
"index": 1,
|
|
"sequence": 4294967295
|
|
},
|
|
{
|
|
"txid": "4ee2eafa9a9b9e900aad69b7d3e4d6a5851556b0680ac1caeb3886f7b4a429d2",
|
|
"index": 0,
|
|
"sequence": 4294967295
|
|
}
|
|
],
|
|
"outputs": [
|
|
{
|
|
"index": 0,
|
|
"satoshis": "88721000msat",
|
|
"scriptPubKey": "a9143a4dfd59e781f9c3018e7d0a9b7a26d58f8d22bf87"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
|
|
AUTHOR
|
|
------
|
|
|
|
Vincenzo Palazzo <<vincenzo.palazzo@protonmail.com>> wrote the initial version of this man page, but many others did the hard work of actually implementing this rpc command.
|
|
|
|
SEE ALSO
|
|
--------
|
|
|
|
lightning-newaddr(7), lightning-listfunds(7)
|
|
|
|
RESOURCES
|
|
---------
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|