Dépanner Ginger Wallet

Niveau de lecture : utilisation courante. Choisissez ce guide lorsque vous avez besoin de la tâche qu’il décrit.

Commencez par l’erreur exacte, le portefeuille choisi, le réseau et la version. Préservez les informations de récupération et les fichiers avant de modifier les données. Réinstaller, supprimer des dossiers ou créer de nouveaux mots est rarement la première étape pour un problème de connexion ou d’affichage.

Solde, récupération et réception

Symptôme	Premier contrôle	Étape suivante
Portefeuille récupéré vide	Mots d’origine, phrase exacte, réseau et progression	Comparez adresses ou historique connus après synchronisation ; utilisez les contrôles avancés seulement si les contrôles ordinaires ne suffisent pas
Paiement entrant manquant	Adresse correcte, identifiant de transaction fourni par l’expéditeur, portefeuille choisi	Vérifiez diffusion et confirmation, puis synchronisation locale
Receive ou Send absent	Récupération encore active ? Portefeuille en lecture seule ?	Attendez la récupération ou utilisez le signataire nécessaire
Ancienne adresse disparue de la liste	A-t-elle été payée ou masquée ?	Vérifiez l’historique ; sa visibilité n’invalide pas les clés
Seul un très petit paiement manque	Seuil de poussière et synchronisation	Comparez le seuil configuré avant de supposer un vol
Étiquettes perdues après récupération	Le fichier ATTR correspondant a-t-il été sauvegardé ?	Préservez-le ; la blockchain ne reconstruit pas les étiquettes

Ne saisissez pas les mots sur un site pour « resynchroniser » un portefeuille. N’utilisez que le parcours de récupération installé et vérifié sur un ordinateur fiable.

Connexion ou synchronisation

Vérifiez connexion, horloge, stockage libre et état du nœud configuré. Une première analyse peut simplement prendre du temps. Si aucun progrès ne se produit, fermez Ginger normalement et rouvrez une fois. Notez le résultat plutôt que de redémarrer répétitivement l’analyse.

Awaiting connection peut bloquer CoinJoin et d’autres services même si l’historique est en cache. Considérez le solde déconnecté comme potentiellement incomplet. Gardez Tor pendant l’examen. P2P du nœud et estimations RPC sont séparés ; l’un fonctionnel ne prouve pas l’autre.

Si vous utilisez Wallet Settings → Tools → Resync, sauvegardez d’abord et prévoyez une nouvelle analyse. Ne supprimez pas Wallets, WalletBackups ou les fichiers 2FA simplement pour effacer un message.

Le démarrage signale une configuration invalide

Dans v2.0.27, Ginger interrompt le démarrage s’il ne peut pas charger Config.json, tout en préservant le fichier original. Le message d’erreur indique son chemin. Lorsque c’est possible, Ginger crée à côté un fichier distinct Config.Default.json servant de modèle de réglages par défaut ; un modèle existant est également préservé. Cette erreur concerne les réglages de l’application et ne signifie pas, à elle seule, qu’un portefeuille ou ses clés sont endommagés.

1. Fermez Ginger et préservez le dossier de données et les sauvegardes du portefeuille avant de modifier des fichiers. Conservez une copie distincte du Config.json original.
2. Si vous comprenez la configuration, comparez-la à Config.Default.json et corrigez le JSON ou la valeur de réglage invalide. Le modèle peut être absent si Ginger n’a pas pu l’écrire.
3. Pour démarrer volontairement avec les réglages par défaut de l’application, renommez le Config.json original, par exemple en Config.before-repair.json, et conservez-le. Redémarrez Ginger pour générer un nouveau Config.json.
4. Vérifiez les réglages du réseau, de Tor, du nœud complet et les autres réglages personnalisés avant de reprendre l’utilisation normale. Renommer ce fichier de réglages ne récupère pas une phrase secrète oubliée et ne remplace pas les sauvegardes du portefeuille. Gardez Wallets, WalletBackups et les fichiers de 2FA intacts.

Si les réglages de démarrage Windows provoquaient une erreur, v2.0.27 gère l’absence d’une entrée de démarrage dans le registre. Après la mise à jour, vérifiez Settings → General → Run Ginger when computer starts.

JSON-RPC ne démarre pas

Ce contrôle s’applique si vous avez expressément activé le serveur JSON-RPC du portefeuille Ginger. Dans v2.0.27, JsonRpcUser et JsonRpcPassword doivent tous deux contenir des valeurs non vides ; les valeurs composées uniquement de caractères d’espacement sont rejetées. Sans elles, le serveur RPC refuse de démarrer et en consigne la raison, tandis que l’application du portefeuille continue de fonctionner.

