Blockchain-Synchronisierung

Die Blockchain-Synchronisierungspipeline ruft On-Chain-Daten für jedes verbundene Wallet ab, normalisiert und dedupliziert sie. Der Fortschritt wird in Echtzeit gestreamt, sodass Sie jede Synchronisierung live verfolgen können.

Funktionsweise der Synchronisierung

Wenn Sie ein Wallet verbinden oder eine Synchronisierung auslösen, startet CryptaCount zwei parallele Datenströme:

Transactions — Ruft native Währungstransfers (ETH auf Ethereum, MATIC auf Polygon usw.) und normale Contract-Aufrufe ab. Dies sind direkte Transaktionen auf der Basisschicht der Chain.

Token Transfers — Ruft Token-Transfer-Events (ERC-20 und Äquivalente) ab. Dies sind von Contracts emittierte Events aus Transaktionsprotokollen, die unabhängig von nativen Transaktionen synchronisiert werden.

Jeder Stream verwaltet seinen eigenen Fortschritts-Tracker (zuletzt verarbeitete Blocknummer) und seinen eigenen Paginierungscursor.

Synchronisierungs-Lebenszyklus

1. Initialize — CryptaCount prüft, ob ein anderes Wallet mit derselben Adresse und Chain bereits synchronisiert (verhindert Doppelsyncs). Bestimmt den Startblock pro Stream.
2. Fetch — Transaktionsdaten von Blockchain-Anbietern in paginierten Blöcken abrufen
3. Normalize — Chain-spezifische Formate in CryptaCountis universelles Transaktionsmodell umwandeln
4. Deduplicate — Jede Transaktion gegen bestehende Datensätze prüfen, um Duplikate zu verhindern
5. Store — Neue Transaktionen in den Arbeitsbereich schreiben
6. Classify — Die Transaktionsklassifizierungs-Engine auf neue Datensätze anwenden
7. Price — Beizulegenden Zeitwert für jeden Vermögenswert zum Transaktionszeitpunkt abrufen
8. Journal — Buchungssätze der doppelten Buchführung generieren

Deduplizierung

Jede Transaktion erhält einen eindeutigen Schlüssel basierend auf Chain, Block, Transaktions-Hash und Event-Index. CryptaCount prüft vor dem Einfügen auf bestehende Datensätze und stellt so sicher, dass keine doppelten Daten entstehen, selbst wenn eine Synchronisierung unterbrochen und neu gestartet wird.

Intelligenter Neustart

Nach der ersten vollständigen Synchronisierung werden nachfolgende Synchronisierungen ab dem zuletzt verarbeiteten Block fortgesetzt. Entscheidend ist, dass der Wiederaufnahmepunkt pro Stream (Transaktionen vs. Token-Transfers) verfolgt wird:

• Jeder Stream wird unabhängig fortgesetzt
• Dies verhindert das Szenario, bei dem die Blocknummer eines schnell abgeschlossenen Streams dazu führt, dass der andere Stream Daten überspringt

Echtzeit-Fortschritt

Der Synchronisierungsfortschritt wird in Echtzeit an die Oberfläche gestreamt. Die Fortschrittsanzeige bietet:

• Aktuelle Synchronisierungsphase (Abruf, Normalisierung, Speicherung)
• Verarbeitete Transaktionen / geschätzte Gesamtzahl
• Block-Fortschritt (aktueller Block / neuester Block)
• Status pro Stream (Transactions, Token Transfers)
• Fehlermeldungen falls vorhanden

Dies ermöglicht Live-Fortschrittsanzeigen ohne Seitenaktualisierung.

Multi-Wallet-Deduplizierung

Wenn dieselbe Adresse für mehrere Workspace-Wallets verwendet wird (z. B. dieselbe Adresse unter verschiedenen Bezeichnungen hinzugefügt), prüft CryptaCount auf Duplikate und überspringt die Synchronisierung, wenn ein anderes Wallet mit derselben Adresse bereits synchronisiert ist oder synchronisiert wird. Dies verhindert doppelte Transaktionsdaten auf Arbeitsbereichsebene.

Ratenbegrenzung und Resilienz

Blockchain-Datenanbieter setzen Ratenlimits durch. Die Synchronisierungspipeline handhabt dies mit:

• Automatisches Backoff — Bei Ratenlimits weicht das System zurück und wiederholt automatisch
• Fortschrittssicherung — Wird eine Synchronisierung unterbrochen, wird der Fortschritt pro Stream gespeichert und die nächste Synchronisierung setzt dort fort
• Bereinigung hängengebliebener Synchronisierungen — Ein Hintergrundauftrag erkennt und bereinigt regelmäßig hängengebliebene Synchronisierungen

Synchronisierungsstatus überwachen

In der Wallet-Detailansicht zeigt die Registerkarte Sync:

• Aktueller Synchronisierungsstatus pro Stream (Transactions, Token Transfers)
• Zuletzt verarbeitete Blocknummer pro Stream
• Gesamtzahl der abgerufenen Transaktionen
• Etwaige Fehlermeldungen
• Zeitpunkt der letzten erfolgreichen Synchronisierung

Manuelle Synchronisierung auslösen

• Einzelnes Wallet: Wallet-Detail öffnen → Sync Now klicken
• Rescan: Vollständigen Rescan eines Wallets ab Block 0 erzwingen
• Sync request: Nutzer können Synchronisierungen anfordern, die Arbeitsbereichsmanager genehmigen oder ablehnen

Synchronisierungsfehler

Häufige Synchronisierungsfehler und ihre Behebung:

Fehler	Ursache	Behebung
Rate limit exceeded	Zu viele Anfragen an den Anbieter	Warten und wiederholen; automatisches Backoff übernimmt dies
Timeout	Großer Datenstapel dauert zu lange	Automatisch; nächste Synchronisierung setzt ab dem letzten Block pro Stream fort
Invalid address	Wallet-Adresse passt nicht zur gewählten Chain	Adressformat und Chain-Auswahl prüfen
Provider unavailable	Blockchain-Datenanbieter vorübergehend nicht verfügbar	Automatischer Wiederholungsversuch nach einer Wartezeit
Double sync detected	Dieselbe Adresse synchronisiert bereits	Auf Abschluss der bestehenden Synchronisierung warten

Bei anhaltenden Problemen lesen Sie den Leitfaden Sync & Konnektivität.