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(img): document the fallback=none lane and tell the community why DeFi logos stopped breaking
nirholas07f17a1fd9b1
diff --git a/data/changelog.json b/data/changelog.jsonindex c50098815..59569dfc9 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,16 @@{"$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. `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-09-04",+ "title": "DeFi tables stop showing broken logos when a coin icon disappears",+ "summary": "The protocol and chain logos on the fees, DeFi, DEX volumes, chain, protocol and exchange pages were loaded straight from a third-party icon host. When that host renamed or removed an icon, the row rendered a broken-image glyph and every reader's browser recorded a failed request. Those logos now come from three.ws itself: we fetch and resize them on our side, cache them, and hand back an empty answer for an icon that no longer exists, so the row shows the same neutral disc a protocol without a logo already gets. Pages load a little faster too, since a 24-pixel icon no longer arrives at full size, and your browser no longer talks to an outside host on every table paint.",+ "tags": [+ "fix",+ "improvement"+ ],+ "link": "/fees"+ },{"date": "2026-09-04","title": "Cross-origin 3D loads no longer break on a header your site never sent",diff --git a/docs/api-reference.md b/docs/api-reference.mdindex f408f5de3..f26624fd6 100644--- a/docs/api-reference.md+++ b/docs/api-reference.md@@ -6925,6 +6925,7 @@ GET /api/img?url=<https-or-ipfs-image-url>GET /api/img?url=<image-url>&w=480GET /api/img?meta=<token-metadata-json-url>GET /api/img?seed=<any-string>+GET /api/img?url=<image-url>&fallback=none```Same-origin delivery for remote artwork, so the browser only ever talks to@@ -6948,6 +6949,19 @@ turns a 1 MB stored render into a 20-40 KB tile([src/shared/image-url.js](../src/shared/image-url.js) builds the URL andleaves same-origin, `data:` and `blob:` sources untouched).+`fallback=none` opts out of the placeholder: when every source fails the+endpoint answers `204 No Content` with an empty body instead of the SVG. Use it+on a surface that already draws its own "no image" state, which is what the DeFi+logo tables (`/fees`, `/defi`, `/dex-volumes`, `/chain/:name`, `/protocol/:slug`,+`/exchange/:id`) do: a protocol icon DeFiLlama has withdrawn should become the+neutral disc those tables already render for a logo-less row, not token art from+a different visual language. `204` rather than `404` because a retired upstream+icon is an ordinary outcome, not an error: the browser logs nothing for a `204`,+while the `<img>` still fires `error` with no bytes, so the designed fallback+runs. Leave the flag off for artwork, which wants the placeholder.+[src/shared/upstream-logo.js](../src/shared/upstream-logo.js) builds these URLs+and installs the swap-to-disc handler.+Real images are cached immutably (`max-age=86400, s-maxage=604800, immutable`):the same upstream URL at the same width is the same bytes forever, so route aURL through here only when its content never changes in place. Placeholders