Morpho Earn - earn safe yield on your USDC on Base

Morpho Earn — Earn safe yield on your USDC

Earn yield on USDC via the Moonwell Flagship USDC vault on Base (Morpho protocol).

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.5-5%)

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

Yields come from real borrowing demand, not unsustainable emissions. Check current APY with npx tsx status.ts.

Quick Start

cd ~/clawd/skills/morpho-yield/scripts
npm install
npx tsx setup.ts

The setup wizard will: 1. Configure your wallet (private key file, env var, or 1Password) 2. Ask your notification preferences (daily/weekly reports) 3. Set compound threshold and auto-compound preference 4. Add monitoring to HEARTBEAT.md automatically

Commands

Interactive Setup

npx tsx setup.ts

Guides you through wallet configuration and preferences.

Check Position & APY

npx tsx status.ts

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

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

Beautiful formatted report showing position, rewards, and estimated earnings.

Deposit USDC

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

Deposits USDC into the Moonwell vault. Requires sufficient USDC balance and gas (ETH on Base).

Withdraw

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

Check Rewards

npx tsx rewards.ts

Returns: claimable MORPHO, WELL, and other reward tokens from Merkl.

Claim Rewards

npx tsx rewards.ts claim

Claims all pending rewards from Merkl distributor to your wallet.

Auto-Compound

npx tsx compound.ts

All-in-one command that: 1. Claims any pending rewards from Merkl 2. Swaps reward tokens (MORPHO, WELL) to USDC via Odos aggregator 3. Deposits the USDC back into the vault

Heartbeat Integration

After setup, your agent monitors the position based on deposit size:

| Deposit Size | Compound Check | Rationale | |--------------|----------------|-----------| | $10,000+ | Daily | Large positions accumulate meaningful rewards quickly | | $1,000-$10,000 | Every 3 days | Balance between gas costs and reward accumulation | | $100-$1,000 | Weekly | Small rewards need time to exceed gas costs | | <$100 | Bi-weekly | Minimal positions, compound only when worthwhile |

The agent will:

Configuration

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

{
  "wallet": {
    "source": "file",
    "path": "~/.clawd/vault/morpho.key"
  },
  "rpc": "https://rpc.moonwell.fi/main/evm/8453"
}

Preferences: ~/.config/morpho-yield/preferences.json

{
  "reportFrequency": "weekly",
  "compoundThreshold": 0.50,
  "autoCompound": true
}

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. Secure key storage — Use encrypted file or 1Password 4. Monitor activity — Periodically check wallet transactions 5. Keep gas funded — Maintain small ETH balance on Base for transactions

Rewards

The vault earns rewards beyond base APY via Merkl:

Rewards update approximately every 8 hours. The compound.ts script handles: 1. Claiming rewards from Merkl distributor 2. Swapping tokens to USDC via Odos aggregator 3. Depositing USDC back into the vault

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 | | RPC error | Network issues | Check RPC URL or try again | | Swap reverted | Gas underestimate | Script auto-adds 50% buffer |

Dependencies

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

cd scripts && npm install

Packages used:

cd ~/clawd/skills/morpho-yield/scripts
npm install
npx tsx setup.ts

The setup wizard will: 1. Configure your wallet (private key file, env var, or 1Password) 2. Ask your notification preferences (daily/weekly reports) 3. Set compound threshold and auto-compound preference 4. Add monitoring to HEARTBEAT.md automatically

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

{
  "wallet": {
    "source": "file",
    "path": "~/.clawd/vault/morpho.key"
  },
  "rpc": "https://rpc.moonwell.fi/main/evm/8453"
}

Preferences: ~/.config/morpho-yield/preferences.json

{
  "reportFrequency": "weekly",
  "compoundThreshold": 0.50,
  "autoCompound": true
}