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, 손익)

• 재생 방지가 포함된 온체인 USDC 검증

• 테스트 스위트 (vitest 46개 + 20포인트 스모크 테스트)

• 에이전트 클라이언트 참조 구현

• GitHub Actions CI

• 지갑 모니터링을 위한 WebSocket 구독

• 동적 혼잡 기반 가격 책정

• 멀티체인 지원

라이선스

MIT