kzn-labs/wiretap

Wiretap is a small Rust command-line tool that listens to the Sui blockchain and saves specific events to a local database. Sui deprecated its older polling-based query APIs in July 2026, so Wiretap exists as a replacement that uses Sui's new streaming approach instead. The tool connects to a Sui node over a persistent connection, receives blockchain events in order as they happen, and writes only the events matching your filters to storage. You specify which events to capture using filters in a configuration file: you can match by event type, by the package that emitted the event, by sender address, or by affected address. Wiretap compiles these filters at startup and runs each incoming event through them. For large address watchlists, it uses a bloom filter as a quick pre-check before more detailed matching. The tool saves its position in the chain so that if it disconnects or restarts, it picks up exactly where it left off and fills in any events it missed during the gap. Four storage options are available: a SQLite file that requires no setup, a Postgres database, a webhook that batches events to a URL with automatic retries, and standard output for piping into other tools. Wiretap also works as a Rust library. You can embed the wiretap-core crate into your own application and write a custom handler that receives decoded events in about twenty lines of code. Event data arrives already decoded from the binary format Sui uses, with struct types and nested objects resolved locally by fetching the type layout from the node. The README does not state a license for this project.