Er is geen Agno-specifiek pakket, en je hebt er ook geen nodig. Agno maakt van een -methode een tool, dus wikkel je de echte Python client in een kleine toolkit en voeg je die toe aan je . De agent kan USDC versturen, facturen afwikkelen en wallets uitlezen, voor elk Agno-model (OpenAI, Anthropic, DeepSeek, Llama, Mistral). Betalingen worden afgerekend op Base.

Installeer Agno en de kern SDK. Twee sleutels.

Er is geen blockchain0x Agno-pakket om toe te voegen. Je installeert Agno (Python 3.10+, de 1.0+ lijn na de Phidata-naamverandering) en de echte blockchain0x kern SDK, en schrijft dan de toolkit hieronder. Als je nog steeds op phi.* imports zit, voer dan eerst pip install -U agno uit.

pip install agno blockchain0x

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

OPENAI_API_KEY (of het equivalent voor welk Agno-supported model je ook gebruikt). 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 Agno-specifieke dingen om op te letten.

Agno is een van de schonere agentenframeworks om mee te integreren, maar het heeft zijn eigen valkuilen - vooral rond de hernoeming van Phidata en markdown-rendering.