CodcompassCodcompass
← Back to Blog
AI/ML2026-05-13·75 min read

Zero-Click Infrastructure: Prompting an AI Agent to Buy and Setup a Domain

By Cless

Autonomous Infrastructure Provisioning: Machine-First Domain Registration with x402 and EIP-191

Current Situation Analysis

The modern development lifecycle is rapidly shifting toward prompt-driven and agent-assisted workflows. Teams are automating CI/CD pipelines, infrastructure provisioning, and even frontend generation. Yet, one critical bottleneck remains stubbornly manual: domain registration. Traditional registrars are architected for human browsers, not machine-to-machine execution. They require interactive checkout flows, credit card validation, CAPTCHA challenges, and dashboard navigation. When an AI agent or automated pipeline attempts to provision infrastructure, it hits a hard wall at the payment and authentication layer.

This friction is frequently overlooked because most engineering teams treat domain procurement as a one-time, pre-deployment task. In reality, it represents a fundamental architectural mismatch. Machine workflows require stateless authentication, deterministic payment routing, and idempotent API contracts. Traditional registrars fail on all three. They rely on session-based cookies, manual payment gateways, and UI-driven state changes.

The technical reality is that infrastructure automation cannot be truly end-to-end until payment and identity are standardized for programmatic consumption. AgentDomainSearch addresses this gap by decoupling domain registration from human interfaces. It operates on the Base network, accepts USDC payments via the x402 protocol, and authenticates requests using EIP-191 cryptographic signatures. This eliminates API keys, account creation, and browser dependencies, transforming domain procurement into a deterministic, machine-readable HTTP transaction.

WOW Moment: Key Findings

The shift from traditional registrars to agent-first registries isn't just a convenience upgrade; it fundamentally changes how infrastructure is provisioned. By standardizing payment and authentication at the protocol level, machine workflows can complete transactions without leaving the execution context.

Approach Authentication Method Payment Flow Automation Compatibility Time to Live
Traditional Registrar Session cookies + 2FA Manual credit card checkout Low (requires browser automation or headless scraping) 15–45 minutes
Cloud Registrar (Route 53/Cloudflare) API keys + IAM roles Monthly billing / prepaid credits Medium (requires key management, billing setup) 5–20 minutes
Agent-First Registry (x402 + EIP-191) Wallet signatures Inline USDC transfer via HTTP 402 High (stateless, deterministic, no accounts) <2 minutes

This comparison reveals why x402-based registries matter. The HTTP 402 status code, historically unused, becomes a standardized payment handshake. The client receives a structured challenge, signs the exact USDC amount, and retries the request with a cryptographic proof. No redirects, no payment gateways, no human intervention. For AI agents and automated pipelines, this transforms domain registration from a blocking manual step into a programmatic API call.

Core Solution

Building a fully autonomous domain provisioning workflow requires three coordinated layers: wallet initialization, x402 payment execution, and EIP-191 authenticated DNS configuration. Below is a production-grade TypeScript implementation that demonstrates the complete flow.

Architecture Decisions & Rationale

  1. Base Network + USDC: Base provides fast finality and minimal transaction fees, making it ideal for micro-payments. USDC is a stablecoin with predictable pricing, eliminating volatility risk during domain purchase.
  2. x402 Protocol: x402 standardizes machine-to-machine payments over HTTP. Instead of custom payment gateways, it uses the native HTTP 402 response to deliver payment requirements, enabling agents to handle transactions deterministically.
  3. EIP-191 Signatures: Traditional API keys require rotation, storage, and revocation management. EIP-191 signatures bind authentication directly to a wallet address. The registry verifies the signature statelessly, removing the need for session management or key distribution.
  4. Vercel DNS Targets: Vercel's edge network requires an A record pointing to 76.76.21.21 for the root domain and a CNAME pointing to cname.vercel-dns.com for the www subdomain. This configuration ensures automatic SSL provisioning and global edge routing.

Implementation

The following module handles wallet initialization, x402 domain purchase, and EIP-191 DNS configuration. It uses ethers v6 for cryptographic operations and axios for HTTP communication.

import { ethers } from 'ethers';
import axios from 'axios';
import * as dotenv from 'dotenv';

dotenv.config();

const REGISTRY_BASE_URL = 'https://api.agentdomainsearch.com';
const VERCEL_A_RECORD = '76.76.21.21';
const VERCEL_CNAME_TARGET = 'cname.vercel-dns.com';

interface WalletConfig {
  provider: ethers.JsonRpcProvider;
  signer: ethers.Wallet;
}

interface DNSRecord {
  subdomain: string;
  ip_address?: string;
  hostname?: string;
}

