Pydantic AI కోసం ప్రత్యేక package లేదు, మీకు అది అవసరమూ లేదు. Pydantic AI తో function ను validated tool గా మారుస్తుంది, కాబట్టి మీరు నిజమైన Python client ను typed function లో wrap చేస్తారు, అప్పుడు agent USDC పంపగలదు, invoices settle చేయగలదు, wallets చదవగలదు. ఇది OpenAI, Anthropic, Google, Mistral, Groq, మరియు ఇతర అన్ని Pydantic AI providers లో పనిచేస్తుంది, ఎందుకంటే tool model ను కాకుండా HTTP API ను పిలుస్తుంది. Payments Base పై settle అవుతాయి.

Pydantic AI మరియు కోర్ SDKని ఇన్‌స్టాల్ చేయండి. రెండు కీలు.

చేర్చడానికి blockchain0x Pydantic AI ప్యాకేజీ లేదు. మీరు Pydantic AIని (Python 3.10+) మరియు నిజమైన blockchain0x కోర్ SDKని ఇన్‌స్టాల్ చేస్తారు, తరువాత క్రింద ఫంక్షన్‌ను రాస్తారు. అది మొత్తం ఆధారిత జాబితా.

pip install pydantic-ai blockchain0x

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

OPENAI_API_KEY (లేదా మీరు use చేసే provider కి సమానమైనది). BLOCKCHAIN0X_API_KEY అనేది మీ dashboard నుంచి వచ్చిన sk_test_ testnet లేదా sk_live_ mainnet key; client దాన్ని environment నుండి reads చేస్తుంది. మీ agent కు money కూడా వస్తే, webhook handler కు అదనంగా BLOCKCHAIN0X_WEBHOOK_SECRET అవసరం.

సంతకం చేసిన వెబ్‌హుక్‌తో ఇన్‌బౌండ్ చెల్లింపులను నిర్ధారించండి.

మీ ఏజెంట్ కూడా USDCని అందుకుంటే, దాన్ని పోలింగ్ చేయకుండా వెబ్‌హుక్‌తో ధృవీకరించండి. ధృవీకరించు సహాయకుడు Node SDKలో షిప్పింగ్ చేస్తుంది; ఒక Python సేవలో మీరు డాక్యుమెంటెడ్ HMACకు వ్యతిరేకంగా చేతితో ధృవీకరించాలి. మీరు టైప్డ్ ఈవెంట్లను కావాలనుకుంటే, మీ స్వంత పాయ్‌డాంటిక్ మోడల్‌ను నిర్వచించండి మరియు సంతకం తనిఖీ చేసిన తర్వాత మోడల్_validate_json క/raw బాడీని చేయండి - టైపింగ్ జోడించడానికి మీది.

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}

అల్గోరిథం t.rawBody అనే స్ట్రింగ్‌పై HMAC-SHA256, స్థిర-సమయాన్ని పోల్చడం, మరియు 300-సెకన్ల రీప్లే విండో. సంతకం కవర్ చేసే బైట్స్‌ను మార్చడం వల్ల await request.body() ద్వారా కచ్చితమైన శరీరాన్ని చదవండి, ఎప్పుడూ request.json() మళ్లీ సీరియలైజ్ చేయకండి. పంపిన ఈవెంట్లు payment.received, payment.sent, wallet.deployed, మరియు webhook.test; విభజించడానికి X-Blockchain0x-Event-Type హెడ్డర్ పై కుదించండి.

గమనించాల్సిన ఐదు Pydantic AI-సంబంధిత చిక్కులు.

Pydantic AI యొక్క బలమైన టైపింగ్ చాలా ఇంటిగ్రేషన్ బగ్‌లను సరిహద్దులో పట్టుకుంటుంది; ఇవి కొన్ని మాత్రమే పరిగెత్తుతాయి.