derivator 0.1

data/lib/derivator/mnemonic.rb

@@ -0,0 +1,51 @@
+module Derivator
+  # {https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki BIP39} mnemonic generation.
+  class Mnemonic
+    # Word list (ordered). Only English is supported.
+    WORDS = File.readlines(__dir__ + '/word_lists/english.txt', chomp: true)
+
+    SEED_ITERATIONS = 2048
+    SEED_KEY_LENGTH = 64
+
+    class << self
+      # Generates 128 bits of random
+      #
+      # @return [String] 16 random bytes
+      def random_bytes
+        SecureRandom.random_bytes(128 / 8) # 128 bits
+      end
+
+      # Generates mnemonic.
+      #
+      # @param bytes [String] bytes to generate mnemonic from
+      # @return [String] mnemonic (12 words)
+      def generate(bytes = random_bytes)
+        checksum = OpenSSL::Digest::SHA256.new(bytes).digest[0..0]
+        checksum_bits = checksum[0..0].unpack('B4').first # first 4 bits
+        bits = bytes.unpack('B*').first + checksum_bits
+        mnemonic = bits.chars.
+          each_slice(11).
+          map(&:join).
+          map { |x| x.to_i(2) }.
+          map { |x| WORDS[x] }.
+          join(' ')
+      end
+
+      # Generates master seed.
+      #
+      # @param mnemonic [String] mnemonic (12 words) to generate seed from
+      # @param password [String] password
+      def seed(mnemonic, password = '')
+        salt = "mnemonic#{password}"
+        result_bytes = OpenSSL::KDF.pbkdf2_hmac(
+          mnemonic,
+          salt: salt,
+          iterations: SEED_ITERATIONS,
+          length: SEED_KEY_LENGTH,
+          hash: 'SHA512'
+        )
+        result_bytes.unpack('H*').first
+      end
+    end
+  end
+end

data/lib/derivator/refinements.rb

@@ -0,0 +1,37 @@
+module Derivator
+  # Internally used refinements
+  module Refinements
+    refine String do
+      def to_hex
+        unpack('H*').first
+      end
+
+      def from_hex
+        [self].pack('H*')
+      end
+
+      def to_base64
+        Base64.encode64(self)
+      end
+
+      def from_base64
+        Base64.decode64(self)
+      end
+
+      def parse_der
+        OpenSSL::ASN1.decode(self)
+      end
+
+      def to_der_octet_string
+        OpenSSL::ASN1::OctetString.new(self)
+      end
+
+      # Returns BIP-0032 key identifier, interpreting string as binary key
+      def hash160
+        # https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki#key-identifiers
+        r = OpenSSL::Digest::SHA256.new(self).digest
+        OpenSSL::Digest::RIPEMD160.new(r).digest
+      end
+    end
+  end
+end