Er is geen OpenAI Agents SDK-pakket, en je hebt er ook geen nodig. De SDK maakt van een gedecoreerde functie een tool met , dus wikkel je de echte Python client in een functie en voeg je die toe aan je . De agent kan USDC versturen, facturen afwikkelen en wallets uitlezen - voor losse agents, handoffs en de onderliggende Responses API. Betalingen worden afgerekend op Base.

Installeer de Agents SDK en de kern SDK. Twee sleutels.

Er is geen blockchain0x Agents SDK-pakket om toe te voegen. Je installeert de OpenAI Agents SDK (het openai-agents-pakket, Python 3.10+) en de echte blockchain0x kern SDK, en schrijft dan de functie hieronder. Dat is de hele afhankelijkheidslijst.

pip install openai-agents blockchain0x

export OPENAI_API_KEY=sk-...
export BLOCKCHAIN0X_API_KEY=sk_test_...   # sk_test_ = Base Sepolia, sk_live_ = Base mainnet

OPENAI_API_KEY is je bestaande OpenAI-sleutel (de Agents SDK gebruikt die voor de onderliggende Responses API). BLOCKCHAIN0X_API_KEY is een sk_test_ testnet- of sk_live_ mainnet-sleutel uit je dashboard; de client leest die uit de omgeving. Als je agent ook geld ontvangt, heeft de webhook handler daarnaast BLOCKCHAIN0X_WEBHOOK_SECRET nodig.

Bevestig inkomende betalingen met een ondertekende webhook.

Als je agent ook USDC ontvangt, bevestig het dan met de webhook in plaats van te polleren. De verify-helper wordt geleverd in de Node SDK; in een Python-service verifieer je handmatig tegen de gedocumenteerde HMAC, wat is wat de helper doet. Voorbeeld van FastAPI hieronder; dezelfde code werkt in elk asynchroon Python-framework.

import hmac, hashlib, os, time
from fastapi import FastAPI, Request, HTTPException

app = FastAPI()
SECRET = os.environ["BLOCKCHAIN0X_WEBHOOK_SECRET"].encode()

@app.post("/webhooks/payment")
async def receive(request: Request):
    raw = await request.body()  # RAW bytes - do not parse first
    sig = request.headers.get("X-Blockchain0x-Signature", "")
    ts = request.headers.get("X-Blockchain0x-Timestamp", "")
    parts = dict(p.split("=", 1) for p in sig.split(",") if "=" in p)
    t, v1 = parts.get("t", ts), parts.get("v1", sig)
    want = hmac.new(SECRET, t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(want, v1) or abs(time.time() - int(t)) > 300:
        raise HTTPException(status_code=401)
    if request.headers.get("X-Blockchain0x-Event-Type") == "payment.received":
        await trigger_followup()  # USDC landed - run the next step
    return {"ok": True}

Het algoritme is HMAC-SHA256 over de string t.rawBody, een constante tijdsvergelijking, en een replayvenster van 300 seconden. Lees het ruwe lichaam via await request.body(), nooit request.json() opnieuw-serialized, omdat dat de bytes verandert die de handtekening dekt. De verzonden evenementen zijn payment.received, payment.sent, wallet.deployed, en webhook.test. Voor zware vervolgwerkzaamheden, voeg een taak toe (Celery, arq) en reageer onmiddellijk met 200 in plaats van de handler te blokkeren.

Vijf dingen om op te letten bij de eerste integratie.

Deze komen uit onze ondersteuningsinbox. Ervan op de hoogte zijn bespaart elk een uur.