@zerodust/mcp-server 0.2.2 → 0.3.0

package/README.md

@@ -53,9 +53,18 @@ Add to your `.claude/settings.json`:
 | `ZERODUST_API_URL` | Custom API URL | `https://api.zerodust.xyz` |
 | `ZERODUST_API_KEY` | API key for higher rate limits | - |
 | `ZERODUST_ALLOW_EXECUTE` | Set to `true` to enable sweeping | `false` |
-| `ZERODUST_PRIVATE_KEY` | Signing key for the agent's wallet | - |
 | `ZERODUST_ALLOWED_DESTINATIONS` | Comma-separated destination allowlist | own address only |
 
+Signing keys have their own section below — there are four ways to supply one,
+and exactly one may be set at a time.
+
+| Variable | Description |
+|----------|-------------|
+| `ZERODUST_SIGNER_MODULE` | Module returning a viem `LocalAccount` (Turnkey, Privy, KMS, ...) |
+| `ZERODUST_KEYSTORE_FILE` | Encrypted V3 keystore, with `ZERODUST_KEYSTORE_PASSWORD_FILE` or `ZERODUST_KEYSTORE_PASSWORD` |
+| `ZERODUST_PRIVATE_KEY_FILE` | File containing a hex private key |
+| `ZERODUST_PRIVATE_KEY` | Hex private key inline |
+
 ## Available Tools
 
 Read-only by default:
@@ -68,6 +77,7 @@ Read-only by default:
 | `zerodust_get_quote` | Get a quote for sweeping a chain |
 | `zerodust_get_sweep_status` | Check status of a submitted sweep |
 | `zerodust_list_sweeps` | List past sweeps for an address |
+| `zerodust_register_api_key` | Issue this agent its own API key, no human signup |
 
 Added when execution is enabled (see below):
 
@@ -77,27 +87,91 @@ Added when execution is enabled (see below):
 | `zerodust_sweep` | Sweep one chain to exactly zero |
 | `zerodust_sweep_all` | Sweep every chain with a balance to one destination |
 
+## Try it without moving funds
+
+Every sweep tool accepts `dryRun`. It fetches a real quote, requests the real
+EIP-712 typed data, and produces all three real signatures with your key, then
+stops before submitting. Nothing is broadcast and no balance changes.
+
+> "Do a dry run of sweeping my Arbitrum balance to Base"
+
+Use this first. It exercises the entire path an actual sweep takes — key
+handling, chain support, fee limits, signature construction — so anything
+misconfigured surfaces while your funds are still where they were.
+
+There is deliberately no testnet mode: the ZeroDust API currently serves no
+testnet chains, so a testnet flag would only produce empty chain lists and
+failing quotes. `dryRun` gives you the same confidence against production.
+
 ## Enabling sweeps
 
-Sweeping moves real funds, so it is off unless you turn it on. Set **both**:
+Sweeping moves real funds, so it is off unless you turn it on. Set
+`ZERODUST_ALLOW_EXECUTE=true` **and** exactly one signing key.
+
+Whichever you choose, the key is used locally to sign an EIP-7702 authorization
+and an EIP-712 sweep intent. It is never transmitted — only signatures reach the
+ZeroDust API.
+
+### Option 1: a signer module (recommended for production)
+
+Point ZeroDust at a module that returns a viem `LocalAccount`. This is how you
+use Turnkey, Privy, AWS KMS, or any other custody service: ZeroDust never sees a
+raw key, and it does not need to know which vendor you use.
+
+```js
+// my-signer.mjs
+export default async function createAccount() {
+  // Build a viem LocalAccount however your custody provider prefers.
+  // Any account that can sign EIP-712 typed data and EIP-7702
+  // authorizations works.
+  return await myProvider.toViemAccount();
+}
+```
 
 ```json
-{
-  "mcpServers": {
-    "zerodust": {
-      "command": "npx",
-      "args": ["@zerodust/mcp-server"],
-      "env": {
-        "ZERODUST_ALLOW_EXECUTE": "true",
-        "ZERODUST_PRIVATE_KEY": "0x..."
-      }
-    }
-  }
+"env": {
+  "ZERODUST_ALLOW_EXECUTE": "true",
+  "ZERODUST_SIGNER_MODULE": "./my-signer.mjs"
+}
+```
+
+The module is validated when it loads: if the account it returns cannot sign an
+EIP-7702 authorization, the server says so immediately rather than failing part
+way through a sweep.
+
+### Option 2: an encrypted keystore
+
+The V3 keystore format produced by `cast wallet import` and geth. Keep the
+password in a file so neither the key nor the password lives in your MCP config.
+
+```json
+"env": {
+  "ZERODUST_ALLOW_EXECUTE": "true",
+  "ZERODUST_KEYSTORE_FILE": "./agent-keystore.json",
+  "ZERODUST_KEYSTORE_PASSWORD_FILE": "./agent-keystore.pass"
+}
+```
+
+### Option 3: a key file
+
+```json
+"env": {
+  "ZERODUST_ALLOW_EXECUTE": "true",
+  "ZERODUST_PRIVATE_KEY_FILE": "./agent.key"
 }
 ```
 
-The key is used locally to sign an EIP-7702 authorization and an EIP-712 sweep
-intent. It is never transmitted — only signatures reach the ZeroDust API.
+### Option 4: an inline key
+
+Simplest, and the least private — the key sits in a config file you may well
+commit. Fine for a throwaway wallet, not for one holding anything you care about.
+
+```json
+"env": {
+  "ZERODUST_ALLOW_EXECUTE": "true",
+  "ZERODUST_PRIVATE_KEY": "0x..."
+}
+```
 
 ### Destination allowlist
 
@@ -125,9 +199,30 @@ Once configured, you can ask Claude:
 
 With execution enabled:
 
+- "Do a dry run of sweeping my Arbitrum balance to Base" (moves nothing)
 - "Sweep my Arbitrum balance to Base"
 - "Exit every chain and consolidate everything on Base"
 
+## No install: the hosted server
+
+If you only need the read-only tools, there is nothing to install. Connect to
+the hosted server by URL:
+
+```
+https://api.zerodust.xyz/mcp
+```
+
+It exposes the same tool names as this package. Sweeping is not available there,
+because sweeping needs a key and the hosted server does not have yours.
+
+## Development
+
+```bash
+npm install
+npm test        # unit tests
+npm run build
+```
+
 ## License
 
 MIT

package/dist/execute.d.ts

