openreceive 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a0236c2d34919d5be3ddb63a8ea58a4d3f7893d5dfcd0f8cb03142ead583473f
+  data.tar.gz: 050d0a795038c6435360ebdbc32a43bb970b9b1fc9d389794e0f923e5c5f435d
+SHA512:
+  metadata.gz: 15f158eca326663f007e002700a59e715116c4bf359cbc40f3f7e15c8b22de9535e9e5aad9ecd2c336ee35943839471651e8eb31d26626a2216163a3883ca060
+  data.tar.gz: 483b606a42e3da3191271b4473fc96110c550a830a21afb7760bf2dbeb763ea6f1b370a4ad8c649e5d5b48ebc5da137f2977831b80fea501eaf87f6a665a35a8

data/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## 0.2.1 - 2026-08-24
+
+The Ruby gems release in lockstep with the npm workspace version. The full
+release narrative lives in the repository-root
+[CHANGELOG](https://github.com/openreceive/openreceive/blob/master/CHANGELOG.md);
+entries here are scoped to this gem.
+
+- Packaging only: `npm run release:gem:build` now names the built `.gem` with
+  the version RubyGems actually mints, so prerelease versions build and push.
+
+## 0.1.1 - 2026-08-18
+
+- First packaged release of the `openreceive` core gem: exact-money helpers,
+  NWC URI parsing/redaction, wallet-error normalization, transaction
+  normalization, and settlement-authority primitives.
+- Built-in price feed (`OpenReceive::Rates`): static provider and cached live
+  feed with primary/fallback failover and the shared 46-currency list.
+- Swap-address validation helpers (`OpenReceive::SwapAddress`).
+- `OpenReceive::NwcRubyReceiveClient` adapts NIP-47 params to the shape the
+  wrapped client declares, by introspecting it: a positional request hash, a
+  `**rest` client, or exact keyword names — including nwc-ruby's `until_ts`
+  for the NIP-47 `until` scan window. A param the client cannot express raises
+  and names itself instead of failing as "wrong number of arguments".
+- `OpenReceive::NwcRubyReceiveClient#subscribe_notifications`: optional NWC-02
+  notifications forwarded to `nwc-ruby`'s `subscribe_to_notifications`, with
+  the yielded notification object translated back to the NWC-02 wire payload.
+  The adapter reports the capability of the client it wraps, so a client that
+  cannot notify still gets `listen_for_notifications!`'s "keep polling" error.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenReceive contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,62 @@
+# openreceive
+
+Pure Ruby exact-money, NWC normalization, and settlement-authority primitives
+for [OpenReceive](https://openreceive.org). It has no persistence dependency.
+Settlement requires `settled_at` or state `settled`; a preimage alone does not
+settle a payment.
+
+OpenReceive adds receive-only Bitcoin Lightning payments to a website or app:
+your server creates and verifies BOLT11 invoices through a wallet you control
+via a receive-only Nostr Wallet Connect (NWC / NIP-47) connection. This gem is
+the dependency-free core; most applications want one of the gems built on it:
+
+- [`openreceive-server`](https://rubygems.org/gems/openreceive-server) — the
+  storage-free Service and framework-agnostic Rack app for the shipped HTTP
+  routes.
+- [`openreceive-rails`](https://rubygems.org/gems/openreceive-rails) — the
+  mountable Rails engine with host-owned payment scaffolding.
+
+## Install
+
+```sh
+gem install openreceive
+```
+
+or in a Gemfile:
+
+```ruby
+gem "openreceive"
+```
+
+## What it provides
+
+- Exact decimal money conversion (fiat price -> msats) backed by `BigDecimal`,
+  with the shared cross-language test vectors.
+- NWC connection-URI parsing, validation, and redaction
+  (`OpenReceive.parse_nwc_uri`, `OpenReceive.redact_nwc_uri`). Receive-only NWC
+  codes never belong in browser code, logs, or examples.
+- Wallet-error and transaction normalization
+  (`OpenReceive::Nwc.normalize_wallet_error`,
+  `OpenReceive::Nwc.normalize_transaction`).
+- Settlement-authority rules: what counts as settled, and what never does.
+- The built-in price feed (`OpenReceive::Rates`): a static provider and the
+  cached live feed with primary/fallback failover, fail-closed windows, and
+  the shared currency list.
+- Swap-address checksum validation (`OpenReceive::SwapAddress`): refund and
+  deposit addresses are checksum-verified, never shape-guessed.
+- `OpenReceive::NwcRubyReceiveClient`, a thin adapter over a host-supplied
+  `nwc-ruby` client, including the optional NWC-02 notification subscription
+  (`subscribe_notifications`, forwarded to that gem's
+  `subscribe_to_notifications`).
+
+The behavior is pinned to the same test vectors as the Node engine
+(`spec/test-vectors` in the repository), so both engines make identical
+decisions.
+
+## Links
+
+- Documentation: <https://openreceive.org>
+- Source: <https://github.com/openreceive/openreceive>
+- Changelog: [CHANGELOG.md](CHANGELOG.md)
+
+MIT license.