hermes-decomp

Descompilador en Rust para bytecode de Hermes (.hbc), el motor JS detrás de React Native. Soporta HBC 40 a 99.

Instalación

Binarios precompilados (Linux / macOS / Windows) desde Releases o Actions:

Los archivos incluyen hermes-decomp y hermes-mcp. Verifica: shasum -a 256 -c SHA256SUMS.

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

Desde fuente (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

Inicio rápido

hermes-decomp info app.hbc
hermes-decomp disasm app.hbc --function 5 --info --show-offsets
hermes-decomp decompile app.hbc -o out.js          # progreso en stderr
hermes-decomp decompile app.hbc --function 42
hermes-decomp tui app.hbc
hermes-decomp xref app.hbc --query "loginWithToken"

Qué hace

Flags completos y ejemplos → docs/USAGE.md.

Notas:

• decompile de paquete completo usa un .hdcache en disco para recargas rápidas. Pasa --no-cache para forzar.
• Las herramientas de escritura parchean bytecode / HASM. No recompilan JavaScript descompilado.
• decompile -o … imprime las etapas del pipeline en stderr.

MCP y biblioteca

• Servidor MCP (hermes-mcp) para asistentes de IA → docs/MCP.md
  Plantilla de configuración: mcp-config.example.json
• Crate de Rust hbc-decomp → docs/LIBRARY.md

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

Contribuir

Consulta CONTRIBUTING.md. Por favor, abre un issue antes de un PR.

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

Recursos

• Hermes Engine · React Native

Licencia

MIT. Ver LICENSE.