Ashigaru Terminal

Oct 30, 2025

Ashigaru Terminal is the Ashigaru team's adaptation of Sparrow Server, which implements the Whirlpool coinjoin protocol. This software is a continuation of the work begun by Samourai Wallet, in particular on Whirlpool GUI, whose fundamental principles it adopts: self-custody and confidentiality preservation.

This software is a fork of Sparrow Server, modified and optimized for full integration with the Whirlpool ecosystem, the ZeroLink coinjoin protocol originally developed by the Samourai teams.

Ashigaru Terminal operates from a minimalist TUI interface and can be deployed on a personal computer or on a dedicated server. It lets you interact directly with Whirlpool to initiate "Tx0", manage "Deposit", "Premix", "Postmix" and "Badbank" accounts, and perform automatic remixes to reinforce the confidentiality of your parts.

In short, Ashigaru Terminal will be particularly useful if you want to create coinjoins using Whirlpool.

In this first tutorial, I'll take you through the installation and operation of Ashigaru Terminal. A second, more advanced tutorial will then be devoted to the actual creation of coinjoins.

Ashigaru - Whirlpool CoinjoinHow do I make coinjoins on the Ashigaru application?

1. Install Ashigaru Terminal

To install Ashigaru Terminal, you'll need Tor Browser, as the binaries are only distributed via the Tor network. If you haven't already done so, install it on your machine.

1.1. download Ashigaru Terminal

From Tor Browser, go to the releases page of their Git repository to download the latest version of Ashigaru Terminal for your operating system.

ashicodepbnpvslzsl2bz7l2pwrjvajgumgac423pp3y2deprbnzz7id.onion/Ashigaru/Ashigaru-Terminal/releases/

Download the following 2 files for your operating system:

The binary (ashigaru_terminal_v1.0.0_amd64.deb for Debian/Ubuntu, .dmg for macOS or .zip for Windows) ;
The signed hashes file: ashigaru_terminal_v1.0.0_signed_hashes.txt.

1.2. Check Ashigaru Terminal

Before running the software on your device, you need to check its authenticity and integrity. This is an important step, as it prevents you from installing a fraudulent version that could compromise your bitcoins or infect your machine.

Open a new browser tab and go to Keybase verification tool. Paste the contents of the .txt file you've just downloaded into the field provided, then click on the Verify button.

To diversify your sources of verification, you can also compare the message with the one available on the clearnet ashigaru.rs site, in the /download section.

If the signature is valid, Keybase will display a message confirming that the file has been signed by Ashigaru's developers.

You can also click on the ashigarudev profile displayed by Keybase and check that their key fingerprint matches exactly : A138 06B1 FA2A 676B.

If an error appears at this stage, the signature is invalid. In this case, do not install the downloaded software. Start again from the beginning, or ask the community for help before continuing.

Keybase has provided you with the authenticated hash of the application. We'll now check that the hash of the .deb, .zip or .dmg file you've downloaded matches the one validated on Keybase. To do this, go to HASH FILE ONLINE.

Click on the BROWSE... button and select the .deb, .zip or .dmg file downloaded in step 1.1. Then choose the SHA-256 hash function, and click on CALCULATE HASH to generate the hash for your file.

The site will then display the software hash. Compare it with the hash you verified on Keybase.io. If the two match perfectly, the authenticity and integrity check has been successful. You can then use the software.

1.3 Launch Ashigaru Terminal

Debian / Ubuntu

To install the software, run the command :

cd ~/Downloads
sudo apt install ./ashigaru_terminal_v1.0.0_amd64.deb

Modify the order according to the downloaded version.

Then check the installation:

/opt/ashigaru-terminal/bin/Ashigaru-terminal --version

Then launch the software:

/opt/ashigaru-terminal/bin/Ashigaru-terminal

Windows**

Right-click on the .zip file you have downloaded and checked, then select Extract All... to extract its contents.

Once extraction is complete, double-click on the Ashigaru-terminal.exe file to launch the software.

2. Getting started with Ashigaru Terminal

Ashigaru Terminal is a TUI (Text-based User Interface) program, i.e. a minimalist interface running directly in the terminal. You interact with it using menus and keyboard shortcuts, but without any real classic graphic environment.

It's easy to use: use your keyboard's arrow keys to navigate through the menus, and press the Enter key to validate an action or confirm a choice.

3. Connecting your node to Ashigaru Terminal

By default, Ashigaru Terminal connects to a public Electrum server. This obviously presents risks in terms of confidentiality and sovereignty. So we're going to configure it to connect directly to your own Electrum Server.

To do this, open the Preferences > Server menu.

Click on the < Edit > button.

Select Private Electrum Server, then click <Continue>.

Enter the URL and port of your server. You can specify a Tor address in .onion. Then click on < Test > to verify the connection.

If the connection is successful, the message Success will appear, along with details of your server.

