INTEGRITY Dokumentace

← Vytvářejte agenty na Cloudflare / agents / tools / payments

x402

x402 ↗ je platební standard postavený na HTTP 402 (Payment Required). Služby vracejí odpověď 402 s pokyny k platbě a klienti platí programově bez účtů, relací nebo API klíčů.

Jak to funguje

  1. Klient požaduje resource: GET /resource.
  2. Server vrací 402 Payment Required s PAYMENT-REQUIRED hlavička obsahující platební údaje zakódované v Base64: cenu, přijímaný token, síť a adresu obchodníka.
  3. Klient sestaví podepsaný platební payload a požadavek zopakuje s PAYMENT-SIGNATURE hlavička.
  4. Server ověří platební payload, a to buď přímo, nebo voláním facilitátor : A transakci vypořádá on-chain.
  5. Server vrací prostředek s PAYMENT-RESPONSE hlavička obsahující potvrzení vyrovnání.

Klíčové komponenty

Klient

Klientem je jakýkoli subjekt, který požaduje placený zdroj: aplikace ovládaná člověkem, AI agent nebo programová služba. Klienti potřebují jen kryptoměnovou peněženku, žádné účty, přihlašovací údaje ani relační tokeny spravovat nemusí.

Server

Server definuje požadavky na platbu v 402 odpověď, ověří příchozí platební payloady, vypořádá transakci a poskytne prostředek. Většinu z toho automaticky zajišťují SDK x402 a facilitator.

Facilitátor

Facilitátor je volitelná, ale doporučená služba třetí strany, která abstrahuje interakci s blockchainem. Server místo přímého připojení k uzlu deleguje dvě operace:

Facilitátor nedrží žádné prostředky. Ověří klientovu předem podepsanou transakci a odešle ji do sítě jménem serveru. https://x402.org/facilitator je veřejný facilitátor provozovaný společností Coinbase a používá se ve všech příkladech Cloudflare. Více facilitátorů ↗ jsou dostupné napříč různými sítěmi.

Platební schémata a sítě

x402 využívá platební schémata k definování způsobu, jakým se platba sestavuje a vypořádává v dané síti.

Scheme Sítě Popis
exact ↗ EVM, Solana, Aptos, Stellar, Hedera, Sui Přenáší pevnou částku tokenů, obvykle ERC-20 ↗ USDC na EVM na adresu obchodníka.
upto ↗ EVM Autorizuje maximální částku; skutečný poplatek se určí v době vypořádání na základě spotřeby prostředků.

Podporované sítě zahrnují Base, Ethereum, Polygon, Optimism, Arbitrum, Avalanche, Solana, Aptos, Stellar a Sui. Použijte base-sepolia pro testování s bezplatným testovacím USDC z Circle Faucet ↗.

Zpoplatnění zdrojů

Obsah HTTP

Řiďte přístup k rozhraním API, webovým stránkám a souborům pomocí proxy Workeru

Nástroje MCP

Zpoplatnění podle volání nástroje pomocí paidTool

Platba za zdroje

Agents SDK

Obalte MCP klienty pomocí withX402Client

SDKs

Balíček Instalovat Použití
x402-hono npm install x402-hono Middleware Hono pro servery Worker
@x402/fetch npm install @x402/fetch Wrapper pro fetch s automatickým zpracováním plateb
@x402/evm npm install @x402/evm Podpora platebního schématu EVM
agents/x402 Součástí agents Klient MCP s podporou plateb x402