{"id":32370226,"url":"https://github.com/hadv/abunfi","last_synced_at":"2026-07-02T21:06:32.548Z","repository":{"id":312172048,"uuid":"1046064717","full_name":"hadv/abunfi","owner":"hadv","description":"Abunfi is a micro-savings DeFi application designed for global users, allowing people to save small amounts (starting from $10) and earn attractive interest rates from diverse DeFi investment strategies.","archived":false,"fork":false,"pushed_at":"2025-10-03T15:35:04.000Z","size":711,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-03T17:50:17.273Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hadv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY_FEATURES.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-28T06:16:10.000Z","updated_at":"2025-10-03T15:35:03.000Z","dependencies_parsed_at":"2025-08-29T04:33:14.383Z","dependency_job_id":"b103b99e-b24f-49f6-b074-6f6fdbb8be15","html_url":"https://github.com/hadv/abunfi","commit_stats":null,"previous_names":["hadv/abunfi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hadv/abunfi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hadv","download_url":"https://codeload.github.com/hadv/abunfi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fabunfi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35062812,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-02T02:00:06.368Z","response_time":173,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-24T20:24:37.802Z","updated_at":"2026-07-02T21:06:32.541Z","avatar_url":"https://github.com/hadv.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Abunfi - Micro-Saving for All\n\nAbunfi is a micro-savings DeFi application designed for global users, allowing people to save small amounts (starting from $10) and earn attractive interest rates from diverse DeFi investment strategies.\n\n## 🎯 Mission\n\nBreaking down financial barriers, bringing savings and earning opportunities to everyone, especially young people and everyday users who are new to crypto.\n\n## 🏗️ Architecture\n\n```\nabunfi/\n├── backend/            # Node.js API server\n├── frontend/           # React web application\n├── docs/              # Documentation\n└── scripts/           # Deployment \u0026 utility scripts\n\nabunfi-contracts/       # Smart contracts repository (separate)\n├── src/               # Smart contracts (Solidity)\n│   ├── strategies/    # Investment strategies\n│   ├── interfaces/    # Contract interfaces\n│   └── mocks/         # Mock contracts for testing\n├── test/              # Forge tests\n├── script/            # Deployment scripts\n└── exports/           # Contract ABIs for integration\n```\n\n## 🚀 Key Features\n\n- **Super Fast Registration**: Using Account Abstraction, login with Google/Apple\n- **Easy Savings**: Starting from $10 with user-friendly interface\n- **Attractive Interest Rates**: 6-12% APY from diverse investment strategies\n- **Profit Tracking**: Intuitive dashboard with real-time updates\n- **Flexible Withdrawals**: Withdraw principal and interest anytime\n- **Smart Risk Management**: Automatic allocation between strategies\n\n## 💼 Investment Strategies\n\n### 🏦 Conservative Strategy (Low Risk)\n- **Lending Protocols**: Aave, Compound - APY 4-6%\n- **Stablecoin Farming**: Curve, Convex - APY 3-5%\n\n### ⚖️ Balanced Strategy (Medium Risk)\n- **Liquidity Providing**: Providing liquidity for stablecoin pairs (USDC/USDT) on Curve, Uniswap V3 - APY 5-8%\n\n### 🦄 Uniswap V4 FairFlow Strategy (Medium Risk - NEW!)\n- **Concentrated Liquidity**: Using Uniswap V4 with concentrated liquidity for stablecoin pairs - APY 8-12%\n- **Dynamic Fee Optimization**: Dynamic fee optimization based on market conditions\n- **Automated Rebalancing**: Automatic rebalancing to maintain optimal efficiency\n- **Gas Efficiency**: Leveraging V4's singleton architecture to reduce gas costs\n\n### 🚀 Advanced Strategy (Medium-High Risk)\n- **Liquid Staking**: stETH, rETH to earn profits from Ethereum staking - APY 4-6%\n- **Yield Farming**: Convex, Yearn Finance - APY 8-15%\n\n## 🛠️ Tech Stack\n\n### Frontend\n- **React 18** with TypeScript\n- **Material-UI** for user interface\n- **Web3Auth** for social login (Google, Apple, Facebook) - ✅ **Fully Implemented**\n- **Ethers.js** for blockchain interaction\n- **Recharts** for data visualization\n- **WebSocket** for real-time updates\n\n### Backend\n- **Node.js** with Express.js\n- **PostgreSQL** for financial data\n- **Memory Cache** for sessions and caching (upgradeable to Redis)\n- **JWT** for API authentication\n- **WebSocket** for real-time updates\n- **Role-based Access Control** for Strategy Manager\n- **zkVM Integration** for privacy-preserving verification\n\n### Blockchain\n- **Sepolia Testnet** (Ethereum testnet for pre-production)\n- **Solidity** for smart contracts\n- **Foundry** for testing and deployment\n- **Account Abstraction (EIP-7702)** for gasless transactions\n- **zkVM (RISC Zero)** for privacy-preserving social verification\n\n### DeFi Integration\n- **Aave, Curve, Lido, Rocket Pool, Uniswap V3**\n\n## 📋 System Requirements\n\n- Node.js \u003e= 18\n- npm or yarn\n- Git\n\n## 🚀 Development Setup\n\n### ⚡ Quick Start (5 minutes)\n\n#### Option 1: Docker Compose (Recommended)\n```bash\n# Clone repository\ngit clone https://github.com/hadv/abunfi.git\ncd abunfi\n\n# Quick start with Docker\n./scripts/quick-start.sh\n\n# Or manually start development environment\ndocker-compose up -d --build\n```\n\n#### Option 2: Manual Setup\n```bash\n# Automated database setup\nchmod +x scripts/setup-local-db.sh\n./scripts/setup-local-db.sh\n\n# Install dependencies\ncd backend \u0026\u0026 npm install\ncd ../frontend \u0026\u0026 npm install\n\n# Start development servers\ncd backend \u0026\u0026 npm run dev    # Terminal 1\ncd frontend \u0026\u0026 npm start     # Terminal 2\n```\n\n### 🎯 Strategy Manager Dashboard\n\nReal-time dashboard for strategy managers:\n- **Real-time Data Visualization**: Funds distribution, APY comparison, compound interest\n- **Interactive Controls**: Allocation management with auto-rebalancing\n- **Role-based Access**: Strategy managers and admins only\n- **WebSocket Integration**: Live updates every 30 seconds\n\n**Access**: `http://localhost:3000/strategy-manager`\n\n## 🐳 Docker Deployment\n\n### Development with Docker\n```bash\n# Start all services with hot reload\ndocker-compose up -d --build\n\n# View logs\ndocker-compose logs -f\n\n# Access services:\n# Frontend: http://localhost:3000\n# Backend: http://localhost:3001\n# Database: localhost:5432\n```\n\n### Production Deployment\n```bash\n# 1. Configure environment\ncp .env.production.example .env.prod\n# Edit .env.prod with your domain and secrets\n\n# 2. Deploy to production\nDOMAIN_NAME=your-domain.com ./scripts/deploy-production.sh\n\n# 3. Monitor deployment\n./scripts/monitor-production.sh\n```\n\n\n\n**Production Features:**\n- 🔒 **SSL/TLS** with Let's Encrypt auto-renewal\n- 🌐 **Nginx reverse proxy** with security headers\n- 📊 **Health monitoring** and logging\n- 🔄 **Automatic backups** and recovery\n- 🚀 **Performance optimization** with caching\n- 💾 **Memory cache** for sessions (upgradeable to Redis for production)\n\nSee [DOCKER_SETUP.md](DOCKER_SETUP.md) and [PRODUCTION_ONLY_DEPLOYMENT.md](PRODUCTION_ONLY_DEPLOYMENT.md) for detailed guides.\n\n## 📚 Documentation\n\n### Development Guides\n- **[Quick Start Guide](docs/QUICK_START.md)** - Get running in 5 minutes ⚡\n- **[Development Setup](docs/DEVELOPMENT_SETUP.md)** - Comprehensive setup guide 🔧\n- **[Strategy Manager Dashboard](docs/STRATEGY_MANAGER_DASHBOARD.md)** - Dashboard documentation 📊\n\n### Technical Documentation\n- [`STRATEGIES.md`](docs/STRATEGIES.md) - Details about investment strategies\n- [`DEPLOYMENT.md`](docs/DEPLOYMENT.md) - Deployment guide\n- [`README.md`](docs/README.md) - Technical documentation\n\n## 🔒 Security\n\n- Smart contracts audited by reputable security firms\n- zkVM (RISC Zero) for enhanced privacy and social verification\n- Automatic risk management with dynamic allocation\n- Diversification across protocols to minimize concentration risk\n- Emergency withdrawal mechanisms\n\n## 🤝 Contributing\n\nWe welcome all contributions! Please read the contribution guidelines before submitting PRs.\n\n## 📄 License\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadv%2Fabunfi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhadv%2Fabunfi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadv%2Fabunfi/lists"}