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
// GET /api/crypto/security: free, keyless token safety / rug-signal check.
//
// Agent use-case: before an agent buys or LPs into a token, it needs a fast
// "is this a honeypot / rug?" read: mint & freeze authority, holder
// concentration, liquidity depth, metadata mutability, LP custody. This is the
// single most-requested pre-trade check in crypto agent workflows; one keyless
// GET answers it with on-chain FACTS and a documented, deterministic riskLevel,
// never an LLM opinion, never a guessed "safe".
//
// Part of the free Crypto Data API (/api/crypto/*). Plain-handler pattern: no
// account, no key, generous per-IP limit. Real data only, from Solana RPC (failover
// chain), DexScreener, pump.fun public records, Metaplex metadata. Solana-only
// by design: the checks (SPL authorities, getTokenLargestAccounts) are Solana
// concepts; an EVM address gets an honest 400, not a half-built passthrough.
//
// Query:
// address = <Solana mint> (required)
// chain = solana (optional; only 'solana'/'sol' accepted)
//
// Response: { address, chain, checks: { mintAuthorityRevoked,
// freezeAuthorityRevoked, metadataMutable, lpBurnedOrLocked, liquidityUsd,
// topHolderPctFlag }, riskLevel: low|medium|high|unknown, reasons[], ts,
// sources[] }. Unknowns are null/'unknown', never guessed.
import { cors, method, wrap, error, json, rateLimited } from '../_lib/http.js';
import { limits, clientIp } from '../_lib/rate-limit.js';
import { isValidSolanaAddress, isValidEvmAddress } from '../_lib/validate.js';
import { composeTokenSecurity } from '../_lib/crypto-token-security.js';
const EXAMPLE = '/api/crypto/security?address=FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump';
export default wrap(async (req, res) => {
if (cors(req, res, { origins: '*', methods: 'GET,OPTIONS' })) return;
if (!method(req, res, ['GET'])) return;
const ip = clientIp(req);
const [ipRl, globalRl] = await Promise.all([limits.cryptoDataIp(ip), limits.cryptoDataGlobal()]);
if (!ipRl.success) return rateLimited(res, ipRl);
if (!globalRl.success) return rateLimited(res, globalRl);
const url = new URL(req.url, 'http://localhost');
const address = (url.searchParams.get('address') || '').trim();
const rawChain = (url.searchParams.get('chain') || '').trim().toLowerCase();
if (!address) {
return error(res, 400, 'missing_address', 'query param `address` is required. Pass a Solana token mint', {
example: EXAMPLE,
});
}
// EVM is a deliberate, honest 400 (matches the v1 security reader): SPL
// mint/freeze authorities and getTokenLargestAccounts have no EVM equivalent
// here, and a half-answered EVM check would read as a fake "safe".
if (isValidEvmAddress(address) || (rawChain && rawChain !== 'solana' && rawChain !== 'sol')) {
return error(res, 400, 'unsupported_chain', 'this endpoint checks Solana tokens only. Pass a base58 Solana mint address', {
example: EXAMPLE,
});
}
if (!isValidSolanaAddress(address)) {
return error(res, 400, 'invalid_address', '`address` must be a base58 Solana mint address (32-44 chars)', {
address,
example: EXAMPLE,
});
}
const result = await composeTokenSecurity({ address });
const ts = new Date().toISOString();
// Valid mint shape, but neither the chain nor any market/pump source knows it:
// client input, matching the bundle's /token and /bonding conventions.
if (result.status === 'not_found') {
return error(res, 400, 'token_not_found', `${address} is not a token any live source can resolve. Check the mint, or discover live tokens at /api/crypto/trending`, {
address,
});
}
// Every source unreachable: never 500, and never a fabricated verdict; 503 +
// Retry-After so the agent backs off and retries.
if (result.status === 'upstream_down') {
return json(res, 503, {
error: 'upstream_unavailable',
error_description: 'security data sources are temporarily unreachable, retry shortly; no verdict is fabricated while sources are down',
address,
retry_after: 15,
ts,
}, { 'cache-control': 'no-store', 'retry-after': '15' });
}
// Authorities/holders move rarely; 60s edge cache absorbs polling agents
// without staleness that matters for a pre-trade check.
return json(res, 200, {
address,
chain: 'solana',
checks: result.checks,
riskLevel: result.riskLevel,
reasons: result.reasons,
ts,
sources: result.sources,
}, { 'cache-control': 'public, s-maxage=60, stale-while-revalidate=30' });
});