eth_newFilter

Creates a filter object based on filter options to notify when the state changes on Optimism Layer 2.

Parameters

1. Filter Options
   • fromBlock - Starting block (optional)
   • toBlock - Ending block (optional)
   • address - Contract address or array of addresses (optional)
   • topics - Array of topics (optional)

Implementation Examples

cURL

curl -X POST https://api-optimism-mainnet-archive.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_newFilter",
    "params": [{
      "fromBlock": "0x1",
      "toBlock": "latest",
      "address": "0x4200000000000000000000000000000000000006",
      "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
    }],
    "id": 1
  }'

JavaScript

// Create filter for WETH Transfer events on Optimism
const response = await fetch('https://api-optimism-mainnet-archive.n.dwellir.com/YOUR_API_KEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'eth_newFilter',
    params: [{
      fromBlock: "0x1",
      toBlock: "latest",
      address: "0x4200000000000000000000000000000000000006", // WETH on Optimism
      topics: ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"] // Transfer topic
    }],
    id: 1
  })
});

const data = await response.json();
const filterId = data.result;
console.log('Filter ID:', filterId);

Response Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1"
}

Returns a filter ID that can be used with eth_getFilterChanges and eth_getFilterLogs.

---

Need help? Contact our support team or check the Optimism documentation.