Passer au contenu principal
INTÉGRATIONS

Intégrez Blockchain0x dans votre pile d'agents.

Code réel pour chaque cadre d'agent populaire. Un paquet expédié là où il existe, une courte recette SDK là où il n'existe pas.

Choisissez votre framework. Là où nous expédions un package, vous l'installez ; sinon, vous enveloppez notre SDK dans l'outil natif de ce framework. Dans tous les cas, c'est une fine couche sur une API HTTP, et vous pouvez l'ignorer et appeler l'API directement.

Chaque carte ouvre une plongée approfondie : l'installation ou la recette, un exemple d'agent fonctionnel, la gestion des webhooks et les pièges courants. Trois sont expédiés comme de véritables paquets aujourd'hui - blockchain0x-langchain et blockchain0x-crewai sur PyPI, et @blockchain0x/mcp sur npm. Les sept autres sont de courtes recettes sur le même SDK. Aucun paquet inventé.

CE QUE CHAQUE INTÉGRATION INCLUT

Une forme cohérente à travers chaque framework.

  • La commande d'installation du package, ou la recette lorsqu'il n'existe pas de package
  • Du code à copier-coller et exécuter, pas du pseudo-code
  • Une réponse courte à 'comment ajouter des paiements à mon agent {framework}'
  • Entrées FAQ avec schéma HowTo/FAQ pour les moteurs de recherche IA
  • Un lien vers la page d'atterrissage longue traîne correspondante
  • Un lien vers la page de tarification
ARCHITECTURE

Chaque intégration est un mince wrapper sur la même API.

Les intégrations Blockchain0x ne sont pas 10 produits distincts. Ce sont 10 surfaces ergonomiques différentes sur une seule API HTTP. L'API est la source de vérité ; les wrappers de framework existent pour vous faire gagner du temps.

Diagramme d'architecture SDK : wrappers de cadre appelant une seule API HTTP Blockchain0x

Chaque enveloppe traduit "la façon dont votre cadre définit un outil" en "un appel HTTP à notre API". C'est tout le travail. Les adaptateurs Python exposent create_blockchain0x_toolset(client), qui fournit à LangChain ou CrewAI un ensemble d'outils prêt à l'emploi. Un cadre sans adaptateur expédié enveloppe createX402Client(...) (Node) ou le client blockchain0x (Python) dans un outil natif de ce cadre. Même API en dessous, de toute façon.

Cela a son importance pour plusieurs raisons. Tout d'abord, vous pouvez mélanger et assortir : un agent de production LangChain et un agent expérimental CrewAI peuvent tous deux cibler le même portefeuille d'agent Blockchain0x sans conflit. Deuxièmement, vous n'êtes pas enfermé dans un choix de cadre par notre intermédiaire ; changer de cadre ne nécessite aucun changement à votre portefeuille, vos politiques de dépenses ou votre page publique. Troisièmement, lorsque nous expédions un nouvel endpoint ou un nouvel événement webhook, les wrappers de cadre l'exposent lors de leur prochaine version ; l'API sous-jacente est le contrat.

SAUTEZ LE SDK

Vous pouvez vous intégrer sans notre SDK, notre wrapper ou notre intégration de cadre.

L'API Blockchain0x est du JSON simple sur HTTPS avec authentification par jeton porteur. N'importe quel client HTTP dans n'importe quel langage peut l'appeler. Les SDK et wrappers de framework officiels sont des couches de commodité ; l'API brute est documentée, stable et intentionnellement assez petite pour que l'écriture manuelle soit raisonnable.

CURL - SANS 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" }
  }'

