hyper/WIKI/TROUBLESHOOTING.md

Troubleshooting common issues

1. Import errors

   • Ensure the virtual environment is active.
   • Run pip install -r requirements.txt.

2. Agent authorization failures

   • Ensure your main wallet is activated on Hyperliquid and has funds.
   • The create_agent.py script will print helpful messages if the vault (main wallet) cannot act.

3. SQLite locked errors

   • Increase the SQLite timeout when opening connections (this project uses a 10s timeout in fetcher). Close other programs that may hold the DB open.

4. Missing coin precision file

   • Run python list_coins.py to regenerate _data/coin_precision.json.

5. Rate limits from CoinGecko

   • Set COINGECKO_API_KEY in your .env file and ensure the fetcher respects backoff.

6. Agent keys in agents file or other local files

   • Treat any agents file with private keys as compromised; rotate keys and remove the file from the repository.