Perdez-vous l’accès à votre portefeuille BitBox02 ? Une phrase de récupération ou une carte microSD contenant une sauvegarde chiffrée peut généralement vous permettre de retrouver vos fonds. La méthode la plus sûre consiste à restaurer les clés sur le matériel lui-même, plutôt que d’extraire une clé privée en clair depuis un ordinateur.
Ce guide présente une procédure utilisant l’outil officiel bitbox-cli, avec les vérifications et les solutions de repli indispensablees.
1. Comprendre ce que signifie récupérer une clé privée BitBox
Un BitBox02 ne conserve pas une clé privée unique dans un fichier que vous pourriez récupérer avec une simple commande. L’appareil dérive les clés nécessaires à partir de la seed phrase, ou phrase de récupération, et les utilise pour signer les transactions dans son environnement sécurisé.
Trois éléments sont donc à distinguer :
- La seed phrase de 12 ou 24 mots constitue la sauvegarde principale du portefeuille.
- Le mot de passe BIP39, s’il est activé, produit un ensemble de clés différent. Ce mot de passe doit être conservé séparément.
- La sauvegarde microSD contient généralement une copie chiffrée de la seed phrase, protégée par le mot de passe défini lors de la configuration.
Principe de sécurité : une restauration réussie ne doit pas nécessiter d’afficher la seed phrase dans le terminal, de la copier dans un presse-papiers suspect ou de l’envoyer à un service en ligne.
Récupérer le portefeuille signifie donc de restaurer l’accès aux clés sur un BitBox02, puis de retrouver les fonds dans BitBoxApp. Cela évite de transformer votre sauvegarde en une phrase secrète exposée sur un ordinateur compromis.
2. Préparer tous les éléments nécessaires
Avant de lancer la restauration, disposez des éléments suivants :
- Le BitBox02 à restaurer, connecté par un câble USB-C fiable ;
- La carte microSD d’origine, ou la seed phrase de 12 ou 24 mots ;
- Le mot de passe de la sauvegarde microSD ;
- Le mot de passe BIP39 facultatif, s’il était configuré ;
- Un ordinateur personnel, de préférence hors ligne, exempt de logiciel malveillant ;
- La dernière version de BitBoxApp et, si nécessaire,
bitbox-cliissu du dépôt officielhttps://github.com/BitBoxSwiss/bitbox-cli.
Ne formatez pas la carte microSD avant la restauration. Conservez également plusieurs copies de la seed phrase et du mot de passe BIP39 dans des emplacements distincts. Si ces deux éléments sont conservés ensemble, une seule fuite peut suffire à compromettre le portefeuille.

Évitez les mots de passe faibles pour la sauvegarde microSD : le fichier est chiffré, mais un mot de passe devinable réduit fortement sa résistance. En revanche, ne choisissez pas un mot de passe que vous ne Arriveriez pas à restituer : le BitBox02 ne permet pas de contourner ce mot de passe simplement parce que la seed phrase est connue.
3. Restaurer le portefeuille avec bitbox-cli
Vérifier l’installation
Une fois bitbox-cli installé depuis la source officielle, confirmez d’abord les commandes disponibles sur votre version :
bitbox-cli --version
bitbox-cli --help
bitbox-cli restore --help
La syntaxe peut évoluer selon les versions. La sortie de bitbox-cli --help doit donc toujours être considérée comme la référence, plutôt que d’inventer une option.
Lancer la restauration depuis la microSD
Sur les versions qui fournissent la sous-commande restore, la procédure ressemble à ceci :
bitbox-cli restore
L’outil vous invite ensuite à sélectionner la sauvegarde chiffrée présente sur la microSD, généralement dans un fichier nommé btseed.<fingerprint>.bitbox. Saisissez le mot de passe de sauvegarde uniquement dans l’invite sécurisée du programme et confirmez les opérations demandées directement sur l’écran tactile du BitBox02.
Ne placez jamais la seed phrase, le mot de passe de sauvegarde ou le mot de passe BIP39 dans un argument de commande. Les arguments peuvent être conservés dans l’historique du shell et visibles par les autres processus du système. Si une version de l’outil ne masque pas correctement une saisie, interrompez l’opération et utilisez l’assistant officiel de BitBoxApp.

