<!--
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.
- [Multisig Transactions](/tempo/guides/multisig-transactions): Send a Tempo Transaction from a native multisig account by collecting owner approvals.
- [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)
- [Account.fromMultisig](/tempo/accounts/account.fromMultisig)
- [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.
-->

# getLogs

Returns a list of **event** logs matching the provided parameters.

## Usage

By default, `getLogs` returns all events. In practice, you must use scoping to filter for specific events.

:::code-group

```ts twoslash [example.ts]
// @twoslash-cache: {"v":2,"hash":"4bc71fd560babe9a4bcb6f4feb0641b11fd0d2f31cbb072d732d5d34a2252836","data":"N4Igdg9gJgpgziAXAbVAFwJ4AcZJACwgDcYAnEAGhDRgA808AKAQwBsBLZuASgAIBjCGDhpeWAK4AjDvwDCHGGDSJewADpheW3s36DxSlQdgAzdmBhQA3Bu29JzNP3wB+Fes13tAW3Gs07PxsrG72EBCsMMyaAD68AAqkMGgBJhgAPACyfgFBrKwAQo7OAPJYAUJwAHy8ccYwZhbWttoAvrW89Y2WNp5aQc4wACrs3jAqYOLekmS9dnrsWABKUVChJmxwMB0eXtpJAI7i8GihjFjMpMxjNKRwKrL8iytHJ/GX18lkPLwAvDWJCDedhbdKPZ4wV4iFZocSkMBDbAwKpzNodLrmHotfr4ZjmdzYrzSCD8ADWAFFaFhWBAkncCX09vtVkJWBheKZmDkGUzebwkswoKz2WBPio1CByWh8N8gmAJai+V4BUKwGzOqRWOKCCksPcAPT65Iyu5ygB07AgCsJSq0KuFOiw7AAqprtfhdQb9cwnWbjbLohaIN6ndbGbzWoqvJGbdozfHeABGABsvG8tO28bNUbsJFI7DSAAkuK4HrjzAA1MgFjDFuD4ABisU6YFMmOajJjjKzvGTAA40xneFmo3QaK2VOlBMJRPwFEpeGPFFA4KpY1oR4T2gAyXiU3Rod6kAJsdJZqpVRgmMAqRhz9iKZS8eQPpRn+NVPj/ATztBfmovo+75miiGitBooxYLSogSNIgSAUolAgCIlwMIgACcVCRGAADm0pIImABMVBoJcOHJHgsEyAhDBYZiSAAAxUM4Hz8LcSDoa0FDoEieCEHmSE0PQeDTiIvA0jh9y8AA4skAAyECSTCcIIki6QYk0FAtm2mnaQ07ZaRpliGa2+lNFUSEoceSAACwAOxYYoeH4LZJFkRRiAgBJCB0RYSDESALFXGxZBIMmXE8TgfHEKFJFjkwbCcD8okwVI1G/jy2i6Pohh6d0HZ2A4Tilmu4Y+DkgTBKEkjhJE0QdIkySpBk2T+JV+RFMVZQVMINR1KZ+VRu0/U6VijIDDKIxjBMUwzKQUYLMsqzrJs2xxLsTKHMcIhnBcVw3N8DxPEtUKHh8B13P+CSkECIIwGCx0vNtaDKfCiI4KBnbogN7YLeWN6lbyxJkpS1IZvSgO2vaarspy3KQ7azKCg6orTbwEpSiacBymGiN2ND6pwlq6M6mgeqIIa/qmoGlq43jdosjDjoum6JMemTXo+uwfrSgGYBBiG7B00qXYRjmcYJimg5JMO8bi1oeY1nWJWyP9Vb5kWJZNt9o0FW0UY9v20uZnLhJLhOvBTpUs6/ou9DLquG17JuX27vubFHierDAReV4A3eGXPr+PtXfej5XTRPu9OBYCQdBYhpfBv6WaR1mIMmTFeU5+GIERbmkORaEgFRSevrRXn0YgAVBQeoW55x3HULxnn8bF1DxZ55w3Tgx4YHwhcKZJk5GVAJm62PZnGXlBnT+ZLAF3AoSyWgg9wEeny3HA6k/bpI8T/l+8zyPfWz5YV2AsCoLL6vr2qTg2/j6fo9P4fu875YF5IUK/AIJ5t+rswcSIJRAQBMIuEgC5vJpmKPgcwOFeC8zEDdIg7BYBQDEOdL4dwzQaA0AAWl4AAERJFJdm5NDQoJgN4M09Z9TfzgN6NilphD6hLvwfUA9FJwHwXuWg1xqTwBUGQr0KEyRwTQAALzNIIbwHD2DSikPqAA7jAIgsjKGyLQEkGA+pvB4jAEaPh3gBEMO8gAfVUY+PB3keEACkADKJQAByeCljxFkLwTIxpoBSWQAAA2NGYzhkk/EAF1GDCIpkaXmSQphmlpDhI0BjYAkBpD3Bh9DBYMIAFZwCEHg0gWB2EAGJAmF28twQSzBJJIGQMgYu50kJkVXAQ4AAABDgYBSQyXklw9eF04CtBAKEig9SkiwnhD5EAABBIBYlQHgMfOJLhZpVAdPMN06+XDb7vRgEMkZ9S6D8MiEhOOx5VACAFDQeIic5C/i0mQrSe0tjTMkOwAAkjQbwvB2gmBut8gA5BogFEFjHx2ANA8wFhRC/P+bwIFD5ZEsXMHAEF8owApR/GXP4lyojXNuTRRgG1kUAz0VC5IFAWhaOiHAKCx4hG6kYNwSlYBWjcA0JiqBvwdBKLxDbMuZpglwCZcMkZyFU5oTsgAZkcrhHODlqDuSLkKpCnTcBV2YriYK7FEBSsIhFJuUVPKkRwkhVG6qvKKRTqhAiDEbKyucoxOKwlPIlHEGTd1KhUCy1WVxC5PY/UQoDaE1Vld7WBS1bXcgiAGKtDFYIWAeAzmiAhWwmiPzeB/KBPCs0+ow5KDRRy62yzJI4uYLy+RCc4J3IFUKplWhDS8GQAAQgTdsEwJJxD3HQuhUJGgkI3GYEgUA5s4DMLwGgBArRWhAA==="}
import { publicClient } from './client'

const logs = await publicClient.getLogs()  // [!code focus:99]
// @log: Output: [{ ... }, { ... }, { ... }]
```

```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()
})
```

:::

## Scoping

You can also scope to a set of given attributes.

:::code-group

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

const logs = await publicClient.getLogs({  // [!code focus:99]
  address: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256)'),
  args: {
    from: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    to: '0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'
  },
  fromBlock: 16330000n,
  toBlock: 16330050n
})
```

```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()
})
```

:::

By default, `event` accepts the [`AbiEvent`](/docs/glossary/types#abievent) type:

:::code-group

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

const logs = await publicClient.getLogs(publicClient, {
  address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
  event: { // [!code focus:8]
    name: 'Transfer', 
    inputs: [
      { type: 'address', indexed: true, name: 'from' },
      { type: 'address', indexed: true, name: 'to' },
      { type: 'uint256', indexed: false, name: 'value' }
    ] 
  },
  args: {
    from: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    to: '0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'
  },
  fromBlock: 16330000n,
  toBlock: 16330050n
})
```

