Synchronisation blockchain

Le pipeline de synchronisation blockchain récupère, normalise et déduplique les données on-chain pour chaque wallet connecté. La progression est diffusée en temps réel pour vous permettre de surveiller chaque synchronisation en cours.

Fonctionnement de la synchronisation

Lorsque vous connectez un wallet ou déclenchez une synchronisation, CryptaCount lance deux flux de données parallèles :

Transactions — Récupère les transferts de devise native (ETH sur Ethereum, MATIC sur Polygon, etc.) et les appels de contrats normaux. Ce sont des transactions directes sur la couche de base de la chaîne.

Token Transfers — Récupère les événements de transfert de tokens (ERC-20 et équivalents). Ce sont des événements émis par des contrats capturés depuis les journaux de transactions, synchronisés indépendamment des transactions natives.

Chaque flux maintient son propre suivi de progression (numéro du dernier bloc traité) et son curseur de pagination.

Cycle de vie de la synchronisation

1. Initialisation — CryptaCount vérifie si un autre wallet avec la même adresse et la même chaîne est déjà en cours de synchronisation (évite la double synchronisation). Détermine le bloc de départ par flux.
2. Récupération — Demande les données de transaction aux fournisseurs blockchain par lots paginés
3. Normalisation — Convertit les formats spécifiques à chaque chaîne vers le modèle de transaction universel de CryptaCount
4. Déduplication — Vérifie chaque transaction par rapport aux enregistrements existants pour éviter les doublons
5. Stockage — Écrit les nouvelles transactions dans l’espace de travail
6. Classification — Exécute le moteur de classification des transactions sur les nouveaux enregistrements
7. Prix — Récupère la FMV pour chaque actif à chaque horodatage de transaction
8. Journal — Génère les écritures comptables en partie double

Déduplication

Chaque transaction se voit attribuer une clé unique basée sur la chaîne, le bloc, le hash de transaction et l’index d’événement. CryptaCount vérifie les enregistrements existants avant d’insérer, garantissant l’absence de données dupliquées même si une synchronisation est interrompue et redémarrée.

Reprise intelligente

Après la synchronisation initiale complète, les synchronisations suivantes reprennent depuis le dernier bloc traité. De manière cruciale, le point de reprise est suivi par flux (transactions vs. transferts de tokens) :

• Chaque flux reprend indépendamment
• Cela évite le scénario où le numéro de bloc d’un flux se terminant rapidement provoquerait le saut de données dans l’autre

Progression en temps réel

La progression de la synchronisation est diffusée en temps réel vers l’interface. L’affichage de la progression fournit :

• Phase de synchronisation actuelle (récupération, normalisation, stockage)
• Transactions traitées / total estimé
• Progression des blocs (bloc actuel / dernier bloc)
• Statut par flux (Transactions, Token Transfers)
• Messages d’erreur le cas échéant

Cela permet des indicateurs de progression en direct sans avoir à actualiser la page.

Déduplication multi-wallets

Lorsque la même adresse est utilisée sur plusieurs wallets de l’espace de travail (p. ex. même adresse ajoutée sous des libellés différents), CryptaCount vérifie les doublons et passe si un autre wallet avec la même adresse est déjà synchronisé ou en cours de synchronisation. Cela évite les doublons de données de transaction au niveau de l’espace de travail.

Limitation de débit et résilience

Les fournisseurs de données blockchain imposent des limites de débit. Le pipeline de synchronisation gère cela avec :

• Backoff automatique — En cas de limitation de débit, le système recule et réessaie automatiquement
• Préservation de la progression — Si une synchronisation est interrompue, la progression est sauvegardée par flux et la synchronisation suivante reprend là où elle s’est arrêtée
• Nettoyage des synchronisations bloquées — Un traitement en arrière-plan détecte et nettoie périodiquement les synchronisations bloquées

Surveiller l’état de synchronisation

Depuis la vue détaillée du wallet, l’onglet Sync affiche :

• État de synchronisation actuel par flux (Transactions, Token Transfers)
• Numéro du dernier bloc traité par flux
• Total des transactions récupérées
• Messages d’erreur éventuels
• Heure de la dernière synchronisation réussie

Déclencher une synchronisation manuelle

• Wallet unique : Ouvrez la vue détaillée du wallet → cliquez sur Sync Now
• Rescan : Forcer un rescann complet d’un wallet depuis le bloc 0
• Sync request : Les utilisateurs peuvent demander des synchronisations, que les managers de l’espace de travail approuvent ou rejettent

Erreurs de synchronisation

Erreurs de synchronisation courantes et leur résolution :

Erreur	Cause	Résolution
Limite de débit dépassée	Trop de requêtes vers le fournisseur	Attendre et réessayer ; le backoff automatique gère cela
Timeout	Trop grand lot de données	Automatique ; la prochaine synchronisation reprend depuis le dernier bloc par flux
Adresse invalide	L’adresse du wallet ne correspond pas à la chaîne sélectionnée	Vérifier le format de l’adresse et la sélection de la chaîne
Fournisseur indisponible	Fournisseur de données blockchain temporairement hors service	Réessai automatique après une période d’attente
Double synchronisation détectée	La même adresse est déjà en cours de synchronisation	Attendre que la synchronisation existante se termine

Pour les problèmes persistants, consultez le guide de dépannage Sync & Connectivity.