wiki

WIKI/TROUBLESHOOTING.md

@@ -0,0 +1,21 @@
+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.