```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()
})
```

:::

### Address

Logs can be scoped to an **address**:

:::code-group

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

const logs = await publicClient.getLogs({
  address: '0xfba3912ca04dd458c843e2ee08967fc04f3579c2' // [!code focus]
})
```

```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()
})
```

:::

### Event

Logs can be scoped to an **event**.

The `event` argument takes in an event in ABI format – we have a [`parseAbiItem` utility](/docs/abi/parseAbiItem) that you can use to convert from a human-readable event signature → ABI.

:::code-group

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

const logs = await publicClient.getLogs({
  address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'), // [!code focus]
})
```

```ts twoslash [client.ts] filename="client.ts"
// @twoslash-cache: {"v":2,"hash":"577792133a9967accac50a843d8303e77374676885f2bcb57ea8c47a16ff755b","data":"N4Igdg9gJgpgziAXAbVAFwJ4AcZJACwgDcYAnEAGhDRgA808AKAQwBsBLZuASgAIAzAK5gAxmnYQwvEaRjMaABUEAjDiIDCHGGDQAeNKWZg4WCKTS86NMFDi8AKoeOnzFafmbspV7bd7qPL14AH15hWH4vGCheAF4wmxhIsGi3ZhERCGE0AHlSAEEoKFk4Ox8bO3yMrJ0Q3kLi+DtQ8KSomPjW5NTeUiwRAGURfBgAW2ZLel87ACV+oZHxuq72uISI9oA+RixmQ1GYGlI4RF4lVXYNLR11SUiAc30nEzM0N2HPMDTq7LyGkrgbj6g2GY2Ym24p3Oak07G0egMRherncnzcCj2cBgVUy2V06VxOj+RQBmyB81B402AB0wOxRi4LDI5IoVDDrgwqFAICIEIgQOpZPJ4LwJtDLv4ObwAO7sND4UW8e7sEhSZCOJGMgC6jHwaDQWBOAHojUQ4aMAHRwfBG7m8o0iDlwI1eAwQPiZMAPQSyGL8MyK5ABT46vUG42m81Wm1252OuE6OOBYzcC202kAWl4ABEeSdeGHDYgTWaxtHbXmHU6jVg2Zd02B8mc6yJJQmLOw7EZeK6yPx0jBeGgILxqSBaxcRGPeMgAFIDHIAOQzMwU6nqCgAkqH9UWTYcRrJBJazPcjdpbTASKwIDhjhX7cwsJ2jQArOCSDPAo18A7y6B2HAgjDKKdiyAYcJmmA9y8KoPIANa8GAx7KGQgJDs86TiJI6FClAXgwfwpAQKMvBwOM5jSJIiJiOhhytvKxGCPcCrIOKrZVNhxg6g+zpYRIxg1i2Lo6MRUDAVxqaUNQzD3HyyDIOOezMKM0meg8vBZsAAACHBgIh7GwvCtxeuw9wAL4gFqFCKeBPrGNJTbsW28IWrwOl6QZLZGTolnWYpdAqVgrC4FQ9KMu50hCqyk4+W8Ba7rw5kCMRpEAOSlqMaW0uFryReMXgpBYyVESRvAZeaDrJnA2VgLSnpwEyUrxMywqGRyjDALSvCol4pwFWARUUN1GGaq8pyFow3DDWA5ncFZ1kgI1ewMIgACcVAhdB8pIAAjAAHFQaB7Pchx4K1MXsu20l6bgiAAAxUB8hhiGQSBreZFDoNgd0EMQb1HVYTBsJwPACMIYgCQlBq6MCCxgpM1h+HMIKLBMLSJN0HTrG0KRQECzDSoj0ywRAEAhd28T9qwWLbD6rAAPynI1pAEcsmPtO8dxmUzvAABK7hqzivCZDywxSaME9KEKnALBpC8iehw5SzBSzSdIMnlhbScdclIApICwHAMjsFgXHSYKLIihMfP2PYCijcLlHyvIVGDTAtFDiOEzzkuK5rhum4WgtVDLeYSAAEwbSAW33DtiAACxHSdZ38trm1REgj0gM9WFvYgUefd9OB4IQJDkID9DAxwXAejhFgDUVpxdVIPWwTeIjwQAorQwVmGhzcjW3bd4ZIrAYLwETMIIrBoIPrfD4vvRyNyYDj0hKkwKcY5d/KaEiEYY4ANxD0vI8r2PE/09vBC7hGB770YFoSMfp9n8vzCr+vT7sAAqqQrAb6FgjD/C0D9jgHzAM/CARof6vwXovcyJ8EFINPnBTu9h6Rb14LtCO918HIOHp6GiaB8wt3fqPNeE9tBwF/nScucA2AzHgOTcu8937D0od/EkTQb73VoDAQRQjBG7QTlAAA7AdEQEdlAJ3EVANaa0I4AGZYDMGULtZRyiACsMBREJ2EfAjh59P6X3bghS2wooCnBUfdfa2iHH7UIWfVBCDOEXyobwUYM9xAH1YKwZR7DjEfy/hPT+jRSh8NoAfXau1lCwHutota4jxHKGUQANmUbE9J4j7oR32vtdJMiYAR2YLtcRyjknpJibtIxwSuET3QfBSxNBrE4ITjojJ91drOKXq44e/S240PsKwWwvMGlkQgtBZAWp2YbDxr0nsbSemnzAJvG+u9DwwGPHUnqazxAkHUD6WQogMBBKXhMtZBwNl71ILsxeEy4AYFGMocmGz7B83ue40xnjYAiHpGwfMB1FmDJ6hacFOD7peP7rwcFFpFnl3YPwDAfMuD4F5sGLwAA1MgSKUVooAGJSAxvM6IyDzI5U1pRRuZ1Q7HXDogbR4jNraDjvgJAzKZKkFOqtEANLOQx0zogXaT0PAvSOO9Iu1Afql3+hXagQN+QNQsBOK68Jzmih+DoU4KwFloPkMMXm5Cz7eNnpcNgjNTivPJnIYlZxwLiGRboAAsj481/iABCBr8A5DNgJOAmw5m4zJafZKJLg1QEWQfUEmDrlIRQmQKN/ysDMM/rzamWI6jGouTAAAjoIeAaBeY7GUn+Ae/hk3MPzYWjE+xDhoT4LEQNChUqdhgLodQla80FsaswtA9l7A/U2CCoNWMo3Jg1cPJpPc+6yGOJOs+Eyp4+IXcYy56zRwgE2Y/OqIBFnBJCWY6+m7gHFnPLc42T8X57rfvUjx39nz/0ASeu+Z7QHgMvVAiQsDnxfJcfutuoLF5wpwek6FshYXgoAz1RFyLUXWgxcmHFrM4OErtbqkNKDFkgfSftcDg44WLPKG03QyrpBSmI3YbNwGoOht4AAMl4D3LCtbxBsF0HCzY2x+BgFOIweM6qXI6A4+CiEcRA0CZ0I2wNcURMWmHbSSydKVp7XwSy7a7LhUR2Tty1O45vIchukK5RorlKvXIMK5RUrMAlzTnKnWiqQAsBrmDC6MB2rtl0HLLACtGS6Aw/jAQgKYBkncmgju3de43jnWQ29PUl1JGnrPVdDz70TyudgneF7IF/pzT89ex6xynv3Nlq9EBcupfy2Ex9ACgGvpNO+0rX6YFwJvW4wDILFlNNjdg3B+D7pRuouK2L7X4tpcsMYOhKo0JMJYawNhYXRuVdCaKHhkTN38OEcI0REipEyLkQopRqi5AaK0bo/Rhi2sHomU0lp0QbHKLsQ47RTi4tJWg4ezxprfEWsCYt6743wkAiiTU+JMBEnJNSRkrJu0cl5IKUU1CpTymVPEdUsptSrt3qq+Yzud3lkdO0V0lZS2gNAeGaMuA4zxsswIjM0d7RFnsGWYsjLNytk7Kx3s+Q02jmkBOSIM5/2z6EdDdhiFu0oWjBhaLhBsH8UIdOJisAyG8XwfwEShnerZpuAC7rjmeNti7DrUcEbw9ZdzQ1RbylEU3MefhNJWMeA7tdmbJOITFhZTykVMqVUM5fOvB3OGM9mVyyxirO2Z0rpiJ11MvcH00QBABgmEGZMQe9yRjLNaXiEf4RJk+DwNMdUwBZlzLyCa9XM+Wmz+HyTpChKTgbE5FsHuexdikL2Ug/YRCDmHJu1V9YQAzl9suVc658hbnT/fW52yTzcvPGAS815bxoRzz/Z075Pzfl/AeACZFgIKi4MvCCV42ZNPjS8tCbhETGH4jhIEK82alVIuRFabsSF0TQAxfATEWIzmcpxP6jxOHnfoJAPiICJG6OJJDJIFJMnHrCgIpMbipGpNzDBFpLpF4F5LFByKLGZH5DZCAHZKQA5FQM3u7nFG5B5FgW7mqr5FZIQYFAyCFNJLlJRMAFFFbPbjoG4IWElClGVBVGMLVGwRYBwfyvwc/uVJlFVAXrVPVPXORu2GsHbgZu2J1CNB8H1F4p8ENCNDforBXgaFNDNHNCHEtPSqtLEtoupmyntIdFyjyudNFO5moQ7hnCkEgCZjnGKnnBZvktZjKnZuXA5lXPyDsMRHeJgB6MmIhp8FmuFghDOtFuWtRt8itsuslsLmuuNmzputuhAofFzhwhMoVrfMHiVoeJ+tAhVukWYj/E+nVhUT+uwGAk1tAi0RVmTl1hFj1qcH1gQqfMQsNilhMjQlNgwrNh+PNmQClnUZ4kDrwhtgIltiImIpIvtNIrIvIooiomoqdjonognAYkIrUSYitrdi4W0rYvYo4h9kBvMevN9u6gEnMecfUWtvmGOPwqDgkkkikmkpktkrkvkoUsUsjhUlUjUmcWNjjpcVbATp0ukt0vcZ1qfBTmMqcI8lMvcPTuGmOqfMzv0azhullhzqMPcvsrzsctoILqMbkaSVurchVo8s8q8s+jvB8iyeNn8gCjTP0a9lhqfCBpLvhpBvCqfPLurnEdiriqhtaJrviYzoplrtEI7nmM7smEnqQEOCMEoa5NJGHFYcog4bHPHDYY4XploWAEZp4YnKZuKvnBHIEbZn9CEZXLys5qDLHo1DoYVIcBqtOlFv3POtkctmYpkXPGGRQgyXGmSTujCZ9gVrVi+s0R+pAjUcUTGTjg0SmUVpXo1lURmd+q1qiWLokRglgv0XgoMQgsMVhGbouuNuMfQjNqwMwtMQtmkU2TmZ8VEqsWsbtpsftjsUdvsZoocRdqcVmT2RcRFvjg9k9ncW9g8e8V9m6n4q8dGbOR8REl8SAD8RjmDhDgCdDsCfDmCUjmUpCWjtCTOXlnORYlcf0YTsTmWUKQghiVTliTTjiXiTjASQgkSTgiSXGUyeSZSTzocjSacvSTjnkfGXcveUmRPE8i8m8vkVychQlv8uMPyTgoKQMuLm5KKdLhBrLsPFKWijKSrnKQrhruhgbphhShrBFPyoaZYXtAnBaWaZppyvSk4fyOxR4XdEnD4WZhKutC6b9GXADAqmEU5lgJEWQNEY7IYfzILM8H5nrkFjTCFuqbyHgPYHqWPmpYyBxSpsKtoukrYfHNHAJXpgYeZSJUgBabnOZpHNJbKu6fJZ6SDLXNDFgP5kxYFhmiFowPTLzLTtBKqYFupDzLLJpWNOYHgY8DpWFTLBpfLFpa8MFaSqFcFurKIYFTrLJPJIpEbCbH6pIBbC4a7rbPbGZXlC7EyJICkJ7H3j7AuKPgHBPkHOYUaXtDkrZZpmJQ5byunIKnaW5b4R5ZZuZItJkLAHgMVRwaoTge2LwYlCVKlNIeaCIVSmIX6e7MVAIelDIdaTVA2HQLbooeAXFCoS4dwWgBoa3Naf1LoYcDND1E5eNIFVNIpvNFQH+MwEgKAOUHAAJHgKQiAOZOZEAA="}
import { createPublicClient, http } from 'viem'
import { mainnet } from 'viem/chains'

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

:::

### Arguments

Logs can be scoped to given ***indexed* arguments**:

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"3095b8b1491d0c6018d409eca9ee1a4feca1d6c25ab89022da16dbe754ac9519","data":"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="}
// [!include ~/snippets/publicClient.ts]
// ---cut---
import { parseAbiItem } from 'viem'

const logs = await publicClient.getLogs({
  address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'),
  args: { // [!code focus:4]
    from: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    to: '0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'
  }
})
```

