Troubleshooting

Solutions for common issues with BlockSecOps.

Common Issues

Issue	Guide
Can't upload contracts	Upload Issues
Scan fails or errors	Scan Failures
Can't log in	Login Issues
Wallet won't connect	Wallet Connection
API errors	API Errors
CLI problems	CLI Issues
Missing or incomplete results	Missing Results

---

Quick Fixes

"Upload Failed"

1. Check file size < 50MB
2. Ensure valid file format (.sol, .vy, .zip)
3. Try uploading fewer files
4. Check browser console for errors

"Scan Failed"

1. Verify contract compiles locally
2. Include all dependencies
3. Check Solidity version is supported
4. Review error message for details

"Can't Login"

1. Check email/password are correct
2. Try password reset
3. Clear browser cache
4. Try different browser

"API 401 Unauthorized"

1. Verify API key is correct
2. Check key isn't expired/revoked
3. Ensure Bearer prefix in header
4. Verify organization context

"CLI: Not authenticated"

1. Run blocksecops auth login
2. Enter your API key when prompted
3. Get an API key from Settings > API Keys

"CLI: Command not found"

1. Install: pip install blocksecops-cli
2. Or run as module: python -m blocksecops_cli
3. Check PATH includes pip bin directory

---

Error Codes

Code	Meaning	Solution
400	Bad Request	Check request format
401	Unauthorized	Verify API key
403	Forbidden	Check permissions
404	Not Found	Verify resource exists
429	Rate Limited	Wait and retry
500	Server Error	Contact support

---

Diagnostic Steps

Before Contacting Support

Gather this information:

1. Account email
2. Error message (exact text)
3. Timestamp of the issue
4. Steps to reproduce
5. Browser/OS (for UI issues)
6. API request/response (for API issues)

Check System Status

Visit our status page to check for:

• Platform outages
• Scheduled maintenance
• Known issues

---

Self-Service Tools

Browser Console

For frontend issues:

1. Press F12 to open DevTools
2. Go to Console tab
3. Look for red error messages
4. Note any errors when reproducing issue

Network Tab

For API/loading issues:

1. Press F12 to open DevTools
2. Go to Network tab
3. Reproduce the issue
4. Look for failed requests (red)
5. Check response details

Test API Connection

curl -X GET "https://api.blocksecops.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

Should return your user info if working correctly.

---

Contact Support

If self-service doesn't resolve your issue:

• Free/Developer: Email support
• Startup: Priority email
• Professional: Email + chat
• Enterprise: Dedicated support

See Contact Support for details.

---

Troubleshooting Guides

• Upload Issues - File upload problems
• Scan Failures - Scan errors
• Login Issues - Authentication problems
• Wallet Connection - Web3 wallet issues
• API Errors - API troubleshooting
• CLI Issues - Command-line tool problems
• Missing Results - Result issues
• Contact Support - Get help