nostr 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 371ed11c0474fd944cc55a054d553945623f7439f67c55f3eadc564805d2fb11
-  data.tar.gz: f7fbe86119bd7816e7066ea3603263dee7327b06daeb4b92f9e90977f52ef8ae
+  metadata.gz: 168cbde3fb029345d4fa10043eead7c194a57fe3ee23c12b76bbaf79b1bdc71d
+  data.tar.gz: ff1a1837e897a8c0ad233a61ed4526fe3e4087c04474e54778a00a0d4313e361
 SHA512:
-  metadata.gz: fa602354304ce9e77377b80cab60146f51ac8943b1399070a87ce81a5e44582f0a23b50f1736fafd9d7d0f13042b8b7292b9d29684077ad878e2439ddf7970ef
-  data.tar.gz: 83fc3d535a1e35438522779ef7dc3e101b4fea3a3f9874db9457b4f6c61d74469ded6ba973923d731789d3c50d7aa66b1c0770d62451794d45b52720c7928ebf
+  metadata.gz: e5549507ded84026a2295c3914324e8c74aff3c1ae80322db3cd449e7f65c3475186e9daaa76f7a22241e33b6759c2073da5a31a910a2082c8e49a99081dc5bf
+  data.tar.gz: 19f69ed10ae3ba42113992541912bb18a4aa3ad8239b582b996e7c7845c4624c4a9ee73d800f51fbd883d2bdd9ea603eeb807ade147bcfc22db7183c1db30ce6

data/.editorconfig

@@ -6,6 +6,6 @@ max_line_length = 120
 trim_trailing_whitespace = true
 
 # 2 space indentation
-[*.rb]
+[{*.rb, *.mjs}]
 indent_style = space
 indent_size = 2

data/.rubocop.yml

@@ -9,8 +9,17 @@ AllCops:
   DisplayCopNames: true
   NewCops: enable
 
+# ----------------------- Gemspec -----------------------
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
 # ----------------------- Style -----------------------
 
+Style/RaiseArgs:
+  Exclude:
+    - 'lib/nostr/key.rb'
+
 Style/StringLiterals:
   Enabled: true
   EnforcedStyle: single_quotes
@@ -31,7 +40,24 @@ Metrics/BlockLength:
     - '**/*_spec.rb'
     - nostr.gemspec
 
+Metrics/ParameterLists:
+  CountKeywordArgs: false
+
 # ----------------------- RSpec -----------------------
 
 RSpec/ExampleLength:
   Enabled: false
+
+RSpec/FilePath:
+  Exclude:
+    - spec/nostr/errors/invalid_*
+
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - spec/nostr/errors/invalid_*
+
+# ----------------------- Naming -----------------------
+
+Naming/MemoizedInstanceVariableName:
+  Exclude:
+    - 'spec/nostr/key.rb'

data/.tool-versions

@@ -1 +1,2 @@
-ruby 3.2.0
+ruby 3.2.2
+bun 1.0.11

data/CHANGELOG.md

