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
/**
* DeFi input validation — EVM address + amount checks ported verbatim from the
* SperaxOS `defi-utils`, extended with Solana base58 address validation and
* EVM/Solana discriminators. `validateAddress`/`validateAmount` return a
* human-readable error string or `null` (null = valid) so callers can surface
* the message straight to a user; the `is*` helpers return booleans.
*/
import bs58 from 'bs58';
/**
* Validate an Ethereum address format. Returns an error message, or `null` when
* the address is well-formed (`0x` + 40 hex chars, any case).
* @param {string} address
* @returns {string | null}
*/
export function validateAddress(address) {
if (!address || !/^0x[\da-f]{40}$/i.test(address)) {
return 'Invalid wallet address. Expected format: 0x followed by 40 hex characters.';
}
return null;
}
/**
* Validate a positive amount string. Accepts the literal `"max"`
* (case-insensitive). Returns an error message, or `null` when valid.
* @param {string} amount
* @returns {string | null}
*/
export function validateAmount(amount) {
if (!amount || amount.trim() === '') {
return 'Amount is required.';
}
if (amount.toLowerCase() === 'max') return null;
const num = Number(amount);
if (Number.isNaN(num) || num <= 0) {
return `Invalid amount: "${amount}". Must be a positive number or "max".`;
}
return null;
}
/**
* Validate a Solana address: base58, 32–44 chars, decoding to exactly 32 bytes.
* Returns an error message, or `null` when valid.
* @param {string} address
* @returns {string | null}
*/
export function validateSolanaAddress(address) {
if (!address || typeof address !== 'string') {
return 'Invalid Solana address. Expected a base58 string.';
}
if (address.length < 32 || address.length > 44) {
return 'Invalid Solana address. Expected 32–44 base58 characters.';
}
let decoded;
try {
decoded = bs58.decode(address);
} catch {
return 'Invalid Solana address. Contains non-base58 characters.';
}
if (decoded.length !== 32) {
return 'Invalid Solana address. Must decode to 32 bytes.';
}
return null;
}
/**
* True when the input is a well-formed EVM address (`0x` + 40 hex chars).
* @param {string} address
* @returns {boolean}
*/
export const isEvmAddress = (address) => validateAddress(address) === null;
/**
* True when the input is a well-formed Solana address (base58, 32 bytes).
* @param {string} address
* @returns {boolean}
*/
export const isSolanaAddress = (address) => validateSolanaAddress(address) === null;