LlamaIndex 전용 패키지는 없으며, 필요하지도 않습니다. LlamaIndex는 로 일반 함수를 도구로 바꾸므로, 실제 Python 클라이언트를 함수로 감싸 또는 에 추가하면 됩니다. 에이전트는 USDC 전송, 인보이스 정산, 지갑 조회를 수행할 수 있습니다. RAG 쿼리당 과금하려면, 자체 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 키이며, client는 이를 environment에서 읽습니다. 유료 쿼리를 게이트하는 경우, webhook handler에는 추가로 BLOCKCHAIN0X_WEBHOOK_SECRET가 필요하며, 이는 webhook을 생성하거나 회전할 때 dashboard가 한 번 반환합니다.

웹후크가 도착할 때 유료 플래그를 전환합니다.

결제가 완료되면 Blockchain0x가 귀하의 웹훅 URL에 서명된 payment.received 이벤트를 POST합니다. verify 헬퍼는 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에 특화된 피해야 할 다섯 가지 함정.

이것들은 우리의 지원 인박스에서 나옵니다. 각각은 알고 나면 최소한 한 시간의 디버깅 시간을 절약합니다.