@@ -5,9 +5,9 @@
  * This module adds the tools that actually perform a sweep, which requires a
  * signing key and is therefore opt-in.
  *
- * Execution is disabled unless BOTH of these are set:
- *   ZERODUST_PRIVATE_KEY   - hex private key for the agent's own wallet
- *   ZERODUST_ALLOW_EXECUTE - must be exactly "true"
+ * Execution is disabled unless BOTH of these are true:
+ *   ZERODUST_ALLOW_EXECUTE=true  - explicit acknowledgement that funds can move
+ *   a signing key is configured  - see signer.ts for the four accepted forms
  *
  * Optional:
  *   ZERODUST_ALLOWED_DESTINATIONS - comma-separated address allowlist.
@@ -16,11 +16,17 @@
  * The allowlist is the main defence against prompt injection: an agent that is
  * talked into sweeping somewhere it shouldn't still cannot send funds to an
  * address the operator never approved.
+ *
+ * Every sweep tool also accepts `dryRun`, which runs the whole flow and stops
+ * before submission. That exists because there is no testnet backend to point
+ * at, so without it the only way to evaluate ZeroDust is to move real money.
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type SignerSource } from "./signer.js";
 /** Resolved execution configuration, or null when execution is not enabled. */
 export interface ExecuteConfig {
-    privateKey: `0x${string}`;
+    /** Where the signing key comes from. Resolved lazily, on first use. */
+    signer: SignerSource;
     /** Lowercased allowlist. Empty means "agent's own address only". */
     allowedDestinations: string[];
 }

package/dist/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBzE,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,oEAAoE;IACpE,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,GAAG,IAAI,CAoC5F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,mBAAmB,EAAE,MAAM,EAAE,GAC5B,MAAM,GAAG,IAAI,CAgBf;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAuJ1F"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAmBnF,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,MAAM,EAAE,YAAY,CAAC;IACrB,oEAAoE;IACpE,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,GAAG,IAAI,CAwC5F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,mBAAmB,EAAE,MAAM,EAAE,GAC5B,MAAM,GAAG,IAAI,CAgBf;AA2CD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAiO1F"}

package/dist/execute.js

@@ -5,9 +5,9 @@
  * This module adds the tools that actually perform a sweep, which requires a
  * signing key and is therefore opt-in.
  *
- * Execution is disabled unless BOTH of these are set:
- *   ZERODUST_PRIVATE_KEY   - hex private key for the agent's own wallet
- *   ZERODUST_ALLOW_EXECUTE - must be exactly "true"
+ * Execution is disabled unless BOTH of these are true:
+ *   ZERODUST_ALLOW_EXECUTE=true  - explicit acknowledgement that funds can move
+ *   a signing key is configured  - see signer.ts for the four accepted forms
  *
  * Optional:
  *   ZERODUST_ALLOWED_DESTINATIONS - comma-separated address allowlist.
@@ -16,10 +16,14 @@
  * The allowlist is the main defence against prompt injection: an agent that is
  * talked into sweeping somewhere it shouldn't still cannot send funds to an
  * address the operator never approved.
+ *
+ * Every sweep tool also accepts `dryRun`, which runs the whole flow and stops
+ * before submission. That exists because there is no testnet backend to point
+ * at, so without it the only way to evaluate ZeroDust is to move real money.
  */
 import { z } from "zod";
+import { hasSignerEnv, resolveSignerSource } from "./signer.js";
 const ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
