obfuskator/todo.md
loki5512344 7e7037001e
Initial commit: noxis JVM bytecode obfuscator
Workspace of 9 crates (noxis, noxis-core, noxis-classfile, noxis-analysis,
noxis-passes, noxis-runtime, noxis-jar, noxis-verify, noxis-structure-check).
AGPL-3.0-only license, Rust 2024 edition, unsafe_code denied.
2026-10-08 22:01:03 +02:00

16 KiB
Raw Blame History

todo.md — план работ noxis

Обновляется по мере выполнения. Текущее состояние кодовой базы — в docs/architecture.md (раздел «Статус»).

Обозначения: [x] готово и проверено, [~] частично, [ ] не начато, [!] заблокировано другим пунктом.


0. Каркас и правила — готово

  • Workspace: Cargo.toml, lints (deny(unsafe_code)), release-профиль
  • Крейты: noxis-classfile, noxis-core, noxis-analysis, noxis-passes, noxis-runtime, noxis-jar, noxis-structure-check
  • noxis-structure-check: 250 строк / 4 файла, вызывается из build.rs каждого крейта, сканирует src/ + docs/
  • cargo:rerun-if-changed на проверяемые деревья (гейт реагирует на docs/)
  • scripts/check.sh — check → fmt --check → clippy -D warnings → test
  • Документация: docs/README, architecture, techniques, stack, learnings/{lessons,reference,priorities}
  • Гейт проверяет и crates/*/tests, crates/*/benches (правило нельзя обойти выносом кода в тесты)
  • Лицензия: LICENSE (MIT), Cargo.toml → license = "MIT", NOTICE.md — third-party (ristretto_classfile)

1. Данные и модель — готово

  • IR: Program → ClassFile → Code → Insn, метки вместо смещений
  • Attribute::Raw — round-trip непонятных атрибутов
  • Builder + writer (без frames), frames::compute_frames — заглушка P1
  • Конфиг: Profile, RenameConfig, StringsConfig, DebugConfig, NoiseConfig, FlowConfig; загрузка из TOML
  • Детерминированный PRNG: xoshiro256++ + splitmix64 + доменное разделение по FNV-1a
  • Маппинги классов/полей/методов + JSON-отчёт Report/PassReport
  • Контракт Pass + Context::rng(domain)

2. Анализ — готово

  • hierarchy: слои наследования, check::virtual_safe
  • entrypoints: main, <clinit>, ServiceLoader, jar:file из manifest
  • keep: reflection по строкам (Class.forName, getMethod, …), fixed-члены (serialVersionUID, access_widened, JNI/native), поддержка format::compute_frames (stackmap), сериализация, @Override + getMethod для стабов, record-аксессоры, enum-константы (values/valueOf/$VALUES)
  • Детект класса из дескриптора (Lpkg/C; + dotted + slash)

3. Пассы

3.1 Переименование — готово

  • namegen: алфавиты, builtin/english/cyrillic-стили, счётчики, запрет одинаковых имён в scope, $ только если включено
  • rename::assign: классы в пакеты, private/static/final → Safe, virtual → семейства, widening по keep::widen + policy
  • rename::rewrite: дескрипторы, LDC-классы, вызовы, поля, exception table, Signature/Exceptions/InnerClasses/MethodParameters
  • standard_pipeline() — каркас конвейера
  • Тесты: round-trip классов, constant_value не тронут, ACC_BRIDGE, package-info, module-info

3.2 Строки — готово

  • noxis-runtime::scheme: XorSplitmix + XteaCtr, salt→ключ, nonce→stream, FNV-1a MAC, roundtrip/tamper-тесты
  • noxis-runtime::decoder: ABI d(Ljava/lang/String;I)Ljava/lang/String;
  • пасс strings (passes/strings/{mod,crypt,tests}): замена Const::String → cipher+salt+invokestatic, ротация схем по salt % n (salt всегда неотрицателен), split на 1–3 чанка + String.concat
  • генератор класса-декодера (runtime/decoder/{mod,kdf,xor,xtea}): v49 без StackMapTable, KDF через FNV+ByteBuffer, мастер как k1^k2, обе схемы побайтово зеркалят Rust
  • вывод мастер-секрета в рантайме (B2): части в ldc2_w, сборка в декодере
  • приёмка: runtime/tests/exec.rs — шифруем в Rust, расшифровываем настоящим java (6 строк × 2 схемы, побайтовое сравнение stdout)

