@cloakely/mcp 0.8.0 → 0.8.1

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.0";
+export declare const VERSION = "0.8.1";
 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, linkKeys, newLinkSecret, parseClaimLink, parseRequestLink, LINK_SHARES_MAX, } 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, } from "@cloakely/sdk";
 import { Spending } from "./limits.js";
 export { loadSettings } from "./config.js";
 export { Spending } from "./limits.js";
-export const VERSION = "0.8.0";
+export const VERSION = "0.8.1";
 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).
 
@@ -789,7 +789,8 @@ export function createCloakServer(settings, opts = {}) {
         const l = parseClaimLink(url);
         if (l.locked && passcode === undefined)
             throw new Error(`This link is locked. Pass its passcode${l.hint ? ` (the answer to: "${l.hint}")` : ""}.`);
-        const c = new CloakPrivate(pub, d.router, await linkKeys(l.secret, l.locked ? passcode : undefined), prover, submit, d.vaultsBlock ?? d.routerBlock, d.batcher, d.migrator);
+        // a locked link with a check refuses a wrong passcode here, before anything touches the network
+        const c = new CloakPrivate(pub, d.router, await openLinkKeys(l, passcode), prover, submit, d.vaultsBlock ?? d.routerBlock, d.batcher, d.migrator);
         for (const a of d.assets ?? [])
             c.addAsset(a);
         await c.loadMarkets();
@@ -835,7 +836,9 @@ export function createCloakServer(settings, opts = {}) {
             return { dryRun: true, wouldLock: `${fmtAmt(a, total)} in ${n} share${n > 1 ? "s" : ""} of ${fmtAmt(a, each)}`, claimFeeCovered: fmtAmt(a, claimFee * BigInt(n)), locked: !!x.passcode };
         return exclusive(async () => {
             const secret = newLinkSecret();
-            const to = await linkAddress(await linkKeys(secret, x.passcode));
+            const keys = await linkKeys(secret, x.passcode);
+            const to = await linkAddress(keys);
+            const check = x.passcode ? await linkCheck(keys) : undefined;
             let block = 0n;
             const txs = [];
             for (let i = 0; i < n; i++) {
@@ -844,7 +847,7 @@ export function createCloakServer(settings, opts = {}) {
                 txs.push(link(h));
             }
             spending.record(c.budget, c.value);
-            const url = buildClaimLink({ secret, block, token: a.symbol, amount: formatUnits(n > 1 ? share : whole, a.decimals), message: x.message, from: x.from, locked: !!x.passcode, hint: x.hint, shares: n });
+            const url = buildClaimLink({ secret, block, token: a.symbol, amount: formatUnits(n > 1 ? share : whole, a.decimals), message: x.message, from: x.from, locked: !!x.passcode, hint: x.hint, shares: n, check });
             return {
                 link: url,
                 holds: `${fmtAmt(a, whole)}${n > 1 ? ` in ${n} shares of ${fmtAmt(a, share)}` : ""}`,
@@ -857,21 +860,25 @@ export function createCloakServer(settings, opts = {}) {
     server.registerTool("check_payment_link", {
         title: "Check a payment link",
         description: "What a claim link still holds (and how many shares are left), without claiming it.",
-        inputSchema: { link: z.string().describe("The claim link (https://…/claim#k=…)"), passcode: z.string().optional() },
+        inputSchema: { link: z.string().describe("The claim link (https://…/claim#…)"), passcode: z.string().optional() },
         annotations: READ,
     }, safe(async ({ link: url, passcode }) => {
         const { l, c } = await linkClient(url, passcode);
         const out = {};
         let notes = 0;
+        let spent = 0;
         for (const sym of ["HYPE", "USDC"]) {
             const a = await linkAsset(sym).catch(() => null);
             if (!a)
                 continue;
-            const live = await c.sync(a.pool);
+            const all = await c.history(a.pool);
+            const live = all.filter((x) => !x.spent);
             notes += live.length;
+            spent += all.length - live.length;
             out[sym] = fmtAmt(a, live.reduce((s, x) => s + x.amount, 0n));
         }
-        return { holds: out, ...(l.shares ? { sharesLeft: `${notes} of ${l.shares}` } : {}), ...(l.message ? { message: l.message } : {}), ...(l.from ? { from: l.from } : {}), empty: notes === 0 };
+        const status = notes > 0 ? (spent > 0 ? "partly claimed" : "waiting") : spent > 0 ? "claimed" : l.locked && !l.check ? "empty (a wrong passcode, already claimed, or not funded yet)" : "not funded yet";
+        return { holds: out, status, claimed: spent, ...(l.shares ? { sharesLeft: `${notes} of ${l.shares}` } : {}), ...(l.message ? { message: l.message } : {}), ...(l.from ? { from: l.from } : {}), empty: notes === 0 };
     }));
     server.registerTool("claim_payment_link", {
         title: "Claim a payment link",
@@ -884,13 +891,20 @@ export function createCloakServer(settings, opts = {}) {
         if (out && !isAddress(to))
             throw new Error('`to` must be "private" or a 0x address.');
         const held = [];
+        let spent = 0;
         for (const sym of ["HYPE", "USDC"]) {
             const a = await linkAsset(sym).catch(() => null);
-            if (a && (await c.balance(a.pool)) > 0n)
+            if (!a)
+                continue;
+            const all = await c.history(a.pool);
+            spent += all.filter((x) => x.spent).length;
+            if (all.some((x) => !x.spent))
                 held.push(a);
         }
         if (!held.length)
-            throw new Error(l.locked ? "Nothing opens with that passcode, or the link was already claimed." : "This link is empty: someone already claimed it, or the sender took it back.");
+            throw new Error(spent > 0 ? "This link is empty: it was already claimed, or the sender took it back."
+                : l.locked && !l.check ? "Nothing opens with that passcode: it's wrong, the link was already claimed, or its payment hasn't landed yet."
+                    : "This link holds nothing yet: the sender's payment hasn't landed. Try again in a minute.");
         if (isDry(dry_run))
             return { dryRun: true, holds: await Promise.all(held.map(async (a) => fmtAmt(a, await c.balance(a.pool)))), wouldClaimTo: out ? to : "this account's private balance", ...(l.shares ? { oneShareOf: l.shares } : {}) };
         return exclusive(async () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cloakely/mcp",
   "mcpName": "io.github.NECOKIZZ/cloak",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "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.0"
+    "@cloakely/sdk": "^0.8.1"
   },
   "devDependencies": {
     "@types/node": "22.10.2",