GetBlockChainInfo/获取区块链当前状态
getblockchaininfo
调用返回区块链的当前状态。
参数
无
返回值
getblockchaininfo
调用返回一个描述区块链当前状态的对象,其结构如下:
- chain:区块链名称,可以是:main、test或regtest
- blocks:本地最优链中的已验证区块数量
- headers:本地最有区块头链表中的已验证区块头数量
- bestblockhash:本地最优链中最高区块的哈希
- difficulty:区块难度
- mediantime:最近区块之前的11个区块的中位时间
- verificationprogress:区块验证进度,0.0~1.0
- chainwork:
- pruned:
- pruneheight:
- softforks:软分叉描述数组,成员结构如下:
- id:
- version:
- enforce:
- status:
- found:
- required:
- window:
- reject:
- status:
- bip9_softforks
- name: 一个BIP39软分叉描述对象,结构如下
- status:当前的状态,可以是以下值之一:
- defined - started - locked_in - active - failed
- bit:在软件版本字段中的位号
- startTime:软分叉开始时间戳
- timeout:超时时间戳
- since:
示例代码
下面的命令返回区块链的总体信息:
~$ bitcoin-cli getblockchaininfo
输出结果如下:
{
"chain": "main",
"blocks": 464562,
"headers": 464562,
"bestblockhash": "00000000000000000085bd56990c579a36bade6ea427646612f13476edb30ceb",
"difficulty": 521974519553.6282,
"mediantime": 1493758169,
"verificationprogress": 0.999989733170878,
"chainwork": "00000000000000000000000000000000000000000052c26f32ffa22706efd28c",
"pruned": false,
"softforks": [
{
"id": "bip34",
"version": 2,
"reject": {
"status": true
}
},
{
"id": "bip66",
"version": 3,
"reject": {
"status": true
}
},
{
"id": "bip65",
"version": 4,
"reject": {
"status": true
}
}
],
"bip9_softforks": {
"csv": {
"status": "active",
"startTime": 1462060800,
"timeout": 1493596800,
"since": 419328
},
"segwit": {
"status": "started",
"bit": 1,
"startTime": 1479168000,
"timeout": 1510704000,
"since": 439488
}
}
}