Enigma Engine

Ghidra की विश्लेषण पाइपलाइन से प्रेरित एक नेटिव C++ रिवर्स-इंजीनियरिंग इंजन।

Enigma JVM निर्भरता को हटाता है और एक स्टैंडअलोन विश्लेषण कोर प्रदान करता है जिसे एम्बेड, विस्तारित और सीधे नेटिव टूल्स और AI सिस्टम के साथ एकीकृत किया जा सकता है।

---

वर्तमान स्थिति

Enigma सक्रिय विकास के अधीन है और इसमें पहले से ही एक कार्यात्मक एंड-टू-एंड विश्लेषण पाइपलाइन है।

विश्लेषण इंजन

• PE, ELF (32/64-बिट, LE/BE, प्रोग्राम हेडर के माध्यम से स्ट्रिप्ड बाइनरी), Mach-O (fat/universal सहित), COFF ऑब्जेक्ट्स/आर्काइव्स, और Ghidra .gzf/.rep आयात पथ
• Capstone + संकलित SLEIGH स्पेक्स के माध्यम से मल्टी-आर्क डिसअसेम्बली (x86/x64, ARM32, AArch64, MIPS जिसमें 16e वेरिएंट शामिल हैं, PowerPC)
• Ghidra की नेटिव डीकंपाइलर लाइब्रेरी का उपयोग करके Pcode जनरेशन
• Ghidra 12.1.3 हेडलेस के विरुद्ध ऑडिट किया गया फ़ंक्शन डिटेक्शन: x86-64, ARM, AArch64, MIPS, और PPC पर सभी छोटे फिक्स्चर पर 100% इंस्ट्रक्शन-स्तरीय सिमेंटिक समानता (0 mnemonic / 0 operand बेमेल); एक बड़े x86-64 बाइनरी पर 2856 साझा फ़ंक्शन / 116k+ सिमेंटिक मैच
• प्रति-फ़ंक्शन पैरिटी हार्नेस के साथ C डीकंपाइलेशन (Ghidra 12.1.3 के विरुद्ध फ़ंक्शन-सेट, नामकरण, सफलता, सिग्नेचर, कैली-सेट, और टेक्स्ट-समानता मेट्रिक्स; सभी फिक्स्चर पर शून्य halt_baddata)
• Windows API सिग्नेचर (1400+ प्रोटोटाइप), glibc/Linux प्रोटोटाइप, और noreturn टेबल्स (Linux/Mac/Windows) के साथ टाइप रिकवरी
• सिंबल्स, रेफ़रेंसेस, फ़ंक्शन्स, टाइप्स, और मेमोरी मॉडल
• 142 पंजीकृत विश्लेषकों के साथ विश्लेषण पाइपलाइन
• git-जैसे कमिट्स और ब्रांचेस के साथ FlatBuffers + LMDB का उपयोग करके प्रोजेक्ट पर्सिस्टेंस

GUI

• इंटरैक्टिव डिसअसेम्बली (डेटा-सेक्शन बैनर + hex/ASCII डंप सहित)
• Hex व्यूअर और पैचिंग
• डीकंपाइलर (स्ट्रिंग-लिटरल रिज़ॉल्यूशन, equate नाम, उन्नत टिप्पणियाँ सहित)
• इनलाइन कंट्रोल-फ़्लो विज़ुअलाइज़ेशन
• Function Graph विंडो (ज़ूम करने योग्य बेसिक-ब्लॉक फ़्लोचार्ट) + Call Graph
• क्रॉस-रेफ़रेंस एक्सप्लोरेशन
• सिंबल और फ़ंक्शन नेविगेशन
• Disassembly, Decompiler, और Hex के बीच क्रॉस-व्यू सिंक्रोनाइज़ेशन
• फ़ंक्शन और सिंबल का नाम बदलना

कोर पाइपलाइन स्थिर है (78/78 CTest सूट हरे हैं), और वर्तमान कार्य फ़ीचर कवरेज का विस्तार करने, इंजन/GUI एकीकरण में सुधार करने, और Ghidra 12.1.3 पैरिटी परीक्षण के दौरान पहचानी गई शेष क्षमता अंतरालों को भरने पर केंद्रित है।

---

आर्किटेक्चर

Binary (PE / ELF / Mach-O / COFF)
        │
        ▼
Binary Loader
        │
        ▼
Capstone + SLEIGH Disassembly
        │
        ▼
Pcode / Decompiler Engine
        │
        ▼
Analysis Pipeline
        │
        ├── Function Detection
        ├── Type Recovery
        ├── Symbols
        ├── References
        └── Other Analyses
        │
        ▼
Program Model
        │
        ├── Functions
        ├── Symbols
        ├── Types
        ├── Memory
        └── References
        │
        ▼
Storage
        │
        ├── FlatBuffers snapshots
        ├── LMDB index
        └── Git-like commits / branches
        │
        ▼
Qt GUI
        │
        ├── Disassembly
        ├── Decompiler
        ├── Hex View
        ├── CFG / Call Graph
        └── Explorers

---

मूल कार्य बनाम Ghidra घटक

घटक	स्रोत
डीकंपाइलर इंजन	Ghidra नेटिव C++ डीकंपाइलर लाइब्रेरी
Sleigh प्रोसेसर विनिर्देश	Ghidra
प्रोग्राम मॉडल	नेटिव Enigma C++ कार्यान्वयन
टाइप और मेमोरी सिस्टम	नेटिव Enigma C++ कार्यान्वयन
विश्लेषण पाइपलाइन	नेटिव Enigma C++ कार्यान्वयन
फ़ंक्शन पहचान	नेटिव Enigma कार्यान्वयन
बाइनरी लोडर	नेटिव Enigma कार्यान्वयन (PE/ELF/Mach-O/COFF)
स्टोरेज	नेटिव Enigma कार्यान्वयन
GUI	नेटिव Qt6 कार्यान्वयन

Enigma Ghidra घटकों का उपयोग वहाँ करता है जहाँ वे आवश्यक निम्न-स्तरीय विश्लेषण तकनीक प्रदान करते हैं, जबकि आसपास की इंजन आर्किटेक्चर को C++ में नेटिव रूप से कार्यान्वित किया गया है।

---

बिल्ड करना

आवश्यकताएँ

• C++17 या नया
• CMake 3.16+
• Ninja (बैकएंड) या MSYS Makefiles (GUI), MSYS2 के माध्यम से MinGW64 g++
• Capstone
• LMDB
• SQLite3
• FlatBuffers + flatc
• zlib
• Python3 (CLI रिग्रेशन परीक्षण)
• Qt 6 (Widgets, Core, Gui — केवल GUI; Qt-Advanced-Docking-System CMake FetchContent के माध्यम से स्वचालित रूप से प्राप्त किया जाता है)

बिल्ड

git clone https://github.com/adam-040/Enigma.git
cd Enigma/Enigma-Engine

cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build
ctest --test-dir build --output-on-failure

परियोजना की स्थिति

Enigma अब केवल एक प्रोटोटाइप विश्लेषण कोर नहीं है। नेटिव पाइपलाइन, स्टोरेज लेयर, विश्लेषण प्रणालियाँ और GUI कार्यात्मक हैं (78/78 CTest सूट हरे हैं)।

वर्तमान विकास इंजन की क्षमताओं का विस्तार करने और बैकएंड में पहले से मौजूद कार्यक्षमता को GUI से जोड़ने पर केंद्रित है, साथ ही Ghidra 12.1.3 डिसअसेम्बलर/डीकंपाइलर समानता ऑडिट के दौरान पहचाने गए शेष अंतरालों को बंद करने पर (देखें PLAN/)।

---

लाइसेंस

यह परियोजना Apache License 2.0 के अंतर्गत लाइसेंस प्राप्त है।

Enigma द्वारा उपयोग किए जाने वाले तृतीय-पक्ष घटक अपने संबंधित लाइसेंसों के अधीन रहते हैं।