@ldgr/mcp 0.1.0 → 0.1.1

package/README.md

@@ -13,7 +13,7 @@ A remote MCP connection cannot install software, access local files, unlock a wa
 Node.js 20.19 or newer is required. Install the package, then create or import a wallet in your own terminal:
 
 ```sh
-npm install --global @ldgr/mcp@0.1.0
+npm install --global @ldgr/mcp@0.1.1
 ldgr-mcp wallet create --testnet
 # Or: ldgr-mcp wallet import --testnet
 ldgr-mcp wallet list
@@ -42,6 +42,16 @@ Configure a local MCP client:
 
 For a custom wallet store, append `--wallet` and its absolute path. Server stdout contains JSON-RPC only; startup errors go to stderr. Local `wallet_info` returns only the selected address, public key, network, ledger ID and protection mode.
 
+The `network` argument to `wallet_info` checks the selected wallet; it does not
+select another wallet or change its network. `WALLET_NETWORK_MISMATCH` means you
+should request the selected network or use `ldgr-mcp wallet list` and
+`ldgr-mcp wallet select <index>` in your terminal to choose the intended wallet.
+Keep a custom `--wallet` path consistent. MCP never changes the wallet selection.
+
+Version 0.1.1 requires `@ldgr/client@^0.6.1`, the published client release containing
+the milestone escrow, atomic offer, claim distribution, and Ledra program reads.
+Restart the MCP process after upgrading; a running process keeps its loaded SDK.
+
 ## Tools
 
 | Tool | Result |

package/dist/cli.js

@@ -159,8 +159,11 @@ var INSTRUCTIONS = `LDGR is an independent single-authority ledger. Always speci
 
 class AssetMismatchError extends Error {
 }
+
+class WalletNetworkMismatchError extends Error {
+}
 function createLdgrMcpServer(options = {}) {
-  const server = new McpServer({ name: "ldgr", version: "0.1.0" }, { instructions: INSTRUCTIONS });
+  const server = new McpServer({ name: "ldgr", version: "0.1.1" }, { instructions: INSTRUCTIONS });
   const request = readTransport(options.fetch);
   const now = options.now ?? Date.now;
   const envelope = (network, source, data) => ({ network, source, data });
@@ -171,8 +174,8 @@ function createLdgrMcpServer(options = {}) {
         const data = await run(args);
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
       } catch (error) {
-        const code = error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError && error.status === 404 ? "NOT_FOUND" : "OPERATION_FAILED";
-        const message = code === "NOT_FOUND" ? "The requested record was not found on the explicit network. This is not proof that a previous submission failed; reconcile an uncertain submission before retrying." : code === "ASSET_MISMATCH" ? "The record does not match the requested exact asset code." : "LDGR operation could not complete. Check the explicit network, address, asset, values and service availability. No transaction was signed or submitted.";
+        const code = error instanceof WalletNetworkMismatchError ? "WALLET_NETWORK_MISMATCH" : error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError && error.status === 404 ? "NOT_FOUND" : "OPERATION_FAILED";
+        const message = code === "NOT_FOUND" ? "The requested record was not found on the explicit network. This is not proof that a previous submission failed; reconcile an uncertain submission before retrying." : code === "ASSET_MISMATCH" ? "The record does not match the requested exact asset code." : code === "WALLET_NETWORK_MISMATCH" ? "The selected CLI wallet uses a different network. The network argument checks the selected wallet; it does not switch wallets or networks. Request the selected network, or run wallet list and wallet select in your own terminal to choose a wallet on the intended network. Keep any custom --wallet path consistent. No wallet settings were changed." : "LDGR operation could not complete. Check the explicit network, address, asset, values and service availability. No transaction was signed or submitted.";
         return { isError: true, content: [{ type: "text", text: JSON.stringify({ error: { code, message } }) }] };
       }
     });
