Skip to main content


Use this hook to send a transaction to your smart contract to write data or perform an action.

const { writeContractAsync: writeYourContractAsync } = useScaffoldWriteContract("YourContract");

The first argument is name of the contract to write to and the second argument is wagmi's useWriteContract hook parameters object.

To send the transaction, you can call the writeContractAsync function returned by the hook (which we instance as writeYourContractAsync). Here's an example usage:

className="btn btn-primary"
onClick={async () => {
try {
await writeYourContractAsync({
functionName: "setGreeting",
args: ["The value to set"],
value: parseEther("0.1"),
} catch (e) {
console.error("Error setting greeting:", e);
Set Greeting

This example sends a transaction to the YourContract smart contract to call the setGreeting function with the arguments passed in args. The writeContractAsync function (writeYourContractAsync instance) sends the transaction to the smart contract.

Below is the configuration for writeContractAsync function:


functionNamestringName of the function to call.
args (optional)unknown[]Array of arguments to pass to the function (if accepts any). Types are inferred from contract's function parameters.
value (optional)bigintAmount of ETH to send with the transaction (for payable functions only).
onBlockConfirmation (optional)functionCallback function to execute when the transaction is confirmed.
blockConfirmations (optional)numberNumber of block confirmations to wait for before considering transaction to be confirmed (default : 1).

You can also pass other arguments accepted by writeContractAsync from wagmi.

Return Valuesโ€‹

  • writeContractAsync function sends the transaction to the smart contract.
  • isMining property indicates whether the transaction is currently being mined.
  • The extended object includes properties inherited from wagmi useWriteContract. You can check the useWriteContract return values documentation to check the types.