@manifest-network/manifest-mcp-core 0.1.0

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { Registry } from '@cosmjs/proto-signing';\nimport {\n  AminoTypes,\n  GasPrice,\n  type HttpEndpoint,\n  SigningStargateClient,\n} from '@cosmjs/stargate';\nimport {\n  cosmosAminoConverters,\n  cosmosProtoRegistry,\n  liftedinit,\n  liftedinitAminoConverters,\n  liftedinitProtoRegistry,\n  osmosisAminoConverters,\n  osmosisProtoRegistry,\n  strangeloveVenturesAminoConverters,\n  strangeloveVenturesProtoRegistry,\n} from '@manifest-network/manifestjs';\nimport { RateLimiter } from 'limiter';\nimport { DEFAULT_REQUESTS_PER_SECOND } from './config.js';\nimport { createLCDQueryClient } from './lcd-adapter.js';\nimport { withRetry } from './retry.js';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type WalletProvider,\n} from './types.js';\n\n// Type for the RPC query client from manifestjs liftedinit bundle\n// This includes cosmos modules + liftedinit-specific modules (billing, manifest, sku)\nexport type ManifestQueryClient = Awaited<\n  ReturnType<typeof liftedinit.ClientFactory.createRPCQueryClient>\n>;\n\n/**\n * Extract the registry type expected by SigningStargateClient.connectWithSigner.\n *\n * The Registry type from @cosmjs/proto-signing doesn't perfectly match the registry type\n * in SigningStargateClientOptions due to telescope-generated proto types. This type alias\n * extracts the expected registry type from the function signature to enable type-safe casting.\n */\ntype SigningClientRegistry = Parameters<\n  typeof SigningStargateClient.connectWithSigner\n>[2] extends { registry?: infer R }\n  ? R\n  : never;\n\n/** Default timeout for transaction broadcast (60 seconds) */\nconst DEFAULT_BROADCAST_TIMEOUT_MS = 60_000;\n\n/** Default polling interval for transaction confirmation (3 seconds) */\nconst DEFAULT_BROADCAST_POLL_INTERVAL_MS = 3_000;\n\n/**\n * Get combined signing client options with all Manifest registries\n */\nfunction getSigningManifestClientOptions() {\n  const registry = new Registry([\n    ...cosmosProtoRegistry,\n    ...liftedinitProtoRegistry,\n    ...strangeloveVenturesProtoRegistry,\n    ...osmosisProtoRegistry,\n  ]);\n\n  const aminoTypes = new AminoTypes({\n    ...cosmosAminoConverters,\n    ...liftedinitAminoConverters,\n    ...strangeloveVenturesAminoConverters,\n    ...osmosisAminoConverters,\n  });\n\n  return { registry, aminoTypes };\n}\n\n/**\n * Manages CosmJS client instances with lazy initialization and singleton pattern\n */\nexport class CosmosClientManager {\n  private static instances: Map<string, CosmosClientManager> = new Map();\n\n  private config: ManifestMCPConfig;\n  private walletProvider: WalletProvider;\n  private queryClient: ManifestQueryClient | null = null;\n  private signingClient: SigningStargateClient | null = null;\n  private rateLimiter: RateLimiter;\n\n  // Promises to prevent concurrent client initialization (lazy init race condition)\n  private queryClientPromise: Promise<ManifestQueryClient> | null = null;\n  private signingClientPromise: Promise<SigningStargateClient> | null = null;\n\n  private constructor(\n    config: ManifestMCPConfig,\n    walletProvider: WalletProvider,\n  ) {\n    this.config = config;\n    this.walletProvider = walletProvider;\n\n    // Initialize rate limiter with configured or default requests per second\n    const requestsPerSecond =\n      config.rateLimit?.requestsPerSecond ?? DEFAULT_REQUESTS_PER_SECOND;\n    this.rateLimiter = new RateLimiter({\n      tokensPerInterval: requestsPerSecond,\n      interval: 'second',\n    });\n  }\n\n  /**\n   * Get or create a singleton instance for the given config.\n   * Instances are keyed by chainId:rpcUrl:restUrl. For existing instances:\n   * - Config and walletProvider references are always updated\n   * - Signing client is disconnected/recreated if gasPrice or walletProvider changed\n   * - Rate limiter is updated if requestsPerSecond changed (without affecting signing client)\n   */\n  static getInstance(\n    config: ManifestMCPConfig,\n    walletProvider: WalletProvider,\n  ): CosmosClientManager {\n    const parts = [config.chainId, config.rpcUrl ?? ''];\n    if (config.restUrl) parts.push(config.restUrl);\n    const key = parts.join(':');\n    let instance = CosmosClientManager.instances.get(key);\n\n    if (!instance) {\n      instance = new CosmosClientManager(config, walletProvider);\n      CosmosClientManager.instances.set(key, instance);\n    } else {\n      // Check what changed to determine what needs updating\n      const signingClientAffected =\n        instance.config.gasPrice !== config.gasPrice ||\n        instance.walletProvider !== walletProvider;\n\n      const rateLimitChanged =\n        instance.config.rateLimit?.requestsPerSecond !==\n        config.rateLimit?.requestsPerSecond;\n\n      // Always update config reference\n      instance.config = config;\n      instance.walletProvider = walletProvider;\n\n      // Only invalidate signing client if fields it depends on changed\n      if (signingClientAffected) {\n        if (instance.signingClient) {\n          instance.signingClient.disconnect();\n          instance.signingClient = null;\n        }\n        // Also clear the promise to allow re-initialization with new config\n        instance.signingClientPromise = null;\n      }\n\n      // Update rate limiter independently (doesn't affect signing client)\n      if (rateLimitChanged) {\n        const newRps =\n          config.rateLimit?.requestsPerSecond ?? DEFAULT_REQUESTS_PER_SECOND;\n        instance.rateLimiter = new RateLimiter({\n          tokensPerInterval: newRps,\n          interval: 'second',\n        });\n      }\n    }\n\n    return instance;\n  }\n\n  /**\n   * Clear all cached instances (useful for testing or reconnection).\n   * Disconnects signing clients and releases query client references before clearing.\n   */\n  static clearInstances(): void {\n    for (const instance of CosmosClientManager.instances.values()) {\n      instance.disconnect();\n    }\n    CosmosClientManager.instances.clear();\n  }\n\n  /**\n   * Get the manifestjs RPC query client with all module extensions\n   *\n   * Automatically retries on transient connection failures with exponential backoff.\n   */\n  async getQueryClient(): Promise<ManifestQueryClient> {\n    // Return cached client if available\n    if (this.queryClient) {\n      return this.queryClient;\n    }\n\n    // If initialization is already in progress, wait for it\n    if (this.queryClientPromise) {\n      return this.queryClientPromise;\n    }\n\n    // Start initialization and cache the promise to prevent concurrent init\n    this.queryClientPromise = (async () => {\n      // Capture reference to detect if superseded by disconnect/config change\n      const thisInitPromise = this.queryClientPromise;\n      try {\n        let client: ManifestQueryClient;\n        if (this.config.restUrl) {\n          // Use LCD/REST for queries when restUrl is configured\n          client = await withRetry(\n            () => createLCDQueryClient(this.config.restUrl!),\n            {\n              config: this.config.retry,\n              operationName: 'connect LCD query client',\n            },\n          );\n        } else if (this.config.rpcUrl) {\n          // Use RPC (existing behavior)\n          client = await withRetry(\n            () =>\n              liftedinit.ClientFactory.createRPCQueryClient({\n                rpcEndpoint: this.config.rpcUrl!,\n              }),\n            {\n              config: this.config.retry,\n              operationName: 'connect query client',\n            },\n          );\n        } else {\n          throw new ManifestMCPError(\n            ManifestMCPErrorCode.INVALID_CONFIG,\n            'Cannot create query client: neither restUrl nor rpcUrl is configured.',\n          );\n        }\n        // Only store if this is still the active promise\n        if (this.queryClientPromise === thisInitPromise) {\n          this.queryClient = client;\n          this.queryClientPromise = null;\n        }\n        return client;\n      } catch (error) {\n        // Clear promise on failure so retry is possible (only if still active)\n        if (this.queryClientPromise === thisInitPromise) {\n          this.queryClientPromise = null;\n        }\n        if (error instanceof ManifestMCPError) {\n          throw error;\n        }\n        const endpoint = this.config.restUrl ?? this.config.rpcUrl;\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.RPC_CONNECTION_FAILED,\n          `Failed to connect to ${this.config.restUrl ? 'REST' : 'RPC'} endpoint: ${error instanceof Error ? error.message : String(error)}`,\n          { url: endpoint },\n        );\n      }\n    })();\n\n    return this.queryClientPromise;\n  }\n\n  /**\n   * Get a signing client with all Manifest registries (for transactions)\n   *\n   * Automatically retries on transient connection failures with exponential backoff.\n   */\n  async getSigningClient(): Promise<SigningStargateClient> {\n    if (!this.config.rpcUrl || !this.config.gasPrice) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.INVALID_CONFIG,\n        'Signing client requires rpcUrl and gasPrice configuration. Current config is query-only (REST).',\n      );\n    }\n\n    // Return cached client if available\n    if (this.signingClient) {\n      return this.signingClient;\n    }\n\n    // If initialization is already in progress, wait for it\n    if (this.signingClientPromise) {\n      return this.signingClientPromise;\n    }\n\n    // Start initialization and cache the promise to prevent concurrent init\n    this.signingClientPromise = (async () => {\n      // Capture reference to detect if superseded by disconnect/config change\n      const thisInitPromise = this.signingClientPromise;\n      try {\n        const signer = await this.walletProvider.getSigner();\n        const gasPrice = GasPrice.fromString(this.config.gasPrice!);\n        const { registry, aminoTypes } = getSigningManifestClientOptions();\n\n        // Configure endpoint as HttpEndpoint object (required for custom options)\n        const endpoint: HttpEndpoint = {\n          url: this.config.rpcUrl!,\n          headers: {},\n        };\n\n        // Note: Registry type from @cosmjs/proto-signing doesn't perfectly match\n        // SigningStargateClientOptions due to telescope-generated proto types.\n        // This is a known limitation with custom cosmos-sdk module registries.\n        // Wrap with retry for transient connection failures\n        const client = await withRetry(\n          () =>\n            SigningStargateClient.connectWithSigner(endpoint, signer, {\n              registry: registry as SigningClientRegistry,\n              aminoTypes,\n              gasPrice,\n              broadcastTimeoutMs: DEFAULT_BROADCAST_TIMEOUT_MS,\n              broadcastPollIntervalMs: DEFAULT_BROADCAST_POLL_INTERVAL_MS,\n            }),\n          {\n            config: this.config.retry,\n            operationName: 'connect signing client',\n          },\n        );\n        // Only store if this is still the active promise\n        if (this.signingClientPromise === thisInitPromise) {\n          this.signingClient = client;\n          this.signingClientPromise = null;\n        } else {\n          // Promise was superseded, clean up the client we just created\n          client.disconnect();\n        }\n        return client;\n      } catch (error) {\n        // Clear promise on failure so retry is possible (only if still active)\n        if (this.signingClientPromise === thisInitPromise) {\n          this.signingClientPromise = null;\n        }\n        if (error instanceof ManifestMCPError) {\n          throw error;\n        }\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.RPC_CONNECTION_FAILED,\n          `Failed to connect signing client: ${error instanceof Error ? error.message : String(error)}`,\n          { rpcUrl: this.config.rpcUrl },\n        );\n      }\n    })();\n\n    return this.signingClientPromise;\n  }\n\n  /**\n   * Get the wallet address\n   */\n  async getAddress(): Promise<string> {\n    return this.walletProvider.getAddress();\n  }\n\n  /**\n   * Get the configuration\n   */\n  getConfig(): ManifestMCPConfig {\n    return this.config;\n  }\n\n  /**\n   * Acquire a rate limit token before making an RPC request.\n   * This will wait if the rate limit has been exceeded.\n   */\n  async acquireRateLimit(): Promise<void> {\n    await this.rateLimiter.removeTokens(1);\n  }\n\n  /**\n   * Disconnect the signing client and release query client references.\n   * The query client's underlying HTTP transport is stateless and does not\n   * require an explicit disconnect.\n   */\n  disconnect(): void {\n    if (this.signingClient) {\n      this.signingClient.disconnect();\n      this.signingClient = null;\n    }\n    this.signingClientPromise = null;\n    this.queryClient = null;\n    this.queryClientPromise = null;\n  }\n}\n"],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+import { ManifestMCPConfig } from "./types.js";
+import { DEFAULT_RETRY_CONFIG } from "./retry.js";
+
+//#region src/config.d.ts
+/**
+ * Default requests per second for rate limiting
+ */
+declare const DEFAULT_REQUESTS_PER_SECOND = 10;
+/**
+ * Create a configuration object with defaults applied
+ */
+declare function createConfig(input: ManifestMCPConfig): ManifestMCPConfig;
+/**
+ * Validation result
+ */
+interface ValidationResult {
+  valid: boolean;
+  errors: string[];
+}
+/**
+ * Validate a configuration object
+ */
+declare function validateConfig(config: Partial<ManifestMCPConfig>): ValidationResult;
+/**
+ * Create and validate a configuration, throwing on invalid config
+ */
+declare function createValidatedConfig(input: ManifestMCPConfig): ManifestMCPConfig;
+//#endregion
+export { DEFAULT_REQUESTS_PER_SECOND, DEFAULT_RETRY_CONFIG, ValidationResult, createConfig, createValidatedConfig, validateConfig };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;AAeA;cAAa,2BAAA;;;AAkEb;iBAAgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAoB,iBAAA;;;;UAsBvC,gBAAA;EACf,KAAA;EACA,MAAA;AAAA;AAFF;;;AAAA,iBAQgB,cAAA,CACd,MAAA,EAAQ,OAAA,CAAQ,iBAAA,IACf,gBAAA;;AAFH;;iBA4HgB,qBAAA,CACd,KAAA,EAAO,iBAAA,GACN,iBAAA"}

