⚡ BitLoan

Empowering peer-to-peer lending with the speed of the Lightning Network.

---

🌐 About the Project

BitLoan is a decentralized, peer-to-peer lending platform built at the MIT Bitcoin Hackathon 2025. It enables users to lend and borrow Bitcoin instantly using the Lightning Network, significantly reducing fees and wait times.

The platform is built with an emphasis on speed, security, and usability, making decentralized finance (DeFi) more accessible than ever.

---

📺 Watch the Demo Video

👉 Click here to watch the demo

✨ Features

• 💸 Instant Loans: Enable fast lending and repayment using the Lightning Network.
• ⚡ Lightning-Powered: Integrated with LNbits for seamless Bitcoin transactions.
• 🔐 Secure Wallets: Manage funds with robust wallet infrastructure.
• 🧠 Smart Matching: Lenders and borrowers matched intelligently.
• 🎯 User-Friendly Interface: Intuitive frontend built with modern web tech.
• 🔧 Modular Architecture: Easy to extend and integrate with new services.

---

🛠️ Tech Stack

🛠️ Tech Stack

🌍 Frontend

• Next.js
• Streamlit (for dashboard & visualization features)
• TypeScript
• Tailwind CSS
• ESLint, Prettier

🧠 Backend

• Python
• FastAPI
• LNbits API
• Voltage API

⚡ Lightning Network

• LNbits
• Docker

---

📦 Prerequisites

Before you begin, make sure you have the following installed:

• Node.js (v18+)
• Python (3.8+)
• Docker
• Git

---

🚀 Getting Started

1. Clone the Repository

git clone [repository-url]
cd bitloan

2. Frontend Setup

cd frontend
npm install
npm run dev

3. Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate
pip install -r requirements.txt
python main.py

4. Lightning Network Setup

[Instructions for setting up LNbits with Docker will be added]

🏗️ Project Structure

bitloan/
├── frontend/          # Next.js frontend application
├── backend/           # Python backend server
├── app/              # LNbits integration and demo
│   ├── src/          # Source code
│   └── requirements.txt
└── nodes/            # Lightning Network node configurations

🔑 Key Features

• Instant peer-to-peer lending
• Lightning Network integration
• Real-time payment processing
• Secure wallet management
• User-friendly interface

📚 Documentation

• Frontend Documentation
• Backend Documentation
• LNbits Integration
• Voltage API Documentation

🤝 How to Contribute We welcome contributions from developers of all backgrounds! 🙌

1.Fork the repo

2.Create your branch: git checkout -b feature/AmazingFeature

3.Commit your changes: git commit -m 'Add AmazingFeature'

4.Push to the branch: git push origin feature/AmazingFeature

5.Open a Pull Request 🚀

📝 License Distributed under the MIT License. See LICENSE for more details.

🙏 Acknowledgments Special thanks to:

🏛️ MIT Bitcoin Hackathon 2025

⚡ LNbits Team

🔌 Voltage API Team

💡 All contributors, testers, and friends who supported this project

📧 Contact

For questions and support, please open an issue in the repository.