openreceive-server 0.4.5 → 0.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7e257329d76d96f9ca09bc133fa231563a61c6beedce0aaedef266ae2f00a09f
4
- data.tar.gz: 4842001e2e42d242a3c3ffdf47ce569831df63c5543d79ba1f49eaab76f21d61
3
+ metadata.gz: accc359244d60dc48efa35a0d18e006483a2003228585d158f9a94f8adcfa20d
4
+ data.tar.gz: 2be9c58cebcd86d46c4b324e3f346259339fe85f68a4ac0e2e26edbb1accd904
5
5
  SHA512:
6
- metadata.gz: af97510aae69684a50cc170c5f9d9ab07b94fed9ada6b3af136f088fa44ec05a8611f8f59a50ea5a18e3d59d20d531f94c0263da92f463b2c0a2f8101d68f289
7
- data.tar.gz: fbf53b4d0313aecca1bf2738b3e05b8c4973ad869e7c825993162e62fa70af369c9e2e6fd0de288ed62bcd97b1fc7f3b3fbf52d13081a89af4515df778a5882e
6
+ metadata.gz: 752a6a92242d4e046632b151193ea93c29153c537795c85c3675a9f746fdc95d1a87035362a07e7e5d466838f9ed3be05fd7980c97e379e899e6d502596a712f
7
+ data.tar.gz: eae62bd8da97447e3e3ece651bee76c7f05624399676ad4b08255281fb7199cf7d365ce1f9c97fab210c5712afed7c5901740016caaced19359f3d4cb436aa0a
data/CHANGELOG.md CHANGED
@@ -1,5 +1,20 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.4.8 - 2026-09-14
4
+
5
+ Version alignment with the 0.4.8 checkout loading fix; no Ruby server API or
6
+ payment behavior changes.
7
+
8
+ ## 0.4.7 - 2026-09-13
9
+
10
+ Version alignment for the BTCPay plugin release; no Ruby behavior changes.
11
+
12
+ ## 0.4.6 - 2026-09-11
13
+
14
+ Refresh installation and quickstart documentation and package metadata.
15
+ Release in lockstep with openreceive 0.4.6, including the live-price request fix
16
+ that removes obsolete VEF. No server adapter API change.
17
+
3
18
  ## 0.4.5 - 2026-09-07
4
19
 
5
20
  Release in lockstep with the Python/PHP publishing workflow fixes and complete
data/README.md CHANGED
@@ -1,6 +1,41 @@
1
1
  # openreceive-server
2
2
 