package/dist/config.js

@@ -0,0 +1,127 @@
+import { ManifestMCPError, ManifestMCPErrorCode } from "./types.js";
+import { DEFAULT_RETRY_CONFIG } from "./retry.js";
+//#region src/config.ts
+/**
+* Default address prefix for Manifest Network
+*/
+const DEFAULT_ADDRESS_PREFIX = "manifest";
+/**
+* Default requests per second for rate limiting
+*/
+const DEFAULT_REQUESTS_PER_SECOND = 10;
+/**
+* Check if a hostname is localhost (IPv4, IPv6, or hostname)
+* Handles both bracketed and unbracketed IPv6 formats
+*/
+function isLocalhostHostname(hostname) {
+	if (hostname === "localhost" || hostname === "127.0.0.1") return true;
+	return hostname.replace(/^\[|\]$/g, "") === "::1";
+}
+/**
+* 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
+*/
+function validateEndpointUrl(url, label) {
+	let parsed;
+	try {
+		parsed = new URL(url);
+	} catch {
+		return {
+			valid: false,
+			reason: `${label} must be a valid URL`
+		};
+	}
+	if (parsed.protocol === "https:") return { valid: true };
+	if (parsed.protocol === "http:" && isLocalhostHostname(parsed.hostname)) return { valid: true };
+	return {
+		valid: false,
+		reason: `${label} must use HTTPS (got ${parsed.protocol}//). HTTP is only allowed for local development (localhost, 127.0.0.1, ::1).`
+	};
+}
+/**
+* Validate gas price format (e.g., "1.0umfx")
+*/
+function isValidGasPrice(gasPrice) {
+	return /^\d+(\.\d+)?[a-zA-Z]+$/.test(gasPrice);
+}
+/**
+* Validate chain ID format
+*/
+function isValidChainId(chainId) {
+	return /^[a-zA-Z0-9][\w-]*$/.test(chainId);
+}
+/**
+* Create a configuration object with defaults applied
+*/
+function createConfig(input) {
+	return {
+		chainId: input.chainId,
+		rpcUrl: input.rpcUrl,
+		gasPrice: input.gasPrice,
+		restUrl: input.restUrl,
+		addressPrefix: input.addressPrefix ?? DEFAULT_ADDRESS_PREFIX,
+		rateLimit: { requestsPerSecond: input.rateLimit?.requestsPerSecond ?? 10 },
+		retry: {
+			maxRetries: input.retry?.maxRetries ?? DEFAULT_RETRY_CONFIG.maxRetries,
+			baseDelayMs: input.retry?.baseDelayMs ?? DEFAULT_RETRY_CONFIG.baseDelayMs,
+			maxDelayMs: input.retry?.maxDelayMs ?? DEFAULT_RETRY_CONFIG.maxDelayMs
+		}
+	};
+}
+/**
+* Validate a configuration object
+*/
+function validateConfig(config) {
+	const errors = [];
+	if (!config.chainId) errors.push("chainId is required");
+	else if (!isValidChainId(config.chainId)) errors.push("chainId must be alphanumeric with hyphens (e.g., \"manifest-ledger-testnet\")");
+	if (!config.rpcUrl && !config.restUrl) errors.push("At least one of rpcUrl or restUrl is required");
+	if (config.rpcUrl) {
+		const urlCheck = validateEndpointUrl(config.rpcUrl, "rpcUrl");
+		if (!urlCheck.valid) errors.push(urlCheck.reason);
+	}
+	if (config.restUrl) {
+		const urlCheck = validateEndpointUrl(config.restUrl, "restUrl");
+		if (!urlCheck.valid) errors.push(urlCheck.reason);
+	}
+	if (config.rpcUrl && !config.gasPrice) errors.push("gasPrice is required when rpcUrl is provided");
+	else if (config.gasPrice && !isValidGasPrice(config.gasPrice)) errors.push("gasPrice must be a number followed by denomination (e.g., \"1.0umfx\")");
+	if (config.addressPrefix !== void 0) {
+		if (!/^[a-z]+$/.test(config.addressPrefix)) errors.push("addressPrefix must be lowercase letters only");
+	}
+	if (config.rateLimit !== void 0) {
+		if (typeof config.rateLimit !== "object" || config.rateLimit === null || Array.isArray(config.rateLimit)) errors.push("rateLimit must be a plain object");
+		else if (config.rateLimit.requestsPerSecond !== void 0) {
+			if (typeof config.rateLimit.requestsPerSecond !== "number" || config.rateLimit.requestsPerSecond <= 0 || !Number.isInteger(config.rateLimit.requestsPerSecond)) errors.push("rateLimit.requestsPerSecond must be a positive integer");
+		}
+	}
+	if (config.retry !== void 0) if (typeof config.retry !== "object" || config.retry === null || Array.isArray(config.retry)) errors.push("retry must be a plain object");
+	else {
+		if (config.retry.maxRetries !== void 0) {
+			if (typeof config.retry.maxRetries !== "number" || config.retry.maxRetries < 0 || !Number.isInteger(config.retry.maxRetries)) errors.push("retry.maxRetries must be a non-negative integer");
+		}
+		if (config.retry.baseDelayMs !== void 0) {
+			if (typeof config.retry.baseDelayMs !== "number" || config.retry.baseDelayMs <= 0 || !Number.isInteger(config.retry.baseDelayMs)) errors.push("retry.baseDelayMs must be a positive integer");
+		}
+		if (config.retry.maxDelayMs !== void 0) {
+			if (typeof config.retry.maxDelayMs !== "number" || config.retry.maxDelayMs <= 0 || !Number.isInteger(config.retry.maxDelayMs)) errors.push("retry.maxDelayMs must be a positive integer");
+		}
+		if (config.retry.baseDelayMs !== void 0 && config.retry.maxDelayMs !== void 0 && config.retry.maxDelayMs < config.retry.baseDelayMs) errors.push("retry.maxDelayMs must be greater than or equal to retry.baseDelayMs");
+	}
+	return {
+		valid: errors.length === 0,
+		errors
+	};
+}
+/**
+* Create and validate a configuration, throwing on invalid config
+*/
+function createValidatedConfig(input) {
+	const validation = validateConfig(input);
+	if (!validation.valid) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, `Invalid configuration: ${validation.errors.join(", ")}`, { errors: validation.errors });
+	return createConfig(input);
+}
+//#endregion
+export { DEFAULT_REQUESTS_PER_SECOND, DEFAULT_RETRY_CONFIG, createConfig, createValidatedConfig, validateConfig };
+
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +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// 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  return /^\\d+(\\.\\d+)?[a-zA-Z]+$/.test(gasPrice);\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  };\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\")',\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  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

