Trace-gestützte VMProtect-Devirtualisierungs-Forschungsplattform: Versions-Frontends speisen ein gemeinsames Remill/LLVM-Backend, um Handler zu liften, Datenfluss wiederherzustellen und native Objekte auszugeben.
Trace-gestützte VMProtect-Devirtualisierungsforschung: Versions-Frontends (1.x-Gate / 2.x-Tabelle / 3.x-FDJ), die ein gemeinsames Backend speisen (Remill-Lift → LLVM-Opt → semantische Karten → Datenfluss → native Objekte).
Validiert gegen selbstgebaute VMP-3.9.4-Binaries über mehrere Schutzmodi hinweg. Die Kompatibilität mit VMP 3.8.x/3.10.x ist experimentell und sample-abhängig.
Dies ist eine Forschungsplattform zur Analyse von VMProtect-geschützten Binaries, die Sie besitzen oder für die Sie eine Lizenz zum Reverse Engineering haben — kein universeller Devirtualizer auf Knopfdruck:
src/
lib.rs crate root, data_dir()
pe_loader.rs PE parsing / VA reads
opcode_map.rs legacy handler-type labels (oracle only, see module docs)
frontend/
mod.rs VmFrontend trait (detect/fetch_stream/handler_addrs)
fetch_finder.rs movzx-byte FDJ scan + watchset/snapshot helpers
cryptor_miner.rs per-site ValueCryptor mining (branch-following)
site_emulator.rs sample-specific oracle decoders (legacy)
handler_classifier.rs handler classification via legacy patterns
classifier_legacy.rs first-bytes patterns (weak; fallback only)
v1_gate.rs VMP 1.x gate-scan front-end
v2_walker.rs VMP 2.x dispatch-table front-end
v3_fdj.rs VMP 3.x FDJ front-end
backend/
value_cryptor.rs ADD/SUB/XOR/ROL/ROR/NOT/NEG/... chains
lifter.rs iced-x86 text lift + Remill subprocess backend
llvm_pipeline.rs opt -O3 over Remill IR (real passes)
harness/
snapshot.rs Unicorn snapshots: sections+scratch mapping,
IN hooks, import stubs, watch hits, memlog,
zero-slide fast-forward
tests/
smoke.rs synthetic PE64 + hand-built fetch chain (no fixtures)
tools/ (analysis drivers; each documents its inputs)
scripts/ Triton/angr/Ghidra helpers (external deps)
# Debian/Ubuntu (LLVM 22 for optional llvm feature)
sudo apt install llvm-22-dev libclang-22-dev clang-22
cargo build --release # pure Rust (no LLVM link)
cargo build --release --features llvm # llvm-sys link check
pip install triton-library capstone pefile # python helpers
# Remill (optional lifter backend): build upstream, export REMILL_LIFT=<path>/remill-lift
# Souper (optional MBA superoptimizer): external only, wire its `souper` CLI
# to scripts/triton_handlers.py output if desired; not vendored.
Das Dockerfile reproduziert die vollständige Umgebung. CI führt cargo build/test --release aus
(Standard-Features, kein LLVM-Link, keine kommerziellen Fixtures; sample-gated
Tests werden übersprungen, tests/smoke.rs läuft immer). Die optionale --features llvm
Link-Prüfung läuft als nicht-blockierender CI-Job (benötigt LLVM 22).
| Var | Standard | Bedeutung |
|---|---|---|
DATA_DIR | ./data | alle Tool-Artefakte |
WATCH_FILE | $DATA_DIR/watch.txt | zu überwachende Fetch-VAs abrufen |
CARDS | open_cards3.json | Remill-Card-Cache-Datei |
BIN_PATH | Ziel-Binary-Pfad (Tool-Standard: ./target.exe-Platzhalter) | Ziel-Binary |
IAT_JSON | — | {api_name: iat_va} Import-Stub-Map |
VMP_TEST_BIN / VMP_ORACLE | tests/fixtures/… | Tests mit lizenzierten Samples |
REMILL_LIFT | remill-lift-22 im PATH | Remill-Lift-Binary |
DEVIRT / FORCE_EDGE / REPO_ROOT | ./target/… / . | skriptaufgerufene Binaries + Repo-Root |
VMP_WORK_DIR | System-Temp | Lift-Arbeitsverzeichnis |
EFLAGS / IN_RET / DLL_MAIN | — | Snapshot-Zustandsvarianten |
ret, Import-Stubs, IN-Hook).reg einen ausgeführten Byte-Load speist, unabhängig von
seinem Mnemonic. Statische movzx-Muster sind nur der Fallback-Seed —
rein statische Treffer maßen 0 % Ausführung bei gehärteten Zielen.
Fetch-Shape-Abdeckung: movzx ✓, movsx ✓ (SMC wechselt mitten im Lauf
zwischen ihnen; der Miner akzeptiert beide), and-gated/Co-Byte-Fetches ✓
via Live-Capture. Gemessene Verzerrung (3.9.4, devirt fetch
dispatch-verankerte Back-Slices vs. statischer strikter Scan): disjunkte
Populationen — der Sensor fand 8 fetch-förmige Byte-Stellen, die das
Muster+mov-imm32-Gate nie vorschlug (indizierte/skalierte Formen
wie movzx edx,[r9+riz-1]), 1 davon förderte eine verifizierte Kette
zutage (Rol→Inc→Xor52→Ror, Schlüssel r10l); der Rest sind VM-Kontext-
Loads, die der Miner korrekt verwirft. Andere Formen (z. B. String-
Ops): Bytes bringen, einen Miner-Fall erhalten — ein Issue mit den Opcode-
Bytes rund um den Fetch einreichen. Musterfixierter Fetch ist hier eine dokumentierte
Nicht-Methode.opt -O3, Cards/Dataflow emittieren,
mit llc neu kompilieren (ld -r beweist Komponierbarkeit).synth portiert (simplify_chain, im Code
attributiert). Wir behielten Remill+LLVM als Lifter; kein IR-Austausch.devirt brighten
portiert (Pool greift bei 3.9 nicht — dokumentiert).backend/mba.rs portiert (aus dem Paper abgeleitet, kein eingebundener Code).MIT (siehe LICENSE) mit Abhängigkeitshinweisen (insbesondere Unicorn GPL-2.0). Nur für Forschungs-/Bildungszwecke, an Binaries, die Sie besitzen oder analysieren dürfen.
Mit KI-Unterstützung erstellt (Design, Code, Docs — menschlich gesteuert,
maschinell geprüft: jede Zahl in docs/coverage.md lässt sich aus den
danebenstehenden Befehlen reproduzieren).