filament-core
Core abstractions, error types, runtime traits.
Runtime 01 — Transport stack
Filament. The transport stack.
Eight crates that move signed payloads between peers. Noise-protocol-encrypted channels with strict forward secrecy, zero-copy packet handling at the link layer, constant-time cryptographic primitives, configurable routing tables, and first-class telemetry. The substrate everything above the wire depends on.
A closer lookBytes in motion. Context intact.
The transport layer connects peers and carries the bytes that make the fabric useful.
- 01Choose the connection
- 02Move the bytes
- 03Deliver to the peer
Eight crates · Noise-encrypted · Zero-copy · Constant-time
01 — Crates
Eight crates, one transport stack.
filament-crypto
Noise handshake, AEAD streams, constant-time primitives.
filament-interfaces
Network interface enumeration, addressing, NAT hints.
filament-link
Link-layer framing, zero-copy buffers, MTU handling.
filament-packet
Wire packet format, header layout, fragmentation.
filament-transport
Pluggable transports (UDP, TCP, QUIC) over a common trait.
filament-types
Shared protocol types — peer ids, session keys, channels.
filament-utilities
Telemetry, instrumentation, tracing hooks.
02 — Code
A handful of lines.
use filament_transport::Transport;
use filament_crypto::Session;
let transport = Transport::udp("0.0.0.0:9912").await?;
let mut session = Session::handshake_xx(&transport, peer_pubkey).await?;
session.send(b"hello, peer").await?;
let reply = session.recv().await?;
println!("got: {}", String::from_utf8_lossy(&reply));03 — Capabilities
What the transport gives you.
Forward secrecy
Noise-protocol-encrypted channels — strict forward secrecy on every session.
Zero copy
Zero-copy packet handling — buffers are never moved between layers.
Constant time
Constant-time crypto — no timing-side-channel leaks on session keys.
Routing policy
Configurable routing — per-peer policy without recompilation.
Telemetry
Built-in telemetry — every link reports loss, jitter, and handshake state.
Pluggable transports
Pluggable transports — same wire format over UDP, TCP, or QUIC.
Move bytes
with confidence.
Filament is the transport layer used by every higher-level Weave protocol. Start with the SDK, or read the source.