# nocoolusername/volatility3-cryptomem architecture

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

- Interactive diagram: https://gitdiagram.com/nocoolusername/volatility3-cryptomem
- Repository: https://github.com/nocoolusername/volatility3-cryptomem

## Overview

CryptoMem is a Volatility 3 plugin for bounded, offline scanning of selected process memory for cryptocurrency-related text artifacts. The workflow starts with a platform-specific adapter selecting a process and its memory ranges, then hands scanning and artifact emission to shared code. Detection covers address/payment-request formats and opt-in mnemonic, key, and transaction-ID candidates; results include findings and coverage summaries, with separately gated secret extraction. README documents the platform and format scope; unsampled modules are represented only where that documentation supports them.

Main entry points: [`plugins/windows/cryptomem_scan.py`](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_scan.py) (Bounded scanner), [`plugins/windows/cryptomem.py`](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem.py) (Windows adapter), [`plugins/linux/cryptomem.py`](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/linux/cryptomem.py) (Linux adapter), [`plugins/mac/cryptomem.py`](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/mac/cryptomem.py) (macOS adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_adapters["Platform adapters"]
  node_windows["Windows adapter<br/>[cryptomem.py]"]
  node_linux["Linux adapter<br/>[cryptomem.py]"]
  node_mac["macOS adapter<br/>[cryptomem.py]"]
end

subgraph group_engine["Scan engine"]
  node_scanner["Bounded scanner<br/>[cryptomem_scan.py]"]
end

subgraph group_detection["Artifact detection"]
  node_address["Address formats"]
  node_extended["Opt-in detectors"]
  node_wordlist["BIP-39 wordlist<br/>[cryptomem_bip39.py]"]
end

subgraph group_outputs["Scan outputs"]
  node_findings["Findings JSONL<br/>[cryptomem_scan.py]"]
  node_summary["Coverage summary<br/>[cryptomem_scan.py]"]
  node_secrets["Private secrets file<br/>[cryptomem_scan.py]"]
end

node_analyst(("Analyst"))
node_volatility["Volatility CLI"]
node_renderer["Volatility renderer"]

node_analyst -->|"runs plugin"| node_volatility
node_volatility -->|"invokes"| node_windows
node_volatility -->|"invokes"| node_linux
node_volatility -->|"invokes"| node_mac
node_windows -->|"delegates scan"| node_scanner
node_linux -->|"delegates scan"| node_scanner
node_mac -->|"delegates scan"| node_scanner
node_scanner -->|"checks formats"| node_address
node_scanner -->|"checks opt-ins"| node_extended
node_extended -.->|"validates phrases"| node_wordlist
node_scanner -->|"writes findings"| node_findings
node_scanner -->|"writes coverage"| node_summary
node_scanner -->|"writes gated secrets"| node_secrets
node_volatility -->|"renders results"| node_renderer

click node_windows "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem.py"
click node_linux "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/linux/cryptomem.py"
click node_mac "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/mac/cryptomem.py"
click node_scanner "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_scan.py"
click node_address "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_formats.py"
click node_extended "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_extended.py"
click node_wordlist "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_bip39.py"
click node_findings "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_scan.py"
click node_summary "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_scan.py"
click node_secrets "https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_scan.py"

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_windows,node_linux,node_mac toneBlue
class node_scanner toneAmber
class node_address,node_extended,node_wordlist toneMint
class node_findings,node_summary,node_secrets toneRose
class node_analyst,node_volatility,node_renderer toneIndigo
```

## Components

### Platform adapters

- [Windows adapter](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem.py): `plugins/windows/cryptomem.py`
- [Linux adapter](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/linux/cryptomem.py): `plugins/linux/cryptomem.py`
- [macOS adapter](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/mac/cryptomem.py): `plugins/mac/cryptomem.py`

### Scan engine

- [Bounded scanner](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_scan.py): `plugins/windows/cryptomem_scan.py`

### Artifact detection

- [Address formats](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_formats.py): `plugins/windows/cryptomem_formats.py`
- [Opt-in detectors](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_extended.py): `plugins/windows/cryptomem_extended.py`
- [BIP-39 wordlist](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_bip39.py): `plugins/windows/cryptomem_bip39.py`

### Scan outputs

- [Findings JSONL](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_scan.py): `plugins/windows/cryptomem_scan.py`
- [Coverage summary](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_scan.py): `plugins/windows/cryptomem_scan.py`
- [Private secrets file](https://github.com/nocoolusername/volatility3-cryptomem/blob/main/plugins/windows/cryptomem_scan.py): `plugins/windows/cryptomem_scan.py`

### Other components

- **Analyst**
- **Volatility CLI**
- **Volatility renderer**

## Connections

- Analyst → Volatility CLI: runs plugin (evidence: `README.md`)
- Volatility CLI → Windows adapter: invokes (evidence: `README.md`)
- Volatility CLI → Linux adapter: invokes (evidence: `README.md`)
- Volatility CLI → macOS adapter: invokes (evidence: `README.md`)
- Windows adapter → Bounded scanner: delegates scan (evidence: `plugins/windows/cryptomem.py`)
- Linux adapter → Bounded scanner: delegates scan (evidence: `plugins/linux/cryptomem.py`)
- macOS adapter → Bounded scanner: delegates scan (evidence: `plugins/mac/cryptomem.py`)
- Bounded scanner → Address formats: checks formats (evidence: `plugins/windows/cryptomem_scan.py`)
- Bounded scanner → Opt-in detectors: checks opt-ins (evidence: `plugins/windows/cryptomem_scan.py`)
- Opt-in detectors → BIP-39 wordlist: validates phrases
- Bounded scanner → Findings JSONL: writes findings (evidence: `plugins/windows/cryptomem_scan.py`)
- Bounded scanner → Coverage summary: writes coverage (evidence: `plugins/windows/cryptomem_scan.py`)
- Bounded scanner → Private secrets file: writes gated secrets (evidence: `plugins/windows/cryptomem_scan.py`)
- Volatility CLI → Volatility renderer: renders results (evidence: `README.md`)
