Pydantic AI-specific package எதுவும் இல்லை, மேலும் உங்களுக்கு அது தேவையுமில்லை. Pydantic AI ஒரு function-ஐ மூலம் validated tool-ஆக மாற்றுகிறது, ஆகவே உண்மையான Python client-ஐ typed function-இல் wrap செய்தால் agent USDC அனுப்பவும், invoices-ஐ settle செய்யவும், wallets-ஐ read செய்யவும் முடியும். இது OpenAI, Anthropic, Google, Mistral, Groq, மற்றும் மற்ற எல்லா Pydantic AI provider-களிலும் வேலை செய்கிறது, ஏனெனில் இந்த 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-னின் சமமான key). BLOCKCHAIN0X_API_KEY என்பது உங்கள் dashboard-இல் உள்ள sk_test_ testnet அல்லது sk_live_ mainnet key; client அதை environment-இலிருந்து வாசிக்கிறது. உங்கள் agent பணத்தையும் பெறுமானால், webhook handler-க்கு கூடுதலாக BLOCKCHAIN0X_WEBHOOK_SECRET தேவைப்படும்.

ஒரு கையொப்பம் செய்யப்பட்ட webhook உடன் உள்ளே வரும் கட்டணங்களை உறுதிப்படுத்தவும்.

உங்கள் எஜெண்ட் USDC ஐப் பெறுமானால், polling மூலம் அல்ல, webhook மூலம் உறுதிப்படுத்துங்கள். verify உதவியாளர் Node SDK இல் அனுப்பப்படுகிறது; ஒரு Python சேவையில் நீங்கள் ஆவணப்படுத்தப்பட்ட HMAC க்கு எதிராக கையால் சரிபார்க்கிறீர்கள். நீங்கள் வகைப்படுத்தப்பட்ட நிகழ்வுகளை விரும்பினால், உங்கள் சொந்த Pydantic மாதிரியை வரையறுக்கவும் மற்றும் கையொப்பம் சரிபார்க்கப்பட்ட பிறகு மாடல்_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 இன் வலுவான வகைப்படுத்தல் எல்லையில் பெரும்பாலான ஒருங்கிணைப்பு பிழைகளை பிடிக்கிறது; இவை சிலவற்றில் சிலவாக உள்ளன.