Home Page
Dashboard
Reels Page
Exchange Page
Finalizing Details
Transaction Summary
Backend Details

About the Project – HufflePay 🦡✨

Inspiration 💡

As international students, we constantly face high costs when making cross-border transactions. From high transaction fees to slow processing times, sending money across borders has been a frustrating experience. This inspired us to build HufflePay — a decentralized, secure, and low-fee stablecoin transfer platform with a unique social component.

Our vision was sparked by the values of House Hufflepuff from Hogwarts — trustworthy, dedicated, and loyal. We wanted to create something that reflected those values, making international transactions more affordable, accessible, and community-driven.

What It Does 🔄

HufflePay combines the functionality of a cross-currency payment platform with social networking features:

Cross-Currency Exchange: Send money in one currency, receive in another instantly
Social Feed: Share your financial activities and connect with friends
Dashboard Analytics: Track your transactions, balance, and rewards
Cashback Rewards: Earn cashback on your transactions
Multiple Currency Support: USDT (Tether USD), USDC (USD Coin), EURT (Tether Euro), GBPT (Pound Tether), Bitcoin (BTC), and many more!

The platform enables users to send money globally with minimal fees (just 0.5%), making international transfers affordable and accessible to everyone.

How We Built It ⚙️

Frontend: React.js with Next.js for server-side rendering
Styling: Tailwind CSS for responsive design
Routing: React Router with protected routes
Backend: Node.js/Express with MongoDB
Authentication: JWT-based auth system with secure token handling
Cross-Currency Engine: Lightning Network integration with Taproot Assets support
Real-time Updates: WebSocket for live transaction tracking
Charts/Dashboard: Custom data visualizations for financial insights
Containerization: Docker for consistent development and deployment environments
Infrastructure: Docker Compose for orchestrating multi-container setup

Technical Architecture

Frontend Components

Authentication Flow: Secure login/registration with JWT
Home Feed: Social updates with transaction sharing
Dashboard: Transaction history, currency converter, analytics
Exchange Wizard: Step-by-step interface for currency conversion
Wallet Management: Multi-currency wallet support

Backend Services

Authentication Service: User management and security
Lightning Service: Integration with Lightning Network for payments
Exchange Service: Real-time currency conversion
Transaction Service: Payment processing and history
Swap Engine: Cross-asset atomic swaps with HTLCs

DevOps & Deployment

Docker Containers: Isolated environments for frontend, backend, and database
Microservices Architecture: Modular services for better scalability
Environment Parity: Consistent development, testing, and production environments
Easy Deployment: One-command setup with Docker Compose

⚙️ Protocol Deep Dive — How Stablecoin Swap Works

🔐 Preparing the Swap: Shared Hash Preimage
- The Edge Node generates a secret s and computes its hash H = SHA256(s).
- Both payment legs use H as the lock condition — enabling atomicity (both succeed or both fail).
🧾 Recipient's Invoice in Target Currency
- Recipient generates a Lightning invoice in their preferred currency (e.g., EUR)
- Includes timelock (CLTV) for refund if settlement fails.
📥 Sender's Payment in Source Currency
- Sender's wallet sees recipient's invoice and calculates equivalent amount in their currency (e.g., USD)
- Edge Node creates a Hold Invoice with the same hash on the sender's channel.
🔄 HTLC Execution
- Leg 1: Sender → Edge (HTLC in source currency locked by hash)
- Leg 2: Edge → Recipient (HTLC in target currency locked by hash)
- Once the secret is revealed by either party, both legs settle.
✅ Atomic Settlement
- Recipient receives payment in their preferred currency
- Edge node receives payment in sender's currency
- If either leg fails, both time out and funds are refunded.

What We Learned 📚

Implementing secure, cross-currency payment systems
Integrating Lightning Network technology with user-friendly interfaces
Creating a seamless UX for complex financial operations
Building a full-stack application with real-time data synchronization
Developing a cashback rewards system to incentivize platform usage
Using Docker for containerization and deployment automation
Implementing microservices architecture for scalable applications

Challenges We Faced 🚧

Designing an intuitive UI for complex financial operations
Implementing secure wallet management
Creating real-time transaction tracking
Making currency conversion transparent and user-friendly
Balancing technical complexity with ease of use
Orchestrating multiple containers with proper networking
Ensuring data persistence across Docker deployments

What Makes HufflePay Unique ✨

Feature	HufflePay	Coinbase	Other Decentralized Apps
Transaction Fees	0.5%	0%–3.99% depending on type	Typically low but varies by dApp
Instant Transactions	Yes	Yes	Yes
Social Feed	Yes (track and share transactions)	No	Rarely implemented
Multi-Currency	Full support (fiat & crypto)	Limited	Usually crypto-only
Cashback Rewards	Yes	Limited	Rarely offered
User Experience	Simple, wizard-based flows	Complex for beginners	Often technical and difficult
Deployment	Containerized & portable	Proprietary infrastructure	Varies widely

Accomplishments That We're Proud Of 🏆

Created a fully functional currency exchange system
Built an intuitive, step-by-step exchange flow
Implemented a working dashboard with transaction tracking
Designed a clean, responsive UI that works across devices
Successfully integrated social features with financial tools
Containerized the entire application with Docker for easy deployment
Created a scalable architecture that can handle growing user demands

What's Next for HufflePay 🚀

Mobile app development for iOS and Android
Enhanced security features including multi-factor authentication
Additional currency support with more stablecoins
Advanced analytics for spending patterns and recommendations
Integration with popular payment methods and banking systems
Expanded social features including groups and communities
Kubernetes deployment for production-grade scaling and resilience

Final Thoughts 🌍

HufflePay isn't just a money transfer app. It's a magical ecosystem where people connect, share, and transact — without borders or burdens. We're bringing the trustworthiness and loyalty of Hufflepuff to international financial transactions, making global transfers as simple as waving a wand. 🪄✨