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

package/dist/cosmos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cosmos.d.ts","names":[],"sources":["../src/cosmos.ts"],"mappings":";;;;;;AA2CA;;;;iBAAsB,WAAA,CACpB,aAAA,EAAe,mBAAA,EACf,MAAA,UACA,UAAA,UACA,IAAA,cACC,OAAA,CAAQ,iBAAA;;;;;;;;;;iBAoDW,QAAA,CACpB,aAAA,EAAe,mBAAA,EACf,MAAA,UACA,UAAA,UACA,IAAA,aACA,mBAAA,YACA,SAAA,GAAY,WAAA,GACX,OAAA,CAAQ,cAAA;;;AAPX;;;;;;;;;iBA2FsB,iBAAA,CACpB,aAAA,EAAe,mBAAA,EACf,MAAA,UACA,UAAA,UACA,IAAA,aACA,SAAA,GAAY,WAAA,GACX,OAAA,CAAQ,iBAAA"}
+{"version":3,"file":"cosmos.d.ts","names":[],"sources":["../src/cosmos.ts"],"mappings":";;;;;;AAqGA;;;;iBAAsB,WAAA,CACpB,aAAA,EAAe,mBAAA,EACf,MAAA,UACA,UAAA,UACA,IAAA,cACC,OAAA,CAAQ,iBAAA;;;;;;;;;;iBA+DW,QAAA,CACpB,aAAA,EAAe,mBAAA,EACf,MAAA,UACA,UAAA,UACA,IAAA,aACA,mBAAA,YACA,SAAA,GAAY,WAAA,GACX,OAAA,CAAQ,cAAA;;;AAPX;;;;;;;;;iBA4GsB,iBAAA,CACpB,aAAA,EAAe,mBAAA,EACf,MAAA,UACA,UAAA,UACA,IAAA,aACA,SAAA,GAAY,WAAA,GACX,OAAA,CAAQ,iBAAA"}

package/dist/cosmos.js

@@ -1,11 +1,44 @@
 import { ManifestMCPError, ManifestMCPErrorCode } from "./types.js";
 import { withRetry } from "./retry.js";
 import "./config.js";
