@ldgr/mcp 0.1.1 → 0.1.2

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.1
+npm install --global @ldgr/mcp@0.1.2
 ldgr-mcp wallet create --testnet
 # Or: ldgr-mcp wallet import --testnet
 ldgr-mcp wallet list
@@ -73,6 +73,10 @@ Restart the MCP process after upgrading; a running process keeps its loaded SDK.
 
 All monetary values are decimal strings in display units. Tool schemas reject unknown fields and credentials. Reads use fixed official network endpoints, verify ledger identity, reject redirects, time out after 15 seconds per fetch and bound responses to 1 MiB. Metadata from the ledger remains untrusted text. A `NOT_FOUND` response does not establish that an earlier transaction submission failed.
 
+Version 0.1.2 preserves HTTP 404 as `NOT_FOUND` for escrow reads as well as the
+other contract templates. Other HTTP failures and malformed successful responses
+remain `OPERATION_FAILED`; upstream response bodies are never exposed in errors.
+
 ## Prepare, review and approve
 
 `claim_faucet_drop` takes an explicit `network` and public `address`. With local

package/dist/cli.js

@@ -42,7 +42,7 @@ import { getMcpWalletInfo, saveMcpRequest, validateMcpRequest } from "@ldgr/cli/
 
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { LdgrClientError } from "@ldgr/client";
+import { LdgrClientError as LdgrClientError2 } from "@ldgr/client";
 import { assertAssetDecimals, assertAssetDisplayName, normalizeAssetTicker, parseDecimalAmount as parseDecimalAmount2 } from "@ldgr/protocol";
 import { z as z2 } from "zod";
 
@@ -90,7 +90,7 @@ function assertFaucetUrl(value) {
 }
 
 // src/transport.ts
-import { createLdgrClient } from "@ldgr/client";
+import { createLdgrClient, LdgrClientError } from "@ldgr/client";
 var MAX_RESPONSE_BYTES = 1048576;
 function readTransport(request = globalThis.fetch.bind(globalThis)) {
   return async (input) => {
@@ -147,7 +147,7 @@ async function checkedClient(network, request) {
 async function readPublicPath(network, path, request) {
   const response = await request(`${network === "mainnet" ? "https://ldgr.ltd" : "https://tst.ldgr.ltd"}${path}`);
   if (!response.ok)
-    throw new Error("LDGR read failed");
+    throw new LdgrClientError(response.status, "LDGR read failed", undefined);
   const data = await response.json();
   if (!data || typeof data !== "object" || Array.isArray(data))
     throw new Error("Invalid response");
@@ -163,7 +163,7 @@ class AssetMismatchError extends Error {
 class WalletNetworkMismatchError extends Error {
 }
 function createLdgrMcpServer(options = {}) {
-  const server = new McpServer({ name: "ldgr", version: "0.1.1" }, { instructions: INSTRUCTIONS });
+  const server = new McpServer({ name: "ldgr", version: "0.1.2" }, { instructions: INSTRUCTIONS });
   const request = readTransport(options.fetch);
   const now = options.now ?? Date.now;
   const envelope = (network, source, data) => ({ network, source, data });
@@ -174,7 +174,7 @@ function createLdgrMcpServer(options = {}) {
         const data = await run(args);
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
       } catch (error) {
-        const code = error instanceof WalletNetworkMismatchError ? "WALLET_NETWORK_MISMATCH" : error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError && error.status === 404 ? "NOT_FOUND" : "OPERATION_FAILED";
+        const code = error instanceof WalletNetworkMismatchError ? "WALLET_NETWORK_MISMATCH" : error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError2 && 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 } }) }] };
       }
@@ -312,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.1",
+    install: "npm install --global @ldgr/mcp@0.1.2",
     node: ">=20.19.0",
     create: `ldgr-mcp wallet create${args.network === "testnet" ? " --testnet" : ""}`,
     import: `ldgr-mcp wallet import${args.network === "testnet" ? " --testnet" : ""}`,
@@ -390,7 +390,7 @@ async function startLdgrMcpStdio(options = {}) {
 }
 
 // src/cli.ts
-var HELP = `LDGR MCP 0.1.1
+var HELP = `LDGR MCP 0.1.2
 
 ldgr-mcp                         Start local MCP over stdio
 ldgr-mcp --wallet <path>         Start MCP with a selected wallet store

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { LdgrClientError } from "@ldgr/client";
+import { LdgrClientError as LdgrClientError2 } from "@ldgr/client";
 import { assertAssetDecimals, assertAssetDisplayName, normalizeAssetTicker, parseDecimalAmount as parseDecimalAmount2 } from "@ldgr/protocol";
 import { z as z2 } from "zod";
 
@@ -48,7 +48,7 @@ function assertFaucetUrl(value) {
 }
 
 // src/transport.ts
