eth_getBlockByHash

Returns information about a block by hash.

Parameters (by position)

Block hash string required

---

Hydrated transactions boolean required

---

Result

Block information null or object

---

Show Option 1 Not Found (null) null

Not Found (null) fields

Block information null

Not Found (null)

---

Show Option 2 Block object object

Block object fields

Block information object

Block object

---

Show Block information object

Block information fields

• hash string required

  Hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• parentHash string required

  Parent block hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• sha3Uncles string required

  Ommers hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• miner string required

  Coinbase

  Match pattern: ^0x[0-9a-fA-F]{40}$

  ---

• stateRoot string required

  State root

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• transactionsRoot string required

  Transactions root

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• receiptsRoot string required

  Receipts root

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• logsBloom string required

  Bloom filter

  Match pattern: ^0x[0-9a-f]{512}$

  ---

• difficulty string

  Difficulty

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• number string required

  Number

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• gasLimit string required

  Gas limit

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• gasUsed string required

  Gas used

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• timestamp string required

  Timestamp

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• extraData string required

  Extra data

  Match pattern: ^0x[0-9a-f]*$

  ---

• mixHash string required

  Mix hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• nonce string required

  Nonce

  Match pattern: ^0x[0-9a-f]{16}$

  ---

• baseFeePerGas string

  Base fee per gas

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• withdrawalsRoot string

  Withdrawals root

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• blobGasUsed string

  Blob gas used

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• excessBlobGas string

  Excess blob gas

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• parentBeaconBlockRoot string

  Parent Beacon Block Root

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• size string required

  Block size

  Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  ---

