mgozali / bip_mnemonic

BipMnemonic is a ruby gem to generate BIP-39 compliant Mnemonic Words from specific entropy or random entropy of `n` bits and also to generate the BIP-32 seed from the BIP-39 Mnemonic.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status Gem Version codecov

README

BipMnemonic is a ruby gem to generate BIP-39 compliant Mnemonic Words from specific entropy or random entropy of n bits and also to generate the BIP-32 seed from the BIP-39 Mnemonic.

Supported Languages:

USAGE

Specified Entropy in Hex

BipMnemonic.to_mnemonic(entropy: 'c10ec20dc3cd9f652c7fac2f1230f7a3c828389a14392f05')
BipMnemonic.to_mnemonic(entropy: 'c10ec20dc3cd9f652c7fac2f1230f7a3c828389a14392f05', language: 'english')

Entropy of n bits

BipMnemonic.to_mnemonic(bits: 128)
BipMnemonic.to_mnemonic(bits: 128, language: 'french')

Retrieving entropy from Mnemonic

BipMnemonic.to_entropy(mnemonic: 'scissors invite lock maple supreme raw rapid void congress muscle digital elegant little brisk hair mango congress clump')
BipMnemonic.to_entropy(mnemonic: 'satira lusinga mordere nastrare sposo responso replica varcato colza opinione distanza erario monetario bici india narice colza cilindro', language: 'italian')

Seed from Mnemonic Words

words = BipMnemonic.to_mnemonic(entropy: 'c10ec20dc3cd9f652c7fac2f1230f7a3c828389a14392f05')
BipMnemonic.to_seed(mnemonic: words)

LANGUAGE USAGE

Pass language: 'language' to methods to_mnemonic or to_entropy with supported values.

Supported Values:

  • english
  • japanese
  • korean
  • spanish
  • chinese_simplified
  • chinese_traditional
  • french
  • italian

TODO

  • Introduce tests for International Languages

CHANGELOG

Version 0.0.4

  • Added support for International Languages
  • Test compatibiltiy updated

Version 0.0.3

  • Major bug fix - Switched from pseudo_bytes to random_bytes

CREDITS

About

BipMnemonic is a ruby gem to generate BIP-39 compliant Mnemonic Words from specific entropy or random entropy of `n` bits and also to generate the BIP-32 seed from the BIP-39 Mnemonic.

License:MIT License


Languages

Language:Ruby 100.0%