-import { createLdgrClient } from "@ldgr/client";
+import { createLdgrClient, LdgrClientError } from "@ldgr/client";
 var MAX_RESPONSE_BYTES = 1048576;
 function readTransport(request = globalThis.fetch.bind(globalThis)) {
   return async (input) => {
@@ -105,7 +105,7 @@ async function checkedClient(network, request) {
 async function readPublicPath(network, path, request) {
   const response = await request(`${network === "mainnet" ? "https://ldgr.ltd" : "https://tst.ldgr.ltd"}${path}`);
   if (!response.ok)
-    throw new Error("LDGR read failed");
+    throw new LdgrClientError(response.status, "LDGR read failed", undefined);
   const data = await response.json();
   if (!data || typeof data !== "object" || Array.isArray(data))
     throw new Error("Invalid response");
@@ -121,7 +121,7 @@ class AssetMismatchError extends Error {
 class WalletNetworkMismatchError extends Error {
 }
 function createLdgrMcpServer(options = {}) {
-  const server = new McpServer({ name: "ldgr", version: "0.1.1" }, { instructions: INSTRUCTIONS });
+  const server = new McpServer({ name: "ldgr", version: "0.1.2" }, { instructions: INSTRUCTIONS });
   const request = readTransport(options.fetch);
   const now = options.now ?? Date.now;
   const envelope = (network, source, data) => ({ network, source, data });
@@ -132,7 +132,7 @@ function createLdgrMcpServer(options = {}) {
         const data = await run(args);
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
       } catch (error) {
-        const code = error instanceof WalletNetworkMismatchError ? "WALLET_NETWORK_MISMATCH" : error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError && error.status === 404 ? "NOT_FOUND" : "OPERATION_FAILED";
+        const code = error instanceof WalletNetworkMismatchError ? "WALLET_NETWORK_MISMATCH" : error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError2 && 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 } }) }] };
       }
@@ -270,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.1",
+    install: "npm install --global @ldgr/mcp@0.1.2",
     node: ">=20.19.0",
     create: `ldgr-mcp wallet create${args.network === "testnet" ? " --testnet" : ""}`,
     import: `ldgr-mcp wallet import${args.network === "testnet" ? " --testnet" : ""}`,

package/dist/stdio.js

@@ -4,7 +4,7 @@ import { getMcpWalletInfo, saveMcpRequest, validateMcpRequest } from "@ldgr/cli/
 
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { LdgrClientError } from "@ldgr/client";
+import { LdgrClientError as LdgrClientError2 } from "@ldgr/client";
 import { assertAssetDecimals, assertAssetDisplayName, normalizeAssetTicker, parseDecimalAmount as parseDecimalAmount2 } from "@ldgr/protocol";
 import { z as z2 } from "zod";
 
@@ -52,7 +52,7 @@ function assertFaucetUrl(value) {
 }
 
 // src/transport.ts
-import { createLdgrClient } from "@ldgr/client";
+import { createLdgrClient, LdgrClientError } from "@ldgr/client";
 var MAX_RESPONSE_BYTES = 1048576;
 function readTransport(request = globalThis.fetch.bind(globalThis)) {
   return async (input) => {
@@ -109,7 +109,7 @@ async function checkedClient(network, request) {
 async function readPublicPath(network, path, request) {
   const response = await request(`${network === "mainnet" ? "https://ldgr.ltd" : "https://tst.ldgr.ltd"}${path}`);
   if (!response.ok)
-    throw new Error("LDGR read failed");
+    throw new LdgrClientError(response.status, "LDGR read failed", undefined);
   const data = await response.json();
   if (!data || typeof data !== "object" || Array.isArray(data))
     throw new Error("Invalid response");
@@ -125,7 +125,7 @@ class AssetMismatchError extends Error {
 class WalletNetworkMismatchError extends Error {
 }
 function createLdgrMcpServer(options = {}) {
-  const server = new McpServer({ name: "ldgr", version: "0.1.1" }, { instructions: INSTRUCTIONS });
+  const server = new McpServer({ name: "ldgr", version: "0.1.2" }, { instructions: INSTRUCTIONS });
   const request = readTransport(options.fetch);
   const now = options.now ?? Date.now;
   const envelope = (network, source, data) => ({ network, source, data });
@@ -136,7 +136,7 @@ function createLdgrMcpServer(options = {}) {
         const data = await run(args);
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
       } catch (error) {
-        const code = error instanceof WalletNetworkMismatchError ? "WALLET_NETWORK_MISMATCH" : error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError && error.status === 404 ? "NOT_FOUND" : "OPERATION_FAILED";
+        const code = error instanceof WalletNetworkMismatchError ? "WALLET_NETWORK_MISMATCH" : error instanceof AssetMismatchError ? "ASSET_MISMATCH" : error instanceof LdgrClientError2 && 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 } }) }] };
       }
@@ -274,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.1",
+    install: "npm install --global @ldgr/mcp@0.1.2",
     node: ">=20.19.0",
     create: `ldgr-mcp wallet create${args.network === "testnet" ? " --testnet" : ""}`,
     import: `ldgr-mcp wallet import${args.network === "testnet" ? " --testnet" : ""}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ldgr/mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {