Blockchain0x ਇੱਕ ਅਸਲੀ Python package, , ਭੇਜਦਾ ਹੈ। ਇਸਨੂੰ install ਕਰੋ, set ਕਰੋ, call ਕਰੋ, ਅਤੇ tools ਇੱਕ dedicated treasurer agent ਨੂੰ ਦੇ ਦਿਓ। ਉਹ agent USDC ਭੇਜ ਸਕਦਾ ਹੈ, on-chain proof ਨਾਲ invoice settle ਕਰ ਸਕਦਾ ਹੈ, ਅਤੇ wallets ਪੜ੍ਹ ਸਕਦਾ ਹੈ, ਜਦਕਿ crew ਦੇ work agents ਕੋਲ ਕੋਈ wallet access ਨਹੀਂ ਹੁੰਦਾ। USDC Base 'ਤੇ settle ਹੁੰਦਾ ਹੈ।

ਇੱਕ pip ਇੰਸਟਾਲ ਕਰੋ। ਇੱਕ ਵਾਤਾਵਰਣ ਚਲ।

ਇਸ package ਲਈ Python 3.10 ਜਾਂ ਇਸ ਤੋਂ ਨਵਾਂ ਵਰਜਨ ਚਾਹੀਦਾ ਹੈ ਅਤੇ ਇਹ poetry ਜਾਂ pip ਨਾਲ ਕੰਮ ਕਰਦਾ ਹੈ। ਇਹ core blockchain0x SDK ਅਤੇ crewai ਨੂੰ dependencies ਵਜੋਂ ਲਿਆਉਂਦਾ ਹੈ; ਹੋਰ ਕੁਝ add ਕਰਨ ਦੀ ਲੋੜ ਨਹੀਂ।

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 ਕਰਦੇ ਹੋ, ਜੋ dashboard webhook create ਜਾਂ rotate ਕਰਨ ਸਮੇਂ ਇਕ ਵਾਰ ਦਿੰਦਾ ਹੈ।

ਜਦੋਂ ਇੱਕ ਭੁਗਤਾਨ ਲੈਂਡ ਕਰਦਾ ਹੈ, ਅਗਲੇ ਕ੍ਰੂ ਨੂੰ ਚਾਲੂ ਕਰਨਾ।

ਜਦੋਂ USDC ਤੁਹਾਡੇ agent ਨੂੰ settle ਹੁੰਦਾ ਹੈ, Blockchain0x ਤੁਹਾਡੇ webhook URL 'ਤੇ ਇੱਕ signed event POST ਕਰਦਾ ਹੈ। verify helper Node SDK ਵਿੱਚ ship ਹੁੰਦਾ ਹੈ; Python service documented HMAC ਦੇ ਖਿਲਾਫ ਖੁਦ verify ਕਰਦੀ ਹੈ, ਜੋ helper ਵੀ ਕਰਦਾ ਹੈ। ਹੇਠਾਂ Flask example ਹੈ; ਉਹੀ code FastAPI ਜਾਂ ਕਿਸੇ ਵੀ Python web framework ਵਿੱਚ ਕੰਮ ਕਰਦਾ ਹੈ।

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 ਦਾ ਭੂਮਿਕਾ ਆਧਾਰਿਤ ਡਿਜ਼ਾਇਨ ਭੁਗਤਾਨ ਇੰਟੇਗ੍ਰੇਸ਼ਨ ਨੂੰ ਹੋਰ ਫਰੇਮਵਰਕਾਂ ਨਾਲੋਂ ਸਾਫ਼ ਬਣਾਉਂਦਾ ਹੈ। ਇਸ ਵਿੱਚ ਆਪਣੇ ਹੀ ਖਤਰੇ ਵੀ ਹਨ। ਇਹਨਾਂ ਨੂੰ ਪਹਿਲਾਂ ਜਾਣਨਾ ਸਮਾਂ ਬਚਾਉਂਦਾ ਹੈ।