<!--
Sitemap:
- [Why Viem](/docs/introduction): A brief preamble on why we built Viem
- [Installation](/docs/installation)
- [Getting Started](/docs/getting-started): Get started with viem in just a few lines of code.
- [Platform Compatibility](/docs/compatibility): Platforms compatible with Viem
- [Frequently Asked Questions](/docs/faq)
- [Migration Guide](/docs/migration-guide)
- [Ethers v5 → viem Migration Guide](/docs/ethers-migration): Migrate from Ethers v5 to viem
- [TypeScript](/docs/typescript): TypeScript support for Viem
- [Error Handling](/docs/error-handling)
- [EIP-7702 Overview](/docs/eip7702): An Overview of EIP-7702
- [Contract Writes with EIP-7702](/docs/eip7702/contract-writes)
- [Sending Transactions with EIP-7702](/docs/eip7702/sending-transactions)
- [Blob Transactions](/docs/guides/blob-transactions): Sending your first Blob Transaction with Viem.
- [Introduction to Clients & Transports](/docs/clients/intro): A brief introduction to Clients & Transports.
- [Public Client](/docs/clients/public): A function to create a Public Client
- [Wallet Client](/docs/clients/wallet): A function to create a Wallet Client.
- [Test Client](/docs/clients/test): A function to create a Test Client
- [Build your own Client](/docs/clients/custom)
- [HTTP Transport](/docs/clients/transports/http): A function to create a HTTP Transport for a Client
- [WebSocket Transport](/docs/clients/transports/websocket): A function to create a WebSocket Transport for a Client
- [Custom Transport](/docs/clients/transports/custom): A function to create a Custom Transport for a Client
- [IPC Transport](/docs/clients/transports/ipc): A function to create an IPC Transport for a Client
- [Fallback Transport](/docs/clients/transports/fallback): A function to create a Fallback Transport for a Client
- [Introduction to Public Actions](/docs/actions/public/introduction): A brief introduction on what Public Actions are in viem.
- [createAccessList](/docs/actions/public/createAccessList)
- [getBalance](/docs/actions/public/getBalance): Returns the balance of an address in wei.
- [getTransactionCount](/docs/actions/public/getTransactionCount): Returns the number of Transactions an Account has sent.
- [getBlock](/docs/actions/public/getBlock): Returns information about a block at a block number, hash or tag.
- [getBlockReceipts](/docs/actions/public/getBlockReceipts): Returns the transaction receipts of a block at a block number, hash or tag.
- [getBlockNumber](/docs/actions/public/getBlockNumber): Returns the number of the most recent block seen.
- [getBlockTransactionCount](/docs/actions/public/getBlockTransactionCount): Returns the number of Transactions at a block number, hash or tag.
- [simulateBlocks](/docs/actions/public/simulateBlocks): Simulates a set of calls on block(s).
- [watchBlockNumber](/docs/actions/public/watchBlockNumber): Watches and returns incoming block numbers.
- [watchBlocks](/docs/actions/public/watchBlocks): Watches and returns information for incoming blocks.
- [call](/docs/actions/public/call): An Action for executing a new message call.
- [simulateCalls](/docs/actions/public/simulateCalls): Simulates a set of calls on block(s).
- [getChainId](/docs/actions/public/getChainId): Returns the chain ID associated with the current network
- [getEip712Domain](/docs/actions/public/getEip712Domain): Reads the EIP-712 domain from a contract.
- [estimateFeesPerGas](/docs/actions/public/estimateFeesPerGas): Returns an estimate for the fees per gas (in wei) for a transaction to be likely included in the next block.
- [estimateGas](/docs/actions/public/estimateGas): An Action for estimating gas for a transaction.
- [estimateMaxPriorityFeePerGas](/docs/actions/public/estimateMaxPriorityFeePerGas): Returns an estimate for the max priority fee per gas (in wei) for a transaction to be likely included in the next block.
- [getBlobBaseFee](/docs/actions/public/getBlobBaseFee): Returns the current blob base fee (in wei).
- [getFeeHistory](/docs/actions/public/getFeeHistory): Returns a collection of historical gas information.
- [getGasPrice](/docs/actions/public/getGasPrice): Returns the current price of gas (in wei).
- [createBlockFilter](/docs/actions/public/createBlockFilter): An Action for creating a new Block Filter.
- [createEventFilter](/docs/actions/public/createEventFilter): An Action for creating a new Event Filter.
- [createPendingTransactionFilter](/docs/actions/public/createPendingTransactionFilter): An Action for creating a new pending transaction filter.
- [getFilterChanges](/docs/actions/public/getFilterChanges): Returns a list of logs or hashes based on a Filter.
- [getFilterLogs](/docs/actions/public/getFilterLogs): Returns a list of event logs since the filter was created.
- [getLogs](/docs/actions/public/getLogs): Returns a list of event logs matching the provided parameters.
- [watchEvent](/docs/actions/public/watchEvent): Watches and returns emitted Event Logs.
- [uninstallFilter](/docs/actions/public/uninstallFilter): Destroys a Filter.
- [getProof](/docs/actions/public/getProof): Returns the account and storage values of the specified account including the Merkle-proof.
- [verifyMessage](/docs/actions/public/verifyMessage): Verifies if a signed message was generated by the provided address.
- [verifyTypedData](/docs/actions/public/verifyTypedData): Verifies a typed data signature
- [prepareTransactionRequest](/docs/actions/wallet/prepareTransactionRequest): Prepares a transaction request for signing.
- [getTransaction](/docs/actions/public/getTransaction): Returns information about a transaction given a hash or block identifier.
- [getTransactionConfirmations](/docs/actions/public/getTransactionConfirmations): Returns the number of blocks passed (confirmations) since the transaction was processed on a block.
- [getTransactionReceipt](/docs/actions/public/getTransactionReceipt): Returns the transaction receipt given a transaction hash.
- [sendRawTransaction](/docs/actions/wallet/sendRawTransaction): Sends a signed transaction to the network
- [waitForTransactionReceipt](/docs/actions/public/waitForTransactionReceipt): Retrieves a Transaction Receipt for a given Transaction hash.
- [watchPendingTransactions](/docs/actions/public/watchPendingTransactions): Watches and returns pending transaction hashes.
- [Introduction to Wallet Actions](/docs/actions/wallet/introduction): A brief introduction to Wallet Actions in viem.
- [getAddresses](/docs/actions/wallet/getAddresses): Returns a list of addresses owned by the wallet or client.
- [requestAddresses](/docs/actions/wallet/requestAddresses): Requests a list of accounts managed by a wallet.
- [watchAsset](/docs/actions/wallet/watchAsset): Requests that the user tracks the token in their wallet.
- [getCallsStatus](/docs/actions/wallet/getCallsStatus): Returns the status of a call batch.
- [getCapabilities](/docs/actions/wallet/getCapabilities): Extract capabilities that a connected wallet supports.
- [sendCalls](/docs/actions/wallet/sendCalls): Sign and broadcast a batch of calls to the network.
- [sendCallsSync](/docs/actions/wallet/sendCallsSync): Sign and broadcast a batch of calls to the network, and waits for the calls to be included in a block.
- [showCallsStatus](/docs/actions/wallet/showCallsStatus): Requests for the wallet to show information about a call batch.
- [waitForCallsStatus](/docs/actions/wallet/waitForCallsStatus): Waits for a call batch to be confirmed & included on a Block.
- [addChain](/docs/actions/wallet/addChain): Adds an EVM chain to the wallet.
- [switchChain](/docs/actions/wallet/switchChain): Switch the target chain in a wallet.
- [signMessage](/docs/actions/wallet/signMessage): Signs a message with the Account's private key.
- [signTypedData](/docs/actions/wallet/signTypedData): Signs typed data with the Account's private key.
- [getPermissions](/docs/actions/wallet/getPermissions): Gets the wallets current permissions.
- [requestPermissions](/docs/actions/wallet/requestPermissions): Requests permissions for a wallet.
- [sendRawTransactionSync](/docs/actions/wallet/sendRawTransactionSync): Sends a signed transaction to the network synchronously
- [sendTransaction](/docs/actions/wallet/sendTransaction): Creates, signs, and sends a new transaction to the network.
- [sendTransactionSync](/docs/actions/wallet/sendTransactionSync): Creates, signs, and sends a new transaction to the network synchronously.
- [signTransaction](/docs/actions/wallet/signTransaction): Signs a transaction.
- [Introduction to Test Actions](/docs/actions/test/introduction): A brief introduction on what Test Actions are in viem.
- [impersonateAccount](/docs/actions/test/impersonateAccount): Impersonate an account or contract address.
- [setBalance](/docs/actions/test/setBalance): Modifies the balance of an account.
- [setCode](/docs/actions/test/setCode): Modifies the bytecode stored at an account's address.
- [setNonce](/docs/actions/test/setNonce): Modifies (overrides) the nonce of an account.
- [setStorageAt](/docs/actions/test/setStorageAt): Writes to a slot of an account's storage.
- [stopImpersonatingAccount](/docs/actions/test/stopImpersonatingAccount): Stop impersonating an account after having previously used impersonateAccount.
- [getAutomine](/docs/actions/test/getAutomine): Returns the automatic mining status of the node.
- [increaseTime](/docs/actions/test/increaseTime): Jump forward in time by the given amount of time, in seconds.
- [mine](/docs/actions/test/mine): Mine a specified number of blocks.
- [removeBlockTimestampInterval](/docs/actions/test/removeBlockTimestampInterval): Removes setBlockTimestampInterval if it exists.
- [setAutomine](/docs/actions/test/setAutomine): Enables or disables the automatic mining of new blocks with each new transaction submitted to the network.
- [setIntervalMining](/docs/actions/test/setIntervalMining): Sets the automatic mining interval (in seconds) of blocks.
- [setBlockTimestampInterval](/docs/actions/test/setBlockTimestampInterval): Sets the block's timestamp interval.
- [setBlockGasLimit](/docs/actions/test/setBlockGasLimit): Sets the block's gas limit.
- [setNextBlockBaseFeePerGas](/docs/actions/test/setNextBlockBaseFeePerGas): Sets the next block's base fee per gas.
- [setNextBlockTimestamp](/docs/actions/test/setNextBlockTimestamp): Sets the next block's timestamp.
- [setCoinbase](/docs/actions/test/setCoinbase): Sets the coinbase address to be used in new blocks.
- [setMinGasPrice](/docs/actions/test/setMinGasPrice): Change the minimum gas price accepted by the network (in wei).
- [reset](/docs/actions/test/reset): Resets the fork back to its original state.
- [setLoggingEnabled](/docs/actions/test/setLoggingEnabled): Enable or disable logging on the test node network.
- [setRpcUrl](/docs/actions/test/setRpcUrl): Sets the backend RPC URL.
- [dumpState](/docs/actions/test/dumpState): Serializes the current state into a savable data blob.
- [loadState](/docs/actions/test/loadState): Adds state previously dumped to the current chain.
- [revert](/docs/actions/test/revert): Revert the state of the blockchain at the current block.
- [snapshot](/docs/actions/test/snapshot): Snapshot the state of the blockchain at the current block.
- [dropTransaction](/docs/actions/test/dropTransaction): Removes a transaction from the mempool.
- [getTxpoolContent](/docs/actions/test/getTxpoolContent): Returns the details of all transactions currently pending for inclusion in the next block(s).
- [getTxpoolStatus](/docs/actions/test/getTxpoolStatus): Returns a summary of all the transactions currently pending for inclusion in the next block(s).
- [inspectTxpool](/docs/actions/test/inspectTxpool): Returns a summary of all the transactions currently pending for inclusion in the next block(s).
- [sendUnsignedTransaction](/docs/actions/test/sendUnsignedTransaction): Executes a transaction regardless of the signature.
- [JSON-RPC Account](/docs/accounts/jsonRpc): A function to create a JSON-RPC Account.
- [Local Accounts (Private Key, Mnemonic, etc)](/docs/accounts/local)
- [privateKeyToAccount](/docs/accounts/local/privateKeyToAccount): A function to create a Private Key Account.
- [mnemonicToAccount](/docs/accounts/local/mnemonicToAccount): A function to create a Mnemonic Account.
- [hdKeyToAccount](/docs/accounts/local/hdKeyToAccount): A function to create a Hierarchical Deterministic (HD) Account.
- [toAccount](/docs/accounts/local/toAccount): A function to create a Custom Account.
- [createNonceManager](/docs/accounts/local/createNonceManager): Creates a Nonce Manager for automatic nonce generation
- [signMessage (Local Account)](/docs/accounts/local/signMessage): Signs a message with the Account's private key.
- [signTransaction (Local Account)](/docs/accounts/local/signTransaction): Signs a transaction with the Account's private key.
- [signTypedData (Local Account)](/docs/accounts/local/signTypedData): Signs typed data with the Account's private key.
- [Chains](/docs/chains/introduction)
- [Fees](/docs/chains/fees): Configure chain-based fee data in Viem
- [Formatters](/docs/chains/formatters): Configure chain-based formatters in Viem
- [Serializers](/docs/chains/serializers): Configure chain-based serializers in Viem
- [Celo](/docs/chains/celo): Integrating with Celo in Viem
- [Getting Started with OP Stack](/op-stack): Getting started with the OP Stack in Viem
- [Getting Started with ZKsync](/zksync): Getting started with the ZKsync in Viem
- [Contract Instances](/docs/contract/getContract): A Contract Instance is a type-safe interface for performing contract-related actions with a specific ABI and address, created by the getContract function.
- [createContractEventFilter](/docs/contract/createContractEventFilter): Creates a Filter to retrieve contract event logs.
- [deployContract](/docs/contract/deployContract): Deploys a contract to the network, given bytecode & constructor arguments.
- [estimateContractGas](/docs/contract/estimateContractGas): Estimates the gas required to successfully execute a contract write function call.
- [getCode](/docs/contract/getCode): Retrieves the bytecode at an address.
- [getContractEvents](/docs/contract/getContractEvents): Returns a list of event logs matching the provided parameters.
- [getStorageAt](/docs/contract/getStorageAt): Returns the value from a storage slot at a given address.
- [multicall](/docs/contract/multicall): Batches up multiple functions on a contract in a single call.
- [readContract](/docs/contract/readContract): Calls a read-only function on a contract, and returns the response.
- [simulateContract](/docs/contract/simulateContract): Simulates & validates a contract interaction.
- [writeContract](/docs/contract/writeContract): Executes a write function on a contract.
- [writeContractSync](/docs/contract/writeContractSync): Executes a write function on a contract synchronously.
- [watchContractEvent](/docs/contract/watchContractEvent): Watches and returns emitted contract event logs.
- [decodeDeployData](/docs/contract/decodeDeployData): Decodes ABI encoded deploy data (bytecode & arguments).
- [decodeErrorResult](/docs/contract/decodeErrorResult): Decodes reverted error from a contract function call.
- [decodeEventLog](/docs/contract/decodeEventLog): Decodes ABI encoded event topics & data.
- [decodeFunctionData](/docs/contract/decodeFunctionData): Decodes ABI encoded data (4 byte selector & arguments) into a function name and arguments.
- [decodeFunctionResult](/docs/contract/decodeFunctionResult): Decodes the result of a function call on a contract.
- [encodeDeployData](/docs/contract/encodeDeployData): Encodes deploy data (bytecode & constructor args) into an ABI encoded value.
- [encodeErrorResult](/docs/contract/encodeErrorResult): Encodes a reverted error from a function call.
- [encodeEventTopics](/docs/contract/encodeEventTopics): Encodes an event (with optional arguments) into filter topics.
- [encodeFunctionData](/docs/contract/encodeFunctionData): Encodes the function name and parameters into an ABI encoded value (4 byte selector & arguments).
- [encodeFunctionResult](/docs/contract/encodeFunctionResult): Encodes structured return data into ABI encoded data.
- [parseEventLogs](/docs/contract/parseEventLogs): Extracts & decodes logs from a set of opaque logs.
- [getEnsAddress](/docs/ens/actions/getEnsAddress): Gets address for ENS name.
- [getEnsAvatar](/docs/ens/actions/getEnsAvatar): Gets the avatar of an ENS name.
- [getEnsName](/docs/ens/actions/getEnsName): Gets primary name for specified address.
- [getEnsResolver](/docs/ens/actions/getEnsResolver): Gets resolver for ENS name.
- [getEnsText](/docs/ens/actions/getEnsText): Gets a text record for specified ENS name.
- [labelhash](/docs/ens/utilities/labelhash): Hashes ENS label.
- [namehash](/docs/ens/utilities/namehash): Hashes ENS name.
- [normalize](/docs/ens/utilities/normalize): Normalizes ENS name to UTS46.
- [verifySiweMessage](/docs/siwe/actions/verifySiweMessage): Verifies EIP-4361 formatted message was signed.
- [createSiweMessage](/docs/siwe/utilities/createSiweMessage): Creates EIP-4361 formatted message.
- [generateSiweNonce](/docs/siwe/utilities/generateSiweNonce): Generates random EIP-4361 nonce.
- [parseSiweMessage](/docs/siwe/utilities/parseSiweMessage): Parses EIP-4361 formatted message into message fields object.
- [validateSiweMessage](/docs/siwe/utilities/validateSiweMessage): Validates EIP-4361 message.
- [decodeAbiParameters](/docs/abi/decodeAbiParameters): Decodes ABI encoded data.
- [encodeAbiParameters](/docs/abi/encodeAbiParameters): Generates ABI encoded data.
- [encodePacked](/docs/abi/encodePacked): Generates ABI encoded data.
- [getAbiItem](/docs/abi/getAbiItem): Retrieves an item from the ABI array.
- [parseAbi](/docs/abi/parseAbi): Parses human-readable ABI into JSON.
- [parseAbiItem](/docs/abi/parseAbiItem): Parses human-readable ABI item (e.g. error, event, function) into ABI item.
- [parseAbiParameter](/docs/abi/parseAbiParameter): Parses human-readable ABI parameter into ABI parameter.
- [parseAbiParameters](/docs/abi/parseAbiParameters): Parses human-readable ABI parameters into ABI parameters.
- [getDelegation](/docs/eip7702/getDelegation): Returns the address an account has delegated to via EIP-7702.
- [prepareAuthorization](/docs/eip7702/prepareAuthorization): Prepares an EIP-7702 Authorization for signing.
- [signAuthorization](/docs/eip7702/signAuthorization): Signs an EIP-7702 Authorization object.
- [hashAuthorization](/docs/eip7702/hashAuthorization): Calculates an Authorization object hash in EIP-7702 format.
- [recoverAuthorizationAddress](/docs/eip7702/recoverAuthorizationAddress): Recovers the original signing address from a signed Authorization object.
- [verifyAuthorization](/docs/eip7702/verifyAuthorization): Verifies that an Authorization object was signed by the provided address.
- [getAddress](/docs/utilities/getAddress): Converts an address into an address that is checksum encoded.
- [getContractAddress](/docs/utilities/getContractAddress): Retrieves a contract address.
- [isAddress](/docs/utilities/isAddress): Checks if the address is valid.
- [isAddressEqual](/docs/utilities/isAddressEqual): Checks if the given addresses (checksummed) are equal.
- [blobsToProofs](/docs/utilities/blobsToProofs): Compute the proofs for a list of blobs and their commitments.
- [blobsToCommitments](/docs/utilities/blobsToCommitments): Compute commitments from a list of blobs.
- [commitmentsToVersionedHashes](/docs/utilities/commitmentsToVersionedHashes): Transform a list of commitments to their versioned hashes.
- [commitmentToVersionedHash](/docs/utilities/commitmentToVersionedHash): Transform a commitment to it's versioned hash.
- [fromBlobs](/docs/utilities/fromBlobs): Transforms blobs into the originating data.
- [sidecarsToVersionedHashes](/docs/utilities/sidecarsToVersionedHashes): Transforms a list of sidecars to their versioned hashes.
- [toBlobs](/docs/utilities/toBlobs): Transforms arbitrary data into blobs.
- [toBlobSidecars](/docs/utilities/toBlobSidecars): Transforms arbitrary data into blob sidecars.
- [extractChain](/docs/utilities/extractChain)
- [concat](/docs/utilities/concat): Concatenates a set of hex values or byte arrays.
- [isBytes](/docs/utilities/isBytes): Checks whether the value is a byte array or not.
- [isHex](/docs/utilities/isHex): Checks whether the value is a hex value or not.
- [pad](/docs/utilities/pad): Pads a hex value or byte array with leading or trailing zeros.
- [slice](/docs/utilities/slice): Returns a section of the hex or byte array given a start/end bytes offset.
- [size](/docs/utilities/size): Retrieves the size of the value (in bytes).
- [trim](/docs/utilities/trim): Trims the leading or trailing zero byte data from a hex value or byte array.
- [fromBytes](/docs/utilities/fromBytes): Decodes a byte array to a string, hex value, boolean or number.
- [fromHex](/docs/utilities/fromHex): Decodes a hex value to a string, number or byte array.
- [fromRlp](/docs/utilities/fromRlp): Decodes a RLP value into a decoded hex value or byte array.
- [toBytes](/docs/utilities/toBytes): Encodes a string, hex value, number or boolean to a byte array.
- [toHex](/docs/utilities/toHex): Encodes a string, number, boolean or byte array to a hex value.
- [toRlp](/docs/utilities/toRlp): Encodes a hex value or byte array into a RLP encoded value.
- [isHash](/docs/utilities/isHash): Checks if a string is a valid 32-byte hex hash.
- [keccak256](/docs/utilities/keccak256): Calculates the Keccak256 hash of a byte array.
- [ripemd160](/docs/utilities/ripemd160): Calculates the Ripemd160 hash of a byte array.
- [sha256](/docs/utilities/sha256): Calculates the Sha256 hash of a byte array.
- [toEventHash](/docs/utilities/toEventHash): Returns the hash (of the event signature) for a given event definition.
- [toEventSelector](/docs/utilities/toEventSelector): Returns the event selector for a given event definition.
- [toEventSignature](/docs/utilities/toEventSignature): Returns the signature for a given event or event definition.
- [toFunctionHash](/docs/utilities/toFunctionHash): Returns the hash (of the function signature) for a given function definition.
- [toFunctionSelector](/docs/utilities/toFunctionSelector): Returns the function selector (4 byte encoding) for a given function definition.
- [toFunctionSignature](/docs/utilities/toFunctionSignature): Returns the signature for a given function definition.
- [setupKzg](/docs/utilities/setupKzg): Sets up and returns a KZG interface.
- [compactSignatureToSignature](/docs/utilities/compactSignatureToSignature): Parses a compact signature into signature format.
- [hashMessage](/docs/utilities/hashMessage): Hashes a message in EIP-191 format.
- [hashTypedData](/docs/utilities/hashTypedData): Hashes EIP-712 typed data.
- [isErc6492Signature](/docs/utilities/isErc6492Signature): Checks whether the signature is in ERC-6492 format.
- [parseCompactSignature](/docs/utilities/parseCompactSignature): Parses a hex formatted compact signature into a structured compact signature.
- [parseErc6492Signature](/docs/utilities/parseErc6492Signature): Parses a hex-formatted ERC-6492 flavoured signature.
- [parseSignature](/docs/utilities/parseSignature): Parses a hex formatted signature into a structured signature.
- [recoverAddress](/docs/utilities/recoverAddress): Recovers the signing address from a hash & signature.
- [recoverMessageAddress](/docs/utilities/recoverMessageAddress): Recovers the signing address from a message & signature.
- [recoverPublicKey](/docs/utilities/recoverPublicKey): Recovers the signing public key from a hash & signature.
- [recoverTransactionAddress](/docs/utilities/recoverTransactionAddress): Recovers the signing address from a transaction & signature.
- [recoverTypedDataAddress](/docs/utilities/recoverTypedDataAddress): Recovers the signing address from EIP-712 typed data & signature.
- [serializeCompactSignature](/docs/utilities/serializeCompactSignature): Serializes a compact signature into hex format.
- [serializeErc6492Signature](/docs/utilities/serializeErc6492Signature): Serializes a ERC-6492 flavoured signature into hex format.
- [serializeSignature](/docs/utilities/serializeSignature): Serializes a structured signature into hex format.
- [signatureToCompactSignature](/docs/utilities/signatureToCompactSignature): Parses a signature into a compact signature.
- [verifyMessage](/docs/utilities/verifyMessage): Verifies if a signed message was generated by the provided address.
- [verifyTypedData](/docs/utilities/verifyTypedData): Verifies a typed data signature
- [parseTransaction](/docs/utilities/parseTransaction): Converts a serialized transaction to a structured transaction.
- [serializeTransaction](/docs/utilities/serializeTransaction): Serializes a transaction object.
- [formatEther](/docs/utilities/formatEther): Converts numerical wei to a string representation of ether.
- [formatGwei](/docs/utilities/formatGwei): Converts numerical wei to a string representation of gwei.
- [formatUnits](/docs/utilities/formatUnits): Divides a number by a given exponent of base 10, and formats it into a string representation of the number.
- [parseEther](/docs/utilities/parseEther): Converts a string representation of ether to numerical wei.
- [parseGwei](/docs/utilities/parseGwei): Converts a string representation of gwei to numerical wei.
- [parseUnits](/docs/utilities/parseUnits): Multiplies a string representation of a number by a given exponent of base 10.
- [Terms](/docs/glossary/terms): Glossary of Terms in viem.
- [Types](/docs/glossary/types): Glossary of Types in viem.
- [Errors](/docs/glossary/errors): Glossary of Errors in viem.
- [Getting Started with Account Abstraction](/account-abstraction): Getting Started with Account Abstraction in Viem
- [Sending User Operations](/account-abstraction/guides/sending-user-operations)
- [Bundler Client](/account-abstraction/clients/bundler): A function to create a Bundler Client.
- [Paymaster Client](/account-abstraction/clients/paymaster): A function to create a Paymaster Client.
- [Smart Accounts](/account-abstraction/accounts/smart)
- [Coinbase Smart Wallet](/account-abstraction/accounts/smart/toCoinbaseSmartAccount)
- [MetaMask Smart Account](/account-abstraction/accounts/smart/toMetaMaskSmartAccount)
- [Thirdweb Smart Account](/account-abstraction/accounts/smart/toThirdwebSmartAccount)
- [Nexus Smart Account](/account-abstraction/accounts/smart/toNexusSmartAccount)
- [Light Smart Account](/account-abstraction/accounts/smart/toLightSmartAccount)
- [Kernel (ZeroDev) Smart Account](/account-abstraction/accounts/smart/toEcdsaKernelSmartAccount)
- [Safe Smart Account](/account-abstraction/accounts/smart/toSafeSmartAccount)
- [Simple Smart Account](/account-abstraction/accounts/smart/toSimpleSmartAccount)
- [Solady Smart Account](/account-abstraction/accounts/smart/toSoladySmartAccount)
- [Trust Smart Account](/account-abstraction/accounts/smart/toTrustSmartAccount)
- [toSmartAccount](/account-abstraction/accounts/smart/toSmartAccount): Creates a Smart Account with a provided Account Implementation.
- [signMessage (Smart Account)](/account-abstraction/accounts/smart/signMessage)
- [signTypedData (Smart Account)](/account-abstraction/accounts/smart/signTypedData)
- [signUserOperation (Smart Account)](/account-abstraction/accounts/smart/signUserOperation)
- [WebAuthn Account](/account-abstraction/accounts/webauthn)
- [toWebAuthnAccount](/account-abstraction/accounts/webauthn/toWebAuthnAccount)
- [createWebAuthnCredential](/account-abstraction/accounts/webauthn/createWebAuthnCredential)
- [estimateUserOperationGas](/account-abstraction/actions/bundler/estimateUserOperationGas): Estimates the gas values for a User Operation to be executed successfully.
- [getChainId](/account-abstraction/actions/bundler/getChainId): Returns the chain ID associated with the bundler
- [getSupportedEntryPoints](/account-abstraction/actions/bundler/getSupportedEntryPoints): Returns the EntryPoints that the bundler supports.
- [getUserOperation](/account-abstraction/actions/bundler/getUserOperation): Retrieves information about a User Operation given a hash.
- [getUserOperationReceipt](/account-abstraction/actions/bundler/getUserOperationReceipt): Returns the User Operation receipt given a User Operation hash.
- [prepareUserOperation](/account-abstraction/actions/bundler/prepareUserOperation): Prepares a User Operation for execution and fills in missing properties.
- [sendUserOperation](/account-abstraction/actions/bundler/sendUserOperation): Broadcasts a User Operation to the Bundler.
- [waitForUserOperationReceipt](/account-abstraction/actions/bundler/waitForUserOperationReceipt): Waits for the User Operation to be included on a Block, and then returns the User Operation receipt.
- [getPaymasterData](/account-abstraction/actions/paymaster/getPaymasterData): Retrieves paymaster-related properties to be used for the User Operation.
- [getPaymasterStubData](/account-abstraction/actions/paymaster/getPaymasterStubData): Retrieves paymaster-related properties to be used for the User Operation.
- [Getting Started](/experimental): Getting started with experimental features in Viem
- [Extending Client with ERC-7715](/experimental/erc7715/client): Setting up your Viem Client
- [grantPermissions](/experimental/erc7715/grantPermissions): Request permissions from a wallet to perform actions on behalf of a user.
- [Extending Client with ERC-7739 Actions](/experimental/erc7739/client): Setting up your Viem Client
- [signMessage](/experimental/erc7739/signMessage): Signs a personal sign message via Solady's ERC-1271 format.
- [signTypedData](/experimental/erc7739/signTypedData): Signs typed data via Solady's ERC-1271 format.
- [hashMessage](/experimental/erc7739/hashMessage): Hashes an EIP-191 message via ERC-7739 format.
- [hashTypedData](/experimental/erc7739/hashTypedData): Hashes EIP-712 typed data via Solady's ERC-1271 format.
- [wrapTypedDataSignature](/experimental/erc7739/wrapTypedDataSignature)
- [Extending Client with ERC-7811 Actions](/experimental/erc7811/client): Setting up your Viem Client
- [getAssets](/experimental/erc7811/getAssets): Requests to get assets for an account from a Wallet.
- [Extending Client with ERC-7821 Actions](/experimental/erc7821/client): Setting up your Viem Client
- [execute](/experimental/erc7821/execute): Executes call(s) using the `execute` function on an ERC-7821-compatible contract.
- [executeBatches](/experimental/erc7821/executeBatches): Executes batches of call(s) on an ERC-7821-compatible contract.
- [supportsExecutionMode](/experimental/erc7821/supportsExecutionMode): Checks if the contract supports the ERC-7821 execution mode.
- [Extending Client with ERC-7846 Actions](/experimental/erc7846/client): Setting up your Viem Client
- [connect](/experimental/erc7846/connect): Requests to connect Account(s).
- [disconnect](/experimental/erc7846/disconnect): Requests to disconnect account(s).
- [Extending Client with ERC-7895 Actions](/experimental/erc7895/client): Setting up your Viem Client
- [addSubAccount](/experimental/erc7895/addSubAccount): Requests to add a Sub Account.
- [Client](/op-stack/client): Setting up your Viem Client with the OP Stack
- [Chains](/op-stack/chains)
- [Deposits](/op-stack/guides/deposits)
- [Withdrawals](/op-stack/guides/withdrawals)
- [buildDepositTransaction](/op-stack/actions/buildDepositTransaction): Builds & prepares parameters for a deposit transaction to be initiated on an L1 and executed on the L2.
- [buildProveWithdrawal](/op-stack/actions/buildProveWithdrawal): Builds the transaction that proves a withdrawal was initiated on an L2.
- [estimateContractL1Fee](/op-stack/actions/estimateContractL1Fee): Estimates the L1 fee to execute an L2 contract write.
- [estimateContractL1Gas](/op-stack/actions/estimateContractL1Gas): Estimates the L1 gas to execute an L2 contract write.
- [estimateContractTotalFee](/op-stack/actions/estimateContractTotalFee): Estimates the total (L1 + L2) fee to execute an L2 contract write.
- [estimateContractTotalGas](/op-stack/actions/estimateContractTotalGas): Estimates the total (L1 + L2) gas to execute an L2 contract write.
- [estimateInitiateWithdrawalGas](/op-stack/actions/estimateInitiateWithdrawalGas): Estimates gas required to initiate a withdrawal on an L2 to the L1.
- [estimateL1Fee](/op-stack/actions/estimateL1Fee): Estimates the L1 fee to execute an L2 transaction.
- [estimateL1Gas](/op-stack/actions/estimateL1Gas): Estimates the amount of L1 gas required to execute an L2 transaction
- [estimateOperatorFee](/op-stack/actions/estimateOperatorFee): Estimates the operator fee to execute an L2 transaction.
- [estimateTotalFee](/op-stack/actions/estimateTotalFee): Estimates the L1 + L2 + operator fee to execute an L2 transaction.
- [estimateTotalGas](/op-stack/actions/estimateTotalGas): Estimates the amount of L1 + L2 gas required to execute an L2 transaction
- [initiateWithdrawal](/op-stack/actions/initiateWithdrawal): Initiates a withdrawal on an L2 to the L1.
- [buildInitiateWithdrawal](/op-stack/actions/buildInitiateWithdrawal): Builds & prepares parameters for a withdrawal to be initiated on an L2.
- [estimateDepositTransactionGas](/op-stack/actions/estimateDepositTransactionGas): Estimates gas to initiate a deposit transaction on an L1, which executes a transaction on an L2.
- [estimateFinalizeWithdrawalGas](/op-stack/actions/estimateFinalizeWithdrawalGas): Estimates gas required to finalize a withdrawal that occurred on an L2.
- [estimateProveWithdrawalGas](/op-stack/actions/estimateProveWithdrawalGas): Estimates gas required to prove a withdrawal that occurred on an L2.
- [getGame](/op-stack/actions/getGame): Retrieves a valid dispute game on an L2 that occurred after a provided L2 block number.
- [getGames](/op-stack/actions/getGames): Retrieves dispute games for an L2.
- [getL2Output](/op-stack/actions/getL2Output): Retrieves the first L2 output proposal that occurred after a provided block number.
- [getTimeToFinalize](/op-stack/actions/getTimeToFinalize): Returns the time until the withdrawal transaction can be finalized.
- [getTimeToNextGame](/op-stack/actions/getTimeToNextGame): Returns the time until the next L2 dispute game is submitted.
- [getTimeToNextL2Output](/op-stack/actions/getTimeToNextL2Output): Builds & prepares parameters for a withdrawal to be initiated on an L2.
- [getTimeToProve](/op-stack/actions/getTimeToProve): Gets time until the L2 withdrawal transaction is ready to be proved.
- [getWithdrawalStatus](/op-stack/actions/getWithdrawalStatus): Returns the current status of a withdrawal.
- [waitForNextGame](/op-stack/actions/waitForNextGame): Waits for the next dispute game to be submitted.
- [waitForNextL2Output](/op-stack/actions/waitForNextL2Output): Waits for the next L2 output (after the provided block number) to be submitted.
- [waitToFinalize](/op-stack/actions/waitToFinalize): Waits until the withdrawal transaction can be finalized.
- [waitToProve](/op-stack/actions/waitToProve): Waits until the L2 withdrawal transaction is ready to be proved.
- [depositTransaction](/op-stack/actions/depositTransaction): Initiates a deposit transaction on an L1, which executes a transaction on an L2.
- [finalizeWithdrawal](/op-stack/actions/finalizeWithdrawal): Finalizes a withdrawal that occurred on an L2.
- [proveWithdrawal](/op-stack/actions/proveWithdrawal): Proves a withdrawal that occurred on an L2.
- [extractTransactionDepositedLogs](/op-stack/utilities/extractTransactionDepositedLogs): Extracts "TransactionDeposited" logs from an opaque array of logs.
- [extractWithdrawalMessageLogs](/op-stack/utilities/extractWithdrawalMessageLogs): Extracts "MessagePassed" logs from a withdrawal initialization from an opaque array of logs.
- [getL2TransactionHash](/op-stack/utilities/getL2TransactionHash): Computes the L2 transaction hash from an L1 "TransactionDeposited" log.
- [getL2TransactionHashes](/op-stack/utilities/getL2TransactionHashes): Computes the L2 transaction hashes from an array of L1 "TransactionDeposited" logs.
- [getWithdrawals](/op-stack/utilities/getWithdrawals): Gets the messages from a withdrawal initialization.
- [getSourceHash](/op-stack/utilities/getSourceHash): Computes source hash of a deposit transaction.
- [opaqueDataToDepositData](/op-stack/utilities/opaqueDataToDepositData): Converts opaque data into a structured deposit data format.
- [getWithdrawalHashStorageSlot](/op-stack/utilities/getWithdrawalHashStorageSlot): Computes the withdrawal hash storage slot to be used when proving a withdrawal.
- [parseTransaction (OP Stack)](/op-stack/utilities/parseTransaction): Converts a serialized transaction to a structured transaction, with support for OP Stack.
- [serializeTransaction (OP Stack)](/op-stack/utilities/serializeTransaction): Serializes a transaction object, with support for OP Stack.
- [USDC (Circle)](/circle-usdc)
- [Integrating USDC into Your Application](/circle-usdc/guides/integrating)
- [Cross-Chain USDC Transfers](/circle-usdc/guides/cross-chain)
- [Cross Chain USDC Transfers with Bridge Kit](/circle-usdc/guides/bridge-kit)
- [Cross Chain USDC Transfers (CCTP Integration)](/circle-usdc/guides/manual-cctp)
- [Gasless USDC Transfers with Circle Paymaster](/circle-usdc/guides/paymaster)
- [Circle Smart Account](/circle-usdc/guides/smart-account)
- [Getting Started](/tempo/)
- [Chains](/tempo/chains)
- [Guides](/tempo/guides/): Task-oriented guides for building common Tempo features with Viem.
- [Create an Account](/tempo/guides/accounts/create): Create a Tempo Account from a private key, passkey, or device-bound key, and use it with a Viem client.
- [Sign In with a Passkey](/tempo/guides/accounts/passkeys): Create and restore WebAuthn passkey accounts for non-custodial browser sign-in on Tempo.
- [Use the Tempo Accounts SDK](/tempo/guides/accounts/accounts-sdk): Connect a Tempo account with the Tempo Accounts SDK and drive it with Viem and Tempo Actions.
- [Tempo Transactions](/tempo/transactions): Send your first Tempo Transaction with Viem, and discover the payment-native features they unlock.
- [Batch Calls](/tempo/guides/batch-calls): Bundle multiple operations into a single atomic Tempo Transaction.
- [Concurrent Transactions](/tempo/guides/concurrent-transactions): Send multiple Tempo Transactions in parallel using concurrent nonces.
- [Scheduled Transactions](/tempo/guides/scheduled-transactions): Sign a Tempo Transaction now and define when it can execute onchain.
- [Pay Fees in a Stablecoin](/tempo/guides/pay-fees): Pay Tempo transaction fees in any USD-denominated TIP-20 stablecoin.
- [Sponsor User Fees](/tempo/guides/sponsor-fees): Sponsor transaction fees on behalf of your users for a gasless experience on Tempo.
- [Create a TIP-20 Token](/tempo/guides/create-token): Deploy a TIP-20 stablecoin on Tempo and read its onchain metadata.
- [Mint & Burn Tokens](/tempo/guides/manage-token-balances): Mint and burn TIP-20 token supply on Tempo.
- [Transfer Tokens](/tempo/guides/transfer-tokens): Transfer TIP-20 tokens, authorize spenders, and read balances on Tempo.
- [Manage Token Roles & Supply](/tempo/guides/manage-token-roles): Grant and revoke TIP-20 roles, cap supply, and pause transfers on Tempo.
- [Configure Transfer Policies](/tempo/guides/transfer-policies): Restrict which accounts can send or receive a TIP-20 token with a transfer policy.
- [Distribute Token Rewards](/tempo/guides/token-rewards): Distribute rewards to TIP-20 holders and let them claim their share on Tempo.
- [Access Keys](/tempo/guides/access-keys/): Delegate signing to a secondary key with access keys, with spending limits, scopes, admin keys, and signature verification.
- [Authorize Access Keys](/tempo/guides/access-keys/authorize): Authorize an access key to sign transactions on behalf of an account, and defer authorization to a transaction.
- [Set Permissions & Limits](/tempo/guides/access-keys/permissions): Restrict an access key with an expiry, per-token spending limits, recurring limits, and call scopes.
- [Manage Access Keys](/tempo/guides/access-keys/manage): Update spending limits, revoke access keys, and inspect their onchain metadata and remaining limits.
- [Admin Access Keys](/tempo/guides/access-keys/admin): Authorize unrestricted admin access keys that can manage an account's other keys, and check admin status.
- [Witnesses](/tempo/guides/access-keys/witnesses): Bind a witness to a key authorization and burn it to revoke signed-but-not-yet-submitted authorizations.
- [Verify Signatures](/tempo/guides/access-keys/verify): Verify that a keychain signature was produced by an active access key for the expected account.
- [Stablecoin Exchange](/tempo/guides/stablecoin-exchange/): Trade stablecoins on Tempo's enshrined DEX, manage orders and balances, create trading pairs, and provide Fee AMM liquidity.
- [Swap Stablecoins](/tempo/guides/stablecoin-exchange/swap): Quote and swap one USD-denominated TIP-20 stablecoin for another on Tempo's enshrined DEX.
- [Place & Manage Orders](/tempo/guides/stablecoin-exchange/orders): Place limit and flip orders on Tempo's Stablecoin DEX, then read, inspect, and cancel them.
- [Manage Exchange Balances](/tempo/guides/stablecoin-exchange/balances): Read your internal Stablecoin DEX balances and withdraw them back to your Tempo wallet.
- [Create a Trading Pair](/tempo/guides/stablecoin-exchange/create-pair): Create a new trading pair on Tempo's Stablecoin DEX and configure a token's quote token.
- [Provide Fee AMM Liquidity](/tempo/guides/stablecoin-exchange/fee-amm-liquidity): Add and remove liquidity in Tempo's Fee AMM so stablecoin fee conversions can settle.
- [Virtual Addresses](/tempo/guides/virtual-addresses/): Register a master address and accept TIP-20 deposits at unlimited virtual addresses that forward to you without sweeps.
- [Register a Master Address](/tempo/guides/virtual-addresses/register): Mine a TIP-1022 proof-of-work salt and register a master address for virtual-address deposit forwarding.
- [Resolve & Accept Payments](/tempo/guides/virtual-addresses/resolve): Derive per-customer virtual deposit addresses offchain and resolve them to your master wallet.
- [Receive Policies](/tempo/guides/receive-policies/): Control who can pay you on Tempo with receive policies, validate inbound transfers, and recover blocked funds.
- [Set a Receive Policy](/tempo/guides/receive-policies/set): Set and read an account's receive policy to control which senders and tokens it accepts.
- [Validate Transfers](/tempo/guides/receive-policies/validate): Check whether a TIP-20 transfer would be accepted by a recipient's receive policy before sending it.
- [Handle Blocked Funds](/tempo/guides/receive-policies/blocked): Read, claim, and burn TIP-20 funds that a receive policy blocked from being credited.
- [Payment Channels](/tempo/guides/payment-channels/): Open funded TIP-20 channels on Tempo, stream off-chain vouchers, and settle or close to move funds onchain.
- [Open & Fund a Channel](/tempo/guides/payment-channels/open): Open and fund a TIP-20 payment channel on Tempo, top it up, and read its onchain state.
- [Send & Settle Vouchers](/tempo/guides/payment-channels/vouchers): Sign off-chain TIP-20 channel vouchers as the payer and settle them onchain as the payee.
- [Close & Withdraw](/tempo/guides/payment-channels/close): Close a TIP-20 payment channel from either side and withdraw the remaining deposit on Tempo.
- [Private Zones](/tempo/guides/zones/): Connect to private Tempo Zones, deposit funds into them, and withdraw back to Tempo Mainnet.
- [Connect to a Zone](/tempo/guides/zones/connect): Connect a Viem client to a private Tempo Zone and authenticate with an authorization token.
- [Deposit to a Zone](/tempo/guides/zones/deposit): Deposit TIP-20 stablecoins from Tempo Mainnet into a private Tempo Zone.
- [Withdraw from a Zone](/tempo/guides/zones/withdraw): Withdraw TIP-20 stablecoins from a private Tempo Zone back to Tempo Mainnet.
- [Accounts](/tempo/accounts/)
- [Account.fromSecp256k1](/tempo/accounts/account.fromSecp256k1)
- [Account.fromP256](/tempo/accounts/account.fromP256)
- [Account.fromWebAuthnP256](/tempo/accounts/account.fromWebAuthnP256)
- [Account.fromWebCryptoP256](/tempo/accounts/account.fromWebCryptoP256)
- [Overview](/tempo/actions/)
- [accessKey.authorize](/tempo/actions/accessKey.authorize)
- [accessKey.burnWitness](/tempo/actions/accessKey.burnWitness)
- [accessKey.getMetadata](/tempo/actions/accessKey.getMetadata)
- [accessKey.getRemainingLimit](/tempo/actions/accessKey.getRemainingLimit)
- [accessKey.isAdmin](/tempo/actions/accessKey.isAdmin)
- [accessKey.isWitnessBurned](/tempo/actions/accessKey.isWitnessBurned)
- [accessKey.revoke](/tempo/actions/accessKey.revoke)
- [accessKey.signAuthorization](/tempo/actions/accessKey.signAuthorization)
- [accessKey.updateLimit](/tempo/actions/accessKey.updateLimit)
- [accessKey.verifyHash](/tempo/actions/accessKey.verifyHash)
- [accessKey.watchAdminAuthorized](/tempo/actions/accessKey.watchAdminAuthorized)
- [accessKey.watchWitness](/tempo/actions/accessKey.watchWitness)
- [accessKey.watchWitnessBurned](/tempo/actions/accessKey.watchWitnessBurned)
- [amm.burn](/tempo/actions/amm.burn)
- [amm.getLiquidityBalance](/tempo/actions/amm.getLiquidityBalance)
- [amm.getPool](/tempo/actions/amm.getPool)
- [amm.mint](/tempo/actions/amm.mint)
- [amm.rebalanceSwap](/tempo/actions/amm.rebalanceSwap)
- [amm.watchBurn](/tempo/actions/amm.watchBurn)
- [amm.watchMint](/tempo/actions/amm.watchMint)
- [amm.watchRebalanceSwap](/tempo/actions/amm.watchRebalanceSwap)
- [channel.close](/tempo/actions/channel.close)
- [channel.getStates](/tempo/actions/channel.getStates)
- [channel.open](/tempo/actions/channel.open)
- [channel.requestClose](/tempo/actions/channel.requestClose)
- [channel.settle](/tempo/actions/channel.settle)
- [channel.signVoucher](/tempo/actions/channel.signVoucher)
- [channel.topUp](/tempo/actions/channel.topUp)
- [channel.withdraw](/tempo/actions/channel.withdraw)
- [fee.getUserToken](/tempo/actions/fee.getUserToken)
- [fee.setUserToken](/tempo/actions/fee.setUserToken)
- [fee.watchSetUserToken](/tempo/actions/fee.watchSetUserToken)
- [nonce.getNonce](/tempo/actions/nonce.getNonce)
- [nonce.watchNonceIncremented](/tempo/actions/nonce.watchNonceIncremented)
- [policy.create](/tempo/actions/policy.create)
- [policy.getData](/tempo/actions/policy.getData)
- [policy.isAuthorized](/tempo/actions/policy.isAuthorized)
- [policy.modifyBlacklist](/tempo/actions/policy.modifyBlacklist)
- [policy.modifyWhitelist](/tempo/actions/policy.modifyWhitelist)
- [policy.setAdmin](/tempo/actions/policy.setAdmin)
- [policy.watchAdminUpdated](/tempo/actions/policy.watchAdminUpdated)
- [policy.watchBlacklistUpdated](/tempo/actions/policy.watchBlacklistUpdated)
- [policy.watchCreate](/tempo/actions/policy.watchCreate)
- [policy.watchWhitelistUpdated](/tempo/actions/policy.watchWhitelistUpdated)
- [receivePolicy.burn](/tempo/actions/receivePolicy.burn)
- [receivePolicy.claim](/tempo/actions/receivePolicy.claim)
- [receivePolicy.get](/tempo/actions/receivePolicy.get)
- [receivePolicy.getBlockedBalance](/tempo/actions/receivePolicy.getBlockedBalance)
- [receivePolicy.set](/tempo/actions/receivePolicy.set)
- [receivePolicy.validate](/tempo/actions/receivePolicy.validate)
- [receivePolicy.watchBlocked](/tempo/actions/receivePolicy.watchBlocked)
- [receivePolicy.watchBurned](/tempo/actions/receivePolicy.watchBurned)
- [receivePolicy.watchClaimed](/tempo/actions/receivePolicy.watchClaimed)
- [receivePolicy.watchUpdated](/tempo/actions/receivePolicy.watchUpdated)
- [faucet.fund](/tempo/actions/faucet.fund)
- [reward.claim](/tempo/actions/reward.claim)
- [reward.distribute](/tempo/actions/reward.distribute)
- [reward.getGlobalRewardPerToken](/tempo/actions/reward.getGlobalRewardPerToken)
- [reward.getPendingRewards](/tempo/actions/reward.getPendingRewards)
- [reward.getUserRewardInfo](/tempo/actions/reward.getUserRewardInfo)
- [reward.setRecipient](/tempo/actions/reward.setRecipient)
- [reward.watchRewardDistributed](/tempo/actions/reward.watchRewardDistributed)
- [reward.watchRewardRecipientSet](/tempo/actions/reward.watchRewardRecipientSet)
- [simulate.simulateBlocks](/tempo/actions/simulate.simulateBlocks)
- [simulate.simulateCalls](/tempo/actions/simulate.simulateCalls)
- [dex.buy](/tempo/actions/dex.buy)
- [dex.cancel](/tempo/actions/dex.cancel)
- [dex.cancelStale](/tempo/actions/dex.cancelStale)
- [dex.createPair](/tempo/actions/dex.createPair)
- [dex.getBalance](/tempo/actions/dex.getBalance)
- [dex.getBuyQuote](/tempo/actions/dex.getBuyQuote)
- [dex.getOrder](/tempo/actions/dex.getOrder)
- [dex.getTickLevel](/tempo/actions/dex.getTickLevel)
- [dex.getSellQuote](/tempo/actions/dex.getSellQuote)
- [dex.place](/tempo/actions/dex.place)
- [dex.placeFlip](/tempo/actions/dex.placeFlip)
- [dex.sell](/tempo/actions/dex.sell)
- [dex.watchFlipOrderPlaced](/tempo/actions/dex.watchFlipOrderPlaced)
- [dex.watchOrderCancelled](/tempo/actions/dex.watchOrderCancelled)
- [dex.watchOrderFilled](/tempo/actions/dex.watchOrderFilled)
- [dex.watchOrderPlaced](/tempo/actions/dex.watchOrderPlaced)
- [dex.withdraw](/tempo/actions/dex.withdraw)
- [token.approve](/tempo/actions/token.approve)
- [token.burn](/tempo/actions/token.burn)
- [token.burnBlocked](/tempo/actions/token.burnBlocked)
- [token.changeTransferPolicy](/tempo/actions/token.changeTransferPolicy)
- [token.create](/tempo/actions/token.create)
- [token.getAllowance](/tempo/actions/token.getAllowance)
- [token.getBalance](/tempo/actions/token.getBalance)
- [token.getMetadata](/tempo/actions/token.getMetadata)
- [token.grantRoles](/tempo/actions/token.grantRoles)
- [token.hasRole](/tempo/actions/token.hasRole)
- [token.mint](/tempo/actions/token.mint)
- [token.pause](/tempo/actions/token.pause)
- [token.renounceRoles](/tempo/actions/token.renounceRoles)
- [token.revokeRoles](/tempo/actions/token.revokeRoles)
- [token.setRoleAdmin](/tempo/actions/token.setRoleAdmin)
- [token.setSupplyCap](/tempo/actions/token.setSupplyCap)
- [token.transfer](/tempo/actions/token.transfer)
- [token.unpause](/tempo/actions/token.unpause)
- [token.watchAdminRole](/tempo/actions/token.watchAdminRole)
- [token.watchApprove](/tempo/actions/token.watchApprove)
- [token.watchBurn](/tempo/actions/token.watchBurn)
- [token.watchCreate](/tempo/actions/token.watchCreate)
- [token.watchMint](/tempo/actions/token.watchMint)
- [token.watchRole](/tempo/actions/token.watchRole)
- [token.watchTransfer](/tempo/actions/token.watchTransfer)
- [validator.add](/tempo/actions/validator.add)
- [validator.changeOwner](/tempo/actions/validator.changeOwner)
- [validator.changeStatus](/tempo/actions/validator.changeStatus)
- [validator.get](/tempo/actions/validator.get)
- [validator.getByIndex](/tempo/actions/validator.getByIndex)
- [validator.getCount](/tempo/actions/validator.getCount)
- [validator.getNextFullDkgCeremony](/tempo/actions/validator.getNextFullDkgCeremony)
- [validator.getOwner](/tempo/actions/validator.getOwner)
- [validator.list](/tempo/actions/validator.list)
- [validator.setNextFullDkgCeremony](/tempo/actions/validator.setNextFullDkgCeremony)
- [validator.update](/tempo/actions/validator.update)
- [virtualAddress.getMasterAddress](/tempo/actions/virtualAddress.getMasterAddress)
- [virtualAddress.registerMaster](/tempo/actions/virtualAddress.registerMaster)
- [virtualAddress.resolve](/tempo/actions/virtualAddress.resolve)
- [wallet.deposit](/tempo/actions/wallet.deposit)
- [wallet.transfer](/tempo/actions/wallet.transfer)
- [wallet.swap](/tempo/actions/wallet.swap)
- [zone.deposit](/tempo/actions/zone.deposit)
- [zone.encryptedDeposit](/tempo/actions/zone.encryptedDeposit)
- [zone.getAuthorizationTokenInfo](/tempo/actions/zone.getAuthorizationTokenInfo)
- [zone.getDepositStatus](/tempo/actions/zone.getDepositStatus)
- [zone.getWithdrawalFee](/tempo/actions/zone.getWithdrawalFee)
- [zone.getZoneInfo](/tempo/actions/zone.getZoneInfo)
- [zone.requestVerifiableWithdrawal](/tempo/actions/zone.requestVerifiableWithdrawal)
- [zone.requestWithdrawal](/tempo/actions/zone.requestWithdrawal)
- [zone.signAuthorizationToken](/tempo/actions/zone.signAuthorizationToken)
- [withRelay](/tempo/transports/withRelay)
- [TempoAddress.format](/tempo/utilities/TempoAddress.format)
- [TempoAddress.parse](/tempo/utilities/TempoAddress.parse)
- [TempoAddress.validate](/tempo/utilities/TempoAddress.validate)
- [Storage.defaultStorage](/tempo/utilities/Storage.defaultStorage)
- [Storage.from](/tempo/utilities/Storage.from)
- [Storage.memory](/tempo/utilities/Storage.memory)
- [Storage.session](/tempo/utilities/Storage.session)
- [Client](/zksync/client): Setting up your ZKsync Viem Client
- [Chains](/zksync/chains)
- [toSinglesigSmartAccount (ZKsync)](/zksync/accounts/toSinglesigSmartAccount): Creates a single-signature ZKsync Smart Account
- [toMultisigSmartAccount (ZKsync)](/zksync/accounts/toMultisigSmartAccount): Creates a multi-signature ZKsync Smart Account
- [toSmartAccount (ZKsync)](/zksync/accounts/toSmartAccount): Creates a ZKsync Smart Account
- [deployContract](/zksync/actions/deployContract): Deploys a contract to the network, given bytecode & constructor arguments by using EIP712 transaction.
- [sendTransaction](/zksync/actions/sendTransaction): Creates, signs, and sends a new transaction to the network, with EIP712 transaction support.
- [signTransaction](/zksync/actions/signTransaction): Signs a transaction, with EIP712 transaction support.
- [writeContract](/zksync/actions/writeContract): Executes a write function on a contract, with EIP712 transaction support.
- [estimateGasL1ToL2](/zksync/actions/estimateGasL1ToL2): Returns an estimated gas for L1 to L2 execution.
- [getBlockDetails](/zksync/actions/getBlockDetails): Returns additional ZKsync-specific information about the L2 block.
- [getBridgehubContractAddress](/zksync/actions/getBridgehubContractAddress): Returns the Bridgehub smart contract address.
- [getDefaultBridgeAddresses](/zksync/actions/getDefaultBridgeAddress): Returns the addresses of the default ZKsync Era bridge contracts on both L1 and L2.
- [getGasPerPubData](/zksync/actions/getGasPerPubData): Returns the scaled gas per pubdata limit for the currently open batch.
- [getL1BatchDetails](/zksync/actions/getL1BatchDetails): Returns data pertaining to a given batch.
- [getL1BatchBlockRange](/zksync/actions/getL1BatchBlockRange): Returns the range of blocks contained within a batch given by batch number.
- [getL1BatchNumber](/zksync/actions/getL1BatchNumber): Returns the latest L1 batch number.
- [getL1TokenAddress](/zksync/actions/getL1TokenAddress): Returns the L1 token address equivalent for a L2 token address as they are not equal.
- [getL2TokenAddress](/zksync/actions/getL2TokenAddress): Returns the L2 token address equivalent for a L1 token address as they are not equal.
- [getLogProof](/zksync/actions/getLogProof): Given a transaction hash, and an index of the L2 to L1 log produced within the transaction, it returns the proof for the corresponding L2 to L1 log.
- [getTransactionDetails](/zksync/actions/getTransactionDetails): Returns data from a specific transaction given by the transaction hash.
- [estimateFee](/zksync/actions/estimateFee): Returns an estimated Fee for requested transaction.
- [getAllBalances](/zksync/actions/getAllBalances): Returns all known balances for a given account.
- [getBaseTokenL1Address](/zksync/actions/getBaseTokenL1Address): Returns the base token L1 address.
- [getL1ChainId](/zksync/actions/getL1ChainId): Returns the Chain Id of underlying L1 network.
- [getMainContractAddress](/zksync/actions/getMainContractAddress): Returns the address of a Main ZKsync Contract.
- [getRawBlockTransaction](/zksync/actions/getRawBlockTransactions): Returns data of transactions in a block.
- [getTestnetPaymasterAddress (depreated)](/zksync/actions/getTestnetPaymasterAddress): Returns the address of a Paymaster on a Testnet.
- [getL1Allowance](/zksync/actions/getL1Allowance): Determines the amount of approved tokens for a specific L1 bridge.
- [getL1Balance](/zksync/actions/getL1Balance): Returns the amount of the token held by the account on the L1 network.
- [getL1TokenBalance](/zksync/actions/getL1TokenBalance): Retrieve the token balance held by the contract on L1.
- [isWithdrawalFinalized](/zksync/actions/isWithdrawalFinalized): Returns whether the withdrawal transaction is finalized on the L1 network.
- [withdraw](/zksync/actions/withdraw): Initiates the withdrawal process which withdraws ETH or any ERC20 token from the associated account on L2 network to the target account on L1 network.
- [requestExecute](/zksync/actions/requestExecute): Requests execution of a L2 transaction from L1.
- [finalizeWithdrawal](/zksync/actions/finalizeWithdrawal): Proves the inclusion of the `L2->L1` withdrawal message.
- [deposit](/zksync/actions/deposit): Transfers the specified token from the associated account on the L1 network to the target account on the L2 network.
- [claimFailedDeposit](/zksync/actions/claimFailedDeposit): Withdraws funds from the initiated deposit, which failed when finalizing on L2.
- [getApprovalBasedPaymasterInput](/zksync/utilities/paymaster/getApprovalBasedPaymasterInput): Returns encoded formatted approval-based paymaster params.
- [getGeneralPaymasterInput](/zksync/utilities/paymaster/getGeneralPaymasterInput): Returns encoded formatted general-based paymaster params.
- [getL2HashFromPriorityOp](/zksync/utilities/bridge/getL2HashFromPriorityOp): Returns the hash of the L2 priority operation from a given L1 transaction receipt.
- [parseEip712Transaction](/zksync/utilities/parseEip712Transaction): Parse EIP712 transaction.
- [Viem · TypeScript Interface for Ethereum](/index)
- [Client](/experimental/client): Setting up your Viem Client
- [ZKsync](/docs/chains/zksync): Integrating with ZKsync in Viem
- [defineKzg](/docs/utilities/defineKzg): Defines a KZG interface.
- [fromBase58](/docs/utilities/fromBase58)
- [fromBase64](/docs/utilities/fromBase64)
- [toBase58](/docs/utilities/toBase58)
- [toBase64](/docs/utilities/toBase64)
- [opaqueDataToDepositData](/op-stack/utilities/fromOpaqueData): Decodes opaque deposit data found in the "TransactionDeposited" event log.
- [fee.validateToken](/tempo/actions/fee.validateToken)
- [Setup](/tempo/actions/setup)
- [withFeePayer](/tempo/transports/withFeePayer)
- [TODO](/account-abstraction/actions/bundler/introduction)
- [verifyHash](/docs/actions/public/verifyHash): Verifies if a signed hash was generated by the provided address.
-->

