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

package/_esm/actions/public/simulateContract.js

@@ -0,0 +1,83 @@
+import { parseAccount, } from '../../accounts/utils/parseAccount.js';
+import { decodeFunctionResult, } from '../../utils/abi/decodeFunctionResult.js';
+import { encodeFunctionData, } from '../../utils/abi/encodeFunctionData.js';
+import { getContractError, } from '../../utils/errors/getContractError.js';
+import { getAction } from '../../utils/getAction.js';
+import { call } from './call.js';
+/**
+ * Simulates/validates a contract interaction. This is useful for retrieving **return data** and **revert reasons** of contract write functions.
+ *
+ * - Docs: https://viem.sh/docs/contract/simulateContract.html
+ * - Examples: https://stackblitz.com/github/wevm/viem/tree/main/examples/contracts/writing-to-contracts
+ *
+ * This function does not require gas to execute and _**does not**_ change the state of the blockchain. It is almost identical to [`readContract`](https://viem.sh/docs/contract/readContract.html), but also supports contract write functions.
+ *
+ * Internally, uses a [Public Client](https://viem.sh/docs/clients/public.html) to call the [`call` action](https://viem.sh/docs/actions/public/call.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
+ *
+ * @param client - Client to use
+ * @param parameters - {@link SimulateContractParameters}
+ * @returns The simulation result and write request. {@link SimulateContractReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { simulateContract } from 'viem/contract'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const result = await simulateContract(client, {
+ *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+ *   abi: parseAbi(['function mint(uint32) view returns (uint32)']),
+ *   functionName: 'mint',
+ *   args: ['69420'],
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ * })
+ */
+export async function simulateContract(client, parameters) {
+    const { abi, address, args, dataSuffix, functionName, ...callRequest } = parameters;
+    const account = callRequest.account
+        ? parseAccount(callRequest.account)
+        : client.account;
+    const calldata = encodeFunctionData({ abi, args, functionName });
+    try {
+        const { data } = await getAction(client, call, 'call')({
+            batch: false,
+            data: `${calldata}${dataSuffix ? dataSuffix.replace('0x', '') : ''}`,
+            to: address,
+            ...callRequest,
+            account,
+        });
+        const result = decodeFunctionResult({
+            abi,
+            args,
+            functionName,
+            data: data || '0x',
+        });
+        const minimizedAbi = abi.filter((abiItem) => 'name' in abiItem && abiItem.name === parameters.functionName);
+        return {
+            result,
+            request: {
+                abi: minimizedAbi,
+                address,
+                args,
+                dataSuffix,
+                functionName,
+                ...callRequest,
+                account,
+            },
+        };
+    }
+    catch (error) {
+        throw getContractError(error, {
+            abi,
+            address,
+            args,
+            docsPath: '/docs/contract/simulateContract',
+            functionName,
+            sender: account?.address,
+        });
+    }
+}
+//# sourceMappingURL=simulateContract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"simulateContract.js","sourceRoot":"","sources":["../../../actions/public/simulateContract.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,YAAY,GACb,MAAM,sCAAsC,CAAA;AAiB7C,OAAO,EAEL,oBAAoB,GACrB,MAAM,yCAAyC,CAAA;AAChD,OAAO,EAEL,kBAAkB,GACnB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAEL,gBAAgB,GACjB,MAAM,wCAAwC,CAAA;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAA2C,IAAI,EAAE,MAAM,WAAW,CAAA;AAiHzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAapC,MAAyC,EACzC,UAOC;IAYD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,GACpE,UAAwC,CAAA;IAE1C,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO;QACjC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC;QACnC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAA;IAClB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;IAChE,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,SAAS,CAC9B,MAAM,EACN,IAAI,EACJ,MAAM,CACP,CAAC;YACA,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;YACpE,EAAE,EAAE,OAAO;YACX,GAAG,WAAW;YACd,OAAO;SACR,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC;YAClC,GAAG;YACH,IAAI;YACJ,YAAY;YACZ,IAAI,EAAE,IAAI,IAAI,IAAI;SACnB,CAAC,CAAA;QACF,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAC7B,CAAC,OAAO,EAAE,EAAE,CACV,MAAM,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,CAAC,YAAY,CAChE,CAAA;QACD,OAAO;YACL,MAAM;YACN,OAAO,EAAE;gBACP,GAAG,EAAE,YAAY;gBACjB,OAAO;gBACP,IAAI;gBACJ,UAAU;gBACV,YAAY;gBACZ,GAAG,WAAW;gBACd,OAAO;aACR;SASF,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,gBAAgB,CAAC,KAAkB,EAAE;YACzC,GAAG;YACH,OAAO;YACP,IAAI;YACJ,QAAQ,EAAE,iCAAiC;YAC3C,YAAY;YACZ,MAAM,EAAE,OAAO,EAAE,OAAO;SACzB,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/_esm/actions/public/uninstallFilter.js

