nostr 0.3.0 → 0.5.0

data/lib/nostr/events/encrypted_direct_message.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Nostr
+  # Classes of event kinds.
+  module Events
+    # An event whose +content+ is encrypted. It can only be decrypted by the owner of the private key that pairs
+    # the event's +pubkey+.
+    class EncryptedDirectMessage < Event
+      # Instantiates a new encrypted direct message
+      #
+      # @api public
+      #
+      # @example Instantiating a new encrypted direct message
+      #   Nostr::Events::EncryptedDirectMessage.new(
+      #    sender_private_key: 'ccf9fdf3e1466d7c20969c71ec98defcf5f54aee088513e1b73ccb7bd770d460',
+      #    recipient_public_key: '48df4af6e240ac5f7c5de89bf5941b249880be0e87d03685b178ccb1a315f52e',
+      #    plain_text: 'Your feedback is appreciated, now pay $8',
+      # )
+      #
+      # @example Instantiating a new encrypted direct message that references a previous direct message
+      #   Nostr::Events::EncryptedDirectMessage.new(
+      #    sender_private_key: 'ccf9fdf3e1466d7c20969c71ec98defcf5f54aee088513e1b73ccb7bd770d460',
+      #    recipient_public_key: '48df4af6e240ac5f7c5de89bf5941b249880be0e87d03685b178ccb1a315f52e',
+      #    plain_text: 'Your feedback is appreciated, now pay $8',
+      #    previous_direct_message: 'ccf9fdf3e1466d7c20969c71ec98defcf5f54aee088513e1b73ccb7bd770d460'
+      # )
+      #
+      # @param plain_text [String] The +content+ of the encrypted message.
+      # @param sender_private_key [PrivateKey] 32-bytes hex-encoded private key of the message's author.
+      # @param recipient_public_key [PublicKey] 32-bytes hex-encoded public key of the recipient of the encrypted
+      #  message.
+      # @param previous_direct_message [String] 32-bytes hex-encoded id identifying the previous message in a
+      # conversation or a message we are explicitly replying to (such that contextual, more organized conversations
+      # may happen
+      #
+      def initialize(plain_text:, sender_private_key:, recipient_public_key:, previous_direct_message: nil)
+        crypto = Crypto.new
+        keygen = Keygen.new
+
+        encrypted_content = crypto.encrypt_text(sender_private_key, recipient_public_key, plain_text)
+        sender_public_key = keygen.extract_public_key(sender_private_key)
+
+        super(
+          pubkey: sender_public_key,
+          kind: Nostr::EventKind::ENCRYPTED_DIRECT_MESSAGE,
+          content: encrypted_content,
+        )
+
+        add_pubkey_reference(recipient_public_key)
+        add_event_reference(previous_direct_message) if previous_direct_message
+      end
+    end
+  end
+end

data/lib/nostr/filter.rb

@@ -3,7 +3,7 @@
 module Nostr
   # A filter determines what events will be sent in a subscription.
   class Filter
-    # A list of event ids or prefixes
+    # A list of event ids
     #
     # @api public
     #
@@ -14,7 +14,7 @@ module Nostr
     #
     attr_reader :ids
 
-    # A list of pubkeys or prefixes, the pubkey of an event must be one of these
+    # A list of pubkeys, the pubkey of an event must be one of these
     #
     # @api public
     #
@@ -107,8 +107,8 @@ module Nostr
     #   )
     #
     # @param kwargs [Hash]
-    # @option kwargs [Array<String>, nil] ids A list of event ids or prefixes
-    # @option kwargs [Array<String>, nil] authors A list of pubkeys or prefixes, the pubkey of an event must be one
+    # @option kwargs [Array<String>, nil] ids A list of event ids
+    # @option kwargs [Array<String>, nil] authors A list of pubkeys, the pubkey of an event must be one
     # of these
     # @option kwargs [Array<Integer>, nil] kinds A list of a kind numbers
     # @option kwargs [Array<String>, nil] e A list of event ids that are referenced in an "e" tag

