openreceive-server 0.2.1

data/lib/openreceive/server/wallet_info.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require "openreceive"
+
+module OpenReceive
+  module Server
+    # NIP-47 wallet service info normalization (the kind 13194 info payload),
+    # ported from the JS summarizeWalletCapabilities and locked to the shared
+    # spec/test-vectors/nwc-info.json vectors: method-name normalization,
+    # encryption-mode choice, spend-capability detection, and receive
+    # readiness must be identical in both engines.
+    module WalletInfo
+      REQUIRED_RECEIVE_METHODS = %w[make_invoice list_transactions].freeze
+      SPEND_METHODS = %w[pay_invoice multi_pay_invoice pay_keysend multi_pay_keysend].freeze
+
+      module_function
+
+      def summarize(raw_info)
+        unwrapped = OpenReceive::Nwc.unwrap(raw_info)
+        info = OpenReceive.stringify(unwrapped)
+        raw_methods = %w[methods capabilities supported_methods supportedMethods]
+                      .map { |key| info[key] }
+                      .find { |value| !value.nil? }
+        raw_methods = unwrapped if raw_methods.nil? && unwrapped.is_a?(String)
+        methods = string_list(raw_methods).map { |name| normalize_method_name(name) }
+        encryption = choose_encryption_mode(
+          string_list(info["encryption"].nil? ? info["encryptions"] : info["encryption"])
+        )
+        spend_methods = methods.select { |name| SPEND_METHODS.include?(name) }
+        missing_methods = REQUIRED_RECEIVE_METHODS.reject { |name| methods.include?(name) }
+        {
+          "methods" => methods,
+          "encryption" => encryption,
+          "spend_capability_advertised" => !spend_methods.empty?,
+          "receive_checkout_ready" => missing_methods.empty?,
+          "warnings" => spend_methods.map do |name|
+            "Wallet advertises spend method '#{name}'; OpenReceive checkout will not expose it."
+          end
+        }
+      end
+
+      def choose_encryption_mode(encryption_modes)
+        normalized = encryption_modes.map { |mode| mode.downcase.gsub(/[- ]/, "_") }
+        if (normalized & %w[nip44_v2 nip44 nip_44]).any?
+          "nip44_v2"
+        elsif normalized.empty? || normalized.include?("nip04") || normalized.include?("nip_04")
+          # No advertised list at all: assume the NIP-47 baseline (NIP-04).
+          "nip04"
+        end
+        # An advertised list containing no mode we speak returns nil so
+        # preflight can fail loudly instead of failing cryptically at RPC time.
+      end
+
+      def string_list(value)
+        if value.is_a?(Array)
+          value.select { |item| item.is_a?(String) }.map(&:strip).reject(&:empty?)
+        elsif value.is_a?(String)
+          value.split(/[,\s]+/).map(&:strip).reject(&:empty?)
+        else
+          []
+        end
+      end
+
+      def normalize_method_name(value)
+        value.strip.gsub(/([a-z0-9])([A-Z])/, '\1_\2').gsub(/[-\s]+/, "_").downcase
+      end
+    end
+  end
+end

data/lib/openreceive/server.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# OpenReceive::Server — storage-agnostic receive checkout service,
+# config loader, and framework-agnostic HTTP (Rack) routes.
+#
+# This gem builds on the dependency-free core gem (`openreceive`) and reuses its exact-money,
+# settlement, NWC normalization, error, and receive-client primitives.
+#
+# Receive-only invariant: nothing here ever exposes a spend method, and the NWC connection
+# secret never leaves the server (never logged, never serialized to a wire payload).
+
+require "openreceive"
+
+module OpenReceive
+  module Server
+    # Generation of the openreceive_payments / openreceive_meta schema this gem
+    # writes and reads. Mirrors the JS OPENRECEIVE_PAYMENTS_SCHEMA_VERSION; both
+    # engines share one host database, so they must agree.
+    PAYMENTS_SCHEMA_VERSION = 1
+
+    # Oldest-first page size for one reconciliation pass. Mirrors the JS
+    # OPENRECEIVE_RECONCILE_BATCH_SIZE: a backlog of pending attempts is
+    # drained over several passes instead of loading every row (and scanning
+    # every invoice's window) in one unbounded query.
+    RECONCILE_BATCH_SIZE = 200
+  end
+end
+
+require "openreceive/server/version"
+require "openreceive/server/errors"
+require "openreceive/server/client_ip"
+require "openreceive/server/wallet_info"
+require "openreceive/server/lsc_uri"
+require "openreceive/server/swap"
+require "openreceive/server/service"
+require "openreceive/server/reconciliation"
+require "openreceive/server/config"
+require "openreceive/server/request_handler"
+require "openreceive/server/rack_app"

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: openreceive-server
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: ruby
+authors:
+- OpenReceive
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: openreceive
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.2.1
+description: 'Server building blocks for OpenReceive: a storage-free Service that
+  mirrors the Node engine and a framework-agnostic Rack app implementing the shipped
+  HTTP routes while the host owns order and payment persistence. Receive-only: it
+  never exposes a spend path and the NWC secret never leaves the server.'
+email:
+- info@openreceive.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/openreceive/server.rb
+- lib/openreceive/server/client_ip.rb
+- lib/openreceive/server/config.rb
+- lib/openreceive/server/errors.rb
+- lib/openreceive/server/lsc_uri.rb
+- lib/openreceive/server/rack_app.rb
+- lib/openreceive/server/reconciliation.rb
+- lib/openreceive/server/request_handler.rb
+- lib/openreceive/server/service.rb
+- lib/openreceive/server/swap.rb
+- lib/openreceive/server/swap/assets.rb
+- lib/openreceive/server/swap/fixedfloat.rb
+- lib/openreceive/server/swap/rates_feed.rb
+- lib/openreceive/server/swap/transient_cache.rb
+- lib/openreceive/server/swap/weight_budget.rb
+- lib/openreceive/server/version.rb
+- lib/openreceive/server/wallet_info.rb
+homepage: https://openreceive.org
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://openreceive.org
+  source_code_uri: https://github.com/openreceive/openreceive
+  changelog_uri: https://github.com/openreceive/openreceive/blob/master/packages/ruby/openreceive-server/CHANGELOG.md
+  bug_tracker_uri: https://github.com/openreceive/openreceive/issues
+  documentation_uri: https://rubydoc.info/gems/openreceive-server
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.8
+specification_version: 4
+summary: Storage-free OpenReceive receive-only service and HTTP routes for Ruby.
+test_files: []