Conecta Blockchain0x a tu pila de agentes.
Código real para cada marco de agente popular. Un paquete enviado donde existe, una receta corta de SDK donde no existe.
Elige tu framework. Donde enviamos un paquete lo instalas; de lo contrario, envuelves nuestro SDK en la herramienta nativa de ese framework. De cualquier manera, es una capa delgada sobre una API HTTP, y puedes omitirla y llamar a la API directamente.
Cada tarjeta abre un análisis profundo: la instalación o la receta, un ejemplo de agente funcional, manejo de webhook y trampas comunes. Tres se envían como paquetes reales hoy - blockchain0x-langchain y blockchain0x-crewai en PyPI, y @blockchain0x/mcp en npm. Los otros siete son recetas cortas sobre el mismo SDK. No hay paquete inventado.
Diez frameworks. Tres paquetes, siete recetas, una API.
LangChain
Paquete de PyPIConjunto de herramientas de Python del paquete blockchain0x-langchain; los agentes de TypeScript envuelven al cliente x402
CrewAI
Paquete de PyPIConjunto de herramientas de Python de blockchain0x-crewai, la misma forma de fábrica que LangChain
AutoGen
Receta de SDKReceta: envolver el SDK en una herramienta de función AutoGen
LlamaIndex
Receta de SDKReceta: envolver el cliente en un FunctionTool de LlamaIndex
OpenAI Agents SDK
Receta de SDKReceta: envolver el cliente en una herramienta de función del SDK de OpenAI Agents
Pydantic AI
Receta de SDKReceta: registrar una herramienta Pydantic AI que llama al cliente
LangGraph
Receta de SDKReceta: un nodo LangGraph que llama al cliente x402
Semantic Kernel
Receta de SDKReceta: una KernelFunction que envuelve el SDK; sin adaptador NuGet o Java
Agno
Receta de SDKReceta: un Agno Toolkit que envuelve el cliente de Python
MCP servers
paquete npmHerramientas de billetera para cualquier cliente MCP a través del servidor @blockchain0x/mcp
Agent Skill
Agent SkillOne installable Agent Skill that teaches any AI agent the whole wallet integration surface; portable or via the Claude Code plugin marketplace
Una forma consistente en todos los frameworks.
- El comando de instalación del paquete, o la receta cuando no existe un paquete
- Código para copiar y pegar que puedes ejecutar, no pseudocódigo
- Una respuesta breve a 'how do I add payments to my {framework} agent'
- Entradas de FAQ con esquema HowTo/FAQ para motores de búsqueda de AI
- Un enlace a la landing page de long tail correspondiente
- Un enlace a la página de precios
Cada integración es una delgada envoltura sobre la misma API.
Las integraciones de Blockchain0x no son 10 productos separados. Son 10 superficies ergonómicas diferentes sobre una única API HTTP. La API es la fuente de verdad; los envoltorios de framework existen para ahorrarte tiempo.
Cada envoltura traduce de "la forma en que tu marco define una herramienta" a "una llamada HTTP a nuestra API". Ese es el trabajo completo. Los adaptadores de Python exponen create_blockchain0x_toolset(client), que entrega a LangChain o CrewAI un conjunto de herramientas listas para usar. Un marco sin un adaptador enviado envuelve createX402Client(...) (Node) o el cliente blockchain0x (Python) en una herramienta nativa de ese marco. La misma API por debajo, de cualquier manera.
Esto es importante por varias razones. Primero, puede mezclar y combinar: un agente de producción de LangChain y un agente experimental de CrewAI pueden ambos dirigirse a la misma billetera de agente de Blockchain0x sin conflicto. Segundo, no está bloqueado en una elección de marco a través de nosotros; cambiar de marcos no requiere ningún cambio en su billetera, sus políticas de gasto o su página pública. Tercero, cuando lanzamos un nuevo endpoint o un nuevo evento de webhook, los envoltorios del marco lo exponen en su próxima versión; la API subyacente es el contrato.
Puedes integrar sin nuestro SDK, nuestro envoltorio o nuestra integración de marco.
La API de Blockchain0x es JSON simple sobre HTTPS con autenticación de token portador. Cualquier cliente HTTP en cualquier lenguaje puede llamarla. Los SDK oficiales y los envoltorios de framework son capas de conveniencia; la API en bruto está documentada, es estable y deliberadamente lo suficientemente pequeña como para que escribir contra ella sea razonable.
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" } }'
Cuando omitir el SDK tiene sentido
- Estás en un idioma que no ofrecemos. Go, Rust, Elixir, Ruby, PHP, Java - todos estos pueden llamar a nuestra API de forma nativa con sus bibliotecas HTTP estándar. No se requiere ninguna herramienta especial.
- Estás en el límite. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - entornos donde preferirías no agrupar una dependencia adicional. La API en bruto funciona allí sin cambios.
- Quieres ver exactamente lo que está en la red. Para depuración, revisión de seguridad o aprendizaje del protocolo, la forma HTTP sin procesar es más clara que leer el código fuente del SDK.
- Tienes tu propia capa HTTP con reintentos, registro y telemetría. Incorporar otro SDK con su propio comportamiento de reintento lucha contra tu infraestructura existente. Llamar a la API en bruto como solo otro punto final HTTP se integra limpiamente.
La referencia completa de la API en docs.blockchain0x.com incluye la especificación OpenAPI, por lo que también puedes generar tu propio cliente en cualquier lenguaje que tenga una herramienta de generación de código OpenAPI.
Cuando cada framework es la herramienta adecuada.
Si aún no has elegido un marco de agente, aquí te mostramos cómo vemos los pros y contras. Ninguna de estas son elecciones incorrectas; la correcta depende de lo que haga tu agente y quién lo mantenga.
| Marco | Mejor cuando | Evitar cuando |
|---|---|---|
| LangChain | Base de código existente en LangChain, cadenas de herramientas complejas, uso amplio del ecosistema | Quieres dependencias mínimas; LangChain trae muchas |
| LangGraph | Flujos de trabajo de varios pasos con estado, ejecución duradera, human-in-the-loop | Cadenas lineales simples; la sobrecarga del gráfico se desperdicia |
| CrewAI | Patrones de colaboración multiagente (investigador + redactor + revisor) | Bucles de agente único; CrewAI está construido para equipos |
| AutoGen | Conversación multiagente, patrones de chat grupal, herramientas de Microsoft | Producción de alto rendimiento; AutoGen optimiza para la investigación |
| LlamaIndex | Agentes con fuerte uso de RAG, preguntas y respuestas sobre documentos como capacidad central | Agentes de uso puramente de herramientas; las fortalezas de LlamaIndex no se utilizan |
| OpenAI Agents SDK | Stacks solo de OpenAI, quieren la API de uso de herramientas más limpia | Pilotes de múltiples proveedores; el SDK de OpenAI es centrado en OpenAI |
| Pydantic AI | Tipado estricto en todas las entradas y salidas del agente, priorizando Python | Pilotos primero de TypeScript; la tipificación nativa de Python es el valor |
| Semantic Kernel | Base de código existente en .NET / C# / Java, entorno empresarial de Microsoft | Equipos solo de Python; estás pagando por una integración de MS no utilizada |
| Agno | Nativo de Python, ligero, con mínima sobrecarga de abstracción | Necesitas las integraciones de terceros del ecosistema LangChain |
| MCP middleware | Estás ejecutando un servidor MCP y quieres que los clientes paguen por llamada | No estás ejecutando un servidor MCP (es un patrón del lado del servidor) |
Dos consejos prácticos. Si está comenzando desde cero y desea la curva de aprendizaje más pequeña posible, LangChain o OpenAI Agents SDK son las opciones más seguras. Si ya tiene un marco, nuestra integración funciona bien; no cambie de marcos solo para usar Blockchain0x.
Los escenarios específicos tienen su propia página.
Más allá de las páginas de integración específicas del marco, publicamos guías de largo alcance sobre preguntas más específicas: "¿cómo agrego pagos a un flujo de trabajo de múltiples pasos de LangGraph?", "¿cómo hago que mi servidor MCP cobre por herramienta?", "¿cómo bloqueo una API similar a Stripe detrás del pago en USDC?". Estas se encuentran en /lp/{slug} y no están intencionadamente en la navegación principal. Se encuentran a través de la búsqueda; cada una enlaza de vuelta a la página de integración relevante.
Dónde encontrarlos
El primer lote de guías de cola larga se envía junto con las páginas del marco de integración. Hasta entonces, el contenido más concreto específico del escenario vive en la documentación en docs.blockchain0x.com bajo "Guías". Cada página /lp/ incluye código funcional que puedes ejecutar y un CTA directo para actualizar el agente relevante a Pro.