OpenAI Agents SDK साठी कोणतेही package नाही, आणि तुम्हाला त्याची गरजही नाही. SDK decorated function ला सह tool मध्ये रूपांतरित करते, त्यामुळे तुम्ही खरा Python client एका function मध्ये wrap करता आणि तो तुमच्या मध्ये add करता. एजंट USDC पाठवू शकतो, invoices settle करू शकतो, आणि wallets read करू शकतो - single agents, handoffs, आणि underlying Responses API across. Payments Base वर settle होतात.

Agents 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 की आहे (Agents SDK ती underlying Responses API साठी वापरते). BLOCKCHAIN0X_API_KEY ही तुमच्या dashboard मधील sk_test_ testnet किंवा sk_live_ mainnet की आहे; client ती environment मधून वाचतो. जर तुमच्या agent ला पैसे देखील मिळत असतील, तर webhook handler ला BLOCKCHAIN0X_WEBHOOK_SECRET देखील लागतो.

स्वाक्षरी केलेल्या वेबहुकसह इनबाउंड पेमेंटची पुष्टी करा.

जर तुमचा एजंट USDC देखील प्राप्त करतो, तर ते वेबहुकद्वारे पुष्टी करा, मतदानाद्वारे नाही. सत्यापन सहाय्यक 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) एनक्यू करा आणि हँडलरला ब्लॉक करण्याऐवजी त्वरित 200 प्रतिसाद द्या.

पहिल्या एकत्रीकरणावर लक्ष ठेवण्यासारख्या पाच गोष्टी.

हे आमच्या समर्थन इनबॉक्समधून येतात. त्यांना आधीच माहित असणे प्रत्येकाला एक तास वाचवते.