• transactions array<string> or array<object> required

  ---

  Show Option 1 Transaction hashes array

  Transaction hashes fields

  transactions array<string> required

  32 byte hex value

  Match pattern: ^0x[0-9a-f]{64}$

  ---

  Show Option 2 Full transactions array

  Full transactions fields

  transactions object or object or object or object or object required

  ---

  Show Option 1 Signed 7702 Transaction object

  Signed 7702 Transaction fields

  transactions array<object> required

  Signed 7702 Transaction

  ---

  Show transactions object

  transactions fields

  • type string required

    type

    Match pattern: ^0x4$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to string required

    to address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • maxPriorityFeePerGas string required

    Maximum fee per gas the sender is willing to pay to miners in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxFeePerGas string required

    The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gasPrice string

    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.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • accessList array<object> required

    EIP-2930 access lists

    ---

    Show accessList object

    accessList fields

    EIP-2930 access lists

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • storageKeys array<string> required

      32 byte hex value

      Match pattern: ^0x[0-9a-f]{64}$

      ---

    • additionalProperties false

      ---

  • chainId string required

    Chain ID that this transaction is valid on

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • authorizationList array<object> required

    List of authorizations for the transaction

    ---

    Show authorizationList object

    authorizationList fields

    List of authorizations for the transaction

    • chainId string required

      Chain ID on which this transaction is valid

      Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

      ---

    • nonce string required

      nonce

      Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

      ---

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • yParity string required

      The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature

      Match pattern: ^0x([0-9a-fA-F]?){1,2}$

      ---

    • r string required

      r

      Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$

      ---

    • s string required

      s

      Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$

      ---

    • additionalProperties true

      ---

  • yParity string required

    The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.

    Match pattern: ^0x([0-9a-fA-F]?){1,2}$

    ---

  • v string

    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.

    Match pattern: ^0x([0-9a-fA-F]?){1,2}$

    ---

  • r string required

    r

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • s string required

    s

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

  Show Option 2 Signed 4844 Transaction object

  Signed 4844 Transaction fields

  transactions array<object> required

  Signed 4844 Transaction

  ---

  Show transactions object

  transactions fields

  • type string required

    type

    Match pattern: ^0x3$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to string required

    to address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • maxPriorityFeePerGas string required

    Maximum fee per gas the sender is willing to pay to miners in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxFeePerGas string required

    The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxFeePerBlobGas string required

    The maximum total fee per gas the sender is willing to pay for blob gas in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gasPrice string

    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.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • accessList array<object> required

    EIP-2930 access list

    ---

    Show accessList object

    accessList fields

    EIP-2930 access list

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • storageKeys array<string> required

      32 byte hex value

      Match pattern: ^0x[0-9a-f]{64}$

      ---

    • additionalProperties false

      ---

  • blobVersionedHashes array<string> required

    List of versioned blob hashes associated with the transaction's EIP-4844 data blobs

    Match pattern: ^0x[0-9a-f]{64}$

    ---

  • chainId string required

    Chain ID that this transaction is valid on

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • yParity string required

    The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.

    Match pattern: ^0x([0-9a-fA-F]?){1,2}$

    ---

  • v string

    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.

    Match pattern: ^0x([0-9a-fA-F]?){1,2}$

    ---

  • r string required

    r

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • s string required

    s

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

  Show Option 3 Signed 1559 Transaction object

  Signed 1559 Transaction fields

  transactions array<object> required

  Signed 1559 Transaction

  ---

  Show transactions object

  transactions fields

  • type string required

    type

    Match pattern: ^0x2$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to null or string

    ---

    Show Option 1 Contract Creation (null) null

    Contract Creation (null) fields

    to null

    Contract Creation (null)

    ---

    Show Option 2 Address string

    Address fields

    to string

    Address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • maxPriorityFeePerGas string required

    Maximum fee per gas the sender is willing to pay to miners in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • maxFeePerGas string required

    The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • gasPrice string required

    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.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • accessList array<object> required

    EIP-2930 access list

    ---

    Show accessList object

    accessList fields

    EIP-2930 access list

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • storageKeys array<string> required

      32 byte hex value

      Match pattern: ^0x[0-9a-f]{64}$

      ---

    • additionalProperties false

      ---

  • chainId string required

    Chain ID that this transaction is valid on.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • yParity string required

    The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.

    Match pattern: ^0x([0-9a-fA-F]?){1,2}$

    ---

  • v string

    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.

    Match pattern: ^0x([0-9a-fA-F]?){1,2}$

    ---

  • r string required

    r

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • s string required

    s

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

  Show Option 4 Signed 2930 Transaction object

  Signed 2930 Transaction fields

  transactions array<object> required

  Signed 2930 Transaction

  ---

  Show transactions object

  transactions fields

  • type string required

    type

    Match pattern: ^0x1$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to null or string

    ---

    Show Option 1 Contract Creation (null) null

    Contract Creation (null) fields

    to null

    Contract Creation (null)

    ---

    Show Option 2 Address string

    Address fields

    to string

    Address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • gasPrice string required

    The gas price willing to be paid by the sender in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • accessList array<object> required

    EIP-2930 access list

    ---

    Show accessList object

    accessList fields

    EIP-2930 access list

    • address string required

      hex encoded address

      Match pattern: ^0x[0-9a-fA-F]{40}$

      ---

    • storageKeys array<string> required

      32 byte hex value

      Match pattern: ^0x[0-9a-f]{64}$

      ---

    • additionalProperties false

      ---

  • chainId string required

    Chain ID that this transaction is valid on.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • yParity string required

    The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.

    Match pattern: ^0x([0-9a-fA-F]?){1,2}$

    ---

  • v string

    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.

    Match pattern: ^0x([0-9a-fA-F]?){1,2}$

    ---

  • r string required

    r

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • s string required

    s

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

  Show Option 5 Signed Legacy Transaction object

  Signed Legacy Transaction fields

  transactions array<object> required

  Signed Legacy Transaction

  ---

  Show transactions object

  transactions fields

  • type string required

    type

    Match pattern: ^0x0$

    ---

  • nonce string required

    nonce

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • to null or string

    ---

    Show Option 1 Contract Creation (null) null

    Contract Creation (null) fields

    to null

    Contract Creation (null)

    ---

    Show Option 2 Address string

    Address fields

    to string

    Address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • gas string required

    gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • value string required

    value

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • input string required

    input data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • gasPrice string required

    The gas price willing to be paid by the sender in wei

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • chainId string

    Chain ID that this transaction is valid on.

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • v string required

    v

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • r string required

    r

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • s string required

    s

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

    ---

  • additionalProperties true

    ---

