eigen-skills 1.0.0 → 1.1.1

package/README.md

@@ -1,16 +1,8 @@
-<p align="center">
-  <h1 align="center">eigen-skills</h1>
-  <p align="center">
-    <strong>EigenLayer Agent Skills — Plug-and-play AI agent capabilities for the entire EigenLayer stack</strong>
-  </p>
-  <p align="center">
-    <a href="#installation">Installation</a> •
-    <a href="#skills-overview">Skills</a> •
-    <a href="#architecture">Architecture</a> •
-    <a href="#usage">Usage</a> •
-    <a href="#api-reference">API Reference</a>
-  </p>
-</p>
+# eigen-skills
+
+**EigenLayer Agent Skills — Plug-and-play AI agent capabilities for the entire EigenLayer stack**
+
+[Installation](#installation) | [Skills](#skills-overview) | [Architecture](#architecture) | [Usage](#usage) | [API Reference](#api-reference)
 
 ---
 
@@ -126,20 +118,29 @@ npx skills add zeeshan8281/eigen-skills
 
 ## Installation
 
-### For AI Agents (Primary Method)
+### For Claude Code (one command)
 
 ```bash
-npx skills add zeeshan8281/eigen-skills
+npm install eigen-skills
 ```
 
-This clones the skills into your agent's skill directory. The agent will auto-discover the `SKILL.md` files.
+That's it. The postinstall script automatically copies the `SKILL.md` into `.claude/skills/eigen/` — Claude Code discovers it instantly. Just set your API key:
 
-### For Programmatic Use (npm)
+```bash
+export EIGEN_API_KEY="your-key-here"
+```
+
+Then open Claude Code and ask anything about EigenLayer.
+
+### Alternative: curl (no npm)
 
 ```bash
-npm install eigen-skills
+mkdir -p .claude/skills/eigen
+curl -o .claude/skills/eigen/SKILL.md https://raw.githubusercontent.com/zeeshan8281/eigen-agent-skills/main/SKILL.md
 ```
 
+### For Programmatic Use (JavaScript)
+
 ```javascript
 const { EigenAPI, AVSAPI, RewardsAPI, DelegationAPI, EigenCompute, EigenDA } = require('eigen-skills');
 ```

package/SKILL.md

@@ -0,0 +1,328 @@
+---
+name: eigen-skills
+description: "Query live EigenLayer data — restaking, operators, AVS, rewards, delegation, stakers, TVL, deposits, withdrawals, EigenCompute TEE, and EigenDA blob storage via EigenExplorer API"
+version: 1.0.1
+metadata:
+  emoji: "🔄"
+  tags: ["eigenlayer", "restaking", "avs", "operators", "rewards", "delegation", "eigencompute", "eigenda"]
+user-invocable: true
+---
+
+# EigenLayer Skills for Claude Code
+
+One-command integration: drop this file into your project and Claude Code can query live EigenLayer data.
+
+## Setup
+
+```bash
+curl -o SKILL.md https://raw.githubusercontent.com/zeeshan8281/eigen-agent-skills/main/SKILL.md
+```
+
+Get a free API key at https://developer.eigenexplorer.com and set it:
+
+```bash
+export EIGEN_API_KEY="your-key-here"
+```
+
+## Data Source
+
+**EigenExplorer API** — `https://api.eigenexplorer.com`
+- Auth: `x-api-token` header
+- Testnet: `https://api-holesky.eigenexplorer.com`
+
+---
+
+## 1. Ecosystem Metrics
+
+Use when the user asks about EigenLayer stats, total TVL, total stakers, total operators, or an ecosystem overview.
+
+### Get ecosystem metrics
+```bash
+curl -s "https://api.eigenexplorer.com/metrics" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get historical TVL
+```bash
+curl -s "https://api.eigenexplorer.com/metrics/historical/tvl" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+---
+
+## 2. Operators
+
+Use when the user asks about EigenLayer operators, top operators, operator details, or operator search.
+
+### List operators (sorted by staker count)
+```bash
+curl -s "https://api.eigenexplorer.com/operators?withTvl=true&sortByTotalStakers=desc&take=10" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### List operators by TVL
+```bash
+curl -s "https://api.eigenexplorer.com/operators?withTvl=true&sortByTvl=desc&take=10" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### List operators by APY
+```bash
+curl -s "https://api.eigenexplorer.com/operators?withTvl=true&sortByApy=desc&take=10" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Search operators by name
+```bash
+curl -s "https://api.eigenexplorer.com/operators?searchByText=NAME&withTvl=true" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get a specific operator
+```bash
+curl -s "https://api.eigenexplorer.com/operators/0xOPERATOR_ADDRESS?withTvl=true" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get stakers delegating to an operator
+```bash
+curl -s "https://api.eigenexplorer.com/operators/0xOPERATOR_ADDRESS/stakers?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get all operator addresses (lightweight)
+```bash
+curl -s "https://api.eigenexplorer.com/operators/addresses" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+---
+
+## 3. Stakers
+
+Use when the user asks about a specific staker's position, deposits, withdrawals, or delegation.
+
+### Get staker info
+```bash
+curl -s "https://api.eigenexplorer.com/stakers/0xSTAKER_ADDRESS" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get staker deposits
+```bash
+curl -s "https://api.eigenexplorer.com/stakers/0xSTAKER_ADDRESS/deposits?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get staker withdrawals
+```bash
+curl -s "https://api.eigenexplorer.com/stakers/0xSTAKER_ADDRESS/withdrawals?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get staker rewards
+```bash
+curl -s "https://api.eigenexplorer.com/stakers/0xSTAKER_ADDRESS/rewards" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+---
+
+## 4. AVS (Actively Validated Services)
+
+Use when the user asks about AVS, which services exist, operators/stakers per AVS, or comparing AVS.
+
+### List all AVS (sorted by TVL)
+```bash
+curl -s "https://api.eigenexplorer.com/avs?withTvl=true&sortByTvl=desc&take=10" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### List AVS by APY
+```bash
+curl -s "https://api.eigenexplorer.com/avs?withTvl=true&sortByApy=desc&take=10" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Search AVS by name
+```bash
+curl -s "https://api.eigenexplorer.com/avs?searchByText=NAME&withTvl=true" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get a specific AVS
+```bash
+curl -s "https://api.eigenexplorer.com/avs/0xAVS_ADDRESS?withTvl=true" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get operators registered to an AVS
+```bash
+curl -s "https://api.eigenexplorer.com/avs/0xAVS_ADDRESS/operators?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get stakers for an AVS
+```bash
+curl -s "https://api.eigenexplorer.com/avs/0xAVS_ADDRESS/stakers?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get rewards distributed by an AVS
+```bash
+curl -s "https://api.eigenexplorer.com/avs/0xAVS_ADDRESS/rewards" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get registration events for an AVS
+```bash
+curl -s "https://api.eigenexplorer.com/avs/0xAVS_ADDRESS/events/registration?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get operator-sets for an AVS
+```bash
+curl -s "https://api.eigenexplorer.com/avs/0xAVS_ADDRESS/operator-sets?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+---
+
+## 5. Rewards & Yield
+
+Use when the user asks about rewards, APY, yield, best operators/AVS by returns, or how much a staker is earning.
+
+### Top operators by APY
+```bash
+curl -s "https://api.eigenexplorer.com/operators?withTvl=true&sortByApy=desc&take=10" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Top AVS by APY
+```bash
+curl -s "https://api.eigenexplorer.com/avs?withTvl=true&sortByApy=desc&take=10" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get rewards for a specific operator
+```bash
+curl -s "https://api.eigenexplorer.com/operators/0xOPERATOR_ADDRESS/rewards" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+---
+
+## 6. Deposits & Withdrawals (Global)
+
+Use when the user asks about recent deposits/withdrawals across the whole protocol.
+
+### Get recent deposits
+```bash
+curl -s "https://api.eigenexplorer.com/deposits?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get recent withdrawals
+```bash
+curl -s "https://api.eigenexplorer.com/withdrawals?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+---
+
+## 7. Delegation & Events
+
+Use when the user asks about delegation events, who is delegating to whom, or operator registration events.
+
+### Get delegation events
+```bash
+curl -s "https://api.eigenexplorer.com/events/delegation?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get operator registration events
+```bash
+curl -s "https://api.eigenexplorer.com/events/registration-status?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get all operator-sets
+```bash
+curl -s "https://api.eigenexplorer.com/operator-sets?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+---
+
+## 8. EigenCompute (TEE)
+
+Use when the user asks about deploying to EigenCompute, TEE, EigenCloud, attestation, or app management.
+
+**Requires:** `npm install -g @layr-labs/ecloud-cli`
+
+### Authentication
+```bash
+ecloud auth login
+ecloud auth whoami
+```
+
+### Deploy an app
+```bash
+ecloud compute app create --name my-app --language typescript
+ecloud compute app deploy
+```
+Always use **"Build and deploy from Dockerfile"** — deploy from registry is unreliable.
+
+### Manage apps
+```bash
+ecloud compute app list
+ecloud compute app info <APP_ID>
+ecloud compute app logs <APP_ID>
+ecloud compute app start <APP_ID>
+ecloud compute app stop <APP_ID>
+ecloud compute app terminate <APP_ID>
+ecloud compute app upgrade <APP_ID>
+```
+
+### Set sealed secrets
+```bash
+ecloud compute app env set MY_SECRET="value" API_KEY="key"
+```
+
+### TEE attestation
+Inside the TEE, the KMS signing key is at `/usr/local/bin/kms-signing-public-key.pem`. Verify at `https://verify-sepolia.eigencloud.xyz`.
+
+---
+
+## 9. EigenDA (Data Availability)
+
+Use when the user asks about storing/retrieving data on EigenDA, blob storage, or data availability.
+
+**Requires:** EigenDA Proxy running locally:
+```bash
+docker run -d --name eigenda-proxy -p 3100:3100 \
+  ghcr.io/layr-labs/eigenda-proxy:latest \
+  --eigenda.disperser-rpc=disperser-sepolia.eigenda.xyz:443 \
+  --eigenda.service-manager-addr=0xD4A7E1Bd8015057293f0D0A557088c286942e84b \
+  --eigenda.eth-rpc=YOUR_SEPOLIA_RPC_URL \
+  --eigenda.status-query-timeout=45s \
+  --eigenda.signer-private-key-hex=YOUR_PRIVATE_KEY \
+  --memstore.enabled=false --eigenda.disable-tls=false
+```
+
+### Store a blob
+```bash
+curl -s -X POST "http://127.0.0.1:3100/put?commitment_mode=standard" \
+  -H "Content-Type: application/json" \
+  -d '{"key": "value"}'
+```
+
+### Retrieve a blob
+```bash
+curl -s "http://127.0.0.1:3100/get/COMMITMENT_HASH?commitment_mode=standard"
+```
+
+### Health check
+```bash
+curl -s "http://127.0.0.1:3100/health"
+```
+
+### View blob on explorer
+```
+https://blobs-sepolia.eigenda.xyz/blobs/COMMITMENT_HASH
+```
+
+---
+
+## Query Parameters Reference
+
+| Parameter | Used On | Values | Description |
+|-----------|---------|--------|-------------|
+| `withTvl` | operators, avs | `true`/`false` | Include TVL calculations |
+| `sortByTvl` | operators, avs | `asc`/`desc` | Sort by TVL |
+| `sortByApy` | operators, avs | `asc`/`desc` | Sort by APY |
+| `sortByTotalStakers` | operators, avs | `asc`/`desc` | Sort by staker count |
+| `sortByTotalAvs` | operators | `asc`/`desc` | Sort by AVS count |
+| `searchByText` | operators, avs | string | Case-insensitive name search |
+| `skip` | all list endpoints | number | Pagination offset (default: 0) |
+| `take` | all list endpoints | number | Results per page (default: 12) |
+
+## Response Formatting
+
+When presenting results to users:
+- **Bold names** and abbreviate addresses (`0x1234...abcd`)
+- TVL in human-readable form ("$1.2B" not "1200000000")
+- APY as percentages ("4.2% APY")
+- Show staker counts and operator counts
+- Use bullet points, not tables
+- Flag high APY + low TVL as potentially risky

package/package.json

@@ -1,14 +1,16 @@
 {
     "name": "eigen-skills",
-    "version": "1.0.0",
+    "version": "1.1.1",
     "description": "Agent Skills for EigenLayer — restaking, AVS, operators, rewards, delegation data powered by EigenExplorer API",
     "main": "index.js",
     "agents": {
         "skills": "skills/"
     },
     "scripts": {
+        "postinstall": "node scripts/postinstall.js",
         "test": "node scripts/test-all.js",
-        "demo": "node scripts/demo.js"
+        "demo": "node scripts/demo.js",
+        "ui": "node server.js"
     },
     "keywords": [
         "eigenlayer",
@@ -24,6 +26,9 @@
     "author": "zeeshan8281",
     "license": "MIT",
     "dependencies": {
-        "axios": "^1.7.0"
+        "axios": "^1.7.0",
+        "dotenv": "^17.3.1",
+        "express": "^5.2.1",
+        "socket.io": "^4.8.3"
     }
-}
+}

package/scripts/postinstall.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+// Resolve symlinks to get the real path, then find the package root
+const scriptDir = fs.realpathSync(__dirname);
+const packageDir = path.resolve(scriptDir, '..');
+const src = path.join(packageDir, 'SKILL.md');
+
+if (!fs.existsSync(src)) {
+    process.exit(0);
+}
+
+// Walk up from the original __dirname (may be symlinked) to find project root
+// npm sets INIT_CWD to where `npm install` was run
+const projectRoot = process.env.INIT_CWD || path.resolve(packageDir, '..', '..');
+
+// Don't run if we're installing our own deps
+if (path.resolve(projectRoot) === path.resolve(packageDir)) {
+    process.exit(0);
+}
+
+if (!fs.existsSync(path.join(projectRoot, 'package.json'))) {
+    process.exit(0);
+}
+
+const destDir = path.join(projectRoot, '.claude', 'skills', 'eigen');
+const dest = path.join(destDir, 'SKILL.md');
+
+try {
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.copyFileSync(src, dest);
+    console.log('\n⚡ eigen-skills: SKILL.md installed to .claude/skills/eigen/');
+    console.log('  Claude Code can now query live EigenLayer data.');
+    console.log('  Set your API key: export EIGEN_API_KEY="your-key"\n');
+} catch (err) {
+    // Silent fail — don't break the user's install
+}

package/skills/eigen-avs/scripts/avs-api.js

@@ -102,26 +102,12 @@ class AVSAPI {
     // ─── AVS Registration Events ──────────────────────────
 
     /**
-     * Get registration events for a specific AVS.
+     * Get registration/deregistration events for a specific AVS.
      * @param {string} avsAddress
      * @param {object} opts
      */
     async getAVSRegistrationEvents(avsAddress, opts = {}) {
-        const { data } = await this.client.get(`/avs/${avsAddress}/events/registration`, {
-            params: { skip: opts.skip || 0, take: opts.take || 12 },
-        });
-        return data;
-    }
-
-    // ─── Operator-Sets per AVS ────────────────────────────
-
-    /**
-     * Get operator sets for a specific AVS.
-     * @param {string} avsAddress
-     * @param {object} opts
-     */
-    async getAVSOperatorSets(avsAddress, opts = {}) {
-        const { data } = await this.client.get(`/avs/${avsAddress}/operator-sets`, {
+        const { data } = await this.client.get(`/avs/${avsAddress}/events/registration-status`, {
             params: { skip: opts.skip || 0, take: opts.take || 12 },
         });
         return data;

package/skills/eigen-delegation/scripts/delegation-api.js

@@ -39,7 +39,7 @@ class DelegationAPI {
         };
         if (opts.type) params.type = opts.type;
 
-        const { data } = await this.client.get('/events', { params });
+        const { data } = await this.client.get('/events/delegation', { params });
         return data;
     }
 
@@ -64,64 +64,6 @@ class DelegationAPI {
         };
     }
 
-    /**
-     * Get all stakers delegating to a specific operator.
-     * @param {string} operatorAddress
-     * @param {object} opts
-     */
-    async getOperatorStakers(operatorAddress, opts = {}) {
-        const { data } = await this.client.get(`/operators/${operatorAddress}/stakers`, {
-            params: { skip: opts.skip || 0, take: opts.take || 12 },
-        });
-        return data;
-    }
-
-    // ─── Staker Delegation ────────────────────────────────
-
-    /**
-     * Get which operator a staker has delegated to and their position details.
-     * @param {string} stakerAddress
-     */
-    async getStakerDelegation(stakerAddress) {
-        const { data } = await this.client.get(`/stakers/${stakerAddress}`);
-        return data;
-    }
-
-    /**
-     * Get a staker's withdrawal history (partial/full undelegations).
-     * @param {string} stakerAddress
-     * @param {object} opts
-     */
-    async getStakerWithdrawals(stakerAddress, opts = {}) {
-        const { data } = await this.client.get(`/stakers/${stakerAddress}/withdrawals`, {
-            params: { skip: opts.skip || 0, take: opts.take || 12 },
-        });
-        return data;
-    }
-
-    // ─── Operator-Sets ────────────────────────────────────
-
-    /**
-     * Get all operator-sets (the new slashing-era grouping model).
-     * @param {object} opts
-     */
-    async getOperatorSets(opts = {}) {
-        const { data } = await this.client.get('/operator-sets', {
-            params: { skip: opts.skip || 0, take: opts.take || 12 },
-        });
-        return data;
-    }
-
-    /**
-     * Get a specific operator-set by AVS address + operatorSetId.
-     * @param {string} avsAddress
-     * @param {string} operatorSetId
-     */
-    async getOperatorSet(avsAddress, operatorSetId) {
-        const { data } = await this.client.get(`/operator-sets/${avsAddress}/${operatorSetId}`);
-        return data;
-    }
-
     // ─── Top Delegated Operators ──────────────────────────
 
     /**

package/skills/eigen-restaking/scripts/eigen-api.js

@@ -144,12 +144,11 @@ class EigenAPI {
     }
 
     /**
-     * Get historical metrics.
+     * Get historical TVL metrics.
      * @param {object} opts
-     * @param {string} [opts.frequency] - 'daily', 'weekly', etc.
      */
     async getHistoricalMetrics(opts = {}) {
-        const { data } = await this.client.get('/metrics/historical', {
+        const { data } = await this.client.get('/metrics/historical/tvl', {
             params: opts,
         });
         return data;
@@ -158,11 +157,22 @@ class EigenAPI {
     // ─── Events ───────────────────────────────────────────
 
     /**
-     * Get on-chain EigenLayer events.
+     * Get delegation events (shares increased/decreased, staker delegated/undelegated).
      * @param {object} opts
      */
-    async getEvents(opts = {}) {
-        const { data } = await this.client.get('/events', {
+    async getDelegationEvents(opts = {}) {
+        const { data } = await this.client.get('/events/delegation', {
+            params: { skip: opts.skip || 0, take: opts.take || 12 },
+        });
+        return data;
+    }
+
+    /**
+     * Get operator registration/deregistration events.
+     * @param {object} opts
+     */
+    async getRegistrationEvents(opts = {}) {
+        const { data } = await this.client.get('/events/registration-status', {
             params: { skip: opts.skip || 0, take: opts.take || 12 },
         });
         return data;

package/skills/eigen-rewards/scripts/rewards-api.js

@@ -23,46 +23,11 @@ class RewardsAPI {
         });
     }
 
-    // ─── Global Rewards ───────────────────────────────────
-
-    /**
-     * Get all rewards data.
-     * @param {object} opts
-     */
-    async getRewards(opts = {}) {
-        const { data } = await this.client.get('/rewards', {
-            params: { skip: opts.skip || 0, take: opts.take || 12 },
-        });
-        return data;
-    }
-
-    // ─── Operator Rewards ─────────────────────────────────
-
-    /**
-     * Get rewards info for a specific operator.
-     * Returns the reward strategies and tokens the operator receives.
-     * @param {string} operatorAddress
-     */
-    async getOperatorRewards(operatorAddress) {
-        const { data } = await this.client.get(`/operators/${operatorAddress}/rewards`);
-        return data;
-    }
-
-    // ─── Staker Rewards ───────────────────────────────────
-
-    /**
-     * Get staker rewards by address.
-     * @param {string} stakerAddress
-     */
-    async getStakerRewards(stakerAddress) {
-        const { data } = await this.client.get(`/stakers/${stakerAddress}/rewards`);
-        return data;
-    }
-
-    // ─── AVS Rewards ──────────────────────────────────────
+    // ─── AVS Rewards (only verified working rewards endpoint) ─────
 
     /**
      * Get rewards distributed by a specific AVS.
+     * Returns reward submission hashes, durations, tokens, and amounts.
      * @param {string} avsAddress
      */
     async getAVSRewards(avsAddress) {