Why did my NEAR transaction fail?

Last updated: 27 October 2026

In short: a NEAR transaction fails when one of its steps can't finish, for example because a contract refused it, the account didn't have enough NEAR, or a token needed a storage deposit first. When that happens, nothing you asked for takes effect, but you still pay the small gas fee for the work done up to that point. Unused gas comes back to you.

This page explains the common reasons, and then walks through one real failed transaction so you can see what the error looks like on an explorer.

What does "failed" mean on NEAR?

A transaction is a request you sign with your wallet, like "send 5 NEAR to this account" or "call this app." On NEAR, one transaction is often split into smaller steps called receipts. Each receipt is one piece of work, such as a token contract passing tokens on to a pool.

A transaction shows as failed when one of those steps stops with an error. The step that failed changes nothing. The record on the chain keeps the error message, so anyone can read why it stopped. That is useful: the message usually tells you exactly what went wrong.

One thing to know: when a transaction has several steps that run one after another, a step that already finished is not always undone when a later step fails. Apps are built to handle this, often by sending tokens back. If a failed transaction left tokens somewhere you didn't expect, read the receipts on the explorer before you try again.

Did I still pay gas?

Yes, a little. Gas is the small NEAR fee that pays the network for checking and running your request (see gas fees on NEAR). The network did that work even if the result was an error, so the gas used up to the failure is charged. The gas you set aside but didn't use is refunded one block later, as it is for any transaction.

In the real example below, the wallet set aside 600 Tgas, the transaction used about 8.18 Tgas before it failed, and the whole fee was about 0.0008 NEAR. The rest was refunded.

Not enough balance: why?

A few things can make NEAR say you don't have enough, even when your wallet seems to show some.

Keeping a small amount of NEAR in the account for fees avoids most of these errors.

What is a storage deposit error?

A token contract keeps a list of who holds how much. Each new name on that list takes space, and someone has to pay for it. So most NEAR tokens ask for a small storage deposit before an account can receive them. If you send a token to an account that hasn't made that deposit, the token contract may refuse the transfer.

The fix is to make the deposit first, which many wallets and apps do for you. The amount is small and set by each token. For example, the wNEAR contract (wrap.near) asks for 0.00125 NEAR, which I read straight from the contract on 27 October 2026. The NEAR wallet page shows a real storage deposit on FLTC.

How do I read the transaction on NearBlocks?

NearBlocks (nearblocks.io) is a public explorer. Paste your transaction ID into its search box. You can find the ID in your wallet's activity list. Then look at:

  1. Status. "Success" or "Failure."
  2. Transaction fee. The gas you actually paid.
  3. Gas limit and usage. How much you set aside, and how much was used.
  4. Receipts. Each step, and which one failed. The failed one shows the error message.

Here is a real one, chosen because the error is easy to read. On 27 October 2026 at 1:03 AM ET, someone tried to add money to a pool on Rhea's contract dclv2.ref-labs.near, calling add_liquidity. Open the transaction on NearBlocks.

What NearBlocks showsValue
StatusFailure
ErrorSmart contract panicked: E204: slippage error
Gas attached600 Tgas
Gas usedabout 8.18 Tgas
Transaction feeabout 0.000796 NEAR

"Panicked" sounds alarming, but it just means the contract stopped on purpose because a check didn't pass. "Slippage" means the price moved between the moment the request was made and the moment it ran, by more than the person allowed. The contract refused rather than give a worse deal. Nothing was added to the pool, and the person paid well under a thousandth of a NEAR to find out.

What should I try next?

Words you don't know are in the glossary.

Sources

Next lesson: What is wNEAR? →

Questions? Join the Telegram to talk with other beginners.