EVM

eth_getLogs

Summary: Get logs

This request passes a set of search conditions and returns an array of all logs matching those.

Parameters

filter object

fromBlock oneOf

Block number or string tag.

Block number string

Block number in hexadecimal.

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

Block tag enum

See the default block parameter.

• 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.
• 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.

Enum:

"earliest"

"finalized"

"latest"

"pending"

toBlock oneOf

Block number or string tag.

Block number string

Block number in hexadecimal.

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

Block tag enum

See the default block parameter.

• 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.
• 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.

Enum:

"earliest"

"finalized"

"latest"

"pending"

address oneOf

Any address null

Any address

Address string

Hex-encoded address.

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

Addresses array

Hex-encoded address.

string

Hex-encoded address.

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

topics oneOf

Filter topics.

Any topic match null

Any topic match

Specified filter topics array

Specified filter topics

oneOf

Filter topic list entry.

Single topic match string

32 Hex-encoded bytes.

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

Multiple topic match array

Multiple topic match

string

32 Hex-encoded bytes.

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

Returns

Array of log objects.

eth_getLogsResponse oneOf

New block or transaction hashes array

New block or transaction hashes

string

32 byte hex value.

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

New logs array

New logs

object

required

removed boolean

logIndex string

Hex-encoded unsigned integer.

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

transactionIndex string

A hexadecimal of the integer representing the position in the block.

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

transactionHash string

The transaction hash in which the call was made.

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

blockHash string

Block hash; 32 byte hex identifier for the block derived from the block header.

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

blockNumber string

Block number as hex-encoded unsigned integer.

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

address string

Hex-encoded address.

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

data string

Hex-encoded bytes.

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

topics array

string

32 Hex-encoded bytes.

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

Customize request

Parameter

Value

fromBlock

0x4fde9d

oneOf

• Block number
• Block tag

toBlock

0x4fde9d

oneOf

• Block number
• Block tag

address

0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f

oneOf

• Any address
• Address
• Addresses

topics

oneOf

• Any topic match
• Specified filter topics

Request

CURL

curl https://linea-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [{"fromBlock":"0x4fde9d","toBlock":"0x4fde9d","address":"0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f","topics":[]}],
    "id": 1
  }'

Example response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "address": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f",
      "blockHash": "0xd459570b5d2994a81ec1875b058f665b7f9c006172a8bd2860de87aee9569ac8",
      "blockNumber": "0x4fde9d",
      "data": "0x0000000000000000000000000000000000000000000000000b6139a7cbd20000",
      "logIndex": "0x0",
      "removed": false,
      "topics": [
        "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c",
        "0x00000000000000000000000000381fd3e1ca2a3758bb86983836c645ca0c1f4a"
      ],
      "transactionHash": "0x962e545e8ac3caef02f251d175cb0519c14db387559bb5804e988e175b3bc6c4",
      "transactionIndex": "0x1"
    },
    {
      "address": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f",
      "blockHash": "0xd459570b5d2994a81ec1875b058f665b7f9c006172a8bd2860de87aee9569ac8",
      "blockNumber": "0x4fde9d",
      "data": "0x000000000000000000000000000000000000000000000000001057acf5f78000",
      "logIndex": "0x18",
      "removed": false,
      "topics": [
        "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c",
        "0x000000000000000000000000fe6508f0015c778bdcc1fb5465ba5ebe224c9912"
      ],
      "transactionHash": "0x1edcdbf205d33cb1f7f88eb58324f20aa32ad7af494ead208d7bc90762c304ea",
      "transactionIndex": "0xa"
    },
    {
      "address": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f",
      "blockHash": "0xd459570b5d2994a81ec1875b058f665b7f9c006172a8bd2860de87aee9569ac8",
      "blockNumber": "0x4fde9d",
      "data": "0x000000000000000000000000000000000000000000000000001057acf5f78000",
      "logIndex": "0x1a",
      "removed": false,
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000fe6508f0015c778bdcc1fb5465ba5ebe224c9912",
        "0x000000000000000000000000586733678b9ac9da43dd7cb83bbb41d23677dfc3"
      ],
      "transactionHash": "0x1edcdbf205d33cb1f7f88eb58324f20aa32ad7af494ead208d7bc90762c304ea",
      "transactionIndex": "0xa"
    },
    {
      "address": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f",
      "blockHash": "0xd459570b5d2994a81ec1875b058f665b7f9c006172a8bd2860de87aee9569ac8",
      "blockNumber": "0x4fde9d",
      "data": "0x00000000000000000000000000000000000000000000000000138a64211903b7",
      "logIndex": "0x2a",
      "removed": false,
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000e24b4a292ba102a9b7b7f9de20718d7ba45ddb29",
        "0x000000000000000000000000d804ba88371a3f00ddaca03cbc2b6c47f38105fc"
      ],
      "transactionHash": "0x3613dbdec4df03cd1efc903773ffad8703c8a6f902384299dc22e32bf3223fab",
      "transactionIndex": "0x10"
    }
  ]
}