Skip to main content
Glama

Axiom Relay

Умный маршрутизатор x402 для автономных агентов. Опишите нужную вам возможность вместо URL; Axiom найдёт провайдера, который действительно работает, заплатит продавцу напрямую и вернёт результат.

Работает в основной сети Base: https://axiom-relay.reference-seller.workers.dev

Почему это существует

Большинство инструментов x402 предполагают, что агент уже знает URL провайдера. На практике это не так — и примерно 13% рекламируемых x402-провайдеров не отвечают на действительный вызов при реальном обращении (измерено по живому каталогу Coinbase Bazaar). Axiom берёт эту проблему на себя.

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

Related MCP server: x402-discovery

Цены

Комиссия

3% от цены продавца

Максимум

$0.50 за покупку

Минимум

нет

Микроплатежи

комиссия не взимается, если она слишком мала для расчёта, пока есть свободная ёмкость

Комиссия составляет процент ниже ~$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 ничего. Когда победитель не самый дешёвый, ответ сообщает об этом и указывает ценовую премию и показатели надёжности, которые перевесили. Связи разрешаются по идентификатору провайдера, поэтому порядок стабилен.

Машинная интеграция

Поверхность

Путь

Описание сервиса

/.well-known/x402

OpenAPI 3.1

/openapi.json

Навык агента

/SKILL.md

Навигация для LLM

/llms.txt

Карточка агента A2A

/.well-known/agent-card.json

Манифест MCP

/.well-known/mcp.json

Здоровье

/health

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, LangChain, Cloudflare Agents и универсальный клиент x402.

Два поведения, о которых стоит знать

Не взимаемая комиссия. Когда feePolicy равен fee_waived_micropayment, axiomFee равен 0, а payTo — null. Не подписывайте платёжную часть — авторизовать нечего.

Квота бесплатного маршрута. free_route_quota_exhausted (HTTP 429) означает, что покупка действительна и провайдер здоров, но бесплатный маршрутный лимит Axiom исчерпан. Ответ содержит resetsAt. Покупки, комиссия за которые может быть взимаема, никогда не ограничиваются квотой.

Модель безопасности

  • x402 v2, схема exact, USDC на Base.

  • URL назначения проверяются на SSRF: loopback, RFC1918, link-local, метаданные облака, IPv4-mapped и NAT64-встраивания, встроенные учётные данные и не-веб-порты отклоняются, а каждый переход по редиректу повторно проверяется независимо.

  • Защита от повторного использования атомарно заявляет каждый nonce авторизации EIP-3009.

  • Обнаруженный провайдер — это непроверенное утверждение: проверяется по схеме, валидируется на SSRF и проверяется на живой вызов, прежде чем может быть выбран.

Статус

Работает в основной сети Base с реальными расчётами. Base Sepolia также поддерживается для тестирования. Текущее состояние всегда доступно по адресу /health.

Лицензия

MIT

Related MCP Connectors

Related MCP Servers