ahfc

AHFC - Aarav HyperFortress Cipher 🔐

AHFC (Aarav HyperFortress Cipher) is a high-performance, multi-mode file encryption tool written in Node.js. Designed with security, flexibility, and user experience in mind, AHFC supports password-based encryption using Argon2, zlib compression, HMAC verification, and AES-GCM encryption (Beast mode). Perfect for CLI users who demand speed and strength.

---

Features

• 🔐 Multiple encryption modes: Lite, Normal, Beast
• 💥 AES-256-GCM in Beast mode with HMAC-SHA512
• 🧂 Argon2id key derivation with unique per-file salt
• 📦 zlib compression before encryption
• 📊 Live progress bar for large file operations
• 🧠 Secure password input with character masking
• 🧪 HMAC integrity check to detect tampering
• 🖥️ Beautiful, intuitive CLI interface
• ✅ Cross-platform (Windows, Linux, macOS)

---

Installation

npm install -g ahfc

---

CLI-Based Usage

Encrypt a File

ahfc encrypt <input-file> <output-file> [--lite|--normal|--beast]

Examples:

ahfc encrypt secret.txt secret.enc --normal
ahfc encrypt bigfile.zip archive.aes --beast

If no mode is specified, it defaults to --normal.

Decrypt a File

ahfc decrypt <input-file> <output-file>

Example:

ahfc decrypt secret.enc secret.txt

Module Usage (Programmatic API)

Please see MODULE_USAGE.md for detailed information.

---

Modes Explained

Mode	Rounds	Min Password Length	Description
Lite	10	4	Fast, lightweight encryption
Normal	64	16	Balanced security & speed
Beast	128	24	AES-GCM, HMAC-SHA512, secure

---

Security Notes

• Always use strong, unique passwords, especially for Normal and Beast modes.
• Files are encrypted with a new salt and IV each time for maximum randomness.
• HMAC is used to prevent tampering and verify password correctness.

---

License

CC BY-NC 4.0 © Aarav Mehta - [e-mail] Learn More

---

Contribute

Feel free to open issues or PRs. Suggestions and improvements are welcome!