# xhoang/bigdatabitcoin architecture

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

- Interactive diagram: https://gitdiagram.com/xhoang/bigdatabitcoin
- Repository: https://github.com/xhoang/bigdatabitcoin

## Overview

This repository contains four analysis jobs for a Bitcoin blockchain subset. The user-facing workflows are monthly transaction counts, identifying top WikiLeaks donors through transaction joins, and ransomware-wallet value analysis with a separate second-generation coin-tracing job. The graph distinguishes job stages and their input/output data. The README documents the Hadoop/Spark context and reported capabilities; source evidence is limited to the four indexed excerpts, so broader platform wiring is not inferred.

Main entry points: [`partc3.py`](https://github.com/xhoang/bigdatabitcoin/blob/master/partc3.py) (Coin Tracing Job), [`partA.py`](https://github.com/xhoang/bigdatabitcoin/blob/master/partA.py) (Monthly Counts Job), [`partB.py`](https://github.com/xhoang/bigdatabitcoin/blob/master/partB.py) (WikiLeaks Filtering), [`part_c.py`](https://github.com/xhoang/bigdatabitcoin/blob/master/part_c.py) (Wallet Value Totals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_time["Time Analysis"]
  node_monthly_job["Monthly Counts Job<br/>[partA.py]"]
  node_monthly_results["Monthly Counts"]
end

subgraph group_donors["Donor Analysis"]
  node_donor_filter["WikiLeaks Filtering<br/>[partB.py]"]
  node_donor_join["Transaction Joins<br/>[partB.py]"]
  node_donor_totals["Address Totals<br/>[partB.py]"]
  node_donor_rank["Top Ten Ranking<br/>[partB.py]"]
  node_donor_results["Donor Results"]
end

subgraph group_ransomware["Ransomware Analysis"]
  node_extortion_job["Wallet Value Totals<br/>[part_c.py]"]
  node_extortion_results["Wallet Totals"]
  node_trace_job["Coin Tracing Job<br/>[partc3.py]"]
  node_trace_results["Traced Coin Totals"]
end

node_analyst(("Analyst"))
node_transactions["Transactions CSV"]
node_vout_data["Vout CSV"]
node_vin_data["Vin CSV"]

node_analyst -->|"runs"| node_monthly_job
node_transactions -->|"provides rows"| node_monthly_job
node_monthly_job -->|"writes counts"| node_monthly_results
node_analyst -->|"runs"| node_donor_filter
node_vout_data -->|"provides rows"| node_donor_filter
node_donor_filter -->|"filters and joins"| node_donor_join
node_vin_data -->|"provides rows"| node_donor_join
node_donor_join -->|"groups and sums"| node_donor_totals
node_donor_totals -->|"ranks totals"| node_donor_rank
node_donor_rank -->|"writes top ten"| node_donor_results
node_analyst -->|"runs"| node_extortion_job
node_vout_data -->|"provides rows"| node_extortion_job
node_extortion_job -->|"writes totals"| node_extortion_results
node_analyst -->|"runs"| node_trace_job
node_vout_data -->|"provides rows"| node_trace_job
node_vin_data -->|"provides rows"| node_trace_job
node_trace_job -->|"writes totals"| node_trace_results

click node_monthly_job "https://github.com/xhoang/bigdatabitcoin/blob/master/partA.py"
click node_donor_filter "https://github.com/xhoang/bigdatabitcoin/blob/master/partB.py"
click node_donor_join "https://github.com/xhoang/bigdatabitcoin/blob/master/partB.py"
click node_donor_totals "https://github.com/xhoang/bigdatabitcoin/blob/master/partB.py"
click node_donor_rank "https://github.com/xhoang/bigdatabitcoin/blob/master/partB.py"
click node_extortion_job "https://github.com/xhoang/bigdatabitcoin/blob/master/part_c.py"
click node_trace_job "https://github.com/xhoang/bigdatabitcoin/blob/master/partc3.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_monthly_job,node_monthly_results toneBlue
class node_donor_filter,node_donor_join,node_donor_totals,node_donor_rank,node_donor_results toneAmber
class node_extortion_job,node_extortion_results,node_trace_job,node_trace_results toneMint
class node_analyst,node_transactions,node_vout_data,node_vin_data toneIndigo
```

## Components

### Time Analysis

- [Monthly Counts Job](https://github.com/xhoang/bigdatabitcoin/blob/master/partA.py): `partA.py`
- **Monthly Counts**

### Donor Analysis

- [WikiLeaks Filtering](https://github.com/xhoang/bigdatabitcoin/blob/master/partB.py): `partB.py`
- [Transaction Joins](https://github.com/xhoang/bigdatabitcoin/blob/master/partB.py): `partB.py`
- [Address Totals](https://github.com/xhoang/bigdatabitcoin/blob/master/partB.py): `partB.py`
- [Top Ten Ranking](https://github.com/xhoang/bigdatabitcoin/blob/master/partB.py): `partB.py`
- **Donor Results**

### Ransomware Analysis

- [Wallet Value Totals](https://github.com/xhoang/bigdatabitcoin/blob/master/part_c.py): `part_c.py`
- **Wallet Totals**
- [Coin Tracing Job](https://github.com/xhoang/bigdatabitcoin/blob/master/partc3.py): `partc3.py`
- **Traced Coin Totals**

### Other components

- **Analyst**
- **Transactions CSV**
- **Vout CSV**
- **Vin CSV**

## Connections

- Analyst → Monthly Counts Job: runs (evidence: `readme.md`)
- Transactions CSV → Monthly Counts Job: provides rows (evidence: `readme.md`)
- Monthly Counts Job → Monthly Counts: writes counts (evidence: `readme.md`)
- Analyst → WikiLeaks Filtering: runs (evidence: `readme.md`)
- Vout CSV → WikiLeaks Filtering: provides rows (evidence: `partB.py`)
- WikiLeaks Filtering → Transaction Joins: filters and joins (evidence: `partB.py`)
- Vin CSV → Transaction Joins: provides rows (evidence: `partB.py`)
- Transaction Joins → Address Totals: groups and sums (evidence: `partB.py`)
- Address Totals → Top Ten Ranking: ranks totals (evidence: `partB.py`)
- Top Ten Ranking → Donor Results: writes top ten (evidence: `partB.py`)
- Analyst → Wallet Value Totals: runs (evidence: `readme.md`)
- Vout CSV → Wallet Value Totals: provides rows (evidence: `part_c.py`)
- Wallet Value Totals → Wallet Totals: writes totals (evidence: `part_c.py`)
- Analyst → Coin Tracing Job: runs (evidence: `readme.md`)
- Vout CSV → Coin Tracing Job: provides rows (evidence: `partc3.py`)
- Vin CSV → Coin Tracing Job: provides rows (evidence: `partc3.py`)
- Coin Tracing Job → Traced Coin Totals: writes totals (evidence: `partc3.py`)
