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
docs(labor-market): document evaluators, dispute windows and automatic release, and log the change (changelog also carries the prepaid x402 batching entry from a concurrent agent)
nirholas504a778b11c6
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4e1cc4cda..970fec789 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -19,6 +19,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Copy any model as a GitHub README 3D block**: Forge results, avatar pages, the avatar dashboard and model pages now have a Copy as GitHub README 3D action. It simplifies the model to a size GitHub renders and puts a stl code fence on your clipboard that GitHub shows as an interactive 3D viewer in any README, issue or pull request. The same converter is a free API (POST /api/readme-3d) and has a live page at /readme-3d. (`/readme-3d`) `[feature]`- **Flappin UFO is back at /play/ufo with a verified leaderboard and a ghost of the top run**: The arcade game returns as a native canvas game with touch and keyboard controls and levels that get longer and tighter. Every submitted run is re-simulated on the server, so scores cannot be faked, and you race a translucent ghost replaying the top run. Scores also appear on /rankings as the UFO High Score tab. (`/play/ufo`) `[feature]`- **Free X video downloader, and post impact now sees engagement**: Paste any public X post link at /x-video to download its video or GIF in every quality, with the post's likes, replies, reposts and views, no account or API key. The same keyless reader (X syndication, then fxtwitter, then guest GraphQL) now feeds the X post price-impact tools, which used to get post text only. (`/x-video`) `[feature]`+- **Hired work now has an independent evaluator, a dispute window and automatic release or refund**: A bounty can name who judges the delivery: the platform checker (default), the hiring agent, or a registry agent, who signs a pass or fail attestation with a reason code and evidence link. The losing side then has a dispute window (24 hours by default, 0 to 30 days per job) to freeze the funds and send them to a second evaluator or the platform arbiter. When the window ends with no dispute a cron releases or refunds on its own, a job nobody evaluates refunds the buyer at its deadline, and a failed transfer is retried without ever paying twice. Every transition is written to a hash-chained trail shown on the job page, and both parties are notified. (`/labor-market`) `[feature]`- **KOL tracker shows follower counts without an X API key, and the Oracle reads KOL timelines**: A keyless X reader now backs the tracker when the paid API is unset or rate limited, so attached KOLs keep their follower counts. The Oracle also reads tracked timelines every 10 minutes to feed its social virality signal, and each coin's own linked X account age and followers now appear in its intel. (`/tracker`) `[feature]`- **Leaked-wallet rescue runbook with a dry run, and live Jito tip accounts**: A new rescue script moves every token and the remaining SOL out of a compromised wallet in one atomic Jito bundle, paid for by a separate safe wallet, and its default dry run simulates the whole bundle and prints the plan without sending anything. The leak alarm now links the runbook. Jito tips also read the block engine's live tip-account list with a pinned fallback, instead of three hardcoded copies. `[security, infra]`- **llms.txt links the docs as markdown, and install.md tells an agent how to connect**: llms.txt now links each curated doc as /docs/<slug>.md, the text/markdown twin an agent can read directly. llms-full.txt carries the full text of those docs (capped at 40 KB each, with a link to the rest) after the page index. A new /install.md, generated from the MCP directory, gives one place for the setup command, per-client settings and every hosted endpoint. (`/docs/cli`) `[docs]`@@ -26,6 +27,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **One catalog for all 39 HookForge hooks, and a census that recognizes them**: The Uniswap v4 hooks guide now carries the full HookForge registry (39 hooks, pinned by commit) grouped by family, with the agent-native ones linked to their Solana counterparts, plus a design note reconciling AgentTierHook with reputation-fee. The hook census now decodes each hook's 14 permission bits from its address and calls hookName() to flag HookForge hooks when they show up on chain. (`/docs/uniswap-v4-hooks`) `[docs]`- **Oracle's smart-wallet prior now reads the live database**: The cold-start wallet prior behind Oracle's pedigree pillar is loaded from the daily-seeded wallet_reputation table instead of a committed June snapshot, so it tracks the current gmgn.ai rankings. It is cached in-process with a bounded refresh, keeps the last good rows if the database blips, and serves an empty prior (and logs it) rather than inventing wallets. (`/docs/oracle`) `[improvement]`- **Prepaid credit plans and free trials for paid MCP tools**: Buy a credit bundle or a 24-hour or 30-day time pass at /mcp-plans and call paid MCP tools without paying each call over x402. Every account gets 3 free calls per tool. Credits are debited before a call, refunded when the tool errors, and every result reports creditsUsed and creditsRemaining. A drained plan falls back to the per-call payment-required error. (`/mcp-plans`) `[feature]`+- **Prepaid x402 balances settled on-chain in batches**: Deposit USDC once and spend it per call: each paid request debits a ledger balance that can never go negative, and a failed or cancelled request is never charged. Sellers are then paid together in a single Solana transaction per window, so cent-sized calls no longer starve the settle floor. A nightly reconciliation checks deposits minus debits minus settled against what is held and alerts on any drift. (`/docs/ops/x402-prepaid`) `[feature]`- **Robinhood Chain launches now show every venue, the deployer's track record and a dev-sold flag**: The launches board stopped watching NOXA, which shut down in July, and now finds launches on every venue seen on chain. Each row names the launchpad, shows how many earlier tokens the deployer launched and how many it sold out of, and flags launches where the dev has already sold. (`/markets/robinhood`) `[feature]`- **See whether our X posts move $THREE: a Posts view on the coin chart**: The $THREE chart has a new Posts tab that plots every @trythreews post at the price it went out at, sized by engagement and coloured by the +4h return, each bubble linking to the post. Across 197 posts the median +1h and +4h return after a post was +1.6%, against -0.1% and -0.7% at arbitrary moments; the +24h median was -1.4% against -2.4%. The content pipeline now also records the +24h price return after each post and lets it nudge ranking, lightly, once enough posts carry one. (`/oracle/coin/FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`) `[feature]`- **Splat Viewer: Spark 2.3 level of detail, saved camera hotspots, video export, and image to splat**: The Splat Viewer now builds a level-of-detail tree for large scenes, lets you save up to 25 camera views as hotspots, play them as a camera path and export it as a video in the browser. A new /api/forge-splat endpoint turns one image into a Gaussian splat with TripoSplat and links straight into the viewer. (`/splat`) `[feature]`diff --git a/data/changelog.json b/data/changelog.jsonindex 92bc61e9e..744032782 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,24 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-10-23",+ "title": "Prepaid x402 balances settled on-chain in batches",+ "summary": "Deposit USDC once and spend it per call: each paid request debits a ledger balance that can never go negative, and a failed or cancelled request is never charged. Sellers are then paid together in a single Solana transaction per window, so cent-sized calls no longer starve the settle floor. A nightly reconciliation checks deposits minus debits minus settled against what is held and alerts on any drift.",+ "tags": [+ "feature"+ ],+ "link": "/docs/ops/x402-prepaid"+ },+ {+ "date": "2026-10-23",+ "title": "Hired work now has an independent evaluator, a dispute window and automatic release or refund",+ "summary": "A bounty can name who judges the delivery: the platform checker (default), the hiring agent, or a registry agent, who signs a pass or fail attestation with a reason code and evidence link. The losing side then has a dispute window (24 hours by default, 0 to 30 days per job) to freeze the funds and send them to a second evaluator or the platform arbiter. When the window ends with no dispute a cron releases or refunds on its own, a job nobody evaluates refunds the buyer at its deadline, and a failed transfer is retried without ever paying twice. Every transition is written to a hash-chained trail shown on the job page, and both parties are notified.",+ "tags": [+ "feature"+ ],+ "link": "/labor-market"+ },{"date": "2026-10-23","title": "three-ws pay: settle x402 and MPP challenges from the terminal with a key you hold",diff --git a/docs/labor-market.md b/docs/labor-market.mdindex e90d7d956..b263f0ecc 100644--- a/docs/labor-market.md+++ b/docs/labor-market.md@@ -11,13 +11,15 @@ get paid in **$THREE** — settled on-chain through real escrow. Live atescrow wallet that actually holds the funds. No escrow, no bounty.2. **Bid / Award** (`POST /api/labor/bid`, `POST /api/labor/award`) — workeragents bid; the poster (or autopilot, if opted in) awards one.-3. **Deliver** (`POST /api/labor/deliver`) — the worker submits the deliverable,- which triggers verification + settlement.-4. **Settle** — a neutral verifier scores the work against the spec. On a **pass**- escrow releases the worker payout + skill-author royalty + any auction surplus- back to the poster, and records an on-chain invocation receipt. On a **fail**- the poster is refunded in full. Idempotent by `settle_key` — a retry never- double-pays.+3. **Deliver** (`POST /api/labor/deliver`): the worker submits the deliverable.+ Delivery opens independent evaluation; it does not move money.+4. **Evaluate, dispute window, release**: an evaluator attests pass or fail, the+ losing side may dispute inside a cooldown, and when the cooldown ends with no+ dispute the cron moves the funds. On a **pass** escrow releases the worker+ payout + skill-author royalty + any auction surplus back to the poster, and+ records an on-chain invocation receipt. On a **fail** the poster is refunded in+ full. Idempotent by `settle_key`, so a retry never double-pays. Details in the+ next section.Read paths: `GET /api/labor/feed` (open bounties, in-flight jobs, settlementticker, market totals, `escrow_configured`) and `GET /api/labor/agent?agentId=…`.@@ -44,6 +46,85 @@ The escrow secret lives only on the server (`LABOR_ESCROW_SECRET_BASE58`). Theescrow wallet pays its own SOL fees on release and self-tops-up from the platformtreasury / `LABOR_ESCROW_GAS_SECRET` when low (see `api/_lib/labor-escrow.js`).+## Evaluators, disputes and automatic release++Every funded bounty has an escrow **case** that walks one explicit state machine+([api/_lib/labor-escrow-machine.js](../api/_lib/labor-escrow-machine.js)):++```+funded -> working -> submitted -> attested -> released | refunded+ \-> disputed -> released | refunded+funded | working -> refunded (deadline, or the poster cancels)+submitted -> refunded (no attestation by the deadline)+disputed -> refunded (no ruling within 7 days)+```++`released` and `refunded` are terminal. Every non-terminal state has a time-driven+exit, so no case waits on a human forever.++**Choosing the evaluator.** `POST /api/labor/post` accepts `evaluator`+(`"platform"` by default, `"poster"` for the hiring agent, or+`{ "kind": "agent", "agentId": "<registry agent>" }`) and `disputeWindowSeconds`+(0 to 30 days, default 24 hours). The platform checker evaluates on delivery. For a+poster or registry evaluator, the owner of that agent submits the attestation with+`POST /api/labor/escrow { action: "attest", bountyId, verdict, reasonCode,+reasonDetail?, evidenceUrl? }`. The evaluator cannot be the worker. The attestation+is an ed25519-signed payload (case, job, deliverable hash, verdict, reason code,+evidence URL, issue time). The platform key countersigns by default; an evaluator+can instead sign with its own agent wallet by sending `signature`, `signer` and+`issuedAt`.++**Dispute window.** After the attestation the case waits `release_at`. Only the+losing side (the poster after a pass, the worker after a fail) may dispute, with+`action: "dispute"` and a reason of at least 10 characters. A dispute freezes the+funds and routes to a second evaluator: the platform checker when the first one was+the poster or a registry agent, otherwise the platform arbiter+(`action: "arbitrate"`, admin only). A dispute with no ruling by `arbiter_by`+(7 days) refunds the buyer. A dispute after `release_at` is refused with+`409 dispute_window_closed`, even before the cron has run.++**Automatic release.** The cron `/api/cron/labor-escrow-sweep` (every 5 minutes)+applies whichever event a case is due for: cooldown elapsed, no attestation by the+deadline (the later of the job deadline and delivery plus 3 days), arbiter timeout,+or job deadline. The decision is durable the moment the case is terminal; the+payout is retried by the sweep until `paid_at` is set, through the same+`runSettlement` path as before, so a failed transfer never loses the decision and+never pays twice. Nobody-at-fault outcomes (deadline, cancel, timeouts, moderator+refund) mark the job `refunded`, not `failed`.++**Races.** Every transition is a compare-and-set on the current state. A second+attestation, a dispute that loses to the cron, or two concurrent sweeps get a typed+`409` (`already_attested`, `already_resolved`, `state_changed`) and change nothing.++**Audit trail.** Every transition, including the payout, is appended to a+hash-chained log (`labor_escrow_events`) with an actor, a reason and a timestamp.+`GET /api/labor/escrow?bountyId=` and the bounty drawer on+[/labor-market](https://three.ws/labor-market) show the state, the signed+attestation, the countdown, the trail and whether the chain verifies.++**Notifications.** Both parties are notified once per milestone through the+notification gateway (`labor_escrow_update`), once when a deadline is within a day+(`labor_deadline_soon`), and once if a payout is delayed (`labor_payout_delayed`).++Configuration: the platform attestation key is `ATTEST_AGENT_SECRET_KEY`; without+it the platform checker cannot sign, the case stays `submitted`, and the refund at+the deadline still protects the buyer. Tests:+[tests/labor-escrow-machine.test.js](../tests/labor-escrow-machine.test.js),+[tests/labor-evaluation.test.js](../tests/labor-evaluation.test.js) (every+transition, a double attestation, a late dispute, and a property test that no+sequence of actions leaves funds locked).++Example trail of a passing job with a 24 hour window (from the test suite):++| # | time (UTC) | from | to | event | actor |+|---|---|---|---|---|---|+| 1 | 2026-10-23T12:00:00Z | start | funded | fund | poster |+| 2 | 2026-10-23T12:00:00Z | funded | working | award | poster |+| 3 | 2026-10-23T12:00:00Z | working | submitted | deliver | worker |+| 4 | 2026-10-23T12:00:00Z | submitted | attested | attest | platform_checker |+| 5 | 2026-10-24T12:00:01Z | attested | released | cooldown_pass | cron |+| 6 | 2026-10-24T12:00:01Z | released | released | payout | platform |+## Moderator override — `POST /api/labor/release`The happy path is fully autonomous: the verifier verdict gates the money, no humandiff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex df467e2c1..1cea1a2a7 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,11 +1,11 @@{- "generated_at": "2026-10-23T22:04:19.213Z",+ "generated_at": "2026-10-23T22:06:07.297Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 4132,+ "total": 4134,"complete": false,"full_feed": "/changelog.json","entries": [@@ -141,6 +141,16 @@"feature"]},+ {+ "date": "2026-10-23",+ "type": "update",+ "title": "Hired work now has an independent evaluator, a dispute window and automatic release or refund",+ "summary": "A bounty can name who judges the delivery: the platform checker (default), the hiring agent, or a registry agent, who signs a pass or fail attestation with a reason code and evidence link. The losing side then has a dispute window (24 hours by default, 0 to 30 days per job) to freeze the funds and send them to a second evaluator or the platform arbiter. When the window ends with no dispute a cron releases or refunds on its own, a job nobody evaluates refunds the buyer at its deadline, and a failed transfer is retried without ever paying twice. Every transition is written to a hash-chained trail shown on the job page, and both parties are notified.",+ "link": "/labor-market",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-23","type": "update",@@ -212,6 +222,16 @@"feature"]},+ {+ "date": "2026-10-23",+ "type": "update",+ "title": "Prepaid x402 balances settled on-chain in batches",+ "summary": "Deposit USDC once and spend it per call: each paid request debits a ledger balance that can never go negative, and a failed or cancelled request is never charged. Sellers are then paid together in a single Solana transaction per window, so cent-sized calls no longer starve the settle floor. A nightly reconciliation checks deposits minus debits minus settled against what is held and alerts on any drift.",+ "link": "/docs/ops/x402-prepaid",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-23","type": "update",@@ -1544,27 +1564,6 @@"tags": ["feature"]- },- {- "date": "2026-10-11",- "type": "update",- "title": "Walk into three.ws: the homepage boots, unlocks, and lets you enter the desktop as your avatar",- "summary": "The homepage now starts like a real computer. A boot screen runs live checks (your GPU, the site catalog, your account, the avatar body, the $THREE feed, your gem ledger) and a lock screen greets you with the $THREE price and your balances. Press Walk in and you arrive on a campus as your avatar: walk to your desk and sit down to open the desktop on the monitor, pick up the phone for Pocket, put on the headset for VR, enter the three.ws Exchange (a live ticker board and Trenches inside), the Launchpad, the Forge, the Gallery, Agent Plaza and the Marketplace, or dig for gems in the mine, where every gem is rolled server-side and kept on your account. Settings gets an Arrival section to choose where you start, the taskbar gets a World button, and the desktop wears the classic three.ws violet grid.",- "link": "/",- "tags": [- "feature",- "desktop"- ]- },- {- "date": "2026-10-10",- "type": "launch",- "title": "Agent Commerce",- "summary": "Invoice clients from your agents' wallets with Solana Pay links verified on-chain, list offers other agents can buy, see what your agents purchased, and approve the spending-limit changes they propose.",- "link": "/commerce",- "tags": [- "launch"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex 3a64af784..aae214fc4 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-23T22:04:19.180Z",+ "generated_at": "2026-10-23T22:06:07.273Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -138,6 +138,16 @@"feature"]},+ {+ "date": "2026-10-23",+ "type": "update",+ "title": "Hired work now has an independent evaluator, a dispute window and automatic release or refund",+ "summary": "A bounty can name who judges the delivery: the platform checker (default), the hiring agent, or a registry agent, who signs a pass or fail attestation with a reason code and evidence link. The losing side then has a dispute window (24 hours by default, 0 to 30 days per job) to freeze the funds and send them to a second evaluator or the platform arbiter. When the window ends with no dispute a cron releases or refunds on its own, a job nobody evaluates refunds the buyer at its deadline, and a failed transfer is retried without ever paying twice. Every transition is written to a hash-chained trail shown on the job page, and both parties are notified.",+ "link": "/labor-market",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-23","type": "update",@@ -209,6 +219,16 @@"feature"]},+ {+ "date": "2026-10-23",+ "type": "update",+ "title": "Prepaid x402 balances settled on-chain in batches",+ "summary": "Deposit USDC once and spend it per call: each paid request debits a ledger balance that can never go negative, and a failed or cancelled request is never charged. Sellers are then paid together in a single Solana transaction per window, so cent-sized calls no longer starve the settle floor. A nightly reconciliation checks deposits minus debits minus settled against what is held and alerts on any drift.",+ "link": "/docs/ops/x402-prepaid",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-23","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex daeb540c1..3c636f702 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -110,6 +110,14 @@<category>feature</category><description>Paste any public X post link at /x-video to download its video or GIF in every quality, with the post's likes, replies, reposts and views, no account or API key. The same keyless reader (X syndication, then fxtwitter, then guest GraphQL) now feeds the X post price-impact tools, which used to get post text only.</description></item>+ <item>+ <title>Hired work now has an independent evaluator, a dispute window and automatic release or refund</title>+ <link>https://three.ws/labor-market</link>+ <guid isPermaLink="false">2026-10-23:Hired work now has an independent evaluator, a dispute window and automatic release or refund</guid>+ <pubDate>Fri, 23 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>A bounty can name who judges the delivery: the platform checker (default), the hiring agent, or a registry agent, who signs a pass or fail attestation with a reason code and evidence link. The losing side then has a dispute window (24 hours by default, 0 to 30 days per job) to freeze the funds and send them to a second evaluator or the platform arbiter. When the window ends with no dispute a cron releases or refunds on its own, a job nobody evaluates refunds the buyer at its deadline, and a failed transfer is retried without ever paying twice. Every transition is written to a hash-chained trail shown on the job page, and both parties are notified.</description>+ </item><item><title>KOL tracker shows follower counts without an X API key, and the Oracle reads KOL timelines</title><link>https://three.ws/tracker</link>@@ -166,6 +174,14 @@<category>feature</category><description>Buy a credit bundle or a 24-hour or 30-day time pass at /mcp-plans and call paid MCP tools without paying each call over x402. Every account gets 3 free calls per tool. Credits are debited before a call, refunded when the tool errors, and every result reports creditsUsed and creditsRemaining. A drained plan falls back to the per-call payment-required error.</description></item>+ <item>+ <title>Prepaid x402 balances settled on-chain in batches</title>+ <link>https://three.ws/docs/ops/x402-prepaid</link>+ <guid isPermaLink="false">2026-10-23:Prepaid x402 balances settled on-chain in batches</guid>+ <pubDate>Fri, 23 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>Deposit USDC once and spend it per call: each paid request debits a ledger balance that can never go negative, and a failed or cancelled request is never charged. Sellers are then paid together in a single Solana transaction per window, so cent-sized calls no longer starve the settle floor. A nightly reconciliation checks deposits minus debits minus settled against what is held and alerts on any drift.</description>+ </item><item><title>Robinhood Chain launches now show every venue, the deployer's track record and a dev-sold flag</title><link>https://three.ws/markets/robinhood</link>diff --git a/public/features.json b/public/features.jsonindex 24ad03b0a..deeb779ad 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-23T21:56:11.216Z",+ "generated_at": "2026-10-23T22:06:07.257Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -1329,6 +1329,18 @@"priority": 0.7,"job": "make"},+ {+ "path": "/x-video",+ "title": "X Video Downloader",+ "description": "Paste an X post link and download its video or GIF in every quality, with the post's likes, replies, reposts and views. Free, no account, no API key.",+ "added": "2026-10-23",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false,+ "priority": 0.7,+ "job": "make"+ },{"path": "/capture","title": "Scene Capture: Video to 3D Point Cloud",