Only indexed arguments in `event` are candidates for `args`.

An argument can also be an array to indicate that other values can exist in the position:

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"2846731570cbe4a8f7c2e3a755952378f970eaf0c2a6b77e1cf3e9998d6e3cf7","data":"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"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
import { parseAbiItem } from 'viem'

const logs = await publicClient.getLogs({
  address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'),
  args: { // [!code focus:8]
    // '0xd8da...' OR '0xa5cc...' OR '0xa152...'
    from: [
      '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', 
      '0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac',
      '0xa152f8bb749c55e9943a3a0a3111d18ee2b3f94e',
    ],
  }
})
```

### Block Range

Logs can be scoped to a **block range**:

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"b5c3141128dfad0d3935757ea6210dab042f02fb9706ee6ead57722712ca1ab5","data":"N4Igdg9gJgpgziAXAbVAFwJ4AcZJACwgDcYAnEAGhDRgA808AKAQwBsBLZuASgAIAzAK5gAxmnYQwvLM1JwYAQQBG7AJI0AtgB447AOZhmaQaRi86NMFDi84aUuzB7eAH16nmUSawy37jvWQAXVd3GE9vX2EAa0gAdzBggD5GXQMjExhEXgA5WVIIOJ19Q2NTJN4AMl5GVJKM03N6GCsbOwcnXgB+Pw7nCxbrW3qysx6Y+KlsgGURzOL00YrssBgSUj43OsXMpsshjy8wH16A4O7hncaB1rCI499znoBRUgLSLQAdEAU0XlZwnZeJIzGlSrtTABHQTsUxQAB032Wpyc5xuQzBDTGvAmhSmvFmV3gC3B5V4KzWZG41OyAAVZPJlGpNCSsUlPmB2BosBBSH8ZHJFCp1DANJQQF4RAhECB6YKbPhBBpmGAALSHZhKAG8BQAIVUvHYmhqMHhenh5jevIo5hIYDQNqEonEkj4jjQEF4HOAAAEOGBol6wEyOQBfDmGzTitDMPTS5DIEAC5hiqiY0a8VW8AASSpV6vCUE12r1BqNopAQQoidMZTACCocvkUF4vv9gaZocjFariboKawAPFIkkQM1zNFvAAvNIGUKJxpGAByJ1iCRSJRsFUiGAAeX4LCgUFMcBseKpvCI7BgcTCdZsjBh9oATABWABs3CX3A5AHpf7wgG8AAej0I71n844iho2TALwhgaFkXogJurDbnu/DfAA3LwmA4Nk3yri6YDYX4RgwAAsoIMYqBwmAESAV43th8KsZW1YgP23JDlQ4FjsKxozgKjICaKjDIBGvD/oBoG8HxkGiTBrbwSmSGERAECkXhakgER66kXY5FUTR7B0RgDFMXEpGOFg1FwIgrGIlIvArsIa6SAIGmMLqzAAF68JuGyXtet61iY9Y1O0ARfhQklLu0ghiLwPn+XBUWdAhMA4aGS6xWAQTcJWVYgIZfJIAAnFQAJOGg+BIAAjM+VAxqQegwAwMrCfO0Hiv6uCIAADLx+CyMwYhkBVoYUOg2D9QQxATc1Fh4PJ/wQHG2QAOLtQAMutcAAErteFAAqs1aMAkmAYckQqYhDEnaQKpwPwZDYVddxHCc2kMZS9rvc512FrdNl2dkN0PLwqAfUBn23T9yGeMe8BwADsOwxDJyZQx/AFBoaPo0D9wnI4sC0DAUDZPYghZR9U2tjDQGY74CPfEjJ6oyAWGM0TX2+NjyEegThPM4aVh0BTVOkDT3OA7w9OXXLGPA5DrMgE+aBvu+wvo6LAvfEQbA0zroZBLL9PQ3LeuqQ9T31q9pA66Lat/WgTsqyTYC2Wg9lw5DluE7z8OzQx7MozryvE/zNvIbjED41zPN+57ZOS7h0u03LCtJ87IeI0eHMR0zHvR/dguaYnSvF1HYup5T6cy3TNqK4Hycs3n3wa1rRdB5D+uMUbMAm2bYZVji4v8I4FM2vV74AMxzwNS8DWAM/z4vA2vivSTiqVHUACxz1VLR6LVSD781shtR1ICsPtvVT0gTUgCII1PeN5CIO+U0zTgeCEOsaMy0ZSrVslqdgIgADCHAWhoFgh9MaI5hBwPHrASeqwoCy1hpuNAr8ujwKroBDQghWDiBEGwVg+CAoaQBCqUItJaziH4BgLQVFSEQIoT5XB+BdxYGInACobhhBoKnpgumoRhEwHQRTLBQFyGvxgCdLkSEwBKiUGQWRgERAiHYFgI6ngqH8DYPIUILdA5QhpnYKhjBkyIRoHIbIkCdF6JgNCeAaA5SqXsTwacFQGHx3YPILQTjdFHTcXYI6dYzo4CSJo+WEiJ6iLia/ZgjgCGty1BAEQ0Rni0EHLyMgvszGt17icNBzASEoOKSUyOfM7o6WeLVQp5CSKVxqSLEuOJSCsAYvgNAaAsD2X/O1fAzSVTwgkD3EpotmBYHYAAVW6b0/pgzED/lmeweEIyxlgAmRAX8Gypmw1DHE45pygKOV4LPXgGgCm8EcucwC6x2DMOzFwfAVDIEjUcAANTIC8jAby4D4AAGJSCEYkjBcSTkfUue+AAHDcu5DyPromyFoVaIgYH2j2IMGw1TYYoqzlUXguSxoeNkOINgWhHJJBSPwMA2RGBYuvPaRx2K0A0tYkkPgU4Kgstgbyio0DWWctpebXeLUOofmPjVOqiBGqX1au1PAYCOBQI5Q/VYT9hqjQ/g1cqP9qCzX/gtcgS16BMCwAUHAfIMB8GvntDavALofWtmXb4j1noO3djXF2do3ZtOrnU0GPtwadIDuYzpasw6nime6nSccE6PLbrXCW9dqaZ2Oc3HO0aO4gFjZzFNCaGJCyDR0mupN01S0blnHNhDU1qy7h+eNnT+6G1YMbct8sR5gAttUktyEvX2zet23O+FkKu19SGr2YNU2RorXUmNBdw7dtqbdfuSbW2VvFuTDNGdoX1tbuOnShbt11P7mW4tnSq17prVmoC2cG0noYs27Wa7g0bpjgbQew9zZj0kdIqAa8F7LxXiBjeW8wApCvnAKh200BOrgJ4uxhSuXwkEagqRoihW8H8RoQJMB0M7yoJKaUIBInhRsMwf4gS/gQH4LaWBa04w3KMK/AIuFRnSAKFeWALZbHtUKU5DkWYAAiWTfZ9IGUM38TENDwmBb+MjBz3L1l/GqiBv5HX7VE6S2gA4ARSZWbJwy2TwFoF8vCEcGhtNGkVEoX8cQ1i2fk7+ewMAYC/mVI4X8XFBzwF/HfOMAB9V2qpguozVLwAAUtMXcORVQHVpJA3gFERnQF9sgAABiMkLOm4zZaCIwaTqzhlNNMEqeEvI9B+bAMpykd9bVwGU5Jg5cyWsACs4CSHVFgEQv4ADEeXr6RcKpfOMSAExJlGqmAtrUbBZjbI4QMCGkMoaE3IUM7EazHVIPWcUChaNAgY0xnFkWLTLYDLwNb+1KP7eiTAbbvZOIGe4rgKgXIeR8mUiIDwNBaSCHARq0VNpSs2i6kyaC8Sk0uXk0uDkX3eR/Dgj5sAqw/hdlh0uNzKTHBwARyRUQo4/gCpxTOP74QAdA/VSK2BjAzF48ZWxxwGO8qAXsM9b7KDSuMG4HlUMP5icQRYzYGczA4ipNJxys0u19p86KmmKVSB3yVVvifM+iAADsSrr54AKw2W+j9EDPxSe/exSA57PiNdpU1gCLU3xsTasgmA+CFqodlgatAAAkwB0p6FDNl0Inufd+/8E4QP5wIUiIweKMjeAFArtPMCUgx36OMcLfAAQeNeBxHwBA/AouU/6EcORKAkrKVIHhfVWVp95U6+oFfFVMpC1av6kfF+b9yUTRNzbk1MoAGLWoMAkATuIC2td2dqpbq23fpAMOl6o64kvsnQG6dINZ1hvnQSz9qt81no/aU0uia8bno33Xe9h6GbPrzROtmSei25prpeiu16d0X4bg+wCT7j2350m+s/PuOfDtLtaFXtbbJXSvBVOeeFWvTXV8XXZvTiANNvc+XVc3Hva3aaY1P+AfM1IBS1GUFgDgLgPgSHRSL4ZA5jBfB2Q8ZGZPW9CmbPeOG0QtNNPdXCCAG0N9S8QeH8EAFIdMTIX6ANXgGgsgOgjmdgpgpNVgh/aQlsD0bg90LWXgztGAfg7gdJXfLGOfcQx2MdP/EQ2BdfSGUNX2UWBdXWIw/Oegx/G/Z/OfLdQ/VNRg/dWtbNa/X/P1ffB/QA3Qj1agV/J/GdD/TNK/HfI/XCfNAAlwwdH9dQv9MMRHbkZHWcQUKHKMUjSTPAJsLPRUZUNUDULUMwUsbsDQE0M0C0Mgd4G0V2R0NyYiN0e0T0b0P0FbIMEMPtCMcsObGMSbFARMWxXeOYRoLMXMQogsTwYsUo/UconbEAMKfbQ3PIlsK7DsFQLsXohY/zHiF+EnXgKCQSdIkSBcZcPSDyVCdCfcSQlGYEBIC8SyO8KjGoN9L8IXaSICWSVaI40UWCepBiK40QDCLSfNC41pHCQyGgYyccMyCyEKFiNiF7XYj7fYkXX4iooSOcTIsSCSZyT474g4jE/4zdDSUEu/XSRo/SLmMiaE6iWEo0cyZCSyayTfeyRyOKcEzyCAbyPyAKWQPgJ4pYiKVIcPPQGKOKBKJKFKZSf3epbKXKDkAqRXEqZXBVfeBA9XOVBqZ+FqPXTqbExSVAxAC+TvPVC3RAQ1bA23PA+3YfQg0fa1cfF3e1ZgjQXUO+bJKhFQPQd0UID0rJaIE6WMBJGPCmOPHImUAM7JeCNRMgFPXCEM5gfgexXPfPV+TgsWLFQQWAUXCvMqE3Oed8OA+VNXPUpApNaM6IY0zUs3bvT+LA3+OaQfc1e0x3J0ifV0j0Ks70kvHFNwKs4M5waPbDWPbIqUPAKs2MjQdRVPXkRM5wdRfgO5PPAvTMxwbM3MyLfMjqZ8LXBvaqOvJABvcsm+bsz06sqqY3Yss0jAhs02XiaAOaJHH7OCcghcGHHPHHa8DQQnDkVaSLacQ4yXI0aQGnCBOne0WXRDeXMxQtbIJcL3ZgAaJQeFVXcqeqEQd8Z8eqeFJQIskQeqKAeqcqKAfeZgZ8GAcqGAJQAaHcIsgad8Gi/eeFRU5yV2bId86CZcV2MQu2RfUgW4hg3dGQvGOQuwhQzg5Ql8D8NQmmd49nN0qs7IWeUDZeVeKSACZAAAQhHFzOXJEEEDgCCEknPMDJUvXiXig00qhl0qfM8kMuMrDHGxADsWYCQFABuF0EkDwB9hAFDFDCAA==="}
// [!include ~/snippets/publicClient.ts]
// ---cut---
import { parseAbiItem } from 'viem'

const logs = await publicClient.getLogs({
  address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'),
  fromBlock: 16330000n, // [!code focus]
  toBlock: 16330050n // [!code focus]
})
```

