Hallucina

🚀 Hallucination Obfuscator

The Hallucination Obfuscator is a powerful obfuscation tool designed to confuse custom MCP servers used in decompilers such as Ghidra and IDA PRO, thereby increasing the confusion of LLM clients.

🚀 Quick Start

💻 Usage Examples

🔍 Basic Usage

To obfuscate a single source file using the generated clang (LLVM 17):

path_to_build/bin/clang -mllvm -irobf -mllvm --irobf-indbr test.c -o test_obfuscated

This command uses the flags -mllvm -irobf and -mllvm --irobf-indbr to obfuscate the test.c file and generates an obfuscated output file named test_obfuscated.

Here is the difference between the original code and the obfuscated code:

🔍 Advanced Usage

For larger projects, integrate the Hallucination Obfuscator into the build system:

CC=path_to_build/bin/clang
CFLAGS+="-mllvm -irobf -mllvm --irobf-indbr"
./configure
make

✨ Features

The available obfuscation flags are as follows:

• Correlation Obfuscation: Introduce correlations during the obfuscation process.
• Indirect Jumps: Encrypt the jump target address (-mllvm -irobf-indbr).
• Indirect Function Calls: Encrypt the target function address (-mllvm -irobf-icall).
• Indirect Global Variable References: Encrypt the variable address (-mllvm -irobf-indgv).
• C String Encryption (-mllvm -irobf-cse).
• Procedure-Related Control Flow Flattening Obfuscation (-mllvm -irobf-cff).
• Apply all the above features comprehensively (-mllvm -irobf-indbr -mllvm -irobf-icall -mllvm -irobf-indgv -mllvm -irobf-cse -mllvm -irobf-cff).

📦 Installation

The Hallucination Obfuscator supports building with LLVM 17. Please follow the instructions below to set up the build environment.

Prerequisites

Windows

• Install LLVM.
• Ensure that a C++ compiler (such as Visual Studio) is installed on the system.

Linux/MacOS

• Install LLVM and Clang using the system package manager:
  • On Debian/Ubuntu: sudo apt-get install llvm clang
  • On MacOS: Install using Homebrew brew install llvm

Build Steps

1. Clone the Hallucination Obfuscator repository:

git clone https://github.com/your-username/hallucination-obfuscator.git
cd hallucination-obfuscator

2. Download and build the LLVM source code:

• LLVM Download Link

3. Run the build script in the project root directory:

./build.sh

📚 Documentation

⚠️ Important Note

If you encounter errors during the compilation process, please check the log files for more information.

💡 Usage Tip

For large projects, it is recommended to increase the memory allocation to avoid out-of-memory issues during the build process.

📄 License

This project is licensed under the GNU v3 License. For more details, please refer to the LICENSE file.

References

• Goron
• Hikari
• ollvm
• Akira
• LLVM