hermes-decomp

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

Установка

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

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

hermes-decomp update --check      # or --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          # progress on stderr
hermes-decomp decompile app.hbc --function 42
hermes-decomp tui app.hbc
hermes-decomp xref app.hbc --query "loginWithToken"

Что делает

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

Примечания:

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

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

• MCP-сервер (hermes-mcp) для ИИ-ассистентов → 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.