@@ -1,14 +1,76 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.1.1/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] 2023-11-20
+
+### Added
+
+- Added relay message type enums `Nostr::RelayMessageType`
+- Compliance with [NIP-19](https://github.com/nostr-protocol/nips/blob/master/19.md) - bech32-formatted strings
+- `Nostr::PrivateKey` and `Nostr::PublicKey` to represent private and public keys, respectively
+- Added a validation of private and public keys
+- Added an ability to convert keys to and from Bech32 format
+- Added RBS types for `faye-websocket` and `bech32`
+
+### Changed
+
+- Set the gem's homepage to [`https://nostr-ruby.com/`](https://nostr-ruby.com/)
+- Updated the filter's documentation to reflect the removal of prefix matching
+- Updated the subscription's id documentation to reflect the changes in the protocol definition
+- Updated `Nostr::PrivateKey` and `Nostr::PublicKey` internally, instead of Strings
+- Updated the gem `bip-schnorr` to version `0.6` (was `0.4`)
+- Updated the gem `puma` to version `6.4` (was `6.3`)
+- Updated the gem `rake` to version `13.1` (was `13.0`)
+- Updated the gem `rbs` to version `3.3` (was `2.8`)
+- Updated the gem `rubocop` to version `1.57` (was `1.42`)
+- Updated the gem `rubocop-rspec` to version `2.25` (was `2.16`)
+- Updated the gem `steep` to version `1.6` (was `1.4`)
+
+## Fixed
+
+- Fixed the RBS type of the constant `Nostr::Crypto::BN_BASE`
+- Fixed the return type of `Nostr::Crypto#decrypt_text` when given an invalid ciphertext
+- Fixed the RBS type of `Nostr::Filter#to_h`, `Nostr::Filter#e` and `Nostr::Filter#p`
+- Fixed the RBS types of `EventEmitter` and `EventMachine::Channel`
+- Fixed the generation of private keys
+
+## [0.4.0] - 2023-02-25
+
+### Removed
+
+- Removed `EventFragment` class. The `Event` class is no longer a Value Object. In other words, it is no longer
+immutable and it may be invalid by not having attributes `id` or `sig`. The `EventFragment` abstraction, along with the
+principles of immutability and was a major source of internal complexity as I needed to scale the codebase.
+
+### Added
+
+- Client compliance with [NIP-04](https://github.com/nostr-protocol/nips/blob/master/04.md) (encrypted direct messages)
+- Extracted the cryptographic concerns into a `Crypto` class.
+- Added the setters `Event#id=` and `Event#sig=`
+- Added a method on the event class to sign events (`Event#sign`)
+- Added a missing test for `EventKind::CONTACT_LIST`
+- Added two convenience methods to append event and pubkey references to an event's tags `add_event_reference` and
+`add_pubkey_reference`
+
+### Fixed
+
+- Fixed the generation of public keys
+- Fixed the RBS signature of `User#create_event`
+
 ## [0.3.0] - 2023-02-15
 
 ### Added
 
 - Client compliance wth [NIP-02](https://github.com/nostr-protocol/nips/blob/master/02.md) (manage contact lists)
+- RBS type checking using Steep and TypeProf
+
+## Fixed
+
+- Fixed a documentation typo
+- Fixed a documentation error regarding the receiving of messages via websockets
 
 ## [0.2.0] - 2023-01-12
 
@@ -20,6 +82,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 - Initial release
 
+[0.5.0]: https://github.com/wilsonsilva/nostr/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/wilsonsilva/nostr/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/wilsonsilva/nostr/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/wilsonsilva/nostr/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/wilsonsilva/nostr/compare/7fded5...v0.1.0

data/README.md

@@ -4,10 +4,30 @@
 [![Maintainability](https://api.codeclimate.com/v1/badges/c7633eb2c89eb95ee7f2/maintainability)](https://codeclimate.com/github/wilsonsilva/nostr/maintainability)
 [![Test Coverage](https://api.codeclimate.com/v1/badges/c7633eb2c89eb95ee7f2/test_coverage)](https://codeclimate.com/github/wilsonsilva/nostr/test_coverage)
 
-Asynchronous Nostr client. Please note that the API is likely to change as the gem is still in development and
-has not yet reached a stable release. Use with caution.
+Asynchronous Nostr client for Rubyists.
 
-## Installation
+## Table of contents
+
+- [Key features](#-key-features)
+- [Installation](#-installation)
+- [Quickstart](#-quickstart)
+- [Documentation](#-documentation)
+- [Implemented NIPs](#-implemented-nips)
+- [Development](#-development)
+  * [Type checking](#type-checking)
+- [Contributing](#-contributing)
+- [License](#-license)
+- [Code of Conduct](#-code-of-conduct)
+
+## 🔑 Key features
+
+- Asynchronous
+- Easy to use
+- Fully documented
+- Fully tested
+- Fully typed
+
+## 📦 Installation
 
 Install the gem and add to the application's Gemfile by executing:
 
@@ -17,215 +37,103 @@ If bundler is not being used to manage dependencies, install the gem by executin
 
     $ gem install nostr
 
-## Usage
+## ⚡️ Quickstart
 
-### Requiring the gem
-
-All examples below assume that the gem has been required.
+Here is a quick example of how to use the gem. For more detailed documentation, please check the
+[documentation website](https://nostr-ruby.com).
 
 ```ruby
+# Require the gem
 require 'nostr'
-```
-
-### Generating a keypair
-
-```ruby
-keygen  = Nostr::Keygen.new
-keypair = keygen.generate_keypair
-
-keypair.private_key
-keypair.public_key
-```
-
-### Generating a private key and a public key
 
-```ruby
-keygen  = Nostr::Keygen.new
+# Instantiate a client
+client = Nostr::Client.new
 
-private_key = keygen.generate_private_key
-public_key  = keygen.extract_public_key(private_key)
-```
+# a) Use an existing keypair
+keypair = Nostr::KeyPair.new(
+  private_key: Nostr::PrivateKey.new('add-your-hex-private-key-here'),
+  public_key: Nostr::PublicKey.new('add-your-hex-public-key-here'),
+)
 
-### Connecting to a Relay
+# b) Or build a keypair from a private key
+keygen = Nostr::Keygen.new
+keypair = keygen.get_key_pair_from_private_key(
+  Nostr::PrivateKey.new('add-your-hex-private-key-here')
+)
 
-Clients can connect to multiple Relays. In this version, a Client can only connect to a single Relay at a time.
+# c) Or create a new keypair
+keygen = Nostr::Keygen.new
+keypair = keygen.generate_keypair
 
-You may instantiate multiple Clients and multiple Relays.
+# Create a user with the keypair
+user = Nostr::User.new(keypair: keypair)
 
-```ruby
-client = Nostr::Client.new
-relay  = Nostr::Relay.new(url: 'wss://relay.damus.io', name: 'Damus')
+# Create a signed event
+text_note_event = user.create_event(
+  kind: Nostr::EventKind::TEXT_NOTE,
+  content: 'Your feedback is appreciated, now pay $8'
+)
 
+# Connect asynchronously to a relay
+relay = Nostr::Relay.new(url: 'wss://nostr.wine', name: 'Wine')
 client.connect(relay)
-```
 
-### WebSocket events
-
-All communication between clients and relays happen in WebSockets.
-
-The `:connect` event is fired when a connection with a WebSocket is opened. You must call `Nostr::Client#connect` first.
-
-```ruby
+# Listen asynchronously for the connect event
 client.on :connect do
-  # all the code goes here
-end
-```
-
-The `:close` event is fired when a connection with a WebSocket has been closed because of an error.
-
-```ruby
-client.on :error do |error_message|
-  puts error_message
-end
-
-# > Network error: wss://rsslay.fiatjaf.com: Unable to verify the server certificate for 'rsslay.fiatjaf.com'
-```
-
-The `:message` event is fired when data is received through a WebSocket.
-
-```ruby
-client.on :message do |message|
-  puts message
-end
-
-# [
-#   "EVENT",
-#   "d34107357089bfc9882146d3bfab0386",
-#   {
-#     "content":"",
-#     "created_at":1676456512,
-#     "id":"18f63550da74454c5df7caa2a349edc5b2a6175ea4c5367fa4b4212781e5b310",
-#     "kind":3,
-#     "pubkey":"117a121fa41dc2caa0b3d6c5b9f42f90d114f1301d39f9ee96b646ebfee75e36",
-#     "sig":"d171420bd62cf981e8f86f2dd8f8f86737ea2bbe2d98da88db092991d125535860d982139a3c4be39886188613a9912ef380be017686a0a8b74231dc6e0b03cb",
-#     "tags":[
-#       ["p","1cc821cc2d47191b15fcfc0f73afed39a86ac6fb34fbfa7993ee3e0f0186ef7c"]
-#     ]
-#   }
-# ]
-```
-
-The `:close` event is fired when a connection with a WebSocket is closed.
-
-```ruby
-client.on :close do |code, reason|
-  # you may attempt to reconnect
+  # Send the event to the Relay
+  client.publish(text_note_event)
 
-  client.connect(relay)
-end
-```
-
-### Requesting for events / creating a subscription
-
-A client can request events and subscribe to new updates after it has established a connection with the Relay.
-
-You may use a `Nostr::Filter` instance with as many attributes as you wish:
-
-```ruby
-client.on :connect do
+  # Create a filter to receive the first 20 text notes
+  # and encrypted direct messages from the relay that
+  # were created in the previous hour
   filter = Nostr::Filter.new(
-    ids: ['8535d5e2d7b9dc07567f676fbe70428133c9884857e1915f5b1cc6514c2fdff8'],
-    authors: ['ae00f88a885ce76afad5cbb2459ef0dcf0df0907adc6e4dac16e1bfbd7074577'],
-    kinds: [Nostr::EventKind::TEXT_NOTE],
-    e: ["f111593a72cc52a7f0978de5ecf29b4653d0cf539f1fa50d2168fc1dc8280e52"],
-    p: ["f1f9b0996d4ff1bf75e79e4cc8577c89eb633e68415c7faf74cf17a07bf80bd8"],
-    since: 1230981305,
-    until: 1292190341,
-    limit: 420,
+    kinds: [
+      Nostr::EventKind::TEXT_NOTE,
+      Nostr::EventKind::ENCRYPTED_DIRECT_MESSAGE
+    ],
+    since: Time.now.to_i - 3600, # 1 hour ago
+    until: Time.now.to_i,
+    limit: 20,
   )
 
-  subscription = client.subscribe('a_random_subscription_id', filter)
-end
-```
-
-With just a few:
+  # Subscribe to events matching conditions of a filter
+  subscription = client.subscribe(filter: filter)
 
-```ruby
-client.on :connect do
-  filter = Nostr::Filter.new(kinds: [Nostr::EventKind::TEXT_NOTE])
-  subscription = client.subscribe('a_random_subscription_id', filter)
+  # Unsubscribe from events matching the filter above
+  client.unsubscribe(subscription.id)
 end
-```
-
-Or omit the filter:
 
-```ruby
-client.on :connect do
-  subscription = client.subscribe('a_random_subscription_id')
+# Listen for incoming messages and print them
+client.on :message do |message|
+  puts message
 end
-```
-
-Or even omit the subscription id:
 
-```ruby
-client.on :connect do
-  subscription = client.subscribe('a_random_subscription_id')
+# Listen for error messages
+client.on :error do |error_message|
+  # Handle the error
 end
-```
-
-### Stop previous subscriptions
-
-You can stop receiving messages from a subscription by calling `#unsubscribe`:
-
-```ruby
-client.unsubscribe('your_subscription_id')
-```
-
-### Publishing an event
 
-To publish an event you need a keypair.
-
-```ruby
-# Set up the private key
-private_key = 'a630b06e2f883378d0aa335b9adaf7734603e00433350b684fe53e184f08c58f'
-user = Nostr::User.new(private_key)
-
-# Create a signed event
-event = user.create_event(
-  created_at: 1667422587, # optional, defaults to the current time
-  kind: Nostr::EventKind::TEXT_NOTE,
-  tags: [], # optional, defaults to []
-  content: 'Your feedback is appreciated, now pay $8'
-)
-
-# Send it to the Relay
-client.publish(event)
+# Listen for the close event
+client.on :close do |code, reason|
+  # You may attempt to reconnect to the relay here
+end
 ```
 
-### Creating/updating your contact list
-
-Every new contact list that gets published overwrites the past ones, so it should contain all entries.
+## 📚 Documentation
 
-```ruby
-# Creating a contact list event with 2 contacts
-update_contacts_event = user.create_event(
-  kind: Nostr::EventKind::CONTACT_LIST,
-  tags: [
-    [
-      "p", # mandatory
-      "32e1827635450ebb3c5a7d12c1f8e7b2b514439ac10a67eef3d9fd9c5c68e245", # public key of the user to add to the contacts
-      "wss://alicerelay.com/", # can be an empty string or can be omitted
-      "alice" # can be an empty string or can be omitted
-    ],
-    [
-      "p", # mandatory
-      "3efdaebb1d8923ebd99c9e7ace3b4194ab45512e2be79c1b7d68d9243e0d2681", # public key of the user to add to the contacts
-      "wss://bobrelay.com/nostr", # can be an empty string or can be omitted
-      "bob" # can be an empty string or can be omitted
-    ],
-  ],
-)
+I made a detailed documentation for this gem and it's usage. The code is also fully documented using YARD.
 
-# Send it to the Relay
-client.publish(update_contacts_event)
-```
+- [Guide documentation](https://nostr-ruby.com)
+- [YARD documentation](https://rubydoc.info/gems/nostr)
 
-## NIPS
+## ✅ Implemented NIPs
 
-- [x] [NIP-01 - Client](https://github.com/nostr-protocol/nips/blob/master/01.md)
-- [x] [NIP-02 - Client](https://github.com/nostr-protocol/nips/blob/master/02.md)
+- [x] [NIP-01 - Basic protocol flow description](https://github.com/nostr-protocol/nips/blob/master/01.md)
+- [x] [NIP-02 - Contact List and Petnames](https://github.com/nostr-protocol/nips/blob/master/02.md)
+- [x] [NIP-04 - Encrypted Direct Message](https://github.com/nostr-protocol/nips/blob/master/04.md)
+- [x] [NIP-19 - Bech32-encoded entities](https://github.com/nostr-protocol/nips/blob/master/19.md)
 
-## Development
+## 🔨 Development
 
 After checking out the repo, run `bin/setup` to install dependencies.
 
@@ -269,17 +177,22 @@ used to provide type checking and autocompletion in your editor. Run `bundle exe
 an RBS definition for the given Ruby file. And validate all definitions using [Steep](https://github.com/soutaro/steep)
 with the command `bundle exec steep check`.
 
-## Contributing
+## 🐞 Issues & Bugs
+
+If you find any issues or bugs, please report them [here](https://github.com/wilsonsilva/nostr/issues), I will be happy
+to have a look at them and fix them as soon as possible.
+
+## 🤝 Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/wilsonsilva/nostr.
 This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere
 to the [code of conduct](https://github.com/wilsonsilva/nostr/blob/main/CODE_OF_CONDUCT.md).
 
-## License
+## 📜 License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
-## Code of Conduct
+## 👔 Code of Conduct
 
 Everyone interacting in the Nostr project's codebases, issue trackers, chat rooms and mailing lists is expected
 to follow the [code of conduct](https://github.com/wilsonsilva/nostr/blob/main/CODE_OF_CONDUCT.md).

data/Steepfile

@@ -6,7 +6,9 @@ target :lib do
   check 'lib'
 
   # Core libraries
+  library 'base64'
   library 'digest'
+  library 'openssl'
   library 'securerandom'
 
   # Gems

data/docs/.gitignore

@@ -0,0 +1,4 @@
+/node_modules/
+.vitepress/dist
+.vitepress/temp
+.vitepress/cache

data/docs/.vitepress/config.mjs

@@ -0,0 +1,112 @@
+import { defineConfig } from 'vitepress'
+import { withMermaid } from "vitepress-plugin-mermaid";
+
+// https://vitepress.dev/reference/site-config
+// https://www.npmjs.com/package/vitepress-plugin-mermaid
+export default defineConfig(withMermaid({
+  title: "Nostr",
+  description: "Documentation of the Nostr Ruby gem",
+  // https://vitepress.dev/reference/site-config#head
+  head: [
+    ['link', { rel: 'icon', href: '/favicon.ico' }]
+  ],
+  themeConfig: {
+    // https://vitepress.dev/reference/default-theme-last-updated
+    lastUpdated: true,
+
+    // https://vitepress.dev/reference/default-theme-config
+    nav: [
+      { text: 'Home', link: '/' },
+      { text: 'Guide', link: '/getting-started/overview' }
+    ],
+
+    // https://vitepress.dev/reference/default-theme-search
+    search: {
+      provider: 'local'
+    },
+
+    // https://vitepress.dev/reference/default-theme-sidebar
+    sidebar: [
+      {
+        text: 'Getting started',
+        collapsed: false,
+        items: [
+          { text: 'Overview', link: '/getting-started/overview' },
+          { text: 'Installation', link: '/getting-started/installation' },
+        ]
+      },
+      {
+        text: 'Core',
+        collapsed: false,
+        items: [
+          { text: 'Client', link: '/core/client' },
+          { text: 'Keys', link: '/core/keys' },
+          { text: 'User', link: '/core/user' },
+        ]
+      },
+      {
+        text: 'Relays',
+        items: [
+          { text: 'Connecting to a relay', link: '/relays/connecting-to-a-relay' },
+          { text: 'Publishing events', link: '/relays/publishing-events' },
+          { text: 'Receiving events', link: '/relays/receiving-events' },
+        ]
+      },
+      {
+        text: 'Subscriptions',
+        collapsed: false,
+        items: [
+          { text: 'Creating a subscription', link: '/subscriptions/creating-a-subscription' },
+          { text: 'Filtering subscription events', link: '/subscriptions/filtering-subscription-events' },
+          { text: 'Updating a subscription', link: '/subscriptions/updating-a-subscription' },
+          { text: 'Deleting a subscription', link: '/subscriptions/deleting-a-subscription' },
+        ]
+      },
+      {
+        text: 'Events',
+        link: '/events',
+        collapsed: false,
+        items: [
+          { text: 'Set Metadata', link: '/events/set-metadata' },
+          { text: 'Text Note', link: '/events/text-note' },
+          { text: 'Recommend Server', link: '/events/recommend-server' },
+          { text: 'Contact List', link: '/events/contact-list' },
+          { text: 'Encrypted Direct Message', link: '/events/encrypted-direct-message' },
+        ]
+      },
+      {
+        text: 'Common use cases',
+        collapsed: false,
+        items: [
+          { text: 'Bech32 enc/decoding (NIP-19)', link: '/common-use-cases/bech32-encoding-and-decoding-(NIP-19)' },
+        ]
+      },
+      {
+        text: 'Implemented NIPs',
+        link: '/implemented-nips',
+      },
+    ],
+
+    // https://vitepress.dev/reference/default-theme-config#sociallinks
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/wilsonsilva/nostr' }
+    ],
+
+    // https://vitepress.dev/reference/default-theme-edit-link
+    editLink: {
+      pattern: 'https://github.com/wilsonsilva/nostr/edit/main/docs/:path',
+      text: 'Edit this page on GitHub'
+    },
+
+    // https://vitepress.dev/reference/default-theme-footer
+    footer: {
+      message: 'Released under the <a href="https://github.com/wilsonsilva/nostr/blob/main/LICENSE.txt">MIT License</a>.',
+      copyright: 'Copyright © 2023-present <a href="https://github.com/wilsonsilva">Wilson Silva</a>'
+    }
+  },
+
+  // https://vitepress.dev/reference/site-config#ignoredeadlinks
+  ignoreDeadLinks: [
+    /^https?:\/\/localhost/
+  ],
+}))

data/docs/README.md

@@ -0,0 +1,44 @@
+# Nostr Docs
+
+VitePress-powered documentation for the Nostr Ruby gem.
+
+## Live Demo
+
+https://nostr-ruby.com/
+
+## Development
+
+### Requirements
+
+- [Bun](https://bun.sh/)
+
+### Installation
+
+```shell
+bun install
+```
+
+### Tasks
+
+The `docs:dev` script will start a local dev server with instant hot updates. Run it with the following command:
+
+```shell
+bun run docs:dev
+```
+
+Run this command to build the docs:
+
+```shell
+bun run docs:build
+```
+
+Once built, preview it locally by running:
+
+```shell
+bun run docs:preview
+```
+
+The preview command will boot up a local static web server that will serve the output directory .`vitepress/dist` at
+http://localhost:4173. You can use this to make sure everything looks good before pushing to production.
+
+