← Celo overview
Celo · eth
eth_getBlockByHash
Returns information about a block by hash.
Parameters
Block hashrequiredSchema{ "type": "string", "title": "32 byte hex value", "pattern": "^0x[0-9a-f]{64}$" }Hydrated transactionsrequiredSchema{ "type": "boolean", "title": "hydrated" }
Result
Block information
Schema
{
"oneOf": [
{
"type": "null",
"title": "Not Found (null)"
},
{
"type": "object",
"title": "Block object",
"properties": {
"baseFeePerGas": {
"type": "string",
"title": "Base fee per gas",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"blobGasUsed": {
"type": "string",
"title": "Blob gas used",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"blockAccessListHash": {
"type": "string",
"title": "EIP-7928 block access list hash",
"pattern": "^0x[0-9a-f]{64}$"
},
"difficulty": {
"type": "string",
"title": "Difficulty",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"excessBlobGas": {
"type": "string",
"title": "Excess blob gas",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"extraData": {
"type": "string",
"title": "Extra data",
"pattern": "^0x[0-9a-f]*$"
},
"gasLimit": {
"type": "string",
"title": "Gas limit",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gasUsed": {
"type": "string",
"title": "Gas used",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"hash": {
"type": "string",
"title": "Hash",
"pattern": "^0x[0-9a-f]{64}$"
},
"logsBloom": {
"type": "string",
"title": "Bloom filter",
"pattern": "^0x[0-9a-f]{512}$"
},
"miner": {
"type": "string",
"title": "Coinbase",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"mixHash": {
"type": "string",
"title": "Mix hash",
"pattern": "^0x[0-9a-f]{64}$"
},
"nonce": {
"type": "string",
"title": "Nonce",
"pattern": "^0x[0-9a-f]{16}$"
},
"number": {
"type": "string",
"title": "Number",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"parentBeaconBlockRoot": {
"type": "string",
"title": "Parent Beacon Block Root",
"pattern": "^0x[0-9a-f]{64}$"
},
"parentHash": {
"type": "string",
"title": "Parent block hash",
"pattern": "^0x[0-9a-f]{64}$"
},
"receiptsRoot": {
"type": "string",
"title": "Receipts root",
"pattern": "^0x[0-9a-f]{64}$"
},
"requestsHash": {
"type": "string",
"title": "EIP-7685 requests hash",
"pattern": "^0x[0-9a-f]{64}$"
},
"sha3Uncles": {
"type": "string",
"title": "Ommers hash",
"pattern": "^0x[0-9a-f]{64}$"
},
"size": {
"type": "string",
"title": "Block size",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"stateRoot": {
"type": "string",
"title": "State root",
"pattern": "^0x[0-9a-f]{64}$"
},
"timestamp": {
"type": "string",
"title": "Timestamp",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"transactions": {
"anyOf": [
{
"type": "array",
"title": "Transaction hashes",
"items": {
"type": "string",
"title": "32 byte hex value",
"pattern": "^0x[0-9a-f]{64}$"
}
},
{
"type": "array",
"title": "Full transactions",
"items": {
"type": "object",
"title": "Transaction information",
"properties": {
"blockHash": {
"type": "string",
"title": "block hash",
"pattern": "^0x[0-9a-f]{64}$"
},
"blockNumber": {
"type": "string",
"title": "block number",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"blockTimestamp": {
"type": "string",
"title": "block timestamp",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"from": {
"type": "string",
"title": "from address",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"hash": {
"type": "string",
"title": "transaction hash",
"pattern": "^0x[0-9a-f]{64}$"
},
"transactionIndex": {
"type": "string",
"title": "transaction index",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
}
},
"required": [
"blockHash",
"blockNumber",
"blockTimestamp",
"from",
"hash",
"transactionIndex"
],
"oneOf": [
{
"type": "object",
"title": "Signed 7702 Transaction",
"properties": {
"accessList": {
"type": "array",
"title": "accessList",
"description": "EIP-2930 access lists",
"items": {
"type": "unknown"
}
},
"authorizationList": {
"type": "array",
"title": "authorizationList",
"description": "List of authorizations for the transaction",
"items": {
"type": "unknown"
}
},
"chainId": {
"type": "string",
"title": "chainId",
"description": "Chain ID that this transaction is valid on",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gas": {
"type": "string",
"title": "gas limit",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gasPrice": {
"type": "string",
"title": "gas price",
"description": "The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"input": {
"type": "string",
"title": "input data",
"pattern": "^0x[0-9a-f]*$"
},
"maxFeePerGas": {
"type": "string",
"title": "max fee per gas",
"description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"maxPriorityFeePerGas": {
"type": "string",
"title": "max priority fee per gas",
"description": "Maximum fee per gas the sender is willing to pay to miners in wei",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"nonce": {
"type": "string",
"title": "nonce",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"r": {
"type": "string",
"title": "r",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"s": {
"type": "string",
"title": "s",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"to": {
"type": "string",
"title": "to address",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"type": {
"type": "string",
"title": "type",
"pattern": "^0x4$"
},
"v": {
"type": "string",
"title": "v",
"description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.",
"pattern": "^0x[0-9a-f]{1,2}$"
},
"value": {
"type": "string",
"title": "value",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"yParity": {
"type": "string",
"title": "yParity",
"description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.",
"pattern": "^0x[0-9a-f]{1,2}$"
}
},
"required": [
"accessList",
"authorizationList",
"chainId",
"gas",
"input",
"maxFeePerGas",
"maxPriorityFeePerGas",
"nonce",
"r",
"s",
"to",
"type",
"value",
"yParity"
]
},
{
"type": "object",
"title": "Signed 4844 Transaction",
"properties": {
"accessList": {
"type": "array",
"title": "accessList",
"description": "EIP-2930 access list",
"items": {
"type": "unknown"
}
},
"blobVersionedHashes": {
"type": "array",
"title": "blobVersionedHashes",
"description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs",
"items": {
"type": "unknown"
}
},
"chainId": {
"type": "string",
"title": "chainId",
"description": "Chain ID that this transaction is valid on",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gas": {
"type": "string",
"title": "gas limit",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gasPrice": {
"type": "string",
"title": "gas price",
"description": "The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"input": {
"type": "string",
"title": "input data",
"pattern": "^0x[0-9a-f]*$"
},
"maxFeePerBlobGas": {
"type": "string",
"title": "max fee per blob gas",
"description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"maxFeePerGas": {
"type": "string",
"title": "max fee per gas",
"description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"maxPriorityFeePerGas": {
"type": "string",
"title": "max priority fee per gas",
"description": "Maximum fee per gas the sender is willing to pay to miners in wei",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"nonce": {
"type": "string",
"title": "nonce",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"r": {
"type": "string",
"title": "r",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"s": {
"type": "string",
"title": "s",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"to": {
"type": "string",
"title": "to address",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"type": {
"type": "string",
"title": "type",
"pattern": "^0x3$"
},
"v": {
"type": "string",
"title": "v",
"description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.",
"pattern": "^0x[0-9a-f]{1,2}$"
},
"value": {
"type": "string",
"title": "value",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"yParity": {
"type": "string",
"title": "yParity",
"description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.",
"pattern": "^0x[0-9a-f]{1,2}$"
}
},
"required": [
"accessList",
"blobVersionedHashes",
"chainId",
"gas",
"input",
"maxFeePerBlobGas",
"maxFeePerGas",
"maxPriorityFeePerGas",
"nonce",
"r",
"s",
"to",
"type",
"value",
"yParity"
]
},
{
"type": "object",
"title": "Signed 1559 Transaction",
"properties": {
"accessList": {
"type": "array",
"title": "accessList",
"description": "EIP-2930 access list",
"items": {
"type": "unknown"
}
},
"chainId": {
"type": "string",
"title": "chainId",
"description": "Chain ID that this transaction is valid on.",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gas": {
"type": "string",
"title": "gas limit",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gasPrice": {
"type": "string",
"title": "gas price",
"description": "The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"input": {
"type": "string",
"title": "input data",
"pattern": "^0x[0-9a-f]*$"
},
"maxFeePerGas": {
"type": "string",
"title": "max fee per gas",
"description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"maxPriorityFeePerGas": {
"type": "string",
"title": "max priority fee per gas",
"description": "Maximum fee per gas the sender is willing to pay to miners in wei",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"nonce": {
"type": "string",
"title": "nonce",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"r": {
"type": "string",
"title": "r",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"s": {
"type": "string",
"title": "s",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"to": {
"title": "to address",
"oneOf": [
{
"type": "unknown"
},
{
"type": "unknown"
}
]
},
"type": {
"type": "string",
"title": "type",
"pattern": "^0x2$"
},
"v": {
"type": "string",
"title": "v",
"description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.",
"pattern": "^0x[0-9a-f]{1,2}$"
},
"value": {
"type": "string",
"title": "value",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"yParity": {
"type": "string",
"title": "yParity",
"description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.",
"pattern": "^0x[0-9a-f]{1,2}$"
}
},
"required": [
"accessList",
"chainId",
"gas",
"gasPrice",
"input",
"maxFeePerGas",
"maxPriorityFeePerGas",
"nonce",
"r",
"s",
"type",
"value",
"yParity"
]
},
{
"type": "object",
"title": "Signed 2930 Transaction",
"properties": {
"accessList": {
"type": "array",
"title": "accessList",
"description": "EIP-2930 access list",
"items": {
"type": "unknown"
}
},
"chainId": {
"type": "string",
"title": "chainId",
"description": "Chain ID that this transaction is valid on.",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gas": {
"type": "string",
"title": "gas limit",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gasPrice": {
"type": "string",
"title": "gas price",
"description": "The gas price willing to be paid by the sender in wei",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"input": {
"type": "string",
"title": "input data",
"pattern": "^0x[0-9a-f]*$"
},
"nonce": {
"type": "string",
"title": "nonce",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"r": {
"type": "string",
"title": "r",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"s": {
"type": "string",
"title": "s",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"to": {
"title": "to address",
"oneOf": [
{
"type": "unknown"
},
{
"type": "unknown"
}
]
},
"type": {
"type": "string",
"title": "type",
"pattern": "^0x1$"
},
"v": {
"type": "string",
"title": "v",
"description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.",
"pattern": "^0x[0-9a-f]{1,2}$"
},
"value": {
"type": "string",
"title": "value",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"yParity": {
"type": "string",
"title": "yParity",
"description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.",
"pattern": "^0x[0-9a-f]{1,2}$"
}
},
"required": [
"accessList",
"chainId",
"gas",
"gasPrice",
"input",
"nonce",
"r",
"s",
"type",
"value",
"yParity"
]
},
{
"type": "object",
"title": "Signed Legacy Transaction",
"properties": {
"chainId": {
"type": "string",
"title": "chainId",
"description": "Chain ID that this transaction is valid on.",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gas": {
"type": "string",
"title": "gas limit",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"gasPrice": {
"type": "string",
"title": "gas price",
"description": "The gas price willing to be paid by the sender in wei",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"input": {
"type": "string",
"title": "input data",
"pattern": "^0x[0-9a-f]*$"
},
"nonce": {
"type": "string",
"title": "nonce",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"r": {
"type": "string",
"title": "r",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"s": {
"type": "string",
"title": "s",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"to": {
"title": "to address",
"oneOf": [
{
"type": "unknown"
},
{
"type": "unknown"
}
]
},
"type": {
"type": "string",
"title": "type",
"pattern": "^0x0$"
},
"v": {
"type": "string",
"title": "v",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
},
"value": {
"type": "string",
"title": "value",
"pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
}
},
"required": [
"gas",
"gasPrice",
"input",
"nonce",
"r",
"s",
"type",
"v",
"value"
]
}
]
}
}
]
},
"transactionsRoot": {
"type": "string",
"title": "Transactions root",
"pattern": "^0x[0-9a-f]{64}$"
},
"uncles": {
"type": "array",
"title": "Uncles",
"items": {
"type": "string",
"title": "32 byte hex value",
"pattern": "^0x[0-9a-f]{64}$"
}
},
"withdrawals": {
"type": "array",
"title": "Withdrawals",
"items": {
"type": "object",
"title": "Validator withdrawal",
"properties": {
"address": {
"type": "string",
"title": "recipient address for withdrawal value",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"amount": {
"type": "string",
"title": "value contained in withdrawal",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$"
},
"index": {
"type": "string",
"title": "index of withdrawal",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
},
"validatorIndex": {
"type": "string",
"title": "index of validator that generated withdrawal",
"pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$"
}
},
"required": [
"index",
"validatorIndex",
"address",
"amount"
]
}
},
"withdrawalsRoot": {
"type": "string",
"title": "Withdrawals root",
"pattern": "^0x[0-9a-f]{64}$"
}
},
"required": [
"hash",
"parentHash",
"sha3Uncles",
"miner",
"stateRoot",
"transactionsRoot",
"receiptsRoot",
"logsBloom",
"number",
"gasLimit",
"gasUsed",
"timestamp",
"extraData",
"mixHash",
"nonce",
"size",
"transactions",
"uncles"
]
}
]
}Example request
Endpoint: https://your-celo-node.azxa.io
JSON-RPC
{
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getBlockByHash",
"params": [
"0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c",
false
]
}Example response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"baseFeePerGas": "0x7",
"blobGasUsed": "0x0",
"difficulty": "0x66e619a",
"excessBlobGas": "0x0",
"extraData": "0xd583010502846765746885676f312e37856c696e7578",
"gasLimit": "0x47e7c4",
"gasUsed": "0x37993",
"hash": "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c",
"logsBloom": "0x000000000000001000000040800000000005000000000000000200001000000008000010000000…00040000900010000000",
"miner": "0xb42b6c4a95406c78ff892d270ad20b22642e102d",
"mixHash": "0x24900fb3da77674a861c428429dce0762707ecb6052325bbd9b3c64e74b5af9d",
"nonce": "0x378da40ff335b070",
"number": "0x68b3",
"parentBeaconBlockRoot": "0x95c4dbd5b19f6fe3cbc3183be85ff4e85ebe75c5b4fc911f1c91e5b7a554a685",
"parentHash": "0x1f68ac259155e2f38211ddad0f0a15394d55417b185a93923e2abe71bb7a4d6d",
"receiptsRoot": "0x68461ab700003503a305083630a8fb8d14927238f0bc8b6b3d246c0c64f21f4a",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x334",
"stateRoot": "0x91309efa7e42c1f137f31fe9edbe88ae087e6620d0d59031324da3e2f4f93233",
"timestamp": "0x5835c54d",
"transactions": [
"0xa0807e117a8dd124ab949f460f08c36c72b710188f01609595223b325e58e0fc",
"0xeae6d797af50cb62a596ec3939114d63967c374fa57de9bc0f4e2b576ed6639d"
],
"transactionsRoot": "0x4d0c8e91e16bdff538c03211c5c73632ed054d00a7e210c0eb25146c20048126",
"uncles": [],
"withdrawals": [
{
"address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
"amount": "0x11a33e3760",
"index": "0x0",
"validatorIndex": "0x9d8c0"
}
],
"…": "1 more fields"
}
}Test fixture
Fixture: get-block-by-empty-hash
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getBlockByHash",
"params": [
"0x0000000000000000000000000000000000000000000000000000000000000000",
true
]
}Response
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}cURL
curl -X POST https://your-celo-node.azxa.io \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_getBlockByHash","params":["0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c",false]}'
Telegram
Instagram
LinkedIn
TikTok
'%20/%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M205.843%20538L267.624%20271.015L270.176%20259.985L258.861%20259.985L-0.000128295%20259.985L-0.000129868%20277.984L247.545%20277.984L187.399%20538L205.843%20538Z'%20fill='url(%23paint1_linear_835_1234)'%20/%3e%3cdefs%3e%3clinearGradient%20id='paint0_linear_835_1234'%20x1='376.119'%20y1='2.17877e-06'%20x2='312.095'%20y2='277.971'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20stop-color='%23FF3131'%20stop-opacity='0'%20/%3e%3cstop%20offset='1'%20stop-color='%23FF3131'%20/%3e%3c/linearGradient%3e%3clinearGradient%20id='paint1_linear_835_1234'%20x1='205.889'%20y1='538'%20x2='269.914'%20y2='260.029'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20stop-color='%23FF3131'%20stop-opacity='0'%20/%3e%3cstop%20offset='1'%20stop-color='%23FF3131'%20/%3e%3c/linearGradient%3e%3c/defs%3e%3c/svg%3e)
