Find file Copy path
f7a8acf Nov 11, 2018
1 contributor

Users who have contributed to this file

53 lines (37 sloc) 2.87 KB


The getBlock tool retrieves Ethereum block data from a running node or, if previously retrieved, the QBlocks cache. It optionally retrieves the hashes that denote the transactions in the block or the full transactional data as a default.

The tool may also be used to double check that the results produced from the QBlocks cache and the results as retrieved directly from the running node are identical (modulo the fact that QBlocks does not store every data field from the node). You may accomplish this check with the --check option.


Usage: getBlock [-r|-n|-c|-l|-a|-u|-x|-m|-l|-v|-h] <block> [block...]
Purpose: Returns block(s) from local cache or directly from a running node.


Short Cut Option Description
block_list a space-separated list of one or more blocks to retrieve
-r --raw pull the block data from the running Ethereum node (no cache)
-n --hash_only display only transaction hashes, default is to display full transaction detail
-c --check compare results between qblocks and Ethereum node, report differences, if any
-l --latest display the latest blocks at both the node and the cache
-a --addrs display all addresses included in the block
-u --uniq display only uniq addresses found per block
-x --uniqTx display only uniq addresses found per transaction
-m --number display address counts (alterntively --addrCnt, --uniqTxCnt, or --uniqCnt)
-l --filter val useful only for --addrs or --uniq, only display this address in results
-v --verbose set verbose level. Either -v, --verbose or -v:n where 'n' is level
-h --help display this help screen


  • block_list is a space-separated list of values, a start-end range, a special, or any combination.
  • This tool retrieves information from the local node or the ${FALLBACK} node, if configured (see documentation).
  • special blocks are detailed under whenBlock --list.

Other Options

All QBlocks command-line tools support the following commands (although in some case, they have no meaning):

Command     |     Description
--version   |   display the current version of the tool
--nocolor   |   turn off colored display
--wei       |   specify value in wei (the default)
--ether     |   specify value in ether
--dollars   |   specify value in US dollars
--file:fn   |   specify multiple sets of command line options in a file.

For the --file:fn option, place a series of valid command lines in a file and use the above options. In some cases, this option may significantly improve performance. A semi-colon at the start of a line makes that line a comment.

Powered by Qblocks