@@ -0,0 +1,31 @@
+/**
+ * Destroys a [`Filter`](https://viem.sh/docs/glossary/types.html#filter).
+ *
+ * - Docs: https://viem.sh/docs/actions/public/uninstallFilter.html
+ * - JSON-RPC Methods: [`eth_uninstallFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_uninstallFilter)
+ *
+ * Destroys a Filter that was created from one of the following Actions:
+ * - [`createBlockFilter`](https://viem.sh/docs/actions/public/createBlockFilter.html)
+ * - [`createEventFilter`](https://viem.sh/docs/actions/public/createEventFilter.html)
+ * - [`createPendingTransactionFilter`](https://viem.sh/docs/actions/public/createPendingTransactionFilter.html)
+ *
+ * @param client - Client to use
+ * @param parameters - {@link UninstallFilterParameters}
+ * @returns A boolean indicating if the Filter was successfully uninstalled. {@link UninstallFilterReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { createPendingTransactionFilter, uninstallFilter } from 'viem/public'
+ *
+ * const filter = await createPendingTransactionFilter(client)
+ * const uninstalled = await uninstallFilter(client, { filter })
+ * // true
+ */
+export async function uninstallFilter(_client, { filter }) {
+    return filter.request({
+        method: 'eth_uninstallFilter',
+        params: [filter.id],
+    });
+}
+//# sourceMappingURL=uninstallFilter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uninstallFilter.js","sourceRoot":"","sources":["../../../actions/public/uninstallFilter.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAInC,OAAmC,EACnC,EAAE,MAAM,EAA6B;IAErC,OAAO,MAAM,CAAC,OAAO,CAAC;QACpB,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;KACpB,CAAC,CAAA;AACJ,CAAC"}

package/_esm/actions/public/verifyHash.js

