x25519 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ea3f150ae564aadb87e3bb463b2f4b7d8d8756b9
-  data.tar.gz: be24c272b97043d3f1385def5543fca88b9ff859
+  metadata.gz: fb37496fe14ef2bf58826e5b30805597b7031c5b
+  data.tar.gz: 02e5d45c634da965b9d351da48c1213f16de2eb0
 SHA512:
-  metadata.gz: 2b598f77e90d1fafbcb0b820d29966ba259a68c3bc1b44674f955a6ccbf010c30a8cc4339321bb55ddc3d27b3b3bce5e19ff1b4540855ee81235e8a55bf85675
-  data.tar.gz: 577ed0233e0a4a73452798c344531df9fbb498625c85526c02ca6658782559dce24538574b23a8eafb2f5adaf500331243ebd0a29dfb80a5bef6c03ee264c2e8
+  metadata.gz: f8c40748f5937cba15380f71e729924764ee8e50f2992aff31ae91100d3efad634ee03ba51da02a62d4de5f243e56c7fc31af47d615b4b4a492df7f5ab937e43
+  data.tar.gz: afae5c90642ae8eeec06c2e107d522f0da19b4b74f6c6b22cd386ffe6590ec8bcab665b1affd136505a38a0b1aed3011d6034a9f7ce392bd106f3f2321492858

data/CHANGES.md

@@ -1,3 +1,11 @@
+# [1.0.2] (2017-12-13)
+
+[1.0.2]: https://github.com/cryptosphere/x25519/compare/v1.0.1...v1.0.2
+
+* [#9](https://github.com/cryptosphere/x25519/pull/9)
+  Make `X25519.provider` an `attr_accessor`
+* Raise `X25519::SelfTestFailure` when self-test fails
+
 # [1.0.1] (2017-12-12)
 
 [1.0.1]: https://github.com/cryptosphere/x25519/compare/v1.0.0...v1.0.1

data/README.md

@@ -18,9 +18,15 @@ high performance [rfc7748_precomputed] implementation based on the paper
 [How to (pre-)compute a ladder]
 (with fallback to the ref10 C implementation).
 
+X25519 is one of two notable algorithms implemented atop the Curve25519
+elliptic curve. The [ed25519 gem] is a related project of this one,
+and implements the Ed25519 signature scheme on the twisted Edwards form of
+Curve25519.
+
 [RFC7748]: https://tools.ietf.org/html/rfc7748
 [How to (pre-)compute a ladder]: https://eprint.iacr.org/2017/264
 [rfc7748_precomputed]: https://github.com/armfazh/rfc7748_precomputed
+[ed25519 gem]: https://github.com/cryptosphere/ed25519
 
 ## Requirements
 

data/ext/x25519_precomputed/x25519_precomputed.h

@@ -15,8 +15,8 @@
  * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
 */
-#ifndef RFC7748_PRECOMPUTED_H
-#define RFC7748_PRECOMPUTED_H
+#ifndef X25519_PRECOMPUTED_H
+#define X25519_PRECOMPUTED_H
 
 #include <stdint.h>
 
@@ -34,4 +34,4 @@ void x25519_precomputed_scalarmult(uint8_t *shared, uint8_t *private_key, uint8_
 void x25519_precomputed_scalarmult_base(uint8_t *session_key, uint8_t *private_key);
 int check_4th_gen_intel_core_features();
 
-#endif /* RFC7748_PRECOMPUTED_H */
+#endif /* X25519_PRECOMPUTED_H */

data/ext/x25519_ref10/x25519_ref10.h

@@ -1,5 +1,5 @@
-#ifndef RFC7748_REF10_H
-#define RFC7748_REF10_H
+#ifndef X25519_REF10_H
+#define X25519_REF10_H
 
 #include <stdint.h>
 
@@ -12,4 +12,4 @@ int x25519_ref10_scalarmult(uint8_t *q, const uint8_t *n, const uint8_t *p);
 /* Variable-base scalar multiplication */
 int x25519_ref10_scalarmult_base(uint8_t *q, const uint8_t *n);
 
-#endif /* RFC7748_REF10_H */
+#endif /* X25519_REF10_H */

data/lib/x25519.rb

@@ -19,18 +19,21 @@ module X25519
   # Size of an X25519 key (public or private) in bytes
   KEY_SIZE = 32
 
+  # Raised when the built-in self-test fails
+  SelfTestFailure = Class.new(StandardError)
+
+  class << self
+    # Obtain the backend provider module
+    attr_accessor :provider
+  end
+
   # ref10 is the default provider
-  @provider = X25519::Provider::Ref10
+  self.provider = X25519::Provider::Ref10
 
   # X25519::Precomputed requires a 4th generation Intel Core CPU or newer,
   # so only enable it if we detect we're on a supported platform. Otherwise,
   # fall back to the ref10 portable C implementation.
-  @provider = X25519::Provider::Precomputed if X25519::Provider::Precomputed.available?
-
-  # Selected provider based on the logic above
-  def provider
-    @provider
-  end
+  self.provider = X25519::Provider::Precomputed if X25519::Provider::Precomputed.available?
 
   # Raw Diffie-Hellman function that acts directly on bytestrings. An
   # alternative to the object-oriented API
@@ -56,12 +59,12 @@ module X25519
   def self_test
     X25519::TestVectors::VARIABLE_BASE.each do |v|
       shared_secret = provider.scalarmult([v.scalar].pack("H*"), [v.input_coord].pack("H*"))
-      raise "self test failed!" unless shared_secret.unpack("H*").first == v.output_coord
+      raise SelfTestFailure, "self test failed!" unless shared_secret.unpack("H*").first == v.output_coord
     end
 
     X25519::TestVectors::FIXED_BASE.each do |v|
       public_key = provider.scalarmult_base([v.scalar].pack("H*"))
-      raise "self test failed!" unless public_key.unpack("H*").first == v.output_coord
+      raise SelfTestFailure, "self test failed!" unless public_key.unpack("H*").first == v.output_coord
     end
 
     true

data/lib/x25519/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module X25519
-  VERSION = "1.0.1"
+  VERSION = "1.0.2"
 end

data/x25519.gemspec

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
-lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "x25519/version"
+require File.expand_path("lib/x25519/version", __dir__)
 
 Gem::Specification.new do |spec|
   spec.name          = "x25519"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: x25519
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - Tony Arcieri
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-12-12 00:00:00.000000000 Z
+date: 2017-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler