mirror of
https://github.com/AtHeartEngineer/bip39.git
synced 2026-01-10 09:57:58 -05:00
94 lines
2.8 KiB
Markdown
94 lines
2.8 KiB
Markdown
# BIP39 Tool
|
|
|
|
A tool for converting BIP39 mnemonic phrases to addresses and private keys.
|
|
|
|
## Online Version
|
|
|
|
https://iancoleman.io/bip39/
|
|
|
|
## Standalone offline version
|
|
|
|
Download `bip39-standalone.html` from
|
|
[the releases](https://github.com/iancoleman/bip39/releases).
|
|
|
|
Open the file in a browser by double clicking it.
|
|
|
|
This can be compiled from source using the command `python compile.py`
|
|
|
|
## Usage
|
|
|
|
Enter your BIP39 phrase into the 'BIP39 Phrase' field, or press
|
|
'Generate Random Phrase'
|
|
|
|
If required, set the derivation path, although the defaults are quite usable.
|
|
|
|
See the table for a list of addresses generated from the phrase.
|
|
|
|
Toggle columns to blank to easily copy/paste a single column of data, eg to
|
|
import private keys into a wallet or supply someone with a list of addresses.
|
|
|
|
The BIP32 keys can be used at [bip32.org](https://bip32.org) if desired.
|
|
|
|
## Donations
|
|
|
|
Since this project is the efforts of many people, most of which don't appear in
|
|
the obvious places like code or issues, donating to the project itself causes
|
|
significant operational difficulties.
|
|
|
|
As a result, if you would like to support this project financially you are
|
|
encouraged to donate to one of the many groups that makes the internet a place
|
|
amenable to projects such as this one.
|
|
|
|
[Donation-accepting organizations and projects](https://en.bitcoin.it/wiki/Donation-accepting_organizations_and_projects)
|
|
|
|
If the list is too difficult to choose from, the EFF is a good choice.
|
|
|
|
[Electronic Frontier Foundation](https://supporters.eff.org/donate)
|
|
|
|
or for a direct bitcoin address, consider donating to the
|
|
[Free Software Foundation](https://www.fsf.org/about/ways-to-donate/)
|
|
at 1PC9aZC4hNX2rmmrt7uHTfYAS3hRbph4UN
|
|
|
|
|
|
|
|
## Making changes
|
|
|
|
Please do not make modifications to `bip39-standalone.html`, since they will
|
|
be overwritten by `compile.py`.
|
|
|
|
Make changes in `src/*`.
|
|
|
|
Changes are applied during release using the command `python compile.py`, so
|
|
please do not commit changes to `bip39-standalone.html`
|
|
|
|
# Tests
|
|
|
|
Tests depend on
|
|
|
|
* nodejs
|
|
* selenium webdriver - cd /path/to/bip39/tests; npm install
|
|
* selenium driver for firefox ([geckodriver](https://github.com/mozilla/geckodriver/releases)) and / or chrome ([chromedriver](https://sites.google.com/a/chromium.org/chromedriver/downloads))
|
|
* jasmine - npm install --global jasmine
|
|
|
|
Before running tests, the site must be served at http://localhost:8000.
|
|
|
|
```
|
|
$ cd /path/to/bip39/src
|
|
$ python -m http.server
|
|
|
|
or for python2
|
|
$ python -m SimpleHTTPServer
|
|
```
|
|
|
|
Run tests from the command-line
|
|
|
|
```
|
|
$ cd /path/to/bip39/tests
|
|
$ jasmine spec/tests.js
|
|
```
|
|
|
|
# License
|
|
|
|
This BIP39 tool is released under the terms of the MIT license. See LICENSE for
|
|
more information or see https://opensource.org/licenses/MIT.
|