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

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

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

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

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

package/dist/client.d.ts

@@ -19,6 +19,7 @@ declare class CosmosClientManager {
   private queryClient;
   private signingClient;
   private rateLimiter;
+  private refCount;
   private queryClientPromise;
   private signingClientPromise;
   private constructor();
@@ -28,11 +29,27 @@ declare class CosmosClientManager {
    * - Config and walletProvider references are always updated
    * - Signing client is disconnected/recreated if gasPrice, gasMultiplier, or walletProvider changed
    * - Rate limiter is updated if requestsPerSecond changed (without affecting signing client)
+   *
+   * Every call acquires a reference (increments refCount). Each caller must
+   * balance it with exactly one disconnect() so the shared clients are torn
+   * down only once the last holder releases (see disconnect()).
+   *
+   * Reference accounting counts calls, not distinct callers: a call that only
+   * updates config on an existing key (changed gasPrice/gasMultiplier/
+   * walletProvider/rate limit) still acquires a reference. A holder that
+   * re-invokes getInstance to reconfigure a key it already holds therefore
+   * takes an ADDITIONAL reference and must balance it with an additional
+   * disconnect(), or refCount never reaches zero and the clients leak. Today
+   * every server acquires once at construction and releases once at shutdown,
+   * so this caveat only applies to callers that reconfigure a live key in place.
    */
   static getInstance(config: ManifestMCPConfig, walletProvider: WalletProvider): CosmosClientManager;
   /**
    * Clear all cached instances (useful for testing or reconnection).
-   * Disconnects signing clients and releases query client references before clearing.
+   * Force-tears-down each instance regardless of its refCount — clearing the
+   * registry is an unconditional reset, so it ignores outstanding holders,
+   * disconnects signing clients, releases query client references, and resets
+   * refCount to zero before clearing.
    */
   static clearInstances(): void;
   /**
@@ -61,11 +78,20 @@ declare class CosmosClientManager {
    */
   acquireRateLimit(): Promise<void>;
   /**
-   * Disconnect the signing client and release query client references.
+   * Release this holder's reference to the shared instance. The underlying
+   * clients are only torn down once the last holder disconnects (refCount
+   * reaches zero), so one server's shutdown cannot sever a client still in
+   * use by another server sharing the same config key. Calling disconnect()
+   * more times than getInstance() was called is safe and never drives the
+   * count negative.
+   */
+  disconnect(): void;
+  /**
+   * Tear down the signing client and release query client references.
    * The query client's underlying HTTP transport is stateless and does not
    * require an explicit disconnect.
    */
-  disconnect(): void;
+  private teardown;
 }
 //#endregion
 export { CosmosClientManager, ManifestQueryClient };

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;KA4CK,qBAAA,GAAwB,OAAA,CAC3B,UAAA,QAAkB,UAAA,CAAW,aAAA,CAAc,oBAAA;AAAA,KAExC,mBAAA,GAAsB,OAAA,CACzB,UAAA,QAAkB,QAAA,CAAW,aAAA,CAAc,oBAAA;AAAA,KAExC,8BAAA,GAAiC,OAAA,CACpC,UAAA,QAAkB,oBAAA,CAAsB,aAAA,CAAc,oBAAA;AAAA,KAEnD,kBAAA,GAAqB,OAAA,CACxB,UAAA,QAAkB,OAAA,CAAU,aAAA,CAAc,oBAAA;AAAA,KAEvC,cAAA,GAAiB,OAAA,CACpB,UAAA,QAAkB,GAAA,CAAM,aAAA,CAAc,oBAAA;AAAA,KAE5B,mBAAA,GAAsB,qBAAA,GAChC,IAAA,CAAK,mBAAA,gBACL,IAAA,CAAK,8BAAA,4BACL,IAAA,CAAK,kBAAA,eACL,IAAA,CAAK,cAAA;;;;cAiDM,mBAAA;EAAA,eACI,SAAA;EAAA,QAEP,MAAA;EAAA,QACA,cAAA;EAAA,QACA,WAAA;EAAA,QACA,aAAA;EAAA,QACA,WAAA;EAAA,QAGA,kBAAA;EAAA,QACA,oBAAA;EAAA,QAED,WAAA,CAAA;;;;;;;;SAuBA,WAAA,CACL,MAAA,EAAQ,iBAAA,EACR,cAAA,EAAgB,cAAA,GACf,mBAAA;EAvGe;;;;EAAA,OA2JX,cAAA,CAAA;EAzJJ;;;;;EAqKG,cAAA,CAAA,GAAkB,OAAA,CAAQ,mBAAA;EArKW;;;;;EA4QrC,gBAAA,CAAA,GAAoB,OAAA,CAAQ,qBAAA;EA3QoB;;;EAkXhD,UAAA,CAAA,GAAc,OAAA;EAhXC;;;EAuXrB,SAAA,CAAA,GAAa,iBAAA;EAvXW;;;;EA+XlB,gBAAA,CAAA,GAAoB,OAAA;EA9XR;;;;;EAuYlB,UAAA,CAAA;AAAA"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;KA4CK,qBAAA,GAAwB,OAAA,CAC3B,UAAA,QAAkB,UAAA,CAAW,aAAA,CAAc,oBAAA;AAAA,KAExC,mBAAA,GAAsB,OAAA,CACzB,UAAA,QAAkB,QAAA,CAAW,aAAA,CAAc,oBAAA;AAAA,KAExC,8BAAA,GAAiC,OAAA,CACpC,UAAA,QAAkB,oBAAA,CAAsB,aAAA,CAAc,oBAAA;AAAA,KAEnD,kBAAA,GAAqB,OAAA,CACxB,UAAA,QAAkB,OAAA,CAAU,aAAA,CAAc,oBAAA;AAAA,KAEvC,cAAA,GAAiB,OAAA,CACpB,UAAA,QAAkB,GAAA,CAAM,aAAA,CAAc,oBAAA;AAAA,KAE5B,mBAAA,GAAsB,qBAAA,GAChC,IAAA,CAAK,mBAAA,gBACL,IAAA,CAAK,8BAAA,4BACL,IAAA,CAAK,kBAAA,eACL,IAAA,CAAK,cAAA;;;;cAiDM,mBAAA;EAAA,eACI,SAAA;EAAA,QAEP,MAAA;EAAA,QACA,cAAA;EAAA,QACA,WAAA;EAAA,QACA,aAAA;EAAA,QACA,WAAA;EAAA,QAMA,QAAA;EAAA,QAGA,kBAAA;EAAA,QACA,oBAAA;EAAA,QAED,WAAA,CAAA;EAnFW;;;;;;;;;;;;AAA6C;;;;;;;;EAA7C,OAuHX,WAAA,CACL,MAAA,EAAQ,iBAAA,EACR,cAAA,EAAgB,cAAA,GACf,mBAAA;EAvHH;;;;;;AAA0E;EAA1E,OA+KO,cAAA,CAAA;;;;;;EAeD,cAAA,CAAA,GAAkB,OAAA,CAAQ,mBAAA;EA5LR;;;;;EAmSlB,gBAAA,CAAA,GAAoB,OAAA,CAAQ,qBAAA;EAlS4B;AAAA;;EAyYxD,UAAA,CAAA,GAAc,OAAA;EAtYF;;;EA6YlB,SAAA,CAAA,GAAa,iBAAA;EA9Yc;;;;EAsZrB,gBAAA,CAAA,GAAoB,OAAA;EArZY;;;AAExC;;;;;EA+ZE,UAAA,CAAA;EA7ZK;;;;;EAAA,QAuaG,QAAA;AAAA"}

package/dist/client.js

@@ -1,4 +1,4 @@
-import { ManifestMCPError, ManifestMCPErrorCode } from "./types.js";
+import { ManifestMCPError } from "./types.js";
 import { withRetry } from "./retry.js";
 import "./config.js";
 import { logger } from "./logger.js";