@@ -0,0 +1,24 @@
+import { CosmosQueryResult, CosmosTxResult } from "./types.js";
+import { CosmosClientManager } from "./client.js";
+
+//#region src/cosmos.d.ts
+/**
+ * Execute a Cosmos query via manifestjs RPC client
+ *
+ * Automatically retries on transient failures (network errors, timeouts, 5xx)
+ * with exponential backoff. Configure retry behavior via `config.retry`.
+ */
+declare function cosmosQuery(clientManager: CosmosClientManager, module: string, subcommand: string, args?: string[]): Promise<CosmosQueryResult>;
+/**
+ * Execute a Cosmos transaction via manifestjs signing client
+ *
+ * Automatically retries on transient failures (network errors, timeouts, 5xx)
+ * with exponential backoff. Configure retry behavior via `config.retry`.
+ *
+ * Note: Only network-level failures are retried. Transaction validation errors
+ * (insufficient funds, invalid args, etc.) are not retried as they won't succeed.
+ */
+declare function cosmosTx(clientManager: CosmosClientManager, module: string, subcommand: string, args?: string[], waitForConfirmation?: boolean): Promise<CosmosTxResult>;
+//#endregion
+export { cosmosQuery, cosmosTx };
+//# sourceMappingURL=cosmos.d.ts.map

