nostr 0.1.0 → 0.2.0

data/lib/nostr/filter.rb

@@ -0,0 +1,172 @@
+# frozen_string_literal: true
+
+module Nostr
+  # A filter determines what events will be sent in a subscription.
+  class Filter
+    # A list of event ids or prefixes
+    #
+    # @api public
+    #
+    # @example
+    #   filter.ids # => ['c24881c305c5cfb7c1168be7e9b0e150', '35deb2612efdb9e13e8b0ca4fc162341']
+    #
+    # @return [Array<String>, nil]
+    #
+    attr_reader :ids
+
+    # A list of pubkeys or prefixes, the pubkey of an event must be one of these
+    #
+    # @api public
+    #
+    # @example
+    #   filter.authors # => ['000000001c5c45196786e79f83d21fe801549fdc98e2c26f96dcef068a5dbcd7']
+    #
+    # @return [Array<String>, nil]
+    #
+    attr_reader :authors
+
+    # A list of a kind numbers
+    #
+    # @api public
+    #
+    # @example
+    #   filter.kinds # => [0, 1, 2]
+    #
+    # @return [Array<Integer>, nil]
+    #
+    attr_reader :kinds
+
+    # A list of event ids that are referenced in an "e" tag
+    #
+    # @api public
+    #
+    # @example
+    #   filter.e # => ['7bdb422f254194ae4bb86d354c0bd5a888fce233ffc77dceb3e844ceec1fcfb2']
+    #
+    # @return [Array<String>, nil]
+    #
+    attr_reader :e
+
+    # A list of pubkeys that are referenced in a "p" tag
+    #
+    # @api public
+    #
+    # @example
+    #   filter.p # => ['000000001c5c45196786e79f83d21fe801549fdc98e2c26f96dcef068a5dbcd7']
+    #
+    # @return [Array<String>, nil]
+    #
+    attr_reader :p
+
+    # A timestamp, events must be newer than this to pass
+    #
+    # @api public
+    #
+    # @example
+    #   filter.since # => 1230981305
+    #
+    # @return [Integer, nil]
+    #
+    attr_reader :since
+
+    # A timestamp, events must be older than this to pass
+    #
+    # @api public
+    #
+    # @example
+    #   filter.until # => 1292190341
+    #
+    # @return [Integer, nil]
+    #
+    attr_reader :until
+
+    # Maximum number of events to be returned in the initial query
+    #
+    # @api public
+    #
+    # @example
+    #   filter.limit # => 420
+    #
+    # @return [Integer, nil]
+    #
+    attr_reader :limit
+
+    # Instantiates a new Filter
+    #
+    # @api public
+    #
+    # @example
+    #   Nostr::Filter.new(
+    #     ids: ['c24881c305c5cfb7c1168be7e9b0e150'],
+    #     authors: ['000000001c5c45196786e79f83d21fe801549fdc98e2c26f96dcef068a5dbcd7'],
+    #     kinds: [0, 1, 2],
+    #     since: 1230981305,
+    #     until: 1292190341,
+    #     e: ['7bdb422f254194ae4bb86d354c0bd5a888fce233ffc77dceb3e844ceec1fcfb2'],
+    #     p: ['000000001c5c45196786e79f83d21fe801549fdc98e2c26f96dcef068a5dbcd7']
+    #   )
+    #
+    # @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
+    # 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
+    # @option kwargs [Array<String, nil>] p A list of pubkeys that are referenced in a "p" tag
+    # @option kwargs [Integer, nil] since A timestamp, events must be newer than this to pass
+    # @option kwargs [Integer, nil] until A timestamp, events must be older than this to pass
+    # @option kwargs [Integer, nil] limit Maximum number of events to be returned in the initial query
+    #
+    def initialize(**kwargs)
+      @ids = kwargs[:ids]
+      @authors = kwargs[:authors]
+      @kinds = kwargs[:kinds]
+      @e = kwargs[:e]
+      @p = kwargs[:p]
+      @since = kwargs[:since]
+      @until = kwargs[:until]
+      @limit = kwargs[:limit]
+    end
+
+    # Converts the filter to a hash, removing all empty attributes
+    #
+    # @api public
+    #
+    # @example
+    #   filter.to_h # => {:ids=>["c24881c305c5cfb7c1168be7e9b0e150"],
+    #    :authors=>["000000001c5c45196786e79f83d21fe801549fdc98e2c26f96dcef068a5dbcd7"],
+    #    :kinds=>[0, 1, 2],
+    #    :"#e"=>["7bdb422f254194ae4bb86d354c0bd5a888fce233ffc77dceb3e844ceec1fcfb2"],
+    #    :"#p"=>["000000001c5c45196786e79f83d21fe801549fdc98e2c26f96dcef068a5dbcd7"],
+    #    :since=>1230981305,
+    #    :until=>1292190341}
+    #
+    # @return [Hash] The filter as a hash.
+    #
+    def to_h
+      {
+        ids:,
+        authors:,
+        kinds:,
+        '#e': e,
+        '#p': p,
+        since:,
+        until: self.until,
+        limit:
+      }.compact
+    end
+
+    # Compares two filters. Returns true if all attributes are equal and false otherwise
+    #
+    # @api public
+    #
+    # @example
+    #  filter == filter # => true
+    #
+    # @return [Boolean] True if all attributes are equal and false otherwise
+    #
+    def ==(other)
+      to_h == other.to_h
+    end
+  end
+end

