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

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

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": [],
    "id": 1
  }'

Constraints

The following constraints apply:

To prevent queries from consuming too many resources, eth_getLogs requests are currently limited by three constraints:

• A maximum of 5,000 parameters can be included in a single request.
• A maximum of 10,000 results can be returned by a single query.
• Query duration must not exceed 10 seconds.

If a query returns too many results or exceeds the max query duration, one of the following errors is returned:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32005,
    "message": "query returned more than 10000 results"
  }
}

or

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32005,
    "message": "query timeout exceeded"
  }
}

If this happens:

• Limit your query to a smaller number of blocks using fromBlock and toBlock.
• If querying for commonly used topics, consider limiting to a single smart contract address.