# hack-bitgod/whatsapphacking architecture

> Architecture diagram of the GitHub repository hack-bitgod/whatsapphacking, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hack-bitgod/whatsapphacking
- Repository: https://github.com/hack-bitgod/whatsapphacking

## Overview

##### Project Type and Purpose
- This is a command‐line driven Android “builder” tool whose goal is to (a) generate a specially crafted WhatsApp message to crash the official client, and (b) repackage/install a malicious WhatsApp APK containing a payload that extracts media files.
- It combines shell scripts, a Python helper, a Gradle-based Android app, raw smali payload code, auxiliary Java libraries, and signing keystores.

##### High‐Level File‐Structure Analysis
- Top level:
- whatsapphack.sh & hack.py – the orchestrating scripts.
- cleanup.sh – resets any temporary artifacts.
- data/ – a Gradle Android project (“app”) plus wrapper configs.
- payload/ – decompiled APK smali code with a Metasploit stage.
- java/classes/ – helper Java bytecode utilities (e.g., obfuscator).
- lib/aso.jar – third-party libraries.
- signingg.keystore & key.keystore – keys for APK signing.
- WhatsApp_files/ – CSS/JS snippets for the crash text delivery.
- Patterns:
- Builder pipeline: scripts → payload injection → Gradle build → sign → output APK.
- Modular separation: Android source (data/app), raw smali stage (payload/), utility code (java/classes, lib/).

##### Key README Insights
- Describes prerequisites (Java JDK, Gradle, Android Studio).
- Explains execution steps: clone repo, run whatsapphack.sh, optionally run crash via Python.

