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.

13.0 KB
Raw Blame
/**
 * /character/:id — consumer-facing character profile page
 *
 * Fetches /api/agents/:id (public GET) and renders a charms-style page:
 *   hero avatar, name, creator, stats (chats + holders), description,
 *   chat CTA, token card with price/trade, and memes gallery.
 */

import { onchainBadgeEl } from './shared/onchain-badge.js';
import { walletChipEl } from './shared/agent-wallet-chip.js';
import { hydrateAvatarWallet } from './shared/wallet-aura.js';
import './ui-juice.css';
import { countUp } from './ui-juice.js';
import { fetchFirstOrNull } from './shared/failover-fetch.js';
import { gmgnTokenUrl, dextoolsTokenUrl } from './shared/trading-terminals.js';
import { escapeHtml } from './shared/coin-format.js';
import { safeUrl } from './safe-url.js';

let chNetWorthAura = null;

const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;

function $(id) { return document.getElementById(id); }

function formatNum(n) {
	if (n == null) return '0';
	if (n >= 1_000_000) return (n / 1_000_000).toFixed(1).replace(/\.0$/, '') + 'M';
	if (n >= 1_000) return (n / 1_000).toFixed(1).replace(/\.0$/, '') + 'K';
	return String(n);
}

function formatUsd(n) {
	if (n == null) return '$0';
	if (n >= 1_000_000) return '$' + (n / 1_000_000).toFixed(2) + 'M';
	if (n >= 1_000) return '$' + (n / 1_000).toFixed(1).replace(/\.0$/, '') + 'K';
	return '$' + Number(n).toFixed(2);
}

function avatarPlaceholder(name) {
	const letter = (name || '?')[0].toUpperCase();
	const hue = [...(name || 'X')].reduce((acc, c) => acc + c.charCodeAt(0), 0) % 360;
	return { letter, color: `hsl(${hue}, 55%, 45%)` };
}

function agentId() {
	const parts = location.pathname.split('/').filter(Boolean);
	return parts[1] || null;
}

async function fetchAgent(id) {
	const res = await fetch(`/api/agents/${encodeURIComponent(id)}`);
	if (!res.ok) throw Object.assign(new Error('not found'), { status: res.status });
	const json = await res.json();
	return json.agent;
}

function renderHero(agent) {
	// Avatar
	const avatarImg = $('ch-avatar-img');
	const avatarPH = $('ch-avatar-ph');
	const imageUrl =
		agent.meta?.profile_image_url ||
		agent.avatar_thumbnail_url ||
		agent.meta?.thumbnail_url ||
		agent.meta?.avatar_url ||
		null;

	if (imageUrl) {
		avatarImg.src = imageUrl;
		avatarImg.alt = agent.name;
		avatarImg.style.display = 'block';
		avatarPH.style.display = 'none';
		avatarImg.onerror = () => {
			avatarImg.style.display = 'none';
			showPlaceholder(agent, avatarPH);
		};
	} else {
		avatarImg.style.display = 'none';
		showPlaceholder(agent, avatarPH);
	}

	// Net-Worth-Reactive Avatar: weld the agent's real wallet to its hero portrait
	// so its funded-ness reads identically here, on the 3D viewer, and the galaxy.
	const avatarWrap = $('ch-avatar-wrap');
	if (avatarWrap && agent.id && !chNetWorthAura) {
		hydrateAvatarWallet(avatarWrap, agent, { lod: 'card', live: true, network: 'mainnet' })
			.then((c) => { chNetWorthAura = c; })
			.catch(() => { /* dormant baseline already shown */ });
	}

	// Name
	const nameEl = $('ch-name');
	nameEl.textContent = agent.name || 'Unnamed';
	document.title = `${agent.name || 'Character'} · three.ws`;

	// On-chain badge — surfaces below the name when this character is deployed.
	document.getElementById('ch-onchain-badge')?.remove();
	const onchainBadge = onchainBadgeEl(agent, { size: 'md' });
	if (onchainBadge) {
		onchainBadge.id = 'ch-onchain-badge';
		onchainBadge.style.marginTop = '8px';
		nameEl.insertAdjacentElement('afterend', onchainBadge);
	}

	// Wallet identity — the SAME shared chip rendered on the profile, marketplace,
	// galaxy and dashboard, so this consumer page shows the agent's custodial wallet
	// (address, copy, Solscan, vanity tier) consistently. The owner additionally
	// gets the vanity entry point; everyone else gets a Tip action.
	document.getElementById('ch-wallet-chip')?.remove();
	const walletChip = walletChipEl(agent, { isOwner: !!agent.is_owner });
	if (walletChip) {
		walletChip.id = 'ch-wallet-chip';
		walletChip.style.marginTop = '8px';
		(document.getElementById('ch-onchain-badge') || nameEl).insertAdjacentElement('afterend', walletChip);
	}

	// Creator
	const authorName = agent.author_name || 'Unknown';
	const authorAvatar = agent.author_avatar || null;
	const creatorEl = $('ch-creator');

	if (authorAvatar) {
		const img = document.createElement('img');
		img.src = authorAvatar;
		img.className = 'ch-creator-avatar';
		img.alt = authorName;
		img.onerror = () => img.remove();
		creatorEl.appendChild(img);
	}

	const byText = document.createElement('span');
	byText.textContent = 'by ';
	creatorEl.appendChild(byText);

	const handle = document.createElement('span');
	handle.textContent = '@' + (authorName.toLowerCase().replace(/\s+/g, ''));
	creatorEl.appendChild(handle);

	// Stats — count up from 0 to the real values, keeping the K/M formatting.
	countUp($('ch-stat-chats'), 0, Number(agent.chat_count ?? 0), { format: formatNum });
	const holders = agent.token?.holders ?? agent.meta?.token?.holders ?? 0;
	countUp($('ch-stat-holders'), 0, Number(holders), { format: formatNum });

	// Description
	$('ch-desc').textContent = agent.description || '';

	// Chat button
	const chatBtn = $('ch-chat-btn');
	chatBtn.href = `/agents/${agent.id}`;
}

