99[ ![ Rust] ( https://img.shields.io/badge/rust-1.70%2B-orange.svg )] ( https://www.rust-lang.org/ )
1010[ ![ License: MIT] ( https://img.shields.io/badge/License-MIT-yellow.svg )] ( LICENSE )
1111[ ![ Security] ( https://img.shields.io/badge/security-malware%20detection-red )] ( https://github.com/xonoxitron/polymorph )
12- [ ![ Build Status] ( https://github.com/xonoxitron/polymorph/workflows/CI/badge.svg )] ( https://github.com/xonoxitron/polymorph/actions )
1312
14- [ Features] ( #-features ) • [ Quick Start] ( #-quick-start ) • [ Documentation ] ( #-documentation ) • [ Contributing ] ( #-contributing )
13+ [ Features] ( #-features ) • [ Quick Start] ( #-quick-start ) • [ Examples ] ( #-examples )
1514
1615</div >
1716
1817---
1918
2019## 🚨 The Polyglot Malware Problem
2120
22- The malware landscape is evolving. Attackers exploit ** polyglot files** - binaries valid in multiple formats simultaneously - to evade detection systems that traditional antivirus cannot catch .
21+ Modern malware exploits ** polyglot files** - binaries valid in multiple formats simultaneously - to evade traditional antivirus.
2322
24- ### The Emerging Threats
23+ ### The Threats
2524
26- ** Actually Portable Executables (APE)**
27- - Single binary runs natively on Windows, Linux, macOS, and BSD
28- - Combines PE + ELF + Mach-O formats in one file
29- - Perfect for cross-platform malware campaigns
25+ - ** APE (Actually Portable Executable)** : Single binary runs on Windows/Linux/macOS/BSD
26+ - ** Zig Malware** : Direct syscalls bypass EDR (Hell's Gate, Halo's Gate)
27+ - ** WASM Cryptominers** : 75% of WASM modules are malicious (CrowdStrike, 2024)
3028
31- ** Zig Malware**
32- - Direct syscalls bypass EDR hooks (Hell's Gate, Halo's Gate)
33- - Compile-time obfuscation defeats static analysis
34- - Growing adoption in APT toolkits
29+ ### Research Shows Defenses Fail
3530
36- ** WebAssembly Cryptominers**
37- - Near-native performance in browsers
38- - Binary format evades string-based detection
39- - ** 75% of WASM modules in the wild are malicious** (CrowdStrike, 2024)
31+ - ** 20/36 detectors** bypassed by polyglots (Jana & Shmatikov, 2012)
32+ - ** 90% evasion rate** against VirusTotal for WASM (Cabrera-Arteaga, 2024)
4033
41- ### Research Proves Traditional Defenses Fail
42-
43- - ** 20 out of 36 malware detectors** bypassed by polyglot files (Jana & Shmatikov, 2012)
44- - ** 4 leading commercial tools** missed 199 polyglot samples (Bridges et al., 2023)
45- - ** 90% evasion rate** against VirusTotal for WASM (Cabrera-Arteaga et al., 2024)
46-
47- ** No open-source production tool detects APE, Zig, AND WASM threats together.**
48-
49- ** PolyMorph fills this gap.**
50-
51- ---
52-
53- ## 🎯 What is PolyMorph?
54-
55- First open-source static analyzer for:
56-
57- ✅ ** Cosmopolitan APE** polyglot binaries
58- ✅ ** Zig-based malware** with EDR evasion
59- ✅ ** WebAssembly cryptominers**
60- ✅ ** Direct syscall patterns** (Hell's Gate, Halo's Gate)
61- ✅ ** Anti-debugging/anti-VM** mechanisms
62- ✅ ** Process injection** across platforms
63-
64- Built in Rust for performance (~ 50ms per 10MB), safety, and portability.
34+ ** No open-source tool detects APE + Zig + WASM together. PolyMorph fills this gap.**
6535
6636---
6737
6838## ⚡ Quick Start
6939
7040``` bash
71- # Clone and build
7241git clone https://github.com/xonoxitron/polymorph
7342cd polymorph
7443cargo build --release
@@ -77,66 +46,30 @@ cargo build --release
7746./target/release/polymorph suspicious.exe
7847
7948# JSON output
80- ./target/release/polymorph --json malware.com
49+ ./target/release/polymorph --json malware.wasm
8150```
8251
8352---
8453
85- ## 📚 Documentation
86-
87- - [ Quick Start Guide] ( docs/QUICKSTART.md )
88- - [ Architecture] ( docs/ARCHITECTURE.md )
89- - [ WASM Detection] ( docs/WASM_DETECTION.md )
90- - [ YARA Rules] ( rules/polymorph.yar )
91- - [ Contributing] ( CONTRIBUTING.md )
92-
93- ---
94-
95- ## 💻 Usage Examples
54+ ## 💻 Examples
9655
97- ### Malware Analysis
98- ``` bash
99- polymorph /tmp/suspicious.exe | grep -E " CRITICAL|HIGH"
100- ```
101-
102- ### CI/CD Integration
103- ``` yaml
104- - name : Scan artifacts
105- run : polymorph --json ./build/app.exe || exit 1
106- ` ` `
107-
108- ### SOC Automation
109- ` ` ` python
110- import subprocess, json
111-
112- def scan(path) :
113- result = subprocess.run(['polymorph', '--json', path],
114- capture_output=True, text=True)
115- return json.loads(result.stdout)
116-
117- report = scan('/quarantine/sample.com')
118- if report['risk_score'] >= 80 :
119- alert_soc_team(report)
120- ` ` `
56+ See ` examples/ ` directory:
57+ - ` basic_scan.rs ` - Simple file scanning
58+ - ` batch_scan.rs ` - Multiple file processing
12159
12260---
12361
124- ## 🔬 Comparison to Existing Tools
125-
126- | Tool | APE | Zig | WASM | Open Source | Production Ready |
127- |------|-----|-----|------|-------------|------------------|
128- | **PolyMorph** | ✅ | ✅ | ✅ | ✅ | ✅ |
129- | MINOS | ❌ | ❌ | ⚠️ | ⚠️ | ❌ |
130- | MinerRay | ❌ | ❌ | ✅ | ❌ | ❌ |
131- | ClamAV | ❌ | ❌ | ❌ | ✅ | ✅ |
62+ ## 📚 Documentation
13263
133- **PolyMorph: Only tool with APE+Zig+WASM detection in production-ready open-source package.**
64+ - [ Quick Start] ( docs/QUICKSTART.md )
65+ - [ Architecture] ( docs/ARCHITECTURE.md )
66+ - [ WASM Detection] ( docs/WASM_DETECTION.md )
13467
13568---
13669
13770## 🤝 Contributing
13871
139- Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
72+ Contributions welcome! See [ CONTRIBUTING.md] ( CONTRIBUTING.md )
14073
14174---
14275
@@ -146,14 +79,6 @@ MIT License - see [LICENSE](LICENSE)
14679
14780---
14881
149- ## 📧 Support
150-
151- - **Issues**: [GitHub Issues](https://github.com/xonoxitron/polymorph/issues)
152- - **Discussions**: [GitHub Discussions](https://github.com/xonoxitron/polymorph/discussions)
153- - **Security**: [SECURITY.md](SECURITY.md)
154-
155- ---
156-
15782<div align =" center " >
15883
15984Made with ❤️ by the security community
0 commit comments