eigen-skills 2.0.2 → 2.1.0

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

@@ -1,196 +0,0 @@
-/**
- * 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 TVL metrics.
-     * @param {object} opts
-     */
-    async getHistoricalMetrics(opts = {}) {
-        const { data } = await this.client.get('/metrics/historical/tvl', {
-            params: opts,
-        });
-        return data;
-    }
-
-    // ─── Events ───────────────────────────────────────────
-
-    /**
-     * Get delegation events (shares increased/decreased, staker delegated/undelegated).
-     * @param {object} opts
-     */
-    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;
-    }
-
-    // ─── 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

@@ -1,83 +0,0 @@
----
-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

@@ -1,73 +0,0 @@
-/**
- * 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,
-        });
-    }
-
-    // ─── 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) {
-        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;