@@ -42,12 +42,14 @@ var CosmosClientManager = class CosmosClientManager {
 	constructor(config, walletProvider) {
 		this.queryClient = null;
 		this.signingClient = null;
+		this.refCount = 0;
 		this.queryClientPromise = null;
 		this.signingClientPromise = null;
 		this.config = config;
 		this.walletProvider = walletProvider;
+		const requestsPerSecond = config.rateLimit?.requestsPerSecond ?? 10;
 		this.rateLimiter = new RateLimiter({
-			tokensPerInterval: config.rateLimit?.requestsPerSecond ?? 10,
+			tokensPerInterval: requestsPerSecond,
 			interval: "second"
 		});
 	}
@@ -57,6 +59,19 @@ var CosmosClientManager = class CosmosClientManager {
 	* - Config and walletProvider references are always updated
 	* - Signing client is disconnected/recreated if gasPrice, gasMultiplier, or walletProvider changed
 	* - Rate limiter is updated if requestsPerSecond changed (without affecting signing client)
+	*
+	* Every call acquires a reference (increments refCount). Each caller must
+	* balance it with exactly one disconnect() so the shared clients are torn
+	* down only once the last holder releases (see disconnect()).
+	*
+	* Reference accounting counts calls, not distinct callers: a call that only
+	* updates config on an existing key (changed gasPrice/gasMultiplier/
+	* walletProvider/rate limit) still acquires a reference. A holder that
+	* re-invokes getInstance to reconfigure a key it already holds therefore
+	* takes an ADDITIONAL reference and must balance it with an additional
+	* disconnect(), or refCount never reaches zero and the clients leak. Today
+	* every server acquires once at construction and releases once at shutdown,
+	* so this caveat only applies to callers that reconfigure a live key in place.
 	*/
 	static getInstance(config, walletProvider) {
 		const parts = [config.chainId, config.rpcUrl ?? ""];
@@ -86,14 +101,21 @@ var CosmosClientManager = class CosmosClientManager {
 				});
 			}
 		}
+		instance.refCount += 1;
 		return instance;
 	}
 	/**
 	* Clear all cached instances (useful for testing or reconnection).
-	* Disconnects signing clients and releases query client references before clearing.
+	* Force-tears-down each instance regardless of its refCount — clearing the
+	* registry is an unconditional reset, so it ignores outstanding holders,
+	* disconnects signing clients, releases query client references, and resets
+	* refCount to zero before clearing.
 	*/
 	static clearInstances() {
-		for (const instance of CosmosClientManager.instances.values()) instance.disconnect();
+		for (const instance of CosmosClientManager.instances.values()) {
+			instance.teardown();
+			instance.refCount = 0;
+		}
 		CosmosClientManager.instances.clear();
 	}
 	/**
@@ -131,7 +153,7 @@ var CosmosClientManager = class CosmosClientManager {
 					config: this.config.retry,
 					operationName: "connect query client"
 				});
-				else throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, "Cannot create query client: neither restUrl nor rpcUrl is configured.");
+				else throw new ManifestMCPError("INVALID_CONFIG", "Cannot create query client: neither restUrl nor rpcUrl is configured.");
 				if (this.queryClientPromise === thisInitPromise) {
 					this.queryClient = client;
 					this.queryClientPromise = null;
@@ -141,7 +163,7 @@ var CosmosClientManager = class CosmosClientManager {
 				if (this.queryClientPromise === thisInitPromise) this.queryClientPromise = null;
 				if (error instanceof ManifestMCPError) throw error;
 				const endpoint = this.config.restUrl ?? this.config.rpcUrl;
-				throw new ManifestMCPError(ManifestMCPErrorCode.RPC_CONNECTION_FAILED, `Failed to connect to ${this.config.restUrl ? "REST" : "RPC"} endpoint: ${error instanceof Error ? error.message : String(error)}`, { url: endpoint });
+				throw new ManifestMCPError("RPC_CONNECTION_FAILED", `Failed to connect to ${this.config.restUrl ? "REST" : "RPC"} endpoint: ${error instanceof Error ? error.message : String(error)}`, { url: endpoint });
 			}
 		})();
 		return this.queryClientPromise;
@@ -152,7 +174,7 @@ var CosmosClientManager = class CosmosClientManager {
 	* Automatically retries on transient connection failures with exponential backoff.
 	*/
 	async getSigningClient() {
-		if (!this.config.rpcUrl || !this.config.gasPrice) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, "Signing client requires rpcUrl and gasPrice configuration. Current config is query-only (REST).");
+		if (!this.config.rpcUrl || !this.config.gasPrice) throw new ManifestMCPError("INVALID_CONFIG", "Signing client requires rpcUrl and gasPrice configuration. Current config is query-only (REST).");
 		if (this.signingClient) return this.signingClient;
 		if (this.signingClientPromise) return this.signingClientPromise;
 		this.signingClientPromise = (async () => {
@@ -192,7 +214,7 @@ var CosmosClientManager = class CosmosClientManager {
 			} catch (error) {
 				if (this.signingClientPromise === thisInitPromise) this.signingClientPromise = null;
 				if (error instanceof ManifestMCPError) throw error;
-				throw new ManifestMCPError(ManifestMCPErrorCode.RPC_CONNECTION_FAILED, `Failed to connect signing client: ${error instanceof Error ? error.message : String(error)}`, { rpcUrl: this.config.rpcUrl });
+				throw new ManifestMCPError("RPC_CONNECTION_FAILED", `Failed to connect signing client: ${error instanceof Error ? error.message : String(error)}`, { rpcUrl: this.config.rpcUrl });
 			}
 		})();
 		return this.signingClientPromise;
@@ -217,11 +239,23 @@ var CosmosClientManager = class CosmosClientManager {
 		await this.rateLimiter.removeTokens(1);
 	}
 	/**
-	* Disconnect the signing client and release query client references.
+	* Release this holder's reference to the shared instance. The underlying
+	* clients are only torn down once the last holder disconnects (refCount
+	* reaches zero), so one server's shutdown cannot sever a client still in
+	* use by another server sharing the same config key. Calling disconnect()
+	* more times than getInstance() was called is safe and never drives the
+	* count negative.
+	*/
+	disconnect() {
+		if (this.refCount > 0) this.refCount -= 1;
+		if (this.refCount === 0) this.teardown();
+	}
+	/**
+	* Tear down the signing client and release query client references.
 	* The query client's underlying HTTP transport is stateless and does not
 	* require an explicit disconnect.
 	*/
