Skip to main content

Troubleshooting

TODO: Complete Troubleshooting Guide​

How to debug common issues.

API Issues​

Issue: 401 Unauthorized

  • Check that your API key is correct
  • Verify your API key hasn't expired
  • Ensure you're using the correct header format: Authorization: Bearer YOUR_API_KEY
  • API Authentication

Issue: 429 Rate Limited

  • You've exceeded your request quota
  • Wait for the rate limit window to reset (see response headers)
  • Upgrade to a higher tier for higher limits
  • Optimize your queries (use batch endpoints)
  • Rate Limiting

Issue: 404 Not Found

  • The operator address doesn't exist in EigenWatch
  • Check the address format (should be checksummed)
  • The operator may not yet be indexed
  • Query all operators to verify: API Overview

Issue: 500 Internal Server Error

  • EigenWatch is experiencing a problem
  • Check the status page: https://status.eigenwatch.xyz
  • Retry after a brief delay
  • Contact support if the issue persists

Issue: Slow API Response

  • Check your internet connection
  • Try a simpler query first (single operator vs batch)
  • Check the status page for service degradation
  • Upgrade to a higher tier for better performance

WebSocket Issues​

Issue: Connection Refused

  • Check that you're connecting to the correct endpoint
  • Verify that WebSockets are enabled in your network
  • Firewalls may block WebSocket connections
  • Try connecting from a different network to test

Issue: Connection Dropped

  • The server may have restarted
  • Implement reconnection with exponential backoff
  • Check your internet connection
  • WebSocket Subscriptions

Issue: Not Receiving Events

  • Verify your subscription is active
  • Check that events are happening (new slashing, risk score changes)
  • Check your filters (are you subscribed to the right operators?)
  • Review subscription configuration: Alerts API

Data Issues​

Issue: Risk Score is Stale

  • Check the last_updated field
  • Verify that new events are occurring for this operator
  • If older than expected, contact support

Issue: Different Risk Scores at Different Times

  • Risk scores update in real-time
  • Different times may show different scores
  • Check the update timestamp to confirm

Issue: Operator Not Yet Indexed

  • New operators may take time to appear
  • Check if the operator is registered with EigenLayer
  • Retry after a few minutes
  • Contact support if the operator isn't indexed after a day

Alert Issues​

Issue: Webhook Not Being Called

  • Verify your webhook URL is correct
  • Check that your server is responding with 2xx status
  • Verify that events are actually happening
  • Check firewall/network rules allowing inbound traffic
  • Alert Webhooks

Issue: Duplicate Alerts

  • EigenWatch guarantees at-least-once delivery
  • Implement idempotency on your end (check alert_id)
  • Alert API Details

Issue: Email Alerts Not Arriving

  • Check spam/junk folders
  • Verify email address in subscription settings
  • Ensure the event actually occurred
  • Contact support if the issue persists

Smart Contract Issues​

Issue: Oracle Returns Zero / Stale Data

  • Check that the oracle address is correct
  • Verify the operator is deployed in the system
  • Call lastUpdate() to check data freshness
  • Check the network (mainnet vs testnet)
  • Oracle Feeds

Issue: Gas Cost Too High

  • Batch multiple queries into one call
  • Consider caching results on-chain
  • Use L2 deployments if available
  • Contact support for optimization tips

Getting Help​

If you've tried these steps and still have issues:

  1. Check the FAQ
  2. Search GitHub Issues
  3. Ask in GitHub Discussions
  4. Contact support@eigenwatch.xyz (email to be added)
  5. Join the Discord community

Status: NOT STARTED — Requires product support experience