@shroud-fi/mcp-server 0.1.0

package/dist/cjs/tools/balance.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * shroud_balance — read ETH and (optionally) ERC-20 balance for a wallet.
+ *
+ * Defaults to the agent's operator wallet. Pass `address` to query a different
+ * one (e.g. a stealth address whose private key was just recovered).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shroudBalanceTool = void 0;
+const zod_1 = require("zod");
+const transport_1 = require("@shroud-fi/transport");
+const errors_js_1 = require("../errors.js");
+const schema_js_1 = require("./schema.js");
+const ArgsSchema = zod_1.z
+    .object({
+    address: schema_js_1.AddressSchema.optional(),
+    token: schema_js_1.AddressSchema.optional(),
+})
+    .strict();
+exports.shroudBalanceTool = {
+    name: 'shroud_balance',
+    description: 'Read the ETH balance and (optionally) a single ERC-20 balance for a wallet. Defaults to the operator wallet. Returns wei-denominated strings.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            address: { type: 'string', pattern: '^0x[0-9a-fA-F]{40}$' },
+            token: { type: 'string', pattern: '^0x[0-9a-fA-F]{40}$' },
+        },
+    },
+    async handler(ctx, raw) {
+        const parsed = ArgsSchema.safeParse(raw ?? {});
+        if (!parsed.success) {
+            throw new errors_js_1.McpInvalidArgsError();
+        }
+        const target = (parsed.data.address ?? ctx.walletAddress);
+        if (target === undefined) {
+            throw new errors_js_1.McpInvalidArgsError();
+        }
+        const ethBal = await ctx.transport.publicClient.getBalance({
+            address: target,
+        });
+        const out = {
+            ok: true,
+            address: target,
+            ethWei: ethBal.toString(),
+        };
+        if (parsed.data.token !== undefined) {
+            const tokenBal = (await ctx.transport.publicClient.readContract({
+                address: parsed.data.token,
+                abi: transport_1.ERC20Abi,
+                functionName: 'balanceOf',
+                args: [target],
+            }));
+            out.token = parsed.data.token;
+            out.tokenBaseUnits = tokenBal.toString();
+        }
+        return out;
+    },
+};
+//# sourceMappingURL=balance.js.map

package/dist/cjs/tools/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../../src/tools/balance.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6BAAwB;AACxB,oDAAgD;AAEhD,4CAAmD;AACnD,2CAA4C;AAE5C,MAAM,UAAU,GAAG,OAAC;KACjB,MAAM,CAAC;IACN,OAAO,EAAE,yBAAa,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,yBAAa,CAAC,QAAQ,EAAE;CAChC,CAAC;KACD,MAAM,EAAE,CAAC;AAEC,QAAA,iBAAiB,GAAY;IACxC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,+IAA+I;IACjJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE;YAC3D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE;SAC1D;KACF;IACD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG;QACpB,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,+BAAmB,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,aAAa,CAE3C,CAAC;QACd,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,+BAAmB,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,UAAU,CAAC;YACzD,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;QAEH,MAAM,GAAG,GAA4B;YACnC,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC1B,CAAC;QACF,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC;gBAC9D,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAsB;gBAC3C,GAAG,EAAE,oBAAQ;gBACb,YAAY,EAAE,WAAW;gBACzB,IAAI,EAAE,CAAC,MAAM,CAAC;aACf,CAAC,CAAW,CAAC;YACd,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YAC9B,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO,GAAoB,CAAC;IAC9B,CAAC;CACF,CAAC"}

package/dist/cjs/tools/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tool registry. Add new tools here so both stdio + http transports pick them up.
+ */
+import type { McpTool } from '../types.js';
+import { shroudRegisterTool } from './register.js';
+import { shroudSendTool } from './send.js';
+import { shroudSendToWalletTool } from './send-to-wallet.js';
+import { shroudReceiveTool } from './receive.js';
+import { shroudSweepTool } from './sweep.js';
+import { shroudBalanceTool } from './balance.js';
+import { shroudStatusTool } from './status.js';
+import { shroudX402PayTool } from './x402-pay.js';
+import { shroudX402ServeTool } from './x402-serve.js';
+export declare const ALL_TOOLS: readonly McpTool[];
+export declare function findTool(name: string): McpTool | undefined;
+export { shroudRegisterTool, shroudSendTool, shroudSendToWalletTool, shroudReceiveTool, shroudSweepTool, shroudBalanceTool, shroudStatusTool, shroudX402PayTool, shroudX402ServeTool, };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAUvC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE1D;AAED,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,CAAC"}

