Merge pull request #4 from hyperweb-io/feat/interchainjs-tools

feat: interchainjs mcp tools

Author: marslavish

package.json

@@ -5,7 +5,7 @@
   "main": "build/index.js",
   "scripts": {
     "build": "tsc && npm run copy-prompts && chmod 755 build/index.js",
-    "copy-prompts": "mkdir -p build/starship && cp -r src/starship/prompts build/starship/",
+    "copy-prompts": "./scripts/copy-prompts.sh",
     "clean": "rimraf build",
     "test": "vitest",
     "test:watch": "vitest --watch",
@@ -30,19 +30,14 @@
     "typescript": "^5.8.2",
     "vitest": "^3.1.1"
   },
-  "files": [
-    "build"
-  ],
+  "files": ["build"],
   "pnpm": {
-    "onlyBuiltDependencies": [
-      "@biomejs/biome",
-      "esbuild"
-    ]
+    "onlyBuiltDependencies": ["@biomejs/biome", "esbuild"]
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.7.0",
     "dotenv": "^16.4.7",
     "js-yaml": "^4.1.0",
     "zod": "^3.24.2"
   }
-}
+}

scripts/copy-prompts.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+# Ensure the script fails on any error
+set -e
+
+# Find all prompts directories under src
+PROMPTS_DIRS=$(find src -type d -name prompts)
+
+# Process each prompts directory
+for PROMPT_DIR in $PROMPTS_DIRS; do
+    # Get the relative path without 'src/'
+    REL_PATH=$(dirname "$PROMPT_DIR" | sed 's|^src/||')
+    
+    # Create the target directory
+    mkdir -p "build/$REL_PATH"
+    
+    # Copy the prompts
+    cp -r "$PROMPT_DIR" "build/$REL_PATH/"
+done
+
+# Copy migration-examples directory
+if [ -d "src/interchainjs/migration-examples" ]; then
+    mkdir -p "build/interchainjs"
+    cp -r "src/interchainjs/migration-examples" "build/interchainjs/"
+fi

src/index.ts

@@ -6,6 +6,7 @@ import { fileURLToPath } from "node:url";
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerMigrateToInterchainjsTool } from "./interchainjs/tools/migrate-to-interchainjs.js";
 import { registerStarshipConfigGenTool } from "./starship/tools/starship-config-gen.js";
 import { registerStarshipSetupTool } from "./starship/tools/starship-setup.js";
 
@@ -25,8 +26,12 @@ async function main() {
     version: VERSION,
   });
 
-  registerStarshipConfigGenTool(server);
+  // Starship
   registerStarshipSetupTool(server);
+  registerStarshipConfigGenTool(server);
+
+  // InterchainJS
+  registerMigrateToInterchainjsTool(server);
 
   const transport = new StdioServerTransport();
   await server.connect(transport);

src/interchainjs/migration-examples/cosmjs-signing.ts

