sha3 0.2.5 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 035f7085d22a6bccff51be3775cde1b8aa61ff9a
-  data.tar.gz: 52abae3fab52ae7634b0ad016d81e69895f98227
+SHA256:
+  metadata.gz: 2abc34b466bf79618721bac7202c2e4c2617175a74843ae4e059e698da1bb813
+  data.tar.gz: c805b46df9491e191022164606330d1b4d8bb709470399558da0d8272041e210
 SHA512:
-  metadata.gz: 18aeef47b4c1fb4a79ada7b4ea00323d47f9404d58c74b37586a858a2561727c944eb9ac778a6a673574c02dc4ad7e93535c4cd8ee1bf8b9b7db12c154cbdaf7
-  data.tar.gz: fb635f1a539f597a0b6c74d9c74f3d0eff3862349df27b7212806e93c9f1ad0e2b16a6bef17ba38f5089b52846ce2912d95d5ef6fab8084547e4e95ba42887e3
+  metadata.gz: 61f430b210275ae079d8ce0baf13841b02fe817ff4ee80215eb99578920d1bff3131b453ec7bf80426b11607302404705cc55a017a0e19bded58485755f9d492
+  data.tar.gz: 475662e0c8a0d74b9222152a9b98bfed02bcb385551f212cac5cdc23e5e9a2eccc99ffb1c7bb101b1ca50fb55c3614d4e17d63b267a1ef4864339998df90f2c7

data/.gitignore

@@ -1,22 +1,234 @@
+
+# Created by https://www.toptal.com/developers/gitignore/api/c,clion,visualstudiocode,ruby
+# Edit at https://www.toptal.com/developers/gitignore?templates=c,clion,visualstudiocode,ruby
+
+### C ###
+# Prerequisites
+*.d
+
+# Object files
+*.o
+*.ko
+*.obj
+*.elf
+
+# Linker output
+*.ilk
+*.map
+*.exp
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Libraries
+*.lib
+*.a
+*.la
+*.lo
+
+# Shared objects (inc. Windows DLLs)
+*.dll
+*.so
+*.so.*
+*.dylib
+
+# Executables
+*.exe
+*.out
+*.app
+*.i*86
+*.x86_64
+*.hex
+
+# Debug files
+*.dSYM/
+*.su
+*.idb
+*.pdb
+
+# Kernel Module Compile Results
+*.mod*
+*.cmd
+.tmp_versions/
+modules.order
+Module.symvers
+Mkfile.old
+dkms.conf
+
+### CLion ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### CLion Patch ###
+# Comment Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-215987721
+
+# *.iml
+# modules.xml
+# .idea/misc.xml
+# *.ipr
+
+# Sonarlint plugin
+# https://plugins.jetbrains.com/plugin/7973-sonarlint
+.idea/**/sonarlint/
+
+# SonarQube Plugin
+# https://plugins.jetbrains.com/plugin/7238-sonarqube-community-plugin
+.idea/**/sonarIssues.xml
+
+# Markdown Navigator plugin
+# https://plugins.jetbrains.com/plugin/7896-markdown-navigator-enhanced
+.idea/**/markdown-navigator.xml
+.idea/**/markdown-navigator-enh.xml
+.idea/**/markdown-navigator/
+
+# Cache file creation bug
+# See https://youtrack.jetbrains.com/issue/JBR-2257
+.idea/$CACHE_FILE$
+
+# CodeStream plugin
+# https://plugins.jetbrains.com/plugin/12206-codestream
+.idea/codestream.xml
+
+### Ruby ###
 *.gem
 *.rbc
