waitforblock

Back to blockchain

Summary

Waits for a specific new block and returns useful info about it.

Description

Waits for a specific new block and returns useful info about it.

Returns the current block on timeout or exit.

Make sure to use no RPC timeout (qbit-cli -rpcclienttimeout=0)

Arguments

  • blockhash (STR_HEX, required): Block hash to wait for.
  • timeout (NUM): Time in milliseconds to wait for a response. 0 indicates no timeout.

Results

  • value (OBJ): No description.
  • hash (STR_HEX): The blockhash
  • height (NUM): Block height

Examples

qbit-cli waitforblock "0000000000079f8ef3d2c688c244eb7a4570b24c9ed7b4a8c619eb02596f8862" 1000

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "waitforblock", "params": ["0000000000079f8ef3d2c688c244eb7a4570b24c9ed7b4a8c619eb02596f8862", 1000]}' -H 'content-type: application/json' http://127.0.0.1:8352/