LlamaIndex साठी कोणतेही विशिष्ट package नाही, आणि तुम्हाला त्याची गरजही नाही. LlamaIndex साध्या function ला सह tool मध्ये रूपांतरित करते, त्यामुळे तुम्ही खरा Python client एका function मध्ये wrap करता आणि तो किंवा मध्ये add करता. एजंट USDC पाठवू शकतो, invoices settle करू शकतो, आणि wallets read करू शकतो. प्रति RAG query शुल्क घेण्यासाठी, तुमचा स्वतःचा QueryEngineTool त्याच प्रकारे gate करा. Payments Base वर settle होतात.

LlamaIndex आणि मुख्य SDK स्थापित करा. एक पर्यावरणीय चल.

जोडण्यासाठी blockchain0x LlamaIndex पॅकेज नाही. तुम्ही LlamaIndex (Python 3.10+, आधुनिक FunctionAgent / ReActAgent / Workflows APIs) आणि वास्तविक 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 मधून वाचतो. जर तुम्ही paid queries gate करत असाल, तर webhook handler ला BLOCKCHAIN0X_WEBHOOK_SECRET देखील लागतो, जो webhook तयार करताना किंवा rotate करताना डॅशबोर्ड एकदाच परत देतो.

वेबहुक लँड झाल्यावर पैसे दिलेले ध्वज उलटा करा.

Payment settle झाल्यावर Blockchain0x तुमच्या webhook URL वर signed payment.received event POST करते. verify helper Node SDK मध्ये येतो; Python service मध्ये तुम्ही दस्तऐवजीकृत HMAC विरुद्ध हाताने verify करता. तुमच्या स्वतःच्या store मध्ये caller ला paid म्हणून नोंदवा, आणि तुमचा gated query tool पुढचा call परवानगी देईल. खाली 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-विशिष्ट जाळे टाळा.

हे आमच्या समर्थन इनबॉक्समधून येतात. प्रत्येकाने तुम्हाला याबद्दल माहिती मिळाल्यावर किमान एक तास डिबगिंग वाचवतो.