Transaction errors explained
A transaction can fail in two places: the node can refuse it before it reaches a block, or it can run on the chain and fail there. Find your error below. Each page shows where it happens, the messages you will see, how to fix it and how it looks in a trace.
No match yet. Try a shorter part of the message.
Nonce and replacement
The order of an account’s transactions: a counter that must be used once, in order.
- Nonce too low in Ethereum: cause and fixnonce too lowRejected before the chain
- Replacement transaction underpriced: cause and fixreplacement transaction underpricedRejected before the chain
- Transaction stuck pending: causes and fixWaitForTransactionReceiptTimeoutErrorWaiting in the pool
- Transaction dropped and replaced: meaning and fixDropped & ReplacedReplaced in the pool
Gas, fees and funds
The node checks what the sender can pay before it accepts a transaction.
- Insufficient funds for gas * price + value: cause and fixinsufficient funds for gas * price + valueRejected before the chain
- Max fee per gas less than block base fee: cause and fixmax fee per gas less than block base feeRejected before the chain
- Intrinsic gas too low: cause and fixintrinsic gas too lowRejected before the chain
Reverts and out of gas
The transaction ran on the chain and failed, and still cost gas.
Missing the error you hit? Tell us which one, and we will add it: open an idea on GitHub.