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
// 3D funder graph for the coin intel drawer. Wallets are GPU-instanced spheres
// sized by net SOL; wallets that share a SOL funder link to a funder node.
// The engine under src/vendor/swarming is lazy-loaded by the caller.
import { ForceSimulation } from './vendor/swarming/ForceSimulation.js';
import { ThreeRenderer } from './vendor/swarming/ThreeRenderer.js';
const CLUSTER_PALETTE = ['#f87171', '#fb923c', '#22d3ee', '#a78bfa', '#f472b6', '#a3e635', '#38bdf8', '#fb7185'];
const INDEPENDENT = '#5b6478';
const CREATOR = '#fbbf24';
const MAX_LIVE_NODES = 600;
export const clusterColor = (i) => CLUSTER_PALETTE[Math.abs(Number(i) || 0) % CLUSTER_PALETTE.length];
const shortAddr = (a) => (a && a.length > 10 ? `${a.slice(0, 4)}…${a.slice(-4)}` : a || '');
const fmtSol = (n) => `${(Number(n) || 0).toFixed(Math.abs(n) >= 100 ? 0 : 2)} SOL`;
export function buildGraph(wallets, clusters = []) {
const holders = wallets.filter((w) => (w.net_sol || 0) > 0);
const maxNet = Math.max(1e-9, ...holders.map((w) => w.net_sol));
const radiusOf = (net) => 0.9 + Math.sqrt(Math.max(0, net) / maxNet) * 3.4;
const nodes = [];
const edges = [];
const seenClusters = new Set();
for (const w of holders) {
const hasCluster = w.cluster != null;
const color = w.is_creator ? CREATOR : hasCluster ? clusterColor(w.cluster) : INDEPENDENT;
const funderId = hasCluster ? `funder:${w.cluster}` : null;
nodes.push({
id: w.wallet,
kind: 'wallet',
radius: radiusOf(w.net_sol),
color,
net_sol: w.net_sol,
is_creator: !!w.is_creator,
labels: w.labels || [],
cluster: hasCluster ? w.cluster : null,
anchorId: funderId,
});
if (hasCluster) seenClusters.add(w.cluster);
}
const info = new Map(clusters.map((c) => [c.cluster, c]));
const funders = [...seenClusters].map((id) => ({
id: `funder:${id}`,
kind: 'funder',
radius: 1.1,
color: clusterColor(id),
cluster: id,
wallets: info.get(id)?.wallets ?? holders.filter((w) => w.cluster === id).length,
net_sol: info.get(id)?.net_sol ?? 0,
}));
for (const w of nodes) {
if (w.cluster != null) edges.push({ source: `funder:${w.cluster}`, target: w.id, color: clusterColor(w.cluster) });
}
return { nodes: [...funders, ...nodes], edges, radiusOf, maxNet };
}
export function mountFunderGraph(container, { wallets, clusters, mint, reducedMotion = false, onError } = {}) {
const graph = buildGraph(wallets || [], clusters || []);
container.classList.add('fg3d');
const tip = document.createElement('div');
tip.className = 'fg3d-tip';
tip.hidden = true;
tip.setAttribute('role', 'status');
container.appendChild(tip);
const onHover = (node, x, y) => {
if (!node) { tip.hidden = true; return; }
tip.textContent = node.kind === 'funder'
? `Shared funder · ${node.wallets} wallets${node.net_sol ? ` · ${fmtSol(node.net_sol)}` : ''}`
: `${shortAddr(node.id)}${node.is_creator ? ' (creator)' : ''} · net ${fmtSol(node.net_sol)}${node.labels?.length ? ` · ${node.labels.join(', ')}` : ''}`;
tip.hidden = false;
const pad = 8;
const w = tip.offsetWidth;
tip.style.left = `${Math.max(pad, Math.min(container.clientWidth - w - pad, x + 12))}px`;
tip.style.top = `${Math.max(pad, y - 34)}px`;
};
let renderer;
try {
renderer = new ThreeRenderer(container, { autoRotate: !reducedMotion, onHover, onContextLost: () => onError?.(new Error('webgl_context_lost')) });
} catch (err) {
tip.remove();
throw err;
}
renderer.renderer.domElement.setAttribute(
'aria-label',
`3D wallet network: ${graph.nodes.filter((n) => n.kind === 'wallet').length} wallets, ${graph.nodes.filter((n) => n.kind === 'funder').length} shared-funder clusters. Drag to rotate, scroll or plus and minus to zoom. The order book below lists the same wallets.`,
);
const sim = new ForceSimulation();
sim.update(graph.nodes, graph.edges);
renderer.setData(sim.nodes, sim.edges);
if (reducedMotion) {
sim.settle();
renderer.fit();
} else {
let fitted = false;
renderer.start(() => {
if (sim.alpha > 0.001) sim.tick();
else if (!fitted) { fitted = true; renderer.fit(); }
});
}
// ── live mode: trades-stream applies buys/sells to wallet nodes ─────────
let es = null;
let liveStatus = 'off';
let statusCb = () => {};
const setStatus = (s) => { liveStatus = s; statusCb(s); };
const radiusFor = (net) => 0.9 + Math.sqrt(net / Math.max(graph.maxNet, net)) * 3.4;
const applyTrade = (side, d) => {
const trader = d && (d.trader || d.traderPublicKey);
const amt = Number(d && (d.solAmount ?? d.sol_amount));
if (!trader || !Number.isFinite(amt)) return;
const existing = sim.nodeMap.get(trader);
const delta = side === 'sell' ? -amt : amt;
if (existing) {
if (existing.kind !== 'wallet') return;
const net = Math.max(0, (existing.net_sol || 0) + delta);
sim.update([{ id: trader, net_sol: net, radius: radiusFor(net), color: existing.color }]);
} else if (delta > 0 && sim.nodes.length < MAX_LIVE_NODES) {
sim.update([{ id: trader, kind: 'wallet', radius: radiusFor(delta), color: INDEPENDENT, net_sol: delta, labels: ['live'], cluster: null }]);
renderer.setData(sim.nodes, sim.edges);
}
if (reducedMotion) { sim.settle(60); renderer.requestRender(); }
};
const connect = () => {
if (!mint) return;
es = new EventSource(`/api/pump/trades-stream?mint=${encodeURIComponent(mint)}`);
es.addEventListener('open', () => setStatus('live'));
const handler = (side) => (e) => { try { applyTrade(side, JSON.parse(e.data)); setStatus('live'); } catch { /* malformed frame */ } };
es.addEventListener('buy', handler('buy'));
es.addEventListener('sell', handler('sell'));
es.addEventListener('notice', () => setStatus('degraded'));
es.addEventListener('close', () => { es?.close(); if (liveStatus !== 'off') setTimeout(connect, 600); });
es.onerror = () => { setStatus('connecting'); es?.close(); if (liveStatus !== 'off') setTimeout(connect, 2500); };
};
return {
get nodeCount() { return sim.nodes.length; },
renderer,
sim,
setLive(on, cb) {
statusCb = cb || statusCb;
if (on) { setStatus('connecting'); connect(); }
else { setStatus('off'); es?.close(); es = null; }
},
destroy() {
liveStatus = 'off';
es?.close();
sim.dispose();
renderer.dispose();
tip.remove();
container.classList.remove('fg3d');
},
};
}