indexing-wildcard

What problem does it solve?

This Skill enables capturing the same event signature emitted by any contract address on a blockchain, removing the need to pre-list contract addresses and allowing chain-wide event discovery and attribution.

Core Features & Use Cases

• Wildcard contract configuration: declare a contract in config without addresses to match that event signature across the entire chain.
• Handler wildcard mode: pass wildcard:true to handlers and use event.srcAddress to identify the actual emitting contract for storage and attribution.
• Event filtering to control volume: combine wildcard indexing with eventFilters (by parameter values, address lists, or functions) to reduce noise and cost.
• Use cases: index all ERC-20 Transfer events for token analytics, monitor builder-attributed order fills across an exchange, or aggregate on-chain metrics without maintaining exhaustive address lists.

Quick Start

Start wildcard indexing of ERC-20 Transfer events across a chain and record each event using event.srcAddress as the token identifier.