viem 2.0.0-beta.12 → 2.0.0-beta.13

package/_esm/actions/public/call.js

@@ -0,0 +1,182 @@
+import { parseAccount, } from '../../accounts/utils/parseAccount.js';
+import { multicall3Abi } from '../../constants/abis.js';
+import { aggregate3Signature } from '../../constants/contract.js';
+import { BaseError } from '../../errors/base.js';
+import { ChainDoesNotSupportContract, ClientChainNotConfiguredError, } from '../../errors/chain.js';
+import { RawContractError, } from '../../errors/contract.js';
+import { decodeFunctionResult, } from '../../utils/abi/decodeFunctionResult.js';
+import { encodeFunctionData, } from '../../utils/abi/encodeFunctionData.js';
+import { getChainContractAddress, } from '../../utils/chain/getChainContractAddress.js';
+import { numberToHex, } from '../../utils/encoding/toHex.js';
+import { getCallError, } from '../../utils/errors/getCallError.js';
+import { extract } from '../../utils/formatters/extract.js';
+import { formatTransactionRequest, } from '../../utils/formatters/transactionRequest.js';
+import { createBatchScheduler, } from '../../utils/promise/createBatchScheduler.js';
+import { assertRequest } from '../../utils/transaction/assertRequest.js';
+/**
+ * Executes a new message call immediately without submitting a transaction to the network.
+ *
+ * - Docs: https://viem.sh/docs/actions/public/call.html
+ * - JSON-RPC Methods: [`eth_call`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_call)
+ *
+ * @param client - Client to use
+ * @param parameters - {@link CallParameters}
+ * @returns The call data. {@link CallReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { call } from 'viem/public'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const data = await call(client, {
+ *   account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+ *   data: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+ *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ * })
+ */
+export async function call(client, args) {
+    const { account: account_ = client.account, batch = Boolean(client.batch?.multicall), blockNumber, blockTag = 'latest', accessList, data, gas, gasPrice, maxFeePerGas, maxPriorityFeePerGas, nonce, to, value, ...rest } = args;
+    const account = account_ ? parseAccount(account_) : undefined;
+    try {
+        assertRequest(args);
+        const blockNumberHex = blockNumber ? numberToHex(blockNumber) : undefined;
+        const block = blockNumberHex || blockTag;
+        const chainFormat = client.chain?.formatters?.transactionRequest?.format;
+        const format = chainFormat || formatTransactionRequest;
+        const request = format({
+            // Pick out extra data that might exist on the chain's transaction request type.
+            ...extract(rest, { format: chainFormat }),
+            from: account?.address,
+            accessList,
+            data,
+            gas,
+            gasPrice,
+            maxFeePerGas,
+            maxPriorityFeePerGas,
+            nonce,
+            to,
+            value,
+        });
+        if (batch && shouldPerformMulticall({ request })) {
+            try {
+                return await scheduleMulticall(client, {
+                    ...request,
+                    blockNumber,
+                    blockTag,
+                });
+            }
+            catch (err) {
+                if (!(err instanceof ClientChainNotConfiguredError) &&
+                    !(err instanceof ChainDoesNotSupportContract))
+                    throw err;
+            }
+        }
+        const response = await client.request({
+            method: 'eth_call',
+            params: block
+                ? [request, block]
+                : [request],
+        });
+        if (response === '0x')
+            return { data: undefined };
+        return { data: response };
+    }
+    catch (err) {
+        const data = getRevertErrorData(err);
+        const { offchainLookup, offchainLookupSignature } = await import('../../utils/ccip.js');
+        if (data?.slice(0, 10) === offchainLookupSignature && to) {
+            return { data: await offchainLookup(client, { data, to }) };
+        }
+        throw getCallError(err, {
+            ...args,
+            account,
+            chain: client.chain,
+        });
+    }
+}
+// We only want to perform a scheduled multicall if:
+// - The request has calldata,
+// - The request has a target address,
+// - The target address is not already the aggregate3 signature,
+// - The request has no other properties (`nonce`, `gas`, etc cannot be sent with a multicall).
+function shouldPerformMulticall({ request }) {
+    const { data, to, ...request_ } = request;
+    if (!data)
+        return false;
+    if (data.startsWith(aggregate3Signature))
+        return false;
+    if (!to)
+        return false;
+    if (Object.values(request_).filter((x) => typeof x !== 'undefined').length > 0)
+        return false;
+    return true;
+}
+async function scheduleMulticall(client, args) {
+    const { batchSize = 1024, wait = 0 } = typeof client.batch?.multicall === 'object' ? client.batch.multicall : {};
+    const { blockNumber, blockTag = 'latest', data, multicallAddress: multicallAddress_, to, } = args;
+    let multicallAddress = multicallAddress_;
+    if (!multicallAddress) {
+        if (!client.chain)
+            throw new ClientChainNotConfiguredError();
+        multicallAddress = getChainContractAddress({
+            blockNumber,
+            chain: client.chain,
+            contract: 'multicall3',
+        });
+    }
+    const blockNumberHex = blockNumber ? numberToHex(blockNumber) : undefined;
+    const block = blockNumberHex || blockTag;
+    const { schedule } = createBatchScheduler({
+        id: `${client.uid}.${block}`,
+        wait,
+        shouldSplitBatch(args) {
+            const size = args.reduce((size, { data }) => size + (data.length - 2), 0);
+            return size > batchSize * 2;
+        },
+        fn: async (requests) => {
+            const calls = requests.map((request) => ({
+                allowFailure: true,
+                callData: request.data,
+                target: request.to,
+            }));
+            const calldata = encodeFunctionData({
+                abi: multicall3Abi,
+                args: [calls],
+                functionName: 'aggregate3',
+            });
+            const data = await client.request({
+                method: 'eth_call',
+                params: [
+                    {
+                        data: calldata,
+                        to: multicallAddress,
+                    },
+                    block,
+                ],
+            });
+            return decodeFunctionResult({
+                abi: multicall3Abi,
+                args: [calls],
+                functionName: 'aggregate3',
+                data: data || '0x',
+            });
+        },
+    });
+    const [{ returnData, success }] = await schedule({ data, to });
+    if (!success)
+        throw new RawContractError({ data: returnData });
+    if (returnData === '0x')
+        return { data: undefined };
+    return { data: returnData };
+}
+export function getRevertErrorData(err) {
+    if (!(err instanceof BaseError))
+        return undefined;
+    const error = err.walk();
+    return typeof error.data === 'object' ? error.data.data : error.data;
+}
+//# sourceMappingURL=call.js.map

