❌Transaction Failure Dictionary

Learn the cause of common swap failures

Error Message	Error Message Meaning
❌ Fail with error 'Transaction too old' ❌ Fail with error 'PancakeV2Router EXPIRED'	This error can occur when your transaction gets stuck in the mempool for too long and then fails due to the age of the transaction. Transactions have a certain timespan after which they can no longer be included in a block.
❌ Fail with error 'PancakeV2Library: INSUFFICIENT_LIQUIDITY'	This error often occurs when there's not enough liquidity in a trading pair to execute a swap or transaction, this error can also occur if you attempt to snipe a token that has a anti bot feature and you didn't correctly set the number of dead blocks.
❌ Fail with error 'ds-math-sub-underflow'	The error message "ds-math-sub-underflow" typically indicates an underflow in a subtraction operation that occurred within a smart contract on the blockchain.
❌ Fail with error 'PancakeV2Router: INSUFFICIENT_OUTPUT_AMOUNT'	This error occurs when the output amount of the swap is insufficient, meaning that the calculated amount of the token you're receiving after the swap is too small to be processed. Consider increasing your slippage if you encounter this error. This error can also occur when trying to snipe tokens that haven't yet enabled trading.
❌ Fail with error 'TransferHelper: TRANSFER_FROM_FAILED'	This error is often encountered when there's an issue with the token allowance, the sender's balance, or the interaction with the token contract. This error will also occur if you're performing a swap or transfer on a honeypotted token.
❌ Fail with error 'PancakeswapV2Router: EXCESSIVE_INPUT_AMOUNT'	This error occurs when the input amount provided for the swap is too large relative to the available liquidity, causing the transaction to fail.
❌ Fail with error 'STF	This error occurs when performing a swap on a token that hasn't been approved.
❌ Unable to locate TxHash	This error occurs because the transaction was rejected by the blockchain. This could be due to not having enough Ether (ETH) balance to cover the gas cost of the transaction. You need to have enough balance to cover both the transaction's gas cost and potential fluctuations in gas prices. If gas prices are high, the max gas cost can be around 0.03-0.15 ETH. Ensure your wallet has enough balance to cover these costs. If your wallet balance is sufficient, the error could be due to a nonce issue. Check if you have a stuck or pending transaction that's preventing your new transaction from being processed. Resolve any pending transactions before attempting the new one.
❌ Insufficient funds for gas * price + value	The error message "Insufficient funds for gas * price + value" indicates that you don't have enough BNB to cover both the gas cost of the transaction and the value being sent.