Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 

Repository files navigation

╔══════════════════════════════════════════════════════════════════════════════╗
║                                                                              ║
║   ______                  _____      _     _                                 ║
║   |  ____|                / ____|    (_)   | |                               ║
║   | |__   __ _ _ __ _ __ | |  __ _ __ _  __| |                               ║
║   |  __| / _` | '__| '_ \| | |_ | '__| |/ _` |                               ║
║   | |___| (_| | |  | | | | |__| | |  | | (_| |                               ║
║   |______\__,_|_|  |_| |_|\_____|_|  |_|\__,_|                               ║
║                                                                              ║
║            ⚡ Autonomous USDC Yield Vault — Outperform the banks             ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝

Live APY TVL Base Mainnet Audited Sourcify

Deposit USDC. The bot does the rest. Withdraw anytime.

🌐 earngrid.site · ❤️ System Health · 🔒 Audit · 🛟 Emergency Withdrawal · 📊 DeFiLlama · 💬 Telegram

The APY and TVL badges above are live — served from the production indexer, recomputed onchain every few minutes. No static screenshots.


🎯 What is EarnGrid?

EarnGrid is a permissionless ERC-4626 yield vault on Base that automatically rotates USDC across MetaMorpho lending strategies to capture the highest risk-adjusted APY.

  • 💰 Deposit USDC → receive bvUSDC shares → earn yield from Morpho Blue lending markets
  • 🔄 Swap & Earn — deposit any token: Aerodrome swap → USDC → vault, one transaction
  • 🤖 Fully autonomous — the allocator bot rebalances, syncs queues, and guards capital 24/7
  • 🛡️ Safety-first — APY spike detection, tier caps, drift gates, timelocked governance
  • 📊 Live onchain data — every number on the site comes from the chain, never mocked

🏗️ How it works (for the nerds)

                    ┌─────────────────────────────────────────────┐
                    │                 EARNGRID                    │
                    │                                             │
  any token ──────► │  SwapAndEarn   Aerodrome    USDC            │
                    │  (0.30% spread)──────────────►              │
                    │                              │              │
  USDC ───────────► │         BlendedVault (ERC-4626)             │
                    │              │    ▲                         │
                    │      deposit │    │ shares (bvUSDC)         │
                    │              ▼    │                         │
                    │      ┌──────────────┐      ┌──────────┐    │
                    │      │  Allocator   │─────►│ Indexer  │    │
                    │      │  (hourly)   │      │ +REST API│    │
                    │      └──────┬───────┘      └────┬─────┘    │
                    │             │ rebalance        │ events    │
                    │             ▼                   ▼          │
                    │    MetaMorpho vaults (5 strategies, tiered)│
                    └─────────────────────────────────────────────┘

The vault (BlendedVault, Solidity 0.8.28, Sourcify exact_match) holds all USDC and issues 12-decimal bvUSDC shares (asset 6 + 6 virtual offset — an inflation-attack defense). It walks an onchain deposit queue — every fresh deposit is pushed into the queue head in the same transaction, so money never waits for the bot.

The allocator (TypeScript keeper) re-runs every hour:

  1. Pulls live APYs for every registered strategy from the Morpho Blue API
  2. Re-ranks strategies by risk-adjusted yield (tier caps — live 100%/100%/100% during the dynamic-APY experiment; defaults 80/50/20)
  3. Only moves money when a challenger beats the incumbent by ≥0.80 pp APY (rank hysteresis) and the drift exceeds ≥0.60% of TVL (moves must pay for themselves)
  4. Re-writes the onchain deposit queue to its ranking — new deposits always go to the model's best pick
  5. A strategy guard freezes any strategy that trips deposits_closed, no_borrow_demand, or apy_spike_extreme — it blocks new capital, never force-withdraws, and unfreezes itself when the baseline catches up

Safety rails: every risk-increasing governance change goes through a timelock; a guardian can pause deposits/withdrawals; rebalances are cooldown-gated; the withdraw path is slippage-protected with onchain floors.


📡 Live deployment (Base mainnet, chainId 8453)

BlendedVault 0x8694D7D44309665D51Cb5002fceC0454f1c233dE
SwapAndEarn 0x7025d1462F09d6eCcACB571a151963fAA8Ce93cD
Asset USDC (6 decimals)
Share token bvUSDC (12 decimals)
Performance fee 3% of profit above high-water mark, taken at harvest — never on principal
Swap spread 0.30%
Strategies 5 MetaMorpho vaults: Gauntlet Prime, Steakhouse Prime, Moonwell Flagship, Gauntlet Frontier, Steakhouse High Yield
Governance AccessControl roles + timelock; guardian pause switch
Verification Sourcify exact_match on creation and runtime

Yield sources — all lending through MetaMorpho → Morpho Blue markets:

Strategy Tier Cap
Gauntlet USDC Prime 0 80%
Steakhouse Prime USDC 0 80%
Moonwell Flagship USDC 1 50%
Gauntlet USDC Frontier 2 20%
Steakhouse High Yield USDC 1 50%

🧪 Live right now: all three tier caps are set to 100% (dynamic-APY experiment). The 80/50/20 above are the production defaults.


🔍 Trust & transparency

  • Releases — the public changelog: one release per version, each linking its audit section.
  • System Health — live service status, onchain state, recent events. All measured, nothing mocked.
  • Audit — full findings, threat model, and mitigations (private repo, published as a public page).
  • DeFiLlama — TVL tracking.
  • Emergency Withdrawal — you never need the UI to exit: private key + any Base RPC + cast redeem = withdrawal from anywhere, even if the site is down.
  • Onchain first — every contract is Sourcify-verified; strategies and queues are readable directly on BaseScan.

🗂️ Why this repo has no code

The EarnGrid source code lives in a private repository. This public repo exists as the documentation, transparency, and links hub — everything a user, auditor, or grant reviewer needs to evaluate the project without exposing the codebase.

Want to contribute, audit, or integrate? Open an issue here or reach out on Telegram.


Outperform the banks.

earngrid.site · DeFiLlama · Telegram

About

EarnGrid — autonomous USDC yield vault on Base. Public docs & links (source code is private).

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors