Troubleshooting

Common issues and solutions for SweepGuard.

Recovery Issues

"Transaction failed" during recovery

Possible causes:

• Insufficient gas — increase the gas limit


• Sweeper bot front-running — ensure Flashbots is enabled


• Token transfer restrictions — some tokens have transfer limits or blacklists

Solutions:


• Make sure Flashbots is enabled in recovery settings


• Try with a higher gas price


• For restricted tokens, try recovering smaller amounts


• Contact support if the issue persists

Recovery shows "pending" for a long time

Flashbots transactions wait for the next block. If the network is congested, this can take several minutes.

Solutions:


• Wait up to 5 minutes — Flashbots bundles retry automatically


• Check the recovery ID on Etherscan for status


• If stuck for >10 minutes, try canceling and re-submitting

"No assets found" during scan

Possible causes:


• Wrong address — double-check the compromised address


• Assets on unsupported chains — check Chain Support


• Assets in DeFi protocols — some positions aren't detected by basic scans

Solutions:


• Verify the address is correct


• Manually add chains you know the wallet uses


• Check DeFi positions manually on DeBank or Zapper

Gas estimation is too high

Possible causes:


• Network congestion


• Complex recovery (many tokens to move)


• Including low-value tokens that aren't worth the gas

Solutions:


• Wait for lower gas prices (weekends, off-peak hours)


• Select only high-value assets for recovery


• Use EIP-7702 batching to reduce total gas

Monitoring Issues

Not receiving Telegram alerts

Possible causes:


• Bot token not configured


• Chat ID incorrect


• Bot was blocked

Solutions:


• Check bot status at /bot


• Verify your chat ID with @userinfobot


• Unblock the bot and send /start


• Check that TELEGRAMBOTTOKEN is set in environment

Not receiving Discord alerts

Possible causes:


• Bot not invited to server


• Channel ID incorrect


• Missing permissions

Solutions:


• Check bot status at /discord


• Re-invite the bot with correct permissions


• Verify the channel ID (enable Developer Mode in Discord)


• Make sure the bot has Send Messages and Embed Links permissions

Alerts are delayed

Possible causes:


• Network congestion affecting blockchain indexing


• Rate limiting on alert delivery

Solutions:


• Alerts typically arrive within 5-30 seconds


• If consistently delayed, check your network connection


• Contact support if delays exceed 1 minute

Extension Issues

Extension not detecting transactions

Solutions:


• Make sure the extension is enabled in your browser


• Refresh the page after installing


• Check that the dApp uses standard wallet providers (MetaMask, WalletConnect)


• Try disabling other extensions that might conflict

Extension slowing down browser

Solutions:


• Disable chains you don't use in extension settings


• Clear the extension cache


• Update to the latest version

API Issues

401 Unauthorized

Your API key is missing or invalid.

Solutions:


• Check that you're including the Authorization header


• Generate a new API key at /api-docs


• Make sure there are no extra spaces in the header

429 Rate Limit Exceeded

You've exceeded your API rate limit.

Solutions:


• Wait for the rate limit to reset (check the Retry-After header)


• Upgrade to a higher tier for more requests


• Implement request caching on your end

500 Internal Server Error

A server-side error occurred.

Solutions:


• Retry the request after a few seconds


• Check the error message for details


• Contact support with the request ID if it persists

Getting Help

If you can't resolve your issue:

• Discord: Join our server for community support


• Telegram: Message our support bot


• Email: support@sweeptsguard.vercel.app


• GitHub: Open an issue for technical problems