useWriteContract

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

const { writeGuessAsync } = useWriteContract({
  abi: [LuckyGuessABI],
  address: "0xabca6bf26964af9f7eed9e03e53415d37aa90123",
});

The following configuration options can be passed to the hook:

Configuration

Parameter	Type	Required	Description
abi	object[]	Yes	ABI of the contract to read from.
address	string	Yes	Address of contract to read from.
blockConfirmations	number	No	Number of block confirmations to wait for (default: 1).
gasLimit	bigint	No	Transaction gas limit.

To send the transaction, you can call the writeGuessAsync function returned by the hook. Here's an example usage:

<Button
  onPress={async () => {
    try {
      await writeGuessAsync({
        functionName: "guess",
        args: [4],
        value: parseEther("0.01"),
      });
    } catch (e) {
      console.error("Error placing guess:", e);
    }
  }}
>
  Guess 4
</Button>

This example calls guess on a LuckyGuess-style contract: args is the number 1–6, and value is the bet amount.

Below is the configuration for writeGuessAsync function:

Configuration

Parameter	Type	Required	Description
functionName	string	Yes	Name of the function to be called.
args	unknown[]	No	Array of arguments to pass to the function (if accepts any). Types are inferred from contract's function parameters.
value	bigint	No	Value in ETH that will be sent with transaction (for payable functions only).

Return Values

• The loading state is stored in the isLoading property.
• The mining state is stored in the isMining property.
• writeContract functions send the transaction to the smart contract but doesn't return a promise.
• writeContractAsync function sends the transaction to the smart contract and returns a promise that resolves when transactions is successful.