Ga naar hoofdinhoud
INTEGRATIES

Sluit Blockchain0x aan op je agentstack.

Echte code voor elk populair agentframework. Een geleverd pakket waar dat bestaat, een kort SDK-recept waar dat niet het geval is.

Kies je framework. Waar we een pakket leveren, installeer je het; anders wikkel je onze SDK in de native tool van dat framework. Hoe dan ook, het is een dunne laag over één HTTP API, en je kunt het overslaan en de API rechtstreeks aanroepen.

Elke kaart opent een diepgaande duik: de installatie of het recept, een werkend agentvoorbeeld, webhookverwerking en veelvoorkomende valkuilen. Drie worden vandaag als echte pakketten verzonden - blockchain0x-langchain en blockchain0x-crewai op PyPI, en @blockchain0x/mcp op npm. De andere zeven zijn korte recepten over dezelfde SDK. Geen uitgevonden pakket.

WAT ELKE INTEGRATIE INHOUDT

Een consistente vorm over elk framework.

  • Het installatiecommando voor het pakket, of het recept als er geen pakket is
  • Copy-paste code die je kunt uitvoeren, geen pseudocode
  • Een kort antwoord op 'hoe voeg ik betalingen toe aan mijn {framework}-agent'
  • FAQ-items met HowTo/FAQ-schema voor AI zoekmachines
  • Een link naar de bijbehorende long-tail landingspagina
  • Een link naar de prijspagina
ARCHITECTUUR

Elke integratie is een dunne wrapper over dezelfde API.

De Blockchain0x-integraties zijn geen 10 afzonderlijke producten. Het zijn 10 verschillende ergonomische oppervlakken bovenop een enkele HTTP API. De API is de bron van waarheid; de framework wrappers bestaan om je tijd te besparen.

SDK-architectuurdiagram: framework wrappers die een enkele Blockchain0x HTTP API aanroepen

Elke wrapper vertaalt van "de manier waarop jouw framework een tool definieert" naar "een HTTP-aanroep naar onze API". Dat is de hele taak. De Python-adapters stellen create_blockchain0x_toolset(client) bloot, die LangChain of CrewAI een kant-en-klare set tools geeft. Een framework zonder een verzonden adapter wikkelt createX402Client(...) (Node) of de blockchain0x client (Python) in een native tool van dat framework. Dezelfde API eronder, in beide gevallen.

Dit is om een paar redenen belangrijk. Ten eerste, je kunt mixen en matchen: een LangChain productieagent en een CrewAI experimentele agent kunnen beide dezelfde Blockchain0x agent wallet targeten zonder conflicten. Ten tweede, je zit niet vast aan een frameworkkeuze via ons; het wisselen van frameworks vereist geen wijziging van je wallet, je uitgavenbeleid of je openbare pagina. Ten derde, wanneer we een nieuwe endpoint of een nieuwe webhook-evenement uitbrengen, stellen de framework wrappers het bloot in hun volgende release; de onderliggende API is het contract.

SLUIT DE SDK UIT

Je kunt integreren zonder onze SDK, onze wrapper of onze frameworkintegratie.

De Blockchain0x API is gewone JSON over HTTPS met bearer-token-authenticatie. Elke HTTP-client in elke taal kan het aanroepen. De officiële SDK's en framework wrappers zijn gemakslagen; de ruwe API is gedocumenteerd, stabiel en opzettelijk klein genoeg dat handmatig schrijven ertegen redelijk is.

CURL - GEEN 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" }
  }'

