@cloakely/mcp 0.8.2 → 0.8.4

package/dist/server.d.ts

@@ -3,7 +3,7 @@ import { type Prover } from "@cloakely/sdk";
 import type { Settings } from "./config.js";
 export { loadSettings, type Settings, type Limits } from "./config.js";
 export { Spending } from "./limits.js";
-export declare const VERSION = "0.8.2";
+export declare const VERSION = "0.8.4";
 export declare const HOSTED_URL = "https://cloak.boblabs.tech/mcp";
 /** Turn an SDK or chain error into one plain sentence an agent can act on. */
 export declare function explain(e: unknown): string;

package/dist/server.js

@@ -4,11 +4,11 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { createPublicClient, createWalletClient, erc20Abi, formatEther, formatUnits, http, isAddress, parseEther, parseUnits, zeroAddress, } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
-import { Cloak, CloakPrivate, cloakAuctionAbi, cloakPairAbi, cloakVaultsAbi, legacyFactories, createProver, loadProver, createSharedProver, loadSharedProver, privateRouterAbi, relayerSubmitter, sharedRelayerSubmitter, sharedVaultAbi, SharedVaultClient, shieldedPoolAbi, buildClaimLink, buildRequestLink, linkAddress, linkCheck, linkKeys, openLinkKeys, newLinkSecret, parseClaimLink, parseRequestLink, LINK_SHARES_MAX, CloakDrops, CloakSpots, } from "@cloakely/sdk";
+import { Cloak, CloakPrivate, cloakAuctionAbi, cloakPairAbi, cloakVaultsAbi, legacyFactories, createProver, loadProver, createSharedProver, loadSharedProver, privateRouterAbi, relayerSubmitter, sharedRelayerSubmitter, sharedVaultAbi, SharedVaultClient, shieldedPoolAbi, buildClaimLink, buildRequestLink, linkAddress, linkCheck, linkKeys, openLinkKeys, newLinkSecret, parseClaimLink, parseRequestLink, LINK_SHARES_MAX, CloakDrops, CloakSpots, resolveRecipient, CIRCUITS_CDN, } from "@cloakely/sdk";
 import { Spending } from "./limits.js";
 export { loadSettings } from "./config.js";
 export { Spending } from "./limits.js";
