@manifest-network/manifest-mcp-core 0.8.0 → 0.10.0

package/README.md

@@ -14,8 +14,9 @@ npm install @manifest-network/manifest-mcp-core
 - **LCD adapter** (`lcd-adapter.ts`) -- Converts LCD/REST responses to the RPC query client shape, making the codebase transport-agnostic
 - **Module registry** (`modules.ts`) -- Static maps of Cosmos SDK modules with metadata and handler functions
 - **Query/transaction routing** (`cosmos.ts`) -- Routes `(module, subcommand, args)` to per-module handlers
-- **On-chain tool functions** (`tools/`) -- `getBalance`, `fundCredits`, `stopApp` (used by the lease package)
-- **Server utilities** (`server-utils.ts`) -- `withErrorHandling`, `jsonResponse`, `bigIntReplacer`, `sanitizeForLogging`
+- **On-chain tool functions** (`tools/`) -- `getBalance`, `fundCredits`, `setItemCustomDomain`, `stopApp` (used by lease and fred packages)
+- **Server utilities** (`server-utils.ts`) -- `withErrorHandling`, `jsonResponse`, `structuredResponse`, `bigIntReplacer`, `sanitizeForLogging`
+- **Tool annotation helpers** (`tool-metadata.ts`) -- `readOnlyAnnotations`, `mutatingAnnotations`, `manifestMeta` (versioned `_meta.manifest` payload, `MANIFEST_TOOL_META_VERSION = 1`)
 - **Wallet providers** (`wallet/`) -- `MnemonicWalletProvider` (BIP-39), `signArbitraryWithAmino` (ADR-036)
 - **Logger** (`logger.ts`) -- Leveled logger (stderr output; defaults to `warn`, configurable via `logger.setLevel()`; the node package's bootstrap reads `LOG_LEVEL` and applies it)
 - **Retry** (`retry.ts`) -- Exponential backoff with transient/permanent error classification
@@ -36,7 +37,10 @@ npm install @manifest-network/manifest-mcp-core
 | poa | yes | yes |
 | tokenfactory | yes | yes |
 | ibc-transfer | yes | yes |
+| authz | yes | yes |
+| feegrant | yes | yes |
 | auth | yes | -- |
+| mint | yes | -- |
 | manifest | -- | yes |
 
 ## Usage

package/dist/__test-utils__/callToolWithElicitation.d.ts

@@ -0,0 +1,43 @@
+import { ToolResult } from "./callTool.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { ElicitRequest, ElicitResult } from "@modelcontextprotocol/sdk/types.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+
+//#region src/__test-utils__/callToolWithElicitation.d.ts
+/**
+ * Scripted responder for incoming `elicitation/create` requests on the
+ * test-side MCP `Client`. The test author owns the mapping from request
+ * shape → result — the helper just wires it up.
+ *
+ * `respond` may be sync or async. It must return a valid `ElicitResult`
+ * (`{ action: 'accept' | 'decline' | 'cancel', content?: ... }`).
+ */
+interface ElicitationScript {
+  respond: (req: ElicitRequest) => ElicitResult | Promise<ElicitResult>;
+}
+/**
+ * Mirror of `callTool` for tools that mid-execution call
+ * `server.elicitInput(...)`. Connects an MCP client (advertising the
+ * `elicitation` capability by default) to the server over an in-memory
+ * transport, registers a request handler that delegates each incoming
+ * elicitation to `script.respond`, then invokes the named tool.
+ *
+ * Cleanup always runs via the `finally` block: client and both transports
+ * are closed, then removed from `activeTransports` to prevent double-close
+ * in the caller's `afterEach`.
+ *
+ * @param server  - The MCP `Server` instance (from `getServer()`)
+ * @param toolName - Name of the tool to invoke
+ * @param toolInput - Tool arguments
+ * @param script - Scripted responder for `elicitation/create` requests
+ * @param activeTransports - Optional mutable array; transports are added
+ *   before the call and removed after cleanup completes.
+ * @param declareElicitationCapability - When `true` (default) the test
+ *   `Client` advertises `capabilities: { elicitation: {} }`. Set to
+ *   `false` to exercise the wrapper's capability-guard path (the tool
+ *   should reject with `INVALID_CONFIG` before any elicitation happens).
+ */
+declare function callToolWithElicitation(server: Server, toolName: string, toolInput: Record<string, unknown>, script: ElicitationScript, activeTransports?: InMemoryTransport[], declareElicitationCapability?: boolean): Promise<ToolResult>;
+//#endregion
+export { ElicitationScript, callToolWithElicitation };
+//# sourceMappingURL=callToolWithElicitation.d.ts.map

package/dist/__test-utils__/callToolWithElicitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callToolWithElicitation.d.ts","names":[],"sources":["../../src/__test-utils__/callToolWithElicitation.ts"],"mappings":";;;;;;;;AAkBA;;;;;;UAAiB,iBAAA;EACf,OAAA,GAAU,GAAA,EAAK,aAAA,KAAkB,YAAA,GAAe,OAAA,CAAQ,YAAA;AAAA;;;;;;;;;AAyB1D;;;;;;;;;;;;;;iBAAsB,uBAAA,CACpB,MAAA,EAAQ,MAAA,EACR,QAAA,UACA,SAAA,EAAW,MAAA,mBACX,MAAA,EAAQ,iBAAA,EACR,gBAAA,GAAkB,iBAAA,IAClB,4BAAA,aACC,OAAA,CAAQ,UAAA"}

package/dist/__test-utils__/callToolWithElicitation.js

@@ -0,0 +1,57 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { ElicitRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+//#region src/__test-utils__/callToolWithElicitation.ts
+/**
+* Mirror of `callTool` for tools that mid-execution call
+* `server.elicitInput(...)`. Connects an MCP client (advertising the
+* `elicitation` capability by default) to the server over an in-memory
+* transport, registers a request handler that delegates each incoming
+* elicitation to `script.respond`, then invokes the named tool.
+*
+* Cleanup always runs via the `finally` block: client and both transports
+* are closed, then removed from `activeTransports` to prevent double-close
+* in the caller's `afterEach`.
+*
+* @param server  - The MCP `Server` instance (from `getServer()`)
+* @param toolName - Name of the tool to invoke
+* @param toolInput - Tool arguments
+* @param script - Scripted responder for `elicitation/create` requests
+* @param activeTransports - Optional mutable array; transports are added
+*   before the call and removed after cleanup completes.
+* @param declareElicitationCapability - When `true` (default) the test
+*   `Client` advertises `capabilities: { elicitation: {} }`. Set to
+*   `false` to exercise the wrapper's capability-guard path (the tool
+*   should reject with `INVALID_CONFIG` before any elicitation happens).
+*/
+async function callToolWithElicitation(server, toolName, toolInput, script, activeTransports = [], declareElicitationCapability = true) {
+	const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+	activeTransports.push(clientTransport, serverTransport);
+	const client = new Client({
+		name: "test-client",
+		version: "1.0.0"
+	}, declareElicitationCapability ? { capabilities: { elicitation: {} } } : { capabilities: {} });
+	if (declareElicitationCapability) client.setRequestHandler(ElicitRequestSchema, async (request) => {
+		return await script.respond(request);
+	});
+	try {
+		await server.connect(serverTransport);
+		await client.connect(clientTransport);
+		return await client.callTool({
+			name: toolName,
+			arguments: toolInput
+		});
+	} finally {
+		await client.close().catch(() => {});
+		await clientTransport.close().catch(() => {});
+		await serverTransport.close().catch(() => {});
+		for (const t of [clientTransport, serverTransport]) {
+			const idx = activeTransports.indexOf(t);
+			if (idx !== -1) activeTransports.splice(idx, 1);
+		}
+	}
+}
+//#endregion
+export { callToolWithElicitation };
+
+//# sourceMappingURL=callToolWithElicitation.js.map

package/dist/__test-utils__/callToolWithElicitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callToolWithElicitation.js","names":[],"sources":["../../src/__test-utils__/callToolWithElicitation.ts"],"sourcesContent":["import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';\nimport type { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport {\n  type ElicitRequest,\n  ElicitRequestSchema,\n  type ElicitResult,\n} from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolResult } from './callTool.js';\n\n/**\n * Scripted responder for incoming `elicitation/create` requests on the\n * test-side MCP `Client`. The test author owns the mapping from request\n * shape → result — the helper just wires it up.\n *\n * `respond` may be sync or async. It must return a valid `ElicitResult`\n * (`{ action: 'accept' | 'decline' | 'cancel', content?: ... }`).\n */\nexport interface ElicitationScript {\n  respond: (req: ElicitRequest) => ElicitResult | Promise<ElicitResult>;\n}\n\n/**\n * Mirror of `callTool` for tools that mid-execution call\n * `server.elicitInput(...)`. Connects an MCP client (advertising the\n * `elicitation` capability by default) to the server over an in-memory\n * transport, registers a request handler that delegates each incoming\n * elicitation to `script.respond`, then invokes the named tool.\n *\n * Cleanup always runs via the `finally` block: client and both transports\n * are closed, then removed from `activeTransports` to prevent double-close\n * in the caller's `afterEach`.\n *\n * @param server  - The MCP `Server` instance (from `getServer()`)\n * @param toolName - Name of the tool to invoke\n * @param toolInput - Tool arguments\n * @param script - Scripted responder for `elicitation/create` requests\n * @param activeTransports - Optional mutable array; transports are added\n *   before the call and removed after cleanup completes.\n * @param declareElicitationCapability - When `true` (default) the test\n *   `Client` advertises `capabilities: { elicitation: {} }`. Set to\n *   `false` to exercise the wrapper's capability-guard path (the tool\n *   should reject with `INVALID_CONFIG` before any elicitation happens).\n */\nexport async function callToolWithElicitation(\n  server: Server,\n  toolName: string,\n  toolInput: Record<string, unknown>,\n  script: ElicitationScript,\n  activeTransports: InMemoryTransport[] = [],\n  declareElicitationCapability = true,\n): Promise<ToolResult> {\n  const [clientTransport, serverTransport] =\n    InMemoryTransport.createLinkedPair();\n  activeTransports.push(clientTransport, serverTransport);\n\n  const client = new Client(\n    { name: 'test-client', version: '1.0.0' },\n    declareElicitationCapability\n      ? { capabilities: { elicitation: {} } }\n      : { capabilities: {} },\n  );\n\n  // Register BEFORE connect so the handler is in place by the time the\n  // server issues its first `elicitation/create` request mid-tool.\n  //\n  // Skip registration when the client did NOT advertise the elicitation\n  // capability — the SDK's `setRequestHandler` enforces that the client\n  // must have declared the capability for the request type, and would\n  // throw before the tool call ever ran. The capability-guard test path\n  // (`declareElicitationCapability: false`) exercises the wrapper's\n  // `assertElicitationCapability` throw — no elicitation will arrive,\n  // so no handler is needed.\n  if (declareElicitationCapability) {\n    client.setRequestHandler(ElicitRequestSchema, async (request) => {\n      return await script.respond(request);\n    });\n  }\n\n  try {\n    await server.connect(serverTransport);\n    await client.connect(clientTransport);\n\n    return (await client.callTool({\n      name: toolName,\n      arguments: toolInput,\n    })) as ToolResult;\n  } finally {\n    await client.close().catch(() => {});\n    await clientTransport.close().catch(() => {});\n    await serverTransport.close().catch(() => {});\n\n    // Remove by identity so afterEach won't double-close\n    for (const t of [clientTransport, serverTransport]) {\n      const idx = activeTransports.indexOf(t);\n      if (idx !== -1) activeTransports.splice(idx, 1);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,eAAsB,wBACpB,QACA,UACA,WACA,QACA,mBAAwC,EAAE,EAC1C,+BAA+B,MACV;CACrB,MAAM,CAAC,iBAAiB,mBACtB,kBAAkB,kBAAkB;AACtC,kBAAiB,KAAK,iBAAiB,gBAAgB;CAEvD,MAAM,SAAS,IAAI,OACjB;EAAE,MAAM;EAAe,SAAS;EAAS,EACzC,+BACI,EAAE,cAAc,EAAE,aAAa,EAAE,EAAE,EAAE,GACrC,EAAE,cAAc,EAAE,EAAE,CACzB;AAYD,KAAI,6BACF,QAAO,kBAAkB,qBAAqB,OAAO,YAAY;AAC/D,SAAO,MAAM,OAAO,QAAQ,QAAQ;GACpC;AAGJ,KAAI;AACF,QAAM,OAAO,QAAQ,gBAAgB;AACrC,QAAM,OAAO,QAAQ,gBAAgB;AAErC,SAAQ,MAAM,OAAO,SAAS;GAC5B,MAAM;GACN,WAAW;GACZ,CAAC;WACM;AACR,QAAM,OAAO,OAAO,CAAC,YAAY,GAAG;AACpC,QAAM,gBAAgB,OAAO,CAAC,YAAY,GAAG;AAC7C,QAAM,gBAAgB,OAAO,CAAC,YAAY,GAAG;AAG7C,OAAK,MAAM,KAAK,CAAC,iBAAiB,gBAAgB,EAAE;GAClD,MAAM,MAAM,iBAAiB,QAAQ,EAAE;AACvC,OAAI,QAAQ,GAAI,kBAAiB,OAAO,KAAK,EAAE"}

package/dist/__test-utils__/mocks.d.ts

@@ -1,7 +1,8 @@
-import { Mock, Procedure } from "../node_modules/@vitest/spy/dist/index.js";
 import { ManifestMCPConfig, WalletProvider } from "../types.js";
 import { ManifestQueryClient } from "../client.js";
 import { LeaseState } from "@manifest-network/manifestjs/dist/codegen/liftedinit/billing/v1/types.js";
+import * as vitest from "vitest";
+import * as _vitest_spy0 from "@vitest/spy";
 
 //#region src/__test-utils__/mocks.d.ts
 /**
@@ -121,12 +122,12 @@ declare function makeMockClientManager(overrides?: {
   address?: string;
   config?: ManifestMCPConfig;
 }): {
-  getQueryClient: Mock<Procedure>;
-  getSigningClient: Mock<Procedure>;
-  getAddress: Mock<Procedure>;
-  getConfig: Mock<Procedure>;
-  acquireRateLimit: Mock<Procedure>;
-  disconnect: Mock<Procedure>;
+  getQueryClient: vitest.Mock<_vitest_spy0.Procedure>;
+  getSigningClient: vitest.Mock<_vitest_spy0.Procedure>;
+  getAddress: vitest.Mock<_vitest_spy0.Procedure>;
+  getConfig: vitest.Mock<_vitest_spy0.Procedure>;
+  acquireRateLimit: vitest.Mock<_vitest_spy0.Procedure>;
+  disconnect: vitest.Mock<_vitest_spy0.Procedure>;
 };
 //#endregion
 export { makeMockClientManager, makeMockConfig, makeMockQueryClient, makeMockWallet };

package/dist/__test-utils__/mocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mocks.d.ts","names":[],"sources":["../../src/__test-utils__/mocks.ts"],"mappings":";;;;;;;;;iBAYgB,cAAA,CACd,SAAA,GAAY,OAAA,CAAQ,iBAAA,IACnB,iBAAA;AAFH;;;;AAAA,iBAgBgB,cAAA,CAAe,IAAA;EAC7B,aAAA;AAAA,IACE,cAAA;;;;UAiBM,gBAAA;EACR,QAAA;IAAa,KAAA;IAAe,MAAA;EAAA;EAC5B,aAAA;IACE,gBAAA;IACA,iBAAA;IACA,eAAA;MAAmB,KAAA;MAAe,MAAA;IAAA;EAAA;EAEpC,qBAAA;IAA0B,KAAA;IAAe,MAAA;EAAA;EACzC,8BAAA;IAAmC,KAAA;IAAe,MAAA;EAAA;EAClD,cAAA;IACE,cAAA;MAAkB,KAAA;MAAe,MAAA;IAAA;IACjC,kBAAA;MAAsB,KAAA;MAAe,MAAA;IAAA;IACrC,wBAAA;IACA,gBAAA;EAAA;EAEF,KAAA;IACE,IAAA;IACA,KAAA,EAAO,UAAA;IACP,YAAA;IACA,SAAA,GAAY,IAAA;IACZ,QAAA,GAAW,IAAA;EAAA;EAEb,YAAA;IAAiB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;EACjE,aAAA;IAAkB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;EAClE,YAAA;IAAiB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;EACjE,cAAA;IAAmB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;EACnE,aAAA;IAAkB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;AAAA;AAAA,UAG1D,YAAA;EACR,SAAA;IACE,IAAA;IACA,OAAA;IACA,MAAA;IACA,MAAA;EAAA;EAEF,IAAA;IACE,IAAA;IACA,IAAA;IACA,YAAA;IACA,SAAA;MAAc,MAAA;MAAgB,KAAA;IAAA;EAAA;EAEhC,cAAA,GAAiB,MAAA;IAAiB,QAAA;MAAY,MAAA;IAAA;EAAA;AAAA;;;;iBAMhC,mBAAA,CAAoB,SAAA;EAClC,OAAA,GAAU,gBAAA;EACV,GAAA,GAAM,YAAA;AAAA,IA4KU,mBAAA;;;;iBAMF,qBAAA,CAAsB,SAAA;EACpC,WAAA,GAAc,mBAAA;EACd,OAAA;EACA,MAAA,GAAS,iBAAA;AAAA;uBAAiB,SAAA"}
+{"version":3,"file":"mocks.d.ts","names":[],"sources":["../../src/__test-utils__/mocks.ts"],"mappings":";;;;;;;;;;iBAYgB,cAAA,CACd,SAAA,GAAY,OAAA,CAAQ,iBAAA,IACnB,iBAAA;AAFH;;;;AAAA,iBAgBgB,cAAA,CAAe,IAAA;EAC7B,aAAA;AAAA,IACE,cAAA;;;;UAiBM,gBAAA;EACR,QAAA;IAAa,KAAA;IAAe,MAAA;EAAA;EAC5B,aAAA;IACE,gBAAA;IACA,iBAAA;IACA,eAAA;MAAmB,KAAA;MAAe,MAAA;IAAA;EAAA;EAEpC,qBAAA;IAA0B,KAAA;IAAe,MAAA;EAAA;EACzC,8BAAA;IAAmC,KAAA;IAAe,MAAA;EAAA;EAClD,cAAA;IACE,cAAA;MAAkB,KAAA;MAAe,MAAA;IAAA;IACjC,kBAAA;MAAsB,KAAA;MAAe,MAAA;IAAA;IACrC,wBAAA;IACA,gBAAA;EAAA;EAEF,KAAA;IACE,IAAA;IACA,KAAA,EAAO,UAAA;IACP,YAAA;IACA,SAAA,GAAY,IAAA;IACZ,QAAA,GAAW,IAAA;EAAA;EAEb,YAAA;IAAiB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;EACjE,aAAA;IAAkB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;EAClE,YAAA;IAAiB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;EACjE,cAAA;IAAmB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;EACnE,aAAA;IAAkB,IAAA;IAAc,YAAA;IAAsB,SAAA,GAAY,IAAA;EAAA;AAAA;AAAA,UAG1D,YAAA;EACR,SAAA;IACE,IAAA;IACA,OAAA;IACA,MAAA;IACA,MAAA;EAAA;EAEF,IAAA;IACE,IAAA;IACA,IAAA;IACA,YAAA;IACA,SAAA;MAAc,MAAA;MAAgB,KAAA;IAAA;EAAA;EAEhC,cAAA,GAAiB,MAAA;IAAiB,QAAA;MAAY,MAAA;IAAA;EAAA;AAAA;;;;iBAMhC,mBAAA,CAAoB,SAAA;EAClC,OAAA,GAAU,gBAAA;EACV,GAAA,GAAM,YAAA;AAAA,IA4KU,mBAAA;;;;iBAMF,qBAAA,CAAsB,SAAA;EACpC,WAAA,GAAc,mBAAA;EACd,OAAA;EACA,MAAA,GAAS,iBAAA;AAAA;8BAAiB,YAAA,CAAA,SAAA"}

package/dist/__test-utils__/mocks.js

@@ -1,5 +1,5 @@
-import { vi } from "../node_modules/vitest/dist/chunks/test.CTcmp4Su.js";
 import { LeaseState } from "@manifest-network/manifestjs/dist/codegen/liftedinit/billing/v1/types.js";
+import { vi } from "vitest";
 //#region src/__test-utils__/mocks.ts
 /**
 * Create a mock ManifestMCPConfig with sensible defaults.

package/dist/config.d.ts

@@ -12,6 +12,16 @@ declare const DEFAULT_REQUESTS_PER_SECOND = 10;
  * the --gas-adjustment value used in this project's E2E scripts (e2e/scripts/init_billing.sh).
  */
 declare const DEFAULT_GAS_MULTIPLIER = 1.5;
+/**
+ * Validate URL format and check if it uses HTTPS or is localhost (HTTP allowed for local dev)
+ * Returns validation result with error reason if invalid
+ */
+declare function validateEndpointUrl(url: string, label: string): {
+  valid: true;
+} | {
+  valid: false;
+  reason: string;
+};
 /**
  * Create a configuration object with defaults applied
  */
@@ -32,5 +42,5 @@ declare function validateConfig(config: Partial<ManifestMCPConfig>): ValidationR
  */
 declare function createValidatedConfig(input: ManifestMCPConfig): ManifestMCPConfig;
 //#endregion
-export { DEFAULT_GAS_MULTIPLIER, DEFAULT_REQUESTS_PER_SECOND, DEFAULT_RETRY_CONFIG, ValidationResult, createConfig, createValidatedConfig, validateConfig };
+export { DEFAULT_GAS_MULTIPLIER, DEFAULT_REQUESTS_PER_SECOND, DEFAULT_RETRY_CONFIG, ValidationResult, createConfig, createValidatedConfig, validateConfig, validateEndpointUrl };
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;AAeA;cAAa,2BAAA;;;;AAOb;;cAAa,sBAAA;;AA8Eb;;iBAAgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAoB,iBAAA;;;;UAuBvC,gBAAA;EACf,KAAA;EACA,MAAA;AAAA;;;;iBAMc,cAAA,CACd,MAAA,EAAQ,OAAA,CAAQ,iBAAA,IACf,gBAAA;AAFH;;;AAAA,iBAsIgB,qBAAA,CACd,KAAA,EAAO,iBAAA,GACN,iBAAA"}
+{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;AAeA;cAAa,2BAAA;;;;AAOb;;cAAa,sBAAA;;AAsBb;;;iBAAgB,mBAAA,CACd,GAAA,UACA,KAAA;EACG,KAAA;AAAA;EAAkB,KAAA;EAAc,MAAA;AAAA;;;AAqDrC;iBAAgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAoB,iBAAA;;;;UAuBvC,gBAAA;EACf,KAAA;EACA,MAAA;AAAA;AAFF;;;AAAA,iBAQgB,cAAA,CACd,MAAA,EAAQ,OAAA,CAAQ,iBAAA,IACf,gBAAA;;AAFH;;iBAsIgB,qBAAA,CACd,KAAA,EAAO,iBAAA,GACN,iBAAA"}

package/dist/config.js

@@ -135,6 +135,6 @@ function createValidatedConfig(input) {
 	return createConfig(input);
 }
 //#endregion
-export { DEFAULT_GAS_MULTIPLIER, DEFAULT_REQUESTS_PER_SECOND, DEFAULT_RETRY_CONFIG, createConfig, createValidatedConfig, validateConfig };
+export { DEFAULT_GAS_MULTIPLIER, DEFAULT_REQUESTS_PER_SECOND, DEFAULT_RETRY_CONFIG, createConfig, createValidatedConfig, validateConfig, validateEndpointUrl };
 
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { DEFAULT_RETRY_CONFIG } from './retry.js';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n} from './types.js';\n\n/**\n * Default address prefix for Manifest Network\n */\nconst DEFAULT_ADDRESS_PREFIX = 'manifest';\n\n/**\n * Default requests per second for rate limiting\n */\nexport const DEFAULT_REQUESTS_PER_SECOND = 10;\n\n/**\n * Default gas simulation multiplier. CosmJS defaults to 1.4 but billing module\n * transactions (close-lease in particular) can exceed that. 1.5 matches\n * the --gas-adjustment value used in this project's E2E scripts (e2e/scripts/init_billing.sh).\n */\nexport const DEFAULT_GAS_MULTIPLIER = 1.5;\n\n// Re-export for consumers\nexport { DEFAULT_RETRY_CONFIG };\n\n/**\n * Check if a hostname is localhost (IPv4, IPv6, or hostname)\n * Handles both bracketed and unbracketed IPv6 formats\n */\nfunction isLocalhostHostname(hostname: string): boolean {\n  if (hostname === 'localhost' || hostname === '127.0.0.1') {\n    return true;\n  }\n  // Handle IPv6 localhost - hostname may be '::1' or '[::1]' depending on environment\n  const normalizedHostname = hostname.replace(/^\\[|\\]$/g, '');\n  return normalizedHostname === '::1';\n}\n\n/**\n * Validate URL format and check if it uses HTTPS or is localhost (HTTP allowed for local dev)\n * Returns validation result with error reason if invalid\n */\nfunction validateEndpointUrl(\n  url: string,\n  label: string,\n): { valid: true } | { valid: false; reason: string } {\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return { valid: false, reason: `${label} must be a valid URL` };\n  }\n\n  if (parsed.protocol === 'https:') {\n    return { valid: true };\n  }\n\n  if (parsed.protocol === 'http:' && isLocalhostHostname(parsed.hostname)) {\n    return { valid: true }; // HTTP allowed for localhost\n  }\n\n  return {\n    valid: false,\n    reason: `${label} must use HTTPS (got ${parsed.protocol}//). HTTP is only allowed for local development (localhost, 127.0.0.1, ::1).`,\n  };\n}\n\n/**\n * Validate gas price format (e.g., \"1.0umfx\")\n */\nfunction isValidGasPrice(gasPrice: string): boolean {\n  // Gas price should be a number followed by a denomination.\n  // Denoms can be simple (umfx), IBC (ibc/ABC123...), or factory\n  // (factory/manifest1.../utoken). Denoms are made of non-empty segments\n  // separated by '/', with the first segment starting with a letter.\n  // Each segment may contain letters, digits, dots, colons, underscores,\n  // and hyphens. Denom length must be 3-128 chars per the Cosmos SDK spec.\n  const match = gasPrice.match(\n    /^(\\d+(?:\\.\\d+)?)([a-zA-Z][a-zA-Z0-9.:_-]*(?:\\/[a-zA-Z0-9.:_-]+)*)$/,\n  );\n  if (!match) {\n    return false;\n  }\n  const denom = match[2];\n  return denom.length >= 3 && denom.length <= 128;\n}\n\n/**\n * Validate chain ID format\n */\nfunction isValidChainId(chainId: string): boolean {\n  // Chain ID should be alphanumeric with hyphens\n  return /^[a-zA-Z0-9][\\w-]*$/.test(chainId);\n}\n\n/**\n * Create a configuration object with defaults applied\n */\nexport function createConfig(input: ManifestMCPConfig): ManifestMCPConfig {\n  return {\n    chainId: input.chainId,\n    rpcUrl: input.rpcUrl,\n    gasPrice: input.gasPrice,\n    restUrl: input.restUrl,\n    addressPrefix: input.addressPrefix ?? DEFAULT_ADDRESS_PREFIX,\n    rateLimit: {\n      requestsPerSecond:\n        input.rateLimit?.requestsPerSecond ?? DEFAULT_REQUESTS_PER_SECOND,\n    },\n    retry: {\n      maxRetries: input.retry?.maxRetries ?? DEFAULT_RETRY_CONFIG.maxRetries,\n      baseDelayMs: input.retry?.baseDelayMs ?? DEFAULT_RETRY_CONFIG.baseDelayMs,\n      maxDelayMs: input.retry?.maxDelayMs ?? DEFAULT_RETRY_CONFIG.maxDelayMs,\n    },\n    gasMultiplier: input.gasMultiplier ?? DEFAULT_GAS_MULTIPLIER,\n  };\n}\n\n/**\n * Validation result\n */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Validate a configuration object\n */\nexport function validateConfig(\n  config: Partial<ManifestMCPConfig>,\n): ValidationResult {\n  const errors: string[] = [];\n\n  // Required fields\n  if (!config.chainId) {\n    errors.push('chainId is required');\n  } else if (!isValidChainId(config.chainId)) {\n    errors.push(\n      'chainId must be alphanumeric with hyphens (e.g., \"manifest-ledger-testnet\")',\n    );\n  }\n\n  // At least one of rpcUrl or restUrl must be provided\n  if (!config.rpcUrl && !config.restUrl) {\n    errors.push('At least one of rpcUrl or restUrl is required');\n  }\n\n  if (config.rpcUrl) {\n    const urlCheck = validateEndpointUrl(config.rpcUrl, 'rpcUrl');\n    if (!urlCheck.valid) {\n      errors.push(urlCheck.reason);\n    }\n  }\n\n  if (config.restUrl) {\n    const urlCheck = validateEndpointUrl(config.restUrl, 'restUrl');\n    if (!urlCheck.valid) {\n      errors.push(urlCheck.reason);\n    }\n  }\n\n  // gasPrice required when rpcUrl is provided (needed for signing)\n  if (config.rpcUrl && !config.gasPrice) {\n    errors.push('gasPrice is required when rpcUrl is provided');\n  } else if (config.gasPrice && !isValidGasPrice(config.gasPrice)) {\n    errors.push(\n      'gasPrice must be a number followed by denomination (e.g., \"1.0umfx\", \"0.5factory/addr/udenom\", or \"0.25ibc/ABC123\")',\n    );\n  }\n\n  // Optional fields\n  if (config.addressPrefix !== undefined) {\n    if (!/^[a-z]+$/.test(config.addressPrefix)) {\n      errors.push('addressPrefix must be lowercase letters only');\n    }\n  }\n\n  if (config.rateLimit !== undefined) {\n    if (\n      typeof config.rateLimit !== 'object' ||\n      config.rateLimit === null ||\n      Array.isArray(config.rateLimit)\n    ) {\n      errors.push('rateLimit must be a plain object');\n    } else if (config.rateLimit.requestsPerSecond !== undefined) {\n      if (\n        typeof config.rateLimit.requestsPerSecond !== 'number' ||\n        config.rateLimit.requestsPerSecond <= 0 ||\n        !Number.isInteger(config.rateLimit.requestsPerSecond)\n      ) {\n        errors.push('rateLimit.requestsPerSecond must be a positive integer');\n      }\n    }\n  }\n\n  if (config.retry !== undefined) {\n    if (\n      typeof config.retry !== 'object' ||\n      config.retry === null ||\n      Array.isArray(config.retry)\n    ) {\n      errors.push('retry must be a plain object');\n    } else {\n      if (config.retry.maxRetries !== undefined) {\n        if (\n          typeof config.retry.maxRetries !== 'number' ||\n          config.retry.maxRetries < 0 ||\n          !Number.isInteger(config.retry.maxRetries)\n        ) {\n          errors.push('retry.maxRetries must be a non-negative integer');\n        }\n      }\n      if (config.retry.baseDelayMs !== undefined) {\n        if (\n          typeof config.retry.baseDelayMs !== 'number' ||\n          config.retry.baseDelayMs <= 0 ||\n          !Number.isInteger(config.retry.baseDelayMs)\n        ) {\n          errors.push('retry.baseDelayMs must be a positive integer');\n        }\n      }\n      if (config.retry.maxDelayMs !== undefined) {\n        if (\n          typeof config.retry.maxDelayMs !== 'number' ||\n          config.retry.maxDelayMs <= 0 ||\n          !Number.isInteger(config.retry.maxDelayMs)\n        ) {\n          errors.push('retry.maxDelayMs must be a positive integer');\n        }\n      }\n      // Validate maxDelayMs >= baseDelayMs if both are provided\n      if (\n        config.retry.baseDelayMs !== undefined &&\n        config.retry.maxDelayMs !== undefined &&\n        config.retry.maxDelayMs < config.retry.baseDelayMs\n      ) {\n        errors.push(\n          'retry.maxDelayMs must be greater than or equal to retry.baseDelayMs',\n        );\n      }\n    }\n  }\n\n  if (config.gasMultiplier !== undefined) {\n    if (\n      typeof config.gasMultiplier !== 'number' ||\n      !Number.isFinite(config.gasMultiplier) ||\n      config.gasMultiplier < 1\n    ) {\n      errors.push('gasMultiplier must be a finite number >= 1');\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Create and validate a configuration, throwing on invalid config\n */\nexport function createValidatedConfig(\n  input: ManifestMCPConfig,\n): ManifestMCPConfig {\n  const validation = validateConfig(input);\n\n  if (!validation.valid) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_CONFIG,\n      `Invalid configuration: ${validation.errors.join(', ')}`,\n      { errors: validation.errors },\n    );\n  }\n\n  return createConfig(input);\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { DEFAULT_RETRY_CONFIG } from './retry.js';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n} from './types.js';\n\n/**\n * Default address prefix for Manifest Network\n */\nconst DEFAULT_ADDRESS_PREFIX = 'manifest';\n\n/**\n * Default requests per second for rate limiting\n */\nexport const DEFAULT_REQUESTS_PER_SECOND = 10;\n\n/**\n * Default gas simulation multiplier. CosmJS defaults to 1.4 but billing module\n * transactions (close-lease in particular) can exceed that. 1.5 matches\n * the --gas-adjustment value used in this project's E2E scripts (e2e/scripts/init_billing.sh).\n */\nexport const DEFAULT_GAS_MULTIPLIER = 1.5;\n\n// Re-export for consumers\nexport { DEFAULT_RETRY_CONFIG };\n\n/**\n * Check if a hostname is localhost (IPv4, IPv6, or hostname)\n * Handles both bracketed and unbracketed IPv6 formats\n */\nfunction isLocalhostHostname(hostname: string): boolean {\n  if (hostname === 'localhost' || hostname === '127.0.0.1') {\n    return true;\n  }\n  // Handle IPv6 localhost - hostname may be '::1' or '[::1]' depending on environment\n  const normalizedHostname = hostname.replace(/^\\[|\\]$/g, '');\n  return normalizedHostname === '::1';\n}\n\n/**\n * Validate URL format and check if it uses HTTPS or is localhost (HTTP allowed for local dev)\n * Returns validation result with error reason if invalid\n */\nexport function validateEndpointUrl(\n  url: string,\n  label: string,\n): { valid: true } | { valid: false; reason: string } {\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return { valid: false, reason: `${label} must be a valid URL` };\n  }\n\n  if (parsed.protocol === 'https:') {\n    return { valid: true };\n  }\n\n  if (parsed.protocol === 'http:' && isLocalhostHostname(parsed.hostname)) {\n    return { valid: true }; // HTTP allowed for localhost\n  }\n\n  return {\n    valid: false,\n    reason: `${label} must use HTTPS (got ${parsed.protocol}//). HTTP is only allowed for local development (localhost, 127.0.0.1, ::1).`,\n  };\n}\n\n/**\n * Validate gas price format (e.g., \"1.0umfx\")\n */\nfunction isValidGasPrice(gasPrice: string): boolean {\n  // Gas price should be a number followed by a denomination.\n  // Denoms can be simple (umfx), IBC (ibc/ABC123...), or factory\n  // (factory/manifest1.../utoken). Denoms are made of non-empty segments\n  // separated by '/', with the first segment starting with a letter.\n  // Each segment may contain letters, digits, dots, colons, underscores,\n  // and hyphens. Denom length must be 3-128 chars per the Cosmos SDK spec.\n  const match = gasPrice.match(\n    /^(\\d+(?:\\.\\d+)?)([a-zA-Z][a-zA-Z0-9.:_-]*(?:\\/[a-zA-Z0-9.:_-]+)*)$/,\n  );\n  if (!match) {\n    return false;\n  }\n  const denom = match[2];\n  return denom.length >= 3 && denom.length <= 128;\n}\n\n/**\n * Validate chain ID format\n */\nfunction isValidChainId(chainId: string): boolean {\n  // Chain ID should be alphanumeric with hyphens\n  return /^[a-zA-Z0-9][\\w-]*$/.test(chainId);\n}\n\n/**\n * Create a configuration object with defaults applied\n */\nexport function createConfig(input: ManifestMCPConfig): ManifestMCPConfig {\n  return {\n    chainId: input.chainId,\n    rpcUrl: input.rpcUrl,\n    gasPrice: input.gasPrice,\n    restUrl: input.restUrl,\n    addressPrefix: input.addressPrefix ?? DEFAULT_ADDRESS_PREFIX,\n    rateLimit: {\n      requestsPerSecond:\n        input.rateLimit?.requestsPerSecond ?? DEFAULT_REQUESTS_PER_SECOND,\n    },\n    retry: {\n      maxRetries: input.retry?.maxRetries ?? DEFAULT_RETRY_CONFIG.maxRetries,\n      baseDelayMs: input.retry?.baseDelayMs ?? DEFAULT_RETRY_CONFIG.baseDelayMs,\n      maxDelayMs: input.retry?.maxDelayMs ?? DEFAULT_RETRY_CONFIG.maxDelayMs,\n    },\n    gasMultiplier: input.gasMultiplier ?? DEFAULT_GAS_MULTIPLIER,\n  };\n}\n\n/**\n * Validation result\n */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Validate a configuration object\n */\nexport function validateConfig(\n  config: Partial<ManifestMCPConfig>,\n): ValidationResult {\n  const errors: string[] = [];\n\n  // Required fields\n  if (!config.chainId) {\n    errors.push('chainId is required');\n  } else if (!isValidChainId(config.chainId)) {\n    errors.push(\n      'chainId must be alphanumeric with hyphens (e.g., \"manifest-ledger-testnet\")',\n    );\n  }\n\n  // At least one of rpcUrl or restUrl must be provided\n  if (!config.rpcUrl && !config.restUrl) {\n    errors.push('At least one of rpcUrl or restUrl is required');\n  }\n\n  if (config.rpcUrl) {\n    const urlCheck = validateEndpointUrl(config.rpcUrl, 'rpcUrl');\n    if (!urlCheck.valid) {\n      errors.push(urlCheck.reason);\n    }\n  }\n\n  if (config.restUrl) {\n    const urlCheck = validateEndpointUrl(config.restUrl, 'restUrl');\n    if (!urlCheck.valid) {\n      errors.push(urlCheck.reason);\n    }\n  }\n\n  // gasPrice required when rpcUrl is provided (needed for signing)\n  if (config.rpcUrl && !config.gasPrice) {\n    errors.push('gasPrice is required when rpcUrl is provided');\n  } else if (config.gasPrice && !isValidGasPrice(config.gasPrice)) {\n    errors.push(\n      'gasPrice must be a number followed by denomination (e.g., \"1.0umfx\", \"0.5factory/addr/udenom\", or \"0.25ibc/ABC123\")',\n    );\n  }\n\n  // Optional fields\n  if (config.addressPrefix !== undefined) {\n    if (!/^[a-z]+$/.test(config.addressPrefix)) {\n      errors.push('addressPrefix must be lowercase letters only');\n    }\n  }\n\n  if (config.rateLimit !== undefined) {\n    if (\n      typeof config.rateLimit !== 'object' ||\n      config.rateLimit === null ||\n      Array.isArray(config.rateLimit)\n    ) {\n      errors.push('rateLimit must be a plain object');\n    } else if (config.rateLimit.requestsPerSecond !== undefined) {\n      if (\n        typeof config.rateLimit.requestsPerSecond !== 'number' ||\n        config.rateLimit.requestsPerSecond <= 0 ||\n        !Number.isInteger(config.rateLimit.requestsPerSecond)\n      ) {\n        errors.push('rateLimit.requestsPerSecond must be a positive integer');\n      }\n    }\n  }\n\n  if (config.retry !== undefined) {\n    if (\n      typeof config.retry !== 'object' ||\n      config.retry === null ||\n      Array.isArray(config.retry)\n    ) {\n      errors.push('retry must be a plain object');\n    } else {\n      if (config.retry.maxRetries !== undefined) {\n        if (\n          typeof config.retry.maxRetries !== 'number' ||\n          config.retry.maxRetries < 0 ||\n          !Number.isInteger(config.retry.maxRetries)\n        ) {\n          errors.push('retry.maxRetries must be a non-negative integer');\n        }\n      }\n      if (config.retry.baseDelayMs !== undefined) {\n        if (\n          typeof config.retry.baseDelayMs !== 'number' ||\n          config.retry.baseDelayMs <= 0 ||\n          !Number.isInteger(config.retry.baseDelayMs)\n        ) {\n          errors.push('retry.baseDelayMs must be a positive integer');\n        }\n      }\n      if (config.retry.maxDelayMs !== undefined) {\n        if (\n          typeof config.retry.maxDelayMs !== 'number' ||\n          config.retry.maxDelayMs <= 0 ||\n          !Number.isInteger(config.retry.maxDelayMs)\n        ) {\n          errors.push('retry.maxDelayMs must be a positive integer');\n        }\n      }\n      // Validate maxDelayMs >= baseDelayMs if both are provided\n      if (\n        config.retry.baseDelayMs !== undefined &&\n        config.retry.maxDelayMs !== undefined &&\n        config.retry.maxDelayMs < config.retry.baseDelayMs\n      ) {\n        errors.push(\n          'retry.maxDelayMs must be greater than or equal to retry.baseDelayMs',\n        );\n      }\n    }\n  }\n\n  if (config.gasMultiplier !== undefined) {\n    if (\n      typeof config.gasMultiplier !== 'number' ||\n      !Number.isFinite(config.gasMultiplier) ||\n      config.gasMultiplier < 1\n    ) {\n      errors.push('gasMultiplier must be a finite number >= 1');\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Create and validate a configuration, throwing on invalid config\n */\nexport function createValidatedConfig(\n  input: ManifestMCPConfig,\n): ManifestMCPConfig {\n  const validation = validateConfig(input);\n\n  if (!validation.valid) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_CONFIG,\n      `Invalid configuration: ${validation.errors.join(', ')}`,\n      { errors: validation.errors },\n    );\n  }\n\n  return createConfig(input);\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { AccountInfo, AccountInfoResult, AddressBytesToStringResult, AddressStringToBytesResult, Any, AuthAccountResult, AuthAccountsResult, AuthParams, AuthParamsResult, AuthzGrant, AuthzGrantAuthorization, AuthzGranteeGrantsResult, AuthzGranterGrantsResult, AuthzGrantsResult, AvailableModules, BalanceResult, BalancesResult, BankMetadata, BankParams, BankParamsResult, BaseAccount, Bech32PrefixResult, BillingParams, BillingParamsResult, BuiltMessages, CodeInfoResponse, Coin, CommissionResult, CommunityPoolResult, ContractCodeHistoryEntry, ContractInfo, CosmosQueryResult, CosmosTxResult, CreditAccount, CreditAccountResult, CreditAccountsResult, CreditAddressResult, CreditEstimateResult, DecCoin, DelegationDelegatorReward, DelegationResponse, DelegationResult, DelegationsResult, DelegatorValidatorsResult, DelegatorWithdrawAddressResult, DenomAuthorityMetadata, DenomAuthorityMetadataResult, DenomMetadataResult, DenomTrace, DenomsFromAdminResult, DenomsFromCreatorResult, DenomsMetadataResult, DepositParams, DepositResult, DepositsResult, DistributionParams, DistributionParamsResult, FeeEstimateResult, FeegrantAllowanceResult, FeegrantAllowancesResult, FeegrantGrant, GovDeposit, GovParams, GovParamsResult, GovProposal, GovTallyResult, GovVote, GroupInfo, GroupInfoResult, GroupMember, GroupMembersResult, GroupPoliciesResult, GroupPolicyInfo, GroupPolicyInfoResult, GroupProposal, GroupProposalResult, GroupProposalsResult, GroupTallyQueryResult, GroupTallyResult, GroupVote, GroupVoteResult, GroupVotesResult, GroupsResult, HistoricalInfo, HistoricalInfoResult, IbcDenomTraceResult, IbcDenomTracesResult, IbcTransferParams, IbcTransferParamsResult, Lease, LeaseByCustomDomainResult, LeaseItemInput, LeaseResult, LeasesResult, ManifestMCPConfig, ManifestMCPError, ManifestMCPErrorCode, MintAnnualProvisionsResult, MintInflationResult, MintParams, MintParamsResult, Model, ModuleAccount, ModuleAccountsResult, ModuleInfo, PaginatedResult, PaginationResponse, PoAAuthorityResult, PoAConsensusPowerResult, PoAPendingValidatorsResult, PoAStakingParams, PoAValidator, ProposalResult, ProposalsResult, Provider, ProviderResult, ProviderWithdrawableResult, ProvidersResult, QueryCreditEstimateResponse, QueryResult, RateLimitConfig, RedelegationResponse, RedelegationsResult, RetryConfig, RewardsResult, SKU, SendEnabled, SendEnabledResult, SignArbitraryResult, SkuParams, SkuParamsResult, SkuResult, SkusResult, SlashesResult, StakingParams, StakingParamsResult, StakingPool, StakingPoolResult, SupplyOfResult, TallyParams, TallyResult, TokenfactoryParams, TokenfactoryParamsResult, TotalSupplyResult, TxBuildContext, TxOptions, TxOverrides, UnbondingDelegation, UnbondingDelegationResult, UnbondingDelegationsResult, Validator, ValidatorAccumulatedCommission, ValidatorOutstandingRewards, ValidatorOutstandingRewardsResult, ValidatorResult, ValidatorSlashEvent, ValidatorsResult, VoteResult, VotesResult, VotingParams, WalletProvider, WasmAllContractStateResult, WasmBuildAddressResult, WasmCodeInfo, WasmCodeInfoResult, WasmCodeResult, WasmCodesResult, WasmContractHistoryResult, WasmContractInfoResult, WasmContractsByCodeResult, WasmContractsByCreatorResult, WasmLimitsConfigResult, WasmParams, WasmParamsResult, WasmPinnedCodesResult, WasmRawContractStateResult, WasmSmartContractStateResult, WithdrawableAmountResult } from "./types.js";
 import { CosmosClientManager, ManifestQueryClient } from "./client.js";
 import { DEFAULT_RETRY_CONFIG, RetryOptions, calculateBackoff, isRetryableError, withRetry } from "./retry.js";
-import { ValidationResult, createConfig, createValidatedConfig, validateConfig } from "./config.js";
+import { ValidationResult, createConfig, createValidatedConfig, validateConfig, validateEndpointUrl } from "./config.js";
 import { cosmosEstimateFee, cosmosQuery, cosmosTx } from "./cosmos.js";
 import { createLCDQueryClient } from "./lcd-adapter.js";
 import { LogLevel, logger, parseLogLevel } from "./logger.js";
@@ -19,4 +19,4 @@ import { VERSION } from "./version.js";
 import { MnemonicWalletProvider } from "./wallet/mnemonic.js";
 import { signArbitraryWithAmino } from "./wallet/sign-arbitrary.js";
 import { LeaseState, leaseStateFromJSON, leaseStateToJSON } from "@manifest-network/manifestjs/dist/codegen/liftedinit/billing/v1/types.js";
-export { AccountInfo, AccountInfoResult, AddressBytesToStringResult, AddressStringToBytesResult, Any, AuthAccountResult, AuthAccountsResult, AuthParams, AuthParamsResult, AuthzGrant, AuthzGrantAuthorization, AuthzGranteeGrantsResult, AuthzGranterGrantsResult, AuthzGrantsResult, AvailableModules, BalanceResult, BalancesResult, BankMetadata, BankParams, BankParamsResult, BaseAccount, Bech32PrefixResult, BillingParams, BillingParamsResult, BuiltMessages, CodeInfoResponse, Coin, CommissionResult, CommunityPoolResult, ContractCodeHistoryEntry, ContractInfo, CosmosClientManager, CosmosQueryResult, CosmosTxResult, CreditAccount, CreditAccountResult, CreditAccountsResult, CreditAddressResult, CreditEstimateResult, DEFAULT_RETRY_CONFIG, DNS_LABEL_RE, DecCoin, DelegationDelegatorReward, DelegationResponse, DelegationResult, DelegationsResult, DelegatorValidatorsResult, DelegatorWithdrawAddressResult, DenomAuthorityMetadata, DenomAuthorityMetadataResult, DenomMetadataResult, DenomTrace, DenomsFromAdminResult, DenomsFromCreatorResult, DenomsMetadataResult, DepositParams, DepositResult, DepositsResult, DistributionParams, DistributionParamsResult, FeeEstimateResult, FeegrantAllowanceResult, FeegrantAllowancesResult, FeegrantGrant, type FundCreditsResult, GovDeposit, GovParams, GovParamsResult, GovProposal, GovTallyResult, GovVote, GroupInfo, GroupInfoResult, GroupMember, GroupMembersResult, GroupPoliciesResult, GroupPolicyInfo, GroupPolicyInfoResult, GroupProposal, GroupProposalResult, GroupProposalsResult, GroupTallyQueryResult, GroupTallyResult, GroupVote, GroupVoteResult, GroupVotesResult, GroupsResult, HistoricalInfo, HistoricalInfoResult, INFRASTRUCTURE_ERROR_CODES, IbcDenomTraceResult, IbcDenomTracesResult, IbcTransferParams, IbcTransferParamsResult, Lease, LeaseByCustomDomainResult, LeaseItemInput, LeaseResult, LeaseState, LeasesResult, type LogLevel, MANIFEST_TOOL_META_VERSION, MAX_PAGE_LIMIT, ManifestMCPConfig, ManifestMCPError, ManifestMCPErrorCode, type ManifestMCPServerOptions, type ManifestQueryClient, type ManifestToolMeta, type ManifestToolMetaContainer, type ManifestToolMetaVersion, MintAnnualProvisionsResult, MintInflationResult, MintParams, MintParamsResult, type MnemonicServerConfig, MnemonicWalletProvider, Model, ModuleAccount, ModuleAccountsResult, ModuleInfo, PaginatedResult, PaginationResponse, PoAAuthorityResult, PoAConsensusPowerResult, PoAPendingValidatorsResult, PoAStakingParams, PoAValidator, ProposalResult, ProposalsResult, Provider, ProviderResult, ProviderWithdrawableResult, ProvidersResult, QueryCreditEstimateResponse, QueryResult, RateLimitConfig, RedelegationResponse, RedelegationsResult, RetryConfig, type RetryOptions, RewardsResult, SENSITIVE_FIELDS, SKU, SendEnabled, SendEnabledResult, type SetItemCustomDomainOptions, type SetItemCustomDomainResult, SignArbitraryResult, SkuParams, SkuParamsResult, SkuResult, SkusResult, SlashesResult, StakingParams, StakingParamsResult, StakingPool, StakingPoolResult, type StopAppResult, SupplyOfResult, TallyParams, TallyResult, TokenfactoryParams, TokenfactoryParamsResult, TotalSupplyResult, TxBuildContext, TxOptions, TxOverrides, UnbondingDelegation, UnbondingDelegationResult, UnbondingDelegationsResult, VERSION, type ValidationResult, Validator, ValidatorAccumulatedCommission, ValidatorOutstandingRewards, ValidatorOutstandingRewardsResult, ValidatorResult, ValidatorSlashEvent, ValidatorsResult, VoteResult, VotesResult, VotingParams, WalletProvider, WasmAllContractStateResult, WasmBuildAddressResult, WasmCodeInfo, WasmCodeInfoResult, WasmCodeResult, WasmCodesResult, WasmContractHistoryResult, WasmContractInfoResult, WasmContractsByCodeResult, WasmContractsByCreatorResult, WasmLimitsConfigResult, WasmParams, WasmParamsResult, WasmPinnedCodesResult, WasmRawContractStateResult, WasmSmartContractStateResult, WithdrawableAmountResult, bigIntReplacer, calculateBackoff, cosmosEstimateFee, cosmosQuery, cosmosTx, createConfig, createLCDQueryClient, createMnemonicServer, createPagination, createValidatedConfig, fundCredits, getAvailableModules, getBalance, getModuleSubcommands, getSubcommandUsage, getSupportedModules, isRetryableError, isSubcommandSupported, jsonResponse, leaseStateFromJSON, leaseStateToJSON, logger, manifestMeta, mutatingAnnotations, optionalBoolean, parseArgs, parseLogLevel, readOnlyAnnotations, requireString, requireStringEnum, requireUuid, sanitizeForLogging, setItemCustomDomain, signArbitraryWithAmino, stopApp, structuredResponse, validateAddress, validateConfig, withErrorHandling, withRetry };
+export { AccountInfo, AccountInfoResult, AddressBytesToStringResult, AddressStringToBytesResult, Any, AuthAccountResult, AuthAccountsResult, AuthParams, AuthParamsResult, AuthzGrant, AuthzGrantAuthorization, AuthzGranteeGrantsResult, AuthzGranterGrantsResult, AuthzGrantsResult, AvailableModules, BalanceResult, BalancesResult, BankMetadata, BankParams, BankParamsResult, BaseAccount, Bech32PrefixResult, BillingParams, BillingParamsResult, BuiltMessages, CodeInfoResponse, Coin, CommissionResult, CommunityPoolResult, ContractCodeHistoryEntry, ContractInfo, CosmosClientManager, CosmosQueryResult, CosmosTxResult, CreditAccount, CreditAccountResult, CreditAccountsResult, CreditAddressResult, CreditEstimateResult, DEFAULT_RETRY_CONFIG, DNS_LABEL_RE, DecCoin, DelegationDelegatorReward, DelegationResponse, DelegationResult, DelegationsResult, DelegatorValidatorsResult, DelegatorWithdrawAddressResult, DenomAuthorityMetadata, DenomAuthorityMetadataResult, DenomMetadataResult, DenomTrace, DenomsFromAdminResult, DenomsFromCreatorResult, DenomsMetadataResult, DepositParams, DepositResult, DepositsResult, DistributionParams, DistributionParamsResult, FeeEstimateResult, FeegrantAllowanceResult, FeegrantAllowancesResult, FeegrantGrant, type FundCreditsResult, GovDeposit, GovParams, GovParamsResult, GovProposal, GovTallyResult, GovVote, GroupInfo, GroupInfoResult, GroupMember, GroupMembersResult, GroupPoliciesResult, GroupPolicyInfo, GroupPolicyInfoResult, GroupProposal, GroupProposalResult, GroupProposalsResult, GroupTallyQueryResult, GroupTallyResult, GroupVote, GroupVoteResult, GroupVotesResult, GroupsResult, HistoricalInfo, HistoricalInfoResult, INFRASTRUCTURE_ERROR_CODES, IbcDenomTraceResult, IbcDenomTracesResult, IbcTransferParams, IbcTransferParamsResult, Lease, LeaseByCustomDomainResult, LeaseItemInput, LeaseResult, LeaseState, LeasesResult, type LogLevel, MANIFEST_TOOL_META_VERSION, MAX_PAGE_LIMIT, ManifestMCPConfig, ManifestMCPError, ManifestMCPErrorCode, type ManifestMCPServerOptions, type ManifestQueryClient, type ManifestToolMeta, type ManifestToolMetaContainer, type ManifestToolMetaVersion, MintAnnualProvisionsResult, MintInflationResult, MintParams, MintParamsResult, type MnemonicServerConfig, MnemonicWalletProvider, Model, ModuleAccount, ModuleAccountsResult, ModuleInfo, PaginatedResult, PaginationResponse, PoAAuthorityResult, PoAConsensusPowerResult, PoAPendingValidatorsResult, PoAStakingParams, PoAValidator, ProposalResult, ProposalsResult, Provider, ProviderResult, ProviderWithdrawableResult, ProvidersResult, QueryCreditEstimateResponse, QueryResult, RateLimitConfig, RedelegationResponse, RedelegationsResult, RetryConfig, type RetryOptions, RewardsResult, SENSITIVE_FIELDS, SKU, SendEnabled, SendEnabledResult, type SetItemCustomDomainOptions, type SetItemCustomDomainResult, SignArbitraryResult, SkuParams, SkuParamsResult, SkuResult, SkusResult, SlashesResult, StakingParams, StakingParamsResult, StakingPool, StakingPoolResult, type StopAppResult, SupplyOfResult, TallyParams, TallyResult, TokenfactoryParams, TokenfactoryParamsResult, TotalSupplyResult, TxBuildContext, TxOptions, TxOverrides, UnbondingDelegation, UnbondingDelegationResult, UnbondingDelegationsResult, VERSION, type ValidationResult, Validator, ValidatorAccumulatedCommission, ValidatorOutstandingRewards, ValidatorOutstandingRewardsResult, ValidatorResult, ValidatorSlashEvent, ValidatorsResult, VoteResult, VotesResult, VotingParams, WalletProvider, WasmAllContractStateResult, WasmBuildAddressResult, WasmCodeInfo, WasmCodeInfoResult, WasmCodeResult, WasmCodesResult, WasmContractHistoryResult, WasmContractInfoResult, WasmContractsByCodeResult, WasmContractsByCreatorResult, WasmLimitsConfigResult, WasmParams, WasmParamsResult, WasmPinnedCodesResult, WasmRawContractStateResult, WasmSmartContractStateResult, WithdrawableAmountResult, bigIntReplacer, calculateBackoff, cosmosEstimateFee, cosmosQuery, cosmosTx, createConfig, createLCDQueryClient, createMnemonicServer, createPagination, createValidatedConfig, fundCredits, getAvailableModules, getBalance, getModuleSubcommands, getSubcommandUsage, getSupportedModules, isRetryableError, isSubcommandSupported, jsonResponse, leaseStateFromJSON, leaseStateToJSON, logger, manifestMeta, mutatingAnnotations, optionalBoolean, parseArgs, parseLogLevel, readOnlyAnnotations, requireString, requireStringEnum, requireUuid, sanitizeForLogging, setItemCustomDomain, signArbitraryWithAmino, stopApp, structuredResponse, validateAddress, validateConfig, validateEndpointUrl, withErrorHandling, withRetry };

package/dist/index.js

@@ -1,6 +1,6 @@
 import { ManifestMCPError, ManifestMCPErrorCode } from "./types.js";
 import { DEFAULT_RETRY_CONFIG, calculateBackoff, isRetryableError, withRetry } from "./retry.js";
-import { createConfig, createValidatedConfig, validateConfig } from "./config.js";
+import { createConfig, createValidatedConfig, validateConfig, validateEndpointUrl } from "./config.js";
 import { logger, parseLogLevel } from "./logger.js";
 import { createLCDQueryClient } from "./lcd-adapter.js";
 import { CosmosClientManager } from "./client.js";
@@ -20,4 +20,4 @@ import { setItemCustomDomain } from "./tools/setItemCustomDomain.js";
 import { stopApp } from "./tools/stopApp.js";
 import { VERSION } from "./version.js";
 import { LeaseState, leaseStateFromJSON, leaseStateToJSON } from "@manifest-network/manifestjs/dist/codegen/liftedinit/billing/v1/types.js";
-export { CosmosClientManager, DEFAULT_RETRY_CONFIG, DNS_LABEL_RE, INFRASTRUCTURE_ERROR_CODES, LeaseState, MANIFEST_TOOL_META_VERSION, MAX_PAGE_LIMIT, ManifestMCPError, ManifestMCPErrorCode, MnemonicWalletProvider, SENSITIVE_FIELDS, VERSION, bigIntReplacer, calculateBackoff, cosmosEstimateFee, cosmosQuery, cosmosTx, createConfig, createLCDQueryClient, createMnemonicServer, createPagination, createValidatedConfig, fundCredits, getAvailableModules, getBalance, getModuleSubcommands, getSubcommandUsage, getSupportedModules, isRetryableError, isSubcommandSupported, jsonResponse, leaseStateFromJSON, leaseStateToJSON, logger, manifestMeta, mutatingAnnotations, optionalBoolean, parseArgs, parseLogLevel, readOnlyAnnotations, requireString, requireStringEnum, requireUuid, sanitizeForLogging, setItemCustomDomain, signArbitraryWithAmino, stopApp, structuredResponse, validateAddress, validateConfig, withErrorHandling, withRetry };
+export { CosmosClientManager, DEFAULT_RETRY_CONFIG, DNS_LABEL_RE, INFRASTRUCTURE_ERROR_CODES, LeaseState, MANIFEST_TOOL_META_VERSION, MAX_PAGE_LIMIT, ManifestMCPError, ManifestMCPErrorCode, MnemonicWalletProvider, SENSITIVE_FIELDS, VERSION, bigIntReplacer, calculateBackoff, cosmosEstimateFee, cosmosQuery, cosmosTx, createConfig, createLCDQueryClient, createMnemonicServer, createPagination, createValidatedConfig, fundCredits, getAvailableModules, getBalance, getModuleSubcommands, getSubcommandUsage, getSupportedModules, isRetryableError, isSubcommandSupported, jsonResponse, leaseStateFromJSON, leaseStateToJSON, logger, manifestMeta, mutatingAnnotations, optionalBoolean, parseArgs, parseLogLevel, readOnlyAnnotations, requireString, requireStringEnum, requireUuid, sanitizeForLogging, setItemCustomDomain, signArbitraryWithAmino, stopApp, structuredResponse, validateAddress, validateConfig, validateEndpointUrl, withErrorHandling, withRetry };

package/dist/server-utils.d.ts

@@ -43,7 +43,9 @@ declare function jsonResponse(data: unknown, replacer?: (key: string, value: any
  * (consumed by clients that validate against the tool's outputSchema) and
  * `content` (text fallback for clients that don't). Use this for any tool
  * registered with an `outputSchema`. Per MCP spec, `structuredContent` must
- * be a JSON object — `data` is therefore typed as a record.
+ * be a JSON object — `data` is typed as `unknown` so callers don't need to
+ * widen typed result interfaces with double-casts; the runtime contract
+ * (object-shaped after JSON round-trip) is enforced below.
  *
  * The optional `replacer` is applied to BOTH `structuredContent` and the
  * text fallback by round-tripping through JSON. This keeps `structuredContent`
@@ -51,7 +53,7 @@ declare function jsonResponse(data: unknown, replacer?: (key: string, value: any
  * `Date`, or anything else `JSON.stringify` knows how to convert via the
  * replacer.
  */
-declare function structuredResponse(data: Record<string, unknown>, replacer?: (key: string, value: any) => any): CallToolResult;
+declare function structuredResponse(data: unknown, replacer?: (key: string, value: any) => any): CallToolResult;
 /**
  * Config shape accepted by createMnemonicServer.
  * Derives from ManifestMCPConfig (minus rateLimit/retry) so new config fields propagate automatically.

package/dist/server-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-utils.d.ts","names":[],"sources":["../src/server-utils.ts"],"mappings":";;;;;;AAgBA;;;cAAa,0BAAA,EAA4B,WAAA,CAAY,oBAAA;;AAYrD;;cAAa,gBAAA,EAAkB,WAAA;;;AAwB/B;iBAAgB,cAAA,CAAe,IAAA,UAAc,KAAA;;;;iBAO7B,kBAAA,CAAmB,GAAA,WAAc,KAAA;;;;UAgDhC,wBAAA;EACf,MAAA,EAAQ,iBAAA;EACR,cAAA,EAAgB,cAAA;AAAA;;;;;;;iBAUF,iBAAA,eACA,IAAA,YAAgB,OAAA,CAAQ,cAAA,EAAA,CACtC,QAAA,UAAkB,EAAA,EAAI,CAAA,GAAI,CAAA;AAF5B;;;AAAA,iBAoFgB,YAAA,CACd,IAAA,WACA,QAAA,IAAY,GAAA,UAAa,KAAA,gBACxB,cAAA;;;;;;;;;;;;;;iBAwBa,kBAAA,CAEd,IAAA,EAAM,MAAA,mBACN,QAAA,IAAY,GAAA,UAAa,KAAA,gBACxB,cAAA;;AA/BH;;;KAiDY,oBAAA,GAAuB,IAAA,CACjC,iBAAA;EAAA,SAGS,QAAA;AAAA;;;;;;AA1BX;iBAmCsB,oBAAA,GAAA,CACpB,MAAA,EAAQ,oBAAA,EACR,WAAA,OAAkB,IAAA,EAAM,wBAAA,KAA6B,CAAA,GACpD,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"server-utils.d.ts","names":[],"sources":["../src/server-utils.ts"],"mappings":";;;;;;AAgBA;;;cAAa,0BAAA,EAA4B,WAAA,CAAY,oBAAA;;AAYrD;;cAAa,gBAAA,EAAkB,WAAA;;;AAwB/B;iBAAgB,cAAA,CAAe,IAAA,UAAc,KAAA;;;;iBAO7B,kBAAA,CAAmB,GAAA,WAAc,KAAA;;;;UAgDhC,wBAAA;EACf,MAAA,EAAQ,iBAAA;EACR,cAAA,EAAgB,cAAA;AAAA;;;;;;;iBAUF,iBAAA,eACA,IAAA,YAAgB,OAAA,CAAQ,cAAA,EAAA,CACtC,QAAA,UAAkB,EAAA,EAAI,CAAA,GAAI,CAAA;AAF5B;;;AAAA,iBAuFgB,YAAA,CACd,IAAA,WACA,QAAA,IAAY,GAAA,UAAa,KAAA,gBACxB,cAAA;;;;;;;;;;;;;;;;iBA0Ba,kBAAA,CACd,IAAA,WAEA,QAAA,IAAY,GAAA,UAAa,KAAA,gBACxB,cAAA;;;;;KAkBS,oBAAA,GAAuB,IAAA,CACjC,iBAAA;EAAA,SAGS,QAAA;AAAA;;;;AA1BX;;;iBAmCsB,oBAAA,GAAA,CACpB,MAAA,EAAQ,oBAAA,EACR,WAAA,OAAkB,IAAA,EAAM,wBAAA,KAA6B,CAAA,GACpD,OAAA,CAAQ,CAAA"}

package/dist/server-utils.js

@@ -82,12 +82,14 @@ function withErrorHandling(toolName, fn) {
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			const errorCode = error instanceof ManifestMCPError ? error.code : "UNKNOWN";
-			if (error instanceof ManifestMCPError) logger.error(`[${toolName}] Tool error [${errorCode}]: ${errorMessage}`);
+			const safeMessage = sanitizeForLogging(errorMessage);
+			const messageWasRedacted = safeMessage !== errorMessage;
+			if (error instanceof ManifestMCPError) logger.error(`[${toolName}] Tool error [${errorCode}]: ${safeMessage}`);
 			else {
-				const stack = error instanceof Error && error.stack ? `\n${error.stack}` : "";
-				logger.error(`[${toolName}] Tool error [${errorCode}]: ${errorMessage}${stack}`);
+				let stackSuffix = "";
+				if (!messageWasRedacted && error instanceof Error && error.stack) stackSuffix = `\n${sanitizeForLogging(error.stack)}`;
+				logger.error(`[${toolName}] Tool error [${errorCode}]: ${safeMessage}${stackSuffix}`);
 			}
-			const safeMessage = sanitizeForLogging(errorMessage);
 			let errorResponse = {
 				error: true,
 				tool: toolName,
@@ -139,7 +141,9 @@ function jsonResponse(data, replacer) {
 * (consumed by clients that validate against the tool's outputSchema) and
 * `content` (text fallback for clients that don't). Use this for any tool
 * registered with an `outputSchema`. Per MCP spec, `structuredContent` must
-* be a JSON object — `data` is therefore typed as a record.
+* be a JSON object — `data` is typed as `unknown` so callers don't need to
+* widen typed result interfaces with double-casts; the runtime contract
+* (object-shaped after JSON round-trip) is enforced below.
 *
 * The optional `replacer` is applied to BOTH `structuredContent` and the
 * text fallback by round-tripping through JSON. This keeps `structuredContent`

package/dist/server-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-utils.js","names":[],"sources":["../src/server-utils.ts"],"sourcesContent":["import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { createValidatedConfig } from './config.js';\nimport { logger } from './logger.js';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type WalletProvider,\n} from './types.js';\nimport { MnemonicWalletProvider } from './wallet/index.js';\n\n/**\n * Error codes that indicate infrastructure-level failures (wallet, RPC, config).\n * Used by tool implementations to distinguish infrastructure errors from\n * provider/application errors so that infrastructure errors are always re-thrown.\n */\nexport const INFRASTRUCTURE_ERROR_CODES: ReadonlySet<ManifestMCPErrorCode> =\n  new Set([\n    ManifestMCPErrorCode.WALLET_NOT_CONNECTED,\n    ManifestMCPErrorCode.WALLET_CONNECTION_FAILED,\n    ManifestMCPErrorCode.RPC_CONNECTION_FAILED,\n    ManifestMCPErrorCode.INVALID_MNEMONIC,\n    ManifestMCPErrorCode.INVALID_CONFIG,\n  ]);\n\n/**\n * Sensitive field names that should be redacted from error responses\n */\nexport const SENSITIVE_FIELDS: ReadonlySet<string> = new Set([\n  'mnemonic',\n  'privatekey',\n  'private_key',\n  'secret',\n  'password',\n  'seed',\n  'secret_key',\n  'signing_key',\n  'apikey',\n  'api_key',\n  'auth_token',\n  'bearer_token',\n  'access_token',\n  'refresh_token',\n]);\n\n// Note: standalone \"key\" and \"token\" are intentionally excluded from SENSITIVE_FIELDS\n// because they are too generic — they would match pagination keys, map keys, and\n// non-sensitive token identifiers. Use compound names (api_key, auth_token, etc.) instead.\n\n/**\n * JSON replacer that converts BigInt values to strings\n */\nexport function bigIntReplacer(_key: string, value: unknown): unknown {\n  return typeof value === 'bigint' ? value.toString() : value;\n}\n\n/**\n * Recursively sanitize an object by redacting sensitive fields\n */\nexport function sanitizeForLogging(obj: unknown, depth = 0): unknown {\n  // Prevent infinite recursion\n  if (depth > 10) {\n    return '[max depth exceeded]';\n  }\n\n  if (obj === null || obj === undefined) {\n    return obj;\n  }\n\n  if (typeof obj === 'string') {\n    // Redact strings that look like BIP-39 mnemonics (12/15/18/21/24 words).\n    // BIP-39 words are all lowercase alphabetic, so require that to avoid\n    // false positives on error messages that happen to be 12/24 words.\n    const words = obj.trim().split(/\\s+/);\n    const wordCount = words.length;\n    if (wordCount >= 12 && wordCount <= 24 && wordCount % 3 === 0) {\n      const allLowercaseAlpha = words.every((w) => /^[a-z]+$/.test(w));\n      if (allLowercaseAlpha) {\n        return '[REDACTED - possible mnemonic]';\n      }\n    }\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => sanitizeForLogging(item, depth + 1));\n  }\n\n  if (typeof obj === 'object') {\n    const sanitized: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      const lowerKey = key.toLowerCase();\n      if (SENSITIVE_FIELDS.has(lowerKey)) {\n        sanitized[key] = '[REDACTED]';\n      } else {\n        sanitized[key] = sanitizeForLogging(value, depth + 1);\n      }\n    }\n    return sanitized;\n  }\n\n  return obj;\n}\n\n/**\n * Options for creating a chain, lease, or fred MCP server\n */\nexport interface ManifestMCPServerOptions {\n  config: ManifestMCPConfig;\n  walletProvider: WalletProvider;\n}\n\n/**\n * Wrap a tool handler with error handling that preserves the existing error format.\n *\n * Generic over the callback type so that Zod-inferred argument types from\n * McpServer.registerTool flow through without requiring manual casts.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- preserves ToolCallback<Args> signature from McpServer\nexport function withErrorHandling<\n  T extends (...args: any[]) => Promise<CallToolResult>,\n>(toolName: string, fn: T): T {\n  // For tools with no inputSchema, McpServer calls cb(extra) with one arg.\n  // For tools with inputSchema, McpServer calls cb(parsedArgs, extra).\n  // We infer from cbArgs.length at call time (not fn.length) so default parameters are safe.\n  const wrapped = async (...cbArgs: any[]) => {\n    const hasArgs = cbArgs.length >= 2;\n    const args = hasArgs ? (cbArgs[0] ?? {}) : {};\n    try {\n      return hasArgs ? await fn(args, cbArgs[1]) : await fn(cbArgs[0]);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      const errorCode =\n        error instanceof ManifestMCPError ? error.code : 'UNKNOWN';\n      if (error instanceof ManifestMCPError) {\n        logger.error(\n          `[${toolName}] Tool error [${errorCode}]: ${errorMessage}`,\n        );\n      } else {\n        const stack =\n          error instanceof Error && error.stack ? `\\n${error.stack}` : '';\n        logger.error(\n          `[${toolName}] Tool error [${errorCode}]: ${errorMessage}${stack}`,\n        );\n      }\n\n      // Sanitize error messages before including in the MCP response.\n      // This catches mnemonic-like strings in error messages and redacts them.\n      const safeMessage = sanitizeForLogging(errorMessage) as string;\n\n      let errorResponse: Record<string, unknown> = {\n        error: true,\n        tool: toolName,\n        input: sanitizeForLogging(args),\n      };\n\n      if (error instanceof ManifestMCPError) {\n        errorResponse = {\n          ...errorResponse,\n          code: error.code,\n          message: sanitizeForLogging(error.message) as string,\n          details: sanitizeForLogging(error.details),\n        };\n      } else {\n        errorResponse = {\n          ...errorResponse,\n          message: safeMessage,\n        };\n      }\n\n      let responseText: string;\n      try {\n        responseText = JSON.stringify(errorResponse, bigIntReplacer, 2);\n      } catch (stringifyError) {\n        logger.error(\n          `[${toolName}] Failed to serialize error response: ${stringifyError instanceof Error ? stringifyError.message : String(stringifyError)}`,\n        );\n        responseText = JSON.stringify({\n          error: true,\n          tool: toolName,\n          message: safeMessage,\n        });\n      }\n\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: responseText,\n          },\n        ],\n        isError: true,\n      };\n    }\n  };\n  return wrapped as T;\n}\n\n/**\n * Helper to build a successful JSON text response\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- matches JSON.stringify's replacer signature\nexport function jsonResponse(\n  data: unknown,\n  replacer?: (key: string, value: any) => any,\n): CallToolResult {\n  return {\n    content: [\n      {\n        type: 'text' as const,\n        text: JSON.stringify(data, replacer, 2),\n      },\n    ],\n  };\n}\n\n/**\n * Helper to build a successful CallToolResult with both `structuredContent`\n * (consumed by clients that validate against the tool's outputSchema) and\n * `content` (text fallback for clients that don't). Use this for any tool\n * registered with an `outputSchema`. Per MCP spec, `structuredContent` must\n * be a JSON object — `data` is therefore typed as a record.\n *\n * The optional `replacer` is applied to BOTH `structuredContent` and the\n * text fallback by round-tripping through JSON. This keeps `structuredContent`\n * JSON-serializable for the wire, even if the caller hands us a `BigInt`,\n * `Date`, or anything else `JSON.stringify` knows how to convert via the\n * replacer.\n */\nexport function structuredResponse(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- matches JSON.stringify's replacer signature\n  data: Record<string, unknown>,\n  replacer?: (key: string, value: any) => any,\n): CallToolResult {\n  const serialized = JSON.stringify(data, replacer);\n  const structuredContent = JSON.parse(serialized) as Record<string, unknown>;\n  return {\n    structuredContent,\n    content: [\n      {\n        type: 'text' as const,\n        text: JSON.stringify(structuredContent, undefined, 2),\n      },\n    ],\n  };\n}\n\n/**\n * Config shape accepted by createMnemonicServer.\n * Derives from ManifestMCPConfig (minus rateLimit/retry) so new config fields propagate automatically.\n */\nexport type MnemonicServerConfig = Omit<\n  ManifestMCPConfig,\n  'rateLimit' | 'retry'\n> & {\n  readonly mnemonic: string;\n};\n\n/**\n * Generic factory that creates any MCP server class with a mnemonic wallet.\n *\n * Eliminates duplicated createMnemonic*Server patterns -- callers pass the\n * server constructor instead.\n */\nexport async function createMnemonicServer<T>(\n  config: MnemonicServerConfig,\n  ServerClass: new (opts: ManifestMCPServerOptions) => T,\n): Promise<T> {\n  const { mnemonic, ...mcpConfig } = config;\n  const validatedConfig = createValidatedConfig(mcpConfig);\n  const walletProvider = new MnemonicWalletProvider(validatedConfig, mnemonic);\n  await walletProvider.connect();\n\n  return new ServerClass({\n    config: validatedConfig,\n    walletProvider,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"server-utils.js","names":[],"sources":["../src/server-utils.ts"],"sourcesContent":["import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { createValidatedConfig } from './config.js';\nimport { logger } from './logger.js';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type WalletProvider,\n} from './types.js';\nimport { MnemonicWalletProvider } from './wallet/index.js';\n\n/**\n * Error codes that indicate infrastructure-level failures (wallet, RPC, config).\n * Used by tool implementations to distinguish infrastructure errors from\n * provider/application errors so that infrastructure errors are always re-thrown.\n */\nexport const INFRASTRUCTURE_ERROR_CODES: ReadonlySet<ManifestMCPErrorCode> =\n  new Set([\n    ManifestMCPErrorCode.WALLET_NOT_CONNECTED,\n    ManifestMCPErrorCode.WALLET_CONNECTION_FAILED,\n    ManifestMCPErrorCode.RPC_CONNECTION_FAILED,\n    ManifestMCPErrorCode.INVALID_MNEMONIC,\n    ManifestMCPErrorCode.INVALID_CONFIG,\n  ]);\n\n/**\n * Sensitive field names that should be redacted from error responses\n */\nexport const SENSITIVE_FIELDS: ReadonlySet<string> = new Set([\n  'mnemonic',\n  'privatekey',\n  'private_key',\n  'secret',\n  'password',\n  'seed',\n  'secret_key',\n  'signing_key',\n  'apikey',\n  'api_key',\n  'auth_token',\n  'bearer_token',\n  'access_token',\n  'refresh_token',\n]);\n\n// Note: standalone \"key\" and \"token\" are intentionally excluded from SENSITIVE_FIELDS\n// because they are too generic — they would match pagination keys, map keys, and\n// non-sensitive token identifiers. Use compound names (api_key, auth_token, etc.) instead.\n\n/**\n * JSON replacer that converts BigInt values to strings\n */\nexport function bigIntReplacer(_key: string, value: unknown): unknown {\n  return typeof value === 'bigint' ? value.toString() : value;\n}\n\n/**\n * Recursively sanitize an object by redacting sensitive fields\n */\nexport function sanitizeForLogging(obj: unknown, depth = 0): unknown {\n  // Prevent infinite recursion\n  if (depth > 10) {\n    return '[max depth exceeded]';\n  }\n\n  if (obj === null || obj === undefined) {\n    return obj;\n  }\n\n  if (typeof obj === 'string') {\n    // Redact strings that look like BIP-39 mnemonics (12/15/18/21/24 words).\n    // BIP-39 words are all lowercase alphabetic, so require that to avoid\n    // false positives on error messages that happen to be 12/24 words.\n    const words = obj.trim().split(/\\s+/);\n    const wordCount = words.length;\n    if (wordCount >= 12 && wordCount <= 24 && wordCount % 3 === 0) {\n      const allLowercaseAlpha = words.every((w) => /^[a-z]+$/.test(w));\n      if (allLowercaseAlpha) {\n        return '[REDACTED - possible mnemonic]';\n      }\n    }\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => sanitizeForLogging(item, depth + 1));\n  }\n\n  if (typeof obj === 'object') {\n    const sanitized: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      const lowerKey = key.toLowerCase();\n      if (SENSITIVE_FIELDS.has(lowerKey)) {\n        sanitized[key] = '[REDACTED]';\n      } else {\n        sanitized[key] = sanitizeForLogging(value, depth + 1);\n      }\n    }\n    return sanitized;\n  }\n\n  return obj;\n}\n\n/**\n * Options for creating a chain, lease, or fred MCP server\n */\nexport interface ManifestMCPServerOptions {\n  config: ManifestMCPConfig;\n  walletProvider: WalletProvider;\n}\n\n/**\n * Wrap a tool handler with error handling that preserves the existing error format.\n *\n * Generic over the callback type so that Zod-inferred argument types from\n * McpServer.registerTool flow through without requiring manual casts.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- preserves ToolCallback<Args> signature from McpServer\nexport function withErrorHandling<\n  T extends (...args: any[]) => Promise<CallToolResult>,\n>(toolName: string, fn: T): T {\n  // For tools with no inputSchema, McpServer calls cb(extra) with one arg.\n  // For tools with inputSchema, McpServer calls cb(parsedArgs, extra).\n  // We infer from cbArgs.length at call time (not fn.length) so default parameters are safe.\n  const wrapped = async (...cbArgs: any[]) => {\n    const hasArgs = cbArgs.length >= 2;\n    const args = hasArgs ? (cbArgs[0] ?? {}) : {};\n    try {\n      return hasArgs ? await fn(args, cbArgs[1]) : await fn(cbArgs[0]);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      const errorCode =\n        error instanceof ManifestMCPError ? error.code : 'UNKNOWN';\n      // Sanitize error messages before including in the MCP response or logs.\n      // This catches mnemonic-like strings in error messages and redacts them.\n      const safeMessage = sanitizeForLogging(errorMessage) as string;\n      const messageWasRedacted = safeMessage !== errorMessage;\n      if (error instanceof ManifestMCPError) {\n        logger.error(`[${toolName}] Tool error [${errorCode}]: ${safeMessage}`);\n      } else {\n        // Stack traces embed error.message verbatim. If the message was\n        // redacted, the stack would re-leak the original — so suppress the\n        // stack in that case rather than emit a half-sanitized trace.\n        let stackSuffix = '';\n        if (!messageWasRedacted && error instanceof Error && error.stack) {\n          stackSuffix = `\\n${sanitizeForLogging(error.stack) as string}`;\n        }\n        logger.error(\n          `[${toolName}] Tool error [${errorCode}]: ${safeMessage}${stackSuffix}`,\n        );\n      }\n\n      let errorResponse: Record<string, unknown> = {\n        error: true,\n        tool: toolName,\n        input: sanitizeForLogging(args),\n      };\n\n      if (error instanceof ManifestMCPError) {\n        errorResponse = {\n          ...errorResponse,\n          code: error.code,\n          message: sanitizeForLogging(error.message) as string,\n          details: sanitizeForLogging(error.details),\n        };\n      } else {\n        errorResponse = {\n          ...errorResponse,\n          message: safeMessage,\n        };\n      }\n\n      let responseText: string;\n      try {\n        responseText = JSON.stringify(errorResponse, bigIntReplacer, 2);\n      } catch (stringifyError) {\n        logger.error(\n          `[${toolName}] Failed to serialize error response: ${stringifyError instanceof Error ? stringifyError.message : String(stringifyError)}`,\n        );\n        responseText = JSON.stringify({\n          error: true,\n          tool: toolName,\n          message: safeMessage,\n        });\n      }\n\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: responseText,\n          },\n        ],\n        isError: true,\n      };\n    }\n  };\n  return wrapped as T;\n}\n\n/**\n * Helper to build a successful JSON text response\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- matches JSON.stringify's replacer signature\nexport function jsonResponse(\n  data: unknown,\n  replacer?: (key: string, value: any) => any,\n): CallToolResult {\n  return {\n    content: [\n      {\n        type: 'text' as const,\n        text: JSON.stringify(data, replacer, 2),\n      },\n    ],\n  };\n}\n\n/**\n * Helper to build a successful CallToolResult with both `structuredContent`\n * (consumed by clients that validate against the tool's outputSchema) and\n * `content` (text fallback for clients that don't). Use this for any tool\n * registered with an `outputSchema`. Per MCP spec, `structuredContent` must\n * be a JSON object — `data` is typed as `unknown` so callers don't need to\n * widen typed result interfaces with double-casts; the runtime contract\n * (object-shaped after JSON round-trip) is enforced below.\n *\n * The optional `replacer` is applied to BOTH `structuredContent` and the\n * text fallback by round-tripping through JSON. This keeps `structuredContent`\n * JSON-serializable for the wire, even if the caller hands us a `BigInt`,\n * `Date`, or anything else `JSON.stringify` knows how to convert via the\n * replacer.\n */\nexport function structuredResponse(\n  data: unknown,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- matches JSON.stringify's replacer signature\n  replacer?: (key: string, value: any) => any,\n): CallToolResult {\n  const serialized = JSON.stringify(data, replacer);\n  const structuredContent = JSON.parse(serialized) as Record<string, unknown>;\n  return {\n    structuredContent,\n    content: [\n      {\n        type: 'text' as const,\n        text: JSON.stringify(structuredContent, undefined, 2),\n      },\n    ],\n  };\n}\n\n/**\n * Config shape accepted by createMnemonicServer.\n * Derives from ManifestMCPConfig (minus rateLimit/retry) so new config fields propagate automatically.\n */\nexport type MnemonicServerConfig = Omit<\n  ManifestMCPConfig,\n  'rateLimit' | 'retry'\n> & {\n  readonly mnemonic: string;\n};\n\n/**\n * Generic factory that creates any MCP server class with a mnemonic wallet.\n *\n * Eliminates duplicated createMnemonic*Server patterns -- callers pass the\n * server constructor instead.\n */\nexport async function createMnemonicServer<T>(\n  config: MnemonicServerConfig,\n  ServerClass: new (opts: ManifestMCPServerOptions) => T,\n): Promise<T> {\n  const { mnemonic, ...mcpConfig } = config;\n  const validatedConfig = createValidatedConfig(mcpConfig);\n  const walletProvider = new MnemonicWalletProvider(validatedConfig, mnemonic);\n  await walletProvider.connect();\n\n  return new ServerClass({\n    config: validatedConfig,\n    walletProvider,\n  });\n}\n"],"mappings":"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"}

package/dist/version.d.ts

@@ -1,5 +1,5 @@
 //#region src/version.d.ts
-declare const VERSION = "0.3.1";
+declare const VERSION = "0.10.0";
 //#endregion
 export { VERSION };
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,5 +1,5 @@
 //#region src/version.ts
-const VERSION = "0.3.1";
+const VERSION = "0.10.0";
 //#endregion
 export { VERSION };
 

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["export const VERSION = '0.3.1';\n"],"mappings":";AAAA,MAAa,UAAU"}
+{"version":3,"file":"version.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["export const VERSION = '0.10.0';\n"],"mappings":";AAAA,MAAa,UAAU"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manifest-network/manifest-mcp-core",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Shared library for Cosmos SDK blockchain logic, tool functions, and server utilities (Manifest Network)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,6 +17,10 @@
     "./__test-utils__/callTool.js": {
       "import": "./dist/__test-utils__/callTool.js",
       "types": "./dist/__test-utils__/callTool.d.ts"
+    },
+    "./__test-utils__/callToolWithElicitation.js": {
+      "import": "./dist/__test-utils__/callToolWithElicitation.js",
+      "types": "./dist/__test-utils__/callToolWithElicitation.d.ts"
     }
   },
   "scripts": {
@@ -69,5 +73,13 @@
     "@types/node": "22.15.29",
     "typescript": "5.9.3",
     "vitest": "4.1.0"
+  },
+  "peerDependencies": {
+    "vitest": "^4.1.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
   }
 }

package/dist/node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.js

@@ -1,78 +0,0 @@
-//#region ../../node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.mjs
-var comma = ",".charCodeAt(0);
-var semicolon = ";".charCodeAt(0);
-var chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
-var intToChar = new Uint8Array(64);
-var charToInt = new Uint8Array(128);
-for (let i = 0; i < chars.length; i++) {
-	const c = chars.charCodeAt(i);
-	intToChar[i] = c;
-	charToInt[c] = i;
-}
-function encodeInteger(builder, num, relative) {
-	let delta = num - relative;
-	delta = delta < 0 ? -delta << 1 | 1 : delta << 1;
-	do {
-		let clamped = delta & 31;
-		delta >>>= 5;
-		if (delta > 0) clamped |= 32;
-		builder.write(intToChar[clamped]);
-	} while (delta > 0);
-	return num;
-}
-var bufLength = 1024 * 16;
-var td = typeof TextDecoder !== "undefined" ? /* @__PURE__ */ new TextDecoder() : typeof Buffer !== "undefined" ? { decode(buf) {
-	return Buffer.from(buf.buffer, buf.byteOffset, buf.byteLength).toString();
-} } : { decode(buf) {
-	let out = "";
-	for (let i = 0; i < buf.length; i++) out += String.fromCharCode(buf[i]);
-	return out;
-} };
-var StringWriter = class {
-	constructor() {
-		this.pos = 0;
-		this.out = "";
-		this.buffer = new Uint8Array(bufLength);
-	}
-	write(v) {
-		const { buffer } = this;
-		buffer[this.pos++] = v;
-		if (this.pos === bufLength) {
-			this.out += td.decode(buffer);
-			this.pos = 0;
-		}
-	}
-	flush() {
-		const { buffer, out, pos } = this;
-		return pos > 0 ? out + td.decode(buffer.subarray(0, pos)) : out;
-	}
-};
-function encode(decoded) {
-	const writer = new StringWriter();
-	let sourcesIndex = 0;
-	let sourceLine = 0;
-	let sourceColumn = 0;
-	let namesIndex = 0;
-	for (let i = 0; i < decoded.length; i++) {
-		const line = decoded[i];
-		if (i > 0) writer.write(semicolon);
-		if (line.length === 0) continue;
-		let genColumn = 0;
-		for (let j = 0; j < line.length; j++) {
-			const segment = line[j];
-			if (j > 0) writer.write(comma);
-			genColumn = encodeInteger(writer, segment[0], genColumn);
-			if (segment.length === 1) continue;
-			sourcesIndex = encodeInteger(writer, segment[1], sourcesIndex);
-			sourceLine = encodeInteger(writer, segment[2], sourceLine);
-			sourceColumn = encodeInteger(writer, segment[3], sourceColumn);
-			if (segment.length === 4) continue;
-			namesIndex = encodeInteger(writer, segment[4], namesIndex);
-		}
-	}
-	return writer.flush();
-}
-//#endregion
-export { encode };
-
-//# sourceMappingURL=sourcemap-codec.js.map