LlamaIndex-ନିର୍ଦ୍ଦିଷ୍ଟ କୌଣସି package ନାହିଁ, ଏବଂ ଆପଣଙ୍କୁ ଦରକାର ମଧ୍ୟ ନାହିଁ। LlamaIndex ସହିତ ସାଧାରଣ function କୁ tool ରେ ପରିଣତ କରେ, ସେଥିପାଇଁ ଆପଣ ସତ୍ୟ Python client କୁ function ଭିତରେ wrap କରି କିମ୍ବା ରେ add କରନ୍ତୁ। agent USDC ପଠାଇପାରେ, invoice settle କରିପାରେ, ଏବଂ wallet ପଢ଼ିପାରେ। ପ୍ରତି RAG query ରେ ଶୁଳ୍କ ନେବାକୁ, ଆପଣଙ୍କ own QueryEngineTool କୁ ସେଇ ଭଳି gate କରନ୍ତୁ। Payments Base ରେ settle ହୁଏ।

LlamaIndex ଏବଂ core SDK ଇନଷ୍ଟଲ୍ କରନ୍ତୁ। ଗୋଟିଏ environment variable।

ଯୋଡିବା ପାଇଁ blockchain0x LlamaIndex package ନାହିଁ। ଆପଣ LlamaIndex (Python 3.10+, modern FunctionAgent / ReActAgent / Workflows APIs) ଏବଂ ଆସଲ blockchain0x core SDK install କରନ୍ତୁ, ତାପରେ ତଳେ ଥିବା function ଲେଖନ୍ତୁ। ଯେକୌଣସି vector store ସହିତ କାମ କରେ - 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 ଏହାକୁ environment ରୁ ପଢ଼େ। ଯଦି ଆପଣ paid queries gate କରନ୍ତି, webhook handler କୁ ଅତିରିକ୍ତ ଭାବେ BLOCKCHAIN0X_WEBHOOK_SECRET ଆବଶ୍ୟକ, ଯାହା dashboard webhook create କିମ୍ବା rotate କରିବାବେଳେ ଗୋଟିଏଥର ଦେଉଛି।

ଯେତେବେଳେ ୱେବହୁକ୍ ଲାଣ୍ଡ୍ କରେ, ଭୁଗତାନ ଝଣ୍ଡାକୁ ଫ୍ଲିପ୍ କରନ୍ତୁ।

ପେମେଣ୍ଟ ସେଟଲ୍ ହେଲେ, Blockchain0x ଆପଣଙ୍କ webhook URL କୁ signed payment.received event POST କରେ। verify helper Node SDK ରେ ship ହୁଏ; Python service ରେ ଆପଣ documented HMAC ସହିତ ହାତେ verify କରନ୍ତି। ଆପଣଙ୍କ ନିଜ store ରେ caller କୁ paid ବୋଲି ଚିହ୍ନଟ କରନ୍ତୁ, ଏବଂ ଆପଣଙ୍କ gated query tool ପରବର୍ତ୍ତୀ call କୁ ଅନୁମତି ଦେଏ। ନିମ୍ନରେ FastAPI example.

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}

algorithm ଟି t.rawBody string ଉପରେ HMAC-SHA256, constant-time compare, ଏବଂ 300-second replay window ବ୍ୟବହାର କରେ। await request.body() ମାଧ୍ୟମରେ raw body ପଢ଼ନ୍ତୁ, କେବେ ମଧ୍ୟ request.json() re-serialized କରନ୍ତୁ ନାହିଁ, କାରଣ ଏହା signature ଆବର୍ତ୍ତିତ bytes କୁ ପରିବର୍ତ୍ତନ କରେ। shipped events ହେଉଛି payment.received, payment.sent, wallet.deployed, ଏବଂ webhook.test। heavy follow-up work ପାଇଁ, job (Celery, arq) enqueue କରନ୍ତୁ ଏବଂ handler କୁ block କରିବା ପେକ୍ଷା ସତ୍ୱର 200 respond କରନ୍ତୁ।

ଲ୍ୟାମାଇଣ୍ଡେକ୍ସ-ନିର୍ଦ୍ଦିଷ୍ଟ ଜାଲକୁ ଏଡାଇବାକୁ ପାଞ୍ଚ ଜାଲ।

ଏହାଗୁଡିକ ଆମର ସମର୍ଥନ ଇନବକ୍ସରୁ ଆସିଛି। ପ୍ରତିଟି ଏକ ଘଣ୍ଟାରୁ ଅଧିକ ଡିବଗିଂ ସଂରକ୍ଷଣ କରେ ଯେତେବେଳେ ଆପଣ ଏହା ବିଷୟରେ ଜାଣିଛନ୍ତି।