Passer au contenu principal
GUIDES

Guides longs avec code fonctionnel.

Huit guides phares. Chacune vous guide des prérequis au déploiement, avec du code à copier-coller en TypeScript et Python et les pièges courants clairement indiqués.

À QUOI RESSEMBLE UN GUIDE

Chaque guide a la même forme.

Nous avons choisi un modèle strict car la forme incohérente des tutoriels concurrents est ce qui les rend difficiles à utiliser. Chaque guide Blockchain0x commence par un paragraphe de réponse de 60 mots (ce que les moteurs de recherche IA extraient pour les citations), puis les prérequis, puis des étapes numérotées avec du code, puis des pièges courants, puis une section des prochaines étapes qui renvoie aux entrées de glossaire pertinentes et aux pages de produits.

L'objectif de nombre de mots par guide est de 1800+. C'est à l'extrémité longue de ce que la plupart des lecteurs parcourent réellement, mais c'est délibéré : des tutoriels superficiels vous obligent à déboguer les détails manquants. Nos guides expliquent les cas particuliers afin que vous n'ayez pas à le faire.

Every guide is code-tested against current Blockchain0x API behavior. When the API ships a breaking change, we update the guides in the same release. Each entry has a "last reviewed" date visible at the top.

LES 8 GUIDES PHARES

Choisissez celui qui correspond à la tâche d'aujourd'hui.

Comment ajouter des paiements à votre agent IA

Le guide de bout en bout. Créez votre wallet, installez le SDK, demandez votre premier paiement USDC, gérez le webhook. Fonctionne avec LangChain, CrewAI, AutoGen, LlamaIndex, OpenAI Agents SDK et les serveurs MCP.

10 minutes lu

Monétisez votre serveur MCP en 10 minutes

Transformez un serveur MCP à trafic gratuit en service payant. Utilisez requirePayment pour construire le challenge x402, protégez vos outils avec votre propre paid-state, vérifiez les webhooks. Inclut le pattern paid-window (un TTL sur Redis ou Postgres) pour la production.

10 minutes lu

Mettre en place des contrôles de dépenses d'agent qui survivent à l'injection d'invite

Plafonds par transaction et allocations par période, définis dans le tableau de bord et appliqués au niveau de l'API. Pourquoi l'application au niveau de l'API est supérieure aux règles dans le code de l'agent. Exemples concrets d'un agent atteignant un plafond.

8 minutes lu

Gagnez les badges de vérification GitHub et domaine

Passez en revue les deux flux de vérification. Configuration de GitHub OAuth, format d'enregistrement DNS TXT, comportement de re-vérification mensuelle. Montre ce que voient les contreparties lorsqu'elles survolent le badge sur la page publique de votre agent.

8 minutes lu

Les modèles de webhook dont les développeurs parlent le plus

Vérification de signature (HMAC-SHA256 en temps constant), idempotence en cas de retry, balayage planifié des paiements qui n'arrivent jamais, reprise après paiement via des files de jobs. Inclut des patterns pour Celery, arq et Bull.

15 minutes lu

Testez les paiements d'agents sans argent réel

Utilisation de clés de test et du testnet Base Sepolia. Comment alimenter un wallet de test depuis le faucet, exécuter le cycle de vie complet du paiement et valider la livraison des webhooks avant le passage en production. Plus les différences entre le comportement de test et de production.

12 minutes lu

Migrer de Stripe vers Blockchain0x pour un accès API piloté par l'agent

Run Stripe alongside Blockchain0x: humans pay via Stripe Checkout; agents pay via 402 Payment Required. Includes the x402 adapter that bills agents on priced routes while humans keep their Stripe path.

20 minutes lu

Sécurisez votre portefeuille d'agent avant de passer en direct

Liste de contrôle de sécurité pré-vol. Choix du fournisseur de wallet (smart wallet vs EOA), dimensionnement des autorisations de dépense, cadence de rotation des clés API, hygiène des secrets de webhook, revue d'audit et mise en place du runbook de réponse aux incidents.

15 minutes lu

Les guides sont publiés chaque semaine, priorisés par ce que les clients demandent dans le support. Si un sujet dont vous avez besoin est manquant, le chemin le plus rapide est de commencer à utiliser Blockchain0x et de nous dire ce qui vous a bloqué - cela devient le prochain guide.

CHOISIR PAR FORME

Quel guide en premier.

  • First time using Blockchain0x: "How to add payments to your AI agent" - the end-to-end flow.
  • Running an MCP server: "Monetize your MCP server in 10 minutes" - the requirePayment flow.
  • About to go to production: "Secure your agent wallet before going live" - the pre-flight checklist.
  • Worried about safety: "Set up agent spend controls that survive prompt injection" - API-layer spend permissions.
  • Migrating from Stripe: "Migrate from Stripe to Blockchain0x for agent-driven API access" - the dual-checkout pattern.

Les guides se lient généreusement : la plupart d'entre eux font référence à au moins une entrée de glossaire (pour le vocabulaire), une page produit (pour les détails des fonctionnalités) et au moins un autre guide (pour la prochaine étape logique). Vous pouvez lire 2-3 guides comme un chemin cohérent plutôt que de traiter chacun comme isolé.

AUTRES ÉTAGÈRES

Vocabulaire d'abord, puis guides, puis comparaisons.

Si un terme dans un guide est inconnu, le glossaire le définit de manière canonique. Si vous choisissez Blockchain0x par rapport à d'autres alternatives, les comparaisons passent en revue les compromis de manière honnête.

Lisez pendant que vous construisez.

Chaque guide est livré avec du code à copier-coller. Inscrivez-vous gratuitement et appliquez-le directement.