data/lib/nostr/key_pair.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Nostr
+  # A pair of public and private keys
+  class KeyPair
+    # 32-bytes hex-encoded private key
+    #
+    # @api public
+    #
+    # @example
+    #   keypair.private_key # => '893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900'
+    #
+    # @return [String]
+    #
+    attr_reader :private_key
+
+    # 32-bytes hex-encoded public key
+    #
+    # @api public
+    #
+    # @example
+    #   keypair.public_key # => '2d7661527d573cc8e84f665fa971dd969ba51e2526df00c149ff8e40a58f9558'
+    #
+    # @return [String]
+    #
+    attr_reader :public_key
+
+    # Instantiates a key pair
+    #
+    # @api public
+    #
+    # @example
+    #   keypair = Nostr::KeyPair.new(
+    #     private_key: '893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900',
+    #     public_key: '2d7661527d573cc8e84f665fa971dd969ba51e2526df00c149ff8e40a58f9558',
+    #   )
+    #
+    # @param private_key [String] 32-bytes hex-encoded private key.
+    # @param public_key [String] 32-bytes hex-encoded public key.
+    #
+    def initialize(private_key:, public_key:)
+      @private_key = private_key
+      @public_key = public_key
+    end
+  end
+end

data/lib/nostr/keygen.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require 'ecdsa'
+require 'securerandom'
+
+module Nostr
+  # Generates private keys, public keys and key pairs.
+  class Keygen
+    # Instantiates a new keygen
+    #
+    # @api public
+    #
+    # @example
+    #   keygen = Nostr::Keygen.new
+    #
+    def initialize
+      @group = ECDSA::Group::Secp256k1
+    end
+
+    # Generates a pair of private and public keys
+    #
+    # @api public
+    #
+    # @example
+    #   keypair = keygen.generate_keypair
+    #   keypair # #<Nostr::KeyPair:0x0000000107bd3550
+    #    @private_key="893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900",
+    #    @public_key="2d7661527d573cc8e84f665fa971dd969ba51e2526df00c149ff8e40a58f9558">
+    #
+    # @return [KeyPair] An object containing a private key and a public key.
+    #
+    def generate_key_pair
+      private_key = generate_private_key
+      public_key  = extract_public_key(private_key)
+
+      KeyPair.new(private_key:, public_key:)
+    end
+
+    # Generates a private key
+    #
+    # @api public
+    #
+    # @example
+    #   private_key = keygen.generate_private_key
+    #   private_key # => '893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900'
+    #
+    # @return [String] A 32-bytes hex-encoded private key.
+    #
+    def generate_private_key
+      (SecureRandom.random_number(group.order - 1) + 1).to_s(16)
+    end
+
+    # Extracts a public key from a private key
+    #
+    # @api public
+    #
+    # @example
+    #   private_key = keygen.generate_private_key
+    #   public_key = keygen.extract_public_key(private_key)
+    #   public_key # => '2d7661527d573cc8e84f665fa971dd969ba51e2526df00c149ff8e40a58f9558'
+    #
+    # @return [String] 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)
+    end
+
+    private
+
+    # The elliptic curve group. Used to generate public and private keys
+    #
+    # @api private
+    #
+    # @return [ECDSA::Group]
+    #
+    attr_reader :group
+  end
+end

data/lib/nostr/relay.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Nostr
+  # Relays expose a websocket endpoint to which clients can connect.
+  class Relay
+    # The websocket URL of the relay
+    #
+    # @api public
+    #
+    # @example
+    #   relay.url # => 'wss://relay.damus.io'
+    #
+    # @return [String]
+    #
+    attr_reader :url
+
+    # The name of the relay
+    #
+    # @api public
+    #
+    # @example
+    #   relay.name # => 'Damus'
+    #
+    # @return [String]
+    #
+    attr_reader :name
+
+    # Instantiates a new Relay
+    #
+    # @api public
+    #
+    # @example
+    #   relay = Nostr::Relay.new(url: 'wss://relay.damus.io', name: 'Damus')
+    #
+    # @return [String] The websocket URL of the relay
+    # @return [String] The name of the relay
+    #
+    def initialize(url:, name:)
+      @url = url
+      @name = name
+    end
+  end
+end

