Không có package riêng cho Pydantic AI, và bạn cũng không cần một package như vậy. Pydantic AI biến một hàm thành một tool đã được xác thực với , vì vậy bạn bọc Python client thực sự trong một hàm có kiểu và agent có thể gửi USDC, thanh toán hóa đơn và đọc ví. Nó hoạt động trên OpenAI, Anthropic, Google, Mistral, Groq và mọi nhà cung cấp khác của Pydantic AI, vì tool gọi HTTP API chứ không gọi model. Thanh toán được chốt trên Base.

Cài đặt Pydantic AI và SDK cốt lõi. Hai khóa.

Không có gói blockchain0x Pydantic AI nào để thêm. Bạn cài đặt Pydantic AI (Python 3.10+) và SDK cốt lõi blockchain0x thực tế, sau đó viết hàm bên dưới. Đó là toàn bộ danh sách phụ thuộc.

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 (hoặc khóa tương đương cho nhà cung cấp bạn dùng). BLOCKCHAIN0X_API_KEY là khóa sk_test_ testnet hoặc sk_live_ mainnet từ dashboard của bạn; client sẽ đọc khóa này từ biến môi trường. Nếu agent của bạn cũng nhận tiền, webhook handler còn cần thêm BLOCKCHAIN0X_WEBHOOK_SECRET.

Xác nhận các khoản thanh toán đến với một webhook đã ký.

Nếu tác nhân của bạn cũng nhận USDC, hãy xác nhận điều đó với webhook thay vì polling. Trợ giúp xác minh có trong Node SDK; trong một dịch vụ Python, bạn xác minh bằng tay theo HMAC đã được tài liệu hóa. Nếu bạn muốn các sự kiện kiểu, hãy định nghĩa mô hình Pydantic của riêng bạn và model_validate_json phần thân thô sau khi chữ ký được kiểm tra - kiểu là của bạn để thêm vào. Ví dụ FastAPI bên dưới.

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}

Thuật toán là HMAC-SHA256 trên chuỗi t.rawBody, so sánh thời gian không đổi và cửa sổ phát lại 300 giây. Đọc nội dung thô qua await request.body(), không bao giờ request.json() được tái tuần tự hóa, vì điều đó thay đổi các byte mà chữ ký bao phủ. Các sự kiện đã được gửi là payment.received, payment.sent, wallet.deployed và webhook.test; thu hẹp trên tiêu đề X-Blockchain0x-Event-Type để phân nhánh.

Năm cạm bẫy cụ thể về Pydantic AI cần tránh.

Kiểu mạnh của Pydantic AI phát hiện hầu hết các lỗi tích hợp tại ranh giới; đây là một vài lỗi lọt qua.