Cloaked

🚀 Cloaked

為Solana上的AI智能體提供無需信任的消費賬戶

cloakedagent.com

🚀 快速開始

針對AI智能體（MCP）

{
  "mcpServers": {
    "cloaked": {
      "command": "npx",
      "args": ["cloaked-mcp"],
      "env": {
        "CLOAKED_AGENT_KEY": "your-agent-key-here"
      }
    }
  }
}

智能體可以使用SOL或USDC進行支付 - 在調用 cloak_pay 時傳入 token: "USDC"。

針對開發者（SDK）

npm install @cloakedagent/sdk

import { CloakedAgent } from "@cloakedagent/sdk";

// 加載智能體（可進行消費）
const agent = new CloakedAgent(agentKey, rpcUrl);

// 在限額內消費
await agent.spend({
  destination: recipientPubkey,
  amount: 100_000_000  // 0.1 SOL
});

// 消費USDC（需要在智能體上啟用該代幣）
await agent.spendToken({
  destination: recipientPubkey,
  mint: USDC_MINT,
  amount: 5_000_000  // 5 USDC (6位小數)
});

✨ 主要特性

1. 鏈上約束

• 每筆交易限額
• 每日消費上限
• 終身限額
• 過期日期
• 即時凍結

2. 隱私選項

• 標準模式（簡單）
• 私密模式（零知識證明）
• 匿名資助（Privacy Cash）

3. x402協議支持

• 自動支付處理
• 按使用付費的API
• AI服務支付

4. 多智能體儀表盤

• 創建/管理多個智能體
• 即時消費可見性
• 一鍵凍結

5. USDC代幣支持

• 帶有每個代幣消費約束的USDC
• 與SOL相同的鏈上強制執行機制
• 在儀表盤中可見代幣餘額

📦 安裝指南

開發者可以使用以下命令安裝SDK：

npm install @cloakedagent/sdk

💻 使用示例

基礎用法

針對AI智能體（MCP）

{
  "mcpServers": {
    "cloaked": {
      "command": "npx",
      "args": ["cloaked-mcp"],
      "env": {
        "CLOAKED_AGENT_KEY": "your-agent-key-here"
      }
    }
  }
}

針對開發者（SDK）

import { CloakedAgent } from "@cloakedagent/sdk";

// 加載智能體（可進行消費）
const agent = new CloakedAgent(agentKey, rpcUrl);

// 在限額內消費
await agent.spend({
  destination: recipientPubkey,
  amount: 100_000_000  // 0.1 SOL
});

高級用法

消費USDC（需要在智能體上啟用該代幣）

await agent.spendToken({
  destination: recipientPubkey,
  mint: USDC_MINT,
  amount: 5_000_000  // 5 USDC (6位小數)
});

📚 詳細文檔

完整文檔可在 cloakedagent.com/docs 查看。

🔧 技術細節

問題所在

AI智能體需要自主消費資金。但給予它們錢包訪問權限是危險的：

• 智能體被越獄？ 會耗盡你的錢包資金
• 智能體代碼存在漏洞？ 會陷入無限消費循環
• 發生提示注入攻擊？ 攻擊者會控制你的資金 智能體端的限制不起作用 - 因為智能體擁有密鑰，可以繞過自身規則。

解決方案

通過鏈上強制執行約束，使智能體根本無法繞過。

┌─────────────────────────────────────────────────────────────────┐
│                      CLOAKED AGENT                              │
├─────────────────────────────────────────────────────────────────┤
│  所有者：人類錢包（完全控制）                                 │
│  委託方：AI智能體密鑰（可在限額內消費）                       │
│                                                                 │
│  約束條件（由Solana程序強制執行）：                            │
│  ├── 每筆交易最大限額：0.1 SOL                                 │
│  ├── 每日限額：1 SOL                                          │
│  ├── 總限額：10 SOL                                           │
│  ├── 過期日期：2026-02-15                                     │
│  └── 代幣限額：                                                │
│       └── USDC：每筆交易5個，每日50個，總計500個              │
│                                                                 │
│  即使智能體被越獄，也無法超過這些限額。                      │
└─────────────────────────────────────────────────────────────────┘

隱私架構

Cloaked提供 雙模式隱私保護：

標準模式

• 所有者錢包在鏈上與智能體關聯
• 設置簡單，費用較低

私密模式（ZK）

• 零知識證明 隱藏錢包與智能體的關聯
• 所有者在不暴露身份的情況下證明所有權
• 通過 Privacy Cash 進行匿名資助

┌─────────────────────────────────────────────────────────────────┐
│                    PRIVACY STACK                                │
├─────────────────────────────────────────────────────────────────┤
│  ZK電路：         Noir (Aztec)                                 │
│  客戶端證明器：    Barretenberg (通過WASM實現的UltraHonk)      │
│  鏈上驗證器：      Sunspot (Solana上的Groth16)                 │
│  哈希函數：        Poseidon (對ZK友好)                         │
│  匿名資助：        Privacy Cash (privacycash.org)              │
└─────────────────────────────────────────────────────────────────┘

私密智能體創建流程：
  錢包簽署消息 → 派生主密鑰 → 生成承諾
  鏈上：所有者承諾（哈希值），而非錢包地址
  管理方式：通過ZK證明證明對原像的知曉

技術棧

程序ID（開發網絡）

Cloaked程序：3yMjzAeXXc5FZRUrJ1YqP4YMPhPd5bBxHQ6npNSPCUwB
ZK驗證器：    G1fDdFA16d199sf6b8zFhRK1NPZiuhuQCwWWVmGBUG3F

項目結構

cloaked/
├── programs/cloaked/     # Anchor程序（約束條件、ZK驗證）
├── circuits/             # Noir ZK電路（所有權證明）
├── app/                  # Next.js前端（儀表盤、文檔）
├── backend/              # Express中繼器（費用支付者、ZK操作）
└── sdk/                  # TypeScript SDK (@cloakedagent/sdk)
    └── src/mcp/          # MCP服務器（cloaked-mcp二進制文件）

為何選擇Cloaked？

📄 許可證

本項目採用 MIT許可證。