Zum Hauptinhalt springen
INTEGRATIONEN

Integrieren Sie Blockchain0x in Ihren Agenten-Stack.

Echter Code für jedes beliebte Agenten-Framework. Ein ausgeliefertes Paket, wo es existiert, ein kurzes SDK-Rezept, wo es nicht existiert.

Wählen Sie Ihr Framework. Wo wir ein Paket ausliefern, installieren Sie es; andernfalls wickeln Sie unser SDK in das native Werkzeug dieses Frameworks ein. So oder so ist es eine dünne Schicht über einer HTTP-API, und Sie können es überspringen und die API direkt aufrufen.

Jede Karte öffnet einen tiefen Einblick: die Installation oder das Rezept, ein funktionierendes Agentenbeispiel, Webhook-Verarbeitung und häufige Fallstricke. Drei werden heute als echte Pakete versendet - blockchain0x-langchain und blockchain0x-crewai auf PyPI sowie @blockchain0x/mcp auf npm. Die anderen sieben sind kurze Rezepte über dasselbe SDK. Kein erfundenes Paket.

WAS JEDER INTEGRATION ENTHÄLT

Eine konsistente Form über jedes Framework hinweg.

  • Der Installationsbefehl für das Paket oder das Rezept, wenn kein Paket vorhanden ist
  • Code zum Copy-Paste und Ausführen, kein Pseudocode
  • Eine kurze Antwort auf die Frage 'Wie füge ich meinem {framework}-Agenten Zahlungen hinzu'
  • FAQ-Einträge mit HowTo/FAQ-Schema für AI-Suchmaschinen
  • Ein Link zur passenden Long-Tail-Landing-Page
  • Ein Link zur Preisseite
ARCHITEKTUR

Jede Integration ist ein dünner Wrapper über die gleiche API.

Die Blockchain0x-Integrationen sind keine 10 separaten Produkte. Sie sind 10 verschiedene ergonomische Oberflächen auf einer einzigen HTTP-API. Die API ist die Quelle der Wahrheit; die Framework-Wrapper existieren, um Ihnen Zeit zu sparen.

SDK-Architekturdiagramm: Framework-Wrapper, die eine einzelne Blockchain0x HTTP-API aufrufen

Jeder Wrapper übersetzt von "der Art und Weise, wie Ihr Framework ein Tool definiert" in "einen HTTP-Aufruf an unsere API". Das ist die gesamte Aufgabe. Die Python-Adapter stellen create_blockchain0x_toolset(client) bereit, das LangChain oder CrewAI ein fertiges Set von Tools übergibt. Ein Framework ohne einen ausgelieferten Adapter umschließt createX402Client(...) (Node) oder den blockchain0x Client (Python) in ein natives Tool dieses Frameworks. Die API ist in beiden Fällen identisch.

Das ist aus mehreren Gründen wichtig. Erstens können Sie mischen und anpassen: Ein LangChain-Produktionsagent und ein CrewAI-Experimentieragent können beide dasselbe Blockchain0x-Agenten-Wallet ohne Konflikte anvisieren. Zweitens sind Sie durch uns nicht an eine Rahmenwahl gebunden; der Wechsel von Rahmen erfordert keine Änderung Ihres Wallets, Ihrer Ausgabenrichtlinien oder Ihrer öffentlichen Seite. Drittens, wenn wir einen neuen Endpunkt oder ein neues Webhook-Ereignis bereitstellen, geben die Rahmenhüllen es in ihrer nächsten Veröffentlichung bekannt; die zugrunde liegende API ist der Vertrag.

SDK ÜBERSPRINGEN

Sie können integrieren, ohne unser SDK, unseren Wrapper oder unsere Framework-Integration zu verwenden.

Die Blockchain0x API ist einfaches JSON über HTTPS mit Bearer-Token-Auth. Jeder HTTP-Client in jeder Sprache kann sie aufrufen. Die offiziellen SDKs und Framework-Wrapper sind Komfortschichten; die rohe API ist dokumentiert, stabil und absichtlich klein genug, dass das manuelle Schreiben dagegen sinnvoll ist.

CURL - KEIN SDK
curl -X POST https://api.blockchain0x.com/v1/payments \
  -H "Authorization: Bearer $BLOCKCHAIN0X_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId":   "<your-agent-id>",
    "to":        "0xRecipientAddress",
    "amountWei": "100000",
    "metadata":  { "reason": "Custom market analysis" }
  }'

