Recherche approfondie : Protocole x402

Recherche effectuee le 2026-04-04, enrichie le 2026-04-15 (docs officielles CDP) Sources : WebSearch, GitHub (coinbase/x402), x402.org, docs.cdp.coinbase.com/x402, Cloudflare, CryptoSlate, CoinDesk, etc.

1. Qu’est-ce que x402 ?

x402 est un protocole de paiement ouvert et standardise construit sur HTTP. Il reactive le code de statut HTTP 402 “Payment Required” — present dans la specification HTTP depuis 1991 mais jamais utilise — pour en faire un mecanisme natif de paiement machine-a-machine sur internet.

En clair : quand un client (humain ou agent IA) fait une requete HTTP vers une API ou un service protege, le serveur repond 402 Payment Required avec les details de paiement. Le client paie en stablecoin on-chain, renvoie la requete avec une preuve de paiement, et recoit la ressource. Pas de compte, pas de session, pas d’authentification complexe.

Le protocole a ete cree par l’equipe Coinbase Developer Platform et lance en open source en mai 2025. Le 2 avril 2026, Coinbase et la Linux Foundation ont officiellement lance la x402 Foundation, une entite non-profit pour gouverner le protocole de facon neutre.

2. Qui est derriere x402 ?

Createur

• Coinbase (equipe Coinbase Developer Platform / CDP)

x402 Foundation (lance le 2 avril 2026)

• Gouvernance : Linux Foundation (Jim Zemlin, CEO)
• Co-fondateurs : Coinbase + Cloudflare (co-fondateurs de la Foundation en septembre 2025)

Membres fondateurs de la Foundation

L’annonce a ete faite lors du MCP Dev Summit North America a New York le 2 avril 2026.

3. Fonctionnement technique

Le flux de paiement en 12 etapes

Client                    Serveur                   Facilitateur         Blockchain
  |                          |                          |                    |
  |--- GET /resource ------->|                          |                    |
  |<-- 402 Payment Required -|                          |                    |
  |    (header PAYMENT-      |                          |                    |
  |     REQUIRED + JSON)     |                          |                    |
  |                          |                          |                    |
  |  [Client cree payload    |                          |                    |
  |   de paiement + signe]   |                          |                    |
  |                          |                          |                    |
  |--- GET /resource ------->|                          |                    |
  |    (header PAYMENT-      |                          |                    |
  |     SIGNATURE)           |                          |                    |
  |                          |--- /verify ------------->|                    |
  |                          |<-- valide/invalide ------|                    |
  |                          |--- /settle ------------->|                    |
  |                          |                          |--- tx on-chain --->|
  |                          |                          |<-- confirmation ---|
  |                          |<-- confirmation ---------|                    |
  |<-- 200 OK + ressource --|                          |                    |
  |    (header PAYMENT-      |                          |                    |
  |     RESPONSE)            |                          |                    |

Les 4 entites du protocole

1. Client : L’entite qui veut acceder a une ressource (humain, bot, agent IA)
2. Serveur de ressources : Le serveur HTTP qui fournit l’API/service
3. Facilitateur : Service intermediaire qui verifie et execute les paiements on-chain (abstrait la complexite blockchain pour le serveur). Le facilitateur CDP de Coinbase est le principal : 1000 tx/mois gratuites, puis $0.001/tx. Supporte Base, Base Sepolia, Polygon, Solana, Solana Devnet. URL : https://api.cdp.coinbase.com/platform/v2/x402. Un facilitateur alternatif testnet-only existe sur https://x402.org/facilitator (pas de signup requis).
4. Blockchain : Le reseau de settlement (Base, Ethereum, Solana, etc.)

Headers HTTP utilises

Schemes de paiement