-import { getQueryHandler, getTxHandler, getTxMsgBuilder } from "./modules.js";
+import { getQueryHandler, getTxContextLoader, getTxHandler, getTxMsgBuilder } from "./modules.js";
 import { calculateFee } from "@cosmjs/stargate";
 //#region src/cosmos.ts
 const VALID_NAME_PATTERN = /^[a-zA-Z0-9_][a-zA-Z0-9_-]*$/;
 /**
+* Resolve and run the `TxBuildContext` loader registered for `(module,
+* subcommand)` in `TX_MODULES`. Returns `undefined` when no loader is
+* registered (the common case) so the caller can short-circuit and skip the
+* chain read.
+*
+* Acquires a rate-limit token before the loader runs so each extra RPC is
+* counted against the same budget every other RPC respects, and wraps any
+* non-`ManifestMCPError` failure as `QUERY_FAILED` with `{module, subcommand}`
+* details for symmetric error classification on both broadcast and estimate
+* paths.
+*/
+async function loadBuildContext(clientManager, module, subcommand) {
+	const loader = getTxContextLoader(module, subcommand);
+	if (!loader) return void 0;
+	try {
+		await clientManager.acquireRateLimit();
+		return await loader(await clientManager.getQueryClient());
+	} catch (error) {
+		if (error instanceof ManifestMCPError) {
+			if (!error.details?.module) throw new ManifestMCPError(error.code, error.message, {
+				...error.details,
+				module,
+				subcommand
+			});
+			throw error;
+		}
+		throw new ManifestMCPError(ManifestMCPErrorCode.QUERY_FAILED, `Failed to load build context for ${module} ${subcommand}: ${error instanceof Error ? error.message : String(error)}`, {
+			module,
+			subcommand
+		});
+	}
+}
+/**
 * Validate that a string is safe for use as a module or subcommand name.
 * Uses the appropriate UNSUPPORTED_QUERY or UNSUPPORTED_TX code so that
 * the error is immediately classified as non-retryable.
@@ -24,17 +57,26 @@ async function cosmosQuery(clientManager, module, subcommand, args = []) {
 	validateName(subcommand, "subcommand", ManifestMCPErrorCode.UNSUPPORTED_QUERY);
 	const handler = getQueryHandler(module);
 	return withRetry(async () => {
-		await clientManager.acquireRateLimit();
-		const queryClient = await clientManager.getQueryClient();
 		try {
+			await clientManager.acquireRateLimit();
 			return {
 				module,
 				subcommand,
-				result: await handler(queryClient, subcommand, args)
+				result: await handler(await clientManager.getQueryClient(), subcommand, args)
 			};
 		} catch (error) {
-			if (error instanceof ManifestMCPError) throw error;
-			throw new ManifestMCPError(ManifestMCPErrorCode.QUERY_FAILED, `Query ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`);
+			if (error instanceof ManifestMCPError) {
+				if (!error.details?.module) throw new ManifestMCPError(error.code, error.message, {
+					...error.details,
+					module,
+					subcommand
+				});
+				throw error;
+			}
+			throw new ManifestMCPError(ManifestMCPErrorCode.QUERY_FAILED, `Query ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`, {
+				module,
+				subcommand
+			});
 		}
 	}, {
 		config: clientManager.getConfig().retry,
@@ -64,12 +106,14 @@ async function cosmosTx(clientManager, module, subcommand, args = [], waitForCon
 		};
 	}
 	const handler = getTxHandler(module);
+	const buildContext = await withRetry(() => loadBuildContext(clientManager, module, subcommand), {
+		config: clientManager.getConfig().retry,
+		operationName: `load-context ${module} ${subcommand}`
+	});
 	return withRetry(async () => {
-		await clientManager.acquireRateLimit();
-		const signingClient = await clientManager.getSigningClient();
-		const senderAddress = await clientManager.getAddress();
 		try {
-			return await handler(signingClient, senderAddress, subcommand, args, waitForConfirmation, txOptions);
+			await clientManager.acquireRateLimit();
+			return await handler(await clientManager.getSigningClient(), await clientManager.getAddress(), subcommand, args, waitForConfirmation, txOptions, buildContext);
 		} catch (error) {
 			if (error instanceof ManifestMCPError) {
 				if (!error.details?.module) throw new ManifestMCPError(error.code, error.message, {
@@ -112,14 +156,18 @@ async function cosmosEstimateFee(clientManager, module, subcommand, args = [], o
 		if (!Number.isFinite(overrides.gasMultiplier) || overrides.gasMultiplier < 1) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, `gasMultiplier must be a finite number >= 1, got ${overrides.gasMultiplier}`);
 	}
 	const builder = getTxMsgBuilder(module);
+	const buildContext = await withRetry(() => loadBuildContext(clientManager, module, subcommand), {
+		config: config.retry,
+		operationName: `load-context ${module} ${subcommand}`
+	});
 	return withRetry(async () => {
-		await clientManager.acquireRateLimit();
-		const signingClient = await clientManager.getSigningClient();
-		const senderAddress = await clientManager.getAddress();
-		const clientMultiplier = signingClient.defaultGasMultiplier;
-		const gasMultiplier = overrides?.gasMultiplier ?? (typeof clientMultiplier === "number" ? clientMultiplier : 1.5);
 		try {
-			const built = builder(senderAddress, subcommand, args);
+			await clientManager.acquireRateLimit();
+			const signingClient = await clientManager.getSigningClient();
+			const senderAddress = await clientManager.getAddress();
+			const clientMultiplier = signingClient.defaultGasMultiplier;
+			const gasMultiplier = overrides?.gasMultiplier ?? (typeof clientMultiplier === "number" ? clientMultiplier : 1.5);
+			const built = builder(senderAddress, subcommand, args, buildContext);
 			const gasEstimate = await signingClient.simulate(senderAddress, built.messages, built.memo);
 			const fee = calculateFee(Math.ceil(gasEstimate * gasMultiplier), gasPrice);
 			return {

package/dist/cosmos.js.map

@@ -1 +1 @@
-{"version":3,"file":"cosmos.js","names":[],"sources":["../src/cosmos.ts"],"sourcesContent":["import { calculateFee } from '@cosmjs/stargate';\nimport type { CosmosClientManager } from './client.js';\nimport { DEFAULT_GAS_MULTIPLIER } from './config.js';\nimport { getQueryHandler, getTxHandler, getTxMsgBuilder } from './modules.js';\nimport { withRetry } from './retry.js';\nimport {\n  type CosmosQueryResult,\n  type CosmosTxResult,\n  type FeeEstimateResult,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type TxOptions,\n  type TxOverrides,\n} from './types.js';\n\n// Validation pattern for module/subcommand names (alphanumeric, hyphens, underscores)\n// First character must not be a hyphen to prevent potential issues\nconst VALID_NAME_PATTERN = /^[a-zA-Z0-9_][a-zA-Z0-9_-]*$/;\n\n/**\n * Validate that a string is safe for use as a module or subcommand name.\n * Uses the appropriate UNSUPPORTED_QUERY or UNSUPPORTED_TX code so that\n * the error is immediately classified as non-retryable.\n */\nfunction validateName(\n  name: string,\n  field: string,\n  errorCode: ManifestMCPErrorCode,\n): void {\n  if (!name || !VALID_NAME_PATTERN.test(name)) {\n    throw new ManifestMCPError(\n      errorCode,\n      `Invalid ${field}: \"${name}\". Only alphanumeric characters, hyphens, and underscores are allowed.`,\n    );\n  }\n}\n\n/**\n * Execute a Cosmos query via manifestjs RPC client\n *\n * Automatically retries on transient failures (network errors, timeouts, 5xx)\n * with exponential backoff. Configure retry behavior via `config.retry`.\n */\nexport async function cosmosQuery(\n  clientManager: CosmosClientManager,\n  module: string,\n  subcommand: string,\n  args: string[] = [],\n): Promise<CosmosQueryResult> {\n  validateName(module, 'module', ManifestMCPErrorCode.UNSUPPORTED_QUERY);\n  validateName(\n    subcommand,\n    'subcommand',\n    ManifestMCPErrorCode.UNSUPPORTED_QUERY,\n  );\n\n  // Get handler from registry (throws if module not found) - do this before retry loop\n  const handler = getQueryHandler(module);\n\n  return withRetry(\n    async () => {\n      // Apply rate limiting before making RPC request\n      await clientManager.acquireRateLimit();\n\n      const queryClient = await clientManager.getQueryClient();\n\n      try {\n        const result = await handler(queryClient, subcommand, args);\n\n        return {\n          module,\n          subcommand,\n          result,\n        };\n      } catch (error) {\n        if (error instanceof ManifestMCPError) {\n          throw error;\n        }\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.QUERY_FAILED,\n          `Query ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n    {\n      config: clientManager.getConfig().retry,\n      operationName: `query ${module} ${subcommand}`,\n    },\n  );\n}\n\n/**\n * Execute a Cosmos transaction via manifestjs signing client\n *\n * Automatically retries on transient failures (network errors, timeouts, 5xx)\n * with exponential backoff. Configure retry behavior via `config.retry`.\n *\n * Note: Only network-level failures are retried. Transaction validation errors\n * (insufficient funds, invalid args, etc.) are not retried as they won't succeed.\n */\nexport async function cosmosTx(\n  clientManager: CosmosClientManager,\n  module: string,\n  subcommand: string,\n  args: string[] = [],\n  waitForConfirmation: boolean = false,\n  overrides?: TxOverrides,\n): Promise<CosmosTxResult> {\n  validateName(module, 'module', ManifestMCPErrorCode.UNSUPPORTED_TX);\n  validateName(subcommand, 'subcommand', ManifestMCPErrorCode.UNSUPPORTED_TX);\n\n  // Build fully-resolved gas options from caller overrides + server config\n  let txOptions: TxOptions | undefined;\n  if (overrides?.gasMultiplier !== undefined) {\n    if (\n      !Number.isFinite(overrides.gasMultiplier) ||\n      overrides.gasMultiplier < 1\n    ) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        `gasMultiplier must be a finite number >= 1, got ${overrides.gasMultiplier}`,\n      );\n    }\n    const gasPrice = clientManager.getConfig().gasPrice;\n    if (!gasPrice) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        'gasMultiplier override requires gasPrice configuration',\n      );\n    }\n    txOptions = { gasMultiplier: overrides.gasMultiplier, gasPrice };\n  }\n\n  // Get handler from registry (throws if module not found) - do this before retry loop\n  const handler = getTxHandler(module);\n\n  return withRetry(\n    async () => {\n      // Apply rate limiting before making RPC request\n      await clientManager.acquireRateLimit();\n\n      const signingClient = await clientManager.getSigningClient();\n      const senderAddress = await clientManager.getAddress();\n\n      try {\n        return await handler(\n          signingClient,\n          senderAddress,\n          subcommand,\n          args,\n          waitForConfirmation,\n          txOptions,\n        );\n      } catch (error) {\n        if (error instanceof ManifestMCPError) {\n          // Re-throw with enriched context if not already present\n          if (!error.details?.module) {\n            throw new ManifestMCPError(error.code, error.message, {\n              ...error.details,\n              module,\n              subcommand,\n              args,\n            });\n          }\n          throw error;\n        }\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.TX_FAILED,\n          `Tx ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`,\n          { module, subcommand, args },\n        );\n      }\n    },\n    {\n      config: clientManager.getConfig().retry,\n      operationName: `tx ${module} ${subcommand}`,\n    },\n  );\n}\n\n/**\n * Estimate the fee for a Cosmos transaction without broadcasting it.\n *\n * Looks up the message builder for the given module, builds the messages,\n * and calls `client.simulate()` to get a gas estimate. Multiplies by the\n * configured (or overridden) gas multiplier and computes the fee.\n *\n * Automatically retries on transient failures via `withRetry`.\n *\n * @returns FeeEstimateResult with raw gas estimate and computed fee\n */\nexport async function cosmosEstimateFee(\n  clientManager: CosmosClientManager,\n  module: string,\n  subcommand: string,\n  args: string[] = [],\n  overrides?: TxOverrides,\n): Promise<FeeEstimateResult> {\n  validateName(module, 'module', ManifestMCPErrorCode.UNSUPPORTED_TX);\n  validateName(subcommand, 'subcommand', ManifestMCPErrorCode.UNSUPPORTED_TX);\n\n  // Always need gasPrice for fee calculation (unlike cosmosTx which can use 'auto')\n  const config = clientManager.getConfig();\n  const gasPrice = config.gasPrice;\n  if (!gasPrice) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_CONFIG,\n      'Fee estimation requires gasPrice configuration',\n    );\n  }\n\n  // Validate the override eagerly (the resolved fallback values are always valid).\n  if (overrides?.gasMultiplier !== undefined) {\n    if (\n      !Number.isFinite(overrides.gasMultiplier) ||\n      overrides.gasMultiplier < 1\n    ) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        `gasMultiplier must be a finite number >= 1, got ${overrides.gasMultiplier}`,\n      );\n    }\n  }\n\n  // Get builder from registry (throws if module not found) - do this before retry loop\n  const builder = getTxMsgBuilder(module);\n\n  return withRetry(\n    async () => {\n      // Apply rate limiting before making RPC request\n      await clientManager.acquireRateLimit();\n\n      const signingClient = await clientManager.getSigningClient();\n      const senderAddress = await clientManager.getAddress();\n\n      // Resolve gasMultiplier from the signing client when no override is provided.\n      // This guarantees parity with cosmosTx's 'auto' path: client.ts patches the\n      // signing client's defaultGasMultiplier to config.gasMultiplier; if that\n      // patch fails (rare — only when CosmJS internals change), the client\n      // falls back to CosmJS's built-in default. Reading from the client uses\n      // the same value cosmosTx would.\n      const clientMultiplier = (\n        signingClient as unknown as { defaultGasMultiplier?: unknown }\n      ).defaultGasMultiplier;\n      const gasMultiplier =\n        overrides?.gasMultiplier ??\n        (typeof clientMultiplier === 'number'\n          ? clientMultiplier\n          : DEFAULT_GAS_MULTIPLIER);\n\n      try {\n        const built = builder(senderAddress, subcommand, args);\n        const gasEstimate = await signingClient.simulate(\n          senderAddress,\n          built.messages,\n          built.memo,\n        );\n        const gasLimit = Math.ceil(gasEstimate * gasMultiplier);\n        const fee = calculateFee(gasLimit, gasPrice);\n\n        return {\n          module,\n          subcommand: built.canonicalSubcommand ?? subcommand,\n          gasEstimate: String(gasEstimate),\n          fee: { amount: fee.amount, gas: fee.gas },\n        };\n      } catch (error) {\n        if (error instanceof ManifestMCPError) {\n          // Re-throw with enriched context if not already present (mirrors cosmosTx)\n          if (!error.details?.module) {\n            throw new ManifestMCPError(error.code, error.message, {\n              ...error.details,\n              module,\n              subcommand,\n              args,\n            });\n          }\n          throw error;\n        }\n        // SIMULATION_FAILED is NOT in NON_RETRYABLE_ERROR_CODES, so withRetry\n        // will fall through to isTransientErrorMessage for message-based\n        // classification. Transient errors (network/5xx) get retried; real\n        // simulation failures (insufficient funds, etc) fail fast.\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.SIMULATION_FAILED,\n          `Fee estimation for ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`,\n          { module, subcommand, args },\n        );\n      }\n    },\n    {\n      config: config.retry,\n      operationName: `estimate ${module} ${subcommand}`,\n    },\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"cosmos.js","names":[],"sources":["../src/cosmos.ts"],"sourcesContent":["import { calculateFee } from '@cosmjs/stargate';\nimport type { CosmosClientManager } from './client.js';\nimport { DEFAULT_GAS_MULTIPLIER } from './config.js';\nimport {\n  getQueryHandler,\n  getTxContextLoader,\n  getTxHandler,\n  getTxMsgBuilder,\n} from './modules.js';\nimport { withRetry } from './retry.js';\nimport {\n  type CosmosQueryResult,\n  type CosmosTxResult,\n  type FeeEstimateResult,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type TxBuildContext,\n  type TxOptions,\n  type TxOverrides,\n} from './types.js';\n\n// Validation pattern for module/subcommand names (alphanumeric, hyphens, underscores)\n// First character must not be a hyphen to prevent potential issues\nconst VALID_NAME_PATTERN = /^[a-zA-Z0-9_][a-zA-Z0-9_-]*$/;\n\n/**\n * Resolve and run the `TxBuildContext` loader registered for `(module,\n * subcommand)` in `TX_MODULES`. Returns `undefined` when no loader is\n * registered (the common case) so the caller can short-circuit and skip the\n * chain read.\n *\n * Acquires a rate-limit token before the loader runs so each extra RPC is\n * counted against the same budget every other RPC respects, and wraps any\n * non-`ManifestMCPError` failure as `QUERY_FAILED` with `{module, subcommand}`\n * details for symmetric error classification on both broadcast and estimate\n * paths.\n */\nasync function loadBuildContext(\n  clientManager: CosmosClientManager,\n  module: string,\n  subcommand: string,\n): Promise<TxBuildContext | undefined> {\n  const loader = getTxContextLoader(module, subcommand);\n  if (!loader) return undefined;\n\n  // The full loader call sequence — rate-limit acquire, query-client\n  // construction, loader invocation — runs inside the try/catch so every\n  // failure mode gets the {module, subcommand} attribution callers expect\n  // from a structured error. Without the wrap, an INVALID_CONFIG from\n  // `getQueryClient` (or a connection failure that escapes the inner\n  // withRetry) would propagate without telling the caller which tx was\n  // being prepared.\n  try {\n    await clientManager.acquireRateLimit();\n    const queryClient = await clientManager.getQueryClient();\n    return await loader(queryClient);\n  } catch (error) {\n    if (error instanceof ManifestMCPError) {\n      if (!error.details?.module) {\n        throw new ManifestMCPError(error.code, error.message, {\n          ...error.details,\n          module,\n          subcommand,\n        });\n      }\n      throw error;\n    }\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.QUERY_FAILED,\n      `Failed to load build context for ${module} ${subcommand}: ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n      { module, subcommand },\n    );\n  }\n}\n\n/**\n * Validate that a string is safe for use as a module or subcommand name.\n * Uses the appropriate UNSUPPORTED_QUERY or UNSUPPORTED_TX code so that\n * the error is immediately classified as non-retryable.\n */\nfunction validateName(\n  name: string,\n  field: string,\n  errorCode: ManifestMCPErrorCode,\n): void {\n  if (!name || !VALID_NAME_PATTERN.test(name)) {\n    throw new ManifestMCPError(\n      errorCode,\n      `Invalid ${field}: \"${name}\". Only alphanumeric characters, hyphens, and underscores are allowed.`,\n    );\n  }\n}\n\n/**\n * Execute a Cosmos query via manifestjs RPC client\n *\n * Automatically retries on transient failures (network errors, timeouts, 5xx)\n * with exponential backoff. Configure retry behavior via `config.retry`.\n */\nexport async function cosmosQuery(\n  clientManager: CosmosClientManager,\n  module: string,\n  subcommand: string,\n  args: string[] = [],\n): Promise<CosmosQueryResult> {\n  validateName(module, 'module', ManifestMCPErrorCode.UNSUPPORTED_QUERY);\n  validateName(\n    subcommand,\n    'subcommand',\n    ManifestMCPErrorCode.UNSUPPORTED_QUERY,\n  );\n\n  // Get handler from registry (throws if module not found) - do this before retry loop\n  const handler = getQueryHandler(module);\n\n  return withRetry(\n    async () => {\n      // The rate-limit + query-client acquisition runs inside the try/catch\n      // so a failure during either step is wrapped with {module, subcommand}\n      // attribution, matching the handler-leg semantics. Otherwise an\n      // INVALID_CONFIG from `getQueryClient` (or a connection failure that\n      // escapes the inner withRetry) would propagate without telling the\n      // caller which query was being routed.\n      try {\n        await clientManager.acquireRateLimit();\n        const queryClient = await clientManager.getQueryClient();\n        const result = await handler(queryClient, subcommand, args);\n\n        return {\n          module,\n          subcommand,\n          result,\n        };\n      } catch (error) {\n        if (error instanceof ManifestMCPError) {\n          if (!error.details?.module) {\n            throw new ManifestMCPError(error.code, error.message, {\n              ...error.details,\n              module,\n              subcommand,\n            });\n          }\n          throw error;\n        }\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.QUERY_FAILED,\n          `Query ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`,\n          { module, subcommand },\n        );\n      }\n    },\n    {\n      config: clientManager.getConfig().retry,\n      operationName: `query ${module} ${subcommand}`,\n    },\n  );\n}\n\n/**\n * Execute a Cosmos transaction via manifestjs signing client\n *\n * Automatically retries on transient failures (network errors, timeouts, 5xx)\n * with exponential backoff. Configure retry behavior via `config.retry`.\n *\n * Note: Only network-level failures are retried. Transaction validation errors\n * (insufficient funds, invalid args, etc.) are not retried as they won't succeed.\n */\nexport async function cosmosTx(\n  clientManager: CosmosClientManager,\n  module: string,\n  subcommand: string,\n  args: string[] = [],\n  waitForConfirmation: boolean = false,\n  overrides?: TxOverrides,\n): Promise<CosmosTxResult> {\n  validateName(module, 'module', ManifestMCPErrorCode.UNSUPPORTED_TX);\n  validateName(subcommand, 'subcommand', ManifestMCPErrorCode.UNSUPPORTED_TX);\n\n  // Build fully-resolved gas options from caller overrides + server config\n  let txOptions: TxOptions | undefined;\n  if (overrides?.gasMultiplier !== undefined) {\n    if (\n      !Number.isFinite(overrides.gasMultiplier) ||\n      overrides.gasMultiplier < 1\n    ) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        `gasMultiplier must be a finite number >= 1, got ${overrides.gasMultiplier}`,\n      );\n    }\n    const gasPrice = clientManager.getConfig().gasPrice;\n    if (!gasPrice) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        'gasMultiplier override requires gasPrice configuration',\n      );\n    }\n    txOptions = { gasMultiplier: overrides.gasMultiplier, gasPrice };\n  }\n\n  // Get handler from registry (throws if module not found) - do this before retry loop\n  const handler = getTxHandler(module);\n  // Fetch chain context once before the broadcast retry loop: every broadcast\n  // attempt uses the same snapshot and we don't consume extra rate-limit\n  // tokens per broadcast retry. The loader is independently wrapped in its\n  // own withRetry so transient LCD failures during the chain read still get\n  // retried (parity with cosmosQuery's params reads).\n  const buildContext = await withRetry(\n    () => loadBuildContext(clientManager, module, subcommand),\n    {\n      config: clientManager.getConfig().retry,\n      operationName: `load-context ${module} ${subcommand}`,\n    },\n  );\n\n  return withRetry(\n    async () => {\n      // The rate-limit + signing-client + address acquisition runs inside\n      // the try/catch so a failure during any of those steps is wrapped\n      // with {module, subcommand, args} attribution, matching the\n      // handler-leg semantics. Otherwise an INVALID_CONFIG / wallet error\n      // from these calls would propagate without telling the caller which\n      // tx was being prepared.\n      try {\n        await clientManager.acquireRateLimit();\n        const signingClient = await clientManager.getSigningClient();\n        const senderAddress = await clientManager.getAddress();\n\n        return await handler(\n          signingClient,\n          senderAddress,\n          subcommand,\n          args,\n          waitForConfirmation,\n          txOptions,\n          buildContext,\n        );\n      } catch (error) {\n        if (error instanceof ManifestMCPError) {\n          // Re-throw with enriched context if not already present\n          if (!error.details?.module) {\n            throw new ManifestMCPError(error.code, error.message, {\n              ...error.details,\n              module,\n              subcommand,\n              args,\n            });\n          }\n          throw error;\n        }\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.TX_FAILED,\n          `Tx ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`,\n          { module, subcommand, args },\n        );\n      }\n    },\n    {\n      config: clientManager.getConfig().retry,\n      operationName: `tx ${module} ${subcommand}`,\n    },\n  );\n}\n\n/**\n * Estimate the fee for a Cosmos transaction without broadcasting it.\n *\n * Looks up the message builder for the given module, builds the messages,\n * and calls `client.simulate()` to get a gas estimate. Multiplies by the\n * configured (or overridden) gas multiplier and computes the fee.\n *\n * Automatically retries on transient failures via `withRetry`.\n *\n * @returns FeeEstimateResult with raw gas estimate and computed fee\n */\nexport async function cosmosEstimateFee(\n  clientManager: CosmosClientManager,\n  module: string,\n  subcommand: string,\n  args: string[] = [],\n  overrides?: TxOverrides,\n): Promise<FeeEstimateResult> {\n  validateName(module, 'module', ManifestMCPErrorCode.UNSUPPORTED_TX);\n  validateName(subcommand, 'subcommand', ManifestMCPErrorCode.UNSUPPORTED_TX);\n\n  // Always need gasPrice for fee calculation (unlike cosmosTx which can use 'auto')\n  const config = clientManager.getConfig();\n  const gasPrice = config.gasPrice;\n  if (!gasPrice) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_CONFIG,\n      'Fee estimation requires gasPrice configuration',\n    );\n  }\n\n  // Validate the override eagerly (the resolved fallback values are always valid).\n  if (overrides?.gasMultiplier !== undefined) {\n    if (\n      !Number.isFinite(overrides.gasMultiplier) ||\n      overrides.gasMultiplier < 1\n    ) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        `gasMultiplier must be a finite number >= 1, got ${overrides.gasMultiplier}`,\n      );\n    }\n  }\n\n  // Get builder from registry (throws if module not found) - do this before retry loop\n  const builder = getTxMsgBuilder(module);\n  // Fetch chain context once before the simulate retry loop: every simulate\n  // attempt uses the same snapshot and we don't consume extra rate-limit\n  // tokens per simulate retry. The loader is independently wrapped in its\n  // own withRetry so transient LCD failures during the chain read still get\n  // retried (parity with cosmosQuery's params reads).\n  const buildContext = await withRetry(\n    () => loadBuildContext(clientManager, module, subcommand),\n    {\n      config: config.retry,\n      operationName: `load-context ${module} ${subcommand}`,\n    },\n  );\n\n  return withRetry(\n    async () => {\n      // The rate-limit + signing-client + address acquisition runs inside\n      // the try/catch so a failure during any of those steps is wrapped\n      // with {module, subcommand, args} attribution, matching the\n      // handler-leg semantics. Otherwise an INVALID_CONFIG / wallet error\n      // from these calls would propagate without telling the caller which\n      // estimate was being computed.\n      try {\n        await clientManager.acquireRateLimit();\n        const signingClient = await clientManager.getSigningClient();\n        const senderAddress = await clientManager.getAddress();\n\n        // Resolve gasMultiplier from the signing client when no override is provided.\n        // This guarantees parity with cosmosTx's 'auto' path: client.ts patches the\n        // signing client's defaultGasMultiplier to config.gasMultiplier; if that\n        // patch fails (rare — only when CosmJS internals change), the client\n        // falls back to CosmJS's built-in default. Reading from the client uses\n        // the same value cosmosTx would.\n        const clientMultiplier = (\n          signingClient as unknown as { defaultGasMultiplier?: unknown }\n        ).defaultGasMultiplier;\n        const gasMultiplier =\n          overrides?.gasMultiplier ??\n          (typeof clientMultiplier === 'number'\n            ? clientMultiplier\n            : DEFAULT_GAS_MULTIPLIER);\n\n        const built = builder(senderAddress, subcommand, args, buildContext);\n        const gasEstimate = await signingClient.simulate(\n          senderAddress,\n          built.messages,\n          built.memo,\n        );\n        const gasLimit = Math.ceil(gasEstimate * gasMultiplier);\n        const fee = calculateFee(gasLimit, gasPrice);\n\n        return {\n          module,\n          subcommand: built.canonicalSubcommand ?? subcommand,\n          gasEstimate: String(gasEstimate),\n          fee: { amount: fee.amount, gas: fee.gas },\n        };\n      } catch (error) {\n        if (error instanceof ManifestMCPError) {\n          // Re-throw with enriched context if not already present (mirrors cosmosTx)\n          if (!error.details?.module) {\n            throw new ManifestMCPError(error.code, error.message, {\n              ...error.details,\n              module,\n              subcommand,\n              args,\n            });\n          }\n          throw error;\n        }\n        // SIMULATION_FAILED is NOT in NON_RETRYABLE_ERROR_CODES, so withRetry\n        // will fall through to isTransientErrorMessage for message-based\n        // classification. Transient errors (network/5xx) get retried; real\n        // simulation failures (insufficient funds, etc) fail fast.\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.SIMULATION_FAILED,\n          `Fee estimation for ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`,\n          { module, subcommand, args },\n        );\n      }\n    },\n    {\n      config: config.retry,\n      operationName: `estimate ${module} ${subcommand}`,\n    },\n  );\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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, 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, 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 { 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";
@@ -12,10 +12,11 @@ import { INFRASTRUCTURE_ERROR_CODES, ManifestMCPServerOptions, MnemonicServerCon
 import { MANIFEST_TOOL_META_VERSION, ManifestToolMeta, ManifestToolMetaContainer, ManifestToolMetaVersion, manifestMeta, mutatingAnnotations, readOnlyAnnotations } from "./tool-metadata.js";
 import { FundCreditsResult, fundCredits } from "./tools/fundCredits.js";
 import { getBalance } from "./tools/getBalance.js";
+import { SetItemCustomDomainOptions, SetItemCustomDomainResult, setItemCustomDomain } from "./tools/setItemCustomDomain.js";
 import { StopAppResult, stopApp } from "./tools/stopApp.js";
 import { DNS_LABEL_RE, optionalBoolean, parseArgs, requireString, requireStringEnum, requireUuid } from "./validation.js";
 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, 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, SignArbitraryResult, SkuParams, SkuParamsResult, SkuResult, SkusResult, SlashesResult, StakingParams, StakingParamsResult, StakingPool, StakingPoolResult, type StopAppResult, SupplyOfResult, TallyParams, TallyResult, TokenfactoryParams, TokenfactoryParamsResult, TotalSupplyResult, 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, 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, withErrorHandling, withRetry };

package/dist/index.js

@@ -16,7 +16,8 @@ import { INFRASTRUCTURE_ERROR_CODES, SENSITIVE_FIELDS, bigIntReplacer, createMne
 import { MANIFEST_TOOL_META_VERSION, manifestMeta, mutatingAnnotations, readOnlyAnnotations } from "./tool-metadata.js";
 import { fundCredits } from "./tools/fundCredits.js";
 import { getBalance } from "./tools/getBalance.js";
+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, 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, withErrorHandling, withRetry };

package/dist/modules.d.ts

@@ -1,4 +1,4 @@
-import { AvailableModules, BuiltMessages, CosmosTxResult, ModuleInfo, QueryResult, TxOptions } from "./types.js";
+import { AvailableModules, BuiltMessages, CosmosTxResult, ModuleInfo, QueryResult, TxBuildContext, TxOptions } from "./types.js";
 import { ManifestQueryClient } from "./client.js";
 import { SigningStargateClient } from "@cosmjs/stargate";
 
@@ -8,14 +8,23 @@ import { SigningStargateClient } from "@cosmjs/stargate";
  */
 type QueryHandler = (queryClient: ManifestQueryClient, subcommand: string, args: string[]) => Promise<QueryResult>;
 /**
- * Handler function type for transaction modules
+ * Handler function type for transaction modules.
+ *
+ * `context` carries optional read-only chain state (currently the on-chain
+ * billing Params) for handlers that must merge against existing values to
+ * preserve fields the caller did not explicitly set. Most handlers ignore it.
  */
-type TxHandler = (signingClient: SigningStargateClient, senderAddress: string, subcommand: string, args: string[], waitForConfirmation: boolean, options?: TxOptions) => Promise<CosmosTxResult>;
+type TxHandler = (signingClient: SigningStargateClient, senderAddress: string, subcommand: string, args: string[], waitForConfirmation: boolean, options?: TxOptions, context?: TxBuildContext) => Promise<CosmosTxResult>;
 /**
  * Pure synchronous function type for building transaction messages.
  * Used by `cosmosEstimateFee` to obtain `EncodeObject[]` without signing/broadcasting.
+ *
+ * `context` carries optional chain state for builders that need it (e.g.
+ * billing `update-params` preserves on-chain `allowedList` /
+ * `reservedDomainSuffixes` when not explicitly overridden). Builders that
+ * don't need context simply ignore it.
  */
-type TxMsgBuilder = (senderAddress: string, subcommand: string, args: string[]) => BuiltMessages;
+type TxMsgBuilder = (senderAddress: string, subcommand: string, args: string[], context?: TxBuildContext) => BuiltMessages;
 /**
  * Throw an error for an unsupported subcommand.
  * Automatically looks up available subcommands from the module registry.
@@ -25,6 +34,12 @@ type TxMsgBuilder = (senderAddress: string, subcommand: string, args: string[])
  * @param subcommand - The unsupported subcommand that was requested
  */
 declare function throwUnsupportedSubcommand(type: 'query' | 'tx', module: string, subcommand: string): never;
+/**
+ * Loader that fetches the chain state a `TxBuildContext`-aware msgBuilder
+ * needs. Receives a `ManifestQueryClient`; the dispatcher in `cosmos.ts`
+ * handles rate-limit acquisition and error wrapping around the call.
+ */
+type TxBuildContextLoader = (queryClient: ManifestQueryClient) => Promise<TxBuildContext>;
 /**
  * Get all available query and transaction modules
  */
@@ -68,6 +83,14 @@ declare function getTxHandler(module: string): TxHandler;
  * @throws ManifestMCPError if module is not found
  */
 declare function getTxMsgBuilder(module: string): TxMsgBuilder;
+/**
+ * Look up the optional `TxBuildContext` loader for a (module, subcommand)
+ * pair. Returns `undefined` when the module is unknown OR when the module
+ * doesn't declare a loader for that subcommand — both are normal cases
+ * (most txs need no context). Callers are expected to short-circuit on
+ * `undefined` and skip the chain read.
+ */
+declare function getTxContextLoader(module: string, subcommand: string): TxBuildContextLoader | undefined;
 //#endregion
-export { QueryHandler, TxHandler, TxMsgBuilder, getAvailableModules, getModuleSubcommands, getQueryHandler, getSubcommandUsage, getSupportedModules, getTxHandler, getTxMsgBuilder, isSubcommandSupported, throwUnsupportedSubcommand };
+export { QueryHandler, TxBuildContextLoader, TxHandler, TxMsgBuilder, getAvailableModules, getModuleSubcommands, getQueryHandler, getSubcommandUsage, getSupportedModules, getTxContextLoader, getTxHandler, getTxMsgBuilder, isSubcommandSupported, throwUnsupportedSubcommand };
 //# sourceMappingURL=modules.d.ts.map

package/dist/modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modules.d.ts","names":[],"sources":["../src/modules.ts"],"mappings":";;;;;;;AAiFA;KAAY,YAAA,IACV,WAAA,EAAa,mBAAA,EACb,UAAA,UACA,IAAA,eACG,OAAA,CAAQ,WAAA;;;;KAKD,SAAA,IACV,aAAA,EAAe,qBAAA,EACf,aAAA,UACA,UAAA,UACA,IAAA,YACA,mBAAA,WACA,OAAA,GAAU,SAAA,KACP,OAAA,CAAQ,cAAA;;;;;KAMD,YAAA,IACV,aAAA,UACA,UAAA,UACA,IAAA,eACG,aAAA;;;;;;AAjBL;;;iBA2BgB,0BAAA,CACd,IAAA,kBACA,MAAA,UACA,UAAA;;;;iBA+5Bc,mBAAA,CAAA,GAAuB,gBAAA;;;;iBAwBvB,oBAAA,CACd,IAAA,kBACA,MAAA,WACC,UAAA;;;;iBAsBa,qBAAA,CACd,IAAA,kBACA,MAAA,UACA,UAAA;;;;;iBAgBc,kBAAA,CACd,IAAA,kBACA,MAAA,UACA,UAAA;AAv/BF;;;AAAA,iBAugCgB,mBAAA,CAAA;EACd,KAAA;IAAA,CAAU,MAAA;EAAA;EACV,EAAA;IAAA,CAAO,MAAA;EAAA;AAAA;;;;;iBAsBO,eAAA,CAAgB,MAAA,WAAiB,YAAA;;;;AA/GjD;iBA+HgB,YAAA,CAAa,MAAA,WAAiB,SAAA;;;;AAvG9C;iBAuHgB,eAAA,CAAgB,MAAA,WAAiB,YAAA"}
+{"version":3,"file":"modules.d.ts","names":[],"sources":["../src/modules.ts"],"mappings":";;;;;;;AAmFA;KAAY,YAAA,IACV,WAAA,EAAa,mBAAA,EACb,UAAA,UACA,IAAA,eACG,OAAA,CAAQ,WAAA;;;;;;;;KASD,SAAA,IACV,aAAA,EAAe,qBAAA,EACf,aAAA,UACA,UAAA,UACA,IAAA,YACA,mBAAA,WACA,OAAA,GAAU,SAAA,EACV,OAAA,GAAU,cAAA,KACP,OAAA,CAAQ,cAAA;;;;;;;AARb;;;KAmBY,YAAA,IACV,aAAA,UACA,UAAA,UACA,IAAA,YACA,OAAA,GAAU,cAAA,KACP,aAAA;;;;;;;;;iBAUW,0BAAA,CACd,IAAA,kBACA,MAAA,UACA,UAAA;;;;;;KAuCU,oBAAA,IACV,WAAA,EAAa,mBAAA,KACV,OAAA,CAAQ,cAAA;;;;iBA65BG,mBAAA,CAAA,GAAuB,gBAAA;;AAx9BvC;;iBAg/BgB,oBAAA,CACd,IAAA,kBACA,MAAA,WACC,UAAA;;;;iBAsBa,qBAAA,CACd,IAAA,kBACA,MAAA,UACA,UAAA;;;;;iBAgBc,kBAAA,CACd,IAAA,kBACA,MAAA,UACA,UAAA;AAhhCF;;;AAAA,iBAgiCgB,mBAAA,CAAA;EACd,KAAA;IAAA,CAAU,MAAA;EAAA;EACV,EAAA;IAAA,CAAO,MAAA;EAAA;AAAA;;;;;iBAsBO,eAAA,CAAgB,MAAA,WAAiB,YAAA;;;;;iBAgBjC,YAAA,CAAa,MAAA,WAAiB,SAAA;;;AA/H9C;;iBA+IgB,eAAA,CAAgB,MAAA,WAAiB,YAAA;;;AAvHjD;;;;;iBA0IgB,kBAAA,CACd,MAAA,UACA,UAAA,WACC,oBAAA"}

package/dist/modules.js

@@ -16,7 +16,7 @@ import { routeTokenfactoryQuery } from "./queries/tokenfactory.js";
 import { routeWasmQuery } from "./queries/wasm.js";
 import { buildAuthzMessages, routeAuthzTransaction } from "./transactions/authz.js";
 import { buildBankMessages, routeBankTransaction } from "./transactions/bank.js";
-import { buildBillingMessages, routeBillingTransaction } from "./transactions/billing.js";
+import { buildBillingMessages, loadBillingUpdateParamsContext, routeBillingTransaction } from "./transactions/billing.js";
 import { buildDistributionMessages, routeDistributionTransaction } from "./transactions/distribution.js";
 import { buildFeegrantMessages, routeFeegrantTransaction } from "./transactions/feegrant.js";
 import { buildGovMessages, routeGovTransaction } from "./transactions/gov.js";
@@ -375,6 +375,11 @@ const QUERY_MODULES = {
 			{
 				name: "credit-estimate",
 				description: "Query credit estimate for a tenant"
+			},
+			{
+				name: "lease-by-custom-domain",
+				description: "Reverse-lookup the active or pending lease that has claimed a custom_domain",
+				args: "<custom-domain>"
 			}
 		]
 	},