data/lib/nostr/key.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Nostr
+  # Abstract class for all keys
+  #
+  # @api private
+  #
+  class Key < String
+    # The regular expression for hexadecimal lowercase characters
+    #
+    # @return [Regexp] The regular expression for hexadecimal lowercase characters
+    #
+    FORMAT = /^[a-f0-9]+$/
+
+    # The length of the key in hex format
+    #
+    # @return [Integer] The length of the key in hex format
+    #
+    LENGTH = 64
+
+    # Instantiates a new key. Can't be used directly because this is an abstract class. Raises a +ValidationError+
+    #
+    # @see Nostr::PrivateKey
+    # @see Nostr::PublicKey
+    #
+    # @param [String] hex_value Hex-encoded value of the key
+    #
+    # @raise [ValidationError]
+    #
+    def initialize(hex_value)
+      validate_hex_value(hex_value)
+
+      super(hex_value)
+    end
+
+    # Instantiates a key from a bech32 string
+    #
+    # @api public
+    #
+    # @example
+    #   bech32_key = 'nsec1vl029mgpspedva04g90vltkh6fvh240zqtv9k0t9af8935ke9laqsnlfe5'
+    #   bech32_key.to_key # => #<Nostr::PublicKey:0x000000010601e3c8 @hex_value="...">
+    #
+    # @raise [Nostr::InvalidHRPError] if the bech32 string is invalid.
+    #
+    # @param [String] bech32_value The bech32 string representation of the key.
+    #
+    # @return [Key] the key.
+    #
+    def self.from_bech32(bech32_value)
+      type, data = Bech32.decode(bech32_value)
+
+      raise InvalidHRPError.new(type, hrp) unless type == hrp
+
+      new(data)
+    end
+
+    # Abstract method to be implemented by subclasses to provide the HRP (npub, nsec)
+    #
+    # @api private
+    #
+    # @return [String] The HRP
+    #
+    def self.hrp
+      raise 'Subclasses must implement this method'
+    end
+
+    # Converts the key to a bech32 string representation
+    #
+    # @api public
+    #
+    # @example Converting a private key to a bech32 string
+    #   public_key = Nostr::PrivateKey.new('67dea2ed018072d675f5415ecfaed7d2597555e202d85b3d65ea4e58d2d92ffa')
+    #   public_key.to_bech32 # => 'nsec1vl029mgpspedva04g90vltkh6fvh240zqtv9k0t9af8935ke9laqsnlfe5'
+    #
+    # @example Converting a public key to a bech32 string
+    #   public_key = Nostr::PublicKey.new('7e7e9c42a91bfef19fa929e5fda1b72e0ebc1a4c1141673e2794234d86addf4e')
+    #   public_key.to_bech32 # => 'npub10elfcs4fr0l0r8af98jlmgdh9c8tcxjvz9qkw038js35mp4dma8qzvjptg'
+    #
+    # @return [String] The bech32 string representation of the key
+    #
+    def to_bech32 = Bech32.encode(hrp: self.class.hrp, data: self)
+
+    protected
+
+    # Validates the hex value during initialization
+    #
+    # @api private
+    #
+    # @param [String] _hex_value The hex value of the key
+    #
+    # @raise [KeyValidationError] When the hex value is invalid
+    #
+    # @return [void]
+    #
+    def validate_hex_value(_hex_value)
+      raise 'Subclasses must implement this method'
+    end
+  end
+end

data/lib/nostr/key_pair.rb

@@ -10,7 +10,7 @@ module Nostr
     # @example
     #   keypair.private_key # => '893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900'
     #
-    # @return [String]
+    # @return [PrivateKey]
     #
     attr_reader :private_key
 
@@ -21,7 +21,7 @@ module Nostr
     # @example
     #   keypair.public_key # => '2d7661527d573cc8e84f665fa971dd969ba51e2526df00c149ff8e40a58f9558'
     #
-    # @return [String]
+    # @return [PublicKey]
     #
     attr_reader :public_key
 
@@ -31,16 +31,40 @@ module Nostr
     #
     # @example
     #   keypair = Nostr::KeyPair.new(
-    #     private_key: '893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900',
-    #     public_key: '2d7661527d573cc8e84f665fa971dd969ba51e2526df00c149ff8e40a58f9558',
+    #     private_key: Nostr::PrivateKey.new('893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900'),
+    #     public_key: Nostr::PublicKey.new('2d7661527d573cc8e84f665fa971dd969ba51e2526df00c149ff8e40a58f9558'),
     #   )
     #
