Comment vider le cache de votre portefeuille pour résoudre les problèmes de connexion ?

Comprendre le cache du portefeuille et son rôle

1. Le cache du portefeuille stocke des données temporaires telles que les en-têtes de blockchain, les métadonnées de transaction et les journaux de connexion homologues pour accélérer la synchronisation et réduire les requêtes réseau redondantes.

2. Au fil du temps, des entrées de cache corrompues ou obsolètes peuvent amener les clients du portefeuille à mal interpréter l'état des nœuds, entraînant des indicateurs « hors ligne » persistants malgré une connectivité Internet active.

3. Certains portefeuilles écrivent le cache directement sur le disque sans contrôles de validation. Cela peut entraîner des références racine Merkle obsolètes ou des instantanés d'ensemble UTXO incohérents.

4. Les anomalies liées au cache sont particulièrement fréquentes après des arrêts brusques, des mises à jour du micrologiciel ou lors du basculement entre les configurations du réseau principal et du réseau de test sur le même chemin d'installation.

Emplacements de cache spécifiques à la plate-forme

1. Sur macOS, Electrum stocke le cache sous ~/Library/Application Support/Electrum/cache/ , où chaque fichier correspond à une plage de hauteur de bloc spécifique et contient des données d'en-tête codées en binaire.

2. Bitcoin Core utilise les répertoires ~/.bitcoin/blocks/index/ et ~/.bitcoin/chainstate/ : ceux-ci contiennent des index gérés par leveldb qui doivent être régénérés après la suppression du cache.

3. Trust Wallet sur Android conserve le cache dans /data/data/com.trustwallet.app/cache/ , accessible uniquement avec les privilèges root ou via des commandes shell ADB comme adb shell rm -rf /data/data/com.trustwallet.app/cache/* .

4. Ledger Live met en cache les réponses de l'API et les jetons de prise de contact de l'appareil dans %APPDATA%\Ledger Live\cache\ sous Windows, et la suppression de ce dossier force la ré-authentification auprès des serveurs Ledger au redémarrage.

Risques de suppression incorrecte du cache

1. La suppression du cache pendant la synchronisation active d'un portefeuille peut déclencher un comportement de restauration, obligeant le client à retélécharger des milliers de blocs de Genesis même si les en-têtes récents ont déjà été vérifiés.

2. Certains portefeuilles stockent des indications de phrases de départ cryptées ou des clés de couplage de portefeuille matériel dans des sous-répertoires de cache. Leur suppression sans vérification de sauvegarde pourrait nuire aux flux de travail de récupération.

3. Si le répertoire de cache contient des liens symboliques pointant vers un stockage externe (par exemple, un stockage en bloc monté sur NAS), la suppression peut involontairement effacer des données en dehors de la portée prévue.

4. Certains portefeuilles multi-signatures intègrent l'état de session du cosignataire dans les fichiers cache ; les effacer à mi-chemin du flux de transaction peut rendre orphelins les PSBT partiellement signés, à moins qu'ils ne soient exportés au préalable.

Étapes de vérification après la suppression du cache

1. Lancez le portefeuille et observez le panneau du journal de débogage pour les messages contenant « Chargement de l'index du bloc... » ou « Reconstruction de l'état de la chaîne... » - ceux-ci confirment que la régénération du cache a commencé.

2. Vérifiez l'onglet réseau du portefeuille pour vérifier qu'au moins trois connexions sortantes affichent le statut « Connecté » et affichent des valeurs non nulles pour les octets envoyés/reçus au cours des 60 dernières secondes.

3. Soumettez une transaction de test de valeur nulle à une adresse de travail connue et vérifiez si elle apparaît dans l'explorateur Mempool dans les deux minutes. Cela valide la réactivité complète du point de terminaison RPC ou REST.

4. Confirmez la cohérence du solde en croisant le solde affiché avec un explorateur de blocs indépendant utilisant la même adresse publique, en vous assurant qu'aucun écart ne dépasse 0,00000001 BTC ou unité de base équivalente.

Foire aux questions

Q : La suppression du cache supprime-t-elle mes clés privées ? R : Non. Les clés privées résident dans la base de données de clés chiffrées du portefeuille ou dans la mémoire du périphérique matériel, et non dans les dossiers de cache. Le cache ne contient que des données opérationnelles transitoires.

Q : Puis-je vider le cache pendant que mon portefeuille est en cours d'exécution ? R : Pas en toute sécurité. La plupart des portefeuilles verrouillent les fichiers cache pendant le fonctionnement. Toute tentative de suppression peut entraîner des erreurs d'E/S ou des écritures partielles déstabilisant les lancements ultérieurs.

Q : Pourquoi mon portefeuille se reconnecte-t-il instantanément après la suppression du cache, puis se déconnecte-t-il à nouveau après cinq minutes ? R : Cela indique un échec de résolution DNS ou une interférence du pare-feu, et non une corruption du cache. La connexion initiale utilise les entrées DNS mises en cache ; des déconnexions ultérieures se produisent lorsque les requêtes DNS en direct expirent ou renvoient des adresses IP non valides.

Q : Existe-t-il un moyen de vider seulement une partie du cache au lieu de tout ? R : Oui. Pour Bitcoin Core, vous pouvez exécuter bitcoin-cli invalidateblock pour supprimer des blocs spécifiques sans toucher aux répertoires chainstate ou index.