commit 4919a7dfccc10c6103ae52a212a19f377df269ad Author: Virgil Date: Thu Feb 19 16:20:09 2026 +0000 Add "Home" diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..96b052d --- /dev/null +++ b/Home.md @@ -0,0 +1,49 @@ +# go-crypt + +Cryptographic primitives and authentication for the Lethean network. Part of the [Core Go ecosystem](https://forge.lthn.ai/core). + +## Installation + +```bash +go get forge.lthn.ai/core/go-crypt +``` + +**Requires**: Go 1.25+, depends on `forge.lthn.ai/core/go` + +## Package Map + +| Import Path | Description | +|---|---| +| `go-crypt/auth` | OpenPGP challenge-response authentication with online and air-gapped transport | +| `go-crypt/crypt` | Symmetric encryption (ChaCha20-Poly1305, AES-256-GCM), KDF, checksums, hashing, HMAC | +| `go-crypt/crypt/pgp` | PGP key generation, encryption, decryption, signing, verification | +| `go-crypt/crypt/openpgp` | OpenPGP service implementing `core.Crypt` interface (RSA-4096 + IPC) | +| `go-crypt/crypt/rsa` | RSA-OAEP encryption/decryption and key pair generation | +| `go-crypt/crypt/lthn` | LTHN quasi-salted deterministic hashing (RFC-0004) | +| `go-crypt/crypt/chachapoly` | Standalone XChaCha20-Poly1305 AEAD encryption | +| `go-crypt/trust` | Agent trust model with tiered access control and policy evaluation | + +## Quick Start + +```go +import "forge.lthn.ai/core/go-crypt/crypt" + +// Encrypt with passphrase (ChaCha20-Poly1305 + Argon2id KDF) +encrypted, err := crypt.Encrypt(plaintext, passphrase) +decrypted, err := crypt.Decrypt(encrypted, passphrase) + +// Password hashing (Argon2id) +hash, err := crypt.HashPassword("secret") +ok, err := crypt.VerifyPassword("secret", hash) +``` + +See [[Cryptography]] for the full API reference. + +## Dependencies + +- `golang.org/x/crypto` -- Argon2id, scrypt, HKDF, ChaCha20-Poly1305, bcrypt +- `github.com/ProtonMail/go-crypto` -- OpenPGP implementation + +## Licence + +EUPL-1.2