Skip to main content
Glama

⚡ invinoveritas

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을 사용하여 자동으로 결제할 수 있습니다. 두 가지 주요 옵션이 있습니다:

  • LND 노드 — 완전한 제어, 자신의 Lightning 노드 실행

  • NWC 지갑 (Alby, Zeus, Mutiny) — 노드 불필요, 가장 쉬운 설정

모든 결제는 암호학적으로 검증 가능하며 원자적(atomic)입니다.


최소 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)

공식 지갑 설정 가이드


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.2배

500 – 800 sats

decide

1000 sats

1.2배

1000 – 1400 sats

가격은 입력 길이에 따라 약간 다를 수 있습니다. 전체 가격/prices

크레딧 기반 계정 (선택 사항)

호출당 결제 대신 선불 계정을 선호하는 사용자나 에이전트를 위한 기능:

  • 계정 등록 POST /accounts/register → 1000 sats 인보이스 반환

  • 충전 POST /accounts/topupapi_key와 금액 제공

  • 충전 정산 POST /accounts/settle-topup → preimage로 확인

  • 크레딧 사용 요청에 api_key를 포함하면 잔액이 자동으로 차감됩니다

  • 잔액 확인 GET /accounts/balance?api_key=<your_api_key>

장점: 호출당 인보이스가 발생하지 않아 고빈도 사용에 이상적입니다.


에이전트가 invinoveritas를 사용하는 이유

자율 에이전트는 다음과 같은 경우에 invinoveritas를 사용합니다:

  • 로컬 모델보다 깊이 있는 전략적 추론

  • 신뢰도 및 위험 점수가 포함된 구조화된 기계 판독 가능 의사결정

  • 결정론적이고 예측 가능한 비용 (sats로 결제)

  • Lightning을 통한 암호학적으로 검증 가능한 결제

  • 기본 MCP 도구 지원

통찰력이 정말 중요할 때만 결제하십시오 — Bitcoin Lightning으로 원자적으로 결제합니다.


핵심 도구

  • reason — 프리미엄 전략적 추론

  • decide — 신뢰도 및 위험 점수가 포함된 구조화된 의사결정 지능

두 도구 모두 REST, MCP 또는 SDK를 통한 전체 L402 결제 흐름을 지원합니다.


결제 흐름 (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} — sats 단위의 현재 가격


철학

대부분의 AI 에이전트는 구독이나 예측 불가능한 토큰 비용에 묶여 있습니다.

invinoveritas는 더 나은 모델을 제공합니다:

Bitcoin Lightning을 사용한 원자적 지능 구매.

의사결정이 중요할 때만 결제하십시오 — sats로, 즉시, 중개자 없이.

Bitcoin × AI 미래를 위해 구축되었습니다. ⚡


빠른 링크

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/babyblueviper1/invinoveritas'

If you have feedback or need assistance with the MCP directory API, please join our Discord server