Open reference implementation of the Bolt Protocol for encrypted device-to-device file transfer.
The SDK that all Bolt-based applications embed to speak Bolt Core. One codepath for pairing, TOFU pinning, handshake gating, envelope encryption, and the transfer state machine.
Note: The Bolt Protocol specification (PROTOCOL.md, LOCALBOLT_PROFILE.md) currently resides in this repository until bolt-protocol is fully separated.
| Document | Description |
|---|---|
| PROTOCOL.md | Bolt Protocol Core v1. Transport-agnostic specification. |
| LOCALBOLT_PROFILE.md | LocalBolt Profile v1. Transport binding for the browser peer channel. |
- Pluggable Profile bindings: apps provide Profile adapters (rendezvous + peer channel + encoding hooks)
- Deterministic behavior: canonical serialization per Profile, stable state machine, strict conformance checks
- Small surface area: minimal public API, strong invariants, reliable defaults
- Transport-agnostic at Core level
- Does not implement discovery or routing
- Does not define UI or product policy
- Does not require a daemon
| Relationship | Repository |
|---|---|
| Specification | bolt-protocol |
| Depends on this | localbolt, localbolt-app, localbolt-v3, bytebolt-app, bolt-daemon |
- Rust crate:
bolt-core - TypeScript package:
@the9ines/bolt-core
As of version 0.1.0, the public API surface is considered stable under Semantic Versioning 2.0.0. See docs/SDK_STABILITY.md for the full stability contract, versioning policy, and breaking change checklist.
| Document | Version | Status |
|---|---|---|
| Bolt Core v1 | 1.0.0 | Draft |
| LocalBolt Profile v1 | 1.0.0 | Draft |
MIT