Ir para o conteúdo principal
INTEGRAÇÕES

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.

O QUE CADA INTEGRAÇÃO INCLUI

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
ARQUITETURA

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.

Diagrama de arquitetura do SDK: wrappers de framework chamando uma única API HTTP Blockchain0x

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.

PULAR O SDK

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 - SEM 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" }
  }'

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.

ESCOLHENDO UM FRAMEWORK

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.

FrameworkMelhor quandoEvite quando
LangChainCodebase existente em LangChain, cadeias complexas de ferramentas, uso amplo no ecossistemaVocê quer dependências mínimas; LangChain puxa muitas
LangGraphWorkflows multi-etapas com estado, execução durável, human-in-the-loopCadeias lineares simples; a sobrecarga do gráfico é desperdiçada
CrewAIPadrões de colaboração multiagente (pesquisador + redator + revisor)Laços de agente único; CrewAI é construído para equipes
AutoGenConversa multiagente, padrões de grupo de chat, ferramentas MicrosoftProdução de alto desempenho; AutoGen otimiza para pesquisa
LlamaIndexAgentes com forte uso de RAG, Q&A sobre documentos como capacidade principalAgentes de uso puro de ferramentas; as forças do LlamaIndex não são utilizadas
OpenAI Agents SDKStacks apenas com OpenAI, querem a API de uso de ferramentas mais limpaPilhas de múltiplos provedores; OpenAI SDK é centrado na OpenAI
Pydantic AITipagem forte em todas as entradas/saídas do agente, Python-firstStacks primeiro em TypeScript; a tipagem nativa do Python é o valor
Semantic KernelCodebase existente em .NET / C# / Java, ambiente corporativo MicrosoftEquipes apenas em Python; você está pagando por uma integração MS não utilizada
AgnoNativo em Python, leve, quer overhead mínimo de abstraçãoVocê precisa das integrações de terceiros do ecossistema LangChain
MCP middlewareVocê está operando um servidor MCP e quer que os clientes paguem por chamadaVocê 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.

GUIAS MAIS PROFUNDOS

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.

PERGUNTAS FREQUENTES

Cinco perguntas de integração que valem a pena responder.

Se o SDK é opcional, por que ele existe?

Três razões. Primeiro, ergonomia: o SDK gera automaticamente chaves de idempotência, tipifica cada solicitação e resposta e agrupa a verificação de assinatura de webhook para que você não precise escrever esse código você mesmo. Segundo, proteção contra desvios: quando adicionamos um endpoint ou mudamos um campo, a próxima versão do SDK o expõe; usuários de HTTP bruto precisam ler o changelog. Terceiro, instrumentação: o SDK emite automaticamente logs estruturados e métricas em um formato compatível com pilhas de observabilidade comuns. Nenhuma dessas é essencial, mas economiza de 30 a 90 minutos de tempo de integração. Se você preferir ver a forma bruta da API, pule o SDK e use curl ou qualquer cliente HTTP.

Estou usando um framework que você não lista. Posso ainda integrar?

Sim. Cada integração se baseia na mesma pequena API REST: agentes, pagamentos, pedidos de pagamento, transações, webhooks, além de permissões de gastos somente leitura. A autenticação é um token bearer, os webhooks são assinados com HMAC-SHA256. Se você pode falar HTTP, pode integrar de qualquer framework, incluindo aqueles sem wrapper enviado - você apenas envolve nosso SDK na ferramenta própria desse framework. As páginas do framework existem para conveniência, não para controle. Quer um adaptador oficial para seu framework? Diga-nos através da documentação e pesaremos isso em relação à demanda.

Um agente pode ser atendido por várias integrações de framework ao mesmo tempo?

Sim. Um único agente tem um endereço de carteira, um conjunto de chaves API, uma política de gastos e uma página pública. Diferentes partes de sua pilha podem chamar nossa API através de diferentes integrações de framework: um agente LangChain em produção, um experimento CrewAI, um middleware de servidor MCP, todos pagando o mesmo agente ou todos cobrando através do mesmo agente. A fronteira do framework está do seu lado; nós apenas vemos solicitações de API autenticadas e assinaturas de webhook.

As integrações do framework custam extra?

Não. Os adaptadores enviados - blockchain0x-langchain e blockchain0x-crewai no PyPI, e o servidor @blockchain0x/mcp no npm - são gratuitos, e os SDKs também. Para todos os outros frameworks, não há pacote extra para comprar: você envolve o SDK você mesmo em algumas linhas. Seu custo é a assinatura por agente mais as taxas de transação que você pagaria de qualquer forma. Instalar o pacote LangChain custa o mesmo que chamar a API com curl. O pacote economiza tempo, não restringe recursos.

Com que rapidez você atualiza integrações quando frameworks lançam mudanças disruptivas?

Para os adaptadores enviados (blockchain0x-langchain, blockchain0x-crewai, @blockchain0x/mcp) rastreamos os frameworks que as pessoas realmente usam e atualizamos quando uma versão principal é lançada; estamos no início e não prometemos um SLA fixo ainda. Versões menores geralmente não precisam de mudança porque os adaptadores envolvem interfaces estáveis. Os frameworks baseados em receita mal se movem aqui: eles chamam o SDK diretamente, então um aumento de framework raramente toca nossa superfície. Se uma mudança quebrada tornar um adaptador inseguro, nós a notamos na página correspondente /integrations/ antes de retirar o suporte.

Conecte, comece a receber.

Gratuito para começar. Cinco minutos até seu primeiro pedido de pagamento.