package/dist/cjs/tools/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Tool registry. Add new tools here so both stdio + http transports pick them up.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shroudX402ServeTool = exports.shroudX402PayTool = exports.shroudStatusTool = exports.shroudBalanceTool = exports.shroudSweepTool = exports.shroudReceiveTool = exports.shroudSendToWalletTool = exports.shroudSendTool = exports.shroudRegisterTool = exports.ALL_TOOLS = void 0;
+exports.findTool = findTool;
+const register_js_1 = require("./register.js");
+Object.defineProperty(exports, "shroudRegisterTool", { enumerable: true, get: function () { return register_js_1.shroudRegisterTool; } });
+const send_js_1 = require("./send.js");
+Object.defineProperty(exports, "shroudSendTool", { enumerable: true, get: function () { return send_js_1.shroudSendTool; } });
+const send_to_wallet_js_1 = require("./send-to-wallet.js");
+Object.defineProperty(exports, "shroudSendToWalletTool", { enumerable: true, get: function () { return send_to_wallet_js_1.shroudSendToWalletTool; } });
+const receive_js_1 = require("./receive.js");
+Object.defineProperty(exports, "shroudReceiveTool", { enumerable: true, get: function () { return receive_js_1.shroudReceiveTool; } });
+const sweep_js_1 = require("./sweep.js");
+Object.defineProperty(exports, "shroudSweepTool", { enumerable: true, get: function () { return sweep_js_1.shroudSweepTool; } });
+const balance_js_1 = require("./balance.js");
+Object.defineProperty(exports, "shroudBalanceTool", { enumerable: true, get: function () { return balance_js_1.shroudBalanceTool; } });
+const status_js_1 = require("./status.js");
+Object.defineProperty(exports, "shroudStatusTool", { enumerable: true, get: function () { return status_js_1.shroudStatusTool; } });
+const x402_pay_js_1 = require("./x402-pay.js");
+Object.defineProperty(exports, "shroudX402PayTool", { enumerable: true, get: function () { return x402_pay_js_1.shroudX402PayTool; } });
+const x402_serve_js_1 = require("./x402-serve.js");
+Object.defineProperty(exports, "shroudX402ServeTool", { enumerable: true, get: function () { return x402_serve_js_1.shroudX402ServeTool; } });
+exports.ALL_TOOLS = [
+    register_js_1.shroudRegisterTool,
+    send_js_1.shroudSendTool,
+    send_to_wallet_js_1.shroudSendToWalletTool,
+    receive_js_1.shroudReceiveTool,
+    sweep_js_1.shroudSweepTool,
+    balance_js_1.shroudBalanceTool,
+    status_js_1.shroudStatusTool,
+    x402_pay_js_1.shroudX402PayTool,
+    x402_serve_js_1.shroudX402ServeTool,
+];
+function findTool(name) {
+    return exports.ALL_TOOLS.find((t) => t.name === name);
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAyBH,4BAEC;AAxBD,+CAAmD;AA2BjD,mGA3BO,gCAAkB,OA2BP;AA1BpB,uCAA2C;AA2BzC,+FA3BO,wBAAc,OA2BP;AA1BhB,2DAA6D;AA2B3D,uGA3BO,0CAAsB,OA2BP;AA1BxB,6CAAiD;AA2B/C,kGA3BO,8BAAiB,OA2BP;AA1BnB,yCAA6C;AA2B3C,gGA3BO,0BAAe,OA2BP;AA1BjB,6CAAiD;AA2B/C,kGA3BO,8BAAiB,OA2BP;AA1BnB,2CAA+C;AA2B7C,iGA3BO,4BAAgB,OA2BP;AA1BlB,+CAAkD;AA2BhD,kGA3BO,+BAAiB,OA2BP;AA1BnB,mDAAsD;AA2BpD,oGA3BO,mCAAmB,OA2BP;AAzBR,QAAA,SAAS,GAAuB;IAC3C,gCAAkB;IAClB,wBAAc;IACd,0CAAsB;IACtB,8BAAiB;IACjB,0BAAe;IACf,8BAAiB;IACjB,4BAAgB;IAChB,+BAAiB;IACjB,mCAAmB;CACpB,CAAC;AAEF,SAAgB,QAAQ,CAAC,IAAY;IACnC,OAAO,iBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/cjs/tools/receive.d.ts

@@ -0,0 +1,13 @@
+/**
+ * shroud_receive — scan a block range for incoming stealth payments to the
+ * configured agent. Stateless: caller supplies fromBlock + toBlock; server
+ * returns every detection in that window.
+ *
+ * Privacy: stealthPrivateKey is exposed in the response because the caller is
+ * the same operator that holds the spending key in the server process — the
+ * key was derived from their own seed. The MCP transport must be local stdio
+ * or authenticated HTTP (EIP-191) to keep this safe. See HTTP transport gate.
+ */
+import type { McpTool } from '../types.js';
+export declare const shroudReceiveTool: McpTool;
+//# sourceMappingURL=receive.d.ts.map

package/dist/cjs/tools/receive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive.d.ts","sourceRoot":"","sources":["../../../src/tools/receive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAc1D,eAAO,MAAM,iBAAiB,EAAE,OA4E/B,CAAC"}

package/dist/cjs/tools/receive.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * shroud_receive — scan a block range for incoming stealth payments to the
+ * configured agent. Stateless: caller supplies fromBlock + toBlock; server
+ * returns every detection in that window.
+ *
+ * Privacy: stealthPrivateKey is exposed in the response because the caller is
+ * the same operator that holds the spending key in the server process — the
+ * key was derived from their own seed. The MCP transport must be local stdio
+ * or authenticated HTTP (EIP-191) to keep this safe. See HTTP transport gate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shroudReceiveTool = void 0;
+const zod_1 = require("zod");
+const scanning_1 = require("@shroud-fi/scanning");
+const errors_js_1 = require("../errors.js");
+const schema_js_1 = require("./schema.js");
+const ArgsSchema = zod_1.z
+    .object({
+    fromBlock: schema_js_1.Uint256StringSchema,
+    toBlock: zod_1.z.union([schema_js_1.Uint256StringSchema, zod_1.z.literal('latest')]).optional(),
+    finality: zod_1.z.enum(['unsafe', 'safe', 'finalized']).optional(),
+    /** Hard cap on detections returned in a single call. Defaults to 100. */
+    limit: zod_1.z.number().int().positive().max(1000).optional(),
+})
+    .strict();
+exports.shroudReceiveTool = {
+    name: 'shroud_receive',
+    description: 'Scan a block range for incoming stealth payments to the agent. Returns the list of detections (each includes stealthAddress, ephemeralPubKey, stealthPrivateKey, txHash, blockNumber). Stateless: caller drives the cursor by passing fromBlock + toBlock.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            fromBlock: { type: 'string', pattern: '^\\d+$' },
+            toBlock: { oneOf: [{ type: 'string', pattern: '^\\d+$' }, { const: 'latest' }] },
+            finality: { type: 'string', enum: ['unsafe', 'safe', 'finalized'] },
+            limit: { type: 'integer', minimum: 1, maximum: 1000 },
+        },
+        required: ['fromBlock'],
+    },
+    async handler(ctx, raw) {
+        const parsed = ArgsSchema.safeParse(raw);
+        if (!parsed.success) {
+            throw new errors_js_1.McpInvalidArgsError();
+        }
+        const { fromBlock, toBlock, finality, limit } = parsed.data;
+        const fromB = (0, schema_js_1.toBigInt)(fromBlock);
+        let toB;
+        if (toBlock === undefined || toBlock === 'latest') {
+            const tag = finality === 'finalized'
+                ? 'finalized'
+                : finality === 'safe'
+                    ? 'safe'
+                    : 'latest';
+            const block = await ctx.transport.publicClient.getBlock({ blockTag: tag });
+            toB = block.number ?? fromB;
+        }
+        else {
+            toB = (0, schema_js_1.toBigInt)(toBlock);
+        }
+        if (toB < fromB) {
+            return { ok: true, fromBlock: fromB.toString(), toBlock: toB.toString(), detections: [] };
+        }
+        const scanner = (0, scanning_1.createScanner)({
+            transport: ctx.transport,
+            scanningKey: ctx.agent.identity.keys.scanningKey,
+            spendingKey: ctx.agent.identity.keys.spendingKey,
+            startBlock: fromB,
+            ...(finality !== undefined ? { finality } : {}),
+        });
+        const out = [];
+        const cap = limit ?? 100;
+        try {
+            for await (const d of scanner.scanRange(fromB, toB)) {
+                out.push({
+                    stealthAddress: d.stealthAddress,
+                    ephemeralPubKey: d.ephemeralPubKey,
+                    stealthPrivateKey: d.stealthPrivateKey,
+                    txHash: d.txHash,
+                    blockNumber: d.blockNumber.toString(),
+                    blockHash: d.blockHash,
+                    logIndex: d.logIndex,
+                    finality: d.finality,
+                });
+                if (out.length >= cap)
+                    break;
+            }
+        }
+        finally {
+            scanner.close();
+        }
+        return {
+            ok: true,
+            fromBlock: fromB.toString(),
+            toBlock: toB.toString(),
+            detections: out,
+        };
+    },
+};
+//# sourceMappingURL=receive.js.map

