openreceive-rails 0.4.13 → 0.4.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c17784f21721177e139d27349d7fa0367f2e6f90cce005e5dd61906ac5fae96a
-  data.tar.gz: f285c9fb57805628956740699f078115672f1485916784fbc2e4b6d8738b1578
+  metadata.gz: a60b35a3d97d75b923597623ae81c053fd2a7632881f0b6e912da6cf17d56823
+  data.tar.gz: e0eb5f150b5a591cdc8fe20007174da8154f3466a56f6b7b2a5b2abacca4b291
 SHA512:
-  metadata.gz: 16634ea35e356230c34b4da9ecf58bc8c089835d1b919692e41ddda40ef127fbddc23e5aa3090ba62835f90ba23b393d562a9006df015cbb5a84c2c16ec0ee35
-  data.tar.gz: 5d70f67f044bfa1003fb963da3e3e8ffe620f27517662d8fd1199ae0972906c7fcc1172196b8b8704d9c4354485700e2732dcf7d99ea818772cb19999a045296
+  metadata.gz: fef5b00ebad98f38e75bfc397c71c19e1743f621a92ff78462cb553efdb35a2d0e6112170808883fd44171e77d6a5b92e98a9e34ed5d05b2360970238f82df0f
+  data.tar.gz: 97b42ba9c0037f31321d2ce1fb875d4dad86284631d2b3981bb7f19219a82023876d94253735da0b1ce63cceff20d0492b524e3a33302f02db45bf6cc6a9e058

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.4.15 - 2026-10-06
+
+- Install agent skills with `bin/rails openreceive:skills` (optional
+  `--dir .claude/skills`). The core `openreceive` gem owns the one offline
+  bundle; Rails/server gems no longer duplicate it. Other Ruby hosts can use
+  `npx skills add OpenReceive/openreceive`.
+
+Requires `nwc-ruby ~> 0.3`. On 0.2.x a silent relay, or an offline wallet
+behind a live relay, could block a checkout's `make_invoice` and the boot
+preflight indefinitely, holding a web thread. 0.3 bounds every call by
+`request_timeout`, retries only failures from before the request is written,
+and tries each relay in the connection string. Relay failures now answer 503
+`WALLET_UNAVAILABLE` (retryable) instead of 502 `OTHER`.
+
+## 0.4.14 - 2026-10-04
+
+Fixes two 0.4.13 reconciliation regressions. A host-clock attempt could be
+skipped indefinitely: with one scan-window slot taken, selection moved its
+cursor past the whole batch and dropped the batch's host-clock attempts. The
+cursor now moves only past attempts it has queued. And a wallet that answers
+only one history page per slice re-read the same overlap page forever; an
+overlap answered alone is now spent, and the next slice reads the unseen page
+first. Both are pinned by new `reconcile-progress.json` vectors. The bundled
+integration skill also documents the plain-HTML checkout's way back to a swap
+refund (`resume-payment-hash`, `resumable`, the `openreceive-state` event).
+
 ## 0.4.13 - 2026-10-01
 
 Reconciliation no longer livelocks on a slow wallet. A wallet-history page
@@ -150,7 +176,8 @@ warning links the rate-limiting guide.
 
 ### The gem carries the agent skills
 
-`skills/` ships in the gem — the integrate and debug playbooks for coding
+At this release, `skills/` shipped in this gem (now supplied by the core
+`openreceive` dependency; see Unreleased) — the integrate and debug playbooks for coding
 agents, kept byte-identical to the repository tree by
 `npm run generate:skills`.
 

data/README.md

@@ -131,3 +131,13 @@ Storage-free `openreceive-server` handlers can call `on_paid` on every settled
 poll, so advanced hosts own the conditional write/outbox. A raw create hook
 refusal returns 409 with instructions withheld; repository infrastructure failures
 remain retryable 503.
