useTransact()

The useTransact() hook lets you perform a transaction on the Sui network.

When user triggers a transaction, we display a notification to confirm that transaction in their wallet. Once user confirmed or rejected the transaction, we convert that notification to a success message or error message. The success message will have a link to a Sui Explorer depending on the active network.

In case of error, we additionally print full error message in the browser console.

Usage

MyComponent.tsx

import type { SuiSignAndExecuteTransactionOutput } from '@mysten/wallet-standard'
import { Transaction } from '@mysten/sui/transactions'

const { transact: greet } = useTransact({
  onSuccess: (data: SuiSignAndExecuteTransactionOutput) => {
    // Optionally react on success, e.g. refetch dependent queries.
  },
  onError: (e: Error) => {
    // Optionally react on error.
  }
})

const prepareTransaction = (packageId: string, objectId: string, name: string) => {
  const tx = new Transaction()
  tx.moveCall({
    arguments: [tx.object(objectId), tx.pure.string(name), tx.object('0x8')],
    target: `${packageId}::greeting::set_greeting`,
  })
  return tx
}

greet(prepareTransaction(packageId, objectId, name))

Uses

useSignAndExecuteTransaction() from @mysten/dapp-kit