# tetragrammalol/sentinel-android-dojobay architecture

> Architecture diagram of the GitHub repository tetragrammalol/sentinel-android-dojobay, 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/tetragrammalol/sentinel-android-dojobay
- Repository: https://github.com/tetragrammalol/sentinel-android-dojobay

## Overview

Sentinel is an Android watch-only Bitcoin wallet. Users pair it with a self-hosted or community Dojo, import wallet public keys, then monitor balances, transactions and UTXOs; they can derive receive addresses and broadcast pre-signed transactions. The app also provides Whirlpool labeling, transaction linkability analysis, BIP-329 label interchange and embedded-Tor networking. The README documents these product relationships; sampled API code confirms import, wallet lookup and transaction-broadcast requests. Several UI and storage internals were not sampled, so their connections are limited to documented behavior.

Main entry points: [`app/src/main/java/com/samourai/sentinel/api/ApiService.kt`](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/api/ApiService.kt) (Dojo API client), [`app/src/main/java/com/samourai/sentinel/data/repository/TransactionsRepository.kt`](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/TransactionsRepository.kt) (Transaction history), [`app/src/main/java/com/samourai/sentinel/ui/home/HomeActivity.kt`](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/home/HomeActivity.kt) (Wallet dashboard), [`app/src/main/java/com/samourai/sentinel/data/repository/LabelRepository.kt`](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/LabelRepository.kt) (Label persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_wallet["Wallet workflows"]
  node_home["Wallet dashboard<br/>[HomeActivity.kt]"]
  node_collections["Wallet collections"]
  node_keyimport["Public-key import"]
  node_receive["Receive addresses"]
  node_transactions["Transaction history"]
  node_utxos["UTXO tracking"]
  node_broadcast["Transaction broadcast<br/>[BroadcastTx.kt]"]
  node_labels["Label interchange<br/>[Bip329Exporter.kt]"]
  node_labelimport["Label import<br/>[Bip329Importer.kt]"]
  node_labelstore[("Label persistence<br/>[LabelRepository.kt]")]
end

subgraph group_network["Dojo networking"]
  node_tor["Embedded Tor"]
  node_api["Dojo API client<br/>[ApiService.kt]"]
  node_dojo{{"Bitcoin Dojo"}}
  node_directory["Community directory"]
  node_websocket["Live updates"]
end

subgraph group_insight["Wallet insights"]
  node_whirlpool["Whirlpool labeling"]
  node_badbank["Badbank lineage<br/>[BadbankDeducer.kt]"]
  node_entropy["Transaction linkability"]
  node_exchange["Exchange rates"]
end

subgraph group_bitcoin["Bitcoin primitives"]
  node_txmodel["Bitcoin transactions<br/>[Transaction.java]"]
  node_txparts["Inputs and outputs"]
  node_networkparams["Network parameters"]
  node_script["Bitcoin scripts<br/>[Script.java]"]
end

node_user(("Wallet user"))

node_user -->|"opens wallet"| node_home
node_home -.->|"views wallets"| node_collections
node_user -->|"imports keys"| node_keyimport
node_keyimport -->|"registers xpub"| node_api
node_api -->|"requests wallet data"| node_dojo
node_api -->|"routes through"| node_tor
node_directory -->|"lists Dojos"| node_dojo
node_user -->|"requests address"| node_receive
node_receive -.->|"shows address"| node_home
node_api -.->|"fetches history"| node_transactions
node_api -.->|"fetches UTXOs"| node_utxos
node_user -->|"broadcasts signed tx"| node_broadcast
node_broadcast -->|"submits transaction"| node_api
node_user -->|"imports labels"| node_labelimport
node_labelimport -->|"stores labels"| node_labelstore
node_labelstore -->|"exports labels"| node_labels
node_transactions -->|"classifies transactions"| node_whirlpool
node_whirlpool -->|"deduces lineage"| node_badbank
node_badbank -->|"persists labels"| node_labelstore
node_transactions -->|"analyzes linkability"| node_entropy
node_api -.->|"updates via socket"| node_websocket
node_api -.->|"gets rates"| node_exchange
node_txmodel -->|"uses transaction parts"| node_txparts
node_txmodel -->|"uses network rules"| node_networkparams
node_txparts -->|"interprets scripts"| node_script

click node_home "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/home/HomeActivity.kt"
click node_collections "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/CollectionRepository.kt"
click node_keyimport "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/fragments/AddNewPubKeyBottomSheet.kt"
click node_receive "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/collectionDetails/receive/ReceiveViewModel.kt"
click node_transactions "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/TransactionsRepository.kt"
click node_utxos "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/utxos/UtxoActivityViewModel.kt"
click node_broadcast "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/broadcast/BroadcastTx.kt"
click node_labels "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/Bip329Exporter.kt"
click node_labelimport "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/Bip329Importer.kt"
click node_labelstore "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/LabelRepository.kt"
click node_tor "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/tor/SentinelTorManager.kt"
click node_api "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/api/ApiService.kt"
click node_directory "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/dojo/CommunityDojoRepository.kt"
click node_websocket "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/service/WebSocketService.kt"
click node_whirlpool "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/whirlpool/WhirlpoolDetector.kt"
click node_badbank "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/whirlpool/BadbankDeducer.kt"
click node_entropy "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/entropy/BoltzmannTxService.kt"
click node_exchange "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/ExchangeRateRepository.kt"
click node_txmodel "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/bitcoinj/src/main/java/org/bitcoinj/core/Transaction.java"
click node_txparts "https://github.com/tetragrammalol/sentinel-android-dojobay/tree/master/bitcoinj/src/main/java/org/bitcoinj/core"
click node_networkparams "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/bitcoinj/src/main/java/org/bitcoinj/core/NetworkParameters.java"
click node_script "https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/bitcoinj/src/main/java/org/bitcoinj/script/Script.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_home,node_collections,node_keyimport,node_receive,node_transactions,node_utxos,node_broadcast,node_labels,node_labelimport,node_labelstore,node_user toneBlue
class node_tor,node_api,node_dojo,node_directory,node_websocket toneAmber
class node_whirlpool,node_badbank,node_entropy,node_exchange toneMint
class node_txmodel,node_txparts,node_networkparams,node_script toneRose
```

## Components

### Wallet workflows

- [Wallet dashboard](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/home/HomeActivity.kt): `app/src/main/java/com/samourai/sentinel/ui/home/HomeActivity.kt`
- [Wallet collections](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/CollectionRepository.kt): `app/src/main/java/com/samourai/sentinel/data/repository/CollectionRepository.kt`
- [Public-key import](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/fragments/AddNewPubKeyBottomSheet.kt): `app/src/main/java/com/samourai/sentinel/ui/fragments/AddNewPubKeyBottomSheet.kt`
- [Receive addresses](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/collectionDetails/receive/ReceiveViewModel.kt): `app/src/main/java/com/samourai/sentinel/ui/collectionDetails/receive/ReceiveViewModel.kt`
- [Transaction history](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/TransactionsRepository.kt): `app/src/main/java/com/samourai/sentinel/data/repository/TransactionsRepository.kt`
- [UTXO tracking](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/utxos/UtxoActivityViewModel.kt): `app/src/main/java/com/samourai/sentinel/ui/utxos/UtxoActivityViewModel.kt`
- [Transaction broadcast](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/broadcast/BroadcastTx.kt): `app/src/main/java/com/samourai/sentinel/ui/broadcast/BroadcastTx.kt`
- [Label interchange](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/Bip329Exporter.kt): `app/src/main/java/com/samourai/sentinel/data/repository/Bip329Exporter.kt`
- [Label import](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/Bip329Importer.kt): `app/src/main/java/com/samourai/sentinel/data/repository/Bip329Importer.kt`
- [Label persistence](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/LabelRepository.kt): `app/src/main/java/com/samourai/sentinel/data/repository/LabelRepository.kt`

### Dojo networking

- [Embedded Tor](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/tor/SentinelTorManager.kt): `app/src/main/java/com/samourai/sentinel/tor/SentinelTorManager.kt`
- [Dojo API client](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/api/ApiService.kt): `app/src/main/java/com/samourai/sentinel/api/ApiService.kt`
- **Bitcoin Dojo**
- [Community directory](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/ui/dojo/CommunityDojoRepository.kt): `app/src/main/java/com/samourai/sentinel/ui/dojo/CommunityDojoRepository.kt`
- [Live updates](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/service/WebSocketService.kt): `app/src/main/java/com/samourai/sentinel/service/WebSocketService.kt`

### Wallet insights

- [Whirlpool labeling](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/whirlpool/WhirlpoolDetector.kt): `app/src/main/java/com/samourai/sentinel/data/whirlpool/WhirlpoolDetector.kt`
- [Badbank lineage](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/whirlpool/BadbankDeducer.kt): `app/src/main/java/com/samourai/sentinel/data/whirlpool/BadbankDeducer.kt`
- [Transaction linkability](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/entropy/BoltzmannTxService.kt): `app/src/main/java/com/samourai/sentinel/data/entropy/BoltzmannTxService.kt`
- [Exchange rates](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/app/src/main/java/com/samourai/sentinel/data/repository/ExchangeRateRepository.kt): `app/src/main/java/com/samourai/sentinel/data/repository/ExchangeRateRepository.kt`

### Bitcoin primitives

- [Bitcoin transactions](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/bitcoinj/src/main/java/org/bitcoinj/core/Transaction.java): `bitcoinj/src/main/java/org/bitcoinj/core/Transaction.java`
- [Inputs and outputs](https://github.com/tetragrammalol/sentinel-android-dojobay/tree/master/bitcoinj/src/main/java/org/bitcoinj/core): `bitcoinj/src/main/java/org/bitcoinj/core`
- [Network parameters](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/bitcoinj/src/main/java/org/bitcoinj/core/NetworkParameters.java): `bitcoinj/src/main/java/org/bitcoinj/core/NetworkParameters.java`
- [Bitcoin scripts](https://github.com/tetragrammalol/sentinel-android-dojobay/blob/master/bitcoinj/src/main/java/org/bitcoinj/script/Script.java): `bitcoinj/src/main/java/org/bitcoinj/script/Script.java`

### Other components

- **Wallet user**

## Connections

- Wallet user → Wallet dashboard: opens wallet (evidence: `README.md`)
- Wallet dashboard → Wallet collections: views wallets
- Wallet user → Public-key import: imports keys (evidence: `README.md`)
- Public-key import → Dojo API client: registers xpub (evidence: `app/src/main/java/com/samourai/sentinel/api/ApiService.kt`)
- Dojo API client → Bitcoin Dojo: requests wallet data (evidence: `README.md`)
- Dojo API client → Embedded Tor: routes through (evidence: `README.md`)
- Community directory → Bitcoin Dojo: lists Dojos (evidence: `README.md`)
- Wallet user → Receive addresses: requests address (evidence: `README.md`)
- Receive addresses → Wallet dashboard: shows address
- Dojo API client → Transaction history: fetches history (evidence: `app/src/main/java/com/samourai/sentinel/data/repository/TransactionsRepository.kt`)
- Dojo API client → UTXO tracking: fetches UTXOs
- Wallet user → Transaction broadcast: broadcasts signed tx (evidence: `README.md`)
- Transaction broadcast → Dojo API client: submits transaction (evidence: `app/src/main/java/com/samourai/sentinel/api/ApiService.kt`)
- Wallet user → Label import: imports labels (evidence: `README.md`)
- Label import → Label persistence: stores labels (evidence: `README.md`)
- Label persistence → Label interchange: exports labels (evidence: `README.md`)
- Transaction history → Whirlpool labeling: classifies transactions (evidence: `README.md`)
- Whirlpool labeling → Badbank lineage: deduces lineage (evidence: `README.md`)
- Badbank lineage → Label persistence: persists labels (evidence: `README.md`)
- Transaction history → Transaction linkability: analyzes linkability (evidence: `README.md`)
- Dojo API client → Live updates: updates via socket (evidence: `app/src/main/java/com/samourai/sentinel/service/WebSocketService.kt`)
- Dojo API client → Exchange rates: gets rates
- Bitcoin transactions → Inputs and outputs: uses transaction parts (evidence: `bitcoinj/src/main/java/org/bitcoinj/core/Transaction.java`)
- Bitcoin transactions → Network parameters: uses network rules (evidence: `bitcoinj/src/main/java/org/bitcoinj/core/Transaction.java`)
- Inputs and outputs → Bitcoin scripts: interprets scripts (evidence: `bitcoinj/src/main/java/org/bitcoinj/core/TransactionOutput.java`)
