No description

Find a file

Snider ca04a88e35 refactor: apply go fix modernizers for Go 1.26 Automated fixes: interface{} → any, range-over-int, t.Context(), wg.Go(), strings.SplitSeq, strings.Builder, slices.Contains, maps helpers, min/max builtins. Co-Authored-By: Virgil <virgil@lethean.io>		2026-02-22 21:00:16 +00:00
docs	docs: graduate TODO/FINDINGS into production documentation	2026-02-20 15:01:55 +00:00
KB@4dcd7ea9fe	test: add UEPS wire protocol tests (Phase 1) — 0% to 88.5% coverage	2026-02-19 23:44:09 +00:00
logging	refactor: apply go fix modernizers for Go 1.26	2026-02-22 21:00:16 +00:00
node	refactor: apply go fix modernizers for Go 1.26	2026-02-22 21:00:16 +00:00
ueps	test: Phase 5 — integration tests, benchmarks, bufpool tests	2026-02-20 06:09:21 +00:00
CLAUDE.md	docs: graduate TODO/FINDINGS into production documentation	2026-02-20 15:01:55 +00:00
go.mod	chore: bump go directive to 1.26.0	2026-02-22 20:34:57 +00:00
go.sum	test: add controller tests (Phase 3) — node/ coverage 63.5% to 72.1%	2026-02-20 00:17:31 +00:00
README.md	docs: add README with quick start and docs links	2026-02-20 15:11:19 +00:00
SESSION-BRIEF.md	docs: add session brief for expert agent work	2026-02-19 17:39:03 +00:00

README.md

go-p2p

P2P mesh networking layer for the Lethean network. Provides Ed25519 node identity, an encrypted WebSocket transport with HMAC-SHA256 challenge-response handshake, KD-tree peer selection across four dimensions (latency, hops, geography, reliability score), UEPS wire protocol (RFC-021) TLV packet builder and reader, UEPS intent routing with a threat circuit breaker, and TIM deployment bundle encryption with Zip Slip and decompression-bomb defences.

Module: forge.lthn.ai/core/go-p2p Licence: EUPL-1.2 Language: Go 1.25

Quick Start

import (
    "forge.lthn.ai/core/go-p2p/node"
    "forge.lthn.ai/core/go-p2p/ueps"
)

// Start a P2P node
identity, _ := node.LoadOrCreateIdentity()
transport := node.NewTransport(identity, node.TransportConfig{ListenAddr: ":9091"})
transport.Start(ctx)

// Build a UEPS packet
pkt, _ := ueps.NewBuilder(ueps.IntentCompute, payload).MarshalAndSign(sharedSecret)

Documentation

Architecture — node identity, transport, peer registry, UEPS protocol, dispatcher
Development Guide — building, testing, benchmarks, security rules
Project History — completed phases and known limitations

Build & Test

go test ./...
go test -race ./...
go test -short ./...   # skip integration tests
go build ./...

Licence

European Union Public Licence 1.2 — see LICENCE for details.