Wanneer het logisch is om de SDK over te slaan

  • Je bevindt je in een taal die we niet aanbieden. Go, Rust, Elixir, Ruby, PHP, Java - al deze kunnen onze API native aanroepen met hun standaard HTTP-bibliotheken. Geen speciale tools vereist.
  • Je bent aan de rand. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - omgevingen waar je liever geen extra afhankelijkheid wilt bundelen. De ruwe API werkt daar zonder wijzigingen.
  • Je wilt precies zien wat er op de draad staat. Voor debugging, beveiligingsreview of het leren van het protocol is de ruwe HTTP-vorm duidelijker dan het lezen van de SDK-bron.
  • Je hebt je eigen HTTP-laag met herhalingen, logging, telemetrie. Het binnenbrengen van een andere SDK met zijn eigen herhaalgedrag strijdt tegen je bestaande infrastructuur. Het aanroepen van de ruwe API als gewoon een andere HTTP-eindpunt sluit netjes aan.

De volledige API-referentie op docs.blockchain0x.com bevat de OpenAPI-specificatie, zodat u ook uw eigen client kunt genereren in elke taal die een OpenAPI-codegeneratietool heeft.

EEN FRAMEWORK KIEZEN

Wanneer elk framework het juiste hulpmiddel is.

Als u nog geen agent-framework heeft gekozen, hier is hoe wij de afwegingen zien. Geen van deze zijn verkeerde keuzes; de juiste hangt af van wat uw agent doet en wie het onderhoudt.

FrameworkBeste wanneerVermijd wanneer
LangChainBestaande LangChain-codebase, complexe toolchains, breed ecosysteemgebruikJe wilt minimale afhankelijkheden; LangChain trekt veel binnen
LangGraphStateful workflows met meerdere stappen, duurzame uitvoering, human-in-the-loopEenvoudige lineaire ketens; de grafiek overhead is verspild
CrewAISamenwerkingspatronen voor meerdere agents (onderzoeker + schrijver + reviewer)Single-agent loops; CrewAI is gebouwd voor crews
AutoGenGesprek tussen meerdere agents, groepschatpatronen, Microsoft-toolsProductie met hoge doorvoer; AutoGen optimaliseert voor onderzoek
LlamaIndexAgents met veel RAG, document Q&A als kernfunctionaliteitPure toolgebruikers; de sterke punten van LlamaIndex worden niet benut
OpenAI Agents SDKOpenAI-only stacks, willen de schoonste tool-gebruik-APIMulti-provider stacks; OpenAI SDK is OpenAI-gecentreerd
Pydantic AISterke typing voor alle agent-inputs/-outputs, Python-firstTypeScript-eerste stacks; de Python-native typing is de waarde
Semantic KernelBestaande .NET / C# / Java-codebase, enterprise Microsoft-omgevingPython-only teams; je betaalt voor ongebruikte MS-integratie
AgnoPython-native, lichtgewicht, minimale abstractie-overhead gewenstJe hebt de third-party integraties van het LangChain-ecosysteem nodig
MCP middlewareJe draait een MCP-server en wilt dat clients per call betalenJe draait geen MCP-server (het is een server-side patroon)

Twee praktische adviezen. Als je vanaf nul begint en de kleinste mogelijke leercurve wilt, zijn LangChain of OpenAI Agents SDK de veiligste standaardopties. Als je al een framework hebt, werkt onze integratie daarvoor prima; wissel niet van framework alleen om Blockchain0x te gebruiken.

DIEPERE GIDSEN

Specifieke scenario's krijgen hun eigen pagina.

Buiten de framework-specifieke integratiepagina's publiceren we long-tail gidsen over specifiekere vragen: "hoe voeg ik betalingen toe aan een LangGraph multi-stap workflow", "hoe laat ik mijn MCP-server kosten per tool in rekening brengen", "hoe sluit ik een Stripe-achtige API af achter USDC-betaling". Deze zijn te vinden op /lp/{slug} en zijn opzettelijk niet in de hoofd navigatie opgenomen. Ze worden gevonden via zoekopdrachten; elke link verwijst terug naar de relevante integratiepagina.

Waar je ze kunt vinden

De eerste batch van long-tail gidsen wordt verzonden samen met de integratiekaderpagina's. Tot die tijd bevindt de meest concrete scenario-specifieke inhoud zich in de docs op docs.blockchain0x.com onder "Gidsen". Elke /lp/-pagina bevat werkende code die je kunt uitvoeren en een directe CTA om de relevante agent naar Pro te upgraden.

