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
// agent-payments-sdk
// Copyright (c) 2026 nirholas | x.com/nichxbt | github.com/nirholas
// All rights reserved.
import {
encodeFunctionData,
maxUint256,
type Address,
type Hex,
} from "viem";
import type { EvmPaymentParams, EvmPaymentTransaction } from "../types.js";
import { getChain } from "../chains.js";
import { ERC20_ABI, PUMP_CROSSCHAIN_API } from "../constants.js";
import { assertQuoteValid } from "./quote.js";
interface PumpBridgeTxResponse {
/** Address of the Pump/MoonPay bridge contract to call */
to: string;
/** Encoded calldata */
data: string;
/** Native value to send (hex string) */
value: string;
/** ERC-20 spender that needs approval (absent when paying with native) */
approvalSpender?: string;
}
/**
* Fetch the bridge transaction calldata from Pump.fun's cross-chain API
* and wrap it with an optional ERC-20 approval transaction.
*
* The returned transactions should be sent in order:
* 1. approval (if present) — wait for confirmation
* 2. bridge
*/
export async function buildEvmPaymentTransaction(
params: EvmPaymentParams,
apiKey?: string
): Promise<EvmPaymentTransaction> {
assertQuoteValid(params.quote);
getChain(params.quote.fromChainId);
const headers: Record<string, string> = { "Content-Type": "application/json" };
if (apiKey) headers["x-api-key"] = apiKey;
const res = await fetch(`${PUMP_CROSSCHAIN_API}/build-tx`, {
method: "POST",
headers,
body: JSON.stringify({
quoteId: params.quote.quoteId,
fromChainId: params.quote.fromChainId,
fromToken:
params.quote.fromToken === "native"
? "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"
: params.quote.fromToken,
fromAmount: params.quote.fromAmount.toString(),
sender: params.sender,
agentMint: params.agentMint,
destinationSolanaWallet: params.destinationSolanaWallet,
memo: params.memo,
}),
});
if (!res.ok) {
const body = await res.text().catch(() => "");
throw new Error(`Bridge tx build failed (${res.status}): ${body}`);
}
const data: PumpBridgeTxResponse = await res.json();
const bridge: EvmPaymentTransaction["bridge"] = {
to: data.to as Address,
data: data.data as Hex,
value: BigInt(data.value),
chainId: params.quote.fromChainId,
};
// ERC-20 approval required when not paying with native currency
if (
params.quote.fromToken !== "native" &&
data.approvalSpender
) {
const approvalData = encodeFunctionData({
abi: ERC20_ABI,
functionName: "approve",
args: [data.approvalSpender as Address, maxUint256],
});
return {
approval: {
to: params.quote.fromToken as Address,
data: approvalData,
value: 0n,
},
bridge,
};
}
return { bridge };
}
/**
* Check whether the sender already has sufficient ERC-20 allowance,
* so the UI can skip showing an approval step.
*/
export async function checkAllowance(
tokenAddress: Address,
owner: Address,
spender: Address,
amount: bigint,
rpcUrl: string
): Promise<boolean> {
const body = {
jsonrpc: "2.0",
id: 1,
method: "eth_call",
params: [
{
to: tokenAddress,
data: encodeFunctionData({
abi: ERC20_ABI,
functionName: "allowance",
args: [owner, spender],
}),
},
"latest",
],
};
const res = await fetch(rpcUrl, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(body),
});
if (!res.ok) {
throw new Error(`Allowance check failed: RPC returned HTTP ${res.status}`);
}
const json: { result?: Hex; error?: { code: number; message: string } } =
await res.json();
if (json.error) {
throw new Error(`Allowance check failed: ${json.error.message}`);
}
if (typeof json.result !== "string") {
throw new Error("Allowance check failed: RPC returned no result");
}
const allowance = BigInt(json.result);
return allowance >= amount;
}