• exact : Paiement d’un montant fixe — le client paie exactement le montant demande. Utilise pour les prix fixes (ex: $0.01 par requete API).
• upto : Paiement usage-based — le client signe une autorisation MAX, mais ne paie que le montant reel consomme. Implemente en production (TypeScript + Go, pas encore Python). Le SDK detecte automatiquement le scheme annonce par le serveur. Cote buyer, c’est transparent : le SDK gere la signature max-authorization et le settlement au montant reel. Cote seller, le middleware declare upto et specifie le montant max, le facilitateur settle au montant reel apres execution.
• Chaque paire (scheme, network) necessite une implementation specifique

Extensions et features avancees (nouveau, avril 2026)

Bazaar (discovery layer) : Plateforme de decouverte et recherche pour l’ecosysteme x402. Indexe les endpoints payants avec descriptions semantiques, metadonnees de paiement, et signaux de confiance on-chain.

• Access modes : REST API (GET /v2/x402/discovery/resources) pour dashboards/backends, et MCP Server (GET /v2/x402/discovery/mcp) pour agents IA via Model Context Protocol
• Pas d’enregistrement separe : Le facilitateur catalogue le service la premiere fois qu’il traite un paiement (verify + settle) pour cet endpoint
• Semantic search : Recherche par embeddings vectoriels. query=current weather conditions matche des endpoints decrits comme “real-time meteorological data”
• Filtres : query, network, asset, scheme, payTo, maxUsdPrice, extensions, limit, offset
• Quality signals : Usage-based trust (payers uniques sur 30 jours glissants), richesse des metadonnees, controle anti-spam (densite par domaine), scoring composite
• Merchant Discovery : GET /v2/x402/discovery/merchant?payTo=<address> — public, pas de cle API requise. Retourne tous les endpoints actifs d’un merchant par son adresse wallet
• CDP discovery endpoint : https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources (100 resultats par defaut)
• Testnet discovery : https://x402.org/facilitator/discovery/resources
• Extension architecture (v2) : Package @x402/extensions/bazaar. Cote serveur : bazaarResourceServerExtension + declareDiscoveryExtension() pour declarer les schemas input/output. Cote client : withBazaar() pour ajouter les capabilities discovery au facilitator client
• v1 vs v2 : v1 (deprecated) utilisait outputSchema dans PaymentRequirements. v2 utilise extensions.bazaar dans la config de route, avec validation JSON Schema et support input/output

Bazaar MCP Server : Le Bazaar expose un serveur MCP pour les agents IA. Le package @x402/mcp wraps un client MCP standard avec gestion automatique des paiements.

• 2 tools : search_resources (recherche semantique dans l’index Bazaar) et proxy_tool_call (appelle un endpoint decouvert, gere le paiement 402 automatiquement)
• Endpoint CDP : https://api.cdp.coinbase.com/platform/v2/x402/discovery/mcp
• createX402MCPClient() : Wraps le client MCP avec auto-payment, hooks de paiement customisables, pricing dynamique
• L’agent fait un seul callTool() — le client @x402/mcp gere la detection 402, la creation du payload, et le retry

Permit2 (tout ERC-20) : Les endpoints peuvent accepter n’importe quel token ERC-20 (pas seulement USDC) via le protocole Permit2 d’Uniswap. Le SDK gere automatiquement le payload PermitWitnessTransferFrom. Premiere approbation one-time necessaire vers le contrat Permit2.

Gas Sponsorship : Le facilitateur peut sponsoriser le gas des transactions de paiement :

• EIP-2612 : Le client signe un message off-chain permit(). Le facilitateur soumet l’approbation on-chain — zero gas pour le buyer.
• ERC-20 : Le client signe un approve(). Le facilitateur le broadcast on-chain — zero gas pour le buyer.

MCP Server x402 : Integration native pour les agents LLM. Architecture : Claude Desktop → MCP Server (x402 client) → x402 API (paid endpoint). Le MCP server detecte le 402, parse les requirements, cree et signe le paiement, retry avec le header PAYMENT-SIGNATURE. Packages : @x402/axios (wrapper axios), @x402/evm + @x402/svm (multi-network). L’agent selectionne automatiquement EVM ou SVM selon le network dans les requirements (eip155:* → EVM, solana:* → SVM).

Miniapps (Farcaster) : Applications legeres qui tournent dans les clients Farcaster, avec paiements x402 integres. Tech stack : Next.js 16, React 19, Tailwind CSS 4, OnchainKit, MiniKit, Wagmi, @x402/next. Le wrapper withX402 protege les routes API Next.js. Le settlement se fait uniquement APRES une reponse reussie (status < 400). Pas de cle CDP requise en testnet. Use case : monetisation de contenu/services directement dans l’experience social Farcaster, sans quitter l’app.

Principes fondamentaux

1. Norme ouverte : Pas de dependance a un acteur unique
2. Natif HTTP : Pas de protocole supplementaire, s’integre aux flux existants
3. Agnosticisme chain/token : Multi-chain, multi-token
4. Retrocompatibilite : Ne casse jamais le support existant
5. Minimisation de confiance : Aucun intermediaire ne peut bouger les fonds sans consentement
6. Facilite d’integration : “1 ligne pour le serveur, 1 fonction pour le client”

4. Chains et tokens supportes

Identifiants reseau (CAIP-2)

x402 v2 utilise le format CAIP-2 (Chain Agnostic Improvement Proposal) : namespace:reference

• EVM : eip155:{chainId} (ex: eip155:8453 = Base mainnet)
• Solana : solana:{genesisHash} (ex: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp = mainnet)

Chains supportees (en production)

Support par facilitateur

CDP Facilitator (recommande, mainnet + testnet) :

x402.org (testnet only, pas de signup) : Base Sepolia + Solana Devnet (exact, upto)

Le protocole est permissionless — n’importe qui peut run un facilitateur. Liste communautaire sur x402.org/ecosystem.

Tokens principaux et adresses de contrats

• USDC : Token de settlement dominant (Circle). Supporte EIP-3009 (transfert gasless)
• Tout ERC-20 : Supporte via Permit2 sur EVM
• SPL tokens : Supportes sur Solana (SPL Token Program + Token2022 en v2)
• Support d’arbitrary tokens prevu dans la roadmap 2026

Format de prix

// Dollar string (recommande pour la lisibilite)
price: "$0.001"    // 0.001 USDC
price: "$1.00"     // 1 USDC

// Unites atomiques (pour la precision)
amount: "1000"     // 0.001 USDC (6 decimales)
amount: "1000000"  // 1 USDC (6 decimales)

Specificites techniques par chain

• EVM : Utilise EIP-3009 (tokens compatibles comme USDC — zero approval) et Permit2 (tout ERC-20 — one-time approval au contrat Permit2). Gas sponsorship via EIP-2612 ou ERC-20 sponsoring.
• Solana : SPL Token Program + Token2022 (v2 only). Fractions de centime par tx = vrai micropaiement. Settlement instantane.

5. Use cases principaux

1. Paiements autonomes par agents IA (use case killer)

Un agent IA rencontre un paywall, lit la reponse 402, et regle le paiement via un wallet pre-autorise — sans intervention humaine. C’est le narratif central de x402.

2. Monetisation d’APIs

Les fournisseurs d’API (donnees crypto, IA, meteo, etc.) peuvent gater l’acces derriere un paiement x402 au lieu de cles API traditionnelles.

3. Micropaiements pour contenu

Paiement a l’article, a la requete, au byte — granularite impossible avec les systemes de paiement traditionnels.

4. Machine-to-Machine (M2M)

Paiements automatises entre services, microservices, IoT, etc.

5. E-commerce agent-intermedie

Les agents IA acheteraient des produits/services pour le compte de leurs utilisateurs.

6. Farcaster Miniapps

Applications legeres dans les clients Farcaster avec paiement x402 integre. L’utilisateur connecte son wallet, le paiement se fait sans quitter l’app sociale. Stack : Next.js + OnchainKit + MiniKit + @x402/next. Le wrapper withX402 protege les routes API. Settlement uniquement apres reponse reussie (status < 400).