Après la restauration, l’appareil doit retrouver sa configuration de compte. Si le logiciel semble demander de confirmer une nouvelle configuration sur l’écran du钱包, comparez attentivement les informations affichées avant de valider.
Quand la commande restore n’est pas disponible
Certaines versions de bitbox-cli peuvent ne pas exposer directement la restauration. Dans ce cas :
- Vérifiez que vous utilisez bien la version officielle la plus récente.
- Consultez la section
restoreoubackupde l’aide du programme. - Si la fonction reste absente, utilisez l’assistant de restauration intégré dans BitBoxApp avec la même carte microSD.
Cette solution de repliEffectue le même travail de restauration sans forcer une commande non documentée.
4. Vérifier que la récupération est correcte
Une commande d’information permet de contrôler l’état du périphérique. Sur les builds qui la proposent :
bitbox-cli device-info
Vérifiez les éléments suivants :
- Le modèle et la version du firmware correspondent à votre matériel ;
- L’empreinte du portefeuille est identique à celle de la sauvegarde d’origine ;
- Aucun message d’erreur n’indique une restauration incomplète ;
- BitBoxApp détecte le périphérique sans demander une nouvelle configuration de seed phrase.
Ouvrez ensuite BitBoxApp, connectez le BitBox02 et contrôlez les anciennes adresses de réception. Comparez au moins une adresse connue, en veillant à utiliser le même réseau, le même type de script et les mêmes paramètres de dérivation. Une différence de format peut simplement provenir de l’affichage de l’application, mais une adresse entièrement différente doit faire l’objet d’une vérification supplémentaire.

Si les fonds apparaissent correctement, vous pouvez réaliser un petit transfert de test après avoir confirmé l’adresse de destination directement sur l’écran du BitBox02. Cette transaction facultative permet de vérifier l’ensemble de la chaîne avant de Considerer la restauration definitively terminée.
5. Gérer les cas particuliers
La carte microSD est perdue
Si la seed phrase de 12 ou 24 mots est disponible, utilisez l’assistant officiel de restauration de BitBoxApp. Selon le modèle et la version du firmware, la saisie s’effectue via l’écran et le clavier de l’appareil ou par l’intermédiaire de l’application, avec des confirmations sur le hardware.
N’utilisez pas un site web qui réclame une seed phrase et n’inscrivez pas la phrase dans une commande shell. Si votre version de bitbox-cli propose une importation interactive, privilégiez toujours une saisie masquée et jamais une option qui conserverait la phrase dans l’historique.
Le mot de passe de la microSD est oublié
La seed phrase seule ne permet pas de déchiffrer le fichier de sauvegarde microSD. Il faut retrouver le mot de passe original. Si celui-ci est较强的 et unique, une tentative de cracking devient généralement impraticable ; il est préférable de rechercher dans vos gestionnaires de mots de passe, vos sauvegardes ou vos supports de configuration d’origine.
Le mot de passe BIP39 est oublié
Le mot de passe BIP39 n’est pas la même chose que le mot de passe de la microSD. Sans lui, la seed phrase seule peut dériver un portefeuille différent. Des outils hors ligne专门isés dans la vérification de passphrases BIP39 peuvent être envisagés, mais ils ne doivent recevoir la seed phrase que sur une machine isolée et de confiance.
Le BitBox02 n’est pas détecté
Essayez un autre câble USB-C, un port direct et la fermeture des autres applications de portefeuille. Sous Linux, le problème peut aussi venir des permissions du périphérique USB. En aucun cas, un câble ou un logiciel tiers ne doit vous demander de saisir votre seed phrase pour établir la connexion.
La seed phrase et les mots de passe sont tous perdus
Sans la seed phrase, le mot de passe BIP39 éventuel ou une sauvegarde microSD exploitable, il est mathématiquement impossible de retrouver les clés à partir du seul contenu visible de l’appareil. Un service de récupération ne peut pas contourner cette limitation ; il peut seulement exploiter une sauvegarde dont vous disposez déjà.
Conclusion
Pour récupérer une clé privée BitBox en ligne de commande, la bonne approche consiste à restaurer le portefeuille avec bitbox-cli à partir de la sauvegarde microSD chiffrée, puis à vérifier l’empreinte et les adresses dans BitBoxApp. Ne cherchez pas à extraire la seed ou une clé privée en clair : la restauration matérielle protège les fonds bien plus efficacement.
Avant de conclude,ّنExisting un inventaire de vos sauvegardes et especially une nouvelle copie microSD vérifiée, sans supprimer l’ancienne avant d’avoir contrôlé la restauration. Ces précautions permettent de récupérer l’accès à vos fonds tout en évitant de transformer votre sauvegarde en vulnérabilité.