@gala-chain/launchpad-mcp-server 5.0.3 → 5.0.4-beta.0

package/dist/tools/bridge/index.js

@@ -5,67 +5,32 @@
  * Cross-chain bridging tools for GalaChain ↔ Ethereum and GalaChain ↔ Solana.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bridgeTools = exports.getWrapStatusTool = exports.estimateUnwrapFeeTool = exports.estimateWrapFeeTool = exports.unwrapTokenTool = exports.wrapTokenTool = exports.isTokenWrappableTool = exports.getWrapCounterpartTool = exports.getWrappableTokenTool = exports.fetchAllWrappableTokensTool = exports.fetchWrappableTokensTool = exports.getEthereumTransactionStatusTool = exports.getSolanaTransactionStatusTool = exports.requestSolanaDevnetAirdropTool = exports.isTokenBridgeableToSolanaTool = exports.isTokenBridgeableToEthereumTool = exports.isTokenBridgeableToNetworkTool = exports.fetchAllTokensBridgeableToSolanaTool = exports.fetchAllTokensBridgeableToEthereumTool = exports.fetchAllBridgeableTokensByNetworkTool = exports.fetchBridgeableTokensByNetworkTool = exports.fetchSolanaWalletAllBalancesTool = exports.fetchEthereumWalletAllBalancesTool = exports.fetchSolanaWalletNativeBalanceTool = exports.fetchSolanaWalletTokenBalanceTool = exports.fetchEthereumWalletNativeBalanceTool = exports.fetchEthereumWalletTokenBalanceTool = exports.getSupportedBridgeTokensTool = exports.getBridgeStatusTool = exports.bridgeInTool = exports.bridgeOutTool = exports.estimateBridgeFeeTool = void 0;
-const response_formatter_js_1 = require("../../utils/response-formatter.js");
-const error_handler_js_1 = require("../../utils/error-handler.js");
+exports.bridgeTools = exports.getWrapStatusTool = exports.estimateUnwrapFeeTool = exports.estimateWrapFeeTool = exports.unwrapTokenTool = exports.wrapTokenTool = exports.isTokenWrappableTool = exports.getWrapCounterpartTool = exports.getWrappableTokenTool = exports.fetchAllWrappableTokensTool = exports.fetchWrappableTokensTool = exports.getEthereumTransactionStatusTool = exports.getSolanaTransactionStatusTool = exports.requestSolanaDevnetAirdropTool = exports.isTokenBridgeableToSolanaTool = exports.isTokenBridgeableToEthereumTool = exports.isTokenBridgeableToNetworkTool = exports.fetchAllTokensBridgeableToSolanaTool = exports.fetchAllTokensBridgeableToEthereumTool = exports.fetchAllBridgeableTokensByNetworkTool = exports.fetchBridgeableTokensByNetworkTool = exports.getSupportedBridgeTokensTool = exports.getBridgeStatusTool = exports.bridgeInTool = exports.bridgeOutTool = exports.estimateBridgeFeeTool = exports.fetchSolanaWalletAllBalancesTool = exports.fetchSolanaWalletNativeBalanceTool = exports.fetchSolanaWalletTokenBalanceTool = exports.fetchEthereumWalletAllBalancesTool = exports.fetchEthereumWalletNativeBalanceTool = exports.fetchEthereumWalletTokenBalanceTool = void 0;
 const common_schemas_js_1 = require("../../schemas/common-schemas.js");
