eth_getTransactionByBlockNumberAndIndex

Returns information about a transaction by block number and transaction index position.

Parameters (by position)

Block string or string required

---

Show Option 1 Block number string

Block number fields

Block string required

Block number

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

---

Show Option 2 Block tag string

Block tag fields

earliest: The lowest numbered block the client has available; finalized: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; safe: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for finalized or safe block MUST be responded to with -39001: Unknown block error

Block string required

earliest: The lowest numbered block the client has available; finalized: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; safe: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for finalized or safe block MUST be responded to with -39001: Unknown block error

Allowed values: earliest finalized safe latest pending

---

Transaction index string required

---

Result

Transaction information null or object

---

Show Option 1 Not Found (null) null

Not Found (null) fields

Transaction information null

Not Found (null)

---

Show Option 2 Transaction information object

Transaction information fields

Transaction information object or object or object or object or object

---

Show Option 1 Signed 7702 Transaction object

Signed 7702 Transaction fields

Transaction information object

Signed 7702 Transaction

---

Show Transaction information object

Transaction information 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

Transaction information object

Signed 4844 Transaction

---

Show Transaction information object

Transaction information 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

Transaction information object

Signed 1559 Transaction

---

Show Transaction information object

Transaction information 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

Transaction information object

Signed 2930 Transaction

---

Show Transaction information object

Transaction information 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

Transaction information object

Signed Legacy Transaction

---

Show Transaction information object

Transaction information 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

  ---

Errors

Error code: 4444

• code

  4444

• message

  Pruned history unavailable

Examples

eth_getTransactionByBlockNumberAndIndex example

Request

{
  "params": [
    "0x1442e",
    "0x2"
  ]
}

Response

{
  "blockHash": "0x510efccf44a192e6e34bcb439a1947e24b86244280762cbb006858c237093fda",
  "blockNumber": "0x422",
  "chainId": "0x7e2",
  "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73",
  "gas": "0x5208",
  "gasPrice": "0x3b9aca00",
  "hash": "0xa52be92809541220ee0aaaede6047d9a6c5d0cd96a517c854d944ee70a0ebb44",
  "input": "0x",
  "nonce": "0x1",
  "to": "0x627306090abab3a6e1400e9345bc60c78a8bef57",
  "transactionIndex": "0x0",
  "value": "0x4e1003b28d9280000",
  "v": "0xfe7",
  "r": "0x84caf09aefbd5e539295acc67217563438a4efb224879b6855f56857fa2037d3",
  "s": "0x5e863be3829812c81439f0ae9d8ecb832b531d651fb234c848d1bf45e62be8b9"
}

Request

Server URL:

{ "jsonrpc": "2.0", "method": "eth_getTransactionByBlockNumberAndIndex", "params": [ "0x1442e", "0x2" ], "id": 1 }