Linux for networks. Carry one binary and a keypair.

Multi-path transports, plug-in security, peer-key addressing, a real SSH replacement. The kernel is minimal — the brand is the ecosystem.

gn::sdk::Core core;
auto session = core.connect_to("ice://QFK4...XYZ7");
session.send("hello");

Reading

Two essays. One on the human cost of the 1983 decision. One on what the fix looks like.

The Network Layer We Always Deserved

Every programmer has fought the network. That fight was never necessary. It was an architectural error — and thirty years of computer science already had the answer, scattered across papers that never talked to each other.

Read →

No One Took Your Freedom

On how free things become toll booths, why the walls are always optional, and what it means that the architecture can be changed.

Read →

Live counter demo

Open this page in two tabs. Each tab dials a local goodnetd via the handler-web-api-proxy WebSocket gateway and bumps a shared counter. The kernel routes the event between tabs.

Not connected.
Peer pubkey
—
Latency
—
Conn ID
—
Shared counter 0

No daemon yet? Install and start one locally: nix profile add github:GoodNet-io/goodnetd#full then goodnetd quickstart and goodnetd run --config ~/.local/share/goodnet/config.json --manifest ~/.local/share/goodnet/manifests/baseline.json --identity ~/.local/share/goodnet/identity/default.bin (full setup guide: goodnetd README). Then open this page in two browser tabs to see the counter sync.

Plan B — browser-as-peer (WASM kernel)

goodnet-js ships a stable v0.2 type surface for the in-tab WASM kernel; WasmTransport.create() throws a documented "pending impl" until the emscripten Module exports are pinned. When v0.3 lands here, this card swaps for a real working WASM demo — no daemon required.

Track v0.3 in bridges-js →

Tech breakdown

Four building blocks that make GoodNet tick.

Multi-path transport

Every connection is a bundle of paths. A strategy plugin (RTT-optimal, redundant, manual) picks which carrier to send on, switches mid-flight on degradation, and reorders inbound by cryptographic counter — never by socket.

Plugin ecosystem

The kernel exposes a stable C ABI. Plugins compose into the dispatch chain at load time.

  • link-* — TCP, UDP, WebSocket, TLS, IPC, QUIC, ICE NAT-traversal.
  • security-* — Noise XX/IK, PKCS#11 HSM, null (loopback).
  • handler-* — heartbeat, DNS, distributed store, web-api-proxy.
  • strategy-* — RTT-floating multi-path scheduler.
  • bridges-* — C++, JS, Python, Rust.

Identity & HSM

Peer addresses are Ed25519 pubkeys. The signing key can sit in a YubiKey or any PKCS#11 token — kernel never sees the secret.

// Phase 5 — HSM-backed identity
gn::sdk::Identity id = gn::sdk::Identity::from_pkcs11(
  "/usr/lib/libykcs11.so",
  /*slot*/ 0,
  /*pin*/ getenv("GN_PIN"));
auto core = gn::sdk::Core::with_identity(id);
auto sess = core.connect_to("ice://peer-pubkey-base32");

gssh — peer-pubkey SSH

A native SSH-2.0 server / client that authenticates by GoodNet peer pubkey. No authorized_keys to sync — the address is the credential.

# dial a host by its pubkey, no DNS or IP
gssh user@QFK4M7N2-XYZ7-A9KL-VBC3-RT8P

Repositories

22 repos, one license decision per layer (kernel GPL-2.0+linking exception, SDK MIT, plugins their own).