Empowering Financial Inclusion Through Blockchain Technology
Verified Smart Contracts ✅ | Deployed on Celo Sepolia ✅ | Production Ready 🚀
TrustCircle is a next-generation decentralized micro-lending platform built on the Celo blockchain, providing accessible financial services to unbanked and underbanked populations worldwide through blockchain technology, AI-powered credit scoring, and social verification mechanisms.
- 💰 Multi-Currency Lending: Support for cUSD, cEUR, and cREAL stablecoins
- 🤖 AI Credit Scoring: Intelligent credit assessment (300-850 score range)
- 🎫 Soul-Bound Identity: Non-transferable verification tokens
- 🤝 Social Lending Circles: Community-based loan approvals
- 🔐 Secure & Audited: OpenZeppelin contracts with security best practices
- 📱 Mobile-First: Responsive design for smartphone access
- 🔗 WalletConnect: Seamless wallet connection experience
- ⚡ Low Fees: 8-25% APY (vs 100%+ traditional micro-loans)
trustcircle/ # Monorepo root
├── packages/
│ ├── frontend/ # Next.js 15 + React 19 app
│ ├── contracts/ # Solidity smart contracts (verified ✅)
│ └── shared/ # Shared TypeScript utilities
├── docs/ # Comprehensive documentation
│ ├── WALLETCONNECT_INTEGRATION.md
│ ├── FRONTEND_INTEGRATION.md
│ └── ...
└── README_COMPREHENSIVE.md # Full project documentation
- Next.js 15 with App Router
- React 19 & TypeScript 5.6
- Tailwind CSS for styling
- Reown AppKit (WalletConnect v3)
- Wagmi 2.12 & Viem 2.21
- TanStack Query for data fetching
- Solidity 0.8.24
- Hardhat development environment
- OpenZeppelin security libraries
- UUPS Proxy pattern for upgradeability
- Celo blockchain (Mainnet & Sepolia)
- Mento Protocol stablecoins (cUSD, cEUR, cREAL)
- Verified Contracts on Blockscout ✅
- Anthropic Claude for credit scoring
- Neynar SDK for Farcaster integration
- WalletConnect Cloud for wallet connections
All contracts are verified on Celo Sepolia Blockscout ✅
| Contract | Address | Purpose |
|---|---|---|
| CreditScore | 0x72Bf1C... |
On-chain credit scoring |
| VerificationSBT | 0x57B545... |
Identity verification |
| LendingPool | 0xFce256... |
Liquidity pools |
| CollateralManager | 0x62B863... |
Collateral management |
| LoanManager | 0x5C8D2d... |
Loan lifecycle |
| LendingCircle | 0xa50dc2... |
Social lending circles |
📄 Verification Status: View Details
- Node.js 18+ and npm 9+
- Git
- MetaMask or compatible Web3 wallet
git clone https://github.com/yourusername/trustcircle.git
cd trustcircle
npm install# Frontend
cp packages/frontend/.env.example packages/frontend/.env.local
# Contracts (if deploying)
cp packages/contracts/.env.example packages/contracts/.env.localRequired Environment Variables:
# Get from https://cloud.walletconnect.com/
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id
# Optional: AI credit scoring
ANTHROPIC_API_KEY=your_api_key
# Optional: Farcaster integration
NEYNAR_API_KEY=your_neynar_keynpm run devOpen http://localhost:3000 🎉
Visit Celo Faucet to get testnet CELO and stablecoins.
# Development
npm run dev # Start frontend dev server
npm run build # Build all packages
npm run test # Run all tests
npm run lint # Lint code
# Smart Contracts
npm run compile # Compile contracts
npm run test:contracts # Test contracts
npm run deploy:sepolia # Deploy to testnet💡 Tip: See README_COMPREHENSIVE.md for all commands and detailed workflows.
- 📖 Comprehensive README - Complete project documentation
- 🚀 Quick Start Guide - Get started in 5 minutes
- ⚙️ Complete Setup Guide - Detailed setup instructions
- 🔗 WalletConnect Integration - Complete WalletConnect setup
- 🎨 Frontend Integration - Frontend & contract integration
- 🧪 Testing Guide - Testing strategies
- 🚢 Deployment Guide - Deployment instructions
- ✅ Verification Complete - Contract verification status
- 🔒 Security Guide - Security best practices
- 📊 Project Status - Current project state
- 🗺 Roadmap - Future plans
- Celo Docs - Celo blockchain documentation
- Mento Protocol - Stablecoin infrastructure
- Wagmi Docs - React hooks for Ethereum
- Reown AppKit - WalletConnect integration
✅ OpenZeppelin security-audited contracts
✅ Reentrancy protection
✅ Role-based access control
✅ Pausable functionality
✅ Upgradeable pattern (UUPS)
✅ Verified on Blockscout
⏳ Professional security audit
⏳ Bug bounty program
⏳ Multi-signature admin wallet
⏳ Timelock for upgrades
Found a security issue? Email: security@trustcircle.io (Do NOT open public issues)
We welcome contributions! See Contributing Guidelines for details.
Ways to contribute:
- 🐛 Report bugs
- 💡 Suggest features
- 📝 Improve documentation
- 💻 Submit code
- 🧪 Write tests
- Smart contracts deployed & verified
- Basic frontend structure
- WalletConnect integration
- Complete frontend UI
- AI credit scoring
- Farcaster integration
- Comprehensive testing
- Security audit
- Bug bounty program
- Mainnet deployment
- Marketing launch
Full Roadmap: See detailed roadmap
Stay connected with the TrustCircle community:
- Discord: Join our server (Coming Soon)
- Twitter: @TrustCircle (Coming Soon)
- Telegram: TrustCircle Community (Coming Soon)
- Forum: GitHub Discussions
This project is licensed under the MIT License - see the LICENSE file for details.
Built with:
- Celo - Mobile-first blockchain
- Mento Protocol - Stablecoin infrastructure
- OpenZeppelin - Secure contract library
- WalletConnect - Web3 wallet connection
- Anthropic - AI credit scoring
IMPORTANT: TrustCircle is currently in beta testing on testnet. Use at your own risk. This is not financial advice. Smart contracts carry inherent risks. Users are responsible for compliance with local regulations.
Made with ❤️ by the TrustCircle Team
⭐ Star us on GitHub if you find this project useful!