sr25519 0.3.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9331720979c05775dd52810475846df3672445cf0da2d29369981d2cfe508ff2
-  data.tar.gz: 685a8d5100fe6b15c2bf4d0f808812fda0e50b7d1ffc2572bef13788fb945578
+  metadata.gz: b113b67bbe4a743dfe19a186d10bf4e12b929037e9f11c80628205d5d20a8d1a
+  data.tar.gz: fd5d5f843cdd92ceba67cb1128f410425810641fc417915bfeb1cf79d41088b4
 SHA512:
-  metadata.gz: c71efd717b9d1388cdc7722b7a284140fe8b846c0a172a3c2945e18507cd53298caa0a02534a1da901e600a11b7e560d875dbe8f6ae51596ce4843010a13c7e1
-  data.tar.gz: 6188e1bfdb5fe02a824d01824163b3ea8b98584f49eea535c5f3e87fe02035f16b7669e534e7e958800ba4bb4ed3dbe1c9af21ac6e22688b66ab4e5d509e98ff
+  metadata.gz: a54153363c366648db12f5b10f3afa383ba368d412623c813c095033832f7c74c07b7bfd9fcb373296aa227ac9fd93d2a90a8dea2d7c74ad843691d7d408e3b0
+  data.tar.gz: 18cf9d2b4f91774660e598e82114ec789bca49fcf2e29ecdd17cfc5b6c751edaf915c6a75d7717d1d2c229288ade84570ac625ed47a6c985aa81d89e3383cbcc

data/Gemfile.lock

@@ -1,9 +1,10 @@
 PATH
   remote: .
   specs:
-    sr25519 (0.3.0)
+    sr25519 (0.7.0)
       base58
       blake2b
+      ed25519 (~> 1.2, >= 1.2.4)
 
 GEM
   remote: https://rubygems.org/
@@ -11,6 +12,7 @@ GEM
     base58 (0.2.3)
     blake2b (0.10.0)
     diff-lcs (1.4.4)
+    ed25519 (1.2.4)
     ffi (1.15.4)
     rake (13.0.6)
     rspec (3.10.0)

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2021 xuxh
+Copyright (c) 2021 UniArts Network
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -22,21 +22,21 @@ Or install it yourself as:
 
 ## Usage
 
-1. Require ed25519.rb in your Ruby program:
+#### 1. Require ed25519.rb in your Ruby program:
 ```ruby
 require "sr25519"
 ```
 
-2.  Generate keypair
+#### 2. SR25519 Generate keypair
 
 ```ruby
 # seed is priviate key, is a hex string.
-# example: SR25519.sr25519_keypair_from_seed("0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e")
-keypaire = SR25519.sr25519_keypair_from_seed(seed)
+# example: SR25519.keypair_from_seed("0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e")
+keypair = SR25519.keypair_from_seed(seed)
 
 ```
 
-3. Generate public_key
+#### 3. SR25519 Generate public_key
 
 ```ruby
 public_key = SR25519.get_public_key_from_seed(seed)
@@ -46,30 +46,58 @@ public_key_str = public_key.to_s
 
 ```
 
-4. Encode address
+#### 4. Encode address
 ```ruby
 address = Address.encode(public_key.to_s)
 ```
 
-5. Decode address
+#### 5. Decode address
 
 ```ruby
-address = Address.decode(address)
+public_key_str = Address.decode(address)
 ```
 
-6. Sign message
+#### 6. SR25519 Sign message
 
 ```ruby
+# message = "Hello World"
 signature_result = SR25519.sign(message, keypair)
 
 ```
 
-7. Verify message
+#### 7. SR25519 Verify message
 
 ```ruby
-SR25519.verify(address, message, signature_result)
+verify_result = SR25519.verify(address, message, signature_result)
 ```
 
+#### 8.  ED25519 Generate keypair
+
+```ruby
+keypair = ED25519.keypair_from_seed(seed)
+```
+
+#### 9.  ED25519 Sign message
+
+```ruby
+signature_result = ED25519.sign(message, keypair)
+```
+
+#### 10. ED25519 Get public key
+
+```ruby
+pulick_key_str = ED25519.get_public_key_from_seed(seed)
+```
+
+#### 11. ED25519 Verify message
+
+```ruby
+# public_key_str = ED25519.get_public_key_from_seed(seed)
+# address = Address.encode(public_key_str)
+verify_result = ED25519.verify(address, message, signature_result)
+```
+
+
 ## Running tests
 1. Run all tests
 