-*.rbx
-*.bundle
-*.so
-*.dll
-.config
-coverage
-InstalledFiles
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-
-# YARD artifacts
-.yardoc
-_yardoc
-doc/
-Gemfile.lock
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Ignore Byebug command history file.
+.byebug_history
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*
+
+### Ruby Patch ###
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*
+
+### VisualStudioCode ###
+.vscode/*
+!.vscode/tasks.json
+!.vscode/launch.json
+*.code-workspace
+
+### VisualStudioCode Patch ###
+# Ignore all local history of files
+.history
+.ionide
+
+# End of https://www.toptal.com/developers/gitignore/api/c,clion,visualstudiocode,ruby

data/.travis.yml

@@ -1,15 +1,21 @@
-language: ruby
-rvm:
-  - 2.0.0
-  - 1.9.3
-  - 1.9.2
-  - 1.8.7
-  - ruby-head
-  - rbx-18mode
-  - rbx-19mode
-
-gemfile: Gemfile.ci
+arch:
+  - amd64
+  - arm64 
 
 branches:
   only:
-    - master
+    - master
+    - develop
+
+gemfile: Gemfile.ci
+
+language: ruby
+
+os:
+  - linux
+
+rvm:
+  - ruby-head
+  - 2.7
+  - 2.6
+  - 2.5

data/Gemfile

@@ -1,3 +1,3 @@
-source "http://rubygems.org"
+source 'http://rubygems.org'
 
 gemspec

data/Gemfile.ci

@@ -1,8 +1,8 @@
-source "http://rubygems.org"
+source 'http://rubygems.org'
 
 gemspec
 
-gem 'rubygems-tasks', '> 0.2'
-gem 'rake', '> 0.9'
-gem 'rspec', '~> 2.11'
-gem 'yard', '~> 0.8'
+gem 'rake'
+gem 'rspec'
+gem 'rubygems-tasks'
+gem 'yard'

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2012 Johanns Gregorian
+Copyright (c) 2015 Johanns Gregorian
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,120 @@
+# sha3  
+
+[![Gem Version](https://badge.fury.io/rb/sha3.svg)](https://badge.fury.io/rb/sha3) [![CI](https://secure.travis-ci.org/johanns/sha3.png)](https://secure.travis-ci.org/johanns/sha3) [![CodeClimate](https://codeclimate.com/github/johanns/sha3.png)](https://codeclimate.com/github/johanns/sha3)
+
+**SHA3 for Ruby** is a native (C) binding to SHA3 (Keccak FIPS 202) cryptographic hashing algorithm.
+
+- [Home](https://github.com/johanns/sha3#readme)
+- [Issues](https://github.com/johanns/sha3/issues)
+- [Documentation](http://rubydoc.info/gems/sha3/frames)
+
+## Warnings
+
+- Please do NOT use SHA3 to hash passwords -- use a slow hashing function instead (e.g.: `pbkdf2`, `argon2`, `bcrypt` or `scrypt`)
+- Version 1.0 introduces new API and is incompatible with previous versions (0.x).
+
+## Module details
+
+**SHA3::Digest**: A standard *Digest* _subclass_. The interface, and operation of this class are parallel to digest classes bundled with MRI-based Rubies (e.g.: **Digest::SHA2**, and **OpenSSL::Digest**).
+
+See [documentation for Ruby's **Digest** class for additional details](http://www.ruby-doc.org/stdlib-2.2.3/libdoc/digest/rdoc/Digest.html).
+
+## Installation
+
+```shell
+gem install sha3
+```
+
+## Usage
+
+```ruby
+require 'sha3'
+```
+
+Valid hash bit-lengths are: *224*, *256*, *384*, *512*.
+
+```ruby
+:sha224  :sha256  :sha384  :sha512
+
+# SHA3::Digest.new(224) is SHA3::Digest.new(:sha224)
+```
+
+Alternatively, you can instantiate using one of four sub-classes:
+
+```ruby
+SHA3::Digest::SHA224.new() # 224 bits
+SHA3::Digest::SHA256.new() # 256 bits
+SHA3::Digest::SHA384.new() # 384 bits
+SHA3::Digest::SHA512.new() # 512 bits
+```
+
+### Basics
+
+```ruby
+# Instantiate a new SHA3::Digest class with 256 bit length
+s = SHA3::Digest.new(:sha256)
+
+# OR #
+
+s = SHA3::Digest::SHA256.new()
+
+# Update hash state, and compute new value
+s.update "Compute Me"
+
+# << is an .update() alias
+s << "Me too"
+
+# Returns digest value in bytes
+s.digest
+# => "\xBE\xDF\r\xD9\xA1..."
+
+# Returns digest value as hex string
+s.hexdigest
+# => "bedf0dd9a15b647..."
+
+### Digest class-methods: ###
+
+SHA3::Digest.hexdigest(:sha224, "Hash me, please")
+# => "200e7bc18cd613..."
+
+SHA3::Digest::SHA384.digest("Hash me, please")
+# => "\xF5\xCEpC\xB0eV..."
+```
+
+### Hashing a file
+
+```ruby
+# Compute the hash value for given file, and return the result as hex
+s = SHA3::Digest::SHA224.file("my_fantastical_file.bin").hexdigest
+
+# Calling SHA3::Digest.file(...) defaults to SHA256
+s = SHA3::Digest.file("tests.sh")
+# => #<SHA3::Digest: a9801db49389339...>
+```
+
+## Development
+
+* Native build tools (e.g., GCC, Minigw, etc.)
+* Gems: rubygems-tasks, rake, rspec, yard
+
+### Testing
+
+Call ```rake``` to run the included RSpec tests.
+
+Only a small subset of test vectors are included in the source repository; however, the complete test vectors suite is available for download. Simply run the ```tests.sh``` shell script (available in the root of source directory) to generate full byte-length RSpec test files.
+
+  ```sh tests.sh```
+
+### Rubies
+
+Supported Ruby versions:
+
+  - MRI Ruby 2.4 - 3.0
+
+
+
+## Copyright
+
+Copyright (c) 2012 - 2020 Johanns Gregorian (https://github.com/johanns)
+
+**See LICENSE.txt for details.**

data/Rakefile

@@ -1,43 +1,41 @@
-# encoding: utf-8
-
 require 'rubygems'
 require 'rake'
 
 begin
-  gem 'rubygems-tasks', '~> 0.2'
+  gem 'rubygems-tasks'
   require 'rubygems/tasks'
 
   Gem::Tasks.new
 rescue LoadError => e
   warn e.message
-  warn "Run `gem install rubygems-tasks` to install Gem::Tasks."
+  warn 'Run `gem install rubygems-tasks` to install Gem::Tasks.'
 end
 
 begin
-  gem 'rspec', '~> 2.4'
+  gem 'rspec'
   require 'rspec/core/rake_task'
 
   RSpec::Core::RakeTask.new
-rescue LoadError => e
+rescue LoadError
   task :spec do
-    abort "Please run `gem install rspec` to install RSpec."
+    abort 'Please run `gem install rspec` to install RSpec.'
   end
 end
 
-task :test    => :spec
-task :default => [:compile, :spec]
+task test: :spec
+task default: %i[compile spec]
 
 begin
-  gem 'yard', '~> 0.8'
+  gem 'yard'
   require 'yard'
 
-  YARD::Rake::YardocTask.new  
-rescue LoadError => e
+  YARD::Rake::YardocTask.new
+rescue LoadError
   task :yard do
-    abort "Please run `gem install yard` to install YARD."
+    abort 'Please run `gem install yard` to install YARD.'
   end
 end
-task :doc => :yard
+task doc: :yard
 
 begin
   gem 'rake-compiler'
@@ -47,11 +45,10 @@ begin
     ext.name = 'sha3_n'
     ext.ext_dir = 'ext/sha3'
     ext.tmp_dir = 'tmp'
-    ext.source_pattern = "*.{c}"
+    ext.source_pattern = '*.{c}'
   end
-rescue LoadError => e
+rescue LoadError
   task :compile do
-    abort "Please run `gem install rake-compiler` to install Rake-Compiler."
+    abort 'Please run `gem install rake-compiler` to install Rake-Compiler.'
   end
 end
-

data/ext/sha3/KeccakF-1600-interface.h

@@ -1,46 +1,40 @@
 /*
-The Keccak sponge function, designed by Guido Bertoni, Joan Daemen,
-Michaël Peeters and Gilles Van Assche. For more information, feedback or
-questions, please refer to our website: http://keccak.noekeon.org/
+Implementation by the Keccak, Keyak and Ketje Teams, namely, Guido Bertoni,
+Joan Daemen, Michaël Peeters, Gilles Van Assche and Ronny Van Keer, hereby
+denoted as "the implementer".
 
-Implementation by the designers,
-hereby denoted as "the implementer".
+For more information, feedback or questions, please refer to our websites:
+http://keccak.noekeon.org/
+http://keyak.noekeon.org/
+http://ketje.noekeon.org/
 
 To the extent possible under law, the implementer has waived all copyright
 and related or neighboring rights to the source code in this file.
 http://creativecommons.org/publicdomain/zero/1.0/
 */
 