-	disconnect() {
+	teardown() {
 		if (this.signingClient) {
 			this.signingClient.disconnect();
 			this.signingClient = null;

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":["cosmwasmNs","strangeloveVenturesNs","osmosisNs","ibcNs"],"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  cosmwasmAminoConverters,\n  cosmwasm as cosmwasmNs,\n  cosmwasmProtoRegistry,\n  ibcAminoConverters,\n  ibc as ibcNs,\n  ibcProtoRegistry,\n  liftedinit,\n  liftedinitAminoConverters,\n  liftedinitProtoRegistry,\n  osmosisAminoConverters,\n  osmosis as osmosisNs,\n  osmosisProtoRegistry,\n  strangeloveVenturesAminoConverters,\n  strangelove_ventures as strangeloveVenturesNs,\n  strangeloveVenturesProtoRegistry,\n} from '@manifest-network/manifestjs';\nimport { RateLimiter } from 'limiter';\nimport {\n  DEFAULT_GAS_MULTIPLIER,\n  DEFAULT_REQUESTS_PER_SECOND,\n} from './config.js';\nimport { createLCDQueryClient } from './lcd-adapter.js';\nimport { logger } from './logger.js';\nimport { withRetry } from './retry.js';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type WalletProvider,\n} from './types.js';\n\n// Combined query client type: liftedinit modules (cosmos + billing/manifest/sku) + cosmwasm\n// + strangelove_ventures (poa) + osmosis (tokenfactory) + ibc (transfer, channel, client, connection).\n// Uses Pick to extract only each factory's unique namespace, avoiding conflicts with overlapping cosmos types.\ntype LiftedinitQueryClient = Awaited<\n  ReturnType<typeof liftedinit.ClientFactory.createRPCQueryClient>\n>;\ntype CosmwasmQueryClient = Awaited<\n  ReturnType<typeof cosmwasmNs.ClientFactory.createRPCQueryClient>\n>;\ntype StrangeloveVenturesQueryClient = Awaited<\n  ReturnType<typeof strangeloveVenturesNs.ClientFactory.createRPCQueryClient>\n>;\ntype OsmosisQueryClient = Awaited<\n  ReturnType<typeof osmosisNs.ClientFactory.createRPCQueryClient>\n>;\ntype IbcQueryClient = Awaited<\n  ReturnType<typeof ibcNs.ClientFactory.createRPCQueryClient>\n>;\nexport type ManifestQueryClient = LiftedinitQueryClient &\n  Pick<CosmwasmQueryClient, 'cosmwasm'> &\n  Pick<StrangeloveVenturesQueryClient, 'strangelove_ventures'> &\n  Pick<OsmosisQueryClient, 'osmosis'> &\n  Pick<IbcQueryClient, 'ibc'>;\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    ...cosmwasmProtoRegistry,\n    ...ibcProtoRegistry,\n  ]);\n\n  const aminoTypes = new AminoTypes({\n    ...cosmosAminoConverters,\n    ...liftedinitAminoConverters,\n    ...strangeloveVenturesAminoConverters,\n    ...osmosisAminoConverters,\n    ...cosmwasmAminoConverters,\n    ...ibcAminoConverters,\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, gasMultiplier, 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.config.gasMultiplier !== config.gasMultiplier ||\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: merge liftedinit + cosmwasm + strangelove_ventures + osmosis + ibc namespaces\n          client = await withRetry(\n            async () => {\n              const [\n                liftedinitClient,\n                cosmwasmClient,\n                strangeloveClient,\n                osmosisClient,\n                ibcClient,\n              ] = await Promise.all([\n                liftedinit.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n                cosmwasmNs.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n                strangeloveVenturesNs.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n                osmosisNs.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n                ibcNs.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n              ]);\n              return {\n                ...liftedinitClient,\n                cosmwasm: cosmwasmClient.cosmwasm,\n                strangelove_ventures: strangeloveClient.strangelove_ventures,\n                osmosis: osmosisClient.osmosis,\n                ibc: ibcClient.ibc,\n              } as ManifestQueryClient;\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          async () => {\n            const c = await SigningStargateClient.connectWithSigner(\n              endpoint,\n              signer,\n              {\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            // The property is private readonly with no constructor option,\n            // so we must bypass TypeScript's access control to override it.\n            const record = c as unknown as Record<string, unknown>;\n            if (typeof record.defaultGasMultiplier === 'number') {\n              record.defaultGasMultiplier =\n                this.config.gasMultiplier ?? DEFAULT_GAS_MULTIPLIER;\n            } else {\n              const effective =\n                this.config.gasMultiplier ?? DEFAULT_GAS_MULTIPLIER;\n              logger.warn(\n                `gasMultiplier ${effective} could not be applied: ` +\n                  `signing client defaultGasMultiplier is ${typeof record.defaultGasMultiplier}, expected number. ` +\n                  `Transactions will use the CosmJS built-in gas multiplier instead.`,\n              );\n            }\n            return c;\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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"}
+{"version":3,"file":"client.js","names":["cosmwasmNs","strangeloveVenturesNs","osmosisNs","ibcNs"],"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  cosmwasmAminoConverters,\n  cosmwasm as cosmwasmNs,\n  cosmwasmProtoRegistry,\n  ibcAminoConverters,\n  ibc as ibcNs,\n  ibcProtoRegistry,\n  liftedinit,\n  liftedinitAminoConverters,\n  liftedinitProtoRegistry,\n  osmosisAminoConverters,\n  osmosis as osmosisNs,\n  osmosisProtoRegistry,\n  strangeloveVenturesAminoConverters,\n  strangelove_ventures as strangeloveVenturesNs,\n  strangeloveVenturesProtoRegistry,\n} from '@manifest-network/manifestjs';\nimport { RateLimiter } from 'limiter';\nimport {\n  DEFAULT_GAS_MULTIPLIER,\n  DEFAULT_REQUESTS_PER_SECOND,\n} from './config.js';\nimport { createLCDQueryClient } from './lcd-adapter.js';\nimport { logger } from './logger.js';\nimport { withRetry } from './retry.js';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type WalletProvider,\n} from './types.js';\n\n// Combined query client type: liftedinit modules (cosmos + billing/manifest/sku) + cosmwasm\n// + strangelove_ventures (poa) + osmosis (tokenfactory) + ibc (transfer, channel, client, connection).\n// Uses Pick to extract only each factory's unique namespace, avoiding conflicts with overlapping cosmos types.\ntype LiftedinitQueryClient = Awaited<\n  ReturnType<typeof liftedinit.ClientFactory.createRPCQueryClient>\n>;\ntype CosmwasmQueryClient = Awaited<\n  ReturnType<typeof cosmwasmNs.ClientFactory.createRPCQueryClient>\n>;\ntype StrangeloveVenturesQueryClient = Awaited<\n  ReturnType<typeof strangeloveVenturesNs.ClientFactory.createRPCQueryClient>\n>;\ntype OsmosisQueryClient = Awaited<\n  ReturnType<typeof osmosisNs.ClientFactory.createRPCQueryClient>\n>;\ntype IbcQueryClient = Awaited<\n  ReturnType<typeof ibcNs.ClientFactory.createRPCQueryClient>\n>;\nexport type ManifestQueryClient = LiftedinitQueryClient &\n  Pick<CosmwasmQueryClient, 'cosmwasm'> &\n  Pick<StrangeloveVenturesQueryClient, 'strangelove_ventures'> &\n  Pick<OsmosisQueryClient, 'osmosis'> &\n  Pick<IbcQueryClient, 'ibc'>;\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    ...cosmwasmProtoRegistry,\n    ...ibcProtoRegistry,\n  ]);\n\n  const aminoTypes = new AminoTypes({\n    ...cosmosAminoConverters,\n    ...liftedinitAminoConverters,\n    ...strangeloveVenturesAminoConverters,\n    ...osmosisAminoConverters,\n    ...cosmwasmAminoConverters,\n    ...ibcAminoConverters,\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  // Number of live holders (servers) sharing this instance. Each getInstance\n  // acquisition increments it; each disconnect() decrements it. The underlying\n  // clients are only torn down once the count reaches zero (the last holder\n  // disconnects), so one server's shutdown can't sever another's shared client.\n  private refCount = 0;\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, gasMultiplier, or walletProvider changed\n   * - Rate limiter is updated if requestsPerSecond changed (without affecting signing client)\n   *\n   * Every call acquires a reference (increments refCount). Each caller must\n   * balance it with exactly one disconnect() so the shared clients are torn\n   * down only once the last holder releases (see disconnect()).\n   *\n   * Reference accounting counts calls, not distinct callers: a call that only\n   * updates config on an existing key (changed gasPrice/gasMultiplier/\n   * walletProvider/rate limit) still acquires a reference. A holder that\n   * re-invokes getInstance to reconfigure a key it already holds therefore\n   * takes an ADDITIONAL reference and must balance it with an additional\n   * disconnect(), or refCount never reaches zero and the clients leak. Today\n   * every server acquires once at construction and releases once at shutdown,\n   * so this caveat only applies to callers that reconfigure a live key in place.\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.config.gasMultiplier !== config.gasMultiplier ||\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    instance.refCount += 1;\n    return instance;\n  }\n\n  /**\n   * Clear all cached instances (useful for testing or reconnection).\n   * Force-tears-down each instance regardless of its refCount — clearing the\n   * registry is an unconditional reset, so it ignores outstanding holders,\n   * disconnects signing clients, releases query client references, and resets\n   * refCount to zero before clearing.\n   */\n  static clearInstances(): void {\n    for (const instance of CosmosClientManager.instances.values()) {\n      // Force teardown regardless of refCount — clearing the registry is an\n      // unconditional reset (used by tests/reconnection), so drop all holders.\n      instance.teardown();\n      instance.refCount = 0;\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: merge liftedinit + cosmwasm + strangelove_ventures + osmosis + ibc namespaces\n          client = await withRetry(\n            async () => {\n              const [\n                liftedinitClient,\n                cosmwasmClient,\n                strangeloveClient,\n                osmosisClient,\n                ibcClient,\n              ] = await Promise.all([\n                liftedinit.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n                cosmwasmNs.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n                strangeloveVenturesNs.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n                osmosisNs.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n                ibcNs.ClientFactory.createRPCQueryClient({\n                  rpcEndpoint: this.config.rpcUrl!,\n                }),\n              ]);\n              return {\n                ...liftedinitClient,\n                cosmwasm: cosmwasmClient.cosmwasm,\n                strangelove_ventures: strangeloveClient.strangelove_ventures,\n                osmosis: osmosisClient.osmosis,\n                ibc: ibcClient.ibc,\n              } as ManifestQueryClient;\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          async () => {\n            const c = await SigningStargateClient.connectWithSigner(\n              endpoint,\n              signer,\n              {\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            // The property is private readonly with no constructor option,\n            // so we must bypass TypeScript's access control to override it.\n            const record = c as unknown as Record<string, unknown>;\n            if (typeof record.defaultGasMultiplier === 'number') {\n              record.defaultGasMultiplier =\n                this.config.gasMultiplier ?? DEFAULT_GAS_MULTIPLIER;\n            } else {\n              const effective =\n                this.config.gasMultiplier ?? DEFAULT_GAS_MULTIPLIER;\n              logger.warn(\n                `gasMultiplier ${effective} could not be applied: ` +\n                  `signing client defaultGasMultiplier is ${typeof record.defaultGasMultiplier}, expected number. ` +\n                  `Transactions will use the CosmJS built-in gas multiplier instead.`,\n              );\n            }\n            return c;\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   * Release this holder's reference to the shared instance. The underlying\n   * clients are only torn down once the last holder disconnects (refCount\n   * reaches zero), so one server's shutdown cannot sever a client still in\n   * use by another server sharing the same config key. Calling disconnect()\n   * more times than getInstance() was called is safe and never drives the\n   * count negative.\n   */\n  disconnect(): void {\n    if (this.refCount > 0) this.refCount -= 1;\n    if (this.refCount === 0) this.teardown();\n  }\n\n  /**\n   * Tear down 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  private teardown(): 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":";;;;;;;;;;;AA+EA,MAAM,+BAA+B;;AAGrC,MAAM,qCAAqC;;;;AAK3C,SAAS,kCAAkC;AAmBzC,QAAO;EAAE,UAAA,IAlBY,SAAS;GAC5B,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACJ,CAWgB;EAAE,YAAA,IATI,WAAW;GAChC,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACJ,CAE4B;EAAE;;;;;AAMjC,IAAa,sBAAb,MAAa,oBAAoB;CAmB/B,YACE,QACA,gBACA;AAjBF,OAAQ,cAA0C;AAClD,OAAQ,gBAA8C;AAOtD,OAAQ,WAAW;AAGnB,OAAQ,qBAA0D;AAClE,OAAQ,uBAA8D;AAMpE,OAAK,SAAS;AACd,OAAK,iBAAiB;EAGtB,MAAM,oBACJ,OAAO,WAAW,qBAAA;AACpB,OAAK,cAAc,IAAI,YAAY;GACjC,mBAAmB;GACnB,UAAU;GACX,CAAC;;;;;;;;;;;;;;;;;;;;;;CAuBJ,OAAO,YACL,QACA,gBACqB;EACrB,MAAM,QAAQ,CAAC,OAAO,SAAS,OAAO,UAAU,GAAG;AACnD,MAAI,OAAO,QAAS,OAAM,KAAK,OAAO,QAAQ;EAC9C,MAAM,MAAM,MAAM,KAAK,IAAI;EAC3B,IAAI,WAAW,oBAAoB,UAAU,IAAI,IAAI;AAErD,MAAI,CAAC,UAAU;AACb,cAAW,IAAI,oBAAoB,QAAQ,eAAe;AAC1D,uBAAoB,UAAU,IAAI,KAAK,SAAS;SAC3C;GAEL,MAAM,wBACJ,SAAS,OAAO,aAAa,OAAO,YACpC,SAAS,OAAO,kBAAkB,OAAO,iBACzC,SAAS,mBAAmB;GAE9B,MAAM,mBACJ,SAAS,OAAO,WAAW,sBAC3B,OAAO,WAAW;AAGpB,YAAS,SAAS;AAClB,YAAS,iBAAiB;AAG1B,OAAI,uBAAuB;AACzB,QAAI,SAAS,eAAe;AAC1B,cAAS,cAAc,YAAY;AACnC,cAAS,gBAAgB;;AAG3B,aAAS,uBAAuB;;AAIlC,OAAI,kBAAkB;IACpB,MAAM,SACJ,OAAO,WAAW,qBAAA;AACpB,aAAS,cAAc,IAAI,YAAY;KACrC,mBAAmB;KACnB,UAAU;KACX,CAAC;;;AAIN,WAAS,YAAY;AACrB,SAAO;;;;;;;;;CAUT,OAAO,iBAAuB;AAC5B,OAAK,MAAM,YAAY,oBAAoB,UAAU,QAAQ,EAAE;AAG7D,YAAS,UAAU;AACnB,YAAS,WAAW;;AAEtB,sBAAoB,UAAU,OAAO;;;;;;;CAQvC,MAAM,iBAA+C;AAEnD,MAAI,KAAK,YACP,QAAO,KAAK;AAId,MAAI,KAAK,mBACP,QAAO,KAAK;AAId,OAAK,sBAAsB,YAAY;GAErC,MAAM,kBAAkB,KAAK;AAC7B,OAAI;IACF,IAAI;AACJ,QAAI,KAAK,OAAO,QAEd,UAAS,MAAM,gBACP,qBAAqB,KAAK,OAAO,QAAS,EAChD;KACE,QAAQ,KAAK,OAAO;KACpB,eAAe;KAChB,CACF;aACQ,KAAK,OAAO,OAErB,UAAS,MAAM,UACb,YAAY;KACV,MAAM,CACJ,kBACA,gBACA,mBACA,eACA,aACE,MAAM,QAAQ,IAAI;MACpB,WAAW,cAAc,qBAAqB,EAC5C,aAAa,KAAK,OAAO,QAC1B,CAAC;MACFA,SAAW,cAAc,qBAAqB,EAC5C,aAAa,KAAK,OAAO,QAC1B,CAAC;MACFC,qBAAsB,cAAc,qBAAqB,EACvD,aAAa,KAAK,OAAO,QAC1B,CAAC;MACFC,QAAU,cAAc,qBAAqB,EAC3C,aAAa,KAAK,OAAO,QAC1B,CAAC;MACFC,IAAM,cAAc,qBAAqB,EACvC,aAAa,KAAK,OAAO,QAC1B,CAAC;MACH,CAAC;AACF,YAAO;MACL,GAAG;MACH,UAAU,eAAe;MACzB,sBAAsB,kBAAkB;MACxC,SAAS,cAAc;MACvB,KAAK,UAAU;MAChB;OAEH;KACE,QAAQ,KAAK,OAAO;KACpB,eAAe;KAChB,CACF;QAED,OAAM,IAAI,iBAAA,kBAER,wEACD;AAGH,QAAI,KAAK,uBAAuB,iBAAiB;AAC/C,UAAK,cAAc;AACnB,UAAK,qBAAqB;;AAE5B,WAAO;YACA,OAAO;AAEd,QAAI,KAAK,uBAAuB,gBAC9B,MAAK,qBAAqB;AAE5B,QAAI,iBAAiB,iBACnB,OAAM;IAER,MAAM,WAAW,KAAK,OAAO,WAAW,KAAK,OAAO;AACpD,UAAM,IAAI,iBAAA,yBAER,wBAAwB,KAAK,OAAO,UAAU,SAAS,MAAM,aAAa,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IAChI,EAAE,KAAK,UAAU,CAClB;;MAED;AAEJ,SAAO,KAAK;;;;;;;CAQd,MAAM,mBAAmD;AACvD,MAAI,CAAC,KAAK,OAAO,UAAU,CAAC,KAAK,OAAO,SACtC,OAAM,IAAI,iBAAA,kBAER,kGACD;AAIH,MAAI,KAAK,cACP,QAAO,KAAK;AAId,MAAI,KAAK,qBACP,QAAO,KAAK;AAId,OAAK,wBAAwB,YAAY;GAEvC,MAAM,kBAAkB,KAAK;AAC7B,OAAI;IACF,MAAM,SAAS,MAAM,KAAK,eAAe,WAAW;IACpD,MAAM,WAAW,SAAS,WAAW,KAAK,OAAO,SAAU;IAC3D,MAAM,EAAE,UAAU,eAAe,iCAAiC;IAGlE,MAAM,WAAyB;KAC7B,KAAK,KAAK,OAAO;KACjB,SAAS,EAAE;KACZ;IAMD,MAAM,SAAS,MAAM,UACnB,YAAY;KACV,MAAM,IAAI,MAAM,sBAAsB,kBACpC,UACA,QACA;MACY;MACV;MACA;MACA,oBAAoB;MACpB,yBAAyB;MAC1B,CACF;KAGD,MAAM,SAAS;AACf,SAAI,OAAO,OAAO,yBAAyB,SACzC,QAAO,uBACL,KAAK,OAAO,iBAAA;UACT;MACL,MAAM,YACJ,KAAK,OAAO,iBAAA;AACd,aAAO,KACL,iBAAiB,UAAU,gEACiB,OAAO,OAAO,qBAAqB,sFAEhF;;AAEH,YAAO;OAET;KACE,QAAQ,KAAK,OAAO;KACpB,eAAe;KAChB,CACF;AAED,QAAI,KAAK,yBAAyB,iBAAiB;AACjD,UAAK,gBAAgB;AACrB,UAAK,uBAAuB;UAG5B,QAAO,YAAY;AAErB,WAAO;YACA,OAAO;AAEd,QAAI,KAAK,yBAAyB,gBAChC,MAAK,uBAAuB;AAE9B,QAAI,iBAAiB,iBACnB,OAAM;AAER,UAAM,IAAI,iBAAA,yBAER,qCAAqC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IAC3F,EAAE,QAAQ,KAAK,OAAO,QAAQ,CAC/B;;MAED;AAEJ,SAAO,KAAK;;;;;CAMd,MAAM,aAA8B;AAClC,SAAO,KAAK,eAAe,YAAY;;;;;CAMzC,YAA+B;AAC7B,SAAO,KAAK;;;;;;CAOd,MAAM,mBAAkC;AACtC,QAAM,KAAK,YAAY,aAAa,EAAE;;;;;;;;;;CAWxC,aAAmB;AACjB,MAAI,KAAK,WAAW,EAAG,MAAK,YAAY;AACxC,MAAI,KAAK,aAAa,EAAG,MAAK,UAAU;;;;;;;CAQ1C,WAAyB;AACvB,MAAI,KAAK,eAAe;AACtB,QAAK,cAAc,YAAY;AAC/B,QAAK,gBAAgB;;AAEvB,OAAK,uBAAuB;AAC5B,OAAK,cAAc;AACnB,OAAK,qBAAqB;;;AA1X5B,oBAAe,4BAA8C,IAAI,KAAK"}

package/dist/config.js

@@ -1,4 +1,4 @@
-import { ManifestMCPError, ManifestMCPErrorCode } from "./types.js";
+import { ManifestMCPError } from "./types.js";
 import { DEFAULT_RETRY_CONFIG } from "./retry.js";
 //#region src/config.ts
 /**
@@ -131,7 +131,7 @@ function validateConfig(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 });
+	if (!validation.valid) throw new ManifestMCPError("INVALID_CONFIG", `Invalid configuration: ${validation.errors.join(", ")}`, { errors: validation.errors });
 	return createConfig(input);
 }
 //#endregion

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { DEFAULT_RETRY_CONFIG } from './retry.js';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n} from './types.js';\n\n/**\n * Default address prefix for Manifest Network\n */\nconst DEFAULT_ADDRESS_PREFIX = 'manifest';\n\n/**\n * Default requests per second for rate limiting\n */\nexport const DEFAULT_REQUESTS_PER_SECOND = 10;\n\n/**\n * Default gas simulation multiplier. CosmJS defaults to 1.4 but billing module\n * transactions (close-lease in particular) can exceed that. 1.5 matches\n * the --gas-adjustment value used in this project's E2E scripts (e2e/scripts/init_billing.sh).\n */\nexport const DEFAULT_GAS_MULTIPLIER = 1.5;\n\n// Re-export for consumers\nexport { DEFAULT_RETRY_CONFIG };\n\n/**\n * Check if a hostname is localhost (IPv4, IPv6, or hostname)\n * Handles both bracketed and unbracketed IPv6 formats\n */\nfunction isLocalhostHostname(hostname: string): boolean {\n  if (hostname === 'localhost' || hostname === '127.0.0.1') {\n    return true;\n  }\n  // Handle IPv6 localhost - hostname may be '::1' or '[::1]' depending on environment\n  const normalizedHostname = hostname.replace(/^\\[|\\]$/g, '');\n  return normalizedHostname === '::1';\n}\n\n/**\n * Validate URL format and check if it uses HTTPS or is localhost (HTTP allowed for local dev)\n * Returns validation result with error reason if invalid\n */\nexport function validateEndpointUrl(\n  url: string,\n  label: string,\n): { valid: true } | { valid: false; reason: string } {\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return { valid: false, reason: `${label} must be a valid URL` };\n  }\n\n  if (parsed.protocol === 'https:') {\n    return { valid: true };\n  }\n\n  if (parsed.protocol === 'http:' && isLocalhostHostname(parsed.hostname)) {\n    return { valid: true }; // HTTP allowed for localhost\n  }\n\n  return {\n    valid: false,\n    reason: `${label} must use HTTPS (got ${parsed.protocol}//). HTTP is only allowed for local development (localhost, 127.0.0.1, ::1).`,\n  };\n}\n\n/**\n * Validate gas price format (e.g., \"1.0umfx\")\n */\nfunction isValidGasPrice(gasPrice: string): boolean {\n  // Gas price should be a number followed by a denomination.\n  // Denoms can be simple (umfx), IBC (ibc/ABC123...), or factory\n  // (factory/manifest1.../utoken). Denoms are made of non-empty segments\n  // separated by '/', with the first segment starting with a letter.\n  // Each segment may contain letters, digits, dots, colons, underscores,\n  // and hyphens. Denom length must be 3-128 chars per the Cosmos SDK spec.\n  const match = gasPrice.match(\n    /^(\\d+(?:\\.\\d+)?)([a-zA-Z][a-zA-Z0-9.:_-]*(?:\\/[a-zA-Z0-9.:_-]+)*)$/,\n  );\n  if (!match) {\n    return false;\n  }\n  const denom = match[2];\n  return denom.length >= 3 && denom.length <= 128;\n}\n\n/**\n * Validate chain ID format\n */\nfunction isValidChainId(chainId: string): boolean {\n  // Chain ID should be alphanumeric with hyphens\n  return /^[a-zA-Z0-9][\\w-]*$/.test(chainId);\n}\n\n/**\n * Create a configuration object with defaults applied\n */\nexport function createConfig(input: ManifestMCPConfig): ManifestMCPConfig {\n  return {\n    chainId: input.chainId,\n    rpcUrl: input.rpcUrl,\n    gasPrice: input.gasPrice,\n    restUrl: input.restUrl,\n    addressPrefix: input.addressPrefix ?? DEFAULT_ADDRESS_PREFIX,\n    rateLimit: {\n      requestsPerSecond:\n        input.rateLimit?.requestsPerSecond ?? DEFAULT_REQUESTS_PER_SECOND,\n    },\n    retry: {\n      maxRetries: input.retry?.maxRetries ?? DEFAULT_RETRY_CONFIG.maxRetries,\n      baseDelayMs: input.retry?.baseDelayMs ?? DEFAULT_RETRY_CONFIG.baseDelayMs,\n      maxDelayMs: input.retry?.maxDelayMs ?? DEFAULT_RETRY_CONFIG.maxDelayMs,\n    },\n    gasMultiplier: input.gasMultiplier ?? DEFAULT_GAS_MULTIPLIER,\n  };\n}\n\n/**\n * Validation result\n */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Validate a configuration object\n */\nexport function validateConfig(\n  config: Partial<ManifestMCPConfig>,\n): ValidationResult {\n  const errors: string[] = [];\n\n  // Required fields\n  if (!config.chainId) {\n    errors.push('chainId is required');\n  } else if (!isValidChainId(config.chainId)) {\n    errors.push(\n      'chainId must be alphanumeric with hyphens (e.g., \"manifest-ledger-testnet\")',\n    );\n  }\n\n  // At least one of rpcUrl or restUrl must be provided\n  if (!config.rpcUrl && !config.restUrl) {\n    errors.push('At least one of rpcUrl or restUrl is required');\n  }\n\n  if (config.rpcUrl) {\n    const urlCheck = validateEndpointUrl(config.rpcUrl, 'rpcUrl');\n    if (!urlCheck.valid) {\n      errors.push(urlCheck.reason);\n    }\n  }\n\n  if (config.restUrl) {\n    const urlCheck = validateEndpointUrl(config.restUrl, 'restUrl');\n    if (!urlCheck.valid) {\n      errors.push(urlCheck.reason);\n    }\n  }\n\n  // gasPrice required when rpcUrl is provided (needed for signing)\n  if (config.rpcUrl && !config.gasPrice) {\n    errors.push('gasPrice is required when rpcUrl is provided');\n  } else if (config.gasPrice && !isValidGasPrice(config.gasPrice)) {\n    errors.push(\n      'gasPrice must be a number followed by denomination (e.g., \"1.0umfx\", \"0.5factory/addr/udenom\", or \"0.25ibc/ABC123\")',\n    );\n  }\n\n  // Optional fields\n  if (config.addressPrefix !== undefined) {\n    if (!/^[a-z]+$/.test(config.addressPrefix)) {\n      errors.push('addressPrefix must be lowercase letters only');\n    }\n  }\n\n  if (config.rateLimit !== undefined) {\n    if (\n      typeof config.rateLimit !== 'object' ||\n      config.rateLimit === null ||\n      Array.isArray(config.rateLimit)\n    ) {\n      errors.push('rateLimit must be a plain object');\n    } else if (config.rateLimit.requestsPerSecond !== undefined) {\n      if (\n        typeof config.rateLimit.requestsPerSecond !== 'number' ||\n        config.rateLimit.requestsPerSecond <= 0 ||\n        !Number.isInteger(config.rateLimit.requestsPerSecond)\n      ) {\n        errors.push('rateLimit.requestsPerSecond must be a positive integer');\n      }\n    }\n  }\n\n  if (config.retry !== undefined) {\n    if (\n      typeof config.retry !== 'object' ||\n      config.retry === null ||\n      Array.isArray(config.retry)\n    ) {\n      errors.push('retry must be a plain object');\n    } else {\n      if (config.retry.maxRetries !== undefined) {\n        if (\n          typeof config.retry.maxRetries !== 'number' ||\n          config.retry.maxRetries < 0 ||\n          !Number.isInteger(config.retry.maxRetries)\n        ) {\n          errors.push('retry.maxRetries must be a non-negative integer');\n        }\n      }\n      if (config.retry.baseDelayMs !== undefined) {\n        if (\n          typeof config.retry.baseDelayMs !== 'number' ||\n          config.retry.baseDelayMs <= 0 ||\n          !Number.isInteger(config.retry.baseDelayMs)\n        ) {\n          errors.push('retry.baseDelayMs must be a positive integer');\n        }\n      }\n      if (config.retry.maxDelayMs !== undefined) {\n        if (\n          typeof config.retry.maxDelayMs !== 'number' ||\n          config.retry.maxDelayMs <= 0 ||\n          !Number.isInteger(config.retry.maxDelayMs)\n        ) {\n          errors.push('retry.maxDelayMs must be a positive integer');\n        }\n      }\n      // Validate maxDelayMs >= baseDelayMs if both are provided\n      if (\n        config.retry.baseDelayMs !== undefined &&\n        config.retry.maxDelayMs !== undefined &&\n        config.retry.maxDelayMs < config.retry.baseDelayMs\n      ) {\n        errors.push(\n          'retry.maxDelayMs must be greater than or equal to retry.baseDelayMs',\n        );\n      }\n    }\n  }\n\n  if (config.gasMultiplier !== undefined) {\n    if (\n      typeof config.gasMultiplier !== 'number' ||\n      !Number.isFinite(config.gasMultiplier) ||\n      config.gasMultiplier < 1\n    ) {\n      errors.push('gasMultiplier must be a finite number >= 1');\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Create and validate a configuration, throwing on invalid config\n */\nexport function createValidatedConfig(\n  input: ManifestMCPConfig,\n): ManifestMCPConfig {\n  const validation = validateConfig(input);\n\n  if (!validation.valid) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_CONFIG,\n      `Invalid configuration: ${validation.errors.join(', ')}`,\n      { errors: validation.errors },\n    );\n  }\n\n  return createConfig(input);\n}\n"],"mappings":";;;;;;AAUA,MAAM,yBAAyB;;;;AAK/B,MAAa,8BAA8B;;;;;;AAO3C,MAAa,yBAAyB;;;;;AAStC,SAAS,oBAAoB,UAA2B;AACtD,KAAI,aAAa,eAAe,aAAa,YAC3C,QAAO;AAIT,QAD2B,SAAS,QAAQ,YAAY,GAAG,KAC7B;;;;;;AAOhC,SAAgB,oBACd,KACA,OACoD;CACpD,IAAI;AACJ,KAAI;AACF,WAAS,IAAI,IAAI,IAAI;SACf;AACN,SAAO;GAAE,OAAO;GAAO,QAAQ,GAAG,MAAM;GAAuB;;AAGjE,KAAI,OAAO,aAAa,SACtB,QAAO,EAAE,OAAO,MAAM;AAGxB,KAAI,OAAO,aAAa,WAAW,oBAAoB,OAAO,SAAS,CACrE,QAAO,EAAE,OAAO,MAAM;AAGxB,QAAO;EACL,OAAO;EACP,QAAQ,GAAG,MAAM,uBAAuB,OAAO,SAAS;EACzD;;;;;AAMH,SAAS,gBAAgB,UAA2B;CAOlD,MAAM,QAAQ,SAAS,MACrB,qEACD;AACD,KAAI,CAAC,MACH,QAAO;CAET,MAAM,QAAQ,MAAM;AACpB,QAAO,MAAM,UAAU,KAAK,MAAM,UAAU;;;;;AAM9C,SAAS,eAAe,SAA0B;AAEhD,QAAO,sBAAsB,KAAK,QAAQ;;;;;AAM5C,SAAgB,aAAa,OAA6C;AACxE,QAAO;EACL,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,UAAU,MAAM;EAChB,SAAS,MAAM;EACf,eAAe,MAAM,iBAAiB;EACtC,WAAW,EACT,mBACE,MAAM,WAAW,qBAAA,IACpB;EACD,OAAO;GACL,YAAY,MAAM,OAAO,cAAc,qBAAqB;GAC5D,aAAa,MAAM,OAAO,eAAe,qBAAqB;GAC9D,YAAY,MAAM,OAAO,cAAc,qBAAqB;GAC7D;EACD,eAAe,MAAM,iBAAA;EACtB;;;;;AAcH,SAAgB,eACd,QACkB;CAClB,MAAM,SAAmB,EAAE;AAG3B,KAAI,CAAC,OAAO,QACV,QAAO,KAAK,sBAAsB;UACzB,CAAC,eAAe,OAAO,QAAQ,CACxC,QAAO,KACL,gFACD;AAIH,KAAI,CAAC,OAAO,UAAU,CAAC,OAAO,QAC5B,QAAO,KAAK,gDAAgD;AAG9D,KAAI,OAAO,QAAQ;EACjB,MAAM,WAAW,oBAAoB,OAAO,QAAQ,SAAS;AAC7D,MAAI,CAAC,SAAS,MACZ,QAAO,KAAK,SAAS,OAAO;;AAIhC,KAAI,OAAO,SAAS;EAClB,MAAM,WAAW,oBAAoB,OAAO,SAAS,UAAU;AAC/D,MAAI,CAAC,SAAS,MACZ,QAAO,KAAK,SAAS,OAAO;;AAKhC,KAAI,OAAO,UAAU,CAAC,OAAO,SAC3B,QAAO,KAAK,+CAA+C;UAClD,OAAO,YAAY,CAAC,gBAAgB,OAAO,SAAS,CAC7D,QAAO,KACL,4HACD;AAIH,KAAI,OAAO,kBAAkB,KAAA;MACvB,CAAC,WAAW,KAAK,OAAO,cAAc,CACxC,QAAO,KAAK,+CAA+C;;AAI/D,KAAI,OAAO,cAAc,KAAA;MAErB,OAAO,OAAO,cAAc,YAC5B,OAAO,cAAc,QACrB,MAAM,QAAQ,OAAO,UAAU,CAE/B,QAAO,KAAK,mCAAmC;WACtC,OAAO,UAAU,sBAAsB,KAAA;OAE9C,OAAO,OAAO,UAAU,sBAAsB,YAC9C,OAAO,UAAU,qBAAqB,KACtC,CAAC,OAAO,UAAU,OAAO,UAAU,kBAAkB,CAErD,QAAO,KAAK,yDAAyD;;;AAK3E,KAAI,OAAO,UAAU,KAAA,EACnB,KACE,OAAO,OAAO,UAAU,YACxB,OAAO,UAAU,QACjB,MAAM,QAAQ,OAAO,MAAM,CAE3B,QAAO,KAAK,+BAA+B;MACtC;AACL,MAAI,OAAO,MAAM,eAAe,KAAA;OAE5B,OAAO,OAAO,MAAM,eAAe,YACnC,OAAO,MAAM,aAAa,KAC1B,CAAC,OAAO,UAAU,OAAO,MAAM,WAAW,CAE1C,QAAO,KAAK,kDAAkD;;AAGlE,MAAI,OAAO,MAAM,gBAAgB,KAAA;OAE7B,OAAO,OAAO,MAAM,gBAAgB,YACpC,OAAO,MAAM,eAAe,KAC5B,CAAC,OAAO,UAAU,OAAO,MAAM,YAAY,CAE3C,QAAO,KAAK,+CAA+C;;AAG/D,MAAI,OAAO,MAAM,eAAe,KAAA;OAE5B,OAAO,OAAO,MAAM,eAAe,YACnC,OAAO,MAAM,cAAc,KAC3B,CAAC,OAAO,UAAU,OAAO,MAAM,WAAW,CAE1C,QAAO,KAAK,8CAA8C;;AAI9D,MACE,OAAO,MAAM,gBAAgB,KAAA,KAC7B,OAAO,MAAM,eAAe,KAAA,KAC5B,OAAO,MAAM,aAAa,OAAO,MAAM,YAEvC,QAAO,KACL,sEACD;;AAKP,KAAI,OAAO,kBAAkB,KAAA;MAEzB,OAAO,OAAO,kBAAkB,YAChC,CAAC,OAAO,SAAS,OAAO,cAAc,IACtC,OAAO,gBAAgB,EAEvB,QAAO,KAAK,6CAA6C;;AAI7D,QAAO;EACL,OAAO,OAAO,WAAW;EACzB;EACD;;;;;AAMH,SAAgB,sBACd,OACmB;CACnB,MAAM,aAAa,eAAe,MAAM;AAExC,KAAI,CAAC,WAAW,MACd,OAAM,IAAI,iBACR,qBAAqB,gBACrB,0BAA0B,WAAW,OAAO,KAAK,KAAK,IACtD,EAAE,QAAQ,WAAW,QAAQ,CAC9B;AAGH,QAAO,aAAa,MAAM"}
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { DEFAULT_RETRY_CONFIG } from './retry.js';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n} from './types.js';\n\n/**\n * Default address prefix for Manifest Network\n */\nconst DEFAULT_ADDRESS_PREFIX = 'manifest';\n\n/**\n * Default requests per second for rate limiting\n */\nexport const DEFAULT_REQUESTS_PER_SECOND = 10;\n\n/**\n * Default gas simulation multiplier. CosmJS defaults to 1.4 but billing module\n * transactions (close-lease in particular) can exceed that. 1.5 matches\n * the --gas-adjustment value used in this project's E2E scripts (e2e/scripts/init_billing.sh).\n */\nexport const DEFAULT_GAS_MULTIPLIER = 1.5;\n\n// Re-export for consumers\nexport { DEFAULT_RETRY_CONFIG };\n\n/**\n * Check if a hostname is localhost (IPv4, IPv6, or hostname)\n * Handles both bracketed and unbracketed IPv6 formats\n */\nfunction isLocalhostHostname(hostname: string): boolean {\n  if (hostname === 'localhost' || hostname === '127.0.0.1') {\n    return true;\n  }\n  // Handle IPv6 localhost - hostname may be '::1' or '[::1]' depending on environment\n  const normalizedHostname = hostname.replace(/^\\[|\\]$/g, '');\n  return normalizedHostname === '::1';\n}\n\n/**\n * Validate URL format and check if it uses HTTPS or is localhost (HTTP allowed for local dev)\n * Returns validation result with error reason if invalid\n */\nexport function validateEndpointUrl(\n  url: string,\n  label: string,\n): { valid: true } | { valid: false; reason: string } {\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return { valid: false, reason: `${label} must be a valid URL` };\n  }\n\n  if (parsed.protocol === 'https:') {\n    return { valid: true };\n  }\n\n  if (parsed.protocol === 'http:' && isLocalhostHostname(parsed.hostname)) {\n    return { valid: true }; // HTTP allowed for localhost\n  }\n\n  return {\n    valid: false,\n    reason: `${label} must use HTTPS (got ${parsed.protocol}//). HTTP is only allowed for local development (localhost, 127.0.0.1, ::1).`,\n  };\n}\n\n/**\n * Validate gas price format (e.g., \"1.0umfx\")\n */\nfunction isValidGasPrice(gasPrice: string): boolean {\n  // Gas price should be a number followed by a denomination.\n  // Denoms can be simple (umfx), IBC (ibc/ABC123...), or factory\n  // (factory/manifest1.../utoken). Denoms are made of non-empty segments\n  // separated by '/', with the first segment starting with a letter.\n  // Each segment may contain letters, digits, dots, colons, underscores,\n  // and hyphens. Denom length must be 3-128 chars per the Cosmos SDK spec.\n  const match = gasPrice.match(\n    /^(\\d+(?:\\.\\d+)?)([a-zA-Z][a-zA-Z0-9.:_-]*(?:\\/[a-zA-Z0-9.:_-]+)*)$/,\n  );\n  if (!match) {\n    return false;\n  }\n  const denom = match[2];\n  return denom.length >= 3 && denom.length <= 128;\n}\n\n/**\n * Validate chain ID format\n */\nfunction isValidChainId(chainId: string): boolean {\n  // Chain ID should be alphanumeric with hyphens\n  return /^[a-zA-Z0-9][\\w-]*$/.test(chainId);\n}\n\n/**\n * Create a configuration object with defaults applied\n */\nexport function createConfig(input: ManifestMCPConfig): ManifestMCPConfig {\n  return {\n    chainId: input.chainId,\n    rpcUrl: input.rpcUrl,\n    gasPrice: input.gasPrice,\n    restUrl: input.restUrl,\n    addressPrefix: input.addressPrefix ?? DEFAULT_ADDRESS_PREFIX,\n    rateLimit: {\n      requestsPerSecond:\n        input.rateLimit?.requestsPerSecond ?? DEFAULT_REQUESTS_PER_SECOND,\n    },\n    retry: {\n      maxRetries: input.retry?.maxRetries ?? DEFAULT_RETRY_CONFIG.maxRetries,\n      baseDelayMs: input.retry?.baseDelayMs ?? DEFAULT_RETRY_CONFIG.baseDelayMs,\n      maxDelayMs: input.retry?.maxDelayMs ?? DEFAULT_RETRY_CONFIG.maxDelayMs,\n    },\n    gasMultiplier: input.gasMultiplier ?? DEFAULT_GAS_MULTIPLIER,\n  };\n}\n\n/**\n * Validation result\n */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Validate a configuration object\n */\nexport function validateConfig(\n  config: Partial<ManifestMCPConfig>,\n): ValidationResult {\n  const errors: string[] = [];\n\n  // Required fields\n  if (!config.chainId) {\n    errors.push('chainId is required');\n  } else if (!isValidChainId(config.chainId)) {\n    errors.push(\n      'chainId must be alphanumeric with hyphens (e.g., \"manifest-ledger-testnet\")',\n    );\n  }\n\n  // At least one of rpcUrl or restUrl must be provided\n  if (!config.rpcUrl && !config.restUrl) {\n    errors.push('At least one of rpcUrl or restUrl is required');\n  }\n\n  if (config.rpcUrl) {\n    const urlCheck = validateEndpointUrl(config.rpcUrl, 'rpcUrl');\n    if (!urlCheck.valid) {\n      errors.push(urlCheck.reason);\n    }\n  }\n\n  if (config.restUrl) {\n    const urlCheck = validateEndpointUrl(config.restUrl, 'restUrl');\n    if (!urlCheck.valid) {\n      errors.push(urlCheck.reason);\n    }\n  }\n\n  // gasPrice required when rpcUrl is provided (needed for signing)\n  if (config.rpcUrl && !config.gasPrice) {\n    errors.push('gasPrice is required when rpcUrl is provided');\n  } else if (config.gasPrice && !isValidGasPrice(config.gasPrice)) {\n    errors.push(\n      'gasPrice must be a number followed by denomination (e.g., \"1.0umfx\", \"0.5factory/addr/udenom\", or \"0.25ibc/ABC123\")',\n    );\n  }\n\n  // Optional fields\n  if (config.addressPrefix !== undefined) {\n    if (!/^[a-z]+$/.test(config.addressPrefix)) {\n      errors.push('addressPrefix must be lowercase letters only');\n    }\n  }\n\n  if (config.rateLimit !== undefined) {\n    if (\n      typeof config.rateLimit !== 'object' ||\n      config.rateLimit === null ||\n      Array.isArray(config.rateLimit)\n    ) {\n      errors.push('rateLimit must be a plain object');\n    } else if (config.rateLimit.requestsPerSecond !== undefined) {\n      if (\n        typeof config.rateLimit.requestsPerSecond !== 'number' ||\n        config.rateLimit.requestsPerSecond <= 0 ||\n        !Number.isInteger(config.rateLimit.requestsPerSecond)\n      ) {\n        errors.push('rateLimit.requestsPerSecond must be a positive integer');\n      }\n    }\n  }\n\n  if (config.retry !== undefined) {\n    if (\n      typeof config.retry !== 'object' ||\n      config.retry === null ||\n      Array.isArray(config.retry)\n    ) {\n      errors.push('retry must be a plain object');\n    } else {\n      if (config.retry.maxRetries !== undefined) {\n        if (\n          typeof config.retry.maxRetries !== 'number' ||\n          config.retry.maxRetries < 0 ||\n          !Number.isInteger(config.retry.maxRetries)\n        ) {\n          errors.push('retry.maxRetries must be a non-negative integer');\n        }\n      }\n      if (config.retry.baseDelayMs !== undefined) {\n        if (\n          typeof config.retry.baseDelayMs !== 'number' ||\n          config.retry.baseDelayMs <= 0 ||\n          !Number.isInteger(config.retry.baseDelayMs)\n        ) {\n          errors.push('retry.baseDelayMs must be a positive integer');\n        }\n      }\n      if (config.retry.maxDelayMs !== undefined) {\n        if (\n          typeof config.retry.maxDelayMs !== 'number' ||\n          config.retry.maxDelayMs <= 0 ||\n          !Number.isInteger(config.retry.maxDelayMs)\n        ) {\n          errors.push('retry.maxDelayMs must be a positive integer');\n        }\n      }\n      // Validate maxDelayMs >= baseDelayMs if both are provided\n      if (\n        config.retry.baseDelayMs !== undefined &&\n        config.retry.maxDelayMs !== undefined &&\n        config.retry.maxDelayMs < config.retry.baseDelayMs\n      ) {\n        errors.push(\n          'retry.maxDelayMs must be greater than or equal to retry.baseDelayMs',\n        );\n      }\n    }\n  }\n\n  if (config.gasMultiplier !== undefined) {\n    if (\n      typeof config.gasMultiplier !== 'number' ||\n      !Number.isFinite(config.gasMultiplier) ||\n      config.gasMultiplier < 1\n    ) {\n      errors.push('gasMultiplier must be a finite number >= 1');\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Create and validate a configuration, throwing on invalid config\n */\nexport function createValidatedConfig(\n  input: ManifestMCPConfig,\n): ManifestMCPConfig {\n  const validation = validateConfig(input);\n\n  if (!validation.valid) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_CONFIG,\n      `Invalid configuration: ${validation.errors.join(', ')}`,\n      { errors: validation.errors },\n    );\n  }\n\n  return createConfig(input);\n}\n"],"mappings":"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"}