package/_esm/actions/public/call.js.map

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

package/_esm/actions/public/createBlockFilter.js

@@ -0,0 +1,32 @@
+import { createFilterRequestScope } from '../../utils/filters/createFilterRequestScope.js';
+/**
+ * Creates a [`Filter`](https://viem.sh/docs/glossary/types.html#filter) to listen for new block hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html).
+ *
+ * - Docs: https://viem.sh/docs/actions/public/createBlockFilter.html
+ * - JSON-RPC Methods: [`eth_newBlockFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newBlockFilter)
+ *
+ * @param client - Client to use
+ * @returns [`Filter`](https://viem.sh/docs/glossary/types.html#filter). {@link CreateBlockFilterReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { createBlockFilter } from 'viem/public'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const filter = await createBlockFilter(client)
+ * // { id: "0x345a6572337856574a76364e457a4366", type: 'block' }
+ */
+export async function createBlockFilter(client) {
+    const getRequest = createFilterRequestScope(client, {
+        method: 'eth_newBlockFilter',
+    });
+    const id = await client.request({
+        method: 'eth_newBlockFilter',
+    });
+    return { id, request: getRequest(id), type: 'block' };
+}
+//# sourceMappingURL=createBlockFilter.js.map

package/_esm/actions/public/createBlockFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBlockFilter.js","sourceRoot":"","sources":["../../../actions/public/createBlockFilter.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AAM1F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAiC;IAEjC,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAA;IACF,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAA;IACF,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AACvD,CAAC"}

package/_esm/actions/public/createContractEventFilter.js