-#ifndef _KeccakPermutationInterface_h_
-#define _KeccakPermutationInterface_h_
+#ifndef _KeccakF1600Interface_h_
+#define _KeccakF1600Interface_h_
 
-#include "KeccakF-1600-int-set.h"
+#include <string.h>
 
-void KeccakInitialize( void );
-void KeccakInitializeState(unsigned char *state);
-void KeccakPermutation(unsigned char *state);
-#ifdef ProvideFast576
-void KeccakAbsorb576bits(unsigned char *state, const unsigned char *data);
-#endif
-#ifdef ProvideFast832
-void KeccakAbsorb832bits(unsigned char *state, const unsigned char *data);
-#endif
-#ifdef ProvideFast1024
-void KeccakAbsorb1024bits(unsigned char *state, const unsigned char *data);
-#endif
-#ifdef ProvideFast1088
-void KeccakAbsorb1088bits(unsigned char *state, const unsigned char *data);
-#endif
-#ifdef ProvideFast1152
-void KeccakAbsorb1152bits(unsigned char *state, const unsigned char *data);
-#endif
-#ifdef ProvideFast1344
-void KeccakAbsorb1344bits(unsigned char *state, const unsigned char *data);
-#endif
-void KeccakAbsorb(unsigned char *state, const unsigned char *data, unsigned int laneCount);
-#ifdef ProvideFast1024
-void KeccakExtract1024bits(const unsigned char *state, unsigned char *data);
-#endif
-void KeccakExtract(const unsigned char *state, unsigned char *data, unsigned int laneCount);
+#define KeccakF_width 1600
+#define KeccakF_laneInBytes 8
+#define KeccakF_stateSizeInBytes (KeccakF_width/8)
+#define KeccakF_1600
+
+void KeccakF1600_Initialize( void );
+void KeccakF1600_StateInitialize(void *state);
+void KeccakF1600_StateXORBytes(void *state, const unsigned char *data, unsigned int offset, unsigned int length);
+void KeccakF1600_StateOverwriteBytes(void *state, const unsigned char *data, unsigned int offset, unsigned int length);
+void KeccakF1600_StateOverwriteWithZeroes(void *state, unsigned int byteCount);
+void KeccakF1600_StateComplementBit(void *state, unsigned int position);
+void KeccakF1600_StatePermute(void *state);
+void KeccakF1600_StateExtractBytes(const void *state, unsigned char *data, unsigned int offset, unsigned int length);
+void KeccakF1600_StateExtractAndXORBytes(const void *state, unsigned char *data, unsigned int offset, unsigned int length);
+size_t KeccakF1600_FBWL_Absorb(void *state, unsigned int laneCount, const unsigned char *data, size_t dataByteLen, unsigned char trailingBits);
+size_t KeccakF1600_FBWL_Squeeze(void *state, unsigned int laneCount, unsigned char *data, size_t dataByteLen);
+size_t KeccakF1600_FBWL_Wrap(void *state, unsigned int laneCount, const unsigned char *dataIn, unsigned char *dataOut, size_t dataByteLen, unsigned char trailingBits);
+size_t KeccakF1600_FBWL_Unwrap(void *state, unsigned int laneCount, const unsigned char *dataIn, unsigned char *dataOut, size_t dataByteLen, unsigned char trailingBits);
 
 #endif

