Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mlouielu/iota-mnemonic
Generate, restore IOTA seed from Bitcoin BIP39 mnemonic
https://github.com/mlouielu/iota-mnemonic
bip39 iota iota-library mnemonic python
Last synced: about 1 month ago
JSON representation
Generate, restore IOTA seed from Bitcoin BIP39 mnemonic
- Host: GitHub
- URL: https://github.com/mlouielu/iota-mnemonic
- Owner: mlouielu
- License: mit
- Created: 2017-12-21T02:52:35.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T06:36:27.000Z (almost 2 years ago)
- Last Synced: 2024-09-17T15:34:36.642Z (2 months ago)
- Topics: bip39, iota, iota-library, mnemonic, python
- Language: Python
- Homepage:
- Size: 32.2 KB
- Stars: 16
- Watchers: 4
- Forks: 11
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
IOTA Mnemonic
=============
This is a command line tool to help user generate IOTA seed from Bitcoin BIP39 mnenomics
Install
=======
### $ pipenv install iota_mnemonic
To install IOTA mnemonic, simply run this simple command in your terminal of choice:
```
$ pipenv install iota_mnemonic
```
### Get the source code
You can clone the source code from repository:
```
$ git clone https://github.com/mlouielu/iota-mnemonic
```
How to use
==========
```
# Generate 24 words mnemonic and IOTA seed
$ python -m iota_mnemonic
Mnemonic: come grocery cube calm void liberty increase pigeon captain appear employ among
float fancy cargo faith seek buzz argue lift agent split bachelor judge
IOTA Seed: RTWTRPAEGJQFRWAYTIJTKWZKLN9K9VRUETFSIPUAUCLKPNNSNWAKTOXBWSCPQVNNWDLTEIPMILIOVPGIX
# Generate mnemonic with passphrase
$ python -m iota_mnemonic -p TREZOR
Mnemonic: limit about defy sail base useless soul album aim border celery false asset average
romance attract lonely track hope sun afford creek dignity couple
IOTA Seed: LIPSSXDAJQRLBPTTBQTPTYBMUSTJPXWGYBKLSSBDVKPVEAXDGPZXOWPMEGRNSHTJXIUVCXYFTOXMZKIMY
# Generate 12 words mnemonic with passphrase
$ python -m iota_mnemonic -s 128 -p TREZOR
Mnemonic: broccoli merry lucky milk lizard cannon area utility jelly click bag clever
IOTA Seed: YNONELPCFBKQDDQMIBBBGJDZODCKXEBIJIMXRUGBA9AOPJEQ9SYYLGID9IXHILWVVDJ9ZEGQHCGIHQ9TB
# Genreate mnemonic with japanese
$ python -m iota_mnemonic -l japanese
Mnemonic: こいぬ ようちえん むせん いんさつ しなもの ふのう かわく ひかり はいけん
そんしつ たたかう ちいさい そうめん つうわ にんげん とおす さみだれ かまぼこ
らくだ さずかる ふとる とんかつ きびしい ひつぜん
IOTA Seed: ISBAFGB9LBGOQYGKKMMNK9APICZCGWIJHCMLOLPAQITGSSIGBJJOYQZJJ9NNGYIJLFB9ORMJGCWFFFYQZ
# Output the mnemonic to file
$ python -m iota_mnemonic -p TREZOR -o mnemonic
# Recover seed from mnemonic
$ python -m iota_menmonic -p TREZOR -f mnemonic
Mnemonic: often various act decide tongue sausage summer wall priority knock finish until
taxi robot panic toward giraffe acid avocado anchor travel kiwi actress cream
IOTA Seed: CRGFVETUFKUQYTPTEH9TP9BDKBVZLG9UZJDZBDMMFSSCUPIATPEZMKBLKXOEKCRDFHHFNCCBF9SKHNYIA
```
How it works?
=============
To create IOTA seed from the mnemonic, we use IOTA Kerl function with a mnemonic
sentence (in UTF-8 NFKD) used as the password and the string "mnemonic" + passphrase
(again in UTF-8 NFKD) used as the salt.
To get a valid tryte hash, we concat salt and mnemonic sentence, and load into `iota.Hash`
by `from_string` function. `from_string` will encode UTF-8 NFKD into bytes, then convert
bytes into IOTA hash.
Using each hash, we then use hash trits and Kerl to absorb and squeeze:
```python
trits = []
sponge = iota.crypto.kerl.Kerl()
for word in mnemonic:
hash = iota.Hash.from_string(f'mnemonic{passphrase}{word}')
hash_trits = hash.as_trits()
k = iota.crypto.kerl.Kerl()
k.absorb(hash_trits)
k.squeeze(hash_trits)
sponge.absorb(hash_trits)
sponge.squeeze(trits)
return iota.Hash.from_trits(trits)
```