Overview
View Source
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.14.0 (2025-12-01)
Masterless CRDT Architecture (v0.14.0):
- ✅ Ra/Raft consensus removed - fully masterless operation
- ✅ OR-Set CRDT for distributed membership
- ✅ G-Counter and PN-Counter CRDTs for distributed counters
- ✅ LWW-Register CRDT for eventually-consistent state
Hierarchical DHT with Bridge System (v0.13.0):
- ✅ Fractal mesh hierarchy (Cluster → Street → City → Region)
- ✅ Query escalation to parent levels on local cache miss
- ✅ TTL-based caching with LRU eviction
NAT Traversal & Connectivity (v0.12.x):
- ✅ Complete NAT traversal with hole-punching and relay fallback
- ✅ Connection pooling with 94.5% hit rate
- ✅ NATS-style async RPC with direct P2P delivery
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