Troubleshooting Guides¶
Welcome to the Fukuii troubleshooting guides! This directory contains step-by-step solutions for common operational scenarios.
Contents¶
Sync and Network¶
- Block Sync Guide — Solutions for blockchain synchronization scenarios
EVM and Transaction¶
- Gas Calculation Guide — Gas calculation reference and solutions (✅ Resolved)
Test Failures and CI¶
- Visual Summary — 📊 Visual overview with charts and diagrams (start here!)
- Quick Reference — Quick lookup for nightly test failure investigation
- Nightly Run Analysis (2025-12-19) — Comprehensive analysis of 37 test failures
- Failure Tracking — Current status and progress on fixing test failures
Quick Links¶
- Operations Runbooks — Day-to-day operational guides
- Known Issues & Solutions — Common scenarios with solutions
- Log Analysis — Understanding log messages
- Investigation Reports — Historical issue investigations
Getting Help¶
If you can't find what you're looking for:
- Check the Known Issues list
- Review relevant Investigation Reports
- Search GitHub Issues
- Open a new issue with detailed information — we're happy to help!