Axiom Relay

자율 에이전트를 위한 x402 스마트 라우터. URL 대신 필요한 기능을 설명하세요. Axiom이 실제로 작동하는 제공자를 찾아 판매자에게 직접 결제하고 결과를 반환합니다.

Base 메인넷에서 운영 중: https://axiom-relay.reference-seller.workers.dev

왜 만들어졌나

대부분의 x402 도구는 에이전트가 이미 제공자의 URL을 알고 있다고 가정합니다. 하지만 실제로는 그렇지 않습니다. 실제로 광고된 x402 제공자의 약 13%는 실제 호출 시 유효한 챌린지에 응답하지 않습니다 (라이브 Coinbase Bazaar 카탈로그 기준 측정). Axiom이 이 문제를 흡수합니다.

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

Related MCP server: pyrimid

요금

수수료는 약 $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 임베딩, 임베디드 자격 증명, 비웹 포트는 거부되며 모든 리다이렉트 홉은 독립적으로 재검증됩니다.

• 재생 방지는 각 EIP-3009 승인 논스를 원자적으로 점유합니다.

• 발견된 제공자는 신뢰할 수 없는 주장입니다: 스키마 검사, SSRF 검증, 선택 전 라이브 챌린지 프로브를 거칩니다.

상태

실제 정산과 함께 Base 메인넷에서 운영 중입니다. 테스트용으로 Base Sepolia도 지원됩니다. 현재 상태는 항상 /health에서 확인할 수 있습니다.

라이선스

MIT