Description
hmy_getBlocks returns blocks in range [from; to]
API v1
Parameters
String
- starting block number in 0x format
String
- ending block number in 0x format
blockArgs
- optional args struct in json format (should be used just with { })
fullTx
- Bool
: To show full tx or not
withSigners
- Bool
: Include block signes in blocks or not
Returns
Array
: returns blocks list in json format
number
- Number
: The block number. null
when its pending block.
hash
32 Bytes - String
: Hash of the block. null
when its pending block.
parentHash
32 Bytes - String
: Hash of the parent block.
nonce
8 Bytes - String
: Hash of the generated proof-of-work.null
when its pending block.
logsBloom
256 Bytes - String
: The bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
32 Bytes - String
: The root of the transaction trie of the block
stateRoot
32 Bytes - String
: The root of the final state trie of the block.
miner
- String
: The address of the beneficiary to whom the mining rewards were given.
difficulty
- Number
: Integer of the difficulty for this block.
extraData
- String
: The “extra data” field of this block.
size
- Number
: Integer the size of this block in bytes.
gasLimit
- Number
: The maximum gas allowed in this block.
gasUsed
- Number
: The total used gas by all transactions in this block.
timestamp
- Number
: The unix timestamp for when the block was collated, 0x format.
stakingTransactions
- Array
: Array of staking transactions object; absent if inclStaking is false, are present by default.
transactions
- Array
: Array of transaction objects; absent if second parameter is false
.
signers
- Array
: Array of validators one addresses who signed this block
uncles
- Array
: Array of uncle hashes.
Sample Curl Request
curl -d '{
"jsonrpc":"2.0",
"method":"hmy_getBlocks",
"params":[
"0x0",
"0x1",
{
"withSigners": true,
"fullTx": true
}
],
"id":1
}' -H "Content-Type: application/json" -X POST "https://api.s0.b.hmny.io"
Sample Curl Response
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"difficulty": 0,
"extraData": "0x4861726d6f6e7920666f72204f6e6520616e6420416c6c2e204f70656e20436f6e73656e73757320666f72203130422e",
"gasLimit": "0x47e7c4",
"gasUsed": "0x0",
"hash": "0x34a8b155f90b8fc22342fc8b5d1c969ed836a2f666c506e4017b570dc337e88c",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0x0000000000000000000000000000000000000000",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": 0,
"number": "0x0",
"parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"signers": [],
"size": "0x6ed",
"stateRoot": "0xae22370df046aa8c4470a032ecc88609efc08438abe79fd9e7f134b077a11fb6",
"timestamp": "0x5d162b70",
"transactions": [],
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncles": []
},
{
"difficulty": 0,
"extraData": "0x",
"gasLimit": "0x47f9bc",
"gasUsed": "0x0",
"hash": "0x9e91a1ebe860eab3821f0d731689ec3833863f445a6f79649ce2813782e36be2",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0x0b585f8daefbc68a311fbd4cb20d9174ad174016",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": 0,
"number": "0x1",
"parentHash": "0x34a8b155f90b8fc22342fc8b5d1c969ed836a2f666c506e4017b570dc337e88c",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"signers": [
"one1pdv9lrdwl0rg5vglh4xtyrv3wjk3wsqket7zxy",
"one12fuf7x9rgtdgqg7vgq0962c556m3p7afsxgvll",
"one1pf75h0t4am90z8uv3y0dgunfqp4lj8wr3t5rsp",
"one1spshr72utf6rwxseaz339j09ed8p6f8ke370zj",
"one1d2rngmem4x2c6zxsjjz29dlah0jzkr0k2n88wc",
"one103q7qe5t2505lypvltkqtddaef5tzfxwsse4z7"
],
"size": "0x33b",
"stateRoot": "0xae22370df046aa8c4470a032ecc88609efc08438abe79fd9e7f134b077a11fb6",
"timestamp": "0x5db74a3f",
"transactions": [],
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncles": []
}
]
}
API v2
Parameters
Number
- starting block number
Number
- ending block number
blockArgs
- optional args struct in json format (should be used just with { })
fullTx
- Bool
: To show full tx or not
withSigners
- Bool
: Include block signes in blocks or not
inclStaking
- Bool
: To show staking txs or not
Returns
Array
: returns blocks list in json format
number
- Number
: The block number. null
when its pending block.
hash
32 Bytes - String
: Hash of the block. null
when its pending block.
parentHash
32 Bytes - String
: Hash of the parent block.
nonce
8 Bytes - String
: Hash of the generated proof-of-work. null
when its pending block.
logsBloom
256 Bytes - String
: The bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
32 Bytes - String
: The root of the transaction trie of the block
stateRoot
32 Bytes - String
: The root of the final state trie of the block.
miner
- String
: The address of the beneficiary to whom the mining rewards were given.
difficulty
- String
: Integer of the difficulty for this block.
extraData
- String
: The “extra data” field of this block.
size
- Number
: Integer the size of this block in bytes.
gasLimit
- Number
: The maximum gas allowed in this block.
gasUsed
- Number
: The total used gas by all transactions in this block.
timestamp
- Number
: The unix timestamp for when the block was collated.
stakingTransactions
- Array
: Array of staking transactions object; absent if inclStaking is false, are present by default
transactions
- Array
: Array of transaction objects; only hashes if fullTx is false, are hashes by default
signers
- Array
: Array of validators one addresses who signed this block
uncles
- Array
: Array of uncle hashes.
Sample Curl Request
curl -d '{
"jsonrpc":"2.0",
"method":"hmyv2_getBlocks",
"params":[
1,
2,
{
"withSigners": true,
"fullTx": true,
"inclStaking": true
}
],
"id":1
}' -H "Content-Type: application/json" -X POST "https://api.s0.b.hmny.io"
Sample Curl Response
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"difficulty": 0,
"extraData": "0x",
"gasLimit": 4716988,
"gasUsed": 0,
"hash": "0xdeca0d8c04a45b78bc0b6c1811bae6c2570b0cc4dc82ae11df2e09fd0194ce90",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0x0b585f8daefbc68a311fbd4cb20d9174ad174016",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": 0,
"number": 1,
"parentHash": "0x34a8b155f90b8fc22342fc8b5d1c969ed836a2f666c506e4017b570dc337e88c",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"signers": [
"one1pdv9lrdwl0rg5vglh4xtyrv3wjk3wsqket7zxy",
"one12fuf7x9rgtdgqg7vgq0962c556m3p7afsxgvll",
"one1pf75h0t4am90z8uv3y0dgunfqp4lj8wr3t5rsp",
"one1spshr72utf6rwxseaz339j09ed8p6f8ke370zj",
"one1d2rngmem4x2c6zxsjjz29dlah0jzkr0k2n88wc",
"one1a50tun737ulcvwy0yvve0pvu5skq0kjargvhwe",
"one103q7qe5t2505lypvltkqtddaef5tzfxwsse4z7"
],
"size": 827,
"stakingTransactions": [],
"stateRoot": "0xae22370df046aa8c4470a032ecc88609efc08438abe79fd9e7f134b077a11fb6",
"timestamp": 1580418265,
"transactions": [],
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncles": []
},
{
"difficulty": 0,
"extraData": "0x",
"gasLimit": 4721593,
"gasUsed": 0,
"hash": "0x0d7eb3f99bb28cecd5af7a19d809f917b1b210ad1fc10d5cf273e7cf32e416be",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0x0b585f8daefbc68a311fbd4cb20d9174ad174016",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": 0,
"number": 2,
"parentHash": "0xdeca0d8c04a45b78bc0b6c1811bae6c2570b0cc4dc82ae11df2e09fd0194ce90",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"signers": [
"one1pdv9lrdwl0rg5vglh4xtyrv3wjk3wsqket7zxy",
"one12fuf7x9rgtdgqg7vgq0962c556m3p7afsxgvll",
"one1pf75h0t4am90z8uv3y0dgunfqp4lj8wr3t5rsp",
"one1spshr72utf6rwxseaz339j09ed8p6f8ke370zj",
"one1d2rngmem4x2c6zxsjjz29dlah0jzkr0k2n88wc",
"one1a50tun737ulcvwy0yvve0pvu5skq0kjargvhwe",
"one103q7qe5t2505lypvltkqtddaef5tzfxwsse4z7"
],
"size": 698,
"stakingTransactions": [],
"stateRoot": "0x4e37e8739fc27e85c95f38c1c8ac2d8a382c9086c0fcdfd7762904b2c80f067c",
"timestamp": 1580418273,
"transactions": [],
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncles": []
}
]
}