Lorsque sauter le SDK a du sens

  • Vous êtes dans une langue que nous ne proposons pas. Go, Rust, Elixir, Ruby, PHP, Java - tous peuvent appeler notre API nativement avec leurs bibliothèques HTTP standard. Aucun outil spécial requis.
  • Vous êtes à la limite. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - environnements où vous préféreriez ne pas regrouper une dépendance supplémentaire. L'API brute fonctionne là-bas sans modifications.
  • Vous voulez voir exactement ce qui est sur le fil. Pour le débogage, la révision de sécurité ou l'apprentissage du protocole, la forme HTTP brute est plus claire que la lecture du code source du SDK.
  • Vous avez votre propre couche HTTP avec des tentatives, des journaux, de la télémétrie. L'intégration d'un autre SDK avec son propre comportement de réessai conteste votre infrastructure existante. Appeler l'API brute comme un autre point de terminaison HTTP s'intègre proprement.

La référence complète de l'API à docs.blockchain0x.com inclut la spécification OpenAPI, vous pouvez donc également générer votre propre client dans n'importe quel langage disposant d'un outil de génération de code OpenAPI.

CHOISIR UN FRAMEWORK

Lorsque chaque framework est le bon outil.

Si vous n'avez pas encore choisi de cadre d'agent, voici comment nous voyons les compromis. Aucun de ces choix n'est mauvais ; le bon dépend de ce que fait votre agent et de qui le maintient.