package/dist/cjs/tools/receive.js.map

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

package/dist/cjs/tools/register.d.ts

@@ -0,0 +1,9 @@
+/**
+ * shroud_register — publish the agent's stealth meta-address into ERC-6538.
+ *
+ * Idempotent. Returns `{ registered: false }` if the wallet already has an
+ * on-chain entry.
+ */
+import type { McpTool } from '../types.js';
+export declare const shroudRegisterTool: McpTool;
+//# sourceMappingURL=register.d.ts.map

package/dist/cjs/tools/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/tools/register.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAK1D,eAAO,MAAM,kBAAkB,EAAE,OAuBhC,CAAC"}

package/dist/cjs/tools/register.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * shroud_register — publish the agent's stealth meta-address into ERC-6538.
+ *
+ * Idempotent. Returns `{ registered: false }` if the wallet already has an
+ * on-chain entry.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shroudRegisterTool = void 0;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const ArgsSchema = zod_1.z.object({}).strict();
+exports.shroudRegisterTool = {
+    name: 'shroud_register',
+    description: 'Publish the agent stealth meta-address into ERC-6538. Idempotent — no-op when already registered. Returns the registration tx hash on first call.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {},
+        required: [],
+    },
+    async handler(ctx, raw) {
+        const parsed = ArgsSchema.safeParse(raw ?? {});
+        if (!parsed.success) {
+            throw new errors_js_1.McpInvalidArgsError();
+        }
+        const result = await ctx.agent.ensureRegistered();
+        return {
+            ok: true,
+            registered: result.registered,
+            ...(result.txHash !== undefined ? { txHash: result.txHash } : {}),
+            metaAddress: ctx.agent.metaAddressEncoded,
+        };
+    },
+};
+//# sourceMappingURL=register.js.map

