以太坊JSON RPC手册

eth_syncing

对于已经同步的客户端,该调用返回一个描述同步状态的对象;对于未同步客户端,返回false。

参数

返回值

Object|Boolean, 同步状态对象或false。同步对象的结构如下:

  • startingBlock: QUANTITY - 开始块
  • currentBlock: QUANTITY - 当前块,同eth_blockNumber
  • highestBlock: QUANTITY - 预估最高块

示例代码

请求:

curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'

响应:

{
  "id":1,
  "jsonrpc": "2.0",
  "result": {
    startingBlock: '0x384',
    currentBlock: '0x386',
    highestBlock: '0x454'
  }
}

如果未同步则结果如下:

{
  "id":1,
  "jsonrpc": "2.0",
  "result": false
}