eigen-skills 2.0.2 → 2.0.3

package/README.md

@@ -1,424 +1,113 @@
 # 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)
+**EigenCompute Agent Skill — Deploy and manage apps in Trusted Execution Environments (TEE) with one command**
 
 ---
 
 ## What is this?
 
-**eigen-skills** is a modular skills package that gives any AI agent instant access to the full EigenLayer ecosystem. Inspired by the [Agent Skills specification](https://github.com/anthropics/skills), it follows the `SKILL.md` standard so agents like Claude Code, OpenClaw, or any compatible framework can discover and use these capabilities automatically.
+**eigen-skills** gives AI agents (Claude Code, OpenClaw, etc.) the ability to deploy and manage apps on [EigenCompute](https://eigencloud.xyz) — hardware-isolated TEEs powered by Intel TDX with encrypted secrets and cryptographic attestation.
 
 ```bash
-npx skills add zeeshan8281/eigen-skills
-```
-
-> Think of it like `npm install` but for AI agents — instead of code libraries, you're installing **knowledge and capabilities**.
-
----
-
-## Skills Overview
-
-| Skill | Emoji | Domain | Data Source |
-|-------|-------|--------|-------------|
-| [`eigen-restaking`](#eigen-restaking) | 🔄 | Operators, TVL, stakers, deposits, withdrawals | EigenExplorer API |
-| [`eigen-avs`](#eigen-avs) | 🛡️ | Actively Validated Services, registrations, operator-sets | EigenExplorer API |
-| [`eigen-rewards`](#eigen-rewards) | 💰 | Rewards, APY rankings, yield strategies | EigenExplorer API |
-| [`eigen-delegation`](#eigen-delegation) | 🤝 | Delegation events, staker positions, top operators | EigenExplorer API |
-| [`eigen-compute`](#eigen-compute) | 🔒 | TEE deployment, attestation, lifecycle management | EigenCompute (ecloud CLI) |
-| [`eigen-da`](#eigen-da) | 📦 | Blob storage & retrieval, data availability | EigenDA Proxy |
-
----
-
-## Architecture
-
-### How Agent Skills Work
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                        AI Agent                             │
-│  (Claude Code / OpenClaw / Any Agent Skills-compatible)     │
-│                                                             │
-│  1. User asks: "What are the top EigenLayer operators?"     │
-│  2. Agent scans installed skills/                           │
-│  3. Matches intent → eigen-restaking/SKILL.md              │
-│  4. Reads SKILL.md for instructions                        │
-│  5. Executes the appropriate curl/CLI command               │
-│  6. Formats and returns results                             │
-└──────────────┬──────────────────────────────────────────────┘
-               │
-               ▼
-┌──────────────────────────────────────────────────────────────┐
-│                     eigen-skills/                            │
-│                                                              │
-│  skills/                                                     │
-│  ├── eigen-restaking/                                        │
-│  │   ├── SKILL.md          ← Agent reads this               │
-│  │   └── scripts/                                            │
-│  │       └── eigen-api.js  ← JS client (optional)           │
-│  ├── eigen-avs/                                              │
-│  ├── eigen-rewards/                                          │
-│  ├── eigen-delegation/                                       │
-│  ├── eigen-compute/                                          │
-│  └── eigen-da/                                               │
-└──────────────┬──────────────────────────────────────────────┘
-               │
-               ▼
-┌──────────────────────────────────────────────────────────────┐
-│                   EigenLayer Ecosystem                        │
-│                                                              │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐       │
-│  │ EigenExplorer │  │ EigenCompute │  │   EigenDA    │       │
-│  │   REST API   │  │  (ecloud CLI)│  │   (Proxy)    │       │
-│  │              │  │              │  │              │       │
-│  │  Operators   │  │  TEE Deploy  │  │  Blob Store  │       │
-│  │  AVS         │  │  Attestation │  │  Blob Get    │       │
-│  │  Stakers     │  │  KMS Signing │  │  KZG Verify  │       │
-│  │  Rewards     │  │  Lifecycle   │  │  Commitment  │       │
-│  │  Events      │  │  Monitoring  │  │  Explorer    │       │
-│  └──────────────┘  └──────────────┘  └──────────────┘       │
-│         │                  │                  │               │
-│         ▼                  ▼                  ▼               │
-│  ┌─────────────────────────────────────────────────┐         │
-│  │           EigenLayer Protocol (L1)              │         │
-│  │  DelegationManager · StrategyManager · AVSDir   │         │
-│  │  AllocationManager · RewardsCoordinator         │         │
-│  └─────────────────────────────────────────────────┘         │
-└──────────────────────────────────────────────────────────────┘
+npm install -g eigen-skills@latest
 ```
 
-### Data Flow
-
-```
-                    ┌─────────────────┐
-                    │    User Query   │
-                    │ "top operators" │
-                    └────────┬────────┘
-                             │
-                    ┌────────▼────────┐
-                    │   AI Agent      │
-                    │   reads SKILL.md│
-                    └────────┬────────┘
-                             │
-              ┌──────────────┼──────────────┐
-              │              │              │
-     ┌────────▼─────┐ ┌─────▼──────┐ ┌─────▼──────┐
-     │  REST API    │ │ ecloud CLI │ │ DA Proxy   │
-     │  (curl)      │ │ (shell)    │ │ (curl)     │
-     └────────┬─────┘ └─────┬──────┘ └─────┬──────┘
-              │              │              │
-     ┌────────▼─────┐ ┌─────▼──────┐ ┌─────▼──────┐
-     │ EigenExplorer│ │ EigenCloud │ │  EigenDA   │
-     │   Mainnet    │ │   TEE      │ │  Network   │
-     └──────────────┘ └────────────┘ └────────────┘
-```
+> Install once, then any compatible AI agent can deploy to EigenCompute automatically via the `SKILL.md` standard.
 
 ---
 
-## Installation
-
-### For Claude Code (one command)
-
-```bash
-npm install eigen-skills
-```
-
-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:
-
-```bash
-export EIGEN_API_KEY="your-key-here"
-```
-
-Then open Claude Code and ask anything about EigenLayer.
-
-### Alternative: curl (no npm)
+## Setup
 
 ```bash
-mkdir -p .claude/skills/eigen
-curl -o .claude/skills/eigen/SKILL.md https://raw.githubusercontent.com/zeeshan8281/eigen-agent-skills/main/SKILL.md
-```
-
-### As an MCP Server (Claude Desktop, Cursor, Windsurf, Claude Code)
-
-Install the separate [`eigen-mcp`](https://www.npmjs.com/package/eigen-mcp) package for MCP support — all 21 tools, no SKILL.md files or curl needed:
-
-```bash
-npm install -g eigen-mcp
+npm install -g @layr-labs/ecloud-cli@latest   # minimum v0.4.3
+ecloud auth login
+ecloud auth whoami
 ```
 
-See the [eigen-mcp README](https://www.npmjs.com/package/eigen-mcp) for config examples for Claude Desktop, Cursor, Windsurf, and Claude Code.
-
-### For Programmatic Use (JavaScript)
-
-```javascript
-const { EigenAPI, AVSAPI, RewardsAPI, DelegationAPI, EigenCompute, EigenDA } = require('eigen-skills');
-```
+**CRITICAL:** CLI v0.4.3+ is required. Older versions have broken ITA attestation metadata causing deploy failures on all instance types.
 
 ---
 
-## Prerequisites
-
-### Data Skills (restaking, AVS, rewards, delegation)
-
-| Requirement | How to Get |
-|-------------|-----------|
-| EigenExplorer API Key | Free at [developer.eigenexplorer.com](https://developer.eigenexplorer.com) |
-| Set env var | `export EIGEN_API_KEY=your_key` |
-
-### EigenCompute Skill
-
-| Requirement | How to Get |
-|-------------|-----------|
-| ecloud CLI | `npm install -g @layr-labs/ecloud-cli` |
-| Auth | `ecloud auth login` or `ecloud auth generate --store` |
+## Instance Types
 
-### EigenDA Skill
-
-| Requirement | How to Get |
-|-------------|-----------|
-| EigenDA Proxy | See [EigenDA Proxy Setup](#eigenda-proxy-setup) below |
-| Ethereum RPC | Any Sepolia RPC endpoint |
+| Type | vCPUs | Memory | TEE | Notes |
+|------|-------|--------|-----|-------|
+| g1-micro-1v | 2 shared | 1 GB | Shielded VM | Cheapest, attestation can be flaky |
+| g1-medium-1v | 2 shared | 4 GB | Shielded VM | |
+| g1-custom-2-4096s | 2 | 4 GB | SEV-SNP | |
+| g1-standard-2s | 2 | 8 GB | SEV-SNP | |
+| g1-standard-4t | 4 | 16 GB | TDX | **Recommended — most reliable** |
+| g1-standard-8t | 8 | 32 GB | TDX | |
 
 ---
 
-## Usage
+## Deploy (Non-Interactive, Agent-Friendly)
 
-### Agent Usage (SKILL.md driven)
+`ecloud compute app deploy` has 6+ interactive prompts. Use the full flag set for CI/agent contexts:
 
-When an agent has eigen-skills installed, it reads the `SKILL.md` files to know what to do:
+### Step 1: Build & push Docker image (must be linux/amd64)
 
-**User:** "What are the top EigenLayer operators by TVL?"
-**Agent reads:** `skills/eigen-restaking/SKILL.md`
-**Agent runs:**
 ```bash
-curl -s "https://api.eigenexplorer.com/operators?withTvl=true&sortByTvl=desc&take=10" \
-  -H "x-api-token: $EIGEN_API_KEY"
+docker build --platform linux/amd64 -t <registry/image:tag> .
+docker push <registry/image:tag>
 ```
-**Agent formats:** Bold names, TVL in human-readable form, staker counts.
 
----
+### Step 2: Deploy
 
-**User:** "Deploy my Dockerfile to EigenCompute"
-**Agent reads:** `skills/eigen-compute/SKILL.md`
-**Agent runs:**
 ```bash
-ecloud compute app deploy
-# Selects "Build and deploy from Dockerfile"
-# Selects Linux/AMD64
-```
-
----
+# Remove Dockerfile to avoid "Choose deployment method" prompt
+rm -f Dockerfile
+touch .env  # create empty .env if no secrets
 
-**User:** "Store this verification proof on EigenDA"
-**Agent reads:** `skills/eigen-da/SKILL.md`
-**Agent runs:**
-```bash
-curl -s -X POST "http://127.0.0.1:3100/put?commitment_mode=standard" \
-  -H "Content-Type: application/json" \
-  -d '{"verified": true, "model": "gpt-oss-120b", "timestamp": "2025-01-01"}'
+echo "n" | ecloud compute app deploy \
+  --name <app-name> \
+  --image-ref <registry/image:tag> \
+  --skip-profile \
+  --env-file .env \
+  --instance-type g1-standard-4t \
+  --log-visibility public \
+  --resource-usage-monitoring enable \
+  --verbose
 ```
 
-### Programmatic Usage (JavaScript)
-
-```javascript
-const { EigenAPI, AVSAPI, RewardsAPI, DelegationAPI, EigenCompute, EigenDA } = require('eigen-skills');
-
-// ─── Restaking Data ─────────────────────────────────
-const eigen = new EigenAPI(process.env.EIGEN_API_KEY);
-
-// Ecosystem overview
-const metrics = await eigen.getMetrics();
-console.log(`Total TVL: ${metrics.tvl}`);
-console.log(`Operators: ${metrics.totalOperators}`);
-console.log(`Stakers: ${metrics.totalStakers}`);
-
-// Top operators
-const ops = await eigen.getOperators({ sortByTvl: 'desc', take: 5 });
-ops.data.forEach(op => {
-  console.log(`${op.metadataName} — TVL: ${op.tvl?.tvl} — Stakers: ${op.totalStakers}`);
-});
-
-// ─── AVS Data ───────────────────────────────────────
-const avs = new AVSAPI(process.env.EIGEN_API_KEY);
-
-// All services
-const services = await avs.getAllAVS({ sortByTvl: 'desc', take: 10 });
-
-// Operators securing a specific AVS
-const avsOps = await avs.getAVSOperators('0xAVS_ADDRESS');
-
-// ─── Rewards & Yield ────────────────────────────────
-const rewards = new RewardsAPI(process.env.EIGEN_API_KEY);
-
-// Best yield operators
-const topYield = await rewards.getTopOperatorsByAPY(10);
-
-// Rewards for a specific operator
-const opRewards = await rewards.getOperatorRewards('0xOPERATOR');
+### Dockerfile Requirements
 
-// ─── Delegation ─────────────────────────────────────
-const delegation = new DelegationAPI(process.env.EIGEN_API_KEY);
-
-// Most delegated operators
-const topDelegated = await delegation.getTopDelegatedOperators(10);
-
-// Staker's delegation position
-const stakerInfo = await delegation.getStakerDelegation('0xSTAKER');
-
-// ─── TEE Compute ────────────────────────────────────
-const compute = new EigenCompute();
-
-// Check if running inside TEE
-const health = compute.healthCheck();
-console.log(`Inside TEE: ${health.insideTEE}`);
-
-// Collect attestation (inside TEE container)
-const attestation = compute.collectAttestation();
-console.log(`App ID: ${attestation.appId}`);
-console.log(`KMS Key: ${attestation.kmsKeyFingerprint}`);
-
-// ─── Data Availability ──────────────────────────────
-const da = new EigenDA();
-
-// Store data
-const commitment = await da.store({
-  proof: { verified: true, model: 'gpt-oss-120b' },
-  timestamp: new Date().toISOString(),
-});
-console.log(`Stored! Commitment: ${commitment}`);
-console.log(`Explorer: ${da.getExplorerUrl(commitment)}`);
-
-// Retrieve data
-const data = await da.retrieve(commitment);
-console.log(`Retrieved:`, data);
-```
+- Use `EXPOSE <port>` to declare your port
+- App must listen on `0.0.0.0`, not `localhost`
+- EigenCompute wraps your CMD with `compute-source-env.sh` entrypoint — do NOT set your own ENTRYPOINT to source it manually
 
 ---
 
-## Detailed Skill Reference
-
-### eigen-restaking
-
-🔄 **Query EigenLayer restaking data**
+## Manage Apps
 
-```
-Operators ←→ Stakers ←→ Strategies ←→ TVL
-     │
-     └── Deposits / Withdrawals / Events
-```
-
-**Key endpoints:**
-
-| Method | What |
-|--------|------|
-| `getMetrics()` | Ecosystem-wide TVL, operator count, staker count |
-| `getOperators(opts)` | List operators with sorting/filtering |
-| `getOperator(address)` | Single operator detail |
-| `getStaker(address)` | Staker info and positions |
-| `getDeposits()` | Recent deposit events |
-| `getWithdrawals()` | Recent withdrawal events |
-| `getHistoricalMetrics()` | TVL over time |
-
-**Example queries:**
 ```bash
-# Top 10 operators by TVL
-curl -s "https://api.eigenexplorer.com/operators?withTvl=true&sortByTvl=desc&take=10" \
-  -H "x-api-token: $EIGEN_API_KEY"
-
-# Search operator by name
-curl -s "https://api.eigenexplorer.com/operators?searchByText=p2p&withTvl=true" \
-  -H "x-api-token: $EIGEN_API_KEY"
-
-# Staker position
-curl -s "https://api.eigenexplorer.com/stakers/0xADDRESS" \
-  -H "x-api-token: $EIGEN_API_KEY"
+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 upgrade <APP_ID>
 ```
 
----
-
-### eigen-avs
+### Terminate (interactive confirm — pipe "y")
 
-🛡️ **Query Actively Validated Services**
-
-```
-AVS (Service)
- ├── Operators (securing it)
- ├── Stakers (delegated via operators)
- ├── Registration Events
- └── Operator-Sets (slashing-era grouping)
+```bash
+echo "y" | ecloud compute app terminate <APP_ID>
 ```
 
-**Key endpoints:**
-
-| Method | What |
-|--------|------|
-| `getAllAVS(opts)` | List all AVS with sorting/filtering |
-| `getAVS(address)` | Single AVS detail |
-| `getAVSOperators(address)` | Operators registered to an AVS |
-| `getAVSStakers(address)` | Stakers delegated to an AVS |
-| `getAVSRegistrationEvents(address)` | Registration/deregistration events |
-| `getAVSOperatorSets(address)` | Operator-sets for an AVS |
-
 ---
 
-### eigen-rewards
-
-💰 **Query rewards and yield data**
-
-```
-AVS distributes rewards
-        │
-        ▼
-   ┌─────────┐
-   │ Operator │ ← takes fee (0-100%)
-   └────┬────┘
-        │
-        ▼
-   ┌─────────┐
-   │ Staker  │ ← receives remaining rewards
-   └─────────┘
-```
-
-**Key endpoints:**
+## Sealed Secrets
 
-| Method | What |
-|--------|------|
-| `getTopOperatorsByAPY(limit)` | Best yield operators |
-| `getTopAVSByAPY(limit)` | Best yield AVS |
-| `getOperatorRewards(address)` | Reward strategies for an operator |
-| `getStakerRewards(address)` | Rewards earned by a staker |
-| `getAVSRewards(address)` | Rewards distributed by an AVS |
-
----
-
-### eigen-delegation
-
-🤝 **Query delegation relationships**
-
-```
-Staker ──delegates──▶ Operator ──registers──▶ AVS
-  │                       │
-  └── withdrawals         └── operator-sets
+```bash
+ecloud compute app env set MY_SECRET="value" API_KEY="key"
 ```
 
-**Key endpoints:**
-
-| Method | What |
-|--------|------|
-| `getTopDelegatedOperators(limit)` | Most delegated by staker count |
-| `getTopOperatorsByTVL(limit)` | Most capital delegated |
-| `getOperatorDelegation(address)` | Operator's full delegation profile |
-| `getOperatorStakers(address)` | Stakers delegating to an operator |
-| `getStakerDelegation(address)` | Which operator a staker is delegated to |
-| `getDelegationEvents()` | Recent delegation/undelegation events |
-| `getOperatorSets()` | Operator-sets (slashing-era model) |
+Secrets are encrypted and only decryptable inside the TEE via KMS attestation. At boot, `compute-source-env.sh` fetches them and writes to `/tmp/.env`.
 
 ---
 
-### eigen-compute
-
-🔒 **Deploy and manage TEE applications**
+## TEE Internals
 
 ```
 ┌─────────────────────────────────────────┐
@@ -431,7 +120,6 @@ Staker ──delegates──▶ Operator ──registers──▶ AVS
 │  │  • Encrypted memory             │    │
 │  │  • Sealed secrets               │    │
 │  │  • KMS signing key              │    │
-│  │  • Unique wallet identity       │    │
 │  │  • Cryptographic attestation    │    │
 │  └─────────────────────────────────┘    │
 │                                         │
@@ -442,314 +130,36 @@ Staker ──delegates──▶ Operator ──registers──▶ AVS
 └─────────────────────────────────────────┘
 ```
 
-**Lifecycle:**
-
-```
-ecloud auth login
-       │
-       ▼
-ecloud compute app deploy    ← builds Dockerfile in TEE
-       │
-       ▼
-ecloud compute app list      ← check status + IP
-       │
-       ▼
-ecloud compute app logs <id> ← view logs
-       │
-       ▼
-ecloud compute app stop <id> ← pause
-       │
-       ▼
-ecloud compute app terminate <id> ← permanent destroy
-```
-
-**Key methods:**
-
-| Method | What |
-|--------|------|
-| `whoami()` | Check authenticated address |
-| `listApps()` | List all deployed apps |
-| `getAppInfo(id)` | App status and details |
-| `getAppLogs(id)` | View app logs |
-| `startApp(id)` / `stopApp(id)` | Lifecycle control |
-| `collectAttestation()` | Gather TEE attestation data |
-| `computeConfigHash(files)` | Hash config files for integrity proof |
-
-**Known issues:** See [Troubleshooting](#troubleshooting).
-
----
-
-### eigen-da
-
-📦 **Store and retrieve data blobs**
-
-```
-Your App ──POST /put──▶ EigenDA Proxy ──disperse──▶ EigenDA Network
-                              │                         │
-                         commitment                KZG commitment
-                              │                    stored on-chain
-                              ▼
-                        ┌──────────┐
-                        │ Explorer │
-                        │ blobs-   │
-                        │ sepolia. │
-                        │eigenda.  │
-                        │ xyz      │
-                        └──────────┘
-
-Your App ──GET /get/X──▶ EigenDA Proxy ──retrieve──▶ EigenDA Network
-                              │
-                         original data
-```
-
-**Proxy endpoints:**
-
-| Endpoint | Method | What |
-|----------|--------|------|
-| `/put?commitment_mode=standard` | POST | Store a blob, returns commitment |
-| `/get/<commitment>?commitment_mode=standard` | GET | Retrieve a blob by commitment |
-| `/health` | GET | Proxy health check |
-
-**Key methods:**
-
-| Method | What |
-|--------|------|
-| `store(data)` | Store JSON on EigenDA, returns commitment |
-| `retrieve(commitment)` | Retrieve JSON by commitment |
-| `getExplorerUrl(commitment)` | Get blob explorer URL |
-| `healthCheck()` | Check proxy availability |
-
-**Networks:**
-
-| Network | Disperser RPC | Service Manager |
-|---------|---------------|-----------------|
-| Sepolia | `disperser-sepolia.eigenda.xyz:443` | `0xD4A7E1Bd8015057293f0D0A557088c286942e84b` |
-| Mainnet | `disperser.eigenda.xyz:443` | See EigenLayer docs |
-
-### EigenDA Proxy Setup
-
-```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
-```
-
----
-
-## API Reference
-
-### Constructor Options
-
-#### EigenAPI / AVSAPI / RewardsAPI / DelegationAPI
-
-```javascript
-new EigenAPI(apiKey, { network: 'mainnet' | 'holesky' })
-```
-
-| Param | Type | Default | Description |
-|-------|------|---------|-------------|
-| `apiKey` | string | **required** | EigenExplorer API key |
-| `network` | string | `'mainnet'` | `'mainnet'` or `'holesky'` |
-
-#### EigenDA
-
-```javascript
-new EigenDA({ proxyUrl, commitmentMode, timeout })
-```
-
-| Param | Type | Default | Description |
-|-------|------|---------|-------------|
-| `proxyUrl` | string | `'http://127.0.0.1:3100'` | EigenDA proxy URL |
-| `commitmentMode` | string | `'standard'` | `'standard'` or `'optimistic'` |
-| `timeout` | number | `60000` | Request timeout in ms |
+| Path | What |
+|------|------|
+| `/usr/local/bin/compute-source-env.sh` | Entrypoint — fetches secrets, then runs your CMD |
+| `/usr/local/bin/kms-signing-public-key.pem` | KMS signing public key |
+| `/usr/local/bin/kms-client` | KMS client binary |
 
-#### EigenCompute
-
-```javascript
-new EigenCompute()  // No args — wraps ecloud CLI
-```
-
-### Pagination
-
-All list endpoints support pagination:
-
-```javascript
-const results = await eigen.getOperators({
-  skip: 0,     // offset
-  take: 12,    // page size (default: 12)
-  sortByTvl: 'desc',
-});
-
-console.log(results.meta.total);  // total records
-console.log(results.meta.skip);   // current offset
-console.log(results.meta.take);   // page size
-```
-
-### Sorting Options
-
-| Parameter | Valid Values | Available On |
-|-----------|-------------|-------------|
-| `sortByTvl` | `'asc'` / `'desc'` | Operators, AVS |
-| `sortByApy` | `'asc'` / `'desc'` | Operators, AVS |
-| `sortByTotalStakers` | `'asc'` / `'desc'` | Operators, AVS |
-| `sortByTotalAvs` | `'asc'` / `'desc'` | Operators |
-| `searchByText` | any string | Operators, AVS |
-| `withTvl` | `true` / `false` | Operators, AVS |
-
----
-
-## Environment Variables
-
-| Variable | Required For | Description |
-|----------|-------------|-------------|
-| `EIGEN_API_KEY` | Data skills | EigenExplorer API key |
-| `EIGENDA_PROXY_URL` | eigen-da | Proxy URL (default: `http://127.0.0.1:3100`) |
-| `EIGENDA_COMMITMENT_MODE` | eigen-da | `standard` or `optimistic` |
-| `EIGENDA_TIMEOUT` | eigen-da | Timeout in ms (default: `60000`) |
-| `ECLOUD_APP_ID` | eigen-compute | Auto-set inside TEE |
-
----
-
-## Demo
-
-Run the interactive demo to verify all data skills work:
-
-```bash
-EIGEN_API_KEY=your_key npm run demo
-```
-
-Sample output:
-```
-🔄 Eigen Agent Skills — Demo
-
-📡 Health check...
-   Status: ✅ Healthy
-   EigenLayer TVL: 4,754,266
-
-👥 Top 5 Operators by TVL:
-  1. EigenYields — Stakers: 25,700 — AVS: 32
-  2. AltLayer — Stakers: 21,826 — AVS: 14
-  3. InfStones — Stakers: 21,617 — AVS: 11
-
-🛡️ Top 5 AVS:
-  1. Brevis coChain AVS
-  2. DIN
-  3. Renzo wBTC DVN
-
-💰 Top 5 by APY:
-  1. EigenYields — APY: 484.3%
-  2. Nodes.Guru — APY: 484.3%
-
-✅ All skills working!
-```
+Verify your app: `https://verify-sepolia.eigencloud.xyz/app/<APP_ID>`
 
 ---
 
 ## Troubleshooting
 
-### Data Skills (EigenExplorer)
-
-| Issue | Fix |
-|-------|-----|
-| `401 Unauthorized` | Check your `EIGEN_API_KEY` is set correctly |
-| Timeout on `withTvl=true` | TVL calculations are expensive — set `withTvl=false` for faster queries, or increase timeout |
-| Rate limited | EigenExplorer has rate limits on the free tier — add delays between requests |
-
-### EigenCompute
-
-| Issue | Fix |
-|-------|-----|
-| `ecloud: command not found` | Run `npm install -g @layr-labs/ecloud-cli` |
-| App stuck in `Status: Unknown` | Use "Build from Dockerfile" method instead of "Deploy from registry" |
-| `app logs` returns 403 | Known issue — add HTTP logging endpoint in your app as workaround |
-| 429 rate limiting after deploy | Wait 30-60 seconds before running `app list` or `app info` |
-| IP changes on every deploy | No static IP available — use DNS/webhook updates in your entrypoint |
-
-### EigenDA
-
-| Issue | Fix |
-|-------|-----|
-| `ECONNREFUSED 127.0.0.1:3100` | Start the EigenDA proxy Docker container |
-| Store timeout | Increase `EIGENDA_TIMEOUT` — dispersal can take 30-60s |
-| Invalid commitment | Ensure `commitment_mode` matches between store and retrieve |
+| Symptom | Cause | Fix |
+|---------|-------|-----|
+| `no ITA verifier client present` | CLI too old (< v0.4.3) | `sudo npm install -g @layr-labs/ecloud-cli@latest` |
+| `failed to quote: error code 0x15` | CLI too old or flaky Shielded VM | Update CLI, use `g1-standard-4t` |
+| `No space left on device` during layering | Docker disk full | `docker system prune -f && docker builder prune -f` |
+| "Choose deployment method" prompt hangs | Dockerfile present in deploy dir | `rm -f Dockerfile` before deploying |
+| App "Running" but port refuses connections | Attestation failed, app never started | Check `ecloud compute app logs <APP_ID>` |
+| IP changes on every deploy | Expected behavior | Don't hardcode IPs |
+| App ID changes on terminate + redeploy | Expected behavior | No persistent identity across deploys |
 
 ---
 
-## Project Structure
+## Scaffold a New App (Optional)
 
+```bash
+ecloud compute app create --name my-app --language typescript --template-repo minimal
+# Languages: typescript, python, golang, rust
 ```
-eigen-skills/
-├── package.json                  # npm package with "agents" field
-├── index.js                      # programmatic entry point (all 6 modules)
-├── README.md                     # this file
-├── .gitignore
-├── .npmignore
-├── scripts/
-│   └── demo.js                   # interactive demo
-└── skills/
-    ├── eigen-restaking/          # 🔄 Operators, TVL, stakers
-    │   ├── SKILL.md              #    agent instructions
-    │   └── scripts/
-    │       └── eigen-api.js      #    JS API client
-    │
-    ├── eigen-avs/                # 🛡️ Actively Validated Services
-    │   ├── SKILL.md
-    │   └── scripts/
-    │       └── avs-api.js
-    │
-    ├── eigen-rewards/            # 💰 Rewards & APY
-    │   ├── SKILL.md
-    │   └── scripts/
-    │       └── rewards-api.js
-    │
-    ├── eigen-delegation/         # 🤝 Delegation & operator-sets
-    │   ├── SKILL.md
-    │   └── scripts/
-    │       └── delegation-api.js
-    │
-    ├── eigen-compute/            # 🔒 TEE deployment & attestation
-    │   ├── SKILL.md
-    │   └── scripts/
-    │       └── compute-api.js
-    │
-    └── eigen-da/                 # 📦 Blob storage & data availability
-        ├── SKILL.md
-        └── scripts/
-            └── da-api.js
-```
-
----
-
-## How It Compares
-
-| Feature | eigen-skills | Manual curl | Custom SDK |
-|---------|-------------|-------------|------------|
-| Agent-compatible | ✅ SKILL.md standard | ❌ | ❌ |
-| Zero config | ✅ just add API key | ✅ | ❌ needs setup |
-| Covers restaking data | ✅ | ✅ manual | ✅ |
-| Covers TEE compute | ✅ | ❌ need CLI | ❌ |
-| Covers data availability | ✅ | ✅ manual | ❌ |
-| Programmatic JS API | ✅ | ❌ | ✅ |
-| Works with Claude/OpenClaw | ✅ auto-discovered | ❌ | ❌ |
-
----
-
-## Contributing
-
-1. Fork the repo
-2. Create a new skill directory under `skills/`
-3. Add a `SKILL.md` following the [Agent Skills spec](https://github.com/anthropics/skills)
-4. Add scripts in `scripts/` for programmatic use
-5. Update `index.js` to export the new module
-6. PR it
 
 ---
 
@@ -760,5 +170,5 @@ MIT
 ---
 
 <p align="center">
-  Built with data from <a href="https://eigenexplorer.com">EigenExplorer</a>, <a href="https://eigencloud.xyz">EigenCloud</a>, and <a href="https://docs.eigenlayer.xyz">EigenDA</a>
+  Built for <a href="https://eigencloud.xyz">EigenCompute</a> TEE
 </p>

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "eigen-skills",
-    "version": "2.0.2",
+    "version": "2.0.3",
     "description": "Deploy and manage apps on EigenCompute TEE — trusted execution environments with hardware-level isolation, encrypted secrets, and attestation",
     "main": "index.js",
     "agents": {