Không có package riêng cho LlamaIndex, và bạn cũng không cần một package như vậy. LlamaIndex biến một hàm thuần thành một tool với , vì vậy bạn bọc Python client thực sự trong một hàm và thêm nó vào một hoặc . Agent có thể gửi USDC, thanh toán hóa đơn và đọc ví. Để tính phí theo từng truy vấn RAG, hãy chặn QueryEngineTool của riêng bạn theo cách tương tự. Thanh toán được chốt trên Base.

Cài đặt LlamaIndex và SDK cốt lõi. Một biến môi trường.

Không có gói blockchain0x LlamaIndex nào để thêm. Bạn cài đặt LlamaIndex (Python 3.10+, các API FunctionAgent / ReActAgent / Workflows hiện đại) và SDK cốt lõi blockchain0x thực tế, sau đó viết hàm bên dưới. Hoạt động cùng với bất kỳ kho vector nào - Pinecone, Qdrant, Chroma, Weaviate, LlamaIndex Cloud.

pip install llama-index blockchain0x

export BLOCKCHAIN0X_API_KEY=sk_test_...   # sk_test_ = Base Sepolia, sk_live_ = Base mainnet

BLOCKCHAIN0X_API_KEY là một khóa sk_test_ testnet hoặc sk_live_ mainnet từ dashboard của bạn; client đọc nó từ môi trường. Nếu bạn chặn các truy vấn trả phí, webhook handler còn cần BLOCKCHAIN0X_WEBHOOK_SECRET, giá trị này dashboard chỉ trả về một lần khi bạn tạo hoặc xoay vòng một webhook.

Lật cờ đã thanh toán khi webhook đến.

Khi một khoản thanh toán được giải quyết, Blockchain0x POST một sự kiện payment.received đã ký đến URL webhook của bạn. Trợ giúp xác minh được cung cấp trong SDK Node; trong một dịch vụ Python, bạn xác minh bằng tay theo HMAC đã được tài liệu hóa. Đánh dấu người gọi đã thanh toán trong cửa hàng của riêng bạn, và công cụ truy vấn được khóa của bạn cho phép cuộc gọi tiếp theo đi qua. 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 - serve the paid query
    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. Đối với công việc theo dõi nặng, hãy xếp hàng một công việc (Celery, arq) và phản hồi 200 ngay lập tức thay vì chặn trình xử lý.

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

Những điều này đến từ hộp thư hỗ trợ của chúng tôi. Mỗi điều tiết kiệm ít nhất một giờ gỡ lỗi khi bạn biết về nó.