@t402/mcp 1.0.0 → 2.4.0

package/README.md

@@ -13,20 +13,21 @@ Enable AI agents like Claude to make stablecoin payments across multiple blockch
 
 ## Available Tools
 
-| Tool | Description |
-|------|-------------|
-| `t402/getBalance` | Get token balances for a wallet on a specific network |
-| `t402/getAllBalances` | Get balances across all supported networks |
-| `t402/pay` | Execute a stablecoin payment |
-| `t402/payGasless` | Execute a gasless payment using ERC-4337 |
-| `t402/getBridgeFee` | Get fee quote for bridging USDT0 |
-| `t402/bridge` | Bridge USDT0 between chains |
+| Tool                  | Description                                           |
+| --------------------- | ----------------------------------------------------- |
+| `t402/getBalance`     | Get token balances for a wallet on a specific network |
+| `t402/getAllBalances` | Get balances across all supported networks            |
+| `t402/pay`            | Execute a stablecoin payment                          |
+| `t402/payGasless`     | Execute a gasless payment using ERC-4337              |
+| `t402/getBridgeFee`   | Get fee quote for bridging USDT0                      |
+| `t402/bridge`         | Bridge USDT0 between chains                           |
 
 ## Claude Desktop Integration
 
 ### Quick Start
 
 1. Install the package globally:
+
 ```bash
 npm install -g @t402/mcp
 ```
@@ -132,39 +133,40 @@ Configure custom RPC endpoints for better reliability:
 
 ## Environment Variables
 
-| Variable | Description |
-|----------|-------------|
-| `T402_PRIVATE_KEY` | Wallet private key (hex with 0x prefix) |
-| `T402_DEMO_MODE` | Set to "true" for simulated transactions |
-| `T402_BUNDLER_URL` | ERC-4337 bundler URL for gasless transactions |
-| `T402_PAYMASTER_URL` | Paymaster URL for sponsored gas |
-| `T402_RPC_ETHEREUM` | Custom RPC URL for Ethereum |
-| `T402_RPC_BASE` | Custom RPC URL for Base |
-| `T402_RPC_ARBITRUM` | Custom RPC URL for Arbitrum |
-| `T402_RPC_OPTIMISM` | Custom RPC URL for Optimism |
-| `T402_RPC_POLYGON` | Custom RPC URL for Polygon |
-| `T402_RPC_AVALANCHE` | Custom RPC URL for Avalanche |
-| `T402_RPC_INK` | Custom RPC URL for Ink |
-| `T402_RPC_BERACHAIN` | Custom RPC URL for Berachain |
-| `T402_RPC_UNICHAIN` | Custom RPC URL for Unichain |
+| Variable             | Description                                   |
+| -------------------- | --------------------------------------------- |
+| `T402_PRIVATE_KEY`   | Wallet private key (hex with 0x prefix)       |
+| `T402_DEMO_MODE`     | Set to "true" for simulated transactions      |
+| `T402_BUNDLER_URL`   | ERC-4337 bundler URL for gasless transactions |
+| `T402_PAYMASTER_URL` | Paymaster URL for sponsored gas               |
+| `T402_RPC_ETHEREUM`  | Custom RPC URL for Ethereum                   |
+| `T402_RPC_BASE`      | Custom RPC URL for Base                       |
+| `T402_RPC_ARBITRUM`  | Custom RPC URL for Arbitrum                   |
+| `T402_RPC_OPTIMISM`  | Custom RPC URL for Optimism                   |
+| `T402_RPC_POLYGON`   | Custom RPC URL for Polygon                    |
+| `T402_RPC_AVALANCHE` | Custom RPC URL for Avalanche                  |
+| `T402_RPC_INK`       | Custom RPC URL for Ink                        |
+| `T402_RPC_BERACHAIN` | Custom RPC URL for Berachain                  |
+| `T402_RPC_UNICHAIN`  | Custom RPC URL for Unichain                   |
 
 ## Supported Networks
 
