hermes-decomp

React Native 뒤에 있는 JS 엔진인 Hermes 바이트코드(.hbc)용 Rust 디컴파일러입니다. HBC 40부터 99까지 지원합니다.

설치

Releases 또는 Actions에서 제공하는 사전 빌드된 바이너리(Linux / macOS / Windows):

에셋 접미사	플랫폼
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      # 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 --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"

기능

영역	명령어 (주요 항목)
읽기	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.

참고:

• 전체 번들 decompile은 빠른 재로드를 위해 디스크 상의 .hdcache 를 사용합니다. 강제하려면 --no-cache를 전달하세요.
• 쓰기 도구는 바이트코드 / HASM을 패치합니다. 디컴파일된 JavaScript를 다시 컴파일하지는 않습니다.
• decompile -o …는 파이프라인 단계를 stderr에 출력합니다.

MCP 및 라이브러리

• AI 어시스턴트용 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 를 참고하세요. PR 전에 이슈를 먼저 열어 주세요.

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

리소스

• Hermes Engine · React Native

라이선스

MIT. LICENSE 참조.