@@ -0,0 +1,59 @@
+import { encodeEventTopics, } from '../../utils/abi/encodeEventTopics.js';
+import { numberToHex, } from '../../utils/encoding/toHex.js';
+import { createFilterRequestScope } from '../../utils/filters/createFilterRequestScope.js';
+/**
+ * Creates a Filter to retrieve event logs that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html) or [`getFilterLogs`](https://viem.sh/docs/actions/public/getFilterLogs.html).
+ *
+ * - Docs: https://viem.sh/docs/contract/createContractEventFilter.html
+ *
+ * @param client - Client to use
+ * @param parameters - {@link CreateContractEventFilterParameters}
+ * @returns [`Filter`](https://viem.sh/docs/glossary/types.html#filter). {@link CreateContractEventFilterReturnType}
+ *
+ * @example
+ * import { createPublicClient, http, parseAbi } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { createContractEventFilter } from 'viem/contract'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const filter = await createContractEventFilter(client, {
+ *   abi: parseAbi(['event Transfer(address indexed, address indexed, uint256)']),
+ * })
+ */
+export async function createContractEventFilter(client, parameters) {
+    const { address, abi, args, eventName, fromBlock, strict, toBlock } = parameters;
+    const getRequest = createFilterRequestScope(client, {
+        method: 'eth_newFilter',
+    });
+    const topics = eventName
+        ? encodeEventTopics({
+            abi,
+            args,
+            eventName,
+        })
+        : undefined;
+    const id = await client.request({
+        method: 'eth_newFilter',
+        params: [
+            {
+                address,
+                fromBlock: typeof fromBlock === 'bigint' ? numberToHex(fromBlock) : fromBlock,
+                toBlock: typeof toBlock === 'bigint' ? numberToHex(toBlock) : toBlock,
+                topics,
+            },
+        ],
+    });
+    return {
+        abi,
+        args,
+        eventName,
+        id,
+        request: getRequest(id),
+        strict: Boolean(strict),
+        type: 'event',
+    };
+}
+//# sourceMappingURL=createContractEventFilter.js.map

package/_esm/actions/public/createContractEventFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContractEventFilter.js","sourceRoot":"","sources":["../../../actions/public/createContractEventFilter.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,iBAAiB,GAClB,MAAM,sCAAsC,CAAA;AAE7C,OAAO,EAEL,WAAW,GACZ,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AAmD1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAS7C,MAAgC,EAChC,UAOC;IAWD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GACjE,UAAiD,CAAA;IAEnD,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,eAAe;KACxB,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,SAAS;QACtB,CAAC,CAAC,iBAAiB,CAAC;YAChB,GAAG;YACH,IAAI;YACJ,SAAS;SACgC,CAAC;QAC9C,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,EAAE,GAAQ,MAAM,MAAM,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE;YACN;gBACE,OAAO;gBACP,SAAS,EACP,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;gBACpE,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;gBACrE,MAAM;aACP;SACF;KACF,CAAC,CAAA;IAEF,OAAO;QACL,GAAG;QACH,IAAI;QACJ,SAAS;QACT,EAAE;QACF,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACvB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,OAAO;KAQd,CAAA;AACH,CAAC"}

package/_esm/actions/public/createEventFilter.js