Exemples concrets dans l’ecosysteme

• Daydreams Router : Gateway crypto-native vers GPT, Claude, Groq, Gemini — settlement USDC instantane via x402
• Messari : Acces pay-per-use a leurs APIs de recherche crypto
• Alchemy : Acces monetise a leur plateforme de dev blockchain
• Cloudflare Workers : Support natif x402 dans leur SDK Agents

6. Metriques d’adoption et volume

Timeline d’adoption

Ecosysteme total

• Market cap ecosysteme x402 : ~$6.83 milliards (avril 2026)
• Nombre de tx cumulees : 15M+ (tous projets ecosystem confondus)
• Adoption totale : 100M+ paiements traites

Projections

• Galaxy Digital (dec 2025) : x402 pourrait representer 30% des tx quotidiennes de Base et 5% de celles de Solana en 2026
• a16z : Le protocole pourrait capturer $30 trillions de marche sur 5 ans
• Gartner : D’ici 2028, 90% des achats B2B seront intermedies par des agents IA = $15T+ via des echanges agent-to-agent

7. SDKs et integration technique

SDKs disponibles

Integration serveur (Express.js)

import { paymentMiddleware } from "@x402/express";

app.use(
  paymentMiddleware({
    "GET /weather": {
      accepts: [/* conditions de paiement */],
      description: "Weather data"
    }
  })
);

Integration Cloudflare Workers

• withX402 et paidTool pour MCP servers
• Middleware x402-hono pour HTTP Workers
• Client MCP integre capable de payer pour des outils x402-protected
• Support natif dans Cloudflare Agents SDK v0.4.0+

Structure du repo GitHub

coinbase/x402/
  specs/           # Specifications completes
  typescript/      # SDK TypeScript
  python/          # SDK Python
  go/              # SDK Go
  java/            # SDK Java
  contracts/evm/   # Smart contracts Solidity
  examples/        # Implementations d'exemple
  e2e/             # Tests end-to-end
  docs/            # Documentation GitBook

Statistiques du repo (avril 2026) :

• 722 commits
• Composition : TypeScript 43.2%, Python 32.9%, Go 22.7%, Solidity 0.5%
• Licence : Apache-2.0
• Fork de : x402-foundation/x402

8. x402 V2

x402 V2 a ete lance avec des ameliorations significatives :

• Sessions de paiement reutilisables : Un client peut payer une fois et reutiliser la session
• Tarification dynamique : Le serveur peut ajuster les prix en temps reel
• Modeles multi-acces : Pay-per-use, credits, flux prepayes
• Nouveaux headers : PAYMENT-SIGNATURE remplace X-PAYMENT
• Champ amount remplace maxAmountRequired
• Selection automatique du reseau par le client

9. Concurrents et alternatives

Comparaison des protocoles de paiement agent

|---------|------|------| | Settlement | USDC (stablecoins) on-chain | Bitcoin (Lightning) | | Verification | Via Facilitateur (lookup on-chain) | Stateless (macaroons cryptographiques) | | Latence | Secondes (confirmation on-chain) | Millisecondes (Lightning) | | Frais | Faibles (L2) a moyens (L1) | Sub-centime | | Stabilite prix | Oui (stablecoins) | Non (volatilite BTC) | | Dependance | Facilitateur necessaire | Aucune (trustless) | | Adoption enterprise | Forte (Coinbase, Cloudflare, Stripe) | Limitee (ecosysteme Lightning) | | Lancement | Mai 2025 | 2020 (sous le nom LSAT) |

MPP — Machine Payments Protocol (l’évolution de x402)

MPP (mpp.dev) est le standard IETF qui formalise et étend ce que x402 a initié. Créé par Tempo Labs + Wevm. Spec proposée à l’IETF : paymentauth.org.

