Skip to content

thisyearnofear/diversify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

442 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 DiversiFi - Multi-Chain AI Wealth Protection

AI-powered wealth protection across Celo, Arbitrum, and Hyperliquid. Smart stablecoin diversification, commodities exposure, inflation hedging, and real-world asset access.

License Status Network AI

🌟 What It Does

DiversiFi helps you protect wealth from inflation and currency volatility through:

  • Cultural Financial Strategies - Choose from 7 authentic philosophies (Africapitalism, Buen Vivir, Islamic Finance, etc.) that shape AI recommendations and asset filtering
  • Smart Stablecoin Swaps - Exchange between global (USDC) and local stablecoins using strategy-aware AI recommendations
  • Cross-Chain Bridging - Move assets seamlessly between Celo and Arbitrum via LiFi
  • Inflation Protection - Real-time economic data analysis to hedge against currency devaluation
  • RWA Access - Exposure to tokenized real-world assets (treasury yields, gold) on Arbitrum
  • Strategy-Aligned Asset Filtering - Automatic compliance checking (e.g., Islamic Finance excludes interest-bearing assets)
  • GoodDollar UBI - Earn free G$ tokens daily by maintaining saving streaks ($0.50+ minimum)
  • Mobile-Optimized Claims - Seamless in-app G$ claiming with guided bottom-sheet interface

🚀 Quick Start

# Install dependencies
pnpm install

# Setup environment
cp .env.example .env.local

# Add your API keys to .env.local:
# - GOOGLE_AI_API_KEY (get from https://aistudio.google.com/)
# - VENICE_API_KEY (optional, from https://venice.ai/api)
# - SYNTH_API_KEY (for market predictions, from https://docs.synthdata.co)
# - NEXT_PUBLIC_REOWN_PROJECT_ID (or NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID, from https://cloud.walletconnect.com/)

# Run dev server
pnpm dev

⛽ The Agent Fuel Model (2026 Architecture)

DiversiFi introduces a revolutionary User-Funded Autonomous Economy powered by Arc L1 and Circle MPC.

  • Agent Fuel: Users top up their dedicated AI Agent with USDC.
  • Native Gas: The Agent uses this USDC to pay for its own compute, data access (x402), and execution fees.
  • Invisible Complexity: No need for ETH, MATIC, or CELO. Just "Fuel" (USDC).
  • Safety: Scoped by ERC-6900 permissions (e.g., "Spend max $10/day").

📖 Read the Full Agent Fuel Documentation

🏗️ Architecture

Deployment

  • Frontend: Static hosting (e.g., Netlify)
  • AI API: Separate API service for long-running AI operations (extended timeouts)

Deployment/runbook details are intentionally kept out of the public repo. If you’re a maintainer, see docs/internal/DEPLOYMENT_RUNBOOK.md (not committed) or your team’s internal documentation.

Financial Strategies (New!)

Choose from 7 cultural approaches to wealth:

  • Africapitalism 🌍 - Keep wealth in African economies
  • Buen Vivir 🌎 - Balance material wealth with community well-being (LatAm)
  • Confucian/Family Wealth 🏮 - Multi-generational stability (East Asia)
  • Gotong Royong 🤝 - Mutual aid and remittances (Southeast Asia)
  • Islamic Finance ☪️ - Sharia-compliant, no interest-bearing assets
  • Global Diversification 🌐 - Maximum geographic spread
  • Custom 🎯 - Define your own approach

Each strategy shapes:

  • AI recommendations (prioritizes aligned assets)
  • Asset filtering (blocks violations for Islamic Finance)
  • Success metrics (strategy-specific diversification scoring)
  • Positive reinforcement (badges for recommended assets)

Supported Chains

  • Celo - Local stablecoin access (cUSD, cEUR, cREAL) via Mento
  • Arbitrum - RWA yield tokens (USDY, PAXG, SYRUPUSDC) via LiFi/Uniswap
  • Hyperliquid (Virtual Chain ID 998) - Commodity perpetual exposure (GOLD, SILVER, OIL, COPPER) with EIP-712 typed-data signing

AI Intelligence

  • Venice AI (primary) - Web search, private inference, no data retention
  • Gemini 3.0 Flash (fallback) - Portfolio analysis and recommendations
  • SynthData - Probabilistic market intelligence (prediction-percentiles, volatility, option-pricing, liquidation) with cache + deterministic fallback
  • Real-time Data - Inflation rates, exchange rates, macro indicators

Cross-Chain Infrastructure

  • LiFi SDK - Cross-chain swaps and bridging (primary)
  • Circle Programmable Wallets - Enterprise wallet infrastructure
  • 1inch - Arbitrum DEX aggregation

📂 Documentation

🛠️ Tech Stack

Category Technology
Frontend Next.js 15, React 19, Tailwind CSS
AI Google Gemini 3.0, Venice AI
Swaps & Execution Mento (Celo), LiFi (cross-chain), 1inch (Arbitrum), Hyperliquid Perps (commodities)
Market Intelligence SynthData probabilistic forecasts + volatility/risk endpoints
Wallet Reown AppKit (WalletConnect), Farcaster Mini App SDK, Circle Programmable Wallets
Voice OpenAI Whisper, ElevenLabs TTS

🔮 Roadmap

  • Enhanced Strategy Features - More granular controls for custom strategies
  • Multi-Agent System - Specialized agents for yield vs protection strategies
  • Additional Chains - Base, Optimism support via LiFi
  • Enhanced Automation - Zapier MCP integration (in development)
  • Community Strategies - User-created and shared financial philosophies

📄 License

MIT License

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors