🎉 3rd Place Winner at EasyA x Ripple Apex Hackathon (XRP Ledger Track)
Decentralized Microloan Platform for Financial Inclusion
MicroLoanX is a revolutionary lending platform built on the XRP Ledger that connects unbanked borrowers with global lenders through pseudonymous, reputation-based microloans. Built for the Ripple x EasyA Singapore Hackathon, this platform demonstrates how blockchain technology can solve real-world financial inclusion challenges.
Financial exclusion affects over 1.7 billion people worldwide who lack access to traditional banking services. MicroLoanX addresses this by:
- Eliminating KYC barriers while maintaining trust through decentralized identity
- Enabling cross-border lending with instant settlements via RLUSD
- Building reputation without revealing identity through pseudonymous profiles
- Providing automated escrow protection using XRP Ledger's native functionality
- Reducing lending costs through blockchain efficiency
- Node.js 18 or higher
- npm package manager
- Git
- Clone the repository:
git clone https://github.com/yourusername/hackathon2025xrp.git
cd hackathon2025xrp- Install dependencies:
npm install- Start the development server:
npm run dev- Open your browser to http://localhost:3000
The application comes pre-loaded with test accounts. Click "Select Test Account" to choose from:
Borrower Accounts:
- Maria Santos - Agriculture specialist with 92/100 trust score
- Ahmed Hassan - Healthcare & business loans, 88/100 trust score
- Priya Sharma - Education loans, 76/100 trust score
- Carlos Rodriguez - General loans, 68/100 trust score
Lender Accounts:
- Jennifer Chen - $50,000 available, low risk tolerance
- Michael Thompson - $75,000 available, medium risk tolerance
- Sarah Williams - $100,000 available, high risk tolerance
- Ashton Hall - $25,000 available, low risk tolerance
- Select an account from the demo accounts
- Switch between views - borrower or lender dashboard
- Create loan requests (borrowers) with purpose and amount
- Browse and fund loans (lenders) based on risk assessment
- Track transactions on the XRP Ledger testnet
- Pseudonymous profiles using Decentralized Identifiers (DIDs)
- Dynamic interest rates based on reputation score
- Categorical expertise tracking (agriculture, healthcare, education, business)
- Loan request system with purpose tagging
- Reputation building through successful repayments
- Risk assessment tools with borrower trust scores
- Portfolio management dashboard
- Real-time transaction tracking on XRP Ledger
- Automated loan matching based on risk preferences
- Complete audit trail of all lending activity
- Pseudonymous lending - no personal information required
- Decentralized identity through mock DID implementation
- XRPL escrow protection for all transactions
- Local data persistence using IndexedDB
- Transparent reputation system without revealing identity
- Next.js 15 with App Router
- TypeScript for type safety
- Tailwind CSS with custom glass morphism design
- Framer Motion for smooth animations
- Headless UI for accessible components
- XRP Ledger for transaction processing
- RLUSD (Ripple USD stablecoin) for stable value
- xrpl.js v4.2.5 SDK for blockchain interaction
- XRPL Testnet for development and demo
- IndexedDB for local data persistence
- React Context for state management
- Mock DID system for pseudonymous identity
src/
├── app/ # Next.js App Router
│ ├── page.tsx # Main dashboard
│ ├── layout.tsx # Root layout
│ └── globals.css # Global styles
├── components/
│ ├── borrower/ # Borrower interface
│ ├── lender/ # Lender interface
│ ├── layout/ # Navigation components
│ └── ui/ # Reusable UI components
├── lib/
│ ├── contexts/ # React Context providers
│ ├── database/ # IndexedDB operations
│ └── xrpl/ # XRP Ledger integration
└── types/
└── index.ts # TypeScript definitions
- Network: XRPL Testnet (
wss://s.altnet.rippletest.net:51233) - Currency: RLUSD (Ripple USD stablecoin)
- Explorer: XRPL Testnet Explorer
- Native Escrow Objects - Trustless loan agreements with time-based or conditional release
- RLUSD Stablecoin - Stable value lending without cryptocurrency volatility
- Trust Lines - Multi-currency support within the XRP ecosystem
- Memo Fields - On-chain metadata for loan transparency
- Instant Settlement - 3-4 second transaction finality
Working Features:
- XRPL Testnet connectivity
- Real XRP transactions for loan funding/repayment
- Account balance checking with RLUSD support
- Transaction history tracking
- Testnet explorer integration
In Development:
- Full RLUSD trust line implementation
- Production escrow contracts
- Automated loan lifecycle management
- Enhanced reputation algorithms
# Development server with Turbopack
npm run dev
# Production build
npm run build
# Start production server
npm start
# Run ESLint
npm run lint
# Type checking
npx tsc --noEmit- All new code should use TypeScript
- Follow the existing component patterns
- Use the established styling system (Tailwind + custom CSS)
- Implement proper error handling
- Add comprehensive code comments
src/lib/xrpl/client.ts- Core XRPL integrationsrc/lib/xrpl/escrow.ts- Loan escrow managementsrc/lib/database/db.ts- Local database operationssrc/lib/contexts/AccountContext.tsx- Global state managementsrc/components/borrower/EnhancedBorrowerView.tsx- Borrower interfacesrc/components/lender/EnhancedLenderView.tsx- Lender interface
Database initialization fails:
- Refresh the page to retry initialization
- Check browser console for specific errors
- Clear browser storage if issues persist
XRPL connection problems:
- Verify internet connectivity
- Check if XRPL testnet is operational
- Look for connection errors in browser console
User switching not working:
- Wait for database initialization to complete
- Try refreshing the page
- Check that test data has loaded properly
Open browser developer tools to see detailed logs:
- Database operations and initialization status
- XRPL connection and transaction details
- User switching and authentication flow
- Error messages and stack traces
- Mock escrow system - Uses simulated blockchain transactions for demo
- Local data storage - Data resets when browser storage is cleared
- Single session - No persistent user authentication
- Testnet only - Not connected to XRP Ledger mainnet
- Real XRPL escrow integration with production contracts
- Persistent user sessions with secure authentication
- IPFS metadata storage for decentralized loan data
- Mainnet deployment with real RLUSD transactions
- Enhanced security with production-grade practices
- Complete RLUSD trust line integration
- Implement real XRPL escrow contracts
- Add comprehensive error handling
- Improve mobile responsiveness
- Multi-currency loan support
- Lending pool functionality
- Advanced reputation algorithms
- Social verification systems
- Mainnet deployment
- Real DID integration with established standards
- Regulatory compliance framework
- Mobile application development
- Partnership integrations
MicroLoanX employs a modern, accessible design system:
- Glass morphism UI for a premium, modern feel
- Dark theme optimization for extended usage
- Mobile-first responsive design for global accessibility
- High contrast ratios for visual accessibility
- Smooth animations that enhance rather than distract
The color palette emphasizes trust and reliability:
- Primary blue for trustworthiness
- Secondary teal for growth and stability
- Success green for positive outcomes
- Warning amber for pending states
- Error red for negative states
We welcome contributions to MicroLoanX. Please:
- Fork the repository
- Create a feature branch
- Make your changes with proper TypeScript typing
- Add tests for new functionality
- Submit a pull request with detailed description
Built for: Ripple x EasyA Singapore Hackathon 2025 Problem addressed: Financial inclusion through blockchain technology Innovation: Pseudonymous reputation-based lending on XRP Ledger Impact: Enabling microfinance for the unbanked globally
This project is licensed under the MIT License - see the LICENSE file for details.
- Ripple for XRP Ledger technology and RLUSD infrastructure
- EasyA for organizing the hackathon and fostering innovation
- Next.js team for the excellent React framework
- Tailwind CSS for the utility-first styling approach
- xrpl.js contributors for the comprehensive SDK
Experience the future of inclusive finance - start by selecting a test account and exploring decentralized microloans powered by the XRP Ledger.
Presentation slides : https://www.canva.com/design/DAGpptDxMJ0/PL_4naT3VGxGMMhm3XxQ1A/edit?ui=eyJBIjp7fX0
Transaction link : https://testnet.xrpl.org/transactions/764B959E857334986422B9BA51B9054D3CD3BC4A37519E018144F1465D70822E