waitforblockheight (hidden command)

Bitcoin Core 25.0 RPC

waitforblockheight height ( timeout )

Waits for (at least) block height and returns the height and hash

of the current tip.

Returns the current block on timeout or exit.


1. height     (numeric, required) Block height to wait for.
2. timeout    (numeric, optional, default=0) Time in milliseconds to wait for a response. 0 indicates no timeout.


{                    (json object)
  "hash" : "hex",    (string) The blockhash
  "height" : n       (numeric) Block height


> bitcoin-cli waitforblockheight 100 1000
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "waitforblockheight", "params": [100, 1000]}' -H 'content-type: text/plain;'