package/dist/cosmos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosmos.d.ts","names":[],"sources":["../src/cosmos.ts"],"mappings":";;;;;;AAsCA;;;;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,aACC,OAAA,CAAQ,cAAA"}

package/dist/cosmos.js

@@ -0,0 +1,85 @@
+import { ManifestMCPError, ManifestMCPErrorCode } from "./types.js";
+import { withRetry } from "./retry.js";
+import { getQueryHandler, getTxHandler } from "./modules.js";
+//#region src/cosmos.ts
+const VALID_NAME_PATTERN = /^[a-zA-Z0-9_][a-zA-Z0-9_-]*$/;
+/**
+* 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.
+*/
+function validateName(name, field, errorCode) {
+	if (!name || !VALID_NAME_PATTERN.test(name)) throw new ManifestMCPError(errorCode, `Invalid ${field}: "${name}". Only alphanumeric characters, hyphens, and underscores are allowed.`);
+}
+/**
+* Execute a Cosmos query via manifestjs RPC client
+*
+* Automatically retries on transient failures (network errors, timeouts, 5xx)
+* with exponential backoff. Configure retry behavior via `config.retry`.
+*/
+async function cosmosQuery(clientManager, module, subcommand, args = []) {
+	validateName(module, "module", ManifestMCPErrorCode.UNSUPPORTED_QUERY);
+	validateName(subcommand, "subcommand", ManifestMCPErrorCode.UNSUPPORTED_QUERY);
+	const handler = getQueryHandler(module);
+	return withRetry(async () => {
+		await clientManager.acquireRateLimit();
+		const queryClient = await clientManager.getQueryClient();
+		try {
+			return {
+				module,
+				subcommand,
+				result: await handler(queryClient, 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)}`);
+		}
+	}, {
+		config: clientManager.getConfig().retry,
+		operationName: `query ${module} ${subcommand}`
+	});
+}
+/**
+* Execute a Cosmos transaction via manifestjs signing client
+*
+* Automatically retries on transient failures (network errors, timeouts, 5xx)
+* with exponential backoff. Configure retry behavior via `config.retry`.
+*
+* Note: Only network-level failures are retried. Transaction validation errors
+* (insufficient funds, invalid args, etc.) are not retried as they won't succeed.
+*/
+async function cosmosTx(clientManager, module, subcommand, args = [], waitForConfirmation = false) {
+	validateName(module, "module", ManifestMCPErrorCode.UNSUPPORTED_TX);
+	validateName(subcommand, "subcommand", ManifestMCPErrorCode.UNSUPPORTED_TX);
+	const handler = getTxHandler(module);
+	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);
+		} catch (error) {
+			if (error instanceof ManifestMCPError) {
+				if (!error.details?.module) throw new ManifestMCPError(error.code, error.message, {
+					...error.details,
+					module,
+					subcommand,
+					args
+				});
+				throw error;
+			}
+			throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Tx ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`, {
+				module,
+				subcommand,
+				args
+			});
+		}
+	}, {
+		config: clientManager.getConfig().retry,
+		operationName: `tx ${module} ${subcommand}`
+	});
+}
+//#endregion
+export { cosmosQuery, cosmosTx };
+
+//# sourceMappingURL=cosmos.js.map

