Skip to content

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.

test(okx): probe the paid forge rows the way the marketplace reviewer does

nirholas4b22f8b8db76
diff --git a/docs/okx-marketplace.md b/docs/okx-marketplace.md
index c387a665c..bdaee1ac4 100644
--- a/docs/okx-marketplace.md
+++ b/docs/okx-marketplace.md
@@ -240,6 +240,13 @@ unit tests in [`tests/api/okx-forge.test.js`](../tests/api/okx-forge.test.js).
`PAYMENT-REQUIRED`. Every paid row answers it that way. Unparseable bytes from a caller
that is already past the paywall get the JSON-RPC parse error (`-32700`), and nothing
settles because nothing ran.
+- **Both of those are checked against the live site on demand.**
+ `node scripts/okx-compliance-probe.mjs` walks all four paid rows through the reviewer's
+ probe shapes (the bodyless self-check, an empty JSON body, a plain business payload, and
+ a well-formed priced `tools/call`) and exits non-zero if any 402 goes missing, duplicates
+ a rail, or quotes anything but the row's registered list price. Point it elsewhere with
+ `--base`, and capture the run with `--out prompts/okx-ai/e2e-evidence/<file>.json`. Run it
+ before every listing resubmission.
> **Not yet demonstrated end to end.** The X Layer rail reports `settleable: true` in
> production, but no *funded* call has settled on-chain against these endpoints yet: the
diff --git a/scripts/okx-compliance-probe.mjs b/scripts/okx-compliance-probe.mjs
new file mode 100644
index 000000000..72b9c8866
--- /dev/null
+++ b/scripts/okx-compliance-probe.mjs
@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+/**
+ * Probe the four paid OKX.AI forge rows exactly the way the A2MCP compliance
+ * reviewer does, and fail loudly if either defect behind the 2026-09-04 listing
+ * rejection is live again.
+ *
+ * Pass conditions, per paid row:
+ * 1. The guide's own self-check, `curl -i -X POST <endpoint>` with no body and
+ * no content-type, answers HTTP 402 carrying a PAYMENT-REQUIRED header.
+ * 2. Every 402 quotes each rail exactly once (no duplicate
+ * scheme|network|asset), so the quotation is unambiguous.
+ * 3. Every stablecoin rail quotes the row's registered list price, whether or
+ * not the caller named a priced tool.
+ *
+ * Usage:
+ * node scripts/okx-compliance-probe.mjs [--base https://three.ws] [--out <file>]
+ */
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+
+const args = process.argv.slice(2);
+const flag = (name, fallback) => {
+ const i = args.indexOf(name);
+ return i === -1 ? fallback : args[i + 1];
+};
+
+const BASE = (flag('--base', 'https://three.ws') || '').replace(/\/+$/, '');
+const OUT = flag('--out', '');
+
+/** service id -> registered list price, in atomic units of a 6-decimal stablecoin. */
+const PAID_ROWS = [
+ ['forge-draft', '10000'],
+ ['forge-standard', '50000'],
+ ['forge-hd', '250000'],
+ ['forge-image', '250000'],
+];
+
+/** Every paid row sells the same priced tool; the row picks the tier and price. */
+const PRICED_TOOL = 'forge_3d';
+
+/** Readable token label, so the evidence file carries no raw contract addresses. */
+function assetLabel(accept) {
+ const network = String(accept.network || '');
+ const asset = String(accept.asset || '');
+ if (network === 'eip155:196') return 'USD₮0 (X Layer settlement stablecoin)';
+ if (network === 'eip155:8453') return 'USDC (Base)';
+ if (network.startsWith('solana:')) return /pump$/.test(asset) ? '$THREE' : 'USDC (Solana)';
+ return `${network} token`;
+}
+
+/** $THREE is priced off a live quote, so it is exempt from the list-price check. */
+const isThree = (accept) => assetLabel(accept) === '$THREE';
+
+const railKey = (a) => `${a.scheme}|${a.network}|${a.asset}`;
+const amountOf = (a) => a.amount ?? a.maxAmountRequired ?? null;
+
+async function probe(service, label, init) {
+ const url = `${BASE}/api/okx/3d/${service}`;
+ const res = await fetch(url, { method: 'POST', redirect: 'manual', ...init });
+ const text = await res.text();
+ const record = {
+ service,
+ probe: label,
+ status: res.status,
+ payment_required_header: Boolean(res.headers.get('payment-required')),
+ };
+ let parsed = null;
+ try {
+ parsed = JSON.parse(text);
+ } catch {
+ record.body = text.slice(0, 400);
+ return { record, parsed };
+ }
+ if (Array.isArray(parsed?.accepts)) {
+ record.accepts = parsed.accepts.map((a) => ({
+ scheme: a.scheme,
+ network: a.network,
+ asset: assetLabel(a),
+ amount: amountOf(a),
+ }));
+ const rails = parsed.accepts.map(railKey);
+ record.duplicate_rails = rails.length !== new Set(rails).size;
+ } else {
+ record.body = text.slice(0, 400);
+ }
+ return { record, parsed };
+}
+
+function check(record, parsed, listPrice, failures) {
+ const where = `${record.service} / ${record.probe}`;
+ if (record.status !== 402) {
+ failures.push(`${where}: expected HTTP 402, got ${record.status}`);
+ return;
+ }
+ if (!record.payment_required_header) {
+ failures.push(`${where}: 402 carried no PAYMENT-REQUIRED header`);
+ }
+ const accepts = parsed?.accepts;
+ if (!Array.isArray(accepts) || accepts.length === 0) {
+ failures.push(`${where}: challenge body carried no accepts array`);
+ return;
+ }
+ if (parsed.x402Version !== 2) {
+ failures.push(`${where}: x402Version is ${parsed.x402Version}, expected 2`);
+ }
+ if (accepts[0].network !== 'eip155:196') {
+ failures.push(`${where}: first accept is ${accepts[0].network}, expected the X Layer rail to lead`);
+ }
+ if (record.duplicate_rails) {
+ failures.push(`${where}: the same rail is quoted more than once, so the quotation is ambiguous`);
+ }
+ for (const a of accepts) {
+ if (isThree(a)) continue;
+ const amount = amountOf(a);
+ if (amount !== listPrice) {
+ failures.push(`${where}: ${assetLabel(a)} quoted ${amount}, expected the list price ${listPrice}`);
+ }
+ }
+}
+
+const probes = [];
+const failures = [];
+
+for (const [service, listPrice] of PAID_ROWS) {
+ const shapes = [
+ ['docs self-check: POST, no body, no content-type', {}],
+ [
+ 'POST {} with content-type application/json',
+ { headers: { 'content-type': 'application/json' }, body: '{}' },
+ ],
+ [
+ 'POST a plain business payload, naming no tool',
+ {
+ headers: { 'content-type': 'application/json' },
+ body: JSON.stringify({ prompt: 'a low-poly fox' }),
+ },
+ ],
+ [
+ `well-formed tools/call ${PRICED_TOOL} (control)`,
+ {
+ headers: { 'content-type': 'application/json', accept: 'application/json, text/event-stream' },
+ body: JSON.stringify({
+ jsonrpc: '2.0',
+ id: 1,
+ method: 'tools/call',
+ params: { name: PRICED_TOOL, arguments: { prompt: 'a low-poly fox' } },
+ }),
+ },
+ ],
+ ];
+ for (const [label, init] of shapes) {
+ const { record, parsed } = await probe(service, label, init);
+ check(record, parsed, listPrice, failures);
+ probes.push(record);
+ }
+}
+
+const report = {
+ captured_at: new Date().toISOString(),
+ base: BASE,
+ what: 'Live A2MCP compliance capture of the four paid OKX.AI forge rows: the bodyless self-check answers the quotation, and every quotation names each rail once at the registered list price.',
+ pass: failures.length === 0,
+ failures,
+ probes,
+};
+
+const serialized = `${JSON.stringify(report, null, 2)}\n`;
+if (OUT) {
+ mkdirSync(dirname(OUT), { recursive: true });
+ writeFileSync(OUT, serialized);
+ console.log(`wrote ${OUT}`);
+} else {
+ process.stdout.write(serialized);
+}
+
+for (const f of failures) console.error(`FAIL ${f}`);
+console.log(failures.length === 0 ? `PASS ${probes.length} probes against ${BASE}` : `${failures.length} failing check(s)`);
+process.exit(failures.length === 0 ? 0 : 1);