Common Issues

Even with a robust platform, users may occasionally encounter challenges. Below are the most common issues and how to resolve them.

Installation Problems

  • Ensure Node.js, Python, and Docker are installed with supported versions

  • Check for missing dependencies using npm install or pip install -r requirements.txt

  • Use Docker logs or verbose mode for error visibility

Configuration Errors

  • Double-check .env variables are set correctly

  • Verify API keys and RPC endpoints are valid and reachable

  • Ensure database connections and ports are open

Performance Issues

  • Large dataset loads can be reduced with query filters

  • Enable caching with Redis to prevent API overload

  • Adjust resource allocation for local Docker services

API Limitations

  • Monitor rate limits; upgrade plans allow more requests

  • Ensure pagination and batching are implemented for large fetches

  • Refer to status codes for API response diagnostics

Data Inconsistencies

  • Sync issues may occur during heavy chain reorgs or RPC outages

  • Use fallback RPC nodes when primary source is unstable

  • Clear cache or restart services to reinitialize data fetch

PreviousAutomation and WorkflowsNextDebugging Guide

Last updated