Skip to main content

listsinceblock

Command#

pacprotocol-cli listsinceblock ( "blockhash" target_confirmations include_watchonly include_removed )

Get all transactions in blocks since block [blockhash], or all transactions if omitted. If "blockhash" is no longer a part of the main chain, transactions from the fork point onward are included. Additionally, if include_removed is set, transactions affecting the wallet which were removed are returned in the "removed" array.

Arguments#

blockhash#

(string, optional)

The block hash to list transactions since

target_confirmations#

(numeric, optional, default=1)

Return the nth block hash from the main chain. e.g. 1 would mean the best block hash. Note: this is not used as a filter, but only affects in the return value

[lastblock]

include_watchonly#

(bool, optional, default=false)

Include transactions to watch-only addresses (see 'importaddress')

include_removed#

(bool, optional, default=true)

Show transactions that were removed due to a reorg in the "removed" array (not guaranteed to work on pruned nodes)

Examples#

pacprotocol-cli listsinceblock
pacprotocol-cli listsinceblock "000000000000000bacf66f7497b7dc45ef753ee9a7d38571037cdb1a57f663ad" 6
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listsinceblock", "params": ["000000000000000bacf66f7497b7dc45ef753ee9a7d38571037cdb1a57f663ad", 6] }' -H 'content-type: text/plain;' http://127.0.0.1:1111/

Result#

{
"transactions": [
"account":"accountname", #(string) DEPRECATED. This field will be removed in V0.18. To see this deprecated field, start pacprotocold with -deprecatedrpc=accounts. The account name associated with the transaction. Will be "" for the default account.
"address":"address", #(string) The PAC address of the transaction. Not present for move transactions #(category = move).
"category":"send|receive", #(string) The transaction category. 'send' has negative amounts, 'receive' has positive amounts.
"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.
"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.
When it's < 0, it means the transaction conflicted that many blocks ago.
"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
"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 #(Jan 1 1970 GMT).
"timereceived": xxx, #(numeric) The time received in seconds since epoch #(Jan 1 1970 GMT). Available for 'send' and 'receive' category of transactions.
"abandoned": xxx, #(bool) 'true' if the transaction has been abandoned #(inputs are respendable). Only available for the 'send' category of transactions.
"comment": "...", #(string) If a comment is associated with the transaction.
"label" : "label" #(string) A comment for the address/transaction, if any
"to": "...", #(string) If a comment to is associated with the transaction.
],
"removed": [
<structure is the same as "transactions" above, only present if include_removed=true>
Note: transactions that were re-added in the active chain will appear as-is in this array, and may thus have a positive confirmation count.
],
"lastblock": "lastblockhash" #(string) The hash of the block #(target_confirmations-1) from the best block on the main chain. This is typically used to feed back into listsinceblock the next time you call it. So you would generally use a target_confirmations of say 6, so you will be continually re-notified of transactions until they've reached 6 confirmations plus any new ones
}

Running following help command

pacprotocol-cli help listsinceblock

Will produce following output:

listsinceblock ( "blockhash" target_confirmations include_watchonly include_removed )
Get all transactions in blocks since block [blockhash], or all transactions if omitted.
If "blockhash" is no longer a part of the main chain, transactions from the fork point onward are included.
Additionally, if include_removed is set, transactions affecting the wallet which were removed are returned in the "removed" array.
Arguments:
1. "blockhash" (string, optional) The block hash to list transactions since
2. target_confirmations: (numeric, optional, default=1) Return the nth block hash from the main chain. e.g. 1 would mean the best block hash. Note: this is not used as a filter, but only affects [lastblock] in the return value
3. include_watchonly: (bool, optional, default=false) Include transactions to watch-only addresses (see 'importaddress')
4. include_removed: (bool, optional, default=true) Show transactions that were removed due to a reorg in the "removed" array
(not guaranteed to work on pruned nodes)
Result:
{
"transactions": [
"account":"accountname", (string) DEPRECATED. This field will be removed in V0.18. To see this deprecated field, start pacprotocold with -deprecatedrpc=accounts. The account name associated with the transaction. Will be "" for the default account.
"address":"address", (string) The PAC address of the transaction. Not present for move transactions (category = move).
"category":"send|receive", (string) The transaction category. 'send' has negative amounts, 'receive' has positive amounts.
"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.
"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.
When it's < 0, it means the transaction conflicted that many blocks ago.
"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
"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 (Jan 1 1970 GMT).
"timereceived": xxx, (numeric) The time received in seconds since epoch (Jan 1 1970 GMT). Available for 'send' and 'receive' category of transactions.
"abandoned": xxx, (bool) 'true' if the transaction has been abandoned (inputs are respendable). Only available for the 'send' category of transactions.
"comment": "...", (string) If a comment is associated with the transaction.
"label" : "label" (string) A comment for the address/transaction, if any
"to": "...", (string) If a comment to is associated with the transaction.
],
"removed": [
<structure is the same as "transactions" above, only present if include_removed=true>
Note: transactions that were re-added in the active chain will appear as-is in this array, and may thus have a positive confirmation count.
],
"lastblock": "lastblockhash" (string) The hash of the block (target_confirmations-1) from the best block on the main chain. This is typically used to feed back into listsinceblock the next time you call it. So you would generally use a target_confirmations of say 6, so you will be continually re-notified of transactions until they've reached 6 confirmations plus any new ones
}
Examples:
> pacprotocol-cli listsinceblock
> pacprotocol-cli listsinceblock "000000000000000bacf66f7497b7dc45ef753ee9a7d38571037cdb1a57f663ad" 6
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listsinceblock", "params": ["000000000000000bacf66f7497b7dc45ef753ee9a7d38571037cdb1a57f663ad", 6] }' -H 'content-type: text/plain;' http://127.0.0.1:1111/