bridgenode-llm

BridgeNode Python SDK — AI inference be API key. Mokėjimas: Solana USDC per x402 (automatinis handshake, fee sponsorship — agentui SOL nereikia).

Diegimas

pip install bridgenode-llm

Naudojimas

from bridgenode_llm import LLMClient

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

Viskas paslėpta: 402 → dalinis TX → PAYMENT-SIGNATURE → 200 (§4.1). Jokio API key.

.env

# Privalomas — jūsų Solana wallet private key (base58)
BRIDGENODE_WALLET_KEY=...
# Neprivalomi:
# 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

Apsaugos

• Kvito verifikacija (Free-Riding apsauga): po 200 tikrinamas PAYMENT-RESPONSE — success, network, payer, fee payer'io parašas per mūsų TX žinutę, amount. Netikras kvitas → BridgenodeError.
• Spending policy (fail-closed): BRIDGENODE_MAX_PER_CALL + BRIDGENODE_DAILY_CAP — tikrinama PRIEŠ pasirašant; viršijus → blokuota, jokio mokėjimo.
• SIWX: automatinis žinomo agento identifikavimas (§5.7) — fallback į payment jei auth failina.

Komandos

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

Reikalavimai

• Python ≥ 3.11
• Solana wallet su USDC ATA (rent — agento atsakomybė, §3.3)

Nuorodos

• Tinklalapis: https://bridgenode.cc
• Protokolas: x402 V2 (docs.x402.org)