interface DNSPayload {
  records: {
    A: DNSRecord[];
    CNAME: DNSRecord[];
  };
}

async function initializeWallet(): Promise<WalletConfig> {
  const privateKey = process.env.AGENT_WALLET_PRIVATE_KEY;
  if (!privateKey) throw new Error('Missing AGENT_WALLET_PRIVATE_KEY in environment');

  const provider = new ethers.JsonRpcProvider('https://mainnet.base.org');
  const signer = new ethers.Wallet(privateKey, provider);
  return { provider, signer };
}

async function purchaseDomain(domain: string, wallet: WalletConfig): Promise<string> {
  try {
    const response = await axios.post(`${REGISTRY_BASE_URL}/${domain}`, {
      contact_email: process.env.CONTACT_EMAIL,
      contact_name: process.env.CONTACT_NAME
    });
    return response.data.transaction_id;
  } catch (error: any) {
    if (error.response?.status === 402) {
      const challenge = error.response.data;
      const amount = challenge.amount;
      const recipient = challenge.recipient;
      const nonce = challenge.nonce;

      const typedData = {
        types: {
          EIP712Domain: [
            { name: 'name', type: 'string' },
            { name: 'chainId', type: 'uint256' }
          ],
          Payment: [
            { name: 'amount', type: 'uint256' },
            { name: 'recipient', type: 'address' },
            { name: 'nonce', type: 'bytes32' }
          ]
        },
        primaryType: 'Payment',
        domain: { name: 'AgentDomainSearch', chainId: 8453 },
        message: { amount, recipient, nonce }
      };

      const signature = await wallet.signer.signTypedData(
        typedData.domain,
        typedData.types,
        typedData.message
      );

      const retryResponse = await axios.post(`${REGISTRY_BASE_URL}/${domain}`, {
        contact_email: process.env.CONTACT_EMAIL,
        contact_name: process.env.CONTACT_NAME,
        payment_signature: signature
      }, {
        headers: { 'PAYMENT-SIGNATURE': signature }
      });

      return retryResponse.data.transaction_id;
    }
    throw error;
  }
}

async function configureDNS(domain: string, wallet: WalletConfig): Promise<void> {
  const timestamp = Math.floor(Date.now() / 1000);
  const message = `agentdomainsearch.com:${timestamp}`;
  const signature = await wallet.signer.signMessage(message);

  const dnsPayload: DNSPayload = {
    records: {
      A: [{ subdomain: '', ip_address: VERCEL_A_RECORD }],
      CNAME: [{ subdomain: 'www', hostname: VERCEL_CNAME_TARGET }]
    }
  };

  await axios.put(`${REGISTRY_BASE_URL}/${domain}/dns`, dnsPayload, {
    headers: {
      Authorization: `Bearer ${signature}`,
      'X-Signature-Timestamp': timestamp.toString()
    }
  });
}

export async function provisionDomain(domain: string): Promise<void> {
  const wallet = await initializeWallet();
  console.log(`[Provisioning] Purchasing ${domain}...`);
  await purchaseDomain(domain, wallet);
  
  console.log(`[Provisioning] Configuring DNS for ${domain}...`);
  await configureDNS(domain, wallet);
  
  console.log(`[Provisioning] Domain ${domain} ready for edge deployment.`);
}

Why This Structure Works

  • Explicit 402 Handling: Instead of relying on a black-box SDK, the code intercepts the HTTP 402 response, extracts the payment challenge, constructs an EIP-712 typed signature, and retries with the PAYMENT-SIGNATURE header. This makes the payment flow transparent and auditable.
  • Stateless Authentication: The DNS configuration uses EIP-191 signing with a timestamped message. The registry verifies the signature against the domain owner's wallet address, eliminating API key rotation and storage risks.
  • Deterministic Payloads: DNS records are structured as explicit arrays, matching the registry's expected schema. This prevents ambiguous subdomain routing and ensures Vercel's edge network receives clean configuration data.

Pitfall Guide

1. Network Chain Mismatch

Explanation: AgentDomainSearch operates exclusively on Base (Chain ID 8453). Sending USDC or signing transactions on Ethereum Mainnet, Arbitrum, or Polygon will result in failed payments or invalid signatures. Fix: Always initialize the provider with https://mainnet.base.org and verify chain ID in wallet setup. Use network-aware environment variables to prevent cross-chain leakage.

2. EIP-191 Signature Format Errors

Explanation: The registry expects a strict message format: agentdomainsearch.com:<unix-timestamp>. Omitting the prefix, using milliseconds instead of seconds, or signing with the wrong wallet will cause authentication rejection. Fix: Use Math.floor(Date.now() / 1000) for timestamps. Validate the signed message matches the exact string before attaching it to the Authorization header.