@@ -0,0 +1,38 @@
+import { universalSignatureValidatorAbi } from '../../constants/abis.js';
+import { universalSignatureValidatorByteCode } from '../../constants/contracts.js';
+import { CallExecutionError } from '../../errors/contract.js';
+import { isBytesEqual, } from '../../utils/data/isBytesEqual.js';
+import { getAction } from '../../utils/getAction.js';
+import { encodeDeployData, isHex, toHex } from '../../utils/index.js';
+import { call } from './call.js';
+/**
+ * Verifies a message hash on chain using ERC-6492.
+ *
+ * @param client - Client to use.
+ * @param parameters - {@link VerifyHashParameters}
+ * @returns Whether or not the signature is valid. {@link VerifyHashReturnType}
+ */
+export async function verifyHash(client, { address, hash, signature, ...callRequest }) {
+    const signatureHex = isHex(signature) ? signature : toHex(signature);
+    try {
+        const { data } = await getAction(client, call, 'call')({
+            data: encodeDeployData({
+                abi: universalSignatureValidatorAbi,
+                args: [address, hash, signatureHex],
+                bytecode: universalSignatureValidatorByteCode,
+            }),
+            ...callRequest,
+        });
+        return isBytesEqual(data ?? '0x0', '0x1');
+    }
+    catch (error) {
+        if (error instanceof CallExecutionError) {
+            // if the execution fails, the signature was not valid and an internal method inside of the validator reverted
+            // this can happen for many reasons, for example if signer can not be recovered from the signature
+            // or if the signature has no valid format
+            return false;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=verifyHash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifyHash.js","sourceRoot":"","sources":["../../../actions/public/verifyHash.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,EAAE,mCAAmC,EAAE,MAAM,8BAA8B,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAK7D,OAAO,EAEL,YAAY,GACb,MAAM,kCAAkC,CAAA;AAGzC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,EAA2C,IAAI,EAAE,MAAM,WAAW,CAAA;AAwBzE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAiC,EACjC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,WAAW,EAAwB;IAElE,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAEpE,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,SAAS,CAC9B,MAAM,EACN,IAAI,EACJ,MAAM,CACP,CAAC;YACA,IAAI,EAAE,gBAAgB,CAAC;gBACrB,GAAG,EAAE,8BAA8B;gBACnC,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC;gBACnC,QAAQ,EAAE,mCAAmC;aAC9C,CAAC;YACF,GAAG,WAAW;SACc,CAAC,CAAA;QAE/B,OAAO,YAAY,CAAC,IAAI,IAAI,KAAK,EAAE,KAAK,CAAC,CAAA;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;YACxC,8GAA8G;YAC9G,kGAAkG;YAClG,0CAA0C;YAC1C,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/_esm/actions/public/verifyMessage.js

@@ -0,0 +1,23 @@
+import { hashMessage } from '../../utils/index.js';
+import { verifyHash, } from './verifyHash.js';
+/**
+ * Verify that a message was signed by the provided address.
+ *
+ * Compatible with Smart Contract Accounts & Externally Owned Accounts via [ERC-6492](https://eips.ethereum.org/EIPS/eip-6492).
+ *
+ * - Docs {@link https://viem.sh/docs/actions/public/verifyMessage.html}
+ *
+ * @param client - Client to use.
+ * @param parameters - {@link VerifyMessageParameters}
+ * @returns Whether or not the signature is valid. {@link VerifyMessageReturnType}
+ */
+export async function verifyMessage(client, { address, message, signature, ...callRequest }) {
+    const hash = hashMessage(message);
+    return verifyHash(client, {
+        address,
+        hash,
+        signature,
+        ...callRequest,
+    });
+}
+//# sourceMappingURL=verifyMessage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifyMessage.js","sourceRoot":"","sources":["../../../actions/public/verifyMessage.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAGL,UAAU,GACX,MAAM,iBAAiB,CAAA;AAkBxB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAiC,EACjC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,WAAW,EAA2B;IAExE,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IACjC,OAAO,UAAU,CAAC,MAAM,EAAE;QACxB,OAAO;QACP,IAAI;QACJ,SAAS;QACT,GAAG,WAAW;KACf,CAAC,CAAA;AACJ,CAAC"}

package/_esm/actions/public/verifyTypedData.js

@@ -0,0 +1,21 @@
+import { hashTypedData, } from '../../utils/signature/hashTypedData.js';
+import { verifyHash, } from './verifyHash.js';
+/**
+ * Verify that typed data was signed by the provided address.
+ *
+ * - Docs {@link https://viem.sh/docs/actions/public/verifyTypedData.html}
+ *
+ * @param client - Client to use.
+ * @param parameters - {@link VerifyTypedDataParameters}
+ * @returns Whether or not the signature is valid. {@link VerifyTypedDataReturnType}
+ */
+export async function verifyTypedData(client, { address, signature, message, primaryType, types, domain, ...callRequest }) {
+    const hash = hashTypedData({ message, primaryType, types, domain });
+    return verifyHash(client, {
+        address,
+        hash,
+        signature,
+        ...callRequest,
+    });
+}
+//# sourceMappingURL=verifyTypedData.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifyTypedData.js","sourceRoot":"","sources":["../../../actions/public/verifyTypedData.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,aAAa,GACd,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAGL,UAAU,GACX,MAAM,iBAAiB,CAAA;AAoBxB;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAiC,EACjC,EACE,OAAO,EACP,SAAS,EACT,OAAO,EACP,WAAW,EACX,KAAK,EACL,MAAM,EACN,GAAG,WAAW,EACY;IAE5B,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IACnE,OAAO,UAAU,CAAC,MAAM,EAAE;QACxB,OAAO;QACP,IAAI;QACJ,SAAS;QACT,GAAG,WAAW;KACf,CAAC,CAAA;AACJ,CAAC"}

package/_esm/actions/public/waitForTransactionReceipt.js

@@ -0,0 +1,180 @@
+import { BlockNotFoundError } from '../../errors/block.js';
+import { TransactionNotFoundError, TransactionReceiptNotFoundError, WaitForTransactionReceiptTimeoutError, } from '../../errors/transaction.js';
+import { getAction } from '../../utils/getAction.js';
+import { observe } from '../../utils/observe.js';
+import { withRetry } from '../../utils/promise/withRetry.js';
+import { stringify } from '../../utils/stringify.js';
+import { getBlock } from './getBlock.js';
+import { getTransaction, } from './getTransaction.js';
+import { getTransactionReceipt, } from './getTransactionReceipt.js';
+import { watchBlockNumber, } from './watchBlockNumber.js';
+/**
+ * Waits for the [Transaction](https://viem.sh/docs/glossary/terms.html#transaction) to be included on a [Block](https://viem.sh/docs/glossary/terms.html#block) (one confirmation), and then returns the [Transaction Receipt](https://viem.sh/docs/glossary/terms.html#transaction-receipt). If the Transaction reverts, then the action will throw an error.
+ *
+ * - Docs: https://viem.sh/docs/actions/public/waitForTransactionReceipt.html
+ * - Example: https://stackblitz.com/github/wevm/viem/tree/main/examples/transactions/sending-transactions
+ * - JSON-RPC Methods:
+ *   - Polls [`eth_getTransactionReceipt`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getTransactionReceipt) on each block until it has been processed.
+ *   - If a Transaction has been replaced:
+ *     - Calls [`eth_getBlockByNumber`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblockbynumber) and extracts the transactions
+ *     - Checks if one of the Transactions is a replacement
+ *     - If so, calls [`eth_getTransactionReceipt`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getTransactionReceipt).
+ *
+ * The `waitForTransactionReceipt` action additionally supports Replacement detection (e.g. sped up Transactions).
+ *
+ * Transactions can be replaced when a user modifies their transaction in their wallet (to speed up or cancel). Transactions are replaced when they are sent from the same nonce.
+ *
+ * There are 3 types of Transaction Replacement reasons:
+ *
+ * - `repriced`: The gas price has been modified (e.g. different `maxFeePerGas`)
+ * - `cancelled`: The Transaction has been cancelled (e.g. `value === 0n`)
+ * - `replaced`: The Transaction has been replaced (e.g. different `value` or `data`)
+ *
+ * @param client - Client to use
+ * @param parameters - {@link WaitForTransactionReceiptParameters}
+ * @returns The transaction receipt. {@link WaitForTransactionReceiptReturnType}
+ *
+ * @example
+ * import { createPublicClient, waitForTransactionReceipt, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const transactionReceipt = await waitForTransactionReceipt(client, {
+ *   hash: '0x4ca7ee652d57678f26e887c149ab0735f41de37bcad58c9f6d3ed5824f15b74d',
+ * })
+ */
+export async function waitForTransactionReceipt(client, { confirmations = 1, hash, onReplaced, pollingInterval = client.pollingInterval, timeout, }) {
+    const observerId = stringify(['waitForTransactionReceipt', client.uid, hash]);
+    let transaction;
+    let replacedTransaction;
+    let receipt;
+    let retrying = false;
+    return new Promise((resolve, reject) => {
+        if (timeout)
+            setTimeout(() => reject(new WaitForTransactionReceiptTimeoutError({ hash })), timeout);
+        const _unobserve = observe(observerId, { onReplaced, resolve, reject }, (emit) => {
+            const _unwatch = getAction(client, watchBlockNumber, 'watchBlockNumber')({
+                emitMissed: true,
+                emitOnBegin: true,
+                poll: true,
+                pollingInterval,
+                async onBlockNumber(blockNumber_) {
+                    if (retrying)
+                        return;
+                    let blockNumber = blockNumber_;
+                    const done = (fn) => {
+                        _unwatch();
+                        fn();
+                        _unobserve();
+                    };
+                    try {
+                        // If we already have a valid receipt, let's check if we have enough
+                        // confirmations. If we do, then we can resolve.
+                        if (receipt) {
+                            if (confirmations > 1 &&
+                                (!receipt.blockNumber ||
+                                    blockNumber - receipt.blockNumber + 1n < confirmations))
+                                return;
+                            done(() => emit.resolve(receipt));
+                            return;
+                        }
+                        // Get the transaction to check if it's been replaced.
+                        // We need to retry as some RPC Providers may be slow to sync
+                        // up mined transactions.
+                        if (!transaction) {
+                            retrying = true;
+                            await withRetry(async () => {
+                                transaction = (await getAction(client, getTransaction, 'getTransaction')({ hash }));
+                                if (transaction.blockNumber)
+                                    blockNumber = transaction.blockNumber;
+                            }, {
+                                // exponential backoff
+                                delay: ({ count }) => ~~(1 << count) * 200,
+                                retryCount: 6,
+                            });
+                            retrying = false;
+                        }
+                        // Get the receipt to check if it's been processed.
+                        receipt = await getAction(client, getTransactionReceipt, 'getTransactionReceipt')({ hash });
+                        // Check if we have enough confirmations. If not, continue polling.
+                        if (confirmations > 1 &&
+                            (!receipt.blockNumber ||
+                                blockNumber - receipt.blockNumber + 1n < confirmations))
+                            return;
+                        done(() => emit.resolve(receipt));
+                    }
+                    catch (err) {
+                        // If the receipt is not found, the transaction will be pending.
+                        // We need to check if it has potentially been replaced.
+                        if (err instanceof TransactionNotFoundError ||
+                            err instanceof TransactionReceiptNotFoundError) {
+                            if (!transaction) {
+                                retrying = false;
+                                return;
+                            }
+                            try {
+                                replacedTransaction = transaction;
+                                // Let's retrieve the transactions from the current block.
+                                // We need to retry as some RPC Providers may be slow to sync
+                                // up mined blocks.
+                                retrying = true;
+                                const block = await withRetry(() => getAction(client, getBlock, 'getBlock')({
+                                    blockNumber,
+                                    includeTransactions: true,
+                                }), {
+                                    // exponential backoff
+                                    delay: ({ count }) => ~~(1 << count) * 200,
+                                    retryCount: 6,
+                                    shouldRetry: ({ error }) => error instanceof BlockNotFoundError,
+                                });
+                                retrying = false;
+                                const replacementTransaction = block.transactions.find(({ from, nonce }) => from === replacedTransaction.from &&
+                                    nonce === replacedTransaction.nonce);
+                                // If we couldn't find a replacement transaction, continue polling.
+                                if (!replacementTransaction)
+                                    return;
+                                // If we found a replacement transaction, return it's receipt.
+                                receipt = await getAction(client, getTransactionReceipt, 'getTransactionReceipt')({
+                                    hash: replacementTransaction.hash,
+                                });
+                                // Check if we have enough confirmations. If not, continue polling.
+                                if (confirmations > 1 &&
+                                    (!receipt.blockNumber ||
+                                        blockNumber - receipt.blockNumber + 1n < confirmations))
+                                    return;
+                                let reason = 'replaced';
+                                if (replacementTransaction.to === replacedTransaction.to &&
+                                    replacementTransaction.value === replacedTransaction.value) {
+                                    reason = 'repriced';
+                                }
+                                else if (replacementTransaction.from === replacementTransaction.to &&
+                                    replacementTransaction.value === 0n) {
+                                    reason = 'cancelled';
+                                }
+                                done(() => {
+                                    emit.onReplaced?.({
+                                        reason,
+                                        replacedTransaction: replacedTransaction,
+                                        transaction: replacementTransaction,
+                                        transactionReceipt: receipt,
+                                    });
+                                    emit.resolve(receipt);
+                                });
+                            }
+                            catch (err_) {
+                                done(() => emit.reject(err_));
+                            }
+                        }
+                        else {
+                            done(() => emit.reject(err));
+                        }
+                    }
+                },
+            });
+        });
+    });
+}
+//# sourceMappingURL=waitForTransactionReceipt.js.map

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

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

package/_esm/actions/public/watchBlockNumber.js

@@ -0,0 +1,105 @@
+import { hexToBigInt } from '../../utils/encoding/fromHex.js';
+import { getAction } from '../../utils/getAction.js';
+import { observe } from '../../utils/observe.js';
+import { poll } from '../../utils/poll.js';
+import { stringify } from '../../utils/stringify.js';
+import { getBlockNumber, } from './getBlockNumber.js';
+/**
+ * Watches and returns incoming block numbers.
+ *
+ * - Docs: https://viem.sh/docs/actions/public/watchBlockNumber.html
+ * - Examples: https://stackblitz.com/github/wevm/viem/tree/main/examples/blocks/watching-blocks
+ * - JSON-RPC Methods:
+ *   - When `poll: true`, calls [`eth_blockNumber`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_blocknumber) on a polling interval.
+ *   - When `poll: false` & WebSocket Transport, uses a WebSocket subscription via [`eth_subscribe`](https://docs.alchemy.com/reference/eth-subscribe-polygon) and the `"newHeads"` event.
+ *
+ * @param client - Client to use
+ * @param parameters - {@link WatchBlockNumberParameters}
+ * @returns A function that can be invoked to stop watching for new block numbers. {@link WatchBlockNumberReturnType}
+ *
+ * @example
+ * import { createPublicClient, watchBlockNumber, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const unwatch = watchBlockNumber(client, {
+ *   onBlockNumber: (blockNumber) => console.log(blockNumber),
+ * })
+ */
+export function watchBlockNumber(client, { emitOnBegin = false, emitMissed = false, onBlockNumber, onError, poll: poll_, pollingInterval = client.pollingInterval, }) {
+    const enablePolling = typeof poll_ !== 'undefined' ? poll_ : client.transport.type !== 'webSocket';
+    let prevBlockNumber;
+    const pollBlockNumber = () => {
+        const observerId = stringify([
+            'watchBlockNumber',
+            client.uid,
+            emitOnBegin,
+            emitMissed,
+            pollingInterval,
+        ]);
+        return observe(observerId, { onBlockNumber, onError }, (emit) => poll(async () => {
+            try {
+                const blockNumber = await getAction(client, getBlockNumber, 'getBlockNumber')({ cacheTime: 0 });
+                if (prevBlockNumber) {
+                    // If the current block number is the same as the previous,
+                    // we can skip.
+                    if (blockNumber === prevBlockNumber)
+                        return;
+                    // If we have missed out on some previous blocks, and the
+                    // `emitMissed` flag is truthy, let's emit those blocks.
+                    if (blockNumber - prevBlockNumber > 1 && emitMissed) {
+                        for (let i = prevBlockNumber + 1n; i < blockNumber; i++) {
+                            emit.onBlockNumber(i, prevBlockNumber);
+                            prevBlockNumber = i;
+                        }
+                    }
+                }
+                // If the next block number is greater than the previous,
+                // it is not in the past, and we can emit the new block number.
+                if (!prevBlockNumber || blockNumber > prevBlockNumber) {
+                    emit.onBlockNumber(blockNumber, prevBlockNumber);
+                    prevBlockNumber = blockNumber;
+                }
+            }
+            catch (err) {
+                emit.onError?.(err);
+            }
+        }, {
+            emitOnBegin,
+            interval: pollingInterval,
+        }));
+    };
+    const subscribeBlockNumber = () => {
+        let active = true;
+        let unsubscribe = () => (active = false);
+        (async () => {
+            try {
+                const { unsubscribe: unsubscribe_ } = await client.transport.subscribe({
+                    params: ['newHeads'],
+                    onData(data) {
+                        if (!active)
+                            return;
+                        const blockNumber = hexToBigInt(data.result?.number);
+                        onBlockNumber(blockNumber, prevBlockNumber);
+                        prevBlockNumber = blockNumber;
+                    },
+                    onError(error) {
+                        onError?.(error);
+                    },
+                });
+                unsubscribe = unsubscribe_;
+                if (!active)
+                    unsubscribe();
+            }
+            catch (err) {
+                onError?.(err);
+            }
+        })();
+        return unsubscribe;
+    };
+    return enablePolling ? pollBlockNumber() : subscribeBlockNumber();
+}
+//# sourceMappingURL=watchBlockNumber.js.map

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

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

package/_esm/actions/public/watchBlocks.js

@@ -0,0 +1,120 @@
+import { formatBlock } from '../../utils/formatters/block.js';
+import { getAction } from '../../utils/getAction.js';
+import { observe } from '../../utils/observe.js';
+import { poll } from '../../utils/poll.js';
+import { stringify } from '../../utils/stringify.js';
+import { getBlock } from './getBlock.js';
+/**
+ * Watches and returns information for incoming blocks.
+ *
+ * - Docs: https://viem.sh/docs/actions/public/watchBlocks.html
+ * - Examples: https://stackblitz.com/github/wevm/viem/tree/main/examples/blocks/watching-blocks
+ * - JSON-RPC Methods:
+ *   - When `poll: true`, calls [`eth_getBlockByNumber`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getBlockByNumber) on a polling interval.
+ *   - When `poll: false` & WebSocket Transport, uses a WebSocket subscription via [`eth_subscribe`](https://docs.alchemy.com/reference/eth-subscribe-polygon) and the `"newHeads"` event.
+ *
+ * @param client - Client to use
+ * @param parameters - {@link WatchBlocksParameters}
+ * @returns A function that can be invoked to stop watching for new block numbers. {@link WatchBlocksReturnType}
+ *
+ * @example
+ * import { createPublicClient, watchBlocks, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const unwatch = watchBlocks(client, {
+ *   onBlock: (block) => console.log(block),
+ * })
+ */
+export function watchBlocks(client, { blockTag = 'latest', emitMissed = false, emitOnBegin = false, onBlock, onError, includeTransactions: includeTransactions_, poll: poll_, pollingInterval = client.pollingInterval, }) {
+    const enablePolling = typeof poll_ !== 'undefined' ? poll_ : client.transport.type !== 'webSocket';
+    const includeTransactions = includeTransactions_ ?? false;
+    let prevBlock;
+    const pollBlocks = () => {
+        const observerId = stringify([
+            'watchBlocks',
+            client.uid,
+            emitMissed,
+            emitOnBegin,
+            includeTransactions,
+            pollingInterval,
+        ]);
+        return observe(observerId, { onBlock, onError }, (emit) => poll(async () => {
+            try {
+                const block = await getAction(client, getBlock, 'getBlock')({
+                    blockTag,
+                    includeTransactions,
+                });
+                if (block.number && prevBlock?.number) {
+                    // If the current block number is the same as the previous,
+                    // we can skip.
+                    if (block.number === prevBlock.number)
+                        return;
+                    // If we have missed out on some previous blocks, and the
+                    // `emitMissed` flag is truthy, let's emit those blocks.
+                    if (block.number - prevBlock.number > 1 && emitMissed) {
+                        for (let i = prevBlock?.number + 1n; i < block.number; i++) {
+                            const block = (await getAction(client, getBlock, 'getBlock')({
+                                blockNumber: i,
+                                includeTransactions,
+                            }));
+                            emit.onBlock(block, prevBlock);
+                            prevBlock = block;
+                        }
+                    }
+                }
+                if (
+                // If no previous block exists, emit.
+                !prevBlock?.number ||
+                    // If the block tag is "pending" with no block number, emit.
+                    (blockTag === 'pending' && !block?.number) ||
+                    // If the next block number is greater than the previous block number, emit.
+                    // We don't want to emit blocks in the past.
+                    (block.number && block.number > prevBlock.number)) {
+                    emit.onBlock(block, prevBlock);
+                    prevBlock = block;
+                }
+            }
+            catch (err) {
+                emit.onError?.(err);
+            }
+        }, {
+            emitOnBegin,
+            interval: pollingInterval,
+        }));
+    };
+    const subscribeBlocks = () => {
+        let active = true;
+        let unsubscribe = () => (active = false);
+        (async () => {
+            try {
+                const { unsubscribe: unsubscribe_ } = await client.transport.subscribe({
+                    params: ['newHeads'],
+                    onData(data) {
+                        if (!active)
+                            return;
+                        const format = client.chain?.formatters?.block?.format || formatBlock;
+                        const block = format(data.result);
+                        onBlock(block, prevBlock);
+                        prevBlock = block;
+                    },
+                    onError(error) {
+                        onError?.(error);
+                    },
+                });
+                unsubscribe = unsubscribe_;
+                if (!active)
+                    unsubscribe();
+            }
+            catch (err) {
+                onError?.(err);
+            }
+        })();
+        return unsubscribe;
+    };
+    return enablePolling ? pollBlocks() : subscribeBlocks();
+}
+//# sourceMappingURL=watchBlocks.js.map