> For the complete documentation index, see [llms.txt](https://shepherd-1.gitbook.io/shepherd/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shepherd-1.gitbook.io/shepherd/additional-info/troubleshooting.md). # Troubleshooting ### Upload Issues **Problem:** .zip file upload fails or times out **Solutions:** * Verify .zip file is valid and not corrupted * Ensure .zip contains contract source files * Reduce file size by removing unnecessary files * Check file size limits (split large repos if needed) *** ### Tunnel Connection Issues **Problem:** Shepherd cannot reach local environment **Solutions:** * Verify tunnel URL is correct and accessible * Test tunnel with `curl [tunnel-url]` from command line * Check firewall and network settings * Ensure local node is running on correct port * Verify tunnel service (ngrok, etc.) is active *** ### No Findings or Unclear Results **Problem:** Shepherd doesn't find expected vulnerabilities **Solutions:** * Make hypothesis more specific and detailed * Include exact function names and attack vectors * Add more contract chunks for cross-contract scenarios * Verify contract names and function names are correct * Check that uploaded contracts match what you're testing *** ### Contract or Function Not Found **Problem:** Error message about missing contract or function **Solutions:** * Verify contract name matches exactly (case-sensitive) * Check function name spelling and case * Ensure contract is included in uploaded zip * For complex areas, provide more description context * Review zip structure and file organization *** ### Initialization Hangs or Takes Too Long **Problem:** Materials initialization or chunking doesn't complete **Solutions:** * Wait a few minutes for large codebases * Verify .zip file contains valid Solidity files * Check for corrupted or malformed source files * Try uploading a smaller subset of contracts first * Restart session and try again