
Statischer Analysator für Flutter/Dart-AOT-Snapshots — rekonstruiert Funktionsnamen, Klassenhierarchien, Aufrufgraphen und Verhaltenssignale aus libapp.so, ohne die Dart-VM einzubetten oder auszuführen. Unterstützt ARM64 und x86_64, Dart 2.10–3.12.
Ein Dart-AOT-Snapshot-Analysator. Verwandelt libapp.so — den kompilierten Dart-Code innerhalb einer Flutter-Release-APK — in Funktionsnamen, Klassenlayouts, Aufrufgraphen, Verhaltenssignale und lesbaren Pseudocode. Keine Dart-VM, keine SDK-Kompilierung, kein Runtime-Fallback.
Fork-Hinweis: AOTopsy ist ein Fork von unflutter, ursprünglich von Anthony Zboralski. Das ursprüngliche Repository
zboralski/unflutterist nicht mehr verfügbar (vom Autor entfernt); eine Community-Fortführung existiert unterKristijanZic/unflutter. Die gesamte Anerkennung für den ursprünglichen Snapshot-Parser, Cluster-Deserializer, die ARM64-Disassembly-Pipeline und die Ghidra/IDA-Integration gebührt dem ursprünglichen Autor. AOTopsy erweitert es um x86_64-Unterstützung, einen nativen Decompiler, programmweite Typinferenz, Frida-Skriptgenerierung und umfassende Dokumentation.
| Ausgabe | Was es ist |
|---|---|
| Funktionsnamen | Der ursprüngliche Dart-Name für jede kompilierte Funktion |
| Klassenstrukturen | Feldnamen, Byte-Offsets, Vererbungsketten |
| Aufrufgraph | Direkte (BL) und indirekte (BLR/Dispatch) Aufrufkanten mit Provenienz |
| String-Referenzen | Welche Funktionen welche String-Literale aus dem Objektpool laden |
| Verhaltenssignale | Klassifizierung von Krypto-, Netzwerk-, Glücksspiel-, SIM-, Standort-, WebView- und Blockchain-Schlüsselwörtern |
| Pseudocode | Architekturneutraler dekompilierter Output aus ARM64- oder x86_64-Maschinencode |
| Dart-Quellexport | Modular rekonstruierte .dart-Dateien des gesamten Projekts mit Klassen, Feldern und Methoden |
Unterstützt ARM64 und x86_64. Deckt Dart 2.10 bis 3.13 ab (3.13.2 ist die aktuelle stabile Grenze) — jede modellierte Version wird auf beiden Architekturen sauber geparst, siehe COVERAGE.md (93 Beispiel-Builds, 0 Fehler).
AOTopsy wird an der Ground Truth gemessen, nicht behauptet. Zwei Eigenschaften werden bei jeder Änderung durch die Testsuite erzwungen:
| Metrik | Wert | Was sie bedeutet |
|---|---|---|
| Übereinstimmung bei der Namenswiederherstellung | 90,2 % insgesamt (81,3 % schlechtestes Band, ≥ 0,81 Gate-Untergrenze) über 44 Ground-Truth-Builds | Wiederhergestellte Funktionsnamen im Vergleich zur eigenen ELF .symtab jedes Builds, der externen Ground Truth — TestSymtabDifferential. Vollständige Rangliste pro Build: BENCHMARK.md (make bench). |
| Syntaktische Gültigkeit des Decompilers | 100 % gültiges Dart | Jede ausgegebene Pseudocode-Funktion wird als Dart geparst — TestDecompileQualityCorpus. |
| Fabrikationsrate | 0 % | Die §2-Regel: niemals einen geratenen Namen, Typ oder Aufrufziel als Tatsache ausgeben. Unbekanntes wird ehrlich dargestellt (indirectCall, <unknown>, dynamic). |
Die Ground-Truth-Zwillinge sind echte Produktions-Builds, die wir nicht weitergeben können, daher laufen diese differentiellen Gates lokal; die öffentliche CI validiert Build, Vet, gofmt, staticcheck, Unit-Tests (gemischt) und eine Coverage-Untergrenze über die Plattformmatrix. samples/ ist nicht weitergebbar und wird von Git ignoriert, daher werden sample-abhängige Tests dort übersprungen — aber nur, wenn das Korpus vollständig fehlt; ein Korpus, der vorhanden ist und ein registriertes Sample vermissen lässt, schlägt fehl, weil diese beiden Fälle das Gegenteil bedeuten. Wie jede Zahl hier gemessen wird (Ground Truth, Metrikdefinitionen, Reproduktion): METHODOLOGY.md. Siehe SECURITY.md für die Verifikation von Release-Binaries und den ehrlichen Geltungsbereich unten.
make build
./aotopsy libapp.so # full pipeline
./aotopsy doctor libapp.so # quick diagnostic
./aotopsy export-dart --lib libapp.so --out ./lib # reconstruct entire Dart source project
./aotopsy _debug decompile-native --lib libapp.so --find MyClass # find and decompile a function
Siehe DEMO.md für eine fünfminütige Einführung anhand eines echten Snapshots oder WORKFLOW.md für die schrittweise Methodik, wenn Sie eine rohe APK haben und nicht wissen, wo Sie anfangen sollen.
AOTopsy behandelt den Dart-AOT-Snapshot als eine deterministische binäre Grammatik. Jedes Byte hat bei den richtigen Einschränkungen (ELF-Struktur, Snapshot-Magic, Versions-Hash, CID-Tabelle, Cluster-Encoding) genau eine korrekte Interpretation. Der Parser wendet Einschränkungen an, bis nur noch eine Interpretation übrig bleibt – keine Heuristiken, kein Raten.
Die Pipeline läuft in Stufen ab, wobei jede eine reine Funktion von Bytes zu strukturierten Daten ist:
flowchart TD
A[libapp.so] --> B[ELF parse]
B --> C[snapshot region extraction]
C --> D[version detection]
D --> E[cluster alloc<br/>object census]
E --> F[cluster fill<br/>field values, names, strings]
F --> G[instructions table<br/>code ranges, stub boundaries]
G --> H{architecture?}
H -->|ARM64| I[ARM64 disassembly]
H -->|x86_64| J[x86_64 disassembly]
I --> K[CFG + call edges<br/>register provenance]
J --> K
K --> L[type inference<br/>BLR receiver type resolution]
L --> M[signal classification<br/>behavioral keyword matching]
M --> N[JSONL + HTML + DOT<br/>pseudocode output]
Zwei unabhängige Backends teilen sich dieselbe vordere Hälfte (ELF bis Cluster-Füllung) und verzweigen sich dann nach Architektur: internal/disasm für ARM64, internal/disasm/x86.go für x86_64. Der Decompiler (internal/decompiler) verarbeitet beide Architekturen über eine einheitliche IR.
flowchart LR
subgraph "Shared front half"
A[elfx] --> B[snapshot]
B --> C[cluster]
end
subgraph "ARM64 backend"
C --> D1[disasm ARM64]
D1 --> E1[callgraph]
E1 --> F1[signal]
end
subgraph "x86_64 backend"
C --> D2[disasm x86_64]
D2 --> E2[callgraph]
E2 --> F2[signal]
end
subgraph "Decompiler (both archs)"
C --> G[decompiler IR]
G --> H[pseudocode]
end
flowchart LR
subgraph Blutter
direction TB
B1[libapp.so] --> B2[Compile matching<br/>Dart SDK]
B2 --> B3[Embed Dart VM]
B3 --> B4[Deserialize via<br/>VM internal APIs]
B4 --> B5[Perfect fidelity]
end
subgraph AOTopsy
direction TB
A1[libapp.so] --> A2[Parse binary format<br/>directly]
A2 --> A3[No VM, no SDK]
A3 --> A4[Version-specific<br/>format modeling]
A4 --> A5[Portability + speed]
end
Blutter bettet die Dart-VM ein, um den Snapshot über ihre eigenen Codepfade zu deserialisieren. Perfekte Genauigkeit, erfordert jedoch das Kompilieren eines passenden Dart-SDK für jede Zielversion – und es ist nur für ARM64 verfügbar, ohne statische x86_64-Unterstützung. AOTopsy ist der einzige statische, versionsunabhängige Analyzer mit einem nativen Pseudocode-Decompiler und veröffentlichter Ground-Truth-Genauigkeit.