Cashu Nutshell is a free, open-source wallet and mint for Cashu, an ecash protocol that moves digital money over the Bitcoin Lightning Network. It is written in Python and aimed at developers, node operators and hobbyists who want to experiment with private, bearer-style tokens instead of balances tied to a single account. The project ships as a command-line wallet, a mint server and a Python library, so it suits people comfortable working in a terminal. Windows is listed among its supported platforms, alongside Linux and Docker.
Cashu works differently from a typical Lightning wallet. Instead of holding a channel balance, a wallet holds ecash tokens issued by a mint, and the blinding scheme is designed so the mint cannot easily link issuance to later redemption. Nutshell covers both sides of that system: you can run a mint that issues tokens backed by Bitcoin, or use the wallet to hold and send them. The codebase has been updated recently, and the latest release is version 0.21.0.
What Is Ecash and Why Does It Matter?
Ecash is digital cash in which a bank or issuer signs tokens that can be passed between people. In the Cashu design, a mint issues these tokens against Bitcoin it holds, and the holder can later redeem them through Lightning. The key idea is blinding: the mint signs a token without seeing its final value in a form it can trace back to the holder.
That design differs from most Lightning wallets, which manage payment channels or route through a node. With ecash, many small payments can happen inside the wallet without opening a channel for each one. The tradeoff is trust in the mint, because the mint is the party holding the underlying Bitcoin.
For newcomers, it helps to think of a mint as a shared vault that issues receipts. The receipts are the tokens you hold, and the vault's promise to redeem them is what gives them value. Understanding that relationship is the first step to using Nutshell sensibly.
Who Cashu Nutshell Is For
Nutshell fits people who already have some comfort with Bitcoin and Lightning concepts. Developers who want to build ecash features into an app will find the Python library useful, and node operators who want to run a mint for a community will find the mint server relevant. Hobbyists who enjoy testing new protocols also tend to get the most out of it.
It is less suited to someone looking for a polished graphical app with one-click setup. The main interface is a command-line wallet, and getting comfortable with seed phrases, mint URLs and configuration files takes some practice. Readers who want a simple desktop wallet may prefer a different tool from the list at the end of this page.
If you are unsure, start by using the wallet with a small amount you can afford to lose. That approach lets you learn how tokens move between a wallet and a mint before you rely on the system for anything important.
Practical Scenarios for Ecash Payments
Consider a small online community that wants to reward members with tiny amounts of value. A mint operated by the community can issue tokens, and members can hold them in a Nutshell wallet and pass them along. Because each token is a bearer instrument, the exchange does not need to create an account for every participant.
Another scenario is a developer testing a Lightning app. They can run a local mint, connect it to a Lightning backend on a test network and watch how tokens are issued and redeemed. The PostgreSQL and SQLite options make it easy to match the setup to the size of the test.
A third case involves privacy-conscious users who want to avoid linking every payment to a single identity. The Tor support and multi-mint wallet give them more control, although the privacy of any ecash system depends on how each mint is run and how tokens are handled. No setup removes all trade-offs.
Key features
Lightning Network payments
Full Cashu protocol support
Standalone CLI wallet and mint server
Reusable Python library
PostgreSQL and SQLite storage
Built-in Tor support
Multiple mints in one wallet
Deterministic seed phrase backup
Programmable ecash
Offline verification and caching
Supported coins
The project's documentation points to Bitcoin (BTC) as the underlying asset, with payments handled over the Lightning Network. Nutshell connects to Lightning backends such as LND and Core Lightning, which means its ecash flows depend on those node implementations being available and running.
How to install Cashu Nutshell on Windows
- 1
Get the program from the official source
Download only from the official website or the project's GitHub Releases page at github.com/cashubtc/nutshell. Avoid mirrors, forum links and ads, since a modified installer can carry malware.
- 2
Check the release version
Confirm that you are looking at the current release, version 0.21.0 at the time of writing. Read the release notes for any Windows-specific files or changes that affect the installation.
- 3
Verify the file before running it
Calculate the SHA-256 checksum of the downloaded file using a tool such as PowerShell's Get-FileHash, and compare the result with the value published on the release page. If a signature file is provided, verify it as well before you open anything.
-
Install and launch
Run the installer or extract the archive into a folder you control, then launch the wallet from a terminal. When the wallet creates a seed phrase, write it down on paper and store it offline before you deposit anything.
How to use Cashu Nutshell
Using Nutshell is mostly a matter of opening the wallet, connecting it to a mint and understanding how tokens move between the two. The steps below assume you have already installed the program and verified the download.
- Open a terminal in the program folder and start the wallet.
- Review the command list so you know which actions create, send and redeem tokens.
- Add a mint by entering its URL, and check that the mint's details match the operator you expect.
- Fund your wallet by creating a Lightning invoice through the mint, then pay it from another wallet.
- Once the payment settles, confirm that the balance appears in your wallet.
- To send value, create a token from your balance and share it with the recipient, who redeems it in their own wallet.
- Back up your seed phrase after your first deposit, and test a restore on a separate machine when you can.
Start with small amounts while you learn the workflow. Keep track of which mint holds each balance, because a wallet with several mints requires you to manage each one separately.
Pros & cons
- Free and open source, with the code publicly available on GitHub
- Covers both the wallet and the mint server in one project
- Python library lets developers reuse wallet and mint logic
- Supports several storage options, including PostgreSQL and SQLite
- Includes built-in Tor support and multi-mint wallets
- Implements a broad set of Cashu protocol specifications
- The main interface is a command-line tool, which can be hard for beginners
- Using ecash means trusting the mint that holds the underlying Bitcoin
- Running a mint requires a working Lightning backend such as LND or CLN
- Documentation is aimed at technical readers, so newcomers may need extra time
Is Cashu Nutshell safe?
Nutshell handles real value, so treat the download and setup with care. Get the program only from the official website or the project's GitHub repository, and compare the SHA-256 checksum or signature with the value published by the maintainers before you run the file. Never enter your seed phrase on a third-party website, in a chat message or in a form that asks for it, because anyone who has those words can control your ecash.
The mint you choose is also a risk. Its operator holds the Bitcoin behind your tokens, so use mints you have reason to trust and avoid keeping large balances with any single one. Ecash is not a guaranteed savings product, and a software bug or a failing mint can cost you funds. Keep backups and check the project's latest release notes regularly.
- Official source only. Download from github.com/cashubtc/nutshell. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
Nutshell differs from most of the similar programs on this list because it is built around ecash tokens rather than a single channel-based balance. Polar is designed for building local Lightning test networks, so it suits developers who need a sandbox, while Nutshell is the program to use when you want to issue and hold ecash. Peach is a free cross-platform desktop Lightning wallet focused on micro payments, which makes it a more familiar choice for everyday users who want a graphical app. Spark Wallet offers a minimal interface for c-lightning and comes in web, mobile and desktop versions. Zap Desktop is no longer supported, so it is best avoided for new setups. Choose Nutshell if you want the ecash model and are comfortable with a terminal.
Specifications
- Price
- Free
- Type
- Open source
- License
- —
- Latest version
- 0.21.0
- Last update
- 30 Oct 2026
- Windows support
- Likely (builds for Windows; check releases)
- Source code
- github.com/cashubtc/nutshell
Frequently asked questions
Cashu Nutshell can be used safely when you download it from the official source, verify the SHA-256 checksum or signature, and keep your seed phrase offline. The bigger risk is the mint, since its operator holds the Bitcoin behind your tokens. Use mints you trust and avoid keeping large balances with one operator.
Yes, Cashu Nutshell is free and open source, and its code is publicly available on GitHub. You do not pay to download or use the wallet or the library. Any costs you incur would come from running your own infrastructure, such as a server or a Lightning node, if you choose to operate a mint.
Windows is listed as one of the platforms the project supports, alongside Linux and Docker. Check the GitHub Releases page for the current Windows files and release notes before installing. If a Windows build is not available for the version you want, the project's documentation explains the general setup steps.
The seed phrase lets Nutshell derive the wallet's keys deterministically, so a single written backup can restore your ecash after a lost device or reinstallation. Store it offline on paper and never type it into a website or app you do not fully trust. Anyone who has the seed phrase can access the funds it controls.
Nutshell is built around Bitcoin (BTC) and the Lightning Network. Its ecash tokens are issued by mints backed by Bitcoin, and payments flow through Lightning backends such as LND and Core Lightning. It does not add support for other coins in the wallet itself.
Yes, you can use the wallet to hold and send tokens from mints run by other operators. Running your own mint is optional and mainly relevant for developers or community operators. Using an existing mint is simpler, but you should still choose operators carefully because they hold the underlying funds.
Verdict
Cashu Nutshell suits developers, node operators and technically confident users who want to work with Cashu ecash on Windows, Linux or Docker. It is free, open source and covers the wallet, the mint server and a Python library in one project. It is not a good fit for someone who wants a polished graphical app with minimal setup. Before using it with real funds, verify the download, back up your seed phrase and choose your mints carefully.