@@ -0,0 +1,82 @@
+import { DirectSecp256k1HdWallet } from "@cosmjs/proto-signing";
+import {
+  GasPrice,
+  SigningStargateClient,
+  calculateFee,
+} from "@cosmjs/stargate";
+import type { MsgSend } from "cosmjs-types/cosmos/bank/v1beta1/tx";
+
+// --- Configuration & Setup ---
+
+const rpcEndpoint = "rpc.cosmos.network:26657"; // Replace with your RPC endpoint
+const senderMnemonic = "..."; // Replace with a valid mnemonic (for testing only!)
+const recipientAddress = "cosmos1..."; // Replace with a recipient address
+const amountToSend = {
+  denom: "uatom",
+  amount: "1000",
+};
+const gasPrice = GasPrice.fromString("0.025uatom");
+const gasLimit = 200000;
+const fee = calculateFee(gasLimit, gasPrice);
+const memo = "Sent via CosmJS";
+
+// Type registry setup (only needed for custom message types, MsgSend is built-in)
+// const registry = new Registry();
+// const typeUrl = "/cosmos.bank.v1beta1.MsgSend"; // Example type URL
+// registry.register(typeUrl, MsgSend);
+
+// --- Main Signing Logic (Conceptual Example) ---
+
+async function signAndBroadcast() {
+  // 1. Get a signer (e.g., from a mnemonic or browser extension like Keplr)
+  // Using mnemonic here for a self-contained example (DO NOT use mainnet mnemonics in code)
+  const signer = await DirectSecp256k1HdWallet.fromMnemonic(senderMnemonic, {
+    prefix: "cosmos",
+  });
+  const [firstAccount] = await signer.getAccounts();
+  const senderAddress = firstAccount.address;
+
+  console.log(`Sender address: ${senderAddress}`);
+
+  // 2. Create the signing client
+  const signingClient = await SigningStargateClient.connectWithSigner(
+    rpcEndpoint,
+    signer,
+    // Optional: Provide registry if using custom types
+    // { registry: registry }
+  );
+
+  // 3. Create the message
+  const message: MsgSend = {
+    fromAddress: senderAddress,
+    toAddress: recipientAddress,
+    amount: [amountToSend],
+  };
+
+  // The type URL is crucial for Stargate messages
+  const msgAny = {
+    typeUrl: "/cosmos.bank.v1beta1.MsgSend",
+    value: message,
+  };
+
+  // 4. Sign and broadcast the transaction
+  try {
+    console.log("Signing and broadcasting transaction...");
+    const result = await signingClient.signAndBroadcast(
+      senderAddress,
+      [msgAny], // Array of messages
+      fee,
+      memo,
+    );
+    console.log("Transaction successful:", result.transactionHash);
+    console.log("Result details:", result);
+  } catch (error) {
+    console.error("Transaction failed:", error);
+  }
+}
+
+// --- Execute the function ---
+// signAndBroadcast(); // Uncomment to run, requires valid RPC and mnemonic
+
+console.log("Example signing code structure loaded.");
+console.log("Ensure RPC endpoint and mnemonic are configured before running.");

src/interchainjs/migration-examples/cosmjs-utils.ts

@@ -0,0 +1,39 @@
+import { fromBech32, toBech32 } from "@cosmjs/encoding";
+import { Decimal, Uint53 } from "@cosmjs/math";
+import { parseCoins } from "@cosmjs/stargate";
+
+// Example 1: Bech32 encoding and decoding
+const decodedAddress = fromBech32(
+  "cosmos1zmj0fpkm9px3f7klg7hzycu6z6k76jskvnsc0n",
+);
+console.log("Decoded Address Prefix:", decodedAddress.prefix);
+console.log("Decoded Address Data Length:", decodedAddress.data.length);
+
+const reEncodedAddress = toBech32("cosmos", decodedAddress.data);
+console.log("Re-encoded Address:", reEncodedAddress);
+
+// Example 2: Parsing coin strings
+const coinsString = "1000000uatom,500000stake";
+const parsedCoins = parseCoins(coinsString);
+console.log("Parsed Coins:", parsedCoins);
+
+const singleCoinString = "12345uosmo";
+const parsedCoin = parseCoins(singleCoinString)[0];
+console.log("Parsed Single Coin:", parsedCoin);
+
+// Example 3: Using Decimal for calculations
+const amount1 = Decimal.fromUserInput("123.456", 6); // Represents 123.456000
+const amount2 = Decimal.fromUserInput("0.001", 6); // Represents 0.001000
+
+const sum = amount1.plus(amount2);
+console.log(
+  `Sum: ${sum.toString()} (fractional digits: ${sum.fractionalDigits})`,
+);
+
+const product = amount1.multiply(new Uint53(2)); // Multiply by 2
+console.log(
+  `Product: ${product.toString()} (fractional digits: ${product.fractionalDigits})`,
+);
+
+const division = amount1.toFloatApproximation() / 10;
+console.log(`Division (approx float): ${division}`);

src/interchainjs/migration-examples/interchainjs-signing.ts

