web3-tools-mcp 2.0.2 → 3.1.0

package/dist/tools/{ens.js → read/ens.js}

@@ -1,8 +1,8 @@
 import { isAddress, namehash } from 'viem';
 import { normalize } from 'viem/ens';
 import { z } from 'zod';
-import { getClientManager, SUPPORTED_CHAINS } from '../client.js';
-import { createTool, formatResponse } from '../utils.js';
+import { getClientManager } from '../../client.js';
+import { createTool, formatResponse, MAX_BATCH } from '../../utils.js';
 // Base ENS Contract Addresses
 const BASE_ENS_CONTRACTS = {
     registry: '0xb94704422c2a1e396835a571837aa5ae53285a95',
@@ -143,29 +143,28 @@ async function getTextRecordBase(name, key) {
         return null;
     }
 }
+/** Where a name service is deployed: ENS on mainnet, Linea Names on Linea, Basenames on Base. */
+const ENS_CHAINS = ['mainnet', 'linea', 'base'];
+const ensChain = z
+    .enum(ENS_CHAINS)
+    .default('mainnet')
+    .describe('Where the name lives: mainnet for .eth (ENS), linea for Linea Names, base for Basenames. Defaults to mainnet.');
 const EnsResolveSchema = z.object({
-    chain: z
-        .enum(SUPPORTED_CHAINS)
-        .default('mainnet')
-        .describe('Blockchain network (defaults to mainnet, as ENS is primarily on Ethereum)'),
-    name: z.string().describe("ENS name to resolve to an address (e.g., 'vitalik.eth', 'example.eth')"),
-    universalResolver: z.boolean().optional().describe('Use universal resolver for cross-chain resolution (defaults to true)')
+    chain: ensChain,
+    name: z.string().describe("ENS name to resolve to an address (e.g., 'vitalik.eth', 'example.eth')")
 });
 const EnsReverseResolveSchema = z.object({
-    chain: z.enum(SUPPORTED_CHAINS).default('mainnet').describe('Blockchain network (defaults to mainnet)'),
-    address: z.string().describe('Ethereum address to resolve to an ENS name'),
-    universalResolver: z.boolean().optional().describe('Use universal resolver for cross-chain resolution (defaults to true)')
+    chain: ensChain,
+    address: z.string().describe('Ethereum address to resolve to an ENS name')
 });
 const EnsTextRecordSchema = z.object({
-    chain: z.enum(SUPPORTED_CHAINS).default('mainnet').describe('Blockchain network (defaults to mainnet)'),
+    chain: ensChain,
     name: z.string().describe('ENS name to query text records from'),
-    key: z.string().describe("Text record key (e.g., 'avatar', 'description', 'email', 'url', 'com.twitter', 'com.github')"),
-    universalResolver: z.boolean().optional().describe('Use universal resolver for cross-chain resolution (defaults to true)')
+    key: z.string().describe("Text record key (e.g., 'avatar', 'description', 'email', 'url', 'com.twitter', 'com.github')")
 });
 const EnsBatchResolveSchema = z.object({
-    chain: z.enum(SUPPORTED_CHAINS).default('mainnet').describe('Blockchain network (defaults to mainnet)'),
-    names: z.array(z.string()).describe('Array of ENS names to resolve to addresses in a single batch'),
-    universalResolver: z.boolean().optional().describe('Use universal resolver for cross-chain resolution (defaults to true)')
+    chain: ensChain,
+    names: z.array(z.string()).max(MAX_BATCH).describe('Array of ENS names to resolve to addresses in a single batch')
 });
 export default {
     resolve_ens_name: createTool('Resolve ENS Name to Address', 'Resolve an ENS name to its Ethereum address. ENS names are human-readable identifiers (like vitalik.eth) that resolve to Ethereum addresses.', EnsResolveSchema, async (args) => {
@@ -181,8 +180,7 @@ export default {
             const clientManager = getClientManager();
             const client = clientManager.getClient(args.chain);
             address = await client.getEnsAddress({
-                name: normalizedName,
-                universalResolverAddress: args.universalResolver !== false ? undefined : undefined
+                name: normalizedName
             });
         }
         if (!address) {
@@ -217,8 +215,7 @@ export default {
             const clientManager = getClientManager();
             const client = clientManager.getClient(args.chain);
             ensName = await client.getEnsName({
-                address: args.address,
-                universalResolverAddress: args.universalResolver !== false ? undefined : undefined
+                address: args.address
             });
         }
         if (!ensName) {
@@ -251,8 +248,7 @@ export default {
             const client = clientManager.getClient(args.chain);
             textRecord = await client.getEnsText({
                 name: normalizedName,
-                key: args.key,
-                universalResolverAddress: args.universalResolver !== false ? undefined : undefined
+                key: args.key
             });
         }
         if (!textRecord) {
@@ -275,10 +271,9 @@ export default {
             chain: args.chain
         });
     }),
-    get_ens_avatar: createTool('Get ENS Avatar', 'Get the avatar URI for an ENS name. Returns the avatar URL if set.', z.object({
-        chain: z.enum(SUPPORTED_CHAINS).default('mainnet').describe('Blockchain network (defaults to mainnet)'),
-        name: z.string().describe('ENS name to get avatar from'),
-        universalResolver: z.boolean().optional().describe('Use universal resolver for cross-chain resolution (defaults to true)')
+    get_ens_avatar: createTool('Get ENS Avatar', 'Get the raw avatar text record for an ENS name: an https/ipfs URL, a data URI, or an NFT reference (eip155:1/erc721:0x…/1). It is not fetched or resolved to an image.', z.object({
+        chain: ensChain,
+        name: z.string().describe('ENS name to get avatar from')
     }), async (args) => {
         // Normalize the ENS name
         const normalizedName = normalize(args.name);
@@ -291,10 +286,8 @@ export default {
             // Use viem's built-in ENS resolution for other chains
             const clientManager = getClientManager();
             const client = clientManager.getClient(args.chain);
-            avatar = await client.getEnsAvatar({
-                name: normalizedName,
-                universalResolverAddress: args.universalResolver !== false ? undefined : undefined
-            });
+            // getEnsAvatar would fetch the record's URL (or the NFT's metadata) from this server.
+            avatar = await client.getEnsText({ name: normalizedName, key: 'avatar' });
         }
         if (!avatar) {
             return formatResponse({
@@ -328,8 +321,7 @@ export default {
                 const clientManager = getClientManager();
                 const client = clientManager.getClient(args.chain);
                 address = await client.getEnsAddress({
-                    name: normalizedName,
-                    universalResolverAddress: args.universalResolver !== false ? undefined : undefined
+                    name: normalizedName
                 });
             }
             return {

package/dist/tools/read/ens.js.map

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

package/dist/tools/read/gas.d.ts

@@ -0,0 +1,171 @@
+import { z } from 'zod';
+declare const _default: {
+    simulate_contract: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            contractAddress: z.ZodString;
+            functionAbi: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+            from: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodString>;
+            blockNumber: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            contractAddress: string;
+            functionAbi: string;
+            blockNumber?: string | undefined;
+            from?: string | undefined;
+            value?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+        }, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            contractAddress: string;
+            functionAbi: string;
+            blockNumber?: string | undefined;
+            from?: string | undefined;
+            value?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            contractAddress: string;
+            functionAbi: string;
+            blockNumber?: string | undefined;
+            from?: string | undefined;
+            value?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
+    };
+    simulate_bundle: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            from: z.ZodOptional<z.ZodString>;
+            calls: z.ZodArray<z.ZodObject<{
+                to: z.ZodString;
+                functionAbi: z.ZodOptional<z.ZodString>;
+                args: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+                data: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodString>;
+                from: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                to: string;
+                from?: string | undefined;
+                value?: string | undefined;
+                data?: string | undefined;
+                args?: (string | number | boolean | null)[] | undefined;
+                functionAbi?: string | undefined;
+            }, {
+                to: string;
+                from?: string | undefined;
+                value?: string | undefined;
+                data?: string | undefined;
+                args?: (string | number | boolean | null)[] | undefined;
+                functionAbi?: string | undefined;
+            }>, "many">;
+            blockNumber: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            calls: {
+                to: string;
+                from?: string | undefined;
+                value?: string | undefined;
+                data?: string | undefined;
+                args?: (string | number | boolean | null)[] | undefined;
+                functionAbi?: string | undefined;
+            }[];
+            blockNumber?: string | undefined;
+            from?: string | undefined;
+        }, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            calls: {
+                to: string;
+                from?: string | undefined;
+                value?: string | undefined;
+                data?: string | undefined;
+                args?: (string | number | boolean | null)[] | undefined;
+                functionAbi?: string | undefined;
+            }[];
+            blockNumber?: string | undefined;
+            from?: string | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            calls: {
+                to: string;
+                from?: string | undefined;
+                value?: string | undefined;
+                data?: string | undefined;
+                args?: (string | number | boolean | null)[] | undefined;
+                functionAbi?: string | undefined;
+            }[];
+            blockNumber?: string | undefined;
+            from?: string | undefined;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
+    };
+    estimate_gas: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            to: z.ZodOptional<z.ZodString>;
+            from: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodString>;
+            data: z.ZodOptional<z.ZodString>;
+            functionAbi: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            from?: string | undefined;
+            to?: string | undefined;
+            value?: string | undefined;
+            data?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+            functionAbi?: string | undefined;
+        }, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            from?: string | undefined;
+            to?: string | undefined;
+            value?: string | undefined;
+            data?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+            functionAbi?: string | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            from?: string | undefined;
+            to?: string | undefined;
+            value?: string | undefined;
+            data?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+            functionAbi?: string | undefined;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
+    };
+    get_gas_price: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            formatted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            formatted: boolean;
+        }, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            formatted?: boolean | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            formatted: boolean;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
+    };
+};
+export default _default;
+//# sourceMappingURL=gas.d.ts.map

package/dist/tools/read/gas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../../../src/tools/read/gas.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwKvB,wBAqQC"}

package/dist/tools/read/gas.js

@@ -0,0 +1,333 @@
+import { decodeFunctionResult, encodeFunctionData, formatEther, formatGwei, isAddress, parseAbiItem, toHex } from 'viem';
+import { simulateBlocks } from 'viem/actions';
+import { z } from 'zod';
+import { getClientManager, SUPPORTED_CHAINS } from '../../client.js';
+import { enrichTransfers } from '../../preview.js';
+import { convertArgumentsToTypes, createTool, formatResponse, MAX_BATCH, rpcReason } from '../../utils.js';
+/** Alchemy's bundle method takes at most this many transactions. */
+const ALCHEMY_BUNDLE_LIMIT = 3;
+/** Where eth_simulateV1's traced native transfers say they come from. */
+const NATIVE_TOKEN = '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee';
+const argsSchema = z.array(z.union([z.string(), z.number(), z.boolean(), z.null()]));
+function bundleCall(call, from, index) {
+    const sender = call.from ?? from;
+    if (!isAddress(call.to))
+        throw new Error(`Call ${index}: invalid to address ${call.to}`);
+    if (sender && !isAddress(sender))
+        throw new Error(`Call ${index}: invalid from address ${sender}`);
+    if (call.functionAbi && call.data)
+        throw new Error(`Call ${index}: give functionAbi and args, or data — not both`);
+    const abi = call.functionAbi ? parseAbiItem(call.functionAbi) : undefined;
+    const data = abi
+        ? encodeFunctionData({ abi: [abi], functionName: abi.name, args: convertArgumentsToTypes(call.args ?? [], abi.inputs) })
+        : call.data;
+    return { from: sender, to: call.to, data, value: call.value ? BigInt(call.value) : undefined, abi };
+}
+/** Native, ERC20, ERC721 and ERC1155 changes with token metadata — on Alchemy's paid plans only. */
+async function viaAlchemy(chain, calls, blockNumber) {
+    const client = getClientManager().getClient(chain);
+    const transactions = calls.map((call) => ({
+        from: call.from,
+        to: call.to,
+        data: call.data,
+        value: call.value !== undefined ? toHex(call.value) : undefined
+    }));
+    const params = blockNumber === undefined ? [transactions] : [transactions, toHex(blockNumber)];
+    const outcomes = (await client.request({ method: 'alchemy_simulateAssetChangesBundle', params }));
+    return outcomes.map((outcome) => ({
+        status: outcome.error ? 'failure' : 'success',
+        gasUsed: outcome.gasUsed ? BigInt(outcome.gasUsed).toString() : undefined,
+        error: outcome.error?.message,
+        assetChanges: outcome.changes.map((change) => ({
+            assetType: change.assetType,
+            token: change.contractAddress,
+            symbol: change.symbol,
+            tokenId: change.tokenId,
+            from: change.from,
+            to: change.to,
+            amount: change.amount,
+            rawAmount: change.rawAmount
+        }))
+    }));
+}
+function decodeResult(abi, data) {
+    if (!abi?.outputs.length)
+        return data;
+    try {
+        return decodeFunctionResult({ abi: [abi], functionName: abi.name, data });
+    }
+    catch {
+        return data;
+    }
+}
+/**
+ * Any RPC with eth_simulateV1: decoded return values, and native, ERC20 and ERC721 transfers.
+ *
+ * ponytail: ERC1155 moves tokens with TransferSingle / TransferBatch, which are not read
+ * here, so those changes are missing on this path. Parse them if 1155 bundles matter.
+ */
+async function viaSimulateV1(chain, calls, blockNumber) {
+    const client = getClientManager().getClient(chain);
+    const [block] = await simulateBlocks(client, {
+        blocks: [{ calls: calls.map((call) => ({ account: call.from, to: call.to, data: call.data, value: call.value })) }],
+        traceTransfers: true,
+        validation: false,
+        ...(blockNumber !== undefined && { blockNumber })
+    });
+    if (!block)
+        throw new Error('The RPC returned no simulated block');
+    const nativeSymbol = client.chain?.nativeCurrency.symbol;
+    return Promise.all(block.calls.map(async (call, index) => {
+        const error = call.error;
+        const transfers = await enrichTransfers(chain, (call.logs ?? []));
+        return {
+            status: call.status,
+            gasUsed: call.gasUsed.toString(),
+            error: call.status === 'success' ? undefined : (error?.shortMessage ?? error?.message ?? 'execution reverted'),
+            result: call.status === 'success' ? decodeResult(calls[index]?.abi, call.data) : undefined,
+            assetChanges: transfers.map((transfer) => {
+                if (transfer.tokenId !== undefined) {
+                    return {
+                        assetType: 'ERC721',
+                        token: transfer.token,
+                        symbol: transfer.symbol,
+                        tokenId: transfer.tokenId,
+                        from: transfer.from,
+                        to: transfer.to,
+                        amount: '1',
+                        rawAmount: '1'
+                    };
+                }
+                const native = transfer.token.toLowerCase() === NATIVE_TOKEN;
+                return {
+                    assetType: native ? 'NATIVE' : 'ERC20',
+                    token: native ? undefined : transfer.token,
+                    symbol: native ? nativeSymbol : transfer.symbol,
+                    from: transfer.from,
+                    to: transfer.to,
+                    amount: native ? formatEther(BigInt(transfer.amount)) : transfer.humanAmount,
+                    rawAmount: transfer.amount
+                };
+            })
+        };
+    }));
+}
+export default {
+    simulate_contract: createTool('Simulate Contract Call', 'Simulate a contract call (including state-changing functions) without broadcasting. Returns simulation result and estimated gas.', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('Blockchain network to simulate on'),
+        contractAddress: z.string().describe('Contract address to call'),
+        functionAbi: z
+            .string()
+            .describe('Function ABI signature (e.g., "function transfer(address to, uint256 amount)"). Can be any function type.'),
+        args: z
+            .array(z.union([z.string(), z.number(), z.boolean(), z.null()]))
+            .optional()
+            .describe('Function arguments in order matching the ABI signature'),
+        from: z.string().optional().describe('Sender address (defaults to zero address)'),
+        value: z.string().optional().describe('ETH value to send with the transaction (in wei as string)'),
+        blockNumber: z.string().optional().describe('Block number for simulation (defaults to latest)')
+    }), async (args) => {
+        if (!isAddress(args.contractAddress)) {
+            throw new Error(`Invalid contract address: ${args.contractAddress}`);
+        }
+        if (args.from && !isAddress(args.from)) {
+            throw new Error(`Invalid from address: ${args.from}`);
+        }
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        try {
+            const abiItem = parseAbiItem(args.functionAbi);
+            const convertedArgs = convertArgumentsToTypes(args.args || [], abiItem.inputs);
+            const tx = {
+                to: args.contractAddress,
+                data: encodeFunctionData({ abi: [abiItem], functionName: abiItem.name, args: convertedArgs }),
+                account: args.from ? args.from : undefined,
+                value: args.value ? BigInt(args.value) : undefined,
+                blockNumber: args.blockNumber ? BigInt(args.blockNumber) : undefined
+            };
+            const result = await client.call(tx);
+            const gasEstimate = await client.estimateGas(tx);
+            // Decode the result if the function has outputs
+            let decodedResult = result.data;
+            if (abiItem.outputs && abiItem.outputs.length > 0 && result.data) {
+                decodedResult = decodeFunctionResult({
+                    abi: [abiItem],
+                    functionName: abiItem.name,
+                    data: result.data
+                });
+            }
+            return formatResponse({
+                success: true,
+                chain: args.chain,
+                contractAddress: args.contractAddress,
+                functionName: abiItem.name,
+                result: decodedResult,
+                rawData: result.data,
+                gasEstimate: gasEstimate.toString(),
+                blockNumber: args.blockNumber || 'latest'
+            });
+        }
+        catch (error) {
+            return formatResponse({
+                success: false,
+                chain: args.chain,
+                contractAddress: args.contractAddress,
+                error: rpcReason(error),
+                reverted: String(error instanceof Error ? error.message : error).includes('revert')
+            });
+        }
+    }),
+    simulate_bundle: createTool('Simulate Transaction Bundle', 'Simulate several transactions in order, in one block, each seeing the state the previous ones left — e.g. ' +
+        'approve then swap, or deposit then borrow. Nothing is broadcast. Returns per transaction whether it ' +
+        'succeeded, gas used, the revert reason, and the assets that moved. Up to 3 transactions go through ' +
+        "Alchemy's asset-change simulation (native, ERC20, ERC721, ERC1155, with symbols) where the plan allows it; " +
+        'otherwise eth_simulateV1, which adds decoded return values but reports only native and ERC20 transfers.', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('Blockchain network to simulate on'),
+        from: z.string().optional().describe('Sender for every transaction that does not name its own'),
+        calls: z
+            .array(z.object({
+            to: z.string().describe('Contract or recipient address'),
+            functionAbi: z
+                .string()
+                .optional()
+                .describe('Function signature to encode the call, e.g. "function approve(address spender, uint256 amount)"'),
+            args: argsSchema.optional().describe('Arguments for functionAbi, in order'),
+            data: z.string().optional().describe('Raw calldata, instead of functionAbi and args'),
+            value: z.string().optional().describe('Native value to send, in wei'),
+            from: z.string().optional().describe('Sender of this transaction, if not the bundle-wide from')
+        }))
+            .min(1)
+            .max(MAX_BATCH)
+            .describe('Transactions to run, in order'),
+        blockNumber: z.string().optional().describe('Block to simulate on top of (defaults to latest)')
+    }), async (args) => {
+        const chain = args.chain;
+        const calls = args.calls.map((call, index) => bundleCall(call, args.from, index));
+        const blockNumber = args.blockNumber ? BigInt(args.blockNumber) : undefined;
+        let outcomes;
+        let via = 'alchemy_simulateAssetChangesBundle';
+        let fallbackReason;
+        if (calls.length <= ALCHEMY_BUNDLE_LIMIT) {
+            try {
+                outcomes = await viaAlchemy(chain, calls, blockNumber);
+            }
+            catch (error) {
+                // A free plan, a chain Alchemy does not simulate on, or a custom RPC that is not Alchemy.
+                fallbackReason = rpcReason(error);
+            }
+        }
+        else {
+            fallbackReason = `Alchemy simulates at most ${ALCHEMY_BUNDLE_LIMIT} transactions per bundle`;
+        }
+        if (!outcomes) {
+            via = 'eth_simulateV1';
+            try {
+                outcomes = await viaSimulateV1(chain, calls, blockNumber);
+            }
+            catch (error) {
+                return formatResponse({ success: false, chain, error: rpcReason(error), alchemyBundleError: fallbackReason });
+            }
+        }
+        return formatResponse({
+            success: outcomes.every((outcome) => outcome.status === 'success'),
+            chain,
+            via,
+            ...(fallbackReason && { fallbackReason }),
+            totalGasUsed: outcomes.reduce((sum, outcome) => sum + BigInt(outcome.gasUsed ?? 0), 0n),
+            calls: outcomes.map((outcome, index) => ({
+                index,
+                to: calls[index]?.to,
+                ...(calls[index]?.abi && { functionName: calls[index].abi.name }),
+                ...outcome
+            }))
+        });
+    }, 
+    // Offered only where a provider RPC backs it: public endpoints rarely serve eth_simulateV1.
+    () => Boolean(getClientManager().getConfig().alchemyApiKey)),
+    estimate_gas: createTool('Estimate Gas', 'Estimate gas required for a transaction. Supports contract calls, transfers, and deployments.', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('Blockchain network'),
+        to: z.string().optional().describe('Recipient address (omit for contract deployment)'),
+        from: z.string().optional().describe('Sender address (optional)'),
+        value: z.string().optional().describe('ETH value to send (in wei as string)'),
+        data: z.string().optional().describe('Transaction data (hex string for contract calls or deployment bytecode)'),
+        functionAbi: z.string().optional().describe('Optional: Function ABI signature to encode call data automatically'),
+        args: z
+            .array(z.union([z.string(), z.number(), z.boolean(), z.null()]))
+            .optional()
+            .describe('Optional: Function arguments (only used with functionAbi)')
+    }), async (args) => {
+        if (args.to && !isAddress(args.to)) {
+            throw new Error(`Invalid to address: ${args.to}`);
+        }
+        if (args.from && !isAddress(args.from)) {
+            throw new Error(`Invalid from address: ${args.from}`);
+        }
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        let callData = args.data;
+        // If functionAbi is provided, encode the call data
+        if (args.functionAbi) {
+            const abiItem = parseAbiItem(args.functionAbi);
+            const convertedArgs = convertArgumentsToTypes(args.args || [], abiItem.inputs);
+            callData = encodeFunctionData({
+                abi: [abiItem],
+                functionName: abiItem.name,
+                args: convertedArgs
+            });
+        }
+        const gasEstimate = await client.estimateGas({
+            to: args.to ? args.to : undefined,
+            account: args.from ? args.from : undefined,
+            value: args.value ? BigInt(args.value) : undefined,
+            data: callData
+        });
+        return formatResponse({
+            success: true,
+            chain: args.chain,
+            gasEstimate: gasEstimate.toString(),
+            to: args.to,
+            from: args.from,
+            value: args.value
+        });
+    }),
+    get_gas_price: createTool('Get Gas Price', 'Get current gas prices for a chain. Returns both legacy gasPrice and EIP-1559 fees (maxFeePerGas, maxPriorityFeePerGas).', z.object({
+        chain: z.enum(SUPPORTED_CHAINS).describe('Blockchain network'),
+        formatted: z.boolean().optional().default(true).describe('Return prices in Gwei (default: true). If false, returns wei.')
+    }), async (args) => {
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        // Get both legacy and EIP-1559 gas prices
+        const [gasPrice, feeData] = await Promise.all([
+            client.getGasPrice(),
+            client.estimateFeesPerGas().catch(() => null) // Some chains don't support EIP-1559
+        ]);
+        const formatPrice = (wei) => `${formatGwei(wei)} Gwei`;
+        const response = {
+            chain: args.chain,
+            timestamp: new Date().toISOString(),
+            legacy: {
+                gasPrice: args.formatted ? formatPrice(gasPrice) : gasPrice.toString(),
+                gasPriceWei: gasPrice.toString()
+            }
+        };
+        // Add EIP-1559 data if available
+        if (feeData) {
+            response.eip1559 = {
+                maxFeePerGas: args.formatted ? formatPrice(feeData.maxFeePerGas) : feeData.maxFeePerGas.toString(),
+                maxPriorityFeePerGas: args.formatted
+                    ? formatPrice(feeData.maxPriorityFeePerGas)
+                    : feeData.maxPriorityFeePerGas.toString(),
+                maxFeePerGasWei: feeData.maxFeePerGas.toString(),
+                maxPriorityFeePerGasWei: feeData.maxPriorityFeePerGas.toString()
+            };
+            // Calculate estimated total cost for a standard 21000 gas transaction
+            const standardGasLimit = 21000n;
+            const estimatedCost = feeData.maxFeePerGas * standardGasLimit;
+            response.eip1559.estimatedCostFor21kGas = args.formatted
+                ? `${formatEther(estimatedCost)} ${client.chain?.nativeCurrency.symbol ?? 'ETH'}`
+                : estimatedCost.toString();
+        }
+        return formatResponse(response);
+    })
+};
+//# sourceMappingURL=gas.js.map