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
/**
* Oracle: full intel for one coin.
*
* GET /api/oracle/coin?mint=<mint>&network=mainnet
*
* Returns the fused conviction verdict (lazy-scored with a fresh narrative read
* on a cache miss), the transparent pillar reasons, the narrative classification,
* the ground-truth outcome if known, and the live "who's in" trader breakdown:
* every early wallet labeled by its data-brain archetype + track record. This is
* the trader-classification surface the product is built around.
*/
import { cors, json, method, wrap, error, rateLimited } from '../_lib/http.js';
import { limits, clientIp } from '../_lib/rate-limit.js';
import { readCoin, scoreCoin } from '../_lib/oracle/store.js';
const NETWORKS = new Set(['mainnet', 'devnet']);
const MINT_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
export default wrap(async (req, res) => {
if (cors(req, res, { methods: 'GET,OPTIONS', origins: '*' })) return;
if (!method(req, res, ['GET'])) return;
const rl = await limits.mcpIp(clientIp(req));
if (!rl.success) return rateLimited(res, rl);
const url = new URL(req.url, `http://${req.headers.host || 'x'}`);
const mint = (url.searchParams.get('mint') || '').trim();
const network = NETWORKS.has(url.searchParams.get('network')) ? url.searchParams.get('network') : 'mainnet';
if (!MINT_RE.test(mint)) return error(res, 400, 'validation_error', 'a valid base58 mint is required');
let coin = await safeReadCoin(mint, network);
// Cache miss (no verdict yet) → score it now, with a real narrative read.
if (!coin || !coin.conviction) {
let scored;
try {
scored = await scoreCoin(mint, { network, classify: true, persist: true });
} catch {
// Scoring threw: the intel store / DB is degraded, NOT "coin unknown".
// A 404 here would let clients and the CDN cache a transient outage as an
// authoritative "this mint doesn't exist". Surface 503 so callers retry.
return error(res, 503, 'scoring_unavailable', 'coin scoring is temporarily unavailable, retry shortly');
}
if (!scored) {
// Clean empty result: the coin is genuinely unknown to the data brain.
// This is a stable, idempotent fact (coins are ingested by the always-on
// observer, never inline here), so cache the negative answer briefly at the
// CDN. The always-on polling surfaces (coin page, oracle UI) would otherwise
// re-spin this function and re-run assembleIntel on every poll for a mint the
// brain has never seen. One such mint produced hundreds of redundant
// invocations. The window is short enough that a coin becoming known surfaces
// within seconds.
return json(res, 404, { error: 'not_found', error_description: 'this mint has not been observed yet', mint, network }, {
'cache-control': 'public, max-age=15, s-maxage=30, stale-while-revalidate=60',
});
}
coin = await safeReadCoin(mint, network);
// Scoring succeeded but the warm re-read came back empty (read-path blip), so
// don't return a hollow 200; treat it as transient.
if (!coin) return error(res, 503, 'scoring_unavailable', 'coin scoring is temporarily unavailable, retry shortly');
}
return json(res, 200, { network, mint, ...coin }, {
'Cache-Control': 'public, max-age=5, stale-while-revalidate=30',
});
});
async function safeReadCoin(mint, network) {
try { return await readCoin(mint, network); } catch { return null; }
}