package/dist/cosmos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosmos.js","names":[],"sources":["../src/cosmos.ts"],"sourcesContent":["import type { CosmosClientManager } from './client.js';\nimport { getQueryHandler, getTxHandler } from './modules.js';\nimport { withRetry } from './retry.js';\nimport {\n  type CosmosQueryResult,\n  type CosmosTxResult,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\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): Promise<CosmosTxResult> {\n  validateName(module, 'module', ManifestMCPErrorCode.UNSUPPORTED_TX);\n  validateName(subcommand, 'subcommand', ManifestMCPErrorCode.UNSUPPORTED_TX);\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        );\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"],"mappings":";;;;AAYA,MAAM,qBAAqB;;;;;;AAO3B,SAAS,aACP,MACA,OACA,WACM;AACN,KAAI,CAAC,QAAQ,CAAC,mBAAmB,KAAK,KAAK,CACzC,OAAM,IAAI,iBACR,WACA,WAAW,MAAM,KAAK,KAAK,wEAC5B;;;;;;;;AAUL,eAAsB,YACpB,eACA,QACA,YACA,OAAiB,EAAE,EACS;AAC5B,cAAa,QAAQ,UAAU,qBAAqB,kBAAkB;AACtE,cACE,YACA,cACA,qBAAqB,kBACtB;CAGD,MAAM,UAAU,gBAAgB,OAAO;AAEvC,QAAO,UACL,YAAY;AAEV,QAAM,cAAc,kBAAkB;EAEtC,MAAM,cAAc,MAAM,cAAc,gBAAgB;AAExD,MAAI;AAGF,UAAO;IACL;IACA;IACA,QALa,MAAM,QAAQ,aAAa,YAAY,KAAK;IAM1D;WACM,OAAO;AACd,OAAI,iBAAiB,iBACnB,OAAM;AAER,SAAM,IAAI,iBACR,qBAAqB,cACrB,SAAS,OAAO,GAAG,WAAW,WAAW,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAChG;;IAGL;EACE,QAAQ,cAAc,WAAW,CAAC;EAClC,eAAe,SAAS,OAAO,GAAG;EACnC,CACF;;;;;;;;;;;AAYH,eAAsB,SACpB,eACA,QACA,YACA,OAAiB,EAAE,EACnB,sBAA+B,OACN;AACzB,cAAa,QAAQ,UAAU,qBAAqB,eAAe;AACnE,cAAa,YAAY,cAAc,qBAAqB,eAAe;CAG3E,MAAM,UAAU,aAAa,OAAO;AAEpC,QAAO,UACL,YAAY;AAEV,QAAM,cAAc,kBAAkB;EAEtC,MAAM,gBAAgB,MAAM,cAAc,kBAAkB;EAC5D,MAAM,gBAAgB,MAAM,cAAc,YAAY;AAEtD,MAAI;AACF,UAAO,MAAM,QACX,eACA,eACA,YACA,MACA,oBACD;WACM,OAAO;AACd,OAAI,iBAAiB,kBAAkB;AAErC,QAAI,CAAC,MAAM,SAAS,OAClB,OAAM,IAAI,iBAAiB,MAAM,MAAM,MAAM,SAAS;KACpD,GAAG,MAAM;KACT;KACA;KACA;KACD,CAAC;AAEJ,UAAM;;AAER,SAAM,IAAI,iBACR,qBAAqB,WACrB,MAAM,OAAO,GAAG,WAAW,WAAW,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IAC5F;IAAE;IAAQ;IAAY;IAAM,CAC7B;;IAGL;EACE,QAAQ,cAAc,WAAW,CAAC;EAClC,eAAe,MAAM,OAAO,GAAG;EAChC,CACF"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { AccountInfo, AccountInfoResult, AddressBytesToStringResult, AddressStringToBytesResult, Any, AuthAccountResult, AuthAccountsResult, AuthParams, AuthParamsResult, AvailableModules, BalanceResult, BalancesResult, BankMetadata, BankParams, BankParamsResult, BaseAccount, Bech32PrefixResult, BillingParams, BillingParamsResult, Coin, CommissionResult, CommunityPoolResult, CosmosQueryResult, CosmosTxResult, CreditAccount, CreditAccountResult, CreditAccountsResult, CreditAddressResult, CreditEstimateResult, DecCoin, DelegationDelegatorReward, DelegationResponse, DelegationResult, DelegationsResult, DelegatorValidatorsResult, DelegatorWithdrawAddressResult, DenomMetadataResult, DenomsMetadataResult, DepositParams, DepositResult, DepositsResult, DistributionParams, DistributionParamsResult, GovDeposit, GovParams, GovParamsResult, GovProposal, GovTallyResult, GovVote, GroupInfo, GroupInfoResult, GroupMember, GroupMembersResult, GroupPoliciesResult, GroupPolicyInfo, GroupPolicyInfoResult, GroupProposal, GroupProposalResult, GroupProposalsResult, GroupTallyQueryResult, GroupTallyResult, GroupVote, GroupVoteResult, GroupVotesResult, GroupsResult, HistoricalInfo, HistoricalInfoResult, Lease, LeaseItemInput, LeaseResult, LeasesResult, ManifestMCPConfig, ManifestMCPError, ManifestMCPErrorCode, ModuleAccount, ModuleAccountsResult, ModuleInfo, PaginatedResult, PaginationResponse, 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, TotalSupplyResult, UnbondingDelegation, UnbondingDelegationResult, UnbondingDelegationsResult, Validator, ValidatorAccumulatedCommission, ValidatorOutstandingRewards, ValidatorOutstandingRewardsResult, ValidatorResult, ValidatorSlashEvent, ValidatorsResult, VoteResult, VotesResult, VotingParams, WalletProvider, 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 { cosmosQuery, cosmosTx } from "./cosmos.js";
+import { createLCDQueryClient } from "./lcd-adapter.js";
+import { LogLevel, logger } from "./logger.js";
+import { getAvailableModules, getModuleSubcommands, getSubcommandUsage, getSupportedModules, isSubcommandSupported } from "./modules.js";
+import { MAX_PAGE_LIMIT, createPagination } from "./queries/utils.js";
+import { INFRASTRUCTURE_ERROR_CODES, ManifestMCPServerOptions, MnemonicServerConfig, SENSITIVE_FIELDS, bigIntReplacer, createMnemonicServer, jsonResponse, sanitizeForLogging, withErrorHandling } from "./server-utils.js";
+import { fundCredits } from "./tools/fundCredits.js";
+import { getBalance } from "./tools/getBalance.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, AvailableModules, BalanceResult, BalancesResult, BankMetadata, BankParams, BankParamsResult, BaseAccount, Bech32PrefixResult, BillingParams, BillingParamsResult, Coin, CommissionResult, CommunityPoolResult, CosmosClientManager, CosmosQueryResult, CosmosTxResult, CreditAccount, CreditAccountResult, CreditAccountsResult, CreditAddressResult, CreditEstimateResult, DEFAULT_RETRY_CONFIG, DNS_LABEL_RE, DecCoin, DelegationDelegatorReward, DelegationResponse, DelegationResult, DelegationsResult, DelegatorValidatorsResult, DelegatorWithdrawAddressResult, DenomMetadataResult, DenomsMetadataResult, DepositParams, DepositResult, DepositsResult, DistributionParams, DistributionParamsResult, 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, Lease, LeaseItemInput, LeaseResult, LeaseState, LeasesResult, type LogLevel, MAX_PAGE_LIMIT, ManifestMCPConfig, ManifestMCPError, ManifestMCPErrorCode, type ManifestMCPServerOptions, type ManifestQueryClient, type MnemonicServerConfig, MnemonicWalletProvider, ModuleAccount, ModuleAccountsResult, ModuleInfo, PaginatedResult, PaginationResponse, 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, TotalSupplyResult, UnbondingDelegation, UnbondingDelegationResult, UnbondingDelegationsResult, VERSION, type ValidationResult, Validator, ValidatorAccumulatedCommission, ValidatorOutstandingRewards, ValidatorOutstandingRewardsResult, ValidatorResult, ValidatorSlashEvent, ValidatorsResult, VoteResult, VotesResult, VotingParams, WalletProvider, WithdrawableAmountResult, bigIntReplacer, calculateBackoff, cosmosQuery, cosmosTx, createConfig, createLCDQueryClient, createMnemonicServer, createPagination, createValidatedConfig, fundCredits, getAvailableModules, getBalance, getModuleSubcommands, getSubcommandUsage, getSupportedModules, isRetryableError, isSubcommandSupported, jsonResponse, leaseStateFromJSON, leaseStateToJSON, logger, optionalBoolean, parseArgs, requireString, requireStringEnum, requireUuid, sanitizeForLogging, signArbitraryWithAmino, stopApp, validateConfig, withErrorHandling, withRetry };

package/dist/index.js

@@ -0,0 +1,20 @@
+import { ManifestMCPError, ManifestMCPErrorCode } from "./types.js";
+import { DEFAULT_RETRY_CONFIG, calculateBackoff, isRetryableError, withRetry } from "./retry.js";
+import { createConfig, createValidatedConfig, validateConfig } from "./config.js";
+import { createLCDQueryClient } from "./lcd-adapter.js";
+import { CosmosClientManager } from "./client.js";
+import { DNS_LABEL_RE, optionalBoolean, parseArgs, requireString, requireStringEnum, requireUuid } from "./validation.js";
+import { MAX_PAGE_LIMIT, createPagination } from "./queries/utils.js";
+import { getAvailableModules, getModuleSubcommands, getSubcommandUsage, getSupportedModules, isSubcommandSupported } from "./modules.js";
+import { cosmosQuery, cosmosTx } from "./cosmos.js";
+import { logger } from "./logger.js";
+import { signArbitraryWithAmino } from "./wallet/sign-arbitrary.js";
+import { MnemonicWalletProvider } from "./wallet/mnemonic.js";
+import "./wallet/index.js";
+import { INFRASTRUCTURE_ERROR_CODES, SENSITIVE_FIELDS, bigIntReplacer, createMnemonicServer, jsonResponse, sanitizeForLogging, withErrorHandling } from "./server-utils.js";
+import { fundCredits } from "./tools/fundCredits.js";
+import { getBalance } from "./tools/getBalance.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, MAX_PAGE_LIMIT, ManifestMCPError, ManifestMCPErrorCode, MnemonicWalletProvider, SENSITIVE_FIELDS, VERSION, bigIntReplacer, calculateBackoff, cosmosQuery, cosmosTx, createConfig, createLCDQueryClient, createMnemonicServer, createPagination, createValidatedConfig, fundCredits, getAvailableModules, getBalance, getModuleSubcommands, getSubcommandUsage, getSupportedModules, isRetryableError, isSubcommandSupported, jsonResponse, leaseStateFromJSON, leaseStateToJSON, logger, optionalBoolean, parseArgs, requireString, requireStringEnum, requireUuid, sanitizeForLogging, signArbitraryWithAmino, stopApp, validateConfig, withErrorHandling, withRetry };

