Conecte Blockchain0x à sua pilha de agentes.
Código real para cada framework de agente popular. Um pacote enviado onde existe, uma receita SDK curta onde não existe.
Escolha seu framework. Onde enviamos um pacote você o instala; caso contrário, você envolve nosso SDK na ferramenta nativa desse framework. De qualquer forma, é uma camada fina sobre uma API HTTP, e você pode ignorá-la e chamar a API diretamente.
Cada cartão abre uma imersão: a instalação ou a receita, um exemplo de agente em funcionamento, manipulação de webhook e armadilhas comuns. Três são enviados como pacotes reais hoje - blockchain0x-langchain e blockchain0x-crewai no PyPI, e @blockchain0x/mcp no npm. Os outros sete são receitas curtas sobre o mesmo SDK. Nenhum pacote inventado.
Dez frameworks. Três pacotes, sete receitas, uma API.
LangChain
Pacote PyPIConjunto de ferramentas Python do pacote blockchain0x-langchain; agentes TypeScript envolvem o cliente x402
CrewAI
Pacote PyPIConjunto de ferramentas Python do blockchain0x-crewai, a mesma forma de fábrica que LangChain
AutoGen
Receita do SDKReceita: envolver o SDK em uma ferramenta de função AutoGen
LlamaIndex
Receita do SDKReceita: envolver o cliente em uma ferramenta de função LlamaIndex
OpenAI Agents SDK
Receita do SDKReceita: envolver o cliente em uma ferramenta de função OpenAI Agents SDK
Pydantic AI
Receita do SDKReceita: registrar uma ferramenta Pydantic AI que chama o cliente
LangGraph
Receita do SDKReceita: um nó LangGraph que chama o cliente x402
Semantic Kernel
Receita do SDKReceita: uma KernelFunction envolvendo o SDK; sem adaptador NuGet ou Java
Agno
Receita do SDKReceita: um Agno Toolkit envolvendo o cliente Python
MCP servers
pacote npmFerramentas de carteira para qualquer cliente MCP através do 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
Uma forma consistente em todos os frameworks.
- O comando de instalação do pacote, ou a receita quando não houver pacote
- Código para copiar e colar que você pode executar, não pseudocódigo
- Uma resposta curta para 'como adiciono pagamentos ao meu agente {framework}'
- Entradas de FAQ com schema HowTo/FAQ para mecanismos de busca de IA
- Um link para a landing page de cauda longa correspondente
- Um link para a página de preços
Cada integração é um wrapper fino sobre a mesma API.
As integrações do Blockchain0x não são 10 produtos separados. Elas são 10 superfícies ergonômicas diferentes em cima de uma única API HTTP. A API é a fonte da verdade; os wrappers de framework existem para economizar seu tempo.
Cada wrapper traduz de "a maneira como seu framework define uma ferramenta" para "uma chamada HTTP para nossa API". Esse é o trabalho inteiro. Os adaptadores Python expõem create_blockchain0x_toolset(client), que fornece a LangChain ou CrewAI um conjunto de ferramentas prontas. Um framework sem um adaptador enviado envolve createX402Client(...) (Node) ou o cliente blockchain0x (Python) em uma ferramenta nativa daquele framework. A mesma API por baixo, de qualquer forma.
Isso é importante por algumas razões. Primeiro, você pode misturar e combinar: um agente de produção LangChain e um agente experimental CrewAI podem ambos direcionar a mesma carteira de agente Blockchain0x sem conflito. Segundo, você não está preso a uma escolha de framework através de nós; mudar de frameworks não requer nenhuma alteração na sua carteira, suas políticas de gasto ou sua página pública. Terceiro, quando lançamos um novo endpoint ou um novo evento de webhook, os wrappers de framework o expõem em sua próxima versão; a API subjacente é o contrato.
Você pode integrar sem nosso SDK, nosso wrapper ou nossa integração de framework.
A API do Blockchain0x é JSON simples sobre HTTPS com autenticação de token portador. Qualquer cliente HTTP em qualquer linguagem pode chamá-la. Os SDKs oficiais e wrappers de framework são camadas de conveniência; a API bruta é documentada, estável e intencionalmente pequena o suficiente para que a escrita manual contra ela seja razoável.
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" } }'
Quando pular o SDK faz sentido
- Você está em uma linguagem que não oferecemos. Go, Rust, Elixir, Ruby, PHP, Java - todos esses podem chamar nossa API nativamente com suas bibliotecas HTTP padrão. Nenhuma ferramenta especial necessária.
- Você está na borda. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - ambientes onde você preferiria não agrupar uma dependência extra. A API bruta funciona lá sem alterações.
- Você quer ver exatamente o que está na rede. Para depuração, revisão de segurança ou aprendizado do protocolo, a forma HTTP bruta é mais clara do que ler o código-fonte do SDK.
- Você tem sua própria camada HTTP com tentativas, registro e telemetria. Trazer outro SDK com seu próprio comportamento de repetição conflita com sua infraestrutura existente. Chamar a API bruta como apenas outro endpoint HTTP se encaixa perfeitamente.
A referência completa da API em docs.blockchain0x.com inclui a especificação OpenAPI, para que você também possa gerar seu próprio cliente em qualquer linguagem que tenha uma ferramenta de geração de código OpenAPI.
Quando cada framework é a ferramenta certa.
Se você ainda não escolheu um framework de agente, aqui está como vemos as compensações. Nenhuma dessas escolhas é errada; a certa depende do que seu agente faz e quem o mantém.
| Framework | Melhor quando | Evite quando |
|---|---|---|
| LangChain | Codebase existente em LangChain, cadeias complexas de ferramentas, uso amplo no ecossistema | Você quer dependências mínimas; LangChain puxa muitas |
| LangGraph | Workflows multi-etapas com estado, execução durável, human-in-the-loop | Cadeias lineares simples; a sobrecarga do gráfico é desperdiçada |
| CrewAI | Padrões de colaboração multiagente (pesquisador + redator + revisor) | Laços de agente único; CrewAI é construído para equipes |
| AutoGen | Conversa multiagente, padrões de grupo de chat, ferramentas Microsoft | Produção de alto desempenho; AutoGen otimiza para pesquisa |
| LlamaIndex | Agentes com forte uso de RAG, Q&A sobre documentos como capacidade principal | Agentes de uso puro de ferramentas; as forças do LlamaIndex não são utilizadas |
| OpenAI Agents SDK | Stacks apenas com OpenAI, querem a API de uso de ferramentas mais limpa | Pilhas de múltiplos provedores; OpenAI SDK é centrado na OpenAI |
| Pydantic AI | Tipagem forte em todas as entradas/saídas do agente, Python-first | Stacks primeiro em TypeScript; a tipagem nativa do Python é o valor |
| Semantic Kernel | Codebase existente em .NET / C# / Java, ambiente corporativo Microsoft | Equipes apenas em Python; você está pagando por uma integração MS não utilizada |
| Agno | Nativo em Python, leve, quer overhead mínimo de abstração | Você precisa das integrações de terceiros do ecossistema LangChain |
| MCP middleware | Você está operando um servidor MCP e quer que os clientes paguem por chamada | Você não está executando um servidor MCP (é um padrão do lado do servidor) |
Duas dicas práticas. Se você está começando do zero e quer a menor curva de aprendizado possível, LangChain ou OpenAI Agents SDK são as opções mais seguras. Se você já tem um framework, nossa integração para ele funciona bem; não mude de frameworks apenas para usar a Blockchain0x.
Cenários específicos têm sua própria página.
Além das páginas de integração específicas do framework, publicamos guias de longo alcance sobre perguntas mais específicas: "como adiciono pagamentos a um fluxo de trabalho de múltiplas etapas do LangGraph", "como deixo meu servidor MCP cobrar por ferramenta", "como coloco uma API semelhante à Stripe atrás do pagamento em USDC". Estes estão em /lp/{slug} e não estão intencionalmente na navegação principal. Eles são encontrados através da busca; cada um vincula de volta à página de integração relevante.
Onde encontrá-los
O primeiro lote de guias de cauda longa é enviado juntamente com as páginas do framework de integração. Até lá, o conteúdo mais concreto específico de cenários vive na documentação em docs.blockchain0x.com sob "Guias". Cada página /lp/ inclui código funcional que você pode executar e um CTA direto para atualizar o agente relevante para Pro.