Инспектирует, декомпилирует и структурно патчит байт-код Hermes (HBC) из приложений React Native, с REPL в стиле GDB, CFG, декомпилятором и патчером с повторной сериализацией.
Интерактивный набор инструментов для обратной разработки и манипулирования Hermes.
hermit инспектирует, декомпилирует и структурно патчит байткод Hermes (HBC) — формат, в котором React Native приложения поставляют свой JavaScript. Откройте файл .hbc, просмотрите его функции, прочитайте декомпилированный JavaScript, отредактируйте инструкции, строки и литералы в интерактивном редакторе и запишите обратно файл, который Hermes VM всё ещё загружает и выполняет.
В отличие от инструментов, которые только анализируют байткод или патчат его на месте без изменения размеров, hermit повторно сериализует весь файл. Он может вставлять и удалять инструкции, перемещать переходы и обработчики исключений, перестраивать таблицы строк и литералов, добавлять новые функции и пересчитывать SHA-1 в футере. Немодифицированный файл проходит круговой цикл байт в байт.
.hbc| Версия | Роль |
|---|---|
| 96 | Основная цель. То, что используют поставляемые React Native приложения: RN 0.73 до 0.83, и RN 0.84+ с отключённым Hermes V1. |
| 94, 95 | Проверены. Формат идентичен 96, отличаются только таблицы опкодов. |
Приложения, собранные с Hermes V1 (по умолчанию с RN 0.84), выдают HBC 98, который пока
не поддерживается. Заметки о формате находятся в doc/hbc-format/.
Каждый релиз содержит архивы для macOS и Linux, на arm64 и x86_64. Python или компилятор не нужны:
| Архив | Содержимое |
|---|---|
hermit-<version>-<platform>.tar.gz | Интерактивный REPL: ./hermit file.hbc. |
hermit-tools-<version>-<platform>.tar.gz | Автономные инструменты командной строки hbc_*. |
SHA256SUMS | Контрольные суммы: shasum -a 256 -c SHA256SUMS. |
tar -xzf hermit-0.1.0-macos-arm64.tar.gz
./hermit-0.1.0-macos-arm64/hermit --version
Бинарные файлы macOS не подписаны. После загрузки один раз снимите флаг карантина: xattr -dr com.apple.quarantine hermit-0.1.0-macos-arm64. Сборкам для Linux требуется glibc 2.35 или новее. Команде cfg по-прежнему нужен установленный graph-easy.
Релизы создаются в .github/workflows/release.yml при отправке тега v* с помощью packaging/build-release.sh, который вы также можете запустить локально.
FetchContent, если они ещё не установлены.graph-easy для команды cfg (cpanm Graph::Easy), less в качестве пейджера.Выполняйте все команды из этого каталога (того, который содержит CMakeLists.txt):
cmake -B build
cmake --build build -j
Собирает статическую библиотеку libhbc, модуль Python _libhbc (в
build/bindings/), инструменты командной строки (в build/tools/) и модульные
тесты. REPL требует только модуль Python:
cmake --build build --target _libhbc
Инструменты и тесты можно исключить из сборки, например для релиза:
cmake -B build -DCMAKE_BUILD_TYPE=Release -DHERMIT_BUILD_TOOLS=OFF -DHERMIT_BUILD_TESTS=OFF
Пересоберите той же командой после каждого изменения в core/ или bindings/.
macOS: если компоновка завершается ошибкой о повреждённом SDK, укажите сборке полный SDK, например
SDKROOT=/Library/Developer/CommandLineTools/SDKs/MacOSX26.5.sdk cmake --build build.
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
Модуль _libhbc не устанавливается в virtualenv. Добавьте его каталог сборки в PYTHONPATH всякий раз, когда запускаете hermit:
export PYTHONPATH=$PWD/build/bindings:$PYTHONPATH
.hbcПриложение React Native поставляется со своим бандлом в виде обычного файла:
| Платформа | Расположение внутри пакета |
|---|---|
Android (.apk, zip-архив) | assets/index.android.bundle |
iOS (.ipa, zip-архив) | Payload/<App>.app/main.jsbundle |
Если файл начинается с байтов C6 1F BC 03 C1 03 19 1F, это байткод Hermes. REPL открывает только файлы с расширением .hbc, поэтому переименуйте его:
unzip -p app.apk assets/index.android.bundle > app.hbc
xxd app.hbc | head -1 # c61f bc03 c103 191f ...
Анализируйте только те приложения, которые вам разрешено изучать, например собственные или приложения с открытым исходным кодом для исследований.
Чтобы получить небольшие контролируемые входные данные, скомпилируйте JavaScript или TypeScript с помощью компилятора
Hermes, который выдаёт HBC 96 (например, hermesc из react-native 0.73 до
0.83, в node_modules/react-native/sdks/hermesc/):
hermes -emit-binary -g0 -out hello.hbc hello.js # -g0: no debug info
Пакет seeder/ автоматизирует этот процесс для примеров программ в
seeder/samples/ и записывает результаты в seeder/corpus/:
.venv/bin/python -m seeder.compile # all samples
.venv/bin/python -m seeder.compile --g0 seeder/samples/loop_sum.js
.venv/bin/python -m seeder.compile --debug seeder/samples/greeting.js
--g0 записывает <name>_g0.hbc без отладочной информации, --debug записывает
<name>_g.hbc с полной отладочной информацией. Для образцов .ts требуется tsc в вашем PATH;
компилятор берётся из --hermes (по умолчанию hermes). seeder/build-real-bundle.sh
собирает реальное open-source приложение React Native в .hbc.
export PYTHONPATH=$PWD/build/bindings:$PYTHONPATH
.venv/bin/python -m cli.main app.hbc
Без аргумента с файлом REPL запускается пустым; используйте open <file.hbc>. В приглашении отображаются версия HBC и имя файла, со знаком + при наличии несохранённых изменений: [hbc v96 | app+] >. История хранится в ~/.hermit_history, а команды дополняются по Tab.
> info
> strings --identifiers filter:fetch
> functions
> disasm func:12
> decompile func:isPremium
> xrefs string:"api.example.com"
> edit func:isPremium
> patch patched.hbc
Функции адресуются по индексу или имени (func:12, func:isPremium), строки
по индексу или значению (string:42, string:"hello"), литеральные сайты по индексу
(array:7).