@@ -760,6 +765,7 @@ const TX_MODULES = {
 		description: "Manifest billing transaction subcommands",
 		handler: routeBillingTransaction,
 		msgBuilder: buildBillingMessages,
+		contextLoaders: { "update-params": loadBillingUpdateParamsContext },
 		subcommands: [
 			{
 				name: "fund-credit",
@@ -803,8 +809,13 @@ const TX_MODULES = {
 			},
 			{
 				name: "update-params",
-				description: "Update billing module parameters (governance)",
-				args: "<max-leases-per-tenant> <max-items-per-lease> <min-lease-duration> <max-pending-leases-per-tenant> <pending-timeout> [<allowed-address>...]"
+				description: "Update billing module parameters (governance). List-typed fields (allowed_list, reserved_domain_suffixes) preserve their on-chain values when not explicitly overridden; pass --clear-allowed-list or --clear-reserved-suffixes to clear them. Mutually exclusive: positional <allowed-address> with --clear-allowed-list, and --reserved-suffix with --clear-reserved-suffixes.",
+				args: "<max-leases-per-tenant> <max-items-per-lease> <min-lease-duration> <max-pending-leases-per-tenant> <pending-timeout> [<allowed-address>...] [--clear-allowed-list] [--reserved-suffix <.example.com>...] [--clear-reserved-suffixes]"
+			},
+			{
+				name: "set-item-custom-domain",
+				description: "Set or clear the custom_domain on a lease item (signer must be tenant, authority, or in params.allowed_list). <custom-domain> must be non-empty when not using --clear; --service-name (when supplied) must be a valid RFC 1123 DNS label. <custom-domain> and --clear are mutually exclusive.",
+				args: "<lease-uuid> <custom-domain> [--service-name <name>] OR <lease-uuid> --clear [--service-name <name>]"
 			}
 		]
 	},
@@ -1145,7 +1156,17 @@ function getTxMsgBuilder(module) {
 	if (!moduleInfo) throw new ManifestMCPError(ManifestMCPErrorCode.UNKNOWN_MODULE, `Unknown tx module: ${module}`, { availableModules: Object.keys(TX_MODULES) });
 	return moduleInfo.msgBuilder;
 }
+/**
+* Look up the optional `TxBuildContext` loader for a (module, subcommand)
+* pair. Returns `undefined` when the module is unknown OR when the module
+* doesn't declare a loader for that subcommand — both are normal cases
+* (most txs need no context). Callers are expected to short-circuit on
+* `undefined` and skip the chain read.
+*/
+function getTxContextLoader(module, subcommand) {
+	return TX_MODULES[module]?.contextLoaders?.[subcommand];
+}
 //#endregion
-export { getAvailableModules, getModuleSubcommands, getQueryHandler, getSubcommandUsage, getSupportedModules, getTxHandler, getTxMsgBuilder, isSubcommandSupported, throwUnsupportedSubcommand };
+export { getAvailableModules, getModuleSubcommands, getQueryHandler, getSubcommandUsage, getSupportedModules, getTxContextLoader, getTxHandler, getTxMsgBuilder, isSubcommandSupported, throwUnsupportedSubcommand };
 
 //# sourceMappingURL=modules.js.map