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.

docs/TROUBLESHOOTING.md

@@ -0,0 +1,147 @@
+# 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
+