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

# `reward.setRecipient`

Sets or changes the reward recipient for a token holder.

## Usage

Use the `reward.setRecipient` action on the Viem `client` to opt in to rewards or change your reward recipient.

:::code-group

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

const { holder, receipt, recipient } = await client.reward.setRecipientSync({
  recipient: client.account.address, // receive rewards directly
  token: '0x20c0000000000000000000000000000000000001',
})

console.log('Holder:', holder)
// @log: Holder: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
console.log('Recipient:', recipient)
// @log: Recipient: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
```

```ts twoslash [viem.config.ts] filename="viem.config.ts"
// @twoslash-cache: {"v":2,"hash":"f5ce74de204b861af6e50e55d4661b69b789937a75a119d1940bc87040694010","data":"N4Igdg9gJgpgziAXAbVAFwJ4AcZJACwgDcYAnEAGhDRgA808AKAQwBsBLZuASgAIAzAK5gAxmnYQwvEaRjMaAYQ4wwaADxpSzMHCwRSaXnRpgocXgBUtOvQYrT8zdlOMqzvBY+e8APr2Gw/M4wULwAvP6mMEFgIfbMIiIQwmgA8qQAglBQsnDmrqbmGYnJqr68WTnw5n4B0cGhEXUxcbykWCIAyiL4MAC2zEb0buYASh3dvQPlzQ3hkYENAHyMWMxafTA0pHCIHsqqCpJBAOYa1rr6aPY9TmDxJSnplblw9u1dPf3MS9x7AAqyNDifgYNRKdgqdSabSXOwOO4PJJPTLZV5DEzuF7VXgAfl4gK2ILBACk4JJxiJisjVGoEjS0qiqnklkteHt6aVGdi8u8Jl8BqyADpgdh9WyGGRyRQHBhUOBodYMRAATiorBUJzQ+CQAEYAExURWkE5bPBS+QwCFQyggDixJAABioty0YjISBVAF8KOhsLhEARiB6jcYmGxODwBMIxBIpPhgVg1B9Jt8MSNeJTU9NalEWo0FvVYlB3swAO7pwq8ABGEAgGu0834bDgMBWglIrFxewVpGcJxmeYaN2O7BO3d4AAlE1ZYRKjmBTsn+VNmKWy789tO0FhZzYrsvPqv10sRWKJbwEzvbYqTggUMgQLA4DJ2FhxJJbQpZJbzINJxYFj/LwML7gYIGOJKkixGI5hoBAvCDCSnSpAAcgAtKM/wKBU/wAJIAHQgAAusR8rGsq+oAMzqpq2pIAALEa6ymsqBCJra9oBs6ICugk2xINRPp+jgeCECQ5ChvQ4YcFwfBCKIH5SFggjVhwVKxpIcDnHOVyVu4e5woYESGRKNxeC4wxVp4dyDosxbzDZ3i5vZrScik+lFI8ZQuUWITzNSXJ2X5UArCIsp7NatKgUZ5mIoh3loJuBKqepxRKdpMVmQizhIlyp6iuKekqWp7AaRltoKkqglqnadE6oguo0dQLFmoGJVpZpOiccETouo4boCYg+rer61D+mJwaSdQYaBiwslRgpXW8GWbAamg6VxplFwXgUBk7VccXeHt5hOVIvn5o5FnBfmeUeSdFSJTdcwRIFHkXcsjDhZCqiRbKOlgdcOX3AlDLJQA6mtWybVpai3LloP5WeRXgatrDrTD3XkdViAMUxdVgFqDVNcxJptSAaMY11CDqr1iA8Xx7rkLjDHCeNomBuJIYzdJgbnnpb2qJVFFIAAHLqtGE/RiAAOyk6xeCC3Kdp0xLvEDfxHqqmzmAc0GEk3rNID8+BZ3CzjKo8RqUsNQArPL5Nm7TDqNf16ya8zuqizrE2c1Nhu8yA82RvJMZKSB/R6JjcCMH8vAA0ZnmWAd8Lw5ZmKnddH3FndZQPUrz3FmFEX7D90Ip0Dae50lfBhGyAAiMBJFo8GkHDFnVwVJuGDQRXR+bBienLBNE3qhotWTbG91H1M9S7auM0N+q2z7etc9NNCB0kOiSiXUXqNuu4V2osw5wILZtvYwAirwt81qwEAiAA1gAorQWAP7IOx7NfUh3//P4oCSFYBgXggRmCCFYGgH+N9/5wNvoA4BoCwDME2HsIUIALCRwQm/D++gyAYIANywPgQAuQQCwAgP8J2dB7Edy7AAPQMLoHg2QBEaAKliGgdh2CCK0AwAALyISQuBXpiF/1vmIkRalH5PwsGKGAexdSOhUeI/+28YSwQnL/UhvBkC0B7JofsxFIoWQXJowwfgdG6LvsgckHYRAwDwlAPYYBBB9GrGQExHgzGSAsYXEIajSFegCVAIJ8CVBwFGDAE47BewYAnGdcxg1QnhLgZEgAqqKCScA2DRPJKwCSiTfGqBSdnQJIj/59EgeIEQa0qLFLuMk/iqTKl3zICIAAbAxFU+oABqZB2BBDII05wzSxCtIkbwEJ5SwkiIIgs3gupba8D6Pg3gCyCJpL2nsOGWlDB7X8g9ax8DNlpK9CsQ5Lj9IhFrmyDIeQxxgDUJspY4ifSPQZARUYdYNqJXsKfVoJyNkLPebwAAZCCgiSzVnrM2RC3gwKzkiguQPZUuo8aS1HogTpDs2LfRtM7AMzVF5ayaqvAM+tuabzYsHOS0gfwyjLmoQ+pkDyApLOfVgrYlhX2kQ/Z+uDP5kF2IitpCDyFILAdECBUCYFTN0YgyhyDUGKN4BgrBRVeBCvwaQYRCrSFKqoR2VgtCrxYEYcw9+wqeGcK2DwoqfDBH6t0VIqZbr/4yOfvItBSyVGOjSRowacBtHir0QY3gvZjGmKaX4spYqDXwLsckUgjjnGuPcZ40g3iklxpabMtJ/8ZmFnzIW9pOhomxPiaMsA4zLEloaGW2+mTskiryfAesRSY1jLzRMgtYbqlQLKvUmtdbJm6I6d03pAy+zDNIKO3t9aOXnPHXfeFyzYWyChdsqy1y1BXMubukIewrl3IqI8k4zzXnvPsErb5vylYAqHEXVY7tNjbFFfvBcS5XlxyRaClFyMLwWiZYSkAVVB6NVts1a22KDR4vNIyq0so57ErdoNLW+p9QUsmgbKStKsCkAgDgAwGA+DuVUBOAABo6WgAASYAUbCZeio+UAufg70/IgH8hkoTbRAJEPeTBvRPlBXgv4VsAh9AQRgKXKE0KLD4DiStdg6MayycEK2UI/BpPRwgvINoMAACOgh2BbsbBRwwXBEJSBYu4+TaK9QyytvVJAw9jQK0DJZ1DjF0Me0Ejhv2eGeZsW7qJlIjnGoy1qrB6W7nWpsSVj53GfmmZ6l1IFqlG8jZLXDvwIjfROhNywMvTpT9dRqDvfliAhXiulfKwRVI74torEI+wIgloADSMAMBbjoPYYjGUJxVYK0VkQJXbZld1I15rWk46cYfYlEUKDNi6ASLJ6rtXxv1d1Pxx+Qm8I720OIX8NnwtlE24hXgY2JtTd4G1jrNBeBPx60RZid4kDIEfHQVBH9cBUCo4DtAcAgN6WAOdwwITLsAHIiCQj6Aw6eEBocihFNvBUiMPKvUSgRTbN2duMGh7RzZ0PuAikB1RkiFBHxrA2LaB7XWevXbq5N8r92+yPdky9jAREyKPiBB2LGIA70kTIuBkWjVRbD1i8TZqHnyZ45Z1N5L+NSWe1GiJSl68A4EaIyRzAfA041vKMCr1r9rW6tFcCshzAKFUPATU+VNi75GpVb6jV2DtUW6/i653hnbdSpNWaxMlqWE2o4WgLhDq9BOqESAJt0zzlpLNz6tVyjVEiKDfxENTvSH6MMX2QmOaSn+KsWG/+yaHFOOuW4jxXju21sXau+Bxbl1hsiZWuJmgEkN7Hf2xNRgdBZPa221g+TO0jN703/vujB21JHVP0p+aG3FgT5Onp/TBlzoXUvvtK+Knuub1CpZKy1lbuRVMnZ8d0cHKPaEY5YaL9FsPZiY9NyoBnoeXAJ5LyFlvJRXxlQAJkJmdFJqQDJtILKG9uLjjPqCTCPNLPbBPJ5urHcMlkgWrgFmNLrFrv7PhngGFk7DAZBlhi5jbEgEgfLmxEQVxBQalkNBruzLgcFjSjJCHNIPshHHatAgmp6gKubqwiKrnvAq7tKs2I7rwX7qIStmqh7lqjqj7vHuXi7pKsqtQqauqnQhaogEwmHvgrapHvakjrHr7i3knvyrIqnkov6oGoujnpIUmhGkxicMXrGrvvWtbnnvYqmtXhmnXtmovqXvvnMgPq3s+gfhOhWjEl3qQD3j4m4UEW3gPi2iPjsO2gUl2vET2u4UflUjUsOujA0oEfGkkROqmlOpvrOpCPOsUcvqUXfGEa5CEf/OuqfnCgBpfrursjfu/knJ4bfE/g0S/m4G/qeuEPchelen/u8iKCwnpBHlwpFlhriggQ1PFpPHgAsWaESnQagRhp7CvNgb7FljrkwIRsRmQAbiBBXFuDOMfByvYM2Nym2HtoJngIprJlhDhFlFcEsVRNLq5qqAhoGD8YPDsTivQZhpltrvgXNBGPSuaifOEZyk8TyowCahOM4aEiOIuGOBOKyhXN+mOEiU0Y8RfMlASbpAYCSSFGSc8V3CjIYOajeMwB9g+E+PAK+LNmAF+Ehn+FOIBMBKCT3JBBwWADBMDiBAhEhChBhF8bhIRKLtjCQQxKLFitLPjFQWJBxOCSsZgY1FRNCXgSFmcXrpcWRvpLsv8KlGVNHCyncVSeoA8VyjynylMmbgoUIQ4XAqIQ7nKt6YqqoVQjIbQpqnoF7oIXqkoQPjbnbqAkHpoeaqHt7jAAYVHsYfwnHgnh6g0cnvwVYX6hnlMlnlosIXAvnpGkYkXrUXvv0eWd4WmjXpmvXlkY3jkTPsErkeWlEtEdWjWUusiWvkPq2mkWPh2oUpPq2X3sEQnnPgUawEUVOdPjOe3uURvjOkMtUTvokYOSIo0SFGkq0ZurJoMc2l0fHAeowFcienfp/pMb/gRP/mAB8gttxkrKyIwPwGAHsF9HvP9L+uMSlKVOVFtA+b8IBfvGBUsZ0uPDLkgCsVqYGHtMlmqXsf5ogIaUcWvMaawXCQtKHIpHGPdjaSBbDMKUnGyuBCZBXEdOnBmKAbMldLZLMtXEnOxsEQFE9LMsXGXH9MysKbRZ3HHNacBXaQJcDJ3KDuBB1LabPMqZRJ0jFoCfAYhSADJaRULrQYgKhfqcokaSwUbKsGaaRnwFfmoJDOjNDNTGoKbvwZ6d/AGSoQHmoX6TwXWbGVKiGZoWGTgimVGQnh5WoQmRgkmToVaoIWmUYbwpmaYaIuYe6fmQotYUWeonYaGgPhWc4a4dkUEe5bYg2b4bwLXlmtlW2TuU0dmV2c2lEVWt3tuSUbuckcOakbkmORkZObmu2SuQPnOXUoUfVXUY1WUV0uuVvluf2UfvuaWiIpEhYKwGYBOKIc4cgMREfuugxMedujNeefunfsMVENcmMXXOet/pemBTehDvem+YlB+V+T+QSr9HJrSABcdRZVTBlGBWepBa8ksVLuqQ1AhQlngMheCbVPqZhZrrhtSoZfCYtGHERZTFZR9eRQ9JRZXNdA9AxRxREFjc6ZZmxVxdjRDqEjxVCHxVCAnNlFXJjqoBDFDH8h9dTZZgyReIjQzVtEsSqPjHBQacCRTPTf3KDZCZ7I6PpdDYHEZRcSZZafHI3M3PIPoDZRYYKn5VbmGr6TKhIXlRKs5cGaqqGZ7vZbFYGbrfGTQomSHmFXoWwlsdwhmc6tGa6vFXwZYUlYWQGpnmlWWRXk4VWS4RNWXjGflSmo2X4SVQHd1a6lVYPj2bVbEQNXvvUREs1TkukRPjUUuV1UnXAr1QvpneVQeauSNdOmNR1SXg1RVXuUfrNfNfYUtX7StWtYshiptaeTLbta/qFFeXfjeZ3XeadVMY+Rda+TxvlCsHdbwL+bxU9eoC9Q3E3PoArW3HPTPVBfJUgFRPBqsfBXzSDSrPPAzBrGlhhWLdlhLbDXwEjtHLHLsijbuuYGjbRUnLjciaxfnITRyqTY9ZBeJUzTdWenLYva3O3PFMzVJT3NgoLcQcqJvUpeQY1OPKpVfXJfvQGMosLXqKLWLkkLAAQYyYigytKMhmXPYOavYOpdHPYGzXplDgVrwLDvDijoVBeODo+q2fYMgxlNMgIHQww/0Ijtgkw7Me/HpD0Q9cZIQ5aPvIwNYpZnsCNjVvjqzrqITsTgsqThQLAmnA3pFdcLAsKXsOarHJo8+WTn/ARHtKsCRdHGYwMZY9Q9TLYxspY5w1tLHNwLaO+swEgKAAUN/p+CCQgF6F6EAA"}
// [!include ~/snippets/tempo/viem.config.ts:setup]
```

:::

### Opt Out of Rewards

Set `recipient` to the zero address to opt out from rewards distribution:

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"60385a192e83fd455981e8d5654018ad5c581d75b3aed83cbe13a77c3dbf5db5","data":"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="}
import { client, token } from './viem.config'

await client.reward.setRecipientSync({
  recipient: '0x0000000000000000000000000000000000000000',
  token: '0x20c0000000000000000000000000000000000001',
})
```