package/dist/cjs/tools/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/tools/register.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6BAAwB;AAExB,4CAAmD;AAEnD,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE5B,QAAA,kBAAkB,GAAY;IACzC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,mJAAmJ;IACrJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;IACD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG;QACpB,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,+BAAmB,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAClD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,kBAAkB;SAC1C,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/cjs/tools/schema.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared zod schemas + helpers for tool argument validation.
+ */
+import { z } from 'zod';
+/** 0x-prefixed lowercase EVM address (case preserved by viem checks). */
+export declare const AddressSchema: z.ZodString;
+/** Asset descriptor used by send tools: 'ETH' or token address. */
+export declare const AssetSchema: z.ZodUnion<[z.ZodLiteral<"ETH">, z.ZodObject<{
+    token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    token: string;
+}, {
+    token: string;
+}>]>;
+/** Positive integer string that parses to bigint. */
+export declare const Uint256StringSchema: z.ZodString;
+export declare function toBigInt(v: string): bigint;
+//# sourceMappingURL=schema.d.ts.map

package/dist/cjs/tools/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/tools/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yEAAyE;AACzE,eAAO,MAAM,aAAa,aAEyC,CAAC;AAEpE,mEAAmE;AACnE,eAAO,MAAM,WAAW;;;;;;IAGtB,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,aAEc,CAAC;AAE/C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1C"}

