@manifest-network/manifest-mcp-core 0.1.0

package/dist/transactions/utils.js

@@ -0,0 +1,272 @@
+import { ManifestMCPError, ManifestMCPErrorCode } from "../types.js";
+import { DNS_LABEL_RE } from "../validation.js";
+import { fromBech32, fromHex, toHex } from "@cosmjs/encoding";
+//#region src/transactions/utils.ts
+/** Maximum number of arguments allowed */
+const MAX_ARGS = 100;
+/** Maximum meta hash length in bytes (64 bytes for SHA-512) */
+const MAX_META_HASH_BYTES = 64;
+/**
+* Extract a flag value from args array.
+* Returns { value, consumedIndices } or { value: undefined, consumedIndices: [] } if flag not present.
+* Throws if flag is present but value is missing or looks like another flag.
+*
+* @param args - The arguments array to search
+* @param flagName - The flag to look for (e.g., '--memo')
+* @param context - Description for error messages (e.g., 'bank send')
+*/
+function extractFlag(args, flagName, context, errorCode = ManifestMCPErrorCode.TX_FAILED) {
+	const flagIndex = args.indexOf(flagName);
+	if (flagIndex === -1) return {
+		value: void 0,
+		consumedIndices: []
+	};
+	if (args.indexOf(flagName, flagIndex + 1) !== -1) throw new ManifestMCPError(errorCode, `Duplicate ${flagName} flag in ${context}`);
+	const value = args[flagIndex + 1];
+	if (!value || value.startsWith("--")) throw new ManifestMCPError(errorCode, `${flagName} flag requires a value in ${context}`);
+	return {
+		value,
+		consumedIndices: [flagIndex, flagIndex + 1]
+	};
+}
+/**
+* Extract a valueless boolean flag from args array.
+* Returns { value: true, remainingArgs } if flag is present, { value: false, remainingArgs: args } otherwise.
+*
+* @param args - The arguments array to search
+* @param flagName - The flag to look for (e.g., '--active-only')
+* @returns Object with boolean value and filtered args
+*/
+function extractBooleanFlag(args, flagName) {
+	const flagIndex = args.indexOf(flagName);
+	if (flagIndex === -1) return {
+		value: false,
+		remainingArgs: args
+	};
+	return {
+		value: true,
+		remainingArgs: args.filter((_, index) => index !== flagIndex)
+	};
+}
+/**
+* Filter args to remove consumed flag indices
+*/
+function filterConsumedArgs(args, consumedIndices) {
+	if (consumedIndices.length === 0) return args;
+	const consumedSet = new Set(consumedIndices);
+	return args.filter((_, index) => !consumedSet.has(index));
+}
+/** Maximum memo length (Cosmos SDK default) */
+const MAX_MEMO_LENGTH = 256;
+/**
+* Parse a colon-separated pair (e.g., "address:amount", "sku:quantity").
+* Throws with helpful error if format is invalid.
+*
+* @param input - The string to parse (e.g., "manifest1abc:1000umfx")
+* @param leftName - Name of the left value for error messages (e.g., "address")
+* @param rightName - Name of the right value for error messages (e.g., "amount")
+* @param context - Context for error messages (e.g., "multi-send pair")
+* @returns Tuple of [left, right] values
+*/
+function parseColonPair(input, leftName, rightName, context) {
+	const colonIndex = input.indexOf(":");
+	if (colonIndex === -1) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid ${context} format: "${input}". Missing colon separator. Expected format: ${leftName}:${rightName}`);
+	if (colonIndex === 0) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid ${context} format: "${input}". Missing ${leftName}. Expected format: ${leftName}:${rightName}`);
+	if (colonIndex === input.length - 1) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid ${context} format: "${input}". Missing ${rightName}. Expected format: ${leftName}:${rightName}`);
+	return [input.slice(0, colonIndex), input.slice(colonIndex + 1)];
+}
+/**
+* Validate args array length (max limit)
+*/
+function validateArgsLength(args, context) {
+	if (args.length > 100) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Too many arguments for ${context}: ${args.length}. Maximum allowed: 100`);
+}
+/**
+* Validate that required arguments are present.
+* Provides helpful error messages with received vs expected args.
+*
+* @param args - The arguments array to validate
+* @param minCount - Minimum number of required arguments
+* @param expectedNames - Names of expected arguments for error messages
+* @param context - Context for error messages (e.g., 'bank send', 'staking delegate')
+* @param errorCode - Error code to use (defaults to TX_FAILED)
+* @throws ManifestMCPError if args.length < minCount
+*/
+function requireArgs(args, minCount, expectedNames, context, errorCode = ManifestMCPErrorCode.TX_FAILED) {
+	if (args.length >= minCount) return;
+	const expectedList = expectedNames.slice(0, minCount).join(", ");
+	const receivedList = args.length === 0 ? "none" : args.map((a) => `"${a}"`).join(", ");
+	throw new ManifestMCPError(errorCode, `${context} requires ${minCount} argument(s): ${expectedList}. Received ${args.length}: ${receivedList}`, {
+		expectedArgs: expectedNames.slice(0, minCount),
+		receivedArgs: args,
+		receivedCount: args.length,
+		requiredCount: minCount
+	});
+}
+/**
+* Validate a bech32 address using @cosmjs/encoding
+*/
+function validateAddress(address, fieldName, expectedPrefix) {
+	if (!address || address.trim() === "") throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_ADDRESS, `${fieldName} is required`);
+	try {
+		const { prefix } = fromBech32(address);
+		if (expectedPrefix && prefix !== expectedPrefix) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_ADDRESS, `Invalid ${fieldName}: "${address}". Expected prefix "${expectedPrefix}", got "${prefix}"`);
+	} catch (error) {
+		if (error instanceof ManifestMCPError) throw error;
+		throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_ADDRESS, `Invalid ${fieldName}: "${address}". Not a valid bech32 address.`);
+	}
+}
+/**
+* Validate memo length
+*/
+function validateMemo(memo) {
+	if (memo.length > 256) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Memo too long: ${memo.length} characters. Maximum allowed: 256`);
+}
+/**
+* Parse and validate a hex string into Uint8Array.
+* Uses @cosmjs/encoding for browser compatibility.
+*
+* @param hexString - The hex string to parse
+* @param fieldName - Name of the field for error messages
+* @param maxBytes - Maximum allowed byte length
+* @param errorCode - Error code to use (defaults to TX_FAILED)
+* @returns Uint8Array of the parsed bytes
+*/
+function parseHexBytes(hexString, fieldName, maxBytes, errorCode = ManifestMCPErrorCode.TX_FAILED) {
+	if (!hexString || hexString.trim() === "") throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: empty value. Expected a hex string.`);
+	if (hexString.length % 2 !== 0) throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: hex string must have even length. Got ${hexString.length} characters.`);
+	const byteLength = hexString.length / 2;
+	if (byteLength > maxBytes) throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: exceeds maximum ${maxBytes} bytes. Got ${byteLength} bytes (${hexString.length} hex chars).`);
+	try {
+		return fromHex(hexString);
+	} catch (_error) {
+		throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: "${hexString}". Must contain only hexadecimal characters (0-9, a-f, A-F).`);
+	}
+}
+/**
+* Convert Uint8Array to hex string.
+* Uses @cosmjs/encoding for browser compatibility.
+*/
+function bytesToHex(bytes) {
+	return toHex(bytes);
+}
+/**
+* Safely parse a string to BigInt with proper error handling and configurable error code.
+* This is the base implementation used by both transaction and query utilities.
+*/
+function parseBigIntWithCode(value, fieldName, errorCode) {
+	if (!value || value.trim() === "") throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: empty value. Expected a valid integer.`);
+	try {
+		return BigInt(value);
+	} catch {
+		throw new ManifestMCPError(errorCode, `Invalid ${fieldName}: "${value}". Expected a valid integer.`);
+	}
+}
+/**
+* Safely parse a string to BigInt with proper error handling (for transactions)
+*/
+function parseBigInt(value, fieldName) {
+	return parseBigIntWithCode(value, fieldName, ManifestMCPErrorCode.TX_FAILED);
+}
+/**
+* Parse a vote option string to its numeric enum value.
+* Accepts case-insensitive strings or numeric identifiers.
+*
+* @param optionStr - Vote option string (yes, no, abstain, no_with_veto, or 1-4)
+* @param voteOptionEnum - The VoteOption enum object from the relevant cosmos module
+*/
+function parseVoteOption(optionStr, voteOptionEnum) {
+	switch (optionStr.toLowerCase()) {
+		case "yes":
+		case "1": return voteOptionEnum.VOTE_OPTION_YES;
+		case "abstain":
+		case "2": return voteOptionEnum.VOTE_OPTION_ABSTAIN;
+		case "no":
+		case "3": return voteOptionEnum.VOTE_OPTION_NO;
+		case "no_with_veto":
+		case "nowithveto":
+		case "4": return voteOptionEnum.VOTE_OPTION_NO_WITH_VETO;
+		default: throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid vote option: ${optionStr}. Expected: yes, no, abstain, or no_with_veto`);
+	}
+}
+/**
+* Parse a lease item string in the format "sku-uuid:quantity" or "sku-uuid:quantity:service-name".
+* The service-name is optional and used for stack (multi-service) deployments.
+*
+* @param input - The string to parse (e.g., "sku-123:1" or "sku-123:1:web")
+* @returns Parsed lease item with skuUuid, quantity, and serviceName
+*/
+function parseLeaseItem(input) {
+	const parts = input.split(":");
+	if (parts.length < 2 || parts.length > 3) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid lease item format: "${input}". Expected sku-uuid:quantity or sku-uuid:quantity:service-name`);
+	const [skuUuid, quantityStr, serviceName] = parts;
+	if (!skuUuid) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid lease item format: "${input}". Missing sku-uuid.`);
+	if (!quantityStr) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid lease item format: "${input}". Missing quantity.`);
+	const quantity = parseBigInt(quantityStr, "quantity");
+	if (serviceName !== void 0) {
+		if (!serviceName) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid lease item format: "${input}". Empty service-name after trailing colon.`);
+		if (!DNS_LABEL_RE.test(serviceName)) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid service name: "${serviceName}". Must be a valid RFC 1123 DNS label: 1-63 lowercase alphanumeric characters or hyphens, must not start or end with a hyphen.`);
+	}
+	return {
+		skuUuid,
+		quantity,
+		serviceName: serviceName ?? ""
+	};
+}
+/**
+* Parse amount string into coin (e.g., "1000umfx" -> { amount: "1000", denom: "umfx" })
+* Supports simple denoms (umfx), IBC denoms (ibc/...), and factory denoms (factory/creator/subdenom)
+*/
+function parseAmount(amountStr) {
+	const match = amountStr.match(/^(\d+)([a-zA-Z][a-zA-Z0-9/_-]*)$/);
+	if (!match) {
+		let hint = "";
+		if (!amountStr || amountStr.trim() === "") hint = " Received empty string.";
+		else if (amountStr.includes(" ")) hint = " Remove the space between number and denom.";
+		else if (amountStr.includes(",")) hint = " Do not use commas in the number.";
+		else if (/^\d+$/.test(amountStr)) hint = " Missing denomination (e.g., add \"umfx\" after the number).";
+		else if (/^[a-zA-Z]/.test(amountStr)) hint = " Amount must start with a number, not the denomination.";
+		throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Invalid amount format: "${amountStr}".${hint} Expected format: <number><denom> (e.g., "1000000umfx" or "1000000factory/address/subdenom")`, {
+			receivedValue: amountStr,
+			expectedFormat: "<number><denom>",
+			example: "1000000umfx"
+		});
+	}
+	return {
+		amount: match[1],
+		denom: match[2]
+	};
+}
+/**
+* Build transaction result from DeliverTxResponse.
+* Throws ManifestMCPError if the transaction failed on-chain (non-zero code).
+*/
+function buildTxResult(module, subcommand, result, waitForConfirmation) {
+	if (result.code !== 0) throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Transaction ${module} ${subcommand} failed with code ${result.code}: ${result.rawLog || "no details"}`, {
+		module,
+		subcommand,
+		code: result.code,
+		transactionHash: result.transactionHash,
+		rawLog: result.rawLog,
+		height: String(result.height)
+	});
+	return {
+		module,
+		subcommand,
+		transactionHash: result.transactionHash,
+		code: result.code,
+		height: String(result.height),
+		rawLog: result.rawLog || void 0,
+		gasUsed: String(result.gasUsed),
+		gasWanted: String(result.gasWanted),
+		events: result.events,
+		...waitForConfirmation && {
+			confirmed: true,
+			confirmationHeight: String(result.height)
+		}
+	};
+}
+//#endregion
+export { MAX_ARGS, MAX_MEMO_LENGTH, MAX_META_HASH_BYTES, buildTxResult, bytesToHex, extractBooleanFlag, extractFlag, filterConsumedArgs, parseAmount, parseBigInt, parseBigIntWithCode, parseColonPair, parseHexBytes, parseLeaseItem, parseVoteOption, requireArgs, validateAddress, validateArgsLength, validateMemo };
+
+//# sourceMappingURL=utils.js.map

