⚡ invinoveritas

Рассуждения и интеллектуальное принятие решений для автономных агентов с оплатой через Lightning

API с оплатой за инсайт по протоколу L402 (Bitcoin Lightning).
Никаких подписок. Никаких аккаунтов. Никакого KYC.

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

Быстрый старт

Python SDK — ручной процесс оплаты

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 — автономные платежи (v0.3.1)

Агенты платят автоматически. Без участия человека.

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

Полная документация SDK → sdk/README.md

Кошельки для агентов

Агенты могут платить автоматически, используя Lightning. Есть два основных варианта:

• LND Node — полный контроль, запуск собственной Lightning-ноды

• NWC Wallet (Alby, Zeus, Mutiny) — нода не требуется, самая простая настройка

Все платежи криптографически проверяемы и атомарны.

Минимальный пример SDK (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)

Замените YOUR_WALLET_URI_HERE на ваш URI WalletConnect из Alby, Zeus или Mutiny.

Для пользователей LND Node

Просто замените провайдер:

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)

Официальные руководства по настройке кошельков

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

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

MCP Endpoint (Claude Desktop, Cursor)

Укажите вашему MCP-совместимому агенту адрес:

https://invinoveritas.onrender.com/mcp

Встроенная поддержка оплаты L402. Поддерживает initialize, tools/list и callTool.

lnget (CLI-агенты)

lnget обрабатывает L402 автоматически:

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

Прямой 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?" }
    }
  }'

После оплаты полученного инвойса повторите запрос с заголовком: -H "Authorization: L402 <payment_hash>:<preimage>"

Ценообразование (динамическое)

Цены могут незначительно варьироваться в зависимости от длины входных данных.
Полный прайс-лист → /prices

Аккаунты на основе кредитов (опционально)

Для пользователей или агентов, которые предпочитают предоплаченные аккаунты вместо оплаты за каждый вызов:

• Регистрация аккаунта
  POST /accounts/register → Возвращает инвойс на 1000 сат

• Пополнение баланса
  POST /accounts/topup → Укажите api_key и сумму

• Подтверждение пополнения
  POST /accounts/settle-topup → Подтвердите с помощью preimage

• Использование кредитов
  Включайте ваш api_key в запросы — баланс списывается автоматически

• Проверка баланса
  GET /accounts/balance?api_key=<your_api_key>

Преимущества: нет инвойсов на каждый вызов, идеально для высокочастотного использования.

Почему агенты используют invinoveritas

Автономные агенты используют invinoveritas, когда им нужно:

• Стратегическое мышление глубже, чем у локальных моделей

• Структурированные, машиночитаемые решения с оценками уверенности и риска

• Детерминированные, предсказуемые расходы (оплата в сатоши)

• Криптографически проверяемые платежи через Lightning

• Нативная поддержка инструментов MCP

Платите только тогда, когда инсайт действительно важен — атомарно, с помощью Bitcoin Lightning.

Основные инструменты

• reason — премиальное стратегическое мышление

• decide — структурированное интеллектуальное принятие решений с оценками уверенности и риска

Оба инструмента поддерживают полный процесс оплаты L402 через REST, MCP или SDK.

Процесс оплаты (L402)

1. Первый вызов → возвращает 402 Payment Required + инвойс Lightning

2. Оплатите инвойс любым кошельком Lightning или через lnget

3. Повторите запрос с заголовком: Authorization: L402 <payment_hash>:<preimage>

4. Получите результат

Полное руководство → /guide

Эндпоинты для обнаружения (бесплатные)

• GET /health — статус сервиса и цены

• GET /prices — все цены на инструменты в одном вызове

• GET /guide — пошаговое руководство по оплате

• GET /.well-known/mcp/server-card.json — карта MCP-сервера

• GET /price/{endpoint} — текущая цена в сатоши

Философия

Большинство AI-агентов привязаны к подпискам или непредсказуемым расходам на токены.

invinoveritas предлагает лучшую модель:

Атомарные покупки интеллекта с использованием Bitcoin Lightning.

Платите только тогда, когда решение имеет значение — сатоши, мгновенно и без посредников.

Создано для будущего Bitcoin × AI. ⚡

Полезные ссылки

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

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

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

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

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

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

• Payment Guide: https://invinoveritas.onrender.com/guide