Begin working toward licensing

o Add anonymous flag for avoiding public crypto addresses on cards
o Improved sizing/layout of 256-bit SLIP-39 mnemonics
o Begin moving custom Exceptions to slip39/exceptions

Author: pjkundert

README.org

@@ -437,11 +437,11 @@ slip39 --help 2>&1                | sed 's/^/: /' # (just for output formatting)
     :               [-c CRYPTOCURRENCY] [-p PATH] [-j JSON] [-w WALLET]
     :               [--wallet-hint WALLET_HINT] [--wallet-format WALLET_FORMAT]
     :               [-s SECRET] [-e ENTROPY] [--show] [--no-show] [--bits BITS]
-    :               [--using-bip39] [--passphrase PASSPHRASE] [-C CARD] [--no-card]
-    :               [--paper PAPER] [--cover] [--no-cover] [--identifier IDENTIFIER]
-    :               [--extendable] [--no-extendable] [--text]
-    :               [--watermark WATERMARK] [--double-sided] [--no-double-sided]
-    :               [--single-sided]
+    :               [--using-bip39] [--anonymous] [--passphrase PASSPHRASE]
+    :               [-C CARD] [--no-card] [--paper PAPER] [--cover] [--no-cover]
+    :               [--identifier IDENTIFIER] [--extendable] [--no-extendable]
+    :               [--text] [--watermark WATERMARK] [--double-sided]
+    :               [--no-double-sided] [--single-sided]
     :               [names ...]
     : 
     : Create and output SLIP-39 encoded Seeds and Paper Wallets to a PDF file.
@@ -504,6 +504,8 @@ slip39 --help 2>&1                | sed 's/^/: /' # (just for output formatting)
     :   --using-bip39         Generate Seed from secret Entropy using BIP-39
     :                         generation algorithm (encode as BIP-39 Mnemonics,
     :                         encrypted using --passphrase)
+    :   --anonymous           SLIP-39 mnemonic cards include cryptocurrency public
+    :                         addresses and QR codes (default: False)
     :   --passphrase PASSPHRASE
     :                         Encrypt the master secret w/ this passphrase, '-'
     :                         reads it from stdin (default: None/'')
