aboutsummaryrefslogblamecommitdiff
path: root/README.rst
blob: 7a6670b8d3c1da8b442f3dbe2201265ccd17a341 (plain) (tree)
1
2
3
4
5
6
7
8
9
10
11

          
 
                                 
                         





                                                                                                                                                                                                      
                                                                               
                                                                              
         
                                                                                                       
                                                                             
                                                                  




                                                                            







                                                                              



               
                                                                     
keytree.py
==========

- Make sure you have Python = 3.9
- CD into the cloned repo

Examples
--------
- Derive 10 keys from a given mnemonic: ``./keytree.py --end-idx 10``
- Generate a new mnemonic, print 10 derived addresses from it, then also save the mnemonic to an encrypted keystore file: ``./keytree.py --end-idx 10 --gen-mnemonic --save-keystore mykeystore.json``
- Load the mnemonic from an existing keystore file: ``./keytree.py --load-keystore mykeystore.json``
- To see all private keys and the mnemonic phrase, use ``--show-private`` (only
  use it after you look around and ensure there is no one else looking at your
  screen)
- Use arbitrary UTF-8 string as your mnemonic ``./keytree.py --custom --save-keystore mykeystore.json``
- Show Fuji testnet address format ``./keytree.py <your options> --hrp fuji``
- Use Metamask's deriving algorithm: ``./keytree.py <your options>
  --path "44'/60'/0'/0"`` or ``./keytree.py <your options> --metamask``. By
  default, ETH addresses/keys use AVAX's deriving path (AVAX C-Chain
  keys/addresses) instead of Metamask's. To treat the mnemonic in Metamask's
  way, use ``--path``.  Whatever deriving path is used, the generated
  individual key-address pair is always valid Ethereum format.

Caveat
------
The above instructions use a frozen, full clone of all dependencies that is
shipped in this repo (more secure, recommended, only works on x86-64 Linux).
If you instead do a normal pip install (``pip3 install --user .``) and use
``keytree.py`` (without ``./`` prefix), it will use the latest deps fetched by
pip.

Portable Binary
---------------

Use ``./keytree-0.1.1-x86_64.AppImage`` in place of ``./keytree.py``.