Update README formatting

Author: pjkundert

README.org

@@ -1,4 +1,4 @@
-#+title: Ethereum SLIP-39 Account Generation
+#+title: SLIP-39 Wallet "Seed" Generation & Backup
 #+author: Perry Kundert
 #+email: [email protected]
 #+date: 2021-12-20 10:55:00
@@ -26,47 +26,57 @@ nil
 #+BEGIN_ABSTRACT
 Creating Ethereum, Bitcoin and other accounts is complex and fraught with potential for loss of funds.
 
-A BIP-39 seed recovery phrase helps, but a *single* lapse in security dooms the account (and all
-derived accounts, in fact).  If someone finds your recovery phrase (or you lose it), the accounts
-derived from that seed are /gone/.
+A 12- or 24-word BIP-39 seed recovery Mmnemonic Phrase helps, but a *single* lapse in security dooms
+the account (and all derived accounts, in fact).  If someone finds your recovery phrase (or you lose
+it), the accounts derived from that seed are /gone/.
 
 The SLIP-39 standard allows you to split the seed between 1, 2, or more groups of several mnemonic
 recovery phrases.  This is better, but creating such accounts is difficult; presently, only the
-Trezor supports these, and they can only be created "manually".  Writing down 5 or more sets of 20
-words is difficult, error-prone and time consuming.
-
-The [[https://github.com/pjkundert/python-slip39.git][python-slip39]] project (and the [[https://slip39.com/app][SLIP-39 macOS/win32 App]]) exists to assist in the safe creation
-and documentation of [[https://wolovim.medium.com/ethereum-201-hd-wallets-11d0c93c87][Hierarchical Deterministic (HD) Wallet]] seeds and derived accounts, with
-various SLIP-39 sharing parameters.  It generates the new random wallet seed, and generates the
-expected standard Ethereum account(s) (at [[https://medium.com/myetherwallet/hd-wallets-and-derivation-paths-explained-865a643c7bf2][derivation path]] =m/44'/60'/0'/0/0= by default) and Bitcoin
-accounts (at Bech32 derivation path =m/84'/0'/0'/0/0= by default), with wallet address and QR code
-(compatible with Trezor and Ledger derivations).  It produces the required SLIP-39 phrases, and outputs a
-single PDF containing all the required printable cards to document the seed (and the specified
-derived accounts).
-
-Output of BIP-38 or JSON encrypted Paper Wallets is supported, for import into standard software
-cryptocurrency wallets.
-
-On an secure (ideally air-gapped) computer, new seeds can safely be generated and the PDF saved to a
-USB drive for printing (or directly printed without the file being saved to disk.).  Presently,
-=slip39= can output example ETH, BTC, LTC, DOGE, BNB, CRO and XRP addresses derived from the seed,
-to /illustrate/ what accounts are associated with the backed-up seed.  Recovery of the seed to a
-[[https://shop.trezor.io/product/trezor-model-t?offer_id=15&aff_id=10388][Trezor "Model T"]] is simple, by entering the mnemonics right on the device.
-
-We also support backup of existing insecure and unreliable BIP-39 Seed Phrases as SLIP-39 Mnemonic
-cards, for existing BIP-39 hardware wallets like the [[https://shop.ledger.com/pages/ledger-nano-x?r=2cd1cb6ae51f][Ledger Nano]], etc.!  Recover from your existing
-BIP-39 Seed Phrase Mnemonic, select "Using BIP-39" (and enter your BIP-39 passphrase), and generate
-a set of SLIP-39 Mnemonic cards.  Later, use the SLIP-39 App to recover from your SLIP-39 Mnemonic
-cards, click "Using BIP-39" to get your BIP-39 Mnemonic back, and use it (and your passphrase) to
-recover your accounts to your Ledger (or other) hardware wallet.
+Trezor supports these directly, and they can only be created "manually".  Writing down 5 or more
+sets of 20 words is difficult, error-prone and time consuming.
 #+END_ABSTRACT
 
 #+TOC: headlines 3
 
+* Hardware Wallet "Seed" Configuration
+
+  #+BEGIN_QUOTE
+  Your keys, your Bitcoin.  Not your keys, not your Bitcoin.
+  
+  ---Andreas Antonopoulos
+  #+END_QUOTE
+
+  The [[https://github.com/pjkundert/python-slip39.git][python-slip39]] project (and the [[https://slip39.com/app][SLIP-39 macOS/win32 App]]) exists to assist in the safe creation,
+  backup and documentation of [[https://wolovim.medium.com/ethereum-201-hd-wallets-11d0c93c87][Hierarchical Deterministic (HD) Wallet]] seeds and derived accounts,
+  with various SLIP-39 sharing parameters.  It generates the new random wallet seed, and generates
+  the expected standard Ethereum account(s) (at [[https://medium.com/myetherwallet/hd-wallets-and-derivation-paths-explained-865a643c7bf2][derivation path]] *m/44'/60'/0'/0/0* by default) and
+  Bitcoin accounts (at Bech32 derivation path *m/84'/0'/0'/0/0* by default), with wallet address and
+  QR code (compatible with Trezor and Ledger derivations).  It produces the required SLIP-39
+  phrases, and outputs a single PDF containing all the required printable cards to document the seed
+  (and the specified derived accounts).
+
+  On an secure (ideally air-gapped) computer, new seeds can /safely/ be generated (*without*
+  trusting this program) and the PDF saved to a USB drive for printing (or directly printed without
+  the file being saved to disk.).  Presently, =slip39= can output example ETH, BTC, LTC, DOGE, BNB,
+  CRO and XRP addresses derived from the seed, to /illustrate/ what accounts are associated with the
+  backed-up seed.  Recovery of the seed to a [[https://shop.trezor.io/product/trezor-model-t?offer_id=15&aff_id=10388][Trezor "Model T"]] is simple, by entering the mnemonics
+  right on the device.
+
+  We also support the backup of existing insecure and unreliable 12- or 24-word BIP-39 Mnemonic
+  Phrases as SLIP-39 Mnemonic cards, for existing BIP-39 hardware wallets like the [[https://shop.ledger.com/pages/ledger-nano-x?r=2cd1cb6ae51f][Ledger Nano]],
+  etc.!  Recover from your existing BIP-39 Seed Phrase Mnemonic, select "Using BIP-39" (and enter
+  your BIP-39 passphrase), and generate a set of SLIP-39 Mnemonic cards.  Later, use the SLIP-39 App
+  to recover from your SLIP-39 Mnemonic cards, click "Using BIP-39" to get your BIP-39 Mnemonic
+  back, and use it (and your passphrase) to recover your accounts to your Ledger (or other) hardware
+  wallet.
+
+  Output of BIP-38 or JSON encrypted Paper Wallets is also supported, for import into standard
+  software cryptocurrency wallets.
+
 * Security with Availability
 
   For both BIP-39 and SLIP-39, a 128- or 256-bit random "seed" is the source of an unlimited
-  sequence of Ethereum and Bitcoin HD (Heirarchical Deterministic) derived Wallet accounts.  Anyone
+  sequence of Ethereum and Bitcoin Heirarchical Deterministic (HD) derived Wallet accounts.  Anyone
   who can obtain this seed gains control of all Ethereum, Bitcoin (and other) accounts derived from
   it, so it must be securely stored.
 
@@ -212,9 +222,9 @@ recover your accounts to your Ledger (or other) hardware wallet.
     #+LATEX: {\scriptsize
     #+BEGIN_SRC bash :exports both :results output
     slip39-recovery -v \
-	--mnemonic "material leaf acrobat romp charity capital omit skunk change firm eclipse crush fancy best tracks flip grownup plastic chew peanut" \
+        --mnemonic "material leaf acrobat romp charity capital omit skunk change firm eclipse crush fancy best tracks flip grownup plastic chew peanut" \
         --mnemonic "material leaf beard romp disaster duke flame uncover group slice guest blue gums duckling total suitable trust guitar payment platform" \
-	2>&1
+            2>&1
     #+END_SRC
 
     #+RESULTS:
@@ -230,11 +240,11 @@ recover your accounts to your Ledger (or other) hardware wallet.
     #+LATEX: {\scriptsize
     #+BEGIN_SRC bash :exports both :results output
     slip39-recovery \
-	--mnemonic "material leaf acrobat romp charity capital omit skunk change firm eclipse crush fancy best tracks flip grownup plastic chew peanut" \
+        --mnemonic "material leaf acrobat romp charity capital omit skunk change firm eclipse crush fancy best tracks flip grownup plastic chew peanut" \
         --mnemonic "material leaf beard romp disaster duke flame uncover group slice guest blue gums duckling total suitable trust guitar payment platform" \
     | slip39 -c ETH -c BTC -c DOGE -c LTC --secret - \
         --no-card --wallet password --wallet-hint 'bad:pass...' \
-	2>&1
+            2>&1
     #+END_SRC
 
     #+RESULTS:
@@ -728,9 +738,9 @@ recover your accounts to your Ledger (or other) hardware wallet.
     ( python3 -m slip39.recovery --bip39 --mnemonic 'zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo wrong' \
         | python3 -m slip39.generator --secret - --xpub --path "../-2'"  --encrypt 'password' \
         | python3 -m slip39.generator -v --receive --decrypt 'password' \
-	| while IFS=':' read num json; do \
-	    echo "--- $(( num ))"; \
-	    echo "$json" | jq -c '.[]'; \
+        | while IFS=':' read num json; do \
+            echo "--- $(( num ))"; \
+            echo "$json" | jq -c '.[]'; \
         done \
     ) 2>&1
     #+END_SRC
@@ -759,11 +769,11 @@ recover your accounts to your Ledger (or other) hardware wallet.
     ( python3 -m slip39.recovery --bip39 --mnemonic 'zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo wrong' \
         | python3 -m slip39.generator --secret - --xpub --path "../-2'"  --encrypt 'password' \
         | python3 -m slip39.generator -v --receive --decrypt 'password' \
-	| while IFS=':' read num json; do \
-	    echo "--- $(( num ))"; \
-	    echo "$json" | jq -cr '.[]|"--crypto " + .[0] + " --secret " + .[2]' | while read command; do \
-		python3 -m slip39.cli -v --no-json addresses $command --paths m/0/-2; \
-	    done; \
+        | while IFS=':' read num json; do \
+            echo "--- $(( num ))"; \
+            echo "$json" | jq -cr '.[]|"--crypto " + .[0] + " --secret " + .[2]' | while read command; do \
+                python3 -m slip39.cli -v --no-json addresses $command --paths m/0/-2; \
+            done; \
         done \
     ) 2>&1
     #+END_SRC