How pradyumnn100/yield-agent-vault works
This repository is an ERC-4626 yield vault with an off-chain rebalancing agent and a wallet UI. The main workflow polls approved strategies for APYs, checks for a meaningful yield advantage, asks Gemini to assess risk, and—if approved—requests an on-chain rebalance; the agent records each outcome. Depositors can connect a wallet, inspect vault state, approve DAI, deposit, and redeem. The README describes contract capabilities whose Solidity sources are not present in the supplied tree, so those components and links are grounded in documentation rather than inspected implementations; the frontend page excerpt appears to be a starter screen.
Main entry points: rebalanceAgent.ts Rebalance loop · contracts ERC-4626 vault · VaultCard.tsx Vault interaction card · riskAssessor.ts Risk assessment
Components 18
Off-chain agent
- Rebalance loop
agent/src/rebalanceAgent.ts - Contract ABIs
agent/src/abi.ts - Risk assessment
agent/src/riskAssessor.ts - Decision log
agent/src/rebalanceAgent.ts
Vault contracts
- ERC-4626 vault
contracts - Strategy controls
contracts - Aave adapter
contracts - Compound adapter
contracts
Wallet frontend
- Wallet app shell
frontend/src/pages/_app.tsx - Home page
frontend/src/pages/index.tsx - Vault interaction card
frontend/components/VaultCard.tsx - Contract ABIs
frontend/lib/vaultAbi.ts - Contract addresses
frontend/lib/addresses.ts
External services
- Gemini API
Other components
- Agent operator
- Aave pool
- Compound Comet
- Vault user
Connections 19
- Agent operator → Rebalance loop: starts polling
agent/src/rebalanceAgent.ts - Rebalance loop → Aave adapter: reads APY
- Rebalance loop → Compound adapter: reads APY
- Rebalance loop → ERC-4626 vault: reads strategy
agent/src/rebalanceAgent.ts - Rebalance loop → Risk assessment: requests assessment
agent/src/rebalanceAgent.ts - Risk assessment → Gemini API: assesses signal
agent/src/riskAssessor.ts - Rebalance loop → ERC-4626 vault: submits rebalance
agent/src/rebalanceAgent.ts - Rebalance loop → Decision log: appends decisions
agent/src/rebalanceAgent.ts - ERC-4626 vault → Strategy controls: enforces whitelist
- ERC-4626 vault → Aave adapter: dispatches funds
- ERC-4626 vault → Compound adapter: dispatches funds
- Aave adapter → Aave pool: uses pool
- Compound adapter → Compound Comet: uses Comet
- Vault user → Vault interaction card: uses vault UI
frontend/components/VaultCard.tsx - Wallet app shell → Vault interaction card: provides wallet context
frontend/src/pages/_app.tsx - Home page → Wallet app shell: renders in app
- Vault interaction card → Contract ABIs: uses interfaces
frontend/components/VaultCard.tsx - Vault interaction card → Contract addresses: uses addresses
frontend/components/VaultCard.tsx - Vault interaction card → ERC-4626 vault: reads and writes
frontend/components/VaultCard.tsx