Skip to content

eth_getBlockByHash


Returns information about a block by block hash

Parameters

Block hash

A block hash, as a hex number in a JSON string eg. "0xf77e76c25038b0be1fbd12a4f3e404173802bf0c9a9e62deef7949201d59ebfb"

Hydrated

If this parameter is true, we return transaction objects. If false, we return a list of hashes.

Results

A block, or null if no such block is known to this node.

Block

Parameter Type Required Description
hash string required Block hash as a hex number
parentHash string required Hash of the parent of this block
sha3Uncles string required Since zq2 has no uncles, this field is always 0x0
miner string required Set to the address that received the reward for generating this block
stateRoot string required The state root hash for this block
transactionsRoot string required Always 0x0
receiptsRoot string required Always 0x0
logsBloom string required Always 0x0
difficulty number required 0
number string required Block number in hex
gasLimit string required Gas limit for this block, in hex
gasUsed string required Gas used in this block, in hex
timestamp string required Hex value of the number of seconds between the UNIX epoch and the creation of this block
extraData string required Hex value of extra data for this block; currently always 0x0
mixHash string required hex number, always 0x0
nonce string required hex number, always 0x0
totalDifficulty number required 0
size number required Always 0
transactions array required An array of either transaction hashes or returned transaction objects
uncles array required Always empty
quorum_certificate object required zq2-specific quorum certificate
aggregate_quorum_certificate object optional An aggregate quorum certificate, if one was attached to this block

The quorum_certificate contains:

Parameter Type Required Description
signature string required Hex string; the BLS aggregate signature of the block hash in this view
cosigned array required An array of integers; 1 means this committee member participated in the signature, 0 that they did not
view string required Hex string; the view number for this QC
block_hash string rquired Hex string; the block hash

Sometimes, a quorum certificate cannot be established for a proposal due to validator failure or some other cause. When this happens, an aggregate_quorum_certificate appears in the next block, with the quorum_certificate providing a copy of the highest QC within this aggregate.

Parameter Type Required Description
qcs array required A vector of quorum_certificates.
signature string required Hex string; the BLS aggregate signature of the qcs in this aggregate
cosigned array required An array of integers; 1 means this committee member participated in the signature, 0 that they did not
view string required Hex string; the view number for this QC

We do not currently report:

  • baseFeePerGas
  • withdrawalsRoot
  • blobGasUsed
  • excessBlobGas
  • parentBeaconBlockRoot

If hydrated is true, blocks contain returned transactions.

Returned transaction

Parameter Type Required Description
blockHash string required Hash of the block in which this transaction appears
blockNumber string required Hex number of the block in which this transaction appears
from string required From address of this transaction
gas string required Hex number - the amount of gas used by this transaction
gasPrice string required Hex number - the gas price charged for this transaction, per gas unit
maxFeePerGas string optional Hex number - max fee per gas for this transaction. See EIP-1559.
maxPriorityFeePerGas string optional Hex number - max priority fee per gas. See EIP-1559.
hash string required The transaction hash for this transaction
input string required The input for this transaction
nonce string required Hex number; the nonce for this transaction.
to string required To address for this transaction
value string required Hex number; the value sent with this transaction
v string required Hex number; the v parameter for the signature for this transaction
r string required Hex number; the r parameter for the signature on this transaction
s string required Hex number; the s parameter for the signature on this transaction
chainId string optional Hex number. The (EVM) chain id for this zq2 chain
access_list array optional EIP-1559 access list.
type string required Hex number; type of this transaction

Example Request

curl -d '{
    "id": "1",
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [ "0x50b3b76c3a4f19ac20e498744d8e0ff9a110b9130acb3ba786c80c26738ee9ae", true
 ]}' -H "Content-Type: application/json" -X POST "https://api.zq2-prototestnet.zilliqa.com/"

Example response

