# kallerosenbaum/grokkingbitcoin architecture

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

- Interactive diagram: https://gitdiagram.com/kallerosenbaum/grokkingbitcoin
- Repository: https://github.com/kallerosenbaum/grokkingbitcoin

## Overview

Grokking Bitcoin is an Asciidoctor-sourced educational book, not a Bitcoin application. The reader’s workflow is to consult the book’s chapters and appendices to learn Bitcoin concepts, from fundamentals through transactions, wallets, networking, and upgrades. The README documents how the root book assembles its chapters and describes illustrations, styling, and translation materials. Source excerpts are limited to one numbering extension, so the graph focuses on documented content organization rather than inferred runtime behavior.

Main entry points: [`grokking-bitcoin.adoc`](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/grokking-bitcoin.adoc) (Complete Book), [`lang`](https://github.com/kallerosenbaum/grokkingbitcoin/tree/master/lang) (Translation Materials), [`front-matter.adoc`](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/front-matter.adoc) (Front Matter), [`ch01-introduction-to-bitcoin.adoc`](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch01-introduction-to-bitcoin.adoc) (Bitcoin Introduction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_book["Book Assembly"]
  node_bookroot["Complete Book"]
  node_front["Front Matter<br/>[front-matter.adoc]"]
end

subgraph group_fundamentals["Bitcoin Fundamentals"]
  node_intro["Bitcoin Introduction"]
  node_crypto["Hashes and Signatures"]
  node_addresses["Addresses"]
  node_wallets["Wallets<br/>[ch04-wallets.adoc]"]
end

subgraph group_protocol["Bitcoin Protocol"]
  node_transactions["Transactions"]
  node_blockchain["Blockchain"]
  node_pow["Proof of Work"]
  node_p2p["Peer Networking"]
  node_txrevisit["Transactions Revisited"]
  node_segwit["Segregated Witness"]
  node_upgrades["Bitcoin Upgrades"]
end

subgraph group_supplements["Reader Supplements"]
  node_cli["Bitcoin CLI"]
  node_answers["Answers<br/>[app2-answers.adoc]"]
  node_resources["Web Resources"]
end

subgraph group_localization["Localization and Design"]
  node_illustrations["Book Illustrations"]
  node_styling["Book Styling"]
  node_translations["Translation Materials"]
end

node_reader(("Reader"))

node_reader -->|"reads"| node_bookroot
node_bookroot -->|"includes"| node_front
node_bookroot -->|"includes"| node_intro
node_bookroot -->|"includes"| node_crypto
node_bookroot -->|"includes"| node_addresses
node_bookroot -->|"includes"| node_wallets
node_bookroot -->|"includes"| node_transactions
node_bookroot -->|"includes"| node_blockchain
node_bookroot -->|"includes"| node_pow
node_bookroot -->|"includes"| node_p2p
node_bookroot -->|"includes"| node_txrevisit
node_bookroot -->|"includes"| node_segwit
node_bookroot -->|"includes"| node_upgrades
node_bookroot -->|"includes"| node_cli
node_bookroot -->|"includes"| node_answers
node_bookroot -->|"includes"| node_resources
node_bookroot -->|"uses images"| node_illustrations
node_bookroot -->|"styled by"| node_styling
node_translations -->|"translates"| node_bookroot

click node_bookroot "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/grokking-bitcoin.adoc"
click node_front "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/front-matter.adoc"
click node_intro "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch01-introduction-to-bitcoin.adoc"
click node_crypto "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch02-hash-functions-and-signatures.adoc"
click node_addresses "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch03-addresses.adoc"
click node_wallets "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch04-wallets.adoc"
click node_transactions "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch05-transactions.adoc"
click node_blockchain "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch06-the-blockchain.adoc"
click node_pow "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch07-proof-of-work.adoc"
click node_p2p "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch08-peer-to-peer-network.adoc"
click node_txrevisit "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch09-transactions-revisited.adoc"
click node_segwit "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch10-segregated-witness.adoc"
click node_upgrades "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch11-bitcoin-upgrades.adoc"
click node_cli "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/app1-bitcoin-cli.adoc"
click node_answers "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/app2-answers.adoc"
click node_resources "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/app3-web-resources.adoc"
click node_illustrations "https://github.com/kallerosenbaum/grokkingbitcoin/tree/master/images"
click node_styling "https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/style/grokking-bitcoin.css"
click node_translations "https://github.com/kallerosenbaum/grokkingbitcoin/tree/master/lang"

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_bookroot,node_front toneBlue
class node_intro,node_crypto,node_addresses,node_wallets toneAmber
class node_transactions,node_blockchain,node_pow,node_p2p,node_txrevisit,node_segwit,node_upgrades toneMint
class node_cli,node_answers,node_resources toneRose
class node_illustrations,node_styling,node_translations,node_reader toneIndigo
```

## Components

### Book Assembly

- [Complete Book](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/grokking-bitcoin.adoc): `grokking-bitcoin.adoc`
- [Front Matter](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/front-matter.adoc): `front-matter.adoc`

### Bitcoin Fundamentals

- [Bitcoin Introduction](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch01-introduction-to-bitcoin.adoc): `ch01-introduction-to-bitcoin.adoc`
- [Hashes and Signatures](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch02-hash-functions-and-signatures.adoc): `ch02-hash-functions-and-signatures.adoc`
- [Addresses](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch03-addresses.adoc): `ch03-addresses.adoc`
- [Wallets](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch04-wallets.adoc): `ch04-wallets.adoc`

### Bitcoin Protocol

- [Transactions](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch05-transactions.adoc): `ch05-transactions.adoc`
- [Blockchain](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch06-the-blockchain.adoc): `ch06-the-blockchain.adoc`
- [Proof of Work](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch07-proof-of-work.adoc): `ch07-proof-of-work.adoc`
- [Peer Networking](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch08-peer-to-peer-network.adoc): `ch08-peer-to-peer-network.adoc`
- [Transactions Revisited](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch09-transactions-revisited.adoc): `ch09-transactions-revisited.adoc`
- [Segregated Witness](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch10-segregated-witness.adoc): `ch10-segregated-witness.adoc`
- [Bitcoin Upgrades](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/ch11-bitcoin-upgrades.adoc): `ch11-bitcoin-upgrades.adoc`

### Reader Supplements

- [Bitcoin CLI](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/app1-bitcoin-cli.adoc): `app1-bitcoin-cli.adoc`
- [Answers](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/app2-answers.adoc): `app2-answers.adoc`
- [Web Resources](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/app3-web-resources.adoc): `app3-web-resources.adoc`

### Localization and Design

- [Book Illustrations](https://github.com/kallerosenbaum/grokkingbitcoin/tree/master/images): `images`
- [Book Styling](https://github.com/kallerosenbaum/grokkingbitcoin/blob/master/style/grokking-bitcoin.css): `style/grokking-bitcoin.css`
- [Translation Materials](https://github.com/kallerosenbaum/grokkingbitcoin/tree/master/lang): `lang`

### Other components

- **Reader**

## Connections

- Reader → Complete Book: reads (evidence: `readme.md`)
- Complete Book → Front Matter: includes (evidence: `readme.md`)
- Complete Book → Bitcoin Introduction: includes (evidence: `readme.md`)
- Complete Book → Hashes and Signatures: includes (evidence: `readme.md`)
- Complete Book → Addresses: includes (evidence: `readme.md`)
- Complete Book → Wallets: includes (evidence: `readme.md`)
- Complete Book → Transactions: includes (evidence: `readme.md`)
- Complete Book → Blockchain: includes (evidence: `readme.md`)
- Complete Book → Proof of Work: includes (evidence: `readme.md`)
- Complete Book → Peer Networking: includes (evidence: `readme.md`)
- Complete Book → Transactions Revisited: includes (evidence: `readme.md`)
- Complete Book → Segregated Witness: includes (evidence: `readme.md`)
- Complete Book → Bitcoin Upgrades: includes (evidence: `readme.md`)
- Complete Book → Bitcoin CLI: includes (evidence: `readme.md`)
- Complete Book → Answers: includes (evidence: `readme.md`)
- Complete Book → Web Resources: includes (evidence: `readme.md`)
- Complete Book → Book Illustrations: uses images (evidence: `readme.md`)
- Complete Book → Book Styling: styled by (evidence: `readme.md`)
- Translation Materials → Complete Book: translates (evidence: `readme.md`)
