Kaginet - Bitcoin Escrow for AI Agents
Kaginet - Bitcoin Escrow para Agentes de IA
GitHub
1
Prueba este MCPPatrocinadoDocumentación
Kaginet — Escrow de Bitcoin sin confianza para Agentes de IA
Escrow de Bitcoin con atestación por hardware que los agentes de IA pueden usar mediante MCP, LangChain o CrewAI. Sin custodia, sin supuestos de confianza, sin riesgo de contraparte.
En vivo en la red principal de Bitcoin. Ejecutándose dentro de una VM confidencial Intel TDX.
Por qué Kaginet
| Propiedad | Cómo |
|---|---|
| Sin custodia | Bloqueo matemático: la clave del emisor se destruye antes del financiamiento. El consenso de Bitcoin lo hace cumplir, no una política. |
| Privado | Las transferencias al portador fuera de cadena son invisibles. Sin libro mayor público para transferencias intermedias. |
| Atestación por hardware | Intel TDX demuestra que el código que eliminó la clave es el código auditado. Verificable contra la CA raíz de Intel. |
| 29 herramientas MCP | Cualquier agente compatible con MCP (Claude, GPT-4, Cursor, Windsurf) obtiene capacidad de pago con una URL. |
| Red principal de Bitcoin | Dinero real. En vivo ahora. No es una demo de testnet. |
Inicio rápido
Opción A: MCP (recomendado, sin instalación)
Agrégalo a tu configuración MCP de Claude Desktop, Cursor o Windsurf:
{
"mcpServers": {
"kagikai": {
"url": "https://mcp.kaginet.com/sse",
"headers": {
"Authorization": "Bearer kagi_YOUR_API_KEY"
}
}
}
}
Obtén una clave API en cloud.kaginet.com.
Tu agente ahora tiene 29 herramientas de pago. Prueba:
Create a 50,000 sat escrow to bc1q...recipient for "Logo design work"
Opción 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
Opción C: CrewAI
pip install kagikai-crewai
from kagikai_crewai import (
KagikaiEscrowCreateTool,
KagikaiEscrowStatusTool,
KagikaiEscrowReleaseTool,
)
# Add to your crew's agent
tools = [
KagikaiEscrowCreateTool(),
KagikaiEscrowStatusTool(),
KagikaiEscrowReleaseTool(),
]
Cómo 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
- Crear: El agente llama a
kagikai_escrow_createcon el monto y la dirección del beneficiario. ICS genera claves dentro del TEE, destruye la clave del emisor y devuelve una dirección de financiamiento bc1q. - Financiar: El pagador envía bitcoin a la dirección bc1q desde cualquier billetera. ICS reenvía automáticamente al escrow P2TR interno.
- Liberar: El agente envía evidencia. El evaluador valida (automática o manualmente). ICS barre automáticamente los fondos al beneficiario.
- Atestar: En cualquier momento, cualquiera puede verificar la atestación TDX que demuestra que la clave del emisor fue eliminada por el código auditado.
Ciclo de vida del 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
Documentación completa de la máquina de estados: docs/instrument-lifecycle.md
Documentación
| Documento | Descripción |
|---|---|
| Arquitectura | Componentes del sistema, límites de confianza, flujo de datos |
| Ciclo de vida del instrumento | Máquina de estados con todas las transiciones |
| Referencia de API | Cada endpoint REST con esquemas |
| Herramientas MCP | Las 29 definiciones de herramientas |
| Atestación | Cadena de atestación TDX y verificación |
| Mecanismo de disputas | Liquidación optimista con bonos |
| Modelo de tarifas | Estructura de tarifas y estimación |
| Modelo de seguridad | Modelo de amenazas y límites de confianza |
| Comparación | Kaginet vs ERC-8183 vs Stripe vs AURA |
| Especificación del protocolo | Protocolo de escrow completo: máquina de estados, esquemas de evaluador, eventos Nostr, herramientas MCP |
Endpoints en vivo
| Endpoint | URL |
|---|---|
| MCP (SSE) | https://mcp.kaginet.com/sse |
| Panel de desarrollador | cloud.kaginet.com |
| Sitio web del producto | kaginet.com |
Ejemplos
- quickstart.py — Crea tu primer escrow
- agent-escrow-flow.py — Pago completo de agente a agente
- mcp-config.json — Configuración del cliente MCP
- langchain-agent.py — Agente LangChain con herramientas de pago
- crewai-crew.py — Equipo CrewAI con capacidad de escrow
- verify-attestation.py — Verifica una atestación TDX
- fee-estimate.py — Consulta tarifas antes de crear un escrow
Estructura del proyecto
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
El servidor ICS (Rust, se ejecuta dentro de Intel TDX) no está incluido en este repositorio. Este repositorio contiene la capa de integración: adaptadores de frameworks, documentación y ejemplos.
Seguridad
Consulta SECURITY.md para nuestra política de divulgación responsable.
El modelo de seguridad está documentado en docs/security-model.md.
Contribuciones
Consulta CONTRIBUTING.md. Agradecemos contribuciones de adaptadores para nuevos frameworks, mejoras de documentación y código de ejemplo.
Licencia
Consulta LICENSE. Los términos de la licencia están actualmente en evaluación.