@kasarlabs/starkgate-mcp 0.1.1

package/build/tools/bridgeL2toL1.js

@@ -0,0 +1,112 @@
+import * as ethers from 'ethers';
+import { STARKNET_BRIDGE_ADDRESS_MAP } from '../constants/contract-address.js';
+import { ethTokenAddresses, starknetTokenAddresses, getStarknetTokenAbi, } from '@kasarlabs/ask-starknet-core';
+import { Contract } from 'starknet';
+import { L2_BRIDGE_ABI_MAP } from '../abi/l2bridge/bridge-map.js';
+async function validateStarknetTokenBalance(tokenContract, accountAddress, tokenAmount, decimals, symbol) {
+    const balance = await tokenContract.balanceOf(accountAddress);
+    const tokenBalance = BigInt(balance.toString());
+    console.error(`Token balance: ${ethers.formatUnits(tokenBalance, decimals)} ${symbol}`);
+    if (tokenBalance < tokenAmount) {
+        throw new Error(`Insufficient ${symbol} balance. Required: ${ethers.formatUnits(tokenAmount, decimals)} ${symbol}, Available: ${ethers.formatUnits(tokenBalance, decimals)} ${symbol}`);
+    }
+}
+async function ensureStarknetTokenAllowance(tokenContract, accountAddress, bridgeAddress, tokenAmount, decimals, symbol) {
+    const allowance = await tokenContract.allowance(accountAddress, bridgeAddress);
+    const currentAllowance = BigInt(allowance.toString());
+    console.error(`Current allowance: ${ethers.formatUnits(currentAllowance, decimals)} ${symbol}`);
+    if (currentAllowance < tokenAmount) {
+        console.error(`Approving bridge to spend ${ethers.formatUnits(tokenAmount, decimals)} ${symbol}...`);
+        const approveTx = await tokenContract.approve(bridgeAddress, tokenAmount);
+        console.error('Approval transaction hash:', approveTx.transaction_hash);
+        await tokenContract.providerOrAccount.waitForTransaction(approveTx.transaction_hash);
+        console.error('Approval confirmed.');
+    }
+    else {
+        console.error('Sufficient allowance already exists, skipping approval.');
+    }
+}
+export async function withdrawToEthereum(starknetEnv, params) {
+    try {
+        const { toAddress, amount, symbol } = params;
+        const { provider, account } = starknetEnv;
+        const bridgeAddress = STARKNET_BRIDGE_ADDRESS_MAP[symbol];
+        if (!bridgeAddress) {
+            throw new Error(`Unsupported token: ${symbol}`);
+        }
+        console.error(`Using ${symbol} bridge: ${bridgeAddress}`);
+        const withdrawContract = new Contract({
+            address: bridgeAddress,
+            abi: L2_BRIDGE_ABI_MAP[symbol],
+            providerOrAccount: account,
+        });
+        let withdrawTx;
+        if (symbol === 'ETH') {
+            const weiWithdrawAmount = ethers.parseEther(amount);
+            const withdrawAmount = BigInt(weiWithdrawAmount.toString());
+            console.error(`Withdrawing ${amount} ETH (${withdrawAmount.toString()} wei) from Starknet address ${account.address} to Ethereum address ${toAddress}`);
+            console.error('Using initiate_withdraw for native ETH');
+            withdrawTx = await withdrawContract.initiate_withdraw(toAddress, withdrawAmount);
+        }
+        else {
+            const tokenAddress = starknetTokenAddresses[symbol];
+            if (!tokenAddress) {
+                throw new Error(`Starknet token address not found for ${symbol}`);
+            }
+            const tokenAbi = getStarknetTokenAbi(symbol);
+            const tokenContract = new Contract({
+                abi: tokenAbi,
+                address: tokenAddress,
+                providerOrAccount: account,
+            });
+            let decimals = 18;
+            try {
+                const fetchedDecimals = await tokenContract.decimals();
+                decimals = Number(fetchedDecimals);
+                console.error(`Fetched decimals for ${symbol}: ${decimals}`);
+            }
+            catch (error) {
+                console.error(`Failed to fetch decimals for ${symbol}, using default (18):`, error);
+            }
+            const tokenAmount = ethers.parseUnits(amount, decimals);
+            const withdrawAmount = BigInt(tokenAmount.toString());
+            console.error(`Token amount (${symbol}):`, withdrawAmount.toString());
+            console.error(`Token decimals: ${decimals}`);
+            console.error(`Withdrawing ${amount} ${symbol} from Starknet address ${account.address} to Ethereum address ${toAddress}`);
+            await validateStarknetTokenBalance(tokenContract, account.address, withdrawAmount, decimals, symbol);
+            await ensureStarknetTokenAllowance(tokenContract, account.address, bridgeAddress, withdrawAmount, decimals, symbol);
+            const l1TokenAddress = ethTokenAddresses[symbol];
+            if (!l1TokenAddress) {
+                throw new Error(`L1 token address not found for ${symbol}`);
+            }
+            console.error('Using initiate_token_withdraw for ERC20 token');
+            withdrawTx = await withdrawContract.initiate_token_withdraw(l1TokenAddress, toAddress, withdrawAmount);
+        }
+        console.error('Withdraw transaction hash:', withdrawTx.transaction_hash);
+        const receipt = await provider.waitForTransaction(withdrawTx.transaction_hash);
+        console.error('Withdraw transaction confirmed on L2.', receipt);
+        return {
+            status: 'success',
+            data: {
+                transactionHash: withdrawTx.transaction_hash,
+                amount,
+                symbol,
+                from: account.address,
+                to: toAddress,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            status: 'failure',
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+export async function bridgeL2toL1(starknetEnv, params) {
+    console.error('Bridging from Starknet to Ethereum...');
+    const result = await withdrawToEthereum(starknetEnv, params);
+    console.error('Bridging completed.');
+    return result;
+}
+//# sourceMappingURL=bridgeL2toL1.js.map

package/build/tools/bridgeL2toL1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeL2toL1.js","sourceRoot":"","sources":["../../src/tools/bridgeL2toL1.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@kasarlabs/starkgate-mcp",
+  "version": "0.1.1",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "starkgate-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js",
+    "clean": "rm -rf build",
+    "clean:all": "rm -rf build node_modules",
+    "start": "node build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "dependencies": {
+    "@hyperlane-xyz/core": "^10.0.3",
+    "@hyperlane-xyz/sdk": "^19.9.0",
+    "@kasarlabs/ask-starknet-core": "0.1.3",
+    "@langchain/core": "^0.3.75",
+    "@modelcontextprotocol/sdk": "^1.11.2",
+    "@solana/web3.js": "^1.98.4",
+    "bitcoinjs-lib": "^7.0.0",
+    "dotenv": "^16.4.7",
+    "ethers": "^6.13.4",
+    "starknet": "8.6.0",
+    "winston": "^3.17.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2"
+  },
+  "keywords": [
+    "mcp",
+    "starknet",
+    "starkgate",
+    "bridge"
+  ],
+  "author": "kasarlabs",
+  "license": "MIT",
+  "description": "MCP server for StarkGate bridge operations between Ethereum L1 and Starknet L2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "bfb4d4b055bbfa15b8e745d414adf52ac5e158fb"
+}