waitforblockheight

hidden

v0.15.1

waitforblockheight  (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.

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

Result:
{ (json object)
"hash" : { (string) The blockhash
"height" : { (int) Block height
}

Examples:
> 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;' http://127.0.0.1:8332/
Don't trust. Verify. Docs extracted from src/rpc/blockchain.cpp#L273-L292.