sec_₿sec.21ideas.org
cashu nutshell · Cashu / Nutshell
Patch availableNode operatorsMerchants and infrastructure3 November 2026

Nutshell 0.22.0 released with security fixes for mint accounting, authentication and seed handling

Nutshell 0.22.0 includes, per the release notes, security fixes and hardening across mint accounting, authentication, seed handling, logging and request validation. The notes do not describe the individual defects or whether they are exploitable. The release also includes mint database migrations, BIP-39 mint seed support via MINT_MNEMONIC (MINT_PRIVATE_KEY is deprecated but still supported), in-memory response caching without Redis, and changes to Lightning payment handling. A patch is available.

Actions to take

Mint operators running Nutshell without these fixes: back up your databases and stop all older mint workers before upgrading. Spark operators should reconcile existing pending payments before upgrading. After upgrading, if you use legacy keysets with MINT_SEED_DECRYPTION_KEY, re-run the seed encryption migration as described in the release notes. For pip/pipx installs, Python 3.12 is recommended. If you set MINT_MNEMONIC, keep a secure backup of it; existing keysets are not rotated automatically, and each unit moves over through an explicit rotation. Installations that are already updated need no action.