Lanzamiento de x402 Foundation con Coinbase y soporte para transacciones x402

Cloudflare se asocia con Coinbase para crear x402 Foundation. La misión de esta fundación será fomentar la adopción del protocolo x402, un marco actualizado que permite a los clientes y servicios intercambiar valor en la web gracias a un lenguaje común. Además de la asociación que presentamos hoy, lanzamos un conjunto de funciones que permitirán a los desarrolladores utilizar x402 en el SDK de Agentes y en nuestras integraciones MCP. Asimismo, proponemos un nuevo sistema de pago aplazado.

Históricamente, los pagos en la web han sido diseñados para los usuarios humanos. Navegamos por el sitio web de un comerciante, expresamos nuestra disposición a comprar añadiendo algunos artículos a un carrito y confirmamos esta intención de compra al indicar la información de nuestra tarjeta de crédito y hacer clic en "Pagar". Sin embargo, ¿y si quieres que se puedan realizar transacciones directas entre servicios digitales? Para ello, necesitamos protocolos que permitan las transacciones entre máquinas. 

Los sitios en Cloudflare envían a diario más de mil millones de códigos de respuesta HTTP 402 a bots y rastreadores que intentan acceder a su contenido y a las tiendas de comercio electrónico. Este código de respuesta incluye un mensaje simple: "Payment Required".

Sin embargo, estas respuestas 402 suelen ser ignoradas. Una de las razones es la falta de estandarización. Sin una especificación sobre cómo formatear y responder a esos códigos de respuesta, los creadores de contenido, los editores y los operadores de sitios web carecen de las herramientas adecuadas para transmitir sus solicitudes de pago. El protocolo x402 puede ofrecer a los desarrolladores un protocolo claro y abierto para que los sitios web y los agentes automatizados negocien los pagos a nivel mundial. 

Coinbase creó el flujo de transacciones x402 (que se describe a continuación) para ayudar a las máquinas a pagar directamente por recursos a través de HTTP:

1. Un cliente intenta acceder a un recurso protegido mediante el protocolo x402. 

2. El servidor responde con el código de estado 402 Payment Required. El cuerpo de la respuesta contiene instrucciones de pago, incluidos el importe y el destinatario del pago.

3. El cliente solicita el recurso protegido mediante el protocolo x402 con el encabezado de autorización de pago.

4. El facilitador de pagos verifica la carga útil del cliente y liquida la transacción.

5. El servidor responde con el recurso solicitado en la respuesta, junto con el encabezado de respuesta de pago que confirma el resultado del pago. 

Este flujo proporciona el acceso mediante programación a los recursos en Internet. Los clientes y los servidores que pueden interpretar el protocolo x402 pueden realizar transacciones sin necesidad de cuentas, suscripciones ni claves API.

El protocolo x402 se puede utilizar para monetizar casos de uso tradicionales, pero también permite la monetización de una nueva clase de escenarios. Por ejemplo:

• Un asistente que puede adquirir accesorios para tu disfraz de Halloween de varios comerciantes.

• Un agente de IA que paga por cada sesión de representación del navegador, en lugar de comprometerse a una tarifa de suscripción mensual.

• Un operador bursátil autónomo que efectúa micropagos por un suministro de datos de alta calidad y en tiempo real para mejorar su toma de decisiones.

En el futuro, las versiones de x402 podrían ser independientes de las infraestructuras de pago, y aceptar tarjetas de crédito y cuentas bancarias además de stablecoins. 

Los agentes y rastreadores suelen requerir dos funciones importantes que ya existen en gran parte de la infraestructura financiera actual: la liquidación aplazada para la resolución de disputas y un pago único y agregado para simplificar su contabilidad. Por ejemplo, los rastreadores que participan en nuestra versión beta privada de pago por rastreo pueden rastrear fácilmente un gran número de páginas y generar registros de auditoría. Posteriormente se les cobrará una tarifa única a través de una tarjeta de crédito o cuenta bancaria vinculada al final del día. 

Para contemplar estos tipos de escenarios de pago, proponemos un nuevo sistema de pago aplazado para el protocolo x402. Este nuevo sistema está diseñado específicamente para pagos de agentes que no requieren una liquidación inmediata y que pueden gestionarse mediante métodos de pago tradicionales o stablecoins. Con esta propuesta de incorporación, ayudamos a garantizar que cualquier servidor compatible pueda opcionalmente desvincular el protocolo de enlace criptográfico de la propia liquidación del pago, y proporcionar así a los agentes y los servidores la capacidad de utilizar acuerdos de licencia prenegociados, liquidaciones por lotes o suscripciones.

Implementaremos este nuevo sistema de pago aplazado para el pago por rastreo a medida que ampliemos y mejoremos la versión beta privada. 

Te presentamos nuestra propuesta inicial para el protocolo de enlace que podría lanzarse en la próxima versión principal del protocolo x402:

Actualmente, cuando un cliente no autenticado o no autorizado intenta acceder a un recurso recibe una respuesta 402 Payment Required. El servidor proporciona una carga útil de compromiso de pago que el cliente puede utilizar para generar una nueva solicitud. Esta respuesta es una oferta legible por una máquina, y nuestra propuesta incluye un nuevo sistema aplazado.

HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "accepts": [
    {
      "scheme": "deferred",
      "network": "example-network-provider",
      "resource": "https://example.com/page",
      "...": "...",
      "extras": {
        "id": "abc123",
        "termsUrl": "https://example.com/terms"
      },
    }
  ]
}

