Risk-aware, values-driven treasury management.
DiversiFi detects a visitor’s local currency depreciation against USD, EUR, and gold, then helps protect savings through stablecoin allocation, gold-backed tokens, and yield vaults. The same machinery runs both directions: savers in volatile-currency economies protecting purchasing power, and businesses and savers in developed markets trading with — or diversifying into — emerging markets along cultural, values, or philosophy lines, with FX exposure quantified either way. Every Guardian decision is recorded on-chain, with AI reasoning anchored to 0G. The philosophy/values system is the retention moat.
Live app: https://diversifiapp.vercel.app · Full pitch: docs/product.md
pnpm install
cp .env.example .env.local # minimum: NEXT_PUBLIC_PRIVY_APP_ID, PRIVY_APP_SECRET
pnpm dev # http://localhost:3042Requires Node ≥22.11 and pnpm. Setup details, env tables, and test drive: docs/setup.md. Docs index: docs/README.md. How to contribute: CONTRIBUTING.md.
| Area | Where |
|---|---|
| Next.js app | apps/web/ (components/, hooks/, pages/, …) |
| Domain logic | packages/shared/ |
| Agent APIs | apps/web/pages/api/agent/ |
| Contracts | contracts/ (+ contracts/test/), scripts/Deploy*.s.sol (Foundry libs in root lib/) |
| Docs index | docs/README.md |
| Agent / coding conventions | AGENTS.md |
| Ops (Alibaba FC, etc.) | ops/ |
| Examples | examples/ |
Foundry tests live in contracts/test/. x402 smoke scripts live in scripts/smoke/.
- Currency-risk awareness — show depreciation in the visitor’s own money (GHS, KES, USD vs gold, …). Risk is universal; the response is values-driven. Ships today: risk detection, philosophy-aware allocation, on-chain protection. Not yet: direct fiat on-ramp; full SME FX drag product (concierge CLI:
npx tsx scripts/fx-drag-report.ts). - Philosophy / values system — identity-based retention via cultural archetypes, not generic DeFi yield shopping.
The Guardian routes capital across Celo/Mento (local stables), Arbitrum (liquidity + RWA yield), and HashKey Chain (APAC savings), with on-chain proof of each decision.
| Topic | Doc |
|---|---|
| Architecture, AI providers, settlement | docs/architecture.md |
| APIs, env vars, external agents | docs/integrations.md |
| Roadmap & grant tracks | docs/roadmap.md |
| APAC rail (HashKey) | docs/rails.md |
| Caribbean rail | docs/rails.md |
| SME FX north star | docs/strategy.md |
| Guardian enforcement | docs/guardian.md |
| Mainnet deployment proofs | docs/architecture.md · ledgers at 0x3BCf…369C on Celo, Arbitrum, and 0G |
- Intelligence gateway — x402-gated Mento depeg + inflation + yield intelligence for any agent
- Chain-aware ledger — decisions settle where the money moves; evidence CIDs on 0G
- Guardian pulse / proactive pilot — AI insights and one-tap rebalance intents
- Verifiable AI tab — in-app evidence CIDs, model IDs, chain receipts
- Social-login onboarding — Privy-first wallet abstraction