data/lib/address.rb

@@ -1,7 +1,30 @@
+
+# The MIT License (MIT)
+
+# Copyright (c) 2019 Wu Minzhe
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
 require 'base58'
 require 'blake2b'
 
- # The code is copy from https://github.com/itering/scale.rb/blob/develop/lib/common.rb
+# The code is copy from https://github.com/itering/scale.rb/blob/develop/lib/common.rb
 class Address
     SS58_PREFIX = 'SS58PRE'
   

data/lib/ed25519_lib.rb

@@ -0,0 +1,68 @@
+require "ed25519"
+class ED25519
+  
+  ##
+  # Sign the given message, Return sign result as hex string
+  # ==== Examples
+  #   message = "Hello world"
+  #   seed = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   keypair = ED25519.keypair_from_seed(seed)
+  #   signature_result = ED25519.sign(message, keypair)
+
+  def self.sign(message, key_pair)
+    "0x" + key_pair.sign(message).unpack1("H*")
+  end
+
+  ##
+  # Verify the sign result, Return true or false
+  # ==== Examples
+  #   message = "Hello world"
+  #   seed = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   public_key = ED25519.get_public_key_from_seed(seed)
+  #   address = Address.encode(public_key)
+  #   keypair = ED25519.keypair_from_seed(seed)
+  #   signature_result = ED25519.sign(message, keypair)
+  #   verify_result = ED25519.verify(address, message, signature_result)
+
+  def self.verify(address, message, signature_result)
+    if signature_result.start_with?("0x")
+      signature_result = signature_result.sub(/0x/, "")
+    end
+    signature = [signature_result].pack("H*")
+    public_key = Address.decode(address)
+    verify_key_bytes = [public_key].pack("H*")
+    verify_key  = Ed25519::VerifyKey.new(verify_key_bytes)
+    begin
+      verify_key.verify(signature, message)
+    rescue
+      return false
+    end
+  end
+
+  ##
+  # Generate ED25519 keypair
+  # ==== Examples
+  #   seed = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   keypair = ED25519.keypair_from_seed(seed)
+
+  def self.keypair_from_seed(seed)
+    if seed.start_with?("0x")
+      seed = seed.sub(/0x/, "")
+    end
+    seed = "".tap { |binary| seed.scan(/../) { |hn| binary << hn.to_i(16).chr } }
+    signing_key = Ed25519::SigningKey.new(seed)
+    return signing_key
+  end
+
+  ##
+  # Get ED25519 public key, return as hex string
+  # ==== Examples
+  #   seed = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   public_key = ED25519.get_public_key_from_seed(seed)
+
+  def self.get_public_key_from_seed(seed)
+    signing_key = self.keypair_from_seed(seed)
+    return signing_key.verify_key.to_bytes.unpack1('H*')
+  end
+
+end

data/lib/sr25519/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sr25519
-  VERSION = "0.3.0"
+  VERSION = "0.7.0"
 end

data/lib/sr25519.rb

@@ -3,6 +3,7 @@
 require_relative "sr25519/version"
 require "address"
 require "sr25519_lib"
+require "ed25519_lib"
 
 module Sr25519
   class Error < StandardError; end

data/lib/sr25519_lib.rb

@@ -5,9 +5,8 @@ module SR25519Lib
  
   ffi_lib FFI::Library::LIBC
 
-  # The library is compile from https://github.com/Warchant/sr25519-crust
-  ffi_lib [File.expand_path('lib/libsr25519crust.so')] if RUBY_PLATFORM =~ /linux/
-  ffi_lib [File.expand_path('lib/libsr25519crust.dylib')] if RUBY_PLATFORM =~ /darwin/
+  ffi_lib File.dirname(__FILE__) + '/libsr25519crust.so' if RUBY_PLATFORM =~ /linux/
+  ffi_lib File.dirname(__FILE__) + '/libsr25519crust.dylib' if RUBY_PLATFORM =~ /darwin/
 
   attach_function :sr25519_keypair_from_seed, [:pointer, :pointer], :void
   attach_function :sr25519_verify, [:pointer, :pointer, :uint, :pointer], :bool
@@ -19,6 +18,8 @@ class KeyPair < FFI::Struct
   # [32b key | 32b nonce | 32b public]
   layout :String, [:uint8, 96]
 
