]> git.immae.eu Git - perso/Immae/Projets/Cryptomonnaies/BIP39.git/blob - src/index.html
Mycelium derivation paths contain more details
[perso/Immae/Projets/Cryptomonnaies/BIP39.git] / src / index.html
1 <!DOCTYPE html>
2 <html>
3 <head lang="en">
4 <meta charset="utf-8" />
5 <title>BIP39 - Mnemonic Code</title>
6 <link rel="stylesheet" href="css/bootstrap.min.css">
7 <meta content="Mnemonic code for generating deterministic keys" name="description"/>
8 <meta content="width=device-width, initial-scale=1.0" name="viewport" />
9 <meta content="bitcoin mnemonic converter" name="description" />
10 <meta content="Ian Coleman" name="author" />
11
12 <style>
13 body {
14 padding-bottom: 32px;
15 }
16 .form-control[readonly] {
17 cursor: text;
18 }
19 .feedback-container {
20 position: fixed;
21 top: 0;
22 width: 100%;
23 text-align: center;
24 z-index: 4;
25 }
26 .feedback {
27 display: table;
28 padding: 0.5em 1em;
29 background-color: orange;
30 margin: 0 auto;
31 font-size: 2em;
32 color: #444;
33 border: 2px solid #555;
34 border-top: 0;
35 border-bottom-left-radius: 20px 20px;
36 border-bottom-right-radius: 20px 20px;
37 }
38 .no-border {
39 border: 0;
40 box-shadow: inset 0 1px 1px rgba(0,0,0,.0);
41 -webkit-box-shadow: inset 0 1px 1px rgba(0,0,0,.0);
42 }
43 .phrase {
44 word-break: keep-all;
45 }
46 .generate-container .strength {
47 /* override mobile width from bootstrap */
48 width: auto!important;
49 display: inline-block;
50 }
51 .languages * {
52 padding-left: 10px;
53 }
54 .monospace {
55 font-family: monospace;
56 }
57 .entropy-container .filtered,
58 .entropy-container .binary {
59 word-wrap: break-word;
60 }
61 .entropy-container li {
62 padding-bottom: 5px;
63 }
64 .card-suit {
65 font-size: 19px;
66 line-height: 0;
67 }
68 .card-suit.club {
69 color: #009F00;
70 }
71 .card-suit.diamond {
72 color: #3D5DC4;
73 }
74 .card-suit.heart {
75 color: #F00;
76 }
77 .card-suit.spade {
78 color: #000;
79 }
80 </style>
81 </head>
82 <body>
83 <div class="container">
84
85 <h1 class="text-center">Mnemonic Code Converter</h1>
86 <hr>
87 <div class="row">
88 <div class="col-md-12">
89 <h2>Mnemonic</h2>
90 <form class="form-horizontal" role="form">
91 <div class="form-group">
92 <div class="col-sm-2"></div>
93 <div class="col-sm-10">
94 <p>You can enter an existing BIP39 mnemonic, or generate a new random one. Typing your own twelve words will probably not work how you expect, since the words require a particular structure (the last word is a checksum)</p>
95 <p>For more info see the <a href="https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki" target="_blank">BIP39 spec</a></p>
96 </div>
97 </div>
98 <div class="form-group generate-container">
99 <label class="col-sm-2 control-label"></label>
100 <div class="col-sm-10">
101 <div class="form-inline">
102 <div class="input-group-inline">
103 <button class="btn generate">Generate</button>
104 <span>a random</span>
105 <select id="strength" class="strength form-control">
106 <option value="3">3</option>
107 <option value="6">6</option>
108 <option value="9">9</option>
109 <option value="12">12</option>
110 <option value="15" selected>15</option>
111 <option value="18">18</option>
112 <option value="21">21</option>
113 <option value="24">24</option>
114 </select>
115 word mnemonic, or enter your own below.
116 </div>
117 </div>
118 </div>
119 </div>
120 <div class="entropy-container hidden">
121 <div class="form-group text-danger">
122 <label class="col-sm-2 control-label">Warning</label>
123 <div class="col-sm-10 form-control-static">
124 Entropy is an advanced feature.
125 Your mnemonic may be insecure if this feature is used incorrectly.
126 <a href="#entropy-notes">Read more</a>
127 </div>
128 </div>
129 <div class="form-group">
130 <label for="entropy" class="col-sm-2 control-label">Entropy</label>
131 <div class="col-sm-7">
132 <textarea id="entropy" rows="2" class="entropy form-control" placeholder="Accepts binary, base 6, 6-sided dice, base 10, hexadecimal, cards"></textarea>
133 <div class="row">
134 <label class="col-sm-3 control-label">Strength</label>
135 <div class="strength col-sm-3 form-control-static"></div>
136 <label class="col-sm-3 control-label">Event Count</label>
137 <div class="event-count col-sm-3 form-control-static"></div>
138 </div>
139 <div class="row">
140 <label class="col-sm-3 control-label">Entropy Type</label>
141 <div class="type col-sm-3 form-control-static"></div>
142 <label class="col-sm-3 control-label">Bits Per Event</label>
143 <div class="bits-per-event col-sm-3 form-control-static"></div>
144 </div>
145 <div class="row">
146 <label class="col-sm-3 control-label">Word Count</label>
147 <div class="word-count col-sm-3 form-control-static"></div>
148 <label class="col-sm-3 control-label">Total Bits</label>
149 <div class="bits col-sm-3 form-control-static"></div>
150 </div>
151 <label class="col-sm-3 control-label">Filtered Entropy</label>
152 <div class="filtered col-sm-9 form-control-static"></div>
153 <label class="col-sm-3 control-label">Raw Binary</label>
154 <div class="binary col-sm-9 form-control-static"></div>
155 <label class="col-sm-3 control-label">Mnemonic Length</label>
156 <div class="col-sm-9">
157 <select class="mnemonic-length form-control">
158 <option value="raw">From entropy length (3 words per 32 bits)</option>
159 <option value="12">12 Words</option>
160 <option value="15" selected>15 Words</option>
161 <option value="18">18 Words</option>
162 <option value="21">21 Words</option>
163 <option value="24">24 Words</option>
164 </select>
165 </div>
166 </div>
167 <div class="col-sm-3">
168 <p>Valid entropy values include:</p>
169 <ul>
170 <li><strong>Binary</strong> [0-1]<br>101010011</li>
171 <li><strong>Base 6</strong> [0-5]<br>123434014</li>
172 <li><strong>Dice</strong> [1-6]<br>62535634</li>
173 <li><strong>Base 10</strong> [0-9]<br>90834528</li>
174 <li><strong>Hex</strong> [0-9A-F]<br>4187a8bfd9</li>
175 <li><strong>Card</strong> [A2-9TJQK][CDHS]<br>ahqs9dtc</li>
176 </ul>
177 </div>
178 </div>
179 </div>
180 <div class="form-group">
181 <div class="col-sm-2"></div>
182 <div class="col-sm-10 checkbox">
183 <label>
184 <input type="checkbox" class="use-entropy">
185 Supply my own source of entropy
186 </label>
187 </div>
188 </div>
189 <div class="form-group">
190 <label class="col-sm-2 control-label"></label>
191 <div class="col-sm-10 languages">
192 <a href="#english">English</a>
193 <a href="#japanese" title="Japanese">日本語</a>
194 <a href="#spanish" title="Spanish">Español</a>
195 <a href="#chinese_simplified" title="Chinese (Simplified)">中文(简体)</a>
196 <a href="#chinese_traditional" title="Chinese (Traditional)">中文(繁體)</a>
197 <a href="#french" title="French">Français</a>
198 <a href="#italian" title="Italian">Italiano</a>
199 </div>
200 </div>
201 <div class="form-group">
202 <label for="phrase" class="col-sm-2 control-label">BIP39 Mnemonic</label>
203 <div class="col-sm-10">
204 <textarea id="phrase" class="phrase form-control"></textarea>
205 </div>
206 </div>
207 <div class="form-group">
208 <label for="passphrase" class="col-sm-2 control-label">BIP39 Passphrase (optional)</label>
209 <div class="col-sm-10">
210 <textarea id="passphrase" class="passphrase form-control"></textarea>
211 </div>
212 </div>
213 <div class="form-group">
214 <label for="seed" class="col-sm-2 control-label">BIP39 Seed</label>
215 <div class="col-sm-10">
216 <textarea id="seed" class="seed form-control" readonly="readonly"></textarea>
217 </div>
218 </div>
219 <div class="form-group">
220 <label for="network-phrase" class="col-sm-2 control-label">Coin</label>
221 <div class="col-sm-10">
222 <select id="network-phrase" class="network form-control">
223 <!-- populated by javascript -->
224 </select>
225 </div>
226 </div>
227 <div class="form-group">
228 <label for="root-key" class="col-sm-2 control-label">BIP32 Root Key</label>
229 <div class="col-sm-10">
230 <textarea id="root-key" class="root-key form-control"></textarea>
231 </div>
232 </div>
233 </form>
234 </div>
235 </div>
236
237 <hr>
238
239 <div class="row">
240 <div class="col-md-12">
241 <h2>Derivation Path</h2>
242 <ul class="derivation-type nav nav-tabs" role="tablist">
243 <li id="bip44-tab" class="active">
244 <a href="#bip44" role="tab" data-toggle="tab">BIP44</a>
245 </li>
246 <li id="bip32-tab">
247 <a href="#bip32" role="tab" data-toggle="tab">BIP32</a>
248 </li>
249 </ul>
250 <div class="derivation-type tab-content">
251 <div id="bip44" class="tab-pane active">
252 <form class="form-horizontal" role="form">
253 <br>
254 <div class="col-sm-2"></div>
255 <div class="col-sm-10">
256 <p>For more info see the <a href="https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki" target="_blank">BIP44 spec</a></p>
257 </div>
258 <div class="form-group">
259 <label for="purpose" class="col-sm-2 control-label">
260 <a href="https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki#purpose" target="_blank">Purpose</a>
261 </label>
262 <div class="col-sm-10">
263 <input id="purpose" type="text" class="purpose form-control" value="44">
264 </div>
265 </div>
266 <div class="form-group">
267 <label for="coin" class="col-sm-2 control-label">
268 <a href="https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki#registered-coin-types" target="_blank">Coin</a>
269 </label>
270 <div class="col-sm-10">
271 <input id="coin" type="text" class="coin form-control" value="0">
272 </div>
273 </div>
274 <div class="form-group">
275 <label for="account" class="col-sm-2 control-label">
276 <a href="https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki#account" target="_blank">Account</a>
277 </label>
278 <div class="col-sm-10">
279 <input id="account" type="text" class="account form-control" value="0">
280 </div>
281 </div>
282 <div class="form-group">
283 <label for="change" class="col-sm-2 control-label">
284 <a href="https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki#change" target="_blank">External / Internal</a>
285 </label>
286 <div class="col-sm-10">
287 <input id="change" type="text" class="change form-control" value="0">
288 </div>
289 </div>
290 <div class="form-group">
291 <label for="bip44-path" class="col-sm-2 control-label">BIP32 Derivation Path</label>
292 <div class="col-sm-10">
293 <input id="bip44-path" type="text" class="path form-control" value="m/44'/0'/0'/0" readonly="readonly">
294 </div>
295 </div>
296 </form>
297 </div>
298 <div id="bip32" class="tab-pane">
299 <form class="form-horizontal" role="form">
300 <br>
301 <div class="col-sm-2"></div>
302 <div class="col-sm-10">
303 <p>For more info see the <a href="https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki" target="_blank">BIP32 spec</a></p>
304 </div>
305 <div class="form-group">
306 <label for="bip32-path" class="col-sm-2 control-label">BIP32 Derivation Path</label>
307 <div class="col-sm-10">
308 <input id="bip32-path" type="text" class="path form-control" value="m/0">
309 </div>
310 </div>
311 <div class="form-group">
312 <div class="col-sm-2"></div>
313 <label class="col-sm-10">
314 <input class="hardened-addresses" type="checkbox">
315 Use hardened addresses
316 </label>
317 </div>
318 <div class="form-group">
319 <label class="col-sm-2 control-label">Hive Wallet</label>
320 <div class="col-sm-10">
321 <p class="form-control no-border">
322 Use path <code>m/0'/0</code>.
323 For more info see the <a href="https://www.hivewallet.com/" target="_blank">Hive Wallet homepage</a>
324 </p>
325 </div>
326 </div>
327 <div class="form-group">
328 <label for="mycelium-path" class="col-sm-2 control-label">Mycelium Wallet</label>
329 <div class="col-sm-10">
330 <p class="form-control no-border">
331 <code>m/44'/0'/0'</code> generates extended keys for import / export.
332 </p>
333 <p class="form-control no-border">
334 <code>m/44'/0'/1'</code> to generate the next account. Continue incrementing for more accounts (most use a single account).
335 </p>
336 <p class="form-control no-border">
337 <code>m/44'/0'/0'/0</code> to generate public addresses.
338 </p>
339 <p class="form-control no-border">
340 <code>m/44'/0'/0'/1</code> to generate change addresses.
341 </p>
342 <p class="form-control no-border">
343 For more info see the <a href="http://www.mycelium.com/" target="_blank">Mycelium Wallet homepage</a>
344 </p>
345 </div>
346 </div>
347 <div class="form-group">
348 <label for="core-path" class="col-sm-2 control-label">Bitcoin Core</label>
349 <div class="col-sm-10">
350 <p class="form-control no-border">
351 Use path <code>m/0'/0'</code> with hardened addresses.
352 For more info see the <a href="https://github.com/bitcoin/bitcoin/pull/8035" target="_blank">Bitcoin Core BIP32 implementation</a>
353 </p>
354 </div>
355 </div>
356 <div class="form-group">
357 <label class="col-sm-2 control-label">Block Explorers</label>
358 <div class="col-sm-10">
359 <p class="form-control no-border">
360 Use path <code>m/44'/0'/0'</code>.
361 Only enter the <code>xpub</code> extended key into block explorer search fields, never the <code>xpriv</code> key.
362 </p>
363 </div>
364 </div>
365 </form>
366 </div>
367 </div>
368 <form class="form-horizontal" role="form">
369 <div class="form-group">
370 <label for="extended-priv-key" class="col-sm-2 control-label">BIP32 Extended Key</label>
371 <div class="col-sm-10">
372 <textarea id="extended-priv-key" class="extended-priv-key form-control" readonly="readonly"></textarea>
373 </div>
374 </div>
375 <div class="form-group">
376 <label for="extended-pub-key" class="col-sm-2 control-label">BIP32 Extended Key (addresses only)</label>
377 <div class="col-sm-10">
378 <textarea id="extended-pub-key" class="extended-pub-key form-control" readonly="readonly"></textarea>
379 </div>
380 </div>
381 </form>
382 </div>
383 </div>
384
385 <hr>
386
387 <div class="row">
388 <div class="col-md-12">
389 <h2>Derived Addresses</h2>
390 <p>Note these addreses are derived from the <strong>BIP32 Extended Key</strong></p>
391 <table class="table table-striped">
392 <thead>
393 <th>
394 <div class="input-group">
395 Path&nbsp;&nbsp;
396 <button class="index-toggle">Toggle</button>
397 </div>
398 </th>
399 <th>
400 <div class="input-group">
401 Address&nbsp;&nbsp;
402 <button class="address-toggle">Toggle</button>
403 </div>
404 </th>
405 <th>
406 <div class="input-group">
407 Public Key&nbsp;&nbsp;
408 <button class="public-key-toggle">Toggle</button>
409 </div>
410 </th>
411 <th>
412 <div class="input-group">
413 Private Key&nbsp;&nbsp;
414 <button class="private-key-toggle">Toggle</button>
415 </div>
416 </th>
417 </thead>
418 <tbody class="addresses monospace">
419 <tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr>
420 <tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr>
421 <tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr>
422 <tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr>
423 <tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr>
424 </tbody>
425 </table>
426 </div>
427 </div>
428 <span>Show next </button>
429 <input type="number" class="rows-to-add" value="20">
430 <button class="more">Show</button>
431
432 <hr>
433
434 <div class="row">
435 <div class="col-md-12">
436 <h2>More info</h2>
437 <h3>BIP39 <span class="small">Mnemonic code for generating deterministic keys</span></h3>
438 <p>
439 Read more at the
440 <a href="https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki">official BIP39 spec</a>
441 </p>
442 <h3>BIP32 <span class="small">Hierarchical Deterministic Wallets</span></h3>
443 <p>
444 Read more at the
445 <a href="https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki" target="_blank">official BIP32 spec</a>
446 and see the demo at
447 <a href="http://bip32.org/" target="_blank">bip32.org</a>
448 </p>
449 <h3>BIP44 <span class="small">Multi-Account Hierarchy for Deterministic Wallets</span></h3>
450 <p>
451 Read more at the
452 <a href="https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki" target="_blank">official BIP44 spec</a>
453 </p>
454 <h3>Private Keys</h3>
455 <p>
456 Use private keys at
457 <a href="https://web.archive.org/web/20150707020924/https://brainwallet.org/" target="_blank">brainwallet.org</a>,
458 but be careful - it can be easy to make mistakes if you
459 don't know what you're doing
460 </p>
461 <h3 id="entropy-notes">Entropy</h3>
462 <p>
463 Entropy values must be sourced from a
464 <a href="https://en.wikipedia.org/wiki/Random_number_generation" target="_blank">strong source of randomness</a>.
465 This means flipping a fair coin, rolling a fair dice, noise measurements etc. Do <strong>NOT</strong> use
466 phrases from books, lyrics from songs, your birthday or steet address, keyboard mashing, or anything you <i>think</i>
467 is random, because chances are <em>overwhelming</em> that it isn't random enough for the needs of this tool.
468 </p>
469 <p>
470 The random mnemonic generator on this page uses a
471 <a href="https://developer.mozilla.org/en-US/docs/Web/API/RandomSource/getRandomValues" target="_blank">cryptographically secure random number generator</a>,
472 and can generally be trusted more than your own intuition about randomness.
473 If cryptographic randomness isn't available in your browser, this page will show a warning and <i>will not generate
474 random mnemonics</i>.
475 </p>
476 <p>
477 <a href="https://bitcointalk.org/index.php?topic=311000.msg3345309#msg3345309" target="_blank">You are not a good source of entropy.</a>
478 </p>
479 </div>
480 </div>
481
482 <hr>
483
484 <div class="row">
485 <div class="col-md-12">
486
487 <h2>Offline Usage</h2>
488
489 <p>
490 You can use this tool without having to be online.
491 </p>
492 <p>
493 In your browser, select file save-as, and save this page
494 as a file.
495 </p>
496 <p>
497 Double-click that file to open it in a browser
498 on any offline computer.
499 </p>
500 <p>
501 Alternatively, download it from
502 <a href="https://github.com/iancoleman/bip39">
503 https://github.com/iancoleman/bip39
504 </a>
505
506 </div>
507 </div>
508
509 <hr>
510
511 <div class="row">
512 <div class="col-md-12">
513
514 <h2>This project is 100% open-source code</h2>
515
516 <p>
517 <span>Get the source code at - </span>
518 <a href="https://github.com/iancoleman/bip39" target="_blank">
519 https://github.com/iancoleman/bip39
520 </a>
521 </p>
522
523 <h3>Libraries</h3>
524
525 <p>
526 <span>BitcoinJS - </span>
527 <a href="https://github.com/bitcoinjs/bitcoinjs-lib" target="_blank">
528 https://github.com/bitcoinjs/bitcoinjs-lib
529 </a>
530 </p>
531
532 <p>
533 <span>jsBIP39 - </span>
534 <a href="https://github.com/iancoleman/jsbip39" target="_blank">
535 https://github.com/iancoleman/jsbip39
536 </a>
537 </p>
538
539 <p>
540 <span>sjcl - </span>
541 <a href="https://github.com/bitwiseshiftleft/sjcl" target="_blank">
542 https://github.com/bitwiseshiftleft/sjcl
543 </a>
544 </p>
545
546 <p>
547 <span>jQuery - </span>
548 <a href="https://jquery.com/" target="_blank">
549 https://jquery.com/
550 </a>
551 </p>
552
553 <p>
554 <span>Twitter Bootstrap - </span>
555 <a href="http://getbootstrap.com/" target="_blank">
556 http://getbootstrap.com/
557 </a>
558 </p>
559
560 </div>
561 </div>
562
563 </div>
564
565 <div class="feedback-container">
566 <div class="feedback">Loading...</div>
567 </div>
568
569 <script type="text/template" id="address-row-template">
570 <tr>
571 <td class="index"><span></span></td>
572 <td class="address"><span></span></td>
573 <td class="pubkey"><span></span></td>
574 <td class="privkey"><span></span></td>
575 </tr>
576 </script>
577 <script src="js/jquery.min.js"></script>
578 <script src="js/bootstrap.min.js"></script>
579 <script src="js/levenshtein.js"></script>
580 <script src="js/bitcoinjs-1-5-7.js"></script>
581 <script src="js/bitcoinjs-extensions.js"></script>
582 <script src="js/sjcl-bip39.js"></script>
583 <script src="js/wordlist_english.js"></script>
584 <script src="js/wordlist_japanese.js"></script>
585 <script src="js/wordlist_spanish.js"></script>
586 <script src="js/wordlist_chinese_simplified.js"></script>
587 <script src="js/wordlist_chinese_traditional.js"></script>
588 <script src="js/wordlist_french.js"></script>
589 <script src="js/wordlist_italian.js"></script>
590 <script src="js/jsbip39.js"></script>
591 <script src="js/biginteger.js"></script>
592 <script src="js/zxcvbn.js"></script>
593 <script src="js/entropy.js"></script>
594 <script src="js/index.js"></script>
595 </body>
596 </html>