Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
fix(x402-modal-sdk): pay() with a body sends POST, so a paid POST route is reachable
nirholasd5bf05f9568b
diff --git a/prompts/swarm-100/route-tutor.md b/prompts/swarm-100/route-tutor.mddeleted file mode 100644index df6773524..000000000--- a/prompts/swarm-100/route-tutor.md+++ /dev/null@@ -1,119 +0,0 @@-# Route audit: /tutor (Pay-As-You-Learn Tutor)--How to run: paste this file's repo path into a fresh Claude Code chat in this-repository and say "run this work order". This file is fully self-contained:-it depends on no other prompt file anywhere. If neighboring files in-prompts/swarm-100/ are gone, that work is done; if present, ignore them.-Every claim below rots; step 0 re-measures, and what you measure wins.--## Operating clause (binding)--- Read CLAUDE.md first. Its rules override everything, including this file.-- Finish 100% in this session. Never end the turn with a question, an option- list, or an unexecuted plan. A judgment call goes in one line of the final- report; it never becomes a question that halts work.-- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real- funds or any irreversible on-chain write, git push or a production deploy,- committing content that references a crypto project other than $THREE, and- destroying unrecoverable data.-- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no- commented-out code. Real APIs and real integrations only.-- The em-dash and en-dash characters are banned in everything you write.-- Concurrent agents share this worktree: stage explicit paths only (never a- bare add-everything), and commit finished work promptly.-- Before committing, run: npm run check:rules -- --paths <files you touched>.- It must exit 0.--## Step 0: re-derive the current state--1. This route's declared entry (path, description, added date):-- node -e "const p=require('./data/pages.json');for(const s of p.sections)for(const g of s.pages)if(g.path==='/tutor')console.log(JSON.stringify(g,null,2))"--2. Find the serving implementation: grep "/tutor" in vercel.json (the live- route table server/index.mjs boots from), then list matching files in- pages/ and src/. STRUCTURE.md maps every surface to its directory if the- grep is ambiguous.-3. Production right now:-- curl -so /dev/null -w '%{http_code}\n' https://three.ws/tutor--4. Start (or reuse) the local dev server: npm run dev (vite, port 3000).--## Task: audit this one route end to end, then fix everything found--Route: /tutor ("Pay-As-You-Learn Tutor", section "crypto").-Declared purpose: Ask anything and pay a cent per answer. A pay-as-you-learn AI tutor that bills $0.01 per explanation in USDC over x402, with a live itemized session invoice and signed attestation.--Drive the page in a real headless browser. Playwright is already a dev-dependency; keep your probe script in the session scratchpad, never in the-repo.--1. Load http://localhost:3000/tutor. Record the HTTP status, every console- error and warning, and every failed network request.-2. Exercise it like a first-time user: click the primary actions, run the- primary flow if one exists, follow the page's internal links. Every button- must do something real; every link must resolve. If the page renders data,- prove in the network log that it came from a live endpoint, not a baked-in- fallback array.-3. States: verify populated, empty, loading, and error states are designed and- reachable. Block the page's primary fetch in Playwright and confirm an- actionable error state appears, not a blank void or a raw exception.-4. Responsive: render at 320, 768, and 1440 px. No horizontal page scroll, no- overlapping or clipped controls.-5. Accessibility basics: one h1; interactive elements are real buttons or- links with visible focus states; images carry alt text; form fields have- labels.-6. Head: a specific title tag and meta description that match the declared- purpose above.-7. Fix every defect at its root in the page's real source files and re-run the- probe until clean. Defects in shared modules are in scope when this route- exercises them.--## Definition of done--- [ ] Local load of /tutor: HTTP 200, zero console errors, zero unhandled- failed requests (a third-party outage must land in a designed fallback,- not a broken page).-- [ ] No dead interactive element on the page: no stub href="#", no button- without a handler, no link to a missing path.-- [ ] Empty, loading, error, and populated states verified.-- [ ] 320 / 768 / 1440 px renders verified clean.-- [ ] Title and meta description present and specific.-- [ ] npm test passes; npm run check:rules -- --paths <touched files> exits 0.-- [ ] Production status from step 0 recorded in the report; if production- needs a deploy to pick up a fix, the report says so (deploys stay- owner-gated).--## Never blocked--| Blocker | Resolution (act, do not ask) |-|---|---|-| Missing env var or credential | Check .env and .env.local, then the Cloud Run service env, then Secret Manager (the CLAUDE.md self-unblock playbook has the exact commands). If it truly exists nowhere, wire the code fully behind the env var, prove the wiring with a dry run, and name the single missing var in the report. |-| gcloud not on PATH | Run: export PATH="$HOME/google-cloud-sdk/bin:$PATH" |-| Dev server port 3000 busy | Another agent may be serving this repo; probe it and reuse if so. Otherwise start your own on a free port: npx vite --port 3101 |-| Playwright browser missing | npx playwright install chromium |-| A surface needs a signed-in user | Register a fresh account through the real /register flow against the real API and use it. Never mock the session. |-| A defect sits in code you did not touch | Fix it if it blocks a Definition of done line (root cause it, never mask it). Otherwise note it in the report and continue. |-| An unrelated test is red | Same rule. Never pipe npm test through tail; it masks exit codes. |--## Close out (required)--1. Verify every Definition of done line with the actual command output in- front of you. Never claim a line you did not verify.-2. Commit with explicit paths and a subject that describes the diff (house- style: type(scope): what changed and why a reader cares).-3. Delete this prompt file in that same commit:-- git rm prompts/swarm-100/route-tutor.md-- The shrinking directory is this campaign's only progress ledger; there is- no progress log to update.-4. Final report: what step 0 measured, what changed (file list), evidence per- Definition of done line, and any one-line judgment calls. No trailing- questions, no unexecuted plans.--If a line genuinely cannot pass inside this session (an external party must-respond, or an owner-gated action is the final step), finish everything else,-leave this file in place, and state exactly which line remains and who owns-it. Never delete this file on a partial.diff --git a/tests/public/x402-discover-method.test.js b/tests/public/x402-discover-method.test.jsnew file mode 100644index 000000000..d5460ce86--- /dev/null+++ b/tests/public/x402-discover-method.test.js@@ -0,0 +1,92 @@+// @vitest-environment jsdom+//+// Regression guard for the checkout's price-discovery request (public/x402.js).+//+// window.X402.pay() defaulted the discovery method to GET while still attaching+// the caller's request body, and fetch() refuses that combination outright+// ("Request with GET/HEAD method cannot have body"). The throw landed before the+// endpoint was ever contacted, so every page paying a POST route without naming+// the method died at "Confirming price" and no payment was ever attempted. The+// /tutor page hit this on every question. A body now implies POST, matching what+// the data-attribute binding in the same file has always inferred.+//+// Fixtures use $THREE (the only coin) as the Solana asset/payTo, per CLAUDE.md.++import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';+import { pay } from '../../public/x402.js';++const THREE_MINT = 'FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump';++const solanaAccept = {+ scheme: 'exact',+ network: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',+ amount: '10000',+ asset: THREE_MINT,+ payTo: THREE_MINT,+ maxTimeoutSeconds: 60,+ resource: 'https://three.ws/api/x402/tutor',+ extra: { name: 'USDC', decimals: 6, feePayer: THREE_MINT },+};++function stub402() {+ return {+ status: 402,+ headers: { get: () => null },+ json: async () => ({ accepts: [solanaAccept] }),+ text: async () => '{"error":"payment required"}',+ };+}++// The discovery fetch runs in a microtask after mount; the promise pay() returns+// stays pending at the wallet-connect step, which is where these assertions end.+function flush() {+ return new Promise((resolve) => setTimeout(resolve, 0));+}++async function discoveryRequest(opts) {+ const fetchSpy = vi.fn(async () => stub402());+ global.fetch = fetchSpy;+ pay(opts).catch(() => {});+ await flush();+ const call = fetchSpy.mock.calls.find(([url]) => String(url).includes('/api/x402/tutor'));+ expect(call, 'discovery never reached the endpoint').toBeTruthy();+ return { url: call[0], init: call[1] };+}++describe('x402 price discovery: request method', () => {+ beforeEach(() => {+ document.body.innerHTML = '';+ });++ afterEach(() => {+ document.querySelector('.x402-overlay')?.remove();+ vi.restoreAllMocks();+ });++ it('sends POST when the caller supplies a body but no method', async () => {+ const { init } = await discoveryRequest({+ endpoint: '/api/x402/tutor',+ body: { sessionId: 'sess-1', question: 'Why does recursion overflow the stack?', level: 'beginner' },+ merchant: 'three.ws Tutor',+ action: 'Explain',+ });+ expect(init.method).toBe('POST');+ expect(JSON.parse(init.body).question).toContain('recursion');+ expect(init.headers['content-type']).toBe('application/json');+ });++ it('leaves a body-less call on GET', async () => {+ const { init } = await discoveryRequest({ endpoint: '/api/x402/tutor', merchant: 'three.ws Tutor' });+ expect(init.method).toBe('GET');+ expect(init.body).toBeUndefined();+ });++ it('never overrides a method the caller named', async () => {+ const { init } = await discoveryRequest({+ endpoint: '/api/x402/tutor',+ method: 'PUT',+ body: { question: 'What is a stack frame?' },+ });+ expect(init.method).toBe('PUT');+ });+});diff --git a/x402-modal-sdk/src/x402-modal.js b/x402-modal-sdk/src/x402-modal.jsindex 86fa1a840..74820d15d 100644--- a/x402-modal-sdk/src/x402-modal.js+++ b/x402-modal-sdk/src/x402-modal.js@@ -1403,6 +1403,16 @@ async function discoverChallenge(opts) {// ───────────────────────────────────────────────────────── public api ───────+// The README documents `method` as "POST when a body is set", and the quickstart+// at the top of this file passes { endpoint, body } with no method. Without this,+// that call pairs a body with the GET default and fetch() rejects it outright+// ("Request with GET/HEAD method cannot have body"), failing at price discovery+// before the endpoint is ever contacted. readOptsFrom() already infers it this way.+function normalizeOpts(opts) {+ if (opts.method) return opts;+ return { ...opts, method: opts.body ? 'POST' : 'GET' };+}+/*** Open the payment modal for an x402 endpoint and resolve when the call* succeeds (after settlement) or reject if the user cancels.@@ -1411,7 +1421,7 @@ async function discoverChallenge(opts) {*/export async function pay(opts) {if (!opts?.endpoint) throw new Error('X402.pay: endpoint is required');- const modal = new CheckoutModal(opts);+ const modal = new CheckoutModal(normalizeOpts(opts));const result = modal.mount();// Kick off discovery on the next tick so the modal animates in first.queueMicrotask(() => modal.start());