+  ##
+  # Return the keypair public key
   def public_key
     pub_key = self[:String].to_a[64..96]
     public_key = PublicKey.new
@@ -55,6 +56,8 @@ end
 class SigMessage < FFI::Struct
   layout :String, [:uint8, 64]
 
+  ##
+  # Return the sign message as hex string
   def to_s
     self[:String].to_a.pack("c*").unpack1("H*")
   end
@@ -62,17 +65,28 @@ end
 
 class SR25519
 
+  ##
+  # Return the sign message result as hex string
+  # ==== Examples
+  #   message = "Hello World"
+  #   private_key = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   signature_result = SR25519.sr25519_sign(message, private_key)
   def self.sr25519_sign(message, private_key)
     sig = SigMessage.new
     msg = FFI::MemoryPointer.from_string(message)
-    key_pair = self.sr25519_keypair_from_seed(private_key)
+    key_pair = self.keypair_from_seed(private_key)
     public_key = key_pair.public_key
     SR25519Lib.sr25519_sign(sig, public_key, key_pair, msg, message.length)
     sig.to_s
   end
 
-
-  # Creates a signature for given data
+  ##
+  # Return the sign message result as hex string
+  # ==== Examples
+  #   message = "Hello World"
+  #   seed = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   keypair = SR25519.keypair_from_seed(seed)
+  #   signature_result = SR25519.sign(message, keypair)
   def self.sign(message, key_pair)
     sig = SigMessage.new
     msg = FFI::MemoryPointer.from_string(message)
@@ -81,6 +95,16 @@ class SR25519
     sig.to_s
   end
 
+  ##
+  # Verify the sign result, Return true or false
+  # ==== Examples
+  #   message = "Hello World"
+  #   seed = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   keypair = SR25519.keypair_from_seed(seed)
+  #   public_key = SR25519.get_public_key_from_seed(seed)
+  #   address = Address.encode(public_key.to_s)
+  #   signature_result = SR25519.sign(message, keypair)
+  #   verify_result = SR25519.verify(address, message, signature_result)
   def self.verify(address, message, signature_result)
     pk = PublicKey.new
     public_key = self.decode_address(address)
@@ -97,7 +121,12 @@ class SR25519
     verify = SR25519Lib.sr25519_verify(sig, msg, message.size, pk)
   end
 
-  def self.sr25519_keypair_from_seed(seed)
+  ##
+  # Generate SR25519 keypair
+  # ==== Examples
+  #   seed = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   keypair = SR25519.keypair_from_seed(seed)
+  def self.keypair_from_seed(seed)
     if seed.start_with?("0x")
       seed = seed.sub(/0x/, "")
     end
@@ -109,11 +138,23 @@ class SR25519
     return key_pair
   end
 
+  ##
+  # Get SR25519 public key, need call to_s to get hex string
+  # ==== Examples
+  #   seed = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   public_key = SR25519.get_public_key_from_seed(seed)
   def self.get_public_key_from_seed(seed)
-    key_pair = self.sr25519_keypair_from_seed(seed)
+    key_pair = self.keypair_from_seed(seed)
     key_pair.public_key
   end
 
+  ##
+  # Get public from address
+  # ==== Examples
+  #   seed = "0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e"
+  #   public_key = SR25519.get_public_key_from_seed(seed)
+  #   address = Address.encode(public_key.to_s)
+  #   public_key = SR25519.decode_address(address)
   def self.decode_address(address,addr_type=42)
     public_address = Address.decode(address,addr_type)
   end

data/sr25519.gemspec

@@ -34,5 +34,5 @@ Gem::Specification.new do |spec|
   spec.add_dependency "blake2b"
   spec.add_dependency "base58"
   spec.add_development_dependency "ffi", "~> 1.15.0"
-
+  spec.add_dependency "ed25519", '~> 1.2', '>= 1.2.4'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sr25519
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.7.0
 platform: ruby
 authors:
 - xuxh
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-10-11 00:00:00.000000000 Z
+date: 2021-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -80,6 +80,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.15.0
+- !ruby/object:Gem::Dependency
+  name: ed25519
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.4
 description: Sign and verify message with sr25519
 email:
 - xxh2611@gmail.com
@@ -100,6 +120,7 @@ files:
 - bin/console
 - bin/setup
 - lib/address.rb
+- lib/ed25519_lib.rb
 - lib/libsr25519crust.dylib
 - lib/libsr25519crust.so
 - lib/sr25519.rb