obol

Заплати перевозчику. Шлюз для Solana-агентов через x402.

Obol — это Solana API с оплатой за использование для ИИ-агентов. Без API-ключей, без подписок — агенты платят за каждый запрос в USDC, используя протокол платежей x402. Субцентовая стоимость транзакций 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, может нативно обнаруживать и вызывать инструменты 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 — официальный x402 SDK для Solana

• 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 (dev, авто-одобрение) или onchain (продакшн)

• PAYMENT_RECIPIENT_ADDRESS — ваш Solana-кошелёк, который получает USDC

• HELIUS_API_KEY — доступ к Helius RPC

• UPSTASH_REDIS_REST_URL / TOKEN — слой кэша

Дорожная карта

• 11 платных эндпоинтов (кошелёк, токен, DeFi, LST, P&L)

• Проверка USDC в блокчейне с защитой от повторного использования

• Набор тестов (46 vitest + 20-точечный смоук-тест)

• Эталонная реализация клиента агента

• GitHub Actions CI

• Подписки WebSocket для мониторинга кошелька

• Динамическое ценообразование на основе загруженности

• Поддержка нескольких блокчейнов

Лицензия

MIT