### Multiple Events

Logs can be scoped to **multiple events**:

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"f8180da919d8353735bf12853d61db5cdecd3cbbc014d8e884f85376282d7b1e","data":"N4Igdg9gJgpgziAXAbVAFwJ4AcZJACwgDcYAnEAGhDRgA808AKAQwBsBLZuASgAIAzAK5gAxmnYQwvLM1JwYAQQBG7ADwjJcNLzjsA5mGZpBpeLzo0wUOL1PMok1hh1pS7MHuQBdAHyNdBkYm8Ig6+obGpnDIADogrDAeaPhxXub0ida8AAy8APy8AKKkpBCkqnEK2glc2pIwYYGRDaYAjoLsplBxPryhAMrhQVGqARHBcL0WmTZjw2YFc802A0PLo2sTPtyhAAqy8spqS1sxYOwAtlhl2jJyiiqUIA4iCIgg+/c2+IIXzGAAWjsUGYSgSvAUACEAJK8dxoCC8ABS/QA8gA5XhnYAAAQ4YAA1liwEczgBfJ5oZh6N7IZAgO7MC5PE5RXgA3gACV+/wBACUYPZQeCodCQF4KPTTJEwAgqJ95FBeLj8USjhSJfS6EysAknhpZdpQexeABeaQHB7sRixKS8AD09t4vAAegUDVpeMbQsDHM5ULxDBcYKE4ko2P8RDBUfw4gBuXiYHChkBCUTiSTxlxGGAAWUEVJUHEwiAAdOWzs6AORpsQSKTh1iR6P8FhQKBRGwQADuYDIfCI7Bg3dsMBlNkYHTAaAATABWABs3CrFErvCrMBI094ABVSP84PwyG2O/AbO5YLQYEr+KULhQve3O3CrHRr4mIA+p7PF16LhBhDQZdVzALxuHFCUQC0WQGEQABOKgEiSfAkAADioKlSD0Mc8DuQ5HkQ9xcEQbIqBEfBZGYMQyCQOCyQodBsGIghiBojCLDwD1qggGlQgAcTHAAZHi4AFGUdyY1RhFgfgiKgB9fTAJxeFQNdnUU5SgxDLEQAULAsFKIg2HjNTR3sP1EyYlNN0SNATLtdTBQcJTnHcLACzgH0nIs1SHOdfyNOcJNtLiexTzgOB7P86KzOczSmRCkAez7UgopixzzJcl9L2vUJXEEGA41M+jlVM6LAss5MdLCzs0vSiqtJTeRX1SkAir88rvKyi83ygPLSAK9ropK4AyoCrrlOClNv3nBc6pihqEpTIzWAK+ayS8dqRtMxbgxTPcDyPVqhvGzLJqsnSbOneaKrcjyvLO/1Ro6064qCi7QqfM95s6x7AyWnTbwgC4fteiyeqvPrEwGwriofZ70oyt7KsSmrvrasakYsxqdIRUGse619If6wa4dKl6CfOqq4hmxd8di7GAbiFa1oxvyNq2iVeGkmBZL7eTudfPnry/IW5J8FlMNggBmBD4kSPRkiQAAWDDZGw2D4hEp58WImcyIo/dqPIRAF3oxicDwQgSHIdj6E4zRbkEMF2BEABhDhbNCBH/KojRANCHnhagE7nXDNByLyb3Md4C5BFYcQRDYVgo94JQIAgGopAAH14XZpXEfgMFUfME9d5PISMcjUSwDNZV6XOg7k0PeDJXhG7F/mW6T8iYB3S5tLAX4lDIbuRHYLABXsVP+DYeR2/JxHR3aeA0FTxhGWDGg5FCN3x8nmAV60T4Eu3ngzV6fPgfYeRVD3ieBSPtAxJMMAJJwHwW7bjuZOb0zyOYO4aOFM06sAgCIAkhRaC6jKGQTyi8l5gyyjJZg8c0DAMQYjXaiVCjJDgUnMA9Ml4VRMKwFM+A0BoCwJ5R0Y58D4P+KWCQRCsETWcMwLA7AACqpAyE6QoVQmh9oOHsFLHQhhYAmEQGEZwlhzoyQt2Goo/y5ZSy8AAIwLljrA3gqjlHOhtuwIunIuD4FTm7Ci7gABqZAjEYBMXAfAAAxHOgtf5d2Ki3VRvAFyoW0aYXR5YW7TCsKEdQjteAiE9tuEJWQfbpT0cVXgAAyIotAqJoE+OINgqhVE+D8PwMAoRGBRKHNOXe0S0C5PLNsC+kTKl8FNL0D2ZSql5K2pLGCSA5z63lshJA6jemYQ1rhZ2HB3aVJ1kRJAvSAFG23gMuiDFqBMStqxW21AOLvA3qUHApBMB8A1sJXivApKdxFgzLKvlfrIxxpUfShljJsxuRZKal0tx2WeUg5Sd00DwIqtc1hf03mfXCpFL59U2H/T2jpZKZB6a3SJrlaGpN2bwxjhVEFIA0YRQRVCu5UFMjwohQtKFENkX5VhmihBkLgUfRALTOaJKXlZQJSzGA61NrknRX5bB+19yyiOjdKFWKrqfJboi9yfyHrI0BbS5GWKcXgv0Zc+KMK4hAxBsy75rkkVQ0pV/HlxCRX0qVXiv6BK8basprqnK+qYaGppaSul1MGXwlmua25TMQDss5ZzUW7iLlN35gG3m4sWBYTgKnASaBjlwBPlvOB1TSwNzcWG/mjTL53hvjAZNEsqAvDeCAF+pBZRel4BwT0EB+DmA+RWkSscq74HcHoRM9DpCGXYLAJUm8xxwNLGcM4HIAAi4D4ECOoYgR0g4YAXFLI4+0hbhF1k0PadyLsRD2iOSJIdaSdQJHHZQydjpoIQJdmgAAXqWDQFwt3sGSM7e03ZNy3pnbe1wMAYD2j+O4e02orgHvtGAmkAB9MVAJgORUBMiNE6J+S7DdrwXMdDoDwOQAAAzoSB7dNJ0NeEYBOoR4jTC/FLGUPQf6wCLpsmAvZcBF1jpkTfe0AArOAkggRYE3QAYiwxrSD4E1Y0iQHSBklFmRUHVjYDkKp3BEhjXGhNfa5AaklCAaUr85S6QrTfOoNaxX1ppGo2ThJeAKZEiWt+TFVNanSQB3AVBLjXH2cqSJdgaC7DGa7FptkHwTofHhK00IaAXFbgIO86431VjOE5m4rmf1gD7NoNumrItDlvQA9wcBouENEBE0ptkzRucFB5rzEzWmMB9plopjb3BJZAs6VwB5nPoN4BOxg3AQJkm4GcLihmbDmmYN2QB2gCvTlLDhuAHWIJUGgvspAC45yIQVkrRAAB2NWWEcLvEm1MvsMyDaUWNkgaWM5zYrMtu8a2bFNn222QZCAeyDm1tsv8qFcrVXOAJXpB7K1hUusSmK/7yNflvb+h9llVNUZfVxdaz70LEpwuOhisleqSZUuGkaoFCrTUw+VSji13rmqwGRyAxFdr0eOvic6nHrrGWesZuqn1bBWZfy5WAbavL8XeoOoK4lEqTWuqBySyV914cQ51SjFMZq4d8sBneBnhMKcoox/5TnxqAfS7x4rtViUrUqvJ71SnZNqeQ/enT91dNZfc6Z76klHNyReE6fN9bG2+mKxQqbTbIz3hiq07rE7h35k0UQGd5ZwU1k20pFskALAOBcD4IFo4qhYggAMz9x5rATzPnJUqJHD4lXZV6joIlpAvyW60eynrlB3mFd54eY8hfc/heBgXvHRfIYfnL9OWavAq+pD8KyEIKk4jp4ecQNg2ezwd/fPnx8YKZ9KmJ2QbvP5K8s5gNXh8o+6316OlPiKi+W/3nnznvVXfuYV77xv6vYEZU+Wp3L+5v2nkC817X66IvUdSrB7K03kvFVtdrdCcmckcddbUjcVcqcCdadocwVwCEcmpS8EDc9jdqV/9nREl2Z2d1cVEglHcYsrg4sk8CJngx08AFQzAfg/hARgRhQGhRQXwEQYMMRiQTMiQzhSQOdKRqRaR6RN4WRNg2QORuQaD+QnJ6CIQYRxQ1MNNS0tNKClR2CIQVAbM087NdQHMQA+tjQisSDrRbRnRHRnQ3RIkIlvRxdgBECdJGxmwYwswsVaw64sxoIaB8xCx2BiwMAywKw7QaxhAV0GwIxRAWwD8uxex+w+8hwRw5Cy1JwK9gI1wNxd8BUG9SAwij9NU28F9m8ERV9e8mQAJpxEjQJwIvBII5tYJUIlt3dVt0JqB1ZtsxN7gjg9tiJpYg8MkQ91FsgNoyJoBmJYsXMrD9CwtUsqwotB08tDR+sishsRtpAysfNxtJtKs1w/dQh9CbQHQnRkAABCDQWAAQcBQQTyZWLwUyZIwrDPCfLPJvc/Ofe4u1EvFqfI38KvFcS4gzPfRvdvZvLI0/afXIz8S/Hvd4m/T4u0MCLrQTEALeZgJAUAEJXQSQPAP5EAMkMkIAA"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
import { parseAbi } from 'viem'

