The peer-to-peer net under WeirdBrains apps
Weirdnet is a set of crates for apps that talk to each other directly: a libp2p node, signed invitations and key exchanges, sealed messages, identities that work across apps, and relays for the devices NAT hides.
What Weirdnet is
The apps keep their own data, storage and policy. The crates bring the wire and the cryptography, so every WeirdBrains app speaks the same network.
How the net holds together
Five ideas carry everything else. Each links to the details.
Identities
A user key for the person, a node key per device, certificates that tie them together.
Read more →Invitations
Signed offers and answers. Both sides derive one key and a short code to compare.
Read more →Sealed messages
Requests sealed under the exchange key, bound to the exchange, the peers and the direction.
Read more →Discovery
mDNS on the local network, Kademlia from bootstrap nodes, relays found by provider key.
Read more →Relays
Devices behind NAT reserve a slot. Hole punching first, the relay circuit as the fallback.
Read more →The pieces
Each crate does one job and lives in its own WeirdBrains repository.
weirdnet-net
The libp2p node, key exchanges, invitations, sealed messaging, identities and certificates.
weirdnet-relaynew
A relay and bootstrap node you can run: circuit relay v2, Kademlia server, an info page.
weirdnet-keys
256-bit keys, BIP39 words, Shamir shards, KDFs, sealing, X25519 and an envelope keyring.
weirdnet-storage
SQLCipher databases opened with a caller-supplied raw key, migrations, savepoints, sync change log.
weirdnet-update
Signed update metadata: org roots, manifests, freshness, verification, targeting, rollouts, consent, boot health.
weirdnet-accounts
Argon2id passwords, hashed tokens, name rules, per-client rate limits, org-scoped API keys.
weirdnet-mcp
A transport-agnostic Model Context Protocol tools server and stdio bridge.
weirdnet-plugin
The plugin SDK: the stable C ABI (v2), host API, frames and result views.
weirdnet-code-spaces
Math, Polars, Rust and typed Python sources compiled into plugins against the plugin SDK.
weirdnet-pipelines
DAGs of application-defined sources, steps and sinks with validation, ordering and a runner.
weirdnet-rules
If-this-then-that rule specs, conditions, schedules and a loop-protected engine.
weirdnet-render
Tables and line charts (or JSON describing them) drawn to PNG with input checks and size limits.
weirdnet-themes
A TOML theme format: dark and light variants, semantic colour roles, contrast checks.
Built on Weirdnet
Morph
A distributed web browser with local AI. Identity, device linking and peer sites on Weirdnet.
Muninn
The data ingestor most of Weirdnet’s crates were extracted from.
TAUR
An alternative Arch user repository server, on weirdnet-accounts and weirdnet-mcp.
Salty Gull
Signed, consent-first over-the-air updates, on weirdnet-update.