package/dist/lcd-adapter.d.ts

@@ -0,0 +1,15 @@
+import { ManifestQueryClient } from "./client.js";
+
+//#region src/lcd-adapter.d.ts
+declare function snakeToCamelDeep(obj: unknown): unknown;
+interface Converter {
+  fromJSON(object: unknown): unknown;
+}
+declare function findConverter(namespace: Record<string, unknown>, methodName: string): Converter;
+type AsyncFn = (...args: unknown[]) => Promise<unknown>;
+declare function adaptModule(lcdMod: unknown, converterNs: unknown): Record<string, AsyncFn>;
+declare function unsupportedModule(modulePath: string): unknown;
+declare function createLCDQueryClient(restEndpoint: string): Promise<ManifestQueryClient>;
+//#endregion
+export { adaptModule as _adaptModule, findConverter as _findConverter, snakeToCamelDeep as _snakeToCamelDeep, unsupportedModule as _unsupportedModule, createLCDQueryClient };
+//# sourceMappingURL=lcd-adapter.d.ts.map

package/dist/lcd-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcd-adapter.d.ts","names":[],"sources":["../src/lcd-adapter.ts"],"mappings":";;;iBAQS,gBAAA,CAAiB,GAAA;AAAA,UAwBhB,SAAA;EACR,QAAA,CAAS,MAAA;AAAA;AAAA,iBAGF,aAAA,CACP,SAAA,EAAW,MAAA,mBACX,UAAA,WACC,SAAA;AAAA,KAiBE,OAAA,OAAc,IAAA,gBAAoB,OAAA;AAAA,iBAE9B,WAAA,CACP,MAAA,WACA,WAAA,YACC,MAAA,SAAe,OAAA;AAAA,iBAqCT,iBAAA,CAAkB,UAAA;AAAA,iBAiBL,oBAAA,CACpB,YAAA,WACC,OAAA,CAAQ,mBAAA"}

package/dist/lcd-adapter.js