CadreMeilleur quandÉvitez quand
LangChainBase de code LangChain existante, chaînes d'outils complexes, large usage écosystémiqueVous voulez des dépendances minimales ; LangChain en tire beaucoup.
LangGraphWorkflows multi-étapes avec état, exécution durable, human-in-the-loopChaînes linéaires simples ; la surcharge graphique est gaspillée
CrewAISchémas de collaboration multi-agents (chercheur + rédacteur + relecteur)Boucles à agent unique ; CrewAI est construit pour des équipes
AutoGenConversation multi-agents, schémas de chat de groupe, outils MicrosoftProduction à haut débit ; AutoGen optimise pour la recherche
LlamaIndexAgents fortement orientés RAG, Q+A sur documents comme capacité centraleAgents d'utilisation pure des outils ; les forces de LlamaIndex restent inutilisées
OpenAI Agents SDKStacks OpenAI uniquement, veulent l'API d'utilisation des outils la plus proprePiles multi-fournisseurs ; le SDK OpenAI est centré sur OpenAI
Pydantic AITypage fort sur toutes les entrées/sorties des agents, Python-firstStacks orientés TypeScript ; le typage natif Python est la valeur
Semantic KernelBase de code .NET / C# / Java existante, environnement Microsoft entrepriseÉquipes uniquement Python ; vous payez pour une intégration MS inutilisée
AgnoPython-native, léger, avec un overhead d'abstraction minimalVous avez besoin des intégrations tierces de l'écosystème LangChain
MCP middlewareVous exploitez un serveur MCP et souhaitez que les clients paient par appelVous ne gérez pas de serveur MCP (c'est un modèle côté serveur)

Deux conseils pratiques. Si vous partez de zéro et souhaitez la courbe d'apprentissage la plus petite possible, LangChain ou OpenAI Agents SDK sont les choix par défaut les plus sûrs. Si vous avez déjà un cadre, notre intégration fonctionne bien ; ne changez pas de cadre juste pour utiliser Blockchain0x.

GUIDES PLUS APPROFONDIS

Des scénarios spécifiques ont leur propre page.

Au-delà des pages d'intégration spécifiques au cadre, nous publions des guides de longue traîne sur des questions plus étroites : "comment ajouter des paiements à un flux de travail LangGraph multi-étapes", "comment faire en sorte que mon serveur MCP facture par outil", "comment restreindre une API similaire à Stripe derrière un paiement en USDC". Ceux-ci se trouvent à /lp/{slug} et ne sont intentionnellement pas dans la navigation principale. Ils sont trouvés par la recherche ; chacun renvoie à la page d'intégration pertinente.

Où les trouver

Le premier lot de guides de longue traîne est expédié avec les pages du cadre d'intégration. D'ici là, le contenu le plus concret spécifique aux scénarios se trouve dans la documentation à docs.blockchain0x.com sous "Guides". Chaque page /lp/ comprend du code fonctionnel que vous pouvez exécuter et un CTA direct pour mettre à niveau l'agent concerné vers Pro.

QUESTIONS FRÉQUEMMENT POSÉES

Cinq questions d'intégration qui valent la peine d'être répondues.

Si le SDK est optionnel, pourquoi existe-t-il ?

Trois raisons. Premièrement, ergonomie : le SDK génère automatiquement des clés d'idempotence, typifie chaque requête et réponse, et regroupe la vérification de signature de webhook afin que vous ne deviez pas écrire ce code vous-même. Deuxièmement, protection contre les dérives : lorsque nous ajoutons un point de terminaison ou modifions un champ, la prochaine version du SDK l'expose ; les utilisateurs HTTP bruts doivent lire le journal des modifications. Troisièmement, instrumentation : le SDK émet automatiquement des journaux et des métriques structurés dans un format compatible avec les piles d'observabilité courantes. Aucun de ces éléments n'est essentiel, mais ils permettent d'économiser 30 à 90 minutes de temps d'intégration. Si vous préférez voir la forme brute de l'API, passez le SDK et utilisez curl ou tout client HTTP.

J'utilise un framework que vous ne listez pas. Puis-je quand même m'intégrer?

Oui. Chaque intégration repose sur la même petite API REST : agents, paiements, demandes de paiement, transactions, webhooks, plus des autorisations de dépense en lecture seule. L'authentification est un token porteur, les webhooks sont signés avec HMAC-SHA256. Si vous pouvez parler HTTP, vous pouvez vous intégrer depuis n'importe quel framework, y compris ceux sans wrapper expédié - vous enveloppez simplement notre SDK dans l'outil de ce framework. Les pages de framework existent pour la commodité, pas pour le contrôle d'accès. Vous voulez un adaptateur officiel pour votre framework ? Dites-le nous à travers la documentation et nous le peserons par rapport à la demande.

Un agent peut-il être servi par plusieurs intégrations de framework en même temps ?

Oui. Un seul agent a une adresse de portefeuille, un ensemble de clés API, une politique de dépenses et une page publique. Différentes parties de votre pile peuvent appeler notre API via différentes intégrations de framework : un agent LangChain en production, une expérience CrewAI, un middleware de serveur MCP, tous payant le même agent ou tous facturant via le même agent. La frontière du framework est de votre côté ; nous voyons juste des requêtes API authentifiées et des abonnements webhook.

Les intégrations de framework coûtent-elles extra ?

Non. Les adaptateurs expédiés - blockchain0x-langchain et blockchain0x-crewai sur PyPI, et le serveur @blockchain0x/mcp sur npm - sont gratuits, tout comme les SDK. Pour chaque autre framework, il n'y a pas de package supplémentaire à acheter : vous enveloppez le SDK vous-même en quelques lignes. Votre coût est l'abonnement par agent plus les frais de transaction que vous paieriez de toute façon. Installer le package LangChain coûte le même prix que d'appeler l'API avec curl. Le package fait gagner du temps, il ne bloque pas les fonctionnalités.

À quelle vitesse mettez-vous à jour les intégrations lorsque les frameworks publient des changements majeurs?

Pour les adaptateurs expédiés (blockchain0x-langchain, blockchain0x-crewai, @blockchain0x/mcp), nous suivons les cadres que les gens utilisent réellement et mettons à jour lorsque qu'une version majeure est publiée ; nous sommes encore au début et ne promettons pas encore un SLA fixe. Les versions mineures nécessitent généralement aucun changement car les adaptateurs enveloppent des interfaces stables. Les cadres basés sur des recettes bougent à peine ici : ils appellent directement le SDK, donc une mise à jour de cadre touche rarement notre surface. Si un changement majeur rend un adaptateur dangereux, nous le notons sur la page /integrations/ correspondante avant de retirer le support.

Branchez-le, commencez à être payé.

Gratuit pour commencer. Cinq minutes pour votre première demande de paiement.