@persistenceone/bridgekitty 0.3.0

package/dist/utils/tokens.js

@@ -0,0 +1,37 @@
+// Token resolution and amount formatting utilities
+// Symbol resolution delegates to the verified token registry.
+import { resolveToken } from "./token-registry.js";
+// Re-export registry types and functions for convenience
+export { resolveToken, lookupByAddress } from "./token-registry.js";
+/**
+ * Resolve a token symbol or address to { address, decimals }.
+ *
+ * Returns null if:
+ * - Symbol is unknown in the verified registry for this chain
+ * - Address is already a 0x address (still returns result with known/default decimals)
+ *
+ * @deprecated Use `resolveToken()` for better error messages.
+ *   This function is kept for backward compatibility.
+ */
+export function resolveTokenAddress(symbol, chainId) {
+    const result = resolveToken(symbol, chainId);
+    if (result.ok) {
+        return { address: result.address, decimals: result.decimals };
+    }
+    return null;
+}
+export function formatTokenAmount(amountRaw, decimals) {
+    if (!amountRaw || amountRaw === "0")
+        return "0";
+    const str = amountRaw.padStart(decimals + 1, "0");
+    const intPart = str.slice(0, str.length - decimals) || "0";
+    const fracPart = str.slice(str.length - decimals);
+    const trimmed = fracPart.replace(/0+$/, "").slice(0, 8);
+    return trimmed ? `${intPart}.${trimmed}` : intPart;
+}
+export function parseTokenAmount(amount, decimals) {
+    const [intPart, fracPart = ""] = amount.split(".");
+    const padded = fracPart.padEnd(decimals, "0").slice(0, decimals);
+    const raw = intPart + padded;
+    return raw.replace(/^0+/, "") || "0";
+}

package/dist/utils/tx-simulator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Transaction simulation via eth_estimateGas.
+ * Verifies transactions won't revert before returning them to the user.
+ * Uses multi-RPC failover for reliability.
+ */
+export interface SimulationResult {
+    success: boolean;
+    /** Estimated gas units if simulation succeeded */
+    estimatedGas?: string;
+    /** Error message if simulation failed */
+    error?: string;
+    /** Warning message for non-fatal issues */
+    warning?: string;
+}
+/**
+ * Simulate a transaction via eth_estimateGas.
+ * Returns success/failure with gas estimate or error details.
+ * Tries multiple RPCs with failover for reliability.
+ *
+ * If all RPCs are unavailable, returns a warning rather than blocking the transaction.
+ */
+export declare function simulateTransaction(chainId: number, tx: {
+    to: string;
+    data: string;
+    value: string;
+    from?: string;
+}): Promise<SimulationResult>;

package/dist/utils/tx-simulator.js

