Ashigaru Terminal

Loïc MorelLoïc Morel
30 oct. 2025
30 oct. 2025
Ashigaru Terminal est l'adaptation de Sparrow Server par les équipes d'Ashigaru qui implémente le protocole de coinjoin Whirlpool. Ce logiciel s’inscrit dans la continuité du travail amorcé par Samourai Wallet, notamment sur Whirlpool GUI, dont il reprend les principes fondamentaux : la self-custody et la préservation de la confidentialité.
Ce logiciel est donc un fork de Sparrow Server, modifié et optimisé pour une intégration complète avec l’écosystème Whirlpool, le protocole de coinjoin ZeroLink initialement développé par les équipes de Samourai.
Ashigaru Terminal fonctionne depuis une interface TUI minimaliste et peut être déployé sur un ordinateur personnel ou sur un serveur dédié. Il permet d’interagir directement avec Whirlpool pour initier des "Tx0", gérer les comptes "Deposit", "Premix", "Postmix" et "Badbank", et effectuer des remixages automatiques afin de renforcer la confidentialité de vos pièces.
En résumé, Ashigaru Terminal vous sera particulièrement utile si vous souhaitez réaliser des coinjoins via Whirlpool.
Dans ce premier tutoriel, je vais vous accompagner dans l’installation et la prise en main d’Ashigaru Terminal. Un second tutoriel, plus avancé, sera ensuite consacré à la réalisation concrète de coinjoins.

1. Installer Ashigaru Terminal

Pour installer Ashigaru Terminal, vous aurez besoin de Tor Browser, car les binaires ne sont distribués que via le réseau Tor. Si ce n’est pas déjà fait, installez-le sur votre machine.

1.1. Télécharger Ashigaru Terminal

Depuis Tor Browser, rendez-vous sur la page des releases de leur dépôt Git afin de télécharger la dernière version d’Ashigaru Terminal correspondant à votre système d’exploitation.
ashicodepbnpvslzsl2bz7l2pwrjvajgumgac423pp3y2deprbnzz7id.onion/Ashigaru/Ashigaru-Terminal/releases/
Téléchargez les 2 fichiers suivants correspondant à votre système d’exploitation :
  • Le binaire (ashigaru_terminal_v1.0.0_amd64.deb pour Debian/Ubuntu, .dmg pour macOS ou .zip pour Windows) ;
  • Le fichier des hachages signés : ashigaru_terminal_v1.0.0_signed_hashes.txt.

1.2. Vérifier Ashigaru Terminal

Avant d’exécuter le logiciel sur votre appareil, il faut vérifier son authenticité et son intégrité. Cette étape est importante, car elle permet d'éviter d’installer une version frauduleuse susceptible de compromettre vos bitcoins ou d’infecter votre machine.
Ouvrez un nouvel onglet dans un navigateur et accédez à l’outil de vérification Keybase. Collez dans le champ prévu le contenu du fichier .txt que vous venez de télécharger, puis cliquez sur le bouton Verify.
Pour diversifier vos sources de vérification, vous pouvez également comparer le message avec celui disponible sur le site clearnet ashigaru.rs, dans la section /download.
Si la signature est valide, Keybase affichera un message confirmant que le fichier a bien été signé par les développeurs d’Ashigaru.
Vous pouvez aussi cliquer sur le profil ashigarudev affiché par Keybase et vérifier que l’empreinte de leur clé correspond exactement à : A138 06B1 FA2A 676B.
Si une erreur apparaît à cette étape, cela signifie que la signature n’est pas valide. Dans ce cas, n’installez surtout pas le logiciel téléchargé. Reprenez la procédure depuis le début ou demandez de l’aide à la communauté avant de continuer.
Keybase vous a fourni le hachage authentifié de l’application. Nous allons maintenant vérifier que le hachage du fichier .deb, .zip ou .dmg que vous avez téléchargé correspond bien à celui validé sur Keybase. Pour cela, rendez-vous sur le site HASH FILE ONLINE.
Cliquez sur le bouton BROWSE... et sélectionnez le fichier .deb, .zip ou .dmg téléchargé à l’étape 1.1. Choisissez ensuite la fonction de hachage SHA-256, puis cliquez sur CALCULATE HASH pour générer le hachage de votre fichier.
Le site affichera alors le hachage du logiciel. Comparez-le à celui que vous avez vérifié sur Keybase.io. Si les deux correspondent parfaitement, la vérification d’authenticité et d’intégrité est réussie. Vous pouvez alors utiliser ce logiciel.