Ginger étant fermé, définissez les deux identifiants dans Config.json et configurez le client qui s’y connectera pour les utiliser. Si vous n’avez pas besoin du serveur, définissez plutôt JsonRpcServerEnabled sur false. N’incluez pas d’identifiants dans les journaux partagés ni dans les demandes d’assistance. Il s’agit des réglages RPC du portefeuille Ginger, distincts des identifiants RPC d’un nœud Bitcoin Core ou de la phrase secrète du portefeuille.

CoinJoin ne démarre pas

Message ou condition	Action probable
Insufficient funds eligible for coinjoin	Examinez les confirmations, les montants des pièces, les frais et les exclusions ; le total ne suffit pas à établir l’admissibilité
Only excluded funds are available	Examinez Exclude Coins si vous souhaitez faire participer certaines pièces
Only immature funds are available	Attendez le nombre requis de confirmations ; les sorties nouvellement minées ont des règles de dépense spéciales
Some funds are rejected from coinjoining	Lisez la raison et les conditions actuelles ; le refus ne transfère pas la propriété
Awaiting cheaper coinjoins	Examinez les préférences de coût et décidez si attendre correspond au but
Coinjoin may be uneconomical	Examinez seuil d’arrêt et coûts relatifs avant de contourner manuellement
Awaiting the blame round	Attendez la reprise ; ce n’est pas une instruction d’accuser quelqu’un
Awaiting closure of send dialog	Terminez ou fermez le parcours d’envoi
Mining fee rate was too high ou Coordination fee rate was too high	Attendez ou examinez les conditions ; n’augmentez pas aveuglément les limites
Source matérielle	La signature automatique exige un portefeuille logiciel admissible

Des participants peuvent ne pas terminer, ou une pièce devenir temporairement indisponible après interruption. Réessais, imports répétés et tentatives de contourner un refus ne constituent pas une réparation. Utilisez raison et état actuel pour décider d’attendre ou de contacter l’assistance officielle.

La version 2.0.27 corrige un plantage sur macOS lors de l’arrêt de CoinJoin. Si Ginger se ferme pendant la participation, rouvrez-le, laissez le portefeuille se synchroniser et examinez l’historique avant de supposer qu’une transaction a échoué. Fermer l’application n’annule pas une transaction déjà diffusée. Notez toute erreur récurrente et la version installée pour l’assistance.

Problèmes de paiement ou de frais

Si les estimations manquent, attendez, réparez la connexion prestataire/nœud ou utilisez un taux manuel que vous comprenez. Le montant final plus les frais doit tenir dans les fonds dépensables. Une longue chaîne non confirmée peut exiger d’attendre les confirmations antérieures.

Utilisez Speed Up Transaction ou Cancel Transaction seulement si proposé et après vérification des frais. L’annulation tente de remplacer un paiement en attente ; elle ne peut pas annuler un paiement confirmé. Après une diffusion incertaine, vérifiez l’historique avant un double paiement.

2FA et matériel

Pour un code d’authentification rejeté, vérifiez l’heure du téléphone, l’entrée choisie, la compatibilité de l’authentificateur avec Ginger et la connexion à Tor et au service. Préservez les fichiers du portefeuille et de 2FA existants. Si le démarrage normal ne revient pas, les mots de récupération et la phrase secrète d’origine constituent la sauvegarde indépendante des clés ; réinstaller sur les mêmes données ne recrée pas l’authentificateur perdu. La FAQ avancée explique la dépendance.

Pour la détection, utilisez un seul matériel déverrouillé, un câble de données et un port direct, avec applications concurrentes fermées. Terminez les étapes requises de Bitcoin, PIN ou phrase sur l’appareil. Sous Linux, vérifiez les permissions du fabricant. Gardez la seed hors ordinateur.

Signaler un problème utilement

Utilisez les liens du dépôt Ginger officiel. Indiquez version, système et processeur, erreur exacte, résultat attendu et reproduction non secrète minimale. Mentionnez modèle et firmware si pertinent.

L’action Logs de recherche ouvre les journaux. Examinez-les et expurgez avant partage : chemins, adresses, identifiants, étiquettes et commandes peuvent être sensibles. Partagez un extrait minimal pertinent, pas tout le dossier. Une issue publique est publique ; aucune assistance ne devrait nécessiter mots ou phrase secrète.