package/dist/cjs/tools/schema.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Shared zod schemas + helpers for tool argument validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Uint256StringSchema = exports.AssetSchema = exports.AddressSchema = void 0;
+exports.toBigInt = toBigInt;
+const zod_1 = require("zod");
+/** 0x-prefixed lowercase EVM address (case preserved by viem checks). */
+exports.AddressSchema = zod_1.z
+    .string()
+    .regex(/^0x[0-9a-fA-F]{40}$/, '0x-prefixed 20-byte hex required');
+/** Asset descriptor used by send tools: 'ETH' or token address. */
+exports.AssetSchema = zod_1.z.union([
+    zod_1.z.literal('ETH'),
+    zod_1.z.object({ token: exports.AddressSchema }),
+]);
+/** Positive integer string that parses to bigint. */
+exports.Uint256StringSchema = zod_1.z
+    .string()
+    .regex(/^\d+$/, 'positive integer required');
+function toBigInt(v) {
+    return BigInt(v);
+}
+//# sourceMappingURL=schema.js.map

package/dist/cjs/tools/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/tools/schema.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAoBH,4BAEC;AApBD,6BAAwB;AAExB,yEAAyE;AAC5D,QAAA,aAAa,GAAG,OAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,qBAAqB,EAAE,kCAAkC,CAAC,CAAC;AAEpE,mEAAmE;AACtD,QAAA,WAAW,GAAG,OAAC,CAAC,KAAK,CAAC;IACjC,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAChB,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,qBAAa,EAAE,CAAC;CACnC,CAAC,CAAC;AAEH,qDAAqD;AACxC,QAAA,mBAAmB,GAAG,OAAC;KACjC,MAAM,EAAE;KACR,KAAK,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC;AAE/C,SAAgB,QAAQ,CAAC,CAAS;IAChC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/cjs/tools/send-to-wallet.d.ts

@@ -0,0 +1,9 @@
+/**
+ * shroud_send_to_wallet — pay a recipient by their plain EVM wallet address.
+ *
+ * The SDK does the ERC-6538 lookup + meta-address decode + stealth derivation.
+ * Caller never sees a meta-address.
+ */
+import type { McpTool } from '../types.js';
+export declare const shroudSendToWalletTool: McpTool;
+//# sourceMappingURL=send-to-wallet.d.ts.map

package/dist/cjs/tools/send-to-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-to-wallet.d.ts","sourceRoot":"","sources":["../../../src/tools/send-to-wallet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAiB1D,eAAO,MAAM,sBAAsB,EAAE,OA4CpC,CAAC"}

package/dist/cjs/tools/send-to-wallet.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * shroud_send_to_wallet — pay a recipient by their plain EVM wallet address.
+ *
+ * The SDK does the ERC-6538 lookup + meta-address decode + stealth derivation.
+ * Caller never sees a meta-address.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shroudSendToWalletTool = void 0;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const schema_js_1 = require("./schema.js");
+const ArgsSchema = zod_1.z
+    .object({
+    recipient: schema_js_1.AddressSchema,
+    asset: schema_js_1.AssetSchema,
+    amount: schema_js_1.Uint256StringSchema,
+})
+    .strict();
+exports.shroudSendToWalletTool = {
+    name: 'shroud_send_to_wallet',
+    description: 'Send ETH or an ERC-20 token to a recipient identified by their plain wallet address. The SDK looks up their ERC-6538 stealth meta-address and derives a one-time stealth address automatically. Throws RecipientNotOnboardedError if the wallet has not registered.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            recipient: { type: 'string', pattern: '^0x[0-9a-fA-F]{40}$' },
+            asset: {
+                oneOf: [
+                    { type: 'string', enum: ['ETH'] },
+                    {
+                        type: 'object',
+                        properties: { token: { type: 'string', pattern: '^0x[0-9a-fA-F]{40}$' } },
+                        required: ['token'],
+                        additionalProperties: false,
+                    },
+                ],
+            },
+            amount: { type: 'string', pattern: '^\\d+$' },
+        },
+        required: ['recipient', 'asset', 'amount'],
+    },
+    async handler(ctx, raw) {
+        const parsed = ArgsSchema.safeParse(raw);
+        if (!parsed.success) {
+            throw new errors_js_1.McpInvalidArgsError();
+        }
+        const { recipient, asset, amount } = parsed.data;
+        const assetArg = asset === 'ETH' ? 'ETH' : { token: asset.token };
+        const receipt = await ctx.agent.sendToWallet(recipient, assetArg, (0, schema_js_1.toBigInt)(amount));
+        return {
+            ok: true,
+            txHash: receipt.txHash,
+            stealthAddress: receipt.stealthAddress,
+            ephemeralPubKey: receipt.ephemeralPubKey,
+            viewTag: receipt.viewTag,
+        };
+    },
+};
+//# sourceMappingURL=send-to-wallet.js.map

