Blockchain0x ఒక real Python package, , ను ship చేస్తుంది. దాన్ని install చేయండి, set చేయండి, call చేయండి, మరియు tools ను dedicated treasurer agent కు hand off చేయండి. ఆ agent USDC పంపగలదు, on-chain proof తో invoice settle చేయగలదు, మరియు wallets చదవగలదు, while the work agents in the crew carry no wallet access. USDC settles on Base.

ఒక పిప్ ఇన్‌స్టాల్. ఒక వాతావరణ మార్పిడి.

ప్యాకేజీకి Python 3.10 లేదా కొత్తది అవసరం మరియు కవితా లేదా పిప్‌తో పనిచేస్తుంది. ఇది కోర్ blockchain0x SDK మరియు crewai ను ఆధారాలుగా తీసుకుంటుంది; జోడించడానికి మరేదీ లేదు.

pip install blockchain0x-crewai

export BLOCKCHAIN0X_API_KEY=sk_test_...   # sk_test_ = Base Sepolia, sk_live_ = Base mainnet

BLOCKCHAIN0X_API_KEY అనేది మీ Blockchain0x dashboard నుండి వచ్చిన sk_test_ testnet లేదా sk_live_ mainnet key, మరియు adapter కు అవసరమైన ఏకైక variable ఇదే - ఇది key ను backend కు forward చేస్తుంది, స్వంత secret ఏదీ ఉంచదు. క్రింద ఉన్న webhook handler కోసం మీరు BLOCKCHAIN0X_WEBHOOK_SECRET ను కూడా set చేస్తారు, webhook ను create లేదా rotate చేసినప్పుడు dashboard దీన్ని ఒక్కసారి మాత్రమే ఇస్తుంది.

ఒక చెల్లింపు చేరినప్పుడు తదుపరి బృందాన్ని ప్రేరేపించడం.

USDC మీ ఏజెంట్ కు స్థిరమైనప్పుడు, Blockchain0x మీ వెబ్‌హుక్ URL కు సంతకం చేసిన ఈవెంట్‌ను POST చేస్తుంది. ధృవీకరణ సహాయాన్ని Node SDK లో పంపిస్తారు; ఒక Python సేవ డాక్యుమెంటెడ్ HMAC కు చేతితో ధృవీకరించుతుంది, ఇది సహాయానికి ఏదీ చేయదు. క్రింద ఫ్లాస్క్ ఉదాహరణ; అదే కోడ్ FastAPI లేదా ఏ Python వెబ్ ఫ్రేమ్‌వర్క్‌లో పనిచేస్తుంది.

import hmac, hashlib, os, time
from flask import Flask, request, abort

app = Flask(__name__)
SECRET = os.environ["BLOCKCHAIN0X_WEBHOOK_SECRET"].encode()

@app.post("/webhooks/payment")
def receive():
    raw = request.get_data()  # RAW bytes - do not parse first
    sig = request.headers.get("X-Blockchain0x-Signature", "")
    ts = request.headers.get("X-Blockchain0x-Timestamp", "")
    # Header is "t=<unix>,v1=<hex>"; some proxies send bare hex + the ts header.
    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:
        abort(401)
    if request.headers.get("X-Blockchain0x-Event-Type") == "payment.received":
        run_followup_for(request.get_json())  # USDC landed - do the work
    return "ok", 200

ఇది నిజమైన ఆల్గోరిథం: HMAC-SHA256 స్ట్రింగ్ t.rawBodyపై, ఒక స్థిర-సమయ పోల్చడం, మరియు 300-సెకన్ల పునరావృత విండో. కచ్చితమైన శరీరాన్ని చదవండి (request.get_data()), ఎప్పుడూ request.get_json() తిరిగి పునర్వినియోగం చేయకండి, ఎందుకంటే అది సంతకం కప్పే బైట్స్‌ను మార్చుతుంది. ఆర్కిటెక్చర్: హ్యాండ్లర్‌ను ఒక ఉద్యోగాన్ని (Celery, RQ, ఒక Redis జాబితా) ఎంక్యూ చేయడానికి ఉంచండి, ఇది నిజమైన CrewAI నడిపించడానికి ప్రేరేపిస్తుంది. హ్యాండ్లర్‌లో crew.kickoff()ను కాల్ చేయడం కొన్ని నిమిషాలు పడవచ్చు మరియు HTTP అభ్యర్థనను టైమ్ అవుట్ చేస్తుంది.

క్రూలో బిల్లింగ్‌ను వైర్ చేయడానికి గమనించాల్సిన ఐదు విషయాలు.

CrewAI యొక్క పాత్ర ఆధారిత డిజైన్ చెల్లింపు సమీకరణను ఇతర ఫ్రేమ్‌వర్క్‌ల కంటే శుభ్రంగా చేస్తుంది. దీని స్వంత పాదాలు కూడా ఉన్నాయి. ఇవి ముందుగా తెలుసుకోవడం సమయాన్ని ఆదా చేస్తుంది.