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.

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.json
index 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.md
index 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=480
GET /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 and
leaves 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 a
URL through here only when its content never changes in place. Placeholders