{
  "jsonrpc": "2.0",
  "result": {
    "number": "0x4f5f",
    "view": "0x4f60",
    "hash": "0x50b3b76c3a4f19ac20e498744d8e0ff9a110b9130acb3ba786c80c26738ee9ae",
    "parentHash": "0xec294892c9d8d325483eb26af35dca5801113d50a4e8ab0f85cfa15a44a7b65e",
    "nonce": "0x0000000000000000",
    "sha3Uncles": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "transactionsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "stateRoot": "0x20fe4121df6d491706e10f2165ea6cf25c9a6de8964714ec86101bf30c3f4713",
    "receiptsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "miner": "0x6813eb9362372eef6200f3b1dbc3f819671cba69",
    "difficulty": "0x0",
    "totalDifficulty": "0x0",
    "extraData": "0x",
    "gasLimit": "0x501bd00",
    "gasUsed": "0x90042",
    "timestamp": "0x667aef3a",
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "size": "0x0",
    "transactions": [
      {
        "blockHash": "0x50b3b76c3a4f19ac20e498744d8e0ff9a110b9130acb3ba786c80c26738ee9ae",
        "blockNumber": "0x4f5f",
        "from": "0xcb57ec3f064a16cadb36c7c712f4c9fa62b77415",
        "gas": "0xbb278",
        "gasPrice": "0x454b7a4e100",
        "hash": "0xf4818804242f4a1f5c8f9d255a51b80bd1e21c0047affffd5f480636ac2a9773",
        "input": "0x608060405234801561001057600080fd5b50604051610c38380380610c3883398101604081905261002f91610298565b8282600361003d8382610393565b50600461004a8282610393565b505050600061005d61007260201b60201c565b90506100698183610076565b50505050610478565b3390565b6001600160a01b0382166100a55760405163ec442f0560e01b8152600060048201526024015b60405180910390fd5b6100b1600083836100b5565b5050565b6001600160a01b0383166100e05780600260008282546100d59190610451565b909155506101529050565b6001600160a01b038316600090815260208190526040902054818110156101335760405163391434e360e21b81526001600160a01b0385166004820152602481018290526044810183905260640161009c565b6001600160a01b03841660009081526020819052604090209082900390555b6001600160a01b03821661016e5760028054829003905561018d565b6001600160a01b03821660009081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516101d291815260200190565b60405180910390a3505050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261020657600080fd5b81516001600160401b0381111561021f5761021f6101df565b604051601f8201601f19908116603f011681016001600160401b038111828210171561024d5761024d6101df565b60405281815283820160200185101561026557600080fd5b60005b8281101561028457602081860181015183830182015201610268565b506000918101602001919091529392505050565b6000806000606084860312156102ad57600080fd5b83516001600160401b038111156102c357600080fd5b6102cf868287016101f5565b602086015190945090506001600160401b038111156102ed57600080fd5b6102f9868287016101f5565b925050604084015190509250925092565b600181811c9082168061031e57607f821691505b60208210810361033e57634e487b7160e01b600052602260045260246000fd5b50919050565b601f82111561038e57806000526020600020601f840160051c8101602085101561036b5750805b601f840160051c820191505b8181101561038b5760008155600101610377565b50505b505050565b81516001600160401b038111156103ac576103ac6101df565b6103c0816103ba845461030a565b84610344565b6020601f8211600181146103f457600083156103dc5750848201515b600019600385901b1c1916600184901b17845561038b565b600084815260208120601f198516915b828110156104245787850151825560209485019460019092019101610404565b50848210156104425786840151600019600387901b60f8161c191681555b50505050600190811b01905550565b8082018082111561047257634e487b7160e01b600052601160045260246000fd5b92915050565b6107b1806104876000396000f3fe608060405234801561001057600080fd5b50600436106100a95760003560e01c8063313ce56711610071578063313ce5671461011c57806370a082311461012b57806385bb7d691461015457806395d89b411461015b578063a9059cbb14610163578063dd62ed3e1461017657600080fd5b806306fdde03146100ae578063095ea7b3146100cc57806318160ddd146100ef57806319ff1d211461010157806323b872dd14610109575b600080fd5b6100b66101af565b6040516100c391906105fa565b60405180910390f35b6100df6100da366004610664565b610241565b60405190151581526020016100c3565b6002545b6040519081526020016100c3565b6100b661025b565b6100df61011736600461068e565b61028c565b604051601281526020016100c3565b6100f36101393660046106cb565b6001600160a01b031660009081526020819052604090205490565b602a6100f3565b6100b66102b0565b6100df610171366004610664565b6102bf565b6100f36101843660046106ed565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b6060600380546101be90610720565b80601f01602080910402602001604051908101604052809291908181526020018280546101ea90610720565b80156102375780601f1061020c57610100808354040283529160200191610237565b820191906000526020600020905b81548152906001019060200180831161021a57829003601f168201915b5050505050905090565b60003361024f8185856102cd565b60019150505b92915050565b60603361026a816103e86102df565b505060408051808201909152600681526548656c6c6f2160d01b602082015290565b60003361029a85828561031e565b6102a585858561039c565b506001949350505050565b6060600480546101be90610720565b60003361024f81858561039c565b6102da83838360016103fb565b505050565b6001600160a01b03821661030e57604051634b637e8f60e11b8152600060048201526024015b60405180910390fd5b61031a826000836104d0565b5050565b6001600160a01b038381166000908152600160209081526040808320938616835292905220546000198114610396578181101561038757604051637dc7a0d960e11b81526001600160a01b03841660048201526024810182905260448101839052606401610305565b610396848484840360006103fb565b50505050565b6001600160a01b0383166103c657604051634b637e8f60e11b815260006004820152602401610305565b6001600160a01b0382166103f05760405163ec442f0560e01b815260006004820152602401610305565b6102da8383836104d0565b6001600160a01b0384166104255760405163e602df0560e01b815260006004820152602401610305565b6001600160a01b03831661044f57604051634a1406b160e11b815260006004820152602401610305565b6001600160a01b038085166000908152600160209081526040808320938716835292905220829055801561039657826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040516104c291815260200190565b60405180910390a350505050565b6001600160a01b0383166104fb5780600260008282546104f0919061075a565b9091555061056d9050565b6001600160a01b0383166000908152602081905260409020548181101561054e5760405163391434e360e21b81526001600160a01b03851660048201526024810182905260448101839052606401610305565b6001600160a01b03841660009081526020819052604090209082900390555b6001600160a01b038216610589576002805482900390556105a8565b6001600160a01b03821660009081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516105ed91815260200190565b60405180910390a3505050565b602081526000825180602084015260005b81811015610628576020818601810151604086840101520161060b565b506000604082850101526040601f19601f83011684010191505092915050565b80356001600160a01b038116811461065f57600080fd5b919050565b6000806040838503121561067757600080fd5b61068083610648565b946020939093013593505050565b6000806000606084860312156106a357600080fd5b6106ac84610648565b92506106ba60208501610648565b929592945050506040919091013590565b6000602082840312156106dd57600080fd5b6106e682610648565b9392505050565b6000806040838503121561070057600080fd5b61070983610648565b915061071760208401610648565b90509250929050565b600181811c9082168061073457607f821691505b60208210810361075457634e487b7160e01b600052602260045260246000fd5b50919050565b8082018082111561025557634e487b7160e01b600052601160045260246000fdfea2646970667358221220c897a6dc5042fca31e75cf787b9a01c183696d0d2633cbe16843fac3a4115cf464736f6c634300081a0033000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000f42400000000000000000000000000000000000000000000000000000000000000008525257546573744100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000045254414100000000000000000000000000000000000000000000000000000000",
        "nonce": "0x0",
        "to": null,
        "transactionIndex": "0x0",
        "value": "0x0",
        "v": "0x1059b",
        "r": "0x187862d385dcea721250462ee0afa98e61f25434301dac120c94c23e210a6518",
        "s": "0x217a53d53590aa2ffad21d2227e9c2268d513a3e17743fed5ee597be48dc7b01",
        "chainId": "0x82bc",
        "type": "0x0"
      }
    ],
    "uncles": [],
    "quorumCertificate": {
      "signature": "0xa31bb94ff29d0c1d0d1e5e79cc798051d7721255e49fbdb5dffc50e9a641247d7173c9e3673539593092b1746fa573fe12fb510436086e62f2c7fc1fddf18d18f5e7a3a7168965b67fc2aa70da89ac36cca8b90bdf54861415e9092ea34826f3",
      "cosigned": "[1, 0, 1, 1]",
      "view": "0x4f5f",
      "block_hash": "0xec294892c9d8d325483eb26af35dca5801113d50a4e8ab0f85cfa15a44a7b65e"
    }
  },
  "id": "1"
}

Arguments

Parameter Type Required Description
id string Required "1"
jsonrpc string Required "2.0"
method string Required "eth_getBlockByHash"
params array Required [ block_hash, hydrated ]