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.
Installation
Section titled “Installation”npx shadcn@latest add @0xui/transaction-buttonpnpm dlx shadcn@latest add @0xui/transaction-buttonyarn dlx shadcn@latest add @0xui/transaction-buttonbunx --bun shadcn@latest add @0xui/transaction-buttonSend 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.
Examples
Section titled “Examples”Wrong network
Section titled “Wrong network”The label says exactly what clicking does: “Switch to Base”. Once the switch is done, the button returns to its normal label.
Name the blocker
Section titled “Name the blocker”Don’t just disable the button. Say why, so users know what to fix.
<TransactionButton disabledReason={!amount ? "Enter an amount" : undefined} …>Reverted
Section titled “Reverted”Simulate first
Section titled “Simulate first”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.
Headless
Section titled “Headless”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.
States
Section titled “States”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. |
