gekko-yield

# Gekko Yield — Earn safe yield on USDC

Earn yield on USDC via the Moonwell Flagship USDC vault on Base.

**Vault:** `0xc1256Ae5FF1cf2719D4937adb3bbCCab2E00A2Ca`  
**Chain:** Base (8453)  
**Asset:** USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)

## Why This Vault?

The Moonwell Flagship USDC vault is one of the **safest places to earn yield on Base**:

- **Powers Coinbase** — Provides $20M+ liquidity to Coinbase's BTC/ETH borrow products
- **Blue-chip collateral only** — Loans backed by ETH, cbETH, wstETH, cbBTC
- **Conservative LTV ratios** — Healthy collateral requirements
- **Isolated markets** — Risk is compartmentalized
- **Battle-tested** — Morpho's codebase is <650 lines, immutable, extensively audited
- **Multi-layer governance** — Moonwell DAO + Block Analitica/B.Protocol curators

### Current APY (~4-6%)

| Component | APY | Source |
|-----------|-----|--------|
| Base yield | ~4-5% | Borrower interest |
| Rewards | ~0.5-1% | WELL + MORPHO via Merkl |
| **Total** | **~4.5-6%** | Sustainable, from real demand |

Yields come from real borrowing demand, not unsustainable emissions.

## Quick Start

```bash
cd gekko-yield/scripts
pnpm install  # or npm install
npx tsx setup.ts
```

The setup wizard will:
1. Guide you to set your private key as environment variable
2. Save configuration to `~/.config/gekko-yield/config.json`

## Commands

### Interactive Setup

```bash
npx tsx setup.ts
```

Guides you through wallet configuration.

### Check Position & APY

```bash
npx tsx status.ts
```

Returns: current deposit, vault shares, APY, wallet balances, estimated earnings.

### Generate Report

```bash
# Telegram/Discord format (default)
npx tsx report.ts

# JSON format (for automation)
npx tsx report.ts --json

# Plain text
npx tsx report.ts --plain
```

### Deposit USDC

```bash
npx tsx deposit.ts <amount>
# Example: deposit 100 USDC
npx tsx deposit.ts 100
```

Deposits USDC in...

# 🦎 Gekko Yield — Earn Safe Yield on USDC

Automated yield farming on Base. Deposit USDC, earn ~4-6% APY, auto-compound rewards.

## 🚀 Quick Start

```bash
# 1. Install dependencies
cd gekko-yield/scripts
pnpm install

# 2. Setup wallet (first time only)
npx tsx setup.ts

# 3. Check your position
npx tsx status.ts

# 4. Deposit USDC
npx tsx deposit.ts 100

# 5. Generate report
npx tsx report.ts

# 6. Auto-compound rewards
npx tsx compound.ts
```

## 📋 All Commands

### Setup (First Time)
```bash
npx tsx setup.ts
```

### Check Position
```bash
npx tsx status.ts
```

### Deposit USDC
```bash
npx tsx deposit.ts 100
```

### Withdraw
```bash
npx tsx withdraw.ts 50     # Withdraw 50 USDC
npx tsx withdraw.ts all    # Withdraw everything
```

### Generate Report
```bash
npx tsx report.ts          # Formatted
npx tsx report.ts --json   # JSON
npx tsx report.ts --plain  # Plain text
```

### Auto-Compound Rewards
```bash
npx tsx compound.ts
```
Swaps reward tokens (WELL, MORPHO) to USDC and deposits back into vault.

## Configuration

After running setup, config is saved to `~/.config/gekko-yield/config.json`:

```json
{
  "wallet": {
    "source": "env",
    "envVar": "PRIVATE_KEY"
  },
  "rpc": "https://mainnet.base.org"
}
```

## Security

⚠️ **This skill manages real funds:**

- Private key loaded from environment variable at runtime
- Never logged or written to disk
- All transactions simulated before execution
- Contract addresses verified on each run

**Recommendations:**
- Use a dedicated hot wallet
- Only deposit what you're comfortable with
- Keep ETH for gas on Base

## Rate Limit Handling

The script automatically handles RPC rate limits (429 errors) by:

- **Automatic retries** with exponential backoff (2s, 4s, 8s delays)
- **Fallback to alternative RPCs** if the primary endpoint is rate limited
- **Built-in delays** between requests to avoid hitting limits

If...