Blockchain-synchronisatie

De blockchain-synchronisatiepipeline haalt on-chain gegevens op, normaliseert deze en dedupliceert ze voor elke verbonden wallet. De voortgang wordt in realtime gestreamd, zodat u elke synchronisatie kunt volgen.

Hoe synchronisatie werkt

Wanneer u een wallet verbindt of een synchronisatie start, lanceert CryptaCount twee parallelle gegevensstromen:

Transactions — Haalt overdrachten van de basisvaluta op (ETH op Ethereum, MATIC op Polygon, enz.) en normale contractaanroepen. Dit zijn directe transacties op de basislaag van de keten.

Token Transfers — Haalt tokenoverdrachtgebeurtenissen op (ERC-20 en equivalenten). Dit zijn door contracten uitgezonden gebeurtenissen vastgelegd uit transactielogboeken, onafhankelijk van normale transacties gesynchroniseerd.

Elke stroom heeft zijn eigen voortgangsregistratie (het laatste verwerkte bloknummer) en pagineringscursor.

Levenscyclus van synchronisatie

1. Initialiseren — CryptaCount controleert of een andere wallet met hetzelfde adres en dezelfde keten al gesynchroniseerd wordt (voorkomt dubbele synchronisatie). Bepaalt het startblok per stroom.
2. Ophalen — Transactiegegevens opvragen bij blockchain-providers in gepagineerde stukken
3. Normaliseren — Ketenspecifieke formaten omzetten naar het universele transactiemodel van CryptaCount
4. Dedupliceren — Elke transactie controleren op bestaande records om duplicaten te voorkomen
5. Opslaan — Nieuwe transacties naar de werkruimte schrijven
6. Classificeren — De transactieclassificatie-engine uitvoeren op nieuwe records
7. Prijzen — FMV ophalen voor elk activum bij elke transactietijdstempel
8. Journaliseren — Dubbelboekhoudkundige journaalposten genereren

Deduplicatie

Elke transactie krijgt een unieke sleutel op basis van de keten, het blok, de transactiehash en de gebeurtenisindex. CryptaCount controleert op bestaande records vóór het invoegen, zodat er geen dubbele gegevens optreden, zelfs als een synchronisatie wordt onderbroken en opnieuw gestart.

Slim hervatten

Na de initiële volledige synchronisatie hervatten volgende synchronisaties vanuit het laatste verwerkte blok. Cruciaal is dat het hervattingspunt per stroom wordt bijgehouden (transactions versus token transfers):

• Elke stroom hervat onafhankelijk
• Dit voorkomt het scenario waarbij het bloknummer van een snel voltooide stroom ertoe leidt dat de andere stroom gegevens overslaat

Voortgang in realtime

Synchronisatievoortgang wordt in realtime gestreamd naar de interface. De voortgangsweergave toont:

• Huidige synchronisatiefase (ophalen, normaliseren, opslaan)
• Verwerkte transacties / geschat totaal
• Blokvoortgang (huidig blok / laatste blok)
• Status per stroom (Transactions, Token Transfers)
• Eventuele foutmeldingen

Dit maakt live voortgangsindicatoren mogelijk zonder dat de pagina moet worden vernieuwd.

Deduplicatie bij meerdere wallets

Wanneer hetzelfde adres wordt gebruikt in meerdere werkruimtewallets (bijv. hetzelfde adres toegevoegd met verschillende labels), controleert CryptaCount op duplicaten en slaat het over als een andere wallet met hetzelfde adres al gesynchroniseerd is of gesynchroniseerd wordt. Dit voorkomt dubbele transactiegegevens op werkruimteniveau.

Snelheidsbeperking en weerbaarheid

Blockchain-dataproviders leggen snelheidsbeperkingen op. De synchronisatiepipeline gaat hier als volgt mee om:

• Automatische back-off — Wanneer snelheidsbeperkingen worden bereikt, trekt het systeem zich automatisch terug en probeert het opnieuw
• Voortgangsbehoud — Als een synchronisatie wordt onderbroken, wordt de voortgang per stroom opgeslagen en hervat de volgende synchronisatie waar de vorige was gebleven
• Opruimen van vastgelopen synchronisaties — Een achtergrondtaak detecteert en ruimt periodiek vastgelopen synchronisaties op

Synchronisatiestatus bewaken

Vanuit de walletdetailweergave toont het tabblad Sync:

• Huidige synchronisatiestatus per stroom (Transactions, Token Transfers)
• Laatste verwerkte bloknummer per stroom
• Totaal aantal opgehaalde transacties
• Eventuele foutmeldingen
• Tijdstip van laatste succesvolle synchronisatie

Handmatige synchronisatie starten

• Enkele wallet: Open walletdetails → klik op Sync Now
• Herscanning: Forceer een volledige herscanning van een wallet vanaf blok 0
• Synchronisatieverzoek: Gebruikers kunnen synchronisaties aanvragen, die werkruimtebeheerders goedkeuren of afwijzen

Synchronisatiefouten

Veelvoorkomende synchronisatiefouten en hun oplossing:

Fout	Oorzaak	Oplossing
Snelheidslimiet overschreden	Te veel verzoeken aan de provider	Wachten en opnieuw proberen; automatische back-off regelt dit
Time-out	Grote gegevensbatch duurt te lang	Automatisch; volgende synchronisatie hervat vanuit het laatste blok per stroom
Ongeldig adres	Walletadres komt niet overeen met de geselecteerde keten	Adresformaat en ketenselectie verifiëren
Provider niet beschikbaar	Blockchain-dataprovider tijdelijk uitgevallen	Automatisch opnieuw proberen na een wachttijd
Dubbele synchronisatie gedetecteerd	Hetzelfde adres wordt al gesynchroniseerd	Wachten tot de bestaande synchronisatie is voltooid

Voor aanhoudende problemen, zie de probleemoplossingsgids Sync & Connectivity.