If you don't yet have a Bitcoin node, I recommend you take this course:

Setting up your first Bitcoin node

Intermediate

4.7(116)

Understanding, installing, configuring, and using a Bitcoin node

4.7(116)

Setting up your first Bitcoin node

Understanding, installing, configuring, and using a Bitcoin node

In my case, for this tutorial, I'm going to disconnect from my Electrs server because I'm working on testnet. However, operation remains strictly identical on mainnet.

4. Create a wallet on Ashigaru Terminal

Now that the software is correctly configured, we can add a Bitcoin wallet.

You have two options:

You can create a new wallet from scratch and use it exclusively on Ashigaru Terminal. In this case, you will need to open this software each time you wish to interact with your wallet;
Alternatively, you can import your existing Ashigaru wallet directly from your phone into Ashigaru Terminal. The disadvantage of this method is that it slightly reduces the security of your setup, as your wallet is then exposed to two risky environments instead of one. On the other hand, it offers the advantage of being able to leave Ashigaru Terminal running continuously to mix your coins, while allowing you to spend them remotely via the Ashigaru mobile app.

In this tutorial, we'll opt for the second method. However, if you'd prefer to create an entirely new wallet, the procedure remains the same: the only difference will be during creation, when you'll need to save your new mnemonic phrase and your new passphrase.

Note also that Ashigaru Terminal does not allow you to spend your bitcoins directly. You can either synchronize the same wallet on Ashigaru Terminal and the Ashigaru app (which I will do in this tutorial), or on Sparrow Wallet.

If you do not yet have a wallet on the Ashigaru application, you can follow the dedicated tutorial :

AshigaruThe fork from Samourai Wallet to secure, manage and mix your bitcoins

Go to the Wallets menu.

Then select Create / restore wallet.... The Open Wallet... option lets you access a wallet already saved in Ashigaru Terminal at a later date.

Give your wallet a name.

Then choose wallet type Hot Wallet.

It is at this stage that the procedure differs depending on your initial choice:

If you wish to create a new wallet from scratch, click on <Generate New Wallet>, define a passphrase BIP39, then carefully save your mnemonic phrase and your passphrase on a physical medium ;

Back up your mnemonic phraseDiscover best practices for safeguarding your Bitcoin wallet

If you wish to use the same wallet as your Ashigaru application, enter the 12 words of your mnemonic phrase and your passphrase BIP39 directly into the corresponding fields. Write the words in lower case, whole, in order, separated by a space, without numbers or extra characters.

Once this step is complete, click < Next >.

Note: If you can't click this button, your mnemonic phrase is invalid. Check carefully that none of the words are incorrect or misspelled.

You'll then need to set a password. This will be used to unlock your Ashigaru Terminal wallet and protect it against unauthorized physical access. It is not involved in the cryptographic derivation of your keys: in other words, even without this password, anyone with your mnemonic phrase and passphrase will be able to restore your wallet and access your bitcoins.

Choose a long, complex, random password. Keep a copy in a safe place: ideally on a physical medium or in a secure password manager.

Click < OK > when you're finished.

5. Using the wallet

You can then choose which account to access. For the moment, we haven't initiated any mixes, so we'll access the Deposit account.

Operation is then identical to that of Sparrow, since Ashigaru Terminal is a fork of Sparrow Server. You'll find the same menus:

transactions": allows you to consult the history of transactions linked to this account. In my case, some of them already appear, as I had made some with the Ashigaru application on this same wallet.

receive`: generates a new, blank receipt address for placing satss in the deposit account.

addresses`: displays a list of all your addresses, whether they belong to your account's internal or external chain.

UTXOs: lists all your available UTXOs.

Settings: gives access to your wallet descriptor. You can also consult your seed, adjust the Gap Limit or change the creation date of your wallet.

You now know how to install and use Ashigaru Terminal. In the next tutorial, we will see how to perform coinjoins with this software and how to manage funds in "Postmix".

Ashigaru - Whirlpool CoinjoinHow do I make coinjoins on the Ashigaru application?

Did this work well for you?

Author

This tutorial has been written by Loïc Morel

You can say thanks by tipping the professor.

Loïc Morel

7Courses

104Tutorials

I write educational content about Bitcoin.

guidesuser-friendlyhigh-level

Credits

This tutorial has not been proofread yet

0/3Proofreading status

The original content has been translated by AI, but human review is necessary to ensure its accuracy.

2 203 sats1 102 sats551 sats

*Rewards may vary based on the $ exchange rate

Every content on the platform is the result of a collaborative effort: each lesson, translation, and revision is made possible by the work of contributors. For this reason, we are always looking for proofreaders who can review our content in many languages. If you want to participate in the proofreading process, please reach out in our Telegram group and read our tutorial. We remind you that this content is open-source - licensed under CC BY-SA - so it can be freely shared and used, as long as the original source is credited.