### Delegate Rewards

Set `recipient` to another address to delegate your rewards to them:

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"f6d6b832759eda581bacf34c050ad8088a613c3645bcb99c6ab360d5267d86d4","data":"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"}
import { client } from './viem.config'

await client.reward.setRecipientSync({
  recipient: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
  token: '0x20c0000000000000000000000000000000000001',
})
```

### Asynchronous Usage

The example above uses a `*Sync` variant of the action, that will wait for the transaction to be included before returning.

If you are optimizing for performance, you should use the non-sync `reward.setRecipient` action and wait for inclusion manually:

```ts twoslash
// @twoslash-cache: {"v":2,"hash":"d462248db3163858725159f1cf3a53bd637f09a287510bf0551d79829ef8c33c","data":"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"}
import { Actions } from 'viem/tempo'
import { client, token } from './viem.config'

const hash = await client.reward.setRecipient({
  recipient: client.account.address,
  token,
})
const receipt = await client.waitForTransactionReceipt({ hash })

const { args: { holder, recipient } } 
  = Actions.reward.setRecipient.extractEvent(receipt.logs)
```

## Return Type

```ts
type ReturnType = {
  /** Token holder address who set their reward recipient */
  holder: Address
  /** Transaction receipt */
  receipt: TransactionReceipt
  /** Reward recipient address (zero address indicates opt-out) */
  recipient: Address
}
```

:::tip
Rewards are automatically distributed to the current recipient before changing. This happens during any balance-changing operation (transfers, mints, burns).
:::

## Parameters

### recipient

* **Type:** `Address`

The reward recipient address. Use zero address to opt out of rewards.

### token

* **Type:** `Address`

The TIP20 token address.

<WriteParameters />