obol

渡し守に支払え。x402 による Solana エージェントゲートウェイ。

Obol は AI エージェント向けの従量課金制 Solana API です。API キーもサブスクリプションも不要で、エージェントは x402 支払いプロトコル を使用してリクエストごとに USDC で支払います。Solana のサブセント級のトランザクションコストにより、マイクロペイメントが初めて実現可能になりました。

死者の舌に置かれ、ステュクス川を渡るためのカロンへの支払いに使われた硬貨にちなんで名付けられました。元祖マイクロペイメントです。

仕組み

1. エージェントが有料エンドポイントからデータを要求

2. Obol は支払い要件（金額、受取人、ネットワーク）を含む HTTP 402 を返す

3. エージェントは要件に一致する USDC を Solana 上で送信

4. エージェントは X-PAYMENT ヘッダーにトランザクション証明を付けて再試行

5. Obol はオンチェーンで検証し、データを返す

アカウント不要。トークン不要。オンボーディング不要。支払って進むだけです。

Related MCP server: AgentWallet MCP Server

エンドポイント

ウォレット分析

トークンデータ

DeFi

無料

エージェント例

完全なリファレンス実装については examples/agent-client.ts を参照してください。主要なフローは次のとおりです。

import { ObolAgent } from './examples/agent-client';

const agent = new ObolAgent();
await agent.discover();  // fetch pricing
agent.loadWallet(process.env.AGENT_PRIVATE_KEY);

// Auto-discovers price, pays, and returns data
const price = await agent.fetch('/api/v1/token/USDC_MINT/price');

ディスカバリのみのモードで実行（ウォレット不要）：

npx tsx examples/agent-client.ts

MCP サーバー

Obol は MCP サーバーとして提供されます。Model Context Protocol をサポートする AI エージェントは、Obol のツールをネイティブに発見して呼び出すことができます。

npm からインストール

npm install -g obol-mcp

Claude Desktop / Claude Code

MCP 設定に追加：

{
  "mcpServers": {
    "obol": {
      "command": "npx",
      "args": ["-y", "obol-mcp"],
      "env": {
        "OBOL_URL": "https://obol-production.up.railway.app"
      }
    }
  }
}

またはローカルで開発する場合：

{
  "mcpServers": {
    "obol": {
      "command": "npx",
      "args": ["tsx", "/path/to/obol/src/mcp.ts"],
      "env": {
        "OBOL_URL": "http://localhost:3000"
      }
    }
  }
}

利用可能な MCP ツール

ローカルで実行

npm run mcp

スタック

• Fastify 5 — 高性能 HTTP

• @x402/svm — Solana 用公式 x402 SDK

• Helius — RPC + DAS API

• Jupiter — トークン価格 + スワップ実行

• Upstash Redis — キャッシュ + 支払いレシート

• TypeScript — 完全な型安全性

• Zod — ランタイム検証

セットアップ

git clone https://github.com/halfkey/obol.git
cd obol
npm install
cp .env.example .env
# Edit .env with your Helius key and merchant wallet address
npm run dev

テスト

# Unit + integration tests (46 tests)
npm test -- --run

# Smoke test against live deployment
npx tsx scripts/smoke-test.ts https://obol-production.up.railway.app

# Manual payment test
npx tsx scripts/test-payment.ts <tx-signature>

環境

.env.example を参照してください。主な変数：

• PAYMENT_MODE — mock（開発、自動承認）または onchain（本番）

• PAYMENT_RECIPIENT_ADDRESS — USDC を受け取るあなたの Solana ウォレット

• HELIUS_API_KEY — Helius RPC アクセス

• UPSTASH_REDIS_REST_URL / TOKEN — キャッシュレイヤー

ロードマップ

• 有料エンドポイント 11 個（ウォレット、トークン、DeFi、LST、P&L）

• リプレイ防止付きオンチェーン USDC 検証

• テストスイート（vitest 46 件 + 20 項目のスモークテスト）

• エージェントクライアントのリファレンス実装

• GitHub Actions CI

• ウォレット監視用 WebSocket サブスクリプション

• 動的な輻輳ベースの価格設定

• マルチチェーン対応

ライセンス

MIT