@@ -0,0 +1,105 @@
+/**
+ * Transaction simulation via eth_estimateGas.
+ * Verifies transactions won't revert before returning them to the user.
+ * Uses multi-RPC failover for reliability.
+ */
+import { getChainRpcUrls } from "./gas-estimator.js";
+const SIMULATION_TIMEOUT_MS = 8_000;
+/**
+ * Simulate a transaction via eth_estimateGas.
+ * Returns success/failure with gas estimate or error details.
+ * Tries multiple RPCs with failover for reliability.
+ *
+ * If all RPCs are unavailable, returns a warning rather than blocking the transaction.
+ */
+export async function simulateTransaction(chainId, tx) {
+    const rpcUrls = getChainRpcUrls(chainId);
+    if (rpcUrls.length === 0) {
+        console.warn(`[tx-simulator] MEDIUM-003: Simulation bypassed — no RPC configured for chainId=${chainId}. ` +
+            `Transaction will proceed without pre-flight simulation.`);
+        return {
+            success: true,
+            warning: `No RPC configured for chain ${chainId} — could not simulate. Proceed with caution.`,
+        };
+    }
+    // Build the eth_estimateGas params (reused across RPC attempts)
+    const txParam = {
+        to: tx.to,
+        data: tx.data,
+    };
+    if (tx.value && tx.value !== "0x0" && tx.value !== "0x00") {
+        txParam.value = tx.value.startsWith("0x") ? tx.value : `0x${BigInt(tx.value).toString(16)}`;
+    }
+    if (tx.from) {
+        txParam.from = tx.from;
+    }
+    const requestBody = JSON.stringify({
+        jsonrpc: "2.0",
+        method: "eth_estimateGas",
+        params: [txParam],
+        id: 1,
+    });
+    // Try each RPC in order — return first definitive result
+    let lastWarning;
+    for (const rpcUrl of rpcUrls) {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), SIMULATION_TIMEOUT_MS);
+            const res = await fetch(rpcUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: requestBody,
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            if (!res.ok) {
+                lastWarning = `RPC returned ${res.status} during simulation`;
+                continue; // Try next RPC
+            }
+            const data = await res.json();
+            if (data.error) {
+                const errorMsg = data.error.message ?? JSON.stringify(data.error);
+                // Definitive revert — don't try other RPCs
+                if (errorMsg.includes("execution reverted") ||
+                    errorMsg.includes("revert") ||
+                    errorMsg.includes("UNPREDICTABLE_GAS_LIMIT")) {
+                    return {
+                        success: false,
+                        error: `Transaction would revert: ${errorMsg.slice(0, 300)}`,
+                    };
+                }
+                // Insufficient funds is expected (simulating without user's actual balance)
+                if (errorMsg.includes("insufficient funds") ||
+                    errorMsg.includes("insufficient balance")) {
+                    return {
+                        success: true,
+                        warning: "Could not fully simulate (insufficient balance in simulation) — transaction structure appears valid.",
+                    };
+                }
+                // Other RPC-specific errors — try next RPC
+                lastWarning = `Simulation inconclusive: ${errorMsg.slice(0, 200)}`;
+                continue;
+            }
+            if (data.result) {
+                return {
+                    success: true,
+                    estimatedGas: data.result,
+                };
+            }
+            lastWarning = "Simulation returned no result";
+            continue;
+        }
+        catch (err) {
+            const errMsg = err.message;
+            lastWarning = errMsg.includes("abort")
+                ? "Simulation timed out"
+                : `Simulation failed: ${errMsg.slice(0, 200)}`;
+            continue; // Try next RPC
+        }
+    }
+    // All RPCs exhausted without a definitive result
+    return {
+        success: true,
+        warning: `${lastWarning ?? "All RPCs failed"} (tried ${rpcUrls.length} RPCs). Proceed with caution.`,
+    };
+}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@persistenceone/bridgekitty",
+  "version": "0.3.0",
+  "description": "BridgeKitty 🐱 — Cross-chain bridge aggregator MCP server for AI agents. One tool, all bridges, best routes.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bridgekitty": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "bridge",
+    "cross-chain",
+    "defi",
+    "ai-agent",
+    "lifi",
+    "debridge",
+    "across",
+    "relay",
+    "squid",
+    "cosmos",
+    "solana-bridge",
+    "persistence",
+    "xprt",
+    "evm",
+    "ethereum",
+    "arbitrum",
+    "optimism",
+    "base"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/persistenceOne/bridgekitty"
+  },
+  "dependencies": {
+    "@cosmjs/amino": "^0.38.1",
+    "@cosmjs/crypto": "^0.38.1",
+    "@cosmjs/proto-signing": "^0.38.1",
+    "@cosmjs/stargate": "^0.38.1",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@scure/bip39": "^2.0.1",
+    "@solana/spl-token": "^0.4.14",
+    "@solana/web3.js": "^1.98.0",
+    "bs58": "^6.0.0",
+    "ed25519-hd-key": "^1.3.0",
+    "ethers": "^6.16.0",
+    "ws": "^8.19.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT"
+}