⚡ invinoveritas

Razonamiento e inteligencia de decisiones pagados mediante Lightning para agentes autónomos

API de pago por información utilizando el protocolo L402 (Bitcoin Lightning). Sin suscripciones. Sin cuentas. Sin KYC.

API en vivo: https://invinoveritas.onrender.com Endpoint MCP: https://invinoveritas.onrender.com/mcp Registro MCP: io.github.babyblueviper1/invinoveritas

Inicio rápido

SDK de Python — flujo de pago manual

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)

SDK de Python — pagos autónomos (v0.3.1)

Los agentes pagan automáticamente. Sin intervención humana.

# 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")

Documentación completa del SDK → sdk/README.md

Carteras de agentes

Los agentes pueden pagar automáticamente usando Lightning. Hay dos opciones principales:

• Nodo LND — Control total, ejecuta tu propio nodo Lightning

• Cartera NWC (Alby, Zeus, Mutiny) — No requiere nodo, configuración más sencilla

Todos los pagos son criptográficamente verificables y atómicos.

Ejemplo mínimo de SDK (Cartera NWC)

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)

Reemplaza YOUR_WALLET_URI_HERE con tu URI de WalletConnect de Alby, Zeus o Mutiny.

Para usuarios de nodos LND

Simplemente cambia el proveedor:

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)

Guías oficiales de configuración de carteras

• Nodo LND: https://docs.lightning.engineering

• WalletConnect / Carteras NWC: https://walletconnect.com/

Endpoint MCP (Claude Desktop, Cursor)

Dirige tu agente compatible con MCP a:

https://invinoveritas.onrender.com/mcp

Gestión de pagos L402 integrada. Soporta initialize, tools/list y callTool.

lnget (Agentes CLI)

lnget gestiona L402 automáticamente:

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

HTTP directo

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?" }
    }
  }'

Después de pagar la factura devuelta, vuelve a intentarlo con: -H "Authorization: L402 <payment_hash>:<preimage>"

Precios (Dinámicos)

Los precios pueden variar ligeramente según la longitud de la entrada. Precios completos → /prices

Cuentas basadas en créditos (Opcional)

Para usuarios o agentes que prefieren cuentas prefinanciadas en lugar de pagar por llamada:

• Registrar una cuenta POST /accounts/register → Devuelve una factura de 1000 sats

• Recargar POST /accounts/topup → Proporciona api_key y cantidad

• Liquidar recarga POST /accounts/settle-topup → Confirma con la preimagen

• Usar créditos Incluye tu api_key en las solicitudes — el saldo se debita automáticamente

• Consultar saldo GET /accounts/balance?api_key=<your_api_key>

Beneficios: Sin factura por llamada, ideal para uso de alta frecuencia.

Por qué los agentes usan invinoveritas

Los agentes autónomos usan invinoveritas cuando necesitan:

• Razonamiento estratégico más profundo que los modelos locales

• Decisiones estructuradas y legibles por máquina con puntuaciones de confianza y riesgo

• Costos deterministas y predecibles (pagados en sats)

• Pagos criptográficamente verificables a través de Lightning

• Soporte nativo para herramientas MCP

Paga solo cuando la información realmente importe — de forma atómica, con Bitcoin Lightning.

Herramientas principales

• reason — Razonamiento estratégico premium

• decide — Inteligencia de decisiones estructurada con puntuaciones de confianza y riesgo

Ambas herramientas soportan el flujo de pago L402 completo a través de REST, MCP o SDK.

Flujo de pago (L402)

1. Primera llamada → devuelve 402 Payment Required + factura Lightning

2. Paga la factura usando cualquier cartera Lightning o lnget

3. Vuelve a intentar con: Authorization: L402 <payment_hash>:<preimage>

4. Recibe el resultado

Guía completa → /guide

Endpoints de descubrimiento (Gratis)

• GET /health — Estado del servicio y precios

• GET /prices — Todos los precios de las herramientas en una sola llamada

• GET /guide — Guía de pago paso a paso

• GET /.well-known/mcp/server-card.json — Tarjeta del servidor MCP

• GET /price/{endpoint} — Precio actual en sats

Filosofía

La mayoría de los agentes de IA están atrapados con suscripciones o costos de tokens impredecibles.

invinoveritas ofrece un modelo mejor:

Compras de inteligencia atómica usando Bitcoin Lightning.

Paga solo cuando la decisión importe — con sats, al instante y sin intermediarios.

Creado para el futuro de Bitcoin × IA. ⚡

Enlaces rápidos

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

• API en vivo: https://invinoveritas.onrender.com

• Endpoint MCP: https://invinoveritas.onrender.com/mcp

• Registro MCP: https://registry.modelcontextprotocol.io

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

• Verificación de estado: https://invinoveritas.onrender.com/health

• Guía de pago: https://invinoveritas.onrender.com/guide