# watchBlocks

Watches and returns information for incoming blocks.

## Usage

Pass through your Public Client, along with a listener.

:::code-group

```ts twoslash [example.ts]
// @twoslash-cache: {"v":2,"hash":"ffac511ca8d86fac726b2a28b1b5513e1d9014cffa79e036b57a11828508eb95","data":"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"}
import { publicClient } from './client'

const unwatch = publicClient.watchBlocks( // [!code focus:99]
  { onBlock: block => console.log(block) }
)
// @log: > {
// @log:  baseFeePerGas: 10789405161n,
// @log:  difficulty: 11569232145203128n,
// @log:  extraData: '0x75732d656173742d38',
// @log:  ...
// @log: }

// @log: > {
// @log:  baseFeePerGas: 12394051511n,
// @log:  difficulty: 11512315412421123n,
// @log:  extraData: '0x5123ab1512dd14aa',
// @log:  ...
// @log: }
```

```ts twoslash [client.ts] filename="client.ts"
// @twoslash-cache: {"v":2,"hash":"577792133a9967accac50a843d8303e77374676885f2bcb57ea8c47a16ff755b","data":"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"}
import { createPublicClient, http } from 'viem'
import { mainnet } from 'viem/chains'

export const publicClient = createPublicClient({
  chain: mainnet,
  transport: http()
})
```

