ed-precompiled_ed25519 1.4.0

data/lib/ed25519/signing_key.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require "securerandom"
+
+module Ed25519
+  # Private key for producing digital signatures
+  class SigningKey
+    attr_reader :seed, :keypair, :verify_key
+
+    # Generate a random Ed25519 signing key (i.e. private scalar)
+    def self.generate
+      new SecureRandom.random_bytes(Ed25519::KEY_SIZE)
+    end
+
+    # Create a SigningKey from a 64-byte Ed25519 keypair (i.e. public + private)
+    #
+    # @param keypair [String] 64-byte keypair value containing both seed + public key
+    def self.from_keypair(keypair)
+      raise TypeError, "expected String, got #{keypair.class}" unless keypair.is_a?(String)
+      raise ArgumentError, "expected 64-byte String, got #{keypair.bytesize}" unless keypair.bytesize == 64
+
+      new(keypair[0, KEY_SIZE]).tap do |key|
+        raise ArgumentError, "corrupt keypair" unless keypair[KEY_SIZE, KEY_SIZE] == key.verify_key.to_bytes
+      end
+    end
+
+    # Create a new Ed25519::SigningKey from the given seed value
+    #
+    # @param seed [String] 32-byte seed value from which the key should be derived
+    def initialize(seed)
+      Ed25519.validate_key_bytes(seed)
+
+      @seed = seed
+      @keypair = Ed25519.provider.create_keypair(seed)
+      @verify_key = VerifyKey.new(@keypair[32, 32])
+    end
+
+    # Sign the given message, returning an Ed25519 signature
+    #
+    # @param message [String] message to be signed
+    #
+    # @return [String] 64-byte Ed25519 signature
+    def sign(message)
+      Ed25519.provider.sign(@keypair, message)
+    end
+
+    # String inspection that does not leak secret values
+    def inspect
+      to_s
+    end
+
+    # Return a bytestring representation of this signing key
+    #
+    # @return [String] signing key converted to a bytestring
+    def to_bytes
+      seed
+    end
+    alias to_str to_bytes
+  end
+end

data/lib/ed25519/verify_key.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Ed25519
+  # Public key for verifying digital signatures
+  class VerifyKey
+    # Create a Ed25519::VerifyKey from its serialized Twisted Edwards representation
+    #
+    # @param key [String] 32-byte string representing a serialized public key
+    def initialize(key)
+      Ed25519.validate_key_bytes(key)
+      @key_bytes = key
+    end
+
+    # Verify an Ed25519 signature against the message
+    #
+    # @param signature [String] 64-byte string containing an Ed25519 signature
+    # @param message [String] string containing message to be verified
+    #
+    # @raise Ed25519::VerifyError signature verification failed
+    #
+    # @return [true] message verified successfully
+    def verify(signature, message)
+      if signature.length != SIGNATURE_SIZE
+        raise ArgumentError, "expected #{SIGNATURE_SIZE} byte signature, got #{signature.length}"
+      end
+
+      return true if Ed25519.provider.verify(@key_bytes, signature, message)
+
+      raise VerifyError, "signature verification failed!"
+    end
+
+    # Return a compressed twisted Edwards coordinate representing the public key
+    #
+    # @return [String] bytestring serialization of this public key
+    def to_bytes
+      @key_bytes
+    end
+    alias to_str to_bytes
+
+    # Show hex representation of serialized coordinate in string inspection
+    def inspect
+      "#<#{self.class}:#{@key_bytes.unpack1('H*')}>"
+    end
+  end
+end

data/lib/ed25519/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Ed25519
+  VERSION = "1.4.0"
+end

