eth_uninstallFilter | Chiliz RPC Docs

Remove a filter on Chiliz created by eth_newFilter, eth_newBlockFilter, or eth_newPendingTransactionFilter. Essential for resource cleanup after event monitoring.

Removes a filter on Chiliz that was previously created with eth_newFilter, eth_newBlockFilter, or eth_newPendingTransactionFilter. Should always be called when a filter is no longer needed to free server-side resources.

Why Chiliz? Build on the sports-first blockchain powering 2M+ fan token wallets and dozens of licensed sports partnerships with licensed partnerships with major football clubs, MiCA-compliant in EU, OG Esports integration, and SportFi DeFi infrastructure.

When to Use This Method

eth_uninstallFilter is important for sports organizations, entertainment brands, and fan engagement platform developers:

Resource Cleanup — Remove filters you no longer need to free memory and processing on the node
Post-Monitoring Teardown — Clean up after event monitoring sessions end or when switching to different filter criteria
Preventing Stale Filters — Proactively remove filters before they auto-expire to maintain clean state
Connection Management — Uninstall filters before disconnecting to avoid orphaned server-side resources

class ManagedFilter {
  constructor(provider) {
    this.provider = provider;
    this.filterId = null;
    this.polling = false;
  }

  async createLogFilter(filterOptions) {
    this.filterId = await this.provider.send('eth_newFilter', [filterOptions]);
    console.log('Filter created:', this.filterId);
    return this.filterId;
  }

  async createBlockFilter() {
    this.filterId = await this.provider.send('eth_newBlockFilter', []);
    return this.filterId;
  }

  async poll() {
    if (!this.filterId) throw new Error('No active filter');
    return await this.provider.send('eth_getFilterChanges', [this.filterId]);
  }

  async destroy() {
    if (this.filterId) {
      const removed = await this.provider.send('eth_uninstallFilter', [this.filterId]);
      console.log(`Filter ${this.filterId} removed: ${removed}`);
      this.filterId = null;
      return removed;
    }
    return false;
  }
}

// Usage
const filter = new ManagedFilter(provider);
await filter.createBlockFilter();

try {
  const changes = await filter.poll();
  console.log('New blocks:', changes);
} finally {
  await filter.destroy();
}

2. Event Monitor with Cleanup

Monitor events for a limited duration, then clean up all filters:

JavaScript

async function monitorEvents(provider, contractAddress, topics, duration = 60000) {
  const filterId = await provider.send('eth_newFilter', [{
    address: contractAddress,
    topics
  }]);

  const allEvents = [];
  const interval = setInterval(async () => {
    const changes = await provider.send('eth_getFilterChanges', [filterId]);
    if (changes.length > 0) {
      allEvents.push(...changes);
      console.log(`Received ${changes.length} new events`);
    }
  }, 2000);

  // Stop monitoring after the specified duration
  await new Promise(r => setTimeout(r, duration));
  clearInterval(interval);

  // Always clean up the filter
  const removed = await provider.send('eth_uninstallFilter', [filterId]);
  console.log(`Monitoring complete. Filter removed: ${removed}. Total events: ${allEvents.length}`);

  return allEvents;
}

3. Bulk Filter Cleanup

Remove all tracked filters during application shutdown:

Python

import requests

class FilterRegistry:
    def __init__(self, rpc_url):
        self.rpc_url = rpc_url
        self.active_filters = []

    def create_filter(self, filter_type='block'):
        method = {
            'block': 'eth_newBlockFilter',
            'pending': 'eth_newPendingTransactionFilter',
        }.get(filter_type, 'eth_newBlockFilter')

        response = requests.post(
            self.rpc_url,
            json={'jsonrpc': '2.0', 'method': method, 'params': [], 'id': 1}
        )
        filter_id = response.json()['result']
        self.active_filters.append(filter_id)
        return filter_id

    def cleanup_all(self):
        removed = 0
        for filter_id in self.active_filters:
            response = requests.post(
                self.rpc_url,
                json={'jsonrpc': '2.0', 'method': 'eth_uninstallFilter', 'params': [filter_id], 'id': 1}
            )
            if response.json().get('result'):
                removed += 1
        print(f'Cleaned up {removed}/{len(self.active_filters)} filters')
        self.active_filters.clear()

Error Handling

Error Code	Description	Solution
-32602	Invalid params	Ensure the filter ID is a valid hex string
-32603	Internal error	Node may be starting up — retry after delay
-32005	Rate limit exceeded	Implement backoff between cleanup calls
`false` result	Filter not found	Filter already expired or was already removed — safe to ignore

eth_newFilter — Create a log event filter
eth_newBlockFilter — Create a new block filter
eth_newPendingTransactionFilter — Create a pending transaction filter
eth_getFilterChanges — Poll a filter for new results
eth_getFilterLogs — Get all logs matching a filter

eth_uninstallFilter - Chiliz RPC Method

When to Use This Method

Code Examples

Common Use Cases

1. Filter Lifecycle Manager

2. Event Monitor with Cleanup

3. Bulk Filter Cleanup

Error Handling

On this page