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

Декомпилятор на Rust для байт-кода Hermes (.hbc) — JS-движка, лежащего в основе React Native. Поддерживает HBC 40–99.

Установка

Готовые бинарники (Linux / macOS / Windows) из Releases или Actions:

Суффикс ассета	Платформа
`linux-x86_64` / `linux-arm64`	Linux
`macos-arm64` / `macos-x86_64`	macOS
`windows-x86_64`	Windows

Архивы содержат hermes-decomp и hermes-mcp. Проверка: shasum -a 256 -c SHA256SUMS.

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

Из исходников (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

Быстрый старт

hermes-decomp info app.hbc
hermes-decomp disasm app.hbc --function 5 --info --show-offsets
hermes-decomp decompile app.hbc -o out.js          # прогресс в stderr
hermes-decomp decompile app.hbc --deep -o out.js   # больше имён, медленнее
hermes-decomp decompile app.hbc --function 42
hermes-decomp tui app.hbc
hermes-decomp xref app.hbc --query "loginWithToken"

Пример дизассемблирования

Пример декомпиляции

Что умеет

Область	Команды (основные)
Чтение	`info`, `disasm`, `decompile`, `tui`, `extract`, `modules`, `deps`
Анализ	`xref`, `callgraph`, `graphviz`, `closures`, `debug`, `dump`, `bin-diff`
Помощь в RE	`secrets`, `frida-hooks`
Запись (только байт-код)	`emit-hasm`, `asm`, `asm-check`, `patch-string`, `patch-function`, `inject-stub`, `create`

Полные флаги и примеры → docs/USAGE.md.

Примечания:

Полная декомпиляция бандла использует дисковый кэш .hdcache для быстрой перезагрузки. Передайте --no-cache, чтобы отключить.
Инструменты записи патчат байт-код / HASM. Они не перекомпилируют декомпилированный JavaScript.
decompile -o … выводит этапы конвейера в stderr.

MCP и библиотека

MCP-сервер (hermes-mcp) для AI-ассистентов → docs/MCP.md
Шаблон конфигурации: mcp-config.example.json
Rust-крейт hbc-decomp → docs/LIBRARY.md

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

Участие в разработке

См. CONTRIBUTING.md. Пожалуйста, откройте issue перед PR.

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

Ресурсы

Hermes Engine · React Native

Лицензия

MIT. См. LICENSE.