A continuación, el cliente reenvía la solicitud con una carga útil firmada que incluye su compromiso de pago. El sistema aplazado utiliza firmas de mensajes HTTP donde una clave pública con formato JWK está disponible en un directorio alojado. El encabezado Signature-Input explica claramente qué partes de la solicitud se incluyen en Signature para que sirvan como prueba criptográfica de la intención del cliente, verificable por el proveedor de servicios sin una transacción en cadena. 

GET /path/to/resource HTTP/1.1
Host: www.example.com
User-Agent: Mozilla/5.0 Chrome/113.0.0 MyBotCrawler/1.1
Payment:
    scheme="deferred",
    network="example-network-provider",
    id="abc123"
Signature-Agent: signer.example.com
Signature-Input:
    sig=("payment" "signature-agent");
    created=1700000000;
    expires=1700011111;
    keyid="ba3e64==";
    tag="web-bot-auth"
Signature: sig=abc==

El servidor de recursos valida la firma y devuelve el contenido con un encabezado de confirmación. El servidor es responsable de atribuir el pago a la cuenta asociada con la firma del mensaje HTTP, de verificar la identidad del cliente y, por último, de entregar el contenido. En este escenario, no hay ningún blockchain asociado a los pagos. 

HTTP/1.1 200 OK
Content-Type: text/html
Payment-Response:
    scheme="deferred",
    network="example-network-provider",
    id="abc123",
    timestamp=1730872968

Ahora el servidor puede gestionar la liquidación con flexibilidad. El identificador validado del protocolo de enlace funciona como referencia para la transacción. Este enfoque ofrece un modelo de uso flexible sin sobrecarga por solicitud, y permite al servidor acumular los pagos en una suscripción o bien efectuar el pago diario o incluso el pago agrupado. Esto genera un marco flexible donde la confianza criptográfica se establece de inmediato, mientras que la liquidación financiera puede utilizar métodos de pago tradicionales o stablecoins. 

La ejecución de código es lo que permite que un convenio abierto pase de la mera teoría a algo realmente útil y, con el tiempo, a un estándar reconocido. Los agentes desarrollados con el SDK de Agentes de Cloudflare ahora pueden pagar por los recursos con el protocolo x402, y los servidores MCP pueden exponer herramientas para su pago a través de x402. Para mostrarte cómo funciona, hemos creado el entorno de pruebas de x402, una demostración en directo que emplea x402. El entorno de pruebas de x402 funciona con el SDK de Agentes y tiene acceso a las herramientas de los servidores MCP implementados en Cloudflare.

Cuando abras el entorno de pruebas de x402, se creará una nueva cartera, financiada con Testnet USDC, en una testnet de blockchain básica. El agente, creado con el SDK de Agentes, tiene acceso a un servidor MCP con herramientas gratuitas y de pago.

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { McpAgent } from "agents/mcp";
import { withX402 } from "agents/x402";

export class PayMCP extends McpAgent {
  server = withX402(
    new McpServer({ name: "PayMCP", version: "1.0.0" }),
    X402_CONFIG
  );

  async init() {
    // Paid tool
    this.server.paidTool(
      "square",
      "Squares a number",
      0.01, // Tool price
      {
        a: z.number()
      },
      {},
      async ({ number }) => {
        return { content: [{ type: "text", text: String(a ** 2) }] };
      }
    );

    // Free tool
    this.server.tool(
      "add-two-numbers",
      "Adds two numbers",
      {
        a: z.number(),
        b: z.number(),
      },
      async ({ a, b }) => {
        return { content: [{ type: 'text', text: String(a + b) }] };
      }
    );
  }
}

Cuando el agente intenta utilizar una herramienta de pago, el servidor MCP responde con un mensaje 402 Payment Required. El agente puede interpretar las instrucciones de pago y preguntar al usuario humano si desea continuar con la transacción. Para crear un cliente compatible con x402 se requiere un contenedor básico en la llamada a la herramienta:

import { Agent } from "agents";
import { withX402Client } from "agents/x402";

export class MyAgent extends Agent {
  // Your Agent definitions...

  async onToolCall() {

    // Build the x402 client
    const x402Client = withX402Client(
      myMcpClient,
      { network: "base-sepolia", account: this.account }
    );

    // The first parameter becomes the confirmation callback.
    // We can set it to `null` if we want the agent to pay automatically.
    const res = await x402Client.callTool(
      this.onPaymentRequired,
      {
        name: toolName,
        arguments: toolArgs
    });
  }
}

Este agente de prueba retira los fondos de la cartera y envía la carga útil de pago al servidor MCP, que finaliza la transacción. Puedes especificar que las transacciones se ejecuten con o sin confirmación humana, lo que te permite diseñar la interfaz que mejor se adapte a tu aplicación.

Puedes empezar hoy mismo utilizando el SDK de Agentes o implementando tu propio servidor MCP.

Seguiremos colaborando estrechamente con Coinbase para establecer x402 Foundation. No te pierdas los próximos anuncios sobre los detalles específicos de la estructura que ofreceremos en breve.

Creemos en el valor de los protocolos abiertos e interoperables, por lo que animamos a todos a contribuir al protocolo x402 directamente. Si quieres ponerte en contacto con el equipo de Cloudflare dedicado al protocolo x402, envíanos un correo electrónico a x402@cloudflare.com.