package/dist/cjs/tools/send-to-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-to-wallet.js","sourceRoot":"","sources":["../../../src/tools/send-to-wallet.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6BAAwB;AAExB,4CAAmD;AACnD,2CAKqB;AAErB,MAAM,UAAU,GAAG,OAAC;KACjB,MAAM,CAAC;IACN,SAAS,EAAE,yBAAa;IACxB,KAAK,EAAE,uBAAW;IAClB,MAAM,EAAE,+BAAmB;CAC5B,CAAC;KACD,MAAM,EAAE,CAAC;AAEC,QAAA,sBAAsB,GAAY;IAC7C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,qQAAqQ;IACvQ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE;YAC7D,KAAK,EAAE;gBACL,KAAK,EAAE;oBACL,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE;oBACjC;wBACE,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAE;wBACzE,QAAQ,EAAE,CAAC,OAAO,CAAC;wBACnB,oBAAoB,EAAE,KAAK;qBAC5B;iBACF;aACF;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;SAC9C;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC;KAC3C;IACD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG;QACpB,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,+BAAmB,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QACjD,MAAM,QAAQ,GAAG,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAsB,EAAE,CAAC;QACnF,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,CAC1C,SAA0B,EAC1B,QAAQ,EACR,IAAA,oBAAQ,EAAC,MAAM,CAAC,CACjB,CAAC;QACF,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/cjs/tools/send.d.ts

@@ -0,0 +1,9 @@
+/**
+ * shroud_send — send to a stealth meta-address (the privacy-native form).
+ *
+ * Uses agent.send (ETH) or agent.sendERC20 (token). Recipient is the encoded
+ * meta-address string `st:base:0x…`.
+ */
+import type { McpTool } from '../types.js';
+export declare const shroudSendTool: McpTool;
+//# sourceMappingURL=send.d.ts.map

package/dist/cjs/tools/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/tools/send.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAY1D,eAAO,MAAM,cAAc,EAAE,OAoD5B,CAAC"}

package/dist/cjs/tools/send.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * shroud_send — send to a stealth meta-address (the privacy-native form).
+ *
+ * Uses agent.send (ETH) or agent.sendERC20 (token). Recipient is the encoded
+ * meta-address string `st:base:0x…`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shroudSendTool = void 0;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const schema_js_1 = require("./schema.js");
+const ArgsSchema = zod_1.z
+    .object({
+    to: zod_1.z.string().min(1),
+    asset: schema_js_1.AssetSchema,
+    amount: schema_js_1.Uint256StringSchema,
+})
+    .strict();
+exports.shroudSendTool = {
+    name: 'shroud_send',
+    description: 'Send ETH or an ERC-20 token to a stealth meta-address. `to` is the encoded `st:base:0x…` string. `asset` is "ETH" or { token: 0x… }. `amount` is a base-units string.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            to: { type: 'string', description: 'Encoded stealth meta-address' },
+            asset: {
+                oneOf: [
+                    { type: 'string', enum: ['ETH'] },
+                    {
+                        type: 'object',
+                        properties: { token: { type: 'string', pattern: '^0x[0-9a-fA-F]{40}$' } },
+                        required: ['token'],
+                        additionalProperties: false,
+                    },
+                ],
+            },
+            amount: { type: 'string', pattern: '^\\d+$', description: 'Base-units integer' },
+        },
+        required: ['to', 'asset', 'amount'],
+    },
+    async handler(ctx, raw) {
+        const parsed = ArgsSchema.safeParse(raw);
+        if (!parsed.success) {
+            throw new errors_js_1.McpInvalidArgsError();
+        }
+        const { to, asset, amount } = parsed.data;
+        const amountWei = (0, schema_js_1.toBigInt)(amount);
+        let receipt;
+        if (asset === 'ETH') {
+            receipt = await ctx.agent.send(to, amountWei);
+        }
+        else {
+            // Validate the token address shape before dispatch.
+            schema_js_1.AddressSchema.parse(asset.token);
+            receipt = await ctx.agent.sendERC20(to, asset.token, amountWei);
+        }
+        return {
+            ok: true,
+            txHash: receipt.txHash,
+            stealthAddress: receipt.stealthAddress,
+            ephemeralPubKey: receipt.ephemeralPubKey,
+            viewTag: receipt.viewTag,
+        };
+    },
+};
+//# sourceMappingURL=send.js.map