@@ -0,0 +1,67 @@
+import { encodeEventTopics, } from '../../utils/abi/encodeEventTopics.js';
+import { numberToHex, } from '../../utils/encoding/toHex.js';
+import { createFilterRequestScope } from '../../utils/filters/createFilterRequestScope.js';
+/**
+ * Creates a [`Filter`](https://viem.sh/docs/glossary/types.html#filter) to listen for new events that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html).
+ *
+ * - Docs: https://viem.sh/docs/actions/public/createEventFilter.html
+ * - JSON-RPC Methods: [`eth_newFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newfilter)
+ *
+ * @param client - Client to use
+ * @param parameters - {@link CreateEventFilterParameters}
+ * @returns [`Filter`](https://viem.sh/docs/glossary/types.html#filter). {@link CreateEventFilterReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { createEventFilter } from 'viem/public'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const filter = await createEventFilter(client, {
+ *   address: '0xfba3912ca04dd458c843e2ee08967fc04f3579c2',
+ * })
+ */
+export async function createEventFilter(client, { address, args, event, events: events_, fromBlock, strict, toBlock, } = {}) {
+    const events = events_ ?? (event ? [event] : undefined);
+    const getRequest = createFilterRequestScope(client, {
+        method: 'eth_newFilter',
+    });
+    let topics = [];
+    if (events) {
+        topics = [
+            events.flatMap((event) => encodeEventTopics({
+                abi: [event],
+                eventName: event.name,
+                args,
+            })),
+        ];
+        if (event)
+            topics = topics[0];
+    }
+    const id = await client.request({
+        method: 'eth_newFilter',
+        params: [
+            {
+                address,
+                fromBlock: typeof fromBlock === 'bigint' ? numberToHex(fromBlock) : fromBlock,
+                toBlock: typeof toBlock === 'bigint' ? numberToHex(toBlock) : toBlock,
+                ...(topics.length ? { topics } : {}),
+            },
+        ],
+    });
+    return {
+        abi: events,
+        args,
+        eventName: event ? event.name : undefined,
+        fromBlock,
+        id,
+        request: getRequest(id),
+        strict: Boolean(strict),
+        toBlock,
+        type: 'event',
+    };
+}
+//# sourceMappingURL=createEventFilter.js.map

package/_esm/actions/public/createEventFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEventFilter.js","sourceRoot":"","sources":["../../../actions/public/createEventFilter.ts"],"names":[],"mappings":"AAcA,OAAO,EAGL,iBAAiB,GAClB,MAAM,sCAAsC,CAAA;AAE7C,OAAO,EAEL,WAAW,GACZ,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AA4F1F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAerC,MAAiC,EACjC,EACE,OAAO,EACP,IAAI,EACJ,KAAK,EACL,MAAM,EAAE,OAAO,EACf,SAAS,EACT,MAAM,EACN,OAAO,MASL,EAAS;IAYb,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAEvD,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,eAAe;KACxB,CAAC,CAAA;IAEF,IAAI,MAAM,GAAe,EAAE,CAAA;IAC3B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG;YACN,MAAqB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACvC,iBAAiB,CAAC;gBAChB,GAAG,EAAE,CAAC,KAAK,CAAC;gBACZ,SAAS,EAAG,KAAkB,CAAC,IAAI;gBACnC,IAAI;aAC0B,CAAC,CAClC;SACF,CAAA;QACD,IAAI,KAAK;YAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAe,CAAA;IAC7C,CAAC;IAED,MAAM,EAAE,GAAQ,MAAM,MAAM,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE;YACN;gBACE,OAAO;gBACP,SAAS,EACP,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;gBACpE,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;gBACrE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrC;SACF;KACF,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,EAAE,MAAM;QACX,IAAI;QACJ,SAAS,EAAE,KAAK,CAAC,CAAC,CAAE,KAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACvD,SAAS;QACT,EAAE;QACF,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACvB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;QACvB,OAAO;QACP,IAAI,EAAE,OAAO;KASd,CAAA;AACH,CAAC"}

package/_esm/actions/public/createPendingTransactionFilter.js

@@ -0,0 +1,32 @@
+import { createFilterRequestScope } from '../../utils/filters/createFilterRequestScope.js';
+/**
+ * Creates a Filter to listen for new pending transaction hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html).
+ *
+ * - Docs: https://viem.sh/docs/actions/public/createPendingTransactionFilter.html
+ * - JSON-RPC Methods: [`eth_newPendingTransactionFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newpendingtransactionfilter)
+ *
+ * @param client - Client to use
+ * @returns [`Filter`](https://viem.sh/docs/glossary/types.html#filter). {@link CreateBlockFilterReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { createPendingTransactionFilter } from 'viem/public'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const filter = await createPendingTransactionFilter(client)
+ * // { id: "0x345a6572337856574a76364e457a4366", type: 'transaction' }
+ */
+export async function createPendingTransactionFilter(client) {
+    const getRequest = createFilterRequestScope(client, {
+        method: 'eth_newPendingTransactionFilter',
+    });
+    const id = await client.request({
+        method: 'eth_newPendingTransactionFilter',
+    });
+    return { id, request: getRequest(id), type: 'transaction' };
+}
+//# sourceMappingURL=createPendingTransactionFilter.js.map