• withdrawals array<object>

  Validator withdrawal

  ---

  Show withdrawals object

  withdrawals fields

  • index string required

    index of withdrawal

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

    ---

  • validatorIndex string required

    index of validator that generated withdrawal

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

    ---

  • address string required

    recipient address for withdrawal value

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • amount string required

    value contained in withdrawal

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$

    ---

  • additionalProperties false

    ---

• uncles array<string> required

  32 byte hex value

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• requestsHash string

  EIP-7685 requests hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• additionalProperties true

  ---

Errors

Error code: 4444

• code

  4444

• message

  Pruned history unavailable

Examples

eth_getBlockByHash example

Request

{
  "params": [
    "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c",
    false
  ]
}

Response

{
  "number": "0x68b3",
  "hash": "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c",
  "mixHash": "0x24900fb3da77674a861c428429dce0762707ecb6052325bbd9b3c64e74b5af9d",
  "parentHash": "0x1f68ac259155e2f38211ddad0f0a15394d55417b185a93923e2abe71bb7a4d6d",
  "nonce": "0x378da40ff335b070",
  "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
  "logsBloom": "0x00000000000000100000004080000000000500000000000000020000100000000800001000000004000001000000000000000800040010000020100000000400000010000000000000000040000000000000040000000000000000000000000000000400002400000000000000000000000000000004000004000000000000840000000800000080010004000000001000000800000000000000000000000000000000000800000000000040000000020000000000000000000800000400000000000000000000000600000400000000002000000000000000000000004000000000000000100000000000000000000000000000000000040000900010000000",
  "transactionsRoot": "0x4d0c8e91e16bdff538c03211c5c73632ed054d00a7e210c0eb25146c20048126",
  "stateRoot": "0x91309efa7e42c1f137f31fe9edbe88ae087e6620d0d59031324da3e2f4f93233",
  "receiptsRoot": "0x68461ab700003503a305083630a8fb8d14927238f0bc8b6b3d246c0c64f21f4a",
  "miner": "0xb42b6c4a95406c78ff892d270ad20b22642e102d",
  "difficulty": "0x66e619a",
  "extraData": "0xd583010502846765746885676f312e37856c696e7578",
  "size": "0x334",
  "gasLimit": "0x47e7c4",
  "gasUsed": "0x37993",
  "timestamp": "0x5835c54d",
  "uncles": [],
  "transactions": [
    "0xa0807e117a8dd124ab949f460f08c36c72b710188f01609595223b325e58e0fc",
    "0xeae6d797af50cb62a596ec3939114d63967c374fa57de9bc0f4e2b576ed6639d"
  ],
  "baseFeePerGas": "0x7",
  "withdrawalsRoot": "0x7a4ecf19774d15cf9c15adf0dd8e8a250c128b26c9e2ab2a08d6c9c8ffbd104f",
  "withdrawals": [
    {
      "index": "0x0",
      "validatorIndex": "0x9d8c0",
      "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
      "amount": "0x11a33e3760"
    }
  ],
  "blobGasUsed": "0x0",
  "excessBlobGas": "0x0",
  "parentBeaconBlockRoot": "0x95c4dbd5b19f6fe3cbc3183be85ff4e85ebe75c5b4fc911f1c91e5b7a554a685"
}

Request

Server URL:

{ "jsonrpc": "2.0", "method": "eth_getBlockByHash", "params": [ "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c", false ], "id": 1 }