package/dist/cjs/tools/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../../src/tools/send.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6BAAwB;AAExB,4CAAmD;AACnD,2CAAwF;AAExF,MAAM,UAAU,GAAG,OAAC;KACjB,MAAM,CAAC;IACN,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,uBAAW;IAClB,MAAM,EAAE,+BAAmB;CAC5B,CAAC;KACD,MAAM,EAAE,CAAC;AAEC,QAAA,cAAc,GAAY;IACrC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,uKAAuK;IACzK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACnE,KAAK,EAAE;gBACL,KAAK,EAAE;oBACL,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE;oBACjC;wBACE,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAE;wBACzE,QAAQ,EAAE,CAAC,OAAO,CAAC;wBACnB,oBAAoB,EAAE,KAAK;qBAC5B;iBACF;aACF;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;SACjF;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC;KACpC;IACD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG;QACpB,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,+BAAmB,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAA,oBAAQ,EAAC,MAAM,CAAC,CAAC;QAEnC,IAAI,OAAO,CAAC;QACZ,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,oDAAoD;YACpD,yBAAa,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,CACjC,EAAE,EACF,KAAK,CAAC,KAAsB,EAC5B,SAAS,CACV,CAAC;QACJ,CAAC;QACD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/cjs/tools/status.d.ts

@@ -0,0 +1,6 @@
+/**
+ * shroud_status — read-only snapshot of agent + chain + on-chain registration.
+ */
+import type { McpTool } from '../types.js';
+export declare const shroudStatusTool: McpTool;
+//# sourceMappingURL=status.d.ts.map

package/dist/cjs/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/tools/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAK1D,eAAO,MAAM,gBAAgB,EAAE,OA6B9B,CAAC"}

package/dist/cjs/tools/status.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * shroud_status — read-only snapshot of agent + chain + on-chain registration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shroudStatusTool = void 0;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const ArgsSchema = zod_1.z.object({}).strict();
+exports.shroudStatusTool = {
+    name: 'shroud_status',
+    description: 'Snapshot of the running agent: operator wallet, meta-address, chain id, current block, on-chain registration state, and stealth contract address.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {},
+        required: [],
+    },
+    async handler(ctx, raw) {
+        const parsed = ArgsSchema.safeParse(raw ?? {});
+        if (!parsed.success) {
+            throw new errors_js_1.McpInvalidArgsError();
+        }
+        const latest = await ctx.transport.publicClient.getBlock({
+            blockTag: 'latest',
+        });
+        const registered = await ctx.agent.isRegistered();
+        return {
+            ok: true,
+            chainId: ctx.chainId,
+            walletAddress: ctx.walletAddress ?? null,
+            metaAddress: ctx.agent.metaAddressEncoded,
+            stealthContract: ctx.agent.stealthContract,
+            latestBlock: (latest.number ?? 0n).toString(),
+            registered,
+        };
+    },
+};
+//# sourceMappingURL=status.js.map

package/dist/cjs/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/tools/status.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6BAAwB;AAExB,4CAAmD;AAEnD,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE5B,QAAA,gBAAgB,GAAY;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,mJAAmJ;IACrJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;IACD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG;QACpB,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,+BAAmB,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC;YACvD,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QAClD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;YACxC,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,kBAAkB;YACzC,eAAe,EAAE,GAAG,CAAC,KAAK,CAAC,eAAe;YAC1C,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC7C,UAAU;SACX,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/cjs/tools/sweep.d.ts

@@ -0,0 +1,14 @@
+/**
+ * shroud_sweep — sweep a previously-detected stealth address to a destination.
+ *
+ * Caller passes the detection bundle returned by shroud_receive (stealth
+ * address + stealth private key + ephemeral pub key + tx coords). We
+ * reconstruct a minimal DetectedPayment and dispatch to agent.sweep.
+ *
+ * Optional flags:
+ *   - viaRelayer + token → Gelato ERC-20 gasless sweep
+ *   - viaRelayer (ETH) → EIP-7702 ETH gasless sweep (requires selfHostEndpoint)
+ */
+import type { McpTool } from '../types.js';
+export declare const shroudSweepTool: McpTool;
+//# sourceMappingURL=sweep.d.ts.map

package/dist/cjs/tools/sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep.d.ts","sourceRoot":"","sources":["../../../src/tools/sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AA0B1D,eAAO,MAAM,eAAe,EAAE,OAoF7B,CAAC"}