Kaginet Bitcoin Escrow For Ai Agents

Kaginet — 面向 AI Agent 的无信任比特币托管

经硬件证明的比特币托管，AI Agent 可通过 MCP、LangChain 或 CrewAI 使用。无需托管，无需信任假设，无交易对手风险。

已在比特币主网上线。 运行于 Intel TDX 机密虚拟机中。

---

为什么选择 Kaginet

属性	方式
无需托管	数学层面的锁定：出资前销毁发行方密钥。由比特币共识强制执行，而非依赖策略。
隐私保护	链下持票人转移不可见。中间转移没有公开账本记录。
经硬件证明	Intel TDX 可证明删除密钥的代码就是经过审计的代码。可通过 Intel 的根 CA 验证。
29 个 MCP 工具	任何兼容 MCP 的 Agent（Claude、GPT-4、Cursor、Windsurf）只需一个 URL 即可获得支付能力。
比特币主网	真金白银。现已上线。并非测试网演示。

---

快速开始

选项 A：MCP（推荐，无需安装）

将以下配置添加到 Claude Desktop、Cursor 或 Windsurf 的 MCP 配置中：

{
  "mcpServers": {
    "kagikai": {
      "url": "https://mcp.kaginet.com/sse",
      "headers": {
        "Authorization": "Bearer kagi_YOUR_API_KEY"
      }
    }
  }
}

在 cloud.kaginet.com 获取 API 密钥。

现在，你的 Agent 拥有 29 个支付工具。试试：

Create a 50,000 sat escrow to bc1q...recipient for "Logo design work"

选项 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

选项 C：CrewAI

pip install kagikai-crewai

from kagikai_crewai import (
    KagikaiEscrowCreateTool,
    KagikaiEscrowStatusTool,
    KagikaiEscrowReleaseTool,
)

# Add to your crew's agent
tools = [
    KagikaiEscrowCreateTool(),
    KagikaiEscrowStatusTool(),
    KagikaiEscrowReleaseTool(),
]

---

工作原理

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                       

1. 创建：Agent 调用 kagikai_escrow_create，并提供金额和收款人地址。ICS 在 TEE 内生成密钥，销毁发行方密钥，并返回一个 bc1q 充值地址。
2. 充值：付款方从任意钱包向 bc1q 地址发送比特币。ICS 会自动将资金转发到内部 P2TR 托管地址。
3. 释放：Agent 提交证据。评估器进行验证（自动或手动）。ICS 自动将资金转至收款人。
4. 证明：任何时候，任何人都可以验证 TDX 证明，以确认发行方密钥已被经过审计的代码删除。

---

交易凭证生命周期

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

完整的状态机文档：docs/instrument-lifecycle.md

---

文档

文档	说明
架构	系统组件、信任边界、数据流
交易凭证生命周期	包含所有转换的状态机
API 参考	所有 REST 端点及其架构
MCP 工具	全部 29 个工具定义
证明	TDX 证明链及验证
争议处理机制	使用保证金的乐观结算
费用模型	费用结构及估算
安全模型	威胁模型和信任边界
对比	Kaginet、ERC-8183、Stripe 与 AURA 的对比
协议规范	完整托管协议：状态机、评估器架构、Nostr 事件、MCP 工具

---

在线端点

端点	URL
MCP（SSE）	https://mcp.kaginet.com/sse
开发者控制面板	cloud.kaginet.com
产品网站	kaginet.com

---

示例

• quickstart.py — 创建你的第一个托管交易
• agent-escrow-flow.py — 完整的 Agent 对 Agent 付款流程
• mcp-config.json — MCP 客户端配置
• langchain-agent.py — 配备付款工具的 LangChain Agent
• crewai-crew.py — 具备托管能力的 CrewAI 团队
• verify-attestation.py — 验证 TDX 证明
• fee-estimate.py — 创建托管交易前查询费用

---

项目结构

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

ICS 服务（Rust，在 Intel TDX 内运行）未包含在此代码库中。本代码库包含集成层：框架适配器、文档和示例。

---

安全

请参阅 SECURITY.md，了解我们的负责任披露政策。

安全模型记录在 docs/security-model.md。

---

贡献

请参阅 CONTRIBUTING.md。欢迎为新框架贡献适配器、改进文档以及提供示例代码。

---

许可证

请参阅 LICENSE。许可证条款目前正在评估中。