keccak-pure-ruby 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 73764214b42066133a8ea89fbf28d64156527b2d5ae9d71520757c2d434d39fc
+  data.tar.gz: 852efe6a69cd1cc3df61ac8fee3b7c01f91e25ccf6eb25665b88220aa6031191
+SHA512:
+  metadata.gz: 0dda2f15b0ff43f043afbd41e6940997288fc7ec59801cb91e831398e9a6c3ae3724b3e09453a5d1375cc8b9755c03cde23946d95864bc7d33a102127c3910f7
+  data.tar.gz: 868c9bec64fb0a3c0dbb55c6541aaf619d9eaab922312479dde53c222dfa2389d201e4082690d5ab96d05d8ec5c2e95d8ed6e9899af2411c049f3f5876cfc161

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 1.9.3
+  - 1.9.2
+  - jruby-19mode
+  - rbx-19mode

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,21 @@
+PATH
+  remote: .
+  specs:
+    keccak-pure-ruby (0.1.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    minitest (5.11.3)
+    rake (12.3.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  keccak-pure-ruby!
+  minitest
+  rake
+
+BUNDLED WITH
+   1.16.1

data/README.md

@@ -0,0 +1,44 @@
+# Pure Ruby SHA3 Gem
+[![Build Status](https://travis-ci.org/havenwood/sha3-pure-ruby.png?branch=master)](https://travis-ci.org/havenwood/sha3-pure-ruby)
+
+A pure Ruby implementation of SHA3.
+
+## Installation
+
+Install it from the command line:
+
+```bash
+gem install keccak-pure-ruby
+```
+
+Or execute `bundle` after adding this line to your app's Gemfile:
+
+```ruby
+gem 'sha3-pure-ruby'
+```
+
+## Usage
+
+```ruby
+Digest::SHA3.new.hexdigest 'default 512-bit'
+#=> "26dce8c3ea8e5ffbfbf684070ca59f9635487942bfc220b9fe94bf9b2f8a7dfa2e4e85059ead3c92f14e5d2e06076eb6643adf50481976bd52f737f89b185ae2"
+
+Digest::SHA3.new(224).hexdigest 'example 224-bit'
+#=> "d6e8cef46de550a1b50ca920c4600a6e1512af055034c45a33849133"
+```
+
+## Compatibility
+
+- Ruby 2.0.0
+- Ruby 1.9.3
+- Ruby 1.9.2
+- JRuby
+- Rubinius
+
+## License
+
+Creative Commons
+
+To the extent possible under law, Christian Neukirchen has waived all copyright and related or neighboring rights to the source code of the original Ruby implementation. Performance enhancements added by Clemens Gruber. Refactored, tests added, and cut into a gem by Shannon Skipper. You can copy, modify, distribute and perform this work, even for commercial purposes, all without asking permission:
+
+[https://creativecommons.org/publicdomain/zero/1.0/](https://creativecommons.org/publicdomain/zero/1.0/)

data/Rakefile

@@ -0,0 +1,5 @@
+task default: [:test]
+
+task :test do
+  ruby 'test/test_sha3-pure-ruby.rb'
+end

data/lib/sha3-pure-ruby.rb

@@ -0,0 +1,103 @@
+require 'digest'
+require_relative 'sha3-pure-ruby/version'
+
+module Digest
+  class SHA3 < Digest::Class    
+    PILN = [10,  7, 11, 17, 18,  3,  5, 16,
+             8, 21, 24,  4, 15, 23, 19, 13,
+            12,  2, 20, 14, 22,  9,  6,  1]
+            
+    ROTC = [ 1,  3,  6, 10, 15, 21, 28, 36,
+            45, 55,  2, 14, 27, 41, 56,  8,
+            25, 43, 62, 18, 39, 61, 20, 44]
+            
+    RNDC = [0x0000000000000001, 0x0000000000008082, 0x800000000000808a,
+            0x8000000080008000, 0x000000000000808b, 0x0000000080000001,
+            0x8000000080008081, 0x8000000000008009, 0x000000000000008a,
+            0x0000000000000088, 0x0000000080008009, 0x000000008000000a,
+            0x000000008000808b, 0x800000000000008b, 0x8000000000008089,
+            0x8000000000008003, 0x8000000000008002, 0x8000000000000080,
+            0x000000000000800a, 0x800000008000000a, 0x8000000080008081,
+            0x8000000000008080, 0x0000000080000001, 0x8000000080008008]
+            
+    def initialize hash_size = 512
+      @size = hash_size / 8
+      @buffer = ''
+    end
+    
+    def << s
+      @buffer << s
+      self
+    end
+    alias update <<
+    
+    def reset
+      @buffer.clear
+      self
+    end
+    
+    def finish
+      s = Array.new 25, 0
+      width = 200 - @size * 2
+      
+      buffer = @buffer
+      buffer << "\x01" << "\0" * (width - buffer.size % width)
+      buffer[-1] = (buffer[-1].ord | 0x80).chr
+      
+      0.step buffer.size - 1, width do |j|
+        quads = buffer[j, width].unpack 'Q*'
+        (width / 8).times do |i|
+          s[i] ^= quads[i]
+        end
+        
+        keccak s
+      end
+      
+      s.pack('Q*')[0, @size]
+    end
+    
+    private
+    def keccak s
+      24.times.each_with_object [] do |round, a|
+        # Theta
+        5.times do |i|
+          a[i] = s[i] ^ s[i + 5] ^ s[i + 10] ^ s[i + 15] ^ s[i + 20]
+        end
+        
+        5.times do |i|
+          t = a[(i + 4) % 5] ^ rotate(a[(i + 1) % 5], 1)
+          0.step 24, 5 do |j|
+            s[j + i] ^= t
+          end
+        end
+        
+        # Rho Pi
+        t = s[1]
+        24.times do |i|
+          j = PILN[i]
+          a[0] = s[j]
+          s[j] = rotate t, ROTC[i]
+          t = a[0]
+        end
+        
+        # Chi
+        0.step 24, 5 do |j|
+          5.times do |i|
+            a[i] = s[j + i]
+          end
+          
+          5.times do |i|
+            s[j + i] ^= ~a[(i + 1) % 5] & a[(i + 2) % 5]
+          end
+        end
+        
+        # Iota
+        s[0] ^= RNDC[round]
+      end
+    end
+    
+    def rotate x, y
+      (x << y | x >> 64 - y) & (1 << 64) - 1
+    end
+  end
+end

data/lib/sha3-pure-ruby/version.rb

@@ -0,0 +1,3 @@
+class SHA3
+  VERSION = '0.2.1'
+end

data/sha3-pure-ruby.gemspec

@@ -0,0 +1,21 @@
+# coding: utf-8
+lib = File.expand_path '../lib', __FILE__
+$:.unshift lib unless $:.include? lib
+require 'sha3-pure-ruby/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'keccak-pure-ruby'
+  spec.version       = SHA3::VERSION
+  spec.authors       = ['havenwood']
+  spec.email         = ['shannonskipper@gmail.com']
+  spec.description   = 'An implementation of SHA3 in pure Ruby.'
+  spec.summary       = 'Pure Ruby SHA3.'
+  spec.homepage      = 'https://github.com/havenwood/sha3-pure-ruby'
+  spec.license       = 'https://creativecommons.org/publicdomain/zero/1.0/'
+  spec.files         = `git ls-files`.split $/
+  # spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename f }
+  spec.test_files    = spec.files.grep %r{^(test)/}
+  spec.require_paths = ['lib']
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'minitest'
+end

data/test/test_sha3-pure-ruby.rb

@@ -0,0 +1,54 @@
+require File.expand_path '../../lib/sha3-pure-ruby', __FILE__
+require 'minitest/autorun'
+require 'minitest/pride'
+
+describe Digest::SHA3 do
+  describe 'default 512-bit' do
+    it 'should work when empty' do
+      empty_string_sha3 = '0eab42de4c3ceb9235fc91acffe746b29c29a8c366b7c60e4e67c466f36a4304c00fa9caf9d87976ba469bcbe06713b435f091ef2769fb160cdab33d3670680e'
+      assert_equal Digest::SHA3.new.hexdigest(''), empty_string_sha3
+    end
+    
+    it 'should work with content' do
+      cat_sha3 = "b2faf80c85bd36029dc3f804cbf439888fd1ca195ab0e3decb872f8aa9ef767e4866186ebb8b5ecfa1237147a94775f8302648be0fd0ae3a6ebbdf931f423360"
+      assert_equal Digest::SHA3.new.hexdigest('cat'), cat_sha3
+    end
+  end
+  
+  describe '384-bit' do
+    it 'should work when empty' do
+      empty_string_sha3 = '2c23146a63a29acf99e73b88f8c24eaa7dc60aa771780ccc006afbfa8fe2479b2dd2b21362337441ac12b515911957ff'
+      assert_equal Digest::SHA3.new(384).hexdigest(''), empty_string_sha3
+    end
+    
+    it 'should work with content' do
+      cat_sha3 = 'fbcae9b945da6967b622e93e5712dcd0b4df2f522a89b0a20b485684c02efcf9efafb699499b2328172cbf654b7721c5'
+      assert_equal Digest::SHA3.new(384).hexdigest('cat'), cat_sha3
+    end
+  end
+  
+  describe '256-bit' do
+    it 'should work when empty' do
+      empty_string_sha3 = 'c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470'
+      assert_equal Digest::SHA3.new(256).hexdigest(''), empty_string_sha3
+    end
+    
+    it 'should work with content' do
+      cat_sha3 = '52763589e772702fa7977a28b3cfb6ca534f0208a2b2d55f7558af664eac478a'
+      assert_equal Digest::SHA3.new(256).hexdigest('cat'), cat_sha3
+    end
+  end
+  
+  describe '224-bit' do
+    it 'should work when empty' do
+      empty_string_sha3 = 'f71837502ba8e10837bdd8d365adb85591895602fc552b48b7390abd'
+      assert_equal Digest::SHA3.new(224).hexdigest(''), empty_string_sha3
+    end
+    
+    it 'should work with content' do
+      cat_sha3 = "c3e4d225cefd1d01166d801f856907492b3bf8909a8a3a5bc922580f"
+      assert_equal Digest::SHA3.new(224).hexdigest('cat'), cat_sha3
+    end
+  end
+end
+    

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: keccak-pure-ruby
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: ruby
+authors:
+- havenwood
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-07-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: An implementation of SHA3 in pure Ruby.
+email:
+- shannonskipper@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- lib/sha3-pure-ruby.rb
+- lib/sha3-pure-ruby/version.rb
+- sha3-pure-ruby.gemspec
+- test/test_sha3-pure-ruby.rb
+homepage: https://github.com/havenwood/sha3-pure-ruby
+licenses:
+- https://creativecommons.org/publicdomain/zero/1.0/
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.3
+signing_key: 
+specification_version: 4
+summary: Pure Ruby SHA3.
+test_files:
+- test/test_sha3-pure-ruby.rb