hermes-decomp v0.2.3 — A powerful decompiler that lets you reverse-engineer React Native mobile apps by converting their compiled Hermes bytecode (.hbc) files back into readable JavaScript.

Hermes Bytecode Decompiler

Decompilatore Rust per il bytecode Hermes (.hbc), il motore JS alla base di React Native. Supporta HBC dalla 40 alla 99.

Installazione

Binari precompilati (Linux / macOS / Windows) disponibili su Releases o Actions:

Suffisso asset	Piattaforma
`linux-x86_64` / `linux-arm64`	Linux
`macos-arm64` / `macos-x86_64`	macOS
`windows-x86_64`	Windows

Gli archivi includono hermes-decomp e hermes-mcp. Verifica: shasum -a 256 -c SHA256SUMS.

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

Dai sorgenti (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

Avvio rapido

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"

Disassembly Example

Decompilation Example

Cosa fa

Area	Comandi (in evidenza)
Lettura	`info`, `disasm`, `decompile`, `tui`, `extract`, `modules`, `deps`
Analisi	`xref`, `callgraph`, `graphviz`, `closures`, `debug`, `dump`, `bin-diff`
Strumenti RE	`secrets`, `frida-hooks`
Scrittura (solo bytecode)	`emit-hasm`, `asm`, `asm-check`, `patch-string`, `patch-function`, `inject-stub`, `create`

Flag completi ed esempi → docs/USAGE.md.

Note:

Il comando decompile sull'intero bundle utilizza una .hdcache su disco per ricaricamenti rapidi. Usa --no-cache per forzare.
Gli strumenti di scrittura modificano bytecode / HASM. Non ricompilano il JavaScript decompilato.
decompile -o … stampa le fasi della pipeline su stderr.

MCP e libreria

Server MCP (hermes-mcp) per assistenti AI → docs/MCP.md
Template di configurazione: mcp-config.example.json
Crate Rust hbc-decomp → docs/LIBRARY.md

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

Contribuire

Vedi CONTRIBUTING.md. Apri una issue prima di una PR.

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

Risorse

Hermes Engine · React Native

Licenza

MIT. Vedi LICENSE.