Collega Blockchain0x al tuo stack agente.
Codice reale per ogni popolare framework per agenti. Un pacchetto spedito dove esiste, una breve ricetta SDK dove non esiste.
Scegli il tuo framework. Dove spediamo un pacchetto lo installi; altrimenti avvolgi il nostro SDK nello strumento nativo di quel framework. In entrambi i casi è uno strato sottile su una singola API HTTP, e puoi saltarlo e chiamare l'API direttamente.
Ogni scheda apre un approfondimento: l'installazione o la ricetta, un esempio di agente funzionante, gestione dei webhook e insidie comuni. Tre vengono spediti come pacchetti reali oggi - blockchain0x-langchain e blockchain0x-crewai su PyPI, e @blockchain0x/mcp su npm. Gli altri sette sono ricette brevi sullo stesso SDK. Nessun pacchetto inventato.
Dieci framework. Tre pacchetti, sette ricette, una API.
LangChain
Pacchetto PyPISet di strumenti Python dal pacchetto blockchain0x-langchain; gli agenti TypeScript avvolgono il client x402
CrewAI
Pacchetto PyPISet di strumenti Python da blockchain0x-crewai, la stessa forma di fabbrica di LangChain
AutoGen
Ricetta SDKRicetta: avvolgi l'SDK in uno strumento funzione AutoGen
LlamaIndex
Ricetta SDKRicetta: avvolgi il client in un FunctionTool LlamaIndex
OpenAI Agents SDK
Ricetta SDKRicetta: avvolgi il client in uno strumento funzione OpenAI Agents SDK
Pydantic AI
Ricetta SDKRicetta: registra uno strumento Pydantic AI che chiama il client
LangGraph
Ricetta SDKRicetta: un nodo LangGraph che chiama il client x402
Semantic Kernel
Ricetta SDKRicetta: una KernelFunction che avvolge l'SDK; nessun adattatore NuGet o Java
Agno
Ricetta SDKRicetta: un Toolkit Agno che avvolge il client Python
MCP servers
pacchetto npmStrumenti wallet per qualsiasi client MCP tramite il server @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 coerente in ogni framework.
- Il comando di installazione del package, o la procedura quando non esiste un package
- Codice da copiare e incollare che puoi eseguire, non pseudocodice
- Una breve risposta a 'come aggiungo i pagamenti al mio agent {framework}'
- Voci FAQ con schema HowTo/FAQ per i motori di ricerca AI
- Un link alla landing page long-tail corrispondente
- Un link alla pagina dei prezzi
Ogni integrazione è un sottile wrapper sopra la stessa API.
Le integrazioni Blockchain0x non sono 10 prodotti separati. Sono 10 diverse superfici ergonomiche su un'unica API HTTP. L'API è la fonte di verità; i wrapper del framework esistono per farti risparmiare tempo.
Ogni wrapper traduce da "il modo in cui il tuo framework definisce uno strumento" in "una chiamata HTTP alla nostra API". Questo è il lavoro intero. Gli adattatori Python espongono create_blockchain0x_toolset(client), che fornisce a LangChain o CrewAI un set di strumenti già pronti. Un framework senza un adattatore spedito avvolge createX402Client(...) (Node) o il client blockchain0x (Python) in uno strumento nativo di quel framework. Stessa API sotto, in entrambi i casi.
Questo è importante per alcuni motivi. Prima di tutto, puoi mescolare e abbinare: un agente di produzione LangChain e un agente sperimentale CrewAI possono entrambi mirare allo stesso wallet agente Blockchain0x senza conflitti. In secondo luogo, non sei bloccato in una scelta di framework attraverso di noi; cambiare framework non richiede alcuna modifica al tuo wallet, alle tue politiche di spesa o alla tua pagina pubblica. Infine, quando rilasciamo un nuovo endpoint o un nuovo evento webhook, i wrapper del framework lo espongono nel loro prossimo rilascio; l'API sottostante è il contratto.
Puoi integrare senza il nostro SDK, il nostro wrapper o la nostra integrazione del framework.
L'API Blockchain0x è JSON semplice su HTTPS con autenticazione bearer-token. Qualsiasi client HTTP in qualsiasi linguaggio può chiamarlo. Gli SDK ufficiali e i wrapper del framework sono strati di convenienza; l'API grezza è documentata, stabile e intenzionalmente abbastanza piccola da rendere ragionevole la scrittura a mano.
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 ha senso saltare l'SDK
- Sei in una lingua che non distribuiamo. Go, Rust, Elixir, Ruby, PHP, Java - tutti questi possono chiamare la nostra API nativamente con le loro librerie HTTP standard. Non è necessario alcun strumento speciale.
- Sei al limite. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - ambienti in cui preferiresti non includere una dipendenza extra. L'API grezza funziona lì senza modifiche.
- Vuoi vedere esattamente cosa c'è sul filo. Per il debug, la revisione della sicurezza o l'apprendimento del protocollo, la forma HTTP grezza è più chiara della lettura del codice sorgente dell'SDK.
- Hai il tuo livello HTTP con ripetizioni, registrazione, telemetria. Portare un altro SDK con il proprio comportamento di ripetizione combatte la tua infrastruttura esistente. Chiamare l'API raw come un altro endpoint HTTP si integra facilmente.
Il riferimento completo all'API su docs.blockchain0x.com include la specifica OpenAPI, quindi puoi anche generare il tuo client in qualsiasi linguaggio che abbia uno strumento di generazione di codice OpenAPI.
Quando ogni framework è lo strumento giusto.
Se non hai ancora scelto un framework per agenti, ecco come vediamo i compromessi. Nessuna di queste è una scelta sbagliata; quella giusta dipende da cosa fa il tuo agente e chi lo mantiene.
| Framework | Migliore quando | Evita quando |
|---|---|---|
| LangChain | Codebase LangChain esistente, catene di tool complesse, uso diffuso nell'ecosistema | Vuoi dipendenze minime; LangChain ne richiede molte |
| LangGraph | Workflow multi-step stateful, esecuzione durabile, human-in-the-loop | Catene lineari semplici; l'overhead del grafo è sprecato |
| CrewAI | Pattern di collaborazione multi-agente (researcher + writer + reviewer) | Loop di agenti singoli; CrewAI è costruito per squadre |
| AutoGen | Conversazione multi-agente, pattern di gruppo chat, strumenti Microsoft | Produzione ad alta capacità; AutoGen ottimizza per la ricerca |
| LlamaIndex | Agenti con forte uso di RAG, Q+A su documenti come funzionalità core | Agenti di solo utilizzo di strumenti; i punti di forza di LlamaIndex rimangono inutilizzati |
| OpenAI Agents SDK | Stack solo OpenAI, vogliono la API di utilizzo tool più pulita | Stack multi-fornitore; OpenAI SDK è OpenAI-centrico |
| Pydantic AI | Tipizzazione forte su tutti gli input/output degli agenti, Python-first | Stack incentrati su TypeScript; la tipizzazione nativa di Python è il valore |
| Semantic Kernel | Codebase .NET / C# / Java esistente, azienda enterprise orientata a Microsoft | Team solo Python; stai pagando per un'integrazione MS non utilizzata |
| Agno | Python-native, leggero, con overhead di astrazione minimo | Hai bisogno delle integrazioni di terze parti dell'ecosistema LangChain |
| MCP middleware | Stai eseguendo un server MCP e vuoi che i client paghino per chiamata | Non stai eseguendo un server MCP (è un modello lato server) |
Due consigli pratici. Se stai partendo da zero e vuoi la curva di apprendimento più piccola possibile, LangChain o OpenAI Agents SDK sono le scelte più sicure. Se hai già un framework, la nostra integrazione funziona bene; non cambiare framework solo per utilizzare Blockchain0x.
Scenari specifici hanno la loro pagina.
Oltre alle pagine di integrazione specifiche del framework, pubblichiamo guide a lungo termine su domande più specifiche: "come posso aggiungere pagamenti a un flusso di lavoro multi-step di LangGraph", "come posso far pagare il mio server MCP per strumento", "come posso proteggere un'API simile a Stripe dietro il pagamento in USDC". Queste si trovano su /lp/{slug} e non sono intenzionalmente nella navigazione principale. Vengono trovate tramite ricerca; ciascuna rimanda alla pagina di integrazione pertinente.
Dove trovarli
Il primo lotto di guide long-tail viene spedito insieme alle pagine del framework di integrazione. Fino ad allora, il contenuto specifico per scenari più concreto si trova nella documentazione su docs.blockchain0x.com sotto "Guide". Ogni pagina /lp/ include codice funzionante che puoi eseguire e una CTA diretta per aggiornare l'agente pertinente a Pro.