Files
CurrenciCombo/docs/TROUBLESHOOTING.md
defiQUG f600b7b15e Add ECDSA signature verification and enhance ComboHandler functionality
- Integrated ECDSA for signature verification in ComboHandler.
- Updated event emissions to include additional parameters for better tracking.
- Improved gas tracking during execution of combo plans.
- Enhanced database interactions for storing and retrieving plans, including conflict resolution and status updates.
- Added new dependencies for security and database management in orchestrator.
2025-11-05 16:28:48 -08:00

3.4 KiB

Troubleshooting Guide

Common Issues and Solutions


Frontend Issues

Issue: Hydration Errors

Symptoms: Console warnings about hydration mismatches Solution:

  • Ensure all client-only components use "use client"
  • Check for conditional rendering based on window or browser APIs
  • Use useEffect for client-side only code

Issue: Wallet Connection Fails

Symptoms: Wallet popup doesn't appear or connection fails Solution:

  • Check browser console for errors
  • Verify wallet extension is installed
  • Check network connectivity
  • Clear browser cache and try again

Issue: API Calls Fail

Symptoms: Network errors, 500 status codes Solution:

  • Verify NEXT_PUBLIC_ORCH_URL is set correctly
  • Check orchestrator service is running
  • Verify CORS configuration
  • Check browser network tab for detailed errors

Backend Issues

Issue: Database Connection Fails

Symptoms: "Database connection error" in logs Solution:

  • Verify DATABASE_URL is correct
  • Check database is running and accessible
  • Verify network connectivity
  • Check firewall rules

Issue: Rate Limiting Too Aggressive

Symptoms: "Too many requests" errors Solution:

  • Adjust rate limit configuration in rateLimit.ts
  • Check if IP is being shared
  • Verify rate limit window settings

Issue: Plan Execution Fails

Symptoms: Execution status shows "failed" Solution:

  • Check execution logs for specific error
  • Verify all adapters are whitelisted
  • Check DLT connection status
  • Verify plan signature is valid

Database Issues

Issue: Migration Fails

Symptoms: Migration errors during startup Solution:

  • Check database permissions
  • Verify schema doesn't already exist
  • Check migration scripts for syntax errors
  • Review database logs

Issue: Query Performance Issues

Symptoms: Slow API responses Solution:

  • Check database indexes are created
  • Review query execution plans
  • Consider adding additional indexes
  • Check connection pool settings

Smart Contract Issues

Issue: Contract Deployment Fails

Symptoms: Deployment reverts or fails Solution:

  • Verify sufficient gas
  • Check contract dependencies
  • Verify constructor parameters
  • Review contract compilation errors

Issue: Transaction Reverts

Symptoms: Transactions revert on execution Solution:

  • Check error messages in transaction receipt
  • Verify adapter is whitelisted
  • Check gas limits
  • Verify signature is valid

Monitoring Issues

Issue: Metrics Not Appearing

Symptoms: Prometheus metrics endpoint empty Solution:

  • Verify metrics are being recorded
  • Check Prometheus configuration
  • Verify service is running
  • Check network connectivity

Security Issues

Issue: API Key Authentication Fails

Symptoms: 401/403 errors Solution:

  • Verify API key is correct
  • Check API key format
  • Verify key is in ALLOWED_KEYS
  • Check request headers

Performance Issues

Issue: Slow API Responses

Symptoms: High latency Solution:

  • Check database query performance
  • Verify Redis caching is working
  • Review connection pool settings
  • Check external service response times

Getting Help

  1. Check logs: kubectl logs <pod-name> or docker logs <container>
  2. Review metrics: /metrics endpoint
  3. Check health: /health endpoint
  4. Review error messages in application logs

Last Updated: 2025-01-15