@@ -0,0 +1,98 @@
+import { ManifestMCPError, ManifestMCPErrorCode } from "./types.js";
+import { cosmos, liftedinit } from "@manifest-network/manifestjs";
+//#region src/lcd-adapter.ts
+function snakeToCamel(s) {
+	return s.replace(/_(.)/g, (_, c) => c.toUpperCase());
+}
+function snakeToCamelDeep(obj) {
+	if (Array.isArray(obj)) return obj.map(snakeToCamelDeep);
+	if (obj !== null && typeof obj === "object" && !(obj instanceof Date) && !(obj instanceof Uint8Array)) return Object.fromEntries(Object.entries(obj).map(([k, v]) => [snakeToCamel(k), snakeToCamelDeep(v)]));
+	return obj;
+}
+function ucFirst(s) {
+	return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function findConverter(namespace, methodName) {
+	const uc = ucFirst(methodName);
+	const queryName = `Query${uc}Response`;
+	const plainName = `${uc}Response`;
+	const converter = namespace[queryName] ?? namespace[plainName];
+	if (!converter?.fromJSON) throw new ManifestMCPError(ManifestMCPErrorCode.QUERY_FAILED, `No response converter found for method "${methodName}" (tried "${queryName}" and "${plainName}")`);
+	return converter;
+}
+function adaptModule(lcdMod, converterNs) {
+	const lcdModule = lcdMod;
+	const converterNamespace = converterNs;
+	const adapted = {};
+	for (const key of Object.keys(lcdModule)) {
+		if (key === "req" || typeof lcdModule[key] !== "function") continue;
+		const originalFn = lcdModule[key];
+		const converter = findConverter(converterNamespace, key);
+		adapted[key] = async (...args) => {
+			let sdkResult;
+			try {
+				sdkResult = await originalFn.call(lcdModule, ...args);
+			} catch (error) {
+				if (error instanceof ManifestMCPError) throw error;
+				throw new ManifestMCPError(ManifestMCPErrorCode.QUERY_FAILED, `LCD query "${key}" failed: ${error instanceof Error ? error.message : String(error)}`);
+			}
+			const camelCased = snakeToCamelDeep(sdkResult);
+			try {
+				return converter.fromJSON(camelCased);
+			} catch (error) {
+				throw new ManifestMCPError(ManifestMCPErrorCode.QUERY_FAILED, `Failed to convert LCD response for "${key}": ${error instanceof Error ? error.message : String(error)}`);
+			}
+		};
+	}
+	return adapted;
+}
+function unsupportedModule(modulePath) {
+	return new Proxy({}, { get(_target, prop) {
+		if (typeof prop === "string") throw new ManifestMCPError(ManifestMCPErrorCode.UNSUPPORTED_QUERY, `Module "${modulePath}" is not available via LCD/REST. Use an RPC endpoint instead.`);
+	} });
+}
+async function createLCDQueryClient(restEndpoint) {
+	let lcd;
+	try {
+		lcd = await liftedinit.ClientFactory.createLCDClient({ restEndpoint });
+	} catch (error) {
+		throw new ManifestMCPError(ManifestMCPErrorCode.RPC_CONNECTION_FAILED, `Failed to create LCD client for ${restEndpoint}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	try {
+		return {
+			cosmos: {
+				auth: { v1beta1: adaptModule(lcd.cosmos.auth.v1beta1, cosmos.auth.v1beta1) },
+				authz: { v1beta1: adaptModule(lcd.cosmos.authz.v1beta1, cosmos.authz.v1beta1) },
+				bank: { v1beta1: adaptModule(lcd.cosmos.bank.v1beta1, cosmos.bank.v1beta1) },
+				base: { node: { v1beta1: adaptModule(lcd.cosmos.base.node.v1beta1, cosmos.base.node.v1beta1) } },
+				circuit: { v1: adaptModule(lcd.cosmos.circuit.v1, cosmos.circuit.v1) },
+				consensus: { v1: adaptModule(lcd.cosmos.consensus.v1, cosmos.consensus.v1) },
+				distribution: { v1beta1: adaptModule(lcd.cosmos.distribution.v1beta1, cosmos.distribution.v1beta1) },
+				feegrant: { v1beta1: adaptModule(lcd.cosmos.feegrant.v1beta1, cosmos.feegrant.v1beta1) },
+				gov: {
+					v1: adaptModule(lcd.cosmos.gov.v1, cosmos.gov.v1),
+					v1beta1: adaptModule(lcd.cosmos.gov.v1beta1, cosmos.gov.v1beta1)
+				},
+				group: { v1: adaptModule(lcd.cosmos.group.v1, cosmos.group.v1) },
+				mint: { v1beta1: adaptModule(lcd.cosmos.mint.v1beta1, cosmos.mint.v1beta1) },
+				orm: { query: { v1alpha1: unsupportedModule("cosmos.orm.query.v1alpha1") } },
+				params: { v1beta1: adaptModule(lcd.cosmos.params.v1beta1, cosmos.params.v1beta1) },
+				staking: { v1beta1: adaptModule(lcd.cosmos.staking.v1beta1, cosmos.staking.v1beta1) },
+				tx: { v1beta1: adaptModule(lcd.cosmos.tx.v1beta1, cosmos.tx.v1beta1) },
+				upgrade: { v1beta1: adaptModule(lcd.cosmos.upgrade.v1beta1, cosmos.upgrade.v1beta1) }
+			},
+			liftedinit: {
+				billing: { v1: adaptModule(lcd.liftedinit.billing.v1, liftedinit.billing.v1) },
+				manifest: { v1: unsupportedModule("liftedinit.manifest.v1") },
+				sku: { v1: adaptModule(lcd.liftedinit.sku.v1, liftedinit.sku.v1) }
+			}
+		};
+	} catch (error) {
+		if (error instanceof ManifestMCPError) throw error;
+		throw new ManifestMCPError(ManifestMCPErrorCode.RPC_CONNECTION_FAILED, `Failed to adapt LCD modules: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+//#endregion
+export { adaptModule as _adaptModule, findConverter as _findConverter, snakeToCamelDeep as _snakeToCamelDeep, unsupportedModule as _unsupportedModule, createLCDQueryClient };
+
+//# sourceMappingURL=lcd-adapter.js.map

package/dist/lcd-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcd-adapter.js","names":[],"sources":["../src/lcd-adapter.ts"],"sourcesContent":["import { cosmos, liftedinit } from '@manifest-network/manifestjs';\nimport type { ManifestQueryClient } from './client.js';\nimport { ManifestMCPError, ManifestMCPErrorCode } from './types.js';\n\nfunction snakeToCamel(s: string): string {\n  return s.replace(/_(.)/g, (_, c: string) => c.toUpperCase());\n}\n\nfunction snakeToCamelDeep(obj: unknown): unknown {\n  if (Array.isArray(obj)) {\n    return obj.map(snakeToCamelDeep);\n  }\n  if (\n    obj !== null &&\n    typeof obj === 'object' &&\n    !(obj instanceof Date) &&\n    !(obj instanceof Uint8Array)\n  ) {\n    return Object.fromEntries(\n      Object.entries(obj as Record<string, unknown>).map(([k, v]) => [\n        snakeToCamel(k),\n        snakeToCamelDeep(v),\n      ]),\n    );\n  }\n  return obj;\n}\n\nfunction ucFirst(s: string): string {\n  return s.charAt(0).toUpperCase() + s.slice(1);\n}\n\ninterface Converter {\n  fromJSON(object: unknown): unknown;\n}\n\nfunction findConverter(\n  namespace: Record<string, unknown>,\n  methodName: string,\n): Converter {\n  const uc = ucFirst(methodName);\n  const queryName = `Query${uc}Response`;\n  const plainName = `${uc}Response`;\n\n  const converter = (namespace[queryName] ?? namespace[plainName]) as\n    | Converter\n    | undefined;\n  if (!converter?.fromJSON) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.QUERY_FAILED,\n      `No response converter found for method \"${methodName}\" (tried \"${queryName}\" and \"${plainName}\")`,\n    );\n  }\n  return converter;\n}\n\ntype AsyncFn = (...args: unknown[]) => Promise<unknown>;\n\nfunction adaptModule(\n  lcdMod: unknown,\n  converterNs: unknown,\n): Record<string, AsyncFn> {\n  const lcdModule = lcdMod as Record<string, unknown>;\n  const converterNamespace = converterNs as Record<string, unknown>;\n  const adapted: Record<string, AsyncFn> = {};\n\n  for (const key of Object.keys(lcdModule)) {\n    if (key === 'req' || typeof lcdModule[key] !== 'function') continue;\n\n    const originalFn = lcdModule[key] as AsyncFn;\n    const converter = findConverter(converterNamespace, key);\n\n    adapted[key] = async (...args: unknown[]) => {\n      let sdkResult: unknown;\n      try {\n        sdkResult = await originalFn.call(lcdModule, ...args);\n      } catch (error) {\n        if (error instanceof ManifestMCPError) throw error;\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.QUERY_FAILED,\n          `LCD query \"${key}\" failed: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n      const camelCased = snakeToCamelDeep(sdkResult);\n      try {\n        return converter.fromJSON(camelCased);\n      } catch (error) {\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.QUERY_FAILED,\n          `Failed to convert LCD response for \"${key}\": ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    };\n  }\n\n  return adapted;\n}\n\nfunction unsupportedModule(modulePath: string): unknown {\n  return new Proxy(\n    {},\n    {\n      get(_target, prop) {\n        if (typeof prop === 'string') {\n          throw new ManifestMCPError(\n            ManifestMCPErrorCode.UNSUPPORTED_QUERY,\n            `Module \"${modulePath}\" is not available via LCD/REST. Use an RPC endpoint instead.`,\n          );\n        }\n        return undefined;\n      },\n    },\n  );\n}\n\nexport async function createLCDQueryClient(\n  restEndpoint: string,\n): Promise<ManifestQueryClient> {\n  let lcd: Awaited<ReturnType<typeof liftedinit.ClientFactory.createLCDClient>>;\n  try {\n    lcd = await liftedinit.ClientFactory.createLCDClient({ restEndpoint });\n  } catch (error) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.RPC_CONNECTION_FAILED,\n      `Failed to create LCD client for ${restEndpoint}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  try {\n    return {\n      cosmos: {\n        auth: {\n          v1beta1: adaptModule(lcd.cosmos.auth.v1beta1, cosmos.auth.v1beta1),\n        },\n        authz: {\n          v1beta1: adaptModule(lcd.cosmos.authz.v1beta1, cosmos.authz.v1beta1),\n        },\n        bank: {\n          v1beta1: adaptModule(lcd.cosmos.bank.v1beta1, cosmos.bank.v1beta1),\n        },\n        base: {\n          node: {\n            v1beta1: adaptModule(\n              lcd.cosmos.base.node.v1beta1,\n              cosmos.base.node.v1beta1,\n            ),\n          },\n        },\n        circuit: { v1: adaptModule(lcd.cosmos.circuit.v1, cosmos.circuit.v1) },\n        consensus: {\n          v1: adaptModule(lcd.cosmos.consensus.v1, cosmos.consensus.v1),\n        },\n        distribution: {\n          v1beta1: adaptModule(\n            lcd.cosmos.distribution.v1beta1,\n            cosmos.distribution.v1beta1,\n          ),\n        },\n        feegrant: {\n          v1beta1: adaptModule(\n            lcd.cosmos.feegrant.v1beta1,\n            cosmos.feegrant.v1beta1,\n          ),\n        },\n        gov: {\n          v1: adaptModule(lcd.cosmos.gov.v1, cosmos.gov.v1),\n          v1beta1: adaptModule(lcd.cosmos.gov.v1beta1, cosmos.gov.v1beta1),\n        },\n        group: { v1: adaptModule(lcd.cosmos.group.v1, cosmos.group.v1) },\n        mint: {\n          v1beta1: adaptModule(lcd.cosmos.mint.v1beta1, cosmos.mint.v1beta1),\n        },\n        orm: {\n          query: { v1alpha1: unsupportedModule('cosmos.orm.query.v1alpha1') },\n        },\n        params: {\n          v1beta1: adaptModule(\n            lcd.cosmos.params.v1beta1,\n            cosmos.params.v1beta1,\n          ),\n        },\n        staking: {\n          v1beta1: adaptModule(\n            lcd.cosmos.staking.v1beta1,\n            cosmos.staking.v1beta1,\n          ),\n        },\n        tx: { v1beta1: adaptModule(lcd.cosmos.tx.v1beta1, cosmos.tx.v1beta1) },\n        upgrade: {\n          v1beta1: adaptModule(\n            lcd.cosmos.upgrade.v1beta1,\n            cosmos.upgrade.v1beta1,\n          ),\n        },\n      },\n      liftedinit: {\n        billing: {\n          v1: adaptModule(lcd.liftedinit.billing.v1, liftedinit.billing.v1),\n        },\n        manifest: { v1: unsupportedModule('liftedinit.manifest.v1') },\n        sku: { v1: adaptModule(lcd.liftedinit.sku.v1, liftedinit.sku.v1) },\n      },\n    } as ManifestQueryClient;\n  } catch (error) {\n    if (error instanceof ManifestMCPError) throw error;\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.RPC_CONNECTION_FAILED,\n      `Failed to adapt LCD modules: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n}\n\n// Re-export for testing\nexport {\n  adaptModule as _adaptModule,\n  findConverter as _findConverter,\n  snakeToCamelDeep as _snakeToCamelDeep,\n  unsupportedModule as _unsupportedModule,\n};\n"],"mappings":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,20 @@
+//#region src/logger.d.ts
+/**
+ * Leveled logger for MCP server processes.
+ *
+ * All output goes to stderr because stdout is reserved for MCP protocol messages.
+ * The level is resolved from `process.env.LOG_LEVEL` at import time and can be
+ * overridden at runtime via `logger.setLevel()`.
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+declare const logger: {
+  debug(...args: unknown[]): void;
+  info(...args: unknown[]): void;
+  warn(...args: unknown[]): void;
+  error(...args: unknown[]): void;
+  setLevel(level: LogLevel): void;
+  getLevel(): LogLevel;
+};
+//#endregion
+export { LogLevel, logger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","names":[],"sources":["../src/logger.ts"],"mappings":";;AAQA;;;;;AA4BA;KA5BY,QAAA;AAAA,cA4BC,MAAA;;;;;kBAaK,QAAA;cAGJ,QAAA;AAAA"}

package/dist/logger.js

@@ -0,0 +1,43 @@
+//#region src/logger.ts
+const LOG_LEVEL_ORDER = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3,
+	silent: 4
+};
+function resolveLevel() {
+	const env = typeof process !== "undefined" ? process.env.LOG_LEVEL : void 0;
+	if (!env) return "warn";
+	if (new Set(Object.keys(LOG_LEVEL_ORDER)).has(env)) return env;
+	console.error(`[WARN] Invalid LOG_LEVEL "${env}". Valid values: debug, info, warn, error, silent. Defaulting to "warn".`);
+	return "warn";
+}
+let currentLevel = resolveLevel();
+function shouldLog(level) {
+	return LOG_LEVEL_ORDER[level] >= LOG_LEVEL_ORDER[currentLevel];
+}
+const logger = {
+	debug(...args) {
+		if (shouldLog("debug")) console.error("[DEBUG]", ...args);
+	},
+	info(...args) {
+		if (shouldLog("info")) console.error("[INFO]", ...args);
+	},
+	warn(...args) {
+		if (shouldLog("warn")) console.error("[WARN]", ...args);
+	},
+	error(...args) {
+		if (shouldLog("error")) console.error("[ERROR]", ...args);
+	},
+	setLevel(level) {
+		currentLevel = level;
+	},
+	getLevel() {
+		return currentLevel;
+	}
+};
+//#endregion
+export { logger };
+
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":[],"sources":["../src/logger.ts"],"sourcesContent":["/**\n * Leveled logger for MCP server processes.\n *\n * All output goes to stderr because stdout is reserved for MCP protocol messages.\n * The level is resolved from `process.env.LOG_LEVEL` at import time and can be\n * overridden at runtime via `logger.setLevel()`.\n */\n\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';\n\nconst LOG_LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n  silent: 4,\n};\n\nfunction resolveLevel(): LogLevel {\n  const env =\n    typeof process !== 'undefined' ? process.env.LOG_LEVEL : undefined;\n  if (!env) return 'warn';\n  const validLevels = new Set<string>(Object.keys(LOG_LEVEL_ORDER));\n  if (validLevels.has(env)) return env as LogLevel;\n  console.error(\n    `[WARN] Invalid LOG_LEVEL \"${env}\". Valid values: debug, info, warn, error, silent. Defaulting to \"warn\".`,\n  );\n  return 'warn';\n}\n\nlet currentLevel: LogLevel = resolveLevel();\n\nfunction shouldLog(level: LogLevel): boolean {\n  return LOG_LEVEL_ORDER[level] >= LOG_LEVEL_ORDER[currentLevel];\n}\n\nexport const logger = {\n  debug(...args: unknown[]) {\n    if (shouldLog('debug')) console.error('[DEBUG]', ...args);\n  },\n  info(...args: unknown[]) {\n    if (shouldLog('info')) console.error('[INFO]', ...args);\n  },\n  warn(...args: unknown[]) {\n    if (shouldLog('warn')) console.error('[WARN]', ...args);\n  },\n  error(...args: unknown[]) {\n    if (shouldLog('error')) console.error('[ERROR]', ...args);\n  },\n  setLevel(level: LogLevel) {\n    currentLevel = level;\n  },\n  getLevel(): LogLevel {\n    return currentLevel;\n  },\n};\n"],"mappings":";AAUA,MAAM,kBAA4C;CAChD,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,QAAQ;CACT;AAED,SAAS,eAAyB;CAChC,MAAM,MACJ,OAAO,YAAY,cAAc,QAAQ,IAAI,YAAY,KAAA;AAC3D,KAAI,CAAC,IAAK,QAAO;AAEjB,KADoB,IAAI,IAAY,OAAO,KAAK,gBAAgB,CAAC,CACjD,IAAI,IAAI,CAAE,QAAO;AACjC,SAAQ,MACN,6BAA6B,IAAI,0EAClC;AACD,QAAO;;AAGT,IAAI,eAAyB,cAAc;AAE3C,SAAS,UAAU,OAA0B;AAC3C,QAAO,gBAAgB,UAAU,gBAAgB;;AAGnD,MAAa,SAAS;CACpB,MAAM,GAAG,MAAiB;AACxB,MAAI,UAAU,QAAQ,CAAE,SAAQ,MAAM,WAAW,GAAG,KAAK;;CAE3D,KAAK,GAAG,MAAiB;AACvB,MAAI,UAAU,OAAO,CAAE,SAAQ,MAAM,UAAU,GAAG,KAAK;;CAEzD,KAAK,GAAG,MAAiB;AACvB,MAAI,UAAU,OAAO,CAAE,SAAQ,MAAM,UAAU,GAAG,KAAK;;CAEzD,MAAM,GAAG,MAAiB;AACxB,MAAI,UAAU,QAAQ,CAAE,SAAQ,MAAM,WAAW,GAAG,KAAK;;CAE3D,SAAS,OAAiB;AACxB,iBAAe;;CAEjB,WAAqB;AACnB,SAAO;;CAEV"}