##### Detailed Capture of Essential Elements
- Signing keystore feeding into the final artifact node.
- A loop from cleanup.sh back to build modules for iterative runs.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Dependencies
    External["Java JDK / Android SDK / Gradle"]:::external

    %% Orchestration Scripts
    whatsapphack["whatsapphack.sh"]:::script
    hackpy["hack.py"]:::script
    cleanup["cleanup.sh"]:::script

    %% Crash Assets
    WhatsAppFiles["WhatsApp_files/"]:::assets

    %% Payload Module
    subgraph "Payload Module"
        payloadOriginal["payload/original/"]:::builder
        payloadSmali["payload/smali/"]:::builder
        payloadRes["payload/res/"]:::builder
        payloadManifest["payload/AndroidManifest.xml"]:::builder
        payloadApktool["payload/apktool.yml"]:::builder
    end

    %% Android Builder Module
    subgraph "Android Builder Module"
        dataApp["data/app/"]:::builder
        gradlew["data/gradlew"]:::builder
        gradlewBat["data/gradlew.bat"]:::builder
        wrapperJar["data/gradle/wrapper/gradle-wrapper.jar"]:::builder
        wrapperProps["data/gradle/wrapper/gradle-wrapper.properties"]:::builder
        buildGradle["data/build.gradle"]:::builder
        settingsGradle["data/settings.gradle"]:::builder
        gradleProps["data/gradle.properties"]:::builder
        mainActivity["data/app/src/main/java/com/whatsapphack/MainActivity.java"]:::builder
        appManifest["data/app/src/main/AndroidManifest.xml"]:::builder
        appRes["data/app/src/main/res/"]:::builder
        dataApp --> mainActivity
        dataApp --> appManifest
        dataApp --> appRes
    end

    %% Utility Libraries
    subgraph "Utility Libraries"
        stringObf["StringObfuscator.smali"]:::util
        asoJar["lib/aso.jar"]:::util
        activationJar["data/app/libs/activation.jar"]:::util
        additionnalJar["data/app/libs/additionnal.jar"]:::util
        commonsCol["data/app/libs/commons-collections4-4.2.jar"]:::util
        commonsIo["data/app/libs/commons-io-2.6.jar"]:::util
        mailJar["data/app/libs/mail.jar"]:::util
    end

    %% Signing Infrastructure
    signingKeystore["signingg.keystore"]:::signing
    keyKeystore["data/key.keystore"]:::signing

    %% Final Artifact
    finalAPK["Malicious WhatsApp APK"]:::final

    %% Flows
    External -->|invokes| whatsapphack
    whatsapphack -->|calls| hackpy
    hackpy -->|generates crash payload| WhatsAppFiles
    whatsapphack -->|decodes original APK| payloadOriginal
    whatsapphack -->|inject smali| payloadSmali
    payloadOriginal --> payloadSmali
    payloadSmali --> payloadRes
    payloadRes --> payloadManifest
    payloadApktool --> payloadOriginal
    payloadSmali --> dataApp
    External -->|build| gradlew
    External -->|build| gradlewBat
    gradlew --> dataApp
    gradlewBat --> dataApp
    wrapperJar --> dataApp
    wrapperProps --> dataApp
    buildGradle --> dataApp
    settingsGradle --> dataApp
    gradleProps --> dataApp
    stringObf --> dataApp
    asoJar --> dataApp
    activationJar --> dataApp
    additionnalJar --> dataApp
    commonsCol --> dataApp
    commonsIo --> dataApp
    mailJar --> dataApp
    dataApp -->|compiles| finalAPK
    signingKeystore -->|signs| finalAPK
    keyKeystore -->|signs| finalAPK
    cleanup -->|cleans build| dataApp
    cleanup -->|cleans| payloadOriginal
    cleanup -->|cleans| payloadSmali

    %% Click Events
    click whatsapphack "https://github.com/hack-bitgod/whatsapphacking/blob/main/whatsapphack.sh"
    click hackpy "https://github.com/hack-bitgod/whatsapphacking/blob/main/hack.py"
    click cleanup "https://github.com/hack-bitgod/whatsapphacking/blob/main/cleanup.sh"
    click dataApp "https://github.com/hack-bitgod/whatsapphacking/tree/main/data/app/"
    click gradlew "https://github.com/hack-bitgod/whatsapphacking/tree/main/data/gradlew"
    click gradlewBat "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/gradlew.bat"
    click wrapperJar "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/gradle/wrapper/gradle-wrapper.jar"
    click wrapperProps "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/gradle/wrapper/gradle-wrapper.properties"
    click buildGradle "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/build.gradle"
    click settingsGradle "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/settings.gradle"
    click gradleProps "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/gradle.properties"
    click payloadOriginal "https://github.com/hack-bitgod/whatsapphacking/tree/main/payload/original/"
    click payloadSmali "https://github.com/hack-bitgod/whatsapphacking/tree/main/payload/smali/"
    click payloadRes "https://github.com/hack-bitgod/whatsapphacking/tree/main/payload/res/"
    click payloadManifest "https://github.com/hack-bitgod/whatsapphacking/blob/main/payload/AndroidManifest.xml"
    click payloadApktool "https://github.com/hack-bitgod/whatsapphacking/blob/main/payload/apktool.yml"
    click stringObf "https://github.com/hack-bitgod/whatsapphacking/blob/main/java/classes/net/dirtybox/util/obfuscation/StringObfuscator.smali"
    click asoJar "https://github.com/hack-bitgod/whatsapphacking/blob/main/lib/aso.jar"
    click activationJar "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/app/libs/activation.jar"
    click additionnalJar "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/app/libs/additionnal.jar"
    click commonsCol "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/app/libs/commons-collections4-4.2.jar"
    click commonsIo "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/app/libs/commons-io-2.6.jar"
    click mailJar "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/app/libs/mail.jar"
    click signingKeystore "https://github.com/hack-bitgod/whatsapphacking/blob/main/signingg.keystore"
    click keyKeystore "https://github.com/hack-bitgod/whatsapphacking/blob/main/data/key.keystore"
    click WhatsAppFiles "https://github.com/hack-bitgod/whatsapphacking/tree/main/WhatsApp_files/"

    %% Styles
    classDef external fill:#f2f2f2,stroke:#333,stroke-width:1px
    classDef script fill:#b8e986,stroke:#333,stroke-width:1px
    classDef builder fill:#a6cee3,stroke:#333,stroke-width:1px
    classDef util fill:#ffe680,stroke:#333,stroke-width:1px
    classDef signing fill:#d9b3ff,stroke:#333,stroke-width:1px
    classDef assets fill:#80d4ff,stroke:#333,stroke-width:1px
    classDef final fill:#ffb380,stroke:#333,stroke-width:1px
```
