@manifest-network/manifest-mcp-core 0.1.0

package/dist/wallet/mnemonic.d.ts

@@ -0,0 +1,47 @@
+import { ManifestMCPConfig, SignArbitraryResult, WalletProvider } from "../types.js";
+import { OfflineSigner } from "@cosmjs/proto-signing";
+
+//#region src/wallet/mnemonic.d.ts
+/**
+ * Mnemonic-based wallet provider for non-browser environments or testing
+ *
+ * SECURITY NOTE: The mnemonic is stored in memory until disconnect() is called.
+ * After disconnect(), the wallet cannot be reconnected - create a new instance instead.
+ */
+declare class MnemonicWalletProvider implements WalletProvider {
+  private config;
+  private mnemonic;
+  private wallet;
+  private aminoWallet;
+  private address;
+  private disconnected;
+  private initPromise;
+  constructor(config: ManifestMCPConfig, mnemonic: string);
+  /**
+   * Initialize the wallet from the mnemonic
+   */
+  private initWallet;
+  /**
+   * Connect (initialize) the wallet
+   */
+  connect(): Promise<void>;
+  /**
+   * Disconnect and securely clear all sensitive data
+   *
+   * IMPORTANT: After calling disconnect(), this wallet instance cannot be reused.
+   * Create a new MnemonicWalletProvider instance if you need to reconnect.
+   */
+  disconnect(): Promise<void>;
+  /**
+   * Get the wallet's address
+   */
+  getAddress(): Promise<string>;
+  /**
+   * Get the offline signer for signing transactions
+   */
+  getSigner(): Promise<OfflineSigner>;
+  signArbitrary(address: string, data: string): Promise<SignArbitraryResult>;
+}
+//#endregion
+export { MnemonicWalletProvider };
+//# sourceMappingURL=mnemonic.d.ts.map

package/dist/wallet/mnemonic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mnemonic.d.ts","names":[],"sources":["../../src/wallet/mnemonic.ts"],"mappings":";;;;;;AAoBA;;;;cAAa,sBAAA,YAAkC,cAAA;EAAA,QACrC,MAAA;EAAA,QACA,QAAA;EAAA,QACA,MAAA;EAAA,QACA,WAAA;EAAA,QACA,OAAA;EAAA,QACA,YAAA;EAAA,QAGA,WAAA;cAEI,MAAA,EAAQ,iBAAA,EAAmB,QAAA;EAXoB;;;EAAA,QAmB7C,UAAA;EAhBN;;;EAyFF,OAAA,CAAA,GAAW,OAAA;EAnFT;;;;;;EA6FF,UAAA,CAAA,GAAc,OAAA;EAVH;;;EAyBX,UAAA,CAAA,GAAc,OAAA;EAAA;;;EAgBd,SAAA,CAAA,GAAa,OAAA,CAAQ,aAAA;EAarB,aAAA,CACJ,OAAA,UACA,IAAA,WACC,OAAA,CAAQ,mBAAA;AAAA"}

package/dist/wallet/mnemonic.js

