[perso/Immae/Projets/Cryptomonnaies/BIP39.git] / readme.md

# 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

![alt text](https://static.fsf.org/nosvn/images/bitcoin_qrcodes/fsf.png "FSF Bitcoin Address")

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