data/ext/sha3/KeccakHash.c

@@ -0,0 +1,80 @@
+/*
+Implementation by the Keccak, Keyak and Ketje Teams, namely, Guido Bertoni,
+Joan Daemen, Michaël Peeters, Gilles Van Assche and Ronny Van Keer, hereby
+denoted as "the implementer".
+
+For more information, feedback or questions, please refer to our websites:
+http://keccak.noekeon.org/
+http://keyak.noekeon.org/
+http://ketje.noekeon.org/
+
+To the extent possible under law, the implementer has waived all copyright
+and related or neighboring rights to the source code in this file.
+http://creativecommons.org/publicdomain/zero/1.0/
+*/
+
+#include <string.h>
+#include "KeccakHash.h"
+
+/* ---------------------------------------------------------------- */
+
+HashReturn Keccak_HashInitialize(Keccak_HashInstance *instance, unsigned int rate, unsigned int capacity, unsigned int hashbitlen, unsigned char delimitedSuffix)
+{
+    HashReturn result;
+
+    if (delimitedSuffix == 0)
+        return FAIL;
+    result = (HashReturn)Keccak_SpongeInitialize(&instance->sponge, rate, capacity);
+    if (result != SUCCESS)
+        return result;
+    instance->fixedOutputLength = hashbitlen;
+    instance->delimitedSuffix = delimitedSuffix;
+    return SUCCESS;
+}
+
+/* ---------------------------------------------------------------- */
+
+HashReturn Keccak_HashUpdate(Keccak_HashInstance *instance, const BitSequence *data, DataLength databitlen)
+{
+    if ((databitlen % 8) == 0)
+        return (HashReturn)Keccak_SpongeAbsorb(&instance->sponge, data, databitlen/8);
+    else {
+        HashReturn ret = (HashReturn)Keccak_SpongeAbsorb(&instance->sponge, data, databitlen/8);
+        if (ret == SUCCESS) {
+            // The last partial byte is assumed to be aligned on the least significant bits
+            unsigned char lastByte = data[databitlen/8];
+            // Concatenate the last few bits provided here with those of the suffix
+            unsigned short delimitedLastBytes = (unsigned short)lastByte | ((unsigned short)instance->delimitedSuffix << (databitlen % 8));
+            if ((delimitedLastBytes & 0xFF00) == 0x0000) {
+                instance->delimitedSuffix = delimitedLastBytes & 0xFF;
+            }
+            else {
+                unsigned char oneByte[1];
+                oneByte[0] = delimitedLastBytes & 0xFF;
+                ret = (HashReturn)Keccak_SpongeAbsorb(&instance->sponge, oneByte, 1);
+                instance->delimitedSuffix = (delimitedLastBytes >> 8) & 0xFF;
+            }
+        }
+        return ret;
+    }
+}
+
+/* ---------------------------------------------------------------- */
+
+HashReturn Keccak_HashFinal(Keccak_HashInstance *instance, BitSequence *hashval)
+{
+    HashReturn ret = (HashReturn)Keccak_SpongeAbsorbLastFewBits(&instance->sponge, instance->delimitedSuffix);
+    if (ret == SUCCESS)
+        return (HashReturn)Keccak_SpongeSqueeze(&instance->sponge, hashval, instance->fixedOutputLength/8);
+    else
+        return ret;
+}
+
+/* ---------------------------------------------------------------- */
+
+HashReturn Keccak_HashSqueeze(Keccak_HashInstance *instance, BitSequence *data, DataLength databitlen)
+{
+    if ((databitlen % 8) != 0)
+        return FAIL;
+    return (HashReturn)Keccak_SpongeSqueeze(&instance->sponge, data, databitlen/8);
+}