Axiom Relay

面向自主智能体的 x402 智能路由器。 描述你所需的能力，而不是 URL；Axiom 会找到真正可用的提供商，直接向卖家付款，并返回结果。

已在 Base 主网上线：https://axiom-relay.reference-seller.workers.dev

为什么存在

大多数 x402 工具假设智能体已经知道提供商的 URL。实际上并非如此——在真实调用时，大约 13% 的已发布 x402 提供商无法回应有效的 challenge（基于 Coinbase Bazaar 在线目录的实测数据）。Axiom 消化了这个问题。

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

Related MCP server: x402-discovery

定价

费用在约 $16.67 以下按百分比收取，以上则为固定金额，因此 $25 和 $250 的购买都只需 $0.50。

非托管设计

买家签署两份独立的授权：一份直接支付给卖家，一份支付给 Axiom。Axiom 原样转发卖家的授权，无法更改其金额或收款方。

• 卖家资金永远不会进入 Axiom 控制的地址。

• Axiom 完全不持有任何签名密钥——它无法动用你的资金。

• 每笔完成的购买只收取一次路由费用，且仅在成功时收取。

• 只有在有确凿证据表明前一个卖家未被支付时，回退才会继续；结算状态不明确时，链条会停止，而不是冒双重支付的风险。

快速开始

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);

或者使用纯 HTTP：

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"}}'

路由如何决策

确定性决策，无学习，无隐藏偏好：

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

可靠性被有意置于首位——一个便宜但失败的提供商会让智能体白跑一趟，Axiom 也一无所获。当胜出者不是最便宜的时，响应会明确说明，并指出价格溢价和使其胜出的可靠性数据。平局时按提供商 ID 排序，因此顺序是稳定的。

机器集成

MCP

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

工具：find_paid_resource、quote_paid_resource、purchase_paid_resource、check_provider。MCP 层是 HTTP API 之上的薄适配层——它不包含任何支付逻辑，因此安全属性完全相同。

示例

参见 examples/：原生 TypeScript、MCP、OpenAI 工具、Claude Agent Skills、LangChain、Cloudflare Agents，以及通用 x402 客户端。

两个值得了解的行为

免除费用。 当 feePolicy 为 fee_waived_micropayment 时，axiomFee 为 0，payTo 为 null。不要签署费用部分——没有需要授权的内容。

免费路由配额。 free_route_quota_exhausted（HTTP 429）表示购买有效且提供商健康，但 Axiom 的免费路由配额已用完。响应中带有 resetsAt。可收取费用的购买永远不会受到配额限制。

安全模型

• x402 v2，exact 方案，Base 上的 USDC。

• 目标 URL 会经过 SSRF 校验：回环地址、RFC1918、链路本地地址、云元数据、IPv4 映射和 NAT64 嵌入、内嵌凭据和非 Web 端口均被拒绝，每个重定向跳转都会独立重新校验。

• 重放保护以原子方式占用每个 EIP-3009 授权的 nonce。

• 发现的提供商被视为不可信声明：必须通过 schema 检查、SSRF 校验，并探测到有效的 challenge，才能被选中。

状态

已在 Base 主网上线并支持真实结算。同时支持 Base Sepolia 用于测试。当前状态可随时在 /health 查看。

许可证

MIT