⚡ invinoveritas

Über Lightning bezahltes Reasoning und Entscheidungsintelligenz für autonome Agenten

Pay-per-Insight-API unter Verwendung des L402-Protokolls (Bitcoin Lightning). Keine Abonnements. Keine Konten. Kein KYC.

Live-API: https://invinoveritas.onrender.com MCP-Endpunkt: https://invinoveritas.onrender.com/mcp MCP-Registry: io.github.babyblueviper1/invinoveritas

Schnellstart

Python SDK — manueller Zahlungsablauf

pip install invinoveritas

from invinoveritas import InvinoClient, PaymentRequired

client = InvinoClient()

try:
    result = client.reason("What are the biggest risks for Bitcoin in 2026?")
except PaymentRequired as e:
    print(f"Pay: {e.invoice}  ({e.amount_sats} sats)")
    result = client.reason(
        "What are the biggest risks for Bitcoin in 2026?",
        payment_hash=e.payment_hash,
        preimage="your_preimage_here",
    )
    print(result.answer)

Python SDK — autonome Zahlungen (v0.3.1)

Agenten bezahlen automatisch. Kein Mensch im Prozess erforderlich.

# LND node
pip install "invinoveritas[langchain]"

# Alby, Zeus, or any NWC wallet (no node required)
pip install "invinoveritas[nwc]"

# With LND
from invinoveritas.langchain import InvinoCallbackHandler, create_invinoveritas_tools
from invinoveritas.providers import LNDProvider

handler = InvinoCallbackHandler(
    provider=LNDProvider(
        macaroon_path="/root/.lnd/data/chain/bitcoin/mainnet/admin.macaroon",
        cert_path="/root/.lnd/tls.cert"
    )
)

# With NWC (Alby, Zeus, Mutiny — no node required)
from invinoveritas.providers import NWCProvider

handler = InvinoCallbackHandler(
    provider=NWCProvider(uri="nostr+walletconnect://...")
)

tools = create_invinoveritas_tools(handler)
result = agent.run("Should I increase my BTC exposure in 2026?", callbacks=[handler])
print(f"Spent: {handler.total_spent_sats} sats")

Vollständige SDK-Dokumentation → sdk/README.md

Agenten-Wallets

Agenten können automatisch über Lightning bezahlen. Es gibt zwei Hauptoptionen:

• LND-Node — Volle Kontrolle, betreibt Ihren eigenen Lightning-Node

• NWC-Wallet (Alby, Zeus, Mutiny) — Kein Node erforderlich, einfachste Einrichtung

Alle Zahlungen sind kryptografisch verifizierbar und atomar.

Minimales SDK-Beispiel (NWC-Wallet)

from invinoveritas.providers import NWCProvider
from invinoveritas.langchain import InvinoCallbackHandler, create_invinoveritas_tools

handler = InvinoCallbackHandler(
    provider=NWCProvider(uri="nostr+walletconnect://YOUR_WALLET_URI_HERE")
)

tools = create_invinoveritas_tools(handler)

result = agent.run(
    "Should I increase my BTC exposure in 2026?", 
    callbacks=[handler]
)

print(f"Spent: {handler.total_spent_sats} sats")
print(result)

Ersetzen Sie YOUR_WALLET_URI_HERE durch Ihre WalletConnect-URI von Alby, Zeus oder Mutiny.

Für LND-Node-Benutzer

Tauschen Sie einfach den Provider aus:

from invinoveritas.providers import LNDProvider
from invinoveritas.langchain import InvinoCallbackHandler, create_invinoveritas_tools

handler = InvinoCallbackHandler(
    provider=LNDProvider(
        macaroon_path="/root/.lnd/data/chain/bitcoin/mainnet/admin.macaroon",
        cert_path="/root/.lnd/tls.cert"
    )
)

tools = create_invinoveritas_tools(handler)

Offizielle Anleitungen zur Wallet-Einrichtung

• LND-Node: https://docs.lightning.engineering

• WalletConnect / NWC-Wallets: https://walletconnect.com/

MCP-Endpunkt (Claude Desktop, Cursor)

Verweisen Sie Ihren MCP-kompatiblen Agenten auf:

https://invinoveritas.onrender.com/mcp

