比特币(Bitcoin) RPC Blockchain API中getblockchaininfo的用法及代码示例。
用法:
getblockchaininfo
返回一个对象,其中包含有关区块链处理的各种状态信息。
返回结果
{
"chain": "xxxx", (string) current network name as defined in BIP70 (main, test, regtest)
"blocks": xxxxxx, (numeric) the current number of blocks processed in the server
"headers": xxxxxx, (numeric) the current number of headers we have validated
"bestblockhash": "...", (string) the hash of the currently best block
"difficulty": xxxxxx, (numeric) the current difficulty
"mediantime": xxxxxx, (numeric) median time for the current best block
"verificationprogress": xxxx, (numeric) estimate of verification progress [0..1]
"initialblockdownload": xxxx, (bool) (debug information) estimate of whether this node is in Initial Block Download mode.
"chainwork": "xxxx" (string) total amount of work in active chain, in hexadecimal
"size_on_disk": xxxxxx, (numeric) the estimated size of the block and undo files on disk
"pruned": xx, (boolean) if the blocks are subject to pruning
"pruneheight": xxxxxx, (numeric) lowest-height complete block stored (only present if pruning is enabled)
"automatic_pruning": xx, (boolean) whether automatic pruning is enabled (only present if pruning is enabled)
"prune_target_size": xxxxxx, (numeric) the target size used by pruning (only present if automatic pruning is enabled)
"softforks": [ (array) status of softforks in progress
{
"id": "xxxx", (string) name of softfork
"version": xx, (numeric) block version
"reject": { (object) progress toward rejecting pre-softfork blocks
"status": xx, (boolean) true if threshold reached
},
}, ...
],
"bip9_softforks": { (object) status of BIP9 softforks in progress
"xxxx" : { (string) name of the softfork
"status": "xxxx", (string) one of "defined", "started", "locked_in", "active", "failed"
"bit": xx, (numeric) the bit (0-28) in the block version field used to signal this softfork (only for "started" status)
"startTime": xx, (numeric) the minimum median time past of a block at which the bit gains its meaning
"timeout": xx, (numeric) the median time past of a block at which the deployment is considered failed if not yet locked in
"since": xx, (numeric) height of the first block to which the status applies
"statistics": { (object) numeric statistics about BIP9 signalling for a softfork (only for "started" status)
"period": xx, (numeric) the length in blocks of the BIP9 signalling period
"threshold": xx, (numeric) the number of blocks with the version bit set required to activate the feature
"elapsed": xx, (numeric) the number of blocks elapsed since the beginning of the current period
"count": xx, (numeric) the number of blocks with the version bit set in the current period
"possible": xx (boolean) returns false if there are not enough blocks left in this period to pass activation threshold
}
}
}
"warnings" : "...", (string) any network and blockchain warnings.
}
示例
bitcoin-cli getblockchaininfo
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockchaininfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/
相关用法
- Bitcoin getbestblockhash用法及代码示例
- Bitcoin getblock用法及代码示例
- Bitcoin getblockcount用法及代码示例
- Bitcoin getblockhash用法及代码示例
- Bitcoin getblockheader用法及代码示例
- Bitcoin getblockstats用法及代码示例
- Bitcoin getchaintips用法及代码示例
- Bitcoin getchaintxstats用法及代码示例
- Bitcoin getdifficulty用法及代码示例
- Bitcoin getmempoolancestors用法及代码示例
- Bitcoin getmempooldescendants用法及代码示例
- Bitcoin getmempoolentry用法及代码示例
- Bitcoin getmempoolinfo用法及代码示例
- Bitcoin getrawmempool用法及代码示例
- Bitcoin gettxout用法及代码示例
- Bitcoin gettxoutproof用法及代码示例
- Bitcoin gettxoutsetinfo用法及代码示例
- Bitcoin preciousblock用法及代码示例
- Bitcoin pruneblockchain用法及代码示例
- Bitcoin savemempool用法及代码示例
- Bitcoin scantxoutset用法及代码示例
- Bitcoin verifychain用法及代码示例
注:本文由纯净天空筛选整理自bitcoin.org大神的英文原创作品 Bitcoin getblockchaininfo。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。