GIOTAmonic

This is a command line tool to help user generate IOTA seed from Bitcoin BIP39 mnenomic

Install

$ go install github.com/mcpride/giotamonic

Build

GIOTAmonic has a dependency to the tool glide which manages related vendor packages - so it must be installed.

To install the vendor packages run:

$ glide install

then you can build it with

$ go build

or test the sub package iota_mnemonic with following command:

$ go test ./iota_mnemonic

Usage

With giotamonic help you will get a help how to use giotamonic:

$ giotamonic help

NAME:
   giotamonic - Generate, restore IOTA seed from Bitcoin BIP39 mnemonic word list.

USAGE:
   giotamonic [global options] command [command options] [arguments...]

VERSION:
   0.1.0

COMMANDS:
     new      Create new mnemonic and iota seed
     to-seed  Convert mnemonic to iota seed

Generate new seed

To output a new seed and the corresponding BIP39 mnemonic word list, execute giotamonic mit the new command:

$ giotamonic help new

NAME:
   giotamonic new - Create new mnemonic and iota seed

USAGE:
   giotamonic new [command options] [arguments...]

DESCRIPTION:
   Creates new BIP0039 mnemonic word list and corresponding - optional passphrase encrypted - iota seed.

OPTIONS:
   --passphrase value  Additional passphrase
   --bitsize value     Bit length of the mnemonic entropy. Must be [128, 256] and a multiple of 32 (default: 256)

Examples

• 24 word mnemonic + seed:

$ giotamonic new

Mnemonic: abuse episode network recall cement connect left sport nose claw reveal certain struggle north strike surprise tennis luxury begin pole trap quote labor collect
Seed: HYRQZWPCRFIQ9BZOJBJGMNBRKAHWRSZKYZWS9NTTGPCWLRFUFUGHORONUHWXGNUQZUQGNWPPKUUEEXJQY

• 12 word mnemonic + seed:

$ giotamonic new --bitsize 128

Mnemonic: ugly scorpion hour trial blue forum glass life click feature mean sentence
Seed: IUSOCINQJUYBBGWDKBIKWU9YYCFHJFRALIPPHGIQHMYRWUNVZLWFEAHZDKFRFGZAAEWMKEI9YTRRGCYZA

• Word mnemonic + seed (passphrase encrypted):

$ giotamonic new --passphrase "Mei Pa$$frA$e"

Mnemonic: rifle rhythm zebra practice pet fish general accuse virtual traffic history blanket visit gaze leave city alpha injury myself pizza upgrade trade detect awake
Seed: KIVQGMYMDXXOXMDKIKOXHDYMWFTRHXHWZPEPHHIWONSZLLCQMVTVHLICMUUEIERAQFZB9ZPKKGHFBWCP9

Generate seed from existing mnemonic

$ giotamonic help to-seed

NAME:
   giotamonic to-seed - Convert mnemonic to iota seed

USAGE:
   giotamonic to-seed [command options] [arguments...]

DESCRIPTION:
   Converts mnemonic words to iota seed.

OPTIONS:
   --passphrase value  Additional passphrase

Examples

$ giotamonic to-seed "ugly scorpion hour trial blue forum glass life click feature mean sentence"

IUSOCINQJUYBBGWDKBIKWU9YYCFHJFRALIPPHGIQHMYRWUNVZLWFEAHZDKFRFGZAAEWMKEI9YTRRGCYZA

• with passphrase:

$ giotamonic to-seed "ugly scorpion hour trial blue forum glass life click feature mean sentence" --passphrase "Mei Pa$$frA$e"

XLQHKPKWBASMVJVWRDPDIKFOGTEFQGSCUXCKHSQXTTSEAXIL9JJGEWQHHGXFWKPBUUBNJTQEGEKPDSOKX

• You can also use pipes:

$ giotamonic to-seed --passphrase "Mei Pa$$frA$e" < mnemonic.txt > seed.txt

How it works

The mnemonic and passphrase will be used to generate a 64 byte seed according to the BIP-0039 standard. IOTA seeds consist of 81 trytes. Deterministic conversions can done between 81 trytes and 48 bytes. For the extraction of 4 x 48 byte slices from a 64 byte block I implemented the simple algorithm from Bart Slinger. These slices will be absorbed by IOTA Kerl and then squeezed out to an IOTA hash seed.

HINT: To increase the difficultiy for hacking your mnemonic seed in the future you should use a strong passhrase!

More detailed

The following steps sketches the algrorithm in prosa:

• Generate the 64 bytes seed from mnemonic words and password according to BIP-39
• Slide the 64 bytes of mnemonic seed into 4 x 16 bytes blocks [1|2|3|4].
• Get the first 48 bytes (first 3 blocks): [1|2|3] and absorb them with IOTA's Kerl.
• Get the last 48 bytes (last 3 blocks): [2|3|4] and absorb them with IOTA's Kerl.
• Get the last 32 bytes (last 2 blocks) + first 16 bytes (1st block): [3|4|1] and absorb them with IOTA's Kerl.
• Get tshe last 16 bytes (last block) + first 32 bytes (first 2 blocks): [4|1|2] and absorb them with IOTA's Kerl.
• Call Squeeze from Kerl to get the IOTA seed.

License

Giotamonic and it's sub packages are under the MIT license. See the LICENSE file for details.