-/**
- * Token ID schema for bridge operations
- *
- * Accepts either:
- * - Pipe-delimited string: "GALA|Unit|none|none"
- * - TokenClassKey object: { collection: "GALA", category: "Unit", type: "none", additionalKey: "none" }
- */
+const handler_factories_js_1 = require("../handler-factories.js");
+// Import external chain balance tools from factory
+const external_chain_balance_tools_js_1 = require("./helpers/external-chain-balance-tools.js");
+Object.defineProperty(exports, "fetchEthereumWalletTokenBalanceTool", { enumerable: true, get: function () { return external_chain_balance_tools_js_1.fetchEthereumWalletTokenBalanceTool; } });
+Object.defineProperty(exports, "fetchEthereumWalletNativeBalanceTool", { enumerable: true, get: function () { return external_chain_balance_tools_js_1.fetchEthereumWalletNativeBalanceTool; } });
+Object.defineProperty(exports, "fetchEthereumWalletAllBalancesTool", { enumerable: true, get: function () { return external_chain_balance_tools_js_1.fetchEthereumWalletAllBalancesTool; } });
+Object.defineProperty(exports, "fetchSolanaWalletTokenBalanceTool", { enumerable: true, get: function () { return external_chain_balance_tools_js_1.fetchSolanaWalletTokenBalanceTool; } });
+Object.defineProperty(exports, "fetchSolanaWalletNativeBalanceTool", { enumerable: true, get: function () { return external_chain_balance_tools_js_1.fetchSolanaWalletNativeBalanceTool; } });
+Object.defineProperty(exports, "fetchSolanaWalletAllBalancesTool", { enumerable: true, get: function () { return external_chain_balance_tools_js_1.fetchSolanaWalletAllBalancesTool; } });
+// Alias for backward compatibility within this file
 const TOKEN_ID_SCHEMA = {
+    ...common_schemas_js_1.FLEXIBLE_TOKEN_ID_SCHEMA,
     description: 'Token identifier in flexible format (string or object)',
-    oneOf: [
-        {
-            type: 'string',
-            description: 'Pipe-delimited format: "collection|category|type|additionalKey" (e.g., "GUSDC|Unit|none|eth:0x...")',
-        },
-        {
-            type: 'object',
-            description: 'TokenClassKey object format',
-            properties: {
-                collection: {
-                    type: 'string',
-                    description: 'Token collection (e.g., "Token")',
-                },
-                category: {
-                    type: 'string',
-                    description: 'Token category (e.g., "Unit")',
-                },
-                type: {
-                    type: 'string',
-                    description: 'Token type (e.g., "GUSDC")',
-                },
-                additionalKey: {
-                    type: 'string',
-                    description: 'Additional key (e.g., "eth:0x...")',
-                },
-            },
-            required: ['collection', 'category', 'type', 'additionalKey'],
-        },
-    ],
-};
-/**
- * External network schema
- */
-const EXTERNAL_NETWORK_SCHEMA = {
-    type: 'string',
-    enum: ['Ethereum', 'Solana'],
-    description: 'Target external blockchain network',
 };
 // 1. Estimate Bridge Fee
 exports.estimateBridgeFeeTool = {
     name: 'gala_launchpad_estimate_bridge_fee',
-    description: 'Estimate bridge fees for transferring tokens between GalaChain and an external chain (Ethereum or Solana)',
+    description: 'Estimate bridge fees for transferring tokens between GalaChain and an external chain. Returns fee amount in source token. Amount parameter is optional but recommended for accurate estimates.',
     inputSchema: {
         type: 'object',
         properties: {
             tokenId: TOKEN_ID_SCHEMA,
             destinationChain: {
-                ...EXTERNAL_NETWORK_SCHEMA,
+                ...common_schemas_js_1.EXTERNAL_NETWORK_SCHEMA,
                 description: 'Destination chain (Ethereum or Solana)',
             },
             amount: {
@@ -75,14 +40,11 @@ exports.estimateBridgeFeeTool = {
         },
         required: ['tokenId', 'destinationChain'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.estimateBridgeFee({
-            tokenId: args.tokenId,
-            destinationChain: args.destinationChain,
-            amount: args.amount,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('estimateBridgeFee', (args) => ({
+        tokenId: args.tokenId,
+        destinationChain: args.destinationChain,
+        amount: args.amount,
+    })),
 };
 // 2. Bridge Out (GalaChain → External)
 exports.bridgeOutTool = {
@@ -97,7 +59,7 @@ exports.bridgeOutTool = {
                 description: 'Amount to bridge',
             },
             destinationChain: {
-                ...EXTERNAL_NETWORK_SCHEMA,
+                ...common_schemas_js_1.EXTERNAL_NETWORK_SCHEMA,
                 description: 'Destination chain (Ethereum or Solana)',
             },
             recipientAddress: {
@@ -107,15 +69,12 @@ exports.bridgeOutTool = {
         },
         required: ['tokenId', 'amount', 'destinationChain', 'recipientAddress'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.bridgeOut({
-            tokenId: args.tokenId,
-            amount: args.amount,
-            destinationChain: args.destinationChain,
-            recipientAddress: args.recipientAddress,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('bridgeOut', (args) => ({
+        tokenId: args.tokenId,
+        amount: args.amount,
+        destinationChain: args.destinationChain,
+        recipientAddress: args.recipientAddress,
+    })),
 };
 // 3. Bridge In (External → GalaChain)
 exports.bridgeInTool = {
@@ -130,25 +89,22 @@ exports.bridgeInTool = {
                 description: 'Amount to bridge',
             },
             sourceChain: {
-                ...EXTERNAL_NETWORK_SCHEMA,
+                ...common_schemas_js_1.EXTERNAL_NETWORK_SCHEMA,
                 description: 'Source chain (Ethereum or Solana)',
             },
         },
         required: ['tokenId', 'amount', 'sourceChain'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.bridgeIn({
-            tokenId: args.tokenId,
-            amount: args.amount,
-            sourceChain: args.sourceChain,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('bridgeIn', (args) => ({
+        tokenId: args.tokenId,
+        amount: args.amount,
+        sourceChain: args.sourceChain,
+    })),
 };
 // 4. Get Bridge Status
 exports.getBridgeStatusTool = {
     name: 'gala_launchpad_get_bridge_status',
-    description: 'Get the status of a bridge transaction by transaction hash',
+    description: 'Get the status of a bridge transaction by transaction hash. Returns status (pending/confirmed/failed), block number, and error details if applicable.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -157,16 +113,16 @@ exports.getBridgeStatusTool = {
                 description: 'Transaction hash from bridgeOut or bridgeIn operation',
             },
             chainHint: {
-                ...EXTERNAL_NETWORK_SCHEMA,
+                ...common_schemas_js_1.EXTERNAL_NETWORK_SCHEMA,
                 description: 'Optional chain hint for faster lookup (Ethereum or Solana)',
             },
         },
         required: ['transactionHash'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.getBridgeStatus(args.transactionHash, args.chainHint);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('getBridgeStatus', (args) => [
+        args.transactionHash,
+        args.chainHint,
+    ]),
 };
 // 5. Get Supported Bridge Tokens
 exports.getSupportedBridgeTokensTool = {
@@ -176,151 +132,29 @@ exports.getSupportedBridgeTokensTool = {
         type: 'object',
         properties: {
             chain: {
-                ...EXTERNAL_NETWORK_SCHEMA,
+                ...common_schemas_js_1.EXTERNAL_NETWORK_SCHEMA,
                 description: 'Optional chain filter (Ethereum or Solana)',
             },
         },
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        // SDK's getSupportedBridgeTokens returns { tokens, totalCount, supportedChains }
-        const result = await sdk.getSupportedBridgeTokens();
+    handler: (0, handler_factories_js_1.createTransformingHandler)('getSupportedBridgeTokens', undefined, (result, args) => {
         // Filter by chain if specified
         if (args.chain) {
             const chain = args.chain;
             const filteredTokens = result.tokens.filter((t) => t.supportedChains.includes(chain));
-            return (0, response_formatter_js_1.formatSuccess)({
+            return {
                 tokens: filteredTokens,
                 totalCount: filteredTokens.length,
                 supportedChains: [chain],
-            });
+            };
         }
-        return (0, response_formatter_js_1.formatSuccess)(result);
+        return result;
     }),
 };
 // ============================================================================
-// SINGLE TOKEN BALANCE TOOLS (Fast - 1 RPC call each)
+// EXTERNAL CHAIN BALANCE TOOLS (6 tools - imported from factory)
+// See ./helpers/external-chain-balance-tools.ts for DRY implementation
 // ============================================================================
-// 6. Fetch Ethereum Wallet Token Balance (Single ERC-20)
-exports.fetchEthereumWalletTokenBalanceTool = {
-    name: 'gala_launchpad_fetch_ethereum_wallet_token_balance',
-    description: 'Get a single ERC-20 token balance on Ethereum (GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC). Fast: only 1 RPC call.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            symbol: {
-                ...common_schemas_js_1.TOKEN_SYMBOL_SCHEMA,
-                description: 'Token symbol (GALA, GWETH, GUSDC, GUSDT, GWTRX, or GWBTC)',
-            },
-            address: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Ethereum address (0x format). Defaults to configured wallet address.',
-            },
-        },
-        required: ['symbol'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchEthereumWalletTokenBalance(args.symbol, args.address);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
-};
-// 7. Fetch Ethereum Wallet Native Balance (ETH only)
-exports.fetchEthereumWalletNativeBalanceTool = {
-    name: 'gala_launchpad_fetch_ethereum_wallet_native_balance',
-    description: 'Get native ETH balance on Ethereum. Fast: only 1 RPC call.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            address: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Ethereum address (0x format). Defaults to configured wallet address.',
-            },
-        },
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchEthereumWalletNativeBalance(args.address);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
-};
-// 8. Fetch Solana Wallet Token Balance (Single SPL)
-exports.fetchSolanaWalletTokenBalanceTool = {
-    name: 'gala_launchpad_fetch_solana_wallet_token_balance',
-    description: 'Get a single SPL token balance on Solana (GALA or GSOL). Fast: only 1 RPC call.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            symbol: {
-                ...common_schemas_js_1.TOKEN_SYMBOL_SCHEMA,
-                description: 'Token symbol (GALA or GSOL)',
-            },
-            address: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Solana address (base58 format). Defaults to configured wallet address.',
-            },
-        },
-        required: ['symbol'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchSolanaWalletTokenBalance(args.symbol, args.address);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
-};
-// 9. Fetch Solana Wallet Native Balance (SOL only)
-exports.fetchSolanaWalletNativeBalanceTool = {
-    name: 'gala_launchpad_fetch_solana_wallet_native_balance',
-    description: 'Get native SOL balance on Solana. Fast: only 1 RPC call.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            address: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Solana address (base58 format). Defaults to configured wallet address.',
-            },
-        },
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchSolanaWalletNativeBalance(args.address);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
-};
-// ============================================================================
-// ALL TOKENS BALANCE TOOLS (Complete portfolio view - multiple RPC calls)
-// ============================================================================
-// 10. Fetch All Ethereum Wallet Balances
-exports.fetchEthereumWalletAllBalancesTool = {
-    name: 'gala_launchpad_fetch_ethereum_wallet_all_balances',
-    description: 'Get ALL supported token balances on Ethereum for a wallet (ETH + GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC). Returns native ETH and all supported ERC-20 token balances. Note: Makes 7 RPC calls.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            address: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Ethereum address (0x format). Defaults to configured wallet address.',
-            },
-        },
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchEthereumWalletAllBalances(args.address);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
-};
-// 11. Fetch All Solana Wallet Balances
-exports.fetchSolanaWalletAllBalancesTool = {
-    name: 'gala_launchpad_fetch_solana_wallet_all_balances',
-    description: 'Get ALL supported token balances on Solana for a wallet (SOL + GALA, GSOL). Returns native SOL and all supported SPL token balances. Note: Makes 3 RPC calls.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            address: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Solana address (base58 format). Defaults to configured wallet address.',
-            },
-        },
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchSolanaWalletAllBalances(args.address);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
-};
 // ============================================================================
 // BRIDGEABLE TOKEN DISCOVERY TOOLS (Dynamic contract address lookups)
 // ============================================================================