function showPlaceholder(agent, el) {
	const { letter, color } = avatarPlaceholder(agent.name);
	el.textContent = letter;
	el.style.background = color;
	el.style.display = 'flex';
}

// Live market stats from three keyless, CORS-enabled sources, tried in order.
// DexScreener leads because it's the only one with a 24h price change; the
// fallbacks fill price/mcap/volume so the token card still renders live data
// when DexScreener is down or rate-limiting.
async function fetchDexScreener(mint) {
	const m = encodeURIComponent(mint);
	return fetchFirstOrNull([
		{
			name: 'dexscreener',
			url: `https://api.dexscreener.com/latest/dex/tokens/${m}`,
			parse: async (res) => {
				const pairs = ((await res.json())?.pairs || []).filter(p => p.chainId === 'solana');
				if (!pairs.length) return null;
				// Pick highest-liquidity pair
				pairs.sort((a, b) => (b.liquidity?.usd ?? 0) - (a.liquidity?.usd ?? 0));
				const p = pairs[0];
				return {
					priceUsd: parseFloat(p.priceUsd) || null,
					marketCapUsd: p.marketCap ?? null,
					change24h: p.priceChange?.h24 ?? null,
					volume24h: p.volume?.h24 ?? null,
					liquidity: p.liquidity?.usd ?? null,
					dexUrl: p.url ?? `https://dexscreener.com/solana/${mint}`,
				};
			},
		},
		{
			name: 'geckoterminal',
			url: `https://api.geckoterminal.com/api/v2/networks/solana/tokens/${m}`,
			parse: async (res) => {
				const a = (await res.json())?.data?.attributes;
				if (!a) return null;
				return {
					priceUsd: parseFloat(a.price_usd) || null,
					marketCapUsd: a.market_cap_usd != null ? Number(a.market_cap_usd) : (a.fdv_usd != null ? Number(a.fdv_usd) : null),
					change24h: null,
					volume24h: a.volume_usd?.h24 != null ? Number(a.volume_usd.h24) : null,
					liquidity: a.total_reserve_in_usd != null ? Number(a.total_reserve_in_usd) : null,
					dexUrl: `https://dexscreener.com/solana/${mint}`,
				};
			},
		},
		{
			name: 'jupiter',
			url: `https://lite-api.jup.ag/tokens/v2/search?query=${m}`,
			parse: async (res) => {
				const t = (await res.json())?.[0];
				if (!t || (t.id || t.address) !== mint) return null;
				return {
					priceUsd: Number(t.usdPrice) || null,
					marketCapUsd: t.mcap != null ? Number(t.mcap) : (t.fdv != null ? Number(t.fdv) : null),
					change24h: t.stats24h?.priceChange != null ? Number(t.stats24h.priceChange) : null,
					volume24h: null,
					liquidity: t.liquidity != null ? Number(t.liquidity) : null,
					dexUrl: `https://dexscreener.com/solana/${mint}`,
				};
			},
		},
	], { timeoutMs: 6000, label: 'token-market' });
}

