Skip to main content

AVS Integration Guide

TODO: Complete Integration Guide for AVS Developers​

How to integrate EigenWatch risk data into your AVS.

Required Sections​

  • Why AVSs Use EigenWatch

    • Operator health monitoring
    • Automated operator replacement on high risk
    • Slashing event alerts
    • Reputation filtering for whitelist

  • Operator Monitoring Workflow

    • Query operator risk scores
    • Set risk thresholds for your AVS
    • Subscribe to risk score changes
    • Monitor for slashing events

  • Operator Replacement Strategy

    • When to replace high-risk operators
    • Communication with operators
    • Replacement process & timing
    • Governance considerations

  • Example Integration

    from eigenwatch import EigenWatchAPI

    client = EigenWatchAPI(api_key="...")

    # Monitor operator set
    for operator in my_avs_operators:
      risk = client.get_risk_score(operator)
      if risk['risk_score'] > 70:
        send_alert(f"High-risk operator: {operator}")
        # Potentially trigger replacement

  • Alert Subscriptions

    • Slashing event alerts
    • Risk score threshold breaches
    • Operator registration/deregistration
    • Setting up webhooks

  • On-Chain Integration (if applicable)

    • Querying oracle for operator risk
    • Automated slashing triggers
    • Gas-efficient querying strategies

  • Testing & Staging

    • Using testnet endpoints
    • Mock data / simulation mode
    • Integration testing strategies

  • Support & Troubleshooting

    • Common issues & solutions
    • Debug logging
    • Contacting support

Use Cases​

  • Validating new operator registrations against minimum risk score
  • Automatically replacing operators when score exceeds threshold
  • Building operator health dashboard
  • Incident response automation

Status: NOT STARTED — Requires AVS design patterns & examples