Skip to content

README.md

Latest commit

 

History

History
189 lines (140 loc) · 4.89 KB

README.md

File metadata and controls

189 lines (140 loc) · 4.89 KB

EigenWatch Subgraph

🔍 Real-time indexing of EigenLayer events for risk analysis and operator monitoring

EigenWatch Subgraph powers the EigenWatch analytics platform by indexing key EigenLayer contracts to enable real-time risk analysis, operator scoring, and delegation monitoring. It captures critical events across the protocol to support restaking infrastructure insights.

Deploy Status Network

🚀 What It Does

EigenWatch indexes six core EigenLayer smart contracts to enable:

  • Operator Risk Scoring – Slashing history, commission behavior, AVS performance
  • Delegation Monitoring – Real-time flows, volatility, and concentration
  • TVS Indexing – Running totals of operator shares per strategy for TVS calculation
  • Economic Analysis – Rewards tracking, sustainability signals
  • Portfolio Insights – AVS exposure, strategy allocation, diversification metrics

🔧 Tracked Contracts

Contract Description Address (Start Block)
DelegationManager Operator registration & delegation 0x3905...f37A (17445563)
AllocationManager Slashing events & AVS assignments 0x948a...bc39 (22218956)
RewardsCoordinator Commission rates & rewards tracking 0x7750...adda (20341793)
StrategyManager Strategy deposits (stETH, rETH, etc.) 0x8586...075A (17445564)
AVSDirectory Legacy AVS registration 0x135d...f5af (19492759)
EigenPodManager Native ETH restaking 0x91E6...338 (17445564)

🛠️ Quick Start

Prerequisites

Setup & Deploy

git clone https://github.com/your-org/eigenwatch-subgraph
cd eigenwatch-subgraph
npm install
npm run codegen
npm run build

# Authenticate with Graph Studio
graph auth <YOUR_DEPLOY_KEY>

# Deploy
graph deploy eigenwatch-ethereum

📘 Core Entities

  • Operator – Delegation history, slashing, commissions, AVS memberships
  • OperatorStrategyShare – Running totals of shares for an operator-strategy pair
  • Staker – Individual delegators and their relationships
  • AVS – Actively Validated Services with operator sets
  • Strategy – Restaking tokens (e.g., stETH, rETH) with metadata
  • EigenPod – Native ETH restaking pods
  • Events – Immutable records for slashing, rewards, delegation, etc.

📊 Example Queries

Operator Risk Summary

query GetOperatorRisk($id: String!) {
  operator(id: $id) {
    slashingEventCount
    delegatorCount
    commissionEvents {
      newCommissionBips
      blockTimestamp
    }
  }
}

Recent Slashing & Delegation

query GetRecentEvents($from: BigInt!) {
  operatorSlasheds(where: { blockTimestamp_gte: $from }) {
    operator {
      id
      address
    }
    description
    blockTimestamp
  }
  stakerDelegationEvents(where: { blockTimestamp_gte: $from }) {
    delegationType
    operator {
      id
    }
    staker {
      id
    }
    blockTimestamp
  }
}

Operator TVS Shares

query GetOperatorShares($operatorId: ID!) {
  operator(id: $operatorId) {
    shares {
      strategy {
        id
        underlyingToken
        tokenDecimals
      }
      totalShares
    }
  }
}

🔎 More example queries in test-queries/

🧠 Use Cases

  • Operator Monitoring – Reputation, slashing, commission changes
  • AVS Risk Modeling – Slashing frequency, operator quality
  • Delegation Analysis – Flow tracking, HHI-based concentration scoring
  • Portfolio Views – AVS exposure and strategy allocation per operator

📈 Performance

  • Real-Time Indexing – <60s latency
  • Initial Sync – 2–24 hrs (optimized start blocks)
  • Query Performance – <2s for most complex queries

🧩 Development

Add New Events

  1. Update schema.graphql

  2. Add handler in subgraph.yaml

  3. Implement logic in src/

  4. Run:

    npm run codegen
npm run build

Local Deployment (Optional)

# Start Graph node locally
docker-compose up

# Deploy locally
graph create eigenwatch --node http://127.0.0.1:8020
graph deploy eigenwatch --node http://127.0.0.1:8020 --ipfs http://127.0.0.1:5001

📞 Support & Community

Built with ❤️ for the EigenLayer ecosystem