-export const VERSION = "0.8.2";
+export const VERSION = "0.8.4";
 export const HOSTED_URL = "https://cloak.boblabs.tech/mcp";
 const INSTRUCTIONS = `Cloak: sealed-bid token launches and private trading on Kinetiq's Elysium (HYPE is the gas and base currency).
 
@@ -97,11 +97,11 @@ export function createCloakServer(settings, opts = {}) {
     const prover = opts.prover ??
         (() => (proverP ??= settings.circuitsDir
             ? Promise.resolve(createProver(readFileSync(join(settings.circuitsDir, "transaction2x2.wasm")), readFileSync(join(settings.circuitsDir, "transaction2x2_final.zkey"))))
-            : loadProver(d.circuitsUrl)));
+            : loadProver([CIRCUITS_CDN, d.circuitsUrl])));
     let sharedProverP;
     const sharedProver = () => (sharedProverP ??= settings.circuitsDir
         ? Promise.resolve(createSharedProver(readFileSync(join(settings.circuitsDir, "transactionMA2x2.wasm")), readFileSync(join(settings.circuitsDir, "transactionMA2x2_final.zkey"))))
-        : loadSharedProver(d.circuitsUrl));
+        : loadSharedProver([CIRCUITS_CDN, d.circuitsUrl]));
     let sharedC;
     /** The shared launch-token vault (new Uniswap launches keep their private balances there). */
     async function shared() {
@@ -399,7 +399,7 @@ export function createCloakServer(settings, opts = {}) {
     const dropsFor = (w) => {
         if (!d.dropFactory)
             throw new Error("NFT drops aren't deployed on this network yet.");
-        return new CloakDrops(pub, w, d.dropFactory, d.dropFactoryBlock ?? 0n);
+        return new CloakDrops(pub, w, d.dropFactory, d.dropFactoryBlock ?? 0n, d.escrowDropFactory);
     };
     const spotsFor = (w) => (d.spotBook ? new CloakSpots(dropsFor(w), d.spotBook) : null);
     const dropPhase = (s) => (s.failed ? "ended with no sale (every bid refunded)" : s.phase === "gtd" ? "gtd (guaranteed list minting; bidding opens after)" : s.phase === "settle" || s.phase === "numbering" ? "settling" : s.phase);
@@ -410,7 +410,8 @@ export function createCloakServer(settings, opts = {}) {
             drop: s.address,
             name: s.name,
             symbol: s.symbol,
-            kind: sale ? `WL spot sale for ${sale.partner}` : "NFT drop",
+            kind: sale ? `WL spot sale for ${sale.partner}` : s.escrow ? "auction of existing NFTs" : "NFT drop",
+            ...(s.escrow ? { collection: s.escrow.collection, tokenIds: s.escrow.tokenIds.map(String), heldInEscrow: `${s.escrow.held} of ${s.supply}` } : {}),
             phase: dropPhase(s),
             ...(s.phase === "gtd" ? { biddingOpens: iso(s.gtdEnd) } : {}),
             biddingEnds: iso(s.commitEnd),
@@ -456,7 +457,7 @@ export function createCloakServer(settings, opts = {}) {
     }));
     server.registerTool("get_drop", {
         title: "Drop details",
-        description: "One NFT drop or WL spot sale: phase, timing, floor, WL boost, results once settled, whether a wallet is on its GTD list or WL, and for a spot sale the whitelist so far.",
+        description: "One NFT drop, WL spot sale or auction of existing NFTs: phase, timing, floor, WL boost, results once settled, whether a wallet is on its GTD list or WL, and for a spot sale the whitelist so far.",
         inputSchema: { drop: addr, wallet: addr.optional().describe("A wallet to check against the drop's GTD list and WL") },
         annotations: READ,
     }, safe(async ({ drop, wallet: w }) => {
@@ -834,13 +835,14 @@ export function createCloakServer(settings, opts = {}) {
     }));
     server.registerTool("withdraw", {
         title: "Withdraw to an address",
-        description: "Move funds from the private balance to a normal 0x address (public on purpose). A brand-new address keeps the most privacy. Cloak keeps 0.25%, and the relayer takes a small fee for gas.",
-        inputSchema: { asset: z.string().describe('"HYPE", "USDC" or a launch token'), to: addr, amount: amt('Amount, or "max"'), dry_run: dry },
+        description: "Move funds from the private balance to a normal 0x address or .ely name (public on purpose). A brand-new address keeps the most privacy. Cloak keeps 0.25%, and the relayer takes a small fee for gas.",
+        inputSchema: { asset: z.string().describe('"HYPE", "USDC" or a launch token'), to: z.string().describe("0x address or a .ely name (looked up when sending)"), amount: amt('Amount, or "max"'), dry_run: dry },
         annotations: WRITE,
     }, safe(async ({ asset, to, amount, dry_run }) => {
         const { spending } = needWallet();
-        if (!isAddress(to))
-            throw new Error("`to` must be a 0x address.");
+        const dest = await resolveRecipient(pub, to); // a .ely name resolves now: names expire and change hands
+        const named = dest.name ? `${dest.name} (${dest.address})` : dest.address;
+        to = dest.address;
         const a = await resolve(asset);
         const p = await priv();
         const kind = a.kind === "hype" ? "unshieldHype" : "transact";
@@ -852,12 +854,12 @@ export function createCloakServer(settings, opts = {}) {
         spending.check(c.budget, c.value);
         const arrives = await pub.readContract({ address: a.pool, abi: shieldedPoolAbi, functionName: "afterFee", args: [x] });
         if (isDry(dry_run))
-            return { dryRun: true, wouldWithdraw: fmtAmt(a, x), arrives: fmtAmt(a, arrives), to };
+            return { dryRun: true, wouldWithdraw: fmtAmt(a, x), arrives: fmtAmt(a, arrives), to: named };
         return exclusive(async () => {
             const h = a.kind === "hype" ? await p.unshieldHype(to, x) : sharedTok ? await (await shared()).unshield(a.token, x, to) : await p.unshieldToken(a.token, to, x);
             await receipt(h);
             spending.record(c.budget, c.value);
-            return { withdrew: fmtAmt(a, x), arrived: fmtAmt(a, arrives), to, privateBalance: fmtAmt(a, await balanceOf(a)), tx: link(h) };
+            return { withdrew: fmtAmt(a, x), arrived: fmtAmt(a, arrives), to: named, privateBalance: fmtAmt(a, await balanceOf(a)), tx: link(h) };
         });
     }));
     // ───────────── payment links ─────────────
@@ -967,13 +969,13 @@ export function createCloakServer(settings, opts = {}) {
     server.registerTool("claim_payment_link", {
         title: "Claim a payment link",
         description: "Claim the money in a claim link: into this account's private balance (default), or out to any 0x address. Also how a sender takes back a link nobody claimed. The relayer submits it and takes its fee from the link, so no gas is needed. On a link split into shares, it claims one share.",
-        inputSchema: { link: z.string().describe("The claim link"), passcode: z.string().optional(), to: z.string().optional().describe('"private" (default) or a 0x address'), dry_run: dry },
+        inputSchema: { link: z.string().describe("The claim link"), passcode: z.string().optional(), to: z.string().optional().describe('"private" (default), a 0x address or a .ely name'), dry_run: dry },
         annotations: WRITE,
     }, safe(async ({ link: url, passcode, to, dry_run }) => {
         const { l, c } = await linkClient(url, passcode);
         const out = to && to !== "private";
-        if (out && !isAddress(to))
-            throw new Error('`to` must be "private" or a 0x address.');
+        if (out)
+            to = (await resolveRecipient(pub, to)).address; // a 0x address, or a .ely name resolved now
         const held = [];
         let spent = 0;
         for (const sym of ["HYPE", "USDC"]) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cloakely/mcp",
   "mcpName": "io.github.NECOKIZZ/cloak",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "Cloak's MCP server: let an AI agent launch tokens with sealed bids and trade them privately on Elysium, with spending limits, testnet by default and a local signer.",
   "keywords": [
     "mcp",
@@ -47,7 +47,7 @@
     "@modelcontextprotocol/sdk": "1.32.1",
     "viem": "2.21.54",
     "zod": "4.6.7",
-    "@cloakely/sdk": "^0.8.2"
+    "@cloakely/sdk": "^0.8.4"
   },
   "devDependencies": {
     "@types/node": "22.10.2",