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
// `three_balance` — read the $THREE and SOL balance of a wallet. Defaults to
// the configured signer's address when no pubkey is supplied. Read-only.
import { z } from 'zod';
import { getSolBalance, getSplBalance, isValidPubkey, loadSigner } from '../lib/solana.js';
import { resolveMint } from '../lib/token.js';
export const def = {
name: 'three_balance',
title: "Read a wallet's $THREE + SOL balance",
// MCP ToolAnnotations — safety hints surfaced to MCP clients.
annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true },
description:
'Return the $THREE and SOL balance for a Solana pubkey. If no pubkey is given, uses the configured signer (SOLANA_SECRET_KEY). Read-only, no payment. Use this to check holdings before a three_burn or to confirm a wallet holds $THREE.',
inputSchema: {
pubkey: z
.string()
.min(32)
.max(64)
.optional()
.describe("Base58 pubkey to read. Defaults to the configured signer's address."),
},
async handler(args) {
const { pubkey } = args || {};
// loadSigner() throws a clear `no_signer` error if neither a pubkey nor a
// configured secret is available.
const owner = pubkey || loadSigner().publicKey.toBase58();
if (!isValidPubkey(owner)) {
return { ok: false, error: 'invalid_pubkey' };
}
const token = await resolveMint();
const [sol, three] = await Promise.all([
getSolBalance(owner),
getSplBalance(owner, token.mint),
]);
return {
ok: true,
pubkey: owner,
symbol: token.symbol,
three: {
mint: token.mint,
amount: three.uiAmount,
atomics: three.atomics,
decimals: three.decimals || token.decimals,
},
sol: sol.sol,
lamports: sol.lamports,
explorer: `https://solscan.io/account/${owner}`,
fetchedAt: new Date().toISOString(),
};
},
};