⚡ invinoveritas

Name: invinoveritas
Author: babyblueviper1

License PyPI

自律型エージェントのためのLightning決済による推論および意思決定インテリジェンス

L402プロトコル（Bitcoin Lightning）を使用した、インサイトごとの支払い型APIです。サブスクリプションなし。アカウント登録なし。KYCなし。

ライブAPI: https://invinoveritas.onrender.com MCPエンドポイント: https://invinoveritas.onrender.com/mcp MCPレジストリ: 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を使用して自動的に支払うことができます。主な選択肢は2つあります：

LNDノード — 完全な制御が可能。独自のLightningノードを運用します。
NWCウォレット (Alby, Zeus, Mutiny) — ノード不要。最も簡単なセットアップです。

すべての支払いは暗号学的に検証可能であり、アトミックです。

最小限のSDK例 (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)

YOUR_WALLET_URI_HERE を Alby、Zeus、またはMutinyのWalletConnect URIに置き換えてください。

LNDノードユーザー向け

プロバイダーを切り替えるだけです：

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ノード: https://docs.lightning.engineering
WalletConnect / NWCウォレット: https://walletconnect.com/

MCPエンドポイント (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>"

料金 (動的)

ツール	基本価格	エージェント乗数適用時	通常の範囲
reason	500 sats	1.2x	500 – 800 sats
decide	1000 sats	1.2x	1000 – 1400 sats

価格は入力の長さによって多少変動する場合があります。 完全な料金表 → /prices

クレジットベースのアカウント (オプション)

呼び出しごとの支払いではなく、前払いアカウントを好むユーザーやエージェント向け：

アカウント登録 POST /accounts/register → 1000 satsのインボイスを返します
チャージ POST /accounts/topup → api_key と金額を指定します
チャージの決済 POST /accounts/settle-topup → プリイメージで確認します
クレジットの使用 リクエストに api_key を含めると、残高から自動的に引き落とされます
残高確認 GET /accounts/balance?api_key=<your_api_key>

利点: 呼び出しごとのインボイス発行が不要で、高頻度の利用に最適です。

なぜエージェントはinvinoveritasを使うのか

自律型エージェントは、以下が必要な場合に invinoveritas を使用します：

ローカルモデルよりも深い戦略的推論
信頼度とリスクスコアを備えた、機械可読な構造化された意思決定
決定論的で予測可能なコスト (satsで支払い)
Lightningを通じた暗号学的に検証可能な支払い
ネイティブなMCPツールサポート

インサイトが本当に重要なときだけ支払う — Bitcoin Lightningで、アトミックに。

コアツール

reason — プレミアムな戦略的推論
decide — 信頼度とリスクスコアを備えた構造化意思決定インテリジェンス

どちらのツールも、REST、MCP、またはSDKを介した完全なL402支払いフローをサポートしています。

支払いフロー (L402)

初回呼び出し → 402 Payment Required + Lightningインボイスを返します
Lightningウォレットまたは lnget を使用してインボイスを支払います
以下で再試行します: Authorization: L402 <payment_hash>:<preimage>
結果を受け取ります

完全なガイド → /guide

ディスカバリーエンドポイント (無料)

GET /health — サービスステータスと価格
GET /prices — すべてのツールの価格を一度に取得
GET /guide — ステップバイステップの支払いガイド
GET /.well-known/mcp/server-card.json — MCPサーバーカード
GET /price/{endpoint} — sats単位の現在の価格

哲学

ほとんどのAIエージェントは、サブスクリプションや予測不可能なトークンコストに縛られています。

invinoveritas は、より優れたモデルを提供します：

Bitcoin Lightningを使用したアトミックなインテリジェンスの購入。

意思決定が重要なときだけ支払う — satsで、即座に、仲介者なしで。

Bitcoin × AI の未来のために構築されました。 ⚡

クイックリンク

GitHub: https://github.com/babyblueviper1/invinoveritas
ライブAPI: https://invinoveritas.onrender.com
MCPエンドポイント: https://invinoveritas.onrender.com/mcp
MCPレジストリ: https://registry.modelcontextprotocol.io
PyPI: https://pypi.org/project/invinoveritas/
ヘルスチェック: https://invinoveritas.onrender.com/health
支払いガイド: https://invinoveritas.onrender.com/guide

invinoveritas