+
+## Agent skills
+
+In Rails, run `bin/rails openreceive:skills` from your application. The offline
+skills ship once in the core `openreceive` gem. Non-Rails projects can use
+`npx skills add OpenReceive/openreceive`.
+See [agent setup](https://openreceive.org/agents). The bundled installers write
+to `.agents/skills/`; use `--dir .claude/skills` for Claude Code. They replace
+only `integrate-openreceive` and `debug-openreceive-payment`, preserving
+unrelated skills.

data/lib/openreceive/rails/version.rb

@@ -5,6 +5,6 @@ module OpenReceive
   # top-level `::Rails` framework constant — engine code always references the framework as
   # `::Rails` to avoid shadowing.
   module Rails
-    VERSION = "0.4.13"
+    VERSION = "0.4.15"
   end
 end

data/lib/openreceive/reconcile.rb

@@ -82,15 +82,29 @@ module OpenReceive
           candidates = OpenReceivePayment.reconcilable_attempts
         end
         unless candidates.empty?
-          last = candidates.last
-          scheduler["cursor"] = candidates.length < Server::RECONCILE_BATCH_SIZE ? nil : last.slice("created_at", "payment_hash")
           queued = windows.flat_map { |w| w.fetch("attempts").map { |a| a.fetch("payment_hash") } }
-          cohort = candidates.reject { |a| queued.include?(a.fetch("payment_hash")) }
           # A host-clock attempt's window spans the whole wallet history. It
           # gets its own window, so it never drags wallet-timed attempts into
-          # that walk; one the cap leaves out returns on cursor wrap.
-          cohort.partition { |a| a["created_at_source"] == "wallet" }.each do |group|
-            windows << ReconcileScan.new_window(group, observed_at, overlap_seconds) unless group.empty? || windows.length >= 2
+          # that walk. Candidates are taken in keyset order, and the cursor
+          # moves only past those already queued or admitted: one whose clock
+          # source has no free slot stops the selection and is read again next
+          # time, never skipped.
+          cohorts = {}
+          taken = 0
+          candidates.each do |attempt|
+            unless queued.include?(attempt.fetch("payment_hash"))
+              wallet = attempt["created_at_source"] == "wallet"
+              break if !cohorts.key?(wallet) && windows.length + cohorts.length >= 2
+
+              (cohorts[wallet] ||= []) << attempt
+            end
+            taken += 1
+          end
+          # A short batch taken whole already reached the ledger's tail: wrap now.
+          tail = taken == candidates.length && candidates.length < Server::RECONCILE_BATCH_SIZE
+          scheduler["cursor"] = tail ? nil : candidates[taken - 1].slice("created_at", "payment_hash")
+          [true, false].each do |wallet|
+            windows << ReconcileScan.new_window(cohorts[wallet], observed_at, overlap_seconds) if cohorts.key?(wallet)
           end
         end
       end

data/lib/openreceive/reconcile_scan.rb

@@ -27,6 +27,15 @@ module OpenReceive
       anchor = resumed ? window["anchor_offset"] : nil
       replaying = !anchor.nil?
       previous = window["fingerprint"]
+      # The last answered page was the overlap re-read. A slice that ends here
+      # spends the overlap, so the next slice reads the unseen page first: a
+      # wallet answering one page per slice still advances. The fingerprint
+      # stays, to catch a wallet that ignores offset.
+      overlap_only = false
+      continued = lambda do
+        window["anchor_offset"] = nil if overlap_only
+        [results.values, false, false]
+      end
       max_pages.times do |page_number|
         break if Process.clock_gettime(Process::CLOCK_MONOTONIC) >= deadline
 
@@ -47,9 +56,11 @@ module OpenReceive
           # that never answers stays visible.
           raise if page_number.zero? || Process.clock_gettime(Process::CLOCK_MONOTONIC) < deadline
 
-          return [results.values, false, false]
+          return continued.call
         end
-        return [results.values, false, false] if Process.clock_gettime(Process::CLOCK_MONOTONIC) >= deadline
+        return continued.call if Process.clock_gettime(Process::CLOCK_MONOTONIC) >= deadline
+
+        overlap_only = false
 
         rows = page.fetch("transactions")
         physical = rows.length + page.fetch("skipped_rows", 0)
@@ -73,6 +84,7 @@ module OpenReceive
           unless physical.zero?
             window["anchor_offset"] = offset
             window["fingerprint"] = fingerprint
+            overlap_only = true
             next
           end
         end
@@ -100,7 +112,7 @@ module OpenReceive
         previous = fingerprint
         return [results.values, true, false] if expected.all? { |hash| %w[settled expired failed].include?(window.fetch("observations").dig(hash, "status")) }
       end
-      [results.values, false, false]
+      continued.call
     end
   end
 end

data/lib/rails/commands/openreceive/openreceive_command.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "rails/command"
+require "openreceive/skills"
+
+module Rails
+  module Command
+    # A Rails command accepts --dir before the Rake fallback parses arguments.
+    # It does not boot the application or require wallet credentials.
+    class OpenreceiveCommand < Base
+      desc "skills", "Install the bundled OpenReceive agent skills into this project"
+      method_option :dir, type: :string, default: ".agents/skills"
+      def skills
+        OpenReceive::Skills.install(directory: options[:dir])
+      end
+    end
+  end
+end

data/lib/tasks/openreceive.rake

@@ -1,6 +1,12 @@
 # frozen_string_literal: true
 
 namespace :openreceive do
+  desc "Install agent skills (optional directory: openreceive:skills[path])"
+  task :skills, [:dir] do |_task, args|
+    require "openreceive/skills"
+    OpenReceive::Skills.install(directory: args[:dir] || ".agents/skills")
+  end
+
   # Step 0 of the agent directions, as one command.
   #
   # "Look for NWC_URI in this app's server environment" is a SEARCH, and it has
@@ -18,6 +24,7 @@ namespace :openreceive do
     set = ->(name) { ENV[name].to_s.strip.empty? ? "unset" : "set" }
     lines = [
       "openreceive:doctor",
+      "Agent skills: run `bin/rails openreceive:skills`",
       "  NWC_URI:          #{set.call('NWC_URI')}",
       "  LSC_URI_PRIMARY:  #{set.call('LSC_URI_PRIMARY')}",
       "  LSC_URI_BACKUP:   #{set.call('LSC_URI_BACKUP')}"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openreceive-rails
 version: !ruby/object:Gem::Version
-  version: 0.4.13
+  version: 0.4.15
 platform: ruby
 authors:
 - OpenReceive
@@ -15,28 +15,28 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.4.13
+        version: 0.4.15
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.4.13
+        version: 0.4.15
 - !ruby/object:Gem::Dependency
   name: openreceive-server
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.4.13
+        version: 0.4.15
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.4.13
+        version: 0.4.15
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -57,20 +57,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.2.4
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.2.4
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -130,19 +124,8 @@ files:
 - lib/openreceive/rails/version.rb
 - lib/openreceive/reconcile.rb
 - lib/openreceive/reconcile_scan.rb
+- lib/rails/commands/openreceive/openreceive_command.rb
 - lib/tasks/openreceive.rake
-- skills/debug-openreceive-payment/SKILL.md
-- skills/integrate-openreceive/SKILL.md
-- skills/integrate-openreceive/references/btcpay.md
-- skills/integrate-openreceive/references/django.md
-- skills/integrate-openreceive/references/fastapi.md
-- skills/integrate-openreceive/references/fastify.md
-- skills/integrate-openreceive/references/laravel.md
-- skills/integrate-openreceive/references/next.md
-- skills/integrate-openreceive/references/node.md
-- skills/integrate-openreceive/references/php.md
-- skills/integrate-openreceive/references/rails.md
-- skills/integrate-openreceive/references/woocommerce.md
 homepage: https://openreceive.org
 licenses:
 - MIT

data/skills/debug-openreceive-payment/SKILL.md

@@ -1,97 +0,0 @@
----
-name: debug-openreceive-payment
-description: >
-  Diagnose a failing OpenReceive integration. Use when an OpenReceive-powered
-  checkout misbehaves: the server refuses to boot, checkout routes return 403,
-  404, 409, or 5xx, a paid invoice never settles, a swap refund seems
-  unreachable, or the checkout UI renders nothing.
-license: MIT
----
-
-# Debug an OpenReceive payment
-
-Work top-down: configuration, then the request, then settlement. Every guide
-URL below is raw markdown — fetch it when the step needs it.
-
-## 1. Run the doctor first
-
-```sh
-npx openreceive doctor                     # Node version, NWC_URI, swap config, wallet probe
-npx openreceive doctor --db <db>           # + are openreceive_payments/openreceive_meta migrated?
-npx openreceive doctor --url http://localhost:3000   # + are the routes actually mounted?
-```
-
-Each failing line states its own fix. `npx openreceive debug-report` prints the
-same diagnostics redacted, always exit 0 — safe to share.
-
-## 2. Boot failures
-
-| Symptom | Cause and fix |
-| --- | --- |
-| `MISSING_NWC` / "needs a receive-only NWC code" | `NWC_URI` is not in the server process env. A `.env` file alone is not enough — something must load it (`dotenv/config`, Next auto-load). Get a code: https://openreceive.org/get_a_nwc_code_to_receive_payments |
-| `INVALID_NWC` / "not a valid NWC code" | The value is malformed (must be `nostr+walletconnect://` with 64-hex pubkey and secret, ≥1 `wss` relay). Re-copy it from the wallet. |
-| "NOT receive-only" / spend methods advertised | The wallet minted a spend-capable code; OpenReceive fails closed because a leak would drain the wallet. Mint a receive-only code. Overriding (`allowSpendCapableWallet` / `OPENRECEIVE_ALLOW_SPEND_CAPABLE_NWC`) is a last resort. |
-| Wallet preflight failed (methods/encryption) | The wallet must advertise `make_invoice` + `list_transactions` and NIP-04 or NIP-44 v2. Use a compatible wallet. |
-| "The openreceive_meta table does not exist" / raw `no such table: openreceive_payments` | The migration was never applied. Node: `npx openreceive scaffold payments --orm <yours>`, then run the emitted migration through the app's normal workflow. Rails: `bin/rails generate openreceive:install`, then `bin/rails db:migrate`. https://openreceive.org/guides/storage.md |
-| "requires amountFor / onPaid / authorize / host" | The factory is missing a required hook — see the host contract in https://openreceive.org/guides/api-reference.md |
-
-## 3. Request-time errors from the routes
-
-| Status | Meaning | Where to look |
-| --- | --- | --- |
-| 403 FORBIDDEN | Your own `authorize` hook denied it, or the request looked cross-site. Check the session/cookie actually reaches the checkout routes. https://openreceive.org/guides/authorization.md |
-| Never 403s — any visitor can mint, poll, or refund for any reference | The opposite failure: on Rails the generated `config.authorize = OpenReceive::ALLOW_ALL_AUTHORIZE` placeholder is still installed (the engine warns at boot; `bin/rails openreceive:doctor` reports it). Replace it with the app's real ownership check. https://openreceive.org/guides/authorization.md |
-| 404 NOT_FOUND | `amountFor` returned `null` (unknown reference), or the `payment_hash` does not belong to that reference. |
-| 409 CONFLICT | **Normal state, not a bug**: the reference already settled, or an unpaid checkout for that method is already live. Show it as order state; never retry-loop. |
-| 503 retryable | The host hook failed while persisting the attempt (instructions withheld), or the wallet is unavailable. Read the server log for the underlying error. |
-| Framework 404 / HTML error page | The router is not mounted, or mounted at a different prefix than the UI's `prefix` prop. `doctor --url` distinguishes these. |
-
-## 4. Paid but never settles
-
-- Settlement is opportunistic: any OpenReceive request runs one reconcile pass
-  through a durable gate (min 3s between wallet scans, stretched by invoice
-  age). A quiet server settles on the next request — or run the optional
-  notification worker. No timer is missing; that is the design.
-- An unpaid attempt closes only after a successful wallet scan at/after expiry
-  plus a 900s grace constant — a local clock alone never closes one. `expired`
-  arriving "late" is correct.
-- `onPaid` runs once per reference, first settled attempt only, inside the
-  settlement transaction. If your fulfillment did not run, check whether the
-  guarded `UPDATE … WHERE` matched zero rows (already transitioned).
-  https://openreceive.org/guides/storage.md
-
-## 5. Swaps and refunds
-
-- A deposit that arrives short or late becomes `refund_required`; the payer
-  claims it on a second visit. That needs a per-order URL you serve
-  (`/checkout/:reference`, `syncUrl` on the drop-ins). Keep the
-  `payment_hash`: `POST /swaps/status` reopens the attempt with no expiry
-  window, while re-picking the coin mints a new deposit after ~30 minutes.
-- Refunds exist only for swap deposits from `refund_required`. There is **no
-  Lightning refund** — the wallet cannot spend. Do not chase one.
-  https://openreceive.org/guides/swap-refunds.md
-- "Payer reports two different amounts on a stablecoin checkout" (50.05 or
-  50.03?): the deposit amount is a token quantity, `fee.pay_in_fiat` is its
-  fiat valuation. Only `swap.deposit_amount` is an instruction. From 0.4.10 the
-  packaged checkout renders a USD stablecoin's breakdown in the token and never
-  shows `pay_in_fiat`; on an older bundle, upgrade `@openreceive/*`. To verify,
-  read the row's `deposit_amount` and `fee` and confirm the UI shows only the
-  deposit amount. A custom UI must call `createSwapFeeBreakdown(fee, swap)`
-  with the swap, not the fee alone.
-
-## 6. Checkout UI shows nothing
-
-- The components require `prefix` — the exact base path the routes are mounted
-  at (`"/openreceive"` unless you changed it).
-- Import the stylesheet (`@openreceive/react/styles.css` or the elements
-  sheet).
-- "invoice must not be an NWC connection string" means a server secret leaked
-  into a browser payload — stop and fix the server response; never render it.
-  https://openreceive.org/guides/frontend-checkout.md
-
-## Still stuck
-
-The full route/option/error reference:
-https://openreceive.org/guides/api-reference.md · machine-readable contract:
-https://openreceive.org/openapi.yaml · library bug reports:
-https://openreceive.org/contact

data/skills/integrate-openreceive/SKILL.md

@@ -1,139 +0,0 @@
----
-name: integrate-openreceive
-description: >
-  Integrate OpenReceive inbound Bitcoin Lightning payments into an application.
-  Use when adding Bitcoin, Lightning, or crypto checkout to a Node.js, Express,
-  Fastify, Next.js, Rails, React, Vue, Svelte, Angular, or plain-HTML
-  application with OpenReceive (the @openreceive/* npm packages or the
-  openreceive-rails gem), or when connecting a BTCPay Server store to a
-  receive-only NWC wallet with the OpenReceive plugin.
-license: MIT
----
-
-# Integrate OpenReceive
-
-OpenReceive is a payment library that runs inside the application you are
-editing. It mounts HTTP routes there, issues Lightning invoices against a
-wallet the merchant already controls, and calls back into your code when one
-settles. There is no OpenReceive account and no API key; funds land directly in
-the merchant's wallet. The one required credential is a **receive-only NWC
-code** (`NWC_URI`).
-
-## Pick the stack, then follow its directions
-
-1. Identify the server stack of the application you are in.
-2. Open the matching reference — it is complete (quickstart inlined) and needs
-   no network access:
-   - Node, Express: [references/node.md](references/node.md)
-   - Node, Fastify: [references/fastify.md](references/fastify.md)
-   - Node, Next.js App Router: [references/next.md](references/next.md)
-   - Rails: [references/rails.md](references/rails.md)
-   - Django: [references/django.md](references/django.md)
-   - Laravel: [references/laravel.md](references/laravel.md)
-   - WordPress + WooCommerce: [references/woocommerce.md](references/woocommerce.md) — the packaged gateway and merchant settings.
-   - BTCPay Server: [references/btcpay.md](references/btcpay.md) — a plugin,
-     configured in BTCPay's store UI or Greenfield API; no application code,
-     no npm packages, no gem. The rest of this file is about the library.
-3. Follow its **Step 0** first: before writing code or searching the machine,
-   ask the user for the receive-only NWC code (then the swap URI), one question
-   per message, and store each pasted code in the project's env file yourself.
-   Never print the value; never invent a placeholder.
-
-Install, per adapter — Express: `npm install @openreceive/express @openreceive/react`;
-Fastify: `npm install @openreceive/fastify @openreceive/react`; Next.js:
-`npm install @openreceive/next @openreceive/react`. Swap the UI package (`vue`,
-`svelte`, `angular`, `elements`) for the frontend the app already has. Install
-(Rails): `bundle add openreceive-rails`.
-
-## The three server objects
-
-| Object | Built with | Talks to |
-| --- | --- | --- |
-| Wallet client | `createOpenReceive()` | the merchant's wallet — mints invoices, reads settlement, holds the NWC code |
-| Host | `createHost()` | your database — your hooks plus the `openreceive_payments` table |
-| HTTP routes | `openReceiveExpress()` / `openReceiveFastify()` / `openReceiveNext()` / the Rails engine | the browser — mounted at `/openreceive` by default |
-
-The quickstart's one-factory form (`openReceiveExpress({ wallet, storage,
-amountFor, authorize })`) builds all three; compose them separately only for a
-shared wallet client or a custom repository. The checkout UI
-(`<Checkout reference={...} prefix="/openreceive" />`) is the optional fourth
-piece.
-
-## The host contract: authorize, amountFor, onPaid
-
-Your application keeps orders, users, prices, and fulfillment. Three hooks are
-the entire bridge — wire them to the models this app already has, never to
-copied demo models:
-
-- `amountFor(reference)` — the authoritative price, read from your own data.
-  Return `{ currency, value, description }` with `value` a **decimal string**
-  (never a float, never payer input), or `null` when there is nothing to pay
-  for. The `reference` is your order id: one per thing you fulfill, created
-  before checkout, kept across retries, never reused.
-- `authorize({ action, request, resource })` — your own access check, run on
-  every request. `resource.reference` is a claim the payer made, not proof;
-  read a real session.
-- `onPaid({ reference, paidAt, query })` — fulfillment, run once per reference
-  inside the settlement transaction, only for the first settled attempt. Use
-  the provided `query`, not your ORM's other connection, and guard the
-  transition (`UPDATE … WHERE state = 'awaiting_payment'`).
-
-## 409 is a state, not a failure
-
-The library serializes attempts per reference. A create that returns **409
-CONFLICT** is normal checkout flow: the reference already settled, or an unpaid
-checkout for that payment method is already in progress. Surface it as order
-state; do not retry-loop it, and do not build an idempotency store around it —
-that serialization is the library's job. (A hook failure while persisting an
-attempt is a **503 retryable**, deliberately distinct.)
-
-## Amounts on the deposit panel
-
-`swap.deposit_amount` is the ONLY amount a payer is ever told to send, in the
-pay-in token. `swap.fee.pay_in_fiat` / `payout_fiat` are fiat valuations that
-explain the spread (why the deposit exceeds the cart total); they are not
-instructions. For a stablecoin pegged to the fee currency (USDT, USDC) the
-packaged checkout expresses the breakdown in the token and never renders
-`pay_in_fiat` — "$50.03" under "50.05 USDC" reads as the same number with a
-typo. A custom UI gets the same rule from `createSwapFeeBreakdown(fee, swap)`;
-pass the swap, not just the fee.
-
-## Secrets
-
-`NWC_URI` and `LSC_URI_*` are server-only. Never put them in browser code,
-logs, assets, or tests. Boot fails closed if the NWC code advertises spend
-methods such as `pay_invoice` — mint a receive-only code
-(https://openreceive.org/get_a_nwc_code_to_receive_payments) instead of
-overriding.
-
-## Database tables
-
-```sh
-npx openreceive scaffold payments --orm prisma   # or drizzle | typeorm | sequelize | knex
-```
-
-emits the `openreceive_payments` + `openreceive_meta` migration for THIS app's
-database (Rails: `bin/rails generate openreceive:install`); run it through the
-app's normal migration workflow. The tables sit beside your models — no
-relations to them, no separate database, no Redis.
-
-## Verify, and test without a real wallet
-
-`npx openreceive doctor` checks the configuration and says what to fix.
-
-For tests, inject a fake wallet at the stable seams — `client` on
-`createOpenReceive` (any object with `preflight`, `makeInvoice`,
-`listTransactions`) or `config.nwc_client` in Rails — plus
-`StaticPriceProvider` for fiat pricing without a network. Your routes,
-persistence, reconcile, and `onPaid` then run the production code paths.
-Details: https://openreceive.org/guides/host-testing.md
-
-## Deeper documentation
-
-Fetch on demand — each URL is raw markdown:
-https://openreceive.org/guides/authorization.md ·
-https://openreceive.org/guides/storage.md ·
-https://openreceive.org/guides/api-reference.md ·
-https://openreceive.org/guides/security.md ·
-https://openreceive.org/openapi.yaml (the normative HTTP contract) ·
-https://openreceive.org/llms.txt (the full index)