Skip to content

getdsprooflist JSON-RPC command

getdsprooflist ( verbosity include_orphans )

List double-spend proofs for transactions in the mempool.

Arguments

1. verbosity          (numeric, optional, default=0) Values 0-3 return progressively more information for each increase in verbosity. This option may also be specified as a boolean where false is the same as verbosity=0 and true is verbosity=2.
2. include_orphans    (boolean, optional, default=false) If true, then also include double-spend proofs that we know about but which are for transactions that we don't yet have.

Result (for verbosity = 0 or false)

[                                  (json array of string)
  "dspid"                          (string) Double-spend proof ID as a hex string.
  , ...
]

Result (for verbosity = 1)

[                                  (json array of object)
  {                                (json object)
    "hex" : "xx",                  (string) The raw serialized double-spend proof data.
    "txid" : "xx"                  (string) The txid of the transaction associated with this double-spend. May be null for "orphan" double-spend proofs.
  }, ...
]

Result (for verbosity = 2 or true)

[                                  (json array of object)
  {                                (json object)
    "dspid" : "xx",                (string) Double-spend proof ID as a hex string.
    "txid" : "xx",                 (string) The txid of the transaction associated with this double-spend. May be null for "orphan" double-spend proofs.
    "outpoint" :                   (json object) The previous output (coin) that is being double-spent.
    {
      "txid" : "xx",               (string) The previous output txid.
      "vout" : n ,                 (numeric) The previous output index number.
    }
  }, ...
]

Result (additional keys for verbosity = 3)

    ...
    "spenders" :                   (json array of object) The conflicting spends.
    [
      {                            (json object)
        "txversion" : n,           (numeric) Transaction version number.
        "sequence" : n,            (numeric) Script sequence number.
        "locktime" : n,            (numeric) Spending tx locktime.
        "hashprevoutputs" : "xx",  (string) Hash of the previous outputs.
        "hashsequence" : "xx",     (string) Hash of the sequence.
        "hashoutputs" : "xx",      (string) Hash of the outputs.
        "pushdata" :               (json object) Script signature push data.
        {
          "asm" : "xx",            (string) Script assembly representation.
          "hex" : "xx"             (string) Script hex.
        }
      }, ...
    ]

Examples

> bitcoin-cli getdsprooflist 2 false
> bitcoin-cli getdsprooflist false false
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getdsprooflist", "params": [1, true] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/

Bitcoin Cash Node Daemon version v23.0.1-fe11d27

Documentation on docs.bitcoincashnode.org reflects the current master branch in Git, and may include API changes that are not yet present in the latest release.