libcryptus

Cryptus

Cryptus is a lightweight cryptography library and CLI tool that makes encryption, decryption, and key derivation simple and consistent.

🚀 Features

• Symmetric encryption: AES-GCM and ChaCha20-Poly1305
• Asymmetric encryption: RSA key pair and message encryption
• Key derivation: Argon2id and PBKDF2
• Hashing: SHA-256 helper
• Nonce and random generation utilities
• CLI or library use — your choice

🔐 Supported Algorithms

📦 Installation

CLI (optional)

go install github.com/ravoni4devs/libcryptus/cmd/cryptus@latest

Library (for Go projects)

go get github.com/ravoni4devs/libcryptus

🧰 CLI Usage

Encrypt

# Encrypt a string using AES + Argon2id (defaults)
cryptus encrypt -text "hello world"

# Encrypt file (auto-saves .nonce)
cryptus encrypt -file wallet.txt

# Use ChaCha20 instead of AES
cryptus encrypt -text "hello" -algo chacha20

# Use PBKDF2 instead of Argon2id
cryptus encrypt -file wallet.txt -kdf pbkdf2

Decrypt

# Decrypt a string
cryptus decrypt -text "ab12cd..." -nonce mynonce

# Decrypt a file (auto-loads .nonce)
cryptus decrypt -file wallet.txt.enc

Options:

💻 Go Library Example

Argon2 Password example

package main

import (
    "fmt"
    "github.com/ravoni4devs/libcryptus/cryptus"
)

func main() {
    c := cryptus.New()
    password := "S3cure-P@ssw0rd!"
    salt, _ := c.GenerateNonceHex(16)  // 16 => 32 hex chars: 9314d292a6b30ae20dd2736dfb50da80

    // phc: $argon2id$v=19$m=65536,t=3,p=1$kxTSkqazCuIN0nNt+1DagA$ZiDzSiQkYC0jrTynfrwnvFIZ81nR+2roAzs14SnZ96U
    phc := c.Argon2(password, salt)
    if !c.CompareArgon2(password, phc) {
        fmt.Println("passwords mismatch")
    }
}

AES Encryption Example

package main

import (
    "encoding/hex"
    "fmt"
    "github.com/ravoni4devs/libcryptus/cryptus"
)

func main() {
    c := cryptus.New()
    password := "mypassword"
    salt := "mysalt"

    keyHex := c.Pbkdf2(password, salt)
    nonceHex := hex.EncodeToString([]byte("123456789012")) // 12 bytes nonce
    cipherText, _ := c.EncryptAESGCMHex("hello world", keyHex, nonceHex)

    fmt.Println("Cipher:", cipherText)

    plainText, _ := c.DecryptAESGCMHex(cipherText, keyHex, nonceHex)
    fmt.Println("Plain:", plainText)
}

RSA Example

package main

import (
    "fmt"
    "github.com/ravoni4devs/libcryptus/cryptus"
)

func main() {
    c := cryptus.New()
    priv, pub, _ := c.GenerateRsaKeyPair(2048)

    text := "super secret"
    enc, _ := c.EncryptRsaOAEPB64(text, pub)
    dec, _ := c.DecryptRsaOAEPB64(enc, priv)

    fmt.Println("Encrypted:", enc)
    fmt.Println("Decrypted:", dec)
}

🧪 Benchmarks

On Apple M4 (10 cores):

Run your own benchmarks:

go test -bench=Encrypt1GB -benchmem -benchtime=1x

📚 More Examples

Check the *_test.go files for working examples of AES, ChaCha20, Argon2id, PBKDF2, and RSA.

🤝 Contributing

1. Open an issue describing your use case or problem
2. Fork the repo and create a branch
3. Add your feature or fix (with tests)
4. Open a PR 🚀

⚖️ License

MIT License — see LICENSE