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
copy(launch-studio): dash-free recipe blurbs, and a deep link that picks the reward coin type
nirholasc6f3f78e6f56
diff --git a/STRUCTURE.md b/STRUCTURE.mdindex 80970c1c4..20f62ac59 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -58,6 +58,7 @@ bottom.| Glance (agent cards for home screens, READMEs and chat) | Page [public/glance/index.html](public/glance/index.html) `-> /glance` (+ [glance-page.js](public/glance/glance-page.js), [glance.css](public/glance/glance.css)), hosted element [public/glance/element.js](public/glance/element.js), endpoints [api/glance/card.js](api/glance/card.js) / [api/glance/mine.js](api/glance/mine.js) / [api/glance/token.js](api/glance/token.js) / [api/glance/template.js](api/glance/template.js), model [api/_lib/glance-card.js](api/_lib/glance-card.js), SVG [api/_lib/glance-svg.js](api/_lib/glance-svg.js), PNG [api/_lib/glance-png.js](api/_lib/glance-png.js), widget tokens [api/_lib/glance-tokens.js](api/_lib/glance-tokens.js) (`glance_widget_tokens`), Adaptive Card [api/_lib/glance-adaptive.js](api/_lib/glance-adaptive.js), Windows widget worker [public/glance-sw.js](public/glance-sw.js) (imported by the VitePWA service worker, manifest `widgets` member in [vite.config.js](vite.config.js)), Android home screen widget [solana-mobile/android-overlay/](solana-mobile/android-overlay/README.md) (applied by [solana-mobile/scripts/apply-overlay.mjs](solana-mobile/scripts/apply-overlay.mjs) inside `build-apk.sh`), macOS and iOS WidgetKit widget [apple/](apple/README.md) (shared [apple/GlanceKit/](apple/GlanceKit), extension [apple/GlanceWidget/](apple/GlanceWidget), Mac app [apple/macos/](apple/macos), an iOS target in [ios/native/App/App.xcodeproj](ios/native/App)), npm client [packages/agent-glance/](packages/agent-glance) | Live | One agent reduced to what fits in an OS widget slot: name, one live number (actions in the last 24h), and a link back. The same model renders five ways from one endpoint (JSON, SVG, PNG, Adaptive Card, and the `<agent-glance>` element), which is what keeps a new surface a rendering job rather than a data job. Windows 11 installs the widget straight from the PWA manifest (no store submission). Android ships it in the app (1.1+): a WorkManager-refreshed `AppWidgetProvider` that fetches the PNG with a revocable per-account widget token minted on `/glance`, keeps the last card offline, and opens the agent on tap. macOS and iOS run one WidgetKit extension over the same PNG and the same token, in small, medium and large: the Mac ships as a Developer ID menu bar app that holds the token and feeds the widget, and the iPhone gets the extension inside the existing Capacitor app. Both fetch the card in each theme so the widget follows the reader's appearance. `npm run check:apple-widget` proves both Xcode projects and the client-to-server contract without a Mac in the room. Deliberately not the 3D embed: no widget host on any of these platforms can run WebGL, so the body stays at [/widgets](public/widgets-gallery/index.html) and the status lives here. Private avatars never leak (the thumbnail is attached only for a public or unlisted avatar; everything else draws a generated monogram). Spec [specs/GLANCE_CARD.md](specs/GLANCE_CARD.md), docs [docs/glance.md](docs/glance.md), [docs/native-widgets.md](docs/native-widgets.md). Tests: [tests/glance-card.test.js](tests/glance-card.test.js), [tests/glance-png.test.js](tests/glance-png.test.js), [tests/glance-tokens.test.js](tests/glance-tokens.test.js), [tests/glance-sw.test.js](tests/glance-sw.test.js), [tests/agent-glance-sdk.test.js](tests/agent-glance-sdk.test.js), guard [scripts/check-apple-widget.mjs](scripts/check-apple-widget.mjs) || Daily Match (agent output arena) | [pages/daily-match.html](pages/daily-match.html) `→ /daily-match`, backend [api/leaderboard/daily-match.js](api/leaderboard/daily-match.js) | Live | Live daily standings ranking public agents by real output shipped since 00:00 UTC: agent_actions events, sniper + pump trades, confirmed skill sales, and coin launches, with realized sniper P&L shown for context (never scored). Computed live per request (no rollup cron), resets naturally at UTC midnight; includes yesterday's champion and a live-output feed. Reputation-first: no payouts hang off the score. Format adopted with credit from Bowyer's Arena (bowyer.app/arena), who build their agent pages on three.ws avatars. || KOL Tracker | [pages/tracker.html](pages/tracker.html) `→ /tracker`, backend [api/kol/[action].js](api/kol/%5Baction%5D.js) `→ GET /api/kol/tracker?window=&limit=`, aggregator [src/kol/tracker.js](src/kol/tracker.js), wallet list [src/kol/wallet-store.js](src/kol/wallet-store.js) (bundled [src/kol/wallets.json](src/kol/wallets.json) + admin R2 imports via `POST /api/kol/import-gmgn`), FIFO P&L engine [src/kol/wallet-pnl.js](src/kol/wallet-pnl.js), cached X follower/avatar lookup [src/kol/x-profile.js](src/kol/x-profile.js) | Live | Solana crypto KOLs ranked by realized P&L computed from each tracked wallet's own on-chain trade history (24h/7d/30d), with win rate, volume, and trade count — every number traceable to real trades, never a competitor's computed leaderboard. A wallet only shows an X handle/avatar/follower-count when an admin has explicitly attached a verified `xHandle` via `import-gmgn`'s `xHandles` map (never inferred or scraped); unattached wallets rank by wallet address alone. Rows with no configured trade source (`PUMPFUN_BOT_URL`) fall back to an imported `pnlUsd`/`winRate` labeled with its `pnlSource` rather than fabricating on-chain numbers. Prewarm cron: [api/cron/kol-tracker-refresh.js](api/cron/kol-tracker-refresh.js). |+| Agent Galaxy (every agent as a star, positioned by meaning) | [pages/galaxy.html](pages/galaxy.html) `→ /galaxy` + [src/galaxy.js](src/galaxy.js), backend [api/galaxy.js](api/galaxy.js) `→ GET/POST /api/galaxy`, assembler [api/_lib/galaxy.js](api/_lib/galaxy.js), embedding cache [api/_lib/agent-embeddings.js](api/_lib/agent-embeddings.js), live-economy overlay over `GET /api/galaxy/flows` | In-repo · awaits watsonx credentials | Every published agent embedded with an IBM Granite model on watsonx.ai, projected to 3D by PCA and grouped into k-means constellations that Granite then names, rendered as a Three.js point cloud. Typing a phrase embeds the query in the same space and lights the matching stars; the Money-Cam layer animates real on-chain transfers between them, and star brightness comes from each agent’s real wallet net worth. No mock path anywhere: with no watsonx credentials on the service `GET /api/galaxy` answers 503 and the page says so, offering the agent list and the integration doc instead of an empty universe. Tests: [tests/e2e/galaxy.spec.js](tests/e2e/galaxy.spec.js), [tests/galaxy-flows.test.js](tests/galaxy-flows.test.js) || Agent Symphony (economy as generative music) | [pages/symphony.html](pages/symphony.html) `→ /symphony`, engine [src/symphony.js](src/symphony.js), grammar [src/symphony-score.js](src/symphony-score.js) | Live | The live activity bus (`GET /api/feed` + `/api/feed-stream` SSE) rendered as WebAudio generative music: one synthesized note per real platform event, voice by event type (payments pluck, coin buys land as bass, new agents chime, guard refusals play dissonance, jackpots glissando), pitch register by amount (whales sit lower), stable per-actor motif + stereo position via FNV-1a hash, all quantized to one pentatonic scale so arbitrary event streams harmonize. Canvas visualization, live ledger with real click-throughs, and a MediaRecorder tap that exports a shareable audio clip of the master bus. A burst gate collapses event floods (a sniper sweep emitting dozens of identical guard events) into one accented note per actor per 1.5s. Solo mode narrows the stream to one participant client-side (`?agent=<id>` exact, `?actor=<label>` case-insensitive), reachable from the per-row "solo" control and from the "Listen →" link on every agent profile's Wallet Story card. No audio assets, no synthetic events. Tests: [tests/symphony-score.test.js](tests/symphony-score.test.js) || Platform activity feed | [pages/feed.html](pages/feed.html) `→ /feed` + [pages/community.html](pages/community.html) `→ /community`, backend [api/users/me/feed.js](api/users/me/feed.js) | Live | Reverse-chronological creation events (avatars, agents, coins, models, worlds) plus follow activity, merged at read time from `forge_creations`, `dioramas`, and `user_follows` (no separate event log to drift out of sync). `?scope=following` (default; session-gated, anonymous gets 401) vs `?scope=all` (public; powers `/community` and first-visit feeds); `limit` 1..50, `before` ISO cursor. Items deep-link to creator portfolios. Distinct from the Money Pulse ticker `GET /api/feed` ([docs/money-feed.md](docs/money-feed.md)). Docs: [docs/social-layer.md](docs/social-layer.md) || Follow graph | [api/users/[username]/follow.js](api/users/%5Busername%5D/follow.js) + [api/users/[username]/follows.js](api/users/%5Busername%5D/follows.js), table `user_follows`, buttons on [pages/profile.html](pages/profile.html) | Live | `GET` returns `{following, followed_by, followers_count, following_count}`; `POST`/`DELETE` are idempotent (session + CSRF, self-follow 400) and return the same envelope so one round-trip updates the button and the counts. A genuinely new edge (`ON CONFLICT DO NOTHING`) publishes a `follow` user event to the notification bell exactly once. Feeds the activity feed's following scope, search ranking, and the `followers` leaderboard metric. Tests: [tests/api/users-follow.test.js](tests/api/users-follow.test.js). Docs: [docs/social-layer.md](docs/social-layer.md) |@@ -198,7 +199,7 @@ bottom.| Token-gated 3D embeds (holder-only interactive scenes) | Gate config + on-chain verify [api/_lib/embed-gate.js](api/_lib/embed-gate.js), access tokens [api/_lib/embed-gate-token.js](api/_lib/embed-gate-token.js), endpoints [api/embed/gate-create.js](api/embed/gate-create.js) + [api/embed/gate-verify.js](api/embed/gate-verify.js), gate-aware resolver [api/embed/resolve.js](api/embed/resolve.js), MCP tool [api/_mcp/tools/embed.js](api/_mcp/tools/embed.js) (`create_gated_embed`), widget [public/embed/v1.js](public/embed/v1.js) (`<three-d>`) + standalone host [public/embed/v1/gated.html](public/embed/v1/gated.html) `→ /embed/v1/gated` | In-repo | `create_gated_embed(asset_id, gate)` turns an avatar or on-chain agent you own into a holder-only interactive `<three-d>` embed — visitors must prove a real, server-verified SPL balance (SIWS challenge → nonce → signature → Solana RPC read, never a client-reported number) before the live scene renders; below the bar they see a designed locked teaser + connect-wallet CTA. `mint` defaults to $THREE but is a runtime parameter (coin-agnostic plumbing). Anti-abuse: short-lived signed access tokens (auto re-verify on expiry) + per-IP/per-wallet rate limits. Storage: [embed_gates + embed_gate_nonces](api/_lib/migrations/20260708120000_embed_gates.sql). Spec: [specs/EMBED_SPEC.md](specs/EMBED_SPEC.md#token-gating). Docs: [docs/token-gated-3d-embeds.md](docs/token-gated-3d-embeds.md). Tests: [tests/embed-gate.test.js](tests/embed-gate.test.js) || Agent token plans (the coin an agent will become) | Rules + storage [api/_lib/agent-token-plan.js](api/_lib/agent-token-plan.js) (migration [api/_lib/migrations/20260811130000_agent_token_plans.sql](api/_lib/migrations/20260811130000_agent_token_plans.sql)), API actions `plan` + `plan-dry-run` in [api/agents/tokens/[action].js](api/agents/tokens/%5Baction%5D.js) `→ /api/agents/tokens/{plan,plan-dry-run}`, profile panel [src/agent-token-plan.js](src/agent-token-plan.js) on `/agents/:id` | In-repo · Live | The launch configuration bound to the agent record: one saved, editable plan per (agent, network) carrying the coin's name, ticker, story, artwork, pairing, buyback share and dev buy, with a derived readiness verdict and SOL cost estimate. Saving costs nothing and mints nothing. `plan-dry-run` is the free proof lane: it builds the SAME pump.fun create instructions the real launch builds from the SAME plan, compiles them against a real blockhash and simulates them on the cluster (devnet by default), never signing and never broadcasting, and separates `funding_required` from a genuinely broken plan. Both launch paths (`/api/agents/tokens/launch-confirm` from the owner's wallet, `/api/pump/launch-agent` from the agent's custodial wallet) call `markPlanLaunched` and write a `pump_agent_mints` row, which is also what finally puts user-wallet launches into `/launches` and the profile's launch history. Docs: [docs/agent-tokens.md](docs/agent-tokens.md). Tests: [tests/agent-token-plan.test.js](tests/agent-token-plan.test.js), [tests/agent-token-plan-api.test.js](tests/agent-token-plan-api.test.js), [tests/agent-token-plan-render.test.js](tests/agent-token-plan-render.test.js) || Agent token market data (what the coin looks like on the profile) | Cluster read [api/_lib/pump-curve-view.js](api/_lib/pump-curve-view.js) `→ GET /api/pump/curve` + `GET /api/v1/pump/curve`, view model [src/widgets/bonding-curve.js](src/widgets/bonding-curve.js) (`computeView`), normalization + widget [src/pump/coin-status-card.js](src/pump/coin-status-card.js) (`mapCoin` / `mapCurve` / `mountCoinStatus`), profile wiring [src/agent-detail.js](src/agent-detail.js) (token chip + launch history) | In-repo · Live | The live market half of an agent token. Two sources, one normalized shape: pump.fun's indexer (`/api/pump/coin`, mainnet, carries logo + 24h volume) and the bonding curve read straight off the cluster (`/api/pump/curve`), which is the ONLY source on devnet and the fallback whenever the indexer has not indexed a fresh mint or cannot be reached. A devnet coin renders in SOL and is badged `DEVNET` (devnet SOL has no dollar value) and links to the explorer instead of a pump.fun page that does not exist for that cluster, so the free rehearsal path renders exactly like a real launch. The curve gate accepts a pump.fun-ground `pump` suffix, a three.ws `3ws` mark, any plausible devnet address, and otherwise asks `pump_agent_mints` whether the mint is one of ours: a coin launched from a user's own wallet carries no mark and used to be refused with a cached `not_a_pump_mint` 404. Market cap is derived as price × supply because the SDK's `price.marketCap` goes negative on live curves. Free proof: [scripts/agent-token-market-proof.mjs](scripts/agent-token-market-proof.mjs) (reads only, signs nothing). Docs: [docs/agent-tokens.md](docs/agent-tokens.md). Tests: [tests/pump-curve-mint-gate.test.js](tests/pump-curve-mint-gate.test.js), [tests/agent-detail-launch-history.test.js](tests/agent-detail-launch-history.test.js), [src/pump/coin-status-card.curve.dom.test.js](src/pump/coin-status-card.curve.dom.test.js) |-| Launch Studio (coin-launch use cases) | [api/_lib/launch/](api/_lib/launch) `→ /launch-studio`, [api/pump/launch-studio.js](api/pump/launch-studio.js), [public/launch-studio/launch-studio.js](public/launch-studio/launch-studio.js) | In-repo | Engine + catalog of 50 declarative launch recipes — reward coins for trending GitHub repos/creators ([github-trending.js](api/_lib/github-trending.js)) and coins riding live narratives ([launcher-trends.js](api/_lib/launcher-trends.js)). Live preview → `/launch` handoff. Docs: [docs/launch-usecases.md](docs/launch-usecases.md), [api/_lib/launch/README.md](api/_lib/launch/README.md) |+| Launch Studio (coin-launch use cases) | [api/_lib/launch/](api/_lib/launch) `→ /launch-studio`, [api/pump/launch-studio.js](api/pump/launch-studio.js), [public/launch-studio/launch-studio.js](public/launch-studio/launch-studio.js) | In-repo | Engine + catalog of 50 declarative launch recipes: reward coins for trending GitHub repos/creators ([github-trending.js](api/_lib/github-trending.js)) and coins riding live narratives ([launcher-trends.js](api/_lib/launcher-trends.js)). Live preview, then a `/launch` handoff that carries the recipe's fee routing as `?reward=` and pre-fills the fee split after the mint. Docs: [docs/launch-usecases.md](docs/launch-usecases.md), [api/_lib/launch/README.md](api/_lib/launch/README.md) || Native launchpad (three.ws's own bonding curve) | Curve economics [api/_lib/native-launch/config.js](api/_lib/native-launch/config.js), curve wrapper [api/_lib/native-launch/dbc.js](api/_lib/native-launch/dbc.js), dispatcher [api/native-launch/[action].js](api/native-launch/%5Baction%5D.js) `→ /api/native-launch/{config,quote,pool,launch-prep,launch-confirm,launches}`, lane toggle in [public/studio/launch-panel.js](public/studio/launch-panel.js) | In-repo (devnet-verified; mainnet config not yet deployed) | The second launch lane beside pump.fun: a coin launch on a bonding curve three.ws configures and owns, so the platform earns a share of every trade instead of only creator fees. Runs on Meteora's audited Dynamic Bonding Curve program with three.ws as the on-chain partner — 1B supply, SOL-quoted, immutable metadata, 1% trading fee split 50/50 creator/platform, graduating at ~85 SOL raised into a DAMM v2 pool with **100% of LP permanently locked** (un-ruggable, both sides keep earning). Same custody model as the pump lane (server builds an unsigned tx, the launcher's wallet + mint keypair sign client-side, confirm verifies on-chain that the curve program actually ran before recording). The lane hides itself entirely until a partner config is pinned for that network (`NATIVE_LAUNCH_CONFIG_KEY[_DEVNET]`), so launches fall back to pump.fun rather than half-working. Not to be confused with `/api/launchpad/*` (Launchpad Studio, the page builder). Storage: [native_launches](api/_lib/migrations/20260726100000_native_launchpad.sql). Setup: [scripts/native-launchpad-create-config.mjs](scripts/native-launchpad-create-config.mjs). E2E: [scripts/native-launchpad-e2e-devnet.mjs](scripts/native-launchpad-e2e-devnet.mjs). Docs: [docs/native-launchpad.md](docs/native-launchpad.md). Tests: [tests/native-launch-curve.test.js](tests/native-launch-curve.test.js), [tests/native-launch-endpoint.test.js](tests/native-launch-endpoint.test.js) || Memetic Launcher (per-user autonomous coin launcher) | [pages/launcher.html](pages/launcher.html) `→ /launcher` + [src/user-launcher.js](src/user-launcher.js), API [api/launcher/me.js](api/launcher/me.js), engine [api/_lib/launcher-engine.js](api/_lib/launcher-engine.js) (cron [api/cron/launcher-tick.js](api/cron/launcher-tick.js)), trends [api/_lib/launcher-trends.js](api/_lib/launcher-trends.js) | In-repo | Every user designs their own autonomous pump.fun launcher: mode (trend/meme/hybrid/random), trend sources, cadence, network. Preview (default) records picks without moving SOL; **Live** mints for real, SELF-FUNDED - each launch paid by the user's own agent wallet (base ~0.022 SOL + dev buy), never master SOL, with typed go-live confirm, dev-buy + daily-SOL-cap clamps, unfunded-wallet skips (breaker-immune), and an agent-wallet funding panel with live balances. Docs: [docs/memetic-launcher.md](docs/memetic-launcher.md). Tests: [tests/user-launcher.test.js](tests/user-launcher.test.js), [tests/launcher-engine.test.js](tests/launcher-engine.test.js) || pump.fun first-claims Telegram channel (@pumpfunclaims) | Delivery lane [api/_lib/pump-claims-push.js](api/_lib/pump-claims-push.js), cron [api/cron/pump-claims-push.js](api/cron/pump-claims-push.js) (every 5 min), shared scanner [api/_lib/pump-claims.js](api/_lib/pump-claims.js) (also backs `GET /api/pump/first-claims` and the `pumpfun_first_claims` MCP tool) | In-repo · lane wired, channel dark pending `PUMPFUN_BOT_URL` + `TELEGRAM_PUMP_CLAIMS_CHAT_ID` | A live feed of first-time pump.fun creator fee claims, one message per claim: the first time a creator ever pulls accrued rewards out of the fee vault is an irreversible on-chain signal that they are engaged with their coin. Mirrors the commit-feed lane's safety properties (DB lock, seed-without-posting on first run, per-message state writes, oldest-first drain, 3h replay cutoff) but dedupes by transaction signature rather than timestamp, because claims routinely share a second and a timestamp cursor drops the second one. No fallback to the holder changelog channel on purpose. The RPC fallback inside the scanner cannot serve this feed (the pump program clears a 200-signature page in under one second, so a scan covers no useful window); an indexer is required. Docs: [docs/pump-claims-channel.md](docs/pump-claims-channel.md). Tests: [tests/pump-claims-push.test.js](tests/pump-claims-push.test.js) |diff --git a/api/_lib/launch/usecases/community.js b/api/_lib/launch/usecases/community.jsindex 678b86a41..d421764c1 100644--- a/api/_lib/launch/usecases/community.js+++ b/api/_lib/launch/usecases/community.js@@ -111,7 +111,7 @@ function communityNarrativeUseCase({ id, title, description, tags = [], params =return {name,symbol: deriveSymbol(subject, { max: 9 }),- description: `A community coin riding the “${name}” vibe — minted on three.ws as the culture surfaces across the open web.`,+ description: `A community coin riding the “${name}” vibe, minted on three.ws as the culture surfaces across the open web.`,image: null,};},@@ -127,7 +127,7 @@ export const communityUseCases = [id: 'community-ecosystem-contributors',title: 'Ecosystem contributors → reward coins',description:- 'Mint a coin for the builders carrying a whole ecosystem forward right now — the contributors whose repos are trending across GitHub. Creator fees route to each builder; they claim by linking a Solana wallet on three.ws.',+ 'Mint a coin for the builders carrying a whole ecosystem forward right now: the contributors whose repos are trending across GitHub. Creator fees route to each builder; they claim by linking a Solana wallet on three.ws.',tags: ['contributors', 'ecosystem'],params: { window: 'active', sinceDays: 30, minStars: 120 },}),@@ -143,7 +143,7 @@ export const communityUseCases = [id: 'community-open-source-builders',title: 'Open-source builders this month',description:- 'The highest-signal open-source builders by trending stars over the last 30 days — one reward coin per person, fees routed to them. Turn community appreciation into real, claimable creator fees.',+ 'The highest-signal open-source builders by trending stars over the last 30 days: one reward coin per person, fees routed to them. Turn community appreciation into real, claimable creator fees.',tags: ['builders', 'open-source'],params: { window: 'new', sinceDays: 30, minStars: 100 },}),@@ -153,7 +153,7 @@ export const communityUseCases = [id: 'community-culture-blend',title: 'Community culture, cross-sourced',description:- 'Blend what the internet’s communities are actually talking about — pulling shared themes from social, forums, search, and meme culture at once — into an original, brand-safe community coin. Identity is invented; only $THREE is ever the promoted coin.',+ 'Blend what the internet’s communities are actually talking about, pulling shared themes from social, forums, search, and meme culture at once, into an original, brand-safe community coin. Identity is invented; only $THREE is ever the promoted coin.',tags: ['blend', 'social'],params: { sources: ['reddit', 'hackernews', 'knowyourmeme', 'x'], limit: 12 },}),@@ -161,7 +161,7 @@ export const communityUseCases = [id: 'community-meme-zeitgeist',title: 'The meme zeitgeist',description:- 'The shared jokes and references a community is rallying around, cross-checked across meme culture, search interest, and the broader knowledge web. An original Title-Case identity rides the vibe — never an external ticker.',+ 'The shared jokes and references a community is rallying around, cross-checked across meme culture, search interest, and the broader knowledge web. An original Title-Case identity rides the vibe, never an external ticker.',tags: ['meme', 'zeitgeist'],params: { sources: ['knowyourmeme', 'googletrends', 'wikipedia', 'reddit'], limit: 12 },}),@@ -169,7 +169,7 @@ export const communityUseCases = [id: 'community-fandom-pulse',title: 'Fandom pulse',description:- 'Where fandoms and interest communities are converging right now — themes surfacing across forums, search trends, and the encyclopedic web, distilled into a fresh, brand-safe community coin.',+ 'Where fandoms and interest communities are converging right now: themes surfacing across forums, search trends, and the encyclopedic web, distilled into a fresh, brand-safe community coin.',tags: ['fandom', 'interest'],params: { sources: ['reddit', 'googletrends', 'wikipedia', 'trending'], limit: 12 },}),diff --git a/api/_lib/launch/usecases/culture.js b/api/_lib/launch/usecases/culture.jsindex a0c026ab4..c1d5b3d1b 100644--- a/api/_lib/launch/usecases/culture.js+++ b/api/_lib/launch/usecases/culture.js@@ -66,7 +66,7 @@ export const cultureUseCases = [cultureUseCase({id: 'culture-reddit-hot',title: 'Reddit hot culture',- description: 'What the front page is laughing at right now — the community pulse, ranked. Ride the joke before it leaves the feed.',+ description: 'What the front page is laughing at right now: the community pulse, ranked. Ride the joke before it leaves the feed.',tags: ['reddit', 'community'],sources: ['reddit'],limit: 12,@@ -82,7 +82,7 @@ export const cultureUseCases = [cultureUseCase({id: 'culture-kym-reddit-blend',title: 'Named memes meeting the front page',- description: 'Memes confirmed on Know Your Meme cross-checked against what Reddit is actually upvoting — named energy with community heat behind it.',+ description: 'Memes confirmed on Know Your Meme cross-checked against what Reddit is actually upvoting: named energy with community heat behind it.',tags: ['knowyourmeme', 'reddit', 'blend'],sources: ['knowyourmeme', 'reddit'],limit: 12,@@ -90,7 +90,7 @@ export const cultureUseCases = [cultureUseCase({id: 'culture-broad-meme-mix',title: 'The broad meme mix',- description: 'Every culture source at once — Know Your Meme, Reddit, and X blended into one ranked feed of the strongest themes across the internet.',+ description: 'Every culture source at once: Know Your Meme, Reddit, and X blended into one ranked feed of the strongest themes across the internet.',tags: ['knowyourmeme', 'reddit', 'x', 'broad'],sources: ['knowyourmeme', 'reddit', 'x'],limit: 16,@@ -98,7 +98,7 @@ export const cultureUseCases = [cultureUseCase({id: 'culture-x-reddit-breakouts',title: 'Cross-platform breakouts',- description: 'Themes spiking on both X and Reddit at the same time — the strongest signal a meme is genuinely breaking out, not just one corner of the web.',+ description: 'Themes spiking on both X and Reddit at the same time: the strongest signal a meme is genuinely breaking out, not just one corner of the web.',tags: ['x', 'reddit', 'breakout'],sources: ['x', 'reddit'],limit: 12,@@ -106,7 +106,7 @@ export const cultureUseCases = [cultureUseCase({id: 'culture-kym-x-confirmed',title: 'Confirmed and still spiking',- description: 'Memes that have a Know Your Meme entry and are still trending on X — proven format, live momentum. The sweet spot for a coin.',+ description: 'Memes that have a Know Your Meme entry and are still trending on X: proven format, live momentum. The sweet spot for a coin.',tags: ['knowyourmeme', 'x', 'confirmed'],sources: ['knowyourmeme', 'x'],limit: 12,@@ -114,7 +114,7 @@ export const cultureUseCases = [cultureUseCase({id: 'culture-reddit-deep-cuts',title: 'Reddit deep cuts',- description: 'A wider pull from Reddit for the niche jokes and emerging in-group memes that have not gone mainstream yet — early on the long tail.',+ description: 'A wider pull from Reddit for the niche jokes and emerging in-group memes that have not gone mainstream yet. Early on the long tail.',tags: ['reddit', 'niche', 'early'],sources: ['reddit'],limit: 20,@@ -122,7 +122,7 @@ export const cultureUseCases = [cultureUseCase({id: 'culture-x-rapid-fire',title: 'X rapid-fire',- description: 'A tight, fast feed of the very top X spikes — the few entities the timeline cannot stop posting. Built for launching while a moment is peaking.',+ description: 'A tight, fast feed of the very top X spikes: the few entities the timeline cannot stop posting. Built for launching while a moment is peaking.',tags: ['x', 'fast', 'peak'],sources: ['x'],limit: 6,@@ -130,7 +130,7 @@ export const cultureUseCases = [cultureUseCase({id: 'culture-everything-deep',title: 'Whole-internet deep scan',- description: 'The widest possible culture pull — Know Your Meme, Reddit, and X with a deep limit — to surface emerging themes the tighter feeds miss.',+ description: 'The widest possible culture pull (Know Your Meme, Reddit, and X with a deep limit) to surface emerging themes the tighter feeds miss.',tags: ['knowyourmeme', 'reddit', 'x', 'deep'],sources: ['knowyourmeme', 'reddit', 'x'],limit: 24,diff --git a/api/_lib/launch/usecases/events.js b/api/_lib/launch/usecases/events.jsindex 76da1c84e..97711673c 100644--- a/api/_lib/launch/usecases/events.js+++ b/api/_lib/launch/usecases/events.js@@ -67,7 +67,7 @@ export const eventsUseCases = [eventsUseCase({id: 'events-search-spikes-now',title: 'Live Google search spikes',- description: 'Real-time trending Google searches with traffic behind them — the queries spiking this minute. Mint a coin the moment a topic catches fire.',+ description: 'Real-time trending Google searches with traffic behind them: the queries spiking this minute. Mint a coin the moment a topic catches fire.',tags: ['googletrends', 'search', 'realtime'],sources: ['googletrends'],limit: 12,@@ -84,7 +84,7 @@ export const eventsUseCases = [eventsUseCase({id: 'events-tight-headliners',title: 'Today\'s headliners only',- description: 'A tight shortlist of the single biggest moments across Wikipedia and Google right now — fewer picks, every one a genuine headliner worth a coin.',+ description: 'A tight shortlist of the single biggest moments across Wikipedia and Google right now: fewer picks, every one a genuine headliner worth a coin.',tags: ['wikipedia', 'googletrends', 'curated', 'top'],sources: ['wikipedia', 'googletrends'],limit: 5,@@ -93,7 +93,7 @@ export const eventsUseCases = [eventsUseCase({id: 'events-encyclopedia-moments',title: 'Wikipedia moments, expanded',- description: 'A wider sweep of Wikipedia\'s trending pages — beyond the obvious top few into the deep cut subjects quietly surging in readership. Each minted as its own celebratory coin.',+ description: 'A wider sweep of Wikipedia\'s trending pages, beyond the obvious top few into the deep cut subjects quietly surging in readership. Each minted as its own celebratory coin.',tags: ['wikipedia', 'discovery', 'deep'],sources: ['wikipedia'],limit: 20,@@ -102,7 +102,7 @@ export const eventsUseCases = [eventsUseCase({id: 'events-breakout-searches',title: 'Breakout searches, search-first',- description: 'Google\'s freshest breakout queries leading, reinforced by Wikipedia\'s most-read pages — the fastest-moving cultural moments of the day turned into original coins.',+ description: 'Google\'s freshest breakout queries leading, reinforced by Wikipedia\'s most-read pages: the fastest-moving cultural moments of the day turned into original coins.',tags: ['googletrends', 'wikipedia', 'breakout', 'culture'],sources: ['googletrends', 'wikipedia'],limit: 14,diff --git a/api/_lib/launch/usecases/github.js b/api/_lib/launch/usecases/github.jsindex 66d6641f4..241315d86 100644--- a/api/_lib/launch/usecases/github.js+++ b/api/_lib/launch/usecases/github.js@@ -53,13 +53,13 @@ export const githubUseCases = [repoUseCase({id: 'github-trending-repos',title: 'Trending GitHub repos → reward coins',- description: 'Mint a coin for each newly trending GitHub repository. Creator fees route to the repo owner — they claim by linking a Solana wallet on three.ws.',+ description: 'Mint a coin for each newly trending GitHub repository. Creator fees route to the repo owner, who claims them by linking a Solana wallet on three.ws.',params: { window: 'new', sinceDays: 30, minStars: 100 },}),repoUseCase({id: 'github-fresh-breakouts',title: "This week's GitHub breakouts",- description: 'The freshest repos to cross a star threshold in the last 7 days — catch a project the moment it breaks out, with fees routed to its owner.',+ description: 'The freshest repos to cross a star threshold in the last 7 days: catch a project the moment it breaks out, with fees routed to its owner.',tags: ['fresh'],params: { window: 'new', sinceDays: 7, minStars: 150 },}),@@ -73,35 +73,35 @@ export const githubUseCases = [repoUseCase({id: 'github-rust-repos',title: 'Trending Rust projects',- description: 'Reward coins for the Rust ecosystem — new trending crates, tools, and runtimes, with fees to their maintainers.',+ description: 'Reward coins for the Rust ecosystem: new trending crates, tools, and runtimes, with fees to their maintainers.',tags: ['language', 'rust'],params: { window: 'new', sinceDays: 45, minStars: 80, language: 'Rust' },}),repoUseCase({id: 'github-typescript-repos',title: 'Trending TypeScript projects',- description: 'The TypeScript wave — frameworks, SDKs, and apps breaking out, each minted as a reward coin for its author.',+ description: 'The TypeScript wave: frameworks, SDKs, and apps breaking out, each minted as a reward coin for its author.',tags: ['language', 'typescript'],params: { window: 'new', sinceDays: 45, minStars: 80, language: 'TypeScript' },}),repoUseCase({id: 'github-python-repos',title: 'Trending Python projects',- description: 'Python’s trending edge — libraries, agents, and tools — with creator fees routed to the people shipping them.',+ description: 'Python’s trending edge (libraries, agents, and tools) with creator fees routed to the people shipping them.',tags: ['language', 'python'],params: { window: 'new', sinceDays: 45, minStars: 80, language: 'Python' },}),repoUseCase({id: 'github-ai-ml-repos',title: 'Trending AI / ML notebooks',- description: 'The applied-AI surface: trending Jupyter Notebook repos — models, demos, and research — minted for their creators.',+ description: 'The applied-AI surface: trending Jupyter Notebook repos (models, demos, and research) minted for their creators.',tags: ['ai', 'ml'],params: { window: 'new', sinceDays: 60, minStars: 60, language: 'Jupyter Notebook' },}),repoUseCase({id: 'github-go-repos',title: 'Trending Go projects',- description: 'Infrastructure’s favourite language — trending Go repos for tooling, databases, and networking, with fees to maintainers.',+ description: 'Infrastructure’s favourite language: trending Go repos for tooling, databases, and networking, with fees to maintainers.',tags: ['language', 'go'],params: { window: 'new', sinceDays: 45, minStars: 80, language: 'Go' },}),@@ -115,13 +115,13 @@ export const githubUseCases = [creatorUseCase({id: 'github-trending-creators',title: 'Trending GitHub creators → reward coins',- description: 'Mint a coin for each builder trending across GitHub right now. One coin per creator, fees routed to them — the $THREE → @nirholas pattern, automated.',+ description: 'Mint a coin for each builder trending across GitHub right now. One coin per creator, fees routed to them: the $THREE → @nirholas pattern, automated.',params: { window: 'new', sinceDays: 60, minStars: 80 },}),creatorUseCase({id: 'github-top-builders',title: 'Top GitHub builders this quarter',- description: 'The highest-signal creators by trending stars over the last 90 days — back the people, not just the projects.',+ description: 'The highest-signal creators by trending stars over the last 90 days. Back the people, not just the projects.',tags: ['builders'],params: { window: 'new', sinceDays: 90, minStars: 150 },}),diff --git a/api/_lib/launch/usecases/news.js b/api/_lib/launch/usecases/news.jsindex 62e0500b4..e1c4e1176 100644--- a/api/_lib/launch/usecases/news.js+++ b/api/_lib/launch/usecases/news.js@@ -62,7 +62,7 @@ export const newsUseCases = [id: 'news-hn-zeitgeist',title: 'Hacker News front-page zeitgeist',description:- 'The tech and internet conversation as it happens — invent an original coin for whatever is climbing the Hacker News front page right now. Themes only, never the source verbatim.',+ 'The tech and internet conversation as it happens: invent an original coin for whatever is climbing the Hacker News front page right now. Themes only, never the source verbatim.',tags: ['hackernews', 'tech', 'zeitgeist'],sources: ['hackernews'],limit: 12,@@ -81,7 +81,7 @@ export const newsUseCases = [id: 'news-wikipedia-top-events',title: 'Wikipedia top events',description:- 'What the world is actually reading up on — coins invented from the most-viewed Wikipedia pages of the moment. The deepest, least-noisy signal of public attention.',+ 'What the world is actually reading up on, as coins invented from the most-viewed Wikipedia pages of the moment. The deepest, least-noisy signal of public attention.',tags: ['wikipedia', 'pageviews', 'events'],sources: ['wikipedia'],limit: 12,@@ -91,7 +91,7 @@ export const newsUseCases = [id: 'news-search-and-read',title: 'Search-and-read blend',description:- 'Where what people search meets what they read — a blend of Google Trends surges and Wikipedia top pageviews, distilled into original coin names with real staying power.',+ 'Where what people search meets what they read: a blend of Google Trends surges and Wikipedia top pageviews, distilled into original coin names with real staying power.',tags: ['googletrends', 'wikipedia', 'blend'],sources: ['googletrends', 'wikipedia'],limit: 16,@@ -100,7 +100,7 @@ export const newsUseCases = [id: 'news-tech-meets-mainstream',title: 'Tech meets mainstream',description:- 'The crossover stories breaking out of the tech bubble into mass attention — Hacker News momentum blended with Google search surges, named as fresh coins.',+ 'The crossover stories breaking out of the tech bubble into mass attention: Hacker News momentum blended with Google search surges, named as fresh coins.',tags: ['hackernews', 'googletrends', 'crossover'],sources: ['hackernews', 'googletrends'],limit: 16,@@ -110,7 +110,7 @@ export const newsUseCases = [id: 'news-builder-attention',title: 'Builder attention radar',description:- 'What technical people are reading and looking up — Hacker News front-page themes paired with Wikipedia top pageviews to surface durable, builder-relevant narratives.',+ 'What technical people are reading and looking up: Hacker News front-page themes paired with Wikipedia top pageviews to surface durable, builder-relevant narratives.',tags: ['hackernews', 'wikipedia', 'builders'],sources: ['hackernews', 'wikipedia'],limit: 14,@@ -120,7 +120,7 @@ export const newsUseCases = [id: 'news-everything-trending',title: 'Everything trending right now',description:- 'The widest possible read on public attention — Hacker News, Google Trends, and Wikipedia fused into one ranked feed of invented coin names. The full pulse of the moment.',+ 'The widest possible read on public attention: Hacker News, Google Trends, and Wikipedia fused into one ranked feed of invented coin names. The full pulse of the moment.',tags: ['hackernews', 'googletrends', 'wikipedia', 'firehose'],sources: ['hackernews', 'googletrends', 'wikipedia'],limit: 24,@@ -129,7 +129,7 @@ export const newsUseCases = [id: 'news-front-page-picks',title: 'Front-page picks',description:- 'A tight, high-conviction shortlist from the broadest attention sources — the top handful of trending themes across HN, Google, and Wikipedia, each minted as an original coin.',+ 'A tight, high-conviction shortlist from the broadest attention sources: the top handful of trending themes across HN, Google, and Wikipedia, each minted as an original coin.',tags: ['hackernews', 'googletrends', 'wikipedia', 'curated'],sources: ['hackernews', 'googletrends', 'wikipedia'],limit: 8,diff --git a/api/_lib/launch/usecases/onchain.js b/api/_lib/launch/usecases/onchain.jsindex 947c356a7..2de4db44c 100644--- a/api/_lib/launch/usecases/onchain.js+++ b/api/_lib/launch/usecases/onchain.js@@ -69,7 +69,7 @@ export const onchainUseCases = [id: 'onchain-oracle-hot-sectors',title: 'Oracle hot sectors',description:- 'Rides the conviction-scored sectors the trending oracle ranks hottest right now. Each hot sector becomes a clean, invented coin — back the theme, not any one ticker.',+ 'Rides the conviction-scored sectors the trending oracle ranks hottest right now. Each hot sector becomes a clean, invented coin. Back the theme, not any one ticker.',tags: ['oracle', 'trending', 'sectors'],suffix: 'Sector',params: { sources: ['trending'], limit: 10 },@@ -86,7 +86,7 @@ export const onchainUseCases = [id: 'onchain-high-conviction-top',title: 'High-conviction top sectors',description:- 'A tight, high-conviction subset — only the five strongest oracle-ranked sectors of the moment — so each coin rides a theme with real weight behind it.',+ 'A tight, high-conviction subset (only the five strongest oracle-ranked sectors of the moment) so each coin rides a theme with real weight behind it.',tags: ['high-conviction', 'oracle', 'top5'],suffix: 'Index',params: { sources: ['trending'], limit: 5 },@@ -95,7 +95,7 @@ export const onchainUseCases = [id: 'onchain-fresh-tags',title: 'Fresh venue tags',description:- 'Mines the raw category tags attached to quality coins breaking out in the last day and turns the freshest tags into invented coins — catch a narrative as the venue starts labelling it.',+ 'Mines the raw category tags attached to quality coins breaking out in the last day and turns the freshest tags into invented coins. Catch a narrative as the venue starts labelling it.',tags: ['tags', 'coin-intel', 'fresh'],suffix: 'Tag',params: { sources: ['coin_intel'], limit: 12 },@@ -121,7 +121,7 @@ export const onchainUseCases = [id: 'onchain-wide-radar',title: 'Wide onchain radar',description:- 'A broad sweep across both venue providers with no category filter — the widest net of onchain narratives, surfacing emerging themes before they consolidate. One invented coin per theme.',+ 'A broad sweep across both venue providers with no category filter: the widest net of onchain narratives, surfacing emerging themes before they consolidate. One invented coin per theme.',tags: ['radar', 'blended', 'wide'],suffix: 'Wave',params: { sources: ['coin_intel', 'trending'], limit: 20 },diff --git a/public/launch/launch.js b/public/launch/launch.jsindex 106e87177..321971a56 100644--- a/public/launch/launch.js+++ b/public/launch/launch.js@@ -102,7 +102,7 @@ let pickerEl = null;// Parse the ?reward= deep-link value Launch Studio (and any other recipe surface)// hands to /launch. Returns a normalized routing target, or null when the param-// is absent or malformed — a bad value never blocks a launch, it just means the+// is absent or malformed. A bad value never blocks a launch, it just means the// coin routes creator fees the default way.// github:<login> | x:<handle> → a social account, resolved to its three.ws// payout wallet when the fee split is saved.diff --git a/public/studio/launch-panel.js b/public/studio/launch-panel.jsindex 8f025850b..b627693ac 100644--- a/public/studio/launch-panel.js+++ b/public/studio/launch-panel.js@@ -2358,7 +2358,14 @@ export function mountLaunchPanel(container, { getAvatar, getUser, getPreviewViewif (prefill.description) s.description = String(prefill.description).slice(0, 500);const buy = Number(prefill.initialBuy);if (isFinite(buy) && buy > 0) s.initialBuy = String(buy);- if (prefill.reward && (prefill.reward.login || prefill.reward.address)) s.rewardTarget = prefill.reward;+ if (prefill.reward && (prefill.reward.login || prefill.reward.address)) {+ s.rewardTarget = prefill.reward;+ // A coin whose fees are promised to somebody IS the 'reward' coin type:+ // a plain pump.fun launch whose creator fees are delegated as a split+ // afterwards. Leaving it on the 'agent' default would have shipped a+ // buyback-bound coin instead, which routes agent revenue, not fees.+ s.coinType = 'reward';+ }}// Pull a prefilled token image (a hosted URL from the launchpad config) into a