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(seeker): document the Seeker app, its new release key, and the emulator QA recipe
nirholas14cc12fda584
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex c05dcca0c..814973164 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,7 +7,10 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-08-27- **three.ws for Seeker** (`/seeker`): The home screen of the three.ws app on Solana Seeker: one-tap Seed Vault sign-in, selfie to avatar, your agents, the marketplace, and Seeker Genesis Token verification.+- **three.ws on Solana Seeker** (`/docs/seeker-app`): What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.+- **A real home screen for the Seeker app, and a Seeker verified badge**: The three.ws app on Solana Seeker now opens on its own home screen at /seeker: one tap signs you in with Seed Vault, your agents are right there, and Create, Discover, and Chat are a thumb away. Seeker owners can prove it by checking for the Seeker Genesis Token in their wallet (a read, never a transaction); once verified, every agent they own shows a Seeker verified badge on its page. (`/seeker`) `[feature]`- **Seeker app: stay signed in across restarts, and a submission path that matches today's dApp Store**: On Solana Seeker, the three.ws app now remembers your Seed Vault session when Android restarts the app in the background, so reopening it no longer asks you to approve again; a revoked session is dropped cleanly instead of failing every signature. The My Agents home-screen shortcut opens your own agents instead of the public index. Behind the scenes the store submission tooling was rebuilt for the Publisher Portal that Solana Mobile now uses, and the listing copy was rewritten to describe only what the app really does. (`/my-agents`) `[improvement, fix, infra]`+- **Share a photo or a 3D file straight into three.ws**: On Android (and the Seeker app) three.ws now appears in the share sheet. Share a photo from your camera roll and it lands in the selfie-to-avatar flow already attached; share a .glb and it opens the upload flow. Going offline inside the app shows a three.ws screen that reloads on its own when the connection is back, instead of a browser error, and the home-screen icon no longer gets its corners cropped on round or squircle launchers. (`/create`) `[feature, improvement]`- **Text-to-3D is generating again, and it answers in seconds**: For most of a day, describing something in the forge produced a long wait and then a busy message, on the site, in the ChatGPT app, and for agents buying through OKX. Two things had gone wrong at once: the image provider that paints the concept picture had stopped responding, and the free assistant that sharpens your description was asking for models that no longer exist. Both are fixed. The painter now runs on a model that answers in about five seconds, the assistant uses current models, and a text-to-3D request is accepted in three to eight seconds instead of never. Image-to-3D was never affected. (`/forge`) `[fix]`- **Text-to-3D now has five independent image sources behind it**: Every text-to-3D generation starts by painting a concept image, and until today that step leaned on two providers. When one of them was cut off and the other stalled, text prompts failed for hours. The painter now tries five independent sources in order: Google's image model, NVIDIA's FLUX.1-dev, two more FLUX providers routed through Hugging Face, and a keyless public service as the final fallback, all under one shared time budget so a slow provider hands off instead of holding your request. A finished model's status is also remembered, so checking on a done job answers instantly instead of re-scoring it every time. (`/forge`) `[fix, infra]`diff --git a/data/changelog.json b/data/changelog.jsonindex 769baf0db..8fec23a3c 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,25 @@{"$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-08-27",+ "title": "A real home screen for the Seeker app, and a Seeker verified badge",+ "summary": "The three.ws app on Solana Seeker now opens on its own home screen at /seeker: one tap signs you in with Seed Vault, your agents are right there, and Create, Discover, and Chat are a thumb away. Seeker owners can prove it by checking for the Seeker Genesis Token in their wallet (a read, never a transaction); once verified, every agent they own shows a Seeker verified badge on its page.",+ "tags": [+ "feature"+ ],+ "link": "/seeker"+ },+ {+ "date": "2026-08-27",+ "title": "Share a photo or a 3D file straight into three.ws",+ "summary": "On Android (and the Seeker app) three.ws now appears in the share sheet. Share a photo from your camera roll and it lands in the selfie-to-avatar flow already attached; share a .glb and it opens the upload flow. Going offline inside the app shows a three.ws screen that reloads on its own when the connection is back, instead of a browser error, and the home-screen icon no longer gets its corners cropped on round or squircle launchers.",+ "tags": [+ "feature",+ "improvement"+ ],+ "link": "/create"+ },{"date": "2026-08-27","title": "Text-to-3D now has five independent image sources behind it",diff --git a/data/pages.json b/data/pages.jsonindex 445ce5425..69eade889 100644--- a/data/pages.json+++ b/data/pages.json@@ -3159,6 +3159,12 @@"description": "What each panel on /monitor reads and how often, every control on the board, how a failed panel degrades alone, and how to add a panel of your own.","added": "2026-08-01"},+ {+ "path": "/docs/seeker-app",+ "title": "three.ws on Solana Seeker",+ "description": "What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.",+ "added": "2026-08-27"+ },{"path": "/docs/money-flow-map","title": "Docs · Money Flow Map",diff --git a/docs/seeker-app.md b/docs/seeker-app.mdnew file mode 100644index 000000000..b742e6acc--- /dev/null+++ b/docs/seeker-app.md@@ -0,0 +1,40 @@+# three.ws on Solana Seeker++three.ws ships as a native Android app for the Solana Seeker (and Saga) through the Solana dApp Store. It is a Trusted Web Activity: the signed APK (`ws.three.app`) opens `https://three.ws/seeker` full-screen in Chrome's rendering engine with no browser chrome, and every wallet interaction is routed to the phone's Seed Vault through Mobile Wallet Adapter. For a WebGL product that is the right shape (it is what Solana Mobile recommends for web apps); what makes it feel like an app is everything around that shell. This page is the user-facing map of those pieces. The packaging, release pipeline, and store checklist live in [solana-mobile/README.md](../solana-mobile/README.md).++## What the app does differently from the website++| Surface | On Seeker | Where it lives |+|---|---|---|+| Home screen | [/seeker](https://three.ws/seeker): one-tap Seed Vault sign-in, Create / Explore grid, your agents, Seeker verification | `pages/seeker.html`, `src/seeker.js` |+| Sign-in | A single Seed Vault sheet (Sign-In With Solana at authorize time) instead of connect-then-sign. The session survives Android killing the app; a revoked session is dropped cleanly | `solana-mobile/src/mwa-wallet.js`, `src/onchain/adapters/solana.js` |+| Share sheet | Share a photo from any app to three.ws: it opens the selfie flow with the photo attached. Share a `.glb`: it opens the upload flow | `public/share-target-sw.js`, `src/shared/share-target.js` |+| Offline | A branded offline screen that reloads itself when the network returns, instead of Chrome's error page | `public/offline.html`, `vite.config.js` (workbox `precacheFallback`) |+| Home-screen shortcuts | Long-press the icon: Create, Discover, My agents | `solana-mobile/twa/twa-manifest.json`, web manifest in `vite.config.js` |+| Icon | A maskable icon with the glyph inside Android's safe zone, so circle and squircle launchers never crop it | `public/pwa-maskable-*.png` |+| Seeker verification | Prove Seeker ownership by holding the soulbound Seeker Genesis Token; owners get a "Seeker verified" badge on every agent they own | `api/seeker/[action].js`, `api/_lib/seeker-genesis.js` |+| Deep links | Any `https://three.ws/...` link opens inside the app once Digital Asset Links verify the release key | `public/.well-known/assetlinks.json` |++## Seeker verification++The Seeker Genesis Token is a soulbound Token-2022 asset that Solana Mobile mints once per device into the primary Seed Vault account. three.ws reads it (never moves it):++1. Sign in on [/seeker](https://three.ws/seeker) with Seed Vault. That links the wallet to your account through SIWS.+2. Tap **Check my wallet**. The server calls Helius `getTokenAccountsByOwnerV2` for the linked Solana wallets, then checks each mint's authority, metadata pointer, and token-group membership against the Genesis Token group. No transaction, no signature.+3. On success the wallet is recorded in `seeker_genesis_verifications`, and every agent you own shows a **Seeker verified** pill in its trust row on `/agents/:id`.++API: `GET /api/seeker/status` and `POST /api/seeker/verify`, documented in [api-reference.md](./api-reference.md#seeker-verification). Verification fails closed: an RPC error is a 502, never a false positive.++## Sharing into three.ws++The web manifest declares a `share_target` at `POST /create/share`. The service worker intercepts that POST, parks the files in the Cache API, and redirects:++- an image goes to `/create/selfie?shared=1`, where the page picks it up as the frontal selfie (a second and third image fill the optional side angles);+- a `.glb` goes to `/create?shared=glb`, where the upload flow validates and stages it;+- anything else goes to `/create`.++The handoff is one-shot and expires after ten minutes, so a stale share can never resurface. On the Seeker the APK registers the same target with Android, so three.ws appears in the system share sheet for photos and `model/gltf-binary` files.++## Testing without a Seeker++The APK can be exercised in a stock Android emulator (Pixel 7, Android 14 image). Everything except the Seed Vault itself works there: install, launch, shortcuts, the share intent, deep-link verification state. The recipe is in [solana-mobile/README.md](../solana-mobile/README.md#emulator-qa). For the wallet flows, `tests/solana-mobile-*.test.js` drive the MWA wrapper against a fake transport, and the Solana Mobile reference wallet can be sideloaded into the emulator for an end-to-end sign-in.diff --git a/docs/start-here.md b/docs/start-here.mdindex b35b52566..4b54feb20 100644--- a/docs/start-here.md+++ b/docs/start-here.md@@ -163,6 +163,7 @@ Deeper references that don't fit a track above but answer real questions:- [Design tokens](./DESIGN-TOKENS.md): the canonical design vocabulary (colors, spacing, type, motion) every surface builds from- [NVIDIA models on three.ws](./nvidia-models.md): the free hosted inference layer model by model, one key behind text-to-3D, chat, vision, embeddings, safety, and speech- [Run an inference node](./inference-node-operator.md): join the supply side of the open inference network with your own hardware, from clone to a signed, verified result, on CPU or an NVIDIA GPU+- [three.ws on Solana Seeker](./seeker-app.md): the Android app for Seeker and Saga, and what it adds on top of the website (Seed Vault sign-in, share-sheet capture, offline shell, Seeker verification)- [Free LLM providers](./free-llm-providers.md): the failover chain of a dozen free AI providers behind every text completion, what each free tier gives, and how to add the next rung- [Tokens API on three.ws](./tokens-xyz.md): the Solana Foundation asset layer that tells us which mints are the same asset, why it sits second in the market-data cascade, and the one env var that turns it on- [NVIDIA Inception membership](./nvidia-inception.md): what the platform already runs on NVIDIA silicon and what the program adds on topdiff --git a/public/changelog.json b/public/changelog.jsonindex fe4eaacc6..3b135aa2b 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-27T05:37:58.249Z",+ "generated_at": "2026-08-27T05:41:23.776Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -16,6 +16,26 @@"launch"]},+ {+ "date": "2026-08-27",+ "type": "launch",+ "title": "three.ws on Solana Seeker",+ "summary": "What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.",+ "link": "/docs/seeker-app",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-08-27",+ "type": "update",+ "title": "A real home screen for the Seeker app, and a Seeker verified badge",+ "summary": "The three.ws app on Solana Seeker now opens on its own home screen at /seeker: one tap signs you in with Seed Vault, your agents are right there, and Create, Discover, and Chat are a thumb away. Seeker owners can prove it by checking for the Seeker Genesis Token in their wallet (a read, never a transaction); once verified, every agent they own shows a Seeker verified badge on its page.",+ "link": "/seeker",+ "tags": [+ "feature"+ ]+ },{"date": "2026-08-27","type": "update",@@ -28,6 +48,17 @@"infra"]},+ {+ "date": "2026-08-27",+ "type": "update",+ "title": "Share a photo or a 3D file straight into three.ws",+ "summary": "On Android (and the Seeker app) three.ws now appears in the share sheet. Share a photo from your camera roll and it lands in the selfie-to-avatar flow already attached; share a .glb and it opens the upload flow. Going offline inside the app shows a three.ws screen that reloads on its own when the connection is back, instead of a browser error, and the home-screen icon no longer gets its corners cropped on round or squircle launchers.",+ "link": "/create",+ "tags": [+ "feature",+ "improvement"+ ]+ },{"date": "2026-08-27","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex fa668746f..ac48aeba6 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -14,6 +14,22 @@<category>launch</category><description>The home screen of the three.ws app on Solana Seeker: one-tap Seed Vault sign-in, selfie to avatar, your agents, the marketplace, and Seeker Genesis Token verification.</description></item>+ <item>+ <title>three.ws on Solana Seeker</title>+ <link>https://three.ws/docs/seeker-app</link>+ <guid isPermaLink="false">2026-08-27:three.ws on Solana Seeker</guid>+ <pubDate>Thu, 27 Aug 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.</description>+ </item>+ <item>+ <title>A real home screen for the Seeker app, and a Seeker verified badge</title>+ <link>https://three.ws/seeker</link>+ <guid isPermaLink="false">2026-08-27:A real home screen for the Seeker app, and a Seeker verified badge</guid>+ <pubDate>Thu, 27 Aug 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>The three.ws app on Solana Seeker now opens on its own home screen at /seeker: one tap signs you in with Seed Vault, your agents are right there, and Create, Discover, and Chat are a thumb away. Seeker owners can prove it by checking for the Seeker Genesis Token in their wallet (a read, never a transaction); once verified, every agent they own shows a Seeker verified badge on its page.</description>+ </item><item><title>Seeker app: stay signed in across restarts, and a submission path that matches today's dApp Store</title><link>https://three.ws/my-agents</link>@@ -22,6 +38,14 @@<category>improvement</category><description>On Solana Seeker, the three.ws app now remembers your Seed Vault session when Android restarts the app in the background, so reopening it no longer asks you to approve again; a revoked session is dropped cleanly instead of failing every signature. The My Agents home-screen shortcut opens your own agents instead of the public index. Behind the scenes the store submission tooling was rebuilt for the Publisher Portal that Solana Mobile now uses, and the listing copy was rewritten to describe only what the app really does.</description></item>+ <item>+ <title>Share a photo or a 3D file straight into three.ws</title>+ <link>https://three.ws/create</link>+ <guid isPermaLink="false">2026-08-27:Share a photo or a 3D file straight into three.ws</guid>+ <pubDate>Thu, 27 Aug 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>On Android (and the Seeker app) three.ws now appears in the share sheet. Share a photo from your camera roll and it lands in the selfie-to-avatar flow already attached; share a .glb and it opens the upload flow. Going offline inside the app shows a three.ws screen that reloads on its own when the connection is back, instead of a browser error, and the home-screen icon no longer gets its corners cropped on round or squircle launchers.</description>+ </item><item><title>Text-to-3D is generating again, and it answers in seconds</title><link>https://three.ws/forge</link>diff --git a/public/features.json b/public/features.jsonindex 2e778c821..6f57fc55d 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-27T05:37:58.227Z",+ "generated_at": "2026-08-27T05:41:23.760Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -3917,6 +3917,16 @@"tags": [],"showcase": false},+ {+ "path": "/docs/seeker-app",+ "title": "three.ws on Solana Seeker",+ "description": "What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.",+ "added": "2026-08-27",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false+ },{"path": "/docs/money-flow-map","title": "Docs · Money Flow Map",diff --git a/public/llms-full.txt b/public/llms-full.txtindex 192d76fb3..1cd7c3437 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -2379,6 +2379,12 @@ URL: https://three.ws/docs/monitorWhat each panel on /monitor reads and how often, every control on the board, how a failed panel degrades alone, and how to add a panel of your own.+### three.ws on Solana Seeker++URL: https://three.ws/docs/seeker-app++What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.+### Docs · Money Flow MapURL: https://three.ws/docs/money-flow-mapdiff --git a/public/llms.txt b/public/llms.txtindex e4af9b0be..685d6427f 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -432,6 +432,7 @@ Docs, tutorials, and reference.- [Docs · Autonomous x402 Loop](https://three.ws/docs/autonomous-x402): The scheduled buyer that pays x402 endpoints on a cadence to feed the oracle and sniper: real USDC, real settlements.- [Docs · Circulation Engine](https://three.ws/docs/circulation-engine): The autonomous agent-to-agent activity loop: a pool of real platform agents tipping, paying, trading, and launching with one another.- [Docs · Agent Monitor](https://three.ws/docs/monitor): What each panel on /monitor reads and how often, every control on the board, how a failed panel degrades alone, and how to add a panel of your own.+- [three.ws on Solana Seeker](https://three.ws/docs/seeker-app): What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.- [Docs · Money Flow Map](https://three.ws/docs/money-flow-map): How /flow builds the agent economy topology from settled on-chain transfers: the two edge sources, the privacy gate on counterparties, what source/hub/relay/sink mean, and how the stuck-capital number is computed.- [Docs · Money Feed](https://three.ws/docs/money-feed): The surfaces that show real value moving through three.ws: the live ticker, the custody-spend ledger, and the economy volume dashboard.- [Docs · Reputation System](https://three.ws/docs/reputation): Leave and read permanent, on-chain reviews for any registered agent via the UI, SDK, or contract.diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex 04d49cdc1..22cd5958c 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -83,7 +83,7 @@<main class="sm-wrap"><div class="sm-hero"><h1>Sitemap</h1>- <p>All 837 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>+ <p>All 838 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p><div class="sm-formats"><a href="/sitemap.xml"><code>sitemap.xml</code> · for search engines</a><a href="/llms.txt"><code>llms.txt</code> · for AI agents</a>@@ -95,7 +95,7 @@</div><div class="sm-filter"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>- <input id="sm-filter-input" type="search" placeholder="Filter 837 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />+ <input id="sm-filter-input" type="search" placeholder="Filter 838 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" /><kbd aria-hidden="true">/</kbd></div><p class="sm-filter-count" id="sm-filter-count" role="status" aria-live="polite"></p>@@ -111,6 +111,14 @@<span class="sm-desc">The home screen of the three.ws app on Solana Seeker: one-tap Seed Vault sign-in, selfie to avatar, your agents, the marketplace, and Seeker Genesis Token verification.</span></a></li>+ <li>+ <a href="/docs/seeker-app">+ <span class="sm-new-date">Aug 27, 2026</span>+ <span class="sm-title">three.ws on Solana Seeker</span>+ <span class="sm-path">/docs/seeker-app</span>+ <span class="sm-desc">What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.</span>+ </a>+ </li><li><a href="/docs/open-source-footprint"><span class="sm-new-date">Aug 25, 2026</span>@@ -167,14 +175,6 @@<span class="sm-desc">The design brief for the liquid-glass look on three.ws grids and panels: real refraction instead of blur, the squircle and material recipe, the two lanes (CSS glass for chrome, three.js transmission for tiles), the open-source references, and the performance and accessibility budget.</span></a></li>- <li>- <a href="/docs/community">- <span class="sm-new-date">Aug 21, 2026</span>- <span class="sm-title">Docs · Community</span>- <span class="sm-path">/docs/community</span>- <span class="sm-desc">Where the three.ws community talks: GitHub Discussions, the Telegram community, the X community, the IBM Community group, and the release channel, with guidance on which room fits which question.</span>- </a>- </li></ul></section><nav class="sm-toc" aria-label="Sections">@@ -2276,7 +2276,7 @@<section class="sm-section" id="learn"><header>- <h2>Learn<span class="sm-count" data-count>376</span></h2>+ <h2>Learn<span class="sm-count" data-count>377</span></h2><p class="sm-section-desc">Docs, tutorials, and reference.</p></header><ul class="sm-list">@@ -2952,6 +2952,13 @@<span class="sm-desc">What each panel on /monitor reads and how often, every control on the board, how a failed panel degrades alone, and how to add a panel of your own.</span></a></li>+ <li>+ <a href="/docs/seeker-app">+ <span class="sm-title">three.ws on Solana Seeker</span>+ <span class="sm-path">/docs/seeker-app</span>+ <span class="sm-desc">What the Seeker app adds on top of the website: Seed Vault sign-in, share-sheet capture, an offline shell, home-screen shortcuts, and Seeker Genesis Token verification.</span>+ </a>+ </li><li><a href="/docs/money-flow-map"><span class="sm-title">Docs · Money Flow Map</span>diff --git a/solana-mobile/README.md b/solana-mobile/README.mdindex 323e4c5bd..8cb77546d 100644--- a/solana-mobile/README.md+++ b/solana-mobile/README.md@@ -30,7 +30,13 @@ solana-mobile/└── INTEGRATION.md # how the wallet is wired into the three.ws bundle```-The offline page and the web manifest are NOT duplicated here: the live manifest is generated by `vite-plugin-pwa` from `vite.config.js` (`webManifestUrl` in `twa/twa-manifest.json` points at it), and the service worker deliberately has no navigation fallback (see the `workbox` block in `vite.config.js`).+The web manifest is NOT duplicated here: the live one is generated by `vite-plugin-pwa` from `vite.config.js` (`webManifestUrl` in `twa/twa-manifest.json` points at it). The app-only surfaces live with the rest of the site:++- `/seeker` (`pages/seeker.html`, `src/seeker.js`): the TWA's start URL. One-tap Seed Vault sign-in, Create / Explore grid, the owner's agents, and Seeker Genesis Token verification.+- Share target: `public/share-target-sw.js` handles `POST /create/share` from the Android share sheet; `src/shared/share-target.js` hands the file to `/create/selfie` (photos) or `/create` (GLB). The APK registers the same target through `shareTarget` in `twa/twa-manifest.json` (MIME types only; Android rejects file extensions there).+- Offline: `public/offline.html` is precached and served by the workbox `precacheFallback` rule in `vite.config.js` when a navigation fails.+- Icons: `public/pwa-maskable-*.png` keep the glyph inside Android's safe zone; `build-apk.sh` serves `public/` locally during the build so the APK embeds this commit's icons rather than whatever the last deploy shipped.+- Seeker verification API: `api/seeker/[action].js`, documented in `docs/api-reference.md`. Product doc: `docs/seeker-app.md`.## How the wallet works@@ -56,28 +62,61 @@ cd solana-mobile# stages JDK 17 + Android SDK under ~/.bubblewrap. Idempotent../scripts/setup-android-sdk.sh-# 1. Build the signed APK. Creates the keystore on first run: back it up-# (file + password) to the owner's password manager immediately. Also-# writes /public/.well-known/assetlinks.json with the real fingerprint.+# 1. Restore the release keystore (it is gitignored). Both halves live in+# Secret Manager since 2026-08-27; the password also sits in .env as+# SOLANA_MOBILE_KEYSTORE_PASSWORD. Losing this key means the app can never+# be updated, so never generate a second one while this one exists.+gcloud secrets versions access latest --secret three-ws-seeker-release-keystore \+ --project aerial-vehicle-466722-p5 | base64 -d > android.keystore+export SOLANA_MOBILE_KEYSTORE_PASSWORD="$(gcloud secrets versions access latest \+ --secret three-ws-seeker-keystore-password --project aerial-vehicle-466722-p5)"++# 2. Build the signed APK. Also writes /public/.well-known/assetlinks.json+# with the key's fingerprint (98:0A:1A:AB:...:11:13:D7).KEYSTORE_PASSWORD="$SOLANA_MOBILE_KEYSTORE_PASSWORD" ACCEPT_ANDROID_SDK_LICENSES=1 ./scripts/build-apk.sh-# 2. Deploy three.ws so assetlinks.json is live (npm run deploy:gcp from the+# 3. Deploy three.ws so assetlinks.json is live (npm run deploy:gcp from the# repo root; production is Cloud Run), then confirm Google sees it:curl -fsSL https://three.ws/.well-known/assetlinks.json | jq .curl -fsSL 'https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://three.ws&relation=delegate_permission/common.handle_all_urls'-# 3. First release only, in the portal (owner): create the publisher profile,+# 4. First release only, in the portal (owner): create the publisher profile,# pass KYC/KYB, "Add a dApp" using publish/config.yaml + publish/listing/ +# publish/media/, mint the App NFT (~0.2 SOL in the publisher wallet), and# create an API key under Settings > API keys.-# 4. Submit the release.+# 5. Submit the release.SOLANA_KEYPAIR=~/.config/solana/publisher.json \DAPP_STORE_API_KEY='portal-api-key' \./scripts/publish.sh```-For later releases, bump `appVersionCode` / `appVersion` in `twa/twa-manifest.json` (or pass `VERSION_CODE` / `VERSION_NAME`), then repeat steps 1 and 4. `publish.sh` refuses to re-submit a versionCode it already shipped from the same machine. Releases are run locally by the owner; this repo does not use GitHub Actions.+For later releases, bump `appVersionCode` / `appVersion` in `twa/twa-manifest.json` (or pass `VERSION_CODE` / `VERSION_NAME`), then repeat steps 2 and 5. `publish.sh` refuses to re-submit a versionCode it already shipped from the same machine. Releases are run locally by the owner; this repo does not use GitHub Actions.++## Emulator QA++Everything except the Seed Vault itself can be verified in a stock emulator; this is how the 2026-08-27 build was checked.++```bash+# One-time: emulator, platform tools, and an Android 14 image (KVM needed: sudo chmod 666 /dev/kvm in a codespace).+SDK=~/.bubblewrap/android_sdk/cmdline-tools+$SDK/bin/sdkmanager --sdk_root=$SDK "platform-tools" "emulator" "build-tools;34.0.0" "system-images;android-34;google_apis;x86_64"+echo no | $SDK/bin/avdmanager create avd -n seeker -k "system-images;android-34;google_apis;x86_64" -d pixel_7+# The SDK root is the cmdline-tools dir, so fix the image path avdmanager writes:+sed -i 's#^image.sysdir.1=.*#image.sysdir.1=system-images/android-34/google_apis/x86_64/#' ~/.android/avd/seeker.avd/config.ini+ANDROID_SDK_ROOT=$SDK $SDK/emulator/emulator -avd seeker -no-window -no-audio -no-boot-anim -gpu swiftshader_indirect &++adb install -r build/three-ws-release.apk+adb shell am start -n ws.three.app/.LauncherActivity # first launch shows Chrome's welcome sheet once+adb shell dumpsys shortcut | grep -A40 "Package: ws.three.app" | grep shortLabel+adb shell pm get-app-links ws.three.app # state 1 after assetlinks.json is live for this key+adb push ../public/pwa-512x512.png /sdcard/Download/selfie.png+adb shell am start -a android.intent.action.SEND -t image/png \+ --eu android.intent.extra.STREAM file:///sdcard/Download/selfie.png -n ws.three.app/.LauncherActivity --grant-read-uri-permission+adb exec-out screencap -p > shot.png+```++Until the commit that adds `/seeker` and the share handler is deployed, the emulator opens production and shows the site's 404 for both; that is the deploy gate, not an app bug.## What still needs a physical Seekerdiff --git a/solana-mobile/docs/CHECKLIST.md b/solana-mobile/docs/CHECKLIST.mdindex 2be113dcf..87a8aae49 100644--- a/solana-mobile/docs/CHECKLIST.md+++ b/solana-mobile/docs/CHECKLIST.md@@ -16,18 +16,19 @@ Work top-to-bottom. Do not submit until every box is checked. A date after a box- [x] `scripts/build-apk.sh` has been run so the SHA-256 fingerprint is known. (2026-08-10; keystore at `solana-mobile/android.keystore`, password in `.env` `SOLANA_MOBILE_KEYSTORE_PASSWORD`; on a fresh headless machine run `scripts/setup-android-sdk.sh` first)- [x] `public/.well-known/assetlinks.json` contains the real fingerprint (no `{{RELEASE_SHA256}}` placeholder) and is on `main`. (2026-08-10)-- [x] `https://three.ws/.well-known/assetlinks.json` returns 200 as `application/json`. (verified 2026-08-27)-- [x] Google's statement list confirms it: `https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://three.ws&relation=delegate_permission/common.handle_all_urls` returns the `ws.three.app` statement with fingerprint `49:84:9C:CC:...:DC:27`. (verified 2026-08-27)+- [ ] `https://three.ws/.well-known/assetlinks.json` returns 200 as `application/json` AND carries the 2026-08-27 fingerprint `98:0A:...:13:D7` (the live file still shows the orphaned `49:84:...` key until the next deploy).+- [ ] Google's statement list confirms the new key: `https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://three.ws&relation=delegate_permission/common.handle_all_urls` must return `98:0A:...:13:D7` (it returned the old `49:84:...` on 2026-08-27, pre-deploy). Then `adb shell pm verify-app-links --re-verify ws.three.app`.- [ ] `cache-control` on `assetlinks.json` is at most one hour. The server now sends `max-age=3600` for `.well-known/*`; confirm on the live site after the next deploy (it read `max-age=86400` on 2026-08-27, from the image built before this change).## 3. APK build-- [ ] Release keystore is backed up offsite (lose it and the app can never be updated). The keystore was generated 2026-08-10 in the codespace; OFFSITE BACKUP STILL NEEDED: put `solana-mobile/android.keystore` and the `.env` password in the owner's password manager.-- [x] `build/three-ws-release.apk` was produced by `scripts/build-apk.sh` and is signed. (2026-08-10, 4.5 MB; `build/` is gitignored, so rebuild on the release machine)-- [x] `apksigner verify --print-certs` prints the SHA-256 that is in `assetlinks.json`. (verified 2026-08-10: `49:84:9C:CC:...:DC:27`)-- [ ] APK installs cleanly on a Seeker: launches into three.ws full-screen, no Chrome address bar.-- [ ] App icon, name, and splash colors match brand (`three.ws`, `#080814` background, `#000000` theme).-- [ ] Long-press on the app icon shows Create / Discover / My agents, and each opens inside the app.+- [x] Release keystore is backed up offsite. The 2026-08-10 keystore was lost with its codespace (never backed up), so a NEW key was generated 2026-08-27 and stored in Secret Manager (`three-ws-seeker-release-keystore`, base64, and `three-ws-seeker-keystore-password`, project `aerial-vehicle-466722-p5`; round trip verified by sha256). Nothing was ever published under the old key. Never generate another.+- [x] `build/three-ws-release.apk` was produced by `scripts/build-apk.sh` and is signed. (2026-08-27, 4.1 MB, versionCode 1, targetSdk 36; `build/` is gitignored, so rebuild on the release machine)+- [x] `apksigner verify --print-certs` prints the SHA-256 that is in `assetlinks.json`. (verified 2026-08-27: `98:0A:1A:AB:...:11:13:D7`)+- [x] APK installs and launches on Android 14 (Pixel 7 emulator, 2026-08-27). Full-screen without the address bar needs Digital Asset Links for the NEW fingerprint, which go live with the next deploy; until then Chrome shows a custom-tab bar, by design.+- [ ] App icon, name, and splash colors match brand on a real launcher (`three.ws`, `#080814` background, `#000000` theme).+- [x] Long-press shortcuts Create / Discover / My agents are registered in the installed APK (`dumpsys shortcut`, 2026-08-27); each opens inside the app once DAL verifies.+- [x] The Android share sheet target is registered (`shareTarget`, MIME types only) and an `ACTION_SEND` image intent opens the app (2026-08-27, emulator).## 4. MWA integration