Add SLIP-39 mnemonic and seed support

.gitignore

@@ -19,3 +19,8 @@ __pycache__/
 
 # py.test stuff
 .pytest_cache/
+
+# NixOS stuff
+flake.lock
+CLAUDE.md
+.claude

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [v3.7.0](https://github.com/hdwallet-io/python-hdwallet/tree/v3.7.0) (2025-08-20)
+
+[Full Changelog](https://github.com/hdwallet-io/python-hdwallet/compare/v3.6.1...v3.7.0)
+
+**New Additions:**
+
+- Add: SLIP-39 mnemonic and seed support with multi-language wordlist handling
+- Add: Raw entropy support for SLIP-39 seeds
+
+**Enhancements:**
+
+- Improve: SLIP-39 mnemonic implementation and multi-mnemonic handling
+
 ## [v3.6.1](https://github.com/hdwallet-io/python-hdwallet/tree/v3.6.1) (2025-08-04)
 
 [Full Changelog](https://github.com/hdwallet-io/python-hdwallet/compare/v3.6.0...v3.6.1)

CONTRIBUTING.md

@@ -7,7 +7,28 @@ with the owners of this repository before making a change.
 
 ## Development
 
-To get started, just fork this repo, clone it locally, and run:
+### Using Nix (Recommended)
+
+The easiest way to get a complete development environment is to use Nix. This approach provides the correct Python version and all dependencies automatically.
+
+If you have Nix installed, you can get a full development/runtime environment by running:
+
+```
+make nix-venv
+```
+
+This will activate an interactive shell with the Nix environment and Python virtual environment set up.
+
+To run specific commands in the Nix + venv environment, use the pattern `make nix-venv-target`:
+
+```
+make nix-venv-test        # Run tests in Nix + venv environment
+make nix-venv-install     # Install package in Nix + venv environment
+```
+
+### Manual Setup
+
+Alternatively, you can set up the development environment manually. Fork this repo, clone it locally, and run:
 
 ```
 pip install -e .[cli,tests,docs]

MANIFEST.in

@@ -1,9 +1,14 @@
 include LICENSE
 include README.md
 include requirements.txt
+include requirements/cli.txt
+include requirements/tests.txt
+include requirements/docs.txt
+include requirements/dev.txt
 
 recursive-include hdwallet/mnemonics/algorand/wordlist *.txt
 recursive-include hdwallet/mnemonics/bip39/wordlist *.txt
+recursive-include hdwallet/mnemonics/slip39/wordlist *.txt
 recursive-include hdwallet/mnemonics/electrum/v1/wordlist *.txt
 recursive-include hdwallet/mnemonics/electrum/v2/wordlist *.txt
 recursive-include hdwallet/mnemonics/monero/wordlist *.txt

Makefile

@@ -1,18 +1,106 @@
-# Minimal makefile for Sphinx documentation
+# Minimal makefile for Sphinx documentation, Nix and venv
 #
 
+SHELL			:= /bin/bash
+
 # You can set these variables from the command line, and also
 # from the environment for the first two.
-SPHINXOPTS    ?=
-SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = docs
-BUILDDIR      = build
+export SPHINXOPTS	?=
+export SPHINXBUILD	?= sphinx-build
+export SOURCEDIR	= docs
+export BUILDDIR		= build
+
+export PYTHON		?= $(shell python3 --version >/dev/null 2>&1 && echo python3 || echo python )
+
+# Ensure $(PYTHON), $(VENV) are re-evaluated at time of expansion, when target 'python' and 'poetry' are known to be available
+PYTHON_V		= $(shell $(PYTHON) -c "import sys; print('-'.join((('venv' if sys.prefix != sys.base_prefix else next(iter(filter(None,sys.base_prefix.split('/'))))),sys.platform,sys.implementation.cache_tag)))" 2>/dev/null )
+
+export PYTEST		?= $(PYTHON) -m pytest
+export PYTEST_OPTS	?= # -vv --capture=no
+
+
+VERSION			= $(shell $(PYTHON) -c "exec(open('hdwallet/info.py').read()); print(__version__[1:])" )
+WHEEL			= dist/hdwallet-$(VERSION)-py3-none-any.whl
+VENV			= $(CURDIR)-$(VERSION)-$(PYTHON_V)
+
+# Force export of variables that might be set from command line
+export VENV_OPTS	?=
+export NIX_OPTS		?=
 
 # Put it first so that "make" without argument is like "make help".
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
-.PHONY: help Makefile
+.PHONY: help wheel install test analyze types venv Makefile FORCE
+
+
+wheel:			$(WHEEL)
+
+$(WHEEL):		FORCE
+	$(PYTHON) -m build
+	@ls -last dist
+
+# Install from wheel, including all optional extra dependencies (doesn't include dev)
+install:		$(WHEEL) FORCE
+	$(PYTHON) -m pip install --force-reinstall $<[cli,tests,docs]
+
+# Install from requirements/*; eg. install-dev, always getting the latest version
+install-%:  		FORCE
+	$(PYTHON) -m pip install --upgrade -r requirements/$*.txt
+
+
+unit-%:
+	$(PYTEST) $(PYTEST_OPTS) -k $*
+
+test:
+	$(PYTEST) $(PYTEST_OPTS) tests
+
+analyze:
+	$(PYTHON) -m flake8 --color never -j 1 --max-line-length=250 \
+	  --ignore=W503,W504,E201,E202,E223,E226 \
+	  hdwallet
+
+types:
+	mypy .
+
+# 
+# Nix and VirtualEnv build, install and activate
+#
+#     Create, start and run commands in "interactive" shell with a python venv's activate init-file.
+# Doesn't allow recursive creation of a venv with a venv-supplied python.  Alters the bin/activate
+# to include the user's .bashrc (eg. Git prompts, aliases, ...).  Use to run Makefile targets in a
+# proper context, for example to obtain a Nix environment containing the proper Python version,
+# create a python venv with the current Python environment.
+#
+#     make nix-venv-build
+#
+nix-%:
+	@if [ -r flake.nix ]; then \
+	    nix develop $(NIX_OPTS) --command make $*; \
+        else \
+	    nix-shell $(NIX_OPTS) --run "make $*"; \
+	fi
+
+venv-%:			$(VENV)
+	@echo; echo "*** Running in $< VirtualEnv: make $*"
+	@bash --init-file $</bin/activate -ic "make $*"
+
+venv:			$(VENV)
+	@echo; echo "*** Activating $< VirtualEnv for Interactive $(SHELL)"
+	@bash --init-file $</bin/activate -i
+
+$(VENV):
+	@[[ "$(PYTHON_V)" =~ "^venv" ]] && ( echo -e "\n\n!!! $@ Cannot start a venv within a venv"; false ) || true
+	@echo; echo "*** Building $@ VirtualEnv..."
+	@rm -rf $@ && $(PYTHON) -m venv $(VENV_OPTS) $@ && sed -i -e '1s:^:. $$HOME/.bashrc\n:' $@/bin/activate \
+	    && source $@/bin/activate \
+	    && make install-dev install
+
+print-%:
+	@echo $* = $($*)
+	@echo $*\'s origin is $(origin $*)
+
+
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).

README.md

@@ -16,9 +16,9 @@ Python-based library implementing a Hierarchical Deterministic (HD) Wallet gener
 | Features                      | Protocols                                                                                                                                                                                                                                                                                                                                           |
 |:------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Cryptocurrencies              | <a href="https://hdwallet.io/cryptocurrencies">#supported-cryptocurrencies</a>                                                                                                                                                                                                                                                                      |
-| Entropies                     | `Algorand`, `BIP39`, `Electrum-V1`, `Electrum-V2`, `Monero`                                                                                                                                                                                                                                                                                         |
-| Mnemonics                     | `Algorand`, `BIP39`, `Electrum-V1`, `Electrum-V2`, `Monero`                                                                                                                                                                                                                                                                                         |
-| Seeds                         | `Algorand`, `BIP39`, `Cardano`, `Electrum-V1`, `Electrum-V2`, `Monero`                                                                                                                                                                                                                                                                              |
+| Entropies                     | `Algorand`, `BIP39`, `SLIP39`, `Electrum-V1`, `Electrum-V2`, `Monero`                                                                                                                                                                                                                                                                               |
+| Mnemonics                     | `Algorand`, `BIP39`, `SLIP39`, `Electrum-V1`, `Electrum-V2`, `Monero`                                                                                                                                                                                                                                                                               |
+| Seeds                         | `Algorand`, `BIP39`, `SLIP39`, `Cardano`, `Electrum-V1`, `Electrum-V2`, `Monero`                                                                                                                                                                                                                                                                    |
 | Elliptic Curve Cryptography's | `Kholaw-Ed25519`, `SLIP10-Ed25519`, `SLIP10-Ed25519-Blake2b`, `SLIP10-Ed25519-Monero`, `SLIP10-Nist256p1`, `SLIP10-Secp256k1`                                                                                                                                                                                                                       |
 | Hierarchical Deterministic's  | `Algorand`, `BIP32`, `BIP44`, `BIP49`, `BIP84`, `BIP86`, `BIP141`, `Cardano`, `Electrum-V1`, `Electrum-V2`, `Monero`                                                                                                                                                                                                                                |
 | Derivations                   | `BIP44`, `BIP49`, `BIP84`, `BIP86`, `CIP1852`, `Custom`, `Electrum`, `Monero`, `HDW (Our own custom derivation)`                                                                                                                                                                                                                                    |

default.nix

@@ -0,0 +1,92 @@
+{ pkgs ? import ./nixpkgs.nix {} }:
+
+with pkgs;
+
+let
+in
+{
+  py314 = stdenv.mkDerivation rec {
+    name = "python314-with-poetry";
+
+    buildInputs = [
+      cacert
+      git
+      gnumake
+      openssh
+      python314
+      python314Packages.pytest
+      python314Packages.coincurve
+      python314Packages.scikitlearn
+      python314Packages.pycryptodome
+      python314Packages.pynacl
+    ];
+  };
+
+  py313 = stdenv.mkDerivation rec {
+    name = "python313-with-poetry";
+
+    buildInputs = [
+      cacert
+      git
+      gnumake
+      openssh
+      python313
+      python313Packages.pytest
+      python313Packages.coincurve
+      python313Packages.scikitlearn
+      python313Packages.pycryptodome
+      python313Packages.pynacl
+    ];
+  };
+
+  py312 = stdenv.mkDerivation rec {
+    name = "python312-with-poetry";
+
+    buildInputs = [
+      cacert
+      git
+      gnumake
+      openssh
+      python312
+      python312Packages.pytest
+      python312Packages.coincurve
+      python312Packages.scikitlearn
+      python312Packages.pycryptodome
+      python312Packages.pynacl
+    ];
+  };
+
+  py311 = stdenv.mkDerivation rec {
+    name = "python311-with-poetry";
+
+    buildInputs = [
+      cacert
+      git
+      gnumake
+      openssh
+      python311
+      python311Packages.pytest
+      python311Packages.coincurve
+      python311Packages.scikitlearn
+      python311Packages.pycryptodome
+      python311Packages.pynacl
+    ];
+  };
+
+  py310 = stdenv.mkDerivation rec {
+    name = "python310-with-poetry";
+
+    buildInputs = [
+      cacert
+      git
+      gnumake
+      openssh
+      python310
+      python310Packages.pytest
+      python310Packages.coincurve
+      python310Packages.scikitlearn
+      python310Packages.pycryptodome
+      python310Packages.pynacl
+    ];
+  };
+}

examples/hdwallet/bips/from_entropy.py

@@ -5,7 +5,7 @@
     BIP39Entropy, BIP39_ENTROPY_STRENGTHS
 )
 from hdwallet.mnemonics import BIP39_MNEMONIC_LANGUAGES
-from hdwallet.cryptocurrencies import Qtum as Cryptocurrency
+from hdwallet.cryptocurrencies import Bitcoin as Cryptocurrency
 from hdwallet.consts import PUBLIC_KEY_TYPES
 from hdwallet.derivations import (
     BIP44Derivation, CHANGES