VAKANT VRAAG

Vijf integratievragen die het waard zijn om te beantwoorden.

Als de SDK optioneel is, waarom bestaat deze dan überhaupt?

Drie redenen. Ten eerste, ergonomie: de SDK genereert automatisch idempotentie-sleutels, typeert elke aanvraag en respons, en bundelt webhook-handtekeningverificatie zodat je die code niet zelf hoeft te schrijven. Ten tweede, driftbescherming: wanneer we een eindpunt toevoegen of een veld wijzigen, maakt de volgende SDK-release het zichtbaar; raw HTTP-gebruikers moeten de changelog lezen. Ten derde, instrumentatie: de SDK genereert automatisch gestructureerde logs en statistieken in een formaat dat compatibel is met gangbare observability-stacks. Geen van deze is essentieel, maar ze besparen 30-90 minuten integratietijd. Als je liever de ruwe vorm van de API wilt zien, sla de SDK dan over en gebruik curl of een andere HTTP-client.

Ik gebruik een framework dat je niet vermeldt. Kan ik nog steeds integreren?

Ja. Elke integratie zit op dezelfde kleine REST API: agents, betalingen, betalingsverzoeken, transacties, webhooks, plus alleen-lezen uitgavenpermissies. Auth is een bearer-token, webhooks zijn ondertekend met HMAC-SHA256. Als je HTTP kunt spreken, kun je integreren vanuit elk framework, inclusief frameworks zonder geleverde wrapper - je wikkelt gewoon onze SDK in de eigen tool van dat framework. De frameworkpagina's bestaan voor gemak, niet voor poortbewaking. Wil je een officiële adapter voor jouw framework? Laat het ons weten via de documentatie en we zullen het afwegen tegen de vraag.

Kan één agent door meerdere framework-integraties tegelijk worden bediend?

Ja. Een enkele agent heeft één walletadres, één set API-sleutels, één uitgavenbeleid en één openbare pagina. Verschillende delen van je stack kunnen onze API aanroepen via verschillende frameworkintegraties: een LangChain-agent in productie, een CrewAI-experiment, een MCP-servermiddleware, allemaal betalen ze dezelfde agent of allemaal rekenen ze via dezelfde agent. De frameworkgrens ligt aan jouw kant; wij zien alleen geauthenticeerde API-aanvragen en webhook-abonnementen.

Kosten de frameworkintegraties extra?

Nee. De verzonden adapters - blockchain0x-langchain en blockchain0x-crewai op PyPI, en de @blockchain0x/mcp-server op npm - zijn gratis, en dat geldt ook voor de SDK's. Voor elk ander framework is er geen extra pakket om te kopen: u wikkelt de SDK zelf in een paar regels. Uw kosten zijn het abonnement per agent plus transactiekosten die u hoe dan ook zou betalen. Het installeren van het LangChain-pakket kost hetzelfde als het aanroepen van de API met curl. Het pakket bespaart tijd, het beperkt geen functies.

Hoe snel werk je integraties bij wanneer frameworks brekende wijzigingen uitbrengen?

Voor de verzonden adapters (blockchain0x-langchain, blockchain0x-crewai, @blockchain0x/mcp) volgen we de frameworks die mensen daadwerkelijk gebruiken en werken we bij wanneer een grote versie verschijnt; we zijn vroeg en beloven nog geen vaste SLA. Kleine versies vereisen meestal geen wijziging omdat de adapters stabiele interfaces omhullen. De recept-gebaseerde frameworks bewegen hier nauwelijks: ze roepen de SDK rechtstreeks aan, dus een frameworkverhoging raakt zelden ons oppervlak. Als een breaking change een adapter onveilig maakt, vermelden we het op de bijbehorende /integrations/-pagina voordat we de ondersteuning intrekken.

Sluit het aan, begin met betalen.

Gratis om te beginnen. Vijf minuten naar je eerste betalingsverzoek.