-    # @param private_key [String] 32-bytes hex-encoded private key.
-    # @param public_key [String] 32-bytes hex-encoded public key.
+    # @param private_key [PrivateKey] 32-bytes hex-encoded private key.
+    # @param public_key [PublicKey] 32-bytes hex-encoded public key.
+    #
+    # @raise ArgumentError when the private key is not a +PrivateKey+
+    # @raise ArgumentError when the public key is not a +PublicKey+
     #
     def initialize(private_key:, public_key:)
+      validate_keys(private_key, public_key)
+
       @private_key = private_key
       @public_key = public_key
     end
+
+    private
+
+    # Validates the keys
+    #
+    # @api private
+    #
+    # @param private_key [PrivateKey] 32-bytes hex-encoded private key.
+    # @param public_key [PublicKey] 32-bytes hex-encoded public key.
+    #
+    # @raise ArgumentError when the private key is not a +PrivateKey+
+    # @raise ArgumentError when the public key is not a +PublicKey+
+    #
+    # @return [void]
+    #
+    def validate_keys(private_key, public_key)
+      raise ArgumentError, 'private_key is not an instance of PrivateKey' unless private_key.is_a?(Nostr::PrivateKey)
+      raise ArgumentError, 'public_key is not an instance of PublicKey' unless public_key.is_a?(Nostr::PublicKey)
+    end
   end
 end

data/lib/nostr/keygen.rb

@@ -44,10 +44,11 @@ module Nostr
     #   private_key = keygen.generate_private_key
     #   private_key # => '893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900'
     #
-    # @return [String] A 32-bytes hex-encoded private key.
+    # @return [PrivateKey] A 32-bytes hex-encoded private key.
     #
     def generate_private_key
-      (SecureRandom.random_number(group.order - 1) + 1).to_s(16)
+      hex_value = (SecureRandom.random_number(group.order - 1) + 1).to_s(16).rjust(64, '0')
+      PrivateKey.new(hex_value)
     end
 
     # Extracts a public key from a private key
@@ -59,10 +60,36 @@ module Nostr
     #   public_key = keygen.extract_public_key(private_key)
     #   public_key # => '2d7661527d573cc8e84f665fa971dd969ba51e2526df00c149ff8e40a58f9558'
     #
-    # @return [String] A 32-bytes hex-encoded public key.
+    # @param [PrivateKey] private_key A 32-bytes hex-encoded private key.
+    #
+    # @raise [ArgumentError] if the private key is not an instance of +PrivateKey+
+    #
+    # @return [PublicKey] A 32-bytes hex-encoded public key.
     #
     def extract_public_key(private_key)
-      group.generator.multiply_by_scalar(private_key.to_i(16)).x.to_s(16)
+      validate_private_key(private_key)
+      hex_value = group.generator.multiply_by_scalar(private_key.to_i(16)).x.to_s(16).rjust(64, '0')
+      PublicKey.new(hex_value)
+    end
+
+    # Builds a key pair from an existing private key
+    #
+    # @api public
+    #
+    # @example
+    #   private_key = Nostr::PrivateKey.new('893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900')
+    #   keygen.get_key_pair_from_private_key(private_key)
+    #
+    # @param private_key [PrivateKey] 32-bytes hex-encoded private key.
+    #
+    # @raise [ArgumentError] if the private key is not an instance of +PrivateKey+
+    #
+    # @return [Nostr::KeyPair]
+    #
+    def get_key_pair_from_private_key(private_key)
+      validate_private_key(private_key)
+      public_key = extract_public_key(private_key)
+      KeyPair.new(private_key:, public_key:)
     end
 
     private
@@ -74,5 +101,17 @@ module Nostr
     # @return [ECDSA::Group]
     #
     attr_reader :group
+
+    # Validates that the private key is an instance of +PrivateKey+
+    #
+    # @api private
+    #
+    # @raise [ArgumentError] if the private key is not an instance of +PrivateKey+
+    #
+    # @return [void]
+    #
+    def validate_private_key(private_key)
+      raise ArgumentError, 'private_key is not an instance of PrivateKey' unless private_key.is_a?(Nostr::PrivateKey)
+    end
   end
 end

