.. This file is licensed under the MIT License (MIT) available on
   http://opensource.org/licenses/MIT.

listsinceblock
==============

``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.

Argument #1 - blockhash
~~~~~~~~~~~~~~~~~~~~~~~

**Type:** string, optional

If set, the block hash to list transactions since, otherwise list all transactions.

Argument #2 - target_confirmations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Type:** 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

Argument #3 - include_watchonly
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Type:** boolean, optional, default=false

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

Argument #4 - include_removed
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Type:** boolean, 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": [
      "address":"address",    (string) The bitcoin address of the transaction.
      "category":               (string) The transaction category.
                  "send"                  Transactions sent.
                  "receive"               Non-coinbase transactions received.
                  "generate"              Coinbase transactions received with more than 100 confirmations.
                  "immature"              Coinbase transactions received with 100 or fewer confirmations.
                  "orphan"                Orphaned coinbase transactions received.
      "amount": x.xxx,          (numeric) The amount in BTC. This is negative for the 'send' category, and is positive
                                           for all other categories
      "vout" : n,               (numeric) the vout value
      "fee": x.xxx,             (numeric) The amount of the fee in BTC. This is negative and only available for the 'send' category of transactions.
      "confirmations": n,       (numeric) The number of confirmations for the transaction.
                                            When it's < 0, it means the transaction conflicted that many blocks ago.
      "blockhash": "hashvalue",     (string) The block hash containing the transaction.
      "blockindex": n,          (numeric) The index of the transaction in the block that includes it.
      "blocktime": xxx,         (numeric) The block time in seconds since epoch (1 Jan 1970 GMT).
      "txid": "transactionid",  (string) The transaction id.
      "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).
      "bip125-replaceable": "yes|no|unknown",  (string) Whether this transaction could be replaced due to BIP125 (replace-by-fee);
                                                     may be unknown for unconfirmed transactions not in the mempool
      "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
~~~~~~~~


.. highlight:: shell

::

  bitcoin-cli listsinceblock

::

  bitcoin-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:8332/