Axiom Relay

自律エージェント向けのx402スマートルーター。 URLの代わりに必要な機能を記述してください。Axiomは実際に動作するプロバイダーを見つけ、売り手に直接支払い、結果を返します。

Baseメインネットで稼働中: https://axiom-relay.reference-seller.workers.dev

なぜ存在するのか

ほとんどのx402ツールは、エージェントがプロバイダーのURLをすでに知っていることを前提としています。実際にはそうではなく、ライブのCoinbase Bazaarカタログ全体で測定したところ、実際に呼び出されたとき、宣伝されているx402プロバイダーの約13%が有効なチャレンジに応答しません。Axiomはその問題を吸収します。

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

Related MCP server: x402-discovery

料金

手数料は~$16.67未満ではパーセンテージ、それ以上では定額です。したがって、$25の購入と$250の購入はどちらも$0.50かかります。

非カストディアルな設計

購入者は2つの独立した承認に署名します。1つは売り手に直接支払われるもの、もう1つはAxiomに支払われるものです。Axiomは売り手の承認を変更せずに中継し、その金額や宛先を変更することはできません。

• 売り手の資金がAxiom管理のアドレスに入ることはありません。

• Axiomは署名鍵を一切保持しません — あなたのお金を動かすことはできません。

• 完了した購入ごとに正確に1つのルーティング手数料がかかり、成功した場合のみ請求されます。

• フォールバックは、前の売り手が支払われなかったという肯定的な証拠がある場合にのみ進行します。曖昧な決済は、二重支払いのリスクを冒すのではなく、チェーンを停止します。

クイックスタート

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クライアント。

知っておくべき2つの動作

免除された手数料。 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承認ノンスを原子的に要求します。

• 発見されたプロバイダーは信頼できない主張です: スキーマチェック、SSRF検証、ライブチャレンジのプローブが行われてから選択できます。

ステータス

Baseメインネットで実際の決済とともに稼働中。テスト用にBase Sepoliaもサポートされています。現在の状態は常に /health で確認できます。

ライセンス

MIT