3
- Storage-free Ruby service and Rack handler. Configure a receive-only NWC client. The host
3
+ **Accept Bitcoin Lightning payments in Ruby and Rack. Your app, your wallet.**
4
+
5
+ [OpenReceive](https://openreceive.org) brings Lightning checkout to your existing
6
+ Ruby application. Receive payments directly into a wallet you control, while
7
+ keeping your orders, prices, and fulfillment in your own code.
8
+
9
+ OpenReceive supports optional swaps from **USDT, USDC, SOL, and ETH** through
10
+ a configured swap provider. The provider converts the payment to **BTC over
11
+ Lightning**, which settles into the merchant's connected wallet. Available
12
+ assets and networks depend on the provider; swaps are optional.
13
+
14
+ - Create invoices and check payments through a receive-only Nostr Wallet
15
+ Connect (NWC) client.
16
+ - Use the payment service directly or mount the framework-agnostic Rack handler.
17
+ - Reconcile pending payments with shared settlement rules and exact money math.
18
+ - Keep your existing persistence stack, with no separate OpenReceive service
19
+ or database to deploy.
20
+
21
+ **Building with Rails?** Start with
22
+ [`openreceive-rails`](https://github.com/OpenReceive/openreceive/blob/master/packages/ruby/openreceive-rails/README.md): it adds payment storage,
23
+ reconciliation, and an install generator on top of this gem.
24
+
25
+ ## Install
26
+
27
+ Requires Ruby 3.2 or later. Add to your Gemfile and run `bundle install`:
28
+
29
+ ```ruby
30
+ gem "openreceive-server"
31
+ ```
32
+
33
+ For a custom integration, provide your NWC client, payment repository, and
34
+ application hooks. The service itself has no persistence dependency.
35
+
36
+ ## Connect your application
37
+
38
+ Configure a receive-only NWC client. The host
4
39
  authorizes requests, resolves order amounts, commits payment hashes before responding, and
5
40
  consumes at-least-once verified payment events by hash. The service refuses to start when the
6
41
  NWC connection advertises spend methods (`pay_invoice`, `multi_pay_invoice`,
@@ -46,3 +81,12 @@ they store to `service.reconcile_payments({ attempts:, max_pages:, deadline: })`
46
81
  and apply the per-hash results through `on_paid` — `RackApp` deliberately has
47
82
  no built-in hook, and the durable-gate convenience (`OpenReceive.maybe_reconcile!`)
48
83
  ships only with the Rails engine.
84
+
85
+ ## Links
86
+
87
+ - API reference: [Ruby and Rails APIs](https://github.com/OpenReceive/openreceive/blob/master/docs/guides/api-reference.md)
88
+ - Rails quickstart: [Use the engine with built-in persistence](https://github.com/OpenReceive/openreceive/blob/master/docs/guides/quickstart-rails.md)
89
+ - Source and issues: <https://github.com/openreceive/openreceive>
90
+ - Changelog: [CHANGELOG.md](CHANGELOG.md)
91
+
92
+ MIT license.
@@ -2,6 +2,6 @@
2
2
 
3
3
  module OpenReceive
4
4
  module Server
5
- VERSION = "0.4.5"
5
+ VERSION = "0.4.8"
6
6
  end
7
7
  end
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (BTCPay Server)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Connect a BTCPay Server store to a receive-only NWC wallet with the OpenReceive
6
6
  plugin, and optionally let payers pay BTCPay invoices with USDT, USDC, ETH or
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (Django)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Add OpenReceive to a Django project — the app you are already working in. You
6
6
  do not need a copy of the OpenReceive source: the Python package is on PyPI
@@ -245,11 +245,25 @@ built on `@openreceive/browser/headless`. Read that before writing components.
245
245
  "switch payment method".
246
246
  - No "Open wallet" button on desktop.
247
247
  - Wallet suggestions: `getPaymentWizardRoutes()` +
248
- `createWizardRouteDisplays`. Lightning only. Every image ships inside
249
- the JavaScript logos as data URIs, tutorials once `loadPayTutorialImages()`
250
- resolves (`image` is `undefined` until then) so serve nothing and set no
251
- asset option. When it works, the logos and payment icons render; a missing
252
- image means a CSP `img-src` that blocks `data:`, and the console names it.
248
+ `createWizardRouteDisplays`. Lightning only. Logos are data URIs; tutorial
249
+ images load from a JavaScript chunk. For a custom headless UI, load it when
250
+ a tutorial opens and look up the returned table by the tutorial's `path`:
251
+
252
+ ```js
253
+ import { loadPayTutorialImages } from "@openreceive/browser/headless";
254
+
255
+ const images = await loadPayTutorialImages();
256
+ const src = images[tutorial.path]; // data URI for the selected tutorial
257
+ ```
258
+
259
+ Render `src` as the image source and update your UI after loading. Existing
260
+ display objects do not update: their `tutorial.image` stays `undefined` if
261
+ created before loading. Alternatively, await the loader, recreate the displays
262
+ with `createWizardRouteDisplays`, and render the new `tutorial.image`.
263
+ Show the caption while loading or if loading fails; never use an empty image
264
+ source. Deploy all JavaScript chunks and allow `data:` in CSP `img-src`.
265
+ For missing images, check CSP errors, failed chunks, and stale displays.
266
+ Registry paths are lookup keys; there is no asset option or image route.
253
267
  The registry answers ~37 wallets: pass
254
268
  `providerPreviewLimit` and build "show all" from `display.providerCount`,
255
269
  or they push the QR off the screen.
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (FastAPI)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Add OpenReceive to a FastAPI application — the app you are already working in.
6
6
  You do not need a copy of the OpenReceive source: the engine is on PyPI
@@ -242,11 +242,25 @@ components.
242
242
  "switch payment method".
243
243
  - No "Open wallet" button on desktop.
244
244
  - Wallet suggestions: `getPaymentWizardRoutes()` +
245
- `createWizardRouteDisplays`. Lightning only. Every image ships inside
246
- the JavaScript logos as data URIs, tutorials once `loadPayTutorialImages()`
247
- resolves (`image` is `undefined` until then) so serve nothing and set no
248
- asset option. When it works, the logos and payment icons render; a missing
249
- image means a CSP `img-src` that blocks `data:`, and the console names it.
245
+ `createWizardRouteDisplays`. Lightning only. Logos are data URIs; tutorial
246
+ images load from a JavaScript chunk. For a custom headless UI, load it when
247
+ a tutorial opens and look up the returned table by the tutorial's `path`:
248
+
249
+ ```js
250
+ import { loadPayTutorialImages } from "@openreceive/browser/headless";
251
+
252
+ const images = await loadPayTutorialImages();
253
+ const src = images[tutorial.path]; // data URI for the selected tutorial
254
+ ```
255
+
256
+ Render `src` as the image source and update your UI after loading. Existing
257
+ display objects do not update: their `tutorial.image` stays `undefined` if
258
+ created before loading. Alternatively, await the loader, recreate the displays
259
+ with `createWizardRouteDisplays`, and render the new `tutorial.image`.
260
+ Show the caption while loading or if loading fails; never use an empty image
261
+ source. Deploy all JavaScript chunks and allow `data:` in CSP `img-src`.
262
+ For missing images, check CSP errors, failed chunks, and stale displays.
263
+ Registry paths are lookup keys; there is no asset option or image route.
250
264
 
251
265
  ## More documentation
252
266
 
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (Fastify)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Add OpenReceive to a Fastify application — the app you are already working in.
6
6
  You do not need a copy of the OpenReceive source: the packages are on npm, and
@@ -225,11 +225,25 @@ components.
225
225
  "switch payment method".
226
226
  - No "Open wallet" button on desktop.
227
227
  - Wallet suggestions: `getPaymentWizardRoutes()` +
228
- `createWizardRouteDisplays`. Lightning only. Every image ships inside
229
- the JavaScript logos as data URIs, tutorials once `loadPayTutorialImages()`
230
- resolves (`image` is `undefined` until then) so serve nothing and set no
231
- asset option. When it works, the logos and payment icons render; a missing
232
- image means a CSP `img-src` that blocks `data:`, and the console names it.
228
+ `createWizardRouteDisplays`. Lightning only. Logos are data URIs; tutorial
229
+ images load from a JavaScript chunk. For a custom headless UI, load it when
230
+ a tutorial opens and look up the returned table by the tutorial's `path`:
231
+
232
+ ```js
233
+ import { loadPayTutorialImages } from "@openreceive/browser/headless";
234
+
235
+ const images = await loadPayTutorialImages();
236
+ const src = images[tutorial.path]; // data URI for the selected tutorial
237
+ ```
238
+
239
+ Render `src` as the image source and update your UI after loading. Existing
240
+ display objects do not update: their `tutorial.image` stays `undefined` if
241
+ created before loading. Alternatively, await the loader, recreate the displays
242
+ with `createWizardRouteDisplays`, and render the new `tutorial.image`.
243
+ Show the caption while loading or if loading fails; never use an empty image
244
+ source. Deploy all JavaScript chunks and allow `data:` in CSP `img-src`.
245
+ For missing images, check CSP errors, failed chunks, and stale displays.
246
+ Registry paths are lookup keys; there is no asset option or image route.
233
247
 
234
248
  ## More documentation
235
249
 
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (Laravel)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Add OpenReceive to a Laravel application — the app you are already working in.
6
6
  You do not need a copy of the OpenReceive source: the package is on Packagist
@@ -230,11 +230,25 @@ built on `@openreceive/browser/headless`. Read that before writing components.
230
230
  "switch payment method".
231
231
  - No "Open wallet" button on desktop.
232
232
  - Wallet suggestions: `getPaymentWizardRoutes()` +
233
- `createWizardRouteDisplays`. Lightning only. Every image ships inside
234
- the JavaScript logos as data URIs, tutorials once `loadPayTutorialImages()`
235
- resolves (`image` is `undefined` until then) so serve nothing and set no
236
- asset option. When it works, the logos and payment icons render; a missing
237
- image means a CSP `img-src` that blocks `data:`, and the console names it.
233
+ `createWizardRouteDisplays`. Lightning only. Logos are data URIs; tutorial
234
+ images load from a JavaScript chunk. For a custom headless UI, load it when
235
+ a tutorial opens and look up the returned table by the tutorial's `path`:
236
+
237
+ ```js
238
+ import { loadPayTutorialImages } from "@openreceive/browser/headless";
239
+
240
+ const images = await loadPayTutorialImages();
241
+ const src = images[tutorial.path]; // data URI for the selected tutorial
242
+ ```
243
+
244
+ Render `src` as the image source and update your UI after loading. Existing
245
+ display objects do not update: their `tutorial.image` stays `undefined` if
246
+ created before loading. Alternatively, await the loader, recreate the displays
247
+ with `createWizardRouteDisplays`, and render the new `tutorial.image`.
248
+ Show the caption while loading or if loading fails; never use an empty image
249
+ source. Deploy all JavaScript chunks and allow `data:` in CSP `img-src`.
250
+ For missing images, check CSP errors, failed chunks, and stale displays.
251
+ Registry paths are lookup keys; there is no asset option or image route.
238
252
  The registry answers ~37 wallets: pass
239
253
  `providerPreviewLimit` and build "show all" from `display.providerCount`,
240
254
  or they push the QR off the screen.
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (Next.js)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Add OpenReceive to a Next.js App Router application — the app you are already
6
6
  working in. You do not need a copy of the OpenReceive source: the packages are
@@ -231,11 +231,25 @@ components.
231
231
  "switch payment method".
232
232
  - No "Open wallet" button on desktop.
233
233
  - Wallet suggestions: `getPaymentWizardRoutes()` +
234
- `createWizardRouteDisplays`. Lightning only. Every image ships inside
235
- the JavaScript logos as data URIs, tutorials once `loadPayTutorialImages()`
236
- resolves (`image` is `undefined` until then) so serve nothing and set no
237
- asset option. When it works, the logos and payment icons render; a missing
238
- image means a CSP `img-src` that blocks `data:`, and the console names it.
234
+ `createWizardRouteDisplays`. Lightning only. Logos are data URIs; tutorial
235
+ images load from a JavaScript chunk. For a custom headless UI, load it when
236
+ a tutorial opens and look up the returned table by the tutorial's `path`:
237
+
238
+ ```js
239
+ import { loadPayTutorialImages } from "@openreceive/browser/headless";
240
+
241
+ const images = await loadPayTutorialImages();
242
+ const src = images[tutorial.path]; // data URI for the selected tutorial
243
+ ```
244
+
245
+ Render `src` as the image source and update your UI after loading. Existing
246
+ display objects do not update: their `tutorial.image` stays `undefined` if
247
+ created before loading. Alternatively, await the loader, recreate the displays
248
+ with `createWizardRouteDisplays`, and render the new `tutorial.image`.
249
+ Show the caption while loading or if loading fails; never use an empty image
250
+ source. Deploy all JavaScript chunks and allow `data:` in CSP `img-src`.
251
+ For missing images, check CSP errors, failed chunks, and stale displays.
252
+ Registry paths are lookup keys; there is no asset option or image route.
239
253
 
240
254
  ## More documentation
241
255
 
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (Node.js)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Add OpenReceive to a Node application — the app you are already working in. You
6
6
  do not need a copy of the OpenReceive source: the packages are on npm, and the
@@ -217,11 +217,25 @@ components.
217
217
  "switch payment method".
218
218
  - No "Open wallet" button on desktop.
219
219
  - Wallet suggestions: `getPaymentWizardRoutes()` +
220
- `createWizardRouteDisplays`. Lightning only. Every image ships inside
221
- the JavaScript logos as data URIs, tutorials once `loadPayTutorialImages()`
222
- resolves (`image` is `undefined` until then) so serve nothing and set no
223
- asset option. When it works, the logos and payment icons render; a missing
224
- image means a CSP `img-src` that blocks `data:`, and the console names it.
220
+ `createWizardRouteDisplays`. Lightning only. Logos are data URIs; tutorial
221
+ images load from a JavaScript chunk. For a custom headless UI, load it when
222
+ a tutorial opens and look up the returned table by the tutorial's `path`:
223
+
224
+ ```js
225
+ import { loadPayTutorialImages } from "@openreceive/browser/headless";
226
+
227
+ const images = await loadPayTutorialImages();
228
+ const src = images[tutorial.path]; // data URI for the selected tutorial
229
+ ```
230
+
231
+ Render `src` as the image source and update your UI after loading. Existing
232
+ display objects do not update: their `tutorial.image` stays `undefined` if
233
+ created before loading. Alternatively, await the loader, recreate the displays
234
+ with `createWizardRouteDisplays`, and render the new `tutorial.image`.
235
+ Show the caption while loading or if loading fails; never use an empty image
236
+ source. Deploy all JavaScript chunks and allow `data:` in CSP `img-src`.
237
+ For missing images, check CSP errors, failed chunks, and stale displays.
238
+ Registry paths are lookup keys; there is no asset option or image route.
225
239
 
226
240
  ## More documentation
227
241
 
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (PHP)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Add OpenReceive to a PHP application — the app you are already working in. You
6
6
  do not need a copy of the OpenReceive source: the engine is on Packagist
@@ -243,11 +243,25 @@ of https://openreceive.org/guides/checkout-ux.md, for a UI built on
243
243
  "switch payment method".
244
244
  - No "Open wallet" button on desktop.
245
245
  - Wallet suggestions: `getPaymentWizardRoutes()` +
246
- `createWizardRouteDisplays`. Lightning only. Every image ships inside
247
- the JavaScript logos as data URIs, tutorials once `loadPayTutorialImages()`
248
- resolves (`image` is `undefined` until then) so serve nothing and set no
249
- asset option. When it works, the logos and payment icons render; a missing
250
- image means a CSP `img-src` that blocks `data:`, and the console names it.
246
+ `createWizardRouteDisplays`. Lightning only. Logos are data URIs; tutorial
247
+ images load from a JavaScript chunk. For a custom headless UI, load it when
248
+ a tutorial opens and look up the returned table by the tutorial's `path`:
249
+
250
+ ```js
251
+ import { loadPayTutorialImages } from "@openreceive/browser/headless";
252
+
253
+ const images = await loadPayTutorialImages();
254
+ const src = images[tutorial.path]; // data URI for the selected tutorial
255
+ ```
256
+
257
+ Render `src` as the image source and update your UI after loading. Existing
258
+ display objects do not update: their `tutorial.image` stays `undefined` if
259
+ created before loading. Alternatively, await the loader, recreate the displays
260
+ with `createWizardRouteDisplays`, and render the new `tutorial.image`.
261
+ Show the caption while loading or if loading fails; never use an empty image
262
+ source. Deploy all JavaScript chunks and allow `data:` in CSP `img-src`.
263
+ For missing images, check CSP errors, failed chunks, and stale displays.
264
+ Registry paths are lookup keys; there is no asset option or image route.
251
265
 
252
266
  ## More documentation
253
267
 
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (Rails)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Add OpenReceive to a Rails application — the app you are already working in. You
6
6
  do not need a copy of the OpenReceive source: the gem is on RubyGems, the
@@ -224,11 +224,25 @@ built on `@openreceive/browser/headless`. Read that before writing components.
224
224
  "switch payment method".
225
225
  - No "Open wallet" button on desktop.
226
226
  - Wallet suggestions: `getPaymentWizardRoutes()` +
227
- `createWizardRouteDisplays`. Lightning only. Every image ships inside
228
- the JavaScript logos as data URIs, tutorials once `loadPayTutorialImages()`
229
- resolves (`image` is `undefined` until then) so serve nothing and set no
230
- asset option. When it works, the logos and payment icons render; a missing
231
- image means a CSP `img-src` that blocks `data:`, and the console names it.
227
+ `createWizardRouteDisplays`. Lightning only. Logos are data URIs; tutorial
228
+ images load from a JavaScript chunk. For a custom headless UI, load it when
229
+ a tutorial opens and look up the returned table by the tutorial's `path`:
230
+
231
+ ```js
232
+ import { loadPayTutorialImages } from "@openreceive/browser/headless";
233
+
234
+ const images = await loadPayTutorialImages();
235
+ const src = images[tutorial.path]; // data URI for the selected tutorial
236
+ ```
237
+
238
+ Render `src` as the image source and update your UI after loading. Existing
239
+ display objects do not update: their `tutorial.image` stays `undefined` if
240
+ created before loading. Alternatively, await the loader, recreate the displays
241
+ with `createWizardRouteDisplays`, and render the new `tutorial.image`.
242
+ Show the caption while loading or if loading fails; never use an empty image
243
+ source. Deploy all JavaScript chunks and allow `data:` in CSP `img-src`.
244
+ For missing images, check CSP errors, failed chunks, and stale displays.
245
+ Registry paths are lookup keys; there is no asset option or image route.
232
246
  The registry answers ~37 wallets: pass
233
247
  `providerPreviewLimit` and build "show all" from `display.providerCount`,
234
248
  or they push the QR off the screen.
@@ -1,6 +1,6 @@
1
1
  # OpenReceive agent directions (WordPress + WooCommerce)
2
2
 
3
- These directions describe OpenReceive 0.4.5.
3
+ These directions describe OpenReceive 0.4.8.
4
4
 
5
5
  Install and configure the OpenReceive gateway in the existing WooCommerce
6
6
  store. Preserve its theme, checkout, customer accounts, order model and prices.
@@ -90,6 +90,29 @@ Requirements: WordPress 6.6+, WooCommerce 9+, 64-bit PHP 8.2+ with GMP and sodiu
90
90
  and MySQL 8 or MariaDB 10.5+. Activation creates payment-attempt tables in the
91
91
  existing WordPress database. No separate database or application is required.
92
92
 
93
+ ### Get the installable archive
94
+
95
+ Use `openreceive-wordpress-<version>.zip` from the selected
96
+ [OpenReceive GitHub release](https://github.com/OpenReceive/openreceive/releases)
97
+ when that asset is listed. A GitHub source-code zip is not the plugin archive.
98
+ If the release does not yet provide a built zip, build it on a development
99
+ machine with Node 22+, PHP 8.2+, Composer and WP-CLI:
100
+
101
+ ```sh
102
+ git clone https://github.com/OpenReceive/openreceive.git
103
+ cd openreceive
104
+ git checkout <release-tag>
105
+ npm ci
106
+ npm run build:packages
107
+ composer install --working-dir=packages/php/wordpress
108
+ npm run release:wordpress:build
109
+ ```
110
+
111
+ Upload the resulting `dist/openreceive-wordpress-<version>.zip`. WP-CLI must be
112
+ on `PATH`, or set `OPENRECEIVE_WP_CLI` to the absolute path of its phar. The
113
+ WordPress server needs neither Node nor Composer: dependencies and checkout
114
+ assets are bundled inside the built plugin.
115
+
93
116
  ### Configure the wallet
94
117
 
95
118
  Open **WooCommerce → Settings → Payments → OpenReceive**. Enter a receive-only
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: openreceive-server
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.5
4
+ version: 0.4.8
5
5
  platform: ruby
6
6
  authors:
7
7
  - OpenReceive
@@ -15,18 +15,27 @@ dependencies:
15
15
  requirements:
16
16
  - - '='
17
17
  - !ruby/object:Gem::Version
18
- version: 0.4.5
18
+ version: 0.4.8
19
19
  type: :runtime
20
20
  prerelease: false
21
21
  version_requirements: !ruby/object:Gem::Requirement
22
22
  requirements:
23
23
  - - '='
24
24
  - !ruby/object:Gem::Version
25
- version: 0.4.5
26
- description: 'Server building blocks for OpenReceive: a storage-free Service that
27
- mirrors the Node engine and a framework-agnostic Rack app implementing the shipped
28
- HTTP routes while the host owns order and payment persistence. Receive-only: it
29
- never exposes a spend path and the NWC secret never leaves the server.'
25
+ version: 0.4.8
26
+ description: |
27
+ Accept Bitcoin Lightning payments directly into a wallet you control, from your
28
+ Ruby or Rack application. OpenReceive provides invoice creation, payment checks,
29
+ and settlement reconciliation through a receive-only Nostr Wallet Connect
30
+ (NWC) client. Optional swaps let customers pay with USDT, USDC, SOL, and ETH
31
+ through a configured provider; you receive BTC over Lightning in your wallet.
32
+ Available assets and networks depend on the provider.
33
+
34
+ Bring your own wallet client, authorization, and payment persistence. The service
35
+ and Rack handler fit into your existing application, with no separate OpenReceive
36
+ service or database to deploy. Your app keeps control of orders, prices, and
37
+ fulfillment; wallet credentials stay on the server. Rails developers can use
38
+ openreceive-rails for built-in payment storage and reconciliation.
30
39
  email:
31
40
  - info@openreceive.org
32
41
  executables: []
@@ -73,7 +82,7 @@ metadata:
73
82
  source_code_uri: https://github.com/openreceive/openreceive
74
83
  changelog_uri: https://github.com/openreceive/openreceive/blob/master/packages/ruby/openreceive-server/CHANGELOG.md
75
84
  bug_tracker_uri: https://github.com/openreceive/openreceive/issues
76
- documentation_uri: https://rubydoc.info/gems/openreceive-server
85
+ documentation_uri: https://github.com/openreceive/openreceive/blob/master/packages/ruby/openreceive-server/README.md
77
86
  rubygems_mfa_required: 'true'
78
87
  rdoc_options: []
79
88
  require_paths:
@@ -91,5 +100,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
91
100
  requirements: []
92
101
  rubygems_version: 3.6.9
93
102
  specification_version: 4
94
- summary: Storage-free OpenReceive receive-only service and HTTP routes for Ruby.
103
+ summary: Accept Bitcoin Lightning payments in Ruby and Rack. Your app, your wallet.
95
104
  test_files: []