package/_esm/actions/public/createPendingTransactionFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPendingTransactionFilter.js","sourceRoot":"","sources":["../../../actions/public/createPendingTransactionFilter.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AAQ1F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAIlD,MAAkC;IAElC,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,iCAAiC;KAC1C,CAAC,CAAA;IACF,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,iCAAiC;KAC1C,CAAC,CAAA;IACF,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;AAC7D,CAAC"}

package/_esm/actions/public/estimateContractGas.js

@@ -0,0 +1,60 @@
+import { parseAccount, } from '../../accounts/utils/parseAccount.js';
+import { encodeFunctionData, } from '../../utils/abi/encodeFunctionData.js';
+import { getContractError, } from '../../utils/errors/getContractError.js';
+import { getAction } from '../../utils/getAction.js';
+import { estimateGas, } from './estimateGas.js';
+/**
+ * Estimates the gas required to successfully execute a contract write function call.
+ *
+ * - Docs: https://viem.sh/docs/contract/estimateContractGas.html
+ *
+ * Internally, uses a [Public Client](https://viem.sh/docs/clients/public.html) to call the [`estimateGas` action](https://viem.sh/docs/actions/public/estimateGas.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
+ *
+ * @param client - Client to use
+ * @param parameters - {@link EstimateContractGasParameters}
+ * @returns The gas estimate (in wei). {@link EstimateContractGasReturnType}
+ *
+ * @example
+ * import { createPublicClient, http, parseAbi } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { estimateContractGas } from 'viem/contract'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const gas = await estimateContractGas(client, {
+ *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+ *   abi: parseAbi(['function mint() public']),
+ *   functionName: 'mint',
+ *   account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+ * })
+ */
+export async function estimateContractGas(client, parameters) {
+    const { abi, address, args, functionName, ...request } = parameters;
+    const data = encodeFunctionData({
+        abi,
+        args,
+        functionName,
+    });
+    try {
+        const gas = await getAction(client, estimateGas, 'estimateGas')({
+            data,
+            to: address,
+            ...request,
+        });
+        return gas;
+    }
+    catch (error) {
+        const account = request.account ? parseAccount(request.account) : undefined;
+        throw getContractError(error, {
+            abi,
+            address,
+            args,
+            docsPath: '/docs/contract/estimateContractGas',
+            functionName,
+            sender: account?.address,
+        });
+    }
+}
+//# sourceMappingURL=estimateContractGas.js.map

package/_esm/actions/public/estimateContractGas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimateContractGas.js","sourceRoot":"","sources":["../../../actions/public/estimateContractGas.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,YAAY,GACb,MAAM,sCAAsC,CAAA;AAY7C,OAAO,EAGL,kBAAkB,GACnB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAEL,gBAAgB,GACjB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAGL,WAAW,GACZ,MAAM,kBAAkB,CAAA;AAmCzB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAOvC,MAAyC,EACzC,UAAyE;IAEzE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,GACpD,UAA2C,CAAA;IAC7C,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC9B,GAAG;QACH,IAAI;QACJ,YAAY;KACmB,CAAC,CAAA;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,MAAM,EACN,WAAW,EACX,aAAa,CACd,CAAC;YACA,IAAI;YACJ,EAAE,EAAE,OAAO;YACX,GAAG,OAAO;SACyB,CAAC,CAAA;QACtC,OAAO,GAAG,CAAA;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC3E,MAAM,gBAAgB,CAAC,KAAkB,EAAE;YACzC,GAAG;YACH,OAAO;YACP,IAAI;YACJ,QAAQ,EAAE,oCAAoC;YAC9C,YAAY;YACZ,MAAM,EAAE,OAAO,EAAE,OAAO;SACzB,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/_esm/actions/public/estimateFeesPerGas.js

