The Block Anomaly detector watches every produced block and fires when key metrics fall outside their expected ranges. It catches network-level anomalies that often precede or accompany on-chain attacks.Documentation Index
Fetch the complete documentation index at: https://docs.extractor.live/llms.txt
Use this file to discover all available pages before exploring further.
What it monitors
- Transactions
- Events
- Block size
- Gas
Fires when the number of transactions in a block is unusually low (possible censorship or validator downtime) or unusually high (spam attack, MEV flood).
Use cases
Network health & stability monitoring
Network health & stability monitoring
A chain suddenly producing blocks with abnormally low transaction counts or gas usage can signal network congestion, validator downtime, or censorship attacks. The detector flags these in real time so infra teams can investigate immediately.
Exploit & attack detection
Exploit & attack detection
MEV spam, denial-of-service attacks, and reorg attempts all produce blocks with extreme metrics. The detector correlates anomalies with known attack patterns (repeated reverts, flash-loan spam, flood of small transfers).
Compliance & forensics
Compliance & forensics
Auditors and compliance teams need structured logs of abnormal block patterns. The detector provides these for cross-referencing with suspicious addresses and regulatory reporting.
Configuration
| Parameter | Description |
|---|---|
| Name | Descriptive label for this detector instance |
| Transactions min/max | Acceptable transaction count range per block |
| Events min/max | Acceptable event count range per block |
| Block size min/max | Acceptable block size range (bytes) |
| Gas min/max | Acceptable total gas usage range per block |
| Gas min/max (Tx) | Acceptable gas usage range per individual transaction |
| Block Freq min/max | Expected block interval in milliseconds |
| Cron | Schedule for evaluation (leave empty for real-time) |
| Track Latency | Whether to include block production latency in analysis |