1.3 Lancer Ashigaru Terminal

  • Debian / Ubuntu
Pour installer le logiciel, exécutez la commande :
cd ~/Downloads sudo apt install ./ashigaru_terminal_v1.0.0_amd64.deb
Modifiez la commande en fonction de la version téléchargée.
Vérifiez ensuite l’installation :
/opt/ashigaru-terminal/bin/Ashigaru-terminal --version
Puis lancez le logiciel :
/opt/ashigaru-terminal/bin/Ashigaru-terminal
  • Windows
Faites un clic droit sur le fichier .zip que vous avez téléchargé et vérifié, puis sélectionnez Extract All... pour extraire son contenu.
Une fois l’extraction terminée, double-cliquez sur le fichier Ashigaru-terminal.exe afin de lancer le logiciel.

2. Prendre en main Ashigaru Terminal

Ashigaru Terminal est un logiciel en TUI (Text-based User Interface), c’est-à-dire une interface minimaliste fonctionnant directement dans le terminal. Vous y interagissez à l’aide de menus et de raccourcis clavier, mais sans véritable environnement graphique classique.
Son utilisation est assez simple : utilisez les flèches directionnelles de votre clavier pour naviguer dans les menus, et appuyez sur la touche Enter pour valider une action ou confirmer un choix.

3. Connecter son nœud à Ashigaru Terminal

Par défaut, Ashigaru Terminal se connecte à un serveur Electrum public. Cela présente évidemment des risques en matière de confidentialité et de souveraineté. Nous allons donc le configurer pour qu’il se connecte directement à votre propre Electrum Server.
Pour ce faire, ouvrez le menu Preferences > Server.
Cliquez sur le bouton < Edit >.
Sélectionnez Private Electrum Server, puis cliquez sur <Continue>.
Saisissez l’URL et le port de votre serveur. Vous pouvez indiquer une adresse Tor en .onion. Cliquez ensuite sur < Test > pour vérifier la connexion.
Si la connexion est réussie, le message Success apparaîtra, accompagné des détails de votre serveur.
Si vous n'avez pas encore de nœud Bitcoin, je vous conseille de suivre cette formation :
Dans mon cas, pour ce tutoriel, je vais me déconnecter de mon serveur Electrs car je travaille sur testnet. Le fonctionnement reste néanmoins strictement identique sur mainnet.

4. Créer un portefeuille sur Ashigaru Terminal

Maintenant que le logiciel est correctement configuré, nous allons pouvoir y ajouter un portefeuille Bitcoin.
Deux possibilités s’offrent à vous :
  • Vous pouvez créer un nouveau portefeuille à partir de zéro et l’utiliser exclusivement sur Ashigaru Terminal. Dans ce cas, vous devrez ouvrir ce logiciel à chaque fois que vous souhaitez interagir avec votre portefeuille ;
  • Ou bien, vous pouvez importer directement votre portefeuille Ashigaru existant depuis votre téléphone vers Ashigaru Terminal. L’inconvénient de cette méthode est qu’elle réduit légèrement la sécurité de votre configuration, car votre portefeuille est alors exposé à deux environnements à risque au lieu d’un seul. En revanche, elle offre l’avantage de pouvoir laisser Ashigaru Terminal fonctionner en continu pour mixer vos pièces, tout en vous permettant de les dépenser à distance via l’application mobile Ashigaru.