:::

## Returns

`UnwatchFn`

A function that can be invoked to stop watching for new blocks.

## Parameters

### onBlock

* **Type:** `(block: Block) => void`

The block information.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"195da49fc46fbd4aa635bd5350679b64c232eb0b1cbbb55a78b898cfa0a4ee4b","data":"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="}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const unwatch = publicClient.watchBlocks(
  { onBlock: block => console.log(block) } // [!code focus:1]
)
```

### onError (optional)

* **Type:** `(error: Error) => void`

Error thrown from getting a block.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"2ab196565a54cdf092c0148c8c8b4427a58025aad1700c9a47364f98abdc12f2","data":"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"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const unwatch = publicClient.watchBlocks(
  { 
    onBlock: block => console.log(block),
    onError: error => console.log(error) // [!code focus:1]
  }
)
```

### blockTag (optional)

* **Type:** `'latest' | 'earliest' | 'pending' | 'safe' | 'finalized'`
* **Default:** `'latest'`

Watch for new blocks on a given tag.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"6c25ed556d055ea7a0f63f67c19f33cc704950cb54a4759b656f0d217850a72e","data":"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="}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const unwatch = publicClient.watchBlocks(
  { 
    blockTag: 'safe',
    onBlock: block => console.log(block), // [!code focus]
  }
)
```

### emitMissed (optional)

* **Type:** `boolean`
* **Default:** `false`

Whether or not to emit missed blocks to the callback.

Missed blocks may occur in instances where internet connection is lost, or the block time is lesser than the [polling interval](/docs/clients/public#pollinginterval-optional) of the client.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"c601415e603345cb7454dcaeaa3c5039854a3c85a4767de0c6499fabbc3c529a","data":"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"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const unwatch = publicClient.watchBlocks(
  { 
    emitMissed: true, // [!code focus]
    onBlock: block => console.log(block),
  }
)
```

