@402flow/sdk 0.1.0-alpha.24 → 0.1.0-alpha.25
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.
- package/README.md +21 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -428,6 +428,17 @@ If your host app wants to execute through Dexter, pay.sh, or another provider, t
|
|
|
428
428
|
|
|
429
429
|
The repo keeps third-party executor proofs in the separate `third-party-executors/` package so the main `@402flow/sdk` install path stays provider-neutral.
|
|
430
430
|
|
|
431
|
+
That package is a private repo-local set of reference adapters, not part of the published `@402flow/sdk` package itself.
|
|
432
|
+
|
|
433
|
+
Current repo-local adapters:
|
|
434
|
+
|
|
435
|
+
| Adapter | Current scope | Key dependencies |
|
|
436
|
+
| --- | --- | --- |
|
|
437
|
+
| Dexter | Host-owned delegated execution against Dexter's paid request client | `@dexterai/x402` |
|
|
438
|
+
| pay.sh | Host-owned x402 Solana exact delegated execution | `@x402/core`, `@x402/svm`, `@solana/kit` |
|
|
439
|
+
|
|
440
|
+
The pay.sh adapter intentionally does not depend on `@solana/pay` today. The current proof targets pay.sh's x402 Solana exact flow, so challenge parsing, signed payment payload creation, and paid response parsing come from `@x402/core` plus `@x402/svm`, while `@solana/kit` only supplies the signer. `@solana/pay` becomes relevant when the repo adds a separate Solana Pay or MPP-specific adapter path.
|
|
441
|
+
|
|
431
442
|
For a repo-wide verification pass from the SDK root, run:
|
|
432
443
|
|
|
433
444
|
```bash
|
|
@@ -449,6 +460,16 @@ npm run example:dexter-delegated-executor -- \
|
|
|
449
460
|
'{"topic":"sdk integration rollout","audience":"platform engineers","format":"bullets"}'
|
|
450
461
|
```
|
|
451
462
|
|
|
463
|
+
For a repo-local host-owned pay.sh x402 example, run:
|
|
464
|
+
|
|
465
|
+
```bash
|
|
466
|
+
cd third-party-executors
|
|
467
|
+
npm install
|
|
468
|
+
npm run example:pay-sh-delegated-executor -- --help
|
|
469
|
+
```
|
|
470
|
+
|
|
471
|
+
The pay.sh example expects the standard SDK auth environment plus a local Solana signer path in `PAY_SH_SOLANA_KEYPAIR_PATH`. Run the `--help` form first to see the full required environment and argument contract.
|
|
472
|
+
|
|
452
473
|
## Prepared Result Semantics
|
|
453
474
|
|
|
454
475
|
`preparePaidRequest()` separates request checking from paid execution.
|