API Reference

GET https://aznp-proxy.kerberos79.workers.dev/?url={target_url}

// Base (EVM) EIP-191 / EIP-712 Signature & Call Example (Node.js — viem) import { createWalletClient, http } from 'viem'; import { base } from 'viem/chains'; import { privateKeyToAccount } from 'viem/accounts'; // Agent EVM private key (0x + 32 bytes hex) — store securely in .env const account = privateKeyToAccount('0xYOUR_BASE_PRIVATE_KEY'); // derives 0x + 40 hex address const client = createWalletClient({ account, chain: base, // Base L2 (chainId 8453) transport: http('https://mainnet.base.org'), }); async function callAZNPProxy(targetUrl) { const timestamp = Math.floor(Date.now() / 1000).toString(); // EIP-191 (personal_sign) over "x402:base:{timestamp}" — chain-bound message const signatureEip191 = await client.signMessage({ account, message: `x402:base:${timestamp}`, }); // EIP-712 (typed data) — X402Auth(string message, uint256 timestamp) const signatureEip712 = await client.signTypedData({ account, domain: { name: 'AZNP', version: '1', chainId: 8453 }, types: { X402Auth: [ { name: 'message', type: 'string' }, { name: 'timestamp', type: 'uint256' }, ], }, primaryType: 'X402Auth', message: { message: 'x402', timestamp: BigInt(timestamp) }, }); const endpointUrl = `https://aznp-proxy.kerberos79.workers.dev/?url=${encodeURIComponent(targetUrl)}&render=true`; const response = await fetch(endpointUrl, { method: 'GET', headers: { 'x-wallet-address': account.address, // 0x + 40 hex (lowercase) 'x-timestamp': timestamp, 'x-signature': signatureEip191, // use signatureEip712 when 'x-sig-type: eip712' 'x-chain': 'base', 'x-sig-type': 'eip191', // or 'eip712' }, }); if (response.status === 402) { const errorData = await response.json(); console.error("402 Payment Required: Insufficient credits. Please top up.", errorData); return null; } const markdown = await response.text(); console.log("Token reduction:", response.headers.get("X-Token-Reduction")); console.log("Clean Markdown output:", markdown.slice(0, 200)); return markdown; }

// 1. Base (EVM) Wallet Generation (Node.js — viem) import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts'; // Create a new private key programmatically for an AI Agent const agentPrivateKey = generatePrivateKey(); // 0x + 32 bytes hex const agentAddress = privateKeyToAccount(agentPrivateKey); // 0x + 40 hex console.log("Agent Address:", agentAddress); console.log("Agent Private Key (Store securely in .env):", agentPrivateKey); // 2. HTTP 402 Auto-Payment Handler Pattern async function fetchWithAutoTopup(targetUrl) { let res = await callAZNPProxy(targetUrl); // Detect 402 Payment Required (Insufficient credits) if (res && res.status === 402) { const paymentInfo = await res.json(); console.warn("HTTP 402 Payment Required received. Executing automated USDC topup..."); // Step 2a: Send $20 USDC via Base SDK to receiver wallet const txHash = await executeUsdcTransfer({ from: agentAddress, toAddress: paymentInfo.receiver_wallet || "0x22E2076148c529981495c3C02A23DfB1D4f8Db9C", amountUsdc: 20.0 }); // Step 2b: Submit transaction hash to AZNP credit topup endpoint const topupRes = await fetch("https://aznp-proxy.kerberos79.workers.dev/v1/topup", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ wallet: agentAddress, tx_hash: txHash, chain: "base" }) }); if (topupRes.ok) { console.log("Auto-topup successful! Resuming original request..."); return await callAZNPProxy(targetUrl); // Retry request } } return res; }