@@ -0,0 +1,83 @@
+import { BaseFeeScalarError, Eip1559FeesNotSupportedError, } from '../../errors/fee.js';
+import { getAction } from '../../utils/getAction.js';
+import { internal_estimateMaxPriorityFeePerGas, } from './estimateMaxPriorityFeePerGas.js';
+import { getBlock } from './getBlock.js';
+import { getGasPrice } from './getGasPrice.js';
+/**
+ * Returns an estimate for the fees per gas (in wei) for a
+ * transaction to be likely included in the next block.
+ * Defaults to [`chain.fees.estimateFeesPerGas`](/docs/clients/chains.html#fees-estimatefeespergas) if set.
+ *
+ * - Docs: https://viem.sh/docs/actions/public/estimateFeesPerGas.html
+ *
+ * @param client - Client to use
+ * @param parameters - {@link EstimateFeesPerGasParameters}
+ * @returns An estimate (in wei) for the fees per gas. {@link EstimateFeesPerGasReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { estimateFeesPerGas } from 'viem/actions'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const maxPriorityFeePerGas = await estimateFeesPerGas(client)
+ * // { maxFeePerGas: ..., maxPriorityFeePerGas: ... }
+ */
+export async function estimateFeesPerGas(client, args) {
+    return internal_estimateFeesPerGas(client, args);
+}
+export async function internal_estimateFeesPerGas(client, args) {
+    const { block: block_, chain = client.chain, request, type = 'eip1559', } = args || {};
+    const baseFeeMultiplier = await (async () => {
+        if (typeof chain?.fees?.baseFeeMultiplier === 'function')
+            return chain.fees.baseFeeMultiplier({
+                block: block_,
+                client,
+                request,
+            });
+        return chain?.fees?.baseFeeMultiplier ?? 1.2;
+    })();
+    if (baseFeeMultiplier < 1)
+        throw new BaseFeeScalarError();
+    const decimals = baseFeeMultiplier.toString().split('.')[1]?.length ?? 0;
+    const denominator = 10 ** decimals;
+    const multiply = (base) => (base * BigInt(Math.ceil(baseFeeMultiplier * denominator))) /
+        BigInt(denominator);
+    const block = block_
+        ? block_
+        : await getAction(client, getBlock, 'getBlock')({});
+    if (typeof chain?.fees?.estimateFeesPerGas === 'function')
+        return chain.fees.estimateFeesPerGas({
+            block: block_,
+            client,
+            multiply,
+            request,
+            type,
+        });
+    if (type === 'eip1559') {
+        if (typeof block.baseFeePerGas !== 'bigint')
+            throw new Eip1559FeesNotSupportedError();
+        const maxPriorityFeePerGas = request?.maxPriorityFeePerGas
+            ? request.maxPriorityFeePerGas
+            : await internal_estimateMaxPriorityFeePerGas(client, {
+                block: block,
+                chain,
+                request,
+            });
+        const baseFeePerGas = multiply(block.baseFeePerGas);
+        const maxFeePerGas = request?.maxFeePerGas ?? baseFeePerGas + maxPriorityFeePerGas;
+        return {
+            maxFeePerGas,
+            maxPriorityFeePerGas,
+        };
+    }
+    const gasPrice = request?.gasPrice ??
+        multiply(await getAction(client, getGasPrice, 'getGasPrice')({}));
+    return {
+        gasPrice,
+    };
+}
+//# sourceMappingURL=estimateFeesPerGas.js.map

package/_esm/actions/public/estimateFeesPerGas.js.map

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

package/_esm/actions/public/estimateGas.js

