Référence historique : le service original de Samourai et le coordinateur Whirlpool décrits ici sont indisponibles. Les captures expliquent l’ancien fonctionnement, pas une procédure actuelle d’installation ou de récupération. Les projets ultérieurs utilisant du code apparenté ont leur propre documentation et leurs propres hypothèses de confiance. Pour un guide à jour, consultez Votre solde est un ensemble d’histoires et Ashigaru.
Si ce n’est pas encore fait, consultez mon RoninDojo 101 pour découvrir ce que prépare l’équipe Ronin. C’est un excellent produit avec une feuille de route prometteuse ! Les étapes suivantes supposent que votre RoninDojo et Ronin UI sont configurés. Sinon, consultez le wiki pour un guide complet étape par étape.
Migration et connexion du portefeuille
La séquence de réinitialisation et de réinstallation décrit une ancienne procédure d’association Samourai. Sauvegardez d’abord et confirmez indépendamment l’identité du portefeuille et les chemins de compte nécessaires. Ne supprimez pas votre seul portefeuille fonctionnel pour changer sa connexion au serveur. La documentation actuelle de RoninDojo fournit des instructions propres à chaque portefeuille.
1. Ouvrez votre Samourai Wallet et appuyez sur les trois points en haut à droite pour accéder au menu. Allez dans Settings > Wallet > Show mnemonic. Vérifiez deux fois la correspondance avec votre sauvegarde hors ligne.
2. Revenez au menu et choisissez Troubleshoot > Passphrase/backup test. Saisissez la phrase secrète du portefeuille. Un message indiquera si elle est correcte. Ne continuez pas tant que le portefeuille ne l’a pas confirmé. Sans elle, vous ne pouvez pas accéder à vos bitcoins.
3. Si vous ne le connaissez pas déjà, notez votre PayNym. Depuis l’écran principal, appuyez sur le + bleu, puis sur PayNyms. Cela permettra de vérifier plus tard que vous avez restauré le bon portefeuille.
Conservez le portefeuille fonctionnel intact pendant que vous établissez la récupération. Sauvegardez et vérifiez la graine et toute phrase secrète, conservez la configuration des comptes et comparez des adresses connues dans le portefeuille restauré. Changer la connexion au nœud ne justifie pas, à lui seul, l’effacement de votre unique copie fonctionnelle.
5. Redémarrez Samourai Wallet.
6. Sélectionnez main-net et activez Tor.
7. Appuyez sur les trois points en haut à droite > Connect to existing Dojo.
FIG. 01Migration et connexion du portefeuille
8. Scannez le code QR de connexion Dojo affiché par l’interface de votre RoninDojo. Si vous n’utilisez pas RoninUI, le même code d’association QR se trouve dans l’outil de maintenance Dojo, accessible avec le navigateur Tor.
FIG. 02Migration et connexion du portefeuille
9. Pour un nouveau portefeuille, poursuivez la configuration affichée sur votre téléphone. Pour migrer un portefeuille existant, appuyez sur back et suivez ces étapes.
10. Appuyez de nouveau sur les trois points, puis sur Import External Wallet.
11. Saisissez votre phrase de récupération et la phrase secrète vérifiée précédemment.
FIG. 03Migration et connexion du portefeuille
12. Définissez un code PIN pour protéger l’application.
Un nom de portefeuille, PayNym ou empreinte identique ne suffit pas à valider une récupération. Vérifiez les adresses attendues, les paramètres du compte et l’historique avant d’utiliser le portefeuille récupéré.
FIG. 04Migration et connexion du portefeuille
Pour restaurer un ancien Samourai dans Sparrow, RoninDojo documente le chemin de dépôt m/84'/0'/0' et l’ajout séparé des comptes Whirlpool. Un compte postmélange ayant utilisé de nombreuses adresses peut nécessiter une marge de recherche plus grande. Récupérez chaque compte contenant des fonds et vérifiez ses adresses et son solde avant d’abandonner l’ancienne installation.
Restaurer les soldes
1. Dans Ronin UI, ouvrez les réglages et choisissez Toggle Hidden Values. Vous verrez l’URL et la clé d’administration de votre Dojo. Collez Dojo URL dans le navigateur Tor, puis Admin Key lorsque la connexion le demande. L’outil de maintenance Dojo s’ouvrira.
FIG. 05Restaurer les soldes
2. Dans le portefeuille mobile Samourai, appuyez sur les trois points verticaux en haut à droite, puis allez dans Settings > Wallet > Show XPUB. La clé publique étendue à choisir dépend de l’emplacement des fonds recherchés dans le portefeuille.
FIG. 06Restaurer les soldes
BIP44 XPUB = compte de dépôt pour les adresses commençant par « 1 »
Segwit BIP49 YPUB = compte de dépôt pour les adresses commençant par « 3 »
Segwit BIP84 ZPUB = compte de dépôt pour les adresses commençant par « bc »
Par défaut, Samourai Wallet utilise BIP84 ZPUB ; c’est donc probablement la clé nécessaire pour rechercher un solde dans le compte de dépôt.
Whirlpool pre-mix ZPUB = compte des fonds envoyés à Whirlpool qui n’ont pas encore été mélangés
Whirlpool post-mix ZPUB = compte contenant les fonds mélangés
Transmettez vos clés publiques étendues du téléphone à l’ordinateur de façon sécurisée, par e-mail chiffré ou avec une application comme Standard Notes.
3. Dans l’outil de maintenance Dojo, cliquez sur xpubs tool et saisissez le xpub à analyser de nouveau.
FIG. 07Restaurer les soldes
Le résultat devrait ressembler à celui ci-dessous. Les principaux éléments à examiner sont…
Suivi depuis = date
Solde = solde attendu
Derivation = le type de dérivation correspondant à votre xpub (voir l’étape 2)
Si le type de dérivation est incorrect, utilisez retype this xpub pour choisir celui souhaité.
FIG. 08Restaurer les soldes
4. Si aucun solde n’apparaît ou si le résultat indique que Dojo ne suit pas le xpub, appuyez sur rescan this xpub. Commencez avec les valeurs par défaut et lancez une nouvelle analyse. Si le solde reste absent, augmentez la valeur lookahead de 100 et recommencez.
FIG. 09Restaurer les soldes
6. Si les fonds se trouvent dans plusieurs parties du portefeuille, répétez les étapes 4-8 pour chaque clé publique étendue concernée.
Connexion de Whirlpool
Cette séquence d’interface graphique et de CLI est conservée comme référence. Ce n’est pas un guide d’installation fonctionnel pour le Sparrow actuel, qui a supprimé la prise en charge de Whirlpool dans la version 1.9.0. Un nom similaire ou un fork ne prouve pas l’équivalence des opérateurs, des frais ou des propriétés de confidentialité.
1. Si vous utilisiez déjà Whirlpool Desktop, allez dans System > Reset GUI.
2. Assurez-vous que le navigateur Tor est installé et fonctionne : il fournit la connexion au proxy Tor permettant à Whirlpool de se connecter à votre RoninDojo.
3. Sélectionnez Remote CLI.
FIG. 10Connexion de Whirlpool
4. Dans Ronin UI, appuyez sur Start Whirlpool, récupérez l’adresse du service caché Whirlpool dans les réglages et collez-la dans le champ d’adresse de l’interface graphique Whirlpool.
Vérifiez que le format ressemble à ceci : http://youraddress.onion
5. Le port Tor devrait devenir automatiquement « 9150 ». Sinon, modifiez-le manuellement. Appuyez sur connecter.
FIG. 11Connexion de Whirlpool
6. Dans le portefeuille mobile, allez dans Settings > Transactions > Pair to Whirlpool GUI. Copiez les données d’association et transmettez-les à l’ordinateur où Whirlpool Desktop est installé. Collez-les dans le champ prévu et continuez.
FIG. 12Connexion de Whirlpool
Appuyez ensuite sur Initialise GUI.
FIG. 13Connexion de Whirlpool
7. Vous serez invité à saisir la phrase secrète du portefeuille.
8. Whirlpool de bureau devrait s’ouvrir. Si vous migrez un portefeuille existant, vos UTXO seront exactement là où vous les aviez laissés avant la migration vers RoninDojo.
Si Whirlpool ne parvient pas à se connecter pendant la configuration, redémarrez le navigateur Tor et l’interface graphique Whirlpool.
FIG. 14Connexion de Whirlpool
Pour en savoir plus, consultez leur site, rejoignez le chat Telegram et écoutez ce podcast de Stephan Livera avec Zelko.
