Introduction
Welcome to apphash.io - the only platform for detecting and reporting the root cause of any state non-determinism in blockchains.
What is apphash.io?
apphash.io is a production-ready platform that monitors consensus-critical events and provides comprehensive root cause analysis when state non-determinism occurs. When your validators produce different app hashes, apphash.io helps you:
- Monitor consensus-critical events in real-time
- Detect state non-determinism issues as they occur
- Analyze block-by-block state changes and validator-specific diffs to pinpoint the root cause
Key Features
Complete State Visibility
- State change tracking: Observe all KV store changes and state hashes for every block on each node
- Chronological ordering: Preserved event ordering enables immediate response when critical issues arise
Easy Integration
- Simple setup: Single commit integration with minimal code changes
- No consensus impact: Zero consensus-breaking patches - safe for production chains
Production-Ready Performance
- Minimal overhead: Collects more data than standard info logs with only slight memory increase and negligible CPU/disk I/O impact
- Efficient design: Internal filtering and gzip-compressed WAL with non-blocking asynchronous operations (see benchmark)
How It Works
apphash.io uses a custom memlogger integrated into the Cosmos SDK that:
- Buffers logs in memory with configurable thresholds
- Compresses logs asynchronously using gzip
- Persists to a Write-Ahead Log (WAL) with indexed segments
- Ships logs to the apphash.io platform for analysis
- Provides detailed state change data when issues occur
Get Started
Ready to integrate apphash.io into your chain? Follow our Getting Started guide to begin monitoring your blockchain in minutes.