Wann es sinnvoll ist, das SDK zu überspringen

  • Sie befinden sich in einer Sprache, die wir nicht unterstützen. Go, Rust, Elixir, Ruby, PHP, Java - all diese können unsere API nativ mit ihren Standard-HTTP-Bibliotheken aufrufen. Keine speziellen Werkzeuge erforderlich.
  • Sie sind am Rande. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - Umgebungen, in denen Sie lieber keine zusätzliche Abhängigkeit bündeln möchten. Die rohe API funktioniert dort ohne Änderungen.
  • Sie möchten genau sehen, was über das Netzwerk läuft. Für Debugging, Sicherheitsüberprüfungen oder das Erlernen des Protokolls ist die rohe HTTP-Form klarer als das Lesen des SDK-Quellcodes.
  • Sie haben Ihre eigene HTTP-Schicht mit Wiederholungen, Protokollierung, Telemetrie. Das Einbringen eines anderen SDK mit eigenem Wiederholverhalten kämpft gegen Ihre bestehende Infrastruktur. Das Aufrufen der Roh-API als einfach einen weiteren HTTP-Endpunkt fügt sich sauber ein.

Die vollständige API-Referenz unter docs.blockchain0x.com enthält die OpenAPI-Spezifikation, sodass Sie auch Ihren eigenen Client in jeder Sprache generieren können, die ein OpenAPI-Codegenerierungstool hat.

EIN FRAMEWORK AUSWÄHLEN

Wann jedes Framework das richtige Werkzeug ist.

Wenn Sie noch kein Agenten-Framework ausgewählt haben, sehen Sie hier, wie wir die Vor- und Nachteile einschätzen. Keine dieser Entscheidungen ist falsch; die richtige hängt davon ab, was Ihr Agent tut und wer ihn pflegt.

FrameworkAm besten, wennVermeiden, wenn
LangChainBestehende LangChain-Codebasis, komplexe Tool-Chains, breite Nutzung im ÖkosystemSie möchten minimale Abhängigkeiten; LangChain zieht viel mit sich
LangGraphStateful Multi-Step-Workflows, dauerhafte Ausführung, Human-in-the-loopEinfache lineare Ketten; der Graph-Overhead ist verschwendet
CrewAIMulti-Agent-Zusammenarbeitsmuster (Researcher + Writer + Reviewer)Einzel-Agenten-Schleifen; CrewAI ist für Crews gebaut
AutoGenMulti-Agent-Konversation, Gruppenchat-Muster, Microsoft-ToolingProduktionshohe Durchsatzrate; AutoGen optimiert für Forschung
LlamaIndexRAG-lastige Agents, Dokumenten-Q&A als KernfunktionReine Werkzeugnutzungsagenten; die Stärken von LlamaIndex bleiben ungenutzt
OpenAI Agents SDKNur-OpenAI-Stacks, wünschen sich die sauberste Tool-Use-APIMulti-Provider-Stacks; OpenAI SDK ist OpenAI-zentriert
Pydantic AIStrikte Typisierung über alle Agenten-Ein- und Ausgaben hinweg, Python-firstTypeScript-first Stacks; die Python-native Typisierung ist der Wert
Semantic KernelBestehende .NET / C# / Java-Codebasis, Enterprise-Microsoft-UmgebungPython-only-Teams; Sie zahlen für ungenutzte MS-Integration
AgnoPython-nativ, schlank, minimaler Abstraktions-Overhead gewünschtSie benötigen die Drittanbieter-Integrationen des LangChain-Ökosystems
MCP middlewareDu betreibst einen MCP-Server und möchtest, dass Clients pro Aufruf bezahlenSie betreiben keinen MCP-Server (es ist ein serverseitiges Muster)

Zwei praktische Ratschläge. Wenn Sie von Grund auf neu beginnen und die kleinste mögliche Lernkurve wünschen, sind LangChain oder OpenAI Agents SDK die sichersten Standardoptionen. Wenn Sie bereits ein Framework haben, funktioniert unsere Integration dafür gut; wechseln Sie nicht das Framework nur, um Blockchain0x zu verwenden.

TIEFERE LEITFÄDEN

Spezifische Szenarien erhalten ihre eigene Seite.

Über die integrationsspezifischen Seiten hinaus veröffentlichen wir Long-Tail-Leitfäden zu spezifischeren Fragen: "Wie füge ich Zahlungen zu einem LangGraph-Multi-Step-Workflow hinzu?", "Wie lasse ich meinen MCP-Server pro Tool Gebühren erheben?", "Wie schränke ich eine Stripe-ähnliche API hinter einer USDC-Zahlung ein?" Diese befinden sich unter /lp/{slug} und sind absichtlich nicht in der Hauptnavigation. Sie werden über die Suche gefunden; jeder Link verweist auf die relevante Integrationsseite.

Wo man sie findet

Die erste Charge von Long-Tail-Guides wird zusammen mit den Seiten des Integrationsframeworks bereitgestellt. Bis dahin befinden sich die konkretesten, szenariospezifischen Inhalte in den Dokumenten unter docs.blockchain0x.com unter "Guides". Jede /lp/-Seite enthält funktionierenden Code, den Sie ausführen können, und einen direkten CTA, um den entsprechenden Agenten auf Pro zu aktualisieren.