Vollständige L402-Zahlungsabwicklung integriert. Unterstützt initialize, tools/list und callTool.

lnget (CLI-Agenten)

lnget handhabt L402 automatisch:

lnget POST https://invinoveritas.onrender.com/reason \
  '{"question": "What are the biggest risks for Bitcoin in 2026?"}'

Direktes HTTP

curl -X POST https://invinoveritas.onrender.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "callTool",
    "params": {
      "name": "reason",
      "arguments": { "question": "What are the biggest risks for Bitcoin in 2026?" }
    }
  }'

Nachdem Sie die zurückgegebene Rechnung bezahlt haben, versuchen Sie es erneut mit: -H "Authorization: L402 <payment_hash>:<preimage>"

Preisgestaltung (Dynamisch)

Die Preise können je nach Eingabelänge leicht variieren. Vollständige Preisliste → /prices

Guthabenbasierte Konten (Optional)

Für Benutzer oder Agenten, die vorfinanzierte Konten bevorzugen, anstatt pro Aufruf zu bezahlen:

• Konto registrieren POST /accounts/register → Gibt eine 1000-Sats-Rechnung zurück

• Aufladen POST /accounts/topup → Geben Sie api_key und Betrag an

• Aufladung begleichen POST /accounts/settle-topup → Mit Preimage bestätigen

• Guthaben nutzen Fügen Sie Ihren api_key in Anfragen ein — das Guthaben wird automatisch abgebucht

• Guthaben prüfen GET /accounts/balance?api_key=<your_api_key>

Vorteile: Keine Rechnung pro Aufruf, ideal für hochfrequente Nutzung.

Warum Agenten invinoveritas nutzen

Autonome Agenten nutzen invinoveritas, wenn sie Folgendes benötigen:

• Strategisches Reasoning, das tiefer geht als lokale Modelle

• Strukturierte, maschinenlesbare Entscheidungen mit Konfidenz- und Risikowerten

• Deterministische, vorhersehbare Kosten (bezahlt in Sats)

• Kryptografisch verifizierbare Zahlungen über Lightning

• Native MCP-Tool-Unterstützung

Bezahlen Sie nur, wenn die Erkenntnis wirklich zählt — atomar, mit Bitcoin Lightning.

Kern-Tools

• reason — Premium strategisches Reasoning

• decide — Strukturierte Entscheidungsintelligenz mit Konfidenz- und Risikowerten

Beide Tools unterstützen den vollständigen L402-Zahlungsablauf via REST, MCP oder SDK.

Zahlungsablauf (L402)

1. Erster Aufruf → gibt 402 Payment Required + Lightning-Rechnung zurück

2. Bezahlen Sie die Rechnung mit einer beliebigen Lightning-Wallet oder lnget

3. Versuchen Sie es erneut mit: Authorization: L402 <payment_hash>:<preimage>

4. Ergebnis erhalten

Vollständige Anleitung → /guide

Discovery-Endpunkte (Kostenlos)

• GET /health — Servicestatus und Preisgestaltung

• GET /prices — Alle Tool-Preise in einem Aufruf

• GET /guide — Schritt-für-Schritt-Zahlungsanleitung

• GET /.well-known/mcp/server-card.json — MCP-Server-Card

• GET /price/{endpoint} — Aktueller Preis in Sats

Philosophie

Die meisten KI-Agenten stecken in Abonnements oder unvorhersehbaren Token-Kosten fest.

invinoveritas bietet ein besseres Modell:

Atomare Intelligenzkäufe mittels Bitcoin Lightning.

Bezahlen Sie nur, wenn die Entscheidung zählt — mit Sats, sofort und ohne Zwischenhändler.

Gebaut für die Bitcoin × KI-Zukunft. ⚡

Quick Links

• GitHub: https://github.com/babyblueviper1/invinoveritas

• Live-API: https://invinoveritas.onrender.com

• MCP-Endpunkt: https://invinoveritas.onrender.com/mcp

• MCP-Registry: https://registry.modelcontextprotocol.io

• PyPI: https://pypi.org/project/invinoveritas/

• Health Check: https://invinoveritas.onrender.com/health

• Zahlungsanleitung: https://invinoveritas.onrender.com/guide