listtransactions
Command#
pacprotocol-cli listtransactions (label count skip include_watchonly)
If a label name is provided, this will return only incoming transactions paying to addresses with the specified label.
Returns up to 'count' most recent transactions skipping the first 'from' transactions. Note that the "account" argument and "otheraccount" return value have been removed in V0.17. To use this RPC with an "account" argument, restart pacprotocold with -deprecatedrpc=accounts
Arguments#
label#
(string, optional)
If set, should be a valid label name to return only incoming transactions with the specified label, or "*" to disable filtering and return all transactions.
count#
(numeric, optional, default=10)
The number of transactions to return
skip#
(numeric, optional, default=0)
The number of transactions to skip
include_watchonly#
( bool, optional, default=false)
Include transactions to watch-only addresses (see 'importaddress')
Examples#
List the most recent 10 transactions in the systems
pacprotocol-cli listtransactions
List transactions 100 to 120
pacprotocol-cli listtransactions "" 20 100
As a json rpc call
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listtransactions", "params": ["", 20, 100] }' -H 'content-type: text/plain;' http://127.0.0.1:1111/
Result#
[
{
"address":"address", #(string) The PAC address of the transaction. Not present for
move transactions #(category = move).
"category":"send|receive|move", #(string) The transaction category. 'move' is a local #(off blockchain)
transaction between accounts, and not associated with an address,
transaction id or block. 'send' and 'receive' transactions are
associated with an address, transaction id and block details
"amount": x.xxx, #(numeric) The amount in PAC. This is negative for the 'send' category, and for the
'move' category for moves outbound. It is positive for the 'receive' category,
and for the 'move' category for inbound funds.
"label": "label", #(string) A comment for the address/transaction, if any
"vout": n, #(numeric) the vout value
"fee": x.xxx, #(numeric) The amount of the fee in PAC. This is negative and only available for the
'send' category of transactions.
"confirmations": n, #(numeric) The number of blockchain confirmations for the transaction. Available for 'send' and
'receive' category of transactions. Negative confirmations indicate the
transation conflicts with the block chain
"instantlock" : true|false, #(bool) Current transaction lock state. Available for 'send' and 'receive' category of transactions
"instantlock_internal" : true|false, #(bool) Current internal transaction lock state. Available for 'send' and 'receive' category of transactions
"chainlock" : true|false, #(bool) The state of the corresponding block chainlock
"trusted": xxx, #(bool) Whether we consider the outputs of this unconfirmed transaction safe to spend.
"blockhash": "hashvalue", #(string) The block hash containing the transaction. Available for 'send' and 'receive'
category of transactions.
"blockindex": n, #(numeric) The index of the transaction in the block that includes it. Available for 'send' and 'receive'
category of transactions.
"blocktime": xxx, #(numeric) The block time in seconds since epoch #(1 Jan 1970 GMT).
"txid": "transactionid", #(string) The transaction id. Available for 'send' and 'receive' category of transactions.
"time": xxx, #(numeric) The transaction time in seconds since epoch #(midnight Jan 1 1970 GMT).
"timereceived": xxx, #(numeric) The time received in seconds since epoch #(midnight Jan 1 1970 GMT). Available
for 'send' and 'receive' category of transactions.
"comment": "...", #(string) If a comment is associated with the transaction.
"abandoned": xxx #(bool) 'true' if the transaction has been abandoned #(inputs are respendable). Only available for the
'send' category of transactions.
}
]
Running following help command
pacprotocol-cli help listtransactions
Will produce following output:
listtransactions (label count skip include_watchonly)
If a label name is provided, this will return only incoming transactions paying to addresses with the specified label.
Returns up to 'count' most recent transactions skipping the first 'from' transactions.
Note that the "account" argument and "otheraccount" return value have been removed in V0.17. To use this RPC with an "account" argument, restart
pacprotocold with -deprecatedrpc=accounts
Arguments:
1. "label" (string, optional) If set, should be a valid label name to return only incoming transactions
with the specified label, or "*" to disable filtering and return all transactions.
2. count (numeric, optional, default=10) The number of transactions to return
3. skip (numeric, optional, default=0) The number of transactions to skip
4. include_watchonly (bool, optional, default=false) Include transactions to watch-only addresses (see 'importaddress')
Result:
[
{
"address":"address", (string) The PAC address of the transaction. Not present for
move transactions (category = move).
"category":"send|receive|move", (string) The transaction category. 'move' is a local (off blockchain)
transaction between accounts, and not associated with an address,
transaction id or block. 'send' and 'receive' transactions are
associated with an address, transaction id and block details
"amount": x.xxx, (numeric) The amount in PAC. This is negative for the 'send' category, and for the
'move' category for moves outbound. It is positive for the 'receive' category,
and for the 'move' category for inbound funds.
"label": "label", (string) A comment for the address/transaction, if any
"vout": n, (numeric) the vout value
"fee": x.xxx, (numeric) The amount of the fee in PAC. This is negative and only available for the
'send' category of transactions.
"confirmations": n, (numeric) The number of blockchain confirmations for the transaction. Available for 'send' and
'receive' category of transactions. Negative confirmations indicate the
transation conflicts with the block chain
"instantlock" : true|false, (bool) Current transaction lock state. Available for 'send' and 'receive' category of transactions
"instantlock_internal" : true|false, (bool) Current internal transaction lock state. Available for 'send' and 'receive' category of transactions
"chainlock" : true|false, (bool) The state of the corresponding block chainlock
"trusted": xxx, (bool) Whether we consider the outputs of this unconfirmed transaction safe to spend.
"blockhash": "hashvalue", (string) The block hash containing the transaction. Available for 'send' and 'receive'
category of transactions.
"blockindex": n, (numeric) The index of the transaction in the block that includes it. Available for 'send' and 'receive'
category of transactions.
"blocktime": xxx, (numeric) The block time in seconds since epoch (1 Jan 1970 GMT).
"txid": "transactionid", (string) The transaction id. Available for 'send' and 'receive' category of transactions.
"time": xxx, (numeric) The transaction time in seconds since epoch (midnight Jan 1 1970 GMT).
"timereceived": xxx, (numeric) The time received in seconds since epoch (midnight Jan 1 1970 GMT). Available
for 'send' and 'receive' category of transactions.
"comment": "...", (string) If a comment is associated with the transaction.
"abandoned": xxx (bool) 'true' if the transaction has been abandoned (inputs are respendable). Only available for the
'send' category of transactions.
}
]
Examples:
List the most recent 10 transactions in the systems
> pacprotocol-cli listtransactions
List transactions 100 to 120
> pacprotocol-cli listtransactions "" 20 100
As a json rpc call
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listtransactions", "params": ["", 20, 100] }' -H 'content-type: text/plain;' http://127.0.0.1:1111/