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
    }
  }
}