@@ -1173,6 +1175,7 @@ create_details      = slip39.create(
     | groups          | Like groups, w/ <members> =  ["<mnemonics>", ...]                   |
     | accounts        | Resultant { "path": Account, ...}                                   |
     | using_bip39     | Generate Seed from Entropy via BIP-39 generation algorithm          |
+    | anonymous       | Avoid including cryptocurrency public addresses and QR codes        |
     | card_format     | 'index', '(<h>,<w>),<margin>', ...                                  |
     | paper_format    | 'Letter', ...                                                       |
     | orientation     | Force an orientation (default: portrait, landscape)                 |
@@ -1212,6 +1215,7 @@ pdf_binary = pdf.output()
     | master_secret   | A Seed secret (only appropriate if exactly one name supplied)                                         |
     | passphrase      | A SLIP-39 passphrase (not Trezor compatible; use "hidden wallet" phrase on device instead)            |
     | using_bip39     | Generate Seed from Entropy via BIP-39 generation algorithm                                            |
+    | anonymous       | Avoid including cryptocurrency public addresses and QR codes                                          |
     | group           | A dict of {"<group>":(<required>, <members>), ...}                                                    |
     | group_threshold | How many groups are required to recover the Seed                                                      |
     | cryptocurrency  | A sequence of [ "<crypto>", "<crypto>:<derivation>", ... ] w/ optional ranges                         |

README.pdf

@@ -56,6 +56,9 @@
 QUARTER_LETTER			= (10.5/4,7+3/4), 1/8   # noqa: E241 (actually 4/letter, 5/legal)
 PHOTO_CARD			= (3+1/2, 5+1/2), 1/16  # prints on 4x6 photo paper w/ 1/4" default outer border
 
+# Whether we should avoid printing Cryptocurrency addresses, QR codes
+ANONYMOUS			= False
+
 # SLIP-39 Mnemonic Card Sizes
 CARD				= 'business'
 CARD_SIZES			= dict(
@@ -110,7 +113,7 @@
 
 MNEM_ROWS_COLS			= {
     20:	( 7, 3),		# 128-bit seed
-    33:	(11, 3),		# 256-bit seed
+    33:	( 9, 4),		# 256-bit seed
     59:	(12, 5),		# 512-bit seed, eg. from BIP-39 (Unsupported on Trezor)
 }
 

README.txt

@@ -0,0 +1,27 @@
+
+#
+# Python-slip39 -- Ethereum SLIP-39 Account Generation and Recovery
+#
+# Copyright (c) 2025, Dominion Research & Development Corp.
+#
+# Python-slip39 is free software: you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free Software
+# Foundation, either version 3 of the License, or (at your option) any later
+# version.  It is also available under alternative (eg. Commercial) licenses, at
+# your option.  See the LICENSE file at the top of the source tree.
+#
+# Python-slip39 is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+#
+
+from hdwallet.exceptions import SymbolError
+
+
+class SLIP39Error( Exception ):
+    pass
+
+
+class ConversionError( SLIP39Error ):
+    pass
+

images/SLIP39-Example.pdf

@@ -0,0 +1,15 @@
+#+title: Anonymous
+#+OPTIONS: toc:nil title:nil author:nil
+
+#+BEGIN_ABSTRACT
+If you prefer your SLIP-39 cards to NOT include your Cryptocurrency public addresses and their QR
+codes, select Anonymous.
+#+END_ABSTRACT
+
+* Anonymous
+
+SLIP-39 Cards Mnemonics will be larger, covering the area where the QR codes would have appeared.
+
+** Paper Wallets
+
+If Cryptocurrency "Paper Wallet" are printed, they will of course include public address information.

slip39/defaults.py

@@ -0,0 +1,16 @@
+If you prefer your SLIP-39 cards to NOT include your Cryptocurrency
+public addresses and their QR codes, select Anonymous.
+
+
+1 Anonymous
+═══════════
+
+  SLIP-39 Cards Mnemonics will be larger, covering the area where the QR
+  codes would have appeared.
+
+
+1.1 Paper Wallets
+─────────────────
+
+  If Cryptocurrency "Paper Wallet" are printed, they will of course
+  include public address information.

slip39/exceptions.py

@@ -14,7 +14,7 @@ compatible) displayed are:
                     SegWit    m/49'/  2'/0'/0/0  M…               
                     Legacy    m/44'/  2'/0'/0/0  L…               
  Recover    DOGE    Legacy    m/44'/  3'/0'/0/0  D…               
- Pro        BSC     Legacy    m/44'/ 60'/0'/0/0  0x…      Beta    
+ Pro        BNB     Legacy    m/44'/714'/0'/0/0  0x…      Beta    
  Pro        XRP     Legacy    m/44'/144'/0'/0/0  r…               
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -35,6 +35,6 @@ are derived from this Seed.
 2 Cryptocurrencies In Beta Testing
 ══════════════════════════════════
 
-  XRP and BSC wallet addresses are also supported, if desired (currently
+  XRP and BNB wallet addresses are also supported, if desired (currently
   in Beta testing quality).  Generated Paper Wallets should be /tested/
   to ensure that generated and recovered private keys are valid.

slip39/gui/SLIP-39-ANONYMOUS.org

@@ -7,7 +7,6 @@ often makes the Seed unrecoverable, because the Passphrase can be so easily lost
 
 SLIP-39 Mnemonic Card Groups are *much* more reliable (to recover) and secure (against accidental
 disclosure); a Passphrase is *not* recommended.  Leave it empty!
-
 #+END_ABSTRACT
 
 * BIP-39 Passphrase