data/lib/nostr/subscription.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+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
+    #
+    # @api public
+    #
+    # @example
+    #   subscription.id # => 'c24881c305c5cfb7c1168be7e9b0e150'
+    #
+    # @return [String]
+    #
+    attr_reader :id
+
+    # An object that determines what events will be sent in the subscription
+    #
+    # @api public
+    #
+    # @example
+    #   subscription.filter # => #<Nostr::Subscription:0x0000000110eea460 @filter=#<Nostr::Filter:0x0000000110c24de8>,
+    #   @id="0dd7f3fa06cd5f797438dd0b7477f3c7">
+    #
+    # @return [Filter]
+    #
+    attr_reader :filter
+
+    # Initializes a subscription
+    #
+    # @api public
+    #
+    # @example Creating a subscription with no id and no filters
+    #   subscription = Nostr::Subscription.new
+    #
+    # @example Creating a subscription with an ID
+    #   subscription = Nostr::Subscription.new(id: 'c24881c305c5cfb7c1168be7e9b0e150')
+    #
+    # @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 filter [Filter] An object that determines what events will be sent in that subscription
+    #
+    def initialize(filter:, id: SecureRandom.hex)
+      @id = id
+      @filter = filter
+    end
+
+    # Compares two subscriptions. Returns true if all attributes are equal and false otherwise
+    #
+    # @api public
+    #
+    # @example
+    #  subscription1 == subscription1 # => true
+    #
+    # @return [Boolean] True if all attributes are equal and false otherwise
+    #
+    def ==(other)
+      id == other.id && filter == other.filter
+    end
+  end
+end

data/lib/nostr/user.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'schnorr'
+require 'json'
+
+module Nostr
+  # Each user has a keypair. Signatures, public key, and encodings are done according to the
+  # Schnorr signatures standard for the curve secp256k1.
+  class User
+    # A pair of private and public keys
+    #
+    # @api public
+    #
+    # @example
+    #   user.keypair # #<Nostr::KeyPair:0x0000000107bd3550
+    #    @private_key="893c4cc8088924796b41dc788f7e2f746734497010b1a9f005c1faad7074b900",
+    #    @public_key="2d7661527d573cc8e84f665fa971dd969ba51e2526df00c149ff8e40a58f9558">
+    #
+    # @return [KeyPair]
+    #
+    attr_reader :keypair
+
+    # Instantiates a user
+    #
+    # @api public
+    #
+    # @example Creating a user with no keypair
+    #   user = Nostr::User.new
+    #
+    # @example Creating a user with a keypair
+    #   user = Nostr::User.new(keypair: keypair)
+    #
+    # @param keypair [Keypair] A pair of private and public keys
+    # @param keygen [Keygen] A private key and public key generator
+    #
+    def initialize(keypair: nil, keygen: Keygen.new)
+      @keypair = keypair || keygen.generate_key_pair
+    end
+
+    # Builds an Event
+    #
+    # @api public
+    #
+    # @example Creating a note event
+    #   event = user.create_event(
+    #     kind: Nostr::EventKind::TEXT_NOTE,
+    #     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 2.
+    # @option event_attributes [Array<Array>] :tags  An array of tags. Each tag is an array of strings.
+    # @option event_attributes [String] :content 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
+      )
+    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*')
+    end
+  end
+end

data/lib/nostr/version.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
 module Nostr
-  VERSION = '0.1.0'
+  # The version of the gem
+  VERSION = '0.2.0'
 end

data/lib/nostr.rb

@@ -1,9 +1,18 @@
 # frozen_string_literal: true
 
 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/key_pair'
+require_relative 'nostr/event_kind'
+require_relative 'nostr/event_fragment'
+require_relative 'nostr/event'
+require_relative 'nostr/client'
+require_relative 'nostr/user'
 
 # Encapsulates all the gem's logic
 module Nostr
-  class Error < StandardError; end
-  # Your code goes here...
 end

data/nostr.gemspec

@@ -17,7 +17,7 @@ Gem::Specification.new do |spec|
 
   spec.metadata['homepage_uri'] = spec.homepage
   spec.metadata['source_code_uri'] = 'https://github.com/wilsonsilva/nostr'
-  spec.metadata['changelog_uri'] = 'https://github.com/wilsonsilva/nostr/blob/master/CHANGELOG.md'
+  spec.metadata['changelog_uri'] = 'https://github.com/wilsonsilva/nostr/blob/main/CHANGELOG.md'
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -31,7 +31,15 @@ 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 'ecdsa', '~> 1.2'
+  spec.add_dependency 'event_emitter', '~> 0.2'
+  spec.add_dependency 'faye-websocket', '~> 0.11'
+  spec.add_dependency 'json', '~> 2.6'
+
   spec.add_development_dependency 'bundler-audit', '~> 0.9'
+  spec.add_development_dependency 'dotenv', '~> 2.8'
   spec.add_development_dependency 'guard', '~> 2.18'
   spec.add_development_dependency 'guard-bundler', '~> 3.0'
   spec.add_development_dependency 'guard-bundler-audit', '~> 0.1'
@@ -39,12 +47,14 @@ 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 'rack', '~> 3.0'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.12'
   spec.add_development_dependency 'rubocop', '~> 1.42'
   spec.add_development_dependency 'rubocop-rake', '~> 0.6'
   spec.add_development_dependency 'rubocop-rspec', '2.16'
-  spec.add_development_dependency 'simplecov', '~> 0.22'
+  spec.add_development_dependency 'simplecov', '= 0.17'
   spec.add_development_dependency 'simplecov-console', '~> 0.9'
   spec.add_development_dependency 'yard', '~> 0.9'
   spec.add_development_dependency 'yard-junk', '~> 0.0.9'