Dans ce tutoriel, nous allons opter pour la seconde méthode. Toutefois, si vous préférez créer un portefeuille entièrement nouveau, la procédure reste identique : la seule différence interviendra lors de la création, où vous devrez sauvegarder votre nouvelle phrase mnémonique et votre nouvelle passphrase.
Notez également qu’Ashigaru Terminal ne permet pas de dépenser directement vos bitcoins. Vous pouvez soit synchroniser le même portefeuille sur Ashigaru Terminal et sur l’application Ashigaru (ce que je vais faire dans ce tutoriel), ou bien sur Sparrow Wallet.
Si vous n’avez pas encore de portefeuille sur l’application Ashigaru, vous pouvez suivre le tutoriel dédié :
Rendez-vous dans le menu Wallets.
Sélectionnez ensuite Create / restore wallet.... L’option Open Wallet... vous permettra d’accéder ultérieurement à un portefeuille déjà enregistré dans Ashigaru Terminal.
Attribuez un nom à votre portefeuille.
Choisissez ensuite le type de portefeuille Hot Wallet.
C’est à cette étape que la procédure diffère en fonction de votre choix initial :
  • Si vous souhaitez créer un nouveau portefeuille à partir de zéro, cliquez sur <Generate New Wallet>, définissez une passphrase BIP39, puis sauvegardez soigneusement votre phrase mnémonique et votre passphrase sur un support physique ;
  • Si vous souhaitez utiliser le même portefeuille que votre application Ashigaru, saisissez directement les 12 mots de votre phrase mnémonique ainsi que votre passphrase BIP39 dans les champs correspondants. Écrivez les mots en minuscules, entiers, dans l'ordre, séparés par un espace, sans chiffre ni caractère supplémentaire.
Une fois cette étape terminée, cliquez sur < Next >.
Remarque : Si vous ne parvenez pas à cliquer sur ce bouton, cela signifie que votre phrase mnémonique est invalide. Vérifiez attentivement qu’aucun mot n’est incorrect ou mal orthographié.
Vous devrez ensuite définir un mot de passe. Celui-ci servira à déverrouiller votre portefeuille sur Ashigaru Terminal et à le protéger contre tout accès physique non autorisé. Il n’intervient pas dans la dérivation cryptographique de vos clés : autrement dit, même sans ce mot de passe, toute personne disposant de votre phrase mnémonique et de votre passphrase pourra restaurer votre portefeuille et accéder à vos bitcoins.
Choisissez un mot de passe long, complexe et aléatoire. Conservez-en une copie en lieu sûr : idéalement sur un support physique ou dans un gestionnaire de mots de passe sécurisé.
Cliquez sur < OK > lorsque vous avez terminé.

5. Utiliser le portefeuille

Vous pouvez ensuite choisir quel compte consulter. Pour l’instant, nous n’avons encore initié aucun mix, nous allons donc accéder au compte Deposit.
Le fonctionnement est ensuite identique à celui de Sparrow, puisque Ashigaru Terminal est un fork de Sparrow Server. Vous retrouverez donc les mêmes menus :
  • Transactions : permet de consulter l’historique des transactions liées à ce compte. Dans mon cas, certaines apparaissent déjà, car j’en avais effectuées avec l’application Ashigaru sur ce même portefeuille.
  • Receive : génère une nouvelle adresse de réception vierge pour mettre des sats sur le compte de dépôt.
  • Addresses : affiche la liste de toutes vos adresses, qu’elles appartiennent à la chaîne interne ou externe de votre compte.
  • UTXOs : répertorie l’ensemble de vos UTXOs disponibles.
  • Settings : donne accès au descriptor de votre portefeuille. Vous pouvez également y consulter votre seed, ajuster le Gap Limit ou encore modifier la date de création de votre portefeuille.
Vous savez désormais comment installer et prendre en main Ashigaru Terminal. Dans le prochain tutoriel, nous verrons comment réaliser des coinjoins avec ce logiciel et comment gérer les fonds en "Postmix".
Cela a-t-il bien fonctionné pour vous ?
7
0

Auteur

Ce tutoriel a été écrit par Loïc Morel

Vous pouvez dire merci en donnant un pourboire au professeur.

Crédits

Ce tutoriel a été relu par LoicPandul & CarlAdm12

2/3Statut de relecture

Même si cette page est dans sa langue d'origine, une relecture humaine est toujours nécessaire pour garantir son exactitude.

Progress: 2/3LoicPandulCarlAdm120 sats
*Les récompenses peuvent varier en fonction du taux de change $

Chaque élément de contenu sur la plateforme est le produit d'un effort collaboratif : chaque leçon, traduction et révision est rendue possible grâce au travail des contributeurs. C'est pour cette raison que nous sommes toujours à la recherche de correcteurs qui peuvent examiner notre contenu dans un grand nombre de langues. Si vous souhaitez participer au processus de relecture, veuillez nous rejoindre dans notre groupe Telegram et consulter notre tutoriel. Nous vous rappelons que ce contenu est open-source - sous licence CC BY-SA - et peut donc être partagé et utilisé librement, à condition que la source originale soit reconnue.