@t402/mcp 1.0.0

package/dist/esm/tools/index.d.mts

@@ -0,0 +1,424 @@
+import { z } from 'zod';
+import { S as SupportedNetwork, C as ChainBalance, a as PaymentResult, G as GaslessPaymentResult, B as BridgeFeeQuote, b as BridgeResult } from '../types-BINGE6ja.mjs';
+import 'viem';
+
+/**
+ * t402/getBalance - Get token balance for a specific network
+ */
+
+/**
+ * Input schema for getBalance tool
+ */
+declare const getBalanceInputSchema: z.ZodObject<{
+    network: z.ZodEnum<["ethereum", "base", "arbitrum", "optimism", "polygon", "avalanche", "ink", "berachain", "unichain"]>;
+    address: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    address: string;
+    network: "ethereum" | "base" | "arbitrum" | "optimism" | "polygon" | "avalanche" | "ink" | "berachain" | "unichain";
+}, {
+    address: string;
+    network: "ethereum" | "base" | "arbitrum" | "optimism" | "polygon" | "avalanche" | "ink" | "berachain" | "unichain";
+}>;
+type GetBalanceInput = z.infer<typeof getBalanceInputSchema>;
+/**
+ * Execute getBalance tool
+ */
+declare function executeGetBalance(input: GetBalanceInput, rpcUrls?: Partial<Record<SupportedNetwork, string>>): Promise<ChainBalance>;
+/**
+ * Format balance result for display
+ */
+declare function formatBalanceResult(balance: ChainBalance): string;
+
+/**
+ * t402/getAllBalances - Get token balances across all supported networks
+ */
+
+/**
+ * Input schema for getAllBalances tool
+ */
+declare const getAllBalancesInputSchema: z.ZodObject<{
+    address: z.ZodString;
+    networks: z.ZodOptional<z.ZodArray<z.ZodEnum<["ethereum", "base", "arbitrum", "optimism", "polygon", "avalanche", "ink", "berachain", "unichain"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    address: string;
+    networks?: ("ethereum" | "base" | "arbitrum" | "optimism" | "polygon" | "avalanche" | "ink" | "berachain" | "unichain")[] | undefined;
+}, {
+    address: string;
+    networks?: ("ethereum" | "base" | "arbitrum" | "optimism" | "polygon" | "avalanche" | "ink" | "berachain" | "unichain")[] | undefined;
+}>;
+type GetAllBalancesInput = z.infer<typeof getAllBalancesInputSchema>;
+/**
+ * Result of getAllBalances
+ */
+interface AllBalancesResult {
+    address: string;
+    balances: ChainBalance[];
+    totalUsdcBalance: string;
+    totalUsdtBalance: string;
+    summary: string;
+}
+/**
+ * Execute getAllBalances tool
+ */
+declare function executeGetAllBalances(input: GetAllBalancesInput, rpcUrls?: Partial<Record<SupportedNetwork, string>>): Promise<AllBalancesResult>;
+/**
+ * Format all balances result for display
+ */
+declare function formatAllBalancesResult(result: AllBalancesResult): string;
+
+/**
+ * t402/pay - Execute a payment on a specific network
+ */
+
+/**
+ * Input schema for pay tool
+ */
+declare const payInputSchema: z.ZodObject<{
+    to: z.ZodString;
+    amount: z.ZodString;
+    token: z.ZodEnum<["USDC", "USDT", "USDT0"]>;
+    network: z.ZodEnum<["ethereum", "base", "arbitrum", "optimism", "polygon", "avalanche", "ink", "berachain", "unichain"]>;
+    memo: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    to: string;
+    amount: string;
+    network: "ethereum" | "base" | "arbitrum" | "optimism" | "polygon" | "avalanche" | "ink" | "berachain" | "unichain";
+    token: "USDC" | "USDT" | "USDT0";
+    memo?: string | undefined;
+}, {
+    to: string;
+    amount: string;
+    network: "ethereum" | "base" | "arbitrum" | "optimism" | "polygon" | "avalanche" | "ink" | "berachain" | "unichain";
+    token: "USDC" | "USDT" | "USDT0";
+    memo?: string | undefined;
+}>;
+type PayInput = z.infer<typeof payInputSchema>;
+/**
+ * Options for executing payment
+ */
+interface PayOptions {
+    /** Private key for signing (hex with 0x prefix) */
+    privateKey: string;
+    /** Custom RPC URL */
+    rpcUrl?: string;
+    /** Demo mode - simulate without executing */
+    demoMode?: boolean;
+}
+/**
+ * Execute pay tool
+ */
+declare function executePay(input: PayInput, options: PayOptions): Promise<PaymentResult>;
+/**
+ * Format payment result for display
+ */
+declare function formatPaymentResult(result: PaymentResult): string;
+
+/**
+ * t402/payGasless - Execute a gasless payment using ERC-4337
+ */
+
+/**
+ * Input schema for payGasless tool
+ */
+declare const payGaslessInputSchema: z.ZodObject<{
+    to: z.ZodString;
+    amount: z.ZodString;
+    token: z.ZodEnum<["USDC", "USDT", "USDT0"]>;
+    network: z.ZodEnum<["ethereum", "base", "arbitrum", "optimism", "polygon", "avalanche"]>;
+}, "strip", z.ZodTypeAny, {
+    to: string;
+    amount: string;
+    network: "ethereum" | "base" | "arbitrum" | "optimism" | "polygon" | "avalanche";
+    token: "USDC" | "USDT" | "USDT0";
+}, {
+    to: string;
+    amount: string;
+    network: "ethereum" | "base" | "arbitrum" | "optimism" | "polygon" | "avalanche";
+    token: "USDC" | "USDT" | "USDT0";
+}>;
+type PayGaslessInput = z.infer<typeof payGaslessInputSchema>;
+/**
+ * Networks that support ERC-4337 gasless transactions
+ */
+declare const GASLESS_SUPPORTED_NETWORKS: SupportedNetwork[];
+/**
+ * Options for executing gasless payment
+ */
+interface PayGaslessOptions {
+    /** Private key for signing (hex with 0x prefix) */
+    privateKey: string;
+    /** Bundler URL for ERC-4337 */
+    bundlerUrl: string;
+    /** Paymaster URL for sponsoring gas */
+    paymasterUrl: string;
+    /** Custom RPC URL */
+    rpcUrl?: string;
+    /** Demo mode - simulate without executing */
+    demoMode?: boolean;
+}
+/**
+ * Execute payGasless tool
+ */
+declare function executePayGasless(input: PayGaslessInput, options: PayGaslessOptions): Promise<GaslessPaymentResult>;
+/**
+ * Format gasless payment result for display
+ */
+declare function formatGaslessPaymentResult(result: GaslessPaymentResult): string;
+
+/**
+ * t402/getBridgeFee - Get fee quote for bridging USDT0 between chains
+ */
+
+/**
+ * Input schema for getBridgeFee tool
+ */
+declare const getBridgeFeeInputSchema: z.ZodObject<{
+    fromChain: z.ZodEnum<["ethereum", "arbitrum", "ink", "berachain", "unichain"]>;
+    toChain: z.ZodEnum<["ethereum", "arbitrum", "ink", "berachain", "unichain"]>;
+    amount: z.ZodString;
+    recipient: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    fromChain: "ethereum" | "arbitrum" | "ink" | "berachain" | "unichain";
+    toChain: "ethereum" | "arbitrum" | "ink" | "berachain" | "unichain";
+    recipient: string;
+}, {
+    amount: string;
+    fromChain: "ethereum" | "arbitrum" | "ink" | "berachain" | "unichain";
+    toChain: "ethereum" | "arbitrum" | "ink" | "berachain" | "unichain";
+    recipient: string;
+}>;
+type GetBridgeFeeInput = z.infer<typeof getBridgeFeeInputSchema>;
+/**
+ * Execute getBridgeFee tool
+ */
+declare function executeGetBridgeFee(input: GetBridgeFeeInput, rpcUrls?: Partial<Record<SupportedNetwork, string>>): Promise<BridgeFeeQuote>;
+/**
+ * Format bridge fee result for display
+ */
+declare function formatBridgeFeeResult(result: BridgeFeeQuote): string;
+
+/**
+ * t402/bridge - Bridge USDT0 between chains using LayerZero OFT
+ */
+
+/**
+ * Input schema for bridge tool
+ */
+declare const bridgeInputSchema: z.ZodObject<{
+    fromChain: z.ZodEnum<["ethereum", "arbitrum", "ink", "berachain", "unichain"]>;
+    toChain: z.ZodEnum<["ethereum", "arbitrum", "ink", "berachain", "unichain"]>;
+    amount: z.ZodString;
+    recipient: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    fromChain: "ethereum" | "arbitrum" | "ink" | "berachain" | "unichain";
+    toChain: "ethereum" | "arbitrum" | "ink" | "berachain" | "unichain";
+    recipient: string;
+}, {
+    amount: string;
+    fromChain: "ethereum" | "arbitrum" | "ink" | "berachain" | "unichain";
+    toChain: "ethereum" | "arbitrum" | "ink" | "berachain" | "unichain";
+    recipient: string;
+}>;
+type BridgeInput = z.infer<typeof bridgeInputSchema>;
+/**
+ * Options for executing bridge
+ */
+interface BridgeOptions {
+    /** Private key for signing (hex with 0x prefix) */
+    privateKey: string;
+    /** Custom RPC URL */
+    rpcUrl?: string;
+    /** Demo mode - simulate without executing */
+    demoMode?: boolean;
+    /** Slippage tolerance percentage (default: 0.5) */
+    slippageTolerance?: number;
+}
+/**
+ * Execute bridge tool
+ */
+declare function executeBridge(input: BridgeInput, options: BridgeOptions): Promise<BridgeResult>;
+/**
+ * Format bridge result for display
+ */
+declare function formatBridgeResult(result: BridgeResult): string;
+
+/**
+ * t402 MCP Tools - Export all payment tools
+ */
+
+/**
+ * Tool definitions for MCP server registration
+ */
+declare const TOOL_DEFINITIONS: {
+    "t402/getBalance": {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                network: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                address: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    "t402/getAllBalances": {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                address: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                networks: {
+                    type: string;
+                    items: {
+                        type: string;
+                        enum: string[];
+                    };
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    "t402/pay": {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                to: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                amount: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                token: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                network: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                memo: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    "t402/payGasless": {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                to: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                amount: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                token: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                network: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    "t402/getBridgeFee": {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                fromChain: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                toChain: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                amount: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                recipient: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    "t402/bridge": {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                fromChain: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                toChain: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                amount: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                recipient: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
+
+export { type AllBalancesResult, type BridgeInput, type BridgeOptions, GASLESS_SUPPORTED_NETWORKS, type GetAllBalancesInput, type GetBalanceInput, type GetBridgeFeeInput, type PayGaslessInput, type PayGaslessOptions, type PayInput, type PayOptions, TOOL_DEFINITIONS, bridgeInputSchema, executeBridge, executeGetAllBalances, executeGetBalance, executeGetBridgeFee, executePay, executePayGasless, formatAllBalancesResult, formatBalanceResult, formatBridgeFeeResult, formatBridgeResult, formatGaslessPaymentResult, formatPaymentResult, getAllBalancesInputSchema, getBalanceInputSchema, getBridgeFeeInputSchema, payGaslessInputSchema, payInputSchema };

package/dist/esm/tools/index.mjs

@@ -0,0 +1,45 @@
+import {
+  GASLESS_SUPPORTED_NETWORKS,
+  TOOL_DEFINITIONS,
+  bridgeInputSchema,
+  executeBridge,
+  executeGetAllBalances,
+  executeGetBalance,
+  executeGetBridgeFee,
+  executePay,
+  executePayGasless,
+  formatAllBalancesResult,
+  formatBalanceResult,
+  formatBridgeFeeResult,
+  formatBridgeResult,
+  formatGaslessPaymentResult,
+  formatPaymentResult,
+  getAllBalancesInputSchema,
+  getBalanceInputSchema,
+  getBridgeFeeInputSchema,
+  payGaslessInputSchema,
+  payInputSchema
+} from "../chunk-SB4O25HA.mjs";
+export {
+  GASLESS_SUPPORTED_NETWORKS,
+  TOOL_DEFINITIONS,
+  bridgeInputSchema,
+  executeBridge,
+  executeGetAllBalances,
+  executeGetBalance,
+  executeGetBridgeFee,
+  executePay,
+  executePayGasless,
+  formatAllBalancesResult,
+  formatBalanceResult,
+  formatBridgeFeeResult,
+  formatBridgeResult,
+  formatGaslessPaymentResult,
+  formatPaymentResult,
+  getAllBalancesInputSchema,
+  getBalanceInputSchema,
+  getBridgeFeeInputSchema,
+  payGaslessInputSchema,
+  payInputSchema
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/tools/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/types-BINGE6ja.d.mts

@@ -0,0 +1,147 @@
+import { Address } from 'viem';
+
+/**
+ * Type definitions for t402 MCP Server
+ */
+
+/**
+ * Supported blockchain networks
+ */
+type SupportedNetwork = "ethereum" | "base" | "arbitrum" | "optimism" | "polygon" | "avalanche" | "ink" | "berachain" | "unichain";
+/**
+ * Token balance information
+ */
+interface TokenBalance {
+    /** Token symbol (e.g., "USDC", "USDT") */
+    symbol: string;
+    /** Token contract address */
+    address: Address;
+    /** Balance in smallest unit (wei/satoshi equivalent) */
+    balance: string;
+    /** Human-readable balance with decimals */
+    formatted: string;
+    /** Token decimals */
+    decimals: number;
+}
+/**
+ * Chain balance information
+ */
+interface ChainBalance {
+    /** Network identifier */
+    network: SupportedNetwork;
+    /** Chain ID */
+    chainId: number;
+    /** Native token balance (ETH/MATIC/etc) */
+    native: {
+        symbol: string;
+        balance: string;
+        formatted: string;
+    };
+    /** Supported stablecoin balances */
+    tokens: TokenBalance[];
+}
+/**
+ * Payment parameters
+ */
+interface PaymentParams {
+    /** Recipient address */
+    to: Address;
+    /** Amount to pay (in token units) */
+    amount: string;
+    /** Token to use for payment */
+    token: "USDC" | "USDT" | "USDT0";
+    /** Network to execute payment on */
+    network: SupportedNetwork;
+    /** Optional: memo/reference for payment */
+    memo?: string;
+}
+/**
+ * Payment result
+ */
+interface PaymentResult {
+    /** Transaction hash */
+    txHash: string;
+    /** Network where payment was executed */
+    network: SupportedNetwork;
+    /** Amount paid (formatted) */
+    amount: string;
+    /** Token used */
+    token: string;
+    /** Recipient address */
+    to: Address;
+    /** Block explorer URL */
+    explorerUrl: string;
+}
+/**
+ * Gasless payment result (ERC-4337)
+ */
+interface GaslessPaymentResult extends PaymentResult {
+    /** User operation hash */
+    userOpHash: string;
+    /** Paymaster used */
+    paymaster?: string;
+}
+/**
+ * Bridge fee quote
+ */
+interface BridgeFeeQuote {
+    /** Source chain */
+    fromChain: SupportedNetwork;
+    /** Destination chain */
+    toChain: SupportedNetwork;
+    /** Amount to bridge (formatted) */
+    amount: string;
+    /** Native fee required (in source chain native token) */
+    nativeFee: string;
+    /** Native fee formatted with symbol */
+    nativeFeeFormatted: string;
+    /** Estimated time in seconds */
+    estimatedTime: number;
+}
+/**
+ * Bridge result
+ */
+interface BridgeResult {
+    /** Source chain transaction hash */
+    txHash: string;
+    /** LayerZero message GUID for tracking */
+    messageGuid: string;
+    /** Amount bridged (formatted) */
+    amount: string;
+    /** Source chain */
+    fromChain: SupportedNetwork;
+    /** Destination chain */
+    toChain: SupportedNetwork;
+    /** Estimated delivery time in seconds */
+    estimatedTime: number;
+    /** LayerZero Scan URL for tracking */
+    trackingUrl: string;
+}
+/**
+ * MCP Server configuration
+ */
+interface McpServerConfig {
+    /** Private key for signing transactions (hex string) */
+    privateKey?: string;
+    /** RPC URLs by network */
+    rpcUrls?: Partial<Record<SupportedNetwork, string>>;
+    /** Enable demo mode (simulates transactions without executing) */
+    demoMode?: boolean;
+    /** Paymaster URL for gasless transactions */
+    paymasterUrl?: string;
+    /** Bundler URL for ERC-4337 */
+    bundlerUrl?: string;
+}
+/**
+ * Tool execution context
+ */
+interface ToolContext {
+    /** Server configuration */
+    config: McpServerConfig;
+    /** Get wallet client for a network */
+    getWalletClient: (network: SupportedNetwork) => Promise<unknown>;
+    /** Get public client for a network */
+    getPublicClient: (network: SupportedNetwork) => Promise<unknown>;
+}
+
+export type { BridgeFeeQuote as B, ChainBalance as C, GaslessPaymentResult as G, McpServerConfig as M, PaymentParams as P, SupportedNetwork as S, TokenBalance as T, PaymentResult as a, BridgeResult as b, ToolContext as c };