Pydantic AI साठी कोणतेही विशिष्ट package नाही, आणि तुम्हाला त्याची गरजही नाही. Pydantic AI function ला सह validated tool मध्ये रूपांतरित करते, त्यामुळे तुम्ही खरा Python client typed function मध्ये wrap करता आणि एजंट USDC पाठवू शकतो, invoices settle करू शकतो, आणि wallets read करू शकतो. हे OpenAI, Anthropic, Google, Mistral, Groq, आणि इतर सर्व Pydantic AI providers across काम करते, कारण tool model नाही तर HTTP API call करते. 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 (किंवा तुम्ही वापरत असलेल्या कोणत्याही provider साठी समतुल्य). BLOCKCHAIN0X_API_KEY ही तुमच्या dashboard मधील sk_test_ testnet किंवा sk_live_ mainnet की आहे; client ती environment मधून वाचतो. जर तुमच्या agent ला पैसे देखील मिळत असतील, तर webhook handler ला BLOCKCHAIN0X_WEBHOOK_SECRET देखील लागतो.

स्वाक्षरी केलेल्या वेबहुकसह इनबाउंड पेमेंटची पुष्टी करा.

जर तुमचा एजंट USDC देखील प्राप्त करतो, तर ते वेबहुकद्वारे पुष्टी करा, मतदानाद्वारे नाही. सत्यापन सहाय्यक Node SDK मध्ये पाठवला जातो; एका Python सेवेमध्ये तुम्ही दस्तऐवजीकरण केलेल्या HMAC विरुद्ध हाताने सत्यापित करता. जर तुम्हाला टाइप केलेले इव्हेंट हवे असतील, तर तुमचे स्वतःचे Pydantic मॉडेल परिभाषित करा आणि स्वाक्षरीची पुष्टी झाल्यावर कच्च्या शरीराचे model_validate_json करा - टायपिंग तुम्ही जोडायची आहे.

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 च्या मजबूत टायपिंग बहुतेक एकत्रीकरण बग्ज सीमारेषेवर पकडते; हे काही आहेत जे गळून पडतात.