La perte d’un mot de passe de portefeuille Tezos peut sembler définitive. Pourtant, lorsqu’il s’agit de votre propre portefeuille et que vous disposez du fichier chiffré, d’une sauvegarde ou d’un indice fiable, une approche méthodique par script peut parfois rouvrir l’accès. Ce guide s’adresse aux utilisateurs avancés, développeurs et passionnés de sécurité qui souhaitent comprendre comment automatiser la vérification de mots de passe candidats dans un cadre légal et éthique.
Important : ne tentez jamais de récupérer un portefeuille qui ne vous appartient pas. La récupération de mot de passe doit rester strictement personnelle, autorisée et documentée.
1. Comprendre le chiffrement d’un portefeuille Tezos
Avant d’écrire la moindre ligne de code, il faut identifier le format de votre portefeuille et la manière dont il protège vos secrets. Un portefeuille Tezos peut être :
- Un fichier keystore local : souvent un JSON contenant un sel, des paramètres de dérivation, un ciphertext et un tag d’authentification.
- Une base de données chiffrée : utilisée par certaines applications desktop ou extensions.
- Une seed chiffrée : protégée par un mot de passe via Argon2, scrypt ou PBKDF2.
- Un matériel Ledger ou un coffre externe : dans ce cas, le script ne pourra pas extraire la seed sans interaction matérielle.
La difficulté principale vient de la fonction de dérivation de clé. Argon2, par exemple, est conçue pour être lente et gourmande en mémoire. Un script naïf qui teste des milliers de mots de passe par seconde sur un seul cœur peut mettre des années à trouver une phrase complexe. L’objectif d’un script avancé est donc d’optimiser chaque étape : génération de candidats, dérivation, déchiffrement, vérification et parallélisation.
Ce qu’il faut extraire du fichier
Pour tester un mot de passe, votre script a besoin de :
- le sel ou nonce,
- l’algorithme de dérivation et ses paramètres,
- le ciphertext,
- le tag d’authentification ou mécanisme de vérification,
- éventuellement l’adresse Tezos publique associée pour valider une seed déchiffrée.
Si vous ne pouvez pas extraire ces éléments, la récupération par script devient très limitée. Dans ce cas, il faut d’abord restaurer une sauvegarde ou utiliser les fonctions officielles de récupération du portefeuille.
2. Préparer un environnement de récupération sûr
La récupération de mot de passe exige un environnement isolé. Travaillez sur une machine de confiance, idéalement hors ligne pour les opérations sensibles.
- Copiez le fichier de portefeuille et ne modifiez jamais l’original.
- Chiffrez votre disque et évitez les services cloud non chiffrés.

- Utilisez un environnement virtuel Python pour installer uniquement les dépendances nécessaires.
- Documentez les paramètres connus : longueur probable, mots utilisés, dates, variantes, fautes de frappe possibles.
- Testez d’abord avec le vrai mot de passe pour valider votre script avant de lancer une recherche longue.
Les bibliothèques utiles peuvent inclure hashlib, argon2-cffi, cryptography, scrypt, multiprocessing, concurrent.futures et tqdm. Pour les attaques par dictionnaire, des outils comme Hashcat ou John the Ripper peuvent être adaptés si le format du portefeuille est pris en charge.
Créer une liste de candidats intelligente
Un script avancé ne se contente pas de tester un dictionnaire générique. Il combine plusieurs stratégies :
- Dictionnaires ciblés : mots personnels, projets, dates, lieux, noms d’animaux.
- Règles de mutation : majuscules, chiffres ajoutés, substitutions comme
avers@,evers3. - Attaques par masque : motifs connus comme
MotDePasse?d?d?d?d. - Combinaisons hybrides : deux mots du dictionnaire concaténés avec un séparateur.
- Variantes de frappe : AZERTY/QWERTY, oubli de majuscule, double lettre.
Plus votre liste est réaliste, plus vous économisez de temps. Une recherche massive et aveugle est rarement efficace contre un mot de passe fort.
3. Construire le script de vérification
Voici une architecture typique pour un script de récupération destiné à votre propre portefeuille. Le code réel dépendra du format exact de votre fichier.
import json
import multiprocessing as mp
from argon2.low_level import hash_secret_raw, Type
from cryptography.hazmat.primitives.ciphers.aead import AESGCM
def charger_keystore(chemin):
with open(chemin, 'r', encoding='utf-8') as f:
data = json.load(f)
return data
def derive_key(mot_de_passe, sel, params):

