@manifest-network/manifest-mcp-browser 0.1.0

package/.claude/settings.local.json

@@ -0,0 +1,17 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm run lint)",
+      "Bash(npm install:*)",
+      "Bash(npm test:*)",
+      "Bash(git init:*)",
+      "Bash(npm run build:*)",
+      "Bash(find:*)",
+      "Bash(node -e:*)",
+      "Bash(ls:*)",
+      "Bash(git config:*)",
+      "WebFetch(domain:docs.npmjs.com)",
+      "WebSearch"
+    ]
+  }
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build
+        run: npm run build

package/.github/workflows/publish.yml

@@ -0,0 +1,51 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    # Required for npm trusted publishing (OIDC)
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build
+        run: npm run build
+
+      - name: Verify package version matches tag
+        run: |
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+          TAG_VERSION=${GITHUB_REF#refs/tags/v}
+          if [ "$PACKAGE_VERSION" != "$TAG_VERSION" ]; then
+            echo "Package version ($PACKAGE_VERSION) does not match tag version ($TAG_VERSION)"
+            exit 1
+          fi
+          echo "Version verified: $PACKAGE_VERSION"
+
+      - name: Publish to npm
+        run: npm publish --access public

package/CLAUDE.md

@@ -0,0 +1,104 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Browser-compatible MCP (Model Context Protocol) server for Cosmos SDK blockchain interactions with Manifest Network using CosmJS. This is a browser-friendly alternative to `manifest-mcp` that uses CosmJS/HTTP instead of CLI.
+
+## Build Commands
+
+```bash
+npm run build       # TypeScript compilation to dist/
+npm run dev         # Watch mode for TypeScript
+npm run lint        # Type-check without emitting (tsc --noEmit)
+npm test            # Run tests with vitest
+npm run test:watch  # Run tests in watch mode
+```
+
+## Architecture
+
+### Entry Point
+
+- `src/index.ts` - Main entry point, exports `ManifestMCPServer` class, `createMnemonicServer()`, and all public APIs
+
+### Core Components
+
+**ManifestMCPServer** (`src/index.ts`)
+- Wraps MCP SDK `Server` to handle tool requests
+- Exposes 5 MCP tools: `get_account_info`, `cosmos_query`, `cosmos_tx`, `list_modules`, `list_module_subcommands`
+
+**CosmosClientManager** (`src/client.ts`)
+- Singleton pattern per chainId:rpcUrl combination
+- Provides lazy-initialized query client (manifestjs RPC) and signing client (CosmJS Stargate)
+- Registers all Manifest protobuf types from `@manifest-network/manifestjs`
+
+**Wallet Providers** (`src/wallet/`)
+- `WalletProvider` interface defines `getAddress()` and `getSigner()` methods (wallet-agnostic)
+- Any wallet providing `OfflineSigner` works (cosmos-kit, Web3Auth, Keplr, Leap, etc.)
+- `MnemonicWalletProvider` - Built-in provider using `DirectSecp256k1HdWallet` for testing
+
+### Query/Transaction Routing
+
+**cosmos.ts** - Main router that validates module/subcommand names and dispatches to module handlers
+
+**queries/** - Module-specific query handlers
+- Each file exports `route{Module}Query()` function
+- Uses manifestjs RPC query client (`liftedinit.ClientFactory.createRPCQueryClient`)
+- Shared utilities in `utils.ts`: `parseBigInt()`, `parseInt()`, `defaultPagination`
+- All paginated queries use `DEFAULT_PAGE_LIMIT` (100) to prevent resource exhaustion
+
+**transactions/** - Module-specific transaction handlers
+- Each file exports `route{Module}Transaction()` function
+- Uses CosmJS `SigningStargateClient` with Manifest registries
+- Uses manifestjs enums (e.g., `VoteOption` from `cosmos.gov.v1`)
+- Shared utilities in `utils.ts`:
+  - `parseAmount()` - Parse amount strings with helpful error hints
+  - `parseBigIntWithCode()` - Base implementation used by both queries and transactions
+  - `validateAddress()` - Bech32 validation using `@cosmjs/encoding`
+  - `validateMemo()` - Enforce 256 char limit (Cosmos SDK default)
+  - `validateArgsLength()` - Enforce 100 args max to prevent DoS
+  - `buildTxResult()` - Build transaction result objects
+
+**modules.ts** - Static registry of all supported modules and subcommands (no dynamic CLI discovery)
+
+### Supported Modules
+
+Query: bank, staking, distribution, gov, auth, billing
+Transaction: bank, staking, distribution, gov, billing, manifest
+
+### Key Dependencies
+
+- `@manifest-network/manifestjs` - Protobuf types, registries, RPC client factory, and enums (e.g., `VoteOption`)
+- `@modelcontextprotocol/sdk` - MCP server implementation
+- `@cosmjs/stargate` - Signing client, gas price parsing
+- `@cosmjs/encoding` - Bech32 address validation (`fromBech32`)
+- `@cosmjs/proto-signing` - Wallet and signer interfaces
+
+### Security Features
+
+**Input Validation:**
+- Bech32 address validation using `@cosmjs/encoding`
+- Amount format validation with helpful error hints
+- Memo length limit (256 chars, Cosmos SDK default)
+- Args array length limit (100 max)
+- BigInt empty string rejection (prevents silent 0n)
+- Hex string validation for address-bytes queries
+
+**Resource Limits:**
+- Default pagination limit of 100 items for all list queries
+- Transaction broadcast timeout (60 seconds)
+- Broadcast poll interval (3 seconds)
+
+**Sensitive Data:**
+- Error responses sanitize sensitive fields (mnemonic, privateKey, secret, etc.)
+- Mnemonic cleared on wallet disconnect
+- No logging of sensitive data
+
+### Error Handling
+
+All errors use `ManifestMCPError` class with typed `ManifestMCPErrorCode` enum (see `src/types.ts`).
+
+### Type Exports
+
+`ManifestQueryClient` type in `client.ts` is derived from manifestjs `liftedinit.ClientFactory.createRPCQueryClient` return type.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Felix C. Morency
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,298 @@
+# @manifest-network/manifest-mcp-browser
+
+Browser-compatible MCP server for Cosmos SDK blockchain interactions with Manifest Network using CosmJS.
+
+This package provides the same MCP tool interface as `manifest-mcp`, but uses CosmJS instead of CLI for browser compatibility.
+
+## Installation
+
+```bash
+npm install @manifest-network/manifest-mcp-browser
+```
+
+## Development
+
+```bash
+npm run build       # TypeScript compilation to dist/
+npm run dev         # Watch mode for TypeScript
+npm run lint        # Type-check without emitting
+npm test            # Run tests
+npm run test:watch  # Run tests in watch mode
+```
+
+## Quick Start
+
+### With Any Wallet (cosmos-kit, Web3Auth, etc.)
+
+The MCP server works with any wallet that provides an `OfflineSigner`:
+
+```typescript
+import { ManifestMCPServer, WalletProvider } from '@manifest-network/manifest-mcp-browser';
+import { OfflineSigner } from '@cosmjs/proto-signing';
+
+// Create a wallet provider from your existing signer
+const walletProvider: WalletProvider = {
+  getAddress: async () => address,
+  getSigner: async () => yourOfflineSigner,
+};
+
+const server = new ManifestMCPServer({
+  config: {
+    chainId: 'manifest-ledger-testnet',
+    rpcUrl: 'https://nodes.chandrastation.com/rpc/manifest/',
+    gasPrice: '1.0umfx',
+  },
+  walletProvider,
+});
+```
+
+### With cosmos-kit
+
+```typescript
+import { useChain } from '@cosmos-kit/react';
+import { ManifestMCPServer, WalletProvider } from '@manifest-network/manifest-mcp-browser';
+
+function MyComponent() {
+  const { address, getOfflineSigner } = useChain('manifest');
+
+  const walletProvider: WalletProvider = {
+    getAddress: async () => address!,
+    getSigner: async () => getOfflineSigner(),
+  };
+
+  const server = new ManifestMCPServer({
+    config: {
+      chainId: 'manifest-ledger-testnet',
+      rpcUrl: 'https://nodes.chandrastation.com/rpc/manifest/',
+      gasPrice: '1.0umfx',
+    },
+    walletProvider,
+  });
+}
+```
+
+### Testing with Mnemonic
+
+For testing or non-interactive environments:
+
+```typescript
+import { createMnemonicServer } from '@manifest-network/manifest-mcp-browser';
+
+const server = await createMnemonicServer({
+  chainId: 'manifest-ledger-testnet',
+  rpcUrl: 'https://nodes.chandrastation.com/rpc/manifest/',
+  gasPrice: '1.0umfx',
+  mnemonic: 'your twelve word mnemonic phrase here...',
+});
+```
+
+## MCP Tools
+
+The server exposes the same five tools as `manifest-mcp`:
+
+1. **get_account_info** - Get the wallet's account address
+2. **cosmos_query** - Execute any supported Cosmos SDK query
+3. **cosmos_tx** - Execute any supported Cosmos SDK transaction
+4. **list_modules** - List available query and transaction modules
+5. **list_module_subcommands** - List subcommands for a specific module
+
+## Supported Operations
+
+### Query Modules
+
+| Module | Subcommands |
+|--------|-------------|
+| bank | balance, balances, spendable-balances, total-supply (alias: total), supply-of, params, denom-metadata, denoms-metadata, send-enabled |
+| staking | delegation, delegations, unbonding-delegation, unbonding-delegations, redelegations, validator, validators, validator-delegations, validator-unbonding-delegations, pool, params, historical-info |
+| distribution | rewards, commission, community-pool, params, validator-outstanding-rewards, slashes, delegator-validators, delegator-withdraw-address |
+| gov | proposal, proposals, vote, votes, deposit, deposits, tally, params |
+| auth | account, accounts, params, module-accounts, module-account-by-name, address-bytes-to-string, address-string-to-bytes, bech32-prefix, account-info |
+| billing | params, lease, leases, leases-by-tenant, leases-by-provider, leases-by-sku, credit-account, credit-accounts, credit-address, withdrawable-amount, provider-withdrawable, credit-estimate |
+
+### Transaction Modules
+
+| Module | Subcommands |
+|--------|-------------|
+| bank | send, multi-send |
+| staking | delegate, unbond (alias: undelegate), redelegate |
+| distribution | withdraw-rewards, set-withdraw-addr, fund-community-pool |
+| gov | vote, weighted-vote, deposit |
+| billing | fund-credit, create-lease, close-lease, withdraw |
+| manifest | payout, burn-held-balance |
+
+## Configuration
+
+```typescript
+interface ManifestMCPConfig {
+  chainId: string;        // Chain ID (e.g., "manifest-ledger-testnet")
+  rpcUrl: string;         // RPC endpoint URL
+  gasPrice: string;       // Gas price with denomination (e.g., "1.0umfx")
+  gasAdjustment?: number; // Gas adjustment multiplier (default: 1.3)
+  addressPrefix?: string; // Address prefix (default: "manifest")
+}
+```
+
+## Wallet Provider Interface
+
+Any wallet that provides an `OfflineSigner` can be used:
+
+```typescript
+interface WalletProvider {
+  getAddress(): Promise<string>;
+  getSigner(): Promise<OfflineSigner>;
+  connect?(): Promise<void>;
+  disconnect?(): Promise<void>;
+}
+```
+
+### MnemonicWalletProvider
+
+Built-in provider for testing or non-interactive environments:
+
+```typescript
+import { MnemonicWalletProvider } from '@manifest-network/manifest-mcp-browser';
+
+const wallet = new MnemonicWalletProvider(config, mnemonic);
+await wallet.connect();
+const address = await wallet.getAddress();
+```
+
+## Direct CosmJS Usage
+
+You can also use the CosmJS client manager directly:
+
+```typescript
+import {
+  CosmosClientManager,
+  cosmosQuery,
+  cosmosTx,
+} from '@manifest-network/manifest-mcp-browser';
+
+const clientManager = CosmosClientManager.getInstance(config, walletProvider);
+
+// Query balance
+const balance = await cosmosQuery(
+  clientManager,
+  'bank',
+  'balance',
+  ['manifest1...', 'umfx']
+);
+
+// Send tokens
+const result = await cosmosTx(
+  clientManager,
+  'bank',
+  'send',
+  ['manifest1recipient...', '1000umfx'],
+  true  // wait for confirmation
+);
+```
+
+## Differences from manifest-mcp
+
+| Feature | manifest-mcp | @manifest-network/manifest-mcp-browser |
+|---------|--------------|---------------------|
+| Runtime | Node.js only | Browser + Node.js |
+| Blockchain access | CLI (manifestd) | CosmJS/HTTP |
+| Module discovery | Dynamic (CLI help) | Static registry |
+| Manifest modules | Full support | Full support (manifestjs) |
+
+## Error Handling
+
+All errors are wrapped in `ManifestMCPError` with typed error codes:
+
+```typescript
+import { ManifestMCPError, ManifestMCPErrorCode } from '@manifest-network/manifest-mcp-browser';
+
+try {
+  await cosmosTx(clientManager, 'bank', 'send', ['...', '1000umfx']);
+} catch (error) {
+  if (error instanceof ManifestMCPError) {
+    console.log(error.code);    // e.g., "TX_FAILED"
+    console.log(error.message); // Human-readable message with hints
+    console.log(error.details); // Additional context
+  }
+}
+```
+
+### Error Codes
+
+| Code | Description |
+|------|-------------|
+| `INVALID_CONFIG` | Configuration validation failed |
+| `INVALID_ADDRESS` | Bech32 address validation failed |
+| `INVALID_MNEMONIC` | Invalid mnemonic phrase |
+| `TX_FAILED` | Transaction failed (invalid format, validation error) |
+| `TX_BROADCAST_FAILED` | Transaction broadcast failed |
+| `QUERY_FAILED` | Query failed (invalid args, RPC error) |
+| `UNSUPPORTED_TX` | Unsupported transaction module/subcommand |
+| `UNSUPPORTED_QUERY` | Unsupported query module/subcommand |
+| `RPC_CONNECTION_FAILED` | Failed to connect to RPC endpoint |
+| `WALLET_NOT_CONNECTED` | Wallet not connected or disconnected |
+
+## CORS Requirements
+
+The RPC endpoint must allow cross-origin requests for browser usage. If you encounter CORS errors, you may need to:
+
+1. Use an RPC endpoint that allows CORS
+2. Set up a CORS proxy
+3. Configure your own RPC node to allow CORS
+
+## Security
+
+### Key Handling
+
+This MCP server is wallet-agnostic. Security depends on the wallet provider you use:
+
+- **cosmos-kit / Keplr / Leap**: Private keys stay in the wallet extension
+- **Web3Auth**: Keys are reconstructed client-side using MPC
+- **MnemonicWalletProvider**: Mnemonic stored in memory (for testing only)
+
+### MnemonicWalletProvider Security
+
+- Mnemonic is stored in memory during the wallet's lifetime
+- Calling `disconnect()` clears the mnemonic and prevents reconnection
+- After disconnect, create a new instance if needed
+- Not recommended for production browser applications
+
+### Input Validation
+
+All inputs are validated to prevent common attack vectors:
+
+- **Address validation**: Bech32 format validated using `@cosmjs/encoding`
+- **Amount format**: Must be `<number><denom>` (e.g., `1000000umfx`)
+- **Memo length**: Limited to 256 characters (Cosmos SDK default)
+- **Args count**: Limited to 100 arguments per call
+- **BigInt parsing**: Empty strings rejected (prevents silent 0n values)
+- **Hex strings**: Validated format and length for address-bytes queries
+
+### Resource Limits
+
+Built-in protections against resource exhaustion:
+
+- **Pagination**: All list queries default to 100 items max
+- **Broadcast timeout**: Transactions timeout after 60 seconds
+- **Poll interval**: Transaction confirmation polled every 3 seconds
+
+### Best Practices
+
+1. **Use wallet adapters in browsers** - Let users control their own keys via cosmos-kit, Web3Auth, etc.
+2. **Never hardcode mnemonics** - Use environment variables or secure vaults for testing
+3. **Call disconnect() when done** - Ensures sensitive data is cleared from memory
+4. **Use HTTPS RPC endpoints** - Prevent man-in-the-middle attacks
+
+### Error Response Sanitization
+
+Error responses automatically redact sensitive fields to prevent accidental exposure:
+- Fields named `mnemonic`, `privateKey`, `secret`, `password`, `seed`, `key`, `token`, `apiKey` are replaced with `[REDACTED]`
+- Strings that appear to be mnemonics (12 or 24 words) are replaced with `[REDACTED - possible mnemonic]`
+
+### Browser Security Considerations
+
+- This package makes RPC calls to blockchain nodes - ensure you trust the RPC endpoint
+- In browser environments, use HTTPS RPC endpoints to prevent MITM attacks
+- Consider Content Security Policy (CSP) headers to restrict allowed endpoints
+
+## License
+
+MIT

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,OAAO,YAAY,EAAE,iBAAiB,CAAC,CAYlD"}

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAwB;AACxB,OAAO,EAOL,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,YAAY,CAAC;AAEpB,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,8BAA8B;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,kCAAkC;AAClC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEpD,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,aAAa;AACb,OAAO,EAAE,iBAAiB,EAA4B,MAAM,YAAY,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAO1C;IACC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAExE,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,GAAG,MAAM,CAAC;IAC1C,MAAM,cAAc,GAAG,IAAI,sBAAsB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACvE,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;IAE/B,OAAO,IAAI,iBAAiB,CAAC;QAC3B,MAAM,EAAE,SAAS;QACjB,cAAc;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,44 @@
+import { SigningStargateClient } from '@cosmjs/stargate';
+import { liftedinit } from '@manifest-network/manifestjs';
+import { ManifestMCPConfig, WalletProvider } from './types.js';
+export type ManifestQueryClient = Awaited<ReturnType<typeof liftedinit.ClientFactory.createRPCQueryClient>>;
+/**
+ * Manages CosmJS client instances with lazy initialization and singleton pattern
+ */
+export declare class CosmosClientManager {
+    private static instances;
+    private config;
+    private walletProvider;
+    private queryClient;
+    private signingClient;
+    private constructor();
+    /**
+     * Get or create a singleton instance for the given config
+     */
+    static getInstance(config: ManifestMCPConfig, walletProvider: WalletProvider): CosmosClientManager;
+    /**
+     * Clear all cached instances (useful for testing or reconnection)
+     */
+    static clearInstances(): void;
+    /**
+     * Get the manifestjs RPC query client with all module extensions
+     */
+    getQueryClient(): Promise<ManifestQueryClient>;
+    /**
+     * Get a signing client with all Manifest registries (for transactions)
+     */
+    getSigningClient(): Promise<SigningStargateClient>;
+    /**
+     * Get the wallet address
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Get the configuration
+     */
+    getConfig(): ManifestMCPConfig;
+    /**
+     * Disconnect all clients
+     */
+    disconnect(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA0B,MAAM,kBAAkB,CAAC;AACjF,OAAO,EASL,UAAU,EACX,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAA0C,MAAM,YAAY,CAAC;AAIvG,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;AA6B5G;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,SAAS,CAA+C;IAEvE,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,aAAa,CAAsC;IAE3D,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,MAAM,EAAE,iBAAiB,EACzB,cAAc,EAAE,cAAc,GAC7B,mBAAmB;IAYtB;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,IAAI;IAI7B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAkBpD;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAyCxD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;OAEG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;OAEG;IACH,UAAU,IAAI,IAAI;CAOnB"}