### emitOnBegin (optional)

* **Type:** `boolean`
* **Default:** `false`

Whether or not to emit the block to the callback when the subscription opens.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"175c13f4408734e8e1fe43ac6be4d7eecdb6c88c1b8ffba43b33bf7ad7194296","data":"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="}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const unwatch = publicClient.watchBlocks(
  { 
    emitOnBegin: true, // [!code focus]
    onBlock: block => console.log(block),
  }
)
```

### includeTransactions (optional)

* **Type:** `boolean`

Whether or not to include transactions (as a structured array of `Transaction` objects).

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"c57f87dc60d0a67c6ecfee834c4ac1dc29d287be511c0fb1f4e1bc58a91c1be5","data":"N4Igdg9gJgpgziAXAbVAFwJ4AcZJACwgDcYAnEAGhDRgA808BjCMONAAgFcwB3AQzSN8idgHUBQgEIAbCIwDWcAEow0nUmAAq2XFTZ9SDRADYq0mGADmafEgDsVNAcuq83foNtmAlmFyIABiohAz5GGnITAF8KdB08QhJyRzojEGZWDixOACNpb0YAYXyLNBFgAB0wdhr2MOZuMq4wWAAzXxgoAG4q2vYciXwAfnLevtqAW05pNAK+aWkR/ogIcz5qgB92AAVSVVnWjAAeAFlp2cZ56UlBgHksWZY4AD52Le42ju6xmqi35s+fm+1VqlyEME03gmMBEYE4ExyZB6IJqjEY3iwKj4UCWrXmcBg/0qKPGewAjpx4GglgAKLChaEROAiQrozEwClU7YM1RkOAASnYAF5XrsIBNvASjqyMSpOWwVGoNNocM9kX0/u8WjB2kD1aD8HxfKMSX08nJ5ABRWhYWR7UjM9jE8Yu9h7bEsaQYdhtPjnE2uwNumAesBe9hgPjQkQVECWmx8y5gWP6oOkkNQT3e9TSGMENBoLDMgD0xdU+ET6wAdN4ICmfmnau7M2HvXwsN4AKqkXPsWP4AtFxCl9veKvlytgGsQYuj+um11RVPjJcNvpVjfsACMxnYEwge3YG6ry76SW8hwAEnw4MMWYbfAA1MgXjDX28AMU2AJ1X2Xq5JY92GMAAOPcD0JY9l1SCwoBEI4MjYdhGBKMAOBglo4CdNdaighs/gAMnYa0wjQblDG8eYjmPZ5nhpVowBEGkUO8UoWVQtBqI3Z5BRFZCON415ilYtCuKrNUqiiSgQH0QwkB3MwLGsWxEC3AAmRxnFcRAQGyPICmE0ppPyPwkCCdJDVIUiyHk4wYjiHAEmIGyUnoPA6VICAcEMDBBQ8KRZAUR0jjQUhKQoPsQGkAQqVjOjnEdcRPBkC04HIqNeQdI5L0HTQrNYLAD04j5fyBCK8WkAlngi51anNBRrVtCCHQDV1myzH0dT9GZWrTdrWwjDK83jCsHSTedG2DUNwxzPMB0LEsywTMbq1rCbG368NR27Xt+0HRbR3HZa4CTadZw7daXQAjVl3q+RIWjbc1ICF7lwyULSMdWqXU270LDgTswG8JI4HmFQ4FWJJeqDX66igKA9jgR1YwCWgYHRjH0a3AAWKA7C3EDGDUnJsbsKAAE5ybUgBmWA+ByLdqepgBWGAcexzHLphjMOruwp3RoOD2BpgIQOZ8WQNPWprranmBqmGY5gWanocDWHsQR+BkZAVHLi3LcclgAJmfJuw7ByanjGp/XjDsAI1JAkDjGJmA1L4Lc7Gp03jD1rcubVuXwz5gXOhEHGWctgItyl35/2g1hNGkKA4CWWG2FIXxLGQABdf4St1Tpl28IXo4bID1PAw88JJc8rxvO92EKB8wGfDO68/b987/SSItC8LIuimg2DiwSxEGFKgsVdQtHiKhM0YBAdKS8EsPWKBgyVVh2F8VoDwmARa2qXfSG3sBmAlKx+kCxQqyqKoAFp2AAETkR15qHUsiFYiYq1vYt57gLOcIh9AF6XyIwYs/l8AT0UA/YitAoy2ngCId+i19AKH0mgAAXlWc+xZLDeBsLkSBMAiATGLF/GA5DQro2LPvXwZYEETCQYAu6cAAD6UDM73zYXAgAUgAZVuAAOXvkobYhR2AnHLNAZkYxH6iArNUAABoVBYIg+4wGURFS4CwsLIGUeWdhLg0AwMkBgYR8JESkGUdnGkqDhxLVGjAeEVYDyWDLGAf+pCYCyG8oAgB51JTFgAFYQzAPfUgWAIEAGIjEmLMRYqxZBBQsDqOwNRJlLCnwiEQeYt8QQKKUewVRqxewVQJMo9gRFRAwByAIi0qh2B5XWHAQqhgIqcAJKvMQdSGkKCaXAXIJ0M4PEPuwL+fB2AGKMUMnIIzvCIlsfY/ajiAFVnmOCCYGBcHimLHsVoZALCMBgE4++cyFmInvmojAlgWCCjXuwBMJTYx+B4JeDMcBYxVJ8WhKs0knCWEXsgZAukGTSQSuwR+wAAACJl5Bj2StfNKPImRSWzhQUFexN4ICoAAQXYK0bgwC0k2AEMhdY/RCS+CIBAeQnQnkQHYGwLy7AuGX2PhGGAPAr4WgjMkh0VYnRwt8Ai5e0DkVT2VDodFmKQB0EQeYaSUJ2kcGAMhEO2xcjgMMmhCK792B/FaJ5CY7AADklCJhmqqCqoqTo9xGjAH4DgRqTXmstcWEIvg4DWuTGfJ4HAWKlGFBqkMNAtX6SKBxGktUvWMQdb4Z1FAxgfQKkVFBg4aT8mTWAKI/IqiIQ4O4QYIa+D8EIfxESaAqxQJgXAGNYwWAwKYndUeiFVgwCrLISwNJW05rzSAbOGKZJODkogNS5NFJWBsPJLcmlSAmLwLW5FxkOhmWCJZaykQJ32WoPEHSiQXLUFSO5LAnlvKYEFL4FCnBYAtNYKREBSxNF521AXKA0kAF4EUROE+B4IwQA4GgJl17pC3sJKm0GJLqhQAEFM3wTyKzBjaU8Tt0lZJGGZnOqKSkZ2qUndQLSaRQPgfvVBx4rBV2mXHRu0I4QbKIGxruzAjkD3OWSMetyOkPJeTIJe9gTbr4iFuGAGBRxvq8oajaO0fJVZNkDt6X0/psILh+gpwaj1YwjUnP7WW01sw9jmqs0sv6TqrTrCAGO6Z9N1A7DtIzC1HGHVM6dWsQTdOx3wrda+D0YRPRegEN6LAPrhC+jhGosN/qA2BnyMG8BIZkDk2pmzGtEba1RpjTGOM8YEyJiTMmlMaZ0wZkzVm7NOaWfC9ZlsQdr78zDaHYW1NRbi2ZpLKrMtks1e9ArC4VwVYqcmureGaW8y63dgbI2JszYWytjbO2DsnYuzdh7L2dgfYTY89V3mdWQ4l2xhHYwUcrOdcNfHOAidk6p3U+nTOOdX2AkLg2YuYdlyRk03GZaLiJhc0jLMEghR1B7DPhgJLU1usab81p5aW204YARKsYamhLyw/U7AdE+9Kph3aySU75cAiV0ghuZctc3z1yWE3R1rdXzvnwF+B7pUnu5t7mFGAEVYyD1iiAZ4n7X54E0Eh3R0gBgKEZRShYbLilTLeZJhFkpgwnJi1Af5ehR1GC3C9Kdyl7DzsXTpQTFoqP+GprRqy9HIhMdiHu1jBB2MApPdx+kVlGQpNl9DOECJEv9G8AQtCy5DS3hEMo1GAASYAt2rBRGUW9lgJyg+h/D6FTOUflzdrgClcU8faBh4j5YFPDYBgEg/OjbYZAADiN4RA5B974DgWw4QLG8xAHIFeAYEiFtX33aBlxQAvO0Rg5xQfe679BWgJykYpRb5X4ftfR8fSfnBkQHzaDLksDeAAMlCQhVea9+4bGvtvjXO+z4bBfL3eKRta2XBKWgtOl/12XE70okgQwZBgUoFY1Is856T5HqpWpHtgQ+gn80I792Badlw9hFcHhlBP8l86BlwCR5gPxWIk5HRl8c5EDDRqZAYUJkFwCH8Gw4BvAsE/Nj898SR9AaAP9AN79bxlxZhoR9BmEd8R8GxgMnBpAn4+8ChB9WDa9/gG9pAGD8pyMQEaCmgICGxiVzB0D65MCGweBCF8AEYy18QlhRBlDVD+BpB7sADGd159D31lwlCbBtD8QJClhg9s9E8M4/8GdjD2DRDH0ngmIJN1xid8J/ggJqZCcjxNwth3DcJPDcd+QFDc10M1d5IAgCNzBp0VJmZddtIQA7ojckATcLI6MIh5JqZmN91bckh7cuNwAMo2kwhCR21zAqg8kT5Ki/NCgngO1ecF5+ckNlE6iql9woBphCQz1iBi54B0liDmFzBOochOBLBfdsk6jENyV5dhjvBooT5gNEMYAqg+E+A8kBFGBRlA1GjRjoQQggY4BTU+iv5YB14chvQeA6l+hPIeACRBU74tAkMuiej2A6BVUsI0AeAmU2kYB0R+9kJxRCo/A0I5E/UAAqdgAlZRBo1gDtKpFCG8LCUw/APcGRZOZlTgIQOoLCdo/YztbtLNbREpOo8cUgTyUgEkuoFoMkwkmtAwMAGkslQNSlRELgdvMXHgDOGgMXdYb0YRaATtMJZlGhKMApaEglSwWQAYaQekhE8wKpb1JwM+ColgdoSwdQBlFYnkwhCDJlAxPo8fOAX+NATMTgNAZZBxUsSAWAMJNxBdf+V+YsTnNge+IgNSbGKsWgIJYsY0rWKsAcCYaQGJAMpGNgC0tAB5FoKoI0zyE0s02ASk604zYsO0mAB09xZ0heV0mKd0z070300cf0hMwM4M0M8MpGc0sgUgfkIVAXQkGU5veYBUiGJUilaoDkrpBlNEiAS07eZhIqTOVYkpDMxADo8Cbo8wApKodhSEyE8QDQTOBc9hEQRs9gZsuU4ExUwkZvEJAEtAM1LCRkQgLEgwQkPwZQsgHc4gtgUoL0KoOADAM+fATySALpdgfIelUcnIe4x4mE7YAASW+IrG9ERioTyDZwAxPgvNWO9EQklBoDQkfMjGfNfPfP7Kwm/MJCuAE2WnYCFNgCrFFPThDAmFNPYAEXRlHIMUgD5LSSrPYCAuLFuFTMc1tOFKzKdMCTdLQA9K9J9L9KrKDLQBDJiT4HvnopgHvhYGuTLKRnvlrEFGPiqH3EPB3j3gPhYFnLABIhGMJC6RHOeS3NbIJN3OUUQGeOURsrCQLQZOJLNQrAWCZV+J7CgDNX5GRFLB2DsLQDfl8VkDZQPCTl7j+PNP7LQHst3K7QgB7ScsCqZQAFIfUIozU3Kk5PLvLixfLa8AqXLgr3KwqxSozor2zO1ayDwaQZdLRKSqqzVFEVgiwIoIZTyRyBh15DQsAcAgRPKvKqgfLdg8qPi6qT4mDQYXBaT150EEUQsDSSrayrKvEcqahaqqSRBGqvI4AWrxRyx2rsR2AuqerOgBqVrahyVkBSF5hs5EBmZVJmZTrxhyVtjdiqwwowAgKXjJR4SaB6B2BqrhTEAyFVJqY1JVIQJ81lqnqOBbgcgDzwg3ruBPqBdvrgtUh/rxzgbmtyZEBqYIbHq+hyVxza8yBIxpBSy5AtZGEATLTD5EAzZ8MCbzqOBLq8lpBs574eT2xvITBx01ImaahyUrrpAXqMQOAAbYBEASaNB5gKaTTqaB8KN6bjATAAhIafLCaOBia0JSbZb6EvFhb2Fc9x0VZqZnjC1IcQ0GrFj5SP9q8ESwAzVkRyT+ANAaRlEF8rAbyw93sYAogABCZ+dYFwUgf25RfqqGoa8EkQT2kOsQG29gO271FgQO2Osgf24qyM2sqoGy5RZ4/SpBTk4yto+E8qpE6KJGJanO2yr5f1TIATAcoUTc1QARcUiYBpaEQgHgLNZ2gNEak+JukxVu90du3arunusqjgbZUujtENGXckme8wGkSKiKWsiOtSjAReokuKmkBKgqjKjyiOwavy/KoKg+4qyKjere2K+K5yoKlKs1NKg+rKx6qO/ylBRKwq0KsXS+sAaehkyq6kmq0a3eza5q5lXamwfazq7miwToPq7K3K6O6ZNag8DawgLanatqy+Dqw62BoEDFMXbOv1C232q2zQiXJOh2p2q+hk125kj24O724AX2gOoOr20O8OxBt+x0NOk+Ch225vZOsAVOph0O4q4h3OgFPgIFJAEFGSdGaSZACGdQE5OxG0/BZQ3IXZchDMsJdM4U4sc0HIChQS30/IEx8ksJfkQdYdDDWdECLXPDBwQjBdZIuotI3G03LdJANSNSPIm3Q9DjX6tIGkU86AQUa+4k8amRmAJYAUiKY8LyCjeYdKCikQAUnOfkEQWlYuf6gAai3AEySFkGxBsbnj5x0h4bF2UUjMiqqTRK5R4BMk7SkXOAxFGOcHhFKCwiTCpQyRRM6AikaYTCqHaAdCLS5JvFHLPShAMB6y1liamrqAlw1kIUPlbJ7PXmmYuVmDUAo2qPmEpCwgWKWLF3jNr1aBpGpn5HYqwEcX3jADsEdI8RMk4F9MeeuVicAUeeplLMuarGplEpDMhppGeS6ehHBLqEPDwvpCRh1MNOUVpukCrGPn3jQBJPUbTL0dNOzN4vzP4sLKEpLOReBdDORbRYEEpf4oSn5HrOsprsnuBMaBDWZl7piscoaDQhECSo8p0X7LQiPpyp4ZEC5aaESLFzqctLKo7Rvt3rFcQEfuZcFe4ZPtFYFfFczoiulbAFzueOosJAMVJepcxZWQ4oMftNxZ4pdL4oEqLL9NJYrJiQpa0rQGpfvlpcJX/XUupTAGpcPhV0I1kZQFBWILVOkiIACCrC3GjZelsdVwMHVzUlMBw3iPSKSLSG7U8YyJCDN2yNxoCACf8AKKPRCdPVRVdzundwFX4IoL6AD2EBKQT1z3zxJEgDVO/1sOT2jwbDTwzwmE7ZbZ7ZJELxgGLxgFL1IFb1rbr35UbwL1lNb07HbxnZ7x4IHxmCH3IO7wbDoBNMn2nZnzrdqFSCsgXycHgJX33w3y3yaG3dXxvGXaP13x3ZJDP1IBEAv01iRmv28Fv3rjoPwEfwvLQhfzCANwUEsMHd/zz3/x/EcJJBALQDAKkJJCgJgDFtgNoPAIQKIJDGkBQN8WTkvfCL6FvD4BwLPlkMA8QJILIJfcQKcGoLgIIPoPYKhCpEQVXfYMA3mG4NaH7z4KPdnaEJENaRcNYAkJo+kKo/wNp1I9qDRPMMqg0K0Ksh0L0Pg6+AcO7hJCU/U4sM/ysObZg6jx071CcPE+g0dAbVU38JPC8K2B8L8KAkCKq2rg1DCOzmRCkgTbHUZnMjiO11uozbwFSJ8Goxzc3XN3SKY2HWYFgCYD7uLU8BDTAQMg4kZKRVShpDGHVWeyo9I2cOs40VZwinYB8uQH9oS8JF3gHzgGzgbAg/kCr2vmFFeHJOJL7TGCiCqHKZAEZD4CQFAAwmIJYDwH8pACiCiCAA==="}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const unwatch = publicClient.watchBlocks(
  { 
    includeTransactions: true,  // [!code focus]
    onBlock: block => console.log(block),
  }
)
```

