BoneMesh is a point-to-point mesh network protocol with implementations in multiple languages.
Traffic is authenticated and encrypted on every hop with NIST post-quantum cryptography, and nodes route for one another. Seven implementations — Java, Go, Rust, PHP, Elixir, JavaScript (Node.js), and Python — all speak the same wire protocol, so a mesh can be any mix of languages.
This repository is organized as a super-repo:
| Folder | Contents |
|---|---|
docs/ |
Project-wide documentation: guides, plan, decisions, defect registry |
spec/ |
The protocol specification, shared test corpora, and the conformance runner |
interop/ |
The multiprotocol test suite that exercises implementations together |
java/ |
The Java implementation (the original, and the v3 reference) |
go/, rust/, php/, elixir/, js/, python/ |
The other six full implementations |
- docs/user-guide.md — start here: concepts, standing up a mesh, running and embedding a node, the security model.
- docs/architecture.md — how it is built: the protocol stack, cryptography, routing, and the cross-language testing regime.
- docs/testing.md — the testing guide: the tier map, the reaper tenants and how to run one, the interop battery, seed replay, the environment tunables, the gated long soak, and a key-log debugging walkthrough.
- Per-language quickstarts — build, test, and run the interop driver for one implementation: go · rust · js · php · elixir · python · java.
- spec/protocol.md and spec/security.md — the normative wire and security specifications.
- docs/PLAN.md, docs/decisions.md, docs/defects.md — the roadmap and design/defect registries.
Copyright (c) 2019-2026 Axonibyte Innovations, LLC. Released under the Apache License, Version 2.0.
Authored and maintained primarily by Caleb L. Power.
This repository lives on Bitbucket. Other remote repository hosting providers (e.g. GitHub) serve as mirrors.