# alphaautoleak/jnvm architecture

> Architecture diagram of the GitHub repository alphaautoleak/jnvm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alphaautoleak/jnvm
- Repository: https://github.com/alphaautoleak/jnvm

## Overview

JNVM is a Java bytecode protection tool. A user supplies a configuration and input JAR; the converter selects protected methods, extracts bytecode, prepares obfuscated/encrypted method data, generates a native VM and bridge, compiles libraries for configured targets, rewrites protected methods, and packages the result as an output JAR. The graph preserves documented capabilities such as configurable rules, opcode obfuscation, string encryption, cross-platform compilation, and experimental invokedynamic. Some pipeline links come from the README because the converter implementation was not sampled.

Main entry points: [`src/main/java/com/alphaautoleak/jnvm/converter/Converter.java`](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/converter/Converter.java) (Conversion orchestrator), [`src/main/java/com/alphaautoleak/jnvm/codegen/NativeGenerationPlan.java`](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/NativeGenerationPlan.java) (Native generation plan), [`src/main/java/com/alphaautoleak/jnvm/Main.java`](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/Main.java) (CLI entry), [`src/main/java/com/alphaautoleak/jnvm/config/ProtectConfig.java`](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/config/ProtectConfig.java) (Protection config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and configuration"]
  node_main["CLI entry<br/>[Main.java]"]
  node_config["Protection config<br/>[ProtectConfig.java]"]
  node_converter["Conversion orchestrator<br/>[Converter.java]"]
end

subgraph group_analysis["Bytecode preparation"]
  node_scanner["JAR scanning<br/>[JarScanner.java]"]
  node_extractor["Bytecode extraction"]
  node_method["Method metadata<br/>[MethodInfo.java]"]
  node_rules["Protection rules"]
  node_crypto["Bytecode protection"]
  node_obfuscator["Opcode mapping"]
  node_methoddata["Protected method data"]
end

subgraph group_native["Native VM generation"]
  node_generation["Native generation plan"]
  node_datagen["VM data emission"]
  node_interpreter["VM interpreter"]
  node_instructions["Opcode implementations<br/>[Instruction.java]"]
  node_bridge["JNI bridge"]
end

subgraph group_delivery["Compilation and patching"]
  node_compiler["Zig compilation<br/>[ZigCompiler.java]"]
  node_patcher["JAR patching<br/>[JarPatcher.java]"]
  node_packager["Output packaging"]
end

node_user(("Protector user"))
node_input["Input JAR"]
node_zig["Zig toolchain"]
node_output["Protected JAR"]

node_user -->|"runs"| node_main
node_main -->|"builds config"| node_config
node_main -->|"starts conversion"| node_converter
node_config -->|"configures"| node_converter
node_input -->|"provides JAR"| node_converter
node_converter -->|"scans methods"| node_scanner
node_converter -->|"selects methods"| node_rules
node_converter -->|"extracts bytecode"| node_extractor
node_extractor -->|"records metadata"| node_method
node_converter -->|"encrypts bytecode"| node_crypto
node_converter -->|"obfuscates opcodes"| node_obfuscator
node_converter -->|"forms method data"| node_methoddata
node_methoddata -->|"supplies methods"| node_generation
node_generation -->|"generates VM data"| node_datagen
node_generation -->|"generates interpreter"| node_interpreter
node_generation -->|"generates bridge"| node_bridge
node_interpreter -.->|"dispatches opcodes"| node_instructions
node_converter -->|"compiles native code"| node_compiler
node_compiler -->|"invokes"| node_zig
node_converter -->|"rewrites classes"| node_patcher
node_patcher -->|"packages output"| node_packager
node_packager -->|"produces JAR"| node_output

click node_main "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/Main.java"
click node_config "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/config/ProtectConfig.java"
click node_converter "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/converter/Converter.java"
click node_scanner "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/asm/JarScanner.java"
click node_extractor "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/asm/BytecodeExtractor.java"
click node_method "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/asm/MethodInfo.java"
click node_rules "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/config/ProtectRuleMatcher.java"
click node_crypto "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/crypto/BytecodeEncryptor.java"
click node_obfuscator "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/crypto/OpcodeObfuscator.java"
click node_methoddata "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/crypto/EncryptedMethodData.java"
click node_generation "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/NativeGenerationPlan.java"
click node_datagen "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/emitter/VmDataGenerator.java"
click node_interpreter "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/emitter/VmInterpreterGenerator.java"
click node_instructions "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/emitter/Instruction.java"
click node_bridge "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/emitter/VmBridgeGenerator.java"
click node_compiler "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/compiler/ZigCompiler.java"
click node_patcher "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/patcher/JarPatcher.java"
click node_packager "https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/patcher/OutputPackager.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_config,node_converter,node_user toneBlue
class node_scanner,node_extractor,node_method,node_rules,node_crypto,node_obfuscator,node_methoddata toneAmber
class node_generation,node_datagen,node_interpreter,node_instructions,node_bridge toneMint
class node_compiler,node_patcher,node_packager toneRose
class node_input,node_zig,node_output toneIndigo
```

## Components

### CLI and configuration

- [CLI entry](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/Main.java): `src/main/java/com/alphaautoleak/jnvm/Main.java`
- [Protection config](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/config/ProtectConfig.java): `src/main/java/com/alphaautoleak/jnvm/config/ProtectConfig.java`
- [Conversion orchestrator](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/converter/Converter.java): `src/main/java/com/alphaautoleak/jnvm/converter/Converter.java`

### Bytecode preparation

- [JAR scanning](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/asm/JarScanner.java): `src/main/java/com/alphaautoleak/jnvm/asm/JarScanner.java`
- [Bytecode extraction](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/asm/BytecodeExtractor.java): `src/main/java/com/alphaautoleak/jnvm/asm/BytecodeExtractor.java`
- [Method metadata](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/asm/MethodInfo.java): `src/main/java/com/alphaautoleak/jnvm/asm/MethodInfo.java`
- [Protection rules](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/config/ProtectRuleMatcher.java): `src/main/java/com/alphaautoleak/jnvm/config/ProtectRuleMatcher.java`
- [Bytecode protection](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/crypto/BytecodeEncryptor.java): `src/main/java/com/alphaautoleak/jnvm/crypto/BytecodeEncryptor.java`
- [Opcode mapping](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/crypto/OpcodeObfuscator.java): `src/main/java/com/alphaautoleak/jnvm/crypto/OpcodeObfuscator.java`
- [Protected method data](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/crypto/EncryptedMethodData.java): `src/main/java/com/alphaautoleak/jnvm/crypto/EncryptedMethodData.java`

### Native VM generation

- [Native generation plan](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/NativeGenerationPlan.java): `src/main/java/com/alphaautoleak/jnvm/codegen/NativeGenerationPlan.java`
- [VM data emission](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/emitter/VmDataGenerator.java): `src/main/java/com/alphaautoleak/jnvm/codegen/emitter/VmDataGenerator.java`
- [VM interpreter](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/emitter/VmInterpreterGenerator.java): `src/main/java/com/alphaautoleak/jnvm/codegen/emitter/VmInterpreterGenerator.java`
- [Opcode implementations](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/emitter/Instruction.java): `src/main/java/com/alphaautoleak/jnvm/codegen/emitter/Instruction.java`
- [JNI bridge](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/codegen/emitter/VmBridgeGenerator.java): `src/main/java/com/alphaautoleak/jnvm/codegen/emitter/VmBridgeGenerator.java`

### Compilation and patching

- [Zig compilation](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/compiler/ZigCompiler.java): `src/main/java/com/alphaautoleak/jnvm/compiler/ZigCompiler.java`
- [JAR patching](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/patcher/JarPatcher.java): `src/main/java/com/alphaautoleak/jnvm/patcher/JarPatcher.java`
- [Output packaging](https://github.com/alphaautoleak/jnvm/blob/master/src/main/java/com/alphaautoleak/jnvm/patcher/OutputPackager.java): `src/main/java/com/alphaautoleak/jnvm/patcher/OutputPackager.java`

### Other components

- **Protector user**
- **Input JAR**
- **Zig toolchain**
- **Protected JAR**

## Connections

- Protector user → CLI entry: runs (evidence: `README.md`)
- CLI entry → Protection config: builds config (evidence: `src/main/java/com/alphaautoleak/jnvm/Main.java`)
- CLI entry → Conversion orchestrator: starts conversion (evidence: `src/main/java/com/alphaautoleak/jnvm/Main.java`)
- Protection config → Conversion orchestrator: configures (evidence: `README.md`)
- Input JAR → Conversion orchestrator: provides JAR (evidence: `README.md`)
- Conversion orchestrator → JAR scanning: scans methods (evidence: `README.md`)
- Conversion orchestrator → Protection rules: selects methods (evidence: `README.md`)
- Conversion orchestrator → Bytecode extraction: extracts bytecode (evidence: `README.md`)
- Bytecode extraction → Method metadata: records metadata (evidence: `src/main/java/com/alphaautoleak/jnvm/asm/BytecodeExtractor.java`)
- Conversion orchestrator → Bytecode protection: encrypts bytecode (evidence: `README.md`)
- Conversion orchestrator → Opcode mapping: obfuscates opcodes (evidence: `README.md`)
- Conversion orchestrator → Protected method data: forms method data (evidence: `README.md`)
- Protected method data → Native generation plan: supplies methods (evidence: `src/main/java/com/alphaautoleak/jnvm/codegen/NativeGenerationPlan.java`)
- Native generation plan → VM data emission: generates VM data (evidence: `src/main/java/com/alphaautoleak/jnvm/codegen/NativeGenerationPlan.java`)
- Native generation plan → VM interpreter: generates interpreter (evidence: `src/main/java/com/alphaautoleak/jnvm/codegen/NativeGenerationPlan.java`)
- Native generation plan → JNI bridge: generates bridge (evidence: `src/main/java/com/alphaautoleak/jnvm/codegen/NativeGenerationPlan.java`)
- VM interpreter → Opcode implementations: dispatches opcodes
- Conversion orchestrator → Zig compilation: compiles native code (evidence: `README.md`)
- Zig compilation → Zig toolchain: invokes (evidence: `src/main/java/com/alphaautoleak/jnvm/compiler/ZigCompiler.java`)
- Conversion orchestrator → JAR patching: rewrites classes (evidence: `README.md`)
- JAR patching → Output packaging: packages output (evidence: `README.md`)
- Output packaging → Protected JAR: produces JAR (evidence: `README.md`)
