bridgenode-llm

BridgeNode Python SDK — AI inference without API keys. Payment: Solana USDC via x402 (automatic handshake, fee sponsorship — no SOL needed for the agent).

Installation

pip install bridgenode-llm

Usage

from bridgenode_llm import LLMClient

client = LLMClient()  # key from .env (BRIDGENODE_WALLET_KEY)
resp = client.chat("deepseek-v4-flash", [
    {"role": "user", "content": "Hello!"}])
print(resp["choices"][0]["message"]["content"])

Everything is handled automatically: 402 → partial TX → PAYMENT-SIGNATURE → 200 (§4.1). No API key required.

.env

# Required — your Solana wallet private key (base58)
BRIDGENODE_WALLET_KEY=...
# Optional:
# BRIDGENODE_BASE_URL=https://bridgenode.cc/v1
# BRIDGENODE_MAX_PER_CALL=0.05   # spending policy: max USD per call (fail-closed)
# BRIDGENODE_DAILY_CAP=1.0       # spending policy: max USD per day

Security

• Receipt verification (Free-Riding protection): after 200, PAYMENT-RESPONSE is verified — success, network, payer, fee payer signature over our TX message, amount. Invalid receipt → BridgenodeError.
• Spending policy (fail-closed): BRIDGENODE_MAX_PER_CALL + BRIDGENODE_DAILY_CAP — checked BEFORE signing; exceeded → blocked, no payment.
• SIWX: automatic known-agent identification (§5.7) — falls back to payment if auth fails.

Commands

client.chat(model, messages, max_tokens=..., mode="auto")  # mode: auto/eco/premium

Requirements

• Python ≥ 3.11
• Solana wallet with USDC ATA (rent — agent's responsibility, §3.3)

Links

• Website: https://bridgenode.cc
• Protocol: x402 V2 (docs.x402.org)