Skip to content

Components

Transaction Button

Sends a transaction and shows every step on the button. Connect, switch network, confirm, pending, done.

The button carries the whole flow. Disconnected users get the wallet picker. On the wrong network it offers to switch. Then it walks through confirm in wallet, pending and done, with a status line for each step.

Connect the Demo Wallet to try it. Demo transactions get a fake hash and “mine” after 3 seconds. Nothing is broadcast.

Terminal window
npx shadcn@latest add @0xui/transaction-button

Send ETH:

import { TransactionButton } from "@/components/transaction-button";
<TransactionButton transaction={{ to, value: parseEther("0.01") }} chainId={1}>
Send 0.01 ETH
</TransactionButton>;

Call a contract:

<TransactionButton
chainId={8453}
contract={{ address: token, abi: erc20Abi, functionName: "approve", args: [spender, amount] }}
onSuccess={() => refetchAllowance()}
>
Approve
</TransactionButton>

Always pass chainId. The button then makes sure the wallet is on that chain before sending.

The label says exactly what clicking does: “Switch to Base”. Once the switch is done, the button returns to its normal label.

Don’t just disable the button. Say why, so users know what to fix.

<TransactionButton disabledReason={!amount ? "Enter an amount" : undefined} …>

With simulate, the button dry-runs the transaction from the connected account before anyone clicks. If it would revert, the button is disabled and the contract’s revert reason is shown, so the wallet never opens on a transaction that will fail.

This demo tries to send a billion USDC from the Demo Wallet. The check runs against mainnet.

<TransactionButton chainId={1} simulate contract={{ address: usdc, abi: erc20Abi, functionName: "transfer", args: [to, amount] }}>
Send
</TransactionButton>

The simulation runs once a wallet is connected on the right network and disabledReason is clear, and again after each transaction. Use disabledReason for what your form already knows, such as an empty amount, and simulate for what only the chain knows.

It is a check, not a guarantee: state can change between the simulation and the block the transaction lands in.

import { useTransactionFlow } from "@/components/transaction-button";
const flow = useTransactionFlow({ chainId: 1 });
flow.execute({ transaction: { to, value } });
// flow.phase, flow.hash, flow.receipt, flow.error, flow.wrongChain, flow.switchToTarget()

useTransactionSimulation({ contract, chainId }) runs the same dry run on its own. It returns status (idle, checking, ok or failed) and the revert reason.

data-phase on the root holds the current state, also exported as TxPhase.

data-phase Button Status line
idle Your label, or “Connect wallet” / “Switch to X” —
idle, with simulate “Checking…”, then your label or “Transaction will fail” Alert with the revert reason when it would fail.
switching Spinner, “Switching network…” Approve the network switch in your wallet.
confirming Spinner, “Confirm in wallet…” Confirm the transaction in your wallet.
pending Spinner, “Pending…” Transaction submitted. Waiting for confirmation…
success Check, successLabel Transaction confirmed. Returns to idle after resetAfter.
reverted Your label (retry) Alert: transaction reverted.
cancelled Your label Cancelled in wallet. Not an error, and onError isn’t called.
error Your label (retry) Alert with the wallet or RPC message.

Also accepts shadcn Button props.

Prop Type Default Description
transaction { to, value?, data? } — Plain transaction. Pass this or contract.
contract { address, abi, functionName, args?, value? } — Contract call.
chainId number current chain Chain the transaction must run on.
confirmations number 1 Confirmations before success.
disabledReason string — Disable and show this text.
simulate boolean false Dry-run first. Disable and show the revert reason when it would fail.
children ReactNode "Submit" Label.
successLabel ReactNode "Done" Label after success.
resetAfter number | false 4000 Back to idle after success, in ms.
hideStatus boolean false Hide the status line.
agentConfirm string | false label + what it does Sets data-agent-confirm, so browser agents ask a person first. false drops it.
onSubmitted (hash) => void — Wallet returned a hash.
onSuccess (receipt) => void — Mined successfully.
onError (error) => void — Failed or reverted. Not called on cancel.