data/lib/ed25519.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "ed25519/version"
+require "ed25519/signing_key"
+require "ed25519/verify_key"
+
+# The Ed25519 digital signatre algorithm
+# rubocop:disable Layout/LineLength
+module Ed25519
+  module_function
+
+  # Size of an Ed25519 key (public or private) in bytes
+  KEY_SIZE = 32
+
+  # Size of an Ed25519 signature in bytes
+  SIGNATURE_SIZE = 64
+
+  # Raised when a signature fails to verify
+  VerifyError = Class.new(StandardError)
+
+  # Raised when the built-in self-test fails
+  SelfTestFailure = Class.new(StandardError)
+
+  class << self
+    # Obtain the backend provider module used to perform signatures
+    attr_accessor :provider
+  end
+
+  # Select the Ed25519::Provider to use based on the current environment
+  if defined? JRUBY_VERSION
+    require "jruby"
+    require "ed25519_jruby"
+    self.provider = org.cryptorb.Ed25519Provider.createEd25519Module(JRuby.runtime)
+  else
+    ruby_version = /(\d+\.\d+)/.match(::RUBY_VERSION)
+    begin
+      require "#{ruby_version}/ed25519_ref10"
+    rescue LoadError
+      require 'ed25519_ref10'
+    end
+    self.provider = Ed25519::Provider::Ref10
+  end
+
+  # Ensure a serialized key meets the requirements
+  def validate_key_bytes(key_bytes)
+    raise TypeError, "expected String, got #{key_bytes.class}" unless key_bytes.is_a?(String)
+    return true if key_bytes.bytesize == KEY_SIZE
+
+    raise ArgumentError, "expected #{KEY_SIZE}-byte String, got #{key_bytes.bytesize}"
+  end
+
+  # Perform a self-test to ensure the selected provider is working
+  def self_test
+    signature_key = Ed25519::SigningKey.new("A" * 32)
+    raise SelfTestFailure, "failed to generate verify key correctly" unless signature_key.verify_key.to_bytes.unpack1("H*") == "db995fe25169d141cab9bbba92baa01f9f2e1ece7df4cb2ac05190f37fcc1f9d"
+
+    message = "crypto libraries should self-test on boot"
+    signature = signature_key.sign(message)
+    raise SelfTestFailure, "failed to generate correct signature" unless signature.unpack1("H*") == "c62c12a3a6cbfa04800d4be81468ef8aecd152a6a26a81d91257baecef13ba209531fe905a843e833c8b71cee04400fa2af3a29fef1152ece470421848758d0a"
+
+    verify_key = signature_key.verify_key
+    raise SelfTestFailure, "failed to verify a valid signature" unless verify_key.verify(signature, message)
+
+    bad_signature = "#{signature[0...63]}X"
+    ex = nil
+    begin
+      verify_key.verify(bad_signature, message)
+    rescue Ed25519::VerifyError => ex
+    end
+
+    raise SelfTestFailure, "failed to detect an invalid signature" unless ex.is_a?(Ed25519::VerifyError)
+  end
+end
+# rubocop:enable Layout/LineLength
+
+# Automatically run self-test when library loads
+Ed25519.self_test

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: ed-precompiled_ed25519
+version: !ruby/object:Gem::Version
+  version: 1.4.0
+platform: ruby
+authors:
+- Tony Arcieri
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: A Ruby binding to the Ed25519 elliptic curve public-key signature system
+  described in RFC 8032.
+email:
+- tony.arcieri@gmail.com
+executables: []
+extensions:
+- ext/ed25519_ref10/extconf.rb
+extra_rdoc_files:
+- README.md
+- ed25519.png
+files:
+- CHANGES.md
+- LICENSE
+- README.md
+- ed25519.png
+- ext/ed25519_jruby/LICENSE.txt
+- ext/ed25519_jruby/README.md
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/EdDSAEngine.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/EdDSAKey.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/EdDSAPrivateKey.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/EdDSAPublicKey.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/EdDSASecurityProvider.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/KeyFactory.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/KeyPairGenerator.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/Utils.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/Constants.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/Curve.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/Encoding.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/Field.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/FieldElement.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/GroupElement.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/ScalarOps.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/bigint/BigIntegerFieldElement.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/bigint/BigIntegerLittleEndianEncoding.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/bigint/BigIntegerScalarOps.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/bigint/package.html
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/ed25519/Ed25519FieldElement.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/ed25519/Ed25519LittleEndianEncoding.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/math/ed25519/Ed25519ScalarOps.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/spec/EdDSAGenParameterSpec.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/spec/EdDSANamedCurveSpec.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/spec/EdDSANamedCurveTable.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/spec/EdDSAParameterSpec.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/spec/EdDSAPrivateKeySpec.java
+- ext/ed25519_jruby/net/i2p/crypto/eddsa/spec/EdDSAPublicKeySpec.java
+- ext/ed25519_jruby/org/cryptorb/Ed25519Provider.java
+- ext/ed25519_ref10/api.h
+- ext/ed25519_ref10/base.h
+- ext/ed25519_ref10/base2.h
+- ext/ed25519_ref10/d.h
+- ext/ed25519_ref10/d2.h
+- ext/ed25519_ref10/ed25519_ref10.c
+- ext/ed25519_ref10/ed25519_ref10.h
+- ext/ed25519_ref10/extconf.rb
+- ext/ed25519_ref10/fe.c
+- ext/ed25519_ref10/fe.h
+- ext/ed25519_ref10/ge.c
+- ext/ed25519_ref10/ge.h
+- ext/ed25519_ref10/ge_add.h
+- ext/ed25519_ref10/ge_madd.h
+- ext/ed25519_ref10/ge_msub.h
+- ext/ed25519_ref10/ge_p2_dbl.h
+- ext/ed25519_ref10/ge_sub.h
+- ext/ed25519_ref10/keypair.c
+- ext/ed25519_ref10/open.c
+- ext/ed25519_ref10/pow22523.h
+- ext/ed25519_ref10/pow225521.h
+- ext/ed25519_ref10/sc.h
+- ext/ed25519_ref10/sc_muladd.c
+- ext/ed25519_ref10/sc_reduce.c
+- ext/ed25519_ref10/sha512.c
+- ext/ed25519_ref10/sha512.h
+- ext/ed25519_ref10/sign.c
+- ext/ed25519_ref10/sqrtm1.h
+- ext/ed25519_ref10/verify.c
+- lib/ed25519.rb
+- lib/ed25519/signing_key.rb
+- lib/ed25519/verify_key.rb
+- lib/ed25519/version.rb
+homepage: https://github.com/RubyCrypto/ed25519
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: An efficient digital signature library providing the Ed25519 algorithm
+test_files: []