-| Network | Chain ID | Tokens |
-|---------|----------|--------|
-| Ethereum | 1 | USDC, USDT, USDT0 |
-| Base | 8453 | USDC |
-| Arbitrum | 42161 | USDC, USDT, USDT0 |
-| Optimism | 10 | USDC, USDT |
-| Polygon | 137 | USDC, USDT |
-| Avalanche | 43114 | USDC, USDT |
-| Ink | 57073 | USDT0 |
-| Berachain | 80094 | USDT0 |
-| Unichain | 130 | USDT0 |
+| Network   | Chain ID | Tokens            |
+| --------- | -------- | ----------------- |
+| Ethereum  | 1        | USDC, USDT, USDT0 |
+| Base      | 8453     | USDC              |
+| Arbitrum  | 42161    | USDC, USDT, USDT0 |
+| Optimism  | 10       | USDC, USDT        |
+| Polygon   | 137      | USDC, USDT        |
+| Avalanche | 43114    | USDC, USDT        |
+| Ink       | 57073    | USDT0             |
+| Berachain | 80094    | USDT0             |
+| Unichain  | 130      | USDT0             |
 
 ## Cross-Chain Bridging
 
 USDT0 can be bridged between these chains using LayerZero:
+
 - Ethereum
 - Arbitrum
 - Ink
@@ -184,23 +186,23 @@ Once configured, you can ask Claude to:
 ## Programmatic Usage
 
 ```typescript
-import { createT402McpServer, loadConfigFromEnv } from '@t402/mcp';
+import { createT402McpServer, loadConfigFromEnv } from '@t402/mcp'
 
-const config = loadConfigFromEnv();
-const server = createT402McpServer(config);
-await server.run();
+const config = loadConfigFromEnv()
+const server = createT402McpServer(config)
+await server.run()
 ```
 
 ## Using Individual Tools
 
 ```typescript
-import { executeGetBalance, executePay } from '@t402/mcp/tools';
+import { executeGetBalance, executePay } from '@t402/mcp/tools'
 
 // Check balance
 const balance = await executeGetBalance({
   network: 'base',
   address: '0x...',
-});
+})
 
 // Execute payment
 const result = await executePay(
@@ -212,8 +214,8 @@ const result = await executePay(
   },
   {
     privateKey: '0x...',
-  }
-);
+  },
+)
 ```
 
 ## Security Considerations

package/bin/t402-mcp.js

@@ -20,34 +20,34 @@
  *   ... (other networks follow same pattern)
  */
 
-import { createT402McpServer, loadConfigFromEnv } from "../dist/esm/index.mjs";
+import { createT402McpServer, loadConfigFromEnv } from '../dist/esm/index.mjs'
 
 async function main() {
-  const config = loadConfigFromEnv();
+  const config = loadConfigFromEnv()
 
   // Log configuration status (to stderr so it doesn't interfere with stdio)
-  console.error("t402 MCP Server Configuration:");
-  console.error(`  Private Key: ${config.privateKey ? "configured" : "not set"}`);
-  console.error(`  Demo Mode: ${config.demoMode ? "enabled" : "disabled"}`);
-  console.error(`  Bundler URL: ${config.bundlerUrl ? "configured" : "not set"}`);
-  console.error(`  Paymaster URL: ${config.paymasterUrl ? "configured" : "not set"}`);
+  console.error('t402 MCP Server Configuration:')
+  console.error(`  Private Key: ${config.privateKey ? 'configured' : 'not set'}`)
+  console.error(`  Demo Mode: ${config.demoMode ? 'enabled' : 'disabled'}`)
+  console.error(`  Bundler URL: ${config.bundlerUrl ? 'configured' : 'not set'}`)
+  console.error(`  Paymaster URL: ${config.paymasterUrl ? 'configured' : 'not set'}`)
 
   if (config.rpcUrls) {
-    console.error(`  Custom RPC URLs: ${Object.keys(config.rpcUrls).join(", ")}`);
+    console.error(`  Custom RPC URLs: ${Object.keys(config.rpcUrls).join(', ')}`)
   }
 
   if (!config.privateKey && !config.demoMode) {
-    console.error("");
-    console.error("Warning: No private key configured.");
-    console.error("Set T402_PRIVATE_KEY env var or enable T402_DEMO_MODE=true");
-    console.error("");
+    console.error('')
+    console.error('Warning: No private key configured.')
+    console.error('Set T402_PRIVATE_KEY env var or enable T402_DEMO_MODE=true')
+    console.error('')
   }
 
-  const server = createT402McpServer(config);
-  await server.run();
+  const server = createT402McpServer(config)
+  await server.run()
 }
 
 main().catch((error) => {
-  console.error("Fatal error:", error);
-  process.exit(1);
-});
+  console.error('Fatal error:', error)
+  process.exit(1)
+})

package/dist/cjs/index.d.ts

@@ -1,7 +1,7 @@
 export { T402McpServer, createT402McpServer, loadConfigFromEnv } from './server/index.js';
 export { AllBalancesResult, BridgeInput, BridgeOptions, GASLESS_SUPPORTED_NETWORKS, GetAllBalancesInput, GetBalanceInput, GetBridgeFeeInput, PayGaslessInput, PayGaslessOptions, PayInput, PayOptions, TOOL_DEFINITIONS, bridgeInputSchema, executeBridge, executeGetAllBalances, executeGetBalance, executeGetBridgeFee, executePay, executePayGasless, formatAllBalancesResult, formatBalanceResult, formatBridgeFeeResult, formatBridgeResult, formatGaslessPaymentResult, formatPaymentResult, getAllBalancesInputSchema, getBalanceInputSchema, getBridgeFeeInputSchema, payGaslessInputSchema, payInputSchema } from './tools/index.js';
-import { S as SupportedNetwork } from './types-BINGE6ja.js';
-export { B as BridgeFeeQuote, b as BridgeResult, C as ChainBalance, G as GaslessPaymentResult, M as McpServerConfig, P as PaymentParams, a as PaymentResult, T as TokenBalance, c as ToolContext } from './types-BINGE6ja.js';
+import { S as SupportedNetwork } from './types-CWK2p9_n.js';
+export { B as BridgeFeeQuote, b as BridgeResult, C as ChainBalance, G as GaslessPaymentResult, M as McpServerConfig, P as PaymentParams, a as PaymentResult, T as TokenBalance, c as ToolContext } from './types-CWK2p9_n.js';
 import { Address } from 'viem';
 import 'zod';
 
@@ -52,11 +52,11 @@ declare function getLayerZeroScanUrl(messageGuid: string): string;
 /**
  * Check if a network supports a specific token
  */
-declare function supportsToken(network: SupportedNetwork, token: "USDC" | "USDT" | "USDT0"): boolean;
+declare function supportsToken(network: SupportedNetwork, token: 'USDC' | 'USDT' | 'USDT0'): boolean;
 /**
  * Get token address for a network
  */
-declare function getTokenAddress(network: SupportedNetwork, token: "USDC" | "USDT" | "USDT0"): Address | undefined;
+declare function getTokenAddress(network: SupportedNetwork, token: 'USDC' | 'USDT' | 'USDT0'): Address | undefined;
 /**
  * Format token amount for display
  */

package/dist/cjs/index.js

@@ -5,6 +5,7 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -26,6 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/index.ts
 var src_exports = {};
@@ -145,7 +147,7 @@ var USDT0_ADDRESSES = {
   arbitrum: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
   ink: "0x0200C29006150606B650577BBE7B6248F58470c1",
   berachain: "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
-  unichain: "0x588ce4F028D8e7B53B687865d6A67b3A54C75518"
+  unichain: "0x9151434b16b9763660705744891fA906F660EcC5"
 };
 var BRIDGEABLE_CHAINS = [
   "ethereum",
@@ -345,13 +347,9 @@ async function executeGetBalance(input, rpcUrls) {
     tokenAddresses.push({ token: USDT0_ADDRESSES[network], expected: "USDT0" });
   }
   const tokenBalances = await Promise.all(
-    tokenAddresses.map(
-      ({ token }) => getTokenBalance(client, token, walletAddress)
-    )
-  );
-  const tokens = tokenBalances.filter(
-    (t) => t !== null
+    tokenAddresses.map(({ token }) => getTokenBalance(client, token, walletAddress))
   );
+  const tokens = tokenBalances.filter((t) => t !== null);
   return {
     network,
     chainId: CHAIN_IDS[network],
@@ -539,7 +537,7 @@ function getViemChain2(network) {
   }
 }
 async function executePay(input, options) {
-  const { to, amount, token, network, memo } = input;
+  const { to, amount, token, network, memo: _memo } = input;
   const { privateKey, rpcUrl, demoMode } = options;
   if (!supportsToken(network, token)) {
     throw new Error(`Token ${token} is not supported on ${network}`);
@@ -625,14 +623,7 @@ var payGaslessInputSchema = import_zod4.z.object({
   to: import_zod4.z.string().regex(/^0x[a-fA-F0-9]{40}$/).describe("Recipient address"),
   amount: import_zod4.z.string().regex(/^\d+(\.\d+)?$/).describe("Amount to pay (e.g., '10.50' for 10.50 USDC)"),
   token: import_zod4.z.enum(["USDC", "USDT", "USDT0"]).describe("Token to use for payment"),
-  network: import_zod4.z.enum([
-    "ethereum",
-    "base",
-    "arbitrum",
-    "optimism",
-    "polygon",
-    "avalanche"
-  ]).describe("Network to execute gasless payment on (must support ERC-4337)")
+  network: import_zod4.z.enum(["ethereum", "base", "arbitrum", "optimism", "polygon", "avalanche"]).describe("Network to execute gasless payment on (must support ERC-4337)")
 });
 var GASLESS_SUPPORTED_NETWORKS = [
   "ethereum",
@@ -668,7 +659,7 @@ function getViemChain3(network) {
 }
 async function executePayGasless(input, options) {
   const { to, amount, token, network } = input;
-  const { privateKey, bundlerUrl, paymasterUrl, rpcUrl, demoMode } = options;
+  const { privateKey, bundlerUrl, paymasterUrl: _paymasterUrl, rpcUrl, demoMode } = options;
   if (!GASLESS_SUPPORTED_NETWORKS.includes(network)) {
     throw new Error(
       `Network ${network} does not support ERC-4337 gasless transactions. Supported: ${GASLESS_SUPPORTED_NETWORKS.join(", ")}`
@@ -1058,9 +1049,7 @@ var OFT_ABI2 = [
     ]
   }
 ];
-var OFT_SENT_EVENT_TOPIC = (0, import_viem5.keccak256)(
-  (0, import_viem5.toBytes)("OFTSent(bytes32,uint32,address,uint256,uint256)")
-);
+var OFT_SENT_EVENT_TOPIC = (0, import_viem5.keccak256)((0, import_viem5.toBytes)("OFTSent(bytes32,uint32,address,uint256,uint256)"));
 function getViemChain5(network) {
   switch (network) {
     case "ethereum":
@@ -1160,11 +1149,7 @@ async function executeBridge(input, options) {
     address: usdt0Address,
     abi: OFT_ABI2,
     functionName: "send",
-    args: [
-      sendParam,
-      { nativeFee: nativeFeeWithBuffer, lzTokenFee: 0n },
-      account.address
-    ],
+    args: [sendParam, { nativeFee: nativeFeeWithBuffer, lzTokenFee: 0n }, account.address],
     value: nativeFeeWithBuffer
   });
   const receipt = await publicClient.waitForTransactionReceipt({ hash });
@@ -1207,7 +1192,7 @@ function formatBridgeResult(result) {
     `- [View on LayerZero Scan](${result.trackingUrl})`,
     `- [View Source TX](${getExplorerTxUrl(result.fromChain, result.txHash)})`,
     "",
-    "_Your USDT0 will arrive on ${result.toChain} once the LayerZero message is delivered._"
+    `_Your USDT0 will arrive on ${result.toChain} once the LayerZero message is delivered._`
   ].join("\n");
 }
 
@@ -1415,6 +1400,8 @@ var TOOL_DEFINITIONS = {
 // src/server/t402Server.ts
 var T402McpServer = class {
   constructor(config = {}) {
+    __publicField(this, "server");
+    __publicField(this, "config");
     this.config = config;
     this.server = new import_server.Server(
       {