Axiom Relay

Un enrutador inteligente x402 para agentes autónomos. Describe la capacidad que necesitas en lugar de una URL; Axiom encuentra un proveedor que realmente funcione, paga al vendedor directamente y devuelve el resultado.

En vivo en la red principal de Base: https://axiom-relay.reference-seller.workers.dev

Por qué existe esto

La mayoría de las herramientas x402 asumen que el agente ya conoce la URL del proveedor. En la práctica no es así — y aproximadamente el 13% de los proveedores x402 anunciados no responden a un desafío válido cuando se les llama realmente (medido en el catálogo en vivo de Coinbase Bazaar). Axiom absorbe ese problema.

intent -> discover candidates -> validate -> rank -> pay -> return result

Related MCP server: pyrimid

Precios

La tarifa es un porcentaje por debajo de ~$16.67 y fija por encima, por lo que una compra de $25 y una de $250 cuestan ambas $0.50.

Sin custodia por construcción

El comprador firma dos autorizaciones independientes: una pagadera directamente al vendedor, otra pagadera a Axiom. Axiom retransmite la autorización del vendedor sin modificación y no puede alterar su importe ni su destino.

• Los fondos del vendedor nunca entran en una dirección controlada por Axiom.

• Axiom no posee ninguna clave de firma — no puede mover tu dinero.

• Exactamente una tarifa de enrutamiento por compra completada, cobrada solo en caso de éxito.

• El respaldo avanza solo con evidencia positiva de que el vendedor anterior no fue pagado; una liquidación ambigua detiene la cadena en lugar de arriesgar un doble pago.

Inicio rápido

npm install axiom-relay

import { Axiom } from 'axiom-relay';
import { x402Client } from '@x402/core/client';
import { registerExactEvmScheme } from '@x402/evm/exact/client';
import { privateKeyToAccount } from 'viem/accounts';

const signer = new x402Client();
registerExactEvmScheme(signer, { signer: privateKeyToAccount(process.env.KEY) });

const axiom = new Axiom({ baseUrl: 'https://axiom-relay.reference-seller.workers.dev' });

const { route, result } = await axiom.buy(signer, 'crypto price', {
  network: 'eip155:8453',
});

console.log(route.selectionReason);
console.log(result.downstream.body);

O con HTTP simple:

curl -sX POST https://axiom-relay.reference-seller.workers.dev/v1/route \
  -H 'content-type: application/json' \
  -d '{"capability":"crypto price","requirements":{"network":"eip155:8453"}}'

Cómo decide el enrutamiento

Determinista, sin aprendizaje, sin preferencia oculta:

score = (50*reliability + 30*price + 10*latency + 10*freshness) / 100

La fiabilidad lidera a propósito — un proveedor barato que falla le cuesta al agente un viaje de ida y vuelta y no le reporta nada a Axiom. Cuando el ganador no es el más barato, la respuesta lo dice y nombra la prima de precio y las cifras de fiabilidad que la superaron. Los empates se rompen por id de proveedor, por lo que el orden es estable.

Integración de máquina

MCP

{
  "mcpServers": {
    "axiom": { "type": "http", "url": "https://axiom-relay.reference-seller.workers.dev/mcp" }
  }
}

Herramientas: find_paid_resource, quote_paid_resource, purchase_paid_resource, check_provider. La capa MCP es un adaptador delgado sobre la API HTTP — no contiene lógica de pago, por lo que las propiedades de seguridad son idénticas.

Ejemplos

Ver examples/: TypeScript puro, MCP, herramientas de OpenAI, Claude Agent Skills, LangChain, Cloudflare Agents y un cliente x402 genérico.

Dos comportamientos que vale la pena conocer

Tarifa exenta. Cuando feePolicy es fee_waived_micropayment, axiomFee es 0 y payTo es null. No firmes una parte de tarifa — no hay nada que autorizar.

Cuota de ruta gratuita. free_route_quota_exhausted (HTTP 429) significa que la compra es válida y el proveedor está sano, pero la asignación de enrutamiento gratuito de Axiom se ha agotado. La respuesta incluye resetsAt. Las compras cuya tarifa es cobrable nunca están limitadas por cuota.

Modelo de seguridad

• x402 v2, esquema exact, USDC en Base.

• Las URL de destino se validan contra SSRF: se rechazan loopback, RFC1918, link-local, metadatos de nube, incrustaciones IPv4-mapped y NAT64, credenciales incrustadas y puertos no web, y cada salto de redirección se revalida de forma independiente.

• La protección contra repetición reclama cada nonce de autorización EIP-3009 atómicamente.

• Un proveedor descubierto es una afirmación no confiable: se verifica el esquema, se valida contra SSRF y se prueba con un desafío en vivo antes de que pueda ser seleccionado.

Estado

En vivo en la red principal de Base con liquidaciones reales. Base Sepolia también es compatible para pruebas. El estado actual siempre se puede consultar en /health.

Licencia

MIT