@@ -0,0 +1,97 @@
+import { ManifestMCPError, ManifestMCPErrorCode } from "../types.js";
+import { signArbitraryWithAmino } from "./sign-arbitrary.js";
+import { DirectSecp256k1HdWallet } from "@cosmjs/proto-signing";
+import { Secp256k1HdWallet } from "@cosmjs/amino";
+//#region src/wallet/mnemonic.ts
+/**
+* Mnemonic-based wallet provider for non-browser environments or testing
+*
+* SECURITY NOTE: The mnemonic is stored in memory until disconnect() is called.
+* After disconnect(), the wallet cannot be reconnected - create a new instance instead.
+*/
+var MnemonicWalletProvider = class {
+	constructor(config, mnemonic) {
+		this.wallet = null;
+		this.aminoWallet = null;
+		this.address = null;
+		this.disconnected = false;
+		this.initPromise = null;
+		this.config = config;
+		this.mnemonic = mnemonic;
+	}
+	/**
+	* Initialize the wallet from the mnemonic
+	*/
+	async initWallet() {
+		if (this.disconnected) throw new ManifestMCPError(ManifestMCPErrorCode.WALLET_NOT_CONNECTED, "Wallet has been disconnected and cannot be reconnected. Create a new MnemonicWalletProvider instance.");
+		if (this.wallet) return;
+		if (this.initPromise) return this.initPromise;
+		if (!this.mnemonic) throw new ManifestMCPError(ManifestMCPErrorCode.WALLET_NOT_CONNECTED, "Mnemonic has been cleared. Create a new MnemonicWalletProvider instance.");
+		const mnemonic = this.mnemonic;
+		this.initPromise = (async () => {
+			const prefix = this.config.addressPrefix ?? "manifest";
+			try {
+				this.wallet = await DirectSecp256k1HdWallet.fromMnemonic(mnemonic, { prefix });
+				this.aminoWallet = await Secp256k1HdWallet.fromMnemonic(mnemonic, { prefix });
+				const accounts = await this.wallet.getAccounts();
+				if (accounts.length === 0) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_MNEMONIC, "No accounts derived from mnemonic");
+				this.address = accounts[0].address;
+				this.initPromise = null;
+			} catch (error) {
+				this.initPromise = null;
+				this.wallet = null;
+				this.aminoWallet = null;
+				this.address = null;
+				if (error instanceof ManifestMCPError) throw error;
+				throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_MNEMONIC, `Failed to create wallet from mnemonic: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		})();
+		return this.initPromise;
+	}
+	/**
+	* Connect (initialize) the wallet
+	*/
+	async connect() {
+		await this.initWallet();
+	}
+	/**
+	* Disconnect and securely clear all sensitive data
+	*
+	* IMPORTANT: After calling disconnect(), this wallet instance cannot be reused.
+	* Create a new MnemonicWalletProvider instance if you need to reconnect.
+	*/
+	async disconnect() {
+		this.mnemonic = null;
+		this.wallet = null;
+		this.aminoWallet = null;
+		this.address = null;
+		this.initPromise = null;
+		this.disconnected = true;
+	}
+	/**
+	* Get the wallet's address
+	*/
+	async getAddress() {
+		await this.initWallet();
+		if (!this.address) throw new ManifestMCPError(ManifestMCPErrorCode.WALLET_NOT_CONNECTED, "Wallet failed to initialize");
+		return this.address;
+	}
+	/**
+	* Get the offline signer for signing transactions
+	*/
+	async getSigner() {
+		await this.initWallet();
+		if (!this.wallet) throw new ManifestMCPError(ManifestMCPErrorCode.WALLET_NOT_CONNECTED, "Wallet failed to initialize");
+		return this.wallet;
+	}
+	async signArbitrary(address, data) {
+		await this.initWallet();
+		if (!this.aminoWallet) throw new ManifestMCPError(ManifestMCPErrorCode.WALLET_NOT_CONNECTED, "Amino wallet failed to initialize");
+		if (!this.address) throw new ManifestMCPError(ManifestMCPErrorCode.WALLET_NOT_CONNECTED, "Wallet address not initialized");
+		return signArbitraryWithAmino(this.aminoWallet, this.address, address, data);
+	}
+};
+//#endregion
+export { MnemonicWalletProvider };
+
+//# sourceMappingURL=mnemonic.js.map

package/dist/wallet/mnemonic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mnemonic.js","names":[],"sources":["../../src/wallet/mnemonic.ts"],"sourcesContent":["import { Secp256k1HdWallet } from '@cosmjs/amino';\nimport {\n  DirectSecp256k1HdWallet,\n  type OfflineSigner,\n} from '@cosmjs/proto-signing';\nimport {\n  type ManifestMCPConfig,\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type SignArbitraryResult,\n  type WalletProvider,\n} from '../types.js';\nimport { signArbitraryWithAmino } from './sign-arbitrary.js';\n\n/**\n * Mnemonic-based wallet provider for non-browser environments or testing\n *\n * SECURITY NOTE: The mnemonic is stored in memory until disconnect() is called.\n * After disconnect(), the wallet cannot be reconnected - create a new instance instead.\n */\nexport class MnemonicWalletProvider implements WalletProvider {\n  private config: ManifestMCPConfig;\n  private mnemonic: string | null;\n  private wallet: DirectSecp256k1HdWallet | null = null;\n  private aminoWallet: Secp256k1HdWallet | null = null;\n  private address: string | null = null;\n  private disconnected: boolean = false;\n\n  // Promise to prevent concurrent wallet initialization (lazy init race condition)\n  private initPromise: Promise<void> | null = null;\n\n  constructor(config: ManifestMCPConfig, mnemonic: string) {\n    this.config = config;\n    this.mnemonic = mnemonic;\n  }\n\n  /**\n   * Initialize the wallet from the mnemonic\n   */\n  private async initWallet(): Promise<void> {\n    if (this.disconnected) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.WALLET_NOT_CONNECTED,\n        'Wallet has been disconnected and cannot be reconnected. Create a new MnemonicWalletProvider instance.',\n      );\n    }\n\n    // Return if already initialized\n    if (this.wallet) {\n      return;\n    }\n\n    // If initialization is already in progress, wait for it\n    if (this.initPromise) {\n      return this.initPromise;\n    }\n\n    if (!this.mnemonic) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.WALLET_NOT_CONNECTED,\n        'Mnemonic has been cleared. Create a new MnemonicWalletProvider instance.',\n      );\n    }\n\n    // Capture mnemonic before the async IIFE so disconnect() cannot null it mid-flight\n    const mnemonic = this.mnemonic;\n\n    // Start initialization and cache the promise to prevent concurrent init\n    this.initPromise = (async () => {\n      const prefix = this.config.addressPrefix ?? 'manifest';\n\n      try {\n        this.wallet = await DirectSecp256k1HdWallet.fromMnemonic(mnemonic, {\n          prefix,\n        });\n        this.aminoWallet = await Secp256k1HdWallet.fromMnemonic(mnemonic, {\n          prefix,\n        });\n\n        const accounts = await this.wallet.getAccounts();\n        if (accounts.length === 0) {\n          throw new ManifestMCPError(\n            ManifestMCPErrorCode.INVALID_MNEMONIC,\n            'No accounts derived from mnemonic',\n          );\n        }\n\n        this.address = accounts[0].address;\n        // Clear promise after successful init - wallet check will short-circuit future calls\n        this.initPromise = null;\n      } catch (error) {\n        // Clear state on failure so retry is possible\n        this.initPromise = null;\n        this.wallet = null;\n        this.aminoWallet = null;\n        this.address = null;\n        if (error instanceof ManifestMCPError) {\n          throw error;\n        }\n        throw new ManifestMCPError(\n          ManifestMCPErrorCode.INVALID_MNEMONIC,\n          `Failed to create wallet from mnemonic: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    })();\n\n    return this.initPromise;\n  }\n\n  /**\n   * Connect (initialize) the wallet\n   */\n  async connect(): Promise<void> {\n    await this.initWallet();\n  }\n\n  /**\n   * Disconnect and securely clear all sensitive data\n   *\n   * IMPORTANT: After calling disconnect(), this wallet instance cannot be reused.\n   * Create a new MnemonicWalletProvider instance if you need to reconnect.\n   */\n  async disconnect(): Promise<void> {\n    // Clear the mnemonic by overwriting with empty string then nullifying\n    // Note: JavaScript strings are immutable, so we can't truly zero the memory,\n    // but we can remove all references to allow garbage collection\n    this.mnemonic = null;\n    this.wallet = null;\n    this.aminoWallet = null;\n    this.address = null;\n    this.initPromise = null;\n    this.disconnected = true;\n  }\n\n  /**\n   * Get the wallet's address\n   */\n  async getAddress(): Promise<string> {\n    await this.initWallet();\n\n    if (!this.address) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.WALLET_NOT_CONNECTED,\n        'Wallet failed to initialize',\n      );\n    }\n\n    return this.address;\n  }\n\n  /**\n   * Get the offline signer for signing transactions\n   */\n  async getSigner(): Promise<OfflineSigner> {\n    await this.initWallet();\n\n    if (!this.wallet) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.WALLET_NOT_CONNECTED,\n        'Wallet failed to initialize',\n      );\n    }\n\n    return this.wallet;\n  }\n\n  async signArbitrary(\n    address: string,\n    data: string,\n  ): Promise<SignArbitraryResult> {\n    await this.initWallet();\n\n    if (!this.aminoWallet) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.WALLET_NOT_CONNECTED,\n        'Amino wallet failed to initialize',\n      );\n    }\n\n    if (!this.address) {\n      throw new ManifestMCPError(\n        ManifestMCPErrorCode.WALLET_NOT_CONNECTED,\n        'Wallet address not initialized',\n      );\n    }\n    return signArbitraryWithAmino(\n      this.aminoWallet,\n      this.address,\n      address,\n      data,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;AAoBA,IAAa,yBAAb,MAA8D;CAW5D,YAAY,QAA2B,UAAkB;AARzD,OAAQ,SAAyC;AACjD,OAAQ,cAAwC;AAChD,OAAQ,UAAyB;AACjC,OAAQ,eAAwB;AAGhC,OAAQ,cAAoC;AAG1C,OAAK,SAAS;AACd,OAAK,WAAW;;;;;CAMlB,MAAc,aAA4B;AACxC,MAAI,KAAK,aACP,OAAM,IAAI,iBACR,qBAAqB,sBACrB,wGACD;AAIH,MAAI,KAAK,OACP;AAIF,MAAI,KAAK,YACP,QAAO,KAAK;AAGd,MAAI,CAAC,KAAK,SACR,OAAM,IAAI,iBACR,qBAAqB,sBACrB,2EACD;EAIH,MAAM,WAAW,KAAK;AAGtB,OAAK,eAAe,YAAY;GAC9B,MAAM,SAAS,KAAK,OAAO,iBAAiB;AAE5C,OAAI;AACF,SAAK,SAAS,MAAM,wBAAwB,aAAa,UAAU,EACjE,QACD,CAAC;AACF,SAAK,cAAc,MAAM,kBAAkB,aAAa,UAAU,EAChE,QACD,CAAC;IAEF,MAAM,WAAW,MAAM,KAAK,OAAO,aAAa;AAChD,QAAI,SAAS,WAAW,EACtB,OAAM,IAAI,iBACR,qBAAqB,kBACrB,oCACD;AAGH,SAAK,UAAU,SAAS,GAAG;AAE3B,SAAK,cAAc;YACZ,OAAO;AAEd,SAAK,cAAc;AACnB,SAAK,SAAS;AACd,SAAK,cAAc;AACnB,SAAK,UAAU;AACf,QAAI,iBAAiB,iBACnB,OAAM;AAER,UAAM,IAAI,iBACR,qBAAqB,kBACrB,0CAA0C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACjG;;MAED;AAEJ,SAAO,KAAK;;;;;CAMd,MAAM,UAAyB;AAC7B,QAAM,KAAK,YAAY;;;;;;;;CASzB,MAAM,aAA4B;AAIhC,OAAK,WAAW;AAChB,OAAK,SAAS;AACd,OAAK,cAAc;AACnB,OAAK,UAAU;AACf,OAAK,cAAc;AACnB,OAAK,eAAe;;;;;CAMtB,MAAM,aAA8B;AAClC,QAAM,KAAK,YAAY;AAEvB,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,iBACR,qBAAqB,sBACrB,8BACD;AAGH,SAAO,KAAK;;;;;CAMd,MAAM,YAAoC;AACxC,QAAM,KAAK,YAAY;AAEvB,MAAI,CAAC,KAAK,OACR,OAAM,IAAI,iBACR,qBAAqB,sBACrB,8BACD;AAGH,SAAO,KAAK;;CAGd,MAAM,cACJ,SACA,MAC8B;AAC9B,QAAM,KAAK,YAAY;AAEvB,MAAI,CAAC,KAAK,YACR,OAAM,IAAI,iBACR,qBAAqB,sBACrB,oCACD;AAGH,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,iBACR,qBAAqB,sBACrB,iCACD;AAEH,SAAO,uBACL,KAAK,aACL,KAAK,SACL,SACA,KACD"}

package/dist/wallet/sign-arbitrary.d.ts

@@ -0,0 +1,12 @@
+import { SignArbitraryResult } from "../types.js";
+import { Secp256k1HdWallet } from "@cosmjs/amino";
+
+//#region src/wallet/sign-arbitrary.d.ts
+/**
+ * Sign arbitrary data using ADR-036 amino sign doc.
+ * Shared implementation used by both MnemonicWalletProvider and KeyfileWalletProvider.
+ */
+declare function signArbitraryWithAmino(aminoWallet: Secp256k1HdWallet, walletAddress: string, address: string, data: string): Promise<SignArbitraryResult>;
+//#endregion
+export { signArbitraryWithAmino };
+//# sourceMappingURL=sign-arbitrary.d.ts.map

package/dist/wallet/sign-arbitrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign-arbitrary.d.ts","names":[],"sources":["../../src/wallet/sign-arbitrary.ts"],"mappings":";;;;;;AAYA;;iBAAsB,sBAAA,CACpB,WAAA,EAAa,iBAAA,EACb,aAAA,UACA,OAAA,UACA,IAAA,WACC,OAAA,CAAQ,mBAAA"}

package/dist/wallet/sign-arbitrary.js

@@ -0,0 +1,36 @@
+import { ManifestMCPError, ManifestMCPErrorCode } from "../types.js";
+import { toBase64 } from "@cosmjs/encoding";
+//#region src/wallet/sign-arbitrary.ts
+/**
+* Sign arbitrary data using ADR-036 amino sign doc.
+* Shared implementation used by both MnemonicWalletProvider and KeyfileWalletProvider.
+*/
+async function signArbitraryWithAmino(aminoWallet, walletAddress, address, data) {
+	if (address !== walletAddress) throw new ManifestMCPError(ManifestMCPErrorCode.INVALID_ADDRESS, `Cannot sign for address "${address}": wallet address is "${walletAddress}"`);
+	const signDoc = {
+		chain_id: "",
+		account_number: "0",
+		sequence: "0",
+		fee: {
+			gas: "0",
+			amount: []
+		},
+		msgs: [{
+			type: "sign/MsgSignData",
+			value: {
+				signer: address,
+				data: toBase64(new TextEncoder().encode(data))
+			}
+		}],
+		memo: ""
+	};
+	const { signature } = await aminoWallet.signAmino(address, signDoc);
+	return {
+		pub_key: signature.pub_key,
+		signature: signature.signature
+	};
+}
+//#endregion
+export { signArbitraryWithAmino };
+
+//# sourceMappingURL=sign-arbitrary.js.map

package/dist/wallet/sign-arbitrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign-arbitrary.js","names":[],"sources":["../../src/wallet/sign-arbitrary.ts"],"sourcesContent":["import type { Secp256k1HdWallet } from '@cosmjs/amino';\nimport { toBase64 } from '@cosmjs/encoding';\nimport {\n  ManifestMCPError,\n  ManifestMCPErrorCode,\n  type SignArbitraryResult,\n} from '../types.js';\n\n/**\n * Sign arbitrary data using ADR-036 amino sign doc.\n * Shared implementation used by both MnemonicWalletProvider and KeyfileWalletProvider.\n */\nexport async function signArbitraryWithAmino(\n  aminoWallet: Secp256k1HdWallet,\n  walletAddress: string,\n  address: string,\n  data: string,\n): Promise<SignArbitraryResult> {\n  if (address !== walletAddress) {\n    throw new ManifestMCPError(\n      ManifestMCPErrorCode.INVALID_ADDRESS,\n      `Cannot sign for address \"${address}\": wallet address is \"${walletAddress}\"`,\n    );\n  }\n\n  const signDoc = {\n    chain_id: '',\n    account_number: '0',\n    sequence: '0',\n    fee: { gas: '0', amount: [] },\n    msgs: [\n      {\n        type: 'sign/MsgSignData',\n        value: {\n          signer: address,\n          data: toBase64(new TextEncoder().encode(data)),\n        },\n      },\n    ],\n    memo: '',\n  };\n\n  const { signature } = await aminoWallet.signAmino(address, signDoc);\n  return {\n    pub_key: signature.pub_key,\n    signature: signature.signature,\n  };\n}\n"],"mappings":";;;;;;;AAYA,eAAsB,uBACpB,aACA,eACA,SACA,MAC8B;AAC9B,KAAI,YAAY,cACd,OAAM,IAAI,iBACR,qBAAqB,iBACrB,4BAA4B,QAAQ,wBAAwB,cAAc,GAC3E;CAGH,MAAM,UAAU;EACd,UAAU;EACV,gBAAgB;EAChB,UAAU;EACV,KAAK;GAAE,KAAK;GAAK,QAAQ,EAAE;GAAE;EAC7B,MAAM,CACJ;GACE,MAAM;GACN,OAAO;IACL,QAAQ;IACR,MAAM,SAAS,IAAI,aAAa,CAAC,OAAO,KAAK,CAAC;IAC/C;GACF,CACF;EACD,MAAM;EACP;CAED,MAAM,EAAE,cAAc,MAAM,YAAY,UAAU,SAAS,QAAQ;AACnE,QAAO;EACL,SAAS,UAAU;EACnB,WAAW,UAAU;EACtB"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@manifest-network/manifest-mcp-core",
+  "version": "0.1.0",
+  "description": "Shared library for Cosmos SDK blockchain logic, tool functions, and server utilities (Manifest Network)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./__test-utils__/mocks.js": {
+      "import": "./dist/__test-utils__/mocks.js",
+      "types": "./dist/__test-utils__/mocks.d.ts"
+    },
+    "./__test-utils__/callTool.js": {
+      "import": "./dist/__test-utils__/callTool.js",
+      "types": "./dist/__test-utils__/callTool.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "mcp",
+    "cosmos",
+    "cosmjs",
+    "blockchain",
+    "manifest"
+  ],
+  "author": "Felix C. Morency",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/manifest-network/manifest-mcp-mono.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/manifest-network/manifest-mcp-mono#readme",
+  "bugs": "https://github.com/manifest-network/manifest-mcp-mono/issues",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@cosmjs/amino": "0.32.4",
+    "@cosmjs/encoding": "0.32.4",
+    "@cosmjs/proto-signing": "0.32.4",
+    "@cosmjs/stargate": "npm:@manifest-network/stargate@0.32.4-ll.3",
+    "@manifest-network/manifestjs": "2.2.0-billing-v2.3",
+    "@modelcontextprotocol/sdk": "1.27.1",
+    "limiter": "3.0.0"
+  },
+  "overrides": {
+    "@cosmjs/stargate": "npm:@manifest-network/stargate@0.32.4-ll.3",
+    "axios": "1.13.2"
+  },
+  "devDependencies": {
+    "@types/node": "22.15.29",
+    "typescript": "5.9.3",
+    "vitest": "4.1.0"
+  }
+}