Kaginet - Bitcoin Escrow for AI Agents
Kaginet - Bitcoin Escrow para Agentes de IA
GitHub
1
Experimente este MCPPatrocinadoDocumentação
Kaginet — Escrow Bitcoin Sem Confiança para Agentes de IA
Escrow Bitcoin atestado por hardware que agentes de IA podem usar via MCP, LangChain ou CrewAI. Sem custódia, sem suposições de confiança, sem risco de contraparte.
Ao vivo na mainnet do Bitcoin. Executando dentro de uma VM confidencial Intel TDX.
Por que Kaginet
| Propriedade | Como |
|---|---|
| Sem custódia | Bloqueio matemático: a chave do emissor é destruída antes do financiamento. O consenso do Bitcoin impõe isso, não a política. |
| Privado | Transferências ao portador fora da cadeia são invisíveis. Sem livro-razão público para transferências intermediárias. |
| Atestado por hardware | O Intel TDX prova que o código que excluiu a chave é o código auditado. Verificável contra a CA raiz da Intel. |
| 29 ferramentas MCP | Qualquer agente compatível com MCP (Claude, GPT-4, Cursor, Windsurf) obtém capacidade de pagamento com uma única URL. |
| Mainnet do Bitcoin | Dinheiro real. Ao vivo agora. Não é uma demonstração de testnet. |
Início Rápido
Opção A: MCP (recomendado, instalação zero)
Adicione à sua configuração MCP do Claude Desktop, Cursor ou Windsurf:
{
"mcpServers": {
"kagikai": {
"url": "https://mcp.kaginet.com/sse",
"headers": {
"Authorization": "Bearer kagi_YOUR_API_KEY"
}
}
}
}
Obtenha uma chave de API em cloud.kaginet.com.
Seu agente agora tem 29 ferramentas de pagamento. Experimente:
Create a 50,000 sat escrow to bc1q...recipient for "Logo design work"
Opção B: LangChain
pip install kagikai-langchain
from kagikai_langchain import KagikaiToolkit
toolkit = KagikaiToolkit(
base_url="https://mcp.kaginet.com",
api_key="kagi_YOUR_API_KEY",
)
tools = toolkit.get_tools() # 29 tools ready for your agent
Opção C: CrewAI
pip install kagikai-crewai
from kagikai_crewai import (
KagikaiEscrowCreateTool,
KagikaiEscrowStatusTool,
KagikaiEscrowReleaseTool,
)
# Add to your crew's agent
tools = [
KagikaiEscrowCreateTool(),
KagikaiEscrowStatusTool(),
KagikaiEscrowReleaseTool(),
]
Como Funciona
Agent Runtime MCP Server ICS (TEE Enclave) Bitcoin
───────────── ────────── ───────────────── ───────
kagikai_escrow_create ──▶ Authenticate ──▶ Generate keys inside TDX
Destroy issuer key (kA)
Create P2TR escrow address
Generate bc1q funding addr
◀── instrument_id + funding_address ◀──
"Fund this address" ────────────────────────────────────────────────▶ bc1q funded
Watcher detects funding
Auto-forward bc1q → bc1p ──────▶ P2TR escrow
Status: Confirmed
kagikai_escrow_release ─▶ Sign JWT ──────▶ Evaluate evidence
Status: Completed
Auto-sweep to payee ──────▶ Payee receives
Zero all keys
- Criar: O agente chama
kagikai_escrow_createcom valor e endereço do beneficiário. O ICS gera chaves dentro do TEE, destrói a chave do emissor e retorna um endereço de financiamento bc1q. - Financiar: O pagador envia bitcoin para o endereço bc1q de qualquer carteira. O ICS encaminha automaticamente para o escrow P2TR interno.
- Liberar: O agente envia evidências. O avaliador valida (automático ou manual). O ICS transfere automaticamente os fundos para o beneficiário.
- Atestar: A qualquer momento, qualquer pessoa pode verificar a atestação TDX que prova que a chave do emissor foi excluída pelo código auditado.
Ciclo de Vida do Instrumento
Created ──▶ WatchingForFunding ──▶ Forwarding ──▶ Confirmed
│
┌─────────────────┤
▼ ▼
Submitted Expired
│ │
┌────────────┼────────────┐ ▼
▼ ▼ ▼ Available
Completed Rejected DisputeWindow │
│ │ │ ├──▶ Recycled ──▶ Confirmed
▼ ▼ │ └──▶ Refunded (terminal)
Swept Available ┌───┴───┐
(terminal) │ ▼ ▼
│ Completed Disputed
│ (auto-win) │
│ ┌────┴────┐
│ ▼ ▼
│ Completed Rejected
│ (seller (buyer
│ wins) wins)
▼
Recycled / Refunded
Documentação completa da máquina de estados: docs/instrument-lifecycle.md
Documentação
| Documento | Descrição |
|---|---|
| Arquitetura | Componentes do sistema, limites de confiança, fluxo de dados |
| Ciclo de Vida do Instrumento | Máquina de estados com todas as transições |
| Referência da API | Todos os endpoints REST com esquemas |
| Ferramentas MCP | Todas as 29 definições de ferramentas |
| Atestação | Cadeia de atestação TDX e verificação |
| Mecanismo de Disputa | Liquidação otimista com títulos |
| Modelo de Taxas | Estrutura de taxas e estimativa |
| Modelo de Segurança | Modelo de ameaças e limites de confiança |
| Comparação | Kaginet vs ERC-8183 vs Stripe vs AURA |
| Especificação do Protocolo | Protocolo de escrow completo: máquina de estados, esquemas de avaliador, eventos Nostr, ferramentas MCP |
Endpoints ao Vivo
| Endpoint | URL |
|---|---|
| MCP (SSE) | https://mcp.kaginet.com/sse |
| Painel do Desenvolvedor | cloud.kaginet.com |
| Site do Produto | kaginet.com |
Exemplos
- quickstart.py — Crie seu primeiro escrow
- agent-escrow-flow.py — Pagamento completo de agente para agente
- mcp-config.json — Configuração do cliente MCP
- langchain-agent.py — Agente LangChain com ferramentas de pagamento
- crewai-crew.py — Equipe CrewAI com capacidade de escrow
- verify-attestation.py — Verifique uma atestação TDX
- fee-estimate.py — Verifique as taxas antes de criar um escrow
Estrutura do Projeto
kaginet/
adapters/
langchain/ # pip install kagikai-langchain (29 tools)
crewai/ # pip install kagikai-crewai (29 tools)
tests/ # 90 adapter tests
docs/ # Architecture, API reference, protocol docs
examples/ # Integration examples
verify/ # TDX attestation verification tool
O servidor ICS (Rust, executado dentro do Intel TDX) não está incluído neste repositório. Este repositório contém a camada de integração: adaptadores de framework, documentação e exemplos.
Segurança
Consulte SECURITY.md para nossa política de divulgação responsável.
O modelo de segurança está documentado em docs/security-model.md.
Contribuição
Consulte CONTRIBUTING.md. Aceitamos contribuições de adaptadores para novos frameworks, melhorias na documentação e código de exemplo.
Licença
Consulte LICENSE. Os termos da licença estão atualmente em avaliação.