Docs
Supported ChainsXDC NetworkJSON-RPC APISmart Contract Methods

eth_newFilter - XDC Network RPC Method

Create event log filter on XDC Network. Essential for monitoring events for tokenized trade finance (Letters of Credit, Bills of Lading), cross-border payments, and real-world asset tokenization.

Creates a filter object on XDC Network to notify when state changes (logs).

Use Cases

  • Event monitoring - Subscribe to contract events
  • Real-time updates - Track events for tokenized trade finance (Letters of Credit, Bills of Lading), cross-border payments, and real-world asset tokenization
  • Indexing - Build event indexes incrementally

Request Parameters

Request
fromBlockQUANTITY|TAG

Starting block

toBlockQUANTITY|TAG

Ending block

addressDATA|Array

Contract address(es)

topicsArray

Topic filters

Response Body

Response
resultQUANTITY

Filter ID

Code Examples

Bash
curl -X POST https://api-xdc-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_newFilter",
    "params": [{
      "fromBlock": "latest",
      "address": "0x951857744785E80e2De051c32EE7b25f9c458C42"
    }],
    "id": 1
  }'
JavaScript
import { JsonRpcProvider } from 'ethers';

const provider = new JsonRpcProvider('https://api-xdc-mainnet.n.dwellir.com/YOUR_API_KEY');

// Create filter
const filterId = await provider.send('eth_newFilter', [{
  fromBlock: 'latest',
  address: '0x951857744785E80e2De051c32EE7b25f9c458C42',
  topics: ['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef']
}]);

// Poll for changes
const changes = await provider.send('eth_getFilterChanges', [filterId]);
console.log('New events:', changes);

// Cleanup
await provider.send('eth_uninstallFilter', [filterId]);

On this page