How varunsingh7389/meshpay-offline-upi-payments-over-mesh works
MeshPay is a Spring Boot proof-of-concept for offline UPI payments relayed through an in-memory device mesh. A sender composes a payment; it is encrypted into a packet, gossiped across devices, and uploaded by a bridge. Backend ingestion verifies and decrypts it, checks duplicates and freshness, then transactionally settles and records the payment. The dashboard exposes the demo flow and ledger. Relationships below follow README documentation; source excerpts were unavailable, so implementation-level call details are not inferred.
Main entry points: BridgeIngestionService.java Bridge Ingestion · ApiController.java REST API · DemoService.java Demo Payment Setup · MeshSimulatorService.java Mesh Simulator
Components 18
Demo and API
- Payment Dashboard
upimesh/src/main/resources/templates/dashboard.html - Dashboard Controller
upimesh/src/main/java/com/demo/upimesh/controller/DashboardController.java - REST API
upimesh/src/main/java/com/demo/upimesh/controller/ApiController.java - Demo Payment Setup
upimesh/src/main/java/com/demo/upimesh/service/DemoService.java
Offline Mesh
- Mesh Simulator
upimesh/src/main/java/com/demo/upimesh/service/MeshSimulatorService.java - Virtual Device
upimesh/src/main/java/com/demo/upimesh/service/VirtualDevice.java - Encrypted Mesh Packet
upimesh/src/main/java/com/demo/upimesh/model/MeshPacket.java
Secure Ingestion
- Bridge Ingestion
upimesh/src/main/java/com/demo/upimesh/service/BridgeIngestionService.java - Hybrid Crypto
upimesh/src/main/java/com/demo/upimesh/crypto/HybridCryptoService.java - Server Key Holder
upimesh/src/main/java/com/demo/upimesh/crypto/ServerKeyHolder.java - Payment Instruction
upimesh/src/main/java/com/demo/upimesh/model/PaymentInstruction.java - Idempotency Check
upimesh/src/main/java/com/demo/upimesh/service/IdempotencyService.java
Settlement and Ledger
- Transactional Settlement
upimesh/src/main/java/com/demo/upimesh/service/SettlementService.java - Account Repository
upimesh/src/main/java/com/demo/upimesh/repository/AccountRepository.java - Transaction Repository
upimesh/src/main/java/com/demo/upimesh/repository/TransactionRepository.java - Settled Transaction
upimesh/src/main/java/com/demo/upimesh/model/Transaction.java
Other components
- Payment Sender
- Bridge Node
Connections 18
- Payment Sender → Payment Dashboard: composes payment
README.md - Payment Dashboard → Dashboard Controller: loads
README.md - Payment Sender → REST API: injects payment
README.md - REST API → Demo Payment Setup: starts demo
- Demo Payment Setup → Encrypted Mesh Packet: creates encrypted
README.md - Demo Payment Setup → Mesh Simulator: injects packet
README.md - Mesh Simulator → Virtual Device: simulates hops
README.md - Mesh Simulator → Encrypted Mesh Packet: relays with TTL
README.md - Bridge Node → REST API: uploads packet
README.md - REST API → Bridge Ingestion: ingests packet
README.md - Bridge Ingestion → Hybrid Crypto: verifies and decrypts
README.md - Hybrid Crypto → Server Key Holder: uses private key
README.md - Hybrid Crypto → Payment Instruction: decrypts payload
README.md - Bridge Ingestion → Idempotency Check: rejects duplicates
README.md - Bridge Ingestion → Transactional Settlement: settles verified payment
README.md - Transactional Settlement → Account Repository: debits and credits
README.md - Transactional Settlement → Transaction Repository: records settlement
README.md - Transaction Repository → Settled Transaction: persists record
README.md