function buildTokenHtml(symbol, mint, marketCapUsd, priceUsd, change24h, holders, volume24h) {
	const displayPrice = marketCapUsd != null
		? formatUsd(marketCapUsd)
		: priceUsd != null
		? formatUsd(priceUsd)
		: '—';

	const priceLabel = marketCapUsd != null ? 'MCAP' : 'PRICE';

	let changeHtml = '';
	if (change24h != null) {
		const sign = change24h >= 0 ? '+' : '';
		const cls = change24h >= 0 ? 'up' : 'down';
		const arrow = change24h >= 0 ? '▲' : '▼';
		changeHtml = `<span class="ch-price-change ${cls}">${arrow} ${sign}${Number(change24h).toFixed(2)}%</span>`;
	}

	const tradeUrl = mint ? gmgnTokenUrl(mint) : '#';
	const chartUrl = mint ? dextoolsTokenUrl(mint, { from: 'character' }) : '#';

	const metaItems = [];
	if (holders) metaItems.push({ label: 'Holders', val: formatNum(holders) });
	if (volume24h) metaItems.push({ label: '24h Vol', val: formatUsd(volume24h) });
	if (symbol) metaItems.push({ label: 'Symbol', val: '$' + symbol });

	const metaHtml = metaItems.map(m =>
		`<div class="ch-token-meta-item">
			<span class="ch-token-meta-label">${m.label}</span>
			<span class="ch-token-meta-val">${escapeHtml(m.val)}</span>
		</div>`
	).join('');

	return `
		<div class="ch-token-header">
			<span class="ch-token-name">${escapeHtml(symbol)}</span>
			<span class="ch-token-dot"></span>
		</div>
		<div class="ch-token-price">
			<span class="ch-price-main">${displayPrice}</span>
			${changeHtml}
			<span style="font-size:11px;color:#9ca3af;font-weight:500;margin-left:2px">${priceLabel}</span>
		</div>
		<div class="ch-token-actions">
			<a class="ch-trade-btn" href="${tradeUrl}" target="_blank" rel="noopener">Trade</a>
			<a class="ch-chart-btn" href="${chartUrl}" target="_blank" rel="noopener" title="View chart on DEXTools" aria-label="View chart on DEXTools">
				<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
					<path d="M3 3v18h18"/>
					<path d="M18.5 8L13 13.5 8.5 10 3 15"/>
				</svg>
			</a>
		</div>
		${metaItems.length ? `<div class="ch-token-meta">${metaHtml}</div>` : ''}
	`;
}

async function renderToken(agent) {
	const tokenSection = $('ch-token-section');
	const token = agent.token || agent.meta?.token || null;

	if (!token) {
		tokenSection.innerHTML = '<p class="ch-no-token">No token linked yet.</p>';
		return;
	}

	const symbol = token.symbol || token.name || 'TOKEN';
	const mint = token.mint || token.contract_address || token.contractAddress || null;

	// Render immediately from stored data
	let priceUsd = token.price_usd ?? token.priceUsd ?? null;
	let marketCapUsd = token.market_cap_usd ?? token.marketCapUsd ?? token.usd_market_cap ?? null;
	let change24h = token.change_24h_percent ?? token.change24hPercent ?? null;
	let holders = token.holders ?? 0;
	let volume24h = token.volume_24h_usd ?? token.volume24hUsd ?? null;

	tokenSection.innerHTML = buildTokenHtml(symbol, mint, marketCapUsd, priceUsd, change24h, holders, volume24h);

	// Fetch live market data from DexScreener and update card
	if (mint) {
		fetchDexScreener(mint).then(live => {
			if (!live) return;
			tokenSection.innerHTML = buildTokenHtml(
				symbol, mint,
				live.marketCapUsd ?? marketCapUsd,
				live.priceUsd ?? priceUsd,
				live.change24h ?? change24h,
				holders,
				live.volume24h ?? volume24h,
			);
		}).catch(() => { /* DexScreener unavailable — static data already rendered */ });
	}
}

function renderMemes(agent) {
	const grid = $('ch-memes-grid');
	const memes = Array.isArray(agent.meta?.memes) ? agent.meta.memes : [];

	const createCard = `
		<a class="ch-meme-create" href="/agents/${encodeURIComponent(agent.id)}?meme=1" title="Create meme">
			<div class="ch-meme-create-icon">
				<img loading="lazy" decoding="async" src="${escapeHtml(safeUrl(agent.meta?.profile_image_url || agent.avatar_thumbnail_url, ''))}"
				     data-fallback="hide"
				     alt="${escapeHtml(agent.name)}" />
			</div>
			<span class="ch-meme-create-label">Create Meme</span>
		</a>
	`;

	if (!memes.length) {
		grid.innerHTML = createCard + '<div class="ch-memes-empty">No memes yet. Be first!</div>';
		return;
	}

	const memeCards = memes.slice(0, 5).map(m => `
		<div class="ch-meme-item">
			<img src="${escapeHtml(safeUrl(m?.image_url, ''))}" alt="meme" loading="lazy" />
			${m?.creator ? `<div class="ch-meme-author">${escapeHtml(m.creator)}</div>` : ''}
		</div>
	`).join('');

	grid.innerHTML = createCard + memeCards;
}

function showError(msg) {
	const shell = document.querySelector('.ch-shell');
	if (shell) {
		shell.innerHTML = `
			<div class="ch-error">
				<h2>Character not found</h2>
				<p>${msg || 'This character does not exist or has been removed.'}</p>
				<br>
				<a href="/" class="ch-btn-primary" style="display:inline-block;margin-top:8px">Go home</a>
			</div>
		`;
	}
}

async function init() {
	const id = agentId();
	if (!id || !UUID_RE.test(id)) {
		showError('Invalid character ID.');
		return;
	}

	let agent;
	try {
		agent = await fetchAgent(id);
	} catch (e) {
		showError(e.status === 404 ? 'Character not found.' : 'Failed to load. Please try again.');
		return;
	}

	document.querySelector('.ch-shell')?.classList.remove('ch-loading');

	renderHero(agent);
	renderToken(agent); // async — DexScreener fetch updates card in background
	renderMemes(agent);
}

window.addEventListener('pagehide', () => { chNetWorthAura?.destroy?.(); chNetWorthAura = null; }, { once: true });

init();