Konzept & Philosophie
Bitcoin Tools beruht auf drei Prinzipien: Selbstverwahrung, local-first und Transparenz der Quellen.
1. Nicht verhandelbare Selbstverwahrung
Kein privater Schlüssel, keine Seed-Phrase und kein Wallet-Passwort läuft jemals über Bitcoin Tools. Bitcoin Tools erstellt eine unsignierte PSBT; die Schaltfläche „Signieren“ übergibt diese PSBT lediglich an Ihre Wallet (Xverse), die Ihre ausdrückliche Zustimmung einholt. Nach Ihrer Zustimmung erhält Bitcoin Tools die finalisierte Transaktion und Ihr Browser sendet sie direkt an mempool.space (Blockstream.info als Ausweichlösung). Die Garantie lautet daher präzise: Bitcoin Tools kann ohne die Signaturfreigabe Ihrer Wallet keine ausgabefähige Transaktion erzeugen — nach der Signatur kann die Übertragung jedoch automatisch erfolgen.
2. Local-first: Ihre IndexedDB ist die Quelle der Wahrheit
Wallet-Scans, UTXO-Anreicherungen, Auswahlen und Einstellungen werden in Ihrem Browser in mehreren spezialisierten lokalen Speichern abgelegt, überwiegend IndexedDB-Datenbanken. Das ermöglicht:
- sofortige Navigation zwischen Tools ohne erneutes Abrufen,
- Offline-Analyse (PSBT Inspector),
- lokale Persistenz Ihrer Ergebnisse: Sie werden auf Ihrem Gerät gespeichert und nicht als Ganzes hochgeladen.
Lokale Persistenz bedeutet keine vollständige Isolation. Um UTXOs, Anreicherungen oder Transaktionsstatus abzurufen — und für die optionale KI-Analyse — werden Bitcoin-Adressen, Outpoints, Transaktions-IDs und dekodierte Transaktionsdaten an die benötigten Datenanbieter und Proxys übertragen. Dieser Datenverkehr ist temporäre Netzwerkverarbeitung; dauerhaft Gespeichertes bleibt auf Ihrem Gerät.
Wichtigste lokale Speicher (nicht abschließend)
| Cache | Inhalt | TTL |
|---|---|---|
scanCache | Vollständiges Wallet-Scan-Ergebnis (Ordinals + Zahlungs-UTXOs + seltene Sat-Gruppen) | 7 Tage |
ordinalsEnrichmentCache | Ordiscan-Anreicherung je txid:vout (Sat-Bereiche, Inschriften, Runes, Satribute) | ~permanent |
addressUtxosCache | Rohe mempool.space UTXOs pro Adresse + Netzwerk-Fingerabdruck | ungültig bei Fingerabdruckänderung |
psbtCache | PSBT-Anreicherung, indiziert nach SHA-256-Hash der Nutzlast | ~permanent |
addressEnrichmentCache | Ordiscan-Anreicherung auf Adressenebene (Inschriften, BRC-20-Guthaben) | 120 s (Anti-Burst) |
paymentRiskScans | Risikoscannergebnis für die Zahlungsadresse | 7 Tage |
Diese Tabelle listet die wichtigsten Speicher auf; sie ist bewusst keine vollständige Bestandsaufnahme jedes internen Caches. Beachten Sie: Der von Bitcoin Tools angezeigte detaillierte Transaktionsverlauf liegt nicht in IndexedDB, sondern im localStorage, indexiert nach Netzwerk und Adresse.
3. Was den Server berührt (und was nicht)
Was lokal bleibt
- Ihre privaten Schlüssel und Seed (immer innerhalb von Xverse).
- Alle Wallet-Scans, Anreicherungen und UTXO-Auswahlen.
- PSBTs, die erstellt werden.
- Der vollständige funktionale Transaktionsverlauf, den Bitcoin Tools anzeigt (ausstehend und bestätigt), gespeichert im localStorage Ihres Browsers, indexiert nach Netzwerk und Adresse.
Das Lesen und Aktualisieren dieser Daten erfordert dennoch Netzwerkaufrufe: Adressen, Outpoints und Transaktions-IDs werden an die unten beschriebenen Datenanbieter gesendet, um UTXOs, Anreicherungen und Bestätigungsstatus zu erhalten.
Was über den Server läuft
- Ordiscan-Aufrufe: Ihr persönlicher Schlüssel (BYOK) wird serverseitig mit AES-256-GCM verschlüsselt; er wird nur für die Dauer eines Aufrufs im Speicher entschlüsselt und nie an den Client zurückgegeben.
- mempool.space-Proxy: schlüsselloses Relay für Lese-/Abfrageverkehr (Gebührensätze, Preise, Chain-Tip, Adress- und UTXO-Abfragen) mit leichtem Server-Cache. Die Übertragung einer signierten Transaktion nutzt diesen Proxy nicht: Ihr Browser sendet die finalisierte Transaktion direkt an mempool.space, mit Blockstream.info als Ausweichlösung.
- Analytik ohne personenbezogene Daten: Beim Anmelden werden Ihre Supabase-
userId, Land/Region (Cloudflare-Header) und ein SHA-256-Hash Ihrer IP erfasst. Die rohe IP wird nie gespeichert. - Operative Nutzungstelemetrie: Beim Senden einer Transaktion kann die Analytik-Implementierung der App serverseitig einen Vorgangsdatensatz erfassen (Kennungen und Kennzahlen wie txid, verwendetes Werkzeug, Gebühr und Anzahl der Eingänge). Das ist Telemetrie, nicht der detaillierte Verlauf in der Oberfläche, der lokal bleibt.
- Optionale KI-Prüfung im PSBT-Inspektor (ausdrücklicher Button): sendet das dekodierte JSON an eine Supabase-Funktion, niemals Ihren Schlüssel oder persönliche Daten.
4. Demo-Modus
Der Demo-Modus lädt einen von einem Administrator vorab erfassten Wallet-Snapshot (UTXOs, Runes, Inschriften, BRC-20). Alle Werkzeuge verhalten sich, als wären Sie verbunden — mit einer Ausnahme:
Live BRC-20 und ausstehende Transaktionsabfragen sind im Demo-Modus ebenfalls deaktiviert, um den Verbrauch Ihres Ordiscan-Schlüssels zu vermeiden.
5. BYOK: Bring Your Own Key (Ordiscan)
Ordiscan ist unsere primäre Quelle für Sat-Bereiche, Inschriften, BRC-20-Guthaben und Runen-Metadaten. Ein kostenloser Schlüssel gewährt Ihnen 1.000 Anfragen pro Monat – mehr als genug für den normalen persönlichen Gebrauch.
Sie können bis zu 5 Schlüssel hinterlegen. Erreicht einer sein Kontingent, wird automatisch der nächste verwendet. Siehe Voraussetzungen für das Vorgehen.
6. Wallet-Rollen und ORD-/PAY-/CHANGE-Badges
In der Historie, in den Transaktionsdetails und in jeder Tool-Vorschau tragen Eingänge und Ausgänge ein kleines Badge, das die Adressfamilie des Skripts beschreibt — abgeleitet durch Dekodieren des Skripts für das aktive Netzwerk, nicht durch Zeichenkettenvergleich mit deinen verbundenen Adressen.
- ORD (orange) — Taproot-Skript (P2TR), die vom Ordinals-Wallet genutzte Familie.
- PAY (blau) — validierte Payment-Familie: Native SegWit oder eine unterstützte, validierte Nested-SegWit-Form.
- CHANGE (blau) — der Ausgang, der den Rest der Transaktion an deine Payment-Wallet zurückgibt. Er ersetzt dort das PAY-Badge; Eingänge werden nie als CHANGE gekennzeichnet.