event-tail

Real-time `tail -f` for your smart contract events.

Stop refreshing block explorers. Monitor any on-chain event in real-time to debug contract interactions, watch for specific activities, or get a live feed of your protocol's usage.

Install for Free

See On-Chain Activity As It Happens


$ # Get a real-time feed of Bored Ape Yacht Club transfers
$ event-tail --address 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D --event Transfer --rpc-url wss://mainnet.alchemy.io/ws/YOUR_KEY

📡 Listening for 'Transfer' events on 0xbc4c...f13d...

[2025-09-30 17:39:05] Transfer (Tx: 0x5d0e...)
 - from: 0x0000000000000000000000000000000000000000
 - to: 0x1a9b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b
 - tokenId: 8821

[2025-09-30 17:39:45] Transfer (Tx: 0x9c1a...)
 - from: 0x1a9b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b
 - to: 0x7d8a9c0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c
 - tokenId: 8821

Key Features

Real-Time Monitoring

Uses a persistent WebSocket connection to your RPC node to stream event logs the moment they are mined, with no polling or delay.

Automatic ABI Fetching

Don't have the ABI handy? Just provide your Etherscan API key, and `event-tail` will automatically fetch the correct ABI for any verified contract.

Simple & Developer-Friendly

With a clear, colorized output and a simple command structure, you can start monitoring in seconds. It's the perfect tool for live debugging and observation.

Get Started

Install the tool and start monitoring events in seconds. It's 100% free.

macOS & Linux (via Shell)

Open your terminal and run the following command to install the tool.

curl -sSL https://download.blocktools.dev/install.sh | sh -s -- event-tail

Windows (via PowerShell)

Open a new PowerShell terminal and run the following command to install the tool.

iex (irm https://download.blocktools.dev/install.ps1) -ToolToInstall event-tail