@zhieldcash/agent 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zhield Cash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+# @zhieldcash/agent
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A shielded wallet for AI agents. An [MCP](https://modelcontextprotocol.io) server that gives an agent (Claude, Cursor, any MCP client) its own wallet on Robinhood Chain, funded through [Zhield Cash](https://zhield.cash) so nothing on-chain links it to the person who runs it.
+
+**The model never sees a note or a key.** Notes move through files on your machine; the tools only show a note's id, pool and state.
+
+```bash
+npx @zhieldcash/agent init
+```
+
+That creates `~/.zhield-agent` with the agent's key, prints its address and the config for your MCP client:
+
+```json
+{ "mcpServers": { "zhield": { "command": "npx", "args": ["-y", "@zhieldcash/agent"] } } }
+```
+
+## How it works
+
+1. **Fund it privately.** Shield ETH at [zhield.cash/app](https://zhield.cash/app) (or with `@zhieldcash/sdk`) and paste the notes into `~/.zhield-agent/inbox.txt`, one per line.
+2. **The agent withdraws them to itself.** `zhield_redeem` builds the zero-knowledge proof on your machine and withdraws through the relayer, which pays the gas, so the agent's wallet needs no ETH to start. It waits for good cover first: 10+ approved deposits in the pool and 3+ after yours.
+3. **It works with its own wallet.** Whatever it pays for, nothing on-chain points back to your main wallet.
+4. **It can send funds back privately.** `zhield_shield` deposits from the agent wallet as fixed-size notes and leaves them in `outbox.txt` for you to unshield wherever you like.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `zhield_wallet` | The agent's address, ETH balance, and every inbox and outbox note by id, with its state and cover. Read only. |
+| `zhield_pools` | The 0.001, 0.01 and 0.1 ETH pools: deposits, approved deposits, whether a withdrawal would have good cover. Read only. |
+| `zhield_redeem` | Withdraws ready inbox notes to the agent. `ids` to pick some; `force` to skip the cover wait. |
+| `zhield_shield` | Shields an amount from the agent wallet, split into pool sizes, notes to the outbox. Capped per call. |
+| `zhield_send` | Sends ETH from the agent wallet. Capped per call. |
+
+## Settings
+
+| Variable | Default | |
+|---|---|---|
+| `ZHIELD_AGENT_HOME` | `~/.zhield-agent` | The folder with the key and the note files. |
+| `ZHIELD_AGENT_MAX_SHIELD` | `0.5` | Most ETH one `zhield_shield` call may deposit. |
+| `ZHIELD_AGENT_MAX_SEND` | `0.05` | Most ETH one `zhield_send` call may transfer. |
+| `ZHIELD_AGENT_RPC` | Robinhood Chain public RPC | |
+| `ZHIELD_AGENT_RELAYER` | `https://zhield.cash/api/relay` | `none` makes the agent pay withdrawal gas itself. |
+| `ZHIELD_AGENT_ARTIFACTS` | fetched from zhield.cash | A folder with `withdraw.wasm` and `withdraw.zkey`. |
+
+## Safety
+
+- `~/.zhield-agent/key` **is** the agent's wallet. Back it up, and never paste it into a chat.
+- Keep the agent's balance to what it needs. The per-call caps limit a single mistake, not a determined one.
+- Most MCP clients ask before running a tool that spends; leave that on for `zhield_shield` and `zhield_send`.
+- A note in `inbox.txt` can be withdrawn by whoever reads that file. Keep the folder on a machine you trust.
+
+## Tests
+
+```bash
+npm test             # offline: the folder, the key, the note files
+npm run test:fork    # end to end through a real MCP client on an anvil fork of mainnet
+```
+
+```bash
+anvil --fork-url https://rpc.mainnet.chain.robinhood.com --chain-id 4663
+```
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,105 @@
+import { Zhield } from "@zhieldcash/sdk";
+import { type Home } from "./store.js";
+export type AgentOptions = {
+    /** Folder with the key and the note files (default ~/.zhield-agent or ZHIELD_AGENT_HOME). */
+    home?: string;
+    rpcUrl?: string;
+    /** null turns the relayer off; then the agent pays withdrawal gas itself. */
+    relayerUrl?: string | null;
+    /** A folder with withdraw.wasm (or withdraw_js/withdraw.wasm) and withdraw.zkey, instead of fetching them. */
+    artifactsDir?: string;
+    /** Most ETH one shield call may deposit (default 0.5). */
+    maxShieldEth?: string;
+    /** Most ETH one send call may transfer (default 0.05). */
+    maxSendEth?: string;
+};
+export type NoteState = "not deposited" | "screening" | "ready" | "spent";
+export type NoteInfo = {
+    id: string;
+    pool: string;
+    state: NoteState;
+    cover?: {
+        crowd: number;
+        after: number;
+        good: boolean;
+    };
+};
+/** Good cover, as in the app: enough approved deposits to hide among and a few after this one. */
+export declare const COVER: {
+    readonly crowd: 10;
+    readonly after: 3;
+};
+export declare function optionsFromEnv(): AgentOptions;
+export declare class Agent {
+    readonly h: Home;
+    readonly address: `0x${string}`;
+    readonly z: Zhield;
+    private readonly wallet;
+    private readonly limits;
+    private cache;
+    private constructor();
+    static open(o?: AgentOptions): Promise<Agent>;
+    close(): Promise<void>;
+    balance(): Promise<bigint>;
+    private state;
+    /** Where a note stands, and how well it would hide if withdrawn now. */
+    info(note: string): Promise<NoteInfo>;
+    /** The agent's wallet and both note files, by id. */
+    overview(): Promise<{
+        address: `0x${string}`;
+        balanceEth: string;
+        chain: string;
+        inbox: NoteInfo[];
+        outbox: NoteInfo[];
+        folder: string;
+    }>;
+    pools(): Promise<{
+        pool: string;
+        name: string;
+        deposits: number;
+        approved: number;
+        goodCover: boolean;
+    }[]>;
+    /**
+     * Withdraws ready notes from the inbox to the agent's own address. Without
+     * `force`, a note waits until it has good cover.
+     */
+    redeem(o?: {
+        ids?: string[];
+        force?: boolean;
+    }): Promise<{
+        id: string;
+        pool: string;
+        done: boolean;
+        detail: string;
+        tx?: string;
+        receivedEth?: string;
+        via?: string;
+    }[]>;
+    /**
+     * Shields ETH from the agent wallet as fixed-size notes, biggest pool first, and
+     * leaves the notes in the outbox for the owner. Returns ids only.
+     */
+    shield(o: {
+        amountEth: string;
+    }): Promise<{
+        shieldedEth: string;
+        keptEth: string;
+        notes: {
+            id: string;
+            pool: string;
+            tx: string;
+        }[];
+        outbox: string;
+    }>;
+    /** A plain ETH transfer from the agent wallet, capped per call. */
+    send(o: {
+        to: string;
+        amountEth: string;
+    }): Promise<{
+        tx: `0x${string}`;
+        sentEth: string;
+        to: string;
+    }>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4C,MAAM,EAA0D,MAAM,iBAAiB,CAAC;AAG3I,OAAO,EAA0D,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAa/F,MAAM,MAAM,YAAY,GAAG;IACzB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8GAA8G;IAC9G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAC1E,MAAM,MAAM,QAAQ,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAAC;AAE/H,kGAAkG;AAClG,eAAO,MAAM,KAAK;;;CAAmC,CAAC;AAGtD,wBAAgB,cAAc,IAAI,YAAY,CAU7C;AAgBD,qBAAa,KAAK;IAId,QAAQ,CAAC,CAAC,EAAE,IAAI;IAChB,QAAQ,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,KAAK,CAAyC;IAEtD,OAAO;WAQM,IAAI,CAAC,CAAC,GAAE,YAAiB;IAuBtC,KAAK;IAIC,OAAO;IAIb,OAAO,CAAC,KAAK;IAKb,wEAAwE;IAClE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa3C,qDAAqD;IAC/C,QAAQ;;;;;;;;IAUR,KAAK;;;;;;;IAUX;;;OAGG;IACG,MAAM,CAAC,CAAC,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;YAIjC,MAAM;cAAQ,MAAM;cAAQ,OAAO;gBAAU,MAAM;aAAO,MAAM;sBAAgB,MAAM;cAAQ,MAAM;;IAmC3H;;;OAGG;IACG,MAAM,CAAC,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE;;;;gBAWlB,MAAM;kBAAQ,MAAM;gBAAM,MAAM;;;;IAUnD,mEAAmE;IAC7D,IAAI,CAAC,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;;;;;CAShD"}

package/dist/agent.js

@@ -0,0 +1,198 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { commitmentOf, parseNote, ROBINHOOD_CHAIN, Zhield, ZhieldError } from "@zhieldcash/sdk";
+import { createWalletClient, defineChain, formatEther, http, parseEther } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { addNotes, home, noteId, readKey, readNotes, writeNotes } from "./store.js";
+/** Good cover, as in the app: enough approved deposits to hide among and a few after this one. */
+export const COVER = { crowd: 10, after: 3 };
+const GAS_MARGIN = parseEther("0.0002");
+export function optionsFromEnv() {
+    const e = process.env;
+    return {
+        home: e.ZHIELD_AGENT_HOME || undefined,
+        rpcUrl: e.ZHIELD_AGENT_RPC || undefined,
+        relayerUrl: e.ZHIELD_AGENT_RELAYER === "none" ? null : e.ZHIELD_AGENT_RELAYER || undefined,
+        artifactsDir: e.ZHIELD_AGENT_ARTIFACTS || undefined,
+        maxShieldEth: e.ZHIELD_AGENT_MAX_SHIELD || undefined,
+        maxSendEth: e.ZHIELD_AGENT_MAX_SEND || undefined,
+    };
+}
+function artifacts(dir) {
+    if (!dir)
+        return undefined;
+    const wasm = [join(dir, "withdraw.wasm"), join(dir, "withdraw_js", "withdraw.wasm")].find((p) => {
+        try {
+            readFileSync(p, { flag: "r" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+    if (!wasm)
+        throw new ZhieldError(`No withdraw.wasm in ${dir}.`);
+    return { wasm: readFileSync(wasm), zkey: readFileSync(join(dir, "withdraw.zkey")) };
+}
+export class Agent {
+    constructor(h, address, z, wallet, limits) {
+        this.h = h;
+        this.address = address;
+        this.z = z;
+        this.wallet = wallet;
+        this.limits = limits;
+        this.cache = new Map();
+    }
+    static async open(o = {}) {
+        const h = home(o.home);
+        const key = readKey(h);
+        if (!key)
+            throw new ZhieldError(`No agent key in ${h.dir}. Run \`npx @zhieldcash/agent init\` first.`);
+        const account = privateKeyToAccount(key);
+        const rpcUrl = o.rpcUrl ?? ROBINHOOD_CHAIN.rpcUrl;
+        const chain = defineChain({
+            id: ROBINHOOD_CHAIN.id,
+            name: ROBINHOOD_CHAIN.name,
+            nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+            rpcUrls: { default: { http: [rpcUrl] } },
+        });
+        const wallet = createWalletClient({ account, chain, transport: http(rpcUrl) });
+        // The SDK takes any signer with an address and sendTransaction; viem's typed `0x` strings need this adapter.
+        const signer = {
+            account: { address: account.address },
+            sendTransaction: (tx) => wallet.sendTransaction({ to: tx.to, data: tx.data, value: tx.value, account, chain }),
+        };
+        const z = await Zhield.connect({ rpcUrl, signer, relayerUrl: o.relayerUrl, artifacts: artifacts(o.artifactsDir) });
+        return new Agent(h, account.address, z, wallet, { shield: parseEther(o.maxShieldEth ?? "0.5"), send: parseEther(o.maxSendEth ?? "0.05") });
+    }
+    close() {
+        return this.z.close();
+    }
+    async balance() {
+        return BigInt(await this.z.rpc.call("eth_getBalance", [this.address, "latest"]));
+    }
+    state(pool) {
+        if (!this.cache.has(pool.id))
+            this.cache.set(pool.id, this.z.poolState(pool));
+        return this.cache.get(pool.id);
+    }
+    /** Where a note stands, and how well it would hide if withdrawn now. */
+    async info(note) {
+        const n = parseNote(note);
+        const pool = this.z.pool(n.pool);
+        const [s, st] = await Promise.all([this.state(pool), this.z.status(note)]);
+        const base = { id: noteId(note), pool: `${pool.id} ETH` };
+        if (st.spent || st.ragequit)
+            return { ...base, state: "spent" };
+        if (!st.deposited)
+            return { ...base, state: "not deposited" };
+        const c = commitmentOf(n);
+        const after = s.leaves.length - 1 - s.leaves.indexOf(c);
+        const cover = { crowd: s.approved.length, after, good: s.approved.length >= COVER.crowd && after >= COVER.after };
+        return { ...base, state: st.approved ? "ready" : "screening", cover };
+    }
+    /** The agent's wallet and both note files, by id. */
+    async overview() {
+        this.cache.clear();
+        const [bal, inbox, outbox] = await Promise.all([
+            this.balance(),
+            Promise.all(readNotes(this.h.inbox).map((n) => this.info(n))),
+            Promise.all(readNotes(this.h.outbox).map((n) => this.info(n))),
+        ]);
+        return { address: this.address, balanceEth: formatEther(bal), chain: `${ROBINHOOD_CHAIN.name} (${ROBINHOOD_CHAIN.id})`, inbox, outbox, folder: this.h.dir };
+    }
+    async pools() {
+        this.cache.clear();
+        return Promise.all(this.z.pools.map(async (p) => {
+            const s = await this.state(p);
+            return { pool: `${p.id} ETH`, name: p.name, deposits: s.leaves.length, approved: s.approved.length, goodCover: s.approved.length >= COVER.crowd };
+        }));
+    }
+    /**
+     * Withdraws ready notes from the inbox to the agent's own address. Without
+     * `force`, a note waits until it has good cover.
+     */
+    async redeem(o = {}) {
+        this.cache.clear();
+        const inbox = readNotes(this.h.inbox);
+        const picked = o.ids?.length ? inbox.filter((n) => o.ids.includes(noteId(n))) : inbox;
+        const results = [];
+        for (const note of picked) {
+            const i = await this.info(note);
+            const skip = (detail) => results.push({ id: i.id, pool: i.pool, done: false, detail });
+            if (i.state === "spent") {
+                addNotes(this.h.spent, [note]);
+                writeNotes(this.h.inbox, readNotes(this.h.inbox).filter((n) => n !== note));
+                skip("Already spent; moved to spent.txt.");
+                continue;
+            }
+            if (i.state === "not deposited") {
+                skip("Not in the pool yet. If the owner just deposited, try again in a moment.");
+                continue;
+            }
+            if (i.state === "screening") {
+                skip("Waiting for screening, usually a few minutes.");
+                continue;
+            }
+            if (!o.force && !i.cover?.good) {
+                skip(`Cover still building: ${i.cover?.crowd} approved deposits (want ${COVER.crowd}+), ${i.cover?.after} after this one (want ${COVER.after}+). Withdrawing now makes it easier to link. Pass force to withdraw anyway.`);
+                continue;
+            }
+            try {
+                const r = await this.z.unshield({ note, to: this.address, relayer: "auto" });
+                addNotes(this.h.spent, [note]);
+                writeNotes(this.h.inbox, readNotes(this.h.inbox).filter((n) => n !== note));
+                results.push({ id: i.id, pool: i.pool, done: true, detail: "Withdrawn to the agent wallet.", tx: r.hash, receivedEth: formatEther(r.received), via: r.via });
+            }
+            catch (e) {
+                skip(e instanceof Error ? e.message : String(e));
+            }
+            this.cache.clear();
+        }
+        return results;
+    }
+    /**
+     * Shields ETH from the agent wallet as fixed-size notes, biggest pool first, and
+     * leaves the notes in the outbox for the owner. Returns ids only.
+     */
+    async shield(o) {
+        const wei = parseEther(o.amountEth);
+        if (wei <= 0n)
+            throw new ZhieldError("The amount must be above zero.");
+        if (wei > this.limits.shield)
+            throw new ZhieldError(`Above this agent's shield limit of ${formatEther(this.limits.shield)} ETH per call (ZHIELD_AGENT_MAX_SHIELD).`);
+        const pools = [...this.z.pools].sort((a, b) => (b.wei > a.wei ? 1 : -1));
+        let rest = wei;
+        const plan = [];
+        for (const p of pools)
+            while (rest >= p.wei)
+                (plan.push(p), (rest -= p.wei));
+        if (!plan.length)
+            throw new ZhieldError(`The smallest pool is ${formatEther(pools[pools.length - 1].wei)} ETH.`);
+        const total = wei - rest;
+        if ((await this.balance()) < total + GAS_MARGIN)
+            throw new ZhieldError(`The agent wallet holds less than ${formatEther(total)} ETH plus gas.`);
+        const out = [];
+        for (const p of plan) {
+            const r = await this.z.shield({ pool: p.id });
+            // Saved at once, so a later failure never loses a note that already went in.
+            addNotes(this.h.outbox, [r.note]);
+            out.push({ id: noteId(r.note), pool: `${p.id} ETH`, tx: r.hash });
+        }
+        return { shieldedEth: formatEther(total), keptEth: formatEther(rest), notes: out, outbox: this.h.outbox };
+    }
+    /** A plain ETH transfer from the agent wallet, capped per call. */
+    async send(o) {
+        if (!/^0x[0-9a-fA-F]{40}$/.test(o.to))
+            throw new ZhieldError("`to` must be an address: 0x followed by 40 hex characters.");
+        const wei = parseEther(o.amountEth);
+        if (wei <= 0n)
+            throw new ZhieldError("The amount must be above zero.");
+        if (wei > this.limits.send)
+            throw new ZhieldError(`Above this agent's send limit of ${formatEther(this.limits.send)} ETH per call (ZHIELD_AGENT_MAX_SEND).`);
+        const hash = await this.wallet.sendTransaction({ to: o.to, value: wei, account: this.wallet.account, chain: this.wallet.chain });
+        await this.z.rpc.waitForReceipt(hash);
+        return { tx: hash, sentEth: formatEther(wei), to: o.to };
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { privateKeyToAccount } from "viem/accounts";
+import { home, init, readKey } from "./store.js";
+/*
+  zhield-agent init      make the agent folder and wallet key, print the MCP config
+  zhield-agent address   print the agent wallet's address
+  zhield-agent           run the MCP server on stdio (what an MCP client starts)
+*/
+const HELP = `zhield-agent: a shielded wallet for AI agents (MCP server)
+
+  npx @zhieldcash/agent init      create the agent wallet and folder, print the config
+  npx @zhieldcash/agent address   print the agent's address
+  npx @zhieldcash/agent           run the MCP server (your MCP client starts this)
+
+Environment: ZHIELD_AGENT_HOME, ZHIELD_AGENT_RPC, ZHIELD_AGENT_RELAYER (url or "none"),
+ZHIELD_AGENT_MAX_SHIELD (default 0.5 ETH), ZHIELD_AGENT_MAX_SEND (default 0.05 ETH).
+Docs: https://zhield.cash/docs#agents`;
+const cmd = process.argv[2];
+const h = home();
+if (cmd === "init") {
+    const { created } = init(h);
+    const address = privateKeyToAccount(readKey(h)).address;
+    console.log(`${created ? "Created" : "Already set up"}: ${h.dir}
+
+Agent address  ${address}
+Inbox          ${h.inbox}
+Outbox         ${h.outbox}
+
+Fund it privately: shield ETH at zhield.cash/app and paste the notes into inbox.txt,
+one per line. The agent withdraws them to its own address through the relayer, so it
+needs no ETH to start and nothing on-chain links it to your wallet.
+
+The key file is the agent's wallet. Back it up and never paste it into a chat.
+
+Add to your MCP client (Claude Desktop, Claude Code, Cursor):
+${JSON.stringify({ mcpServers: { zhield: { command: "npx", args: ["-y", "@zhieldcash/agent"] } } }, null, 2)}`);
+}
+else if (cmd === "address") {
+    const k = readKey(h);
+    if (!k) {
+        console.error(`No agent key in ${h.dir}. Run: npx @zhieldcash/agent init`);
+        process.exit(1);
+    }
+    console.log(privateKeyToAccount(k).address);
+}
+else if (cmd === "help" || cmd === "--help" || cmd === "-h") {
+    console.log(HELP);
+}
+else if (!cmd || cmd === "serve") {
+    const { serve } = await import("./server.js");
+    serve().catch((e) => {
+        console.error(e instanceof Error ? e.message : e);
+        process.exit(1);
+    });
+}
+else {
+    console.error(`Unknown command "${cmd}".\n\n${HELP}`);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;EAIE;AAEF,MAAM,IAAI,GAAG;;;;;;;;sCAQyB,CAAC;AAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;AAEjB,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,OAAO,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,GAAG;;iBAEhD,OAAO;iBACP,CAAC,CAAC,KAAK;iBACP,CAAC,CAAC,MAAM;;;;;;;;;EASvB,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAChH,CAAC;KAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,mCAAmC,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC;KAAM,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;KAAM,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;IACnC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC9C,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QAClB,OAAO,CAAC,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,SAAS,IAAI,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export declare function serve(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAeA,wBAAsB,KAAK,kBAuF1B"}

package/dist/server.js

@@ -0,0 +1,68 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { Agent, COVER, optionsFromEnv } from "./agent.js";
+/*
+  The MCP server: five tools over stdio. Results are JSON text. No tool ever
+  returns a note or the key; notes move through the files in the agent folder.
+*/
+const VERSION = "0.1.0";
+const ok = (v) => ({ content: [{ type: "text", text: JSON.stringify(v, null, 2) }] });
+const fail = (e) => ({ isError: true, content: [{ type: "text", text: e instanceof Error ? e.message : String(e) }] });
+export async function serve() {
+    const agent = await Agent.open(optionsFromEnv());
+    const server = new McpServer({ name: "zhield-agent", version: VERSION }, {
+        instructions: "A shielded wallet on Robinhood Chain, funded through Zhield Cash so nothing on-chain links it to its owner. " +
+            "Notes and the key never appear in tool results; notes are referred to by id. " +
+            "The owner funds the agent by putting notes in inbox.txt; zhield_redeem withdraws them to the agent's own address. " +
+            "zhield_shield sends ETH back privately as notes in outbox.txt for the owner. Ask before spending.",
+    });
+    const run = (fn) => fn().then(ok, fail);
+    server.registerTool("zhield_wallet", {
+        title: "Agent wallet",
+        description: "The agent's own address and ETH balance on Robinhood Chain, plus every note in its inbox (from the owner) and outbox (for the owner) with its state and cover. Notes are shown by id only.",
+        annotations: { readOnlyHint: true },
+    }, () => run(() => agent.overview()));
+    server.registerTool("zhield_pools", {
+        title: "Zhield pools",
+        description: `The three fixed-size pools (0.001, 0.01 and 0.1 ETH): deposits, approved deposits, and whether a withdrawal from each would have good cover (${COVER.crowd}+ approved deposits).`,
+        annotations: { readOnlyHint: true },
+    }, () => run(() => agent.pools()));
+    server.registerTool("zhield_redeem", {
+        title: "Withdraw notes to the agent",
+        description: "Withdraws ready notes from the inbox to the agent's own address, through the relayer (it pays the gas, so the agent needs no ETH first). " +
+            `By default a note waits for good cover: ${COVER.crowd}+ approved deposits and ${COVER.after}+ after it. A proof is built locally; this takes a few seconds per note.`,
+        inputSchema: {
+            ids: z.array(z.string()).optional().describe("Only these note ids; default every note in the inbox."),
+            force: z.boolean().optional().describe("Withdraw even without good cover. Easier to link; only when the owner asks."),
+        },
+        annotations: { destructiveHint: false, openWorldHint: true },
+    }, (a) => run(() => agent.redeem(a)));
+    server.registerTool("zhield_shield", {
+        title: "Shield ETH for the owner",
+        description: "Deposits ETH from the agent wallet into the pools as fixed-size notes, biggest first (0.25 becomes 2 × 0.1 + 5 × 0.01), and saves the notes to outbox.txt for the owner. " +
+            "Returns ids and transactions only. Capped per call. Spends funds: confirm with the user first.",
+        inputSchema: { amountEth: z.string().describe('Amount in ETH, e.g. "0.25".') },
+        annotations: { destructiveHint: true, openWorldHint: true },
+    }, (a) => run(() => agent.shield(a)));
+    server.registerTool("zhield_send", {
+        title: "Send ETH",
+        description: "Sends ETH from the agent wallet to an address, capped per call. Spends funds: confirm the address and amount with the user first.",
+        inputSchema: {
+            to: z.string().describe("0x address"),
+            amountEth: z.string().describe('Amount in ETH, e.g. "0.01".'),
+        },
+        annotations: { destructiveHint: true, openWorldHint: true },
+    }, (a) => run(() => agent.send(a)));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const stop = async () => {
+        await agent.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", stop);
+    process.on("SIGTERM", stop);
+    // stdout belongs to the protocol; status goes to stderr.
+    console.error(`zhield-agent ${VERSION}: ${agent.address} on Robinhood Chain`);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,20 @@
+export type Home = {
+    dir: string;
+    key: string;
+    inbox: string;
+    outbox: string;
+    spent: string;
+};
+export declare function home(dir?: string): Home;
+/** A note's public handle: enough to tell notes apart, useless for withdrawing. */
+export declare const noteId: (note: string) => string;
+/** The valid notes in a file, once each, in order. */
+export declare function readNotes(file: string): string[];
+export declare function writeNotes(file: string, notes: string[]): void;
+export declare function addNotes(file: string, notes: string[]): void;
+export declare function readKey(h: Home): `0x${string}` | null;
+/** Makes the folder and a key if there is none yet; never replaces an existing key. */
+export declare function init(h: Home): {
+    created: boolean;
+};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,IAAI,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F,wBAAgB,IAAI,CAAC,GAAG,SAAoE,GAAG,IAAI,CAElG;AAED,mFAAmF;AACnF,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,WAAsF,CAAC;AAE1H,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQhD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAEvD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAErD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,GAAG,KAAK,MAAM,EAAE,GAAG,IAAI,CAIrD;AAED,uFAAuF;AACvF,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI;;EAY3B"}

package/dist/store.js

@@ -0,0 +1,53 @@
+import { createHash } from "node:crypto";
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parseNote } from "@zhieldcash/sdk";
+import { generatePrivateKey } from "viem/accounts";
+export function home(dir = process.env.ZHIELD_AGENT_HOME || join(homedir(), ".zhield-agent")) {
+    return { dir, key: join(dir, "key"), inbox: join(dir, "inbox.txt"), outbox: join(dir, "outbox.txt"), spent: join(dir, "spent.txt") };
+}
+/** A note's public handle: enough to tell notes apart, useless for withdrawing. */
+export const noteId = (note) => createHash("sha256").update(note.trim().toLowerCase()).digest("hex").slice(0, 10);
+/** The valid notes in a file, once each, in order. */
+export function readNotes(file) {
+    if (!existsSync(file))
+        return [];
+    const seen = new Set();
+    for (const line of readFileSync(file, "utf8").split(/\r?\n/)) {
+        const n = line.trim().toLowerCase();
+        if (parseNote(n) && !seen.has(n))
+            seen.add(n);
+    }
+    return [...seen];
+}
+export function writeNotes(file, notes) {
+    writeFileSync(file, notes.length ? notes.join("\n") + "\n" : "", { mode: 0o600 });
+}
+export function addNotes(file, notes) {
+    writeNotes(file, [...new Set([...readNotes(file), ...notes])]);
+}
+export function readKey(h) {
+    if (!existsSync(h.key))
+        return null;
+    const k = readFileSync(h.key, "utf8").trim();
+    return /^0x[0-9a-fA-F]{64}$/.test(k) ? k : null;
+}
+/** Makes the folder and a key if there is none yet; never replaces an existing key. */
+export function init(h) {
+    mkdirSync(h.dir, { recursive: true, mode: 0o700 });
+    let created = false;
+    if (!readKey(h)) {
+        writeFileSync(h.key, generatePrivateKey() + "\n", { mode: 0o600 });
+        created = true;
+    }
+    try {
+        chmodSync(h.key, 0o600);
+    }
+    catch { }
+    for (const f of [h.inbox, h.outbox, h.spent])
+        if (!existsSync(f))
+            writeNotes(f, []);
+    return { created };
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@zhieldcash/agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "A shielded wallet for AI agents: an MCP server that funds an agent through Zhield Cash on Robinhood Chain, so nothing on-chain links it to its owner. The model never sees a note or a key.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "zhield-agent": "dist/cli.js"
+  },
+  "main": "./dist/agent.js",
+  "types": "./dist/agent.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/agent.d.ts",
+      "import": "./dist/agent.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "zhield",
+    "mcp",
+    "model context protocol",
+    "ai agent",
+    "agent wallet",
+    "privacy",
+    "robinhood chain"
+  ],
+  "homepage": "https://zhield.cash/docs#agents",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test test/unit.test.mjs",
+    "test:fork": "node test/fork.mjs",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.32.1",
+    "@zhieldcash/sdk": "^0.1.0",
+    "viem": "2.57.4",
+    "zod": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "typescript": "^5"
+  }
+}