eth_newFilter - Celo

Example code for the eth_newFilter JSON-RPC method. Complete guide on how to use eth_newFilter JSON-RPC in GetBlock Web3 documentation.

This method creates a filter object for logs on the Celo network, which can be polled with eth_getFilterChanges. This is useful for tracking specific events like cUSD transfers or DeFi protocol activity.

Parameters

Parameter	Type	Required	Description
filterObject	object	Yes	Filter options

Filter Object

Field	Type	Required	Description
fromBlock	string	No	Starting block
toBlock	string	No	Ending block
address	string/array	No	Contract address(es)
topics	array	No	Event topics

Request Example

cURL

curl

curl -X POST https://go.getblock.io/<ACCESS-TOKEN>/ \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": "getblock.io",
  "method": "eth_newFilter",
  "params": [{
    "fromBlock": "latest",
    "address": "0x765DE816845861e75A25fCA122bb6898B8B1282a",
    "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
  }]
}'

JavaScript (Axios)

Python

Response Example

response.json

{
  "jsonrpc": "2.0",
  "id": "getblock.io",
  "result": "0x1"
}

Response Definition

Field	Type	Description
result	string	Filter ID

Use Cases

• Track stablecoin transfers (cUSD, cEUR)

• Monitor DeFi events

• Build event notification systems

• Index contract events

Error Handling

Error Code	Description
-32602	Invalid params
-32603	Internal error

SDK Integration

Ethers.js

ethers-example.js

const { ethers } = require('ethers');

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

const filter = {
  address: '0x765DE816845861e75A25fCA122bb6898B8B1282a',
  topics: ['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef']
};

provider.on(filter, (log) => {
  console.log('Transfer event:', log);
});