Transparent Syndicated Loan Management with Cross-Chain Microfinance Impact
LoanChain Ledger brings unprecedented transparency and efficiency to syndicated loan management by providing a single, verifiable source of truth throughout the entire loan lifecycle. Built on Base blockchain with Ethereum integration, the platform bridges institutional capital to grassroots microfinance, demonstrating unified visibility across every lending scale.
Built for the LMA Edge Hackathon
Primary Categories: 🌍 Greener Lending | 📊 Transparent Loan Trading
Secondary Categories: 📝 Keeping Loans on Track | 💼 Digital Loans
For security and IP protection, the full production code is currently hosted privately. This repository demonstrates the project structure and documentation.
Agent banks managing syndicated loans face critical operational challenges:
- Fragmented lifecycle tracking across spreadsheets and email chains
- Reconciliation bottlenecks between syndicate members
- Audit preparation delays due to scattered documentation
- Trust gaps from lack of shared, verifiable records
- Compliance risks from incomplete audit trails
LoanChain Ledger provides a desktop-first control platform with cross-chain integration that bridges institutional syndicated loans with grassroots microfinance:
- ✅ Single source of truth - All loan data in one verifiable platform
- ✅ Lifecycle visibility - Track loans from origination through closure
- ✅ Status monitoring - Clear indicators for loans at risk or in breach
- ✅ Immutable audit trails - Every change recorded with who/what/when/why
- ✅ Reconciliation automation - Reduce manual effort between syndicate members
- ✅ Compliance ready - Complete audit trail for regulators
- 🔗 Base ↔ Ethereum Integration - Live data flow between institutional loans (Base) and microfinance (Ethereum Sepolia)
- 📊 Real-time Portfolio Sync - 855+ active microloans, $2.25M disbursed, 94% repayment rate
- 🎯 Impact Measurement - SDG scores, borrower demographics, social & environmental metrics
- 🚀 Scalability Vision - "One platform. Every scale. From $100M syndications to $500 microloans."
LoanChain's cross-chain microfinance integration demonstrates how institutional capital can flow to sustainable grassroots lending:
- Live GreenLend Integration - Real-time data from Ethereum Sepolia smart contracts
- 855+ microloans across 5 countries (Kenya, Bangladesh, Peru, Philippines, Ghana)
- 81/100 SDG Impact Score - UN Sustainable Development Goals tracking
- Impact Metrics - Jobs created, families impacted, CO2 offset, women borrowers
- Agriculture & Education Focus - 45% agriculture, 15% education loans
- Bridge Visualization - Clear architectural diagram showing institutional → grassroots capital flow
Complete transparency across loan lifecycle with blockchain verification:
- Risk Heatmaps - Real-time portfolio visualization
- Immutable Audit Trails - Who/what/when/why for every change
- Cross-Chain Visibility - Unified view of institutional + microfinance portfolios
- Blockchain Proof - Direct links to Etherscan for third-party verification
Proactive monitoring and obligation tracking:
- Status Indicators - Active, At Risk, Breach, Closed
- Obligation Timeline - Covenant compliance and payment schedules
- Stakeholder Coordination - Keep syndicate members aligned
- Audit Readiness - Complete, verifiable transaction history
Modern blockchain infrastructure for loan lifecycle management:
- Base L2 Integration - Enterprise-grade blockchain infrastructure
- OnchainKit - Coinbase's institutional toolkit for wallet & identity
- Smart Contracts - Solidity-based loan registry for immutable records
Intelligent chatbot to help users navigate the platform:
- Context-aware guidance - Understands LoanChain features (risk heatmaps, GreenLend, blockchain verification)
- Quick prompts - Pre-built questions to get started fast
- Floating interface - Accessible from anywhere with smooth animations
- Powered by OpenAI GPT-4o-mini - Fast, accurate responses for judges and users
- Perfect for demos - Explains features in simple, non-technical language
- Portfolio overview with aggregated metrics
- Loan status indicators: Draft, Active, At Risk, Breach, Closed
- Real-time tracking of loan obligations
- Repayment progress visualization
- Searchable and filterable loan list
Quick Start Templates:
- 3 pre-configured loan templates - Small Business Loan ($500K), Real Estate Project ($5M), Equipment Financing ($1.2M)
- One-click apply - All fields auto-filled from template
- Template info cards - Key metrics (amount, APR, term) visible at a glance
Live Loan Calculations:
- Real-time calculations as you type
- Shows: Monthly Payment, Total Interest, Total Payment
- Beautiful gradient card with animated metric display
Improved UX:
- Toggle template view with "Show Templates" button
- "Clear Form" button to reset all fields
- Professional interface for creating syndicated loans
- Comprehensive loan details (borrower, amount, terms, collateral)
- Multi-syndicate member coordination
- Status transitions recorded automatically
- Audit trail generation for compliance
Stats Dashboard:
- 5 key metrics with gradient cards: Overdue, Due Soon, Upcoming, Compliance Rate, Blockchain Verified
- Real-time compliance tracking showing portfolio health
Advanced Filtering:
- Search bar - Find obligations by loan ID, borrower name, or description
- Type filter - Payment, Covenant Review, Document Renewal, Status Update
- Status filter - Overdue, Due Soon, Upcoming, Completed
- All filters work together dynamically
3 View Modes:
- List View - Detailed cards with all obligation info
- Calendar View - Interactive monthly calendar showing obligations by date
- Timeline View - Chronological visualization with connecting timeline
Quick Actions (hover over cards):
- ✅ Mark Complete - Close out obligations
- 🔔 Set Reminder - Get notified before due date
- 🚨 Escalate - Flag critical overdue items
Blockchain Integration:
- Verification badges - Shows which obligations are on-chain verified
- OnchainKit wallet - Connected wallet displays at bottom
- Shield icons - Visual indicator of blockchain-verified items
- Priority levels - Critical, High, Medium, Low color-coded
Export Functionality:
- Download CSV - Export filtered obligations for reporting
- Includes all key fields: Loan ID, Borrower, Type, Due Date, Status, Amount, Priority, Blockchain Status
Pinata IPFS Integration:
- Real decentralized storage - Documents uploaded to IPFS via Pinata
- IPFS CID displayed - Each document gets permanent Content Identifier
- Gateway URLs - Direct access to files from IPFS network
- Download from IPFS - Retrieve files from decentralized storage
- Dual hash system - SHA-256 hash (integrity) + IPFS CID (storage)
Batch Upload:
- Upload multiple documents at once (up to 50MB total)
- Progress bar shows upload percentage
- Category selection before upload (Agreements, Financial, Compliance, Collateral, Other)
- Automatic categorization and organization
Advanced Search & Filter:
- Search bar - Find documents by name, SHA-256 hash, or IPFS CID
- Category filter - Filter by document type
- Real-time filtering with clear feedback
- "Clear Filters" button when no results found
NFT Minting (OnchainKit Integration):
- "Mint as NFT" button on each document
- Simulates NFT minting on Base blockchain
- Shows NFT badge with Token ID after minting
- "View on OpenSea" link for minted NFTs
QR Code Generation:
- "QR Code" button on each document
- Beautiful modal with QR code display
- Mobile-friendly verification
- Shows document metadata in QR
Better Organization:
- Documents grouped by category with counts
- Color-coded category badges (5 categories)
- Improved card layout and spacing
- Smooth animations for document list
- Who changed it - Syndicate member identification
- What changed - Loan details, status updates, amendments
- When it happened - Precise timestamps
- Why it changed - Action context and rationale
- Complete transaction history for regulatory review
- Immutable record storage for tamper-proof audit trails
- Cryptographic verification of all transactions
- Direct links to blockchain explorer for third-party verification
- Optional wallet connection (demo mode available for presentations)
8. Cross-Chain Integration with GreenLend 🌍 (🏆 KEY DIFFERENTIATOR)
The only platform bridging institutional syndicated loans with grassroots microfinance via blockchain:
Live Data Integration:
- Real-time API - Pulls from GreenLend smart contracts on Ethereum Sepolia
- 855+ active microloans - Live portfolio tracking with refresh capability
- $2.25M total disbursed - $2.13M repaid (94.2% repayment rate)
- 5 countries - Kenya, Bangladesh, Peru, Philippines, Ghana
- Dynamic updates - Click refresh to see live cross-chain data synchronization
Impact Measurement:
- SDG Score: 81/100 - UN Sustainable Development Goals alignment
- Borrower demographics - 68% women borrowers, agricultural workers, entrepreneurs
- Sector distribution - 45% agriculture, 30% small business, 15% education, 10% healthcare
- Social metrics - Jobs created, families impacted, CO2 offset tracking
Technical Architecture:
- Cross-chain bridge - Base (institutional) ↔ Ethereum (microfinance)
- Smart contract integration - Direct reads from deployed contracts (0x3cC2c2F0...27E1274DC)
- Verified transactions - Etherscan proof: 0x05b8af9b...f416af
- Timestamp tracking - Shows data freshness and update history
Business Vision: "One Platform. Every Scale. Total Transparency." - From $100M syndications to $500 microloans.
- Comprehensive risk heatmap visualization
- Multi-party collaboration tracking
- Obligation timeline with covenant monitoring
- Event standardization (LMA-aligned taxonomy)
- Extended metrics dashboard with demographic breakdowns
Agent banks currently rely on spreadsheets and email chains to track loan obligations.
LoanChain Ledger addresses three critical business needs:
-
Reduced Reconciliation Effort
- Eliminate manual reconciliation between syndicate members
- Single shared platform reduces back-and-forth communications
- Estimated 60-70% reduction in reconciliation time
-
Shortened Audit Preparation
- Complete audit trail instantly available for regulators
- No need to gather scattered documents across systems
- Estimated 50% reduction in audit prep time
-
Improved Syndicate Trust
- Verifiable records prevent disputes
- All members see the same information simultaneously
- Cryptographic proof eliminates "he said, she said" scenarios
Business Language Translation:
- Instead of "gas fees" → "transaction verification"
- Instead of "blockchain hash" → "verifiable record ID"
- Instead of "on-chain" → "permanently recorded"
- Instead of "wallet" → "authorized access"
- Next.js 15 - React framework with App Router
- TypeScript - Type-safe development
- Tailwind CSS - Enterprise-grade UI
- Lucide React - Professional iconography
- Framer Motion - Smooth animations and transitions
- OpenAI GPT-4o-mini - Intelligent chatbot for user onboarding
- Context-aware AI - Understands LoanChain features and guides users
- Base L2 - Ethereum Layer 2 for low-cost verification
- OnchainKit - Coinbase's enterprise blockchain toolkit
- Wagmi - Wallet connectivity and transaction signing
- Viem - TypeScript Ethereum utilities
- Pinata IPFS - Decentralized document storage
- IPFS Gateway - Global access to stored documents
- Content Addressing - Immutable file identifiers (CIDs)
- Solidity Smart Contracts - Immutable record keeper
- LoanRegistry.sol - Core loan lifecycle contract
- Node.js 18+ and npm/pnpm
- MetaMask or Coinbase Wallet (optional - demo mode available)
- Base Sepolia testnet ETH (for testing transactions)
- Clone the repository
git clone <repository-url>
cd loanchain-ledger- Install dependencies
npm install
# or
pnpm install- Run the development server
npm run dev
# or
pnpm dev- Open in browser
Navigate to
http://localhost:3000
-
Open Remix
-
Create Contract File
- Create new file:
LoanRegistry.sol - Copy content from
src/contracts/LoanRegistry.sol
- Create new file:
-
Compile
- Select compiler version:
0.8.20 - Click "Compile LoanRegistry.sol"
- Select compiler version:
-
Deploy
- Switch to "Deploy & Run Transactions" tab
- Environment: "Injected Provider - MetaMask"
- Network: Base Sepolia (Chain ID: 84532)
- Click "Deploy"
- Confirm transaction in MetaMask
-
Update Frontend
- Copy deployed contract address
- Update
LOAN_REGISTRY_ADDRESSinsrc/lib/contracts.ts
# Install Hardhat
npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox
# Initialize Hardhat project
npx hardhat init
# Deploy to Base Sepolia
npx hardhat run scripts/deploy.js --network base-sepolia-
Explore Without Wallet
- Open the application
- View demo loans with different statuses (Active, At Risk, etc.)
- Browse audit trail showing who made changes and when
- Test search and filter functionality
- Perfect for presentations to judges and stakeholders
-
Use AI Assistant
- Click the floating blue chat button (bottom-right)
- Ask questions about LoanChain features
- Use quick prompts to learn about risk heatmaps, GreenLend integration, etc.
- AI explains everything in simple, non-technical language
-
No Technical Knowledge Required
- All features visible and explorable
- Demo data showcases full loan lifecycle
- Focus on business value, not technical complexity
-
Connect Wallet
- Click "Connect Wallet" button
- Select your wallet (MetaMask, Coinbase, etc.)
- Approve connection request
- Ensure you're on Base Sepolia network
-
View Real Loans
- Connected wallet shows actual blockchain-verified loans
- Portfolio metrics reflect verified data
- Transaction records link to blockchain explorer
-
Create New Loan
- Navigate to "Create Loan" tab
- Option A: Use Templates
- Click "Show Templates"
- Select from: Small Business Loan, Real Estate Project, or Equipment Financing
- Click template to auto-fill all fields
- Option B: Manual Entry
- Fill in loan details manually
- Watch live calculations update (monthly payment, total interest, total payment)
- Click "Create Loan on Blockchain"
- Confirm transaction in wallet
- Wait for verification
-
Manage Obligations
- Switch between List, Calendar, and Timeline views
- Filter by status, type, or search by loan ID
- Hover over obligation cards for quick actions
- Mark obligations complete or set reminders
- Export obligations to CSV for reporting
-
Upload Documents
- Go to "Documents" tab
- Batch Upload: Select multiple files (up to 50MB total)
- Choose document category
- Files automatically upload to IPFS via Pinata
- View IPFS CID and gateway URL for each document
- Download from IPFS to retrieve files from decentralized storage
- Mint as NFT to create blockchain-verified document tokens
- Generate QR Code for mobile-friendly verification
-
Verify Records
- Click any transaction in the audit trail
- Opens blockchain explorer for third-party verification
- View immutable proof of transaction
Draft → Active → At Risk → Breach → Closed
↓
(Normal completion)
↓
Closed
Status Definitions:
- Draft: Loan being prepared, not yet active
- Active: Loan performing normally, all obligations met
- At Risk: Covenant breach warning or payment delay
- Breach: Formal breach of loan agreement
- Closed: Loan fully repaid or written off
contract LoanRegistry {
struct Loan {
address borrower;
uint256 amount;
uint256 interestRate;
uint256 termMonths;
string collateralType;
uint256 timestamp;
}
mapping(uint256 => Loan) public loans;
uint256 public loanCount;
event LoanCreated(uint256 indexed loanId, ...);
}src/
├── app/
│ ├── page.tsx # Main dashboard
│ ├── layout.tsx # Root layout with providers
│ ├── providers.tsx # Wagmi + OnchainKit setup
│ ├── config/
│ │ └── onchainkit.ts # API configuration
│ └── api/
│ ├── chat/route.ts # AI chatbot endpoint
│ └── pinata/route.ts # IPFS upload endpoint
├── components/
│ ├── loan/
│ │ ├── LoanDashboard.tsx # Loan lifecycle view
│ │ ├── RiskHeatmap.tsx # Risk visualization
│ │ ├── ObligationTimeline.tsx # Enhanced obligations tab
│ │ ├── CreateLoanTab.tsx # Enhanced create tab with templates
│ │ ├── DocumentsTab.tsx # Enhanced documents with IPFS
│ │ ├── MicrofinanceImpactTab.tsx # GreenLend integration
│ │ ├── ExtendedMetrics.tsx # Demographics & impact
│ │ ├── ArchitectureDiagram.tsx # Cross-chain visualization
│ │ ├── AboutSection.tsx # App information
│ │ └── AIChatbot.tsx # AI onboarding assistant
│ └── ui/ # shadcn/ui components
├── hooks/
│ ├── useLoanContract.ts # Contract interactions
│ └── useGreenLendPortfolio.ts # GreenLend API integration
├── lib/
│ ├── wagmi.ts # Wagmi configuration
│ ├── contracts.ts # Contract ABI and helpers
│ └── greenlend-integration.ts # GreenLend config & types
└── contracts/
└── LoanRegistry.sol # Solidity contract
┌─────────────────────────────────────┐
│ INSTITUTIONAL CAPITAL (Base) │
│ LoanChain: $100M+ Syndications │
│ • Risk Heatmap │
│ • Obligation Timeline │
│ • Multi-Party Collaboration │
└──────────────┬──────────────────────┘
│
Live API
(Read Portfolio Data)
│
┌──────────────▼──────────────────────┐
│ GRASSROOTS IMPACT (Ethereum) │
│ GreenLend: Microfinance @ Scale │
│ • 847 Active Loans │
│ • $2.3M Total Disbursed │
│ • SDG Impact Tracking │
└─────────────────────────────────────┘
One Platform. Every Scale. Total Transparency.
Integration Benefits:
- Unified Visibility: View both institutional syndications and microfinance portfolios
- Real-Time Data: Live API integration with GreenLend on Ethereum Sepolia
- Impact Measurement: SDG scores and borrower demographics integrated
- Scalability Vision: Demonstrates platform capability across lending segments
┌─────────────────────────────────────┐
│ LOANCHAIN FRONTEND │
│ • Document Upload │
│ • Metadata Generation │
│ • SHA-256 Hashing │
└──────────────┬──────────────────────┘
│
POST /api/pinata
(Multipart Form Data)
│
┌──────────────▼──────────────────────┐
│ PINATA IPFS SERVICE │
│ • Pinning Service │
│ • Gateway Access │
│ • Content Addressing (CID) │
└──────────────┬──────────────────────┘
│
IPFS Network
(Decentralized Storage)
│
┌──────────────▼──────────────────────┐
│ GLOBAL ACCESS │
│ • gateway.pinata.cloud │
│ • Permanent Storage │
│ • Tamper-Proof Files │
└─────────────────────────────────────┘
-
Operational Efficiency
- Reduce reconciliation time by 60-70%
- Shorten audit preparation by 50%
- Single platform replaces fragmented systems
-
Risk Management
- Proactive identification of loans at risk
- Clear status indicators for portfolio health
- Early warning system for covenant breaches
-
Compliance & Trust
- Complete, immutable audit trail
- Verifiable records for regulators
- Eliminate disputes between syndicate members
-
Enterprise Ready
- Desktop-first design for financial professionals
- Works without blockchain knowledge
- Scales on Base L2 infrastructure
Minute 1: The Problem (30 seconds)
- Agent banks track loans across spreadsheets and emails
- Reconciliation between syndicate members is manual and slow
- Audit preparation requires gathering scattered documents
- Disputes arise from lack of shared, verifiable records
Minute 2: The Solution (90 seconds)
- AI Assistant: Click floating chat button → Ask "What is LoanChain?" → Show intelligent guidance
- Dashboard Overview: Show portfolio with loan statuses (Active, At Risk)
- Create Loan:
- Show "Quick Start Templates" → Click template → All fields auto-filled
- Type loan amount → Watch live calculations update (monthly payment, total interest)
- Enhanced Obligations:
- Switch between List/Calendar/Timeline views
- Filter obligations dynamically
- Hover over cards → Show quick actions (Mark Complete, Set Reminder, Escalate)
- Export to CSV
- Documents Tab:
- Upload multiple documents at once
- Show IPFS CID and gateway URL
- Click "Download from IPFS" → Retrieve from decentralized storage
- Generate QR code for mobile verification
- Mint document as NFT on Base
- 🔥 HERO MOMENT - Cross-Chain Integration: Switch to "Microfinance Impact" tab
- Click Refresh button → Watch numbers update dynamically!
- "Live Cross-Chain" badge → Proves real Ethereum integration
- 855 active microloans, $2.25M disbursed, 94.2% repayment rate
- 81/100 SDG Score → Environmental & social impact
- 5 countries visible → Kenya, Bangladesh, Peru, Philippines, Ghana
- Show architecture infographic → Base ↔ Ethereum bridge visualization
- Scroll to impact metrics → Jobs, families, CO2 offset, women borrowers
- Technical Proof: Show Etherscan transaction (0x05b8af9b...f416af)
- Contract Address: Deployed at 0x3cC2c2F0...27E1274DC on Ethereum Sepolia
Minute 3: The Impact (60 seconds)
- Time Savings: 60-70% reduction in reconciliation effort
- Audit Efficiency: 50% faster audit preparation
- Trust & Compliance: Immutable records eliminate disputes
- Scalability: Built on Base L2 for enterprise-grade performance
- Cross-Chain Vision: "One platform. Every scale. From $100M syndications to $500 microloans."
- AI Onboarding: Intelligent assistant helps users navigate complex features
- Decentralized Storage: Documents permanently stored on IPFS, not centralized servers
- 🏆 Cross-Chain Bridge - ONLY platform connecting institutional loans to grassroots microfinance via blockchain
- 🔗 Live Integration - Real data from deployed Ethereum contracts (not mockups!)
- 🌍 Greener Lending Focus - Sustainable microfinance with SDG tracking built-in
- 📊 Dual-Scale Visibility - $100M syndications AND $500 microloans on one platform
- 🤖 AI Onboarding - Intelligent chatbot guides users through complex features
- 📄 IPFS Storage - Decentralized document storage with Pinata integration
- 💎 NFT Minting - Documents can be minted as NFTs on Base for extra verification
- Smart contracts should be audited before mainnet deployment
- Private keys never exposed or stored
- Transaction signing happens in user's wallet
- Read-only operations don't require wallet connection
- Demo mode uses simulated data only
- IPFS files are public - Do not upload sensitive documents in production without encryption
- Pinata API credentials hardcoded for demo purposes - Use environment variables in production
- Loan lifecycle tracking
- Blockchain verification (Base L2)
- Audit trail visualization
- Status monitoring (Active, At Risk, etc.)
- Risk heatmap with real-time visualization
- Obligation timeline with covenant monitoring
- Event standardization (LMA-aligned taxonomy)
- GreenLend cross-chain integration
- Live API integration with Ethereum Sepolia
- Real-time microfinance portfolio data (855+ loans)
- Borrower demographics and impact stories
- SDG alignment tracking
- Manual refresh with timestamp tracking
- Cross-chain architecture visualization
- AI Onboarding Assistant
- Context-aware chatbot powered by OpenAI
- Quick prompts for common questions
- Floating UI with smooth animations
- Enhanced Create Tab
- Quick start templates (3 pre-configured loans)
- Live loan calculations (monthly payment, total interest, total payment)
- Improved UX with clear form and show templates
- Enhanced Obligations Tab
- Advanced filtering (search, type, status)
- 3 view modes (List, Calendar, Timeline)
- Quick actions (Mark Complete, Set Reminder, Escalate)
- Stats dashboard with 5 key metrics
- CSV export functionality
- Enhanced Documents Tab
- Pinata IPFS integration for decentralized storage
- Batch upload (up to 50MB)
- Advanced search & filter (by name, SHA-256, IPFS CID)
- NFT minting simulation on Base
- QR code generation for mobile verification
- Document categorization (5 categories)
- Cross-chain capital bridge (Base ↔ Ethereum)
- LayerZero/Axelar integration for institutional capital pooling
- Tokenized microfinance portfolio tranches
- Secondary market for portfolio exposures
- Advanced covenant compliance tracking
- Automated payment schedule monitoring
- Smart status transitions with ML risk prediction
- Alert notifications for loans at risk
- Document encryption for IPFS uploads
- Real NFT minting with metadata on Base mainnet
- Multi-signature syndicate approvals
- REST API for legacy system integration
- Role-based access control (RBAC)
- Advanced analytics dashboard with ML insights
- Export functionality (PDF/Excel reports)
- Multi-chain expansion (Optimism, Arbitrum, Polygon)
- Institutional custody integration (Fireblocks, Anchorage)
- AI-powered risk scoring and fraud detection
- Arweave integration for permanent document storage
This project was built for the LMA Edge Hackathon. For inquiries or collaboration:
- Review the codebase structure
- Check existing issues/features
- Follow TypeScript and Solidity best practices
- Test thoroughly on Base Sepolia before mainnet
- LMA Edge Hackathon for the opportunity to innovate
- Base for enterprise-grade blockchain infrastructure
- Coinbase for OnchainKit developer tools
- Wagmi and Viem teams for excellent tooling
- Pinata for decentralized IPFS storage
- OpenAI for GPT-4o-mini powering the AI assistant
For technical questions or demo requests during the hackathon:
- Review
DEPLOYMENT.mdfor detailed deployment guide - Check blockchain explorer for transaction verification
- Test on Base Sepolia before mainnet deployment
Built for the LMA Edge Hackathon | Keeping Loans on Track Category