@t402/mcp 2.5.0 → 2.6.0

package/dist/cjs/tools/index.js

@@ -31,10 +31,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var tools_exports = {};
 __export(tools_exports, {
   GASLESS_SUPPORTED_NETWORKS: () => GASLESS_SUPPORTED_NETWORKS,
+  TON_BRIDGE_TOOLS: () => TON_BRIDGE_TOOLS,
   TOOL_DEFINITIONS: () => TOOL_DEFINITIONS,
+  UNIFIED_TOOL_DEFINITIONS: () => UNIFIED_TOOL_DEFINITIONS,
   WDK_TOOL_DEFINITIONS: () => WDK_TOOL_DEFINITIONS,
   autoPayInputSchema: () => autoPayInputSchema,
   bridgeInputSchema: () => bridgeInputSchema,
+  createTonBridgeToolSet: () => createTonBridgeToolSet,
   executeAutoPay: () => executeAutoPay,
   executeAutoPayDemo: () => executeAutoPayDemo,
   executeBridge: () => executeBridge,
@@ -43,6 +46,11 @@ __export(tools_exports, {
   executeGetBridgeFee: () => executeGetBridgeFee,
   executePay: () => executePay,
   executePayGasless: () => executePayGasless,
+  executePaymentPlan: () => executePaymentPlan,
+  executePaymentPlanDemo: () => executePaymentPlanDemo,
+  executeSmartPay: () => executeSmartPay,
+  executeSmartPayDemo: () => executeSmartPayDemo,
+  executeTonBridgeTool: () => executeTonBridgeTool,
   executeWdkGetBalances: () => executeWdkGetBalances,
   executeWdkGetBalancesDemo: () => executeWdkGetBalancesDemo,
   executeWdkGetWallet: () => executeWdkGetWallet,
@@ -57,7 +65,9 @@ __export(tools_exports, {
   formatBridgeFeeResult: () => formatBridgeFeeResult,
   formatBridgeResult: () => formatBridgeResult,
   formatGaslessPaymentResult: () => formatGaslessPaymentResult,
+  formatPaymentPlanResult: () => formatPaymentPlanResult,
   formatPaymentResult: () => formatPaymentResult,
+  formatSmartPayResult: () => formatSmartPayResult,
   formatWdkBalancesResult: () => formatWdkBalancesResult,
   formatWdkSwapResult: () => formatWdkSwapResult,
   formatWdkTransferResult: () => formatWdkTransferResult,
@@ -67,6 +77,8 @@ __export(tools_exports, {
   getBridgeFeeInputSchema: () => getBridgeFeeInputSchema,
   payGaslessInputSchema: () => payGaslessInputSchema,
   payInputSchema: () => payInputSchema,
+  paymentPlanInputSchema: () => paymentPlanInputSchema,
+  smartPayInputSchema: () => smartPayInputSchema,
   wdkGetBalancesInputSchema: () => wdkGetBalancesInputSchema,
   wdkGetWalletInputSchema: () => wdkGetWalletInputSchema,
   wdkSwapInputSchema: () => wdkSwapInputSchema,
@@ -1465,6 +1477,496 @@ function formatAutoPayResult(result) {
   return lines.join("\n");
 }
 
+// src/tools/ton-bridge.ts
+var TON_BRIDGE_TOOLS = {
+  "ton/getBalance": {
+    name: "ton/getBalance",
+    description: "Get TON and Jetton balances for a wallet address on the TON blockchain.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        address: {
+          type: "string",
+          description: "TON wallet address (friendly or raw format)"
+        }
+      },
+      required: ["address"]
+    }
+  },
+  "ton/transfer": {
+    name: "ton/transfer",
+    description: "Send TON to a recipient address on the TON blockchain.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        to: {
+          type: "string",
+          description: "Recipient TON address"
+        },
+        amount: {
+          type: "string",
+          description: 'Amount of TON to send (e.g., "1.5")'
+        },
+        memo: {
+          type: "string",
+          description: "Optional memo/comment for the transfer"
+        }
+      },
+      required: ["to", "amount"]
+    }
+  },
+  "ton/getJettonBalance": {
+    name: "ton/getJettonBalance",
+    description: "Get the balance of a specific Jetton (TON token) for a wallet address.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        address: {
+          type: "string",
+          description: "TON wallet address"
+        },
+        jettonMaster: {
+          type: "string",
+          description: "Jetton master contract address"
+        }
+      },
+      required: ["address", "jettonMaster"]
+    }
+  },
+  "ton/swapJettons": {
+    name: "ton/swapJettons",
+    description: "Swap Jettons (TON tokens) using DEX aggregation on the TON network. Returns a raw transaction JSON to be sent via sendTransaction.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        from: {
+          type: "string",
+          description: 'Source Jetton master address (or "TON" for native TON)'
+        },
+        to: {
+          type: "string",
+          description: 'Destination Jetton master address (or "TON" for native TON)'
+        },
+        amount: {
+          type: "string",
+          description: 'Amount to swap in human-readable format (e.g., "1.5")'
+        },
+        slippage: {
+          type: "string",
+          description: 'Slippage tolerance (e.g., "0.5" for 0.5%)'
+        }
+      },
+      required: ["from", "to", "amount"]
+    }
+  },
+  "ton/getTransactionStatus": {
+    name: "ton/getTransactionStatus",
+    description: "Check the status and details of a TON transaction by its hash.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        txHash: {
+          type: "string",
+          description: "Transaction hash (BOC hash or message hash)"
+        }
+      },
+      required: ["txHash"]
+    }
+  }
+};
+async function executeTonBridgeTool(toolName, args, config) {
+  if (config.demoMode) {
+    return executeTonBridgeToolDemo(toolName, args);
+  }
+  if (config.tonMcpEndpoint) {
+    return proxyToTonMcp(toolName, args, config.tonMcpEndpoint);
+  }
+  if (config.tonApiKey) {
+    return executeTonBridgeToolDirect(toolName, args, config.tonApiKey);
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Error: TON MCP bridge not configured. Set tonMcpEndpoint or tonApiKey.`
+      }
+    ],
+    isError: true
+  };
+}
+function executeTonBridgeToolDemo(toolName, args) {
+  const responses = {
+    "ton/getBalance": `[DEMO] TON Balance for ${args.address ?? "unknown"}:
+- TON: 5.25
+- USDT0: 100.00`,
+    "ton/transfer": `[DEMO] Transfer sent:
+- To: ${args.to ?? "unknown"}
+- Amount: ${args.amount ?? "0"} TON
+- TX: demo-ton-tx-hash-${Date.now().toString(36)}`,
+    "ton/getJettonBalance": `[DEMO] Jetton Balance:
+- Address: ${args.address ?? "unknown"}
+- Jetton: ${args.jettonMaster ?? "unknown"}
+- Balance: 50.00`,
+    "ton/swapJettons": `[DEMO] Swap quote received:
+- From: ${args.from ?? "unknown"}
+- To: ${args.to ?? "unknown"}
+- Amount: ${args.amount ?? "0"}
+- Transaction: {"validUntil":${Math.floor(Date.now() / 1e3) + 300},"messages":[{"address":"EQDemo...","amount":"${args.amount ?? "0"}","payload":"base64..."}]}`,
+    "ton/getTransactionStatus": `[DEMO] Transaction Status:
+- Hash: ${args.txHash ?? "unknown"}
+- Status: Confirmed
+- Block: 12345678`
+  };
+  return {
+    content: [
+      {
+        type: "text",
+        text: responses[toolName] ?? `[DEMO] Unknown TON tool: ${toolName}`
+      }
+    ]
+  };
+}
+async function proxyToTonMcp(toolName, args, endpoint) {
+  try {
+    const response = await fetch(endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: { name: toolName, arguments: args }
+      })
+    });
+    if (!response.ok) {
+      throw new Error(`TON MCP server returned ${response.status}`);
+    }
+    const result = await response.json();
+    if (result.error) {
+      throw new Error(result.error.message);
+    }
+    return result.result ?? { content: [{ type: "text", text: "No result" }] };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      content: [{ type: "text", text: `Error proxying to @ton/mcp: ${message}` }],
+      isError: true
+    };
+  }
+}
+async function executeTonBridgeToolDirect(toolName, args, apiKey) {
+  const baseUrl = "https://toncenter.com/api/v2";
+  try {
+    switch (toolName) {
+      case "ton/getBalance": {
+        const response = await fetch(
+          `${baseUrl}/getAddressBalance?address=${encodeURIComponent(String(args.address))}&api_key=${apiKey}`
+        );
+        const data = await response.json();
+        const balanceNano = BigInt(data.result);
+        const balanceTon = Number(balanceNano) / 1e9;
+        return {
+          content: [{ type: "text", text: `TON Balance: ${balanceTon.toFixed(4)} TON` }]
+        };
+      }
+      case "ton/getTransactionStatus": {
+        const response = await fetch(
+          `${baseUrl}/getTransactions?hash=${encodeURIComponent(String(args.txHash))}&limit=1&api_key=${apiKey}`
+        );
+        const data = await response.json();
+        if (data.result.length === 0) {
+          return {
+            content: [{ type: "text", text: "Transaction not found" }]
+          };
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Transaction found:
+${JSON.stringify(data.result[0], null, 2)}`
+            }
+          ]
+        };
+      }
+      default:
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Direct execution of ${toolName} is not supported. Configure tonMcpEndpoint to proxy to @ton/mcp.`
+            }
+          ],
+          isError: true
+        };
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      content: [{ type: "text", text: `Error executing TON API call: ${message}` }],
+      isError: true
+    };
+  }
+}
+function createTonBridgeToolSet(config) {
+  return {
+    definitions: TON_BRIDGE_TOOLS,
+    async handleToolCall(name, args) {
+      return executeTonBridgeTool(name, args, config);
+    }
+  };
+}
+
+// src/tools/unified.ts
+var import_zod12 = require("zod");
+var import_wdk_protocol2 = require("@t402/wdk-protocol");
+var smartPayInputSchema = import_zod12.z.object({
+  url: import_zod12.z.string().url().describe("URL of the 402-protected resource"),
+  maxBridgeFee: import_zod12.z.string().regex(/^\d+(\.\d+)?$/).optional().describe("Maximum acceptable bridge fee in native token (optional)"),
+  preferredNetwork: import_zod12.z.string().optional().describe("Preferred network for payment (optional)")
+});
+var paymentPlanInputSchema = import_zod12.z.object({
+  paymentRequired: import_zod12.z.object({
+    scheme: import_zod12.z.string().optional(),
+    network: import_zod12.z.string().optional(),
+    maxAmountRequired: import_zod12.z.string().optional(),
+    resource: import_zod12.z.string().optional(),
+    description: import_zod12.z.string().optional(),
+    payTo: import_zod12.z.string().optional(),
+    maxDeadline: import_zod12.z.number().optional()
+  }).passthrough().describe("The 402 PaymentRequired response")
+});
+var UNIFIED_TOOL_DEFINITIONS = {
+  "t402/smartPay": {
+    name: "t402/smartPay",
+    description: "Intelligent payment that automatically checks balance, bridges if needed, and pays. Handles the entire payment flow for 402-protected resources.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL of the 402-protected resource" },
+        maxBridgeFee: {
+          type: "string",
+          description: "Maximum acceptable bridge fee in native token (optional)"
+        },
+        preferredNetwork: {
+          type: "string",
+          description: "Preferred network for payment (optional)"
+        }
+      },
+      required: ["url"]
+    }
+  },
+  "t402/paymentPlan": {
+    name: "t402/paymentPlan",
+    description: "Analyze a 402 response and create an optimal payment plan considering balances across all chains. Returns recommended network, bridge requirements, and balance overview.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        paymentRequired: {
+          type: "object",
+          description: "The 402 PaymentRequired response"
+        }
+      },
+      required: ["paymentRequired"]
+    }
+  }
+};
+async function executeSmartPay(input, wdk) {
+  const steps = [];
+  const chains6 = input.preferredNetwork ? [input.preferredNetwork] : ["ethereum", "arbitrum", "base"];
+  steps.push({
+    action: "check_balance",
+    status: "success",
+    detail: `Checking balances on ${chains6.join(", ")}`
+  });
+  const protocol = await import_wdk_protocol2.T402Protocol.create(wdk, { chains: chains6 });
+  steps.push({
+    action: "fetch",
+    status: "success",
+    detail: `Fetching ${input.url}`
+  });
+  const { response, receipt } = await protocol.fetch(input.url);
+  if (receipt) {
+    steps.push({
+      action: "pay",
+      status: "success",
+      detail: `Payment made: ${receipt.amount} on ${receipt.network}`
+    });
+  }
+  const contentType = response.headers.get("content-type") ?? void 0;
+  let body = "";
+  try {
+    body = await response.text();
+    if (body.length > 1e4) {
+      body = body.slice(0, 1e4) + "\n... (truncated)";
+    }
+  } catch {
+    body = "[Could not read response body]";
+  }
+  return {
+    success: response.ok,
+    statusCode: response.status,
+    body,
+    contentType,
+    steps,
+    payment: receipt ? {
+      network: receipt.network,
+      scheme: receipt.scheme,
+      amount: receipt.amount,
+      payTo: receipt.payTo
+    } : void 0
+  };
+}
+function executeSmartPayDemo(input) {
+  const network = input.preferredNetwork ?? "arbitrum";
+  return {
+    success: true,
+    statusCode: 200,
+    body: `[Demo] Premium content from ${input.url}
+
+This is simulated content returned after smart payment.`,
+    contentType: "text/plain",
+    steps: [
+      { action: "check_balance", status: "success", detail: `Checked balances on ${network}` },
+      { action: "check_price", status: "success", detail: "Resource costs 1.00 USDT0" },
+      { action: "pay", status: "success", detail: `Paid 1000000 USDT0 on eip155:42161` },
+      { action: "fetch", status: "success", detail: `Fetched ${input.url}` }
+    ],
+    payment: {
+      network: "eip155:42161",
+      scheme: "exact",
+      amount: "1000000",
+      payTo: "0xC88f67e776f16DcFBf42e6bDda1B82604448899B"
+    }
+  };
+}
+async function executePaymentPlan(input, wdk) {
+  const targetNetwork = input.paymentRequired.network;
+  const requiredAmount = input.paymentRequired.maxAmountRequired;
+  const aggregated = await wdk.getAggregatedBalances();
+  const balances = aggregated.chains.map((chain) => {
+    const usdt0 = chain.tokens.find((t) => t.symbol === "USDT0");
+    const usdc = chain.tokens.find((t) => t.symbol === "USDC");
+    return {
+      chain: chain.chain,
+      usdt0: usdt0?.formatted ?? "0",
+      usdc: usdc?.formatted ?? "0"
+    };
+  });
+  const requiredBigint = requiredAmount ? BigInt(requiredAmount) : 0n;
+  const bestChain = await wdk.findBestChainForPayment(requiredBigint);
+  if (bestChain) {
+    const needsBridge = targetNetwork ? !bestChain.chain.includes(targetNetwork) : false;
+    return {
+      viable: true,
+      recommendedNetwork: bestChain.chain,
+      availableBalance: bestChain.balance.toString(),
+      bridgeRequired: needsBridge,
+      bridgeDetails: needsBridge ? {
+        fromChain: bestChain.chain,
+        toChain: targetNetwork ?? bestChain.chain,
+        amount: requiredAmount ?? "0",
+        estimatedFee: "0.001"
+      } : void 0,
+      balances
+    };
+  }
+  return {
+    viable: false,
+    bridgeRequired: false,
+    balances,
+    reason: "Insufficient balance across all chains"
+  };
+}
+function executePaymentPlanDemo(_input) {
+  return {
+    viable: true,
+    recommendedNetwork: "arbitrum",
+    availableBalance: "500000000",
+    bridgeRequired: false,
+    balances: [
+      { chain: "ethereum", usdt0: "100.00", usdc: "250.00" },
+      { chain: "arbitrum", usdt0: "500.00", usdc: "0" },
+      { chain: "base", usdt0: "50.00", usdc: "100.00" }
+    ]
+  };
+}
+function formatSmartPayResult(result) {
+  const lines = ["## SmartPay Result", ""];
+  if (result.success) {
+    lines.push(`**Status:** Success (${result.statusCode})`);
+  } else {
+    lines.push(`**Status:** Failed (${result.statusCode})`);
+  }
+  if (result.steps.length > 0) {
+    lines.push("");
+    lines.push("### Steps");
+    for (const step of result.steps) {
+      const icon = step.status === "success" ? "[OK]" : step.status === "skipped" ? "[SKIP]" : "[FAIL]";
+      lines.push(`- ${icon} **${step.action}**: ${step.detail}`);
+    }
+  }
+  if (result.payment) {
+    lines.push("");
+    lines.push("### Payment Details");
+    lines.push(`- **Network:** ${result.payment.network}`);
+    lines.push(`- **Scheme:** ${result.payment.scheme}`);
+    lines.push(`- **Amount:** ${result.payment.amount}`);
+    lines.push(`- **Pay To:** \`${result.payment.payTo}\``);
+  }
+  if (result.error) {
+    lines.push("");
+    lines.push(`**Error:** ${result.error}`);
+  }
+  if (result.body) {
+    lines.push("");
+    lines.push("### Response Content");
+    if (result.contentType) {
+      lines.push(`_Content-Type: ${result.contentType}_`);
+    }
+    lines.push("");
+    lines.push("```");
+    lines.push(result.body);
+    lines.push("```");
+  }
+  return lines.join("\n");
+}
+function formatPaymentPlanResult(result) {
+  const lines = ["## Payment Plan", ""];
+  if (result.viable) {
+    lines.push(`**Viable:** Yes`);
+    if (result.recommendedNetwork) {
+      lines.push(`**Recommended Network:** ${result.recommendedNetwork}`);
+    }
+    if (result.availableBalance) {
+      lines.push(`**Available Balance:** ${result.availableBalance}`);
+    }
+  } else {
+    lines.push(`**Viable:** No`);
+    if (result.reason) {
+      lines.push(`**Reason:** ${result.reason}`);
+    }
+  }
+  if (result.bridgeRequired && result.bridgeDetails) {
+    lines.push("");
+    lines.push("### Bridge Required");
+    lines.push(`- **From:** ${result.bridgeDetails.fromChain}`);
+    lines.push(`- **To:** ${result.bridgeDetails.toChain}`);
+    lines.push(`- **Amount:** ${result.bridgeDetails.amount}`);
+    lines.push(`- **Estimated Fee:** ${result.bridgeDetails.estimatedFee}`);
+  }
+  if (result.balances.length > 0) {
+    lines.push("");
+    lines.push("### Chain Balances");
+    lines.push("| Chain | USDT0 | USDC |");
+    lines.push("|-------|-------|------|");
+    for (const b of result.balances) {
+      lines.push(`| ${b.chain} | ${b.usdt0} | ${b.usdc} |`);
+    }
+  }
+  return lines.join("\n");
+}
+
 // src/tools/index.ts
 var TOOL_DEFINITIONS = {
   "t402/getBalance": {
@@ -1772,10 +2274,13 @@ var WDK_TOOL_DEFINITIONS = {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   GASLESS_SUPPORTED_NETWORKS,
+  TON_BRIDGE_TOOLS,
   TOOL_DEFINITIONS,
+  UNIFIED_TOOL_DEFINITIONS,
   WDK_TOOL_DEFINITIONS,
   autoPayInputSchema,
   bridgeInputSchema,
+  createTonBridgeToolSet,
   executeAutoPay,
   executeAutoPayDemo,
   executeBridge,
@@ -1784,6 +2289,11 @@ var WDK_TOOL_DEFINITIONS = {
   executeGetBridgeFee,
   executePay,
   executePayGasless,
+  executePaymentPlan,
+  executePaymentPlanDemo,
+  executeSmartPay,
+  executeSmartPayDemo,
+  executeTonBridgeTool,
   executeWdkGetBalances,
   executeWdkGetBalancesDemo,
   executeWdkGetWallet,
@@ -1798,7 +2308,9 @@ var WDK_TOOL_DEFINITIONS = {
   formatBridgeFeeResult,
   formatBridgeResult,
   formatGaslessPaymentResult,
+  formatPaymentPlanResult,
   formatPaymentResult,
+  formatSmartPayResult,
   formatWdkBalancesResult,
   formatWdkSwapResult,
   formatWdkTransferResult,
@@ -1808,6 +2320,8 @@ var WDK_TOOL_DEFINITIONS = {
   getBridgeFeeInputSchema,
   payGaslessInputSchema,
   payInputSchema,
+  paymentPlanInputSchema,
+  smartPayInputSchema,
   wdkGetBalancesInputSchema,
   wdkGetWalletInputSchema,
   wdkSwapInputSchema,