Relation avec x402 : MPP n’est PAS un concurrent — c’est la prochaine couche. Les deux coexistent sur le même serveur (headers différents). x402 utilise des headers custom (X-PAYMENT-REQUIRED), MPP utilise les headers HTTP standard (WWW-Authenticate: Payment). Un serveur peut annoncer les deux en même temps dans une réponse 402.

En résumé : x402 a posé les fondations (HTTP 402 + stablecoins). MPP les standardise, les étend à tous les moyens de paiement, et les pousse vers l’IETF. Un serveur qui adopte MPP gagne le multi-méthode (un client peut payer en USDC OU en carte bancaire sur le même endpoint) et les sessions pour les micropaiements streaming.

Guide de migration x402 → MPP : https://mpp.dev/guides/upgrade-x402 — les deux peuvent tourner en parallèle.

Positionnement strategique

Les protocoles de paiement agent ne sont pas mutuellement exclusifs :

• x402 = la couche de settlement crypto-native (stablecoins on-chain)
• MPP = la standardisation IETF multi-méthode qui étend x402 (stablecoins + fiat + Lightning)
• AP2 (Google) = la couche d’orchestration (peut transporter des paiements x402/MPP)
• TAP (Visa) / ACP (Stripe+OpenAI) = extensions des rails fiat existants

x402 et MPP sont complémentaires. AP2/TAP/ACP gèrent la couche d’intent et d’orchestration côté fiat.

Perspective complémentaire 2026-04-26 — l’angle Jesus Rodriguez (Sentora CTO)

Ajout 2026-04-26 après recherche approfondie pour /master x402 vs MPP. Voir nouvelles fiches dédiées : MPP et Tempo.

La section ci-dessus présente MPP comme “l’évolution de x402” (perspective valide côté headers HTTP + standards track IETF). Mais l’analyse architecturale de Jesus Rodriguez (../raw/articles/2026-04-26-tempo-mpp-coverage-externe) propose une lecture plus nuancée où x402 et MPP incarnent deux philosophies opposées, pas une simple succession évolutive :

La distinction qui compte vraiment : x402 requiert une transaction on-chain par paiement. MPP avec Sessions permet d’agréger N micropaiements off-chain en 1 settlement on-chain (cf. MPP section “L’innovation clé”).

Pour un agent IA :

• Cas x402 idéal : paiements ponctuels, montants moyens, multi-chain souhaité (Solana 49% market share, Base, Polygon)
• Cas MPP idéal : streaming par token LLM, accès intensif à des APIs payantes, multi-rail (crypto + cards + Lightning)

Ils peuvent coexister : un même serveur peut accepter les deux (la table en haut de section 9 montre que les headers HTTP sont distincts). Mais conceptuellement, ils représentent deux paris différents sur la suite :

• x402 parie sur la composability crypto-native pure (Base + Solana + chains EVM)
• MPP parie sur l’intégration verticale Stripe + Tempo + multi-rail

Voir MPP pour la fiche dédiée et Tempo pour le L1 sous-jacent.

10. Ecosysteme et tokens lies

x402 n’a PAS de token natif

C’est un protocole neutre et ouvert. Pas de token de gouvernance, pas de token utilitaire propre. Le settlement se fait en stablecoins (principalement USDC).

Tokens de l’ecosysteme x402

Market cap total ecosysteme x402 : ~$6.83 milliards (avril 2026)

Projets majeurs de l’ecosysteme

11. Roadmap et developpements futurs

Roadmap 2026

• x402 Bazaar : Marketplace/discovery layer pour que les agents trouvent des services disponibles
• ERC-8004 : Standard Ethereum pour la confiance et l’identite des agents IA (complementaire a x402)
• E-commerce : Refunds et escrow
• Arbitrary tokens : Support de tokens au-dela des stablecoins
• Facilitator Router : Routage intelligent entre facilitateurs
• x402 V2 : Sessions reutilisables, tarification dynamique (lance)

ERC-8004 + x402

