@manifest-network/manifest-mcp-core 0.7.0 → 0.9.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__/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/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,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, 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";
+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";
@@ -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, 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";
@@ -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, validateEndpointUrl, 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