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.