How tetragrammalol/sentinel-android-dojobay works
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: ApiService.kt Dojo API client · TransactionsRepository.kt Transaction history · HomeActivity.kt Wallet dashboard · LabelRepository.kt Label persistence
Components 24
Wallet workflows
- Wallet dashboard
app/src/main/java/com/samourai/sentinel/ui/home/HomeActivity.kt - Wallet collections
app/src/main/java/com/samourai/sentinel/data/repository/CollectionRepository.kt - Public-key import
app/src/main/java/com/samourai/sentinel/ui/fragments/AddNewPubKeyBottomSheet.kt - Receive addresses
app/src/main/java/com/samourai/sentinel/ui/collectionDetails/receive/ReceiveViewModel.kt - Transaction history
app/src/main/java/com/samourai/sentinel/data/repository/TransactionsRepository.kt - UTXO tracking
app/src/main/java/com/samourai/sentinel/ui/utxos/UtxoActivityViewModel.kt - Transaction broadcast
app/src/main/java/com/samourai/sentinel/ui/broadcast/BroadcastTx.kt - Label interchange
app/src/main/java/com/samourai/sentinel/data/repository/Bip329Exporter.kt - Label import
app/src/main/java/com/samourai/sentinel/data/repository/Bip329Importer.kt - Label persistence
app/src/main/java/com/samourai/sentinel/data/repository/LabelRepository.kt
Dojo networking
- Embedded Tor
app/src/main/java/com/samourai/sentinel/tor/SentinelTorManager.kt - Dojo API client
app/src/main/java/com/samourai/sentinel/api/ApiService.kt - Bitcoin Dojo
- Community directory
app/src/main/java/com/samourai/sentinel/ui/dojo/CommunityDojoRepository.kt - Live updates
app/src/main/java/com/samourai/sentinel/service/WebSocketService.kt
Wallet insights
- Whirlpool labeling
app/src/main/java/com/samourai/sentinel/data/whirlpool/WhirlpoolDetector.kt - Badbank lineage
app/src/main/java/com/samourai/sentinel/data/whirlpool/BadbankDeducer.kt - Transaction linkability
app/src/main/java/com/samourai/sentinel/data/entropy/BoltzmannTxService.kt - Exchange rates
app/src/main/java/com/samourai/sentinel/data/repository/ExchangeRateRepository.kt
Bitcoin primitives
- Bitcoin transactions
bitcoinj/src/main/java/org/bitcoinj/core/Transaction.java - Inputs and outputs
bitcoinj/src/main/java/org/bitcoinj/core - Network parameters
bitcoinj/src/main/java/org/bitcoinj/core/NetworkParameters.java - Bitcoin scripts
bitcoinj/src/main/java/org/bitcoinj/script/Script.java
Other components
- Wallet user
Connections 25
- Wallet user → Wallet dashboard: opens wallet
README.md - Wallet dashboard → Wallet collections: views wallets
- Wallet user → Public-key import: imports keys
README.md - Public-key import → Dojo API client: registers xpub
app/src/main/java/com/samourai/sentinel/api/ApiService.kt - Dojo API client → Bitcoin Dojo: requests wallet data
README.md - Dojo API client → Embedded Tor: routes through
README.md - Community directory → Bitcoin Dojo: lists Dojos
README.md - Wallet user → Receive addresses: requests address
README.md - Receive addresses → Wallet dashboard: shows address
- Dojo API client → Transaction history: fetches history
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
README.md - Transaction broadcast → Dojo API client: submits transaction
app/src/main/java/com/samourai/sentinel/api/ApiService.kt - Wallet user → Label import: imports labels
README.md - Label import → Label persistence: stores labels
README.md - Label persistence → Label interchange: exports labels
README.md - Transaction history → Whirlpool labeling: classifies transactions
README.md - Whirlpool labeling → Badbank lineage: deduces lineage
README.md - Badbank lineage → Label persistence: persists labels
README.md - Transaction history → Transaction linkability: analyzes linkability
README.md - Dojo API client → Live updates: updates via socket
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
bitcoinj/src/main/java/org/bitcoinj/core/Transaction.java - Bitcoin transactions → Network parameters: uses network rules
bitcoinj/src/main/java/org/bitcoinj/core/Transaction.java - Inputs and outputs → Bitcoin scripts: interprets scripts
bitcoinj/src/main/java/org/bitcoinj/core/TransactionOutput.java