{
  "markdown": "# Cloaked\n\n**Trustless spending accounts for AI agents on Solana**\n\n[![npm](https://img.shields.io/npm/v/@cloakedagent/sdk?label=SDK&color=10b981)](https://www.npmjs.com/package/@cloakedagent/sdk)\n[![License: MIT](https://img.shields.io/badge/License-MIT-8B5CF6.svg)](LICENSE)\n\n[cloakedagent.com](https://cloakedagent.com)\n\n---\n\n## The Problem\n\nAI agents need to spend money autonomously. But giving them wallet access is dangerous:\n\n- **Jailbroken agent?** Drains your wallet\n- **Bug in agent code?** Infinite spending loop\n- **Prompt injection?** Attacker controls your funds\n\nAgent-side limits don't work - the agent has the keys and can bypass its own rules.\n\n## The Solution\n\n**On-chain enforced constraints that agents literally cannot bypass.**\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                      CLOAKED AGENT                              │\n├─────────────────────────────────────────────────────────────────┤\n│  Owner: Human wallet (full control)                             │\n│  Delegate: AI agent key (can spend within limits)               │\n│                                                                 │\n│  Constraints (enforced by Solana program):                      │\n│  ├── max_per_tx: 0.1 SOL                                        │\n│  ├── daily_limit: 1 SOL                                         │\n│  ├── total_limit: 10 SOL                                        │\n│  ├── expires_at: 2026-02-15                                     │\n│  └── token_limits:                                              │\n│       └── USDC: 5/tx, 50/day, 500 total                        │\n│                                                                 │\n│  Even if jailbroken, agent CANNOT exceed these limits.          │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Privacy Architecture\n\nCloaked offers **dual-mode privacy**:\n\n### Standard Mode\n- Owner wallet linked to agent on-chain\n- Simple setup, lower fees\n\n### Private Mode (ZK)\n- **Zero-knowledge proofs** hide wallet-agent link\n- Owner proves ownership without revealing identity\n- Funded anonymously via **[Privacy Cash](https://privacycash.org)**\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                    PRIVACY STACK                                │\n├─────────────────────────────────────────────────────────────────┤\n│  ZK Circuits:      Noir (Aztec)                                 │\n│  Client Prover:    Barretenberg (UltraHonk via WASM)            │\n│  On-chain Verify:  Sunspot (Groth16 on Solana)                  │\n│  Hash Function:    Poseidon (ZK-friendly)                       │\n│  Anonymous Funding: Privacy Cash (privacycash.org)              │\n└─────────────────────────────────────────────────────────────────┘\n\nPrivate Agent Creation:\n  Wallet signs message → Master secret derived → Commitment generated\n  On-chain: owner_commitment (hash), NOT wallet address\n  To manage: Prove knowledge of preimage via ZK proof\n```\n\n---\n\n## Technology Stack\n\n| Component | Technology |\n|-----------|------------|\n| Blockchain | [Solana](https://solana.com) |\n| RPC | [Helius](https://helius.dev) |\n| Smart Contract | Anchor Framework |\n| ZK Proofs | [Noir](https://noir-lang.org) + Barretenberg + Sunspot |\n| Frontend | Next.js 16, React 19, TypeScript |\n| Backend | Express.js (Relayer) |\n| AI Integration | MCP (Model Context Protocol) |\n| Token Support | USDC |\n| x402 Payments | Native support |\n\n### Program IDs (Devnet)\n\n```\nCloaked Program: 3yMjzAeXXc5FZRUrJ1YqP4YMPhPd5bBxHQ6npNSPCUwB\nZK Verifier:     G1fDdFA16d199sf6b8zFhRK1NPZiuhuQCwWWVmGBUG3F\n```\n\n---\n\n## Key Features\n\n### 1. On-Chain Constraints\n- Per-transaction limits\n- Daily spending caps\n- Lifetime limits\n- Expiration dates\n- Instant freeze\n\n### 2. Privacy Options\n- Standard mode (simple)\n- Private mode (ZK proofs)\n- Anonymous funding (Privacy Cash)\n\n### 3. x402 Protocol Support\n- Automatic payment handling\n- Pay-per-use APIs\n- AI service payments\n\n### 4. Multi-Agent Dashboard\n- Create/manage multiple agents\n- Real-time spending visibility\n- One-click freeze\n\n### 5. USDC Token Support\n- USDC with per-token spending constraints\n- Same on-chain enforcement as SOL\n- Token balance visibility in dashboard\n\n---\n\n## Quick Start\n\n### For AI Agents (MCP)\n\n```json\n{\n  \"mcpServers\": {\n    \"cloaked\": {\n      \"command\": \"npx\",\n      \"args\": [\"cloaked-mcp\"],\n      \"env\": {\n        \"CLOAKED_AGENT_KEY\": \"your-agent-key-here\"\n      }\n    }\n  }\n}\n```\n\nThe agent can pay in SOL or USDC - pass `token: \"USDC\"` to `cloak_pay`.\n\n### For Developers (SDK)\n\n```bash\nnpm install @cloakedagent/sdk\n```\n\n```typescript\nimport { CloakedAgent } from \"@cloakedagent/sdk\";\n\n// Load agent (can spend)\nconst agent = new CloakedAgent(agentKey, rpcUrl);\n\n// Spend within limits\nawait agent.spend({\n  destination: recipientPubkey,\n  amount: 100_000_000  // 0.1 SOL\n});\n\n// Spend USDC (requires token enabled on agent)\nawait agent.spendToken({\n  destination: recipientPubkey,\n  mint: USDC_MINT,\n  amount: 5_000_000  // 5 USDC (6 decimals)\n});\n```\n\n---\n\n## Project Structure\n\n```\ncloaked/\n├── programs/cloaked/     # Anchor program (constraints, ZK verification)\n├── circuits/             # Noir ZK circuits (ownership proofs)\n├── app/                  # Next.js frontend (dashboard, docs)\n├── backend/              # Express relayer (fee payer, ZK ops)\n└── sdk/                  # TypeScript SDK (@cloakedagent/sdk)\n    └── src/mcp/          # MCP server (cloaked-mcp binary)\n```\n\n---\n\n## Documentation\n\nFull documentation available at [cloakedagent.com/docs](https://cloakedagent.com/docs)\n\n---\n\n## Why Cloaked?\n\n| Problem | Cloaked Solution |\n|---------|------------------|\n| AI can drain wallet | On-chain limits can't be bypassed |\n| No spending visibility | Real-time dashboard |\n| Can't stop runaway agent | Instant freeze |\n| Wallet identity exposed | Private mode with ZK proofs |\n| Complex integrations | Native x402 support |\n\n---\n\n*Cloaked - Trustless spending accounts for AI agents*\n",
  "bytes": 6033,
  "sha": "357378bb302af1f243e8924ab0a7ae8f7679e57e69898ea51e9672b53db8fd49",
  "repo_slug": "cloakedagent/cloaked",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cloakedagent_cloaked_fa4e171e/readme"
}