> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.
# eth_newFilter | Avalanche
Avalanche API method that generates a filter object based on the filter parameters. It returns a filter ID, which can be used to retrieve the results of the filter using the [eth\_getFilterChanges](/reference/avalanche-getfilterchanges) method. By creating a filter for specific events, developers can receive notifications when those events occur and use them to trigger actions in their applications.
**Get your own node endpoint today**
[Start for free](https://console.chainstack.com/) and get your app to production levels immediately. No credit card required.
You can sign up with your GitHub, X, Google, or Microsoft account.
## Parameters
* `object` — the filter parameters:
* `fromBlock` — (optional, default: `latest`) integer that specifies the starting block number from which the logs should be fetched.
* `toBlock` — (optional, default: `latest`) integer that specifies the ending block number until which the logs should be fetched.
* `address` — (optional) the contract address from which the logs should be fetched. It can be a single address or an array of addresses.
* `topics` — (optional) an array of `DATA` topics. The event topics for which the logs should be fetched. It can be a single topic or an array of topics.
* `blockhash` — (optional) the hash of the specific block. Limits logs to a specific block with a 32-byte hash value. It takes precedence over `fromBlock` and `toBlock`.
**Possible tags forfromBlockandtoBlock**
* `latest` — the most recent block in the blockchain and the current state of the blockchain at the most recent block
* `earliest` — the earliest available or genesis block
* `pending` — the pending state and transactions block. The current state of transactions that have been broadcast to the network but have not yet been included in a block.
See the [default block parameter](https://eth.wiki/json-rpc/API#the-default-block-parameter).
## Response
* `result` — a hexadecimal string representing the ID of the newly created filter
The filters created are stored on the blockchain client instance. The filter is automatically deleted if not polled within a certain time (5 minutes by default).
Use the following methods with the filter ID:
* [eth\_getFilterChanges](/reference/avalanche-getfilterchanges) to retrieve updated logs
* [eth\_uninstallFilter](/reference/avalanche-uninstallfilter) to remove the filter
## `eth_newFilter` code examples
Note that the `web3.eth.filter` methods have been deprecated and replaced with the `web3.eth.subscribe` in web3.js. See [web3.js subscriptions](/reference/avalanche-web3js-subscriptions-methods).
```javascript ethers.js theme={"system"}
const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);
const filter = {
toBlock: 'latest',
address: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270',
topics: ['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef']
};
const createFilter = async () => {
try {
const filterId = await provider.send('eth_newFilter', [filter]);
console.log(filterId); // the filter ID returned by eth_newFilter
return filterId
} catch (error) {
console.log(error);
}
};
createFilter();
```
```python web3.py theme={"system"}
from web3 import Web3
node_url = "CHAINSTACK_NODE_URL"
web3 = Web3(Web3.HTTPProvider(node_url))
filter = {
'toBlock': 'latest',
'address': '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270',
'topics': ['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef']
}
def create_logs_filter(filter_object):
try:
logs_filter = web3.eth.filter(filter_object)
return logs_filter
except Exception as e:
print(e)
logs_filter = create_logs_filter(filter)
filter_id = logs_filter.filter_id
print(f'New filter ID: {filter_id}')
```
## Use case
You can use `eth_newFilter` to create a filter for a specific action on a smart contract, for example, to monitor the transfer transactions from the [Wrapped ETH token](https://snowtrace.io/token/0x49d5c2bdffac6ce2bfdb6640f4f80f226bc10bab).
The idea is to create a filter using the `eth_newFilter` method to monitor an ERC-20 smart contract, WETH in this case.
The following filter parameters are selected:
```javascript filter_params theme={"system"}
const filter = {
// Poll the latest block available
toBlock: 'latest',
// WETH smart contract address
address: '0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB',
// Signature of the Transfer event.
topics: ['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'],
};
```
The program is then polling the filter every 2 seconds to check for any new changes using the `eth_getFilterChanges` method.
Here is the implementation using ethers.js:
```javascript index.js theme={"system"}
const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);
const filter = {
toBlock: 'latest',
address: '0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB',
topics: ['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'],
};
const createAndPollFilter = async () => {
try {
const filterId = await provider.send('eth_newFilter', [filter]);
console.log(`The filter ID is: ${filterId}`); // the filter ID returned by eth_newFilter
// Poll the filter every 30 seconds
setInterval(async () => {
const filterChanges = await provider.send('eth_getFilterChanges', [filterId]);
if (filterChanges.length === 0) {
console.log('No new logs since the last poll.');
} else {
console.log(filterChanges); // the filter changes returned by eth_getFilterChanges
}
}, 2000); // 2 seconds in milliseconds
return filterId;
} catch (error) {
console.log(error);
}
};
createAndPollFilter();
```
Here's a breakdown of how the code works:
The `createAndPollFilter` function is an asynchronous function that creates and polls a filter for the WETH smart contract on Avalanche.
The `eth_newFilter` method creates a new filter with the specified parameters. In this case, it passes in the filter object as the filter parameter. The method returns the ID of the newly created filter, which is then logged into the console.
The `setInterval` method is used to poll the filter every 2 seconds. It takes a function as the first argument and an interval in milliseconds as the second argument. The function passed to `setInterval` is an asynchronous function that calls `eth_getFilterChanges` with the filter ID returned by `eth_newFilter`. This method returns an array of all the changes to the filter since the last time it was polled. If there are no changes, it logs "No new logs since the last poll." to the console. If there are changes, it logs the filter changes to the console.
The `createAndPollFilter` function returns the filter ID, and if there are any errors thrown while creating or polling the filter, the catch block logs the error to the console.
## OpenAPI
````yaml /openapi/avalanche_node_api/logs_and_events/eth_newFilter.json POST /8763cb5a211e1d4345acd51bde484c00/ext/bc/C/rpc
openapi: 3.0.0
info:
title: Chainstack Node API
version: 1.0.0
description: This is an API for interacting with a Chainstack node.
servers:
- url: https://nd-418-459-126.p2pify.com
security: []
paths:
/8763cb5a211e1d4345acd51bde484c00/ext/bc/C/rpc:
post:
tags:
- logs
summary: eth_newFilter
operationId: newFilter
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
method:
type: string
default: eth_newFilter
params:
type: array
items:
type: object
properties:
fromBlock:
type: string
title: from block
description: >-
The block number or tag to start searching for logs
from.
default: latest
address:
type: string
title: smart contract address
description: The contract address to retrieve the logs for.
topics:
type: array
title: topics
items:
type: string
description: >-
An array of 32-byte topics to filter for. Each topic
is treated as an OR condition.
default:
- fromBlock: latest
address: '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7'
topics:
- >-
0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
id:
type: integer
default: 1
jsonrpc:
type: string
default: '2.0'
responses:
'200':
description: The filter ID.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
id:
type: integer
result:
type: string
````