return hash_secret_raw(
secret=mot_de_passe.encode('utf-8'),
salt=sel,
time_cost=params['time'],
memory_cost=params['memory'],
parallelism=params['parallelism'],
hash_len=params['hash_len'],
type=Type.ID
)
def verifier_candidat(mot_de_passe, data):
try:
cle = derive_key(mot_de_passe, data['salt'], data['kdf_params'])
aes = AESGCM(cle)
aes.decrypt(data['nonce'], data['ciphertext'], data['tag'])
return mot_de_passe
except Exception:
return None
def worker(chunk, data, resultats):
for mot in chunk:
trouve = verifier_candidat(mot, data)
if trouve:
resultats.put(trouve)
return
def lancer_recherche(candidats, data, nb_processus=8):
resultats = mp.Queue()
taille = max(1, len(candidats) // nb_processus)
morceaux = [candidats[i:i+taille] for i in range(0, len(candidats), taille)]
processus = [mp.Process(target=worker, args=(m, data, resultats)) for m in morceaux]
for p in processus:
p.start()
for p in processus:

p.join()
if not resultats.empty():
return resultats.get()
return None
Ce squelette montre les points clés : dérivation, déchiffrement authentifié, parallélisation et arrêt dès qu’un candidat valide est trouvé. Dans un cas réel, il faut adapter les noms de champs, le type d’Argon2, la taille de clé et le mode de chiffrement.
Optimisations avancées
- Parallélisation CPU : utilisez
multiprocessingplutôt que des threads, car les fonctions de dérivation sont gourmandes en CPU et libèrent le GIL. - Accélération GPU : si le format est compatible, Hashcat peut être beaucoup plus rapide pour PBKDF2 ou scrypt.
- Cache de dérivation : inutile de recalculer une clé pour un mot de passe déjà testé.
- Sauvegarde d’état : enregistrez les candidats testés pour reprendre après une interruption.
- Journalisation discrète : ne stockez jamais les mots de passe candidats en clair dans les logs.
- Validation par adresse : après déchiffrement, vérifiez que l’adresse Tezos correspond à celle de votre portefeuille.
4. Limites, éthique et bonnes pratiques
La récupération par script est une course contre l’entropie. Un mot de passe court, prévisible ou basé sur un motif personnel peut être retrouvé en quelques heures. Un mot de passe long, aléatoire et unique peut rester hors de portée même avec un cluster GPU. Il faut donc fixer des attentes réalistes.
La légalité ne dépend pas de la technique, mais de l’autorisation. Vous ne devez utiliser ces méthodes que sur un portefeuille dont vous êtes le propriétaire légitime ou pour lequel vous disposez d’un mandat écrit.
Bonnes pratiques après récupération :
- Transférez immédiatement les fonds vers un nouveau portefeuille si vous suspectez une exposition.
- Générez un nouveau mot de passe fort avec un gestionnaire de mots de passe.
- Sauvegardez la seed et le descripteur de portefeuille hors ligne, sur plusieurs supports.
- Ne réutilisez jamais l’ancien mot de passe compromis.
- Documentez la procédure pour vos proches ou votre plan de succession numérique.
Conclusion
Récupérer le mot de passe d’un portefeuille Tezos avec un script avancé est possible dans certains cas, mais jamais garanti. La réussite dépend du format du portefeuille, de la puissance de calcul et surtout de la qualité de vos indices. En combinant une préparation rigoureuse, des dictionnaires ciblés, une parallélisation efficace et une validation par adresse Tezos, vous maximisez vos chances sans compromettre la sécurité. Si la recherche devient trop coûteuse, la meilleure solution reste de restaurer une sauvegarde ou de considérer les fonds comme perdus. La sécurité d’un portefeuille commence par une sauvegarde testée, pas par une récupération d’urgence.