Cloaked Agent

السجل الرسمي الذكاء الاصطناعي والوكلاء

Trustless spending accounts for AI agents on Solana with on-chain enforced limits.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @cloakedagent/sdk
Claude Code
claude mcp add cloaked-agent -e 'CLOAKED_AGENT_KEY=<your cloaked_agent_key>' -e 'CLOAKED_BACKEND_URL=<CLOAKED_BACKEND_URL>' -e 'SOLANA_RPC_URL=<your solana_rpc_url>' -- npx -y @cloakedagent/sdk@0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "cloaked-agent": {
            "command": "npx",
            "args": [
                "-y",
                "@cloakedagent/sdk@0.2.0"
            ],
            "env": {
                "CLOAKED_AGENT_KEY": "<your cloaked_agent_key>",
                "CLOAKED_BACKEND_URL": "<CLOAKED_BACKEND_URL>",
                "SOLANA_RPC_URL": "<your solana_rpc_url>"
            }
        }
    }
}

متغيرات البيئة

  • CLOAKED_AGENT_KEY إلزامي سري Base58 encoded Cloaked Agent private key
  • CLOAKED_BACKEND_URL Backend relay URL (default: https://api.cloakedagent.com)
  • SOLANA_RPC_URL سري Solana RPC endpoint URL (default: https://api.devnet.solana.com)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Cloaked
  2. The Problem
  3. The Solution
  4. Privacy Architecture
  5. Technology Stack
  6. Key Features
  7. Quick Start
  8. Project Structure
  9. Documentation
  10. Why Cloaked?

Cloaked

Trustless spending accounts for AI agents on Solana

cloakedagent.com


The Problem

AI agents need to spend money autonomously. But giving them wallet access is dangerous:

  • Jailbroken agent? Drains your wallet
  • Bug in agent code? Infinite spending loop
  • Prompt injection? Attacker controls your funds

Agent-side limits don't work - the agent has the keys and can bypass its own rules.

The Solution

On-chain enforced constraints that agents literally cannot bypass.

┌─────────────────────────────────────────────────────────────────┐
│                      CLOAKED AGENT                              │
├─────────────────────────────────────────────────────────────────┤
│  Owner: Human wallet (full control)                             │
│  Delegate: AI agent key (can spend within limits)               │
│                                                                 │
│  Constraints (enforced by Solana program):                      │
│  ├── max_per_tx: 0.1 SOL                                        │
│  ├── daily_limit: 1 SOL                                         │
│  ├── total_limit: 10 SOL                                        │
│  ├── expires_at: 2026-02-15                                     │
│  └── token_limits:                                              │
│       └── USDC: 5/tx, 50/day, 500 total                        │
│                                                                 │
│  Even if jailbroken, agent CANNOT exceed these limits.          │
└─────────────────────────────────────────────────────────────────┘

Privacy Architecture

Cloaked offers dual-mode privacy:

Standard Mode
  • Owner wallet linked to agent on-chain
  • Simple setup, lower fees
Private Mode (ZK)
  • Zero-knowledge proofs hide wallet-agent link
  • Owner proves ownership without revealing identity
  • Funded anonymously via Privacy Cash
┌─────────────────────────────────────────────────────────────────┐
│                    PRIVACY STACK                                │
├─────────────────────────────────────────────────────────────────┤
│  ZK Circuits:      Noir (Aztec)                                 │
│  Client Prover:    Barretenberg (UltraHonk via WASM)            │
│  On-chain Verify:  Sunspot (Groth16 on Solana)                  │
│  Hash Function:    Poseidon (ZK-friendly)                       │
│  Anonymous Funding: Privacy Cash (privacycash.org)              │
└─────────────────────────────────────────────────────────────────┘

Private Agent Creation:
  Wallet signs message → Master secret derived → Commitment generated
  On-chain: owner_commitment (hash), NOT wallet address
  To manage: Prove knowledge of preimage via ZK proof

Technology Stack

ComponentTechnology
BlockchainSolana
RPCHelius
Smart ContractAnchor Framework
ZK ProofsNoir + Barretenberg + Sunspot
FrontendNext.js 16, React 19, TypeScript
BackendExpress.js (Relayer)
AI IntegrationMCP (Model Context Protocol)
Token SupportUSDC
x402 PaymentsNative support
Program IDs (Devnet)
Cloaked Program: 3yMjzAeXXc5FZRUrJ1YqP4YMPhPd5bBxHQ6npNSPCUwB
ZK Verifier:     G1fDdFA16d199sf6b8zFhRK1NPZiuhuQCwWWVmGBUG3F

Key Features

1. On-Chain Constraints
  • Per-transaction limits
  • Daily spending caps
  • Lifetime limits
  • Expiration dates
  • Instant freeze
2. Privacy Options
  • Standard mode (simple)
  • Private mode (ZK proofs)
  • Anonymous funding (Privacy Cash)
3. x402 Protocol Support
  • Automatic payment handling
  • Pay-per-use APIs
  • AI service payments
4. Multi-Agent Dashboard
  • Create/manage multiple agents
  • Real-time spending visibility
  • One-click freeze
5. USDC Token Support
  • USDC with per-token spending constraints
  • Same on-chain enforcement as SOL
  • Token balance visibility in dashboard

Quick Start

For AI Agents (MCP)
{
  "mcpServers": {
    "cloaked": {
      "command": "npx",
      "args": ["cloaked-mcp"],
      "env": {
        "CLOAKED_AGENT_KEY": "your-agent-key-here"
      }
    }
  }
}

The agent can pay in SOL or USDC - pass token: "USDC" to cloak_pay.

For Developers (SDK)
npm install @cloakedagent/sdk
import { CloakedAgent } from "@cloakedagent/sdk";

// Load agent (can spend)
const agent = new CloakedAgent(agentKey, rpcUrl);

// Spend within limits
await agent.spend({
  destination: recipientPubkey,
  amount: 100_000_000  // 0.1 SOL
});

// Spend USDC (requires token enabled on agent)
await agent.spendToken({
  destination: recipientPubkey,
  mint: USDC_MINT,
  amount: 5_000_000  // 5 USDC (6 decimals)
});

Project Structure

cloaked/
├── programs/cloaked/     # Anchor program (constraints, ZK verification)
├── circuits/             # Noir ZK circuits (ownership proofs)
├── app/                  # Next.js frontend (dashboard, docs)
├── backend/              # Express relayer (fee payer, ZK ops)
└── sdk/                  # TypeScript SDK (@cloakedagent/sdk)
    └── src/mcp/          # MCP server (cloaked-mcp binary)

Documentation

Full documentation available at cloakedagent.com/docs


Why Cloaked?

ProblemCloaked Solution
AI can drain walletOn-chain limits can't be bypassed
No spending visibilityReal-time dashboard
Can't stop runaway agentInstant freeze
Wallet identity exposedPrivate mode with ZK proofs
Complex integrationsNative x402 support

Cloaked - Trustless spending accounts for AI agents

الأسئلة الشائعة

ما هو Cloaked Agent؟

Trustless spending accounts for AI agents on Solana with on-chain enforced limits.

كيف أثبّت Cloaked Agent؟

يعمل على جهازك. في Claude Code: claude mcp add cloaked-agent -e 'CLOAKED_AGENT_KEY=<your cloaked_agent_key>' -e 'CLOAKED_BACKEND_URL=<CLOAKED_BACKEND_URL>' -e 'SOLANA_RPC_URL=<your solana_rpc_url>' -- npx -y @cloakedagent/sdk@0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Cloaked Agent إلى مفتاح API؟

نعم. يتطلب CLOAKED_AGENT_KEY, SOLANA_RPC_URL، وتضبطها في إعداداته.

هل Cloaked Agent مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Cloaked Agent؟

ينشره CloakedAgent. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.