hermes-decomp

Décompilateur Rust pour le bytecode Hermes (.hbc), le moteur JS derrière React Native. Prend en charge HBC 40 à 99.

Installation

Binaires précompilés (Linux / macOS / Windows) depuis Releases ou Actions :

Les archives incluent hermes-decomp et hermes-mcp. Vérification : shasum -a 256 -c SHA256SUMS.

hermes-decomp update --check      # or --install / --version v0.1.7

Depuis les sources (Rust 1.70+) :

git clone https://github.com/SymbioticSec/hermes-decomp.git
cd hermes-decomp && cargo build --release
# → target/release/hermes-decomp  target/release/hermes-mcp

Démarrage rapide

hermes-decomp info app.hbc
hermes-decomp disasm app.hbc --function 5 --info --show-offsets
hermes-decomp decompile app.hbc -o out.js          # progress on stderr
hermes-decomp decompile app.hbc --deep -o out.js   # recover more names, slower
hermes-decomp decompile app.hbc --function 42
hermes-decomp tui app.hbc
hermes-decomp xref app.hbc --query "loginWithToken"

Ce qu'il fait

Options complètes et exemples → docs/USAGE.md.

Remarques :

• Le decompile d'un bundle complet utilise un .hdcache sur disque pour des rechargements rapides. Passer --no-cache pour forcer.
• Les outils d'écriture patchent le bytecode / HASM. Ils ne recompilent pas le JavaScript décompilé.
• decompile -o … affiche les étapes du pipeline sur stderr.

MCP et bibliothèque

• Serveur MCP (hermes-mcp) pour assistants IA → docs/MCP.md
  Modèle de configuration : mcp-config.example.json
• Crate Rust hbc-decomp → docs/LIBRARY.md

cargo build --release -p hbc-decomp-mcp

Contribution

Voir CONTRIBUTING.md. Merci d'ouvrir une issue avant une PR.

cargo build --release --workspace && cargo test --workspace

Ressources

• Hermes Engine · React Native

Licence

MIT. Voir LICENSE.