web3-tools-mcp 2.0.1 → 3.0.0

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":"AAYA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmLvB,wBAgSC"}

package/dist/tools/read/gas.js

@@ -0,0 +1,368 @@
+import { decodeFunctionResult, encodeFunctionData, formatEther, 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 } from '../../utils.js';
+/** Alchemy's bundle method takes at most this many transactions. */
+const ALCHEMY_BUNDLE_LIMIT = 3;
+/** One tool call is one quota unit, so an unbounded bundle would be a way around the quota. */
+const MAX_BUNDLE = 25;
+/** 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()]));
+/**
+ * Why an RPC call failed, without the request URL — viem puts it in `message`, and with a
+ * provider key configured that URL carries the key.
+ */
+function rpcReason(error) {
+    const { details, shortMessage } = error;
+    return details || shortMessage || 'The RPC request failed';
+}
+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 blockTag = args.blockNumber ? BigInt(args.blockNumber) : undefined;
+            // Simulate the call
+            const result = await client.call({
+                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: blockTag
+            });
+            // Also estimate gas
+            const gasEstimate = await client.estimateGas({
+                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: blockTag
+            });
+            // 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) {
+            // Check if it's a revert error
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return formatResponse({
+                success: false,
+                chain: args.chain,
+                contractAddress: args.contractAddress,
+                error: errorMessage,
+                reverted: errorMessage.includes('revert') || errorMessage.includes('execution reverted')
+            });
+        }
+    }),
+    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_BUNDLE)
+            .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) => {
+            if (args.formatted) {
+                // Convert to Gwei (1 Gwei = 1e9 wei)
+                const gwei = Number(wei) / 1e9;
+                return `${gwei.toFixed(2)} Gwei`;
+            }
+            return wei.toString();
+        };
+        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
+                ? `${(Number(estimatedCost) / 1e18).toFixed(6)} ETH`
+                : estimatedCost.toString();
+        }
+        return formatResponse(response);
+    })
+};
+//# sourceMappingURL=gas.js.map

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

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

package/dist/tools/{logs.d.ts → read/logs.d.ts}

@@ -4,21 +4,21 @@ declare const _default: {
         title: string;
         description: string;
         schema: z.ZodObject<{
-            chain: z.ZodEnum<["arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            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")[]]>;
             eventAbi: z.ZodString;
             address: z.ZodOptional<z.ZodString>;
             fromBlock: z.ZodOptional<z.ZodString>;
             toBlock: z.ZodOptional<z.ZodString>;
             eventArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">]>>>;
         }, "strip", z.ZodTypeAny, {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             eventAbi: string;
             address?: string | undefined;
             fromBlock?: string | undefined;
             toBlock?: string | undefined;
             eventArgs?: Record<string, string | number | boolean | (string | number | boolean)[]> | undefined;
         }, {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             eventAbi: string;
             address?: string | undefined;
             fromBlock?: string | undefined;
@@ -26,13 +26,14 @@ declare const _default: {
             eventArgs?: Record<string, string | number | boolean | (string | number | boolean)[]> | undefined;
         }>;
         handler: (args: {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             eventAbi: string;
             address?: string | undefined;
             fromBlock?: string | undefined;
             toBlock?: string | undefined;
             eventArgs?: Record<string, string | number | boolean | (string | number | boolean)[]> | undefined;
-        }) => Promise<import("../types.js").ToolResult>;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
     };
 };
 export default _default;

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

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

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

@@ -1,8 +1,8 @@
 import { HypersyncClient, LogField } from '@envio-dev/hypersync-client';
 import { decodeEventLog, isAddress, keccak256, numberToHex, padHex, parseAbiItem, toBytes, toEventSignature } from 'viem';
 import { z } from 'zod';
-import { getClientManager, SUPPORTED_CHAINS } from '../client.js';
-import { convertEventArgsToTypes, createTool, formatResponse } from '../utils.js';
+import { getClientManager, SUPPORTED_CHAINS } from '../../client.js';
+import { convertEventArgsToTypes, createTool, formatResponse } from '../../utils.js';
 /**
  * A topic is always 32 bytes, so an address, a number or a short hex value has to be
  * left-padded to fit. Passing one through unpadded is rejected outright by Hypersync.