A domain-specific kernel for the network layer. The address is the key — a 32-byte Ed25519 public key is the peer, not the machine. Every transport, every cipher, every protocol handler lives in a plugin over a stable C ABI. The kernel holds four registries and a dispatch loop. Everything else is yours to compose.
Runs as a Linux daemon, a .so loaded via FFI, a WebAssembly module in a browser, or bare-metal on a microcontroller. Same binary. Same ABI. Same guarantees.
→ The Network Layer We Always Deserved — on thirty years of the right idea in the wrong place, and what the fix looks like.
- goodnet — kernel, SDK, bundled plugin shims.
- goodnetd —
operator-facing daemon + multicall CLI (
run,version,config validate,plugin hash,manifest gen,identity gen|show|import-hsm,doctor,quickstart). - gssh — native SSH-2.0
server + client. Host identity is the GoodNet device pubkey; vanilla
openssh clients connect; two
gsshpeers also negotiate a customgn.handler-ext@goodnet.iosubsystem channel for file transfer + port forwarding.
- link-tcp · link-udp · link-tls · link-ws · link-ipc — single-protocol carriers.
- link-ice — NAT traversal (RFC 8445 + STUN + TURN + Trickle ICE + mDNS + auto-restart on consent loss).
- link-quic — QUIC over UDP/ICE (OpenSSL 3.6 native QUIC, composer pattern).
- security-noise — Noise XX handshake provider on libsodium primitives.
- security-null — loopback / IntraNode pass-through.
- security-pkcs11 —
hardware-backed signing via YubiKey / SoftHSM / enterprise HSM
(
gn.identity.pkcs11+gn.security.pkcs11dual-expose).
- handler-store — distributed key-value store (Memory + SQLite backends, first-writer-wins ACL).
- handler-dns — DNS
over GoodNet (typed RR storage on
gn.store+ three-tier resolver with c-ares upstream). - handler-heartbeat — peer liveness + RTT measurement; feeds the strategy chain.
- handler-ssh-modern —
native remote-shell handler (
SHELL_*envelopes, peer-pubkey ACL, no openssh wire). - handler-web-api-proxy — browser-as-thin-client WebSocket gateway (JSON-RPC over gnet envelopes).
- strategy-float-send-rtt — RTT-optimal multi-path picker (EWMA + 0.75 hysteresis + EncryptedPath tie-break).
- bridges-rust —
goodnet-sysraw FFI + safegoodnetcrate; ships theWireSchematrait. - bridges-python —
cffi ABI mode,
pip install-able, no C compiler. - bridges-js — TypeScript /
JS client for the goodnetd WS gateway (talks to
handler-web-api-proxy).
The full roadmap with the per-feature livedoc badge table lives at
docs/ROADMAP.en.md
in the kernel repo. Contracts that govern the public surface are in
docs/contracts/.
Strategic baseline (kernel + gnet protocol + the GPL-bundled link /
security / handler plugins) is GPL-2.0 with a linking exception —
out-of-tree plugins ship under any license; the boundary is the C ABI,
not the license. Periphery plugins are MIT. OpenSSL-tied plugins (TLS,
QUIC) and the reference strategy are Apache-2.0. See each repo's
LICENSE file.
Security reports go through the kernel repo's SECURITY.md.
General issues land in each sub-repo's tracker; cross-repo discussions
go to the kernel repo.