Plateforme de recherche pour la dévirtualisation de VMProtect assistée par trace : les front-ends de version alimentent un backend partagé Remill/LLVM pour lever les handlers, récupérer le flux de données et émettre des objets natifs.
Recherche sur la dévirtualisation de VMProtect assistée par trace : des front-ends par version (gate 1.x / table 2.x / FDJ 3.x) alimentant un backend commun (levée Remill → opt LLVM → cartes sémantiques → flux de données → objets natifs).
Validé sur des binaires VMP 3.9.4 auto-construits dans plusieurs modes de protection. La compatibilité avec VMP 3.8.x/3.10.x est expérimentale et dépend de l'échantillon.
Il s'agit d'une plateforme de recherche pour analyser des binaires protégés par VMProtect que vous possédez ou que vous êtes autorisé à rétro-ingénierer — et non d'un dévirtualiseur universel et clé en main :
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.
Le Dockerfile reproduit l'environnement complet. La CI exécute cargo build/test --release
(fonctionnalités par défaut, pas de lien LLVM, pas de fixtures commerciales ; les
tests conditionnés par des échantillons sont ignorés, tests/smoke.rs s'exécute toujours). La vérification de lien optionnelle --features llvm
s'exécute comme tâche CI non bloquante (nécessite LLVM 22).
| Var | Défaut | Signification |
|---|---|---|
DATA_DIR | ./data | tous les artefacts de l'outil |
WATCH_FILE | $DATA_DIR/watch.txt | VA de fetch à surveiller |
CARDS | open_cards3.json | fichier de cache des cartes Remill |
BIN_PATH | chemin du binaire cible (défaut des outils : ./target.exe en tant qu'espace réservé) | binaire cible |
IAT_JSON | — | table des stubs d'import {api_name: iat_va} |
VMP_TEST_BIN / VMP_ORACLE | tests/fixtures/… | tests sur échantillons sous licence |
REMILL_LIFT | remill-lift-22 dans le PATH | binaire de lift Remill |
DEVIRT / FORCE_EDGE / REPO_ROOT | ./target/… / . | binaires appelés par les scripts + racine du dépôt |
VMP_WORK_DIR | répertoire temporaire système | espace de travail du lift |
EFLAGS / IN_RET / DLL_MAIN | — | variantes d'état du snapshot |
ret sur page zéro, stubs d'import, hook IN).reg alimente un chargement d'octet exécuté, quel que soit son
mnémonique. Les motifs statiques movzx ne servent que de graine de repli —
les détections purement statiques mesuraient 0 % d'exécution sur des cibles durcies.
Couverture des formes de fetch : movzx ✓, movsx ✓ (le SMC bascule entre
les deux en cours d'exécution ; le mineur accepte les deux), fetches à porte and/co-octet ✓
via capture en direct. Biais mesuré (3.9.4, back-slices ancrés sur le dispatch de devirt fetch
vs scan statique strict) : populations disjointes — le capteur a trouvé 8 sites d'octets en forme de fetch que
le filtre motif+mov-imm32 n'a jamais proposés (formes indexées/à échelle
comme movzx edx,[r9+riz-1]), 1 a miné une chaîne vérifiée
(Rol→Inc→Xor52→Ror, clé r10l) ; les autres sont des chargements en contexte VM
que le mineur rejette correctement. Autres formes (par ex. opérations sur chaînes) : fournir les octets,
obtenir un cas de mineur — ouvrir une issue avec les octets d'opcode
autour du fetch. Le fetch verrouillé sur motif est une non-méthode documentée ici.opt -O3, émettre les cartes/dataflow,
recompiler avec llc (ld -r prouve la composabilité).synth (simplify_chain, attribution
dans le code). Nous avons conservé Remill+LLVM comme lifter ; pas d'échange d'IR.devirt brighten (le pool ne se déclenche pas sur 3.9 — documenté).backend/mba.rs (dérivé de l'article, aucun code tiers intégré).MIT (voir LICENSE) avec notes sur les dépendances (notamment Unicorn GPL-2.0). Usage de recherche/éducation uniquement, sur des binaires que vous possédez ou êtes autorisé à analyser.
Construit avec l'assistance de l'IA (conception, code, docs — dirigé par un humain,
vérifié par machine : chaque chiffre dans docs/coverage.md se reproduit
à partir des commandes qui l'accompagnent).