Tequel

A authenticated simetric encrypt engine (AEAD), robust and caotic built in Rust.

This project was designed to explore byte's manipulation concepts, XOR and modular-aritmetic in Rust. Not is recommended to use in high-safe systems, but yes like a tool to learn about how data can be converted and recovered through dynamic keys.

By Gabriel Xavier : ]

Summary

• Tequel
  • Summary
  • 📊 Stress and Safety report
    • 1. Colision Test (Avalanche Test)
    • 2. Entropy Analize (Shannon Entropy)
  • ⚙️ What does Tequel do?
  • 📥 How to Install and Use
  • ⁉️ Guide
  • Why the name 'Tequel'?
  • License

📊 Stress and Safety report

A Tequel v0.3.0 was submitted strict tests to ensure your robustness:

1. Colision Test (Avalanche Test)

Using a stress script to compare hashes of millions of unique inputs:

Result: 110.600.000+ iterations with none colision found.

Status: ✅ Approved for use in identification and integrity systems.

2. Entropy Analize (Shannon Entropy)

We measured an imprevisibility of generated bytes to ensure that hash be indistinguishable of pure random noise.

Obtained entropy: 7.999885 bits/byte (Máximo teórico: 8.0).

Status: 🏆 Excellent. The result reaches TEQUEL a statistical threshold of algorithms as SHA-256 and AES in terms of cargo distribution.

⚙️ What does Tequel do?

• Confidentiality: Uses XOR operations, Modular-Arithmetic, Wrapping among constants to "mask" data.
• Integrity (MAC): Validates if data was modified before decryption.
• Salting: Generates random salts to guarantee that the same input generates different results.
• Based in Encrypt-then-MAC (EtM): Smarter Security and validation of internal changes.

📥 How to Install and Use

1. Install with Cargo

cargo install tequel-rs

2. Add in your cargo.toml's project

[dependencies]

tequel-rs = "0.3.0"

3. Use in your project

use tequel_rs::hash::TequelHash;

fn main() {
    let mut teq = TequelHash::new()
        .with_salt("your_secret_key")
        .with_iteration(32);

    let hash = teq.dt_hash_string("data");
    println!("hash: {}", hash);
}

⁉️ Guide

Welcome to Tequel's Guide, here you will understand how each function of Tequel works.

• Tequel RNG — Low-level random number generation.
• Tequel Hash — Deterministic and non-deterministic hashing.
• Tequel Encryption — Authenticated encryption flow.

Why the name 'Tequel'?

"Tequel" is a biblical reference from the Book of Daniel.

"Mene, Mene, Tequel, Parsim" — Daniel 5:25-28

This is a mysterious Aramaic phrase written by a divine hand on the wall during the Babylonian King Belshazzar's feast.

The prophet Daniel interpreted the message, which announced the end of Belshazzar's reign: God had numbered the kingdom, weighed the king, and divided the empire between the Medes and Persians. The kingdom fell that very night.

TEQUEL means "Weighed" or "Heavy." I chose this name because:

The Mystery: The message was "decrypted" by Daniel, a perfect metaphor for an encryption library.

The Weight: It represents the "heavy" security and robustness that Tequel provides to your data.

License

MIT License - free to use, modify and integrate.