Ethereum Webhooks
Decoded ERC-20 & Log Streams
Track contract events, transfers, and token balances across Ethereum, Base, Polygon, and major EVM chains. Eliminate indexing delays and capture clean, signed payloads instantly.
Listen and react to EVM contracts
Configure watches, set filters, and dispatch incoming events natively in your TypeScript projects.
// 1. Initialize Blockferry SDK
import { Blockferry } from '@blockferry/sdk';
const sdk = new Blockferry({
apiKey: process.env.BLOCKFERRY_API_KEY!,
});
// 2. Setup Watchlist for ERC-20 / EVM contract addresses
const watchlist = await sdk.watchlists.create({
name: 'Ethereum Hot Wallet Watch',
chains: ['1'], // Chain ID '1' stands for Ethereum Mainnet
webhookUrl: 'https://api.mybackend.com/webhooks/ethereum'
});
await sdk.watchlists.addAddresses(watchlist.id, {
addresses: [
{
address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
metadata: { accountId: 'user-deposit-master' }
}
]
});How Blockferry delivers EVM events
Multi-Node Ingestion
Our clusters poll raw blocks from multiple high-availability nodes, guaranteeing 100% block coverage.
Log Decoding
Topics and bytecode parameters are decoded automatically using standardized ERC interfaces, returning clean numbers.
Reorg Reconciliation
We trace blocks until forks collapse. Workflows execute only after transactions clear safe reorganization thresholds.
Durable Routing
Webhooks are sent with exponential retry loops and HMAC signatures, offering total security and resilience.
Reorganization Safety Thresholds
Ethereum L2 and L1 block structures are vulnerable to temporary rollbacks. Blockferry eliminates transaction double-counting through automated threshold buffers:
- Safe (1 Block): Delivered immediately upon the next block confirmation. High-speed, suitable for user notifications.
- Finalized (12 Blocks / Epoch): Fully committed under Ethereum consensus rules. Recommended for asset deposits and withdrawal credits.
Smart Contract Log Auditing
We decode standard contract log hashes natively. Target log filtering with Blockferry requires no manual hex calculations:
- Topic Filtering: Filter smart contract events dynamically by matching topic hash signatures (like approvals, deposits, or governance outputs).
- Log Indexes: Every payload carries block log index tracking to maintain correct event sequence execution.