data/lib/nostr/private_key.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Nostr
+  # 32-bytes lowercase hex-encoded private key
+  class PrivateKey < Key
+    # Human-readable part of the Bech32 encoded address
+    #
+    # @api private
+    #
+    # @return [String] The human-readable part of the Bech32 encoded address
+    #
+    def self.hrp
+      'nsec'
+    end
+
+    private
+
+    # Validates the hex value of the private key
+    #
+    # @api private
+    #
+    # @param [String] hex_value The private key in hex format
+    #
+    # @raise InvalidKeyTypeError when the private key is not a string
+    # @raise InvalidKeyLengthError when the private key's length is not 64 characters
+    # @raise InvalidKeyFormatError when the private key is in an invalid format
+    #
+    # @return [void]
+    #
+    def validate_hex_value(hex_value)
+      raise InvalidKeyTypeError, 'private'   unless hex_value.is_a?(String)
+      raise InvalidKeyLengthError, 'private' unless hex_value.size == Key::LENGTH
+      raise InvalidKeyFormatError, 'private' unless hex_value.match(Key::FORMAT)
+    end
+  end
+end

data/lib/nostr/public_key.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Nostr
+  # 32-bytes lowercase hex-encoded public key
+  class PublicKey < Key
+    # Human-readable part of the Bech32 encoded address
+    #
+    # @api private
+    #
+    # @return [String] The human-readable part of the Bech32 encoded address
+    #
+    def self.hrp
+      'npub'
+    end
+
+    private
+
+    # Validates the hex value of the public key
+    #
+    # @api private
+    #
+    # @param [String] hex_value The public key in hex format
+    #
+    # @raise InvalidKeyTypeError when the public key is not a string
+    # @raise InvalidKeyLengthError when the public key's length is not 64 characters
+    # @raise InvalidKeyFormatError when the public key is in an invalid format
+    #
+    # @return [void]
+    #
+    def validate_hex_value(hex_value)
+      raise InvalidKeyTypeError, 'public' unless hex_value.is_a?(String)
+      raise InvalidKeyLengthError, 'public' unless hex_value.size == Key::LENGTH
+      raise InvalidKeyFormatError, 'public' unless hex_value.match(Key::FORMAT)
+    end
+  end
+end

data/lib/nostr/relay_message_type.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Nostr
+  # Clients can send 4 types of messages, which must be JSON arrays
+  module RelayMessageType
+    # @return [String] Used to notify clients all stored events have been sent
+    EOSE = 'EOSE'
+
+    # @return [String] Used to send events requested to clients
+    EVENT = 'EVENT'
+
+    # @return [String] Used to send human-readable messages to clients
+    NOTICE = 'NOTICE'
+
+    # @return [String] Used to notify clients if an EVENT was successful
+    OK = 'OK'
+  end
+end

data/lib/nostr/subscription.rb

@@ -5,7 +5,7 @@ require 'securerandom'
 module Nostr
   # A subscription the result of a request to receive events from a relay
   class Subscription
-    # A random string that should be used to represent a subscription
+    # An arbitrary, non-empty string of max length 64 chars used to represent a subscription
     #
     # @api public
     #
@@ -41,7 +41,7 @@ module Nostr
     # @example Subscribing to all events created after a certain time
     #   subscription = Nostr::Subscription.new(filter: Nostr::Filter.new(since: 1230981305))
     #
-    # @param id [String] A random string that should be used to represent a subscription
+    # @param id [String] An arbitrary, non-empty string of max length 64 chars used to represent a subscription
     # @param filter [Filter] An object that determines what events will be sent in that subscription
     #
     def initialize(filter:, id: SecureRandom.hex)

data/lib/nostr/user.rb

@@ -47,46 +47,27 @@ module Nostr
     #     content: 'Your feedback is appreciated, now pay $8'
     #   )
     #
-    # @param event_attributes [Hash]
-    # @option event_attributes [String] :pubkey 32-bytes hex-encoded public key of the event creator.
-    # @option event_attributes [Integer] :created_at Date of the creation of the vent. A UNIX timestamp, in seconds.
-    # @option event_attributes [Integer] :kind The kind of the event. An integer from 0 to 3.
-    # @option event_attributes [Array<Array>] :tags  An array of tags. Each tag is an array of strings.
-    # @option event_attributes [String] :content Arbitrary string.
+    # @param created_at [Integer] Date of the creation of the vent. A UNIX timestamp, in seconds.
+    # @param kind [Integer] The kind of the event. An integer from 0 to 3.
+    # @param tags [Array<Array>] An array of tags. Each tag is an array of strings.
+    # @param content [String] Arbitrary string.
     #
     # @return [Event]
     #
