πŸ“š Documentation

Learn how to use AgentPay β€” from registering agents to EIP-712 Agent Grants, multi-chain settlement, and the live conformance suite.

🐍 Python SDK

Install the official x402-agentpay package and add machine payments to any AI agent in one line of Python. Zero dependencies.

SDK Docs β†’

☁️ AWS AgentCore Integration

Add programmable payments, escrow, spend policies, and USDC settlement to your AWS Bedrock AgentCore agents. Full walkthrough with code examples.

Read Guide β†’

πŸ” Agent Grant System (EIP-712)

Signed spend grants that let AI agents pay autonomously β€” no private key sharing. Defines x402Grant struct with EIP-712 domain name="x402-AgentGrant", chainId=8453. Includes 6 test vectors, conformance runner, and Base Sepolia example.

Read Spec β†’

πŸ” EIP-712 Agent Grant Verification

Our x402 facilitator now natively verifies EIP-712 signed Agent Grants β€” the new standard for AI-to-AI payments. Validates signature, timing, budget, agent match, and 30% revocation window logic. Zero on-chain calls needed for verification.

View Endpoint β†’

βœ… Live Conformance Suite

Run all 6 test vectors from the shawnhvac/x402 spec against the live facilitator in one API call. Returns pass/fail per vector β€” use this to confirm your agent implementation is spec-compliant before going to mainnet.

Run Conformance β†’

⚑ x402 Payment Flow (Full Lifecycle)

Complete 5-step guide: Grant signing β†’ HTTP request with X-402-Payment header β†’ Verification β†’ On-chain settlement on Base L2 β†’ Receipt proof. Includes Mermaid diagram, error cases, refund logic, and security checklist.

Read Flow β†’

πŸ€– Agent Auto-Signup API

AI agents can register their humans on AgentPay in a single API call β€” no browser required. Returns API key + wallet address instantly. Includes Python, Node.js, cURL, and OpenAI function-calling examples. Also ships a machine-readable agent.json capability manifest.

View Agent Docs β†’

🌐 Multi-Chain Facilitator

Route x402 payments across 5 chains (Base, Ethereum, Optimism, Arbitrum, Polygon) through a single endpoint. 0.5% fee on settlement. Live /x402/verify, /x402/settle, and /x402/info endpoints. PR submitted to x402 Foundation ecosystem page.

Facilitator Docs β†’

πŸ“¦ Full x402 Spec Suite (GitHub)

All 6 specs + subgraph + examples + conformance suite + community docs in one repo. Self-contained β€” no AgentPay dependency required for basic implementations. Designed for immediate adoption by other teams.

View on GitHub β†’

πŸ“Š The Graph Subgraph

Production-ready AssemblyScript subgraph workspace β€” drop it in and deploy. Indexes GrantRegistry + SettlementListener events. 277-line mapping with Taylor-series time-decay for reputation scoring. Two TODOs remaining (contract address + block) β€” waiting on James.

View Subgraph β†’

βœ… Conformance Suite

One-command npm test runs all test vectors against your implementation. Covers: happy path, expired grant, wrong agent, clock skew, revocation window, and zero-budget. Also available live at GET /x402/conformance on the facilitator.

Run Tests β†’

πŸ”— Base Sepolia Real Settlement

Full end-to-end demo with real on-chain USDC β€” not mocked. Uses EIP-3009 transferWithAuthorization for atomic settlement on Base Sepolia testnet. Node.js paying agent + Python receiving agent, both runnable in under 5 minutes.

View Guide β†’

🌍 Community & Implementations

Track every team implementing the x402 protocol. Visual stack diagram, implementation table, and step-by-step "add your implementation" guide. No AgentPay dependency required β€” any team can adopt the open protocol immediately.

View Community β†’

βš™οΈ Minimal Reference Impl

Official minimal end-to-end example β€” Node.js paying agent (grant signing + X-402-Payment header) and Python receiving agent (full EIP-712 verification + replay protection). All local + testnet flows pass the full conformance suite.

View Examples β†’

⭐ Reputation Layer

Optional Sybil-resistant scoring for AI agents. Formula: 60% settlement success rate + 25% counterparty diversity + 15% time-decay (Taylor-series weighted). Queryable from any receiver via The Graph. Fully integrated with the subgraph workspace.

Read Spec β†’

πŸš€ Getting Started

Step-by-step guide for service providers, consumers, and developers. Learn how to register agents, use the personal agent app, and integrate with our API.

Read Guide β†’

⚑ Quick Reference

Fast lookup card with instructions, pricing, key concepts, and common questions. Perfect for when you need answers quickly.

Quick Ref β†’

πŸ’° Pricing Model

Complete pricing breakdown, revenue projections, competitive analysis, and customer acquisition strategy. For investors and business partners.

View Pricing β†’

πŸ›£οΈ Roadmap

5-phase development plan from foundation through scale. See what's planned for autonomous vehicles, Bluetooth/NFC, and cross-chain expansion.

View Roadmap β†’

πŸ’Ό Investor Pitch

Complete Series A pitch deck with market opportunity, traction, financial projections, and exit strategy. For venture capitalists.

View Pitch β†’

πŸ€– Personal Agent App

Strategy document for iOS and Android personal agent applications. Includes use cases, technical architecture, and launch timeline.

Read Strategy β†’

πŸ“± Android Build Guide

Complete guide for building and deploying the Android personal agent app. Technical requirements, development phases, and testing checklist.

Read Guide β†’

πŸ—ΊοΈ Location Discovery

How worldwide location-based agent discovery works. Google Maps integration, cost optimization, and real-world use cases.

Read Setup β†’

Can't find what you're looking for?

Email us at [email protected] or click the chat bubble on any page.

Chat with Aria
πŸ€–

Aria

x402 AgentPay Β· AgentWorld Guide

Hey! I'm Aria πŸ‘‹ I'm the AI guide for both x402 AgentPay and AgentWorld. Ask me anything about machine payments, agent registration, x402 protocol, or our agent economy!