]> git.immae.eu Git - perso/Immae/Projets/Cryptomonnaies/BIP39.git/blame_incremental - readme.md
Add LKRcoin (LKR)
[perso/Immae/Projets/Cryptomonnaies/BIP39.git] / readme.md
... / ...
CommitLineData
1# BIP39 Tool
2
3A tool for converting BIP39 mnemonic phrases to addresses and private keys.
4
5## Online Version
6
7https://iancoleman.io/bip39/
8
9## Standalone offline version
10
11Download `bip39-standalone.html`
12
13Open the file in a browser by double clicking it.
14
15This can be compiled from source using the command `python compile.py`
16
17## Usage
18
19Enter your BIP39 phrase into the 'BIP39 Phrase' field, or press
20'Generate Random Phrase'
21
22If required, set the derivation path, although the defaults are quite usable.
23
24See the table for a list of addresses generated from the phrase.
25
26Toggle columns to blank to easily copy/paste a single column of data, eg to
27import private keys into a wallet or supply someone with a list of addresses.
28
29The BIP32 keys can be used at [bip32.org](https://bip32.org) if desired.
30
31## Donations
32
33Since this project is the efforts of many people, most of which don't appear in
34the obvious places like code or issues, donating to the project itself causes
35significant operational difficulties.
36
37As a result, if you would like to support this project financially you are
38encouraged to donate to one of the many groups that makes the internet a place
39amenable to projects such as this one.
40
41[Donation-accepting organizations and projects](https://en.bitcoin.it/wiki/Donation-accepting_organizations_and_projects)
42
43If the list is too difficult to choose from, the EFF is a good choice.
44
45[Electronic Frontier Foundation](https://supporters.eff.org/donate)
46
47or for a direct bitcoin address, consider donating to the
48[Free Software Foundation](https://www.fsf.org/about/ways-to-donate/)
49at 1PC9aZC4hNX2rmmrt7uHTfYAS3hRbph4UN
50
51![alt text](https://static.fsf.org/nosvn/images/bitcoin_qrcodes/fsf.png "FSF Bitcoin Address")
52
53## Making changes
54
55Please do not make modifications to `bip39-standalone.html`, since they will
56be overwritten by `compile.py`.
57
58Make changes in `src/*`.
59
60Changes are applied during release using the command `python compile.py`, so
61please do not commit changes to `bip39-standalone.html`
62
63# Tests
64
65Tests depend on
66
67* nodejs
68* selenium webdriver - cd /path/to/bip39/tests; npm install
69* selenium driver for firefox ([geckodriver](https://github.com/mozilla/geckodriver/releases)) and / or chrome ([chromedriver](https://sites.google.com/a/chromium.org/chromedriver/downloads))
70* jasmine - npm install --global jasmine
71
72Before running tests, the site must be served at http://localhost:8000.
73
74```
75$ cd /path/to/bip39/src
76$ python -m http.server
77
78or for python2
79$ python -m SimpleHTTPServer
80```
81
82Run tests from the command-line
83
84```
85$ cd /path/to/bip39/tests
86$ jasmine spec/tests.js
87```
88
89# License
90
91This BIP39 tool is released under the terms of the MIT license. See LICENSE for
92more information or see https://opensource.org/licenses/MIT.