Tequel

Crates.io Version

A high-performance, SIMD-accelerated cryptographic engine and KDF, built in pure Rust for the modern CPU.

Tequel 0.6.0: The SIMD Update. Featuring a vectorized ARX core, the TQL-11-AVX engine delivers a 412% performance boost over previous versions while maintaining a surgical Avalanche Stability of 51.04%. Designed for local-first security, high-speed obfuscation, and low-level systems.

By Gabriel "dotxav" Xavier (@G4brielXavier)

🔬 Internal Architecture: TQL-11 (SIMD Edition)

Tequel is powered by the TQL-11, a custom ARX (Addition-Rotation-XOR) primitive now re-engineered for Single Instruction, Multiple Data (SIMD).

Vectorized Execution: Uses AVX2 (Intel/AMD) intrinsics to process 32-byte chunks (256-bit) in parallel across 12 internal state registers.
Manual Loop Unrolling: The core mixer is fully unrolled to eliminate branch misprediction and maximize CPU pipeline throughput.
Chaotic Diffusion: 12 unique rotation constants (Primes) ensure that every bit change propagates across the entire state in a non-linear "Butterfly" effect.
Security First: Integrated with Zeroize to mitigate Cold Boot attacks and memory forensics.

📊 Performance Benchmarks (v0.6.0)

Verified using criterion.rs on a target-cpu=native release build.

Operation	Data Size	Result (v0.5.x)	Result (v0.6.0)	Improvement
Hashing Latency	1 KB	588.8 µs	119.3 µs	-79.5%
Throughput	1 MB	1.74 MiB/s	8.81 MiB/s	+406%
Avalanche (SAC)	Bit-diff	50.26%	51.04%	Optimal

🛡️ Statistical Rigor

1. Strict Avalanche Criterion (SAC)

A single bit flip in the input causes a cascading change in the output.

Result: 51.04% (Perfect chaos distribution).
Collision Resistance: Tested over 110M+ iterations without collisions.

2. Shannon Entropy

Result: 7.999986 bits/byte. The output is statistically indistinguishable from pure white noise, making it ideal for high-entropy key derivation.

⚙️ Core Features

SIMD Optimized: Native support for AVX2 instructions for high-speed local encryption.
Byte-Centric API: Low-level &[u8] processing for zero-copy integration.
Advanced KDF: Key stretching with configurable iterations to protect against GPU-accelerated brute force.
Memory Forensic Resistance: Sensitive buffers are wiped immediately after use.

📥 Installation

Add to your Cargo.toml:

[dependencies]

tequel-rs = "0.6.0"

🚀 Usage

The Tequel API is now byte-oriented for maximum performance.

Basic Hashing

use tequel_rs::hash::TequelHash;

fn main() {
  let mut teq = TequelHash::new();
  let data = b"my_secure_data";

  let hash = teq.tqlhash(data);
}

🔑 Key Derivation (KDF)

Perfect for deriving AES/Tequel keys from user passwords in projects like My Way CLI.

let salt = b"unique_local_salt";
let mut teq = TequelHash::new()
  .with_iterations(1000)
  .with_salt(salt);

let password = b"user_password";

// Derives a cryptographic key using 1000 iterations
let key = teq.derive_key(password);

Why the name 'Tequel'?

"Tequel" is a biblical reference from the Book of Daniel (5:25-28): "Mene, Mene, Tequel, Parsim".

TEQUEL means "Weighed". It represents a judgment where data is weighed and its integrity verified. In this library, it stands for the cryptographic weight and the balance between speed and chaos—data secured by Tequel is weighed and found impenetrable.

License

MIT License - Build the future, keep it open.

tequel-rs 0.6.0