L’Ethereum Foundation (equipe dAI) a integre ERC-8004 et x402 comme priorites cles de sa roadmap 2026. ERC-8004 fournit un framework de confiance pour les agents IA, complementaire au mecanisme de paiement x402.

SKALE V4

SKALE a integre le support x402 dans sa mise a jour V4 (janvier 2026) pour les apps agentiques — frais plus bas, meilleure securite.

12. Analyse pour le Second Brain

Forces

• Coalition massive : Linux Foundation + Coinbase + Cloudflare + Stripe + Google + AWS + Visa + Mastercard
• Standard ouvert : Apache-2.0, gouvernance neutre
• Multi-chain : EVM + Solana + Aptos + Stellar + Sui
• Adoption rapide : 100M+ paiements en ~8 mois
• SDKs matures : 4 langages, integration 1 ligne
• Narratif AI x Crypto : Parfaitement positionne sur le narratif le plus porteur

Faiblesses

• Pas de token natif : Pas de speculation directe sur le protocole
• Competition feroce : Google AP2, Visa TAP, Stripe ACP arrivent en meme temps
• Settlement stablecoin : Pas d’upside crypto sur le moyen de paiement lui-meme

Opportunites d’investissement

• Pas de token x402 direct — mais l’ecosysteme offre des opportunites :
  • $PAYAI : Facilitateur, 14% de part de marche, forte croissance
  • $DREAMS : Infrastructure agent IA avec x402
  • USDC/Circle : Settlement token dominant
  • $COIN (Coinbase) : Createur du protocole, beneficiaire direct
  • Base ecosystem : Chain de lancement, effets reseau
  • Solana : 49% du volume x402, chain dominante

Tags recommandes

ai, infra, defi, l2, watching, high-conviction (narratif), research-needed (tokens ecosystem)

13. Tweet source

Note : Le tweet https://x.com/programmer/status/2040121218687529275 n’a pas pu etre scrape directement (restrictions d’acces X/Twitter sur les outils de scraping). Le contenu de cette recherche a ete compile a partir de multiples sources web independantes.

Sources

• Coinbase x402 Docs — Bazaar (source principale enrichissement 2026-04-15)
• Coinbase x402 Docs — MCP Server
• Coinbase x402 Docs — Miniapps
• Coinbase x402 Docs — Network Support
• x402.org — Site officiel
• Coinbase x402 Documentation
• GitHub coinbase/x402
• Coinbase — Introducing x402
• CoinDesk — Coinbase AI payments joins Linux Foundation
• CryptoNews — Coinbase & Linux Foundation Debut X402
• Cloudflare Blog — Launching the x402 Foundation
• Cloudflare Agents Docs — x402
• CryptoSlate — What is x402?
• DWF Labs — Inside x402
• Eco.com — x402 Protocol Explained
• Solana — What is x402?
• BlockEden — Agent Payment Protocol War
• HyperTrends — Agentic Payments Comparison
• Google Cloud — AP2 Protocol
• CoinGecko — x402 Ecosystem
• Gate Learn — x402 Protocol Builders
• Bitget — x402 Doers List
• Trust Wallet — What is x402 and PING?
• Tokenist — Coinbase Revenue via x402
• PR Newswire — Linux Foundation x402
• Metaverse Post — EF ERC-8004 + x402
• SolanaFloor — Solana 49% x402 Market Share
• MEXC — Solana narrows gap with Base
• OneKey — x402 vs Stripe
• x402.org — V2 Launch
• Blockchain News — The Graph + x402

Notes atomiques liees

• monetiser-tout-internet-cest-peut-etre-pas-le-progres-quon-imagine — la question ethique que pose x402

Builders applicatifs majeurs

• MeritSystems — éditeur de x402scan (block explorer principal), AgentCash (MCP wallet pour agents, 280+ APIs catalogués), Echo (user-pays AI SDK), Poncho (consumer app x402). Membre additionnel de la x402 Foundation. Représente ~5-10% du volume curated x402 visible (au 9 mai 2026).