@@ -0,0 +1,89 @@
+import { SigningClient } from "@interchainjs/cosmos/signing-client";
+import { DirectGenericOfflineSigner } from "@interchainjs/cosmos/types/wallet";
+import { assertIsDeliverTxSuccess } from "@interchainjs/cosmos/utils";
+import { Secp256k1HDWallet } from "@interchainjs/cosmos/wallets/secp256k1hd";
+import { HDPath } from "@interchainjs/types";
+import type { MsgSend } from "interchainjs/cosmos/bank/v1beta1/tx";
+import { send } from "interchainjs/cosmos/bank/v1beta1/tx.rpc.func";
+
+// --- Configuration & Setup ---
+
+const rpcEndpoint = "rpc.cosmos.network:26657"; // Replace with your RPC endpoint
+const senderMnemonic = "..."; // Replace with a valid mnemonic (for testing only!)
+const recipientAddress = "cosmos1..."; // Replace with a recipient address
+const amountToSend = {
+  denom: "uatom",
+  amount: "1000",
+};
+const chainPrefix = "cosmos"; // Prefix for Cosmos Hub
+
+// Fee object (adjust gas limit and amount as needed)
+const fee = {
+  amount: [
+    {
+      denom: amountToSend.denom, // Match the send denom
+      amount: "5000", // Example fee amount
+    },
+  ],
+  gas: "200000", // Example gas limit
+};
+const memo = "Sent via InterchainJS";
+
+// --- Main Signing Logic (Conceptual Example) ---
+
+async function signAndBroadcast() {
+  // 1. Initialize wallet and get signer
+  const wallet = Secp256k1HDWallet.fromMnemonic(senderMnemonic, [
+    {
+      prefix: chainPrefix,
+      hdPath: HDPath.cosmos(0, 0, 0).toString(), // Standard Cosmos path
+    },
+  ]);
+  const offlineSigner = wallet.toOfflineDirectSigner();
+  const [firstAccount] = await offlineSigner.getAccounts();
+  const senderAddress = firstAccount.address;
+
+  console.log(`Sender address: ${senderAddress}`);
+
+  // 2. Wrap signer and create the signing client
+  const genericSigner = new DirectGenericOfflineSigner(offlineSigner);
+  const signingClient = await SigningClient.connectWithSigner(
+    rpcEndpoint,
+    genericSigner,
+    {
+      // Optional: Configure broadcast options if needed
+      broadcast: {
+        checkTx: true,
+        deliverTx: true,
+      },
+    },
+  );
+
+  // 3. Prepare the message payload for the 'send' function
+  // Note: The 'send' function takes the message fields directly
+  const msgPayload: MsgSend = {
+    fromAddress: senderAddress,
+    toAddress: recipientAddress,
+    amount: [amountToSend],
+  };
+
+  // 4. Call the specific 'send' function
+  try {
+    const result = await send(
+      signingClient,
+      senderAddress, // Sender address
+      msgPayload, // The message payload
+      fee, // The fee object
+      memo, // The memo string
+    );
+    console.log(result);
+
+    // Optional: Check for success (interchainjs might throw on error depending on setup)
+    assertIsDeliverTxSuccess(result);
+  } catch (error) {
+    console.error("Transaction failed:", error);
+  }
+}
+
+// --- Execute the function ---
+// signAndBroadcast(); // Uncomment to run, requires valid RPC and mnemonic

src/interchainjs/migration-examples/interchainjs-utils.ts

@@ -0,0 +1,39 @@
+import { parseCoins } from "@interchainjs/amino";
+import { fromBech32, toBech32 } from "@interchainjs/encoding";
+import { Decimal, Uint53 } from "@interchainjs/math";
+
+// Example 1: Bech32 encoding and decoding
+const decodedAddress = fromBech32(
+	"cosmos1zmj0fpkm9px3f7klg7hzycu6z6k76jskvnsc0n",
+);
+console.log("Decoded Address Prefix:", decodedAddress.prefix);
+console.log("Decoded Address Data Length:", decodedAddress.data.length);
+
+const reEncodedAddress = toBech32("cosmos", decodedAddress.data);
+console.log("Re-encoded Address:", reEncodedAddress);
+
+// Example 2: Parsing coin strings
+const coinsString = "1000000uatom,500000stake";
+const parsedCoins = parseCoins(coinsString);
+console.log("Parsed Coins:", parsedCoins);
+
+const singleCoinString = "12345uosmo";
+const parsedCoin = parseCoins(singleCoinString)[0];
+console.log("Parsed Single Coin:", parsedCoin);
+
+// Example 3: Using Decimal for calculations
+const amount1 = Decimal.fromUserInput("123.456", 6); // Represents 123.456000
+const amount2 = Decimal.fromUserInput("0.001", 6); // Represents 0.001000
+
+const sum = amount1.plus(amount2);
+console.log(
+	`Sum: ${sum.toString()} (fractional digits: ${sum.fractionalDigits})`,
+);
+
+const product = amount1.multiply(new Uint53(2)); // Multiply by 2
+console.log(
+	`Product: ${product.toString()} (fractional digits: ${product.fractionalDigits})`,
+);
+
+const division = amount1.toFloatApproximation() / 10;
+console.log(`Division (approx float): ${division}`);