openreceive 0.4.19 → 0.4.21
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 +4 -4
- data/CHANGELOG.md +14 -0
- data/lib/openreceive/version.rb +1 -1
- data/skills/integrate-openreceive/references/btcpay.md +1 -1
- data/skills/integrate-openreceive/references/django.md +13 -5
- data/skills/integrate-openreceive/references/fastapi.md +12 -4
- data/skills/integrate-openreceive/references/fastify.md +14 -4
- data/skills/integrate-openreceive/references/laravel.md +11 -4
- data/skills/integrate-openreceive/references/next.md +16 -5
- data/skills/integrate-openreceive/references/node.md +15 -5
- data/skills/integrate-openreceive/references/php.md +12 -5
- data/skills/integrate-openreceive/references/rails.md +11 -4
- data/skills/integrate-openreceive/references/woocommerce.md +4 -4
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: dfeec42ce821ad2ab73b5140eb1959f76f4125c34f26bfd214cc0e68ef507a00
|
|
4
|
+
data.tar.gz: '09f6e1227799a8d50cab35b0b2e69d4eb6509e55f4e6cbbff9e5067c50fb9b06'
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 0bc687a6d13e167aa2ad2a9dbfc1286058177be57a245424e8ad8e0e911631579296b1520c3fa4876baca6562570b3fdeaadc3fd49576c49752102a72f939bc6
|
|
7
|
+
data.tar.gz: 64ab63dda22aafcac83e0b831ebc3ab17b441145eb07250516e2de2c8141eb7ebeb4cd812ac274fe1427df1c94e96fe00ec45b2b94c1aac47c89a07aa57b5d6b
|
data/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.4.21 - 2026-10-09
|
|
4
|
+
|
|
5
|
+
Release with the complete 0.4.21 package family. The bundled agent skills'
|
|
6
|
+
directions now end on a closing message of at most five lines that keeps the
|
|
7
|
+
test order and names the payment methods it offers, without calling a coin
|
|
8
|
+
unavailable over a swap minimum. No Ruby runtime changes from 0.4.20.
|
|
9
|
+
|
|
10
|
+
## 0.4.20 - 2026-10-09
|
|
11
|
+
|
|
12
|
+
Release with the complete 0.4.20 package family. The bundled agent skills now
|
|
13
|
+
describe the checkout stylesheet's rules as low specificity rather than zero:
|
|
14
|
+
inside the checkout they carry one attribute, so a host page's Tailwind
|
|
15
|
+
utilities cannot rearrange it. No Ruby runtime changes from 0.4.19.
|
|
16
|
+
|
|
3
17
|
## 0.4.19 - 2026-10-07
|
|
4
18
|
|
|
5
19
|
Release with the complete 0.4.19 package family. The bundled agent skills link
|
data/lib/openreceive/version.rb
CHANGED
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/btcpay/full.md
|
|
|
17
17
|
- Never tick the spend-capable override to make a save succeed.
|
|
18
18
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Connect a BTCPay Server store to a receive-only NWC wallet with the OpenReceive
|
|
23
23
|
plugin, and optionally let payers pay BTCPay invoices with USDT, USDC, ETH or
|
|
@@ -3,7 +3,7 @@ This is the full file; follow it from Step 0.
|
|
|
3
3
|
# OpenReceive agent directions (Django)
|
|
4
4
|
|
|
5
5
|
```sh
|
|
6
|
-
# READ THIS FIRST: this file is
|
|
6
|
+
# READ THIS FIRST: this file is 44 KB and a summary drops required steps. Download it whole:
|
|
7
7
|
curl -fsSL https://openreceive.org/agent-directions/django/full.md
|
|
8
8
|
# Skip the download only if you already have all of it: pasted, read from disk or fetched raw.
|
|
9
9
|
```
|
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/django/full.md
|
|
|
17
17
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
18
18
|
- Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Add OpenReceive to a Django project — the app you are already working in. You
|
|
23
23
|
do not need a copy of the OpenReceive source: the Python package is on PyPI
|
|
@@ -167,8 +167,15 @@ mark an order paid, and do not look for a way to (a wallet control port, a
|
|
|
167
167
|
test endpoint, another wallet). If the user wants a real settlement test, they
|
|
168
168
|
pay on that link from their own wallet, and `on_paid` marks the order paid.
|
|
169
169
|
|
|
170
|
-
Setup ends here. Say "Setup is finished" in one message
|
|
171
|
-
what to check. Do not
|
|
170
|
+
Setup ends here. Say "Setup is finished" in one message of at most five
|
|
171
|
+
lines, with the link and what to check. Do not list what changed, offer more
|
|
172
|
+
work, or end the message on a question.
|
|
173
|
+
|
|
174
|
+
- The link is to a real unpaid order. Keep that order; do not delete it.
|
|
175
|
+
- Name the methods it offers: Bitcoin, plus USDT, USDC, ETH and SOL when
|
|
176
|
+
`LSC_URI_PRIMARY` is saved. Never say a coin will not work or will not be
|
|
177
|
+
offered. Swap minimums apply per order, and a coin whose minimum is above an
|
|
178
|
+
order's total says so on its own tile.
|
|
172
179
|
|
|
173
180
|
## Non-negotiables
|
|
174
181
|
|
|
@@ -352,6 +359,7 @@ enough; drop the `.md` for the same page a person would read.
|
|
|
352
359
|
- https://openreceive.org/guides/authorization.md — before you write `authorize`
|
|
353
360
|
- https://openreceive.org/guides/environment-variables.md — every variable, and what is deliberately not one
|
|
354
361
|
- https://openreceive.org/guides/storage.md — the engine tables and the attempt state machine
|
|
362
|
+
- https://openreceive.org/guides/supabase.md — when the database is Supabase: its pooler, its certificate, and locking the tables away from its Data API
|
|
355
363
|
- https://openreceive.org/guides/frontend-checkout.md — the drop-in's props, attributes and slots
|
|
356
364
|
- https://openreceive.org/guides/checkout-ux.md — read before building any custom UI
|
|
357
365
|
- https://openreceive.org/guides/headless-checkout.md — the controller, the display models, refunds
|
|
@@ -690,7 +698,7 @@ manage.py openreceive_doctor # the same, for humans; neve
|
|
|
690
698
|
Serve the compiled `styles.css` without Tailwind processing. Either import it
|
|
691
699
|
from JavaScript (with a CSS-capable bundler) or use a plain
|
|
692
700
|
`<link rel="stylesheet">`. Do not `@import` it into your Tailwind entry. Its
|
|
693
|
-
rules have
|
|
701
|
+
rules have low specificity, so your own styles can override checkout styles.
|
|
694
702
|
Scoping does not prevent that.
|
|
695
703
|
|
|
696
704
|
The app serves JSON checkout routes only. Your template does the rendering. Any
|
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/fastapi/full.md
|
|
|
17
17
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
18
18
|
- Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Add OpenReceive to a FastAPI application — the app you are already working in.
|
|
23
23
|
You do not need a copy of the OpenReceive source: the engine is on PyPI
|
|
@@ -161,8 +161,15 @@ mark an order paid, and do not look for a way to (a wallet control port, a
|
|
|
161
161
|
test endpoint, another wallet). If the user wants a real settlement test, they
|
|
162
162
|
pay on that link from their own wallet, and `on_paid` marks the order paid.
|
|
163
163
|
|
|
164
|
-
Setup ends here. Say "Setup is finished" in one message
|
|
165
|
-
what to check. Do not
|
|
164
|
+
Setup ends here. Say "Setup is finished" in one message of at most five
|
|
165
|
+
lines, with the link and what to check. Do not list what changed, offer more
|
|
166
|
+
work, or end the message on a question.
|
|
167
|
+
|
|
168
|
+
- The link is to a real unpaid order. Keep that order; do not delete it.
|
|
169
|
+
- Name the methods it offers: Bitcoin, plus USDT, USDC, ETH and SOL when
|
|
170
|
+
`LSC_URI_PRIMARY` is saved. Never say a coin will not work or will not be
|
|
171
|
+
offered. Swap minimums apply per order, and a coin whose minimum is above an
|
|
172
|
+
order's total says so on its own tile.
|
|
166
173
|
|
|
167
174
|
## Non-negotiables
|
|
168
175
|
|
|
@@ -351,6 +358,7 @@ enough; drop the `.md` for the same page a person would read.
|
|
|
351
358
|
- https://openreceive.org/guides/authorization.md — before you write `authorize`
|
|
352
359
|
- https://openreceive.org/guides/environment-variables.md — every variable, and what is deliberately not one
|
|
353
360
|
- https://openreceive.org/guides/storage.md — the payment tables and the attempt state machine
|
|
361
|
+
- https://openreceive.org/guides/supabase.md — when the database is Supabase: its pooler, its certificate, and locking the tables away from its Data API
|
|
354
362
|
- https://openreceive.org/guides/frontend-checkout.md — the drop-in's props, attributes and slots
|
|
355
363
|
- https://openreceive.org/guides/checkout-ux.md — read before building any custom UI
|
|
356
364
|
- https://openreceive.org/guides/headless-checkout.md — the controller, the display models, refunds
|
|
@@ -590,7 +598,7 @@ rule applies only inside what OpenReceive renders.
|
|
|
590
598
|
Serve the compiled `styles.css` without Tailwind processing. Import it from
|
|
591
599
|
JavaScript if your bundler handles CSS, or use a plain
|
|
592
600
|
`<link rel="stylesheet">`. Do not `@import` it into your app's Tailwind entry.
|
|
593
|
-
Its rules have
|
|
601
|
+
Its rules have low specificity, so your page's styles can override checkout
|
|
594
602
|
styles. Scoping does not prevent that.
|
|
595
603
|
|
|
596
604
|
`<Checkout>` is complete as rendered. It already shows the `description` from
|
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/fastify/full.md
|
|
|
17
17
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
18
18
|
- Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Add OpenReceive to a Fastify application — the app you are already working in.
|
|
23
23
|
You do not need a copy of the OpenReceive source: the packages are on npm, and
|
|
@@ -144,6 +144,8 @@ The quickstart is done when
|
|
|
144
144
|
`npx openreceive doctor --db <file-or-url> --url <app url>` is clean and this
|
|
145
145
|
app serves the checkout page for one of its orders. Doctor names any failed
|
|
146
146
|
check and exits nonzero; fix it before going on.
|
|
147
|
+
Doctor reads `.env` itself. Never source it into a shell: the `&` in a
|
|
148
|
+
code splits the value and prints the pieces.
|
|
147
149
|
|
|
148
150
|
Give the user that checkout link. The browser check in the quickstart's step 6
|
|
149
151
|
(payment-method icons, wallet logos, a pay tutorial) is theirs: tell them what
|
|
@@ -154,8 +156,15 @@ mark an order paid, and do not look for a way to (a wallet control port, a
|
|
|
154
156
|
test endpoint, another wallet). If the user wants a real settlement test, they
|
|
155
157
|
pay on that link from their own wallet, and `onPaid` marks the order paid.
|
|
156
158
|
|
|
157
|
-
Setup ends here. Say "Setup is finished" in one message
|
|
158
|
-
what to check. Do not
|
|
159
|
+
Setup ends here. Say "Setup is finished" in one message of at most five
|
|
160
|
+
lines, with the link and what to check. Do not list what changed, offer more
|
|
161
|
+
work, or end the message on a question.
|
|
162
|
+
|
|
163
|
+
- The link is to a real unpaid order. Keep that order; do not delete it.
|
|
164
|
+
- Name the methods it offers: Bitcoin, plus USDT, USDC, ETH and SOL when
|
|
165
|
+
`LSC_URI_PRIMARY` is saved. Never say a coin will not work or will not be
|
|
166
|
+
offered. Swap minimums apply per order, and a coin whose minimum is above an
|
|
167
|
+
order's total says so on its own tile.
|
|
159
168
|
|
|
160
169
|
## Non-negotiables
|
|
161
170
|
|
|
@@ -335,6 +344,7 @@ enough; drop the `.md` for the same page a person would read.
|
|
|
335
344
|
- https://openreceive.org/guides/authorization.md — before you write `authorize`
|
|
336
345
|
- https://openreceive.org/guides/environment-variables.md — every variable, and what is deliberately not one
|
|
337
346
|
- https://openreceive.org/guides/storage.md — the payment tables and the attempt state machine
|
|
347
|
+
- https://openreceive.org/guides/supabase.md — when the database is Supabase: its pooler, its certificate, and locking the tables away from its Data API
|
|
338
348
|
- https://openreceive.org/guides/node-orms.md — recipes for Prisma, Drizzle, Knex, TypeORM, Sequelize
|
|
339
349
|
- https://openreceive.org/guides/frontend-checkout.md — the drop-in's props, attributes and slots
|
|
340
350
|
- https://openreceive.org/guides/checkout-ux.md — read before building any custom UI
|
|
@@ -597,7 +607,7 @@ rule applies only inside what OpenReceive renders.
|
|
|
597
607
|
Serve the compiled `styles.css` without Tailwind processing. Import it from
|
|
598
608
|
JavaScript if your bundler handles CSS, or use a plain
|
|
599
609
|
`<link rel="stylesheet">`. Do not `@import` it into your app's Tailwind entry.
|
|
600
|
-
Its rules have
|
|
610
|
+
Its rules have low specificity, so your page's styles can override checkout
|
|
601
611
|
styles. Scoping does not prevent that.
|
|
602
612
|
|
|
603
613
|
`<Checkout>` is complete as rendered. It already shows the `description` from
|
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/laravel/full.md
|
|
|
17
17
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
18
18
|
- Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Add OpenReceive to a Laravel application — the app you are already working in.
|
|
23
23
|
You do not need a copy of the OpenReceive source: the package is on Packagist
|
|
@@ -158,8 +158,15 @@ mark an order paid, and do not look for a way to (a wallet control port, a
|
|
|
158
158
|
test endpoint, another wallet). If the user wants a real settlement test, they
|
|
159
159
|
pay on that link from their own wallet, and `onPaid` marks the order paid.
|
|
160
160
|
|
|
161
|
-
Setup ends here. Say "Setup is finished" in one message
|
|
162
|
-
what to check. Do not
|
|
161
|
+
Setup ends here. Say "Setup is finished" in one message of at most five
|
|
162
|
+
lines, with the link and what to check. Do not list what changed, offer more
|
|
163
|
+
work, or end the message on a question.
|
|
164
|
+
|
|
165
|
+
- The link is to a real unpaid order. Keep that order; do not delete it.
|
|
166
|
+
- Name the methods it offers: Bitcoin, plus USDT, USDC, ETH and SOL when
|
|
167
|
+
`LSC_URI_PRIMARY` is saved. Never say a coin will not work or will not be
|
|
168
|
+
offered. Swap minimums apply per order, and a coin whose minimum is above an
|
|
169
|
+
order's total says so on its own tile.
|
|
163
170
|
|
|
164
171
|
## Non-negotiables
|
|
165
172
|
|
|
@@ -668,7 +675,7 @@ then costs one relay round trip, not two.
|
|
|
668
675
|
Serve the compiled `styles.css` without Tailwind processing. Either import it
|
|
669
676
|
from JavaScript (with a CSS-capable bundler) or use a plain
|
|
670
677
|
`<link rel="stylesheet">`. Do not `@import` it into your Tailwind entry. Its
|
|
671
|
-
rules have
|
|
678
|
+
rules have low specificity, so your own styles can override checkout styles.
|
|
672
679
|
Scoping does not prevent that.
|
|
673
680
|
|
|
674
681
|
The engine serves JSON checkout routes only. Your view does the rendering. Any
|
|
@@ -3,7 +3,7 @@ This is the full file; follow it from Step 0.
|
|
|
3
3
|
# OpenReceive agent directions (Next.js)
|
|
4
4
|
|
|
5
5
|
```sh
|
|
6
|
-
# READ THIS FIRST: this file is
|
|
6
|
+
# READ THIS FIRST: this file is 39 KB and a summary drops required steps. Download it whole:
|
|
7
7
|
curl -fsSL https://openreceive.org/agent-directions/next/full.md
|
|
8
8
|
# Skip the download only if you already have all of it: pasted, read from disk or fetched raw.
|
|
9
9
|
```
|
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/next/full.md
|
|
|
17
17
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
18
18
|
- Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Add OpenReceive to a Next.js App Router application — the app you are already
|
|
23
23
|
working in. You do not need a copy of the OpenReceive source: the packages are
|
|
@@ -149,6 +149,8 @@ The quickstart is done when
|
|
|
149
149
|
`npx openreceive doctor --db <file-or-url> --url <app url>` is clean and this
|
|
150
150
|
app serves the checkout page for one of its orders. Doctor names any failed
|
|
151
151
|
check and exits nonzero; fix it before going on.
|
|
152
|
+
Doctor reads `.env.local` itself. Never source it into a shell: the `&` in a
|
|
153
|
+
code splits the value and prints the pieces.
|
|
152
154
|
|
|
153
155
|
Give the user that checkout link. The browser check in the quickstart's step 6
|
|
154
156
|
(payment-method icons, wallet logos, a pay tutorial) is theirs: tell them what
|
|
@@ -159,8 +161,15 @@ mark an order paid, and do not look for a way to (a wallet control port, a
|
|
|
159
161
|
test endpoint, another wallet). If the user wants a real settlement test, they
|
|
160
162
|
pay on that link from their own wallet, and `onPaid` marks the order paid.
|
|
161
163
|
|
|
162
|
-
Setup ends here. Say "Setup is finished" in one message
|
|
163
|
-
what to check. Do not
|
|
164
|
+
Setup ends here. Say "Setup is finished" in one message of at most five
|
|
165
|
+
lines, with the link and what to check. Do not list what changed, offer more
|
|
166
|
+
work, or end the message on a question.
|
|
167
|
+
|
|
168
|
+
- The link is to a real unpaid order. Keep that order; do not delete it.
|
|
169
|
+
- Name the methods it offers: Bitcoin, plus USDT, USDC, ETH and SOL when
|
|
170
|
+
`LSC_URI_PRIMARY` is saved. Never say a coin will not work or will not be
|
|
171
|
+
offered. Swap minimums apply per order, and a coin whose minimum is above an
|
|
172
|
+
order's total says so on its own tile.
|
|
164
173
|
|
|
165
174
|
## Non-negotiables
|
|
166
175
|
|
|
@@ -344,6 +353,7 @@ enough; drop the `.md` for the same page a person would read.
|
|
|
344
353
|
- https://openreceive.org/guides/authorization.md — before you write `authorize`
|
|
345
354
|
- https://openreceive.org/guides/environment-variables.md — every variable, and what is deliberately not one
|
|
346
355
|
- https://openreceive.org/guides/storage.md — the payment tables and the attempt state machine
|
|
356
|
+
- https://openreceive.org/guides/supabase.md — when the database is Supabase: its pooler, its certificate, and locking the tables away from its Data API
|
|
347
357
|
- https://openreceive.org/guides/node-orms.md — recipes for Prisma, Drizzle, Knex, TypeORM, Sequelize
|
|
348
358
|
- https://openreceive.org/guides/frontend-checkout.md — the drop-in's props, attributes and slots
|
|
349
359
|
- https://openreceive.org/guides/checkout-ux.md — read before building any custom UI
|
|
@@ -361,6 +371,7 @@ enough; drop the `.md` for the same page a person would read.
|
|
|
361
371
|
- https://openreceive.org/guides/api-reference.md — every route, option and error code
|
|
362
372
|
- https://openreceive.org/guides/custom-checkout-route.md — advanced: replacing the shipped adapter's routes with your own
|
|
363
373
|
- https://openreceive.org/guides/react-material-ui-recipe.md — a worked custom UI on a component library
|
|
374
|
+
- https://openreceive.org/guides/tanstack-start-recipe.md — the same handler as a TanStack Start server route, if this app is TanStack Start after all
|
|
364
375
|
- https://openreceive.org/guides.md — the index, if what you need is not above
|
|
365
376
|
|
|
366
377
|
Questions, or a problem with the library itself:
|
|
@@ -647,7 +658,7 @@ scoped: every rule applies only inside what OpenReceive renders. You need no
|
|
|
647
658
|
|
|
648
659
|
Serve the compiled `styles.css` without Tailwind processing: import it from
|
|
649
660
|
JavaScript (with a CSS-capable bundler) or use a plain `<link rel="stylesheet">`.
|
|
650
|
-
Do not `@import` it into the host Tailwind entry. Its
|
|
661
|
+
Do not `@import` it into the host Tailwind entry. Its low-specificity rules
|
|
651
662
|
allow host styles to override checkout styles; scoping does not prevent that.
|
|
652
663
|
|
|
653
664
|
`<Checkout>` is complete as rendered. It already shows the `description` from
|
|
@@ -3,7 +3,7 @@ This is the full file; follow it from Step 0.
|
|
|
3
3
|
# OpenReceive agent directions (Node.js)
|
|
4
4
|
|
|
5
5
|
```sh
|
|
6
|
-
# READ THIS FIRST: this file is
|
|
6
|
+
# READ THIS FIRST: this file is 35 KB and a summary drops required steps. Download it whole:
|
|
7
7
|
curl -fsSL https://openreceive.org/agent-directions/node/full.md
|
|
8
8
|
# Skip the download only if you already have all of it: pasted, read from disk or fetched raw.
|
|
9
9
|
```
|
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/node/full.md
|
|
|
17
17
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
18
18
|
- Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Add OpenReceive to a Node application — the app you are already working in. You
|
|
23
23
|
do not need a copy of the OpenReceive source: the packages are on npm, and the
|
|
@@ -145,6 +145,8 @@ Only then start the quickstart.
|
|
|
145
145
|
The quickstart is done when `npx openreceive doctor --db <file-or-url> --url <app url>`
|
|
146
146
|
is clean and this app serves the checkout page for one of its orders. Doctor
|
|
147
147
|
names any failed check and exits nonzero; fix it before going on.
|
|
148
|
+
Doctor reads `.env` itself. Never source it into a shell: the `&` in a
|
|
149
|
+
code splits the value and prints the pieces.
|
|
148
150
|
|
|
149
151
|
Give the user that checkout link. The browser check in the quickstart's
|
|
150
152
|
step 6 (payment-method icons, wallet logos, a pay tutorial) is theirs: tell
|
|
@@ -155,8 +157,15 @@ mark an order paid, and do not look for a way to (a wallet control port, a
|
|
|
155
157
|
test endpoint, another wallet). If the user wants a real settlement test, they
|
|
156
158
|
pay on that link from their own wallet, and `onPaid` marks the order paid.
|
|
157
159
|
|
|
158
|
-
Setup ends here. Say "Setup is finished" in one message
|
|
159
|
-
what to check. Do not
|
|
160
|
+
Setup ends here. Say "Setup is finished" in one message of at most five
|
|
161
|
+
lines, with the link and what to check. Do not list what changed, offer more
|
|
162
|
+
work, or end the message on a question.
|
|
163
|
+
|
|
164
|
+
- The link is to a real unpaid order. Keep that order; do not delete it.
|
|
165
|
+
- Name the methods it offers: Bitcoin, plus USDT, USDC, ETH and SOL when
|
|
166
|
+
`LSC_URI_PRIMARY` is saved. Never say a coin will not work or will not be
|
|
167
|
+
offered. Swap minimums apply per order, and a coin whose minimum is above an
|
|
168
|
+
order's total says so on its own tile.
|
|
160
169
|
|
|
161
170
|
## Non-negotiables
|
|
162
171
|
|
|
@@ -331,6 +340,7 @@ enough; drop the `.md` for the same page a person would read.
|
|
|
331
340
|
- https://openreceive.org/guides/authorization.md — before you write `authorize`
|
|
332
341
|
- https://openreceive.org/guides/environment-variables.md — every variable, and what is deliberately not one
|
|
333
342
|
- https://openreceive.org/guides/storage.md — the payment tables and the attempt state machine
|
|
343
|
+
- https://openreceive.org/guides/supabase.md — when the database is Supabase: its pooler, its certificate, and locking the tables away from its Data API
|
|
334
344
|
- https://openreceive.org/guides/node-orms.md — recipes for Prisma, Drizzle, Knex, TypeORM, Sequelize
|
|
335
345
|
- https://openreceive.org/guides/frontend-checkout.md — the drop-in's props, attributes and slots
|
|
336
346
|
- https://openreceive.org/guides/checkout-ux.md — read before building any custom UI
|
|
@@ -575,7 +585,7 @@ rule applies only inside what OpenReceive renders.
|
|
|
575
585
|
Serve the compiled `styles.css` without Tailwind processing. Import it from
|
|
576
586
|
JavaScript if your bundler handles CSS, or use a plain
|
|
577
587
|
`<link rel="stylesheet">`. Do not `@import` it into your app's Tailwind entry.
|
|
578
|
-
Its rules have
|
|
588
|
+
Its rules have low specificity, so your page's styles can override checkout
|
|
579
589
|
styles. Scoping does not prevent that.
|
|
580
590
|
|
|
581
591
|
`<Checkout>` is complete as rendered. It already shows the `description` from
|
|
@@ -3,7 +3,7 @@ This is the full file; follow it from Step 0.
|
|
|
3
3
|
# OpenReceive agent directions (PHP)
|
|
4
4
|
|
|
5
5
|
```sh
|
|
6
|
-
# READ THIS FIRST: this file is
|
|
6
|
+
# READ THIS FIRST: this file is 39 KB and a summary drops required steps. Download it whole:
|
|
7
7
|
curl -fsSL https://openreceive.org/agent-directions/php/full.md
|
|
8
8
|
# Skip the download only if you already have all of it: pasted, read from disk or fetched raw.
|
|
9
9
|
```
|
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/php/full.md
|
|
|
17
17
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
18
18
|
- Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Add OpenReceive to a PHP application — the app you are already working in. You
|
|
23
23
|
do not need a copy of the OpenReceive source: the engine is on Packagist
|
|
@@ -163,8 +163,15 @@ mark an order paid, and do not look for a way to (a wallet control port, a
|
|
|
163
163
|
test endpoint, another wallet). If the user wants a real settlement test, they
|
|
164
164
|
pay on that link from their own wallet, and `onPaid` marks the order paid.
|
|
165
165
|
|
|
166
|
-
Setup ends here. Say "Setup is finished" in one message
|
|
167
|
-
what to check. Do not
|
|
166
|
+
Setup ends here. Say "Setup is finished" in one message of at most five
|
|
167
|
+
lines, with the link and what to check. Do not list what changed, offer more
|
|
168
|
+
work, or end the message on a question.
|
|
169
|
+
|
|
170
|
+
- The link is to a real unpaid order. Keep that order; do not delete it.
|
|
171
|
+
- Name the methods it offers: Bitcoin, plus USDT, USDC, ETH and SOL when
|
|
172
|
+
`LSC_URI_PRIMARY` is saved. Never say a coin will not work or will not be
|
|
173
|
+
offered. Swap minimums apply per order, and a coin whose minimum is above an
|
|
174
|
+
order's total says so on its own tile.
|
|
168
175
|
|
|
169
176
|
## Non-negotiables
|
|
170
177
|
|
|
@@ -613,7 +620,7 @@ HTTP routes and the browser snapshots are snake_case throughout.
|
|
|
613
620
|
Serve the compiled `styles.css` without Tailwind processing. Either import it
|
|
614
621
|
from JavaScript (with a CSS-capable bundler) or use a plain
|
|
615
622
|
`<link rel="stylesheet">`. Do not `@import` it into your Tailwind entry. Its
|
|
616
|
-
rules have
|
|
623
|
+
rules have low specificity, so your own styles can override checkout styles.
|
|
617
624
|
Scoping does not prevent that.
|
|
618
625
|
|
|
619
626
|
Unpack the release's `standalone-checkout-<version>.tar.gz` into a directory
|
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/rails/full.md
|
|
|
17
17
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
18
18
|
- Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Add OpenReceive to a Rails application — the app you are already working in. You
|
|
23
23
|
do not need a copy of the OpenReceive source: the gem is on RubyGems, the
|
|
@@ -154,8 +154,15 @@ mark an order paid, and do not look for a way to (a wallet control port, a
|
|
|
154
154
|
test endpoint, another wallet). If the user wants a real settlement test, they
|
|
155
155
|
pay on that link from their own wallet, and `on_paid` marks the order paid.
|
|
156
156
|
|
|
157
|
-
Setup ends here. Say "Setup is finished" in one message
|
|
158
|
-
what to check. Do not
|
|
157
|
+
Setup ends here. Say "Setup is finished" in one message of at most five
|
|
158
|
+
lines, with the link and what to check. Do not list what changed, offer more
|
|
159
|
+
work, or end the message on a question.
|
|
160
|
+
|
|
161
|
+
- The link is to a real unpaid order. Keep that order; do not delete it.
|
|
162
|
+
- Name the methods it offers: Bitcoin, plus USDT, USDC, ETH and SOL when
|
|
163
|
+
`LSC_URI_PRIMARY` is saved. Never say a coin will not work or will not be
|
|
164
|
+
offered. Swap minimums apply per order, and a coin whose minimum is above an
|
|
165
|
+
order's total says so on its own tile.
|
|
159
166
|
|
|
160
167
|
## Non-negotiables
|
|
161
168
|
|
|
@@ -630,7 +637,7 @@ live wallet is needed.
|
|
|
630
637
|
Serve the compiled `styles.css` without Tailwind processing. Either import it
|
|
631
638
|
from JavaScript (with a CSS-capable bundler) or use a plain
|
|
632
639
|
`<link rel="stylesheet">`. Do not `@import` it into your Tailwind entry. Its
|
|
633
|
-
rules have
|
|
640
|
+
rules have low specificity, so your own styles can override checkout styles.
|
|
634
641
|
Scoping does not prevent that.
|
|
635
642
|
|
|
636
643
|
The engine serves JSON checkout routes only. Your view does the rendering. Any
|
|
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/woocommerce/full.md
|
|
|
17
17
|
- Do not suggest rotating or revoking a code because it was pasted here.
|
|
18
18
|
- Setup is done only when the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
|
|
19
19
|
|
|
20
|
-
These directions describe OpenReceive 0.4.
|
|
20
|
+
These directions describe OpenReceive 0.4.21.
|
|
21
21
|
|
|
22
22
|
Install and configure the OpenReceive payment gateway in the WooCommerce store
|
|
23
23
|
you are working in. Preserve its theme, checkout, customer accounts, order
|
|
@@ -96,7 +96,7 @@ Install the plugin built for this release. Never install the GitHub
|
|
|
96
96
|
source-code ZIP or a ZIP from an older release:
|
|
97
97
|
|
|
98
98
|
```sh
|
|
99
|
-
wp plugin install https://github.com/OpenReceive/openreceive/releases/download/v0.4.
|
|
99
|
+
wp plugin install https://github.com/OpenReceive/openreceive/releases/download/v0.4.21/openreceive-wordpress-0.4.21.zip --activate
|
|
100
100
|
```
|
|
101
101
|
|
|
102
102
|
It needs WooCommerce active, and PHP 8.2+ with GMP and sodium in BOTH the web
|
|
@@ -236,7 +236,7 @@ database or application.
|
|
|
236
236
|
|
|
237
237
|
### Get the installable archive
|
|
238
238
|
|
|
239
|
-
Download [openreceive-wordpress-0.4.
|
|
239
|
+
Download [openreceive-wordpress-0.4.21.zip](https://github.com/OpenReceive/openreceive/releases/download/v0.4.21/openreceive-wordpress-0.4.21.zip)
|
|
240
240
|
from the matching release. Historical releases may lack this asset. If that exact
|
|
241
241
|
URL returns 404, build the same tag below; never silently install an older ZIP.
|
|
242
242
|
The GitHub source-code ZIP is not an installable plugin. On a development machine
|
|
@@ -245,7 +245,7 @@ with Node 22+, PHP 8.2+ with GMP/sodium, Composer and WP-CLI:
|
|
|
245
245
|
```sh
|
|
246
246
|
git clone https://github.com/OpenReceive/openreceive.git
|
|
247
247
|
cd openreceive
|
|
248
|
-
git checkout v0.4.
|
|
248
|
+
git checkout v0.4.21
|
|
249
249
|
npm ci
|
|
250
250
|
npm run build:packages
|
|
251
251
|
composer install --working-dir=packages/php/wordpress
|