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:

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

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

npx tsx setup.ts

Guides you through wallet configuration.

Check Position & APY

npx tsx status.ts

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

Generate Report

# 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

npx tsx deposit.ts 
Example: deposit 100 USDC
npx tsx deposit.ts 100

Deposits USDC into the Moonwell vault. Handles approval automatically.

Withdraw

# Withdraw specific amount of USDC
npx tsx withdraw.ts 
Withdraw all (redeem all shares)
npx tsx withdraw.ts all

Auto-Compound

npx tsx compound.ts

All-in-one command that: 1. Checks wallet for reward tokens (WELL, MORPHO) 2. Swaps them to USDC via Odos aggregator 3. Deposits the USDC back into the vault

Configuration

Config location: ~/.config/gekko-yield/config.json

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

Security

⚠️ This skill manages real funds. Review carefully:

Recommended Setup

1. Dedicated wallet — Create a hot wallet just for this skill 2. Limited funds — Only deposit what you're comfortable having in a hot wallet 3. Keep gas funded — Maintain small ETH balance on Base for transactions

Error Handling

| Error | Cause | Fix | |-------|-------|-----| | Insufficient USDC | Not enough USDC in wallet | Bridge/transfer more USDC to Base | | Insufficient gas | Not enough ETH for tx | Add ETH to wallet on Base | | Wallet not configured | Missing config | Run npx tsx setup.ts | | PRIVATE_KEY not set | Missing env var | Set $env:PRIVATE_KEY="your-key" |

Dependencies

Scripts require Node.js 18+. Install deps before first run:

cd scripts && pnpm install

Packages used:

Built by Gekko AI. Powered by ERC-8004.

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

Config location: ~/.config/gekko-yield/config.json

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