bridgenode-llm

BridgeNode Python SDK — AI inference without API keys. Pay per request with Solana USDC via x402. The payment handshake is fully automatic, and fees are sponsored — the agent needs no SOL.

Features

• No API keys, no registration — pay per request with USDC
• Automatic x402 handshake — 402 → signed transaction → 200, fully hidden
• Fee sponsorship (gasless) — the agent needs zero SOL
• Fail-closed spending policy — per-call and daily caps checked before signing
• Receipt verification — every response receipt is verified (invalid → error)
• Smart routing — mode: auto / eco / premium (model selection per prompt complexity)
• MCP support — BridgeNode is also available as an MCP server

Installation

pip install bridgenode-llm

Or install the full toolkit (SDK + CLI):

pip install bridgenode

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: payment, retry, receipt verification. No API key required.

Smart routing

# Let BridgeNode pick the model: auto / eco / premium
resp = client.chat(None, "Explain quantum computing", mode="auto")

Configuration (.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: after each response, the payment receipt is verified (success, network, payer, signature over your transaction, amount). Invalid receipt → BridgenodeError.
• Spending policy (fail-closed): BRIDGENODE_MAX_PER_CALL + BRIDGENODE_DAILY_CAP are checked BEFORE signing; exceeded → blocked, no payment.
• SIWX: automatic known-agent identification — falls back to payment if auth fails.

Requirements

• Python ≥ 3.11
• A Solana wallet with a USDC token account (ATA)

Links

• Website: https://bridgenode.cc
• Models & prices: https://bridgenode.cc/v1/models
• Documentation: https://bridgenode.cc/llms.txt
• Protocol: x402 V2 (https://docs.x402.org)