@cloakedagent/sdk 0.1.0

package/dist/mcp/tools.js

@@ -0,0 +1,320 @@
+"use strict";
+// sdk/src/mcp/tools.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleBalance = handleBalance;
+exports.handleStatus = handleStatus;
+exports.handlePay = handlePay;
+exports.handleX402Fetch = handleX402Fetch;
+const web3_js_1 = require("@solana/web3.js");
+const agent_1 = require("../agent");
+/**
+ * Sanitize error messages to prevent key leakage
+ * Redacts base58-encoded strings that could be keys (32+ chars)
+ */
+function sanitizeErrorMessage(error) {
+    let message;
+    if (error instanceof Error) {
+        message = error.message;
+    }
+    else if (typeof error === "string") {
+        message = error;
+    }
+    else {
+        // Don't use JSON.stringify on unknown objects - could leak keys
+        return "An error occurred";
+    }
+    // Redact potential base58 keys (32+ alphanumeric chars in base58 charset)
+    return message.replace(/[1-9A-HJ-NP-Za-km-z]{32,}/g, "[REDACTED]");
+}
+/**
+ * Tool handler for cloak_balance
+ * Returns enhanced balance info with constraints
+ */
+async function handleBalance(agentKey) {
+    const key = agentKey || process.env.CLOAKED_AGENT_KEY;
+    if (!key) {
+        throw new Error("No Agent Key provided and CLOAKED_AGENT_KEY not set");
+    }
+    try {
+        const rpcUrl = process.env.SOLANA_RPC_URL || "https://api.devnet.solana.com";
+        const agent = new agent_1.CloakedAgent(key, rpcUrl);
+        const state = await agent.getState();
+        // Calculate expires_in_days
+        let expiresInDays = null;
+        if (state.constraints.expiresAt) {
+            const now = Date.now();
+            const expiresAt = state.constraints.expiresAt.getTime();
+            expiresInDays = Math.max(0, Math.ceil((expiresAt - now) / (1000 * 60 * 60 * 24)));
+        }
+        return {
+            balance_sol: state.balance / web3_js_1.LAMPORTS_PER_SOL,
+            balance_lamports: state.balance,
+            daily_spent: state.spending.dailySpent,
+            daily_limit: state.constraints.dailyLimit,
+            daily_remaining: state.spending.dailyRemaining === Number.MAX_SAFE_INTEGER ? -1 : state.spending.dailyRemaining,
+            total_spent: state.spending.totalSpent,
+            total_limit: state.constraints.totalLimit,
+            total_remaining: state.spending.totalRemaining === Number.MAX_SAFE_INTEGER ? -1 : state.spending.totalRemaining,
+            expires_in_days: expiresInDays,
+            frozen: state.constraints.frozen,
+            status: state.status,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get balance: ${sanitizeErrorMessage(error)}`);
+    }
+}
+/**
+ * Tool handler for cloak_status
+ * Returns detailed agent status with health indicator
+ */
+async function handleStatus(agentKey) {
+    const key = agentKey || process.env.CLOAKED_AGENT_KEY;
+    if (!key) {
+        throw new Error("No Agent Key provided and CLOAKED_AGENT_KEY not set");
+    }
+    try {
+        const rpcUrl = process.env.SOLANA_RPC_URL || "https://api.devnet.solana.com";
+        const agent = new agent_1.CloakedAgent(key, rpcUrl);
+        const state = await agent.getState();
+        // Determine health status
+        let health = "ok";
+        if (state.status === "frozen") {
+            health = "frozen";
+        }
+        else if (state.status === "expired") {
+            health = "expired";
+        }
+        else if (state.balance < 0.01 * web3_js_1.LAMPORTS_PER_SOL) {
+            health = "low_balance";
+        }
+        else if (state.constraints.dailyLimit > 0 && state.spending.dailyRemaining < state.constraints.dailyLimit * 0.1) {
+            health = "near_daily_limit";
+        }
+        else if (state.constraints.totalLimit > 0 && state.spending.totalRemaining < state.constraints.totalLimit * 0.1) {
+            health = "near_total_limit";
+        }
+        return {
+            constraints: {
+                max_per_tx: state.constraints.maxPerTx === 0 ? "unlimited" : state.constraints.maxPerTx,
+                daily_limit: state.constraints.dailyLimit === 0 ? "unlimited" : state.constraints.dailyLimit,
+                total_limit: state.constraints.totalLimit === 0 ? "unlimited" : state.constraints.totalLimit,
+                expires_at: state.constraints.expiresAt ? state.constraints.expiresAt.toISOString() : "never",
+            },
+            spending: {
+                balance_sol: state.balance / web3_js_1.LAMPORTS_PER_SOL,
+                daily_spent: state.spending.dailySpent,
+                total_spent: state.spending.totalSpent,
+            },
+            health,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get status: ${sanitizeErrorMessage(error)}`);
+    }
+}
+/**
+ * Tool handler for cloak_pay
+ * Pays to a destination address for x402 services
+ */
+async function handlePay(destination, amountSol, agentKey) {
+    const key = agentKey || process.env.CLOAKED_AGENT_KEY;
+    if (!key) {
+        throw new Error("No Agent Key provided and CLOAKED_AGENT_KEY not set");
+    }
+    const rpcUrl = process.env.SOLANA_RPC_URL || "https://api.devnet.solana.com";
+    const agent = new agent_1.CloakedAgent(key, rpcUrl);
+    const amountLamports = Math.floor(amountSol * web3_js_1.LAMPORTS_PER_SOL);
+    try {
+        const result = await agent.spend({
+            destination: new web3_js_1.PublicKey(destination),
+            amount: amountLamports,
+        });
+        return {
+            success: true,
+            signature: result.signature,
+            remaining_balance: result.remainingBalance / web3_js_1.LAMPORTS_PER_SOL,
+            daily_remaining: result.dailyRemaining === Number.MAX_SAFE_INTEGER ? -1 : result.dailyRemaining / web3_js_1.LAMPORTS_PER_SOL,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            signature: "",
+            remaining_balance: 0,
+            daily_remaining: 0,
+            error: sanitizeErrorMessage(error),
+        };
+    }
+}
+/**
+ * Decode X-PAYMENT-REQUIRED header (base64 JSON)
+ */
+function decodePaymentRequired(encoded) {
+    const decoded = Buffer.from(encoded, 'base64').toString('utf-8');
+    return JSON.parse(decoded);
+}
+/**
+ * Encode payment payload for X-PAYMENT header
+ */
+function encodePaymentPayload(signature) {
+    return Buffer.from(JSON.stringify({ signature })).toString('base64');
+}
+/**
+ * Parse response content based on content-type
+ */
+async function parseResponseContent(response) {
+    const contentType = response.headers.get("content-type") || "application/octet-stream";
+    if (contentType.includes("application/json")) {
+        return { type: "json", content: await response.json(), contentType };
+    }
+    else if (contentType.includes("text/")) {
+        return { type: "text", content: await response.text(), contentType };
+    }
+    else {
+        // Binary - base64 encode
+        const buffer = await response.arrayBuffer();
+        return {
+            type: "binary",
+            content: Buffer.from(buffer).toString('base64'),
+            contentType
+        };
+    }
+}
+/**
+ * Tool handler for cloak_x402_fetch
+ * Fetches x402-protected resources, automatically handling payment
+ */
+async function handleX402Fetch(url, options, agentKey) {
+    const key = agentKey || process.env.CLOAKED_AGENT_KEY;
+    if (!key) {
+        return {
+            success: false,
+            error: "No Agent Key provided and CLOAKED_AGENT_KEY not set",
+            statusCode: 0,
+        };
+    }
+    const method = options?.method || "GET";
+    const customHeaders = options?.headers || {};
+    try {
+        // Step 1: Initial fetch
+        const initialResponse = await fetch(url, {
+            method,
+            headers: customHeaders,
+            body: options?.body,
+        });
+        // If not 402, return content directly
+        if (initialResponse.status !== 402) {
+            if (!initialResponse.ok) {
+                return {
+                    success: false,
+                    error: `HTTP ${initialResponse.status}: ${initialResponse.statusText}`,
+                    statusCode: initialResponse.status,
+                };
+            }
+            const parsed = await parseResponseContent(initialResponse);
+            return {
+                success: true,
+                ...parsed,
+                statusCode: initialResponse.status,
+            };
+        }
+        // Step 2: Parse payment requirements from X-PAYMENT-REQUIRED header
+        const paymentRequiredHeader = initialResponse.headers.get("X-PAYMENT-REQUIRED");
+        if (!paymentRequiredHeader) {
+            return {
+                success: false,
+                error: "Received 402 but no X-PAYMENT-REQUIRED header found",
+                statusCode: 402,
+            };
+        }
+        let requirements;
+        try {
+            requirements = decodePaymentRequired(paymentRequiredHeader);
+        }
+        catch {
+            return {
+                success: false,
+                error: "Failed to decode X-PAYMENT-REQUIRED header",
+                statusCode: 402,
+            };
+        }
+        // Validate required fields
+        if (!requirements.payTo || typeof requirements.payTo !== 'string') {
+            return {
+                success: false,
+                error: "Invalid payment requirements: missing payTo address",
+                statusCode: 402,
+            };
+        }
+        if (!requirements.amount || typeof requirements.amount !== 'string') {
+            return {
+                success: false,
+                error: "Invalid payment requirements: missing amount",
+                statusCode: 402,
+            };
+        }
+        // Step 3: Make payment
+        const amountLamports = parseInt(requirements.amount, 10);
+        if (isNaN(amountLamports) || amountLamports <= 0) {
+            return {
+                success: false,
+                error: "Invalid payment amount in X-PAYMENT-REQUIRED header",
+                statusCode: 402,
+            };
+        }
+        const amountSol = amountLamports / web3_js_1.LAMPORTS_PER_SOL;
+        const payResult = await handlePay(requirements.payTo, amountSol, key);
+        if (!payResult.success) {
+            return {
+                success: false,
+                error: `Payment failed: ${payResult.error}`,
+                statusCode: 402,
+            };
+        }
+        // Step 4: Retry with payment proof
+        const paymentPayload = encodePaymentPayload(payResult.signature);
+        const retryResponse = await fetch(url, {
+            method,
+            headers: {
+                ...customHeaders,
+                "X-PAYMENT": paymentPayload,
+            },
+            body: options?.body,
+        });
+        if (!retryResponse.ok) {
+            return {
+                success: false,
+                error: `Payment accepted but resource fetch failed: HTTP ${retryResponse.status}`,
+                statusCode: retryResponse.status,
+                payment: {
+                    signature: payResult.signature,
+                    amount_sol: amountSol,
+                    amount_lamports: amountLamports,
+                    recipient: requirements.payTo,
+                },
+            };
+        }
+        // Step 5: Return content with payment info
+        const parsed = await parseResponseContent(retryResponse);
+        return {
+            success: true,
+            ...parsed,
+            statusCode: retryResponse.status,
+            payment: {
+                signature: payResult.signature,
+                amount_sol: amountSol,
+                amount_lamports: amountLamports,
+                recipient: requirements.payTo,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: sanitizeErrorMessage(error),
+            statusCode: 0,
+        };
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Response types for MCP tools
+ */
+export interface BalanceResponse {
+    balance_sol: number;
+    balance_lamports: number;
+    daily_spent: number;
+    daily_limit: number;
+    daily_remaining: number;
+    total_spent: number;
+    total_limit: number;
+    total_remaining: number;
+    expires_in_days: number | null;
+    frozen: boolean;
+    status: string;
+}
+export interface StatusResponse {
+    constraints: {
+        max_per_tx: number | string;
+        daily_limit: number | string;
+        total_limit: number | string;
+        expires_at: string;
+    };
+    spending: {
+        balance_sol: number;
+        daily_spent: number;
+        total_spent: number;
+    };
+    health: string;
+}
+export interface PayResponse {
+    success: boolean;
+    signature: string;
+    remaining_balance: number;
+    daily_remaining: number;
+    error?: string;
+}
+export interface ErrorResponse {
+    error: string;
+}
+export interface X402FetchResponse {
+    success: boolean;
+    type?: "json" | "text" | "binary";
+    content?: unknown;
+    contentType?: string;
+    payment?: {
+        signature: string;
+        amount_sol: number;
+        amount_lamports: number;
+        recipient: string;
+    };
+    error?: string;
+    statusCode: number;
+}
+export interface X402PaymentRequirements {
+    payTo: string;
+    amount: string;
+    currency: string;
+    network: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAEA;;GAEG;AAGH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE;QACX,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;QAC5B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;QAC7B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IAEjB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/mcp/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// sdk/src/mcp/types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":";AAAA,uBAAuB"}

package/dist/relayer.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Relayer Client for Truly Private Cloaked Agent Creation
+ *
+ * Handles communication with the backend relayer service for creating
+ * agents without the user's wallet signing any on-chain transaction.
+ *
+ * Security:
+ * - Agent Key encrypted with NaCl box (X25519) - decrypted client-side
+ * - User's wallet only signs "Cloak Private Agent" message for secret derivation
+ * - User's wallet NEVER appears in any on-chain transaction
+ *
+ * Economics:
+ * - User sends total (0.01 SOL fee + funding) to relayer via Privacy Cash
+ * - Relayer keeps 0.01 SOL fee, forwards rest to vault
+ */
+import { PublicKey } from "@solana/web3.js";
+/** Options for creating a private agent via relayer */
+export interface CreatePrivateViaRelayerOptions {
+    maxPerTx?: number;
+    dailyLimit?: number;
+    totalLimit?: number;
+    expiresAt?: Date | null;
+}
+/** Result from creating a Cloaked Agent via relayer */
+export interface CreatePrivateViaRelayerResult {
+    agentKey: string;
+    agentStatePda: PublicKey;
+    vaultPda: PublicKey;
+    delegate: PublicKey;
+    signature: string;
+}
+/** Relayer status response */
+export interface RelayerStatus {
+    address: string;
+    balance: number;
+    minBalance: number;
+    ready: boolean;
+    creationFee: number;
+    minDeposit: number;
+}
+/**
+ * Get relayer status
+ *
+ * @param apiUrl - Optional API URL (defaults to CLOAK_API_URL or localhost:3645)
+ * @returns Relayer status including balance and readiness
+ */
+export declare function getRelayerStatus(apiUrl?: string): Promise<RelayerStatus>;
+/**
+ * Create a Cloaked Agent via relayer
+ *
+ * The relayer signs and pays for the transaction, ensuring the user's wallet
+ * never appears on-chain. The Agent Key is encrypted and only the user can decrypt it.
+ *
+ * Flow:
+ * 1. User sends total (fee + funding) to relayer via Privacy Cash
+ * 2. Call this function with the deposit tx signature
+ * 3. Relayer keeps 0.01 SOL fee, forwards rest to vault
+ * 4. Relayer creates agent, encrypts Agent Key for user
+ *
+ * @param masterSecret - Master secret derived from wallet signature
+ * @param nonce - Agent index (0, 1, 2, ...)
+ * @param options - Agent creation options
+ * @param depositSignature - Privacy Cash tx signature to relayer
+ * @param depositAmount - Total lamports sent (fee + vault funding)
+ * @param apiUrl - Optional API URL
+ * @returns Agent Key and PDA addresses
+ */
+export declare function createPrivateAgentViaRelayer(masterSecret: bigint, nonce: number, options: CreatePrivateViaRelayerOptions, depositSignature: string, depositAmount: number, apiUrl?: string): Promise<CreatePrivateViaRelayerResult>;
+/** Private operation parameters for relayer */
+export interface PrivateOperationParams {
+    agentStatePda: string;
+    proofBytes: number[];
+    witnessBytes: number[];
+}
+/** Update constraints private parameters */
+export interface UpdateConstraintsPrivateParams extends PrivateOperationParams {
+    maxPerTx: number | null;
+    dailyLimit: number | null;
+    totalLimit: number | null;
+    expiresAt: number | null;
+}
+/** Withdraw private parameters */
+export interface WithdrawPrivateParams extends PrivateOperationParams {
+    amount: number;
+    destination: string;
+}
+/** Close private parameters */
+export interface ClosePrivateParams extends PrivateOperationParams {
+    destination: string;
+}
+/**
+ * Freeze a private agent via relayer
+ */
+export declare function freezePrivateViaRelayer(params: PrivateOperationParams, apiUrl?: string): Promise<string>;
+/**
+ * Unfreeze a private agent via relayer
+ */
+export declare function unfreezePrivateViaRelayer(params: PrivateOperationParams, apiUrl?: string): Promise<string>;
+/**
+ * Update constraints for a private agent via relayer
+ */
+export declare function updateConstraintsPrivateViaRelayer(params: UpdateConstraintsPrivateParams, apiUrl?: string): Promise<string>;
+/**
+ * Withdraw from a private agent via relayer
+ */
+export declare function withdrawPrivateViaRelayer(params: WithdrawPrivateParams, apiUrl?: string): Promise<string>;
+/**
+ * Close a private agent via relayer
+ */
+export declare function closePrivateViaRelayer(params: ClosePrivateParams, apiUrl?: string): Promise<string>;
+/**
+ * Co-sign and submit a spend transaction via relayer
+ *
+ * The SDK builds the transaction, delegate signs, then sends to relayer.
+ * Relayer adds its signature as fee payer and submits to the network.
+ *
+ * @param transactionBase64 - Base64 encoded partially-signed transaction
+ * @param apiUrl - Optional API URL
+ * @returns Transaction signature
+ */
+export declare function cosignSpendViaRelayer(transactionBase64: string, apiUrl?: string): Promise<string>;
+/**
+ * Get the relayer public key for use as fee payer
+ * Uses lightweight /pubkey endpoint that doesn't require RPC calls
+ *
+ * @param apiUrl - Optional API URL
+ * @returns Relayer public key
+ */
+export declare function getRelayerPublicKey(apiUrl?: string): Promise<PublicKey>;
+//# sourceMappingURL=relayer.d.ts.map

package/dist/relayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayer.d.ts","sourceRoot":"","sources":["../src/relayer.ts"],"names":[],"mappings":"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"}