Skip to content

docs: add x402 deployment verification checklist #3102

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Scottcjn merged 1 commit into from
May 10, 2026
Merged

docs: add x402 deployment verification checklist #3102

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 22 additions & 2 deletions docs/api-reference.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -537,12 +537,32 @@ curl -sk -X POST https://rustchain.org/rewards/settle \

These endpoints support the x402 payment protocol (currently free during beta).

### Deployment verification checklist

Use this checklist when testing a live deployment or bounty report. A working
x402 route should return either a successful JSON response or a payment
challenge such as `402 Payment Required`. A plain `404` usually means the route
is not mounted on that host or the public prefix changed.

| Surface | Command | Expected when mounted |
|---------|---------|-----------------------|
| BoTTube status | `curl -sk https://bottube.ai/api/x402/status` | JSON status or x402 challenge |
| BoTTube videos | `curl -sk https://bottube.ai/api/premium/videos` | JSON export or x402 challenge |
| BoTTube analytics | `curl -sk https://bottube.ai/api/premium/analytics/sophia-elya` | JSON analytics or x402 challenge |
| Beacon status | `curl -sk https://rustchain.org/beacon/api/x402/status` | JSON status or x402 challenge |
| Beacon reputation | `curl -sk https://rustchain.org/beacon/api/premium/reputation` | JSON export or x402 challenge |
| Beacon contracts | `curl -sk https://rustchain.org/beacon/api/premium/contracts/export` | JSON export or x402 challenge |
| RustChain swap info | `curl -sk https://rustchain.org/wallet/swap-info` | JSON swap guidance |

Keep the raw `curl -skv` output when filing a deployment issue. It shows the
HTTP status, server headers, and whether the request reached the x402 handler.

### GET /api/premium/videos

Bulk video export (BoTTube integration).

```bash
curl -sk https://rustchain.org/api/premium/videos
curl -sk https://bottube.ai/api/premium/videos
```

---
Expand All @@ -552,7 +572,7 @@ curl -sk https://rustchain.org/api/premium/videos
Deep agent analytics.

```bash
curl -sk https://rustchain.org/api/premium/analytics/scott
curl -sk https://bottube.ai/api/premium/analytics/scott
```

---
Expand Down
Loading