gekko-yield – OpenClaw Skill

---

name: gekko-yield description: Earn yield on USDC by supplying to the Moonwell Flagship USDC vault on Base. Use when depositing USDC, withdrawing from the vault, checking position/APY, or generating yield reports. version: 1.0.0 metadata: {"clawdbot":{"emoji":"🦎","category":"defi","requires":{"bins":["node"]}}}

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

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 <amount>
# 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 <amount>

# 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:

• Private keys loaded at runtime from environment variable
• Keys never logged or written to disk by scripts
• All transactions simulated before execution
• Contract addresses verified on each run
• Scripts show transaction preview before sending

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:

• viem — Ethereum interaction
• tsx — TypeScript execution

---

Built by Gekko AI. Powered by ERC-8004.

🦎 Gekko Yield — Earn Safe Yield on USDC

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

🚀 Quick Start

# 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)

npx tsx setup.ts

Check Position

npx tsx status.ts

Deposit USDC

npx tsx deposit.ts 100

Withdraw

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

Generate Report

npx tsx report.ts          # Formatted
npx tsx report.ts --json   # JSON
npx tsx report.ts --plain  # Plain text

Auto-Compound Rewards

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:

{
  "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 you encounter rate limits, the script will automatically:

1. Retry the request with increasing delays
2. Switch to alternative RPC endpoints if needed
3. Show progress messages during retries

Requirements

• Node.js 18+
• USDC on Base
• ETH on Base (for gas)

Dependencies

cd scripts && pnpm install

---

Built by Gekko AI. Powered by ERC-8004.