@@ -309,7 +312,7 @@ function createLdgrMcpServer(options = {}) {
   }, false);
   tool("wallet_setup_instructions", "Explain user-run CLI wallet installation, creation/import and MCP connection. This tool cannot install software or access local files.", { network: networkSchema }, async (args) => ({
     network: args.network,
-    install: "npm install --global @ldgr/mcp@0.1.0",
+    install: "npm install --global @ldgr/mcp@0.1.1",
     node: ">=20.19.0",
     create: `ldgr-mcp wallet create${args.network === "testnet" ? " --testnet" : ""}`,
     import: `ldgr-mcp wallet import${args.network === "testnet" ? " --testnet" : ""}`,
@@ -321,13 +324,13 @@ function createLdgrMcpServer(options = {}) {
     instructions: "Run wallet commands yourself in a terminal. Creation/import uses local interactive prompts. Keep recovery keys and passphrases out of chat and tool calls. Remote MCP cannot install on your computer. Local preparation binds a request to your selected wallet; approvals always require human terminal review."
   }));
   if (options.local)
-    tool("wallet_info", "Read the selected local wallet's public metadata only; never returns recovery keys or passphrases.", { network: networkSchema }, async (args) => {
+    tool("wallet_info", "Read the selected local wallet's public metadata only; never returns recovery keys or passphrases. The network argument checks the selected wallet, not a wallet selector. A mismatch returns WALLET_NETWORK_MISMATCH without changing wallet settings.", { network: networkSchema }, async (args) => {
       const info = await options.local.walletInfo();
       if (!info || typeof info !== "object")
         throw new Error("No wallet selected");
       const record = info;
       if (record.network !== args.network)
-        throw new Error("Selected wallet network mismatch");
+        throw new WalletNetworkMismatchError;
       return { network: record.network, address: record.address, publicKey: record.publicKey, ledgerId: record.ledgerId, protection: record.protection };
     });
   return server;
@@ -387,7 +390,7 @@ async function startLdgrMcpStdio(options = {}) {
 }
 
 // src/cli.ts
-var HELP = `LDGR MCP 0.1.0
+var HELP = `LDGR MCP 0.1.1
 
 ldgr-mcp                         Start local MCP over stdio
 ldgr-mcp --wallet <path>         Start MCP with a selected wallet store

package/dist/index.js

@@ -117,8 +117,11 @@ var INSTRUCTIONS = `LDGR is an independent single-authority ledger. Always speci
 
 class AssetMismatchError extends Error {
 }
+
+class WalletNetworkMismatchError extends Error {
+}
 function createLdgrMcpServer(options = {}) {
-  const server = new McpServer({ name: "ldgr", version: "0.1.0" }, { instructions: INSTRUCTIONS });
+  const server = new McpServer({ name: "ldgr", version: "0.1.1" }, { instructions: INSTRUCTIONS });
   const request = readTransport(options.fetch);
   const now = options.now ?? Date.now;
   const envelope = (network, source, data) => ({ network, source, data });
@@ -129,8 +132,8 @@ function createLdgrMcpServer(options = {}) {
         const data = await run(args);
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
       } catch (error) {
-        const code = error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError && error.status === 404 ? "NOT_FOUND" : "OPERATION_FAILED";
-        const message = code === "NOT_FOUND" ? "The requested record was not found on the explicit network. This is not proof that a previous submission failed; reconcile an uncertain submission before retrying." : code === "ASSET_MISMATCH" ? "The record does not match the requested exact asset code." : "LDGR operation could not complete. Check the explicit network, address, asset, values and service availability. No transaction was signed or submitted.";
+        const code = error instanceof WalletNetworkMismatchError ? "WALLET_NETWORK_MISMATCH" : error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError && error.status === 404 ? "NOT_FOUND" : "OPERATION_FAILED";
+        const message = code === "NOT_FOUND" ? "The requested record was not found on the explicit network. This is not proof that a previous submission failed; reconcile an uncertain submission before retrying." : code === "ASSET_MISMATCH" ? "The record does not match the requested exact asset code." : code === "WALLET_NETWORK_MISMATCH" ? "The selected CLI wallet uses a different network. The network argument checks the selected wallet; it does not switch wallets or networks. Request the selected network, or run wallet list and wallet select in your own terminal to choose a wallet on the intended network. Keep any custom --wallet path consistent. No wallet settings were changed." : "LDGR operation could not complete. Check the explicit network, address, asset, values and service availability. No transaction was signed or submitted.";
         return { isError: true, content: [{ type: "text", text: JSON.stringify({ error: { code, message } }) }] };
       }
     });
@@ -267,7 +270,7 @@ function createLdgrMcpServer(options = {}) {
   }, false);
   tool("wallet_setup_instructions", "Explain user-run CLI wallet installation, creation/import and MCP connection. This tool cannot install software or access local files.", { network: networkSchema }, async (args) => ({
     network: args.network,
-    install: "npm install --global @ldgr/mcp@0.1.0",
+    install: "npm install --global @ldgr/mcp@0.1.1",
     node: ">=20.19.0",
     create: `ldgr-mcp wallet create${args.network === "testnet" ? " --testnet" : ""}`,
     import: `ldgr-mcp wallet import${args.network === "testnet" ? " --testnet" : ""}`,
@@ -279,13 +282,13 @@ function createLdgrMcpServer(options = {}) {
     instructions: "Run wallet commands yourself in a terminal. Creation/import uses local interactive prompts. Keep recovery keys and passphrases out of chat and tool calls. Remote MCP cannot install on your computer. Local preparation binds a request to your selected wallet; approvals always require human terminal review."
   }));
   if (options.local)
-    tool("wallet_info", "Read the selected local wallet's public metadata only; never returns recovery keys or passphrases.", { network: networkSchema }, async (args) => {
+    tool("wallet_info", "Read the selected local wallet's public metadata only; never returns recovery keys or passphrases. The network argument checks the selected wallet, not a wallet selector. A mismatch returns WALLET_NETWORK_MISMATCH without changing wallet settings.", { network: networkSchema }, async (args) => {
       const info = await options.local.walletInfo();
       if (!info || typeof info !== "object")
         throw new Error("No wallet selected");
       const record = info;
       if (record.network !== args.network)
-        throw new Error("Selected wallet network mismatch");
+        throw new WalletNetworkMismatchError;
       return { network: record.network, address: record.address, publicKey: record.publicKey, ledgerId: record.ledgerId, protection: record.protection };
     });
   return server;

package/dist/stdio.js

@@ -121,8 +121,11 @@ var INSTRUCTIONS = `LDGR is an independent single-authority ledger. Always speci
 
 class AssetMismatchError extends Error {
 }
+
+class WalletNetworkMismatchError extends Error {
+}
 function createLdgrMcpServer(options = {}) {
-  const server = new McpServer({ name: "ldgr", version: "0.1.0" }, { instructions: INSTRUCTIONS });
+  const server = new McpServer({ name: "ldgr", version: "0.1.1" }, { instructions: INSTRUCTIONS });
   const request = readTransport(options.fetch);
   const now = options.now ?? Date.now;
   const envelope = (network, source, data) => ({ network, source, data });
@@ -133,8 +136,8 @@ function createLdgrMcpServer(options = {}) {
         const data = await run(args);
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
       } catch (error) {
-        const code = error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError && error.status === 404 ? "NOT_FOUND" : "OPERATION_FAILED";
-        const message = code === "NOT_FOUND" ? "The requested record was not found on the explicit network. This is not proof that a previous submission failed; reconcile an uncertain submission before retrying." : code === "ASSET_MISMATCH" ? "The record does not match the requested exact asset code." : "LDGR operation could not complete. Check the explicit network, address, asset, values and service availability. No transaction was signed or submitted.";
+        const code = error instanceof WalletNetworkMismatchError ? "WALLET_NETWORK_MISMATCH" : error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError && error.status === 404 ? "NOT_FOUND" : "OPERATION_FAILED";
+        const message = code === "NOT_FOUND" ? "The requested record was not found on the explicit network. This is not proof that a previous submission failed; reconcile an uncertain submission before retrying." : code === "ASSET_MISMATCH" ? "The record does not match the requested exact asset code." : code === "WALLET_NETWORK_MISMATCH" ? "The selected CLI wallet uses a different network. The network argument checks the selected wallet; it does not switch wallets or networks. Request the selected network, or run wallet list and wallet select in your own terminal to choose a wallet on the intended network. Keep any custom --wallet path consistent. No wallet settings were changed." : "LDGR operation could not complete. Check the explicit network, address, asset, values and service availability. No transaction was signed or submitted.";
         return { isError: true, content: [{ type: "text", text: JSON.stringify({ error: { code, message } }) }] };
       }
     });
@@ -271,7 +274,7 @@ function createLdgrMcpServer(options = {}) {
   }, false);
   tool("wallet_setup_instructions", "Explain user-run CLI wallet installation, creation/import and MCP connection. This tool cannot install software or access local files.", { network: networkSchema }, async (args) => ({
     network: args.network,
-    install: "npm install --global @ldgr/mcp@0.1.0",
+    install: "npm install --global @ldgr/mcp@0.1.1",
     node: ">=20.19.0",
     create: `ldgr-mcp wallet create${args.network === "testnet" ? " --testnet" : ""}`,
     import: `ldgr-mcp wallet import${args.network === "testnet" ? " --testnet" : ""}`,
@@ -283,13 +286,13 @@ function createLdgrMcpServer(options = {}) {
     instructions: "Run wallet commands yourself in a terminal. Creation/import uses local interactive prompts. Keep recovery keys and passphrases out of chat and tool calls. Remote MCP cannot install on your computer. Local preparation binds a request to your selected wallet; approvals always require human terminal review."
   }));
   if (options.local)
-    tool("wallet_info", "Read the selected local wallet's public metadata only; never returns recovery keys or passphrases.", { network: networkSchema }, async (args) => {
+    tool("wallet_info", "Read the selected local wallet's public metadata only; never returns recovery keys or passphrases. The network argument checks the selected wallet, not a wallet selector. A mismatch returns WALLET_NETWORK_MISMATCH without changing wallet settings.", { network: networkSchema }, async (args) => {
       const info = await options.local.walletInfo();
       if (!info || typeof info !== "object")
         throw new Error("No wallet selected");
       const record = info;
       if (record.network !== args.network)
-        throw new Error("Selected wallet network mismatch");
+        throw new WalletNetworkMismatchError;
       return { network: record.network, address: record.address, publicKey: record.publicKey, ledgerId: record.ledgerId, protection: record.protection };
     });
   return server;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ldgr/mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -12,7 +12,7 @@
   "publishConfig": { "access": "public" },
   "engines": { "node": ">=20.19.0" },
   "dependencies": {
-    "@ldgr/client": "^0.6.0",
+    "@ldgr/client": "^0.6.1",
     "@ldgr/cli": "^0.5.0",
     "@ldgr/protocol": "^0.5.0",
     "@modelcontextprotocol/sdk": "1.32.2",