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
// api/play-og.js — Open Graph / preview image for /play Coin Communities.
// Renders a branded card for a coin's 3D world as a PNG. Coin-aware: pass
// ?coin=<mint> (or ?mint=) for live name / ticker / market cap and the
// deterministic biome palette that coin's world renders in.
//
// Doubles as the guaranteed <img> fallback for content platforms that block
// scripts/iframes (e.g. the AWS Builder Center editor): it is a plain image
// served from our own domain, coin-specific, no embed component required.
//
// Rendered via @vercel/og's ImageResponse through the NODE runtime (not Edge).
// The Edge runtime returns FUNCTION_INVOCATION_FAILED in this deployment, so
// we run as a plain Vercel function and bridge the Web Response → Node
// ServerResponse, the same pattern proven in api/demo/coin/og.js.
import { ImageResponse } from '@vercel/og';
import { method } from './_lib/http.js';
import { selfOrigin } from './_lib/self-origin.js';
const WIDTH = 1200;
const HEIGHT = 630;
// Biome archetypes, matched to the seeded worlds described in /play.
// Each coin's mint deterministically picks one, so the poster's palette
// matches the world the visitor actually lands in.
const BIOMES = [
{ name: 'Verdant Meadow', c1: '#16a34a', c2: '#4ade80' },
{ name: 'Dune Sea', c1: '#d97706', c2: '#fbbf24' },
{ name: 'Frostfields', c1: '#0ea5e9', c2: '#a5f3fc' },
{ name: 'Ashen Caldera', c1: '#b91c1c', c2: '#f97316' },
{ name: 'Neon Expanse', c1: '#7c3aed', c2: '#ec4899' },
{ name: 'Lagoon Shore', c1: '#0d9488', c2: '#5eead4' },
];
function seedHash(seed) {
let h = 0;
const s = String(seed || 'three');
for (let i = 0; i < s.length; i++) h = (h * 31 + s.charCodeAt(i)) >>> 0;
return h;
}
function pickBiome(mint) {
return BIOMES[seedHash(mint) % BIOMES.length];
}
function formatMarketCap(mc) {
const n = Number(mc);
if (!Number.isFinite(n) || n <= 0) return null;
if (n >= 1e9) return `$${(n / 1e9).toFixed(1)}B`;
if (n >= 1e6) return `$${(n / 1e6).toFixed(1)}M`;
if (n >= 1e3) return `$${(n / 1e3).toFixed(0)}K`;
return `$${n.toFixed(0)}`;
}
// The coin lookup is a server-side self-call, so its origin is the configured
// one (api/_lib/self-origin.js), never the client-supplied `host` or
// `x-forwarded-host`: trusting those let any caller point this fetch, and the
// image URL it feeds into the renderer, at a host of their choosing.
function originOf(req) {
return selfOrigin(req);
}
async function fetchCoin(origin, mint) {
if (!mint) return null;
try {
const ctrl = new AbortController();
const t = setTimeout(() => ctrl.abort(), 2500);
const r = await fetch(`${origin}/api/pump/coin?mint=${encodeURIComponent(mint)}`, {
signal: ctrl.signal,
headers: { accept: 'application/json' },
});
clearTimeout(t);
if (!r.ok) return null;
return await r.json();
} catch {
return null;
}
}
function card({ biome, heading, subline, ticker, image, metaChips }) {
return {
type: 'div',
props: {
style: {
width: '100%',
height: '100%',
display: 'flex',
flexDirection: 'column',
justifyContent: 'space-between',
padding: '64px 72px',
background: `radial-gradient(120% 120% at 80% 10%, ${biome.c2} 0%, ${biome.c1} 45%, #0a0a0a 100%)`,
color: 'white',
fontFamily: 'system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
},
children: [
// top row: brand + coin art
{
type: 'div',
props: {
style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between' },
children: [
{
type: 'div',
props: {
style: { fontSize: 30, fontWeight: 800, letterSpacing: -1, opacity: 0.95 },
children: 'three.ws · /play',
},
},
image
? {
type: 'img',
props: {
src: image,
width: 96,
height: 96,
style: { borderRadius: 96, border: '3px solid rgba(255,255,255,0.85)' },
},
}
: { type: 'div', props: { children: '' } },
],
},
},
// middle: heading + name
{
type: 'div',
props: {
style: { display: 'flex', flexDirection: 'column' },
children: [
{
type: 'div',
props: {
style: { fontSize: 84, fontWeight: 900, letterSpacing: -3, lineHeight: 1.0 },
children: heading,
},
},
{
type: 'div',
props: {
style: { fontSize: 34, marginTop: 14, opacity: 0.92, fontWeight: 600 },
children: subline,
},
},
],
},
},
// bottom: chips
{
type: 'div',
props: {
style: { display: 'flex', gap: 16 },
children: metaChips.map((chip) => ({
type: 'div',
props: {
style: {
fontSize: 26,
fontWeight: 700,
padding: '12px 22px',
borderRadius: 999,
background: 'rgba(0,0,0,0.35)',
border: '1px solid rgba(255,255,255,0.25)',
},
children: chip.label,
},
})),
},
},
],
},
};
}
function imageResponse(node) {
return new ImageResponse(node, {
width: WIDTH,
height: HEIGHT,
headers: { 'cache-control': 'public, max-age=300, s-maxage=600, stale-while-revalidate=86400' },
});
}
// Web Response (from @vercel/og) → Node ServerResponse. Headers first, then body.
async function sendImage(res, response) {
for (const [key, value] of response.headers.entries()) res.setHeader(key, value);
const ab = await response.arrayBuffer();
res.statusCode = response.status;
res.end(Buffer.from(ab));
}
export default async function handler(req, res) {
if (req.method === 'OPTIONS') {
res.setHeader('access-control-allow-origin', '*');
res.setHeader('access-control-allow-methods', 'GET,OPTIONS');
res.statusCode = 204;
res.end();
return;
}
// A share card is a GET surface. Without this gate any verb (POST, DELETE)
// drove a full satori render, so an unthrottled write-shaped request could
// burn image-render CPU on a route that never accepts writes.
if (!method(req, res, ['GET'])) return;
const url = new URL(req.url, 'http://x');
const origin = originOf(req);
const mint = url.searchParams.get('coin') || url.searchParams.get('mint') || '';
const biome = pickBiome(mint);
try {
const coin = await fetchCoin(origin, mint);
const ticker = coin?.symbol ? `$${String(coin.symbol).replace(/^\$/, '')}` : null;
const name = coin?.name || (mint ? 'this coin' : 'any coin');
// /api/pump/coin returns the raw pump.fun body — match the same field
// fallbacks the in-world client uses (coincommunities.js) so the share card
// actually populates instead of always rendering the blank/zero state.
const mcap = formatMarketCap(
coin?.usd_market_cap || coin?.market_cap_usd || coin?.market_cap || coin?.marketCap || 0,
);
const image = coin?.image_uri || coin?.image || coin?.imageUri || null;
const heading = ticker ? `Walk into ${ticker}` : 'Walk into any coin';
const subline = ticker ? name : 'Turn any pump.fun coin into a live 3D world';
const metaChips = [
{ label: biome.name },
mcap ? { label: `MCAP ${mcap}` } : null,
{ label: 'Live 3D world' },
].filter(Boolean);
await sendImage(res, imageResponse(card({ biome, heading, subline, ticker, image, metaChips })));
} catch (err) {
// Never fail open to a broken-image grey box — render the coin-agnostic
// brand card so the share preview still looks intentional.
console.error('[play-og] render failed:', err?.message || err);
const fallback = card({
biome,
heading: 'Walk into any coin',
subline: 'Turn any pump.fun coin into a live 3D world',
ticker: null,
image: null,
metaChips: [{ label: biome.name }, { label: 'Live 3D world' }],
});
res.statusCode = 200;
await sendImage(res, imageResponse(fallback));
}
}