Skip to main content

cfx_getBlockByBlockNumber

Returns block with given block number.

curl --request POST \
     --url https://main.confluxrpc.com \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "params": ["0x0",false],
  "method": "cfx_getBlockByBlockNumber"
}'

Params

block_number required

Schema
type : string
Pattern : ^0x([1-9a-f][0-9a-f]{0,15}|0)$

include_txs required

Schema
type : boolean

Result

Schema
type : object
  • adaptive adaptive
    type : boolean
  • baseFeePerGas baseFeePerGas
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • blame blame
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,15}|0)$
  • blockNumber blockNumber
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • custom custom
    type : array
    • items[x] Bytes
      type : string
      Pattern : ^0x[0-9a-f]*$
  • deferredLogsBloomHash deferredLogsBloomHash
    type : string
    Pattern : ^0x[0-9,a-f,A-F]{64}$
  • deferredReceiptsRoot deferredReceiptsRoot
    type : string
    Pattern : ^0x[0-9,a-f,A-F]{64}$
  • deferredStateRoot deferredStateRoot
    type : string
    Pattern : ^0x[0-9,a-f,A-F]{64}$
  • difficulty difficulty
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • epochNumber epochNumber
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • gasLimit gasLimit
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • gasUsed gasUsed
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • hash hash
    type : string
    Pattern : ^0x[0-9,a-f,A-F]{64}$
  • height height
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • miner miner
    type : string
    Pattern : ^(NET\d+|CFX|CFXTEST)(:TYPE\..*|):[ABCDEFGHJKMNPRSTUVWXYZ0123456789]{42}$
  • nonce nonce
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • parentHash parentHash
    type : string
    Pattern : ^0x[0-9,a-f,A-F]{64}$
  • posReference posReference
    type : string
    Pattern : ^0x[0-9,a-f,A-F]{64}$
  • powQuality powQuality
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • refereeHashes refereeHashes
    type : array
    • items[x] H256
      type : string
      Pattern : ^0x[0-9,a-f,A-F]{64}$
  • size size
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • timestamp timestamp
    type : string
    Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$
  • transactions transactions
    oneOf
    type : array
    • items[x] H256
      type : string
      Pattern : ^0x[0-9,a-f,A-F]{64}$
  • transactionsRoot transactionsRoot
    type : string
    Pattern : ^0x[0-9,a-f,A-F]{64}$

Examples

Request

curl -X POST --data \
'{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "cfx_getBlockByBlockNumber",
    "params": [
        "0x0"
    ]
}' \
-H "Content-Type: application/json" \
localhost:12539

Response

null