eigen-skills 1.0.0

package/skills/eigen-restaking/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: eigen-restaking
+description: "Query EigenLayer restaking data — operators, stakers, TVL, deposits, withdrawals, and ecosystem metrics via EigenExplorer API"
+version: 1.0.0
+metadata:
+  emoji: "🔄"
+  tags: ["eigenlayer", "restaking", "operators", "tvl", "stakers"]
+user-invocable: true
+---
+
+# EigenLayer Restaking Skill
+
+Query live EigenLayer restaking data: operators, stakers, TVL, deposits, withdrawals, and ecosystem metrics.
+
+## Data Source
+
+**EigenExplorer API** — `https://api.eigenexplorer.com`
+- Auth: `x-api-token` header (free key at https://developer.eigenexplorer.com)
+- Holesky testnet: `https://api-holesky.eigenexplorer.com`
+
+## When to use this skill
+
+Use when the user asks about:
+- EigenLayer operators (who they are, how much TVL, how many stakers)
+- Restaking stats or metrics (total TVL, total stakers, total operators)
+- Individual staker positions (deposits, withdrawals, delegations)
+- Historical EigenLayer metrics
+- EigenLayer ecosystem overview
+
+## How to query
+
+Use the `exec` tool to curl the EigenExplorer API. **Always include your API key.**
+
+### Get ecosystem metrics
+```bash
+curl -s "https://api.eigenexplorer.com/metrics" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get top operators by TVL
+```bash
+curl -s "https://api.eigenexplorer.com/operators?withTvl=true&sortByTvl=desc&take=10" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Search operators by name
+```bash
+curl -s "https://api.eigenexplorer.com/operators?searchByText=p2p&withTvl=true" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get a specific operator
+```bash
+curl -s "https://api.eigenexplorer.com/operators/0x09e6eb09213bdd3698bd8afb43ec3cb0ecff683a?withTvl=true" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get staker info
+```bash
+curl -s "https://api.eigenexplorer.com/stakers/0xYOUR_STAKER_ADDRESS" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### 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"
+```
+
+### Get historical metrics
+```bash
+curl -s "https://api.eigenexplorer.com/metrics/historical" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+## Response Format
+
+Format results for the user with:
+- **Bold operator names** and addresses (abbreviated)
+- TVL in human-readable form (e.g., "$1.2B" not "1200000000")
+- Staker counts
+- APY where available
+- Use bullet points, never tables in chat
+
+## Programmatic Usage
+
+```javascript
+const EigenAPI = require('eigen-agent-skills/skills/eigen-restaking/scripts/eigen-api');
+const api = new EigenAPI('YOUR_API_KEY');
+
+const metrics = await api.getMetrics();
+const topOps = await api.getOperators({ sortByTvl: 'desc', take: 10 });
+const operator = await api.getOperator('0x...');
+```

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

@@ -0,0 +1,186 @@
+/**
+ * EigenLayer Restaking API Client
+ *
+ * Data source: EigenExplorer REST API (https://api.eigenexplorer.com)
+ * Auth: x-api-token header (free tier available at https://developer.eigenexplorer.com)
+ *
+ * Covers: operators, stakers, TVL, deposits, withdrawals
+ */
+
+const axios = require('axios');
+
+const MAINNET = 'https://api.eigenexplorer.com';
+const HOLESKY = 'https://api-holesky.eigenexplorer.com';
+
+class EigenAPI {
+    constructor(apiKey, { network = 'mainnet' } = {}) {
+        if (!apiKey) throw new Error('EigenExplorer API key required. Get one free at https://developer.eigenexplorer.com');
+        this.apiKey = apiKey;
+        this.baseUrl = network === 'holesky' ? HOLESKY : MAINNET;
+        this.client = axios.create({
+            baseURL: this.baseUrl,
+            headers: {
+                'x-api-token': this.apiKey,
+                'Content-Type': 'application/json',
+            },
+            timeout: 30000,
+        });
+    }
+
+    // ─── Operators ────────────────────────────────────────
+
+    /**
+     * Get all operators with optional filtering and sorting.
+     * @param {object} opts
+     * @param {boolean} [opts.withTvl=true] - include TVL calculations
+     * @param {string}  [opts.searchByText] - case-insensitive name search
+     * @param {'asc'|'desc'} [opts.sortByTvl] - sort by TVL
+     * @param {'asc'|'desc'} [opts.sortByApy] - sort by APY
+     * @param {'asc'|'desc'} [opts.sortByTotalStakers] - sort by staker count
+     * @param {number} [opts.skip=0]
+     * @param {number} [opts.take=12]
+     */
+    async getOperators(opts = {}) {
+        const params = {
+            withTvl: opts.withTvl !== false ? 'true' : 'false',
+            skip: opts.skip || 0,
+            take: opts.take || 12,
+        };
+        if (opts.searchByText) params.searchByText = opts.searchByText;
+        if (opts.sortByTvl) params.sortByTvl = opts.sortByTvl;
+        if (opts.sortByApy) params.sortByApy = opts.sortByApy;
+        if (opts.sortByTotalStakers) params.sortByTotalStakers = opts.sortByTotalStakers;
+        if (opts.sortByTotalAvs) params.sortByTotalAvs = opts.sortByTotalAvs;
+
+        const { data } = await this.client.get('/operators', { params });
+        return data;
+    }
+
+    /**
+     * Get a single operator by address.
+     * @param {string} address - operator ETH address
+     * @param {boolean} [withTvl=true]
+     */
+    async getOperator(address, withTvl = true) {
+        const { data } = await this.client.get(`/operators/${address}`, {
+            params: { withTvl: withTvl ? 'true' : 'false' },
+        });
+        return data;
+    }
+
+    /**
+     * Get all operator addresses (lightweight, no metadata).
+     */
+    async getOperatorAddresses() {
+        const { data } = await this.client.get('/operators/addresses');
+        return data;
+    }
+
+    // ─── Stakers ──────────────────────────────────────────
+
+    /**
+     * Get staker info by address.
+     * @param {string} address - staker wallet address
+     */
+    async getStaker(address) {
+        const { data } = await this.client.get(`/stakers/${address}`);
+        return data;
+    }
+
+    /**
+     * Get withdrawals for a staker.
+     * @param {string} address
+     * @param {object} opts
+     */
+    async getStakerWithdrawals(address, opts = {}) {
+        const { data } = await this.client.get(`/stakers/${address}/withdrawals`, {
+            params: { skip: opts.skip || 0, take: opts.take || 12 },
+        });
+        return data;
+    }
+
+    /**
+     * Get deposits for a staker.
+     * @param {string} address
+     * @param {object} opts
+     */
+    async getStakerDeposits(address, opts = {}) {
+        const { data } = await this.client.get(`/stakers/${address}/deposits`, {
+            params: { skip: opts.skip || 0, take: opts.take || 12 },
+        });
+        return data;
+    }
+
+    // ─── Deposits & Withdrawals (global) ──────────────────
+
+    /**
+     * Get all deposits.
+     */
+    async getDeposits(opts = {}) {
+        const { data } = await this.client.get('/deposits', {
+            params: { skip: opts.skip || 0, take: opts.take || 12 },
+        });
+        return data;
+    }
+
+    /**
+     * Get all withdrawals.
+     */
+    async getWithdrawals(opts = {}) {
+        const { data } = await this.client.get('/withdrawals', {
+            params: { skip: opts.skip || 0, take: opts.take || 12 },
+        });
+        return data;
+    }
+
+    // ─── Ecosystem Metrics ────────────────────────────────
+
+    /**
+     * Get ecosystem-wide metrics (total TVL, staker count, operator count, etc.)
+     */
+    async getMetrics() {
+        const { data } = await this.client.get('/metrics');
+        return data;
+    }
+
+    /**
+     * Get historical metrics.
+     * @param {object} opts
+     * @param {string} [opts.frequency] - 'daily', 'weekly', etc.
+     */
+    async getHistoricalMetrics(opts = {}) {
+        const { data } = await this.client.get('/metrics/historical', {
+            params: opts,
+        });
+        return data;
+    }
+
+    // ─── Events ───────────────────────────────────────────
+
+    /**
+     * Get on-chain EigenLayer events.
+     * @param {object} opts
+     */
+    async getEvents(opts = {}) {
+        const { data } = await this.client.get('/events', {
+            params: { skip: opts.skip || 0, take: opts.take || 12 },
+        });
+        return data;
+    }
+
+    // ─── Health ───────────────────────────────────────────
+
+    /**
+     * Health check — hit the metrics endpoint as a lightweight ping.
+     */
+    async healthCheck() {
+        try {
+            const { data } = await this.client.get('/metrics');
+            return { ok: true, tvl: data?.tvl?.tvl || data?.tvl };
+        } catch (err) {
+            return { ok: false, error: err.message };
+        }
+    }
+}
+
+module.exports = EigenAPI;

package/skills/eigen-rewards/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: eigen-rewards
+description: "Query EigenLayer rewards — operator rewards, staker rewards, AVS reward distributions, top yield operators and AVS"
+version: 1.0.0
+metadata:
+  emoji: "💰"
+  tags: ["eigenlayer", "rewards", "yield", "apy", "staking"]
+user-invocable: true
+---
+
+# EigenLayer Rewards Skill
+
+Query live rewards data from EigenLayer: operator rewards, staker rewards, AVS reward distributions, and find the best yield opportunities.
+
+## Data Source
+
+**EigenExplorer API** — `https://api.eigenexplorer.com`
+- Auth: `x-api-token` header (free key at https://developer.eigenexplorer.com)
+
+## When to use this skill
+
+Use when the user asks about:
+- EigenLayer rewards (operator or staker rewards)
+- Best yield / highest APY operators
+- Best yield / highest APY AVS
+- Reward tokens and strategies for an operator
+- How much a staker is earning
+- AVS reward distributions
+- Comparing restaking yields
+
+## How to query
+
+### Get 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"
+```
+
+### Get 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"
+```
+
+### Get rewards for a specific staker
+```bash
+curl -s "https://api.eigenexplorer.com/stakers/0xSTAKER_ADDRESS/rewards" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get rewards distributed by a specific AVS
+```bash
+curl -s "https://api.eigenexplorer.com/avs/0xAVS_ADDRESS/rewards" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+### Get all rewards data
+```bash
+curl -s "https://api.eigenexplorer.com/rewards?take=20" -H "x-api-token: $EIGEN_API_KEY"
+```
+
+## Response Format
+
+Format results for the user with:
+- **Bold operator/AVS names**
+- APY as a percentage (e.g., "4.2% APY")
+- Reward token names and amounts
+- TVL alongside APY for context (high APY + low TVL = be cautious)
+- Rank operators/AVS by APY when comparing yield
+- Use bullet points, never tables in chat
+
+## Programmatic Usage
+
+```javascript
+const RewardsAPI = require('eigen-agent-skills/skills/eigen-rewards/scripts/rewards-api');
+const api = new RewardsAPI('YOUR_API_KEY');
+
+const topOps = await api.getTopOperatorsByAPY(10);
+const topAVS = await api.getTopAVSByAPY(10);
+const opRewards = await api.getOperatorRewards('0x...');
+const stakerRewards = await api.getStakerRewards('0x...');
+```

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

@@ -0,0 +1,108 @@
+/**
+ * EigenLayer Rewards API Client
+ *
+ * Data source: EigenExplorer REST API
+ * Covers: rewards per operator, rewards per staker, reward strategies
+ */
+
+const axios = require('axios');
+
+const MAINNET = 'https://api.eigenexplorer.com';
+const HOLESKY = 'https://api-holesky.eigenexplorer.com';
+
+class RewardsAPI {
+    constructor(apiKey, { network = 'mainnet' } = {}) {
+        if (!apiKey) throw new Error('EigenExplorer API key required. Get one free at https://developer.eigenexplorer.com');
+        this.client = axios.create({
+            baseURL: network === 'holesky' ? HOLESKY : MAINNET,
+            headers: {
+                'x-api-token': apiKey,
+                'Content-Type': 'application/json',
+            },
+            timeout: 30000,
+        });
+    }
+
+    // ─── 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 ──────────────────────────────────────
+
+    /**
+     * Get rewards distributed by a specific AVS.
+     * @param {string} avsAddress
+     */
+    async getAVSRewards(avsAddress) {
+        const { data } = await this.client.get(`/avs/${avsAddress}/rewards`);
+        return data;
+    }
+
+    // ─── Convenience Queries ──────────────────────────────
+
+    /**
+     * Get the top operators sorted by APY (best yield first).
+     * @param {number} [limit=10]
+     */
+    async getTopOperatorsByAPY(limit = 10) {
+        const { data } = await this.client.get('/operators', {
+            params: {
+                withTvl: 'true',
+                sortByApy: 'desc',
+                take: limit,
+                skip: 0,
+            },
+        });
+        return data;
+    }
+
+    /**
+     * Get top AVS sorted by APY.
+     * @param {number} [limit=10]
+     */
+    async getTopAVSByAPY(limit = 10) {
+        const { data } = await this.client.get('/avs', {
+            params: {
+                withTvl: 'true',
+                sortByApy: 'desc',
+                take: limit,
+                skip: 0,
+            },
+        });
+        return data;
+    }
+}
+
+module.exports = RewardsAPI;