YieldMind

markdown

YieldMind is an AI-powered yield automation platform that lets users deposit USDC into a vault, define their yield strategy in plain English (or via presets and sliders), and let an autonomous AI agent rebalance their position on Arbitrum every 5 minutes.

### The Problem
DeFi yield farming is fragmented, time-consuming, and favors bots. Retail users must constantly monitor APYs, manually rebalance across protocols, and optimize gas costs. Existing auto-compounders are rigid single-strategy pools with no user customization.

### Our Solution
YieldMind gives every user their own AI agent. You describe your strategy — "aggressive growth, 80% in yield assets, 3-month horizon" — and the agent parses it via DGrid AI Gateway, writes it on-chain through the StrategyRegistry, and autonomously rebalances your vault position. Everything is on-chain and verifiable. No hidden databases, no opaque off-chain logic.

### Features
- **AI Strategy Advisor**: Natural language to on-chain execution with reasoning. Not a keyword matcher — the agent considers portfolio value and time horizon.
- **Leaderboard + Copy Trading**: Auto-discovers all depositors from on-chain vault `Deposit` events (no hardcoded lists). Any user can copy any strategy in one click — real PMF for DeFi adoption.
- **Stylus (Rust → WASM)**: Gas-efficient strategy computation running as an Arbitrum Stylus contract. ~10x cheaper than equivalent Solidity math. Shows deep Arbitrum tech stack expertise.
- **Strategy Templates**: One-click presets (Stable Yield, Balanced, Growth, DeFi Degen) eliminate onboarding friction.
- **Dual-Chain**: Deployed on Arbitrum Sepolia and Robinhood Testnet. Same contracts, same frontend, different chains.

### Architecture
Three smart contracts on Arbitrum: a Vault (ERC4626-like), a StrategyRegistry (per-user config), and an Agent Executor (Stylus/Rust). A Cloudflare Worker cron agent reads on-chain state every 5 minutes and submits rebalance transactions. The Next.js 15 frontend reads directly from contracts via wagmi — no backend database.

### Smart Contracts + Deploy
Started from an empty repo. Wrote the Vault contract (ERC4626-inspired): accepts USDC deposits, mints shares 1:1, only the agent address can call `rebalance()`. Wrote the StrategyRegistry with `getStrategy`/`setStrategy` functions storing on-chain config structs.
Created IStrategyRegistry and IERC4626 interfaces. Wrote 7 Foundry tests covering deposit, withdraw, rebalance, access control, zero-amount reverts, and share price math. All passing with gas reports.
Deployed both contracts to Arbitrum Sepolia and verified on Arbiscan.

### Frontend
Built the entire Next.js 15 frontend from scratch: cyberpunk terminal-themed UI with Tailwind.
Implemented wallet connect via RainbowKit + wagmi with multi-chain support (Arbitrum Sepolia, Arbitrum One, Robinhood Testnet).
Built 8 core components: Dashboard (stats grid, onboarding flow, agent log), VaultManager (deposit/withdraw with inline USDC approval), StrategyForm (sliders, risk selector, presets), PositionCard (with estimated APY), PortfolioChart (24h reactive), Navbar (network guard with red warning for wrong chain), TransactionToast (real-time confirmation), and AppprovalGuard. Wrote useVaultData hook integrating wagmi reads and writes with chain-aware contract addresses.

### Agent, AI, Stylus, Robinhood
Wrote the Cloudflare Worker cron agent: reads vault state every 5 minutes via viem, iterates watched users, computes optimal allocations, submits `rebalance()` transactions.
Added REST API: `/api/status` (health), `/api/trigger` (manual), `/api/parse-strategy` (AI parsing via DGrid Gateway).
Deployed to Cloudflare Worker.
Fixed and upgraded the Stylus Rust contract from SDK 0.6 to 0.10.7 — patched 5 compilation errors (API changes in `msg::sender`, `block::timestamp`, `StorageMap::set→insert`, `U256::as_u64→to::<u64>()`, `vec!→alloc::vec!`).
Deployed Stylus contract to Arbitrum Sepolia. Wrote DeployRHC.s.sol + MockUSDC.sol and deployed the full stack to Robinhood Testnet (Chain 46630).
Added RHC faucet component for one-click mock USDC minting.

### Final Polish
Added PMF features in the last sprint: Leaderboard (auto-discovers depositors from on-chain `Deposit` events, no hardcoded user lists), Copy Trading (one-click copy any leaderboard entry's strategy), Strategy Templates (4 one-click presets), AI Advisor upgrade (returns reasoning, accepts portfolio value for context-aware recommendations), Estimated APY display based on allocation, guided onboarding banner for first-time users.
Fixed CORS on agent, chain-id validation on write functions, and pnpm build issues for Vercel deploy.
Created comprehensive docs (README, AGENTS.md).

Not yet.