Troubleshooting
Top five issues customers hit first and how to fix them quickly.
1) Slither missing
Symptom: Slither analyzer skipped or command not found.
Fix: pip install slither-analyzer and ensure slither is in your PATH.
2) Foundry missing
Symptom: Foundry tests/fuzzing unavailable.
Fix: install Foundry via curl -L https://foundry.paradigm.xyz | bash && foundryup.
3) Foundry project not detected
Symptom: contracts compile manually but scanner misses project context.
Fix: confirm foundry.toml exists at project root and run scan from that root path.
4) RPC timeouts
Symptom: chain intelligence modules fail intermittently.
Fix: switch RPC endpoint, reduce concurrent scans, retry with stable provider credentials.
5) License not validating
Symptom: Pro features remain locked after purchase.
Fix: sign in with purchase email, verify key in settings, and for CLI export COUNTERSCARP_PRO_LICENSE.