3.3 Константы — готово (int/long)

  • пасс constants (passes/constants/{mod,forms,tests}): x^k, a+b, сдвиг; ConstantsConfig{schemes, max_predicates, skip} (секция TOML)
  • opaque-предикаты: (C*C+C)&1 == 0 + мёртвая ветвь из nop (константные — честно слабее против свёртки, см. ограничения)
  • отдельные схемы для int/long; float/double — не тронуты

3.4 Контрольный поток — кадры готовы, схемы не начаты

  • spike ristretto_classfile 0.34 — backend выбран и подтверждён (tests/spike_ristretto.rs: сборка/verify/round-trip/запись кадров)
  • spike по генерации кадров (tests/spike_frames.rs): inference работает, но кадры наружу не отдаются — inference/diagnostics/frame объявлены pub(crate), строгий режим возвращает Err(VerifyError)
  • решение: кадры считаем сами на своём IR; вендор inference отвергнут (14 crate::-ссылок, весь verifiers/bytecode/ ≈ 9 700 строк, весь крейт 61 193 строки) — обоснование в docs/stack.md §3
  • реализация format::parse / format::write поверх ристретто (parse/{class,attrs}, write/{mod,pool,attrs,code/{mod,insns,ops,frames}}; пул строится заново детерминированным обходом; tests/roundtrip.rs: минимальный класс, ветвления+handler+кадры, bootstrap — все green)
  • SlotKind в Insn::Load/Store (тип слота терялся при parse — writer не мог восстановить aload vs iload); найдены пропущенные laload/lastore (падали с «неизвестная инструкция»)
  • Attribute::{BootstrapMethods, EnclosingMethod, MethodParameters, ConstantValue} — ссылки пула переживают пересборку; keep лочит BSM-методы от переименования; debug режет новые варианты
  • compute_frames вместо заглушки (границы блоков, worklist, merge/LUB через Hierarchy-трейт, эмиссия StackMapFrame) (format/frames/{mod,flow,emit,tests,xfer/{mod,stack,calls},merge/{mod,descs}})
  • приёмка: java -Xverify:all на фикстурах (tests/data 4 класса + tests/frames.rs: снести кадры → посчитать → round-trip → java для JDK-классов; verify_class(Strict) для приёмки НЕ годится — backend хранит кадры в индексах, а его верификатор ждёт байты)
  • закрыты дыры: I2d/I2D, Record + LocalVariableTypeTable как явные варианты (Raw со старыми индексами ломал чтение); кадры Append — на гранулярности переменных ([Top, Long] отвергает JVM)
  • 4 схемы: state-spread, computed-switch, butterfly, exception-goto
  • ротация схем между методами + мешанина внутри метода
  • только после: включение в standard_pipeline

3.5 Шум — готово (без аннотаций)

  • junk-классы + weave_reachable (passes/noise/{mod,weave}): shadow/decoyN с run()V, вызов вшит перед терминалом живого метода
  • бюджет раздувания (junk_ratio × классы; по умолчанию 0 — выключено)
  • junk-аннотации: пропущены сознательно (сырые атрибуты не несут свежие индексы пула — нужно моделирование аннотаций)

3.6 Отладочная информация — готово

  • DebugInfoPass: strip LineNumberTable, LocalVariableTable, Signature, InnerClasses, EnclosingMethod, MethodParameters
  • spoof_source_file — ложное, но правдоподобное имя (B4)
  • детерминированность подмены от мастер-сида
  • fake_line_numbers — ложные номера строк (не только SourceFile)
  • strip_source_file — полное удаление вместо подмены

