# pradyumnn100/yield-agent-vault architecture

> Architecture diagram of the GitHub repository pradyumnn100/yield-agent-vault, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pradyumnn100/yield-agent-vault
- Repository: https://github.com/pradyumnn100/yield-agent-vault

## Overview

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: [`agent/src/rebalanceAgent.ts`](https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/rebalanceAgent.ts) (Rebalance loop), [`contracts`](https://github.com/pradyumnn100/yield-agent-vault/tree/main/contracts) (ERC-4626 vault), [`frontend/components/VaultCard.tsx`](https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/components/VaultCard.tsx) (Vault interaction card), [`agent/src/riskAssessor.ts`](https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/riskAssessor.ts) (Risk assessment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent["Off-chain agent"]
  node_agent_loop["Rebalance loop<br/>[rebalanceAgent.ts]"]
  node_agent_abi["Contract ABIs<br/>[abi.ts]"]
  node_risk["Risk assessment<br/>[riskAssessor.ts]"]
  node_decision_log["Decision log<br/>[rebalanceAgent.ts]"]
end

subgraph group_vault["Vault contracts"]
  node_vault["ERC-4626 vault"]
  node_strategy_controls["Strategy controls"]
  node_aave_adapter["Aave adapter"]
  node_compound_adapter["Compound adapter"]
end

subgraph group_frontend["Wallet frontend"]
  node_app_shell["Wallet app shell<br/>[_app.tsx]"]
  node_home_page["Home page<br/>[index.tsx]"]
  node_vault_card["Vault interaction card<br/>[VaultCard.tsx]"]
  node_frontend_abi["Contract ABIs<br/>[vaultAbi.ts]"]
  node_addresses["Contract addresses<br/>[addresses.ts]"]
end

subgraph group_integrations["External services"]
  node_gemini{{"Gemini API"}}
end

node_operator(("Agent operator"))
node_aave_pool[("Aave pool")]
node_compound_pool[("Compound Comet")]
node_user(("Vault user"))

node_operator -->|"starts polling"| node_agent_loop
node_agent_loop -->|"reads APY"| node_aave_adapter
node_agent_loop -->|"reads APY"| node_compound_adapter
node_agent_loop -->|"reads strategy"| node_vault
node_agent_loop -->|"requests assessment"| node_risk
node_risk -->|"assesses signal"| node_gemini
node_agent_loop -->|"submits rebalance"| node_vault
node_agent_loop -->|"appends decisions"| node_decision_log
node_vault -.->|"enforces whitelist"| node_strategy_controls
node_vault -.->|"dispatches funds"| node_aave_adapter
node_vault -.->|"dispatches funds"| node_compound_adapter
node_aave_adapter -.->|"uses pool"| node_aave_pool
node_compound_adapter -.->|"uses Comet"| node_compound_pool
node_user -->|"uses vault UI"| node_vault_card
node_app_shell -->|"provides wallet context"| node_vault_card
node_home_page -.->|"renders in app"| node_app_shell
node_vault_card -->|"uses interfaces"| node_frontend_abi
node_vault_card -->|"uses addresses"| node_addresses
node_vault_card -->|"reads and writes"| node_vault

click node_agent_loop "https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/rebalanceAgent.ts"
click node_agent_abi "https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/abi.ts"
click node_risk "https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/riskAssessor.ts"
click node_decision_log "https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/rebalanceAgent.ts"
click node_vault "https://github.com/pradyumnn100/yield-agent-vault/tree/main/contracts"
click node_strategy_controls "https://github.com/pradyumnn100/yield-agent-vault/tree/main/contracts"
click node_aave_adapter "https://github.com/pradyumnn100/yield-agent-vault/tree/main/contracts"
click node_compound_adapter "https://github.com/pradyumnn100/yield-agent-vault/tree/main/contracts"
click node_app_shell "https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/src/pages/_app.tsx"
click node_home_page "https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/src/pages/index.tsx"
click node_vault_card "https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/components/VaultCard.tsx"
click node_frontend_abi "https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/lib/vaultAbi.ts"
click node_addresses "https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/lib/addresses.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_agent_loop,node_agent_abi,node_risk,node_decision_log,node_user toneBlue
class node_vault,node_strategy_controls,node_aave_adapter,node_compound_adapter,node_aave_pool,node_compound_pool toneAmber
class node_app_shell,node_home_page,node_vault_card,node_frontend_abi,node_addresses toneMint
class node_gemini toneRose
class node_operator toneIndigo
```

## Components

### Off-chain agent

- [Rebalance loop](https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/rebalanceAgent.ts): `agent/src/rebalanceAgent.ts`
- [Contract ABIs](https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/abi.ts): `agent/src/abi.ts`
- [Risk assessment](https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/riskAssessor.ts): `agent/src/riskAssessor.ts`
- [Decision log](https://github.com/pradyumnn100/yield-agent-vault/blob/main/agent/src/rebalanceAgent.ts): `agent/src/rebalanceAgent.ts`

### Vault contracts

- [ERC-4626 vault](https://github.com/pradyumnn100/yield-agent-vault/tree/main/contracts): `contracts`
- [Strategy controls](https://github.com/pradyumnn100/yield-agent-vault/tree/main/contracts): `contracts`
- [Aave adapter](https://github.com/pradyumnn100/yield-agent-vault/tree/main/contracts): `contracts`
- [Compound adapter](https://github.com/pradyumnn100/yield-agent-vault/tree/main/contracts): `contracts`

### Wallet frontend

- [Wallet app shell](https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/src/pages/_app.tsx): `frontend/src/pages/_app.tsx`
- [Home page](https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/src/pages/index.tsx): `frontend/src/pages/index.tsx`
- [Vault interaction card](https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/components/VaultCard.tsx): `frontend/components/VaultCard.tsx`
- [Contract ABIs](https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/lib/vaultAbi.ts): `frontend/lib/vaultAbi.ts`
- [Contract addresses](https://github.com/pradyumnn100/yield-agent-vault/blob/main/frontend/lib/addresses.ts): `frontend/lib/addresses.ts`

### External services

- **Gemini API**

### Other components

- **Agent operator**
- **Aave pool**
- **Compound Comet**
- **Vault user**

## Connections

- Agent operator → Rebalance loop: starts polling (evidence: `agent/src/rebalanceAgent.ts`)
- Rebalance loop → Aave adapter: reads APY
- Rebalance loop → Compound adapter: reads APY
- Rebalance loop → ERC-4626 vault: reads strategy (evidence: `agent/src/rebalanceAgent.ts`)
- Rebalance loop → Risk assessment: requests assessment (evidence: `agent/src/rebalanceAgent.ts`)
- Risk assessment → Gemini API: assesses signal (evidence: `agent/src/riskAssessor.ts`)
- Rebalance loop → ERC-4626 vault: submits rebalance (evidence: `agent/src/rebalanceAgent.ts`)
- Rebalance loop → Decision log: appends decisions (evidence: `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 (evidence: `frontend/components/VaultCard.tsx`)
- Wallet app shell → Vault interaction card: provides wallet context (evidence: `frontend/src/pages/_app.tsx`)
- Home page → Wallet app shell: renders in app
- Vault interaction card → Contract ABIs: uses interfaces (evidence: `frontend/components/VaultCard.tsx`)
- Vault interaction card → Contract addresses: uses addresses (evidence: `frontend/components/VaultCard.tsx`)
- Vault interaction card → ERC-4626 vault: reads and writes (evidence: `frontend/components/VaultCard.tsx`)