### poll (optional)

* **Type:** `boolean`
* **Default:** `false` for WebSocket Clients, `true` for non-WebSocket Clients

Whether or not to use a polling mechanism to check for new blocks instead of a WebSocket subscription.

This option is only configurable for Clients with a [WebSocket Transport](/docs/clients/transports/websocket).

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"7a4239f25ec2dc36617a08cd2a76dba1debd6d4590e21a4ba0cf47d242c87a7a","data":"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"}
import { createPublicClient, webSocket } from 'viem'
import { mainnet } from 'viem/chains'

const publicClient = createPublicClient({
  chain: mainnet,
  transport: webSocket()
})

const unwatch = publicClient.watchBlocks(
  { 
    onBlock: block => console.log(block),
    poll: true, // [!code focus]
  }
)
```

### pollingInterval (optional)

* **Type:** `number`

Polling frequency (in ms). Defaults to the Client's `pollingInterval` config.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"fb31199f72c8de9d07f128cbb78e05481a7270e14e38092d275fc2f46f66367f","data":"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="}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const unwatch = publicClient.watchBlocks(
  { 
    onBlock: block => console.log(block),
    pollingInterval: 1_000, // [!code focus]
  }
)
```

## Example

Check out the usage of `watchBlocks` in the live [Watch Blocks Example](https://stackblitz.com/github/wevm/viem/tree/main/examples/blocks_watching-blocks) below.

<iframe frameBorder="0" width="100%" height="500px" src="https://stackblitz.com/github/wevm/viem/tree/main/examples/blocks_watching-blocks?embed=1&file=index.ts&hideNavigation=1&hideDevTools=true&terminalHeight=0&ctl=1" />

## 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.