-const PRIVATE_KEY_RE = /^0x[a-fA-F0-9]{64}$/;
 function text(body, isError = false) {
     const result = { content: [{ type: "text", text: body }] };
     if (isError)
@@ -37,21 +41,23 @@ function errorText(prefix, error) {
  * because the agent discovers it only mid-task.
  */
 export function readExecuteConfig(env = process.env) {
-    const privateKey = env.ZERODUST_PRIVATE_KEY?.trim();
     const allowExecute = env.ZERODUST_ALLOW_EXECUTE?.trim() === "true";
-    if (!privateKey && !allowExecute)
+    const signerConfigured = hasSignerEnv(env);
+    if (!signerConfigured && !allowExecute)
         return null;
     if (!allowExecute) {
-        throw new Error("ZERODUST_PRIVATE_KEY is set but ZERODUST_ALLOW_EXECUTE is not \"true\". " +
+        throw new Error("A ZeroDust signing key is configured but ZERODUST_ALLOW_EXECUTE is not \"true\". " +
             "Sweeping moves real funds, so it must be enabled explicitly.");
     }
-    if (!privateKey) {
-        throw new Error("ZERODUST_ALLOW_EXECUTE is \"true\" but ZERODUST_PRIVATE_KEY is not set.");
-    }
-    const normalizedKey = (privateKey.startsWith("0x") ? privateKey : `0x${privateKey}`);
-    if (!PRIVATE_KEY_RE.test(normalizedKey)) {
-        throw new Error("ZERODUST_PRIVATE_KEY must be a 32-byte hex private key.");
+    if (!signerConfigured) {
+        throw new Error("ZERODUST_ALLOW_EXECUTE is \"true\" but no signing key is configured. Set exactly one of:\n" +
+            "  ZERODUST_SIGNER_MODULE     module returning a viem LocalAccount (Turnkey, Privy, KMS, ...)\n" +
+            "  ZERODUST_KEYSTORE_FILE     encrypted V3 keystore, with ZERODUST_KEYSTORE_PASSWORD_FILE\n" +
+            "  ZERODUST_PRIVATE_KEY_FILE  file containing a hex private key\n" +
+            "  ZERODUST_PRIVATE_KEY       hex private key inline");
     }
+    // Throws on a partial or ambiguous signer setup.
+    const signer = resolveSignerSource(env);
     const allowedDestinations = (env.ZERODUST_ALLOWED_DESTINATIONS ?? "")
         .split(",")
         .map((entry) => entry.trim())
@@ -62,7 +68,7 @@ export function readExecuteConfig(env = process.env) {
         }
     }
     return {
-        privateKey: normalizedKey,
+        signer,
         allowedDestinations: allowedDestinations.map((entry) => entry.toLowerCase()),
     };
 }
@@ -85,18 +91,40 @@ export function checkDestination(destination, agentAddress, allowedDestinations)
         `Permitted: ${agentAddress} (own address), ${allowedDestinations.join(", ")}.`);
 }
 /** Suffix appended to every sweep tool description so the gate is self-documenting. */
-const GATE_NOTE = " Requires ZERODUST_ALLOW_EXECUTE=true and ZERODUST_PRIVATE_KEY; without them this tool returns an error and moves no funds.";
+const GATE_NOTE = " Requires ZERODUST_ALLOW_EXECUTE=true plus a signing key; without them this tool returns an " +
+    "error and moves no funds. Pass dryRun=true to rehearse the whole flow without moving anything.";
 const DISABLED_MESSAGE = [
     "Sweep execution is disabled on this ZeroDust MCP server, so nothing was moved.",
     "",
-    "To enable it, restart the server with both:",
-    "  ZERODUST_ALLOW_EXECUTE=true",
-    "  ZERODUST_PRIVATE_KEY=0x...   (the agent's own wallet)",
+    "To enable it, restart the server with ZERODUST_ALLOW_EXECUTE=true and exactly",
+    "one signing key:",
+    "",
+    "  ZERODUST_SIGNER_MODULE=./my-signer.js",
+    "      A module whose default export returns a viem LocalAccount. This is how",
+    "      you use Turnkey, Privy, AWS KMS or any other custody service without",
+    "      putting a raw key anywhere.",
+    "",
+    "  ZERODUST_KEYSTORE_FILE=./agent-keystore.json",
+    "  ZERODUST_KEYSTORE_PASSWORD_FILE=./agent-keystore.pass",
+    "      An encrypted V3 keystore, as produced by `cast wallet import` or geth.",
+    "",
+    "  ZERODUST_PRIVATE_KEY_FILE=./agent.key",
+    "      A file containing a hex private key, so the key stays out of configs.",
+    "",
+    "  ZERODUST_PRIVATE_KEY=0x...",
+    "      A hex key inline. Simplest, and the least private of the four.",
     "",
     "Optionally set ZERODUST_ALLOWED_DESTINATIONS to permit sweeping to addresses",
     "other than the agent's own. The read-only tools (balances, quotes, status)",
     "work without any of this.",
 ].join("\n");
+/** Shared shape of the dryRun parameter, so both sweep tools describe it identically. */
+const dryRunSchema = z
+    .boolean()
+    .optional()
+    .describe("Rehearse without moving funds (default false). Fetches a real quote and produces " +
+    "the real signatures, then stops before submitting. Use this to prove the setup " +
+    "works before sweeping a real balance.");
 /**
  * Registers the sweep-execution tools on an MCP server.
  *
@@ -108,19 +136,38 @@ const DISABLED_MESSAGE = [
  * advertising the tool grants no capability.
  */
 export function registerExecuteTools(server, config) {
-    // The agent is constructed lazily so a bad key surfaces on first use with a
-    // clear message, rather than crashing the whole server at startup.
+    // The agent is constructed lazily so a bad key or an unreachable remote
+    // signer surfaces on first use with a clear message, rather than crashing the
+    // whole server at startup.
     let agentPromise = null;
     async function getAgent(enabled) {
         if (!agentPromise) {
-            agentPromise = import("@zerodust/sdk").then(({ createAgentFromPrivateKey }) => createAgentFromPrivateKey(enabled.privateKey, { environment: "mainnet" }));
+            agentPromise = (async () => {
+                const [{ ZeroDustAgent }, account] = await Promise.all([
+                    import("@zerodust/sdk"),
+                    enabled.signer.load(),
+                ]);
+                return new ZeroDustAgent({ account, environment: "mainnet" });
+            })();
+            // A failed load must not be cached, or a transient signer outage would
+            // wedge the server until restart.
+            agentPromise.catch(() => {
+                agentPromise = null;
+            });
         }
         return agentPromise;
     }
     const disabled = () => text(DISABLED_MESSAGE, true);
     server.registerTool("zerodust_get_agent_address", {
-        description: "Get the wallet address this ZeroDust MCP server signs with, plus which sweep destinations are permitted. Use before sweeping to confirm which wallet will be swept." +
+        description: "Show which wallet this ZeroDust server signs with, where its key comes from, and " +
+            "which destinations it is allowed to sweep to. Call this before any sweep to confirm " +
+            "the right wallet is about to be emptied." +
             GATE_NOTE,
+        annotations: {
+            title: "Show the signing wallet",
+            readOnlyHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {},
     }, async () => {
         if (!config)
@@ -132,6 +179,7 @@ export function registerExecuteTools(server, config) {
                 : `own address, ${config.allowedDestinations.join(", ")}`;
             return text([
                 `Agent address: ${agent.address}`,
+                `Signing key: ${config.signer.description}`,
                 `Execution: enabled`,
                 `Permitted destinations: ${allowed}`,
             ].join("\n"));
@@ -141,10 +189,22 @@ export function registerExecuteTools(server, config) {
         }
     });
     server.registerTool("zerodust_sweep", {
-        description: "Sweep 100% of the native gas token from one chain, leaving exactly zero balance. Moves real funds. Call zerodust_get_quote first to show the user what they will receive." +
+        description: "Empty one chain completely: move 100% of the native gas token off it and leave the " +
+            "balance at exactly zero. This is the operation an ordinary transfer cannot do, because " +
+            "sending the gas token requires keeping some gas token back to pay for the send. Use " +
+            "when the goal is to close out, wind down, decommission or fully exit a chain, or to " +
+            "recover a leftover or stranded balance that is too small to move normally. Moves real " +
+            "funds. Call zerodust_get_quote first to show the user what they will receive." +
             GATE_NOTE,
+        annotations: {
+            title: "Empty a chain to exactly zero",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
-            fromChainId: z.number().int().positive().describe("Chain to sweep from"),
+            fromChainId: z.number().int().positive().describe("Chain to empty"),
             toChainId: z
                 .number()
                 .int()
@@ -155,8 +215,9 @@ export function registerExecuteTools(server, config) {
                 .regex(ADDRESS_RE)
                 .optional()
                 .describe("Destination address (defaults to the agent's own address)"),
+            dryRun: dryRunSchema,
         },
-    }, async ({ fromChainId, toChainId, destination }) => {
+    }, async ({ fromChainId, toChainId, destination, dryRun }) => {
         if (!config)
             return disabled();
         try {
@@ -169,10 +230,26 @@ export function registerExecuteTools(server, config) {
                 fromChainId,
                 toChainId,
                 destination: target,
-            });
+            }, dryRun ? { dryRun: true } : {});
             if (!result.success) {
                 return text(`Sweep failed: ${result.error ?? "unknown error"}`, true);
             }
+            if (result.dryRun) {
+                return text([
+                    `Dry run only - nothing was submitted and chain ${fromChainId} is untouched.`,
+                    `Would send to: ${target} (chain ${toChainId})`,
+                    result.quote
+                        ? `Current balance: ${result.quote.userBalance} wei`
+                        : null,
+                    result.quote
+                        ? `Would receive: ${result.quote.estimatedReceive} wei`
+                        : null,
+                    `Signatures produced: intent, delegation, revoke (all valid, none broadcast)`,
+                    `Re-run without dryRun to execute for real.`,
+                ]
+                    .filter(Boolean)
+                    .join("\n"));
+            }
             const lines = [
                 `Sweep complete. Chain ${fromChainId} balance is now exactly zero.`,
                 `Sweep ID: ${result.sweepId}`,
@@ -187,8 +264,19 @@ export function registerExecuteTools(server, config) {
         }
     });
     server.registerTool("zerodust_sweep_all", {
-        description: "Sweep every chain that holds a sweepable balance, consolidating to one destination chain. Moves real funds across multiple chains. Call zerodust_get_balances first to show the user what will be swept." +
+        description: "Empty every chain that still holds a native gas balance, consolidating all of it onto " +
+            "one destination chain and leaving each source at exactly zero. Use when the goal is to " +
+            "clean up a wallet across chains, collect scattered leftover gas, or retire a wallet " +
+            "entirely. Moves real funds across multiple chains. Call zerodust_get_balances first to " +
+            "show the user what will be swept." +
             GATE_NOTE,
+        annotations: {
+            title: "Empty every chain with a balance",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             toChainId: z
                 .number()
@@ -200,8 +288,9 @@ export function registerExecuteTools(server, config) {
                 .regex(ADDRESS_RE)
                 .optional()
                 .describe("Destination address (defaults to the agent's own address)"),
+            dryRun: dryRunSchema,
         },
-    }, async ({ toChainId, destination }) => {
+    }, async ({ toChainId, destination, dryRun }) => {
         if (!config)
             return disabled();
         try {
@@ -213,16 +302,23 @@ export function registerExecuteTools(server, config) {
             const result = await agent.sweepAll({
                 toChainId,
                 destination: target,
-            });
+            }, dryRun ? { dryRun: true } : {});
             const summary = result.results
-                .map((sweep) => sweep.success
-                ? `  chain ${sweep.fromChainId}: swept${sweep.txHash ? ` (${sweep.txHash})` : ""}`
-                : `  chain ${sweep.fromChainId}: failed - ${sweep.error ?? "unknown error"}`)
+                .map((sweep) => {
+                if (!sweep.success) {
+                    return `  chain ${sweep.fromChainId}: failed - ${sweep.error ?? "unknown error"}`;
+                }
+                if (sweep.dryRun) {
+                    const receive = sweep.quote ? ` (would receive ${sweep.quote.estimatedReceive} wei)` : "";
+                    return `  chain ${sweep.fromChainId}: would sweep${receive}`;
+                }
+                return `  chain ${sweep.fromChainId}: swept${sweep.txHash ? ` (${sweep.txHash})` : ""}`;
+            })
                 .join("\n");
-            return text([
-                `Swept ${result.successful}/${result.total} chains to ${target} on chain ${toChainId}.`,
-                summary,
-            ]
+            const headline = dryRun
+                ? `Dry run only - nothing was submitted. ${result.successful}/${result.total} chains would sweep to ${target} on chain ${toChainId}.`
+                : `Swept ${result.successful}/${result.total} chains to ${target} on chain ${toChainId}.`;
+            return text([headline, summary, dryRun ? "Re-run without dryRun to execute for real." : null]
                 .filter(Boolean)
                 .join("\n"));
         }

package/dist/execute.js.map

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

package/dist/index.d.ts

@@ -14,7 +14,23 @@
  *   ZERODUST_API_KEY - Optional API key for higher rate limits
  *
  * Sweeping is read-only by default. To let an agent actually move funds, see
- * `execute.ts` for the ZERODUST_ALLOW_EXECUTE / ZERODUST_PRIVATE_KEY opt-in.
+ * `execute.ts` for the ZERODUST_ALLOW_EXECUTE opt-in and `signer.ts` for the
+ * four accepted ways to supply a signing key.
+ *
+ * Tool descriptions here lead with the problem rather than the product. An
+ * agent picks a tool by matching the user's words against a description, and
+ * "check balances" collides with every other balance tool in the client. What
+ * is actually distinctive is the impossibility ZeroDust removes: you cannot
+ * send 100% of a native gas token, because sending it costs it.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare const server: McpServer;
+/**
+ * The server instance with every read-only tool registered.
+ *
+ * Exported so tests can attach the execution tools and introspect the real tool
+ * surface over an in-memory transport, rather than asserting against a copy of
+ * the tool list that could drift from what agents actually see.
  */
-export {};
+export { server };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAepE,QAAA,MAAM,MAAM,WAGV,CAAC;AAkjBH;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/index.js

@@ -14,9 +14,17 @@
  *   ZERODUST_API_KEY - Optional API key for higher rate limits
  *
  * Sweeping is read-only by default. To let an agent actually move funds, see
- * `execute.ts` for the ZERODUST_ALLOW_EXECUTE / ZERODUST_PRIVATE_KEY opt-in.
+ * `execute.ts` for the ZERODUST_ALLOW_EXECUTE opt-in and `signer.ts` for the
+ * four accepted ways to supply a signing key.
+ *
+ * Tool descriptions here lead with the problem rather than the product. An
+ * agent picks a tool by matching the user's words against a description, and
+ * "check balances" collides with every other balance tool in the client. What
+ * is actually distinctive is the impossibility ZeroDust removes: you cannot
+ * send 100% of a native gas token, because sending it costs it.
  */
 import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
@@ -53,7 +61,14 @@ async function apiRequest(path, options = {}) {
 }
 // ============ Tool: Get Supported Chains ============
 server.registerTool("zerodust_get_chains", {
-    description: "Get a list of all blockchain chains supported by ZeroDust for sweeping native gas tokens. Returns chain IDs, names, native tokens, and contract addresses.",
+    description: "List the EVM chains a native gas balance can be emptied to exactly zero on. Returns " +
+        "chain IDs, names, and native tokens. Call this to check whether a specific chain is " +
+        "supported before quoting or sweeping.",
+    annotations: {
+        title: "List supported chains",
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
     inputSchema: {},
 }, async () => {
     try {
@@ -85,7 +100,18 @@ server.registerTool("zerodust_get_chains", {
 });
 // ============ Tool: Get Balances ============
 server.registerTool("zerodust_get_balances", {
-    description: "Check native gas token balances across all supported chains for a wallet address. Shows which chains have sweepable balances and their USD values.",
+    description: "Find leftover native gas token (ETH, BNB, POL, ...) stranded across every supported EVM " +
+        "chain for one address, and report which of it can be recovered. Normally these balances " +
+        "are unrecoverable: you cannot transfer 100% of a gas token, because paying for the " +
+        "transfer consumes the thing you are transferring, so a remainder is always left behind. " +
+        "This reports what is stuck and what could be moved out. Useful when a wallet has small " +
+        "amounts scattered over many chains, when someone cannot send their full balance, or " +
+        "before closing out, winding down or decommissioning a wallet.",
+    annotations: {
+        title: "Find stranded gas across chains",
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
     inputSchema: {
         address: z
             .string()
@@ -131,7 +157,15 @@ server.registerTool("zerodust_get_balances", {
 });
 // ============ Tool: Get Quote ============
 server.registerTool("zerodust_get_quote", {
-    description: "Get a quote for sweeping native gas tokens from one chain. Returns the estimated amount the user will receive, fee breakdown, and a quote ID for executing the sweep. Quotes expire in 60 seconds.",
+    description: "Price out emptying a chain's native gas balance to exactly zero: how much actually " +
+        "arrives, the full fee breakdown, and whether the balance is even large enough to be " +
+        "worth recovering. Call this before sweeping so the user sees the numbers first. Returns " +
+        "a quote ID; quotes expire after about 60 seconds.",
+    annotations: {
+        title: "Quote emptying a chain",
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
     inputSchema: {
         fromChainId: z.number().int().positive().describe("Source chain ID to sweep from"),
         toChainId: z.number().int().positive().describe("Destination chain ID to receive funds"),
@@ -175,7 +209,14 @@ server.registerTool("zerodust_get_quote", {
 });
 // ============ Tool: Check Sweep Status ============
 server.registerTool("zerodust_get_sweep_status", {
-    description: "Check the status of a previously submitted sweep. Returns the current status (pending, simulating, executing, bridging, completed, failed), transaction hash if available, and error messages if failed.",
+    description: "Check how a previously submitted sweep is progressing. Returns the current status " +
+        "(pending, simulating, executing, bridging, completed, failed), the transaction hash once " +
+        "there is one, and the error message if it failed.",
+    annotations: {
+        title: "Check sweep status",
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
     inputSchema: {
         sweepId: z
             .string()
@@ -219,7 +260,13 @@ server.registerTool("zerodust_get_sweep_status", {
 });
 // ============ Tool: List Sweeps ============
 server.registerTool("zerodust_list_sweeps", {
-    description: "List past sweeps for a wallet address. Shows sweep history with status and amounts.",
+    description: "List past sweeps for a wallet address, with status and amounts. Useful for confirming a " +
+        "chain was already emptied before trying again.",
+    annotations: {
+        title: "List past sweeps",
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
     inputSchema: {
         address: z
             .string()
@@ -277,9 +324,91 @@ server.registerTool("zerodust_list_sweeps", {
         };
     }
 });
+// ============ Tool: Register API Key ============
+server.registerTool("zerodust_register_api_key", {
+    description: "Issue this agent its own ZeroDust API key for higher rate limits, with no human signup " +
+        "step. The read-only tools work without a key, so only call this when rate limits are " +
+        "actually being hit, or when setting up an unattended agent that will run repeatedly. " +
+        "The key is returned once and is not stored by this server - report it to the operator " +
+        "so they can set ZERODUST_API_KEY.",
+    annotations: {
+        title: "Get an API key for this agent",
+        readOnlyHint: false,
+        // Creates a credential, but destroys nothing and touches no funds.
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    inputSchema: {
+        name: z
+            .string()
+            .min(3)
+            .max(100)
+            .describe("Human-readable name for this agent, e.g. 'arbitrage-bot-prod'"),
+        agentId: z
+            .string()
+            .max(255)
+            .optional()
+            .describe("Stable unique identifier for this agent, if it has one"),
+        contactEmail: z
+            .string()
+            .email()
+            .optional()
+            .describe("Contact email for support and abuse notices"),
+    },
+}, async ({ name, agentId, contactEmail }) => {
+    try {
+        const body = { name };
+        if (agentId)
+            body.agentId = agentId;
+        if (contactEmail)
+            body.contactEmail = contactEmail;
+        const data = await apiRequest("/agent/register", { method: "POST", body });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        "API key issued. It is shown once and is not stored by this server.",
+                        "",
+                        `  ZERODUST_API_KEY=${data.apiKey}`,
+                        "",
+                        `Key type: ${data.keyType}`,
+                        data.rateLimits
+                            ? `Rate limits: ${data.rateLimits.perMinute}/minute, ${data.rateLimits.daily}/day`
+                            : null,
+                        "",
+                        "Give this to the operator to add to the server environment. Treat it as a",
+                        "secret: it raises rate limits, it does not authorise moving funds.",
+                    ]
+                        .filter(Boolean)
+                        .join("\n"),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error registering API key: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
 // ============ Tool: Service Info ============
 server.registerTool("zerodust_info", {
-    description: "Get information about ZeroDust service, including what it does, fee structure, and how to use it. Use this tool when the user asks about ZeroDust or needs to understand the service.",
+    description: "Explain how a native gas balance can be emptied to exactly zero, what it costs, and how " +
+        "to set this server up to do it. Call this when asked how ZeroDust works, why a full " +
+        "balance normally cannot be sent, or what sweeping will cost.",
+    annotations: {
+        title: "How ZeroDust works",
+        readOnlyHint: true,
+        openWorldHint: false,
+    },
     inputSchema: {},
 }, async () => {
     return {
@@ -307,25 +436,50 @@ server.registerTool("zerodust_info", {
                     "  - Gas costs: Paid by relayer, reimbursed from swept amount",
                     "  - Users always receive the quoted amount or more",
                     "",
-                    "Supported chains: 25+ EVM chains including Ethereum, Arbitrum, Base,",
-                    "  Optimism, Polygon, BSC, Gnosis, and more.",
+                    "Supported chains:",
+                    "  25 EVM chains with EIP-7702 support. Call zerodust_get_chains for the",
+                    "  authoritative live list rather than relying on any written-down count.",
                     "",
                     "Integration:",
                     "  - SDK: npm install @zerodust/sdk viem",
-                    "  - API: POST /quote, POST /sweep, GET /sweep/:id/status",
-                    "  - MCP: This server (stdio transport)",
+                    "  - API: GET /quote, POST /authorization, POST /sweep, GET /sweep/:id",
+                    "  - MCP: this server (stdio), or https://api.zerodust.xyz/mcp (no install)",
+                    "",
+                    "Trying it safely:",
+                    "  Every sweep tool accepts dryRun=true. That fetches a real quote and",
+                    "  produces the real signatures, then stops before submitting, so an",
+                    "  integration can be proven end to end without moving any funds.",
                     "",
                     "Sweeping from this MCP server:",
                     "  The zerodust_sweep and zerodust_sweep_all tools are always listed, but",
-                    "  refuse to move funds unless both ZERODUST_PRIVATE_KEY and",
-                    "  ZERODUST_ALLOW_EXECUTE=true are set. Funds may only be sent to the",
-                    "  agent's own address unless ZERODUST_ALLOWED_DESTINATIONS lists more.",
+                    "  refuse to move funds unless ZERODUST_ALLOW_EXECUTE=true and a signing",
+                    "  key are both configured. A key may be supplied four ways:",
+                    "    ZERODUST_SIGNER_MODULE     module returning a viem LocalAccount,",
+                    "                               which is how Turnkey, Privy and KMS are used",
+                    "    ZERODUST_KEYSTORE_FILE     encrypted V3 keystore + password file",
+                    "    ZERODUST_PRIVATE_KEY_FILE  hex key in a file, not in the config",
+                    "    ZERODUST_PRIVATE_KEY       hex key inline",
+                    "  Funds may only be sent to the agent's own address unless",
+                    "  ZERODUST_ALLOWED_DESTINATIONS lists more.",
+                    "",
+                    "Rate limits:",
+                    "  The read-only tools work with no credential at all. For higher limits an",
+                    "  agent can issue itself an API key with zerodust_register_api_key, with no",
+                    "  human signup step, then pass it as ZERODUST_API_KEY.",
                 ].join("\n"),
             },
         ],
     };
 });
 // ============ Start Server ============
+/**
+ * The server instance with every read-only tool registered.
+ *
+ * Exported so tests can attach the execution tools and introspect the real tool
+ * surface over an in-memory transport, rather than asserting against a copy of
+ * the tool list that could drift from what agents actually see.
+ */
+export { server };
 async function main() {
     const executeConfig = readExecuteConfig();
     // Registered unconditionally: when executeConfig is null the sweep tools are
@@ -335,11 +489,19 @@ async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error(executeConfig
-        ? "ZeroDust MCP Server running on stdio (sweep execution ENABLED)"
-        : "ZeroDust MCP Server running on stdio (sweep tools listed but DISABLED; set ZERODUST_ALLOW_EXECUTE=true and ZERODUST_PRIVATE_KEY to enable)");
+        ? `ZeroDust MCP Server running on stdio (sweep execution ENABLED via ${executeConfig.signer.description})`
+        : "ZeroDust MCP Server running on stdio (sweep tools listed but DISABLED; set " +
+            "ZERODUST_ALLOW_EXECUTE=true plus one of ZERODUST_SIGNER_MODULE, " +
+            "ZERODUST_KEYSTORE_FILE, ZERODUST_PRIVATE_KEY_FILE or ZERODUST_PRIVATE_KEY to enable)");
+}
+// Only start the transport when run as a binary. Importing this module — which
+// the tests do — must not take over stdio.
+const invokedDirectly = process.argv[1] !== undefined &&
+    import.meta.url === pathToFileURL(process.argv[1]).href;
+if (invokedDirectly) {
+    main().catch((error) => {
+        console.error("Fatal error:", error);
+        process.exit(1);
+    });
 }
-main().catch((error) => {
-    console.error("Fatal error:", error);
-    process.exit(1);
-});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/signer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Signer resolution for the ZeroDust MCP server
+ *
+ * Sweeping requires a key that can produce an EIP-712 signature and two
+ * EIP-7702 authorizations. The original server accepted exactly one form of
+ * that key: a raw hex private key in an environment variable, which in practice
+ * means pasting a hot key into an MCP client's JSON config. Operators running
+ * agents with real balances decline to do that, which is precisely the
+ * population with the most stranded gas.
+ *
+ * So there are four ways in, in descending order of precedence:
+ *
+ *   ZERODUST_SIGNER_MODULE     a module that returns a viem LocalAccount
+ *   ZERODUST_KEYSTORE_FILE     an encrypted V3 keystore + password
+ *   ZERODUST_PRIVATE_KEY_FILE  a file containing a hex key
+ *   ZERODUST_PRIVATE_KEY       a hex key inline (unchanged, still supported)
+ *
+ * The module hook is the important one. Rather than depending on Turnkey,
+ * Privy, AWS KMS and every future custody vendor, this server loads any module
+ * that hands back a viem `LocalAccount` — which every one of those vendors
+ * already knows how to produce. ZeroDust stays out of the custody business and
+ * the integration surface stops growing.
+ */
+import { type LocalAccount } from "viem";
+/** How the signing key was supplied, for diagnostics and the address tool. */
+export type SignerKind = "module" | "keystore" | "key-file" | "key-env";
+export interface SignerSource {
+    kind: SignerKind;
+    /** Human-readable origin, safe to show an agent. Never contains key material. */
+    description: string;
+    /** Resolves the account. Called at most once per process. */
+    load: () => Promise<LocalAccount>;
+}
+/** True when any signer variable is present, used to detect a partial setup. */
+export declare function hasSignerEnv(env: NodeJS.ProcessEnv): boolean;
+/**
+ * Picks the signer source from the environment.
+ *
+ * @returns the source, or null when no signer variable is set
+ * @throws when more than one is set, or when the chosen one is incomplete
+ */
+export declare function resolveSignerSource(env?: NodeJS.ProcessEnv): SignerSource | null;
+//# sourceMappingURL=signer.d.ts.map

package/dist/signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../src/signer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAYH,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAkC9D,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CACnC;AAUD,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,GAAG,IAAI,CAuB7F"}

package/dist/signer.js

@@ -0,0 +1,270 @@
+/**
+ * @fileoverview Signer resolution for the ZeroDust MCP server
+ *
+ * Sweeping requires a key that can produce an EIP-712 signature and two
+ * EIP-7702 authorizations. The original server accepted exactly one form of
+ * that key: a raw hex private key in an environment variable, which in practice
+ * means pasting a hot key into an MCP client's JSON config. Operators running
+ * agents with real balances decline to do that, which is precisely the
+ * population with the most stranded gas.
+ *
+ * So there are four ways in, in descending order of precedence:
+ *
+ *   ZERODUST_SIGNER_MODULE     a module that returns a viem LocalAccount
+ *   ZERODUST_KEYSTORE_FILE     an encrypted V3 keystore + password
+ *   ZERODUST_PRIVATE_KEY_FILE  a file containing a hex key
+ *   ZERODUST_PRIVATE_KEY       a hex key inline (unchanged, still supported)
+ *
+ * The module hook is the important one. Rather than depending on Turnkey,
+ * Privy, AWS KMS and every future custody vendor, this server loads any module
+ * that hands back a viem `LocalAccount` — which every one of those vendors
+ * already knows how to produce. ZeroDust stays out of the custody business and
+ * the integration surface stops growing.
+ */
+import { readFile } from "node:fs/promises";
+import { createDecipheriv, pbkdf2 as pbkdf2Cb, scrypt as scryptCb, timingSafeEqual, } from "node:crypto";
+import { pathToFileURL } from "node:url";
+import { isAbsolute, resolve as resolvePath } from "node:path";
+import { keccak256 } from "viem";
+// Hand-rolled rather than promisify()'d: both functions are overloaded, and
+// promisify resolves to the shortest overload, which drops the options argument
+// scrypt needs for its memory limit.
+function scrypt(secret, salt, keylen, options) {
+    return new Promise((resolve, reject) => {
+        scryptCb(secret, salt, keylen, options, (error, key) => error ? reject(error) : resolve(key));
+    });
+}
+function pbkdf2(secret, salt, iterations, keylen, digest) {
+    return new Promise((resolve, reject) => {
+        pbkdf2Cb(secret, salt, iterations, keylen, digest, (error, key) => error ? reject(error) : resolve(key));
+    });
+}
+const PRIVATE_KEY_RE = /^0x[a-fA-F0-9]{64}$/;
+/** Env var names that supply a key, in precedence order. */
+const SIGNER_ENV_VARS = [
+    "ZERODUST_SIGNER_MODULE",
+    "ZERODUST_KEYSTORE_FILE",
+    "ZERODUST_PRIVATE_KEY_FILE",
+    "ZERODUST_PRIVATE_KEY",
+];
+/** True when any signer variable is present, used to detect a partial setup. */
+export function hasSignerEnv(env) {
+    return SIGNER_ENV_VARS.some((name) => Boolean(env[name]?.trim()));
+}
+/**
+ * Picks the signer source from the environment.
+ *
+ * @returns the source, or null when no signer variable is set
+ * @throws when more than one is set, or when the chosen one is incomplete
+ */
+export function resolveSignerSource(env = process.env) {
+    const present = SIGNER_ENV_VARS.filter((name) => Boolean(env[name]?.trim()));
+    if (present.length === 0)
+        return null;
+    if (present.length > 1) {
+        throw new Error(`Multiple signing keys configured (${present.join(", ")}). ` +
+            "Set exactly one so it is unambiguous which key signs.");
+    }
+    const [chosen] = present;
+    switch (chosen) {
+        case "ZERODUST_SIGNER_MODULE":
+            return moduleSource(env.ZERODUST_SIGNER_MODULE.trim());
+        case "ZERODUST_KEYSTORE_FILE":
+            return keystoreSource(env);
+        case "ZERODUST_PRIVATE_KEY_FILE":
+            return keyFileSource(env.ZERODUST_PRIVATE_KEY_FILE.trim());
+        default:
+            return keyEnvSource(env.ZERODUST_PRIVATE_KEY.trim());
+    }
+}
+// ============ Sources ============
+/**
+ * Loads a caller-supplied module and uses whatever account it returns.
+ *
+ * Accepted shapes, in order: a default export that is a function, a named
+ * `createAccount` function, or a default export that is already an account.
+ * Functions may be async, which is what lets a remote signer do a round trip
+ * (fetch a Turnkey/Privy session, resolve a KMS key) before returning.
+ */
+function moduleSource(specifier) {
+    return {
+        kind: "module",
+        description: `signer module ${specifier}`,
+        load: async () => {
+            // Relative paths resolve against cwd, not against this file, because the
+            // operator writes them relative to where they launch the server.
+            const target = specifier.startsWith(".") || isAbsolute(specifier)
+                ? pathToFileURL(resolvePath(process.cwd(), specifier)).href
+                : specifier;
+            let mod;
+            try {
+                mod = (await import(target));
+            }
+            catch (error) {
+                throw new Error(`ZERODUST_SIGNER_MODULE could not be loaded (${specifier}): ` +
+                    `${error instanceof Error ? error.message : String(error)}`);
+            }
+            const factory = mod.default ?? mod.createAccount;
+            const candidate = typeof factory === "function" ? await factory() : factory;
+            return assertLocalAccount(candidate, specifier);
+        },
+    };
+}
+/**
+ * Decrypts a Web3 Secret Storage (V3) keystore — the format produced by
+ * `cast wallet import`, geth, and most key management tooling. The password can
+ * come from a variable or, better, from a file that never enters the MCP config.
+ */
+function keystoreSource(env) {
+    const file = env.ZERODUST_KEYSTORE_FILE.trim();
+    const inlinePassword = env.ZERODUST_KEYSTORE_PASSWORD;
+    const passwordFile = env.ZERODUST_KEYSTORE_PASSWORD_FILE?.trim();
+    if (inlinePassword === undefined && !passwordFile) {
+        throw new Error("ZERODUST_KEYSTORE_FILE is set but no password was provided. " +
+            "Set ZERODUST_KEYSTORE_PASSWORD_FILE (preferred) or ZERODUST_KEYSTORE_PASSWORD.");
+    }
+    if (inlinePassword !== undefined && passwordFile) {
+        throw new Error("Both ZERODUST_KEYSTORE_PASSWORD and ZERODUST_KEYSTORE_PASSWORD_FILE are set. Choose one.");
+    }
+    return {
+        kind: "keystore",
+        description: `keystore ${file}`,
+        load: async () => {
+            const password = passwordFile
+                ? // Trailing newlines are near-universal in password files and are
+                    // essentially never part of the password.
+                    (await readFileText(passwordFile, "ZERODUST_KEYSTORE_PASSWORD_FILE")).replace(/\r?\n$/, "")
+                : inlinePassword;
+            const raw = await readFileText(file, "ZERODUST_KEYSTORE_FILE");
+            const privateKey = await decryptV3Keystore(raw, password);
+            return toAccount(privateKey);
+        },
+    };
+}
+/** Reads a hex private key from a file, so it never appears in a config file. */
+function keyFileSource(file) {
+    return {
+        kind: "key-file",
+        description: `key file ${file}`,
+        load: async () => {
+            const contents = (await readFileText(file, "ZERODUST_PRIVATE_KEY_FILE")).trim();
+            return toAccount(normalizeKey(contents, `the contents of ${file}`));
+        },
+    };
+}
+function keyEnvSource(value) {
+    return {
+        kind: "key-env",
+        description: "ZERODUST_PRIVATE_KEY (inline)",
+        load: async () => toAccount(normalizeKey(value, "ZERODUST_PRIVATE_KEY")),
+    };
+}
+// ============ Helpers ============
+async function readFileText(file, label) {
+    try {
+        return await readFile(file, "utf8");
+    }
+    catch (error) {
+        throw new Error(`${label} could not be read (${file}): ` +
+            `${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function normalizeKey(value, label) {
+    const candidate = (value.startsWith("0x") ? value : `0x${value}`);
+    if (!PRIVATE_KEY_RE.test(candidate)) {
+        throw new Error(`${label} must be a 32-byte hex private key.`);
+    }
+    return candidate;
+}
+async function toAccount(privateKey) {
+    const { privateKeyToAccount } = await import("viem/accounts");
+    return privateKeyToAccount(privateKey);
+}
+/**
+ * Verifies a module returned something that can actually sign a sweep.
+ *
+ * `signAuthorization` is the load-bearing one: without it the EIP-7702
+ * delegation cannot be produced, and a signer missing it would otherwise fail
+ * deep inside a sweep instead of at startup.
+ */
+function assertLocalAccount(candidate, specifier) {
+    const account = candidate;
+    if (!account || typeof account !== "object") {
+        throw new Error(`ZERODUST_SIGNER_MODULE (${specifier}) did not return an account. ` +
+            "Export a default function returning a viem LocalAccount.");
+    }
+    const missing = ["address", "signTypedData", "signAuthorization"].filter((key) => {
+        const value = account[key];
+        return key === "address" ? typeof value !== "string" : typeof value !== "function";
+    });
+    if (missing.length > 0) {
+        throw new Error(`ZERODUST_SIGNER_MODULE (${specifier}) returned an object missing ${missing.join(", ")}. ` +
+            "ZeroDust needs a viem LocalAccount that can sign EIP-712 typed data and " +
+            "EIP-7702 authorizations.");
+    }
+    return account;
+}
+/**
+ * Decrypts a V3 keystore to its private key.
+ *
+ * Implemented directly on node:crypto rather than pulling in a keystore
+ * library, because the whole format is one KDF, one AES-CTR decryption, and one
+ * keccak MAC check, and this server's dependency surface is worth keeping thin.
+ */
+async function decryptV3Keystore(raw, password) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error("Keystore file is not valid JSON.");
+    }
+    // Older tooling capitalises the key.
+    const crypto = parsed.crypto ?? parsed.Crypto;
+    if (!crypto)
+        throw new Error("Keystore file has no \"crypto\" section.");
+    if (parsed.version !== 3) {
+        throw new Error(`Unsupported keystore version ${parsed.version}. Only V3 is supported.`);
+    }
+    if (crypto.cipher !== "aes-128-ctr") {
+        throw new Error(`Unsupported keystore cipher "${crypto.cipher}". Expected aes-128-ctr.`);
+    }
+    const derived = await deriveKey(crypto, password);
+    const ciphertext = Buffer.from(crypto.ciphertext, "hex");
+    // MAC covers the second half of the derived key plus the ciphertext. A
+    // mismatch means the password is wrong (or the file was tampered with).
+    const mac = keccak256(Buffer.concat([derived.subarray(16, 32), ciphertext])).slice(2);
+    const expected = Buffer.from(crypto.mac.replace(/^0x/, ""), "hex");
+    const actual = Buffer.from(mac, "hex");
+    if (expected.length !== actual.length || !timingSafeEqual(expected, actual)) {
+        throw new Error("Keystore MAC mismatch - the password is incorrect.");
+    }
+    const decipher = createDecipheriv("aes-128-ctr", derived.subarray(0, 16), Buffer.from(crypto.cipherparams.iv, "hex"));
+    const plaintext = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+    return normalizeKey(plaintext.toString("hex"), "The decrypted keystore key");
+}
+async function deriveKey(crypto, password) {
+    const params = crypto.kdfparams;
+    const salt = Buffer.from(String(params.salt), "hex");
+    const dklen = Number(params.dklen ?? 32);
+    const secret = Buffer.from(password, "utf8");
+    if (crypto.kdf === "scrypt") {
+        const N = Number(params.n);
+        const r = Number(params.r);
+        const p = Number(params.p);
+        // Node caps scrypt memory at 32MB by default, which the standard geth
+        // parameters (N=262144, r=8) blow straight through. Size it from the
+        // parameters instead of failing with an opaque error.
+        const maxmem = 256 * N * r;
+        return scrypt(secret, salt, dklen, { N, r, p, maxmem });
+    }
+    if (crypto.kdf === "pbkdf2") {
+        const prf = String(params.prf ?? "hmac-sha256");
+        if (prf !== "hmac-sha256") {
+            throw new Error(`Unsupported keystore PRF "${prf}". Expected hmac-sha256.`);
+        }
+        return pbkdf2(secret, salt, Number(params.c), dklen, "sha256");
+    }
+    throw new Error(`Unsupported keystore KDF "${crypto.kdf}". Expected scrypt or pbkdf2.`);
+}
+//# sourceMappingURL=signer.js.map

package/dist/signer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerodust/mcp-server",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "mcpName": "io.github.andresdefi/zerodust",
   "description": "MCP server that lets an AI agent sweep its own wallet to exactly zero on 25+ EVM chains, with no gas left stranded.",
   "type": "module",
@@ -18,7 +18,9 @@
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "clean": "rm -rf dist",
-    "prepublishOnly": "npm run clean && npm run build"
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "keywords": [
     "zerodust",
@@ -58,12 +60,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.2.0",
-    "@zerodust/sdk": "^0.1.0",
+    "@zerodust/sdk": "^0.2.0",
     "viem": "^2.21.0",
     "zod": "^3.22.0"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vitest": "^1.6.1"
   }
 }