OpenAI Agents SDK-യ്ക്ക് പ്രത്യേക package ഒന്നുമില്ല, അതിനാൽ ആവശ്യമുമില്ല. SDK ഉപയോഗിച്ച് ഒരു decorated function-നെ tool ആക്കുന്നതിനാൽ, real Python client-നെ ഒരു function-ൽ wrap ചെയ്ത് നിങ്ങളുടെ -ൽ ചേർക്കുക. agent-ന് USDC അയക്കാനും, invoices settle ചെയ്യാനും, wallets വായിക്കാനും കഴിയും - single agents, handoffs, underlying Responses API എന്നിവയിലുടനീളം. Payments Base-ൽ settle ചെയ്യും.

എജന്റുകളുടെ SDK ഇൻസ്റ്റാൾ ചെയ്യുക, കൂടാതെ കോർ SDK. രണ്ട് കീകൾ.

ചേർക്കാൻ blockchain0x Agents SDK പാക്കേജ് ഇല്ല. നിങ്ങൾ OpenAI Agents SDK (openai-agents പാക്കേജ്, Python 3.10+) ഇൻസ്റ്റാൾ ചെയ്യുന്നു, യഥാർത്ഥ blockchain0x കോർ SDK, പിന്നെ താഴെ ഫംഗ്ഷൻ എഴുതുന്നു. അത് മുഴുവൻ ആശ്രിതങ്ങളുടെ പട്ടികയാണ്.

pip install openai-agents blockchain0x

export OPENAI_API_KEY=sk-...
export BLOCKCHAIN0X_API_KEY=sk_test_...   # sk_test_ = Base Sepolia, sk_live_ = Base mainnet

OPENAI_API_KEY നിങ്ങളുടെ നിലവിലുള്ള OpenAI key ആണ് (Agents SDK അതിനെ അടിസ്ഥാന Responses API-ക്കായി ഉപയോഗിക്കുന്നു). BLOCKCHAIN0X_API_KEY നിങ്ങളുടെ dashboard-ലുള്ള sk_test_ testnet അല്ലെങ്കിൽ sk_live_ mainnet കീ ആണ്; client അതിനെ environment-ൽ നിന്ന് വായിക്കുന്നു. നിങ്ങളുടെ agent-ിന് money സ്വീകരിക്കാനുമുണ്ടെങ്കിൽ, webhook handler-ിന് കൂടാതെ BLOCKCHAIN0X_WEBHOOK_SECRET ആവശ്യമാണ്.

ഒരു ഒപ്പിട്ട വെബ് ഹുക്ക് ഉപയോഗിച്ച് വരവേൽപ്പു പണമടച്ചുകൾ സ്ഥിരീകരിക്കുക.

നിങ്ങളുടെ ഏജന്റ് USDC സ്വീകരിക്കുന്നുവെങ്കിൽ, polling വഴി അല്ലാതെ വെബ്‌ഹുക്ക് ഉപയോഗിച്ച് ഇത് സ്ഥിരീകരിക്കുക. verify സഹായി Node SDK-യിൽ എത്തിക്കുന്നു; ഒരു Python സേവനത്തിൽ, രേഖപ്പെടുത്തിയ HMAC-ന് എതിരായും നിങ്ങൾ കൈകൊണ്ടു സ്ഥിരീകരിക്കുന്നു, ഇത് സഹായിയുടെ എല്ലാ കാര്യങ്ങളും ചെയ്യുന്നു. താഴെയുള്ള FastAPI ഉദാഹരണം; ഒരുപോലെ കോഡ് ഏതെങ്കിലും അസിങ്ക് Python ഫ്രെയിംവർക്കിൽ പ്രവർത്തിക്കുന്നു.

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 - run the next step
    return {"ok": True}

അൽഗോറിതം t.rawBody എന്ന വരിയിൽ HMAC-SHA256 ആണ്, സ്ഥിരമായ സമയത്ത് താരതമ്യം ചെയ്യുന്നു, 300-സെക്കൻഡ് പുനരാവൃത്തി വിൻഡോ. ഒപ്പുവെച്ചതിന്റെ അക്ഷരരൂപം നിലനിർത്താൻ await request.body() വഴി കച്ചവട ബോഡി വായിക്കുക, request.json() വീണ്ടും സീരിയലൈസ് ചെയ്യരുത്, കാരണം അത് ഒപ്പുവെച്ചതിന്റെ പരിധിയിൽ വരുന്ന ബൈറ്റുകൾ മാറ്റുന്നു. അയച്ച ഇവന്റുകൾ payment.received, payment.sent, wallet.deployed, webhook.test എന്നിവയാണ്. ഭാരമുള്ള പിന്തുടർച്ചാ പ്രവർത്തനങ്ങൾക്ക്, ഒരു ജോലി (Celery, arq) enqueue ചെയ്യുക, ഹാൻഡ്ലർ തടയുന്നതിന് പകരം ഉടൻ 200 പ്രതികരിക്കുക.

ആദ്യ ഇന്റഗ്രേഷനിൽ ശ്രദ്ധിക്കേണ്ട അഞ്ചു കാര്യങ്ങൾ.

ഇവ നമ്മുടെ പിന്തുണ ഇൻബോക്സിൽ നിന്നാണ്. അവയെ മുൻകൂട്ടി അറിയുന്നത് ഓരോന്നിനും ഒരു മണിക്കൂർ സംരക്ഷിക്കുന്നു.