Macula HTTP/3 Mesh
Self-organizing distributed mesh for decentralized applications
BEAM-Native • HTTP/3 (QUIC) • Kademlia DHT • NAT Traversal • Multi-Tenant • Platform Layer
Documentation
- 🚀 Getting Started - Installation, quick start, code examples
- 🏗️ Architecture Guide - Visual guide with C4 diagrams, deployment topologies
- 📄 Changelog - Version history and migration guides
- 🧪 Development Guide - Contributing and testing
- 🌐 DHT Guide - Kademlia DHT architecture
Latest Release: v0.12.5 (2025-11-30)
NAT Traversal & Connectivity:
- ✅ Complete NAT traversal with hole-punching and relay fallback
- ✅ Connection pooling with 94.5% hit rate
- ✅ Docker NAT simulation for testing (Full Cone, Restricted, Symmetric)
NATS-style Async RPC:
- ✅ Fire-and-forget request pattern with inbox callbacks
- ✅ Direct P2P delivery (not routed through Bootstrap)
- ✅ Pull-based service discovery with prefetch on startup
PubSub Delivery Metrics:
- ✅ Sequence numbers and per-peer delivery tracking
- ✅ Colored console output for demos (ANSI colors)
- ✅ Delivery rate calculations per sender
Platform Features (v0.9.0+):
- ✅ Ra/Raft consensus for distributed coordination
- ✅ LWW-Register CRDT for eventually-consistent state
- ✅ Leader election and workload registration APIs
Community
- Hex: hex.pm/packages/macula
- GitHub: github.com/macula-io/macula
- Issues: github.com/macula-io/macula/issues
Built with ❤️ for the BEAM community