const logs = await publicClient.getLogs({
  events: parseAbi([ // [!code focus:4]
    'event Approval(address indexed owner, address indexed sender, uint256 value)',
    'event Transfer(address indexed from, address indexed to, uint256 value)',
  ]),
})
```

Note: Logs scoped to multiple events cannot be also scoped with [indexed arguments](#arguments) (`args`).

### Strict Mode

By default, `getLogs` will include logs that [do not conform](/docs/glossary/terms#non-conforming-log) to the indexed & non-indexed arguments on the `event`.
viem will not return a value for arguments that do not conform to the ABI, thus, some arguments on `args` may be undefined.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"f22686f79149bed84a76e81ddc012ed26be4f41fc8c6815167c98d7422cea549","data":"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"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
import { parseAbiItem } from 'viem' 

const logs = await publicClient.getLogs({
  address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)')
})

logs[0].args
//      ^? 


```

You can turn on `strict` mode to only return logs that conform to the indexed & non-indexed arguments on the `event`, meaning that `args` will always be defined. The trade-off is that non-conforming logs will be filtered out.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"a0157c9af4ce233ac187f2f009a64097572ab56f898da9042c9d2424351adac1","data":"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"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
import { parseAbiItem } from 'viem' 

const logs = await publicClient.getLogs({
  address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'),
  strict: true
})

