|
|
|
@ -1128,46 +1128,46 @@ UniValue getblockchaininfo(const JSONRPCRequest& request)
@@ -1128,46 +1128,46 @@ UniValue getblockchaininfo(const JSONRPCRequest& request)
|
|
|
|
|
"Returns an object containing various state info regarding blockchain processing.\n" |
|
|
|
|
"\nResult:\n" |
|
|
|
|
"{\n" |
|
|
|
|
" \"chain\": \"xxxx\", (string) current network name as defined in BIP70 (main, test, regtest)\n" |
|
|
|
|
" \"blocks\": xxxxxx, (numeric) the current number of blocks processed in the server\n" |
|
|
|
|
" \"headers\": xxxxxx, (numeric) the current number of headers we have validated\n" |
|
|
|
|
" \"bestblockhash\": \"...\", (string) the hash of the currently best block\n" |
|
|
|
|
" \"difficulty\": xxxxxx, (numeric) the current difficulty\n" |
|
|
|
|
" \"mediantime\": xxxxxx, (numeric) median time for the current best block\n" |
|
|
|
|
" \"chain\": \"xxxx\", (string) current network name as defined in BIP70 (main, test, regtest)\n" |
|
|
|
|
" \"blocks\": xxxxxx, (numeric) the current number of blocks processed in the server\n" |
|
|
|
|
" \"headers\": xxxxxx, (numeric) the current number of headers we have validated\n" |
|
|
|
|
" \"bestblockhash\": \"...\", (string) the hash of the currently best block\n" |
|
|
|
|
" \"difficulty\": xxxxxx, (numeric) the current difficulty\n" |
|
|
|
|
" \"mediantime\": xxxxxx, (numeric) median time for the current best block\n" |
|
|
|
|
" \"verificationprogress\": xxxx, (numeric) estimate of verification progress [0..1]\n" |
|
|
|
|
" \"initialblockdownload\": xxxx, (bool) (debug information) estimate of whether this node is in Initial Block Download mode.\n" |
|
|
|
|
" \"chainwork\": \"xxxx\" (string) total amount of work in active chain, in hexadecimal\n" |
|
|
|
|
" \"size_on_disk\": xxxxxx, (numeric) the estimated size of the block and undo files on disk\n" |
|
|
|
|
" \"pruned\": xx, (boolean) if the blocks are subject to pruning\n" |
|
|
|
|
" \"pruneheight\": xxxxxx, (numeric) lowest-height complete block stored (only present if pruning is enabled)\n" |
|
|
|
|
" \"automatic_pruning\": xx, (boolean) whether automatic pruning is enabled (only present if pruning is enabled)\n" |
|
|
|
|
" \"chainwork\": \"xxxx\" (string) total amount of work in active chain, in hexadecimal\n" |
|
|
|
|
" \"size_on_disk\": xxxxxx, (numeric) the estimated size of the block and undo files on disk\n" |
|
|
|
|
" \"pruned\": xx, (boolean) if the blocks are subject to pruning\n" |
|
|
|
|
" \"pruneheight\": xxxxxx, (numeric) lowest-height complete block stored (only present if pruning is enabled)\n" |
|
|
|
|
" \"automatic_pruning\": xx, (boolean) whether automatic pruning is enabled (only present if pruning is enabled)\n" |
|
|
|
|
" \"prune_target_size\": xxxxxx, (numeric) the target size used by pruning (only present if automatic pruning is enabled)\n" |
|
|
|
|
" \"softforks\": [ (array) status of softforks in progress\n" |
|
|
|
|
" \"softforks\": [ (array) status of softforks in progress\n" |
|
|
|
|
" {\n" |
|
|
|
|
" \"id\": \"xxxx\", (string) name of softfork\n" |
|
|
|
|
" \"version\": xx, (numeric) block version\n" |
|
|
|
|
" \"reject\": { (object) progress toward rejecting pre-softfork blocks\n" |
|
|
|
|
" \"status\": xx, (boolean) true if threshold reached\n" |
|
|
|
|
" \"id\": \"xxxx\", (string) name of softfork\n" |
|
|
|
|
" \"version\": xx, (numeric) block version\n" |
|
|
|
|
" \"reject\": { (object) progress toward rejecting pre-softfork blocks\n" |
|
|
|
|
" \"status\": xx, (boolean) true if threshold reached\n" |
|
|
|
|
" },\n" |
|
|
|
|
" }, ...\n" |
|
|
|
|
" ],\n" |
|
|
|
|
" \"bip9_softforks\": { (object) status of BIP9 softforks in progress\n" |
|
|
|
|
" \"xxxx\" : { (string) name of the softfork\n" |
|
|
|
|
" \"status\": \"xxxx\", (string) one of \"defined\", \"started\", \"locked_in\", \"active\", \"failed\"\n" |
|
|
|
|
" \"bit\": xx, (numeric) the bit (0-28) in the block version field used to signal this softfork (only for \"started\" status)\n" |
|
|
|
|
" \"startTime\": xx, (numeric) the minimum median time past of a block at which the bit gains its meaning\n" |
|
|
|
|
" \"timeout\": xx, (numeric) the median time past of a block at which the deployment is considered failed if not yet locked in\n" |
|
|
|
|
" \"since\": xx, (numeric) height of the first block to which the status applies\n" |
|
|
|
|
" \"statistics\": { (object) numeric statistics about BIP9 signalling for a softfork (only for \"started\" status)\n" |
|
|
|
|
" \"period\": xx, (numeric) the length in blocks of the BIP9 signalling period \n" |
|
|
|
|
" \"threshold\": xx, (numeric) the number of blocks with the version bit set required to activate the feature \n" |
|
|
|
|
" \"elapsed\": xx, (numeric) the number of blocks elapsed since the beginning of the current period \n" |
|
|
|
|
" \"count\": xx, (numeric) the number of blocks with the version bit set in the current period \n" |
|
|
|
|
" \"possible\": xx (boolean) returns false if there are not enough blocks left in this period to pass activation threshold \n" |
|
|
|
|
" \"bip9_softforks\": { (object) status of BIP9 softforks in progress\n" |
|
|
|
|
" \"xxxx\" : { (string) name of the softfork\n" |
|
|
|
|
" \"status\": \"xxxx\", (string) one of \"defined\", \"started\", \"locked_in\", \"active\", \"failed\"\n" |
|
|
|
|
" \"bit\": xx, (numeric) the bit (0-28) in the block version field used to signal this softfork (only for \"started\" status)\n" |
|
|
|
|
" \"startTime\": xx, (numeric) the minimum median time past of a block at which the bit gains its meaning\n" |
|
|
|
|
" \"timeout\": xx, (numeric) the median time past of a block at which the deployment is considered failed if not yet locked in\n" |
|
|
|
|
" \"since\": xx, (numeric) height of the first block to which the status applies\n" |
|
|
|
|
" \"statistics\": { (object) numeric statistics about BIP9 signalling for a softfork (only for \"started\" status)\n" |
|
|
|
|
" \"period\": xx, (numeric) the length in blocks of the BIP9 signalling period \n" |
|
|
|
|
" \"threshold\": xx, (numeric) the number of blocks with the version bit set required to activate the feature \n" |
|
|
|
|
" \"elapsed\": xx, (numeric) the number of blocks elapsed since the beginning of the current period \n" |
|
|
|
|
" \"count\": xx, (numeric) the number of blocks with the version bit set in the current period \n" |
|
|
|
|
" \"possible\": xx (boolean) returns false if there are not enough blocks left in this period to pass activation threshold \n" |
|
|
|
|
" }\n" |
|
|
|
|
" }\n" |
|
|
|
|
" }\n" |
|
|
|
|
" \"warnings\" : \"...\", (string) any network and blockchain warnings.\n" |
|
|
|
|
" \"warnings\" : \"...\", (string) any network and blockchain warnings.\n" |
|
|
|
|
"}\n" |
|
|
|
|
"\nExamples:\n" |
|
|
|
|
+ HelpExampleCli("getblockchaininfo", "") |
|
|
|
|