bea1903ac9
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
Troubleshooting
Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation
This directory contains troubleshooting guides and FAQs.
Documents
- TROUBLESHOOTING_FAQ.md ⭐⭐⭐ - Common issues and solutions - Start here for problems
- RPC_NODES_BLOCK_PRODUCTION_FIX.md ⭐⭐ - RPC nodes not responding; ping works but curl doesn’t (use POST + JSON-RPC; see section “Ping works but curl to :8545 doesn’t?”)
- METAMASK_TROUBLESHOOTING_GUIDE.md ⭐⭐ - MetaMask on Chain 138 (RPC, tokens, swaps, XChain error)
- QBFT_TROUBLESHOOTING.md ⭐⭐ - QBFT consensus troubleshooting
Quick Reference
Common Issues:
- Check TROUBLESHOOTING_FAQ.md for common problems
- For consensus issues, see QBFT_TROUBLESHOOTING.md
- For allowlist issues, see ../06-besu/BESU_ALLOWLIST_QUICK_START.md
- MetaMask "No XChain Swaps native asset found for chainId: eip155:138" (on Send or Swap) — see METAMASK_TROUBLESHOOTING_GUIDE.md; workaround: send from a dApp, try another Send entry point, or use another wallet
Related Documentation
- ../03-deployment/OPERATIONAL_RUNBOOKS.md - Operational procedures
- ../06-besu/ - Besu configuration
- ../08-monitoring/ - Monitoring guides