eth_getLogs - HyperEVM

Example code for the eth_getLogs JSON RPC method. Сomplete guide on how to use eth_getLogsGetBlock JSON RPC in GetBlock Web3 documentation.

This method returns an array of all logs matching a given filter object.

Parameters

Parameter	Type	Required	Description
filterObject	object	Yes	Filter options object.

Filter Object

Field	Type	Required	Description
fromBlock	string	No	Start block (hex) or "latest".
toBlock	string	No	End block (hex) or "latest".
address	string/array	No	Contract address or array of addresses.
topics	array	No	Array of topic filters (max 4 topics).
blockHash	string	No	Specific block hash (alternative to fromBlock/toBlock).

Request

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [{
        "fromBlock": "0x1",
        "toBlock": "0x32",
        "address": "0xContractAddress",
        "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
    }],
    "id": "getblock.io"
}'

Axios

Request

Rust

Response

response.json

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": [
        {
            "address": "0xContractAddress",
            "topics": [
                "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                "0x000000000000000000000000sender",
                "0x000000000000000000000000recipient"
            ],
            "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
            "blockNumber": "0x1b4",
            "transactionHash": "0x...",
            "transactionIndex": "0x0",
            "blockHash": "0x...",
            "logIndex": "0x0",
            "removed": false
        }
    ]
}

Response Parameters

Field	Type	Description
address	string	Contract address that emitted the log.
topics	array	Indexed event parameters.
data	string	Non-indexed event data (hex).
blockNumber	string	Block number (hex).
transactionHash	string	Transaction hash.
logIndex	string	Log index in block (hex).
removed	boolean	True if log was removed due to reorg.

Use Case

The eth_getLogs method is essential for:

• Event monitoring and indexing

• Token transfer tracking (ERC-20 Transfer events)

• DeFi protocol event processing

• Historical event analysis

• Building event-driven applications

Error Handling

Error Code	Message	Cause
-32602	Invalid params	Invalid filter object.
-32603	Internal error	Query range too large.

Web3 Integration

Ether.js

import ethers from 'ethers';

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

async function getLogs() {
    const logs = await provider.getLogs({
        fromBlock: 0x1,
        toBlock: 'latest',
        address: '0xContractAddress',
        topics: ['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef']
    });
    console.log('Logs:', logs.length);
}

getLogs();

Viem