-    def create_event(event_attributes)
-      event_fragment = EventFragment.new(**event_attributes.merge(pubkey: keypair.public_key))
-      event_sha256 = Digest::SHA256.hexdigest(JSON.dump(event_fragment.serialize))
-
-      signature = sign(event_sha256)
-
-      Event.new(
-        id: event_sha256,
-        pubkey: event_fragment.pubkey,
-        created_at: event_fragment.created_at,
-        kind: event_fragment.kind,
-        tags: event_fragment.tags,
-        content: event_fragment.content,
-        sig: signature
+    def create_event(
+      kind:,
+      content:,
+      created_at: Time.now.to_i,
+      tags: []
+    )
+      event = Event.new(
+        pubkey: keypair.public_key,
+        kind:,
+        content:,
+        created_at:,
+        tags:
       )
-    end
-
-    private
-
-    # Signs an event with the user's private key
-    #
-    # @api private
-    #
-    # @param event_sha256 [String] The SHA256 hash of the event.
-    #
-    # @return [String] The signature of the event.
-    #
-    def sign(event_sha256)
-      hex_private_key = Array(keypair.private_key).pack('H*')
-      hex_message = Array(event_sha256).pack('H*')
-      Schnorr.sign(hex_message, hex_private_key).encode.unpack1('H*')
+      event.sign(keypair.private_key)
     end
   end
 end

data/lib/nostr/version.rb

@@ -2,5 +2,5 @@
 
 module Nostr
   # The version of the gem
-  VERSION = '0.3.0'
+  VERSION = '0.5.0'
 end

data/lib/nostr.rb

@@ -1,17 +1,24 @@
 # frozen_string_literal: true
 
+require_relative 'nostr/errors'
+require_relative 'nostr/bech32'
+require_relative 'nostr/crypto'
 require_relative 'nostr/version'
 require_relative 'nostr/keygen'
 require_relative 'nostr/client_message_type'
 require_relative 'nostr/filter'
 require_relative 'nostr/subscription'
 require_relative 'nostr/relay'
+require_relative 'nostr/relay_message_type'
 require_relative 'nostr/key_pair'
 require_relative 'nostr/event_kind'
-require_relative 'nostr/event_fragment'
 require_relative 'nostr/event'
+require_relative 'nostr/events/encrypted_direct_message'
 require_relative 'nostr/client'
 require_relative 'nostr/user'
+require_relative 'nostr/key'
+require_relative 'nostr/private_key'
+require_relative 'nostr/public_key'
 
 # Encapsulates all the gem's logic
 module Nostr

data/nostr.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
 
   spec.summary = 'Client and relay implementation of the Nostr protocol.'
   spec.description = 'Client and relay implementation of the Nostr protocol.'
-  spec.homepage = 'https://github.com/wilsonsilva/nostr'
+  spec.homepage = 'https://nostr-ruby.com/'
   spec.license = 'MIT'
   spec.required_ruby_version = '>= 3.2.0'
   spec.metadata['rubygems_mfa_required'] = 'true'
@@ -31,8 +31,8 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'bech32', '~> 1.3'
-  spec.add_dependency 'bip-schnorr', '~> 0.4'
+  spec.add_dependency 'bech32', '~> 1.4'
+  spec.add_dependency 'bip-schnorr', '~> 0.6'
   spec.add_dependency 'ecdsa', '~> 1.2'
   spec.add_dependency 'event_emitter', '~> 0.2'
   spec.add_dependency 'faye-websocket', '~> 0.11'
@@ -47,17 +47,17 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'guard-rubocop', '~> 1.5'
   spec.add_development_dependency 'overcommit', '~> 0.59'
   spec.add_development_dependency 'pry', '~> 0.14'
-  spec.add_development_dependency 'puma', '~> 5.6'
+  spec.add_development_dependency 'puma', '~> 6.4'
   spec.add_development_dependency 'rack', '~> 3.0'
-  spec.add_development_dependency 'rake', '~> 13.0'
-  spec.add_development_dependency 'rbs', '~> 2.8'
+  spec.add_development_dependency 'rake', '~> 13.1'
+  spec.add_development_dependency 'rbs', '~> 3.3'
   spec.add_development_dependency 'rspec', '~> 3.12'
-  spec.add_development_dependency 'rubocop', '~> 1.42'
+  spec.add_development_dependency 'rubocop', '~> 1.57'
   spec.add_development_dependency 'rubocop-rake', '~> 0.6'
-  spec.add_development_dependency 'rubocop-rspec', '2.16'
+  spec.add_development_dependency 'rubocop-rspec', '2.25'
   spec.add_development_dependency 'simplecov', '= 0.17'
   spec.add_development_dependency 'simplecov-console', '~> 0.9'
-  spec.add_development_dependency 'steep', '~> 1.3'
+  spec.add_development_dependency 'steep', '~> 1.6'
   spec.add_development_dependency 'typeprof', '~> 0.21'
   spec.add_development_dependency 'yard', '~> 0.9'
   spec.add_development_dependency 'yard-junk', '~> 0.0.9'

data/sig/nostr/bech32.rbs

@@ -0,0 +1,14 @@
+module Nostr
+  module Bech32
+    # Perhaps a bug in RBS/Steep. +decode+ and +encode+ are not recognized as public class methods.
+    def self?.decode: (String data) -> [String, String]
+    def self?.encode: (hrp: String, data: String) -> String
+
+    def naddr_encode: (pubkey: PublicKey, ?relays: Array[String], ?kind: Integer, ?identifier: String) -> String
+    def nevent_encode: (id: PublicKey, ?relays: Array[String], ?kind: Integer) -> String
+    def nprofile_encode: (pubkey: PublicKey, ?relays: Array[String]) -> String
+    def npub_encode: (String npub) -> String
+    def nrelay_encode: (String nrelay) -> String
+    def nsec_encode: (String nsec) -> String
+  end
+end

data/sig/nostr/client.rbs

@@ -5,16 +5,16 @@ module Nostr
     def initialize: -> void
     def connect: (Relay relay) -> Thread
     def subscribe: (?subscription_id: String, ?filter: Filter) -> Subscription
-    def unsubscribe: (String subscription_id) -> untyped
+    def unsubscribe: (String subscription_id) -> void
     def publish: (Event event) -> untyped
 
     private
 
     attr_reader subscriptions: Hash[String, Subscription]
-    attr_reader parent_to_child_channel: untyped
-    attr_reader child_to_parent_channel: untyped
+    attr_reader parent_to_child_channel: EventMachine::Channel
+    attr_reader child_to_parent_channel: EventMachine::Channel
 
-    def execute_within_an_em_thread: { -> untyped } -> Thread
-    def initialize_channels: -> untyped
+    def execute_within_an_em_thread: { -> void } -> Thread
+    def initialize_channels: -> void
   end
 end

data/sig/nostr/crypto.rbs

@@ -0,0 +1,16 @@
+module Nostr
+  class Crypto
+    BN_BASE: 0 | 2 | 10 | 16
+    CIPHER_CURVE: String
+    CIPHER_ALGORITHM: String
+
+    def encrypt_text: (PrivateKey, PublicKey, String) -> String
+    def decrypt_text: (PrivateKey, PublicKey, String) -> String
+    def sign_event: (Event, PrivateKey) -> Event
+
+    private
+
+    def compute_shared_key: (PrivateKey, PublicKey) -> String
+    def hash_event:(Event) -> String
+  end
+end

data/sig/nostr/errors/error.rbs

@@ -0,0 +1,4 @@
+module Nostr
+  class Error < StandardError
+  end
+end

data/sig/nostr/errors/invalid_hrb_error.rbs

@@ -0,0 +1,6 @@
+module Nostr
+  class InvalidHRPError < KeyValidationError
+    def initialize: (String, String) -> void
+  end
+end
+

data/sig/nostr/errors/invalid_key_format_error.rbs

@@ -0,0 +1,5 @@
+module Nostr
+  class InvalidKeyFormatError < KeyValidationError
+    def initialize: (String) -> void
+  end
+end

data/sig/nostr/errors/invalid_key_length_error.rbs

@@ -0,0 +1,5 @@
+module Nostr
+  class InvalidKeyLengthError < KeyValidationError
+    def initialize: (String) -> void
+  end
+end

data/sig/nostr/errors/invalid_key_type_error.rbs

@@ -0,0 +1,5 @@
+module Nostr
+  class InvalidKeyTypeError < KeyValidationError
+    def initialize: (String) -> void
+  end
+end

data/sig/nostr/errors/key_validation_error.rbs

@@ -0,0 +1,4 @@
+module Nostr
+  class KeyValidationError < Error
+  end
+end