package/dist/cosmos.js

@@ -1,4 +1,4 @@
-import { ManifestMCPError, ManifestMCPErrorCode } from "./types.js";
+import { ManifestMCPError } from "./types.js";
 import { withRetry } from "./retry.js";
 import "./config.js";
 import { getQueryHandler, getTxContextLoader, getTxHandler, getTxMsgBuilder } from "./modules.js";
@@ -32,7 +32,7 @@ async function loadBuildContext(clientManager, module, subcommand) {
 			});
 			throw error;
 		}
-		throw new ManifestMCPError(ManifestMCPErrorCode.QUERY_FAILED, `Failed to load build context for ${module} ${subcommand}: ${error instanceof Error ? error.message : String(error)}`, {
+		throw new ManifestMCPError("QUERY_FAILED", `Failed to load build context for ${module} ${subcommand}: ${error instanceof Error ? error.message : String(error)}`, {
 			module,
 			subcommand
 		});
@@ -53,8 +53,8 @@ function validateName(name, field, errorCode) {
 * 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);
+	validateName(module, "module", "UNSUPPORTED_QUERY");
+	validateName(subcommand, "subcommand", "UNSUPPORTED_QUERY");
 	const handler = getQueryHandler(module);
 	return withRetry(async () => {
 		try {
@@ -73,7 +73,7 @@ async function cosmosQuery(clientManager, module, subcommand, args = []) {
 				});
 				throw error;
 			}
-			throw new ManifestMCPError(ManifestMCPErrorCode.QUERY_FAILED, `Query ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`, {
+			throw new ManifestMCPError("QUERY_FAILED", `Query ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`, {
 				module,
 				subcommand
 			});
@@ -93,13 +93,13 @@ async function cosmosQuery(clientManager, module, subcommand, args = []) {
 * (insufficient funds, invalid args, etc.) are not retried as they won't succeed.
 */
 async function cosmosTx(clientManager, module, subcommand, args = [], waitForConfirmation = false, overrides) {
-	validateName(module, "module", ManifestMCPErrorCode.UNSUPPORTED_TX);
-	validateName(subcommand, "subcommand", ManifestMCPErrorCode.UNSUPPORTED_TX);
+	validateName(module, "module", "UNSUPPORTED_TX");
+	validateName(subcommand, "subcommand", "UNSUPPORTED_TX");
 	let txOptions;
 	if (overrides?.gasMultiplier !== void 0) {
-		if (!Number.isFinite(overrides.gasMultiplier) || overrides.gasMultiplier < 1) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, `gasMultiplier must be a finite number >= 1, got ${overrides.gasMultiplier}`);
+		if (!Number.isFinite(overrides.gasMultiplier) || overrides.gasMultiplier < 1) throw new ManifestMCPError("INVALID_CONFIG", `gasMultiplier must be a finite number >= 1, got ${overrides.gasMultiplier}`);
 		const gasPrice = clientManager.getConfig().gasPrice;
-		if (!gasPrice) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, "gasMultiplier override requires gasPrice configuration");
+		if (!gasPrice) throw new ManifestMCPError("INVALID_CONFIG", "gasMultiplier override requires gasPrice configuration");
 		txOptions = {
 			gasMultiplier: overrides.gasMultiplier,
 			gasPrice
@@ -124,7 +124,7 @@ async function cosmosTx(clientManager, module, subcommand, args = [], waitForCon
 				});
 				throw error;
 			}
-			throw new ManifestMCPError(ManifestMCPErrorCode.TX_FAILED, `Tx ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`, {
+			throw new ManifestMCPError("TX_FAILED", `Tx ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`, {
 				module,
 				subcommand,
 				args
@@ -147,13 +147,13 @@ async function cosmosTx(clientManager, module, subcommand, args = [], waitForCon
 * @returns FeeEstimateResult with raw gas estimate and computed fee
 */
 async function cosmosEstimateFee(clientManager, module, subcommand, args = [], overrides) {
-	validateName(module, "module", ManifestMCPErrorCode.UNSUPPORTED_TX);
-	validateName(subcommand, "subcommand", ManifestMCPErrorCode.UNSUPPORTED_TX);
+	validateName(module, "module", "UNSUPPORTED_TX");
+	validateName(subcommand, "subcommand", "UNSUPPORTED_TX");
 	const config = clientManager.getConfig();
 	const gasPrice = config.gasPrice;
-	if (!gasPrice) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, "Fee estimation requires gasPrice configuration");
+	if (!gasPrice) throw new ManifestMCPError("INVALID_CONFIG", "Fee estimation requires gasPrice configuration");
 	if (overrides?.gasMultiplier !== void 0) {
-		if (!Number.isFinite(overrides.gasMultiplier) || overrides.gasMultiplier < 1) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_CONFIG, `gasMultiplier must be a finite number >= 1, got ${overrides.gasMultiplier}`);
+		if (!Number.isFinite(overrides.gasMultiplier) || overrides.gasMultiplier < 1) throw new ManifestMCPError("INVALID_CONFIG", `gasMultiplier must be a finite number >= 1, got ${overrides.gasMultiplier}`);
 	}
 	const builder = getTxMsgBuilder(module);
 	const buildContext = await withRetry(() => loadBuildContext(clientManager, module, subcommand), {
@@ -189,7 +189,7 @@ async function cosmosEstimateFee(clientManager, module, subcommand, args = [], o
 				});
 				throw error;
 			}
-			throw new ManifestMCPError(ManifestMCPErrorCode.SIMULATION_FAILED, `Fee estimation for ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`, {
+			throw new ManifestMCPError("SIMULATION_FAILED", `Fee estimation for ${module} ${subcommand} failed: ${error instanceof Error ? error.message : String(error)}`, {
 				module,
 				subcommand,
 				args

package/dist/cosmos.js.map

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