Python SDK

# For AI agents (wallet + on-chain payments)
pip install xenarch[agent]

# For publishers (FastAPI middleware)
pip install xenarch[fastapi]

# For LangChain agents
pip install xenarch[agent,langchain]

# For CrewAI agents
pip install xenarch[agent,crewai]

from xenarch.wallet import load_wallet, load_wallet_or_create, generate_wallet

# Load from env vars or ~/.xenarch/wallet.json
wallet = load_wallet()

# Load or auto-create on first run
wallet = load_wallet_or_create()

# Generate a new wallet
wallet = generate_wallet()

print(wallet.address)      # 0x...
print(wallet.network)      # "base" or "base-sepolia"
print(wallet.rpc_url)      # RPC endpoint

from xenarch.agent_client import check_gate, check_gate_by_domain

# Check by URL (makes an HTTP request, looks for 402)
gate = check_gate("https://example.com/premium")

# Check by domain (queries the platform API)
gate = check_gate_by_domain("https://xenarch.dev", "example.com")

if gate:
    print(gate.price_usd)   # "0.003"
    print(gate.splitter)     # Splitter contract address
    print(gate.collector)    # Publisher wallet
    print(gate.verify_url)   # Verification endpoint

from xenarch.payment import execute_payment

result = execute_payment(
    wallet=wallet,
    splitter_address=gate.splitter,
    collector_address=gate.collector,
    price_usd=gate.price_usd,
)

print(result.tx_hash)       # "0x..."
print(result.block_number)  # 28451023

from xenarch.agent_client import verify_payment

result = verify_payment(gate.verify_url, tx_hash)
print(result["access_token"])  # "eyJ..."
print(result["expires_at"])    # "2026-04-10T15:05:00Z"

from xenarch.agent_client import get_payment_history

history = get_payment_history(
    api_base="https://xenarch.dev",
    wallet_address=wallet.address,
    domain="example.com",  # optional filter
    limit=10,
)

for item in history:
    print(f"{item.domain}: ${item.amount_usd} ({item.tx_hash})")

from xenarch.middleware import XenarchMiddleware

app.add_middleware(
    XenarchMiddleware,
    site_token="st_...",
    site_id="your-site-uuid",
    access_token_secret="your_secret",
    api_base="https://xenarch.dev",         # optional
    excluded_paths={"/healthz", "/docs"},    # optional
)

from xenarch.decorator import require_payment

gate = require_payment(
    site_token="st_...",
    site_id="your-site-uuid",
    access_token_secret="your_secret",
)

@app.get("/premium")
@gate
async def premium(request: Request):
    return {"content": "premium data"}

from xenarch.token import verify_access_token

result = verify_access_token(token, site_id, secret)
# Returns payload dict if valid, None if invalid/expired

from xenarch.detection import is_bot

is_bot("GPTBot/1.0")           # True
is_bot("Mozilla/5.0 Chrome")   # False