nwc-ruby 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b847b05f148d03753548528e0f4483129cf59887e40329f28e7bbe31f0eda1cd
-  data.tar.gz: 9c99704df81a6e7cfa9c1bfede014b49270b15bf11a3bba8663b5d6f1f3500fa
+  metadata.gz: d541ad9af31629ad26492d8da61d56b0a63980cc8597a460cca9949df56f382d
+  data.tar.gz: 8d48fbbe532bdcf56d889f68f9d7878fa2958381c1ea285fb572aebb70d17d7e
 SHA512:
-  metadata.gz: 11e62747c2dfa88459d900a2e1f89e7a42df5420b88221508bf62df39b65ebe7f9937db357557b2ab3ee8b95be0b50b5062fa3667cf21002dbf607366f49675d
-  data.tar.gz: c0ff4c40f5d8fa68d3b12e6b7c745ff1ff5b19da5719c0998c8cc5db6098ee77917c2c914b0ca96dc9e9301ac4240595f7e472019e6001394c996e75ffdcff6a
+  metadata.gz: bbc5e4a3efdac9b24a4a2c5fc183f3945ba9987fd5312c78a7e8c4ba8cff625af5c08521094cc10101fd24a0bef5f35261eb29720d533d7e0167a236ee59d106
+  data.tar.gz: fb2c7a1ed8d7785a886b38e250432466354b257cef1e4c8552ef24c493c304dbd446bf4c17e57debcce8bc6875666686c16f901d29474ef08541194e6e2a97f3

data/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+
+- Silenced the noisy `Async::Task` warn log ("Task may have ended with
+  unhandled exception") that was emitted every `recycle_interval` (default
+  5 min) by the heartbeat task. The forced recycle used to be signaled by
+  raising `TransportError` from inside the heartbeat's child Async task; the
+  parent's reconnect loop caught it correctly, but Async's console logger
+  logged the unhandled-in-child exception with a full backtrace first.
+  The recycle is now signaled by setting an `@recycle_requested` flag and
+  closing the websocket, which unblocks the read loop and lets
+  `run_one_connection` return normally without any exception crossing a task
+  boundary.
+
 ## [0.2.2] — 2026-04-21
 
 ### Fixed

data/README.md

@@ -2,6 +2,14 @@
 
 A production-grade Ruby client for [Nostr Wallet Connect (NIP-47)][nip47].
 
+Accept and track Bitcoin Lightning payments in your Rails app without running
+any Lightning infrastructure yourself. Generate Lightning invoices for your
+users to pay, then get notified the instant each one settles — all by talking
+to a Nostr Wallet Connect (NWC) service that someone else operates. The gem
+works with any NWC-compatible backend (Rizful, Alby Hub, Alby Cloud, CoinOs,
+any NIP-47 wallet service), so you're not locked into a single provider and
+can swap vendors by changing one environment variable.
+
 ```ruby
 require "nwc_ruby"
 

data/lib/nwc_ruby/transport/relay_connection.rb

@@ -146,6 +146,7 @@ module NwcRuby
       def run_one_connection(top)
         endpoint  = Async::HTTP::Endpoint.parse(@url, alpn_protocols: ['http/1.1'])
         opened_at = Async::Clock.now
+        @recycle_requested = false
         @logger.info("[nwc] connecting to #{@url}")
 
         Async::WebSocket::Client.connect(endpoint) do |conn|
@@ -155,6 +156,7 @@ module NwcRuby
 
           @open_cb&.call(self)
           read_loop(conn)
+          @logger.info("[nwc] recycling connection (#{@recycle_interval}s)") if @recycle_requested
         ensure
           heartbeat&.stop
           poll&.stop
@@ -167,6 +169,13 @@ module NwcRuby
         end
       end
 
+      # Heartbeat task: sends RFC 6455 ping every @ping_interval seconds and
+      # requests a recycle once the connection has been open longer than
+      # @recycle_interval. The recycle is signaled via a flag + close rather
+      # than by raising across task boundaries, because an exception raised
+      # inside a child Async task is logged at warn level by Async's console
+      # logger ("Task may have ended with unhandled exception") before the
+      # parent's rescue runs — producing a noisy backtrace on every recycle.
       def start_heartbeat(top, conn, opened_at)
         top.async do
           loop do
@@ -176,12 +185,25 @@ module NwcRuby
 
             sleep @ping_interval
             break if @stop
-
-            raise TransportError, "recycle (#{@recycle_interval}s)" if Async::Clock.now - opened_at > @recycle_interval
+            break if recycle_due?(opened_at) && request_recycle(conn)
           end
         end
       end
 
+      def recycle_due?(opened_at)
+        Async::Clock.now - opened_at > @recycle_interval
+      end
+
+      def request_recycle(conn)
+        @recycle_requested = true
+        begin
+          conn.close
+        rescue StandardError
+          nil
+        end
+        true
+      end
+
       def start_poll(top)
         return unless @poll_interval && @poll_cb
 
@@ -200,7 +222,21 @@ module NwcRuby
       end
 
       def read_loop(conn)
-        while (message = conn.read)
+        loop do
+          message =
+            begin
+              conn.read
+            rescue StandardError => e
+              # If we asked for the recycle/close ourselves, treat the
+              # resulting read error as a clean EOF rather than propagating
+              # it up into the reconnect-on-error path (which would log a
+              # spurious warning).
+              raise unless @recycle_requested || @stop
+
+              @logger.debug("[nwc] read interrupted by close: #{e.class}")
+              nil
+            end
+          break if message.nil?
           break if @stop
 
           begin

data/lib/nwc_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NwcRuby
-  VERSION = '0.2.2'
+  VERSION = '0.2.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nwc-ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - MegalithicBTC