Important

Notice: Project Discontinuation & Local Patch (v2.1.5)

I apologize for the inconvenience, but Mojic is being discontinued. This release (v2.1.5) marks the final patch to the GitHub repository.

I have forgotten my npm account password, and during a recent migration to Linux, my recovery passcode file was also lost, completely locking me out of the account. Because of this, I am unable to publish a patch to fix a broken dependency (@notamitgamer/mojic) that is currently causing npm install commands from the registry to fail with a 404 error.

If you still wish to use the tool, you can clone this repository and run or install it locally:

# Clone and navigate to the directory
git clone https://github.com/notamitgamer/mojic.git
cd mojic

# Install dependencies and link it globally to use the 'mojic' command
npm install
npm link

Mojic v2.1.5

Operation Ironclad: Obfuscate C source code into a randomized, password-seeded stream of emojis.

Mojic (Magic + Emoji + Logic) is a sophisticated CLI tool designed to transform readable C code into an unrecognizable chaotic stream of emojis. Unlike simple substitution ciphers, Mojic uses your password to seed a cryptographically strong Pseudo-Random Number Generator (PRNG), creating a unique "Emoji Universe" and rolling cipher for every single session.

Key Features

• AES-256-CTR PRNG: Uses a military-grade cryptographically secure pseudorandom number generator (seeded via Scrypt) to handle shuffling and polymorphism.
• Polymorphic Keywords: Common C keywords (int, void, return) are mapped to emojis that change every time they appear based on the PRNG state. Frequency analysis is impossible.
• XOR Whitening: Before encoding, all raw data (whitespace, variable names) is XORed with the AES keystream. This ensures that repeating patterns—like 4 spaces of indentation—never produce the same emoji sequence twice.
• Base-1024 Compression: Non-keyword code is compressed using a custom Base-1024 scheme (5 bytes → 4 emojis), keeping file size manageable.
• Integrity Sealed: Every file ends with an HMAC-SHA256 signature. Any tampering with the emoji stream results in an immediate FILE_TAMPERED error.
• Moon Header Protocol: Metadata (Salt + Auth Check) is encoded using a specific alphabet of Moon and Clock phases (🌑🌒🕐), allowing instant password verification before decryption starts.
• Stream Architecture: Built on Node.js Transform streams to handle large files efficiently with minimal memory footprint.

Installation

Since Mojic is available on npm, you can install it globally with a single command:

npm install -g mojic

Or run it directly using npx without installing:

npx mojic encode main.c

Usage

1. Encrypting Code (encode)

Transforms a .c file into a .mojic file.

# Encrypt a single file
mojic encode main.c

# Encrypt an entire directory recursively
mojic encode ./src -r

# Flatten/Minify code structure before encryption (Removes newlines/indentation)
mojic encode main.c --flat

You will be prompted to create a password. This password is required to decrypt.

2. Decrypting Code (decode)

Restores the original C code from a .mojic file.

# Decrypt a single file
mojic decode main.mojic

# Decrypt an entire directory recursively
mojic decode ./src -r

3. Security & Rotation Tools (srt)

Manage encrypted files without ever revealing their plaintext contents.

# Rotate Password: Changes the password of an encrypted file
mojic srt --pass secret.mojic

# Re-Encrypt: Re-shuffles the entropy (New Salt) with the SAME password
# (Useful to change the visual emoji pattern without changing the password)
mojic srt --re secret.mojic

Under the Hood (Algorithm)

Mojic v2.1.0 implements a custom crypto-system dubbed "Operation Ironclad".

1. Derivation Phase:

   • Input: User Password + 32-byte Random Salt.
   • KDF: Scrypt (N=16384, r=8, p=1).
   • Output: 80 bytes (32 bytes AES Key, 16 bytes AES IV, 32 bytes HMAC Auth Key).

2. The Emoji Universe:

   • The engine generates a universe of ~1,100 valid unicode characters (Emoticons, Transport, Symbols).
   • This universe is shuffled using the AES-256-CTR CSPRNG initialized with the derived key.

3. Polymorphic Encryption:

   • C Keywords: The engine detects C keywords (e.g., while). It assigns them a "Base Emoji" from the shuffled universe.
   • The Twist: It doesn't just print the Base Emoji. It calculates a random offset using the PRNG to pick a different emoji that maps back to the keyword. This means int might look like 🚀 on line 1 and 🌮 on line 5.

4. XOR Whitening:

   • Before encoding non-keyword data (variable names, strings, whitespace), the engine generates a random mask from the AES stream.
   • The raw data is XORed with this mask. This hides repetitive patterns (like indentation or common variable names) effectively turning them into white noise before they are converted to emojis.

5. Base-1024 Encoding:

   • The whitened data is buffered into 5-byte chunks.
   • These chunks are treated as a single large integer and converted into 4 base-1024 digits (mapped to emojis).

6. The Header:

   • The Salt and a 4-byte Auth Check are written to the file header using the Moon/Clock Alphabet (🌑🌒🌓🌔...).
   • Benefit: This allows mojic to tell you "Incorrect Password" instantly, rather than churning out garbage data first.

License

This project is licensed under the Apache License 2.0.