没有 LlamaIndex-specific package，而且你也不需要。LlamaIndex 会用 将普通函数变成工具，因此你只需把真实的 Python client 封装成函数，并将其加入 或 。代理可以发送 USDC、结算 invoice、读取钱包。若要按每次 RAG query 计费，可用同样方式对你自己的 QueryEngineTool 做门控。支付在 Base 上结算。

安装LlamaIndex和核心SDK。一个环境变量。

没有可以添加的 blockchain0x LlamaIndex 包。您安装 LlamaIndex（Python 3.10+，现代的 FunctionAgent / ReActAgent / Workflows API）和真正的 blockchain0x 核心 SDK，然后编写下面的函数。可以与任何向量存储一起使用 - 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 是你 dashboard 中的 sk_test_ testnet 或 sk_live_ mainnet key；client 会从环境变量读取它。如果你要对付费查询做门控，webhook handler 还需要 BLOCKCHAIN0X_WEBHOOK_SECRET，该值会在你创建或轮换 webhook 时由 dashboard 仅返回一次。

当 webhook 到达时翻转已支付标志。

当支付结算时，Blockchain0x 会将签名的 payment.received 事件 POST 到您的 webhook URL。验证助手包含在 Node SDK 中；在 Python 服务中，您手动根据文档中的 HMAC 进行验证。在您自己的存储中标记呼叫者已付款，您的限制查询工具允许下一个调用通过。下面是 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 - serve the paid query
    return {"ok": True}

该算法是针对字符串 t.rawBody 的 HMAC-SHA256，具有常量时间比较和 300 秒的重放窗口。通过 await request.body() 读取原始主体，绝不要 request.json() 重新序列化，因为这会更改签名覆盖的字节。已发布的事件是 payment.received、payment.sent、wallet.deployed 和 webhook.test。对于重的后续工作，排队一个作业（Celery、arq）并立即响应 200，而不是阻塞处理程序。

五个需要避免的 LlamaIndex 特定陷阱。

这些来自我们的支持收件箱。一旦您知道它们，每个都能节省至少一个小时的调试时间。