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
test(three): prove the hold-to-access claims against the live site without buying tokens
ni3ad005e7cda82c
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex f507db55f..4932234fa 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -15,6 +15,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **A launchpad where every coin is bought with $THREE**: The three.ws bonding-curve launchpad is now priced in $THREE instead of SOL. A coin launched there for a 3D agent can only be bought with $THREE, its creator earns half of every trading fee in $THREE, and when it graduates, the roughly 12.3 million $THREE it raised is locked in its pool permanently. The new launchpad page shows the live curves with buy and sell straight from your wallet. The curve has been verified against Solana mainnet and opens for launches as soon as its settings are published on-chain. (`/three-launchpad`) `[feature]`- **A library of prompts you can paste straight into Claude**: Knowing that three.ws has a free text-to-3D API is not the same as getting a rigged avatar out of it, and the paragraph that closes that gap is one nobody should have to write themselves. /prompts is 23 ready-made prompts for Claude and any other assistant: generate a model or a rigged avatar, search the CC0 catalog before generating anything, rig a GLB you already have, put a live avatar on your site, diagnose an embed that went dark, validate a model before it ships, find a paid API in the agent economy or sell your own. Each one names the real endpoint or tool, says what to do when a job comes back pending, and says what to hand back; the ones that can spend money are written to stop and show you the amount first. Most need no account, no key and no setup. Copy a prompt, open it directly in Claude with the text already in the box, or fetch the whole library as JSON or plain text. (`/prompts`) `[feature, docs]`- **Agent reputation on Base and other EVM chains now shows real on-chain reviews**: Reputation panels, the passport widget and the trust scores behind agent-to-agent gating were asking the shared ERC-8004 reputation registry a question it does not answer, so agents with dozens of on-chain reviews showed none. They now read the registry the way it actually works: an agent with 41 reviews from 22 reviewers on Base shows 4.1 out of 5 and its recent reviews, and the panel loads in a few seconds on free public RPCs. Staked vouches are only offered on chains whose registry supports them. `[fix, improvement]`+- **Anyone can now check that the $THREE hold gate does what we say it does**: We publish specific numbers about holding $THREE: $25 unlocks high quality generation and game ready export, draft and standard stay free for everyone, and the perks further up the ladder are labelled planned because they are not built yet. Those are claims, and a claim nobody can check is worth very little. There is now a single command that checks all of them against the live site, and none of it requires owning a token. It compares the published thresholds and discounts to the ones the server actually uses, confirms an anonymous request for the paid lanes is refused with the tier and the price it needs, reads the balances of real wallets that already hold $THREE to confirm they are let through, confirms the free lanes still run with no account at all, and confirms nothing unbuilt is being advertised as live. The unlock side is proved by reading public balances, which moves no money and buys nothing. How to run it is written up in the hold to access guide. (`/three`) `[docs, improvement]`- **Awesome 3D Agents joins the announcement queue, and the machine stops skipping pages like it**: The machinery that writes announcements from the backlog rebuilds its inventory from the site map on every run, and it was reading only the product sections. Five pages filed under Learn are products rather than documents, so it had never seen them: the curated Awesome 3D Agents list among them, live since the 7th of September and never posted about. They are in the backlog now. Three smaller things landed with it. A page can be asked for next, by name and with the reason recorded, instead of waiting for its score to come round. A post can quote the counters a page puts on screen, such as the 152 entries and 15 sections on the list itself, which the fact harvester used to throw away because they are not sentences. And a frame that was meant to be a five second loop is now shipped as a single picture when the capture finds the page does not actually move. (`/awesome`) `[improvement]`- **Derivatives venue profiles show their contracts again**: Opening a futures venue from the exchange rankings could land on a profile that said it had no markets at all, even for venues listing hundreds of contracts and clearing billions a day. The market-data source keeps an empty placeholder record for some of those venues alongside the real one, and the page was reading the placeholder. It now recognises an empty record for what it is and serves the real venue: open interest, perpetual and futures pair counts, and the contract table. Those tables are also ranked by 24h volume before they are cut to fifty rows, so the biggest contracts lead instead of whatever happened to come first alphabetically, and every contract links to its own detail page. (`/exchanges`) `[fix, improvement]`- **Every perpetual on /derivatives now opens a full contract page**: The perps table told you a contract's price, funding rate and open interest, and then dead-ended: rows went nowhere. Each one now opens its own page. It puts the mark price next to the index the contract settles against and states the basis between them, turns the funding rate into money by letting you type a position size and reading back what it pays per interval, per day and per year, and ranks the contract's open interest and volume against every other venue listing the same underlying. Below that sits the spot chart for the underlying, a cross-venue funding table with the contract you came from pinned in place, and four callouts that answer the question the table never could: the cheapest venue to hold a long, the best paid venue to hold a short, how far funding spreads across venues, and how far their prices disagree. Those four ignore venues trading under a million dollars a day, because a dormant book sets the widest number every time and is nowhere anyone should act. The same page is reachable from the contracts table on any derivatives venue's exchange profile. (`/derivatives`) `[feature, improvement]`diff --git a/data/changelog.json b/data/changelog.jsonindex 658983cd4..0724b504f 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -28547,6 +28547,16 @@"improvement"],"link": "/derivatives"+ },+ {+ "date": "2026-09-20",+ "title": "Anyone can now check that the $THREE hold gate does what we say it does",+ "summary": "We publish specific numbers about holding $THREE: $25 unlocks high quality generation and game ready export, draft and standard stay free for everyone, and the perks further up the ladder are labelled planned because they are not built yet. Those are claims, and a claim nobody can check is worth very little. There is now a single command that checks all of them against the live site, and none of it requires owning a token. It compares the published thresholds and discounts to the ones the server actually uses, confirms an anonymous request for the paid lanes is refused with the tier and the price it needs, reads the balances of real wallets that already hold $THREE to confirm they are let through, confirms the free lanes still run with no account at all, and confirms nothing unbuilt is being advertised as live. The unlock side is proved by reading public balances, which moves no money and buys nothing. How to run it is written up in the hold to access guide.",+ "tags": [+ "docs",+ "improvement"+ ],+ "link": "/three"}]}diff --git a/docs/hold-to-access.md b/docs/hold-to-access.mdindex 8558c67b4..7dd7494ba 100644--- a/docs/hold-to-access.md+++ b/docs/hold-to-access.md@@ -286,6 +286,48 @@ worlds unaffected.---+## Verifying the claims without buying anything++Every public statement about this system is checkable from outside, and none of the+checks require holding a token. Run them after any deploy that touches the gate:++```bash+npm run verify:three-gate # against https://three.ws+npm run verify:three-gate -- --no-forge # skip the two free-lane generations+```++[`scripts/verify-three-gate.mjs`](../scripts/verify-three-gate.mjs) asserts five things+against the live site:++1. **The ladder matches what we publish.** The thresholds, discounts, and quota+ multipliers in `TIERS` are compared to the numbers used in public copy. A silent+ threshold change fails here before a holder discovers it.+2. **The deny path.** An anonymous `POST /api/forge {"tier":"high"}` and an anonymous+ Game-Ready export must return `402 three_hold_required` carrying the required tier,+ the `min_usd`, the acquire block, and the pay-per-use alternative.+3. **The allow path, read-only.** The script reads the mint's largest token accounts,+ resolves their owner wallets, and asks `GET /api/three/access?wallet=...` what each+ one is entitled to. Real wallets holding real $THREE must come back eligible. A+ balance read moves nothing and costs nothing, so the unlock side is provable+ without a purchase.+4. **The free floor.** Draft and standard generation must still be accepted with no+ account, no wallet, and no hold.+5. **Planned stays planned.** Every feature that is not wired must report+ `enforced: false`, which is exactly what draws the "Planned" flag on `/three`.+ A perk promoted to "Live" without a gate behind it fails this check.++What the script deliberately does not cover is a holder completing a High generation+end to end, because that needs an authenticated session. Use a+[comped account](../api/_lib/comp-access.js), which clears every gate with no hold, to+exercise that path; the gate treats a comp and a holder through the same+`requireFeatureAccess` branch.++Unit coverage for the same behavior lives in `tests/forge-high-gate.test.js`,+`tests/forge-gameready-gate.test.js`, `tests/three-require.test.js`, and+`tests/comp-access.test.js`.++---+## Configuration| Env var | Required | Purpose |diff --git a/package.json b/package.jsonindex ad34d372f..976b3615c 100644--- a/package.json+++ b/package.json@@ -502,7 +502,8 @@"build:awesome": "node scripts/build-awesome.mjs","check:awesome": "node scripts/build-awesome.mjs --check","awesome:links": "node scripts/check-awesome-links.mjs",- "awesome:standalone": "node scripts/build-awesome.mjs --standalone"+ "awesome:standalone": "node scripts/build-awesome.mjs --standalone",+ "verify:three-gate": "node scripts/verify-three-gate.mjs"},"dependencies": {"@0xsplits/splits-sdk": "^6.6.0",diff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex 0ff0cfb0a..8f48f556e 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,11 +1,11 @@{- "generated_at": "2026-09-20T17:43:40.560Z",+ "generated_at": "2026-09-20T19:41:27.892Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 3731,+ "total": 3732,"complete": false,"full_feed": "/changelog.json","entries": [@@ -101,6 +101,17 @@"improvement"]},+ {+ "date": "2026-09-20",+ "type": "update",+ "title": "Anyone can now check that the $THREE hold gate does what we say it does",+ "summary": "We publish specific numbers about holding $THREE: $25 unlocks high quality generation and game ready export, draft and standard stay free for everyone, and the perks further up the ladder are labelled planned because they are not built yet. Those are claims, and a claim nobody can check is worth very little. There is now a single command that checks all of them against the live site, and none of it requires owning a token. It compares the published thresholds and discounts to the ones the server actually uses, confirms an anonymous request for the paid lanes is refused with the tier and the price it needs, reads the balances of real wallets that already hold $THREE to confirm they are let through, confirms the free lanes still run with no account at all, and confirms nothing unbuilt is being advertised as live. The unlock side is proved by reading public balances, which moves no money and buys nothing. How to run it is written up in the hold to access guide.",+ "link": "/three",+ "tags": [+ "docs",+ "improvement"+ ]+ },{"date": "2026-09-20","type": "update",@@ -1608,16 +1619,6 @@"fix","improvement"]- },- {- "date": "2026-09-09",- "type": "update",- "title": "Trading finally counts toward your daily streak",- "summary": "The cross-surface streak on three.ws counted signing in, forging a model, saving a world and a walk session, but not a trade, which on a trading platform is the one thing it most obviously should count. A confirmed on-chain buy or sell now keeps your streak alive like any other activity, and still counts once per day however many times you trade, so the streak measures showing up rather than trading volume.",- "link": null,- "tags": [- "improvement"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex 213a15c4a..a470804fc 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-09-20T17:43:40.527Z",+ "generated_at": "2026-09-20T19:41:27.867Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -98,6 +98,17 @@"improvement"]},+ {+ "date": "2026-09-20",+ "type": "update",+ "title": "Anyone can now check that the $THREE hold gate does what we say it does",+ "summary": "We publish specific numbers about holding $THREE: $25 unlocks high quality generation and game ready export, draft and standard stay free for everyone, and the perks further up the ladder are labelled planned because they are not built yet. Those are claims, and a claim nobody can check is worth very little. There is now a single command that checks all of them against the live site, and none of it requires owning a token. It compares the published thresholds and discounts to the ones the server actually uses, confirms an anonymous request for the paid lanes is refused with the tier and the price it needs, reads the balances of real wallets that already hold $THREE to confirm they are let through, confirms the free lanes still run with no account at all, and confirms nothing unbuilt is being advertised as live. The unlock side is proved by reading public balances, which moves no money and buys nothing. How to run it is written up in the hold to access guide.",+ "link": "/three",+ "tags": [+ "docs",+ "improvement"+ ]+ },{"date": "2026-09-20","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 6a939c33d..138208f35 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -78,6 +78,14 @@<category>fix</category><description>Reputation panels, the passport widget and the trust scores behind agent-to-agent gating were asking the shared ERC-8004 reputation registry a question it does not answer, so agents with dozens of on-chain reviews showed none. They now read the registry the way it actually works: an agent with 41 reviews from 22 reviewers on Base shows 4.1 out of 5 and its recent reviews, and the panel loads in a few seconds on free public RPCs. Staked vouches are only offered on chains whose registry supports them.</description></item>+ <item>+ <title>Anyone can now check that the $THREE hold gate does what we say it does</title>+ <link>https://three.ws/three</link>+ <guid isPermaLink="false">2026-09-20:Anyone can now check that the $THREE hold gate does what we say it does</guid>+ <pubDate>Sun, 20 Sep 2026 12:00:00 GMT</pubDate>+ <category>docs</category>+ <description>We publish specific numbers about holding $THREE: $25 unlocks high quality generation and game ready export, draft and standard stay free for everyone, and the perks further up the ladder are labelled planned because they are not built yet. Those are claims, and a claim nobody can check is worth very little. There is now a single command that checks all of them against the live site, and none of it requires owning a token. It compares the published thresholds and discounts to the ones the server actually uses, confirms an anonymous request for the paid lanes is refused with the tier and the price it needs, reads the balances of real wallets that already hold $THREE to confirm they are let through, confirms the free lanes still run with no account at all, and confirms nothing unbuilt is being advertised as live. The unlock side is proved by reading public balances, which moves no money and buys nothing. How to run it is written up in the hold to access guide.</description>+ </item><item><title>Awesome 3D Agents joins the announcement queue, and the machine stops skipping pages like it</title><link>https://three.ws/awesome</link>diff --git a/public/features.json b/public/features.jsonindex 90a4f2086..f1ff3f934 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-09-20T17:43:40.508Z",+ "generated_at": "2026-09-20T19:41:27.855Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",diff --git a/scripts/verify-three-gate.mjs b/scripts/verify-three-gate.mjsnew file mode 100644index 000000000..a26067079--- /dev/null+++ b/scripts/verify-three-gate.mjs@@ -0,0 +1,208 @@+#!/usr/bin/env node+// Verify the $THREE hold-to-access claims against the LIVE site, with no spend.+//+// Every public claim about the ladder ("Bronze at $25 unlocks High + Game-Ready",+// "draft and standard stay free", "the rest is marked Planned") is checkable from+// outside without holding a single token. This script checks them, so the claim+// can be re-proved after any deploy instead of trusted.+//+// What it proves, and how each half is covered without buying anything:+// 1. Ladder : the published thresholds/discounts/multipliers match TIERS.+// 2. Deny : an anonymous High / Game-Ready call 402s with the documented shape.+// 3. Allow : real on-chain holder wallets (read from the mint's largest+// accounts at runtime, never hardcoded) resolve to an ELIGIBLE+// tier through the same resolver the gate uses. Reading someone+// else's balance costs nothing and moves nothing.+// 4. Free floor: draft + standard generation are accepted anonymously.+// 5. Honesty : features that are not wired report enforced:false, which is+// what renders the "Planned" flag on /three.+//+// Usage: node scripts/verify-three-gate.mjs [--base https://three.ws] [--no-forge]+// --no-forge skips step 4 (it queues two real free-lane generations).++const args = process.argv.slice(2);+const argValue = (name, fallback) => {+ const i = args.indexOf(name);+ return i >= 0 && args[i + 1] ? args[i + 1] : fallback;+};+const BASE = argValue('--base', 'https://three.ws').replace(/\/+$/, '');+const RUN_FORGE = !args.includes('--no-forge');++const MINT = 'FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump';++// The ladder as published. Divergence here means the marketing and the server+// disagree, which is the single most damaging failure this script can catch.+const PUBLISHED = [+ { id: 'member', minUsd: 0, discountBps: 0, rateMultiplier: 1 },+ { id: 'bronze', minUsd: 25, discountBps: 500, rateMultiplier: 2 },+ { id: 'silver', minUsd: 100, discountBps: 1000, rateMultiplier: 3 },+ { id: 'gold', minUsd: 500, discountBps: 2000, rateMultiplier: 5 },+ { id: 'genesis', minUsd: 2500, discountBps: 3000, rateMultiplier: 10 },+];++// Features the article says are live today, with the tier each one requires.+const LIVE_GATES = [+ { feature: 'forge.high', required: 'bronze' },+ { feature: 'forge.gameready', required: 'bronze' },+];++let failures = 0;+function check(label, ok, detail = '') {+ const mark = ok ? 'PASS' : 'FAIL';+ if (!ok) failures += 1;+ console.log(` [${mark}] ${label}${detail ? `: ${detail}` : ''}`);+}+function section(title) {+ console.log(`\n${title}`);+}++async function getJson(url, init) {+ const r = await fetch(url, init);+ let body = null;+ try {+ body = await r.json();+ } catch {+ body = null;+ }+ return { status: r.status, body };+}++async function rpc(method, params) {+ const { body } = await getJson(`${BASE}/api/solana-rpc`, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),+ });+ return body?.result ?? null;+}++// ── 1. Ladder ────────────────────────────────────────────────────────────────+async function checkLadder() {+ section('1. Tier ladder matches what we publish');+ const { TIERS } = await import('../api/_lib/three-tier.js');+ check('tier count', TIERS.length === PUBLISHED.length, `${TIERS.length} tiers`);+ for (const want of PUBLISHED) {+ const got = TIERS.find((t) => t.id === want.id);+ if (!got) {+ check(`${want.id} exists`, false);+ continue;+ }+ const ok =+ got.minUsd === want.minUsd &&+ got.discountBps === want.discountBps &&+ got.rateMultiplier === want.rateMultiplier;+ check(+ `${want.id}`,+ ok,+ `$${got.minUsd} hold, ${got.discountBps / 100}% off, ${got.rateMultiplier}x quota`,+ );+ }+}++// ── 2. Deny path ─────────────────────────────────────────────────────────────+async function checkDeny() {+ section('2. Anonymous callers are denied with the documented 402');+ const calls = [+ ['forge.high', `${BASE}/api/forge`, { prompt: 'a plain wooden stool', tier: 'high' }],+ ['forge.gameready', `${BASE}/api/forge-gameready`, { model_url: `${BASE}/assets/test.glb` }],+ ];+ for (const [feature, url, payload] of calls) {+ const { status, body } = await getJson(url, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify(payload),+ });+ check(`${feature} returns 402`, status === 402, `HTTP ${status}`);+ check(`${feature} error code`, body?.error === 'three_hold_required', String(body?.error));+ check(`${feature} names the required tier`, body?.required?.id === 'bronze' && body?.required?.min_usd === 25, `${body?.required?.label} @ $${body?.required?.min_usd}`);+ check(`${feature} tells the caller how to acquire`, body?.acquire?.mint === MINT);+ check(`${feature} offers a pay-per-use alternative`, typeof body?.pay_per_use?.usd === 'number', `$${body?.pay_per_use?.usd}`);+ }+}++// ── 3. Allow path, read-only ─────────────────────────────────────────────────+// Resolve owner wallets behind the mint's largest token accounts and ask the live+// access endpoint what they are entitled to. Nothing is signed, nothing is spent.+async function checkAllow() {+ section('3. Real holder wallets resolve as ELIGIBLE (read-only, no purchase)');+ const largest = await rpc('getTokenLargestAccounts', [MINT]);+ const accounts = (largest?.value ?? []).slice(0, 6).map((a) => a.address);+ if (!accounts.length) {+ check('found holder accounts', false, 'RPC returned none');+ return;+ }+ const wallets = [];+ for (const account of accounts) {+ const info = await rpc('getAccountInfo', [account, { encoding: 'jsonParsed' }]);+ const owner = info?.value?.data?.parsed?.info?.owner;+ if (owner) wallets.push(owner);+ }+ check('resolved holder wallets', wallets.length > 0, `${wallets.length} owners`);++ let eligible = 0;+ for (const wallet of wallets) {+ const { body } = await getJson(`${BASE}/api/three/access?feature=forge.high&wallet=${wallet}`);+ const tier = body?.tier;+ const access = body?.access;+ if (!tier) continue;+ // A holder above the Bronze threshold MUST come back eligible; a wallet that+ // sold down to nothing must not. Both directions are the same assertion.+ const shouldPass = Number(tier.held_usd) >= 25;+ const ok = Boolean(access?.eligible) === shouldPass;+ if (access?.eligible) eligible += 1;+ check(+ `${wallet.slice(0, 6)}…${wallet.slice(-4)} holds $${Math.round(Number(tier.held_usd) || 0)} -> ${tier.label}`,+ ok,+ access?.eligible ? 'eligible for forge.high' : 'locked',+ );+ }+ check('at least one live wallet clears the gate', eligible > 0, `${eligible} eligible`);+}++// ── 4. Free floor ────────────────────────────────────────────────────────────+async function checkFreeFloor() {+ section('4. Draft + standard stay free for anonymous callers');+ if (!RUN_FORGE) {+ console.log(' [skip] --no-forge');+ return;+ }+ for (const tier of ['draft', 'standard']) {+ const { status, body } = await getJson(`${BASE}/api/forge`, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ prompt: 'a plain wooden stool', tier }),+ });+ check(`${tier} accepted anonymously`, status === 200 && Boolean(body?.job_id), `HTTP ${status} ${body?.status ?? ''}`);+ }+}++// ── 5. Planned vs live honesty ───────────────────────────────────────────────+async function checkHonesty() {+ section('5. Unbuilt perks report enforced:false (what renders "Planned")');+ const { body } = await getJson(`${BASE}/api/three/access`);+ const features = body?.features ?? [];+ check('access matrix served', features.length > 0, `${features.length} features`);+ for (const { feature, required } of LIVE_GATES) {+ const f = features.find((x) => x.feature === feature);+ check(`${feature} is enforced`, f?.enforced === true);+ check(`${feature} requires ${required}`, f?.required?.id === required);+ }+ const planned = features.filter((f) => !f.enforced).map((f) => f.feature);+ check('planned features are flagged, not sold as live', planned.length === features.length - LIVE_GATES.length, planned.join(', ') || 'none');+}++async function main() {+ console.log(`$THREE hold-to-access verification against ${BASE}`);+ await checkLadder();+ await checkDeny();+ await checkAllow();+ await checkFreeFloor();+ await checkHonesty();+ console.log(`\n${failures === 0 ? 'ALL CHECKS PASSED' : `${failures} CHECK(S) FAILED`}`);+ process.exit(failures === 0 ? 0 : 1);+}++main().catch((err) => {+ console.error('verification crashed:', err?.message || err);+ process.exit(1);+});