Pydantic AI-specific package ಇಲ್ಲ, ಮತ್ತು ನಿಮಗೆ ಅದು ಬೇಕಾಗಿಲ್ಲ. Pydantic AI ಒಂದು function ಅನ್ನು ಮೂಲಕ validated tool ಆಗಿ ಪರಿವರ್ತಿಸುತ್ತದೆ, ಆದ್ದರಿಂದ ನೀವು ನಿಜವಾದ Python client ಅನ್ನು typed function ನಲ್ಲಿ wrap ಮಾಡುತ್ತೀರಿ ಮತ್ತು agent USDC ಕಳುಹಿಸಬಹುದು, invoices settle ಮಾಡಬಹುದು, ಮತ್ತು wallets ಓದಬಹುದು. ಇದು OpenAI, Anthropic, Google, Mistral, Groq, ಮತ್ತು ಇತರೆ ಎಲ್ಲಾ Pydantic AI providers across ನಲ್ಲಿ ಕೆಲಸ ಮಾಡುತ್ತದೆ, ಏಕೆಂದರೆ 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 (ಅಥವಾ ನೀವು ಬಳಸುವ ಯಾವುದೇ provider ಗೆ ಸಮಾನವಾದುದು). BLOCKCHAIN0X_API_KEY ನಿಮ್ಮ dashboard ನಿಂದ ಬಂದಿರುವ sk_test_ testnet ಅಥವಾ sk_live_ mainnet key ಆಗಿದೆ; client ಇದನ್ನು environment ನಿಂದ ಓದುತ್ತದೆ. ನಿಮ್ಮ agent ಗೆ ಹಣವೂ ಬರುತ್ತಿದ್ದರೆ, webhook handler ಗೆ ಹೆಚ್ಚುವರಿಯಾಗಿ BLOCKCHAIN0X_WEBHOOK_SECRET ಬೇಕಾಗುತ್ತದೆ.

ಒಪ್ಪಿಗೆಯ ವೆಬ್‌ಹುಕ್‌ನೊಂದಿಗೆ ಒಳನೋಡುವ ಪಾವತಿಗಳನ್ನು ದೃಢೀಕರಿಸಿ.

ನಿಮ್ಮ ಏಜೆಂಟ್ USDC ಅನ್ನು RECEIVES ಮಾಡಿದರೆ, polling ಬದಲು ವೆಬ್‌ಹುಕ್ ಮೂಲಕ ದೃಢೀಕರಿಸಿ. ಪರಿಶೀಲನೆ ಸಹಾಯಕವು 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}

algorithm ಎಂದರೆ t.rawBody string ಮೇಲೆ HMAC-SHA256, constant-time compare, ಮತ್ತು 300-second replay window. raw body ಅನ್ನು await request.body() ಮೂಲಕ read ಮಾಡಿ, ಎಂದಿಗೂ request.json() ಅನ್ನು re-serialized ಮಾಡಬೇಡಿ, ಏಕೆಂದರೆ ಅದು signature ಒಳಗೊಂಡ bytes ಅನ್ನು ಬದಲಾಯಿಸುತ್ತದೆ. ship ಮಾಡಲಾದ events payment.received, payment.sent, wallet.deployed, ಮತ್ತು webhook.test; branch ಮಾಡಲು X-Blockchain0x-Event-Type header ಮೇಲೆ narrow ಮಾಡಿ.

ಐದು ಪೈಡಾಂಟಿಕ್ AI-ನಿರ್ದಿಷ್ಟ ಬಲೆಗೆಗಳನ್ನು ತಪ್ಪಿಸಲು.

Pydantic AI ಯ ಶ್ರೇಷ್ಠ ಟೈಪಿಂಗ್ ಬಹಳಷ್ಟು ಏಕೀಕರಣ ದೋಷಗಳನ್ನು ಗಡಿಯಲ್ಲಿ ಹಿಡಿದಿಡುತ್ತದೆ; ಇವುಗಳಲ್ಲಿ ಕೆಲವು ಮಾತ್ರ ತಪ್ಪುತ್ತವೆ.