invinoveritas
⚡ invinoveritas
자율 에이전트를 위한 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 invinoveritasfrom 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)공식 지갑 설정 가이드
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.2배 | 500 – 800 sats |
decide | 1000 sats | 1.2배 | 1000 – 1400 sats |
가격은 입력 길이에 따라 약간 다를 수 있습니다. 전체 가격 → /prices
크레딧 기반 계정 (선택 사항)
호출당 결제 대신 선불 계정을 선호하는 사용자나 에이전트를 위한 기능:
계정 등록
POST /accounts/register→ 1000 sats 인보이스 반환충전
POST /accounts/topup→api_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)
첫 번째 호출 → 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 미래를 위해 구축되었습니다. ⚡
빠른 링크
라이브 API: https://invinoveritas.onrender.com
MCP 엔드포인트: https://invinoveritas.onrender.com/mcp
MCP 레지스트리: https://registry.modelcontextprotocol.io
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