No description
b334cb4909
The coreio abstraction hardcodes file permissions (0644) and has no OpenFile equivalent. os.OpenFile is needed here to preserve tar header mode bits — executable binaries require 0755. Co-Authored-By: Virgil <virgil@lethean.io> |
||
|---|---|---|
| .core | ||
| .forgejo/workflows | ||
| .idea | ||
| docs | ||
| KB@4dcd7ea9fe | ||
| logging | ||
| node | ||
| ueps | ||
| .editorconfig | ||
| .gitignore | ||
| .golangci.yml | ||
| CLAUDE.md | ||
| CONTRIBUTING.md | ||
| go.mod | ||
| go.sum | ||
| README.md | ||
| SESSION-BRIEF.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.