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
// Monetization helpers — revenue recording and balance queries.
//
// Used by x402 intent consumption, skill purchase confirmation, and any
// code path that needs to attribute revenue to an agent owner.
import { randomUUID } from 'node:crypto';
import { sql } from './db.js';
import { calculateFee } from './fee.js';
/**
* Record an immutable revenue event for a consumed skill payment.
*
* @param {object} opts
* @param {string} opts.agentId - UUID of the agent that earned revenue
* @param {string} opts.skillName - skill identifier (e.g. "answer-question")
* @param {string} opts.callerAddress - payer wallet address (nullable)
* @param {number|bigint} opts.amountUsdc - gross amount in atomic units (USDC 6 decimals)
* @param {string} opts.network - chain name ("solana", "base", etc.)
* @param {string} opts.txHash - on-chain transaction hash/signature
* @param {string} [opts.currencyMint] - token mint/contract address
* @param {string} [opts.intentId] - payment intent ID if applicable
* @returns {Promise<object>} the inserted revenue event row
*/
export async function recordRevenueEvent({
agentId,
skillName,
callerAddress = null,
amountUsdc,
network,
txHash = null,
currencyMint = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
intentId = null,
}) {
const grossAmount = Number(amountUsdc);
if (!Number.isFinite(grossAmount) || grossAmount <= 0) {
throw Object.assign(new Error('amountUsdc must be a positive number'), { status: 400 });
}
if (!agentId) {
throw Object.assign(new Error('agentId is required'), { status: 400 });
}
if (!skillName) {
throw Object.assign(new Error('skillName is required'), { status: 400 });
}
const { fee, net } = calculateFee(grossAmount);
// intent_id is UNIQUE — one on-chain payment credits exactly once. A real
// intent/tx reuses its identifier (so a retry conflicts and no-ops); a direct
// call with neither gets a synthetic unique key so distinct direct credits
// never collide.
const dedupeKey = intentId ?? txHash ?? `direct_${randomUUID()}`;
const [row] = await sql`
INSERT INTO agent_revenue_events
(agent_id, intent_id, skill, gross_amount, fee_amount, net_amount,
currency_mint, chain, payer_address)
VALUES
(${agentId}, ${dedupeKey}, ${skillName}, ${grossAmount},
${fee}, ${net}, ${currencyMint}, ${network}, ${callerAddress})
ON CONFLICT (intent_id) DO NOTHING
RETURNING id, agent_id, skill, gross_amount, fee_amount, net_amount,
currency_mint, chain, payer_address, created_at
`;
// Conflict → this payment was already recorded; return the existing row so
// callers stay idempotent rather than seeing a phantom failure.
if (!row) {
const [existing] = await sql`
SELECT id, agent_id, skill, gross_amount, fee_amount, net_amount,
currency_mint, chain, payer_address, created_at
FROM agent_revenue_events WHERE intent_id = ${dedupeKey} LIMIT 1
`;
return existing;
}
return row;
}
/**
* Calculate the available (withdrawable) balance for a user.
*
* available = sum(net_amount from revenue_events) - sum(amount from pending/processing/completed withdrawals)
* Revenue flagged settled_to_wallet already landed in the owner's own wallet on
* chain (agent API sales over x402), so it is never withdrawable from the treasury.
*
* @param {string} userId
* @param {string} [currencyMint] - filter to a specific currency (default: all)
* @returns {Promise<{earned: number, withdrawn: number, pending: number, available: number}>}
*/
export async function getAvailableBalance(userId, currencyMint = null) {
const [result] = currencyMint
? await sql`
SELECT
COALESCE(SUM(re.net_amount), 0)::bigint AS earned
FROM agent_revenue_events re
JOIN agent_identities ai ON ai.id = re.agent_id
WHERE coalesce(re.owner_user_id, ai.user_id) = ${userId}
AND re.currency_mint = ${currencyMint}
AND NOT re.settled_to_wallet
`
: await sql`
SELECT
COALESCE(SUM(re.net_amount), 0)::bigint AS earned
FROM agent_revenue_events re
JOIN agent_identities ai ON ai.id = re.agent_id
WHERE coalesce(re.owner_user_id, ai.user_id) = ${userId}
AND NOT re.settled_to_wallet
`;
const [wResult] = currencyMint
? await sql`
SELECT
COALESCE(SUM(CASE WHEN status IN ('pending', 'processing') THEN amount ELSE 0 END), 0)::bigint AS pending,
COALESCE(SUM(CASE WHEN status = 'completed' THEN amount ELSE 0 END), 0)::bigint AS withdrawn
FROM agent_withdrawals
WHERE user_id = ${userId}
AND currency_mint = ${currencyMint}
`
: await sql`
SELECT
COALESCE(SUM(CASE WHEN status IN ('pending', 'processing') THEN amount ELSE 0 END), 0)::bigint AS pending,
COALESCE(SUM(CASE WHEN status = 'completed' THEN amount ELSE 0 END), 0)::bigint AS withdrawn
FROM agent_withdrawals
WHERE user_id = ${userId}
`;
// Split-aware adjustment. For a multi-collaborator listing the creator's net
// is apportioned across recipients (split_distributions), not kept whole by
// the agent owner. So we SUBTRACT the owner's revenue on split listings and
// ADD this user's ledger-mode split allocations (their exact share). On-chain
// (0xSplits) distributions are excluded — those settle on chain, not via our
// payout. Guarded: pre-migration DBs without the split tables degrade to the
// original owner-keeps-net behaviour, never erroring on a hot money path.
let splitOut = 0;
let splitIn = 0;
try {
const [outRow] = currencyMint
? await sql`
SELECT COALESCE(SUM(re.net_amount), 0)::bigint AS amt
FROM agent_revenue_events re
JOIN agent_identities ai ON ai.id = re.agent_id
JOIN listing_splits ls ON ls.agent_id = re.agent_id AND ls.skill = re.skill
WHERE coalesce(re.owner_user_id, ai.user_id) = ${userId} AND re.currency_mint = ${currencyMint}
`
: await sql`
SELECT COALESCE(SUM(re.net_amount), 0)::bigint AS amt
FROM agent_revenue_events re
JOIN agent_identities ai ON ai.id = re.agent_id
JOIN listing_splits ls ON ls.agent_id = re.agent_id AND ls.skill = re.skill
WHERE coalesce(re.owner_user_id, ai.user_id) = ${userId}
`;
const [inRow] = currencyMint
? await sql`
SELECT COALESCE(SUM(amount), 0)::bigint AS amt
FROM split_distributions
WHERE recipient_user_id = ${userId} AND mode = 'ledger' AND status = 'accrued' AND currency_mint = ${currencyMint}
`
: await sql`
SELECT COALESCE(SUM(amount), 0)::bigint AS amt
FROM split_distributions
WHERE recipient_user_id = ${userId} AND mode = 'ledger' AND status = 'accrued'
`;
splitOut = Number(outRow.amt);
splitIn = Number(inRow.amt);
} catch {
splitOut = 0;
splitIn = 0;
}
const earned = Number(result.earned) - splitOut + splitIn;
const pending = Number(wResult.pending);
const withdrawn = Number(wResult.withdrawn);
const available = earned - pending - withdrawn;
return { earned, withdrawn, pending, available: Math.max(0, available) };
}