package/dist/transactions/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/transactions/utils.ts"],"sourcesContent":["import { fromBech32, fromHex, toHex } from '@cosmjs/encoding';\nimport type { SigningStargateClient } from '@cosmjs/stargate';\nimport {\n  type CosmosTxResult,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n} from '../types.js';\nimport { DNS_LABEL_RE } from '../validation.js';\n\n/** Maximum number of arguments allowed */\nexport const MAX_ARGS = 100;\n\n/** Maximum meta hash length in bytes (64 bytes for SHA-512) */\nexport const MAX_META_HASH_BYTES = 64;\n\n/**\n * Result from extracting a flag from args\n */\nexport interface ExtractedFlag {\n  /** The flag value, or undefined if flag not present */\n  value: string | undefined;\n  /** Indices consumed by the flag and its value (for filtering) */\n  consumedIndices: number[];\n}\n\n/**\n * Extract a flag value from args array.\n * Returns { value, consumedIndices } or { value: undefined, consumedIndices: [] } if flag not present.\n * Throws if flag is present but value is missing or looks like another flag.\n *\n * @param args - The arguments array to search\n * @param flagName - The flag to look for (e.g., '--memo')\n * @param context - Description for error messages (e.g., 'bank send')\n */\nexport function extractFlag(\n  args: string[],\n  flagName: string,\n  context: string,\n  errorCode: ManifestMCPErrorCode = ManifestMCPErrorCode.TX_FAILED,\n): ExtractedFlag {\n  const flagIndex = args.indexOf(flagName);\n  if (flagIndex === -1) {\n    return { value: undefined, consumedIndices: [] };\n  }\n\n  // Detect duplicate flags\n  if (args.indexOf(flagName, flagIndex + 1) !== -1) {\n    throw new ManifestMCPError(\n      errorCode,\n      `Duplicate ${flagName} flag in ${context}`,\n    );\n  }\n\n  const value = args[flagIndex + 1];\n  if (!value || value.startsWith('--')) {\n    throw new ManifestMCPError(\n      errorCode,\n      `${flagName} flag requires a value in ${context}`,\n    );\n  }\n\n  return { value, consumedIndices: [flagIndex, flagIndex + 1] };\n}\n\n/**\n * Result from extracting a boolean (valueless) flag from args\n */\nexport interface ExtractedBooleanFlag {\n  /** Whether the flag was present */\n  value: boolean;\n  /** Args with the flag removed */\n  remainingArgs: string[];\n}\n\n/**\n * Extract a valueless boolean flag from args array.\n * Returns { value: true, remainingArgs } if flag is present, { value: false, remainingArgs: args } otherwise.\n *\n * @param args - The arguments array to search\n * @param flagName - The flag to look for (e.g., '--active-only')\n * @returns Object with boolean value and filtered args\n */\nexport function extractBooleanFlag(\n  args: string[],\n  flagName: string,\n): ExtractedBooleanFlag {\n  const flagIndex = args.indexOf(flagName);\n  if (flagIndex === -1) {\n    return { value: false, remainingArgs: args };\n  }\n  const remainingArgs = args.filter((_, index) => index !== flagIndex);\n  return { value: true, remainingArgs };\n}\n\n/**\n * Filter args to remove consumed flag indices\n */\nexport function filterConsumedArgs(\n  args: string[],\n  consumedIndices: number[],\n): string[] {\n  if (consumedIndices.length === 0) {\n    return args;\n  }\n  const consumedSet = new Set(consumedIndices);\n  return args.filter((_, index) => !consumedSet.has(index));\n}\n\n/** Maximum memo length (Cosmos SDK default) */\nexport const MAX_MEMO_LENGTH = 256;\n\n/**\n * Parse a colon-separated pair (e.g., \"address:amount\", \"sku:quantity\").\n * Throws with helpful error if format is invalid.\n *\n * @param input - The string to parse (e.g., \"manifest1abc:1000umfx\")\n * @param leftName - Name of the left value for error messages (e.g., \"address\")\n * @param rightName - Name of the right value for error messages (e.g., \"amount\")\n * @param context - Context for error messages (e.g., \"multi-send pair\")\n * @returns Tuple of [left, right] values\n */\nexport function parseColonPair(\n  input: string,\n  leftName: string,\n  rightName: string,\n  context: string,\n): [string, string] {\n  const colonIndex = input.indexOf(':');\n  if (colonIndex === -1) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Invalid ${context} format: \"${input}\". Missing colon separator. Expected format: ${leftName}:${rightName}`,\n    );\n  }\n  if (colonIndex === 0) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Invalid ${context} format: \"${input}\". Missing ${leftName}. Expected format: ${leftName}:${rightName}`,\n    );\n  }\n  if (colonIndex === input.length - 1) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Invalid ${context} format: \"${input}\". Missing ${rightName}. Expected format: ${leftName}:${rightName}`,\n    );\n  }\n  return [input.slice(0, colonIndex), input.slice(colonIndex + 1)];\n}\n\n/**\n * Validate args array length (max limit)\n */\nexport function validateArgsLength(args: string[], context: string): void {\n  if (args.length > MAX_ARGS) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Too many arguments for ${context}: ${args.length}. Maximum allowed: ${MAX_ARGS}`,\n    );\n  }\n}\n\n/**\n * Validate that required arguments are present.\n * Provides helpful error messages with received vs expected args.\n *\n * @param args - The arguments array to validate\n * @param minCount - Minimum number of required arguments\n * @param expectedNames - Names of expected arguments for error messages\n * @param context - Context for error messages (e.g., 'bank send', 'staking delegate')\n * @param errorCode - Error code to use (defaults to TX_FAILED)\n * @throws ManifestMCPError if args.length < minCount\n */\nexport function requireArgs(\n  args: string[],\n  minCount: number,\n  expectedNames: string[],\n  context: string,\n  errorCode: ManifestMCPErrorCode = ManifestMCPErrorCode.TX_FAILED,\n): void {\n  if (args.length >= minCount) {\n    return;\n  }\n\n  const expectedList = expectedNames.slice(0, minCount).join(', ');\n  const receivedList =\n    args.length === 0 ? 'none' : args.map((a) => `\"${a}\"`).join(', ');\n\n  throw new ManifestMCPError(\n    errorCode,\n    `${context} requires ${minCount} argument(s): ${expectedList}. Received ${args.length}: ${receivedList}`,\n    {\n      expectedArgs: expectedNames.slice(0, minCount),\n      receivedArgs: args,\n      receivedCount: args.length,\n      requiredCount: minCount,\n    },\n  );\n}\n\n/**\n * Validate a bech32 address using @cosmjs/encoding\n */\nexport function validateAddress(\n  address: string,\n  fieldName: string,\n  expectedPrefix?: string,\n): void {\n  if (!address || address.trim() === '') {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_ADDRESS,\n      `${fieldName} is required`,\n    );\n  }\n\n  try {\n    const { prefix } = fromBech32(address);\n    if (expectedPrefix && prefix !== expectedPrefix) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_ADDRESS,\n        `Invalid ${fieldName}: \"${address}\". Expected prefix \"${expectedPrefix}\", got \"${prefix}\"`,\n      );\n    }\n  } catch (error) {\n    if (error instanceof ManifestMCPError) {\n      throw error;\n    }\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_ADDRESS,\n      `Invalid ${fieldName}: \"${address}\". Not a valid bech32 address.`,\n    );\n  }\n}\n\n/**\n * Validate memo length\n */\nexport function validateMemo(memo: string): void {\n  if (memo.length > MAX_MEMO_LENGTH) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Memo too long: ${memo.length} characters. Maximum allowed: ${MAX_MEMO_LENGTH}`,\n    );\n  }\n}\n\n/**\n * Parse and validate a hex string into Uint8Array.\n * Uses @cosmjs/encoding for browser compatibility.\n *\n * @param hexString - The hex string to parse\n * @param fieldName - Name of the field for error messages\n * @param maxBytes - Maximum allowed byte length\n * @param errorCode - Error code to use (defaults to TX_FAILED)\n * @returns Uint8Array of the parsed bytes\n */\nexport function parseHexBytes(\n  hexString: string,\n  fieldName: string,\n  maxBytes: number,\n  errorCode: ManifestMCPErrorCode = ManifestMCPErrorCode.TX_FAILED,\n): Uint8Array {\n  // Check for empty string\n  if (!hexString || hexString.trim() === '') {\n    throw new ManifestMCPError(\n      errorCode,\n      `Invalid ${fieldName}: empty value. Expected a hex string.`,\n    );\n  }\n\n  // Check even length (each byte is 2 hex chars)\n  if (hexString.length % 2 !== 0) {\n    throw new ManifestMCPError(\n      errorCode,\n      `Invalid ${fieldName}: hex string must have even length. Got ${hexString.length} characters.`,\n    );\n  }\n\n  // Check max length\n  const byteLength = hexString.length / 2;\n  if (byteLength > maxBytes) {\n    throw new ManifestMCPError(\n      errorCode,\n      `Invalid ${fieldName}: exceeds maximum ${maxBytes} bytes. Got ${byteLength} bytes (${hexString.length} hex chars).`,\n    );\n  }\n\n  // Use @cosmjs/encoding for browser-compatible hex parsing\n  try {\n    return fromHex(hexString);\n  } catch (_error) {\n    throw new ManifestMCPError(\n      errorCode,\n      `Invalid ${fieldName}: \"${hexString}\". Must contain only hexadecimal characters (0-9, a-f, A-F).`,\n    );\n  }\n}\n\n/**\n * Convert Uint8Array to hex string.\n * Uses @cosmjs/encoding for browser compatibility.\n */\nexport function bytesToHex(bytes: Uint8Array): string {\n  return toHex(bytes);\n}\n\n/**\n * Safely parse a string to BigInt with proper error handling and configurable error code.\n * This is the base implementation used by both transaction and query utilities.\n */\nexport function parseBigIntWithCode(\n  value: string,\n  fieldName: string,\n  errorCode: ManifestMCPErrorCode,\n): bigint {\n  // Check for empty string explicitly (BigInt('') returns 0n, not an error)\n  if (!value || value.trim() === '') {\n    throw new ManifestMCPError(\n      errorCode,\n      `Invalid ${fieldName}: empty value. Expected a valid integer.`,\n    );\n  }\n\n  try {\n    return BigInt(value);\n  } catch {\n    throw new ManifestMCPError(\n      errorCode,\n      `Invalid ${fieldName}: \"${value}\". Expected a valid integer.`,\n    );\n  }\n}\n\n/**\n * Safely parse a string to BigInt with proper error handling (for transactions)\n */\nexport function parseBigInt(value: string, fieldName: string): bigint {\n  return parseBigIntWithCode(value, fieldName, ManifestMCPErrorCode.TX_FAILED);\n}\n\n/**\n * Interface for VoteOption-like enums from cosmos protobuf modules.\n * Both cosmos.gov.v1.VoteOption and cosmos.group.v1.VoteOption share this shape.\n */\ninterface VoteOptionEnum {\n  VOTE_OPTION_YES: number;\n  VOTE_OPTION_ABSTAIN: number;\n  VOTE_OPTION_NO: number;\n  VOTE_OPTION_NO_WITH_VETO: number;\n}\n\n/**\n * Parse a vote option string to its numeric enum value.\n * Accepts case-insensitive strings or numeric identifiers.\n *\n * @param optionStr - Vote option string (yes, no, abstain, no_with_veto, or 1-4)\n * @param voteOptionEnum - The VoteOption enum object from the relevant cosmos module\n */\nexport function parseVoteOption(\n  optionStr: string,\n  voteOptionEnum: VoteOptionEnum,\n): number {\n  const option = optionStr.toLowerCase();\n  switch (option) {\n    case 'yes':\n    case '1':\n      return voteOptionEnum.VOTE_OPTION_YES;\n    case 'abstain':\n    case '2':\n      return voteOptionEnum.VOTE_OPTION_ABSTAIN;\n    case 'no':\n    case '3':\n      return voteOptionEnum.VOTE_OPTION_NO;\n    case 'no_with_veto':\n    case 'nowithveto':\n    case '4':\n      return voteOptionEnum.VOTE_OPTION_NO_WITH_VETO;\n    default:\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.TX_FAILED,\n        `Invalid vote option: ${optionStr}. Expected: yes, no, abstain, or no_with_veto`,\n      );\n  }\n}\n\n/**\n * Parsed lease item with optional service name for stack deployments.\n */\nexport interface ParsedLeaseItem {\n  skuUuid: string;\n  quantity: bigint;\n  serviceName: string;\n}\n\n/**\n * Parse a lease item string in the format \"sku-uuid:quantity\" or \"sku-uuid:quantity:service-name\".\n * The service-name is optional and used for stack (multi-service) deployments.\n *\n * @param input - The string to parse (e.g., \"sku-123:1\" or \"sku-123:1:web\")\n * @returns Parsed lease item with skuUuid, quantity, and serviceName\n */\nexport function parseLeaseItem(input: string): ParsedLeaseItem {\n  const parts = input.split(':');\n  if (parts.length < 2 || parts.length > 3) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Invalid lease item format: \"${input}\". Expected sku-uuid:quantity or sku-uuid:quantity:service-name`,\n    );\n  }\n\n  const [skuUuid, quantityStr, serviceName] = parts;\n\n  if (!skuUuid) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Invalid lease item format: \"${input}\". Missing sku-uuid.`,\n    );\n  }\n\n  if (!quantityStr) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Invalid lease item format: \"${input}\". Missing quantity.`,\n    );\n  }\n\n  const quantity = parseBigInt(quantityStr, 'quantity');\n\n  if (serviceName !== undefined) {\n    if (!serviceName) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.TX_FAILED,\n        `Invalid lease item format: \"${input}\". Empty service-name after trailing colon.`,\n      );\n    }\n    if (!DNS_LABEL_RE.test(serviceName)) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.TX_FAILED,\n        `Invalid service name: \"${serviceName}\". Must be a valid RFC 1123 DNS label: ` +\n          `1-63 lowercase alphanumeric characters or hyphens, must not start or end with a hyphen.`,\n      );\n    }\n  }\n\n  return { skuUuid, quantity, serviceName: serviceName ?? '' };\n}\n\n/**\n * Parse amount string into coin (e.g., \"1000umfx\" -> { amount: \"1000\", denom: \"umfx\" })\n * Supports simple denoms (umfx), IBC denoms (ibc/...), and factory denoms (factory/creator/subdenom)\n */\nexport function parseAmount(amountStr: string): {\n  amount: string;\n  denom: string;\n} {\n  // Regex supports alphanumeric denoms with slashes, underscores, and hyphens for IBC/factory denoms\n  const match = amountStr.match(/^(\\d+)([a-zA-Z][a-zA-Z0-9/_-]*)$/);\n  if (!match) {\n    // Provide specific hints based on common mistakes\n    let hint = '';\n    if (!amountStr || amountStr.trim() === '') {\n      hint = ' Received empty string.';\n    } else if (amountStr.includes(' ')) {\n      hint = ' Remove the space between number and denom.';\n    } else if (amountStr.includes(',')) {\n      hint = ' Do not use commas in the number.';\n    } else if (/^\\d+$/.test(amountStr)) {\n      hint = ' Missing denomination (e.g., add \"umfx\" after the number).';\n    } else if (/^[a-zA-Z]/.test(amountStr)) {\n      hint = ' Amount must start with a number, not the denomination.';\n    }\n\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Invalid amount format: \"${amountStr}\".${hint} Expected format: <number><denom> (e.g., \"1000000umfx\" or \"1000000factory/address/subdenom\")`,\n      {\n        receivedValue: amountStr,\n        expectedFormat: '<number><denom>',\n        example: '1000000umfx',\n      },\n    );\n  }\n  return { amount: match[1], denom: match[2] };\n}\n\n/**\n * Build transaction result from DeliverTxResponse.\n * Throws ManifestMCPError if the transaction failed on-chain (non-zero code).\n */\nexport function buildTxResult(\n  module: string,\n  subcommand: string,\n  result: Awaited<ReturnType<SigningStargateClient['signAndBroadcast']>>,\n  waitForConfirmation: boolean,\n): CosmosTxResult {\n  if (result.code !== 0) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.TX_FAILED,\n      `Transaction ${module} ${subcommand} failed with code ${result.code}: ${result.rawLog || 'no details'}`,\n      {\n        module,\n        subcommand,\n        code: result.code,\n        transactionHash: result.transactionHash,\n        rawLog: result.rawLog,\n        height: String(result.height),\n      },\n    );\n  }\n\n  return {\n    module,\n    subcommand,\n    transactionHash: result.transactionHash,\n    code: result.code,\n    height: String(result.height),\n    rawLog: result.rawLog || undefined,\n    gasUsed: String(result.gasUsed),\n    gasWanted: String(result.gasWanted),\n    events: result.events,\n    ...(waitForConfirmation && {\n      confirmed: true,\n      confirmationHeight: String(result.height),\n    }),\n  };\n}\n"],"mappings":";;;;;AAUA,MAAa,WAAW;;AAGxB,MAAa,sBAAsB;;;;;;;;;;AAqBnC,SAAgB,YACd,MACA,UACA,SACA,YAAkC,qBAAqB,WACxC;CACf,MAAM,YAAY,KAAK,QAAQ,SAAS;AACxC,KAAI,cAAc,GAChB,QAAO;EAAE,OAAO,KAAA;EAAW,iBAAiB,EAAE;EAAE;AAIlD,KAAI,KAAK,QAAQ,UAAU,YAAY,EAAE,KAAK,GAC5C,OAAM,IAAI,iBACR,WACA,aAAa,SAAS,WAAW,UAClC;CAGH,MAAM,QAAQ,KAAK,YAAY;AAC/B,KAAI,CAAC,SAAS,MAAM,WAAW,KAAK,CAClC,OAAM,IAAI,iBACR,WACA,GAAG,SAAS,4BAA4B,UACzC;AAGH,QAAO;EAAE;EAAO,iBAAiB,CAAC,WAAW,YAAY,EAAE;EAAE;;;;;;;;;;AAqB/D,SAAgB,mBACd,MACA,UACsB;CACtB,MAAM,YAAY,KAAK,QAAQ,SAAS;AACxC,KAAI,cAAc,GAChB,QAAO;EAAE,OAAO;EAAO,eAAe;EAAM;AAG9C,QAAO;EAAE,OAAO;EAAM,eADA,KAAK,QAAQ,GAAG,UAAU,UAAU,UAAU;EAC/B;;;;;AAMvC,SAAgB,mBACd,MACA,iBACU;AACV,KAAI,gBAAgB,WAAW,EAC7B,QAAO;CAET,MAAM,cAAc,IAAI,IAAI,gBAAgB;AAC5C,QAAO,KAAK,QAAQ,GAAG,UAAU,CAAC,YAAY,IAAI,MAAM,CAAC;;;AAI3D,MAAa,kBAAkB;;;;;;;;;;;AAY/B,SAAgB,eACd,OACA,UACA,WACA,SACkB;CAClB,MAAM,aAAa,MAAM,QAAQ,IAAI;AACrC,KAAI,eAAe,GACjB,OAAM,IAAI,iBACR,qBAAqB,WACrB,WAAW,QAAQ,YAAY,MAAM,+CAA+C,SAAS,GAAG,YACjG;AAEH,KAAI,eAAe,EACjB,OAAM,IAAI,iBACR,qBAAqB,WACrB,WAAW,QAAQ,YAAY,MAAM,aAAa,SAAS,qBAAqB,SAAS,GAAG,YAC7F;AAEH,KAAI,eAAe,MAAM,SAAS,EAChC,OAAM,IAAI,iBACR,qBAAqB,WACrB,WAAW,QAAQ,YAAY,MAAM,aAAa,UAAU,qBAAqB,SAAS,GAAG,YAC9F;AAEH,QAAO,CAAC,MAAM,MAAM,GAAG,WAAW,EAAE,MAAM,MAAM,aAAa,EAAE,CAAC;;;;;AAMlE,SAAgB,mBAAmB,MAAgB,SAAuB;AACxE,KAAI,KAAK,SAAA,IACP,OAAM,IAAI,iBACR,qBAAqB,WACrB,0BAA0B,QAAQ,IAAI,KAAK,OAAO,wBACnD;;;;;;;;;;;;;AAeL,SAAgB,YACd,MACA,UACA,eACA,SACA,YAAkC,qBAAqB,WACjD;AACN,KAAI,KAAK,UAAU,SACjB;CAGF,MAAM,eAAe,cAAc,MAAM,GAAG,SAAS,CAAC,KAAK,KAAK;CAChE,MAAM,eACJ,KAAK,WAAW,IAAI,SAAS,KAAK,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK;AAEnE,OAAM,IAAI,iBACR,WACA,GAAG,QAAQ,YAAY,SAAS,gBAAgB,aAAa,aAAa,KAAK,OAAO,IAAI,gBAC1F;EACE,cAAc,cAAc,MAAM,GAAG,SAAS;EAC9C,cAAc;EACd,eAAe,KAAK;EACpB,eAAe;EAChB,CACF;;;;;AAMH,SAAgB,gBACd,SACA,WACA,gBACM;AACN,KAAI,CAAC,WAAW,QAAQ,MAAM,KAAK,GACjC,OAAM,IAAI,iBACR,qBAAqB,iBACrB,GAAG,UAAU,cACd;AAGH,KAAI;EACF,MAAM,EAAE,WAAW,WAAW,QAAQ;AACtC,MAAI,kBAAkB,WAAW,eAC/B,OAAM,IAAI,iBACR,qBAAqB,iBACrB,WAAW,UAAU,KAAK,QAAQ,sBAAsB,eAAe,UAAU,OAAO,GACzF;UAEI,OAAO;AACd,MAAI,iBAAiB,iBACnB,OAAM;AAER,QAAM,IAAI,iBACR,qBAAqB,iBACrB,WAAW,UAAU,KAAK,QAAQ,gCACnC;;;;;;AAOL,SAAgB,aAAa,MAAoB;AAC/C,KAAI,KAAK,SAAA,IACP,OAAM,IAAI,iBACR,qBAAqB,WACrB,kBAAkB,KAAK,OAAO,mCAC/B;;;;;;;;;;;;AAcL,SAAgB,cACd,WACA,WACA,UACA,YAAkC,qBAAqB,WAC3C;AAEZ,KAAI,CAAC,aAAa,UAAU,MAAM,KAAK,GACrC,OAAM,IAAI,iBACR,WACA,WAAW,UAAU,uCACtB;AAIH,KAAI,UAAU,SAAS,MAAM,EAC3B,OAAM,IAAI,iBACR,WACA,WAAW,UAAU,0CAA0C,UAAU,OAAO,cACjF;CAIH,MAAM,aAAa,UAAU,SAAS;AACtC,KAAI,aAAa,SACf,OAAM,IAAI,iBACR,WACA,WAAW,UAAU,oBAAoB,SAAS,cAAc,WAAW,UAAU,UAAU,OAAO,cACvG;AAIH,KAAI;AACF,SAAO,QAAQ,UAAU;UAClB,QAAQ;AACf,QAAM,IAAI,iBACR,WACA,WAAW,UAAU,KAAK,UAAU,8DACrC;;;;;;;AAQL,SAAgB,WAAW,OAA2B;AACpD,QAAO,MAAM,MAAM;;;;;;AAOrB,SAAgB,oBACd,OACA,WACA,WACQ;AAER,KAAI,CAAC,SAAS,MAAM,MAAM,KAAK,GAC7B,OAAM,IAAI,iBACR,WACA,WAAW,UAAU,0CACtB;AAGH,KAAI;AACF,SAAO,OAAO,MAAM;SACd;AACN,QAAM,IAAI,iBACR,WACA,WAAW,UAAU,KAAK,MAAM,8BACjC;;;;;;AAOL,SAAgB,YAAY,OAAe,WAA2B;AACpE,QAAO,oBAAoB,OAAO,WAAW,qBAAqB,UAAU;;;;;;;;;AAqB9E,SAAgB,gBACd,WACA,gBACQ;AAER,SADe,UAAU,aAAa,EACtC;EACE,KAAK;EACL,KAAK,IACH,QAAO,eAAe;EACxB,KAAK;EACL,KAAK,IACH,QAAO,eAAe;EACxB,KAAK;EACL,KAAK,IACH,QAAO,eAAe;EACxB,KAAK;EACL,KAAK;EACL,KAAK,IACH,QAAO,eAAe;EACxB,QACE,OAAM,IAAI,iBACR,qBAAqB,WACrB,wBAAwB,UAAU,+CACnC;;;;;;;;;;AAoBP,SAAgB,eAAe,OAAgC;CAC7D,MAAM,QAAQ,MAAM,MAAM,IAAI;AAC9B,KAAI,MAAM,SAAS,KAAK,MAAM,SAAS,EACrC,OAAM,IAAI,iBACR,qBAAqB,WACrB,+BAA+B,MAAM,iEACtC;CAGH,MAAM,CAAC,SAAS,aAAa,eAAe;AAE5C,KAAI,CAAC,QACH,OAAM,IAAI,iBACR,qBAAqB,WACrB,+BAA+B,MAAM,sBACtC;AAGH,KAAI,CAAC,YACH,OAAM,IAAI,iBACR,qBAAqB,WACrB,+BAA+B,MAAM,sBACtC;CAGH,MAAM,WAAW,YAAY,aAAa,WAAW;AAErD,KAAI,gBAAgB,KAAA,GAAW;AAC7B,MAAI,CAAC,YACH,OAAM,IAAI,iBACR,qBAAqB,WACrB,+BAA+B,MAAM,6CACtC;AAEH,MAAI,CAAC,aAAa,KAAK,YAAY,CACjC,OAAM,IAAI,iBACR,qBAAqB,WACrB,0BAA0B,YAAY,gIAEvC;;AAIL,QAAO;EAAE;EAAS;EAAU,aAAa,eAAe;EAAI;;;;;;AAO9D,SAAgB,YAAY,WAG1B;CAEA,MAAM,QAAQ,UAAU,MAAM,mCAAmC;AACjE,KAAI,CAAC,OAAO;EAEV,IAAI,OAAO;AACX,MAAI,CAAC,aAAa,UAAU,MAAM,KAAK,GACrC,QAAO;WACE,UAAU,SAAS,IAAI,CAChC,QAAO;WACE,UAAU,SAAS,IAAI,CAChC,QAAO;WACE,QAAQ,KAAK,UAAU,CAChC,QAAO;WACE,YAAY,KAAK,UAAU,CACpC,QAAO;AAGT,QAAM,IAAI,iBACR,qBAAqB,WACrB,2BAA2B,UAAU,IAAI,KAAK,+FAC9C;GACE,eAAe;GACf,gBAAgB;GAChB,SAAS;GACV,CACF;;AAEH,QAAO;EAAE,QAAQ,MAAM;EAAI,OAAO,MAAM;EAAI;;;;;;AAO9C,SAAgB,cACd,QACA,YACA,QACA,qBACgB;AAChB,KAAI,OAAO,SAAS,EAClB,OAAM,IAAI,iBACR,qBAAqB,WACrB,eAAe,OAAO,GAAG,WAAW,oBAAoB,OAAO,KAAK,IAAI,OAAO,UAAU,gBACzF;EACE;EACA;EACA,MAAM,OAAO;EACb,iBAAiB,OAAO;EACxB,QAAQ,OAAO;EACf,QAAQ,OAAO,OAAO,OAAO;EAC9B,CACF;AAGH,QAAO;EACL;EACA;EACA,iBAAiB,OAAO;EACxB,MAAM,OAAO;EACb,QAAQ,OAAO,OAAO,OAAO;EAC7B,QAAQ,OAAO,UAAU,KAAA;EACzB,SAAS,OAAO,OAAO,QAAQ;EAC/B,WAAW,OAAO,OAAO,UAAU;EACnC,QAAQ,OAAO;EACf,GAAI,uBAAuB;GACzB,WAAW;GACX,oBAAoB,OAAO,OAAO,OAAO;GAC1C;EACF"}