Pydantic AI-യ്ക്ക് പ്രത്യേക package ഒന്നുമില്ല, അതിനാൽ നിങ്ങൾക്ക് അതിന്റെ ആവശ്യമില്ല. Pydantic AI ഉപയോഗിച്ച് ഒരു function-നെ validated tool ആക്കുന്നതിനാൽ, real Python client-നെ ഒരു typed function-ൽ wrap ചെയ്യുക, അതിലൂടെ agent-ന് USDC അയക്കാനും, invoices settle ചെയ്യാനും, wallets വായിക്കാനും കഴിയും. ഇത് OpenAI, Anthropic, Google, Mistral, Groq, കൂടാതെ മറ്റു എല്ലാ Pydantic AI provider-കളിലുമായി പ്രവർത്തിക്കുന്നു, കാരണം 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 കീ ആണ്; client അതിനെ environment-ൽ നിന്ന് വായിക്കുന്നു. നിങ്ങളുടെ agent-ിന് money സ്വീകരിക്കാനുമുണ്ടെങ്കിൽ, webhook handler-ിന് കൂടാതെ BLOCKCHAIN0X_WEBHOOK_SECRET ആവശ്യമാണ്.

ഒരു ഒപ്പിട്ട വെബ് ഹുക്ക് ഉപയോഗിച്ച് വരവേൽപ്പു പണമടച്ചുകൾ സ്ഥിരീകരിക്കുക.

നിങ്ങളുടെ ഏജന്റ് USDC സ്വീകരിക്കുന്നുവെങ്കിൽ, polling വഴി അല്ലാതെ വെബ്‌ഹുക്ക് ഉപയോഗിച്ച് ഇത് സ്ഥിരീകരിക്കുക. verify സഹായി Node SDK-യിൽ എത്തിക്കുന്നു; ഒരു Python സേവനത്തിൽ, രേഖപ്പെടുത്തിയ HMAC-ന് എതിരായും നിങ്ങൾ കൈകൊണ്ടു സ്ഥിരീകരിക്കുന്നു. നിങ്ങൾ ടൈപ്ഡ് ഇവന്റുകൾ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, നിങ്ങളുടെ സ്വന്തം Pydantic മോഡൽ നിർവചിക്കുക, ഒപ്പിടൽ പരിശോധിച്ചതിന് ശേഷം കച്ചവട ബോഡി model_validate_json ചെയ്യുക - ടൈപ്പിംഗ് നിങ്ങൾ ചേർക്കേണ്ടതാണ്. താഴെയുള്ള FastAPI ഉദാഹരണം.

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-യുടെ ശക്തമായ ടൈപ്പിംഗ് അതിന്റെ അതിർത്തിയിൽ കൂടുതലായും സംയോജനം പിശകുകൾ പിടികൂടുന്നു; ഇവയാണ് കുറച്ച് കടന്നുപോകുന്നത്.