logs[0].args
//      ^?


```

## Returns

[`Log[]`](/docs/glossary/types#log)

A list of event logs.

## Parameters

### address

* **Type:** [`Address | Address[]`](/docs/glossary/types#address)

A contract address or a list of contract addresses. Only logs originating from the contract(s) will be included in the result.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"2beac861a2e41e1fc3a79de11edaacbc24038f2e974fa0254d0e7a75fd7e7929","data":"N4Igdg9gJgpgziAXAbVAFwJ4AcZJACwgDcYAnEAGhDRgA808BjCMONAAgBsIBzORdgHEYaADK84AJREBXUmAAq2GAB4ZYWADMAlmBhQK7dVt37DxmDr0GjGy6ZsWr+gHyUQbAIakGiAGxUnDBgPGj4SAAsVGjePCJ43HzunKZIAAxUjPjenow05P4AvhToyniEJOTRdL4gzKwcWDIARimMAMIpwWgCwAA6YOxD7LnM6j22JtYA3APD7M2eaFkA/L1z88MAtjKcaNqMnpycawsQEEGegwA+7AAKpCL7mhgqALK7+4fHAEJLWQB5LD7FhwFzsW5OByzQbDQoQyb2GYbIaHLIwBTaLYwARgGRbZpkGHzRiMbRYaSeKCnTRHOAwBH9WGbdiPACOMngaFOAAosDlsfl+Ox2mSKTAOVy7gKRGQ4ABKdgAXnBDwgW209JUovJ0klbGkaDkimULmJcIRUORzPYWU8unWNvmrQgjAA1gBRWhYbiPUjCpkslmPKksTgYdhaTyfR1BuOsmChsDh9hgTzYgR9EAesJyw5gLPm+ObENQMMRuScTMENBoLD8AD0DZE+DzVwAdNoIIWUcXhqXyyMsNoAKqkKvsLP4Wv1xBNzzD9stttgTsQBsL7Q9p1BwpFzZ73vzdsn9gARj87C2EEe7BP7f380q2heAAlPHB8Kd2tldAA1MgXwwd9PwAMRuRFnCgfdDxte92D8AAOK8bwZe99xqYIoAEFR6jYW0ujADhMI0OB2EDIN0N7eEADJ2C9XI0GlHxtCOFR7xcFweU0MABB5RhCImTptG6diTxcRUVQIkSiMk8FhNEjiYUKdwvB8JAzwATkCYJQnCRAzwAJmiWJ4kQEAmlaA4FKI5JUkQDI6myUhGLIDTNOKUocHKYg3Oqeg8D5UgIBwHwMEVOIxAkHCrTMSCHHMOwoMSqY4tiqAuNiOBTmEKK+GY9NZX9NQkoS+LrBSpE0tKirytcS0av0OT7mCjUtVy8Q+ENY0lBwErUscRrBoGyrkrqjK3CoMtGAQczuvkMjPC4TUOAgTR2BgEgiK4CQr3+fBdB4dhc3YLBgqIbRYCgU6ZSFdsBgGABadgABFXWFac60bBsLpgLZ20/BtprgDc8i7VgG0stoG0izq4Ce+jaHTH14AET7ZybLx3SstAAC922YLYYe0MIWgbAB3Taid+om0EeGAGy2e0wGbJGthRkHEjgAB9TbukermEYAKQAZQBAA5R7JDudp2DeFtoGFZAAAMW252GJGVgBdHl0e+5dHnxdsbx4ZsWdgEhuFCkHgY3YcQYAKzgFhHtILBGAbABiNXIq5+V3BiJIUGQCyBXcLL2Ge4AAAEUjAN0hBEOGCsFOUVK1igQ8eI0FvcABBZb8LWjato4Ln23I2PdATjqJHmk0cHTzOQDoZGgncLEsBvDhgFtEMaDuFo2hstBDHRwx+X9GA8+abQAEkaC2dh4U0Vr2AAchp9eBk77vyL23Q9A4Fe183kSibtXQ4G3gswDwjgBJkjglT7xMB6H6zBJ5CjL94g+wCPhQDYdMrhwC7j4NGM4eTyiAWAQo8oBj3x2nwZUIxyb2gfoJdsGs+DQJAFrDOHgYjqUQAAZmMiAIIIQwhIAAOwmVIJFPAOCECBHso5O0Lk8huTIYZTy1AyjmQqH5agNRApnRCmQTAioqRQEeHAbKAhlZpFoAAEmAGwUgh1CjKwRMotRGi6baOVsgLWDUBruGBngPOUA5HwDIjeQuq11qyPkfSMiq91TsHJgdLIyCHFaJ4LoJY+hVLEN8BEKIlDdI0MQPQ6gplaiuPsXZPQGlMjOVcgUPhhDmCwCYKCMuu0X6eHQSTU6H8OhYJYd/DYySFECHXiozQpDNKaCgH4GAABWM8ngqSIUQpoPwmgIiMBgH4TwzQBmGVoTMzSjBNCLOaJpQyhk/B+HXoYJs7BkAAEI8kMk0K6GQcAtYDHge4QUngkCgBInAcGeA0AIEKIUIAA==="}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const logs = await publicClient.getLogs({
  address: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266', // [!code focus]
})
```