3. DNS Propagation & TTL Misconfiguration

Explanation: After updating DNS records, changes may take time to propagate globally. Low TTL values cause excessive DNS queries, while high TTL values delay updates. Fix: Set initial TTL to 300 seconds during provisioning. Once verified, increase to 3600 for production. Use dig or nslookup to verify record propagation before triggering edge deployments.

4. 402 Challenge Payload Mismatch

Explanation: The x402 protocol requires exact matching of amount, recipient, and nonce. Modifying any field or using floating-point arithmetic for USDC amounts will invalidate the signature. Fix: Treat USDC amounts as integers (e.g., 1000000 for 1.0 USDC with 6 decimals). Use ethers.parseUnits() or string-based arithmetic to prevent precision loss.

5. Private Key Exposure in CI/CD

Explanation: Hardcoding or logging private keys in pipeline logs, Docker images, or version control compromises the wallet and all associated domains. Fix: Inject keys via CI/CD secret managers (GitHub Secrets, AWS Secrets Manager, HashiCorp Vault). Never echo or print private keys. Use ephemeral wallets for short-lived agent tasks.

6. Ignoring Rate Limits & Retry Logic

Explanation: Registry APIs enforce request limits. Aggressive polling or unthrottled retries during DNS propagation will trigger temporary bans. Fix: Implement exponential backoff with jitter. Cache successful responses and avoid redundant PUT requests. Monitor Retry-After headers and respect them.

7. Vercel Domain Verification Delays

Explanation: Vercel requires domain ownership verification before SSL provisioning. If DNS records are misconfigured or propagation is incomplete, Vercel will fail to issue certificates. Fix: Verify A and CNAME records resolve correctly before running vercel domains add. Use vercel inspect to check SSL status. Allow 5–10 minutes for certificate issuance after DNS propagation.

Production Bundle

Action Checklist

  • Initialize Base network wallet and fund with sufficient USDC for domain purchase + gas buffer
  • Store private key in CI/CD secret manager; never commit to version control
  • Verify x402 402 challenge structure matches registry documentation before signing
  • Construct EIP-191 message with exact prefix and Unix timestamp in seconds
  • Validate DNS payload schema matches registry expectations (A/CNAME arrays)
  • Test DNS propagation with dig before triggering Vercel domain addition
  • Monitor Vercel SSL status and retry certificate issuance if propagation delays occur
  • Implement exponential backoff for all HTTP retries and rate limit handling

Decision Matrix

Scenario Recommended Approach Why Cost Impact
Solo developer / rapid prototyping Agent-First Registry (x402) Zero account setup, inline payment, fully scriptable Pay-per-domain, no subscription
Enterprise compliance / audit requirements Cloud Registrar (Route 53/Cloudflare) IAM integration, audit logs, SSO, dedicated support Monthly billing, higher overhead
AI agent / autonomous pipeline Agent-First Registry (x402) Stateless auth, deterministic payments, no UI dependencies Predictable per-transaction cost
Multi-region DNS management Cloud Registrar + CDN Advanced routing policies, health checks, failover Tiered pricing based on queries

Configuration Template

# .env
AGENT_WALLET_PRIVATE_KEY=0xYourHexPrivateKeyHere
CONTACT_EMAIL=ops@yourdomain.com
CONTACT_NAME=Infrastructure Team
REGISTRY_API_BASE=https://api.agentdomainsearch.com

// dns-config.ts
export const VERCEL_DNS_TARGETS = {
  rootARecord: '76.76.21.21',
  wwwCNAME: 'cname.vercel-dns.com',
  ttl: 300
};

export const buildDNSPayload = (domain: string) => ({
  records: {
    A: [{ subdomain: '', ip_address: VERCEL_DNS_TARGETS.rootARecord }],
    CNAME: [{ subdomain: 'www', hostname: VERCEL_DNS_TARGETS.wwwCNAME }]
  }
});

Quick Start Guide

  1. Fund the Wallet: Transfer USDC to your Base network wallet. Ensure balance covers domain cost + 0.5 USDC buffer for network fees.
  2. Generate Credentials: Create a .env file with AGENT_WALLET_PRIVATE_KEY, CONTACT_EMAIL, and CONTACT_NAME. Add to your CI/CD secret store.
  3. Run Provisioning Script: Execute the TypeScript module with your target domain. The script will handle the x402 payment challenge, sign the transaction, and configure DNS.
  4. Link to Edge Platform: Run npx vercel domains add <your-domain> and trigger a deployment. Verify SSL issuance with vercel inspect.
  5. Validate Propagation: Use dig <your-domain> A and dig www.<your-domain> CNAME to confirm records resolve to Vercel's edge IPs.