HÄUFIG GESTELLTE FRAGEN

Fünf Integrationsfragen, die es wert sind, beantwortet zu werden.

Wenn das SDK optional ist, warum existiert es dann überhaupt?

Drei Gründe. Erstens, Ergonomie: Das SDK generiert automatisch Idempotenzschlüssel, typisiert jede Anfrage und Antwort und bündelt die Überprüfung der Webhook-Signatur, sodass Sie diesen Code nicht selbst schreiben müssen. Zweitens, Drift-Schutz: Wenn wir einen Endpunkt hinzufügen oder ein Feld ändern, wird es in der nächsten SDK-Version offengelegt; rohe HTTP-Benutzer müssen das Änderungsprotokoll lesen. Drittens, Instrumentierung: Das SDK gibt automatisch strukturierte Protokolle und Metriken in einem Format aus, das mit gängigen Beobachtungsstacks kompatibel ist. Keines davon ist essentiell, aber sie sparen 30-90 Minuten Integrationszeit. Wenn Sie lieber die rohe Form der API sehen möchten, überspringen Sie das SDK und verwenden Sie curl oder einen beliebigen HTTP-Client.

Ich verwende ein Framework, das Sie nicht auflisten. Kann ich trotzdem integrieren?

Ja. Jede Integration sitzt auf derselben kleinen REST-API: Agenten, Zahlungen, Zahlungsanforderungen, Transaktionen, Webhooks sowie Lesezugriffsberechtigungen. Auth ist ein Bearer-Token, Webhooks sind mit HMAC-SHA256 signiert. Wenn Sie HTTP sprechen können, können Sie aus jedem Framework integrieren, einschließlich solchen ohne gelieferten Wrapper - Sie umhüllen einfach unser SDK in das eigene Tool dieses Frameworks. Die Framework-Seiten existieren zur Bequemlichkeit, nicht zur Zugangskontrolle. Möchten Sie einen offiziellen Adapter für Ihr Framework? Sagen Sie uns über die Dokumentation Bescheid, und wir werden es gegen die Nachfrage abwägen.

Kann ein Agent gleichzeitig von mehreren Framework-Integrationen bedient werden?

Ja. Ein einzelner Agent hat eine Wallet-Adresse, einen Satz von API-Schlüsseln, eine Ausgabenrichtlinie und eine öffentliche Seite. Verschiedene Teile Ihres Stacks können unsere API über verschiedene Framework-Integrationen aufrufen: ein LangChain-Agent in der Produktion, ein CrewAI-Experiment, eine MCP-Server-Middleware, die alle denselben Agenten bezahlen oder alle über denselben Agenten abrechnen. Die Rahmenbedingung liegt auf Ihrer Seite; wir sehen nur authentifizierte API-Anfragen und Webhook-Abonnements.

Kostet die Integration der Frameworks extra?

Nein. Die ausgelieferten Adapter - blockchain0x-langchain und blockchain0x-crewai auf PyPI und der @blockchain0x/mcp-Server auf npm - sind kostenlos, und das gilt auch für die SDKs. Für jedes andere Framework gibt es kein zusätzliches Paket zu kaufen: Sie wickeln das SDK selbst in wenigen Zeilen ein. Ihre Kosten sind das Abonnement pro Agent plus die Transaktionsgebühren, die Sie so oder so zahlen würden. Die Installation des LangChain-Pakets kostet dasselbe wie der Aufruf der API mit curl. Das Paket spart Zeit, es schränkt keine Funktionen ein.

Wie schnell aktualisieren Sie Integrationen, wenn Frameworks breaking Changes ausliefern?

Für die ausgelieferten Adapter (blockchain0x-langchain, blockchain0x-crewai, @blockchain0x/mcp) verfolgen wir die Frameworks, die die Leute tatsächlich verwenden, und aktualisieren, wenn eine Hauptversion veröffentlicht wird; wir sind früh und versprechen noch keinen festen SLA. Kleinere Versionen benötigen in der Regel keine Änderung, da die Adapter stabile Schnittstellen umschließen. Die rezeptbasierten Frameworks bewegen sich hier kaum: sie rufen das SDK direkt auf, sodass ein Framework-Upgrade selten unsere Oberfläche berührt. Wenn eine breaking change einen Adapter unsicher macht, vermerken wir dies auf der entsprechenden /integrations/-Seite, bevor wir den Support zurückziehen.

Stecken Sie es ein, fangen Sie an, bezahlt zu werden.

Kostenlos starten. Fünf Minuten bis zu Ihrer ersten Zahlungsanforderung.