### event

* **Type:** [`AbiEvent`](/docs/glossary/types#abievent)

The event in ABI format.

A [`parseAbiItem` utility](/docs/abi/parseAbiItem) is exported from viem that converts from a human-readable event signature → ABI.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"db241cea0458c9ad817721d71f95640ec37e56a8be8c6ce2f93e399540496d87","data":"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"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
import { parseAbiItem } from 'viem'

const logs = await publicClient.getLogs({
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'), // [!code focus]
})
```

### args

* **Type:** Inferred.

A list of *indexed* event arguments.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"88eb3623f9e99be62d1839fd5749ccaceabdf7d50dd67e7a2d9e955ed430fad9","data":"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"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
import { parseAbiItem } from 'viem'

const logs = await publicClient.getLogs({
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'),
  args: { // [!code focus:4]
    from: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    to: '0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'
  },
})
```

### fromBlock

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

Block to start including logs from. Mutually exclusive with `blockHash`.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"0fb02a2e82e76ab38d4c0402f8e83dd2b1aba8fc642d367f93d70c7e17071cf7","data":"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"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const filter = await publicClient.createEventFilter({
  fromBlock: 69420n // [!code focus]
})
```

### toBlock

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

Block to stop including logs from. Mutually exclusive with `blockHash`.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"b6d9f6a0e070cbedb5295b2ab70f54cbe5f8e8d35447a051a0b2097ec052ace8","data":"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"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const filter = await publicClient.createEventFilter({
  toBlock: 70120n // [!code focus]
})
```

### blockHash

* **Type:** `'0x${string}'`

Block hash to include logs from. Mutually exclusive with `fromBlock`/`toBlock`.

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"e3361f02cb939ab5c5cee282111455635b7a1eb6edee451133008fa200d7ec74","data":"N4Igdg9gJgpgziAXAbVAFwJ4AcZJACwgDcYAnEAGhDRgA808BjCMONAAgBsIBzORdgHEYaADK84AJREBXUmAAq2GAB4ZYWADMAlmBhQK7dVt37DxmDr0GjGy6ZsWr+gHyUQbAIakGiAGxUnDBgPGj4SAAsVGjePCJ43HzunKZIAAxUjPjenow05P4AvhToyniEJOTRdL4gzKwcWDIARimMAMIpwWgCwAA6YOxD7LnM6j22JtYA3APD7M2eaFkA/L1z88MAtjKcaNqMnpycawsQEEGegwA+7AAKpCL7mhgqALK7+4fHAEJLWQB5LD7FhwFzsW5OByzQbDQoQyb2GYbIaHLIwBTaLYwARgGRbZpkGHzRiMbRYaSeKCnTRHOAwBH9WGbdiPACOMngaFOAAosDlsfl+Ox2mSKTAOVy7gKRGQ4ABKdgAXnBDwgW209JUovJ0klbGkaDkimULmJcIRUORzPYWU8unWNvmrQgjAA1gBRWhYbiPUjCpkslmPKksTgYdhaTyfR1BuOsmChsDh9hgTzYgR9EAesJyw5gLPm+ObENQMMRuScTMENBoLD8AD0DZE+DzVwAdNoIIWUcXhqXyyMsNoAKqkKvsLP4Wv1xBNzzD9stttgTsQBsL7Q9p1BwpFzZ73vzdsn9gARj87C2EEe7BP7f380q2heAAlPHB8Kd2tldAA1MgXwwd9PwAMRuRFnCgfdDxte92D8AAOK8bwZe99xqYIoAEFR6jYW0ujADhMI0OB2EDIN0N7eEADJ2C9XI0GlHxtCOFR7xcFweU0MABB5RhCImTptG6diTxcRUVQIkSiMk8FhNEjiYUKdwvB8JAzwATkCYJQnCRAzwAJmiWJ4kQEAmlaA4FKI5JUkQDI6myUhGLIDTNOKUocHKYg3Oqeg8D5UgIBwHwMEVOIxAkHCrTMSCHHMOwoMSqY4tiqAuNiOBTmEKK+GY9NZX9NQkoS+LrBSpE0tKirytcS0av0OT7mCjUtVy8Q+ENY0lBwErUscRrBoGyrkrqjK3CoMtGAQczuvkMjPC4TUOAgTR2BgEgiK4CQr3+fBdB4dhc3YLBgqIbRYCgU6ZSFdsBgGABadgABFXWFac60bBsLpgLZ20/BtprgDc8i7VgG0stoG0izq4Ce+jaHTH14AET7ZybLx3SstAAC922YLYYe0MIWgbAB3Taid+om0EeGAGy2e0wGbJGthRkHEjgAB9TbukermEYAKQAZQBAA5R7JDudp2DeFtoGFZAAAMW252GJGVgBdHl0e+5dHnxdsbx4ZsWdgEhuFCkHgY3YcQYAKzgFhHtILBGAbABiNXIq5+V3BiJIUGQCyBXcLL2Ge4AAAEUjAN0hBEOGCsFOUVK1igQ8eI0FvcABBZb8LWjato4Ln23I2PdATjqJHmk0cHTzOQDoZGgncLEsBvDhgFtEMaDuFo2hstBDHRwx+X9GA8+abQAEkaC2dh4U0Vr2AAchp9eBk77vyL23Q9A4Fe183kSibtXQ4G3gswDwjgBJkjglT7xMB6H6zBJ5CjL94g+wCPhQDYdMrhwC7j4NGM4eTyiAWAQo8oBj3x2nwZUIxyb2gfoJdsGs+DQJAFrDOHgYjqUQAAZmMiAIIIQwhIAAOwmVIJFPAOCECBHso5O0Lk8huTIYZTy1AyjmQqH5agNRApnRCmQTAioXTuhAl+AQys0i0AACTADYKQQ6hRlYNQGu4YGeB5HsGLrIhOaAIDsF0AJGQsBkFkVXuqVSxDfARCiJQ3SNDEDaWoKZWopj5F2T0BpTIzlXIFD4YQ5gsAmCgjLrtF+nh0Ek1Oh/DoWCWHfw2P4j8+ABDr2UREQ4tCYAwD8AAVkMlAMptC/C0MQpoQyfgYCIUQrQxgZ4IiaU8M0NItDSFlM0BEM8sBSG0OaIcKpiFGCaU0H4KApD9BlMQoZCImgzxlOaLQiIUB17sCbOwZAABCKJDJNCuhkHALWAx4HuEFJ4JAoASJwHBngNACBCiFCAA"}
// [!include ~/snippets/publicClient.ts]
// ---cut---
const logs = await publicClient.getLogs({
  blockHash: '0x4ca7ee652d57678f26e887c149ab0735f41de37bcad58c9f6d3ed5824f15b74d' // [!code focus]
})
```

## Live Example

Check out the usage of `getLogs` in the live [Event Logs Example](https://stackblitz.com/github/wevm/viem/tree/main/examples/logs_event-logs) below.

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

## JSON-RPC Method

[`eth_getLogs`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getlogs)