Having trouble with Awareius? This guide covers the most common issues and their solutions. If you can't find what you're looking for, our support team is here to help.
Jump to Section
Scan Issues
My scan failed with 'Compilation Error'
Possible Causes:
- Contract has syntax errors
- Incompatible Solidity version
- Missing imports or dependencies
- Invalid pragma directives
Solutions:
- Verify your contract compiles locally using Remix or Hardhat
- Check that all import statements are correct
- Ensure pragma version matches your code (e.g., pragma solidity ^0.8.0)
- Remove any custom imports that aren't included in the upload
- Try compiling with different Solidity versions
Scan is stuck at 'Processing' for a long time
Possible Causes:
- Very large or complex contract
- High server load
- Network connectivity issues
- Contract requires extended analysis time
Solutions:
- Wait up to 20 minutes for complex contracts
- Check your internet connection
- Refresh the page - scan continues in background
- Try scanning during off-peak hours
- Split very large contracts into smaller modules if possible
- Contact support if stuck for more than 30 minutes
Scan results show 'No vulnerabilities' but I know there are issues
Possible Causes:
- False negatives in specific edge cases
- Contract uses non-standard patterns
- Vulnerabilities in external dependencies not scanned
- Logic errors that require business context
Solutions:
- Remember: automated tools can't catch everything
- Review custom business logic manually
- Get a professional audit for critical contracts
- Use multiple scanning tools for comprehensive coverage
- Test your contract thoroughly with unit tests
- Report false negatives to help improve our detectors
Too many false positives in scan results
Possible Causes:
- Overly sensitive detector settings
- Valid patterns flagged as suspicious
- Contract uses advanced patterns misidentified as risky
Solutions:
- Review each finding carefully - false positives are rare
- Adjust severity threshold in scan settings (Pro plan)
- Document why certain patterns are safe in your context
- Report persistent false positives to support@awareius.com
- Consider if flagged patterns could be refactored for clarity
Upload & File Issues
File upload fails or times out
Possible Causes:
- File size exceeds 10MB limit
- Slow internet connection
- Browser compatibility issues
- File encoding problems
Solutions:
- Check file size is under 10MB
- Try uploading from a better network connection
- Use a modern browser (Chrome, Firefox, Safari, Edge)
- Clear browser cache and cookies
- Try pasting code directly instead of uploading file
- Ensure file is UTF-8 encoded
Contract code appears garbled after upload
Possible Causes:
- Incorrect file encoding
- Special characters not supported
- Binary file uploaded instead of text
Solutions:
- Save your file with UTF-8 encoding
- Copy and paste code directly into the editor instead
- Remove any special characters or formatting
- Ensure you're uploading a .sol or .txt file, not a compiled binary
Account & Authentication
Cannot sign in with Google
Possible Causes:
- Pop-up blocker preventing OAuth
- Third-party cookies disabled
- Google account issues
- Browser privacy settings
Solutions:
- Disable pop-up blockers for awareius.com
- Enable third-party cookies in browser settings
- Try signing in with an incognito/private window
- Clear browser cache and cookies
- Try a different browser
- Ensure your Google account is active and verified
Scan limit reached but I haven't used all my scans
Possible Causes:
- Counting failed scans as used
- Scans from previous billing cycle included
- Account syncing issue
Solutions:
- Check your scan history in Settings > Usage
- Note: Failed scans after compilation don't count
- Wait for next monthly reset (shown in dashboard)
- Refresh the page to sync latest scan count
- Contact support if count appears incorrect
Cannot update account settings
Possible Causes:
- Browser session expired
- Network connectivity issues
- Validation errors in form
Solutions:
- Refresh the page and try again
- Log out and log back in
- Check all required fields are filled correctly
- Ensure email format is valid
- Try using a different browser
Dashboard & UI Issues
Dashboard not loading or showing blank page
Possible Causes:
- JavaScript errors
- Browser compatibility
- Cached outdated version
- Network issues
Solutions:
- Hard refresh the page (Ctrl+Shift+R or Cmd+Shift+R)
- Clear browser cache and cookies
- Disable browser extensions temporarily
- Try a different browser
- Check browser console for error messages
- Ensure JavaScript is enabled
Scan history not showing recent scans
Possible Causes:
- Cache not updated
- Scans still processing
- Sync delay
Solutions:
- Refresh the page
- Wait a few minutes for processing to complete
- Check if scans appear in 'In Progress' section
- Clear browser cache if scans completed but not visible
Cannot download PDF report
Possible Causes:
- Pop-up blocker preventing download
- Browser download settings
- Report still generating
Solutions:
- Disable pop-up blocker for awareius.com
- Check browser's download folder
- Wait a few seconds and try again
- Try right-click > 'Save link as'
- Check browser's download permissions
Billing & Subscription
Payment failed when upgrading to Pro
Possible Causes:
- Insufficient funds
- Card declined by bank
- Incorrect payment information
- International transaction blocked
Solutions:
- Verify card has sufficient funds
- Contact your bank to allow the transaction
- Double-check card number, expiry, and CVV
- Try a different payment method
- Ensure billing address is correct
- Contact support@awareius.com for alternative payment options
Subscription cancelled but still being charged
Possible Causes:
- Cancellation processed after billing cycle
- Pending charges before cancellation
- Subscription not properly cancelled
Solutions:
- Check Settings > Billing for subscription status
- Review cancellation confirmation email
- Verify cancellation took effect after last billing date
- Contact support@awareius.com with transaction details
- Request refund if incorrectly charged
Cannot access Pro features after upgrade
Possible Causes:
- Account not synced after payment
- Payment still processing
- Cache showing old plan
Solutions:
- Log out and log back in
- Wait up to 10 minutes for payment to process
- Clear browser cache and reload
- Check Settings > Billing to confirm plan status
- Contact support if features not unlocked after 1 hour
Still Need Help?
Contact Support
Our support team is available to help with any issues not covered in this guide. We typically respond within 24 hours.
support@awareius.comInclude This Information
When contacting support, please include:
- Your account email
- Scan ID (if applicable)
- Browser and version
- Steps to reproduce the issue
- Screenshots of error messages