@@ -357,14 +191,10 @@ exports.fetchBridgeableTokensByNetworkTool = {
         },
         required: ['network'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchBridgeableTokensByNetwork({
-            network: args.network,
-            offset: args.offset,
-            limit: args.limit,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('fetchBridgeableTokensByNetwork', (args) => ({
+        network: args.network,
+        ...(0, handler_factories_js_1.extractOffsetPaginationArgs)(args),
+    })),
 };
 // 13. Fetch All Bridgeable Tokens By Network (auto-pagination)
 exports.fetchAllBridgeableTokensByNetworkTool = {
@@ -380,10 +210,7 @@ exports.fetchAllBridgeableTokensByNetworkTool = {
         },
         required: ['network'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchAllBridgeableTokensByNetwork(args.network);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('fetchAllBridgeableTokensByNetwork', (args) => args.network),
 };
 // 14. Fetch All Tokens Bridgeable To Ethereum
 exports.fetchAllTokensBridgeableToEthereumTool = {
@@ -393,10 +220,7 @@ exports.fetchAllTokensBridgeableToEthereumTool = {
         type: 'object',
         properties: {},
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk) => {
-        const result = await sdk.fetchAllTokensBridgeableToEthereum();
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('fetchAllTokensBridgeableToEthereum'),
 };
 // 15. Fetch All Tokens Bridgeable To Solana
 exports.fetchAllTokensBridgeableToSolanaTool = {
@@ -406,10 +230,7 @@ exports.fetchAllTokensBridgeableToSolanaTool = {
         type: 'object',
         properties: {},
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk) => {
-        const result = await sdk.fetchAllTokensBridgeableToSolana();
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('fetchAllTokensBridgeableToSolana'),
 };
 // 16. Is Token Bridgeable To Network
 exports.isTokenBridgeableToNetworkTool = {
@@ -426,15 +247,10 @@ exports.isTokenBridgeableToNetworkTool = {
         },
         required: ['tokenId', 'network'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const tokenId = args.tokenId;
-        const network = args.network;
-        const result = await sdk.isTokenBridgeableToNetwork({
-            tokenId,
-            network,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('isTokenBridgeableToNetwork', (args) => ({
+        tokenId: args.tokenId,
+        network: args.network,
+    })),
 };
 // 17. Is Token Bridgeable To Ethereum
 exports.isTokenBridgeableToEthereumTool = {
@@ -447,11 +263,7 @@ exports.isTokenBridgeableToEthereumTool = {
         },
         required: ['tokenId'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const tokenId = args.tokenId;
-        const result = await sdk.isTokenBridgeableToEthereum(tokenId);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('isTokenBridgeableToEthereum', (args) => args.tokenId),
 };
 // 18. Is Token Bridgeable To Solana
 exports.isTokenBridgeableToSolanaTool = {
@@ -464,11 +276,7 @@ exports.isTokenBridgeableToSolanaTool = {
         },
         required: ['tokenId'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const tokenId = args.tokenId;
-        const result = await sdk.isTokenBridgeableToSolana(tokenId);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('isTokenBridgeableToSolana', (args) => args.tokenId),
 };
 // 19. Request Solana Devnet Airdrop
 exports.requestSolanaDevnetAirdropTool = {
@@ -491,17 +299,12 @@ exports.requestSolanaDevnetAirdropTool = {
             },
         },
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const amount = args.amount;
-        const address = args.address;
-        const signature = await sdk.requestSolanaDevnetAirdrop(amount, address);
-        return (0, response_formatter_js_1.formatSuccess)({
-            signature,
-            amount: amount ?? 1,
-            recipient: address ?? 'configured wallet',
-            message: `Successfully airdropped ${amount ?? 1} SOL`,
-        });
-    }),
+    handler: (0, handler_factories_js_1.createTransformingHandler)('requestSolanaDevnetAirdrop', (args) => [args.amount, args.address], (signature, args) => ({
+        signature,
+        amount: args.amount ?? 1,
+        recipient: args.address ?? 'configured wallet',
+        message: `Successfully airdropped ${args.amount ?? 1} SOL`,
+    })),
 };
 // 20. Get Solana Transaction Status
 exports.getSolanaTransactionStatusTool = {
@@ -522,11 +325,7 @@ exports.getSolanaTransactionStatusTool = {
         },
         required: ['signature'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const signature = args.signature;
-        const result = await sdk.getSolanaTransactionStatus(signature);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('getSolanaTransactionStatus', (args) => args.signature),
 };
 // 21. Get Ethereum Transaction Status
 exports.getEthereumTransactionStatusTool = {
@@ -550,11 +349,7 @@ exports.getEthereumTransactionStatusTool = {
         },
         required: ['transactionHash'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const transactionHash = args.transactionHash;
-        const result = await sdk.getEthereumTransactionStatus(transactionHash);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('getEthereumTransactionStatus', (args) => args.transactionHash),
 };
 // ============================================================================
 // WRAPPABLE TOKEN TOOLS (GalaChain-internal wrap/unwrap operations)
@@ -580,13 +375,9 @@ exports.fetchWrappableTokensTool = {
             },
         },
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchWrappableTokens({
-            offset: args.offset,
-            limit: args.limit,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('fetchWrappableTokens', (args) => ({
+        ...(0, handler_factories_js_1.extractOffsetPaginationArgs)(args),
+    })),
 };
 // 23. Fetch All Wrappable Tokens (auto-pagination, metadata only)
 exports.fetchAllWrappableTokensTool = {
@@ -598,10 +389,7 @@ exports.fetchAllWrappableTokensTool = {
         type: 'object',
         properties: {},
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk) => {
-        const result = await sdk.fetchAllWrappableTokens();
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('fetchAllWrappableTokens'),
 };
 // 24. Get Wrappable Token by TokenId
 exports.getWrappableTokenTool = {
@@ -620,10 +408,7 @@ exports.getWrappableTokenTool = {
         },
         required: ['tokenId'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.getWrappableToken(args.tokenId);
-        return (0, response_formatter_js_1.formatSuccess)(result ?? { found: false, tokenId: args.tokenId });
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('getWrappableToken', (args) => args.tokenId),
 };
 // 25. Get Wrap Counterpart by TokenId
 exports.getWrapCounterpartTool = {
@@ -642,10 +427,7 @@ exports.getWrapCounterpartTool = {
         },
         required: ['tokenId'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.getWrapCounterpart(args.tokenId);
-        return (0, response_formatter_js_1.formatSuccess)(result ?? { found: false, tokenId: args.tokenId });
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('getWrapCounterpart', (args) => args.tokenId),
 };
 // 26. Is Token Wrappable
 exports.isTokenWrappableTool = {
@@ -664,10 +446,7 @@ exports.isTokenWrappableTool = {
         },
         required: ['tokenId'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.isTokenWrappable(args.tokenId);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('isTokenWrappable', (args) => args.tokenId),
 };
 // ============================================================================
 // WRAP/UNWRAP EXECUTION TOOLS (Cross-Channel Bridge Operations)
@@ -680,36 +459,10 @@ exports.wrapTokenTool = {
         'Requires wallet configuration. Use for tokens that need to be wrapped before DEX trading.',
     inputSchema: {
         type: 'object',
-        properties: {
-            tokenId: {
-                ...TOKEN_ID_SCHEMA,
-                description: 'Token to wrap (source token on native channel). ' +
-                    'Accepts symbol ("MUSIC"), pipe-delimited ("$MUSIC|Unit|none|none"), or TokenClassKey object.',
-            },
-            amount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Amount to wrap (decimal string, e.g., "100.5")',
-            },
-            recipient: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Optional recipient address (defaults to sender)',
-            },
-            memo: {
-                type: 'string',
-                description: 'Optional memo for the transaction',
-            },
-        },
+        properties: common_schemas_js_1.WRAP_UNWRAP_PROPERTIES,
         required: ['tokenId', 'amount'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.wrapToken({
-            tokenId: args.tokenId,
-            amount: args.amount,
-            recipient: args.recipient,
-            memo: args.memo,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createWrapUnwrapHandler)('wrapToken'),
 };
 // 32. Unwrap Token
 exports.unwrapTokenTool = {
@@ -719,36 +472,10 @@ exports.unwrapTokenTool = {
         'NOT an external bridge. Requires wallet configuration.',
     inputSchema: {
         type: 'object',
-        properties: {
-            tokenId: {
-                ...TOKEN_ID_SCHEMA,
-                description: 'Token to unwrap (wrapped token on asset channel). ' +
-                    'Accepts symbol ("GMUSIC"), pipe-delimited ("$GMUSIC|Unit|none|none"), or TokenClassKey object.',
-            },
-            amount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Amount to unwrap (decimal string, e.g., "50")',
-            },
-            recipient: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Optional recipient address (defaults to sender)',
-            },
-            memo: {
-                type: 'string',
-                description: 'Optional memo for the transaction',
-            },
-        },
+        properties: common_schemas_js_1.WRAP_UNWRAP_PROPERTIES,
         required: ['tokenId', 'amount'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.unwrapToken({
-            tokenId: args.tokenId,
-            amount: args.amount,
-            recipient: args.recipient,
-            memo: args.memo,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createWrapUnwrapHandler)('unwrapToken'),
 };
 // 33. Estimate Wrap Fee
 exports.estimateWrapFeeTool = {
@@ -769,10 +496,10 @@ exports.estimateWrapFeeTool = {
         },
         required: ['tokenId', 'amount'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.estimateWrapFee(args.tokenId, args.amount);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('estimateWrapFee', (args) => [
+        args.tokenId,
+        args.amount,
+    ]),
 };
 // 34. Estimate Unwrap Fee
 exports.estimateUnwrapFeeTool = {
@@ -793,10 +520,10 @@ exports.estimateUnwrapFeeTool = {
         },
         required: ['tokenId', 'amount'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.estimateUnwrapFee(args.tokenId, args.amount);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('estimateUnwrapFee', (args) => [
+        args.tokenId,
+        args.amount,
+    ]),
 };
 // 35. Get Wrap Status
 exports.getWrapStatusTool = {
@@ -813,13 +540,10 @@ exports.getWrapStatusTool = {
         },
         required: ['transactionId'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.getWrapStatus(args.transactionId);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('getWrapStatus', (args) => args.transactionId),
 };
 /**
- * All bridge tools (35 tools)
+ * All bridge tools (31 tools)
  */
 exports.bridgeTools = [
     exports.estimateBridgeFeeTool,
@@ -827,14 +551,8 @@ exports.bridgeTools = [
     exports.bridgeInTool,
     exports.getBridgeStatusTool,
     exports.getSupportedBridgeTokensTool,
-    // Single token (fast - 1 RPC call)
-    exports.fetchEthereumWalletTokenBalanceTool,
-    exports.fetchEthereumWalletNativeBalanceTool,
-    exports.fetchSolanaWalletTokenBalanceTool,
-    exports.fetchSolanaWalletNativeBalanceTool,
-    // All tokens (complete portfolio)
-    exports.fetchEthereumWalletAllBalancesTool,
-    exports.fetchSolanaWalletAllBalancesTool,
+    // External chain balance tools (6 tools - from factory)
+    ...external_chain_balance_tools_js_1.externalChainBalanceTools,
     // Bridgeable token discovery (dynamic contract lookups)
     exports.fetchBridgeableTokensByNetworkTool,
     exports.fetchAllBridgeableTokensByNetworkTool,