@@ -0,0 +1,73 @@
+import { parseAccount, } from '../../accounts/utils/parseAccount.js';
+import { numberToHex, } from '../../utils/encoding/toHex.js';
+import { getEstimateGasError, } from '../../utils/errors/getEstimateGasError.js';
+import { extract } from '../../utils/formatters/extract.js';
+import { formatTransactionRequest, } from '../../utils/formatters/transactionRequest.js';
+import { assertRequest, } from '../../utils/transaction/assertRequest.js';
+import { prepareTransactionRequest, } from '../wallet/prepareTransactionRequest.js';
+/**
+ * Estimates the gas necessary to complete a transaction without submitting it to the network.
+ *
+ * - Docs: https://viem.sh/docs/actions/public/estimateGas.html
+ * - JSON-RPC Methods: [`eth_estimateGas`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_estimategas)
+ *
+ * @param client - Client to use
+ * @param parameters - {@link EstimateGasParameters}
+ * @returns The gas estimate (in wei). {@link EstimateGasReturnType}
+ *
+ * @example
+ * import { createPublicClient, http, parseEther } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { estimateGas } from 'viem/public'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const gasEstimate = await estimateGas(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *   value: parseEther('1'),
+ * })
+ */
+export async function estimateGas(client, args) {
+    const account_ = args.account ?? client.account;
+    const account = account_ ? parseAccount(account_) : undefined;
+    try {
+        const { accessList, blockNumber, blockTag, data, gas, gasPrice, maxFeePerGas, maxPriorityFeePerGas, nonce, to, value, ...rest } = account?.type === 'local'
+            ? (await prepareTransactionRequest(client, args))
+            : args;
+        const blockNumberHex = blockNumber ? numberToHex(blockNumber) : undefined;
+        const block = blockNumberHex || blockTag;
+        assertRequest(args);
+        const chainFormat = client.chain?.formatters?.transactionRequest?.format;
+        const format = chainFormat || formatTransactionRequest;
+        const request = format({
+            // Pick out extra data that might exist on the chain's transaction request type.
+            ...extract(rest, { format: chainFormat }),
+            from: account?.address,
+            accessList,
+            data,
+            gas,
+            gasPrice,
+            maxFeePerGas,
+            maxPriorityFeePerGas,
+            nonce,
+            to,
+            value,
+        });
+        const balance = await client.request({
+            method: 'eth_estimateGas',
+            params: block ? [request, block] : [request],
+        });
+        return BigInt(balance);
+    }
+    catch (err) {
+        throw getEstimateGasError(err, {
+            ...args,
+            account,
+            chain: client.chain,
+        });
+    }
+}
+//# sourceMappingURL=estimateGas.js.map

package/_esm/actions/public/estimateGas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimateGas.js","sourceRoot":"","sources":["../../../actions/public/estimateGas.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,YAAY,GACb,MAAM,sCAAsC,CAAA;AAS7C,OAAO,EAEL,WAAW,GACZ,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAEL,mBAAmB,GACpB,MAAM,2CAA2C,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAA;AAC3D,OAAO,EAEL,wBAAwB,GACzB,MAAM,8CAA8C,CAAA;AACrD,OAAO,EAGL,aAAa,GACd,MAAM,0CAA0C,CAAA;AACjD,OAAO,EAEL,yBAAyB,GAC1B,MAAM,wCAAwC,CAAA;AAmC/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAI/B,MAA2C,EAC3C,IAAmC;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAA;IAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE7D,IAAI,CAAC;QACH,MAAM,EACJ,UAAU,EACV,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,EAAE,EACF,KAAK,EACL,GAAG,IAAI,EACR,GACC,OAAO,EAAE,IAAI,KAAK,OAAO;YACvB,CAAC,CAAE,CAAC,MAAM,yBAAyB,CAC/B,MAAM,EACN,IAA2C,CAC5C,CAA2B;YAC9B,CAAC,CAAC,IAAI,CAAA;QAEV,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACzE,MAAM,KAAK,GAAG,cAAc,IAAI,QAAQ,CAAA;QAExC,aAAa,CAAC,IAA+B,CAAC,CAAA;QAE9C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,CAAA;QACxE,MAAM,MAAM,GAAG,WAAW,IAAI,wBAAwB,CAAA;QAEtD,MAAM,OAAO,GAAG,MAAM,CAAC;YACrB,gFAAgF;YAChF,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACzC,IAAI,EAAE,OAAO,EAAE,OAAO;YACtB,UAAU;YACV,IAAI;YACJ,GAAG;YACH,QAAQ;YACR,YAAY;YACZ,oBAAoB;YACpB,KAAK;YACL,EAAE;YACF,KAAK;SACgB,CAAC,CAAA;QAExB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;YACnC,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;SAC7C,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,mBAAmB,CAAC,GAAgB,EAAE;YAC1C,GAAG,IAAI;YACP,OAAO;YACP,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}