obol

Zahle dem Fährmann. Solana-Agenten-Gateway über x402.

Obol ist eine nutzungsbasierte Solana-API für KI-Agenten. Keine API-Schlüssel, keine Abonnements – Agenten zahlen pro Anfrage in USDC über das x402-Zahlungsprotokoll. Solanas Transaktionskosten im Sub-Cent-Bereich machen Mikrozahlungen zum ersten Mal praktikabel.

Benannt nach der Münze, die den Toten auf die Zunge gelegt wurde, um Charon für die Überfahrt über den Fluss Styx zu bezahlen. Die ursprüngliche Mikrozahlung.

So funktioniert es

1. Agent fordert Daten von einem kostenpflichtigen Endpunkt an

2. Obol antwortet mit HTTP 402 und einer Zahlungsanforderung (Betrag, Empfänger, Netzwerk)

3. Agent sendet USDC auf Solana, das der Anforderung entspricht

4. Agent wiederholt mit Transaktionsnachweis im X-PAYMENT-Header

5. Obol verifiziert on-chain und gibt die Daten zurück

Keine Konten. Keine Token. Kein Onboarding. Einfach zahlen und loslegen.

Related MCP server: AgentWallet MCP Server

Endpunkte

Wallet-Analysen

Token-Daten

DeFi

Kostenlos

Agenten-Beispiel

Siehe examples/agent-client.ts für eine vollständige Referenzimplementierung. Der Schlüsselablauf:

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');

Im Nur-Entdeckungsmodus ausführen (keine Wallet erforderlich):

npx tsx examples/agent-client.ts

MCP-Server

Obol wird als MCP-Server ausgeliefert – jeder KI-Agent, der das Model Context Protocol unterstützt, kann Obols Tools nativ entdecken und aufrufen.

Installation von npm

npm install -g obol-mcp

Claude Desktop / Claude Code

Fügen Sie zu Ihrer MCP-Konfiguration hinzu:

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

Oder wenn Sie lokal entwickeln:

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

Verfügbare MCP-Tools

Lokal ausführen

npm run mcp

Stack

• Fastify 5 – Hochleistungs-HTTP

• @x402/svm – offizielles x402-SDK für Solana

• Helius – RPC + DAS-API

• Jupiter – Token-Preise + Swap-Ausführung

• Upstash Redis – Cache + Zahlungsbelege

• TypeScript – volle Typsicherheit

• Zod – Laufzeitvalidierung

Einrichtung

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

Testen

# 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>

Umgebung

Siehe .env.example. Wichtige Variablen:

• PAYMENT_MODE – mock (Entwicklung, automatische Genehmigung) oder onchain (Produktion)

• PAYMENT_RECIPIENT_ADDRESS – Ihre Solana-Wallet, die USDC empfängt

• HELIUS_API_KEY – Helius-RPC-Zugriff

• UPSTASH_REDIS_REST_URL / TOKEN – Cache-Schicht

Roadmap

• 11 kostenpflichtige Endpunkte (Wallet, Token, DeFi, LST, P&L)

• On-chain-USDC-Verifizierung mit Replay-Schutz

• Test-Suite (46 Vitest + 20-Punkte-Smoke-Test)

• Referenzimplementierung des Agenten-Clients

• GitHub Actions CI

• WebSocket-Abonnements für Wallet-Überwachung

• Dynamische Preise basierend auf Netzwerkauslastung

• Multi-Chain-Unterstützung

Lizenz

MIT