rescanblockchain

rescanblockchain ( start_height stop_height ) Rescan the local blockchain for wallet related transactions. Note: Use "getwalletinfo" to query the scanning progress. The rescan is significantly faster when used on a descriptor wallet and block filters are available (using startup option "-blockfilterindex=1"). Arguments: 1. start_height (numeric, optional, default=0) block height where the rescan should start 2. stop_height (numeric, optional) the last block height that should be scanned. If none is provided it will rescan up to the tip at return time of this call. Result: { (json object) "start_height" : n, (numeric) The block height where the rescan started (the requested height or 0) "stop_height" : n (numeric) The height of the last rescanned block. May be null in rare cases if there was a reorg and the call didn't scan any blocks because they were already scanned in the background. } Examples: > bitcoin-cli rescanblockchain 100000 120000 > curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "rescanblockchain", "params": [100000, 120000]}' -H 'content-type: application/json' http://127.0.0.1:8332/

Signature

rescanblockchain(start_height?: number, stop_height?: number) → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"rescanblockchain","params":[0,0]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli rescanblockchain 100000 120000

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "rescanblockchain", "params": [100000, 120000]}' -H 'content-type: application/json' http://127.0.0.1:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "rescanblockchain",
        "params": [0, 0],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "rescanblockchain",
    params: [0,0],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
start_height	`number`	—	block height where the rescan should start
stop_height	`number`	—	the last block height that should be scanned. If none is provided it will rescan up to the tip at return time of this call.

Result

Type: any

{ (json object) "start_height" : n, (numeric) The block height where the rescan started (the requested height or 0) "stop_height" : n (numeric) The height of the last rescanned block. May be null in rare cases if there was a reorg and the call didn't scan any blocks because they were already scanned in the background. }

Source: services/core-node/bcore/src/wallet/rpc/transactions.cpp:899

C++ symbol: rescanblockchain

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"rescanblockchain","params":[0,0]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli rescanblockchain 100000 120000

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "rescanblockchain", "params": [100000, 120000]}' -H 'content-type: application/json' http://127.0.0.1:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "rescanblockchain",
        "params": [0, 0],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "rescanblockchain",
    params: [0,0],
  }),
});
console.log(await res.json());