3.7 Ресурсы — частично

  • крейт noxis-jar: чтение/запись ZIP (порядок, deflate, дубликаты)
  • strip_signatures — *.SF/*.RSA/*.DSA/*.EC, META-INF/SIG-*
  • load/save — архив ↔ Program (классы через парсер, остальное ресурсы)
  • пасс resources: патч текстовых ресурсов по маппингу (boundary-замена), META-INF/services/*, 9 тестов, в standard_pipeline
  • fabric.mod.json, *.mixins.json, refmap, access widener

4. Верификация — не начато

  • крейт noxis-verify: красный список паттернов (хранится в репо)
  • утечки имён: эталонный список идентификаторов → тест падает при утечке
  • java -Xverify:all subprocess на обфусцированном jar
  • метрики: размер, время, доля распознанных структур в декомпиляте
  • бюджеты: ≤ N% размера, ≤ M% времени
  • проверка стабильности между сборками (маппинги обязаны меняться)
  • P3: опция ristretto_vm (встраиваемый JVM) вместо системного java

5. CLI — не начато

  • крейт noxis: obfuscate, analyze, patterns
  • флаги конфига + --seed (детерминированность по умолчанию)
  • честные off-ключи: --no-strings, --no-flow, --no-junk, …
  • JSON-отчёт маппингов

6. Тесты и данные

  • regression-кейсы из референса: smoke-safe, smoke-inheritance, smoke-flow, smoke-fields, smoke-aes
  • встроить .class-фикстуры в noxis-classfile/tests/data/
  • противник-скрипт (свёртка констант, regex) как тест в noxis-verify

6.1 Fixtures — jar из /storage/project/jvm/ (найдены, не подключены)

jar классов major StackMapTable тип
LoReport/build/libs/lorep-1.1.0.jar 17 65 15 Spigot-плагин, быстрый smoke
hillsphere/neoforge/build/libs/hillsphere-neoforge-1.21.1-0.1.0.jar 40 65 22 NeoForge-мод, Java 21
LoParkour/build/libs/LoParkour-1.4.0.jar 274 65 204 Spigot-плагин, средний
LoChat/build/libs/LoChat-1.5.5-1.20.1.jar 1 080 51/52/65 591 микс версий — стресс
oc2r/build/libs/oc2r-1.21.1-neoforge-0.1.1+78704d26.jar 1 278 65 659 NeoForge, 28 MB (shaded)
LoVisual/mod/build/libs/lovisual-0.1.1.jar 4 082 47–69 2 251 Fabric, включает major 47/49 без кадров
  • скопировать в fixtures-каталог репозитория (licenses permitting)
  • прогон load → pipeline → save → verify на lorep и hillsphere
  • java -Xverify:all на каждом; для Fabric/NeoForge — только verify_class (запуск требует лаунчеров)

Порядок (что делать следующим)

  1. Ремонт структуры + тулчейн — готов (08.10.2026, оценка 55/100). Гейт падал на parse/code.rs/insns.rs — разбиты; 8 латентных багов orphan-кода исправлены; stable 1.97→1.99, edition→2024, toml→1.1.7; MSRV 1.97. ./check.sh — OK.
  2. noxis-jar — готов.
  3. Пасс debug — готов (P0/A2/B4).
  4. Пасс resources — готов (P0/A4).
  5. Spike ristretto_classfile — backend выбран, ограничение найдено.
  6. format::parse/format::write (P1) — готов (08.10.2026): классовый уровень поверх ристретто, пул с нуля, StackMapTable туда-обратно (байтовые дельты ↔ индексные), verify() backend'а на выходе writer'а, tests/roundtrip.rs (3 теста). Снимает блокер writer'а и генератора декодера, то есть и strings, и flow. Известные ограничения (P2): rename не переписывает ссылки внутри BootstrapMethods (имена лочатся в keep, классы с BSM переименовывать методы не будут — безопасно, но менее мутно); Raw-атрибуты со ссылками пула (аннотации, ...) несут старые индексы — моделировать явно (Record + LocalVariableTypeTable уже смоделированы 08.10.2026) или переходить на пул-сохраняющий writer.
  7. Кадры StackMapTable (P1) — готов (08.10.2026): свой dataflow (format/frames/{mod,flow,emit,tests,xfer/{mod,stack,calls},merge/{mod,descs}}, Hierarchy-трейт для LUB); приёмка — java -Xverify:all на фикстурах (tests/data 4 класса, tests/frames.rs): снести → посчитать → round-trip → java зелёный для JDK-классов.
  8. Пассы strings, constants, noise — готовы (08.10.2026): строки с декодером v49 (сквозной тест исполнением), константы int/long
    • opaque, шум с вплетанием; все в standard_pipeline. Ограничения: opaque константные (бьются свёрткой); float/double не шифруются; junk-аннотации пропущены; rename не правит ссылки в BSM.
  9. noxis-verify — метрики, красные паттерны, java -Xverify:all.
  10. noxis (CLI) — последним: он собирает всё вместе.

После каждого пункта — ./scripts/check.sh.


Долг структуры (на грани лимита, разбить превентивно)

  • noxis-passes/src/debug.rs — 249/250
  • noxis-analysis/src/entrypoints.rs — 244/250
  • docs/stack.md — 242/250
  • noxis-passes/src/rename/{mod,assign} — 232–237/250
  • noxis-passes/src/namegen/mod.rs — 215/250
  • noxis-runtime/src/decoder/{xor,xtea}.rs — 243–245/250